现象
packages/agent-help/zcode-agent-help 中 version_described / tested_against 静态写死为 "0.16.1 (App 3.6.5)"(第 165-168 行):
"version_described": "0.16.1 (App 3.6.5)",
# 整体 review P2-6: version_described 是"静态清单基于该版本实测"的意思;
"tested_against": "0.16.1 (App 3.6.5)",
ZCode 已发布更新:本机(Mac mini)与双 VPS 上的 App 已到 3.7.7(CLI 0.16.3,zcode.cjs --version 实测)。get_zcode_capabilities(MCP)与 zcode-agent-help --pretty 输出的能力清单因此声称基于 0.16.1 实测,与实际环境版本不符。
影响
- 能力清单的
since / limitations 等字段围绕 0.16.1 编写,0.16.2 / 0.16.3 若有 CLI 或协议变更(例如 --allowed-tools / --max-turns 是否接线、auto 模式、updateRuntimeModelConfig 的 revision 要求),清单会漏报或误导调用方
- 本机
~/.agents/skills/dispatch-zcode 等下游已按实际环境 0.16.3 / App 3.7.7 更新描述,与 bridge 内置清单口径不一致
建议
- 实测 0.16.3 上清单中的关键不确定项(
--allowed-tools / --max-turns 是否仍报 Unknown option、auto 模式、updateRuntimeModelConfig revision 必填等),有变化则更新清单内容,无变化则仅把 version_described / tested_against 提到 0.16.3 (App 3.7.7)
- 或改为运行时动态探测:
version_described 用 zcode --version 实测值填充,清单仍注明"知识基于 0.16.1 实测"
补充
0.16.3 headless 本身工作正常(--prompt / --mode / --disallowed-tools 链路在 Mac mini 与 contabo 双机持续运行),本 issue 仅针对能力清单描述层。
现象
packages/agent-help/zcode-agent-help中version_described/tested_against静态写死为"0.16.1 (App 3.6.5)"(第 165-168 行):ZCode 已发布更新:本机(Mac mini)与双 VPS 上的 App 已到 3.7.7(CLI 0.16.3,
zcode.cjs --version实测)。get_zcode_capabilities(MCP)与zcode-agent-help --pretty输出的能力清单因此声称基于 0.16.1 实测,与实际环境版本不符。影响
since/limitations等字段围绕 0.16.1 编写,0.16.2 / 0.16.3 若有 CLI 或协议变更(例如--allowed-tools/--max-turns是否接线、auto模式、updateRuntimeModelConfig的 revision 要求),清单会漏报或误导调用方~/.agents/skills/dispatch-zcode等下游已按实际环境 0.16.3 / App 3.7.7 更新描述,与 bridge 内置清单口径不一致建议
--allowed-tools/--max-turns是否仍报 Unknown option、auto模式、updateRuntimeModelConfigrevision 必填等),有变化则更新清单内容,无变化则仅把version_described/tested_against提到0.16.3 (App 3.7.7)version_described用zcode --version实测值填充,清单仍注明"知识基于 0.16.1 实测"补充
0.16.3 headless 本身工作正常(
--prompt/--mode/--disallowed-tools链路在 Mac mini 与 contabo 双机持续运行),本 issue 仅针对能力清单描述层。