# dsh-sidebar-qa
划选即问,侧边栏内嵌问答

划选提问 添加到对话 上下文摘要 嵌套追问 追问记录 零打断 中英双语

DeepSeek Harness(DSH)Web 插件:在对话里划选任意文本 → 点击「提问」→ 右侧面板问答——
自动创建同工作区的独立 DSH 会话,主对话零打断。实现类 codex 侧边提问 / Claude Code `/btw` 功能。
🌏 中文 · English
dsh-sidebar-qa demo
## ✨ 功能一览 - **📝 划选提问**:对话中划选任意文本 → 浮层「提问」→ 右侧面板内嵌问答,全程不跳转大窗口;**侧边栏面板收起时也会自动展开**,「提问」永远有可见反馈 - **💬 添加到对话**:同一个浮层的另一个按钮,把划选文本以 `>` 引用块**追加**进当前会话的主输入框并聚焦(光标落在引用块下方),**不新建会话、不打开侧边栏**——想就地接着说的时候用它([issue #11](https://github.com/ChenRuoT/dsh-sidebar-qa/issues/11)) - **🧠 智能摘要**:快速无思考模型把主对话上下文压缩成小摘要,与划选引文一起注入首条消息 - **🔀 三种上下文策略**:每次提问可在「全量继承(fork+缓存命中)/ 压缩 / 机械裁切」间切换,面板内选择器 + 配置默认值双入口 - **🔗 独立会话**:自动创建同工作区独立 DSH 会话(`❓<主题>`),可继续、可归档,主对话零打断 - **🪆 嵌套追问**:在追问对话里再划选提问,生成子追问,层层嵌套 - **🗂️ 追问记录**:按根(主)会话分层树展示;限定当前工作区;节点可折叠、显示最近访问时间;点击跳转后追问记录 tab 保持开启;已归档/已删除的追问**置灰标记状态**,可一键从记录中移除(连同整棵子树清理映射,不影响 DSH 侧会话) - **🏷️ 两段式命名**:划选首行占位命名 → 首次回答完成后基于「问题 + 回答」自动提炼 ≤15 字最终标题 - **⚙️ 可配置**:摘要/回答模型渠道、思考模式、上下文窗口与预算全部可调——入口是 **DSH 设置页 → 左侧导航「追问」**(面板注册为 `settings.section`),也可以直接写 `settings.yaml` 的 `sidebarqa` 命名空间,两条路写的是同一份配置 - **🌏 中英双语**:界面文案与模型侧提示词跟随 DSH 语言设置实时切换(无需刷新,**包括已打开 tab 的标题**);**回答语言跟随你提问/划选的内容**,不被界面语言绑架 > 🔌 **只注册进 DSH 自带右侧栏**:DSH **0.1.5-alpha.1 及以上**自带右侧栏(`@deepseek-ai/dsh-client-ui-sidebar-right`),本插件直接注册进它(`ctx.sidebarRightTabs` / `ctx.sidebarRight` 服务 + `sidebar.right.pane.tab` 与 `sidebar.right.pane.tab.title` 席位),**无任何额外依赖**。`dsh-better-sidebar` 兼容已在 1.0.0 彻底移除。更早的 DSH 上插件**仍然激活**:划选浮层与「添加到对话」照常可用,只是不注册侧边栏 tab(并记一条 `console.warn`)。 ## 📦 更新记录 ### 1.0.0 - 2026-09-20 **首个 1.x:只注册进 DSH 自带右侧栏,零额外依赖。** 破坏性变更在于**移除了 `dsh-better-sidebar` 后端**(见下),因此按 semver 走 major:只装 `dsh-sidebar-qa` 即可,不再需要任何 peer 侧边栏基座。 - **移除 `dsh-better-sidebar` 兼容(破坏性)**:插件不再有第二个后端,也不再需要任何额外依赖;peer 依赖 `dsh-better-sidebar` 与其 `peerDependenciesMeta` 条目已删除(`pnpm install` 后 lock 里的 `node-pty` / `protobufjs` 一并消失)。 - DSH ≥ `0.1.5-alpha.1`:注册进 DSH 自带右侧栏。栏位展开/拆分/浮动/全屏由 DSH 自己管,插件不再需要手动展开面板。 - 更早的 DSH:插件**仍然激活**,划选浮层与「添加到对话」照常可用,只是不注册侧边栏 tab(并记一条 `console.warn`)。 - **已打开 tab 的标题现在会跟随语言切换**:插件在 `sidebar.right.pane.tab.title` 席位注册了一个活的标题组件(以前该标题会冻结在打开时的语言)。 - **新增能力**:`src/client/ask-mode.ts`(面板视图模式)、`src/client/show-session.ts`(用 `ctx.uiWorkspace.openSession` 把目标会话切到屏幕上)。 - **补回两个 tab 的图标**:`+` 页胶囊与 tab 条上的 chip 现在分别显示 ❓(追问)与队列(追问记录)的宿主图标——原生改造时 `icon` 字段整个丢了,胶囊一直在画宿主的方块占位。 - **已归档 / 已删除的追问不再把面板带塌**:切换条里这类行**置灰不可点**并标注状态,默认选中改为「最新一条**可读**的追问」;选中项在阅读中被归档时给出说明 + 「移除」,输入区停用。此前点它们会把面板切到一段读不出内容的会话上(永远「生成中…」)。 - **面板不再可能整块变白且无法恢复**:两个已知触发点都已修掉(宿主 `MarkdownText` 的文案 prop 改名后含**代码块**的消息会渲染崩溃;面板内的任何渲染错误以前会让 tab body 在**整页所有会话**上被永久摘除),并新增本插件自己的错误边界:崩溃就地显示为一条**可重试**的说明条,标签页本身不受影响。 - **修掉一批「类型镜像臆造上游成员」导致的静默故障**:「添加到对话」一直找不到目标会话、「追问记录」跳转抛 `TypeError`、局域网访问 `/sidebarqa/api` 恒 403、`assistant-stream` 帧读取崩溃等。详见 [CHANGELOG](./CHANGELOG.md)。 - **配置面板已迁入 DSH 官方设置页**:`ConfigPanel` 现在注册成一个 `settings.section`(`src/client/settings-slot.ts` 注册 + `src/client/settings-section.tsx` 页面),设置页左侧导航因此新增**一整页**「追问」(排在 DSH 自带各页之后),**不再有齿轮弹窗**。之所以不是 `plugins.item`:那个席位的契约留给 `ui-settings-plugins` 的 host-plane 配置页,且在没有受管 profile 的部署上整页不可用,会把配置入口一起带走。 - **host 与 client 两半都有改动**(host 侧修了 `/sidebarqa/api` 的信任围栏),且依赖层有变化(移除 `dsh-better-sidebar` peer;`@deepseek-ai/dsh-client-ui-primitives` 的类型桩精确钉到 `0.1.6-alpha.2`):升级后请重新 `pnpm install`,并重启 `dsh web`。 ### 0.5.0 - 2026-08-29 - **划选浮层双按钮([issue #11](https://github.com/ChenRuoT/dsh-sidebar-qa/issues/11))**:新增「添加到对话」——把划选文本以 `>` 引用块**追加**进当前会话的主输入框并聚焦(光标落在引用块下方),**不新建会话、不打开侧边栏**;「提问」文案与行为不变。仅 client 半改动,浏览器硬刷新即可生效。 ## 前置条件 | 宿主 DSH | 侧边栏 tab | 划选浮层 / 添加到对话 | |---|---|---| | ≥ `0.1.5-alpha.1`(推荐) | ✅ 注册进 DSH 自带右侧栏 | ✅ | | `0.1.2-alpha.1` ~ `0.1.4.x` | ❌ 不注册(记一条 `console.warn`) | ✅ | - **侧边栏 tab 需要 DSH ≥ `0.1.5-alpha.1`**:原生右侧栏(`@deepseek-ai/dsh-client-ui-sidebar-right`)从该版本起提供。 - 探测是**运行期结构探测**(服务在不在),不是版本号比对:`sidebarRightTabs` / `sidebarRight` / `slots` 三件套齐备才注册。 - `engines.dsh` 仍声明 `>=0.1.2-alpha.1`(浏览器侧 RPC 走 `ctx.remote.session` 的下限),但 **DSH 完全不校验 `engines`**,所以它只是声明、不是闸门。 ## 安装 ```bash # 通过 npm(推荐) dsh plugin --profile web add dsh-sidebar-qa # 或本地路径 dsh plugin --profile web add <本仓库路径> ``` 重启 `dsh web`(host 半改动需要重启;client 改动浏览器硬刷新即可)。 ## 使用 1. 在任意对话(主对话或追问对话)中划选一段文本,浮层会给出两个按钮:「添加到对话」把引文追加进**当前会话的主输入框**(不开侧边栏),「提问」则走下面的侧边追问流程。点击浮层「提问」。即使右侧面板处于**收起**状态也会自动展开(对应 [issue #6](https://github.com/ChenRuoT/dsh-sidebar-qa/issues/6)),「追问」tab 直接可见——包括"先手动收起面板、再点提问"的重复场景。 2. 右侧「追问」面板变成一条**内嵌对话**:引文/问题在侧边栏内流式回答,输入框固定在下方面板底部,**不会跳转到子对话大窗口**。 3. 回答过程中可在输入框继续追问(Enter 发送、Shift+Enter 换行),所有问答都在侧边栏内完成。面板底部的**输入框复用 DSH 主对话的输入栏外观**(同一套设计 token 的圆角胶囊卡片):发起新追问时左侧是**上下文策略** chip,右侧的**模型选择**(与主对话同一份 `session.models/selectModel` 数据,切换互通)与 **context 占用环**(复用 `contextPressure` 投影)始终可见——新追问时它们绑定**被追问的父会话**(context 环即父会话占用,可据此判断用全量还是裁切)。**模型座不会写主对话**:新追问 + 压缩/裁切时它是**本地草稿**,默认显示配置里的回答模型(子会话真正会用的那个),你的选择只在追问会话建好后应用;新追问 + 全量继承时**只读置灰**(fork 子会话沿用主对话模型,正是前缀缓存命中的前提,如需换模型请改用压缩/裁切);继续已有追问时绑定该追问会话并直接生效。最右侧为**上箭头发送键**。 4. 每个追问仍是同工作区的独立会话(`❓<主题>`),主对话零打断;追问可以**嵌套**(在追问对话里再划选提问会生成新的子追问)。发起新追问时,输入框左侧的**上下文策略** chip 可选择策略(默认取配置 `historyStrategy`): - **全量继承**:`sessions.fork` 从主会话最近的已完成 turn 分叉子会话,完整历史随种子继承,首条请求复用主会话消息前缀 → DeepSeek **自动前缀缓存命中**、零压缩损失;子会话沿用主会话模型。主对话正在回答(无已完成 turn)时 fork 自动降级为「压缩」并提示。追问 tab 中,继承的父对话历史显示在**分割条上方**,默认视图锚定在本追问自己的「引用 + 提问」处,**向上滚动分页加载**父对话历史(与主对话「加载更早」体验一致)。 - **压缩**:快速模型压缩较早窗口 + 近期原文保留(默认,省 token)。 - **机械裁切**:最后 `trimWindowMessages` 条消息原文直取,零 LLM 成本、确定性输出。 5. 侧边栏「追问记录」tab 按根(主)会话分组,以分层树列出**当前工作区**内的所有(嵌套)追问(归属判定:当前会话所在工作区,见 `src/client/history-scope.ts`),点击跳转。有子追问的节点右侧有**折叠按钮**(箭头随折叠状态旋转)收纳子树,其左侧显示该对话组**最近访问时间**(相对标签,复用 DSH 左侧面板的样式与数据源 `sessions.list.updatedAt`)。跳转后目标会话的**追问记录 tab 保持开启**(本插件先把目标会话切到屏幕上——`ctx.uiWorkspace.openSession`——再把「追问记录」tab 开进它的右侧栏)。被**归档或删除**的追问(用户自行管理会话时)会**置灰并标注「已归档 / 已删除」**,不可再点击跳转,行尾的「移除」按钮将其从记录中清除(连同整棵子树清理 localStorage 映射,DSH 侧会话本身不受影响)。 ## 配置 配置走 DSH 设置服务 `sidebarqa` 命名空间(settings.yaml 或 DSH 设置页)。 > ℹ️ **配置面板就在 DSH 设置页里**:「功能配置」面板(`src/client/ConfigPanel.tsx`)注册成一个 `settings.section`,导航路径是 **设置 → 左侧导航「追问」**(排位在 DSH 自带各页之后)。它编辑的仍是 host 的 `sidebarqa` 命名空间(经本插件自己的 `/sidebarqa/api/config.update`,带 revision 乐观锁),所以 **`settings.yaml` 的 `sidebarqa` 命名空间依然有效,两条路写的是同一份配置**。 下表的键都可以直接写进 `settings.yaml` 的 `sidebarqa` 命名空间。面板里则可以逐项编辑这些字段——文本行 blur/Enter 提交,数字行按区间钳制,写入经 `/sidebarqa/api/config.update` 带 revision 乐观锁(多窗口冲突时提示重试),回答/摘要的模型渠道与模型为下拉框(选项来自运行时已配置的渠道);直接手写 YAML 也完全等效。 | 键 | 默认 | 说明 | |---|---|---| | `historyStrategy` | `compressed` | 默认上下文策略:`inherit` 全量继承(fork+缓存命中)/ `compressed` 压缩 / `trim` 机械裁切(面板内可逐次切换) | | `trimWindowMessages` | `10` | 机械裁切模式保留的最近消息条数(1–256) | | `summarizeProvider` | `''` | 摘要快速模型渠道;空 = 继承被追问会话的 provider | | `summarizeModel` | `deepseek-v4-flash` | 摘要快速无思考模型 | | `summarizeReasoningEffort` | `off` | 摘要思考模式(`off`/`high`/`max` 三档下拉) | | `answerProvider` | `deepseek-official` | 子对话回答模型渠道 | | `answerModel` | `deepseek-v4-flash` | 子对话回答模型 | | `answerReasoningEffort` | `off` | 子对话思考模式(`off`/`high`/`max` 三档下拉) | > 配置面板(`config-fields.ts`)只声明上述 8 项常用设置;压缩/标题的内部调参键(`summarizeBudgetTokens`、`recentWindowMessages`、`backgroundWindowMessages`、`titleBudgetTokens`)不在面板暴露,只能在 `settings.yaml` 的 `sidebarqa` 命名空间里配置。 > 压缩模式的下上文注入刻意保持轻量:旧背景压成**最多 3 句话**(目标 / 当前进度 / 未决事项),近期只保留最近 2 条且每段强截断(≤400 字符);模型侧**从新到旧**提交,让当前进度落在注意力最强位置。摘要失败/无渠道时自动降级为「仅近期对话 + 引文 + 问题」,问答不中断;全量继承失败(主对话正在回答)时自动降级为压缩模式。 ## 架构 ``` dsh-sidebar-qa (bundle: dsh.bundle + package.json#dsh.client) ├── src/index.ts host:/sidebarqa/api 摘要 + 标题服务 + sidebarqa 设置命名空间 ├── src/summarize.ts 表面文本抽取 + 流组装(纯函数,可测) ├── src/title.ts 标题提示词 + 规范化 + Q+A 输入框定(纯函数,可测) ├── src/config.ts 设置 schema + 默认值 ├── src/prompt-locale.ts 模型侧 zh/en 提示词词表 + 问题标记注册表(两半共享,纯函数,可测) ├── src/context-types.ts 结构化 cordis 服务面 + Context 增补 └── src/client/ 浏览器:选区捕获、浮层、问答面板、会话编排、追问记录 ├── index.tsx apply:tab 规格(id/kind 分开声明)+ 浮层 + locale 词典 + 侧边栏装配 ├── sidebar-native.ts **唯一的侧边栏模块**:服务探测 + 三阶段注册(类型 / body / 活的标题)+ 按 kind 打开(含导航后跨帧确认) ├── slots.ts 插槽注册表探测(ctx.get('slots');侧边栏 tab 与设置页共用) ├── show-session.ts 把目标会话切到屏幕上(ctx.uiWorkspace.openSession,可测) ├── current-session.ts 当前会话判定:retainedBy.mainView > 0(纯函数,可测) ├── selection.ts 选区捕获与校验(单消息/非流式/≤2000 字符) ├── SelectionPopover.tsx 划选浮层「添加到对话」/「提问」两个按钮 ├── quote-draft.ts 引用块格式化 + 草稿合并(纯) ├── draft-insert.ts 把引文写进主输入框(conversation 服务接线) ├── AskPanel.tsx 追问 tab(内嵌对话:流式 transcript + DSH 风格输入卡片 + 追问切换) ├── HistoryPanel.tsx 追问记录 tab(分层树:折叠按钮 + 最近访问时间 + 工作区限定 + 归档/删除置灰与移除) ├── history-scope.ts 工作区归属解析 + 树过滤 + 子树最近访问时间 + 会话状态判定(live/archived/gone)与子树移除(纯函数,可测) ├── history-time.ts 相对时间分桶 + 本地化标签(纯函数,可测,复用左侧面板样式) ├── StrategySelect.tsx 上下文策略 chip(PermissionSelect 同款触发器 + Menu) ├── ModelSelect.tsx 模型选择(双层菜单三态:提交 / 草稿 / 只读) ├── model-menu.ts 模型目录扁平化/选中解析 + 有效强度与去重判定(纯函数,可测) ├── model-seat.ts 模型座绑定(读哪个会话、提交还是草稿、显示什么,纯函数,可测) ├── ContextMeter.tsx context 占用环(contextPressure 投影 + breakdown 面板) ├── context-meter.ts 占用百分比/紧凑 token 格式化(纯函数,可测) ├── ask-mode.ts 面板视图模式判定 resolveAskMode(纯函数,可测) ├── locales.ts 界面 zh/en 词表 + 模块级 t()(零依赖,可测) ├── use-locale.ts useLocaleRevision():语言切换时重渲染各面板根 ├── orchestrate.ts create → 占位 rename → selectModel(默认 flash/关思考) → prompt + 继续追问 + 回答后重命名 ├── settings-slot.ts 把配置面板注册成 DSH 设置页的一个 section(探测 + 重试,纯模块,可测) ├── settings-section.tsx 设置页「追问」页面:标题 + 说明 + ConfigPanel ├── ConfigPanel.tsx 功能配置面板(编辑 sidebarqa 命名空间;由设置页的 settings.section 渲染) ├── config-fields.ts 配置面板行声明 + 数字钳制 + catalog 选项解析(纯函数,可测) ├── store.ts 父→子 映射(localStorage 持久化,支持嵌套)+ 待提问引文 + 已命名标记 ├── injection.ts XML 转义/消毒 + 注入格式 + 占位主题生成 ├── answer.ts 历史流 → 回答文本折叠 └── api.ts /sidebarqa/api fetch 封装 + 当前模型读取 ``` ### 跨插件 seam(预填引文) 外部插件可以打开追问 tab 并**预填引文**(不经本插件的划选浮层)。载荷走原生侧边栏的 **per-open 通道** —— `ctx.sidebarRight.openTab(kind, { params })`,`kind` 是 `ask` 或 `history`: ```ts // 在目标会话的右侧栏打开「追问」tab,并预填一段引文 ctx.sidebarRight.openTab('ask', { params: { quote: '选中的内容', role: 'user' }, }) // 只打开「追问记录」tab ctx.sidebarRight.openTab('history') ``` > ⚠️ `kind` 是 `ask` / `history` 这样的**派发短名**,不是 `dsh-sidebar-qa:ask` / `dsh-sidebar-qa:history`——后者是 tab 的**实现 id**(席位注册用的键)。`openTab` 按 kind 查注册表,传 id 会抛 `no tab type is registered as "…"`。 本插件自己的划选浮层走的是同一条通道:`sidebar-native.ts` 暴露一个 opener(`openAsk` / `openHistory`),浮层拿到引文后调 `opener.openAsk({ sessionId }, { quote, role })`。**没有**给外部插件用的端口导出——client bundle 的纯度门本来就禁止跨特性插件 value-import。 面板优先显示这条来路引文(形状校验:`params.quote` 为非空字符串;可选透传 `role` / `messageId`),回退到本插件浮层的 pending 引文;引文由适配器保证**每次导航只交付一次**,所以刷新/再次聚焦不会复现旧引文,而**第二次外部打开**仍会递送它的新引文(一次导航 = 一个新的出现实例)。`` 的 `source` 标签沿用 `agent-history`。 > 已打开 tab 的标题**会**跟随语言切换:插件往 `sidebar.right.pane.tab.title` 席位注册了一个**组件**(它订阅语言 revision 并就地重渲染)。宿主不声明该席位时回退为打开时捕获的标题字符串(该语言下陈旧但无害)。 ### 关键数据流 ``` 划选文本 ─┬▶ 浮层[添加到对话] ─▶ 当前会话主输入框(> 引用块 + 聚焦,光标在下方) └▶ 浮层[提问] ─▶ 右侧面板(引文 + 底部输入框) 回车 ─▶ ① host 摘要:sessionQuery.readSurface(被追问会话) → llm 快速无思考模型压缩 ② client 创建会话 sessions.create(workspaceId) ③ rename → "❓<划选文本首行占位>" ④ selectModel(默认 deepseek-v4-flash, 思考关闭) ⑤ prompt(摘要块 + + 问题) ─▶ 面板 follow session 日志流式渲染 transcript(不跳转大窗口) ─▶ 首次 turn/end 后 ⑥ host 标题:Q+A 截断 → llm 快速无思考模型提炼 ≤15 字主题 → rename 覆盖为 "❓<最终主题>"(仅一次,失败保留占位) ─▶ 底部输入框继续追问;主对话零影响;追问可嵌套 ``` ### 上下文注入格式(首条消息) ``` <统领性指令:这是「侧边栏追问」,只围绕划选文本主题直接回答……> 【主对话上下文】 【背景】<模型压缩的旧历史,最多 3 句话> 【近期对话】<最近 2 条近原文,每条 ≤400 字符> <引文原文> 问题:<用户输入> ``` 统领性指令置于**输入最前**,利用注意力机制让模型先定调「聚焦划选文本」再读上下文;用户问题虽然在输入末尾,但划选文本(`quoted_context`)与指令共同锚定了回答范围。追问会话内的后续消息默认不带主对话上下文(只有首条携带)。 ## 构建与测试 ```bash pnpm install pnpm build # tsc 声明 + tsdown(lib/index.js + lib/client.js + lib/client-registry.js) pnpm test # vitest 单测(answer / ask-mode / config / config-fields / context-meter / current-session / draft-insert / history-scope / history-time / injection / locales / model-menu / model-seat / prompt-locale / quote-draft / session-wire / settings-section / sidebar-native / store / summarize / title) pnpm typecheck ``` ## 多语言 界面文案与模型侧提示词都跟随 **DSH 的语言设置**(设置 → 通用 → 语言,即 `$DSH_HOME/settings.yaml` 的 `locale.preference`);缺少 locale 服务时回退浏览器语言,再回退 en。切换语言**即时生效**,无需刷新或重启。 - **界面**:两个 tab 标题(含已打开的 tab——由 `sidebar.right.pane.tab.title` 席位的活标题组件保证)、划选浮层、空态与状态提示、模型选择、context 占用环、功能配置面板——词表在 `src/client/locales.ts`,zh 为键集基准,en 由类型标注锁定。 - **模型侧**:追问引导语、上下文压缩系统提示、标题系统提示,以及提示词指名引用的结构标记——词表在 `src/prompt-locale.ts`。client 调用 `/sidebarqa/api/context` 与 `/sidebarqa/api/title` 时带 `locale` 字段;**缺省等价于 `zh`**,旧版 client 打到新 host 与 i18n 之前逐字节一致。 - **回答语言不跟界面走**:提示词要求模型「用与用户提问相同的语言作答,问题语言不明确时跟随划选文本」——中文界面下划选英文论文提问,仍得到英文回答(与 DSH 官方会话命名同款策略)。 - 追问会话标题为 `❓<主题>`:只用 emoji 标记,不含需要翻译的词,切换语言不会让会话列表出现混合语言前缀。 ## License MIT