Skip to content

dsh-live-side-chat-nested

Verified

dsh-live-side-chat-nested · v0.6.15 · MIT · Web UI

Live side chat for DeepSeek Harness with multiple and nested side chats: many empty read-only conversations can be open at once in the right sidebar, and a side chat can spawn a child side chat that follows it live.

Install

dsh plugin add dsh-live-side-chat-nested

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

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Creators

Readme

实时侧边对话(可嵌套)dsh-live-side-chat-nested

中文 | English

基于 dsh-live-side-chat 0.4.3(MIT)的本地分支,把「侧边对话」从单例扩展为:

  • 可同时开多个 — 每次打开都会新建一个侧边对话,右侧栏可以并排多个标签页;/btw 和引导页不再抢回已打开的那个。
  • 可嵌套 — 状态条上的 + 会在当前侧边对话下再开一个,新对话跟随的是它而不是根会话;默认最多 3 层。
  • 可从选中文字打开 — 选中一段文字后,选择浮出的「引用文本 / 在侧边对话中引用」中的后者,新对话会在输入框里引用这段文字并聚焦,等你写下问题。

侧边对话仍然不是分叉:不复制上级会话历史,以空会话起步(选中文字打开的只在输入框里带着引文),靠有界实时摘要跟随。

保留的能力

  • 实时摘要,不是日志副本 — sideChatDigest 会话投影在每一步重新读取并注入运行时上下文,创建之后发生的进展也看得见;摘要是有界的,所以模型断言前会用只读工具核对。
  • 只读 — sandbox/mode: read-only,审批固定为 never,并拦截改状态的工具:文件修改类工具、常驻 shell(terminal)、后台任务,以及 run_in_background、任何 sandbox_permissions 提权。一次性 shell 查询(ls、git log)允许,写操作由沙箱拒绝;run_code 允许(PTC 预设只暴露它)。只读指不产生文件效果,网络与进程存活不受沙箱限制——可用 allowShellQueries: false 只保留插件自带只读工具。
  • 临时 — 侧边会话不出现在左侧会话列表,只存在于右侧栏;关闭时确认后销毁(agent 释放、会话文件删除)。关闭父级会级联关闭它下面的所有侧边对话。
  • 不打断 — 上级会话继续工作;只有你明确要求或确有必要时,才把结论作为后续轮次交回去。

功能

能力 说明
多标签 每次打开都新建;标签标题带序号(侧边对话 2),多开也分得清
嵌套 状态条 + 打开子对话,受 maxDepth 限制;子对话的摘要、状态条、历史/状态工具与汇报对象都是它的上级侧边对话
根会话参考 嵌套对话额外收到根会话摘要(带标签的只读块),并可使用 side_chat_root_status / side_chat_root_history;rootContext: false 只关闭这个块,工具仍可用
选中浮层 选中文字后浮出「引用文本」和「在侧边对话中引用」(右键菜单已移除)。后者把引文填进新对话的输入框并聚焦;在侧边对话内选中会嵌套,在别处则与现有侧边对话平级
键盘快捷键 macOS Desktop 默认 Cmd+E(可在 设置 → 快捷键 中改键):有选中文字时与右键菜单一致,打开带引文的输入框;没有选中文字时打开空对话。Web 版与其他平台默认不绑定(浏览器限制纯 Cmd/Ctrl 组合)
引导页 / /btw 每次都新建一个侧边对话;/btw <prompt> 会把这段文字作为新对话的第一轮
空会话起步 子会话不继承历史;选中文字打开时输入框里带引文,但未发送
实时摘要 目标、每轮一行、当前轮、待办、最近工具、计数——全部有界裁剪
状态条 上级标题、运行/空闲点、轮次、待办进度、最新工具、相对活动时间、当前轮提示、+
背景摘要 状态条内折叠面板,展开后是模型读到的同一份文本
模型切换 显示下一轮将用的模型与推理强度;菜单里可以为当前模型选推理强度,也可以切换到 Host 能路由的任意模型。只影响下一轮,不碰上级会话
只读工具 side_chat_main_status、side_chat_main_history(turn / contains 过滤,真实日志行)
汇报 side_chat_report 把结论排入上级会话的后续轮次;可在设置中关闭
关闭确认 「关闭这个侧边对话?」含「不再询问」,并提示会一起关闭几个嵌套对话;取消会重新打开标签
级联销毁 销毁父级时释放并删除所有后代,然后关闭它们的标签

安装

本目录是分支,包名不同,可与上游共存。把工作区目录作为 profile bundle 安装:

已发布到 npm 时:

dsh plugin add dsh-live-side-chat-nested

本地开发时先打包再安装压缩包:

npm pack --pack-destination /absolute/path/to/dist
dsh plugin add /absolute/path/to/dist/dsh-live-side-chat-nested-0.5.8.tgz

请安装打包后的 tarball,而不是直接链接目录:目录链接位于 profile 之外,Host 对 @deepseek-ai/dsh-agent、zod 等 peer 包的解析覆盖不到;安装 tarball 会把 bundle 放进 profile 的 node_modules,解析才成立。

然后刷新页面。由于包名不同,请先禁用旧的 dsh-live-side-chat bundle,避免两个 Host 半边同时接管侧边对话。

使用

  1. 在左侧选中一个会话(侧边对话属于当前打开的会话)。
  2. 右侧栏引导页选「侧边对话」,或在输入框输入 /btw;每次都会新开一个标签。/btw <prompt> 会把这段文字作为新对话的第一轮发出去,而不是发给主会话。
  3. 在右侧提问。每一步都会重读上级摘要,创建之后的进展也可见;细节用 side_chat_main_status / side_chat_main_history 核对。
  4. 用模型菜单切换模型或推理强度(只影响下一轮);展开「背景摘要」可查看模型实际读到的内容。
  5. 点状态条上的 +,在当前对话下再开一个嵌套对话;它的状态条会显示上级侧边对话,side_chat_report 也先交给这层。
  6. 在任意对话里选中文字,点浮层里的「在侧边对话中引用」;新对话会在输入框里引用这段文字、光标停在引文下方。写下问题再发送,不会替你自动发一轮。「引用文本」保持原来的行为(插进当前输入框)。
  7. 按 Cmd+E 可以不开鼠标就打开侧边对话:有选中文字时打开带引文的输入框,否则打开空对话。可在 设置 → 通用 → 快捷键 中改键。
  8. 关闭标签 → 确认 → 该对话及其嵌套对话一起销毁;「不再询问」只跳过对话框,仍会级联。

配置

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

  • 允许向上级会话发送消息(默认开):关闭后 side_chat_report 会被拒绝。
  • 嵌套层数上限(默认 20,1–100):允许创建的最深侧边对话层数;到这一层时「+」隐藏,客户端从 Host 读取该值。

插件行配置(在 profile 或 cordis.patch.yml 里覆盖 side-chat-nested 行):

字段 默认 含义
readOnly true 强制只读沙箱
allowShellQueries true 允许一次性 shell 查询;关闭后只用插件自带只读工具
allowReportToMain true(易变) 是否允许汇报,设置面板可改
liveContext true 每一步注入上级摘要
rootContext true 嵌套对话额外注入根会话摘要(只读参考块);根会话工具不受影响
digestTurns 12(4–60) 摘要保留的已结束轮数
historyEventLimit 40(5–200) 单次历史读取最多返回的行数
maxDepth 20(1–100) 最大嵌套层数。客户端启动时从 Host 读取(读取失败时回退 20),到配置的上限时隐藏 +。把它当作防跑飞的护栏,而不是产品限制
preset "" 侧边对话使用的 agent 预设;空则继承上级
sessionsRoot "" 仅销毁时使用的会话根目录;空表示 $DSH_HOME/sessions

已知限制

  • 引文只存在于输入框:它不是模型轮次,发送前刷新页面会丢掉引文;对话本身仍是空的。
  • 标签序号在打开时确定:暂不支持之后按首轮问题重命名。
  • maxDepth 在客户端也镜像了一份(默认 3)用于隐藏 +;在 Host 降低上限时,+ 会以 Host 报错呈现,而不是消失。
  • 关闭确认发生在标签已经关闭之后;右侧栏没有关闭否决口,「取消」会重新打开标签。
  • 摘要是有界摘要而不是日志,细节必须来自只读工具。
  • 销毁依赖 JSONL 会话布局;自定义持久化或根目录时请设置 sessionsRoot。
  • 借用 subagent descriptor 属于「不支持但稳定」的交互,上游版本变更需同步;基线 dsh 0.2.1-rc.2。
  • 插件依赖 webServer 与 connection,面向 Web/桌面部署。

开发

npm run check    # 对 Host 各模块与客户端 bundle 执行 node --check

许可

MIT。分支自 XBXyftx 的 dsh-live-side-chat(MIT),见 LICENSE。