dushaobindoudou/dsh-acp 预览 preview

dushaobindoudou/dsh-acp

用于 DeepSeek Harness (dsh) 的 Agent Client Protocol (ACP) 服务端插件——通过 stdio / HTTP+SSE 从 Zed、任何 ACP v1 客户端或内置 Web UI 驱动 dsh 代理,在线上包括会话、任务、目标、技能及代理树。

Project Overview项目介绍

This repository is a native DSH plugin that provides an Agent Client Protocol (ACP) v1 server for DeepSeek Harness. It enables any ACP-compatible client to drive the full DSH coding agent, with support for streaming output, tool calls, permission prompts, and durable sessions. You can run it as a standalone server connected via stdio for editors like Zed, Neovim, Emacs, and Obsidian, or run it alongside DSH’s existing web UI for remote HTTP access. To install the standalone version, you just need to run npm i -g dsh-acp-server and add a single entry to your editor’s agent server settings.

Two deployment modes are supported to fit different use cases. The standalone mode is ideal for developers who want to use DSH directly from their favorite code editor. After global installation via npm, you just add the dsh-acp-server command to your editor’s agent configuration, and you can start using DSH without opening the DSH web UI. The combined mode works for users who already use DSH’s web interface and want to add ACP access without separate deployment. After running the simple setup script, every boot of dsh web will serve both the GUI and ACP endpoint on the same port.

This project requires Node.js version 22 or higher, and you must have the DSH CLI installed globally first to work correctly. The package automatically handles bootstrapping the ACP profile for DSH on first run, so you don’t need to manually configure most settings. It is released under the open source MIT license, and all core ACP v1 methods are currently supported. Features like session forking, audio input, and document sync are still in active development, and community contributions are welcome.

本仓库是专为 DeepSeek Harness (DSH) 开发的原生 Agent 客户端协议(ACP)服务器插件,可启动完整的 DSH 编码代理,支持流式输出、工具调用、权限提示和持久化会话。它支持通过标准输入输出、HTTP 等方式对接 ACP v1 客户端,让任何符合 ACP 协议的客户端都能像原生客户端一样驱动 DSH 代理,Zed 编辑器、Neovim、Emacs、Obsidian 等工具都可以直接对接使用。

开发者可以通过两种方式部署使用:一种是独立部署,全局安装 dsh-acp-server 包后直接作为命令行工具启动,在编辑器的代理服务器配置中填入对应命令即可使用;另一种是和 DSH 的 Web UI 一起部署,安装插件后启动 DSH Web 就会同时启用 ACP 服务。它主要面向需要在自己常用的编辑器或第三方客户端中使用 DSH 编码代理能力的开发者,不用切换到 DSH 自带的 Web 界面就能调用 DSH 的全部功能。

本项目依赖 Node.js 22 及以上版本,同时需要提前全局安装 DSH CLI,首次使用会自动完成 ACP 配置文件的引导配置,不需要用户手动修改复杂配置。项目采用 MIT 开源许可证,目前已经支持绝大部分 ACP v1 定义的核心方法,会话分支、音频、文档同步等功能仍在开发中,欢迎开发者参与贡献代码。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 9 stars - very few users, little community feedback星标只有 9,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile acp add dsh-acp-server

把 dushaobindoudou/dsh-acp 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-acp-server

npm CI License: MIT

Agent Client Protocol (ACP) server for the DeepSeek Harness (dsh).

Drive a full dsh coding agent - streaming output, tool calls, permission prompts, durable sessions - from Zed or any ACP v1 client, exactly like opencode or Gemini CLI.

English | 中文

What it does

A dsh profile bundle that boots the entire DeepSeek Harness (agent loop, tools, sandbox, session persistence) with an ACP v1 JSON-RPC server instead of - or alongside - the web UI.

ACP method Status
initialize ✅ full capability advertisement (loadSession, promptCapabilities.image, sessionCapabilities.list/resume/close)
session/new ✅ durable dsh agent + modes + slash-command advertisement
session/prompt ✅ streaming agent_message_chunk / agent_thought_chunk (reasoning), plan updates, full tool-call lifecycle, {stopReason}; failed turns reject with a JSON-RPC error carrying the cause; image blocks persist through the dsh attachments service; a single /command text block routes to the dsh command registry
session/list ✅ every persisted + live session (id, cwd, title)
session/resume ✅ reopen a persisted session without replay (standard form of the vendor method)
session/load ✅ reopen + replay the transcript as user_message_chunk / agent_message_chunk
session/set_mode ✅ default ⇄ plan, bridged to dsh plan mode, with current_mode_update push
available_commands_update ✅ the dsh command registry, advertised per session and refreshed each turn
session/request_permission ✅ dsh's approval seam bridged to the client (allow once/always, reject once/always)
session/cancel ✅ aborts the turn, prompt resolves cancelled
session/close ✅ cancels, flushes, disposes the agent

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev awesome-dsh-plugin 下一个 Next dsh-usage-billing →