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
Installation
Prerequisites: Node.js ≥ 20, dsh (developed against dsh@0.1.1-rc.2), pnpm.
dsh plugin --profile acp add github:cnctem/dsh-acp
From source:
git clone https://github.com/cnctem/dsh-acp.git
dsh plugin --profile acp add ./dsh-acp
Configuration
- Model/provider defaults to dsh's default model; override via
DSH_ACP_PROVIDER / DSH_ACP_MODEL (or edit the acp row in $DSH_HOME/profiles/acp/cordis.patch.yml).
- Agent preset via
DSH_ACP_PRESET — an optional field whose value directly names the preset mounted for every session: the value is the preset id, no roster constraint on your side. Unset or empty → standard; a value naming no existing preset fails session creation with an error. Valid ids are the shipped standard / minimal presets, plus any preset you author under $DSH_HOME/.agent-presets/<id>/ (the user root is a preset root by default).
- The
code (PTC) and cordis (creation) presets are not in dsh-base. They need the code-runtime and cordis-host-runner plugins installed globally (in the profile's cordis.patch.yml), after which you can pick code / cordis via DSH_ACP_PRESET like any other preset.
- API key reuses dsh credentials (
$DSH_HOME/.credentials.yaml or DEEPSEEK_API_KEY).
Integration
Add to Zed's settings.json:
{
"agent_servers": {
"dsh": {
"type": "custom",
"command": "dsh",
"args": ["--profile", "acp"],
"env": {}
}
}
}
Restart Zed and pick dsh. Fix a model or preset via env (DSH_ACP_PRESET directly names the preset to mount — empty → standard, unknown id → session error; standard / minimal work out of the box, and globally installed presets are supported too):
{
"agent_servers": {
"dsh-minimal": {
"type": "custom",
"command": "dsh",
"args": ["--profile", "acp"],
"env": { "DSH_ACP_PRESET": "minimal" }
}
}
}
Zed also supports multiple entries for the same acp, so different presets can coexist as separate entries in the "+" menu.
Acknowledgements
