dsh-sidebar-qa 使用指南
为 DSH Web 端提供「划选对话文本→右侧面板提问」能力:在不打断主对话的前提下创建同工作区的独立追问会话,支持嵌套、上下文策略切换与追问记录树。
本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。
本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。
快速上手
dsh-sidebar-qa
— 源: plugin_wiki.wiki_content
安装与验证
dsh plugin --profile web add dsh-sidebar-qa
复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。
— 源: plugins.install
关键要点
- 📝 划选提问:对话中划选任意文本 → 浮层「提问」→ 右侧面板内嵌问答,全程不跳转大窗口;侧边栏面板收起时也会自动展开,「提问」永远有可见反馈
- 🧠 智能摘要:快速无思考模型把主对话上下文压缩成小摘要,与划选引文一起注入首条消息
- 🔀 三种上下文策略:每次提问可在「全量继承(fork+缓存命中)/ 压缩 / 机械裁切」间切换,面板内选择器 + 配置默认值双入口
- 🔗 独立会话:自动创建同工作区独立 DSH 会话(
❓追问·<主题>),可继续、可归档,主对话零打断 - 🪆 嵌套追问:在追问对话里再划选提问,生成子追问,层层嵌套
— 源: plugin_wiki.readme_zh (fallback readme_raw)
常见问题
必须先安装 dsh-better-sidebar 吗?
必须。dsh-better-sidebar 是硬性 peer 依赖(package.json:64-69),未安装时 client 端 inject = ['betterSidebar', ...] 拿不到服务,插件保持不激活——没有任何 UI、行为,也不会创建会话。需要先执行 dsh plugin --profile web add dsh-better-sidebar@latest 并要求 0.14.0+(README.md:34)。
划选文本后点「提问」,主对话会被打断吗?
不会。host 端只读取主会话的当前模型表面(ctx.sessionQuery.readSurface,不打开发送队列),client 端新建一个独立的 DSH 子会话承担问答(orchestrate.ts:148-234),主对话的 agent、消息流与队列全程不会被触碰。
三种上下文策略(全量继承 / 压缩 / 机械裁切)我该怎么选?
「全量继承」从主会话最新已完成 turn 分叉子会话,完整历史作为种子继承,可命中 DeepSeek 前缀缓存但必须沿用主会话模型;「压缩」用快速无思考模型压旧历史 + 近期原文保留(默认,省 token);「机械裁切」直接取最后 N 条消息原文,零 LLM 成本。发起新追问时在面板左侧的策略 chip 逐次切换,全量继承在主对话正在回答时会自动降级为压缩(README.md:57-60 / orchestrate.ts:176-198)。
追问会话的标题为什么先是占位,答完才更新?
这是两段式命名:创建时用引文首行做占位标题(❓追问·<首行>),首次回答完成后由 host 端用快速无思考模型从「问题+回答」提炼 ≤15 字最终标题并 rename 覆盖(orchestrate.ts:279-311)。提炼失败时保留占位,不会再重试。
追问记录中的「已归档 / 已删除」置灰条目是什么?点「移除」会删掉 DSH 会话吗?
你自行在 DSH 端归档或删除的会话,本插件的 localStorage 父→子映射不会自动清理,记录 tab 会把它们置灰并标注状态(CHANGELOG 0.3.1)。点「移除」只清理本插件的映射与衍生状态(titled / collapsed),不触碰 DSH 侧的真实会话。
关闭浏览器后再回来,追问记录还在吗?
在。父→子映射、已命名标记、追问记录树的折叠状态都持久化在 localStorage 的 dsh-sidebar-qa:map / :titled / :collapsed 三个键里(store.ts:15-17)。DSH 侧真正的会话由其自身的会话存储独立保留。
这个插件要求什么 Node 和 DSH 版本?
package.json 声明 engines.node ">=20";dsh 端 peer 依赖锁在 dsh-better-sidebar ^0.14.0 / @deepseek-ai/dsh-client-ui-primitives ^0.1.0-rc.8 / cordis ^4.0.0-rc.8,对应 DSH 0.1.0-rc.8,rc.7 及更早的版本无法解析依赖,请先升级 DSH(CHANGELOG 0.3.0 / README.md:34)。
修改后端后必须重启 dsh web 吗?
host 半改动(/sidebarqa/api 摘要、标题、设置命名空间)需要重启 dsh web;client 半改动(划选浮层、追问/追问记录 tab、模型座、配置面板)只硬刷新浏览器即可,不必重启服务(CHANGELOG 0.3.2 / README.md:50)。
— 源: plugin_wiki.faq_json
兼容性
- DSH: 0.1.0-rc.8+
- Node: >=20
- Platforms: macOS, Windows, Linux
— 源: plugin_wiki.compatibility_json
踩坑提醒
安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。
— 来源:通用规则