新增 AGC 模型 Agent 模式与 Claude Agent SDK sidecar

后台模型目录增加 codex/cc 执行模式绑定，旧目录缺省兼容 Codex AGC 客户端按模型绑定路由 Codex app-server 或 Claude Agent SDK sidecar 随包携带 Node runtime、Claude Agent SDK 与匹配平台 Claude runtime 补充模型配置、客户端选择、运行时适配、MCP 取消和定向测试同步 AGC 模型配置规范、里程碑计划与共享决策记录
2026-09-30 13:49:09 +08:00
parent 5e2d47919e
commit fb130d1847
38 changed files with 3417 additions and 118 deletions
@@ -52,6 +52,16 @@
 - 项目右侧对话的模型选择器在对话进行中保持可交互：切换模型只写回客户端配置并作用于下一轮，当前回合不受影响；发送按钮仍由 `controlBusy` / `modelReady` 把关。
 - 自定义开关关闭时，设置页不包含模型管理或模型选择，使用官方代理锁定。

+
+## 模型绑定 Agent 执行模式
+
+- 后台 AGC 模型目录每项新增 `agentMode`，只接受 `codex` 与 `cc`；缺少该字段的历史目录按 `codex` 解释，后台新增模型默认 `codex`。
+- `codex` 仍表示现有 AGC Codex app-server 执行链路；`cc` 表示 AGC 客户端启动随包的 Claude Agent SDK sidecar，模型的 `modelId` 原样作为 Claude Agent SDK 的模型标识，不把 Claude 协议伪装成 OpenAI Responses。sidecar 随 AGC 安装包携带 SDK 及匹配平台的 Claude Code runtime，用户不需要预先安装 `claude` 命令。
+- `/api/llm/models` 的启用模型摘要返回 `agentMode`，后台完整目录、管理 DTO 和客户端目录保持同一绑定快照。客户端在选择模型时同时持久化模型 ID 与执行模式；默认模型变化、模型被停用或目录刷新回退时一并更新执行模式。
+- 客户端设置保存不得把后台模型绑定覆盖回 Codex。旧客户端配置缺少执行模式时继续按 Codex 运行；旧后台响应缺少 `agentMode` 时客户端按 Codex 兼容。
+- `cc` 执行器必须使用 Claude Agent SDK 的 Anthropic 接入方式，通过隔离的 sidecar 运行环境和受控 MCP 桥接 AGC 工具；不得开放 Claude Code 原生 Bash、任意写文件、付费或编辑器执行能力绕过 AGC 宿主门禁。当前 Codex 模式、provider 模式和自定义 LLM 行为不因新增绑定改变。
+- `cc` 模式的进程失败、超时、取消、MCP 断连和无效输出均按失败关闭，不能留下活动回合、执行租约或未确认的子进程；无法找到或启动 Claude Code 时给出可行动错误。
+
 ## 验收

 - 空目录 + 上游可达：启动后目录自动生成（`id` 为模型名 slug、`alias`/`modelId` 为上游原名、`enabled` 全为真、默认项为排序后第一项），`revision` 自增一次，`GET /api/llm/models` 的 `displayName` 就是上游原名，界面不出现任何内置模型名。