dsh-sidecard-ask 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2.1.1
+
+**主题：卡片记录只收侧边卡片——改发到主对话的问答不再进持久化历史。** 无 API/配置变更。
+
+### 修复
+
+- **主对话承载的问答混进卡片记录**。`syncPersisted()` 一直只收 `carrier === 'side'`，但 v3 信封或
+  v1/v2 迁移数据里可能存在 `carrier: 'main'` 的条目（旧版本写下的），
+  `parseEnvelope()` 会把它当普通记录读回来并在启动时以侧边卡片回放，与主对话内容重复。
+  现在读取时直接丢弃这类条目：它不写 localStorage、不进设置页的历史管理器、也不进「导出全部 .md」。
+- **`sendToMain()` 成功后清理记录**。卡片改投主对话时从 durable history 删除对应 id
+  （`draft` 模式只是把文本放进输入框、尚未真正发出，保留记录）。
+
+CHANGELOG 对应回归测试：`test/contract-test.mjs` 的 `main-carrier records` 段（main 提交不写盘、
+旧 payload 里的 main 条目被丢弃、`sendToMain` 删除记录）。
+
 ## 2.1.0
 
 **主题：跨端核查后的性能与可观测性收口——流式热路径从「每次 delta 全树重渲染」改成「只重渲染变化的卡」，

package/README.md

@@ -713,6 +713,8 @@ node tools/compat-probe.mjs --json tools/.cache/matrix.json
 7e. 设置页勾选「完成后桌面通知」会请求通知权限；授权后切到其它标签页/窗口，作答结束时应弹系统通知。
 7f. 设置页「历史追问卡片」：可搜索、恢复到浮层、单条删除、清空；「历史卡片保存数量」设 0 后新卡片不再写盘；
    注意：**关闭浮层卡片不会删历史**（1.8.0 起历史只在管理中心删除）。
+   **改发到主对话（`carrier: 'main'`）的问答不算卡片记录**（2.1.1 起）：它只出现在主对话里，不写
+   localStorage，也不出现在历史管理器与「导出全部 .md」；旧版本写进去的 main 条目在读取时丢弃。
 7g. **回答风格（1.8.0）**：设置页把「回答风格」切成「精简」并保存 → 下一次追问的答案应明显更短、
    不复述原文；切「详细」→ 应看到展开与依据。自检办法：`GET /state` 的 `config.answerStyle` 应为所选值；
    若 provider 不支持 persona，指令会内联进提示词（卡片上的 provider 行为不变）。
@@ -842,7 +844,7 @@ node tools/compat-probe.mjs 0.1.7-rc.2            # 也可只探某个版本
 ```powershell
 # 0) 探活：唯一免鉴权的接口，只回插件版本与宿主时钟
 (Invoke-WebRequest http://127.0.0.1:8080/sidecard-ask/api/ping -UseBasicParsing).Content
-# → {"ok":true,"value":{"version":"2.1.0","at":1792...}}    200 = 插件宿主半已加载
+# → {"ok":true,"value":{"version":"2.1.1","at":1792...}}    200 = 插件宿主半已加载
 
 # 1) 宿主接口与能力（archived 父会话检测也在这里）——需要会话
 #    在本机浏览器已登录的前提下复用会话：先 -WebSession 登录，或把浏览器的 Cookie 头带进来

package/client.js

@@ -117,7 +117,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 = '2.1.0'
+    const CLIENT_VERSION = '2.1.1'
 
     /**
      * Tab kind served by the DSH native right rail (also its implementation id).
@@ -3123,7 +3123,13 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
      * @returns {string} the file body.
      */
     function buildHistoryMarkdown(entries) {
-      const list = Array.isArray(entries) ? entries.filter(entry => entry !== null && typeof entry === 'object') : []
+      // 主对话承载的问答不算卡片记录（2026-10-23，用户要求）——即使调用方
+      // 递来一条带 `carrier: 'main'` 的旧条目，导出也不该把它当成侧边卡片。
+      const list = Array.isArray(entries)
+        ? entries.filter(entry => entry !== null
+          && typeof entry === 'object'
+          && (entry.carrier === undefined || entry.carrier === 'side'))
+        : []
       if (list.length === 0) return ''
       const sections = list.map((entry, index) => {
         const body = buildCardMarkdown(entry)
@@ -5693,7 +5699,14 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
             const value = JSON.parse(raw)
             if (value?.version !== version || !Array.isArray(value.cards)) return []
             return value.cards
-              .filter(entry => typeof entry?.id === 'string' && entry.id !== '' && typeof entry.question === 'string')
+              // 主对话承载的问答不算卡片记录（2026-10-23，用户要求）。旧版本
+              // 曾把 `carrier: 'main'` 的条目写进 v3/legacy 信封：读取时丢弃，
+              // 磁盘上的副本等下一次写回自然消失；没有 carrier 字段的 v1/v2
+              // 条目仍按侧边卡片处理（它们当时只可能来自侧边卡片）。
+              .filter(entry => typeof entry?.id === 'string'
+                && entry.id !== ''
+                && typeof entry.question === 'string'
+                && (entry.carrier === undefined || entry.carrier === 'side'))
           } catch { return [] }
         }
 
@@ -5756,6 +5769,9 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
         /** Recompute the durable set from the live store and write it. */
         const syncPersisted = () => {
           const cap = historyCap()
+          // 只有侧边卡片算「记录」：改发到主对话的问答由主对话自己保存，
+          // 不再进 durable history（2026-10-23，用户要求）。carrier 过滤是
+          // 这条边界的唯一入口，下游 writePersisted 不要再放宽。
           const finished = store.state.cards
             .filter(card => card.carrier === 'side'
               && (card.status === 'done' || card.status === 'stopped')
@@ -6344,6 +6360,20 @@ body[data-ds-dark-theme] .dsa-seg button[data-on="true"]:hover{
                 error: null,
                 streaming: null,
               })
+              // 主对话承载的问答不算卡片记录（2026-10-23，用户要求）。这条
+              // 卡片一旦改投主对话，durable history 里若还有它的副本就必须
+              // 删掉，否则刷新后它会以侧边卡片的身份被恢复，和主对话重复。
+              // `draft` 模式只是把文本放进输入框（还没有真正发出），保留记录。
+              // cap === 0 与 deleteCard 同规则：不动已存的键，只镜像内存。
+              if (result.mode !== 'draft') {
+                const kept = store.state.history
+                  .filter(item => item.id !== card.id)
+                  .slice(0, historyCap())
+                if (kept.length !== store.state.history.length) {
+                  if (historyCap() > 0) writePersisted(kept)
+                  store.set({ history: kept })
+                }
+              }
               toast(result.mode === 'draft' ? t('draftInserted') : t('mainSent'))
             } catch (error) {
               patchCard(card.id, {

package/index.js

@@ -45,7 +45,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 = '2.1.0'
+export const PLUGIN_VERSION = '2.1.1'
 
 /** 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": "2.1.0",
+  "version": "2.1.1",
   "description": "DSH 划词追问（侧边卡片作答）：在聊天区与任务区选中文本就地追问，答案由独立子代理在侧边卡片里流式呈现，也可选择落回主对话。",
   "type": "module",
   "main": "index.js",