Skip to content

363550c 静默删掉了 cursor / openclaw / hermes 三个 guide-only 条目,README 仍在描述它们 #44

Closed

Description

@yujiezhang-ops

开源评审会要求把 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)。这两条路的工作量差很多。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions