Agent 接入索引
每个 Agent 的配置都在自己的接入页面维护。对应页面会直接说明它的用途,并提供「仅本次启动」「永久使用」「清除接入」和日常启动方式;不支持某种方式时,页面会明确说明原因。
一键导入默认直接读取英文接入页面声明的平台信息与已标记命令代码块,管理员无需再复制到第二份存储。同一平台 ID 的手动记录表示显式覆盖,新平台 ID 表示手动新增;删除覆盖后会立即恢复文档默认值。
命令中的 {{api_base_url}}、{{access_key}}、{{model}} 与各 Agent 专用配置占位符是发布模板变量。普通用户使用时,系统会用同一份有效推理能力生成客户端配置,不再由文档脚本按模型名称猜测档位。{{agent_reasoning_manifest_json}} / {{agent_reasoning_manifest_base64}} 还提供与客户端无关的版本化能力清单,供后续 Agent 适配器复用。
命令代码框标记
每个发布命令代码框都用两个独立属性声明平台和使用方式。agent-import-platform 在 macOS、Linux 和 WSL 的 Bash / Zsh 下为 posix,在 Windows 原生 PowerShell 下为 windows;agent-import-command 只使用 temporary 或 persistent。平台与生命周期不会再组合成 windows-temporary 之类的值。
清理命令只是文档中的生命周期操作,不是一键导入模板。因此 Windows 原生清理代码框使用独立的 agent-import-action="cleanup" 标记,并同时声明 agent-import-platform="windows";它不会复用 agent-import-command。
| 平台 | 平台标记 | 使用方式标记 |
|---|---|---|
| macOS / Linux / WSL | agent-import-platform="posix" | agent-import-command="temporary" 或 agent-import-command="persistent" |
| Windows | agent-import-platform="windows" | agent-import-command="temporary" 或 agent-import-command="persistent" |
在 WSL 中,POSIX 模板会把 Agent 安装和配置在对应 Linux 发行版及其 $HOME 内,不会修改 Windows 原生桌面应用的设置。原生 Windows 安装应选择 Windows 标签;明确依赖 macOS 应用的 Agent 页面仍然只支持 macOS。
注解中的 wslEnabled 字段让这一区别可以被程序读取。为兼容已有 CLI 记录,它默认是 true;依赖 /Applications、osascript 和 open -a 的 ChatGPT Desktop 导入会显式设为 false。控制台因此会把这些入口显示为仅 macOS,而不会宣称支持 WSL。
例如,Windows 清理代码框标记为 agent-import-platform="windows" agent-import-action="cleanup"。
推理能力映射
系统按三层收敛能力:模型原生能力来自 models.dev、OpenRouter 或管理员声明;渠道传输能力来自渠道类型或显式 reasoningTransport;配置 API 路由再取所有候选模型的能力交集。Agent 适配器只能从这个交集继续缩小,绝不会补出上游或渠道没有的档位。
渠道传输配置是结构化、可追溯的数据。管理员可以覆盖映射和可传输档位;覆盖值与模型原生能力取交集,不会把不支持的请求静默改成较低档位。Codex 接入还会发送版本化的 X-Lumoswitch-Agent: codex-v1 标记,使 LiteLLM 兼容层不再只依赖请求结构猜测客户端。
| Agent | 一键导入处理 |
|---|---|
| Codex | 生成模型目录及每模型可用档位 |
| Claude Code | 仅为默认模型写入安全的 effortLevel,并同步 thinking 开关 |
| OpenCode / Kilo | 为每个模型生成默认值及可选 variants |
| DeepSeek Harness | 生成带逐模型 reasoningEfforts 和传输 compat 的 overlay YAML |
| Qwen Code | 为每个 provider model 生成独立的 generationConfig.reasoning |
| Aider | 只为可调模型声明 accepts_settings,有安全默认值时才传 --reasoning-effort |
| OpenClaw | 生成 reasoning 与经过验证的 compat 能力字段 |
| GitHub Copilot CLI | 有安全默认值时才传 --effort |
| Gemini CLI | 只生成模型别名;不把通用档位猜成模型代际相关的 budget / thinking level |
| Continue、Crush、Goose | 当前稳定配置协议没有可验证的逐模型推理档位声明,因此明确省略 |
“省略”是受控结果,不等于缺少处理:当原生能力未知、渠道不能传输、客户端词汇不相交或客户端没有稳定字段时,模板不会发送推理参数,从而避免 The inference request is invalid。
选择 Agent
| Agent | 可用方式 | 接入与命令页面 |
|---|---|---|
| Codex CLI | 仅本次、永久、清除 | Codex CLI |
| ChatGPT 桌面端(Codex) | 永久、清除 | ChatGPT 桌面端 |
| ChatGPT 桌面端 + Codex CLI | 永久共用、清除 | 桌面端 + CLI |
| Claude Code CLI | 仅本次、永久、清除 | Claude Code CLI |
| OpenCode CLI | 仅本次、永久、清除 | OpenCode CLI |
| DeepSeek Harness | 仅本次、永久、清除 | DeepSeek Harness |
| GitHub Copilot CLI | 仅本次、永久、清除 | GitHub Copilot CLI |
| Gemini CLI | 仅本次、永久、清除 | Gemini CLI |
| Qwen Code CLI | 仅本次、永久、清除 | Qwen Code CLI |
| Aider CLI | 仅本次、永久、清除 | Aider CLI |
| OpenClaw CLI | 永久、清除 | OpenClaw CLI |
其他编辑器 Agent 请返回 Agent 接入 选择对应页面。SDK 和普通图形客户端位于侧栏的「API 与兼容性」。