开源评审会要求把 Hermes、OpenClaw 加回适配列表。核对代码后发现它们不是"从未支持",而是**今天被一个无关提交顺带删掉的**,而且文档没跟着改——这是先要修的部分。 ## 事实 `363550c`(2026-08-05 13:45,提交信息为 `feat: sort provider by creation time desc`)从 `agents.lock.json` 删除了 39 行,内容是三个 guide-only 条目: ``` - "cursor": { "command": "cursor", ... - "openclaw": { "command": "openclaw", - "guide": "Install from OpenClaw docs, then run: openclaw onboard --install-daemon && openclaw gateway status", - "hermes": { "command": "hermes", - "guide": "Install Hermes, then configure models with hermes model or ~/.hermes/config.yaml.", ``` 提交信息只提到 provider 排序,完全没有提及删除 Agent。`agents.lock.json` 现在只剩 5 个条目:codex、claude-code、opencode、kilo-cli、aider,全部是 `config_mode: auto`。**当前没有任何 guide-only Agent。** ## 文档已经与实现不符 以下位置仍然声称这三个存在: - `README.md:111` — "OpenClaw, Hermes, and Cursor are guide only" - `README_ZH.md:87` — 同上 - `docs/ai-agent-kit/zh/04-agent-guides.md:41,45` — OpenClaw / Hermes 各有一节 - `docs/ai-agent-kit/zh/03-config-tools.md:61` - `docs/distribution-compliance-policy.md:99` - `frontend/src/pages/AgentSelectionPage.test.tsx:104` — 注释提到 Cursor、OpenClaw、Hermes 这是**开源前对外文档虚报功能**,比缺功能更糟:用户按 README 下载后找不到条目。 ## 需要做什么 1. 恢复 `agents.lock.json` 里的三个条目(`git show 363550c -- agents.lock.json` 有原文,直接反向应用即可) 2. 补 `frontend/src/components/icons/agents.tsx` 的标识。注意 `docs/internal/cc-switch-reference-notes.md:81` 已结论 **OpenClaw 与 Hermes 的图标不可取用**(CC Switch 的 OpenClaw 图标是自绘、Hermes 只有 256×256 PNG 且无权利依据),所以这两个必须走 Lucide 通用符号,不要从任何第三方项目转绘 3. 决定 Cursor 是否一并恢复(它在 README 里与另两个并列,但会议只点名了 Hermes 和 OpenClaw) ## 边界确认 会议定义的适配边界是:只负责安装、更新、Provider 与基础模型配置,未完成则跳转对应页面。但 `docs/internal/cc-switch-reference-notes.md:33` 记录的现有结论是 **OpenClaw 和 Hermes 保持 guide-only,理由是常驻网关形态被 ADR-002/ADR-003 划在范围外,与能否安装无关**。 如果这次要让它们从 guide-only 升级为可安装,那是在改 ADR-002 划定的产品边界,按 `CLAUDE.md` 的规则**需要新的 ADR**,不能只改 lock 文件。建议先明确:是恢复原状(guide-only),还是升级为可安装(需 ADR)。这两条路的工作量差很多。
Activity