g-yixuan/dsh-sidenote5

dsh-sidenote

DSH web plugin: Codex-style side chat (fork the current session into a persistent side panel) + selection annotations with numbered badges and a composer chip. A thin consumer of dsh-better-sidebar. / Codex 风格侧边聊天 + 划选注释的 DSH 插件。

包名
dsh-sidenote
版本
0.3.3
许可证
MIT
最近更新
2026年9月12日

安装

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:g-yixuan/dsh-sidenote

dsh-sidenote —— 侧边开一岔对话,划选留一条注释,主线永不被打断

DSH(DeepSeek Harness)插件——支线问题不打断主线,结论一键回流。

npm version CI MIT license

requires dsh-better-sidebar

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发送后留痕

兼容性

DSHdsh-better-sidebar状态
0.1.1-rc.x≥ 0.12.3✅ CI 双档矩阵
0.1.2-rc.x≥ 0.18.0✅ CI 双档矩阵

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

设计要点

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

开发

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

问题与建议欢迎 Issue

License

MIT