Lumoswitch 文档

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 下为 windowsagent-import-command 只使用 temporarypersistent。平台与生命周期不会再组合成 windows-temporary 之类的值。

清理命令只是文档中的生命周期操作,不是一键导入模板。因此 Windows 原生清理代码框使用独立的 agent-import-action="cleanup" 标记,并同时声明 agent-import-platform="windows";它不会复用 agent-import-command

平台平台标记使用方式标记
macOS / Linux / WSLagent-import-platform="posix"agent-import-command="temporary"agent-import-command="persistent"
Windowsagent-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;依赖 /Applicationsosascriptopen -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 与兼容性」。

On this page