cnctem/dsh-acp 预览 preview

cnctem/dsh-acp

Plugin插件 Native原生 ⭐ 5 MIT Notifications & Remote通知与远程

用于DeepSeek Harness的ACP服务器——将Zed及其他IDE与dsh智能体连接起来。

Project Overview项目介绍

dsh-acp is a native DSH plugin that runs an Agent Client Protocol (ACP) server, enabling Zed Editor and other compatible IDEs to control DSH agents over JSON-RPC 2.0 via standard input/output. It is built as a DSH profile bundle based on the official DSH ACP skeleton from the deepseek-ai/dsh repository, and extends the core framework with improved editor-focused features borrowed from pi-acp. To install the plugin from GitHub, run dsh plugin --profile acp add github:cnctem/dsh-acp from your terminal after installing DSH, Node.js 20+, and pnpm. You can also install it from source by cloning the repository and running the local install command, and no changes to your existing DSH are needed.

After installation, you will need to update your Zed Editor configuration to add DSH as a custom agent server. Open Zed’s settings.json file, add an entry for dsh that sets the type to custom, the command to dsh with args --profile acp, then save the file and restart Zed to apply the changes. Once Zed restarts, you can select the newly added DSH agent from Zed’s agent menu to start using it for your coding and debugging tasks. You can even add multiple separate entries for different DSH agent presets, so all presets appear as distinct options in Zed’s add agent menu.

dsh-acp is released under the permissive MIT open source license, and it reuses the DSH API credentials you already have configured in your DSH installation, so no new API key setup is required. You can set environment variables to override the default model and provider used for ACP sessions, and you can also specify a custom agent preset via the DSH_ACP_PRESET environment variable. Presets that are not included by default, such as code and cordis, require additional global plugins to be installed in the ACP profile before they can be used. The plugin is currently developed against dsh@0.1.1-rc.2, so compatibility with newer versions may vary.

这是一个专门为DeepSeek Harness(DSH)开发的原生插件,它实现了Agent客户端协议(ACP)服务器,允许Zed等IDE通过JSON-RPC 2.0标准的stdio传输驱动DSH代理运行。该插件基于DSH官方提供的@deepseek-ai/dsh-acp开发骨架搭建,是基于dsh-base的配置包扩展,同时吸收了pi-acp的编辑器交互经验。用户无需修改DSH本体,通过DSH自带的插件命令即可完成安装。

这款插件面向同时使用Zed编辑器和DeepSeek Harness的开发者,能够打通Zed与DSH之间的通信通道,让Zed可以直接调用DSH的代理能力。安装完成后,用户仅需在Zed的settings.json中添加对应的DSH代理服务器配置项,重启Zed后即可选择DSH作为编码代理,获得DeepSeek大模型的代码辅助支持。它支持令牌流式输出、工具卡片展示、结构化差异对比、会话历史管理等多种功能。

该项目采用MIT许可证开源,使用前需要先满足依赖条件:Node.js版本不低于20,已安装DSH(当前适配版本是dsh@0.1.1-rc.2)和pnpm包管理器。用户可以通过环境变量自定义配置默认的模型、服务商和代理预设,如果需要使用code或cordis预设,还需要额外安装对应的全局插件。API密钥直接复用DSH已配置的凭证,无需额外配置。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 5 stars - very few users, little community feedback星标只有 5,几乎没人在用,遇到问题缺少社区反馈
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 github:cnctem/dsh-acp

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

READMEREADME

dsh-acp

cover

简体中文 · 技术文档 / Technical notes

An Agent Client Protocol (ACP) server for DeepSeek Harness (dsh) that lets Zed and other IDEs drive dsh agents over JSON-RPC 2.0 stdio.

Built on the official @deepseek-ai/dsh-acp skeleton as a dsh profile bundle over dsh-base, and extended with the editor experience of pi-acp.

Introduction

dsh-acp mounts an ACP server on dsh's stdin/stdout. Zed launches dsh --profile acp and speaks ACP JSON-RPC over stdio; the plugin translates session/* requests into dsh agent lifecycles. No dsh modification required.

Features

  • Token & thinking streaming — agent_message_chunk / agent_thought_chunk
  • Tool cards — tool_call / tool_call_update with kind, file location and line
  • Structured diffs — edit/write hunks plus before/after snapshots
  • Session history — session/list · session/load · session/delete
  • Session selectors — write permission (3) · model · thinking strength
  • Agent presets — deployment-wide preset selection via DSH_ACP_PRESET: the built-in standard / minimal modes (other modes need global mounting in the profile, see Configuration), plus any preset you author under $DSH_HOME/.agent-presets/
  • Bash terminal — command output rendered as terminal content with exit code
  • Context-usage ring — usage_update (used / size) feeds the IDE's context indicator
  • Todo list — dsh's todo_write snapshots rendered as the IDE's plan checklist (plan update), cleared when a new turn begins
  • Image understanding — ACP image prompt blocks (e.g. screenshots) admitted through dsh 0.1.1's durable attachment seam (dsh-attachment) and fed to the model as ImageBlocks, with a capability advertisement that lets Zed send images
  • Slash commands — dsh's / commands advertised via available_commands_update, executed in the command plane (images handed to commands that accept them)
  • Ask the user — dsh's ask_user_question tool answered through ACP form elicitation (options, multi-select, free text), with a self-explaining fallback for clients without the elicitation capability

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-image-bridge 下一个 Next dsh-timeline-studio-plugin →