DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-acp-sidechat

t

dsh-acp-sidechat

Manifest valid

DeepSeek Harness right-sidebar ACP chat: ThinkThread daemon or local ACP agent, native conversation rendering, session switching

UI (client)hasBundlePatch

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 侧模块只在启动时加载),刷新页面。

入口有三处:

  1. 右侧栏引导页 →「ACP 侧聊(hermes)」
  2. 任意会话标题栏 →「ACP」按钮
  3. 已打开的页签 →「连接 hermes」

配置

cordis.patch.yml 里的 config:

字段默认说明
backendthinkthreadthinkthread / acp-stdio(hermes 是 acp-stdio 的别名);也可用 DSH_SIDECHAT_BACKEND
ui.sessionBarmenumenu=原生页签菜单入口 + 按需浮层(正文零自绘节点);inline=正文顶部常驻会话栏;off=只保留 RPC
cwdHost 进程 cwd会话工作目录
thinkthread.daemonUrlhttp://127.0.0.1:7788也可用 THINKTHREAD_DAEMON_URL
thinkthread.daemonToken—也可用 THINKTHREAD_DAEMON_TOKEN
thinkthread.agenthermesagentmanifest 名,解析为 ~/.thinkthread/agent-manifests/<name>.yaml;内置名 hermesagent claude codex opencode pi …
thinkthread.manifestFile—直接指定 manifest yaml 路径(优先于 agent)
thinkthread.manifest—直接给完整 manifest 文档对象(优先于 manifestFile)
thinkthread.rootDir$THINKTHREAD_HOME / ~/.thinkthreadmanifest 注册表根目录
thinkthread.model引擎默认显式指定模型
thinkthread.threadId—复用已有 thread;省略则 threads.create
thinkthread.accessLevelfull_access会话访问级别
thinkthread.permissionPolicyallow_onceallow_once / deny / callback
acpStdio.command / .argshermes / ['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 半:

  1. createBackend() 按 backend 造后端:thinkthread 走 @thinkthread/sdk(threads.create → waitForReady('acpReady') → sessions.open → session.ask),acp-stdio 则 spawn 本地子进程;
  2. 会话是 不带 agent 的 DSH Session(ctx.sessions.create),只用来承载事件;
  3. POST /acp-sidechat/rpc:open / prompt / cancel / state / meta / sessions / close;
  4. 后端统一推 session/update 形状的通知 → 会话事件(投影层不区分后端):
ACP session/updateDSH 事件
agent_message_chunk累积文本,工具调用前 / 轮次结束时落一条 assistant/message(带 stream 分片)
tool_calltool/call(先 flush 文本,再开新 step)
tool_call_updatetool/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,所以「关闭」= 关引擎侧会话 + 解绑,页签由前端自己关。

两个必须注意的坑

  1. 资源地址与 patterns:openResource 只接受 dsh-resource://<type>/…;页签类型必须声明 patterns: ['dsh-resource://acp/**'],只写 canOpen 不够——注册表先按 patterns 收窄。
  2. 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

dsh-acp-agents

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.

Manifest valid

★ 0

MIT

JavaScript

Nov 13, 2026

dsh plugin --profile web add dsh-acp-agents

by Tureen

Resumable ACP subagent backend for DeepSeek Harness — persistent chat pool with session/load reconnect & mid-turn steering. Tested with kiro-cli.

Manifest valid

★ 2

MIT

TypeScript

Nov 9, 2026

dsh plugin --profile web add dsh-acp-resume

by 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.

Tools & CapabilitiesUI & ExperienceManifest valid

★ 0

MIT

JavaScript

Sep 25, 2026

dsh plugin --profile web add dsh-xingye

by 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.

Tools & CapabilitiesTerminal & ClientsSessions & MessagesManifest valid

★ 4

↓ 927/wk

MIT

JavaScript

Nov 17, 2026

dsh plugin --profile web add obsidian-dsh-acp

by openma-ai

ACP server implementation for DeepSeek harness. dsh-acp

Tools & CapabilitiesManifest valid

★ 68

↓ 2.4k/wk

NOASSERTION

TypeScript

Nov 19, 2026

dsh plugin --profile web add @openma/deepseek-harness-acp

by cnctem

ACP server for DeepSeek Harness — bridges Zed and other IDEs to dsh agents

Tools & CapabilitiesSessions & MessagesManifest valid

★ 4

↓ 58/wk

MIT

JavaScript

Oct 21, 2026

dsh plugin --profile web add dsh-acp