dsh-acp-sidechat
Manifest validDeepSeek Harness right-sidebar ACP chat: ThinkThread daemon or local ACP agent, native conversation rendering, session switching
dsh-acp-sidechat
ACP engines in your DeepSeek Harness right sidebar — ThinkThread daemon or a local stdio agent.
一个 DSH 插件:在右侧栏里和 ACP 引擎对话,正文用宿主原生的会话组件渲染 (消息、代码块、表格、工具卡、轮次分隔都是原生),工具调用作为轨迹出现在同一轮里。
后端二选一(backend):
| 后端 | 引擎进程 | 说明 |
|---|---|---|
thinkthread(默认) | ThinkThread daemon 托管 | @thinkthread/sdk,接口对齐 mio_buddy,见 docs/thinkthread-backend.md |
acp-stdio | 本地子进程(hermes acp) | 插件自己 spawn,保留旧路径 |
特性
- 原生渲染:通过
conversation.content工厂槽渲染一个真实 DSH 会话,不画任何自定义消息 UI。 - 多轮上下文:一个 DSH 会话对应一个 ACP session,上下文由 agent 进程自己持有。
- 工具轨迹(原生卡):
tool_call/tool_call_update投影成tool/call/tool/result,并把 ACP 的kind映射成原生 wire 名 (execute→bash、read→read、search→grep、fetch→web_fetch、edit→edit),补齐原生卡要的 arguments 与[exit code: N], 所以工具卡与原生会话里的长得一样,而不是Tool call · execute这种通用卡。 - 思考与打字机都走原生:thought chunk 投影成原生
reasoning块;assistant/message的stream记录满足原生dt.length === texts.length - 1契约(客户端据此逐字回放)。 - 输入卡:会话不带 agent,所以原生 composer 是死的——由插件绘制一个同风格的输入卡(Enter 发送、Shift+Enter 换行、运行中变停止键)。
- 会话切换与管理:默认挂在原生页签操作菜单(
…→「会话与历史…」/「新建会话」),点开才是浮层列表,正文不常驻任何自绘 UI;ui.sessionBar: inline可改成正文顶部常驻一条会话栏。 - 零侵入:不改宿主、不占用 Web GUI 路由表,只加一个页签类型和一条
/acp-sidechat/rpc。 - 可换后端:ThinkThread daemon(多引擎,daemon 托管)或任意说 ACP v1 的本地可执行文件。
环境要求
| 项 | 要求 |
|---|---|
| DSH | >= 0.2.1-rc.3(用到了 conversation.content 工厂 + conversation/session 视图) |
| Node | >= 22.19 |
| 后端 | thinkthread:daemon + @thinkthread/sdk >= 0.2.12(可选依赖);acp-stdio:任意 ACP v1 可执行文件(默认 hermes acp) |
安装
# 本地目录
dsh plugin --profile web add /path/to/dsh-acp-sidechat
# 或 GitHub
dsh plugin --profile web add github:<you>/dsh-acp-sidechat
装完重启 dsh web(Host 侧模块只在启动时加载),刷新页面。
入口有三处:
- 右侧栏引导页 →「ACP 侧聊(hermes)」
- 任意会话标题栏 →「ACP」按钮
- 已打开的页签 →「连接 hermes」
配置
cordis.patch.yml 里的 config:
| 字段 | 默认 | 说明 |
|---|---|---|
backend | thinkthread | thinkthread / acp-stdio(hermes 是 acp-stdio 的别名);也可用 DSH_SIDECHAT_BACKEND |
ui.sessionBar | menu | menu=原生页签菜单入口 + 按需浮层(正文零自绘节点);inline=正文顶部常驻会话栏;off=只保留 RPC |
cwd | Host 进程 cwd | 会话工作目录 |
thinkthread.daemonUrl | http://127.0.0.1:7788 | 也可用 THINKTHREAD_DAEMON_URL |
thinkthread.daemonToken | — | 也可用 THINKTHREAD_DAEMON_TOKEN |
thinkthread.agent | hermesagent | manifest 名,解析为 ~/.thinkthread/agent-manifests/<name>.yaml;内置名 hermesagent claude codex opencode pi … |
thinkthread.manifestFile | — | 直接指定 manifest yaml 路径(优先于 agent) |
thinkthread.manifest | — | 直接给完整 manifest 文档对象(优先于 manifestFile) |
thinkthread.rootDir | $THINKTHREAD_HOME / ~/.thinkthread | manifest 注册表根目录 |
thinkthread.model | 引擎默认 | 显式指定模型 |
thinkthread.threadId | — | 复用已有 thread;省略则 threads.create |
thinkthread.accessLevel | full_access | 会话访问级别 |
thinkthread.permissionPolicy | allow_once | allow_once / deny / callback |
acpStdio.command / .args | hermes / ['acp'] | 仅 acp-stdio 后端使用;建议写绝对路径 |
工作原理
右栏页签 (sidebar.right.pane.tab, key = 包名)
└ dsh-resource://acp/session/<id> ← 资源协议 'acp'
└ ctx.resources.register({ protocol:'acp', open() → { sessionId, reference } })
└ SessionProvider(reference)
└ renderFactorySlot('conversation.content', {variant:'embedded', phase:'active'},
{ slots: { views: ChatView } }) ← ChatView = renderSlot('conversation.session', {view:'chat'})
└ 插件输入卡(会话无 agent → 原生 composer 被 CSS 隐藏)
Host 半:
createBackend()按backend造后端:thinkthread走@thinkthread/sdk(threads.create→waitForReady('acpReady')→sessions.open→session.ask),acp-stdio则 spawn 本地子进程;- 会话是 不带 agent 的 DSH Session(
ctx.sessions.create),只用来承载事件; POST /acp-sidechat/rpc:open/prompt/cancel/state/meta/sessions/close;- 后端统一推
session/update形状的通知 → 会话事件(投影层不区分后端):
ACP session/update | DSH 事件 |
|---|---|
agent_message_chunk | 累积文本,工具调用前 / 轮次结束时落一条 assistant/message(带 stream 分片) |
tool_call | tool/call(先 flush 文本,再开新 step) |
tool_call_update | tool/result |
轮次结束(session/prompt / session.ask() 结束) | step/end + turn/end |
会话切换与管理
| RPC | 参数 | 作用 |
|---|---|---|
sessions | { sessionId? } | 列引擎侧会话,附 bound(已有 DSH 会话)/ current 标记;引擎不支持时 supported:false + note |
open | { backendSessionId? } | 省略 = 新建会话;带 id = 切到已有会话(已绑定直接复用,否则 attachSession 载入历史) |
close | { backendSessionId? | sessionId? } | 关引擎侧会话并解绑;busy 时拒绝 |
state | { sessionId } | 返回 busy / backend / 后端 sessionId |
- 一个后端会话 ↔ 一个 DSH 会话:切回已经打开过的会话不会丢历史,也不会重复建会话。
- 切换失败(会话不存在 / 引擎重启丢失)会明确报错,不会偷偷开新会话把历史冲掉。
- 宿主没有删除 DSH 会话的 API,所以「关闭」= 关引擎侧会话 + 解绑,页签由前端自己关。
两个必须注意的坑
- 资源地址与 patterns:
openResource只接受dsh-resource://<type>/…;页签类型必须声明patterns: ['dsh-resource://acp/**'],只写canOpen不够——注册表先按 patterns 收窄。 - webServer 必须显式 inject:Host 半用
ctx.webServer.register注册路由,如果inject里不写'webServer',冷启动时可能在 webserver 之前 apply,从而静默不注册路由(表现为点按钮 405)。
已知限制
- 段落式落盘:文本在段落结束(工具调用前 / 本轮结束)时一次性落盘,打字机交给客户端回放
stream。assistant/message只能surfaceOp: 'append'(replace 会打崩宿主,见 CHANGELOG 0.1.1)。 - 权限无卡片:
session/request_permission/permission_request按permissionPolicy自动答复。 - 附件:只支持纯文本 prompt;图片要自己写进 workspace 再在 prompt 里引用。
- thread 级切换:只接会话级(
sessions/open|load|resume),没做tt.threads.list()的跨 thread 浏览。
开发
Host 半与 client 半都在 Host 进程内按 URL 加载:改完必须重启 dsh-web(或重新启用 bundle)才生效,
换文件名不是必须的(host-v2.js 只是历史遗留的版本号后缀)。
node --check host-v2.js && node --check client.js && node --check backends/thinkthread.js && node --check backends/acp-stdio.js
node --test tests/*.test.mjs # 用 SDK 替身,不需要真 daemon
curl -s -X POST http://127.0.0.1:3080/acp-sidechat/rpc -H 'content-type: application/json' -d '{"method":"meta"}'
License
MIT
Comments
Loading…
Similar plugins
by lilinfangrelax
Connect DeepSeek Harness (dsh) to the coding agents already installed on your machine over ACP: local detection, official ACP Registry, native chat routing and subagent delegation.
★ 0
MIT
JavaScript
Nov 13, 2026
dsh plugin --profile web add dsh-acp-agentsby Tureen
Resumable ACP subagent backend for DeepSeek Harness — persistent chat pool with session/load reconnect & mid-turn steering. Tested with kiro-cli.
★ 2
MIT
TypeScript
Nov 9, 2026
dsh plugin --profile web add dsh-acp-resumeby Iambatman1928
Chat agent for a DeepSeek Harness session: characters and personas, several archive threads per character, an undoable/rewindable local transcript, and an event book.
★ 0
MIT
JavaScript
Sep 25, 2026
dsh plugin --profile web add dsh-xingyeby SilenZerOrz
ACP adapter to drive DeepSeek Harness from Obsidian Agent Client (and other ACP clients): list, resume and fork sessions, run the harness, and archive conversations.
★ 4
↓ 927/wk
MIT
JavaScript
Nov 17, 2026
dsh plugin --profile web add obsidian-dsh-acpby openma-ai
ACP server implementation for DeepSeek harness. dsh-acp
★ 68
↓ 2.4k/wk
NOASSERTION
TypeScript
Nov 19, 2026
dsh plugin --profile web add @openma/deepseek-harness-acpby cnctem
ACP server for DeepSeek Harness — bridges Zed and other IDEs to dsh agents
★ 4
↓ 58/wk
MIT
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-acp