ACP 斜杠命令 cyclon-b/dsh-acp-commands

dsh-acp-commands

斜杠命令 —— /goal、/compact、/plan、/permission、/feedback —— 用于在 Zed（或任何其他 ACP 客户端）里运行的 DeepSeek Harness 智能体。

Русская версия

问题

在 DeepSeek Harness 里，斜杠命令属于 UI 层功能：一个注册表（ctx.commands），加上每个前端（Web UI、命令行）各自持有的适配器。ACP 桥接层 —— @deepseek-ai/dsh-acp —— 有意只暴露标准 ACP v1 接口：

- 没有 available_commands_update，所以客户端不会渲染 / 菜单；
- 没有斜杠分发，所以 /goal … 会被当成纯文本发给模型。

命令的生产者本身（dsh-commands、dsh-goal、dsh-command-goal、 dsh-command-compact、dsh-plan-mode、dsh-permission-presets、 dsh-command-feedback）已经由基础包在 acp 配置档里挂载好了。缺的只是桥接层。

对照 deepseek-ai/deepseek-harness@master 在 2026-10-23 的状态核查过：桥接层仍然没有命令接口，所以这个仓库不是上游工作的重复。

这个仓库提供什么

ACP 桥接层的增量分支，带四个钩子，外加一套工具，用来安装、验证，以及在 dsh 升级后重新生成它。

| 命令 | 在 Zed 会话里的行为 |
| /goal [<objective> \| clear \| edit <objective> \| pause \| resume] | 创建/编辑目标，打印状态、轮次和激活状态 |
| /compact | 执行一次手动压缩 |
| /plan [off \| <message>] | 进入/退出计划模式 |
| /permission <preset> | 切换权限预设 |
| /feedback <text> | 反馈通道 |

/export 和 /file 不会出现：它们住在 web 宿主和 web 客户端 UI 里，不在基础包中。

工作原理

lib/index.js 是 @deepseek-ai/dsh-acp@0.2.1-rc.2 的补丁副本。四个钩子及其精确代码片段记录在 docs/patches.md。

1. 通告。 在 session/new 和 session/resume 之后，以及再次在 commands/change 时，桥接层发送 session/update，带上 sessionUpdate: "available_commands_update"，把
ctx.commands.list(agent) 的描述符映射到 ACP 的 AvailableCommand
（{name, description, input: {hint}}）。
2. 顺序很重要。 通告用 setTimeout(…, 0) 调度，让 session/new 的 响应先到达客户端。按会话 id 路由更新的客户端 —— 包括 Zed —— 会丢弃尚未注册的会话的通知。
3. 分发。 如果 session/prompt 恰好是一个文本块，且开头字节是已注册的命令行，桥接层就调用 ctx.commands.execute(agent, line, [], signal)，而不是 admitAcpPrompt。结算后的文本作为 agent_message_chunk 发出，提示词返回 {stopReason: "end_turn"}。
4. 回退。 未知的 /… 输入，或任何携带非文本块的提示词，仍然会发给模型。以前能用的功能，现在照样能用。

环境要求

- dsh 0.2.1-rc.2（已测试）。这个分支是编译后的 JS 副本，换用其他版本需要重新打钩子，见更新。
- Zed 加 External Agents（在 1.25.3 上测试过），或任何支持 available_commands_update 的 ACP v1 客户端。
- Node.js ≥ 22，PowerShell 5.1+（Windows）或 sh（POSIX）。

安装

Windows（已测试）

git clone https://github.com/cyclon-b/dsh-acp-commands.git
cd dsh-acp-commands
powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1

POSIX（尽力支持，未测试）

git clone https://github.com/cyclon-b/dsh-acp-commands.git
cd dsh-acp-commands
./install.sh

两个安装脚本都会做三件事：

1. 把分支复制到 <npm root -g>/@deepseek-ai/dsh/node_modules/dsh-acp-commands；
2. 把这个目录链接到 ~/.dsh/profiles/acp/node_modules/dsh-acp-commands （Windows 用 junction，其他平台用符号链接）；
3. 修改 ~/.dsh/profiles/acp/cordis.patch.yml，停用自带的 acp 行，挂载 acp-commands，并沿用相同的服务商/模型配置。

不要用 dsh plugin --profile acp add 安装这个包。
分支必须和 dsh 安装的其余部分解析到同一批 cordis、dsh-agent 和 ACP SDK 实例。
在配置档里建 pnpm 依赖树会复制出第二份服务，启动时报 service "compaction" has been registered at <BasicCompactionEngine>。
所以安装脚本把包放进全局 dsh 安装目录，只把它链接进配置档。

重复运行安装脚本是幂等的。如果已安装的 dsh 版本和分支编写时的版本不一致，两个脚本都会给出警告；重新推导钩子后，Windows 上再加 -Force。

这里刻意不做 npm registry 分发：从 registry 安装会落到独立的模块树，正好撞上前面说的重复实例问题。支持的安装方式只有 git clone（或 release tarball）加安装脚本。

在 Zed 里注册智能体

如果还没注册，把它加到 Zed 的设置（settings.json）里——见 Zed: External Agents：

{
"agent_servers": {
"DeepSeek Harness": {
"type": "custom",
"command": "cmd",
"args": ["/c", "dsh", "--profile", "acp"],
"env": {}
}
}
}

macOS/Linux 上改用 "command": "dsh", "args": ["--profile", "acp"]——只有 Windows 需要 cmd /c，因为 dsh 的 shim 是 .cmd/.ps1，CreateProcess 没法直接执行。

然后：Agent Panel → 新建会话 → 智能体选 DeepSeek Harness → 输入 /。
传输层调试：dev: open acp logs。

不装 Zed 也能验证

scripts/probe.ps1 通过 stdio 驱动真实的 ACP 服务器（; 分隔多条提示词）：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\probe.ps1
-Prompts "/goal demo objective;/goal;/compact;/plan;reply with pong"
预期：先收到一个 available_commands_update，携带这五个命令，然后依次收到每个命令的结果文本，最后是模型的回答。

为新的 dsh 版本更新

全局升级会替换安装目录，fork 也在其中。

1. 升级：npm i -g @deepseek-ai/dsh@<version>。
2. 把四个钩子移植到新的 node_modules/@deepseek-ai/dsh-acp/lib/index.js 上 —— docs/patches.md 里有准确的锚点和代码片段。
3. 运行 npm run check（检查语法和钩子标记），然后重新跑一遍探测。
4. 用 -Force 重新安装。

卸载 powershell powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1 -Revert

或者 ./install.sh --revert。原版桥接会重新提供 acp 配置档。

已知行为与限制

- /goal 会启动自主工作。 目标轮次驱动器由基础包挂载，所以创建目标就等于把它武装起来：智能体开始自主轮次，/compact 随后回答 agent is not idle，之后一条普通提示词会排队，直到智能体稳定下来。这是 DSH 原版的目标语义，不是桥接的缺陷。
- 带附件的命令不会被拦截 —— 这类提示词会直接交给模型。
- /export、/file 按设计就不存在（仅限 web 宿主 / web 客户端）。
- 未知命令会回退给模型，而不是被拒绝：ACP 没有标准的拒绝通道，而把以 / 开头的普通文本误判成命令会更糟。
- 这个 fork 没有合并到上游，也不携带 DSH 专属的展示数据：没有计划卡片、待办列表、终端，也没有通过 ACP 的引导问答。

许可证

MIT —— 见 LICENSE 和 NOTICE。lib/index.js 是 @deepseek-ai/dsh-acp 的衍生作品（MIT，Copyright (c) 2026 DeepSeek）。与 DeepSeek 无隶属关系，也未获其背书。