ACP 增强服务 AndPuQing/dsh-acp-plus

dsh-acp-plus

为 DeepSeek Harness（dsh）扩展的 Agent Client Protocol（ACP）服务器，打包成树外 Cordis 插件和配置档 bundle。

它提供标准 ACP v1 接口，并补上了官方那个只做自动化的 @deepseek-ai/dsh-acp 桥接刻意省略的能力——transcript 回放、额外工作区根目录、斜杠命令、计划模式、表单征询、回合中途引导——同时不改动 harness 核心。

dsh --profile acp-plus

功能

- 标准 ACP v1 —— 会话（new / list / resume / close）、提示词与取消、模型与推理强度配置选项、MCP 服务器（stdio 和 streamable HTTP）、图片、权限、用量、工具更新。
- session/load —— 重新打开已持久化的会话，回放其 transcript，跨进程重启继续提示。
- 额外目录 —— 在会话上声明额外工作区根目录；其中经过验证的单目标写入会走 harness 现有的沙箱升级流程预先批准，其余一切仍然询问客户端。
- 命令与模式 —— 发布 harness 命令列表，不经过模型回合直接执行 /name，并声明 default / plan 模式。
- 征询 —— 当客户端声明支持时，把 ask_user_question 桥接到标准 ACP 的 elicitation/create 表单。
- 引导 —— _session/steering 扩展在实时回合的下一步注入文本，若回合已结束则把文本交还。
- 默认模型回退 —— 自身配置里没有服务商/模型时，桥接跟随组合的 agent-default-model（也就是 dsh Web Models 页面写入的同一个默认值）。

要求

- Node.js >= 22
- 配置好模型路由的 DeepSeek Harness（dsh）。插件的 @deepseek-ai/dsh- peer 依赖锁定到正在运行的 harness 版本（^0.2.0-rc.1）。

安装

从 GitHub：

dsh plugin --profile acp-plus add github:AndPuQing/dsh-acp-plus

从本地检出：

dsh plugin --profile acp-plus add .

构建产物（lib/）已提交，所以两种方式都不会跑构建脚本。改动源码后，运行 npm run build 并把 lib/ 连同改动一起提交。

如果想替换官方 acp 配置档里的原生桥接：

dsh --profile acp --patch ./overlay-on-native-acp.yml

用法

dsh --profile acp-plus

stdout 只输出 ACP JSON-RPC；诊断信息走 stderr。用任意 ACP 客户端连接该进程。

Zed

Zed 通过 agent_servers 启动外部智能体。在远程项目里，智能体运行在远程 Zed 服务器上，所以该设置应放在远程服务器设置中（zed: open server settings，即远程的 ~/.config/zed/settings.json）：

{
"agent_servers": {
"dsh-acp-plus": {
"type": "custom",
"command": "/bin/sh",
"args": ["-lc", "exec dsh --profile acp-plus"],json
"env": {}
}
}
}

sh -lc 会读取登录 shell 的 PATH；用 dsh 的绝对路径也可以。
重新连接远程项目，在智能体选择器里选 dsh-acp-plus。
模式、斜杠命令、session/load 回放，以及 ask_user_question（客户端声明表单引导时）都可用；客户端终端有意不支持。日志： ~/.local/share/zed/logs/server-preview-.log。

配置

配置档补丁配置 bridge 那一行：

| 字段 | 类型 | 默认值 | 说明 |
| provider | string | agent-default-model | 新智能体的服务商路由（例如 deepseek-official）。 |
| model | string | agent-default-model | 精确的模型 id（例如 deepseek-v4-flash）。 |
| sessionListPageSize | integer >= 1 | 100 | 一页 session/list 最多返回的会话数。 |
| enableSessionLoad | boolean | false | 对外声明并提供 session/load 会话记录回放。 |
| enableAdditionalDirectories | boolean | false | 接受 additionalDirectories，并做包含性检查后预批准。 |

随附的配置档同时启用 enableSessionLoad 和 enableAdditionalDirectories。

查看合成后的配置及其 schema： sh
dsh --profile acp-plus --dump-config
dsh --profile acp-plus --dump-config-schema

模型与凭据

provider / model 可选。不设置时，bridge 跟随 agent-default-model —— 也就是 dsh Web Models 页面写入的默认模型服务 —— 这样部署只需配置一次模型，每个入口都跟着走。服务商路由（llm-pi-ai 服务商）和默认模型可以放进 $DSH_HOME/cordis.patch.yml，在多个配置档之间共享。

注意，DSH 补丁会替换目标行的整个 config 对象：覆盖 acp-plus 行时，必须重新写一遍 sessionListPageSize、enableSessionLoad 和 enableAdditionalDirectories。只配置模型不会动那一行。

API key 属于 home 级别，所有配置档共享（$DSH_HOME/.credentials.yaml，由 Web Models 页面写入，或通过启动环境提供）。

与原生 bridge 的关系

随附的 @deepseek-ai/dsh-acp 按设计只做自动化。本项目保留其协议语义并加以扩展：

| 能力 | @deepseek-ai/dsh-acp | dsh-acp-plus |
| 会话、提示词、取消、MCP、图片、配置选项 | 支持 | 支持（对等） |
| session/resume、session/list、session/close | 支持 | 支持 |
| session/load 会话记录回放 | 不支持 | 支持 |
| additionalDirectories | 不支持 | 支持 |
| 命令、模式 | 不支持 | 支持 |
| 表单引导 | 不支持 | 支持 |
| _session/steering | 不支持 | 支持 |

兼容性

- 标准 ACP v1，加上对外声明的会话能力和 _session/steering 扩展；不认识某个扩展的客户端会忽略它。
- 所有 @deepseek-ai/dsh-* 对等依赖都锁定在 ^0.2.0-rc.1，并由
dsh 的插件预检。如果 harness 版本不同，就按诊断信息给出的说明，授予精确版本豁免
（dsh plugin allow-version <name>@<version>）。

开发 sh
npm run build # esbuild -> lib/（改完源码后重新构建并提交）
npm run check # tsc，只检查项目文件
npm test # 无需密钥：esbuild 打包测试 -> node --test
npm run release:check # 构建 + manifest、profile 和 peer 检查

仓库结构、硬性约束，以及 bridge 如何跟随原生实现，见 DEVELOPMENT.md。

许可证

MIT。部分内容源自 DeepSeek Harness，
Copyright (c) 2026 DeepSeek，在 MIT 许可证下使用。