g-yixuan/dsh-sidenote

DSH（DeepSeek Harness）插件——支线问题不打断主线，结论一键回流。

English · 中文

演示：划选注释 → 侧边聊天 → 回流主线

安装

前置：已装 dsh-better-sidebar（硬依赖）。

dsh plugin --profile web add dsh-sidenote

三步上手：① 装依赖 → ② 装本插件 → ③ 顶栏点「侧边」，或直接划选任意回复文本。

本地开发挂载：dsh plugin --profile web add link:（client 改动热重载，host 改动需重启 dsh web）。

侧边聊天——支线问题不打断主线

从当前主会话 fork（全量历史快照，不压缩）出独立侧边会话，在右侧栏多轮对话：

- 顶栏「侧边」按钮 / + 菜单 / 斜杠命令 /side 三个入口，多实例并存；
- 与主对话同一套渲染材质：工具卡、思考预览、任务卡、模型/权限切换、@ 引用、图片附件；
- 审批/提问在面板内直接答复，不用跳回主视图；跑完有 toast 通知；
- 继承历史默认折叠成指示卡；折叠态/滚动位置刷新不丢；Alt+J 主↔侧切焦点。

侧边聊天面板：fork 历史 + 原生级工具卡 + 同能力 composer

划选注释——把「这句有问题」变成模型的上下文

- 划选 assistant 回复 → 浮层 → 注解编辑器，右缘编号角标锚定原文；
- 注释是受控对象（可预览、可逐条移除），草稿零污染——发送瞬间才序列化为模型可读的结构化协议块；
- 发送后气泡收成「批注 ×N」标签留痕；刷新不丢。

| 划选浮层 | 注解编辑器 |
|---|---|
| 划选浮层 | 注解编辑器 |

回流主线——侧边结论不烂在支线

- 侧边结论一键「回流到主会话」：问答成对（结论 + 它回答的问题）收为受控 chip 挂在主输入框上方，随下一条消息发给主线；@ 也可直接引用侧边聊天；
- 「保存为正式会话」转正进会话列表；/side 弹层重开最近关闭。

回流 chip：侧边结论挂进主输入框

更多截图

| 折叠态（继承卡 + 操作行） | 侧边斜杠菜单 |
|---|---|
| 折叠态 | 斜杠菜单 |

| 角标 + 注释 chip | 发送后留痕 |
|---|---|
| 角标与注释 chip | 发送后留痕 |

兼容性

| DSH | dsh-better-sidebar | 状态 |
|---|---|---|
| 0.1.1-rc.x | ≥ 0.12.3 | ✅ CI 双档矩阵 |
| 0.1.2-rc.x | ≥ 0.18.0 | ✅ CI 双档矩阵 |
| 0.1.5-rc.x | ≥ 0.19.0 | ✅ 沙箱实测（见下） |

每周 canary 跟进宿主新版本；宿主面缺席时插件按能力降级（不崩页面）。

native 右栏（better-sidebar ≥ 0.19）语义差异：侧边聊天 tab 托管给 DSH 原生右侧边栏，受宿主「page kind 每 pane 单实例」规则约束——同一会话同时只开一个侧边聊天（再次打开/新建 = 聚焦既有 tab；关闭后可经 /side 重开恢复原会话）。多开诉求可用原生侧栏的分栏（每 pane 一个）。

设计要点

- 真 fork，不压缩：侧边会话是真实 DSH 会话（全量历史快照），与主会话能力对等；不是「摘要 + 一次性问答」。
- 列表卫生：侧边会话归档隐藏，会话列表永远干净。
- 可累积的标注工作流：多次划选累积多条注释，编辑、删除、随消息一起发出——不是一次性单引文。

开发

| 命令 | 说明 |
|---|---|
| pnpm typecheck | tsc --noEmit |
| pnpm test | vitest 单测（136 例） |
| pnpm build | 类型声明 + tsdown（host ESM + client CJS bundle，纯度门） |
| pnpm test:mount | 挂载冒烟：真实 dsh web + 伪造会话日志 + Playwright 十条 journey lane（BS_VERSION/DSH_CMD 切版本矩阵） |

问题与建议欢迎 Issue。

License

MIT