dsh-sidenote：侧边开一岔对话，结论一键回流

在使用 DSH 处理复杂任务时，常会遇到需要即时验证细节或回答支线问题的情况。如果直接在主会话中打断，容易导致上下文混乱；若切换窗口，又会中断心流。dsh-sidenote 插件通过侧边栏机制，允许你 fork 主会话并在不干扰主线的前提下处理支线问题。

插件介绍¶

这是 g-yixuan 维护的 DSH 客户端插件。它提供“侧边开一岔对话”的能力，通过 fork 主会话成侧边会话，支线问题不打断主线，并支持结论一键回流。

核心功能¶

• 侧边开一岔对话：fork 主会话成侧边会话。侧边会话是真实 DSH 会话（全量历史快照），与主会话能力对等。
• 支线问题不打断主线：继承历史默认折叠成指示卡。折叠态/滚动位置刷新不丢。
• 结论一键回流：侧边结论一键“回流到主会话”。问答成对（结论 + 它回答的问题）收为受控 chip 挂在主输入框上方，随下一条消息发给主线。
• 划选留一条注释：划选 assistant 回复 → 浮层 → 注解编辑器，右缘编号角标锚定原文。发送后气泡收成“批注 ×N”标签留痕。
• 原生级工具卡：与主对话同一套渲染材质。工具卡、思考预览、任务卡、模型/权限切换、@ 引用、图片附件均可用。
• 审批/提问在面板内直接答复：不用跳回主视图。跑完有 toast 通知。
• 草稿零污染：注释是受控对象（可预览、可逐条移除），发送瞬间才序列化为模型可读的结构化协议块。

安装与启用¶

安装命令如下：

dsh plugin --profile web add dsh-sidenote

启用后，通过以下三个入口进入侧边栏：
* 顶栏「侧边」按钮
* 右侧栏 guide
* 斜杠命令 /side

典型用法¶

1. 切入侧边栏：点击顶栏「侧边」按钮或输入 /side，插件会将当前主会话 fork 到右侧。
2. 处理支线问题：在侧边栏进行多轮对话，主会话保持静默，不干扰当前上下文。
3. 切换焦点：使用 Alt+J 快速在主↔侧边焦点间切换。
4. 回流结论：侧边对话得出结论后，点击回流，结果会以 chip 形式挂在主输入框上方。
5. 划选注释：在主对话中划选任意回复文本，可添加注释。

注意事项与兼容性¶

• 版本兼容：
  • DSH ≥ 0.1.5-rc.1：直连 DSH 原生右侧边栏（无需安装 dsh-better-sidebar）。
  • DSH ≤ 0.1.2-rc.x：需配合 dsh-better-sidebar（必需）。
• 共存性：与 dsh-better-sidebar 天然共存，各自注册、互不依赖。
• 单实例语义：受宿主“page kind 每 pane 单实例”规则约束。同一会话同时只开一个侧边聊天（再次打开/新建 = 聚焦既有 tab；关闭后可经 /side 重开恢复原会话）。
• 降级策略：宿主面缺席时插件按能力降级，不崩页面。
• 发布机制：发布走 npm Trusted Publishing（OIDC）。不需要 npm token，不需要 OTP。触发条件是“发布一个 GitHub Release”，不是推 tag。

短结尾¶

dsh-sidenote 通过将 fork 会话与主会话隔离，解决了多任务并行处理的上下文切换痛点。对于需要在同一任务流中穿插验证、调研或细碎提问的开发者，该插件能有效保持列表卫生与工作流连贯。

插件目录页 | GitHub 仓库