前言¶

在 DeepSeek Harness（DSH）里推进一项任务时，主对话往往是一条线：方案评审、读代码、改提示词，中间总会冒出「这一句什么意思」「能不能给一版可直接用的文案」之类的小岔路。若在主线里反复展开，上下文容易被支线冲淡；若另开一个新会话，又要重新交代背景。

dsh-sidenote 面向 DSH Web 工作流，在同一任务里提供侧边多轮对话、划选批注，以及把侧聊结论成对带回主输入框的能力。下面介绍它是什么、能做什么，以及如何安装与上手。

这是什么¶

dsh-sidenote（npm 包名 dsh-sidenote）是由维护者 TaoCultivator 发布的工作流类 DSH 插件。简介中的定位是：Follow the tangent. Keep the thread. —— 思路可以分岔，主线始终向前；划选注释、侧边追问，再把结论带回正在推进的任务。

插件为 DSH 增加侧边聊天与划选注释：读到疑问可在旁边聊透，有了结论再带回当前主线，而不必打断主会话的推进节奏。

• 目录页：https://www.skillhub.cn/plugins/TaoCultivator/dsh-sidenote
• 源码与文档：https://github.com/TaoCultivator/dsh-sidenote
• 许可证：MIT（见仓库 LICENSE）

DSH 生态采用「一切皆插件」的思路；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装插件前，建议自行查看仓库源码与许可证，并理解插件在当前 DSH 进程权限下运行。

核心功能¶

以下能力均来自项目 README 与 package 声明，可按同一任务内的「主线 + 支线」理解。

侧边追问，历史随 fork 保留¶

从当前对话可开一个侧聊，用于评审方案时追细节、读代码时弄清实现等场景。侧聊继承完整对话历史（默认折叠，按需展开），不必在支线里重复交代背景。

侧聊具备独立的多轮对话、工具卡、模型与权限切换，并支持图片、@ 引用以及面板内审批；主线与支线可各自推进。

划选批注，原文与意见一并保留¶

在主对话或侧聊回复中划选一段文字，可写下问题或修改意见。原文与注释一起保留，可累积多条；发送前可预览、移除，正文草稿仍可照常编辑。

结论回流主线¶

侧聊回答操作栏提供「带回主对话」：问题与回答成对出现在主输入框上方，随下一条消息送入主线。也可整段回流，或将值得保留的侧聊保存为正式会话。

入口与快捷键¶

打开 DSH Web 后，可：

• 点击会话顶栏 「侧边」；
• 划选一段回复开始侧聊或批注；
• 输入 /side 打开侧聊；
• 使用 Alt+S 在主、侧输入焦点之间切换。

其他顺手细节¶

当前主线支持 DSH 0.2.1-rc.2（当前）、0.2.0-rc.2（过渡）及 0.2.1-rc.3（已准入预览），无需再安装 dsh-better-sidebar。公开安装范围以对应 Release 为准；窗口外宿主可使用最后兼容的插件版本，具体见仓库内兼容政策文档。

安装与启用¶

在已安装 DSH 的环境中执行：

dsh plugin --profile web add dsh-sidenote

该命令针对 Web profile；插件 client 注入面向 web 平台。安装完成后重启或刷新 DSH Web，即可通过顶栏「侧边」、/side 或划选回复开始使用。

package.json 中 engines.dsh 声明为 =0.2.0-rc.2 || =0.2.1-rc.2 || =0.2.1-rc.3，与 README 中的兼容窗口一致。若 DSH 版本不在支持窗口内，应查阅仓库 docs/compatibility.md 中的兼容与维护政策，而非假设最新插件可在任意旧宿主上运行。

典型用法¶

README 概括的操作链为：划选一句 → 带着上下文追问 → 把结论带回主线。

可复现的一种场景如下：

1. 在主对话里读到一句需要改写的说明（例如提示「未找到」并建议放宽条件），划选该句，写下追问或修改意见（如「给一版可直接使用的空状态」）。
2. 若问题需要多轮推敲，打开侧聊在旁讨论；侧聊可使用与主线独立的模型与工具设置。
3. 侧聊得到可用结论后，点击回答栏 「带回主对话」，使问题与回答成对出现在主输入框上方。
4. 编辑主线正文（可同时携带多条待发送批注），发送下一条消息，将结论并入正在推进的任务。

更细的划选范围、恢复行为见仓库 docs/usage.md。

适用场景与注意¶

适合谁： 经常在 DSH Web 里做长任务、需要在不丢主线上下文的前提下旁路追问或逐段批注的开发者；分类上属于 工作流 类插件。

使用前注意：

• 插件随 DSH 进程加载，权限与宿主一致；安装前请阅读 https://github.com/TaoCultivator/dsh-sidenote 源码与 MIT 许可证。
• 侧聊默认不进会话列表与搜索，避免支线堆满列表；需要长期保留时再「保存为正式会话」。
• 遇接入问题时，可在 设置 → 通用设置 → dsh-sidenote 诊断模式 开启诊断，查看并手动导出接入状态（见 README「兼容与帮助」）。

维护窗口按「当前常规版本 + 过渡版本 + 至多一个已准入预览版」滚动；窗口外不保证每个新功能回补。问题反馈与建议可通过仓库 Issue 模板提交（README 中给出链接）。

结尾¶

dsh-sidenote 把「分岔思考」收束在同一任务界面里：侧聊继承历史、划选保留原文、结论成对回流主线。若你在 DSH Web 上常因旁路问题打断主流程，可按上文安装命令启用，并从划选或 /side 试起。

• 插件目录：https://www.skillhub.cn/plugins/TaoCultivator/dsh-sidenote
• GitHub：https://github.com/TaoCultivator/dsh-sidenote