openma-ai/deepseek-harness-acp 预览 preview

openma-ai/deepseek-harness-acp

DeepSeek工具架的ACP服务器实现。dsh-acp

Project Overview项目介绍

openma-ai/deepseek-harness-acp is a native DeepSeek Harness (DSH) plugin that acts as an adapter connecting ACP (Agent Client Protocol) clients like Zed editor and Backchat to DSH. It offers two official installation paths: the recommended path as a DSH profile plugin, and a standalone server path for users who want to connect an ACP client without managing a full DSH profile. It maps all DSH session event logs to the full ACP vocabulary, and reuses DSH’s existing credential store so users do not need to re-enter their DeepSeek API keys in their editor config.

This plugin is targeted at developers who use ACP-compatible code editors like Zed and want to leverage DSH’s AI-assisted coding capabilities. The standard setup workflow starts with installing the global DSH CLI, then logging in and saving your DeepSeek API key through the DSH web UI. After that, you install the adapter via the DSH plugin command, add the corresponding startup entry to your ACP client’s settings file, and you can start using DSH directly from within your editor.

The package requires Node.js version 22.15 or newer to run, and bundles DSH runtime version 0.1.5-rc.1 internally. If you already have a working DSH installation on your system, your existing DSH install will take precedence over the bundled runtime. Currently, multi-root workspaces are not supported, and session logs upgraded to the new format cannot be read by older DSH hosts. The project is released under the open-source Apache-2.0 license, so there is no cost to use or modify it.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,作为适配器让支持 Agent Client Protocol (ACP) 的客户端(如 Zed 编辑器、Backchat)对接 DSH。它支持两种安装方式:推荐作为 DSH 配置文件插件安装,也可作为独立 npm 包全局安装。它能将 DSH 的会话事件日志转换为完整 ACP 格式,复用 DSH 已保存的凭证,无需在编辑器中重复配置 API 密钥。

面向希望在 ACP 兼容客户端中使用 DSH AI 能力的开发者,最典型的使用场景是在 Zed 编辑器中调用 DSH 的编码能力。标准工作流为:先安装全局 DSH CLI,在 DSH 网页界面完成登录并保存 DeepSeek API 密钥,接着通过 DSH 插件命令安装本适配器,最后在 ACP 客户端的配置文件中添加对应启动项,即可在客户端内直接调用 DSH 服务。

本项目依赖 Node.js 版本不低于 22.15,内置绑定的 DSH 运行时版本为 0.1.5-rc.1,若系统已安装 DSH 则优先使用已有安装版本。目前不支持多根工作区,升级后的会话日志无法被旧版本 DSH 主机读取。项目采用 Apache-2.0 许可证开源,无使用费用限制。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 38 stars - an early-stage project星标 38,属于早期项目
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 -w @openma/deepseek-harness-acp

把 openma-ai/deepseek-harness-acp 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

Agent Client Protocol × DeepSeek Harness

deepseek-harness-acp

Use DeepSeek Harness from Agent Client Protocol clients such as Zed and Backchat.

npm version npm downloads CI ACP protocol v1 Apache-2.0 node >= 22.15


The adapter composes the harness in-process and maps its session-event log onto the full ACP vocabulary: streamed text and reasoning, tool calls with diffs and display terminals, plans, permission requests, session modes, config options, slash commands, skills, and MCP servers. Credentials never touch your editor config — it reuses the key you saved in the dsh Web UI, or dsh-acp login saves one to the same store.

One package, standalone or plugin

A · dsh profile plugin (recommended) B · Standalone server
Best for Normal installation and upgrades Connecting an ACP client without managing a dsh profile
Install dsh plugin --profile acp add @openma/deepseek-harness-acp@latest npm i -g @openma/deepseek-harness-acp
Zed runs dsh --profile acp dsh-acp
Harness The dsh that owns the profile Your installed dsh, then the package's locked private runtime
Composition dsh-base + this bundle + your profile's own patches dsh-base + this bundle (profile machinery booted in-process)

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

← 上一个 Prev dsh-minimal-turbo 下一个 Next DshCockpit →