fix(config-agent): 优化 Codex 配置写入与兼容性处理

- 调整 Codex 代理默认 wire_api 为 "responses"，兼容新版 Codex
- 增加对 legacy Codex <= 0.80.0 使用 wire_api "chat" 的警告提示
- 修正 agent flags 描述，更准确说明 wire_api 默认与兼容范围
- 优化代码格式，统一 import 语句风格
- 增加测试用例覆盖不同 wire_api 配置及环境变量警告
- 修复写入过程中文件备份及合并逻辑，保留用户已有配置
- 修复多个 provider 写入时键名与内容匹配，避免重复添加
- 改善测试代码格式，提高可读性与一致性

Author: lishengzxc

packages/commands/src/commands/config/agent/index.ts

@@ -38,7 +38,7 @@ const FLAGS = {
     type: "string",
     valueHint: "<api>",
     description:
-      'Codex only: wire protocol — "chat" works with every model; "responses" for models supporting the Responses API (default: chat)',
+      'Codex only: wire protocol (default: responses). "chat" only works with legacy Codex <= 0.80.0',
     choices: ["chat", "responses"],
   },
 } satisfies FlagsDef;

packages/commands/src/commands/config/agent/writers/codex.ts

@@ -2,31 +2,23 @@ import { homedir } from "os";
 import { join } from "path";
 import { existsSync, readFileSync } from "fs";
 import { parse as parseToml, stringify as stringifyToml } from "smol-toml";
-import {
-  backup,
-  readJson,
-  writeJsonAtomic,
-  writeTextAtomic,
-  type AgentDef,
-} from "./utils.ts";
+import { backup, readJson, writeJsonAtomic, writeTextAtomic, type AgentDef } from "./utils.ts";
 
 const PROVIDER_KEY = "bailian-cli";
 
 export default {
   label: "Codex",
   write({ baseUrl, apiKey, model, wireApi: wireApiParam }) {
     const configPath = join(homedir(), ".codex", "config.toml");
+    const warnings: string[] = [];
 
     // config.toml — merge into existing config so unrelated settings
     // (mcp_servers, approval_policy, other providers, ...) are preserved.
     backup(configPath);
     let config: Record<string, unknown> = {};
     if (existsSync(configPath)) {
       try {
-        config = parseToml(readFileSync(configPath, "utf-8")) as Record<
-          string,
-          unknown
-        >;
+        config = parseToml(readFileSync(configPath, "utf-8")) as Record<string, unknown>;
       } catch {
         config = {};
       }
@@ -35,9 +27,18 @@ export default {
     config.model_provider = PROVIDER_KEY;
     config.model = model;
 
-    // wire_api: "responses" for models supporting the Responses API (e.g.
-    // qwen3.7/3.8 series); "chat" works with every model via Chat Completions.
-    const wireApi = wireApiParam === "responses" ? "responses" : "chat";
+    // wire_api — current Codex releases only load `wire_api = "responses"`
+    // ("chat" is rejected at config load, see openai/codex discussion #7782).
+    // "chat" remains an explicit opt-in for users pinned to legacy Codex
+    // <= 0.80.0 (the Model Studio path for models without Responses support).
+    const wireApi = wireApiParam === "chat" ? "chat" : "responses";
+    if (wireApi === "chat") {
+      warnings.push(
+        'Current Codex releases refuse to load `wire_api = "chat"`; ' +
+          "only use --wire-api chat with legacy Codex <= 0.80.0 " +
+          "(e.g. `npm install -g @openai/codex@0.80.0`).",
+      );
+    }
 
     const providers = (config.model_providers ?? {}) as Record<string, unknown>;
     const existing = (providers[PROVIDER_KEY] ?? {}) as Record<string, unknown>;
@@ -65,6 +66,7 @@ export default {
     return {
       paths: [configPath, authPath],
       nextStep: "Run `codex` to start using Codex with DashScope.",
+      warnings: warnings.length > 0 ? warnings : undefined,
     };
   },
 } satisfies AgentDef;

packages/commands/tests/config-agent-writers.test.ts

@@ -214,7 +214,11 @@ describe("config agent writers", () => {
   });
 
   test("qwen-code anthropic 端点走 anthropic 协议", () => {
-    qwenCode.write({ baseUrl: ANTHROPIC_URL, apiKey: "sk-q", model: "qwen3-max" });
+    qwenCode.write({
+      baseUrl: ANTHROPIC_URL,
+      apiKey: "sk-q",
+      model: "qwen3-max",
+    });
     const settings = readJsonAt(".qwen", "settings.json");
     expect((settings.security as { auth: { selectedType: string } }).auth.selectedType).toBe(
       "anthropic",
@@ -225,8 +229,16 @@ describe("config agent writers", () => {
   });
 
   test("qwen-code 对自有 provider 项按 id upsert 而非追加", () => {
-    qwenCode.write({ baseUrl: OAI_URL, apiKey: "sk-1", model: "qwen3-coder-plus" });
-    qwenCode.write({ baseUrl: OAI_URL, apiKey: "sk-2", model: "qwen3-coder-plus" });
+    qwenCode.write({
+      baseUrl: OAI_URL,
+      apiKey: "sk-1",
+      model: "qwen3-coder-plus",
+    });
+    qwenCode.write({
+      baseUrl: OAI_URL,
+      apiKey: "sk-2",
+      model: "qwen3-coder-plus",
+    });
     const settings = readJsonAt(".qwen", "settings.json");
     const openaiEntries = (settings.modelProviders as Record<string, unknown[]>).openai;
     expect(openaiEntries).toHaveLength(1);
@@ -327,7 +339,11 @@ describe("config agent writers", () => {
       JSON.stringify({ provider: { other: { name: "Other" } } }),
     );
 
-    opencode.write({ baseUrl: ANTHROPIC_URL, apiKey: "sk-o", model: "qwen3-max" });
+    opencode.write({
+      baseUrl: ANTHROPIC_URL,
+      apiKey: "sk-o",
+      model: "qwen3-max",
+    });
     const config = readJsonAt(".config", "opencode", "opencode.json");
     const provider = config.provider as Record<string, Record<string, unknown>>;
     expect(provider.other).toBeDefined();
@@ -351,7 +367,11 @@ describe("config agent writers", () => {
   });
 
   test("openclaw 写入 provider、api、primary，并登记 defaults.models", () => {
-    openclaw.write({ baseUrl: OAI_URL, apiKey: "sk-c", model: "qwen3-coder-plus" });
+    openclaw.write({
+      baseUrl: OAI_URL,
+      apiKey: "sk-c",
+      model: "qwen3-coder-plus",
+    });
     const config = readJsonAt(".openclaw", "openclaw.json");
     const models = config.models as Record<string, unknown>;
     expect(models.mode).toBe("merge");
@@ -496,19 +516,21 @@ describe("config agent writers", () => {
     // 预置 auth.json 无关键，验证合并保留
     writeFileSync(join(home, ".codex", "auth.json"), JSON.stringify({ EXISTING: "keep" }));
 
-    codex.write({
+    const summary = codex.write({
       baseUrl: OAI_URL,
       apiKey: "sk-x",
       model: "qwen3-coder-plus",
     });
+    // 默认路径无警告
+    expect(summary.warnings).toBeUndefined();
     const toml = readFileSync(join(home, ".codex", "config.toml"), "utf8");
     expect(toml).toContain('model_provider = "bailian-cli"');
     expect(toml).toContain('model = "qwen3-coder-plus"');
     expect(toml).toContain("[model_providers.bailian-cli]");
     expect(toml).toContain(`base_url = "${OAI_URL}"`);
     expect(toml).toContain('env_key = "OPENAI_API_KEY"');
-    // 未传 --wire-api 时默认 chat（所有模型可用）
-    expect(toml).toContain('wire_api = "chat"');
+    // 未传 --wire-api 时默认 responses（新版 Codex 已不支持 chat）
+    expect(toml).toContain('wire_api = "responses"');
     expect(toml).toContain("requires_openai_auth = true");
     // 合并：保留用户已有的无关配置
     expect(toml).toContain('approval_policy = "on-request"');
@@ -518,16 +540,17 @@ describe("config agent writers", () => {
     expect(auth.OPENAI_API_KEY).toBe("sk-x");
     expect(auth.EXISTING).toBe("keep");
 
-    // --wire-api responses：支持 Responses API 的模型
-    codex.write({
+    // --wire-api chat：仅旧版 Codex <= 0.80.0 可用，附带警告
+    const summary2 = codex.write({
       baseUrl: OAI_URL,
       apiKey: "sk-x",
-      model: "qwen3.7-plus",
-      wireApi: "responses",
+      model: "glm-5",
+      wireApi: "chat",
     });
+    expect(summary2.warnings?.some((warning) => warning.includes("0.80.0"))).toBe(true);
     const toml2 = readFileSync(join(home, ".codex", "config.toml"), "utf8");
-    expect(toml2).toContain('wire_api = "responses"');
-    expect(toml2).toContain('model = "qwen3.7-plus"');
+    expect(toml2).toContain('wire_api = "chat"');
+    expect(toml2).toContain('model = "glm-5"');
   });
 
   test("已存在的配置文件会被备份为 .bak.<epoch>", () => {