@hanxu131/dshacp
面向 Zed 的 ACP v1 服务器，驱动 DeepSeek Harness (DSH)：提供令牌流式传输、工具调用、审批、计划和会话管理的独立 stdio 桥接器
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @hanxu131/dshacp@0.2.1Acp 以 @hanxu131/dshacp 发布，当前版本为 0.2.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSHACP 是 DeepSeek Harness（DSH）的一个插件。装好之后，你就能在 Zed 编辑器里直接和 DeepSeek 对话、让它帮你读文件、写代码、跑命令。
一句话：DSHACP 是 Zed 和 DeepSeek 之间的"翻译官"。
你（在 Zed 里打字提问）
│
▼
Zed 编辑器（代理面板）
│ ← 用 ACP 协议对话
▼
dsh --profile dshacp（装了 DSHACP 插件的 DSH）
│
▼
DeepSeek（真正回答问题、写代码的大模型）
Zed 自带的是 Claude、GPT 等模型的连接方式。给 DSH 装上 DSHACP 插件之后，Zed 会 多出一个叫 DSH 的"外部代理"，它背后就是 DeepSeek。
dsh --profile acp 有什么区别？DSH 0.1.2 起，官方在 npm 上同时提供 @deepseek-ai/dsh-acp（dsh --profile acp）和本插件
@hanxu131/dshacp（dsh --profile dshacp）。两者都走 ACP v1 / stdio，但定位不同，不要装进同一个 profile。
官方 @deepseek-ai/dsh-acp | 本插件 DSHACP | |
|---|---|---|
| 启动 | dsh --profile acp | dsh --profile dshacp |
| 面向谁 | CI、脚本、自动化流水线 | Zed 等交互式 ACP 客户端 |
| 会话 | 基本 new / prompt / cancel | list / load / resume / delete / close 等完整生命周期 |
| 流式 | 以回合级文本为主 | token 级 assistant/chunk、reasoning、工具输入输出 |
| 审批 | 较简 | 推送 request_permission 到客户端，支持 allow once / always |
| 配置 | 无 | Zed 面板可选 model / thinking / permission / mode（agent preset） |
| 扩展 | 无 | slash 命令、plan、ask_user_question（elicitation）、HTTP MCP 转发、可选 hybrid 写文件 |
| 安装 | DSH 自带 / 官方 profile | dsh plugin --profile dshacp add @hanxu131/dshacp |
一句话：官方 ACP 够用且克制，适合「机器调机器」；DSHACP 是加宽桥，把 DSH 的交互能力完整暴露给 Zed。
Zed ──ACP──► dsh --profile dshacp ──► @hanxu131/dshacp（本插件）
CI ──ACP──► dsh --profile acp ──► @deepseek-ai/dsh-acp（官方，互不混装）
打开终端（Terminal），输入：
dsh --version
到 https://zed.dev 下载安装。本插件只配合 Zed 使用。
打开终端，输入这一条命令：
dsh plugin --profile dshacp add @hanxu131/dshacp
首次安装会直接装到 npm 上的最新版（
latest），无需指定版本号。
已装过的用户升级时，推荐直接用 update 命令（无需手动写版本号）：
dsh plugin --profile dshacp update @hanxu131/dshacp
为了让它稳定生效，先在 profile 目录的 pnpm-workspace.yaml 里永久关闭发布年龄门控，
加一行 minimumReleaseAge: 0：
# 打开 ~/.dsh/profiles/dshacp/pnpm-workspace.yaml，在 autoInstallPeers 那行下面加上：
minimumReleaseAge: 0
没有这行时，npm 上刚发布的新版本（官方默认"发布年龄"需满数天）会被 pnpm 的 供应链门控挡下，
update会误报Already up to date。设为0即永久关闭门控， 之后update会正常追到最新版。
升级完成后，退出并重开 Zed 里的 DSH 会话（或重启 dsh --profile dshacp 进程），
新代码才会被加载。
备选：若不想改配置，也可显式带版本号
dsh plugin --profile dshacp add "@hanxu131/dshacp@^0.2.0"；但由于add存在 lock 锁定、update更省心，日常仍建议用上面的update方式。
acp profile 迁移（0.2.0 起）DSH 0.1.2 起，官方 dsh --profile acp 留给 @deepseek-ai/dsh-acp（自动化专用 ACP）。
DSHACP 改用独立 profile dshacp，不要与官方 acp profile 混装。
若你曾把本插件装进 ~/.dsh/profiles/acp：
dsh plugin --profile acp remove @hanxu131/dshacp
dsh plugin --profile dshacp add @hanxu131/dshacp
然后把 Zed 配置里的 "args": ["--profile", "acp"] 改成 "dshacp"，并重启 DSH 会话。
Cmd + ,（macOS）或 Ctrl + , 打开 Settings（设置）。{
"agent_servers": {
"DSH": {
"type": "custom",
"command": "dsh",
"args": ["--profile", "dshacp"],
"env": {}
}
}
}
这里
command是dsh（不是dshacp）：Zed 会用dsh --profile dshacp启动 我们刚才装好的那个 profile。env留空即可。
成功的样子：Zed 的代理列表里出现一个叫 DSH 的选项。
你好，请告诉我你能做什么。
command not found: dsh说明 DSH 没装好，回到"开始之前"第 1 条，先 npm install -g @deepseek-ai/dsh。
如果用的是 nvm 管理 Node，装完 重开一个新终端窗口 再试。
密钥是 DSH 侧配置的（由维护者负责），不是这个插件的问题——找维护者在 DSH 里补上 DeepSeek API Key 即可。
dev: open acp logs，看有没有报错信息每次对话都保存在当前项目目录下的 .sessions 文件夹里（换项目 = 新一批对话）。
想统一存到别处，可以设置环境变量 DSH_SESSIONS_ROOT（见下文）。
add 插件却没升级到新版本这是 pnpm 的版本锁定/发布年龄门控导致的，不是命令写错：
dsh plugin add 底层就是 pnpm 的 add。只要 profile 目录里的 pnpm-lock.yaml
已经锁定了某个版本，即使 npm 上出了更新版，add 也不会主动跳版本——它会返回
Already up to date。update 也会被供应链安全门控挡下，同样显示 Already up to date。推荐做法：永久关闭门控 + 用 update 追新（见「第 1 步 → 更新到新版本」）。
在 ~/.dsh/profiles/dshacp/pnpm-workspace.yaml 加一行 minimumReleaseAge: 0 后，
升级命令就固定为：
dsh plugin --profile dshacp update @hanxu131/dshacp
若不愿改配置，也可以临时显式带版本号（profile 名 acp、包名 @hanxu131/dshacp，
从 0.1.3 升到 0.1.4）：
# ✅ 临时可行：显式带上目标版本范围
dsh plugin --profile dshacp add "@hanxu131/dshacp@^0.1.4"
# ❌ 无效：不带版本、或只写 @latest，都会被锁定/门控挡住
dsh plugin --profile dshacp add @hanxu131/dshacp
dsh plugin --profile dshacp add "@hanxu131/dshacp@latest"
升级完记得重启 Zed 里的 DSH 会话（或重启 dsh --profile dshacp 进程）让新代码生效。
| 变量 | 作用 |
|---|---|
DSH_SESSIONS_ROOT | 会话保存目录（默认 ./.sessions） |
DSH_PERMISSION_MODE | workspace-write（默认，会弹确认框）或 danger-full-access（不再弹确认框） |
DSHACP_HYBRID | 设成 1 开启混合模式：写文件时交给 Zed 展示 diff 供你审查 |
装好之后，Zed 的 DSH 面板里可以直接选 model、thinking strength、Permissions、mode。 也可以在配置里写死默认值（下面是示例，模型名以面板里实际显示的为准）：
"DSH": {
"type": "custom",
"command": "dsh",
"args": ["--profile", "dshacp"],
"env": {},
"default_config_options": {
"model": "deepseek-official:deepseek-v4-pro",
"thought_level": "high",
"permission": "workspace-write"
}
}
model 的写法是 提供商:模型；只写模型名也可以，程序会自动找到对应的提供商。
Permissions（permission）控制 sandbox 与审批策略，可选值通常为：
workspace-write（默认）：沙箱限制工作区外写入，敏感操作会弹出确认框danger-full-access：无沙箱限制，也不再弹出确认框mode 是 agent preset（工具集 / 技能配置），与 Permissions 无关；不要与 ACP 文档示例里「mode 控制 permission」的语义混淆。
如果你不想用 DSH profile，也可以直接装成独立的 dshacp 命令：
npm install -g @hanxu131/dshacp
然后在 Zed 里把 command 改成 dshacp、args 留空。功能与插件方式一致。
git clone git@github.com:ECHOUniverse/dshacp.git
cd dshacp
npm install
npm run build # 编译 TypeScript
npm test # 跑测试
不要用 npm link 链源码目录——会把 repo 的 node_modules/ 带进 profile，导致 Cordis 插件双份加载（deployment:persona already registered）或缺少依赖（schemastery not found）。
在仓库根目录执行：
./scripts/dev-link-dsh-profile.sh # build → npm pack → 装进 ~/.dsh/profiles/dshacp
改代码后重新跑该脚本，并重启 Zed 里的 DSH 会话。恢复 npm 发布版：
./scripts/dev-unlink-dsh-profile.sh
docs/DESIGN.mddocs/ 目录下的各 *-fact-sheet.mdMIT —— 见 LICENSE。
uv/uvx 和 qwenmm 插件后，可以直接把截图粘进
Zed 让模型"看图"。详见 docs/P5-image-paste-qwenmm.md。dsh plugin --profile dshacp add @linxin666/dsh-ssh。DSHACP_HYBRID=1，文件改动以 diff 形式呈现，逐块审查。initialize、session/new、session/load、session/resume、
session/list、session/delete、session/close、session/set_config_option、
session/prompt、session/cancelsession/request_permission、session/request_elicitation、
session/updateauthenticate/logout、session/set_mode、fs/*、terminal/*src/bin.ts — 独立二进制的启动入口src/index.ts — 应用主体（ACP 桥接）src/bridge.ts — ACP v1 桥接（会话、流式、审批等）src/codec.ts — 编解码cordis.yml / cordis.patch.yml / dshacp.patch.yml — 组合配置（cordis.patch.yml
是插件安装时生效的那一层）tests/ — 测试