[开源] deepseek-acp：把 DeepSeek Harness 接成一个面向编辑器的完整编码智能体

本帖使用社区开源推广，符合推广要求。我申明并遵循社区要求的以下内容：

- 我的帖子已经打上 开源推广 标签： 是

- 我的开源项目完整开源，无未开源部分： 是

- 我的开源项目已链接认可 LINUX DO 社区： 是

- 我帖子内的项目介绍，AI生成、润色内容部分已截图发出： 是

- 以上选择我承诺是永久有效的，接受社区和佬友监督： 是

以下为项目介绍正文内容，AI生成、润色内容已使用截图方式发出

deepseek-acp

把 DeepSeek Harness 接成一个面向编辑器的完整编码 Agent， 通过 Agent Client Protocol（ACP）与客户端通话。

可用客户端：任何实现 ACP 的编辑器。开发期在 codeg 里实测； Zed 走同一套协议、配置方式见下，但尚未逐项验收过。

github.com

GitHub - xintaofei/deepseek-acp: 把 DeepSeek Harness 接成一个面向编辑器的完整编码 Agent， 通过 Agent...

把 DeepSeek Harness 接成一个面向编辑器的完整编码 Agent， 通过 Agent Client Protocol（ACP）与客户端通话。

为什么存在

DeepSeek Harness 自带一个 ACP server（@deepseek-ai/dsh-acp），但它的定位是 automation-only——给程序用的，不是给人用的。上游自己的说明写得很直白：

This package is a transport adapter, not a UI integration or a capability seam. It does not expose editor navigation, transcript replay, commands, modes, configuration pickers, elicitation, reasoning, plans, titles, or tool presentation.

它的主要客户端是 dsh-subagent-acp——一个父 harness 派生子 agent 的通道。对这个用途， 它的设计是对的：只发已提交的助手消息，不漏未提交的中间态，拿到的是干净的自动化结果。

但同一套设计放进编辑器就不成立了：

- 看不到模型在干什么。 工具调用、命令输出、文件改动全部只留在会话日志里，界面上 只有最后一段文字。模型改了你的文件，你得自己去 git diff 才知道。

- 没有逐字流式。 只在整段消息提交后才推一次，长回答期间界面是静止的。

- 一次性会话。 关掉就没了——没有恢复、没有列表、没有标题。

- 控制面全无。 换模型、调文件权限、开计划模式、执行 slash 命令，都没有入口。

- 拒绝 MCP。 mcpServers 只要非空就直接报错。

官方其实实现过一版完整的编辑器向 bridge，又在 2026-07-24 主动删掉了——理由是产品定位， 不是技术不可行。本项目填的就是这块被让出的生态位：同一个 harness 内核，换一张 为人准备的协议面。

与内置 ACP 的能力对比

|
@deepseek-ai/dsh-acp（内置） |
deepseek-acp（本项目） |

定位 |
automation-only 传输适配器 |
面向编辑器的完整 Agent |

回复流式 |
仅整段提交后推送 |
逐 token |

思考过程 |
✗ 留在日志里 |
^-^ agent_thought_chunk |

工具调用 |
✗ 不呈现 |
^-^ 卡片 + 状态流转 |

文件 diff |
✗ |
^-^ 编辑器原生 diff 视图 |

终端输出 |
✗ |
^-^ 终端卡片（Zed _meta 约定） |

待办计划 |
✗ |
^-^ plan + 计划模式 |

会话恢复 / 列表 |
✗ 关掉即消失 |
^-^ load / list / resume / close，带标题 |

会话内换模型 |
✗ |
^-^ 模型、推理档位、文件权限三个选择器 |

slash 命令 |
✗ |
^-^ 命令目录，不进模型 |

技能（skills） |
✗ |
^-^ 模型按需加载；用户可调用的进斜杠补全 |

模型向你提问 |
✗ |
^-^ 表单征询；客户端不支持时降级成按钮 |

MCP server |
✗ 非空即拒绝 |
^-^ 按会话挂载，stdio + HTTP，会话间隔离 |

上下文用量 |
✗ |
^-^ usage_update 进度条 |

读未保存的缓冲区 |
✗ |
^-^ fs/read_text_file 改道到编辑器 |

内嵌上下文（@ 文件） |
✗ embeddedContext: false |
^-^ 整段内联 |

授权提示 |
^-^ 一次性 allow / reject |
^-^ 同左，另含沙箱越界提权 |

多会话 |
|
|

沙箱。 命令与文件操作同在一道围栏之下（默认 workspace-write，可写集是 {会话 cwd, /tmp, 系统临时目录}），bash 与文件工具共用同一份定义。越界会被拒绝， 模型可以就该次操作发起提权，提示走 session/request_permission。

内置工具：bash、read、write、edit、glob、grep、todo_write、 ask_user_question、exit_plan_mode。

刻意不做的：fs/write_text_file 委托（会绕开沙箱围栏，让「文件权限」选择器形同虚设）、 后台任务（自发回合发出的更新没有对应的 stopReason 归属）。受阻于上游的：图片输入、 session/delete、MCP 的 sse / acp 传输。

注册到编辑器

可执行文件是 deepseek-acp，通过 stdio 说 ACP，不接受任何参数。

API Key 填在客户端的环境变量里（下面两份配置都有位置）。别指望 .zshrc 里的 export——编辑器是 GUI 应用，不继承登录 shell 的环境，它派生的子进程同样拿不到。

Zed

settings.json 里加一个 agent_servers 条目：```
{
"agent_servers": {
"DeepSeek Harness": {
"type": "custom",
"command": "npx",
"args": ["-y", "deepseek-acp"],
"env": { "DEEPSEEK_API_KEY": "sk-..." }
}
}
}
``装到全局（npm i -g deepseek-acp）的话，command 填 deepseek-acp、args` 留空即可。

codeg

设置 → 智能体 → 添加自定义智能体 → 手动填写：

字段 |
值 |

注册表 ID |
deepseek-acp |

显示名称 |
DeepSeek Harness |

版本 |
0.1.1 |

分发信息（JSON） |
{"npx": {"package": "[email protected]", "cmd": "deepseek-acp"}} |

环境变量 |
DEEPSEEK_API_KEY=sk-... |

版本查询命令 |
留空 |

MCP 支持 |
开着即可 |

「版本」要与分发信息里的版本一致——codeg 的 preflight 会对账，对不上的表现是 连接阶段失败而不是报错。

MCP 开着时，codeg-mcp 会作为 server 挂进来，模型看到的工具名带会话前缀 （mcp__a1_codeg-mcp__<tool>）：serverName 在进程内全局唯一，而 ACP 的 mcpServers 是每会话参数，不加前缀时第二个会话会挂不上。

会话日志

默认写在 $DSH_HOME/sessions（即 ~/.dsh/sessions），可用 DEEPSEEK_ACP_SESSIONS_ROOT 覆盖。会话恢复、列表与标题都从这里读。