dshacp

DSHACP — 让 Zed 用上 DeepSeek

DSHACP 是 DeepSeek Harness（DSH）的一个插件。装好之后，你就能在 Zed 编辑器里直接和 DeepSeek 对话、让它帮你读文件、写代码、跑命令。

English

这是什么？（先花 30 秒看懂）

一句话：DSHACP 是 Zed 和 DeepSeek 之间的"翻译官"。

你（在 Zed 里打字提问）
        │
        ▼
   Zed 编辑器（代理面板）
        │   ← 用 ACP 协议对话
        ▼
   dsh --profile dshacp（装了 DSHACP 插件的 DSH）
        │
        ▼
   DeepSeek（真正回答问题、写代码的大模型）

Zed 自带的是 Claude、GPT 等模型的连接方式。给 DSH 装上 DSHACP 插件之后，Zed 会 多出一个叫 DSH 的"外部代理"，它背后就是 DeepSeek。

装好之后，你能干什么

• 在 Zed 里直接问 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。

一句话：官方 ACP 够用且克制，适合「机器调机器」；DSHACP 是加宽桥，把 DSH 的交互能力完整暴露给 Zed。

Zed ──ACP──► dsh --profile dshacp ──► @hanxu131/dshacp（本插件）

CI  ──ACP──► dsh --profile acp  ──► @deepseek-ai/dsh-acp（官方，互不混装）

开始之前：先准备两样东西

1. DeepSeek Harness（DSH）已装好

打开终端（Terminal），输入：

dsh --version

2. Zed 编辑器

到 https://zed.dev 下载安装。本插件只配合 Zed 使用。

第 1 步：安装 DSHACP 插件

打开终端，输入这一条命令：

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 会话。

第 2 步：在 Zed 里添加 DSH

1. 打开 Zed，按 Cmd + ,（macOS）或 Ctrl + , 打开 Settings（设置）。
2. 左侧找到 AI → External Agents（外部代理）。
3. 点击 Add Custom Agent（添加自定义代理），把下面这段粘贴进去：

{
  "agent_servers": {
    "DSH": {
      "type": "custom",
      "command": "dsh",
      "args": ["--profile", "dshacp"],
      "env": {}
    }
  }
}

这里 command 是 dsh（不是 dshacp）：Zed 会用 dsh --profile dshacp 启动 我们刚才装好的那个 profile。env 留空即可。

成功的样子：Zed 的代理列表里出现一个叫 DSH 的选项。

第 3 步：开始第一次对话

1. 打开 Zed 的代理面板（Agent Panel，通常在编辑器右侧）。
2. 在代理/模型下拉框里选 DSH（不是 Claude、GPT）。
3. 输入一句简单的话，比如：

你好，请告诉我你能做什么。

常见问题（排错）

1. 提示 command not found: dsh

说明 DSH 没装好，回到"开始之前"第 1 条，先 npm install -g @deepseek-ai/dsh。 如果用的是 nvm 管理 Node，装完 重开一个新终端窗口 再试。

2. 一进对话就报缺密钥 / 401 之类的错

密钥是 DSH 侧配置的（由维护者负责），不是这个插件的问题——找维护者在 DSH 里补上 DeepSeek API Key 即可。

3. 点了"允许"，它还是不动

• 确认 Zed 里选的是 DSH 代理
• 打开 Zed 命令面板，输入 dev: open acp logs，看有没有报错信息

4. 换项目之后，之前的对话不见了

每次对话都保存在当前项目目录下的 .sessions 文件夹里（换项目 = 新一批对话）。 想统一存到别处，可以设置环境变量 DSH_SESSIONS_ROOT（见下文）。

5. 重新 add 插件却没升级到新版本

这是 pnpm 的版本锁定/发布年龄门控导致的，不是命令写错：

• dsh plugin add 底层就是 pnpm 的 add。只要 profile 目录里的 pnpm-lock.yaml 已经锁定了某个版本，即使 npm 上出了更新版，add 也不会主动跳版本——它会返回 Already up to date。
• 新发布的版本在 pnpm 的"最低发布年龄"（minimum release age，默认数天）之内时， 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": {
  "type": "custom",
  "command": "dsh",
      "args": ["--profile", "dshacp"],
  "env": {},
  "default_config_options": {
    "model": "deepseek-official:deepseek-v4-pro",
    "thought_level": "high",
    "permission": "workspace-write"
  }
}

npm install -g @hanxu131/dshacp

git clone git@github.com:ECHOUniverse/dshacp.git
cd dshacp
npm install
npm run build   # 编译 TypeScript
npm test        # 跑测试

./scripts/dev-link-dsh-profile.sh   # build → npm pack → 装进 ~/.dsh/profiles/dshacp

./scripts/dev-unlink-dsh-profile.sh

更多资料

• 设计与实现计划：docs/DESIGN.md
• 研究笔记：docs/ 目录下的各 *-fact-sheet.md
• Zed 外部代理官方文档：https://zed.dev/docs/ai/external-agents
• ACP 协议：https://agentclientprotocol.com

许可证

MIT —— 见 LICENSE。