Skip to content

dsh-live-side-chat

Verified

dsh-live-side-chat · v0.4.4 · MIT · Web UI

Live side chat for DeepSeek Harness: an empty read-only conversation in the right sidebar that follows the current session live through a bounded real-time digest, so its progress never goes stale; destroyed when closed.

Install

dsh plugin add dsh-live-side-chat

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

实时侧边对话(dsh-live-side-chat)

中文 | English

给 DeepSeek Harness 加上 Codex 风格的侧边对话:在右侧栏里开一条全新的空会话,实时跟随当前会话的进展,边工作边问「现在进展如何」「刚才那个结论确认一下」,不打断主会话;关闭标签页即销毁。

它不是分支(fork):侧边对话从不复制主会话的历史,而是从空开始、读取实时摘要。

  • 空会话开始:创建子会话时不传 seed、不设 isSeeded,标签页打开就是一条真正的空对话;随时可以创建,不再要求主会话先完成一轮。
  • 实时摘要,不是日志拷贝:侧边对话通过插件自己的有界 sideChatDigest 会话投影了解主会话,并在每一步重新读取、作为运行时上下文注入。创建之后发生的工作也看得见;摘要天然是片段,模型会先用只读工具核实细节再下结论。
  • 只读:侧边会话跑在只读沙箱里(sandbox/mode: read-only + 审批策略 never + 工具守卫),只能查询、不能改文件。守卫拦的是会改变状态的工具:写文件类(write/edit 等)、常驻 shell(terminal)、后台任务(job_*),并按参数拒绝 run_in_background 与任何 sandbox_permissions 升级。一次性 shell 查询(ls、git log)放行——文件写入本来就由只读沙箱拒绝;run_code 也放行,因为 PTC 预设下它是唯一可直接调用的传输。程序内部调用的写类工具仍走同一守卫。这里的"只读"指没有文件效果:沙箱这一层不管网络与进程存活,所以 shell 查询可以访问网络;把 allowShellQueries 设为 false 可以收紧为"只用插件自带只读工具"。
  • 临时:侧边会话在左侧会话列表里隐藏,只活在右侧栏;关闭标签页会确认,确认后销毁(Agent 释放 + 会话文件删除)。
  • 不打扰:主会话照常工作;侧边对话随时读取主会话的实时进展,只有在你明确要求或确有必要时,才会把结论作为后续轮次排给主会话(不会打断当前轮)。

功能

能力 说明
侧边栏入口 右侧栏引导页新增「侧边对话」入口
/btw 在输入框输入 /btw 直接拉起侧边对话
空会话开始 子会话不继承任何历史,标签页打开就是一条真正的空对话
实时摘要 sideChatDigest 投影:目标、每轮一行、当前轮、任务清单、最近工具、计数器,有界且逐条截断
实时上下文 每一步重新读取并作为运行时上下文注入;创建之后发生的工作也可见
状态条 主会话标题、运行/空闲圆点、第 N 轮、任务进度、最新工具、相对活动时间、当前轮提问
背景摘要 状态条里的折叠面板,展开即是模型读到的原文(与注入共用同一渲染函数)
空会话引导 插件自有的引导卡:已连接主会话「<title>」 + 三个快捷问题
输入框 位于面板底部,样式与主对话输入框一致:同一套浮起圆角卡片、只读胶囊与 34px 圆形发送按钮
模型胶囊 显示下一步请求将使用的模型,点开可列出当前 Host 能路由的全部模型(按 provider 分组);切换只影响侧边对话下一轮,不影响主会话
只读工具 side_chat_main_status(最新摘要 + 运行/空闲)与 side_chat_main_history(turn / contains 过滤,有界,真实日志行)
结果汇报 side_chat_report 把结论排给主会话;可在设置面板关闭
关闭确认 「关闭侧边聊天?」弹窗 + 「不再询问」;取消则重新打开标签页
关闭销毁 释放 Agent 并删除该会话的 JSONL 目录;删除结果经持久化层校验后才报告成功

安装

dsh plugin add dsh-live-side-chat

或从本地目录安装(开发时):

dsh plugin add /absolute/path/to/dsh-side-chat

装好后刷新 Web 页面;插件卡片会出现在设置 → 插件列表里。

使用

  1. 在左侧选中一个会话(侧边对话属于当前打开的会话)。
  2. 打开右侧栏,点引导页里的「侧边对话」;或直接在输入框输入 /btw。
  3. 标签页以空对话打开,上方是一条实时状态条:主会话标题、运行/空闲圆点、第 N 轮、任务进度、最新工具、相对活动时间,以及当前轮的提问。
  4. 在右侧输入你的问题。侧边对话每一步都会重新读取主会话摘要,所以创建之后发生的工作也能看到;细节会用 side_chat_main_status / side_chat_main_history 核实。
  5. 想确认它「知道什么」,展开状态条里的「背景摘要」,看到的就是模型读到的原文。
  6. 想让它把结论交给主会话时,直接说「把这个结论告诉主会话」。
  7. 关闭标签页 → 弹出确认框 → 确认后该侧边对话被销毁。

设置

右侧栏面板 →「侧边对话」:

  • 允许向主会话发送消息(默认开启):关闭后,side_chat_report 会被拒绝,侧边对话只能本地回答。

插件行还支持这些部署配置(cordis.patch.yml / profile 里覆盖 side-chat 行):

字段 默认 含义
readOnly true 侧边对话是否强制只读
allowShellQueries true 是否允许一次性 shell 查询(bash/pwsh);关闭后只能用插件自带只读工具
allowReportToMain true(volatile) 是否允许向主会话汇报;可在设置面板修改
liveContext true 是否把主会话摘要作为运行时上下文注入每一步;关闭后只剩按需调用的状态工具
digestTurns 12(4–60) 摘要保留的已结束主会话轮次数量
historyEventLimit 40(5–200) 一次历史读取最多返回的主会话日志行数
preset "" 侧边对话使用的 Agent preset;空表示继承主会话
sessionsRoot "" 会话存储根目录,仅用于销毁时删除文件;空表示 $DSH_HOME/sessions

实现要点(给维护者)

主会话(你正在工作的会话)
    │  每条已提交事件 → 纯增量折叠(有界)
    ▼
sideChatDigest(会话投影,由投影缓存持久化)
    ├── 每一步重读的运行时上下文 ──▶ 侧边对话的模型
    └── Host 全局控制流 ──────────▶ 右侧栏状态条
  • 一次折叠,三方消费:摘要就是一个普通的 sideChatDigest 会话投影(src/digest.ts):框架在每条已提交事件上增量折叠,投影缓存负责持久化,Host 全局控制流把它推给浏览器,所以模型、状态条和重启恢复读的是同一份状态。
  • 有界折叠:每个会话只保留首个用户提问(goal)、最近若干已结束轮次(提问、最终回复、工具数、错误数;digestTurns,4–60)、当前轮(提问、步数、最新助手文本、最近工具调用、错误数、开始时间)、最新一份任务清单、最近工具调用、最近错误、单调计数器与 lastActivityAt。所有字符串都会截断,所有数组都有上限。
  • 作为实时上下文注入:子会话注册 systemPrompt.context({ name: 'side-chat:main-digest', order: 220, text: () => ... }),每一步同步重读主会话摘要,并渲染成「Main session live digest (partial; verify any detail with the side_chat_main_history or side_chat_main_status tool before asserting it)」块。创建之后发生的工作因此可见——这正是 fork 做不到的。
  • 提示词纪律:side-chat:role 段落会说明摘要只是片段、不是日志,模型必须先调用只读工具核实,才能断言「已完成」「文件已改」「错误已修」。
  • Host 侧(src/):用 ctx.agents.create(...) 创建隐藏子会话,不传 seed、不设 isSeeded,所以对话从空开始;setup 里挂载主会话的 preset,注册角色提示词、摘要上下文、三个工具与只读守卫,并写入 sandbox/mode、approval/policy、subagent/descriptor。
    • 为什么必须有 subagent/descriptor:Web 端对 origin: 'subagent' 的会话会拒绝普通历史读取,只有带 descriptor 投影的子会话才能通过 subagent 路由读取历史。
    • 为什么自建输入框:一旦子会话带上 subagent 地址,内置输入框会把 prompt 路由到 subagent 投递(需要父会话激活),因此侧边对话用自己的 Connection RPC 通道 ask 把消息直接投进子 Agent 的 inbox。
  • Client 侧(client/client.js):两种标签页(草稿页 / 会话页)、资源提供者(retain 会话)、带「背景摘要」面板的实时状态条、插件自有的空会话引导卡(替代 dsh 共享的空白首屏,因为那套工作区装饰不适用于侧边对话)、conversation.composer 链条目(替换输入框)、shell.overlay 关闭确认弹窗、/btw 客户端命令、设置面板。
  • 通信:第三方插件无法生成 Typert Remote,Connection 的通用通道又会把路由归属到服务自身上下文,因此本插件直接在 Host Web 服务器上挂一条受鉴权保护的 POST /side-chat/<endpoint> 路由(create / ask / digest / interrupt / destroy;connection.requestRejection 做 Host/Origin 与浏览器凭据校验),明文 JSON、仅本机 owner 可达。
  • 重启恢复:摘要由投影缓存持久化,重启后侧边对话及其「背景摘要」面板会被恢复。

为什么摘要不在聊天记录里

dsh 有意在聊天记录里隐藏普通的运行时上下文行:ui-chat 的 isVisibleChatNode 会排除 kind === 'context',除非该行携带工具变更。摘要正是以这种上下文行注入的,所以它不会出现在聊天记录里。

状态条里的「背景摘要」面板是用户查看它的受支持方式:它由 /side-chat/digest RPC 端点提供,并且和注入共用同一个渲染函数,所以面板内容不会与模型读到的内容漂移。这些渲染快照会累积在侧边对话自己的历史里(dsh 采用追加而不是替换),但只在侧边对话自身运行时发生。

已知限制

  • 进程崩溃或强制退出时,可能留下尚未销毁的 session-side-chat-* 会话目录:启动时不会自动清理隐藏会话,需要手动删除。
  • 关闭确认是「先关闭、后确认」:右侧栏没有标签页关闭否决钩子,关闭后弹窗;点「取消」会把标签页重新打开(会有一瞬的关闭/重开)。
  • 摘要是「有界摘要」而非日志:字符串有截断、数组有上限、更早的轮次每轮只有一行,且不含工具结果、文件内容和大部分中间步骤;细节必须靠只读工具核实。
  • 销毁依赖会话目录布局($DSH_HOME/sessions/<projectKey>/<sessionId>/)。换用非 JSONL 持久化后端或自定义根目录时,需通过 sessionsRoot 配置;删除结果会经 sessionPersistence.stat() 校验,失败会在弹窗里如实报错。
  • 侧边对话复用宿主 subagent 的 descriptor 语义属于「借用机制」:上游升级 descriptor 版本时需同步。基线 dsh 0.2.1-rc.2(commit 687f282e)。
  • sandbox/mode: read-only 只保证写不进去;bash 仍可执行只读命令。
  • 插件依赖 webServer 与 connection,只适用于 Web/桌面端部署;headless 等无 Web 服务的 profile 不会激活 Host 半。

开发

npm install
npm run typecheck
npm test
npm run build    # 产出 lib/,供 dsh plugin add 安装

许可证

MIT © 2026 XBXyftx