g-yixuan/dsh-sidenote 预览 preview

g-yixuan/dsh-sidenote

Plugin插件 Native原生 ⭐ 5 MIT Sessions & Context会话与上下文

侧边开一岔对话,划选留一条注释——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。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-sidenote

g-yixuan/dsh-sidenote 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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

兼容性

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

上一个 Prev LoopWithAI 下一个 Next dsh-mcp-bridge