g-yixuan/dsh-sidenote
侧边开一岔对话,划选留一条注释——DSH(DeepSeek Harness)插件:fork 主会话成侧边会话,支线问题不打断主线,结论一键回流。Side chat & selection annotations for DSH.
Project Overview项目介绍
This is a web plugin for DeepSeek Harness (DSH) that provides Codex-style side chat and selected text annotation. It supports forking the main session into independent side chats and adding annotations to selected assistant text. Use it when handling side questions without interrupting main conversation. It requires the dsh-better-sidebar plugin pre-installed.
这是DeepSeek Harness(DSH)的网页插件,提供Codex风格侧边聊天与划选注释功能。支持将主会话分叉为独立侧边会话,可对助手回复文本划选添加注解,适合不打断主线对话处理支线问题、添加标注时使用,需提前安装依赖插件dsh-better-sidebar。
请帮我了解并安装插件:【dsh-sidenote】【https://github.com/g-yixuan/dsh-sidenote】
Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH,让它帮你了解并安装。安装命令不一定准确,发给 DSH 更稳。
Or use CLI install (for developers)或使用命令行安装(适合开发者)
CLI Install命令行安装
dsh plugin --profile web add dsh-sidenote
把 g-yixuan/dsh-sidenote 加入你的 DSH 配置(web profile)即可启用。
READMEREADME
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主↔侧切焦点。

划选注释——把「这句有问题」变成模型的上下文
- 划选 assistant 回复 → 浮层 → 注解编辑器,右缘编号角标锚定原文;
- 注释是受控对象(可预览、可逐条移除),草稿零污染——发送瞬间才序列化为模型可读的结构化协议块;
- 发送后气泡收成「批注 ×N」标签留痕;刷新不丢。
| 划选浮层 | 注解编辑器 |
|---|---|
![]() |
![]() |
回流主线——侧边结论不烂在支线
- 侧边结论一键「回流到主会话」:问答成对(结论 + 它回答的问题)收为受控 chip 挂在主输入框上方,随下一条消息发给主线;
@也可直接引用侧边聊天; - 「保存为正式会话」转正进会话列表;
/side弹层重开最近关闭。

更多截图
| 折叠态(继承卡 + 操作行) | 侧边斜杠菜单 |
|---|---|
![]() |
![]() |
| 角标 + 注释 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






liangmianya/dsh-synapse
alaliqing/claude-paper
omdsh-dev/dsh-annotation
Anionex/dsh-turn-rewind
hanshenmesen/dsh-turn-delete
qkycir-123/dsh-run2skill
Tyan66666/billion-context-dsh
PKUfudawei/dsh-capability-menu