dsh-sidecard-ask 1.8.0 → 1.8.2

package/CHANGELOG.md

@@ -1,5 +1,77 @@
 # Changelog
 
+## 1.8.2
+
+**主题：提问框底部的「作答位置」从"两枚看不出选中哪一侧的标签"改成一眼可辨的分段芯片；并把 1.8.1 之后写在本地、尚未提交的弹层对比度修补一并发布。**
+
+起因是用户截图：弹层底部「作答位置 ｜ 主对话 ｜ 侧边卡片」两个选项长得几乎一样，看不出答案会去主对话还是侧边卡片。
+
+- **选中态不可辨（用户反馈，已复现）**：旧选中态只有 `background: var(--dsw-alias-bg-layer-2)`，
+  叠在弹层 `--dsw-alias-bg-overlay` 上几乎是同色（本机皮肤下 `rgba(243,247,253,.95)` on
+  `rgba(248,251,255,.98)`），选中与未选中的差别只剩字重。
+  改法：`.dsa-seg` 变成带中灰描边（`rgba(127,127,127,.5)`）与内凹阴影的轨道；两个选项各带一枚 13px
+  内联 SVG 图标（气泡＝主对话，带右轨的框＝侧边卡片），**选中侧为品牌实底 + 白色 600 字 + 内白环 + 投影**，
+  未选侧为 `label-secondary` + 透明底；补 `:hover` 与 `:focus-visible`（品牌色 outline）。
+  组件抽成 `CarrierSeg`（client §9），带 `role="group"`、`aria-pressed`、`title` 说明；文案仍走 i18n。
+- **深色主题里白字压品牌色只有 2.79:1（复核时发现的，非用户反馈）**：本机皮肤深色把
+  `--dsw-alias-brand-primary` 提亮到 `#5b9cf5`，白色 600 字在其上低于 4.5:1 正文下限、也低于 3:1 大字下限。
+  改法：`[data-ds-dark-theme]` 下选中侧改用深墨 `#0a1428`（实测 6.57:1）；浅色保持白字
+  （`#2563c0` 上 5.79:1）。令牌值取自本机 `uiskin-theme`，对比度按 WCAG 相对亮度公式实算，不是目测。
+- **弹层边框/阴影对比度修补（1.8.1 之后写在本地、未提交，本次一并发布）**：`.dsa-pop` 的 1px 边
+  改显式中灰 `rgba(127,127,127,.55)`（`border-l2` 落在弹层表面只量到 ≈1.3:1），阴影改两层衰减
+  `0 14px 36px rgba(0,0,0,.30), 0 3px 10px rgba(0,0,0,.14)`；`.dsa-pop` 内的次级文案改用
+  `label-primary` 并保留 `.78` 不透明度。
+- 测试：contract 新增 **16** 项钉住这个控件（唯一 `.dsa-seg`、恰好两个按钮、恰好一个
+  `aria-pressed="true"`、每个选项带一枚内联 `svg`、`data-on` 只有一个真值、两个去向的标签不互换、
+  品牌实底规则与深色覆盖规则必须出现在样式表里）。**点击切换本身仍然不可测**：harness 的
+  `useState` 只回队列式 setter、不触发重渲染，注释里写明了原因，没有假装测过。
+- 版本号三处同步到 1.8.2。
+
+本机实测（四项均 exit 0）：verify **57** / contract **972** / float-placement **38** / smoke **226**
+= **1293 项全部通过**（1.8.1 为 1277，contract 956 → 972）。
+
+> 未验证（如实记录）：浅色/深色两张对比图（`design-preview/07-carrier-seg-{light,dark}.png`）是
+> **离屏渲染**——无头 Edge 加载"从 `client.js` 抽取的真实 CSS + 本机皮肤真实令牌值"的静态页，
+> 不是运行中 DSH 窗口的截图。真实页面里的点击手感、字体栅格化差异、弹层背后背景图的影响，
+> 仍需刷新页面人工看一次。此前一轮口头汇报里说"新增 8 条"是数错了，实际新增 16 条。
+
+## 1.8.1
+
+**主题：对 1.8.0 交付做实证复核后的三项修正——1 个已复现的真实缺陷、1 处开关失效、1 条缺证据的声明。**
+
+复核方式：不采信文档，独立跑四套测试、读全部新增代码、对可疑点写最小复现脚本并落盘证据。
+
+- **P0（真实缺陷，已复现）「清空全部历史」刷新后复活**：`clearHistory()` 只删了当前的
+  `:cards:v3` 键，而 `readPersisted()` 在 v3 缺席时会回落到 `:cards:v2` → `:cards:v1`
+  （这条回落正是"非破坏式迁移"的实现方式）。于是**从 1.7.x 升级上来的用户**点「清空全部历史」
+  后刷新页面，旧卡片会从遗留的 v2 键整份读回来——2026-10-17 用独立脚本复现
+  （清空前 history=1 → 清空后=0、v3 键为 null、v2 键仍在 → 重载后 history=1，卡片 id 为旧数据）。
+  修法：`clearHistory` 同时删除 v3/v2/v1 三代键（显式清空本就是破坏性操作，它是唯一允许丢弃旧键的动作）。
+  测试为什么原先没拦住：旧用例只断言"v3 键被删掉"，且只播种 v3 键、清空后**不重载客户端**——
+  钉的是实现细节而非用户可见结果。新增用例覆盖"遗留 v2 + 清空 + 重载仍为空"。
+- **P2（开关失效）建议追问芯片未跟随 `followUpSuggestions`**：只要答案里存在 `<followups>` 块，
+  芯片就渲染，与默认关闭的 opt-in 语义不符。现在渲染跟随开关；**块剥离保持无条件**
+  （模型乱写标记时，正文仍不会被污染成散文）。旧用例正是"开关关闭却断言芯片出现"，已改为开启态，
+  并补关闭态回归守卫。
+- **P1（证据链 + 勘误）`inputActions` 写入面**：1.8.0 把"官方写入面存在
+  `captureInsertion()` / `insertText()` / `setDraft()`"写成探针的第④条结论，但
+  `.compat-report/scripts/composer-probe.mjs` 的正文**从未探测 `inputActions`**（只有脚本头注释
+  承诺过），仓库内也没有任何证据文件出现过这两个标识符。经复核，**声明本身成立**，现补产物层证据：
+  `npm pack @deepseek-ai/dsh-client-ui-conversation@0.2.0-rc.2` 与 `@0.2.1-rc.2` 解包后，
+  `lib/types/client/contract/input.d.ts` 含 `captureInsertion(): TokenSpan` 与
+  `insertText(text: string, span: TokenSpan): boolean`，`lib/client.js` 含 `var SessionInputShell = class`。
+  逐条命中、行号与官方契约原文见 `.compat-report/evidence/p2-inputactions-contract-2026-10-17.json`；
+  README §6.3 与 1.8.0 条目已就地勘误，探针脚本头也改成了它真正做的事。
+- 版本号三处同步到 1.8.1。
+
+本机实测（四项均 exit 0）：verify **57** / contract **956** / float-placement **38** / smoke **226**
+= **1277 项全部通过**（较 1.8.0 的 1267 新增 10 项）。
+
+> 未验证（如实记录）：本次修的是逻辑与测试，**没有在真实页面上点过任何按钮**。
+> 1.8.0 未验证栏的 ①–⑤ 全部继续有效（写回按钮的真实点击与手感、原文高亮的观感与虚拟列表命中率、
+> 导出的真实落盘、真实模型对风格与 `<followups>` 的遵循度、Electron 外壳表现）。
+> 另外：`inputActions` 的证据核到 0.2.0-rc.2 与 0.2.1-rc.2 两个版本，未逐版遍历。
+
 ## 1.8.0
 
 **主题：P2 能力补齐——回答风格档位、答案写回输入框、原文回看定位、模型生成的追问建议、导出与多版本答案。**
@@ -21,9 +93,13 @@
   contenteditable**（`[data-composer-input][data-lexical-editor="true"]`），不是
   textarea；② `document.execCommand('insertText')` 返回 `false` 且**完全不生效**；
   ③ 合成 `beforeinput`（`inputType:'insertText'`）会被 Lexical 接受——文本落地、
-  发送按钮由禁用转可用；④ DSH 的槽位标准 prop `inputActions` 暴露官方写入面
-  `captureInsertion()` + `insertText(text, span)` + `setDraft(text)`
-  （源码：`dsh-client-ui-conversation` 的 `SessionInputShell.actions`）。
+  发送按钮由禁用转可用。另有一条**不在探针内**的结论：DSH 的槽位标准 prop `inputActions`
+  暴露官方写入面 `captureInsertion()` + `insertText(text, span)` + `setDraft(text)`。
+  > **1.8.1 勘误**：本条原先被写成"探针的第④条结论"，但探针脚本的正文从未实现该探测
+  > （只有脚本头注释承诺过），当时没有可核验的证据。经产物层复核，声明本身**成立**：
+  > `@deepseek-ai/dsh-client-ui-conversation@0.2.0-rc.2 / 0.2.1-rc.2` 的
+  > `lib/types/client/contract/input.d.ts` 含该契约，逐条命中见
+  > `.compat-report/evidence/p2-inputactions-contract-2026-10-17.json`。
   据此实现三级写入阶梯：**官方 `insertText`**（重新 `captureInsertion` 后可重试一次）
   → **DOM `beforeinput`**（contenteditable 追加 / textarea 用原生 value setter + input
   事件）→ 明确失败。改写类动作（`builtin:polish` / `builtin:fix`）的已完成答案上出现

package/README.md

@@ -72,8 +72,10 @@ dsh-sidecard-ask/
 ├── README.md             本文件
 ├── CHANGELOG.md          版本变更记录
 ├── LICENSE               MIT
-├── design-preview/       1.5.0 的方案讨论资料，**不参与发布**：00–02 是手绘 SVG 示意图（非截图），
-│                         03-prototype-ac.html 是可直接双击打开的可点按原型（自带近似色板，非真实观感）
+├── design-preview/       方案讨论资料，**不参与发布**：00–02 是手绘 SVG 示意图（非截图），
+│                         03-prototype-ac.html 是可直接双击打开的可点按原型（自带近似色板，非真实观感），
+│                         07-carrier-seg-{light,dark}.png 是 1.8.2 的离屏渲染对比图（无头 Edge + 真实 CSS
+│                         与真实令牌值，仍非运行中窗口截图）
 ├── tools/
 │   └── compat-probe.mjs  DSH 版本能力探测（§7 矩阵的来源）
 └── test/
@@ -362,13 +364,24 @@ ctx.inject(['sidebarRightTabs', 'sidebarRight'], (injected) => { ... })
 ### 3. `client.js` §8c —— 答案写回输入框（1.8.0，已做真机探针）
 
 2026-10-17 用**隔离 `DSH_HOME` + 无头 Edge**（插件不参与）对真实 DSH 页面做了探针，
-脚本见 `.compat-report/scripts/composer-probe.mjs`，三条硬结论：
+脚本见 `.compat-report/scripts/composer-probe.mjs`，证据见
+`.compat-report/evidence/p2-probe-2026-10-17.json`，三条硬结论：
 
-| 问题 | 结论 |
-|---|---|
-| composer 的真实 DOM | **Lexical contenteditable**：`<div contenteditable="true" role="textbox" data-composer-input="true" data-lexical-editor="true">`，槽位 `conversation.composer` |
-| 有没有官方写入面 | **有**。槽位标准 prop `inputActions` 暴露 `captureInsertion()` / `insertText(text, span)` / `setDraft(text)` / `submit()`（源码 `dsh-client-ui-conversation` 的 `SessionInputShell.actions`）。`sessions.using(...).binding.session.prompt` 只负责**提交**，不能写草稿 |
-| native setter + input 事件能否同步 | **N/A 且无效**：不是 textarea，没有 value setter；`document.execCommand('insertText')` 返回 `false`、文本不变。**有效的是**合成 `beforeinput`（`inputType:'insertText'`）：文本落地、发送按钮由禁用转可用 |
+| 问题 | 结论 | 证据来源 |
+|---|---|---|
+| composer 的真实 DOM | **Lexical contenteditable**：`<div contenteditable="true" role="textbox" data-composer-input="true" data-lexical-editor="true">`，槽位 `conversation.composer` | 页面探针 |
+| native setter + input 事件能否同步 | **N/A 且无效**：不是 textarea，没有 value setter；`document.execCommand('insertText')` 返回 `false`、文本不变。**有效的是**合成 `beforeinput`（`inputType:'insertText'`）：文本落地、发送按钮由禁用转可用 | 页面探针 |
+| 有没有官方写入面 | **有**。槽位标准 prop `inputActions` 暴露 `captureInsertion()` / `insertText(text, span)` / `setDraft(text)` / `submit()`。`sessions.using(...).binding.session.prompt` 只负责**提交**，不能写草稿 | **产物层核验**（见下），**不是**页面探针 |
+
+> **1.8.1 勘误**：上面第三行原先被写成"探针的第④条结论"，但 `composer-probe.mjs` 的正文
+> 从未探测 `inputActions`（只有脚本头的注释承诺过）——这条声明当时**没有可核验的证据**。
+> 经复核，声明本身**成立**，现改由产物层证据背书：`npm pack
+> @deepseek-ai/dsh-client-ui-conversation@0.2.0-rc.2` 与 `@0.2.1-rc.2` 解包后，
+> `lib/types/client/contract/input.d.ts` 含 `captureInsertion(): TokenSpan` 与
+> `insertText(text: string, span: TokenSpan): boolean`（且文档明确 *"returns false when the
+> draft changed"*，与实现"拒绝先于写入、故可安全回落 DOM 路径"的假设一致），
+> `lib/client.js` 含 `var SessionInputShell = class`。逐条命中与行号见
+> `.compat-report/evidence/p2-inputactions-contract-2026-10-17.json`。
 
 因此实现是三级阶梯：`inputActions.insertText`（重新 `captureInsertion` 后可重试一次）→
 DOM `beforeinput`（追加到末尾）→ 失败时 toast。**脚本设定的 Range 不被 Lexical 采纳**，
@@ -504,6 +517,9 @@ node tools/compat-probe.mjs --json tools/.cache/matrix.json
 2. 选区末端应浮出动作条：「💬 追问选中内容」按钮 + 「解释 / 翻译 / 总结 / 润色 / 纠错」芯片，
    按钮带区域徽标（聊天区 / 任务区 / 跨区选择）；**点任一芯片即跳过提问框直接在侧边卡片作答**；
 3. 点主按钮后提问框出现（顶部同样有一排芯片），焦点在输入框，引文预览显示选中文本；
+   底部「作答位置」是两枚带内联图标的芯片（气泡＝主对话，带右轨的框＝侧边卡片）：**选中侧为品牌实底 + 白字 600 + 内白环**，
+   未选侧只有描边；深色主题下选中侧改深墨字（品牌色在深色被提亮到 `#5b9cf5`，白字只有 2.79:1，深墨字 6.57:1）；
+   控件带 `role="group"` 与 `aria-pressed`，键盘 Tab 可见品牌色焦点环；
 4. 输入问题按 Enter → 提问框关闭，右下角出现卡片，状态先为「作答中…」并**逐字增长**；
 5. 结束后状态变「已完成」；底部出现「改问 / 复制 / 继续追问 / 关闭」；答案里代码块的右上角有「⧉ 复制代码」；
 6. 点「复制」→ 出现「已复制」提示；点「继续追问」→ 输入第二条问题（追加一轮），卡片内容**重置换行**后继续流式；
@@ -588,15 +604,17 @@ node test/smoke-test.mjs        # 端到端：流式/截断/取消/持久化/失
 ```
 
 四个脚本都以 `process.exitCode` 反映结果，失败会列出具体条目；测试会把 `DSH_HOME` 指向临时目录，不会污染真实配置。
-当前规模（1.8.0 本机实测，四项均 exit 0）：verify **57** 项 + contract **946** 项 + float-placement **38** 项 +
-smoke **226** 项 = **1267 项全部通过**（1.7.2 为 1004 项；新增 263 项覆盖 P2-1 风格档位、
-P2-2 写回决策表与两级写入、P2-3 签名/遍历/失败分支、P2-4 宽容解析与芯片渲染、
-P2-5 导出内容与 v1/v2→v3 迁移）。
+当前规模（1.8.2 本机实测，四项均 exit 0）：verify **57** 项 + contract **972** 项 + float-placement **38** 项 +
+smoke **226** 项 = **1293 项全部通过**（1.8.1 为 1277 项，其中 contract 由 956 → 972：新增 16 项钉住提问框
+「作答位置」分段芯片——唯一 `.dsa-seg`、两个按钮、恰好一个 `aria-pressed`、各带一枚内联图标、
+品牌实底规则与深色覆盖规则；点击切换本身不可测，原因见 1.8.2 的 CHANGELOG）。
 
 **真机探针（不属于四套自测）**：`.compat-report/scripts/composer-probe.mjs` 需要
-`playwright-core` 与本机 Edge，对**真实 DSH 页面**回答 composer DOM / 官方写入面 /
-`beforeinput` 是否生效 / `CSS.highlights` 是否可用四个问题。它是 P2-2 的落地依据，
-**不能**被四套自测替代，也不替代人工观感确认。
+`playwright-core` 与本机 Edge，对**真实 DSH 页面**回答 composer DOM / 哪条写入路径真能改变
+编辑器状态 / `CSS.highlights` 是否可用三个问题（证据 `.compat-report/evidence/p2-probe-2026-10-17.json`）。
+它**不**探测 `inputActions`——那是通过槽位 prop 交给插件的面，页面侧脚本读不到；该写入面的存在性
+改由**产物层证据**背书（`.compat-report/evidence/p2-inputactions-contract-2026-10-17.json`）。
+探针是 P2-2 的落地依据，**不能**被四套自测替代，也不替代人工观感确认。
 
 > 1.5.0 之前这里还放过 `tools/balance-check.mjs` 与 `tools/i18n-check.mjs` 两个「替代检查」。
 > 它们已被**删除**：前者用「正则字面量 vs 除号」的启发式判断，把 8 个源文件全部误报为残损；
@@ -778,5 +796,8 @@ npm deprecate "<旧包名>@*" "Renamed to <新包名> - <原因>"       # 旧名
 10. **建议追问（1.8.0）依赖模型遵循格式**：模型不写 `<followups>`、写半个、或写得过长时，
     客户端只会"少几个芯片"，答案正文照常显示；这是设计内的降级，不是错误。该功能不额外发请求。
 11. **多版本（1.8.0）只在「重试 / 改问」时产生**：普通「继续追问」把旧问答存进 `history`（作为上下文），
-    不进 `versions`；每卡上限 5 条，超出丢最旧。v3 持久化保留 v2/v1 旧键，回退旧版本仍可读自己的数据。
+    不进 `versions`；每卡上限 5 条，超出丢最旧。v3 持久化**默认保留** v2/v1 旧键（回退旧版本仍可读
+    自己的数据）；**唯一的例外是「清空全部历史」**——显式清空会同时删除 v3/v2/v1 三代键（1.8.1）。
+    这条例外是必需的：只删当前键会让 `readPersisted()` 的 v3→v2→v1 回落把刚清掉的历史从旧键读回来，
+    刷新一次就复活（1.8.1 复现并修复）。
 

package/client.js

@@ -47,7 +47,7 @@ window.__ModuleLoader__.load({
      * the Host and the module's `api.version` both read it, so a report can
      * never claim a generation the browser is not actually running.
      */
-    const CLIENT_VERSION = '1.8.0'
+    const CLIENT_VERSION = '1.8.2'
 
     /**
      * Tab kind served by the DSH native right rail (also its implementation id).
@@ -1919,10 +1919,17 @@ window.__ModuleLoader__.load({
    trigger drops its own fixed positioning, chips join the row directly. */
 .dsa-trigger-embedded{position:static;box-shadow:0 2px 10px rgba(0,0,0,.18)}
 .dsa-quickbar-chips{display:contents}
+/* Contrast pass, driven by a light-theme reference screenshot: every 1px edge
+   inside the popover measured only ≈1.3–1.7:1 against the card surface, which
+   is why the card read as a translucent sticker instead of a framed popover.
+   The frame is therefore drawn explicitly here rather than through border-l2,
+   which the host resolves below that level; mid grey is used instead of a
+   black/white alpha so the stroke stays visible on both themes. The shadow is
+   a two-layer falloff so the card lifts off the page as well. */
 .dsa-pop{pointer-events:auto;position:fixed;width:min(420px, 92vw);display:flex;flex-direction:column;gap:8px;
-  padding:12px;border-radius:12px;border:1px solid var(--dsw-alias-border-l2, rgba(127,127,127,.35));
+  padding:12px;border-radius:12px;border:1px solid rgba(127,127,127,.55);
   background:var(--dsw-alias-bg-overlay, #fff);color:var(--dsw-alias-label-primary, #111);
-  box-shadow:0 10px 30px rgba(0,0,0,.24);font-size:13px;line-height:19px}
+  box-shadow:0 14px 36px rgba(0,0,0,.30),0 3px 10px rgba(0,0,0,.14);font-size:13px;line-height:19px}
 .dsa-row{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
 .dsa-title{font-weight:600;font-size:13px}
 .dsa-quote{margin:0;padding:6px 8px;max-height:96px;overflow:auto;white-space:pre-wrap;word-break:break-word;
@@ -1946,11 +1953,43 @@ window.__ModuleLoader__.load({
 /* Icon-only variant (the floating layer's collapse/hide controls): square and
    quiet so the card title bar stays one line and the title keeps the weight. */
 .dsa-btn-icon{padding:4px 7px;line-height:1;font-size:13px;color:var(--dsw-alias-label-secondary, #666)}
-.dsa-seg{display:inline-flex;border:1px solid var(--dsw-alias-border-l1, rgba(127,127,127,.3));border-radius:8px;overflow:hidden}
-.dsa-seg button{padding:3px 10px;border:none;background:transparent;color:var(--dsw-alias-label-secondary, #555);
-  font:inherit;font-size:12px;cursor:pointer}
-.dsa-seg button[data-on="true"]{background:var(--dsw-alias-bg-layer-2, rgba(127,127,127,.14));
-  color:var(--dsw-alias-label-primary, #111);font-weight:500}
+/* Segmented control (main chat / side card). These are the two destinations an
+   answer can land in, so the pair has to read as a radio choice, not as two
+   quiet labels: the group gets a recessed track with an explicit mid-grey edge
+   (border-l1/l2 measured ≈1.3:1 against the popover surface and disappeared),
+   each option carries a 13px label plus an inline glyph, and the selected side
+   is a solid brand chip whose white 600-weight text cannot be confused with the
+   unselected side. The inner white ring keeps the chip from flattening on the
+   brand colour in either theme. */
+.dsa-seg{display:inline-flex;padding:3px;gap:3px;
+  border:1px solid rgba(127,127,127,.5);border-radius:10px;
+  background:var(--dsw-alias-bg-layer-1, rgba(127,127,127,.10));
+  box-shadow:inset 0 1px 2px rgba(0,0,0,.10)}
+.dsa-seg button{display:inline-flex;align-items:center;gap:5px;padding:5px 12px;
+  border:1px solid transparent;border-radius:7px;background:transparent;
+  color:var(--dsw-alias-label-secondary, #666);font:inherit;font-size:13px;font-weight:500;
+  line-height:18px;cursor:pointer;white-space:nowrap;
+  transition:background .12s ease,color .12s ease,box-shadow .12s ease}
+.dsa-seg button svg{flex:none;opacity:.8}
+.dsa-seg button:hover{background:var(--dsw-alias-bg-layer-2, rgba(127,127,127,.16));
+  color:var(--dsw-alias-label-primary, #222)}
+.dsa-seg button:hover svg{opacity:1}
+.dsa-seg button:focus-visible{outline:2px solid var(--dsw-alias-brand-primary, #4c8dff);outline-offset:1px}
+.dsa-seg button[data-on="true"]{background:var(--dsw-alias-brand-primary, #4c8dff);
+  border-color:var(--dsw-alias-brand-primary, #4c8dff);color:#fff;font-weight:600;
+  box-shadow:0 1px 4px rgba(0,0,0,.22),inset 0 0 0 1px rgba(255,255,255,.22)}
+.dsa-seg button[data-on="true"] svg{opacity:1}
+.dsa-seg button[data-on="true"]:hover{background:var(--dsw-alias-brand-primary, #4c8dff);color:#fff}
+/* Dark themes lighten the brand accent (the local skin goes #2563c0 -> #5b9cf5),
+   where white 600 text on the chip measures 2.79:1 — below the 4.5:1 floor for
+   body text and below even the 3:1 large-text floor. Invert the on-brand label
+   there instead of betting on one fixed foreground.
+   DSH flags dark mode with [data-ds-dark-theme] on the root element. */
+html[data-ds-dark-theme] .dsa-seg button[data-on="true"],
+body[data-ds-dark-theme] .dsa-seg button[data-on="true"],
+html[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover,
+body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
+  color:#0a1428;text-shadow:0 1px 0 rgba(255,255,255,.25)}
 .dsa-card{pointer-events:auto;display:flex;flex-direction:column;gap:8px;padding:12px;border-radius:12px;
   border:1px solid var(--dsw-alias-border-l2, rgba(127,127,127,.35));
   background:var(--dsw-alias-bg-overlay, #fff);color:var(--dsw-alias-label-primary, #111);
@@ -2014,6 +2053,13 @@ window.__ModuleLoader__.load({
 .dsa-code{padding:0 4px;border-radius:4px;background:var(--dsw-alias-bg-layer-2, rgba(127,127,127,.12));
   font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}
 .dsa-muted{color:var(--dsw-alias-label-secondary, #666);font-size:11px;line-height:16px}
+/* Same contrast pass, applied to the popover's body copy: label-secondary
+   measures ≈6:1 here and reads washed out at 11–13px. Secondary text inside
+   .dsa-pop is re-derived from the primary label token instead, held one step
+   quieter than the title through opacity so the hierarchy survives. */
+.dsa-pop .dsa-quote,
+.dsa-pop .dsa-muted{color:var(--dsw-alias-label-primary, #111)}
+.dsa-pop .dsa-muted{opacity:.78}
 .dsa-error{color:var(--dsw-alias-state-error-primary, #c0392b);font-size:12px}
 .dsa-toast{pointer-events:auto;position:fixed;left:50%;transform:translateX(-50%);bottom:24px;padding:6px 12px;
   border-radius:999px;font-size:12px;background:var(--dsw-alias-bg-overlay, #222);
@@ -3260,6 +3306,43 @@ window.__ModuleLoader__.load({
         }, h('span', null, action.label))))
     }
 
+    /** Where the answer should land: the main conversation, or an independent
+     *  side card. Rendered as a two-chip switch with an inline glyph per option
+     *  so the pair is scannable at a glance, and the selected chip is painted
+     *  with the brand fill (see .dsa-seg) instead of a whisper-grey tint. The
+     *  hint text moves into title/aria-label rather than a third line, because
+     *  the popover already has quote + chips + composer and a longer hint would
+     *  push the submit row out of view. */
+    function CarrierSeg({ value, onChange }) {
+      const glyph = path => h('svg', {
+        viewBox: '0 0 16 16', width: 13, height: 13, 'aria-hidden': 'true', focusable: 'false',
+      }, h('path', {
+        d: path, fill: 'none', stroke: 'currentColor', strokeWidth: 1.3,
+        strokeLinejoin: 'round', strokeLinecap: 'round',
+      }))
+      const options = [
+        // speech balloon = the main conversation
+        { id: 'main', label: t('carrierMain'), hint: t('carrierMainHint'),
+          icon: glyph('M2.5 3.5h11v8H8.4L5.2 14.3V11.5H2.5z') },
+        // frame with a rail on the right = a card docked in the side panel
+        { id: 'side', label: t('carrierSide'), hint: t('carrierSideHint'),
+          icon: glyph('M2.5 3.5h11v9h-11zM10 3.5v9') },
+      ]
+      return h('div', {
+        className: 'dsa-seg', role: 'group', 'aria-label': t('carrier'),
+      }, options.map(option => {
+        const on = value === option.id
+        return h('button', {
+          key: option.id,
+          type: 'button',
+          'data-on': String(on),
+          'aria-pressed': String(on),
+          title: option.hint,
+          onClick: () => onChange(option.id),
+        }, option.icon, option.label)
+      }))
+    }
+
     /** The question popover. */
     function AskPopover({ candidate, config, onClose, onSubmit, onQuick }) {
       const [question, setQuestion] = React.useState('')
@@ -3341,19 +3424,7 @@ window.__ModuleLoader__.load({
       }),
       h('div', { className: 'dsa-row' },
         h('span', { className: 'dsa-muted' }, t('carrier')),
-        h('div', { className: 'dsa-seg' },
-          h('button', {
-            type: 'button',
-            'data-on': String(carrier === 'main'),
-            title: t('carrierMainHint'),
-            onClick: () => setCarrier('main'),
-          }, t('carrierMain')),
-          h('button', {
-            type: 'button',
-            'data-on': String(carrier === 'side'),
-            title: t('carrierSideHint'),
-            onClick: () => setCarrier('side'),
-          }, t('carrierSide')))),
+        h(CarrierSeg, { value: carrier, onChange: setCarrier })),
       h('div', { className: 'dsa-row', style: { justifyContent: 'flex-end' } },
         h('span', { className: 'dsa-muted', style: { marginRight: 'auto' } },
           t('askShortcutHint', { key: config.shortcut })),
@@ -3688,7 +3759,13 @@ window.__ModuleLoader__.load({
         // P2-4: chips the MODEL proposed for this answer. The block has
         // already been stripped from the body; a missing/half/oversized block
         // simply yields none. Clicking one submits an ordinary follow-up turn.
-        terminalWithAnswer && viewingVersion === null && parsedFollowUps.followups.length > 0
+        //
+        // The ROW follows `followUpSuggestions`, while the STRIP above stays
+        // unconditional: the toggle owns "do we offer the feature", and a
+        // stray block from a model must never render as raw prose even when
+        // the user never asked for chips.
+        terminalWithAnswer && viewingVersion === null && config.followUpSuggestions === true
+          && parsedFollowUps.followups.length > 0
           ? h('div', { className: 'dsa-sug' },
             h('span', { className: 'dsa-muted' }, t('suggestionsLabel')),
             h(QuickChips, {
@@ -4682,10 +4759,22 @@ window.__ModuleLoader__.load({
             })
             toast(t('historyDeleted'))
           },
-          /** Empty the durable history without touching running cards. */
+          /**
+           * Empty the durable history without touching running cards.
+           *
+           * Removes EVERY generation key, not just the current one:
+           * {@link readPersisted} falls back to v2 → v1 whenever the current
+           * key is absent (that fallback is exactly what makes the
+           * non-destructive migration work), so deleting only v3 let a legacy
+           * payload resurrect the "cleared" history on the next page load —
+           * reproduced live, 2026-10-17. An explicit user clear is destructive
+           * by definition: it is the one action allowed to drop the old keys.
+           */
           clearHistory() {
             try {
-              window.localStorage?.removeItem(PERSIST_KEY)
+              for (const key of [PERSIST_KEY, PERSIST_V2_KEY, PERSIST_LEGACY_KEY]) {
+                window.localStorage?.removeItem(key)
+              }
             } catch (error) {
               console.warn(`[${PLUGIN_ID}] history clear failed:`, error)
             }

package/index.js

@@ -42,7 +42,7 @@ export const name = 'dsh-sidecard-ask'
 export const inject = ['webServer']
 
 /** Version of this plugin (kept in step with package.json by test/verify.mjs). */
-export const PLUGIN_VERSION = '1.8.0'
+export const PLUGIN_VERSION = '1.8.2'
 
 /** Route prefix of the plugin's own API. */
 export const ROUTE_PREFIX = '/sidecard-ask/api'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-sidecard-ask",
-  "version": "1.8.0",
+  "version": "1.8.2",
   "description": "DSH 划词追问（侧边卡片作答）：在聊天区与任务区选中文本就地追问，答案由独立子代理在侧边卡片里流式呈现，也可选择落回主对话。",
   "type": "module",
   "main": "index.js",