feat(web): API Key 页「OpenAI 客户端接入」补 Responses 入口

API Key 页此前只列 chat/completions、user/balance、models 三个端点，
Responses API（/v1/responses）只在文档里有——用户在该页照着接入
Codex CLI 时看不到入口。

- 端点列表新增 `POST /v1/responses`（Responses 子集，供 Codex CLI 接入），
  可展开出可直接复制的 Codex CLI 配置；示例复用同一 baseUrl + 真实 Key
  （未创建 Key 时用 sk-… 占位）
- 补一条说明：只实现 Codex CLI 用到的子集，与 chat/completions 共用选号 /
  冷却 / 轮换 / 会话粘性；store=true、previous_response_id 与服务端私有工具
  显式 400，不静默降级
- 测试：新增 Responses 端点展开与复制用例，并把「未创建 Key 时示例用占位符」
  「创建后示例带入真实 Key」两条扩展到覆盖 responses

浏览器验证（ego-browser + 临时实例）：端点行默认折叠，展开显示 Codex CLI
配置，复制按钮给出示例 URL；说明段落行内 code 正常不拆行。

Author: RobbsLuo

web/src/pages/ApiKeysPage.tsx

@@ -43,6 +43,7 @@ export function openaiExamples(baseUrl: string, apiKey: string): {
   curl: string;
   python: string;
   balance: string;
+  responses: string;
 } {
   const key = apiKey || "sk-…";
   return {
@@ -64,6 +65,12 @@ resp = client.chat.completions.create(
 print(resp.choices[0].message.content)`,
     balance: `curl ${baseUrl}/user/balance \\
   -H "Authorization: Bearer ${key}"`,
+    // Codex CLI 用 env_key 引用环境变量名（不是 Key 本身），故先 export 再引用
+    responses: `export CODING2API_KEY=${key}
+codex -c "model_providers.coding2api={ name='coding2api', base_url='${baseUrl}', wire_api='responses', env_key='CODING2API_KEY' }" \\
+      -c model_provider=coding2api \\
+      -c model='glm-5.2' \\
+      '你的任务'`,
   };
 }
 
@@ -186,6 +193,11 @@ function OpenAIEntry({ apiKey }: { apiKey: string }) {
               <CodeExample label="curl 示例" text={examples.balance} copied={copied === "balance"} onCopy={() => void copy("balance", examples.balance)} testid="example-balance-curl" copyTestid="copy-balance-curl" />
             </EndpointRow>
           </li>
+          <li>
+            <EndpointRow method="POST" path={`${baseUrl}/responses`} description="Responses 子集（供 Codex CLI 接入）" testid="example-details-responses">
+              <CodeExample label="Codex CLI 配置" text={examples.responses} copied={copied === "responses"} onCopy={() => void copy("responses", examples.responses)} testid="example-responses" copyTestid="copy-responses" />
+            </EndpointRow>
+          </li>
           <li>
             <Badge>GET</Badge> <code>{baseUrl}/models</code>　模型列表
           </li>
@@ -194,6 +206,15 @@ function OpenAIEntry({ apiKey }: { apiKey: string }) {
           任何兼容 OpenAI 协议的客户端（ChatGPT Next Web、LobeChat、Cursor 等）
           都可以按上面的 Base URL + API Key 接入。模型名从 /v1/models 获取。
         </Notice>
+        <Notice tone="muted">
+          {/* 整段包一层 span：ShadAlert 是 grid 容器，直接放多个行内元素会被拆成多行 */}
+          <span>
+            <code>POST /v1/responses</code> 只实现 Codex CLI 用到的子集，与{" "}
+            <code>/v1/chat/completions</code> 共用同一套选号、冷却、轮换与会话粘性。
+            <code>store=true</code>、<code>previous_response_id</code> 与{" "}
+            <code>web_search</code> 等服务端私有工具会被显式拒绝（400），不静默降级。
+          </span>
+        </Notice>
       </div>
     </Panel>
   );

web/src/pages/__tests__/ApiKeysPage.test.tsx

@@ -209,8 +209,10 @@ describe("OpenAI 客户端接入面板", () => {
       `curl ${window.location.origin}/v1/user/balance`,
     );
     expect(screen.getByTestId("example-balance-curl")).toHaveTextContent("sk-…");
+    // Responses 端点在此列出，示例默认折叠
+    expect(screen.getByTestId("example-details-responses")).toHaveTextContent("/responses");
+    expect(screen.getByTestId("openai-entry")).toHaveTextContent("Codex CLI");
   });
-
   it("创建 Key 后示例自动带入真实 Key", async () => {
     const fetchSpy = vi.fn(async (input: RequestInfo | URL, init?: RequestInit) => {
       const url = String(input);
@@ -231,6 +233,9 @@ describe("OpenAI 客户端接入面板", () => {
     });
     expect(screen.getByTestId("example-python")).toHaveTextContent('api_key="sk-real-key"');
     expect(screen.getByTestId("example-balance-curl")).toHaveTextContent("sk-real-key");
+    expect(screen.getByTestId("example-responses")).toHaveTextContent(
+      "export CODING2API_KEY=sk-real-key",
+    );
   });
 });
 
@@ -265,3 +270,29 @@ it("余额端点示例同样默认折叠，展开后可复制 curl", async () =>
   -H "Authorization: Bearer sk-…"`,
   );
 });
+
+it("Responses 端点示例默认折叠，展开后可复制 Codex CLI 配置", async () => {
+  const writeText = vi.fn(async () => undefined);
+  vi.stubGlobal("navigator", { clipboard: { writeText } });
+  mockFetch({ "/api/api-keys": { api_keys: [] } });
+  renderPage(<ApiKeysPage />);
+  await settle();
+
+  const details = screen.getByTestId("example-details-responses") as HTMLDetailsElement;
+  expect(details.open).toBe(false);
+  // <details> 关闭时子节点仍在 DOM 里，只是不可见
+  expect(screen.getByTestId("example-responses")).not.toBeVisible();
+
+  await userEvent.click(details.querySelector("summary")!);
+  expect(details.open).toBe(true);
+  expect(screen.getByTestId("example-responses")).toBeVisible();
+  expect(screen.getByTestId("example-responses")).toHaveTextContent("wire_api='responses'");
+  expect(screen.getByTestId("example-responses")).toHaveTextContent(
+    `base_url='${window.location.origin}/v1'`,
+  );
+
+  await userEvent.click(screen.getByTestId("copy-responses"));
+  expect(writeText).toHaveBeenCalledWith(
+    expect.stringContaining("export CODING2API_KEY=sk-…"),
+  );
+});