dsh-composer-ux 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.25.0] — 2026-10-18（「OpenCode 请求头」降级为旧宿主兼容层：宿主已原生支持就不注入）
+
+用户 2026-10-18 在设置页看到这一栏，问：**「是否还需要这个功能」**。查完上下游后答案是
+**不需要了，而且开着比不开更差**，用户拍板：关掉 + 改成"启动时探测宿主，有原生支持就不注入"。
+
+**三条证据（都在本机核过）**
+
+1. OpenCode Go 官方文档「可以在哪里使用？」第 3 条仍然要求客户端发
+   `x-opencode-session`（用于优化路由与 prompt cache），所以这个头本身还是要的；
+2. 但**上游已经自己发了**：`@earendil-works/pi-ai` 从 **1.0.2** 起自带
+   `dist/providers/opencode-headers.js`，`opencode` 与 `opencode-go` 两个 provider 都被
+   `withOpenCodeSessionHeader()` 包过；它用的是 `options.sessionId`（**每段对话的真实会话 id**），
+   而且 **`hasHeader()` 命中就不覆盖**；
+3. DSH 的 `llm-pi-ai` 调用时是 `headers: requestHeaders(profile.headers)` 与
+   `sessionId` **一起**交给 pi-ai 的 ⇒ 本插件注入的那个**固定 UUID**（设置页原话"所有对话共用
+   这一个值"）会**顶掉**真实 session id。也就是说：开着它，所有对话在 OpenCode 那边都是同一个
+   会话 —— 正是官方要用来做路由与缓存优化的那一维被抹平了。
+
+**改动**
+
+- 新增 `src/opencode-header.ts`：启动时探测宿主能力。判据是**宿主 pi-ai 安装里有没有
+  `dist/providers/opencode-headers.js`**（能力就是那个模块，版本号只用来写证据），探测面覆盖
+  桌面端（`resources/app.asar` 里的运行时）与网页版（从入口往上找 `node_modules` / `.pnpm`）；
+  探不到时**按旧宿主处理**（继续注入，失败方向是多做一次旧行为），并可用环境变量
+  `DSH_COMPOSER_UX_HEADER_NATIVE=1|0` 强制。
+- 宿主半（`src/host.ts`）：探测到原生支持时 —— 不注入、不生成 UUID、不记"已注入"的账；
+  状态行写「宿主已原生支持（pi-ai 1.1.0 自带 opencode-headers.js）：按每段对话的真实
+  session id 自动发送，本栏不再注入」。
+- 设置页（`src/client/SettingsSection.tsx`）：卡片顶部多一条说明（"本宿主已原生支持…这一栏
+  什么都不做"，与自检卡、状态行说同一件事）；概览写「宿主已原生支持（不需要）」而不是像故障的
+  "未启用"；「值」那一行的说明改成"旧宿主专用"。
+- 自检卡（`src/doctor.ts`）：`header` 那一行在原生支持时如实说明"这一栏不需要、也不会注入"。
+- 桌面 / 网页两个 profile 的 `headerEnabled` 均置 `false`（用户要求"关掉"；不过即便打开，
+  探测到原生支持也不会注入）。
+
+**验证**：33 套件 **2800 条** 0 失败；变异 **220 条全部咬住**（新增 `SG`/`SH`/`SI`）。`test/host-header-mirror.mjs` 新增第 19 / 20 节（原生支持不注入 + 不生成 UUID +
+状态行；探测判据用假目录逐条钉：模块在⇒native、模块缺⇒legacy、目录缺⇒legacy、环境变量强制、
+版本比较按数字不按字符串）；变异新增 `SG`/`SH`/`SI` 三条。
+
+**未验证（如实说明）**：探测只在本机两种布局（Electron asar / pnpm 检出）上验过；发行渠道若把
+pi-ai 装到别处，会落到"按旧宿主处理"，此时用环境变量强制即可。桌面端要重启后才加载这一版。
+
+
 ## [0.24.0] — 2026-10-17（金额胶囊把**子代理**的费用算进去）
 
 用户 2026-10-17：「**我发现金额胶囊不计算子代理的费用**」。
@@ -50,8 +93,8 @@
 变异 **217 条全部咬住**（新增 `SA`–`SF` 六条）；`tsc` 0 错误；`cost-panel-render` 新增第 1.2 节
 17 条渲染断言（旧夹具与旧断言一条没动）。
 
-**未验证（如实说明）**：没有真机截图；桌面端要等用户重启后才会加载这一版（那个进程还是
-2026-10-16 19:21 起的 0.2.0-rc.2）；子代理的钱只有总量、没有按峰谷拆开的金额。
+**未验证（如实说明）**：没有真机截图；桌面端要等用户重启后才会加载这一版（那个进程是
+2026-10-17 23:30 起的 **0.2.1-rc.2**，装的还是 0.23.4）；子代理的钱只有总量、没有按峰谷拆开的金额。
 
 
 ## [0.23.4] — 2026-10-16（适配 dsh 0.2.1-rc.1：无功能变化，只做验证与版本对齐）

package/README.md

@@ -493,6 +493,7 @@ Windows 上 DSH 给模型的终端工具是 **PowerShell**（工具名 `pwsh`）
   - **写完价目要立刻生效，靠的是"写的人通知"，不是设置变更事件**：0.1.7 的 `settings/document-updated` 只在 `describe()` 里比对 raw 变化后发出，而我们自己 `mutate` 写设置时并不调 `describe()` —— 设置页开着时会被界面刷新顺带触发，**设置页没开着**（例如后台的自动同步跑完）就不会发；而折叠缓存按 `seq` 去重、改规则不会重折旧事件，金额会**静静地停在旧价格档**上、界面上看不出。所以宿主半加了模块级 `moneyInvalidators` 注册表：用量路由登记"重读规则 + 作废价目缓存 + 作废折叠缓存"，两条同步路径写完设置直接调 `invalidateMoney()`，事件只作补充。
 - **内置第三方价目快照（0.10.0）**：`src/provider-prices.ts`（**生成**的，别手改：`node scripts/gen-provider-prices.mjs <models.dev-api.json>`）收了 **11 个 provider / 346 个模型**，快照日期写在文件头。**没点过同步时**就是非 DeepSeek 模型的兜底价；点过一次「同步第三方价目」后最新数据会盖住同名条目，界面分别标明"内置快照价"还是已同步。查价优先级：**用户覆盖价 > 已同步价目 > 内置快照 > 未定价**。
 - **非 DeepSeek 模型定价（0.10.0）**：按 `(provider, model)` 查价 —— 精确 provider → `PROVIDER_ALIASES` 别名（`deepseek-official`→`deepseek`、`kimi-coding`→`moonshotai`…）→ **按模型 id 全局唯一匹配**（`glm-5` 在两家都有的价时**拒绝猜**）。**认不出价就说"未定价"**（单价全 0，明细页写明"去同步第三方价目或给这行填个价"），**不再把 DeepSeek 的 flash 价静默套到第三方模型头上** —— 编一个看着合理的假数字，比承认不知道更糟。
+- **「OpenCode 请求头」这一栏（0.25.0 起只给旧宿主）**：OpenCode Go 要求客户端按**每段对话**发 `x-opencode-session`。上游 `@earendil-works/pi-ai` 从 **1.0.2** 起自带 `dist/providers/opencode-headers.js`（`opencode` / `opencode-go` 两个 provider 都被包过），用`options.sessionId` 发**真实会话 id**，且「已有同名头就不覆盖」。本插件注入的是**固定 UUID**，开着反而会顶掉真实 id ⇒ 0.25.0 起宿主半**先探测**（判据是宿主 pi-ai 里有没有那个模块；桌面 asar与 pnpm 检出两种布局都覆盖），探到原生支持就**不注入、不生成 UUID、不记账**，状态行写「宿主已原生支持…本栏不再注入」；探不到按旧宿主处理（继续注入），也可用`DSH_COMPOSER_UX_HEADER_NATIVE=1|0` 强制。`test/host-header-mirror.mjs` 第 19 / 20 节把两条分支与探测判据逐条钉住。
 - **为什么金额必须自己算**：DSH 送到浏览器的 `tokenUsage` 投影**只有 token 桶**，全库没有一处把"钱"送到客户端；`llm-pi-ai` 里那个 `cost` 只活在 provider 内部，而且用户自定义的路由（profile 里手写的 provider）拿到的是 `NO_COST`（全 0）。所以费用只能由本插件按刊例价算。
 - **数据全部来自官方、不新增采集**：token 桶读 `tokenUsage` 投影（与官方统计行**同一份**），模型读 `modelSelection` 投影（来自 `request/header` 事件）。会话中途换过模型时按**最后一次请求**的模型计价（近似，浮层里写明）。
 - **按 route 分列与"逐笔准时"的取数**（点开才去问宿主半；折叠态那颗胶囊也走同一条路由）：面板里列出每条 route（provider + model + 高峰/空闲）的 token 与花费，**金额由宿主半按档算好**（用户覆盖价一并读自设置），所以"各行加起来等于总额""三项相加等于合计"都精确成立。逐请求归因只能宿主半做，走只读路由 `GET /composer-ux/usage?sessionId=…`（`src/host.ts` 注册）：首次（或发现 `seq` 落后）用官方 `sessionQuery.readSession(sessionId)` 完整读一次，之后靠 `session/event` 订阅**增量**喂折叠缓存（`createUsageCache`，纯逻辑在 [src/usage-fold.ts](src/usage-fold.ts)）—— 所以胶囊取价是 O(1)，不必反复重读整份日志。**播种窗口**（读日志期间追加的事件）会先缓冲、读完按 `seq` 补上：不这么做的话水位会跳过快照里那些中间事件，金额**永久少算**（`feed()` 的 seq 幂等，补也补不进去）。**事件形状按本版官方 `SessionEventMap` 的真实声明**（`assistant/attempt` 的 `stream` 里取最后一条 usage 块，或 `assistant/message` 的 `data.usage`；**本版没有 `assistant/chunk` 事件**），口径对齐官方 `token-meter` 的 `usage-projection`（同一步替换、`llm/retry-started` 重开替换槽）。`test/usage-fold.mjs`（89 项）逐条钉住差分、归属、重试、脏数据、逐笔分档与增量缓存；分列出不来时面板会显示"读了 N 条事件、M 条 usage、来源哪条路"，一眼就能定位。
@@ -721,9 +722,9 @@ node build.mjs                    # 产出 lib/index.js + lib/client.js
                                   #   ⚠️ 宿主半会**内联** schemastery / cosmokit：
                                   #   优先用 DSH 检出里的 vendor 副本，检出不在时退到 node_modules
                                   #   里同版本的 npm 包（两者逐字节相同）——CI 上走的就是退路
-npm test                          # 33 个套件；当前 2780 passed, 0 failed（2026-10-17 实测；CI 三平台同样全绿）
+npm test                          # 33 个套件；当前 2800 passed, 0 failed（2026-10-18 实测；CI 三平台同样全绿）
                                   #   走 scripts/run-tests.mjs：顺带把"多少套件/多少条"记进 test/.last-run.json
-npm run test:mutations            # 手动跑：变异测试，证明那套护栏真的在咬人（217 条，须单独跑）
+npm run test:mutations            # 手动跑：变异测试，证明那套护栏真的在咬人（220 条，须单独跑）
                                   #   同样记录结果，供下面的文档门禁核对
 npm run gates                     # 发版门禁三条一起跑：tag 指向 / 包内容 / 文档数字
 npm run check:tag                 #   ① tag 名里的版本 == 该 tag 所指提交里的 package.json 版本

package/dsh-plugin.json

@@ -3,7 +3,7 @@
   "manifestVersion": "0.15",
   "id": "dsh-composer-ux.input-experience",
   "name": "dsh-composer-ux",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "license": "MIT",
   "facets": {
     "host": {

package/lib/client.js

@@ -1281,6 +1281,7 @@ var HEADER_ROUTES_FIELD = "headerRoutes";
 var HEADER_APPLIED_NAME_FIELD = "headerAppliedName";
 var HEADER_APPLIED_VALUE_FIELD = "headerAppliedValue";
 var HEADER_STATUS_FIELD = "headerStatus";
+var NATIVE_STATUS_PREFIX = "\u5BBF\u4E3B\u5DF2\u539F\u751F\u652F\u6301";
 var DEFAULT_HEADER_NAME = "x-opencode-session";
 var HEADER_VALUE_MAX = 200;
 var HEADER_NAME_MAX = 64;
@@ -6350,10 +6351,11 @@ function SettingsSection({ useLive, useBook, useBookStatus, useWriteNotice, acti
   const menuSummary = settings.menuMode === "official" ? "\u5F53\u524D\uFF1A\u5B98\u65B9\u4E0D\u4ECB\u5165" : settings.menuMode === "browser" ? "\u5F53\u524D\uFF1A\u6D4F\u89C8\u5668\u83DC\u5355\uFF08\u7C98\u8D34\u514D\u6388\u6743\uFF09" : `\u5F53\u524D\uFF1A\u81EA\u5B9A\u4E49\u83DC\u5355 \xB7 ${menuEnabled} / ${MENU_ITEMS.length} \u9879\u5F00\u542F`;
   const panelSize = typeof settings.panelWidth === "number" && typeof settings.panelHeight === "number" ? `${settings.panelWidth}\xD7${settings.panelHeight}` : "\u5C3A\u5BF8\u7528\u5B98\u65B9\u9ED8\u8BA4";
   const panelSummary = `\u8FB9\u7F18\u7F29\u653E ${settings.panelResize ? "\u5F00" : "\u5173"} \xB7 ${panelSize}`;
-  const headerSummary = settings.headerEnabled ? settings.headerStatus === "" ? "\u5DF2\u542F\u7528" : settings.headerStatus : "\u672A\u542F\u7528";
+  const headerNative = settings.headerStatus.startsWith(NATIVE_STATUS_PREFIX);
+  const headerSummary = headerNative ? "\u5BBF\u4E3B\u5DF2\u539F\u751F\u652F\u6301\uFF08\u4E0D\u9700\u8981\uFF09" : settings.headerEnabled ? settings.headerStatus === "" ? "\u5DF2\u542F\u7528" : settings.headerStatus : "\u672A\u542F\u7528";
   const quickCounts = bookCounts(book);
   const quickSummary = `${quickCounts.categories} \u4E2A\u5206\u7C7B \xB7 ${quickCounts.prompts} \u6761 \xB7 \u6BCF\u6B21 ${quickCounts.always} \xB7 \u4EC5\u9996\u6B21 ${quickCounts.first} \xB7 \u4F18\u5316\u6863\u4F4D ${OPTIMIZER_TIERS.find((item) => item.id === settings.optimizerTier)?.label ?? "\u9AD8\u7EA7"}`;
-  const headerStatusText = settings.headerEnabled ? settings.headerStatus === "" ? "\u7B49\u5F85\u9996\u6B21\u5199\u5165\u2026" : settings.headerStatus : "\u672A\u542F\u7528\uFF08\u6253\u5F00\u4E0A\u65B9\u5F00\u5173\u5373\u5199\u5165\uFF09";
+  const headerStatusText = headerNative ? settings.headerStatus : settings.headerEnabled ? settings.headerStatus === "" ? "\u7B49\u5F85\u9996\u6B21\u5199\u5165\u2026" : settings.headerStatus : "\u672A\u542F\u7528\uFF08\u6253\u5F00\u4E0A\u65B9\u5F00\u5173\u5373\u5199\u5165\uFF09";
   const terminalSummary = sections.terminal === false ? settings.terminalMode === "pwsh" ? "\u4FDD\u6301 PowerShell" : "\u6253\u5F00\u540E\u63A5\u7BA1\u7EC8\u7AEF" : settings.terminalEffective === "unsupported" ? "\u975E Windows\uFF1A\u4E0D\u9700\u8981" : settings.terminalMode === "pwsh" ? "\u5F53\u524D\uFF1A\u4FDD\u6301 PowerShell" : settings.terminalEffective === "bash" ? "\u5F53\u524D\uFF1AGit Bash" : "\u5F53\u524D\uFF1APowerShell\uFF08\u672A\u63A5\u7BA1\uFF09";
   const statsSummary = `${HIT_DIGITS} \u4F4D\u5C0F\u6570`;
   const costSummary = (() => {
@@ -6781,8 +6783,13 @@ function SettingsSection({ useLive, useBook, useBookStatus, useWriteNotice, acti
             }
           },
           children: [
+            headerNative ? /* @__PURE__ */ (0, import_jsx_runtime11.jsxs)("p", { style: hintInfo, children: [
+              "\u672C\u5BBF\u4E3B\u5DF2\u539F\u751F\u652F\u6301\uFF1Api-ai \u4F1A\u6309\u6BCF\u6BB5\u5BF9\u8BDD\u7684\u771F\u5B9E session id \u53D1\u9001 ",
+              DEFAULT_HEADER_NAME,
+              "\uFF08\u5B83\u540C\u65F6\u4E5F\u662F OpenCode \u7528\u6765\u4F18\u5316\u8DEF\u7531\u4E0E\u63D0\u793A\u8BCD\u7F13\u5B58\u7684\u90A3\u4E00\u7EF4\uFF09\u3002\u6240\u4EE5\u8FD9\u4E00\u680F\u73B0\u5728\u4EC0\u4E48\u90FD\u4E0D\u505A\u2014\u2014 \u6253\u5F00\u5F00\u5173\u4E5F\u4E0D\u4F1A\u6CE8\u5165\uFF08\u6CE8\u5165\u7684\u662F\u56FA\u5B9A\u503C\uFF0C\u53CD\u800C\u4F1A\u9876\u6389\u771F\u5B9E id\uFF09\u3002\u53EA\u6709\u65E7\u5BBF\u4E3B\uFF08pi-ai 1.0.2 \u4E4B\u524D\u3001 \u6CA1\u6709 opencode-headers \u6A21\u5757\uFF09\u624D\u9700\u8981\u6253\u5F00\u5B83\u3002"
+            ] }) : null,
             /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { style: hintError, children: "\u26A0\uFE0F \u8BF7\u4F7F\u7528\u81EA\u5B9A\u4E49\u7684 OpenCode API \u5730\u5740\uFF0C\u4E0D\u8981\u7528 DSH \u81EA\u5E26\u7684 API \u5730\u5740\u914D\u7F6E\uFF1A \u7528\u81EA\u5E26\u7684\u914D\u7F6E\u65E0\u6CD5\u4E0A\u4F20\u56FE\u7247\uFF0C\u4E00\u65E6\u53D1\u9001\u56FE\u7247\u5C31\u4F1A\u62A5\u9519\u3002" }),
-            /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { style: bodyLead, children: "OpenCode \u7684\u63A5\u53E3\u8981\u6C42\u5BA2\u6237\u7AEF\u6BCF\u6B21\u8BF7\u6C42\u90FD\u5E26\u4E0A\u4E00\u4E2A\u7A33\u5B9A\u7684\u4F1A\u8BDD ID \u8BF7\u6C42\u5934\uFF08\u5B98\u65B9 Go \u6587\u6863 \u300C\u53EF\u4EE5\u5728\u54EA\u91CC\u4F7F\u7528\uFF1F\u300D\u7B2C 3 \u6761\uFF1A\u4E3A\u6BCF\u6BB5\u5BF9\u8BDD\u5728 x-opencode-session \u4E2D\u53D1\u9001\u4F1A\u8BDD ID\uFF0C \u4EE5\u4FBF\u5176\u4F18\u5316\u8DEF\u7531\u4E0E\u63D0\u793A\u8BCD\u7F13\u5B58\uFF09\u3002DSH \u7684\u8BBE\u7F6E\u9875\u4E0D\u63D0\u4F9B\u8BF7\u6C42\u5934\u7F16\u8F91\u5668\uFF0C\u6240\u4EE5\u8FD9\u91CC\u76F4\u63A5\u628A\u5B83\u5199\u8FDB llm-pi-ai \u7684 provider \u914D\u7F6E\u2014\u2014\u4E0B\u4E00\u6B21\u6A21\u578B\u8BF7\u6C42\u5C31\u751F\u6548\uFF0C\u4E0D\u7528\u91CD\u542F\uFF0C\u4E5F\u4E0D\u7528\u624B\u5DE5\u6539 settings.yaml\u3002 \u53EA\u5BF9 llm-pi-ai \u91CC\u300C\u5DF2\u5B58\u5728\u300D\u7684 opencode \u7CFB\u8DEF\u7531\u751F\u6548\uFF0C\u4E0D\u4F1A\u51ED\u7A7A\u65B0\u5EFA provider\uFF1B \u603B\u5F00\u5173\u5173\u95ED\u6216\u672C\u680F\u76EE\u505C\u7528\u65F6\uFF0C\u5199\u5165\u7684\u5934\u4F1A\u81EA\u52A8\u64A4\u9500\u3002" }),
+            /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { style: bodyLead, children: "OpenCode \u7684\u63A5\u53E3\u8981\u6C42\u5BA2\u6237\u7AEF\u6BCF\u6B21\u8BF7\u6C42\u90FD\u5E26\u4E0A\u4E00\u4E2A\u7A33\u5B9A\u7684\u4F1A\u8BDD ID \u8BF7\u6C42\u5934\uFF08\u5B98\u65B9 Go \u6587\u6863 \u300C\u53EF\u4EE5\u5728\u54EA\u91CC\u4F7F\u7528\uFF1F\u300D\u7B2C 3 \u6761\uFF1A\u4E3A\u6BCF\u6BB5\u5BF9\u8BDD\u5728 x-opencode-session \u4E2D\u53D1\u9001\u4F1A\u8BDD ID\uFF0C \u4EE5\u4FBF\u5176\u4F18\u5316\u8DEF\u7531\u4E0E\u63D0\u793A\u8BCD\u7F13\u5B58\uFF09\u3002\u65E7\u7248 DSH \u4E0D\u53D1\u8FD9\u4E2A\u5934\uFF0C\u6240\u4EE5\u8FD9\u4E00\u680F\u628A\u5B83\u8865\u8FDB llm-pi-ai \u7684 provider \u914D\u7F6E\u2014\u2014\u4E0B\u4E00\u6B21\u6A21\u578B\u8BF7\u6C42\u5C31\u751F\u6548\uFF0C\u4E0D\u7528\u91CD\u542F\uFF0C\u4E5F\u4E0D\u7528\u624B\u5DE5\u6539 settings.yaml\u3002 \u53EA\u5BF9 llm-pi-ai \u91CC\u300C\u5DF2\u5B58\u5728\u300D\u7684 opencode \u7CFB\u8DEF\u7531\u751F\u6548\uFF0C\u4E0D\u4F1A\u51ED\u7A7A\u65B0\u5EFA provider\uFF1B \u603B\u5F00\u5173\u5173\u95ED\u6216\u672C\u680F\u76EE\u505C\u7528\u65F6\uFF0C\u8865\u7684\u5934\u4F1A\u81EA\u52A8\u64A4\u9500\u3002" }),
             /* @__PURE__ */ (0, import_jsx_runtime11.jsx)(
               TextFieldRow,
               {
@@ -6800,7 +6807,7 @@ function SettingsSection({ useLive, useBook, useBookStatus, useWriteNotice, acti
               TextFieldRow,
               {
                 title: "\u503C",
-                desc: "\u6240\u6709\u5BF9\u8BDD\u5171\u7528\u8FD9\u4E00\u4E2A\u503C\uFF1B\u7559\u7A7A\u65F6\u9996\u6B21\u542F\u7528\u4F1A\u81EA\u52A8\u751F\u6210\u4E00\u4E2A UUID \u5E76\u4FDD\u5B58\u6CBF\u7528",
+                desc: "\u65E7\u5BBF\u4E3B\u4E13\u7528\uFF1A\u6240\u6709\u5BF9\u8BDD\u5171\u7528\u8FD9\u4E00\u4E2A\u503C\uFF1B\u7559\u7A7A\u65F6\u9996\u6B21\u542F\u7528\u4F1A\u81EA\u52A8\u751F\u6210\u4E00\u4E2A UUID\uFF08\u5BBF\u4E3B\u5DF2\u539F\u751F\u652F\u6301\u65F6\u4E0D\u4F1A\u7528\u5230\u5B83\uFF09",
                 value: settings.headerValue,
                 placeholder: "\u7559\u7A7A = \u81EA\u52A8\u751F\u6210",
                 maxLength: HEADER_VALUE_MAX,