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