README
dsh-acp-enhanced
An enhanced Agent Client Protocol (ACP) server for
DeepSeek Harness (dsh), built for ACP
editors like Zed. It is a drop-in replacement for the official @deepseek-ai/dsh-acp
bridge: the official bridge only streams plain text, this one exposes the Web GUI's
capabilities — streaming, telemetry, model/permission control, session management, MCP —
over the ACP wire.
Features
Output & telemetry
- Token-level streaming, on by default: the reply and the model's thinking reach the
editor while it is still writing (
agent_message_chunk/agent_thought_chunk, coalesced on a 75 ms timer). The one cost of sending text before its block commits is that a mid-block retry cannot take its abandoned partial back: a visible_[stream interrupted — retrying]_marker separates it from the retried attempt. SetstreamDeltas: falseon the acp-enhanced row (DSH_ACP_STREAM_DELTAS=false) for the older block-granularity behaviour, where cancelled/retried attempts never leak torn output at all but nothing renders until the block commits - Full telemetry: context usage ring plus cache hit rate / TPS / input-output-reasoning
tokens / tool timing / turn counts (
usage_update._metacarries the full breakdown). The ring's denominator is the routed model's declaredcontextWindow, folded from the session log so a resumed thread keeps it (the harness logsrequest/contextonce and does not re-emit it for an unchanged route). dsh's owndsh-compaction-basicrow auto-compacts at ~80% of that window and is mounted by thestandard/ptc/cordispresets (neverminimal);/compactforces it manually. A route whose adapter declares nocontextWindowhas no denominator, so the ring reportsused === size. - Image support (multimodal): when the dsh composition mounts an attachment store
(
dsh-attachment-local, mounted by default indsh-base),promptCapabilities.imageis advertised and pasted/uploaded images are ingested into the harness's durable attachment store — a vision-capable model (e.g.deepseek-v4-flash-vision-exp) reads them natively, in wire order with surrounding text. Older stacks (no attachment store) automatically downgrade: image is not advertised and an image prompt is refused with a clear error.
Model & permissions
- Model switching: live
provider/modelcatalog dropdown (ACP grouped-select wire shape) - Reasoning effort:
reasoning_effortdropdown — only when the routed model exposes selectable efforts; each model remembers the effort it last used (persisted per profile), so switching back restores it, and a first-time model falls back to its own default — or its first offered effort — instead of an empty "unknown" selection - Permission presets: read-only / workspace-write / full-access session modes
- Approval: native allow-once / reject-once prompts per tool call
- Agent presets: per-session model-facing composition (tools + prompt sections)
from the dsh agent-preset roster.
standardis the full coding agent (default),minimal(极简模式) is a bare persistent shell with no subagent/web/todo/plan tools — nothing from the host layer leaks into a minimal agent;ptcandcordisship alongside. Your own presets are declared in the profile (see Your own presets) — dsh 0.1.7 no longer discovers~/.dsh/.agent-presets. Choose via theagent_presetconfig option, the/presetcommand, or theDSH_ACP_PRESETenv var (per-session default); switching is only allowed while the session is still blank (no turn has run), so history never straddles two tool sets. A configured preset this roster no longer has does not close the panel: a blank session composes under the roster default and says so on stderr.
Zed deep integration
- Tool cards: one-line summary in the collapsed header —
Read <path>, the model's own intent line for shell commands (description, Codex-style — the exact command stays one click away),Search: <pattern>,Fetch: <url>, etc. The card body follows the ACP best practice: file edits render as a real diff, bash/pwsh commands as a real terminal card (codex-acp wire shape: command line + output + exit pill inside a terminal panel — no more raw-JSON cards), other executors as a syntax-highlighted code block, and touched files as clickable locations that open the file — withrawInput/rawOutputkept one click away for transparency, plus per-kind icons and a proper in-progress → completed/failed status lifecycle - Zed files & terminal:
zed_read_text_file/zed_write_text_file/zed_terminalput file edits into Zed's "edited files" area (diff + accept/reject) and commands into a real Zed terminal - Native form questions:
ask_user_question→elicitation/createform, click an option — or type a custom answer when none of them fit: options render with their descriptions, each option-backed question gets a free-text "Custom answer" field, and a custom answer replaces the single selection / accompanies a multi-select (same semantics as dsh's native question card) - Plan panel: plan mode toggle → "planning" status bar in Zed
Sessions
更多「整合與分享」外掛
dsh-notification
作者 omdsh-dev
DeepSeek Harness 桌面通知外掛,任務完成時提醒,可按結果與關鍵詞規則控制。
dsh-lark-bot
作者 plutokeating
DeepSeek Harness (dsh) 接入飛書/Lark bot,掃碼即用:流式卡片、專案工作區、並行任務、多角色 Agent、跨會話通知、對話內模型/金鑰管理與安全網守護(dsh 崩潰後飛書仍可自救)。A scan-to-connect bridge bot connecting DeepSeek Harness (dsh) into Feishu/Lark: streaming cards, workspaces, parallel tasks, multi-role agents, cross-session notify, in-chat model/key management, and a safety-net guardian.
dsh-session-notification
作者 dingyi222666
為 Deepseek Harness 提供會話完成等四種狀態的通知響應,支援瀏覽器提示和提示詞
dsh-chatgpt-web
作者 wlv-zedd
將標準 ChatGPT Web 直接橋接到 DeepSeek Harness 的 DSH ChatGPT Free 外掛。
