# dsh-meter 变更记录（CHANGELOG）

> 本文档由 `PRD.md` §10「迭代记录」拆分而来，记录每个版本的具体变更与决策理由。
> 当前有效规格见 [PRD.md](PRD.md)；新的版本条目请追加在本文档**最上方**（最新在前）。

---

### v0.3.31（子代理状态点对齐官方 `StateDot` 语义：旋转环=运行中、实心绿点=已结束、中性点=历史冷会话）

v0.3.30 的卡片「子代理」小节用自绘状态点（绿=运行中、空心=历史），与官方 `ui-subagent` 的 `StateDot` 语义恰好相反——官方语言里「绿」= 已结束。用户会按官方习惯读错状态，本版把卡片的状态语言换成官方的**同一个组件**。

- **映射（新增 `src/client/subagent-dot.ts`，纯函数）**：`running → ongoing`（旋转环：进行中）、`inactive → done`（实心绿点：轮次已闭合）、`cold → idle`（中性点：冷会话的 live 日志已消失，完成与否**不可知**，绝不冒充 done）。独立成模块只为可测试——`StateDotState` 与 activity 两侧都只做类型导入。
- **每行状态点**：自绘小圆点替换为官方 `StateDot` 组件，套进固定 14px 槽位（对齐官方行的 `rowActivitySlot`：宽旋转环与窄实心点共一条光学轴，行名不错位）；`role="img"` + 原 aria-label 保留。`.subsDot/.subsDotOff/.subsDotCold` 三个类合并为 `.subsActivity`，插件不再自绘任何状态色。
- **头部「运行中 N」**：`●` 字形换成官方 `StateDot` 旋转环，计数文字承载语义（dot 为 aria-hidden），两者不会对「运行中」长得不一致。`.subsRunning` 不再涂成功绿（官方语义里绿=已结束），改 tertiary 文字色 + inline-flex；`.subsHead` 对齐从 baseline 改 center。
- **测试**：`pure-check` 新增三条映射断言（running→ongoing / inactive→done / cold→idle）。
- 文档：v0.3.30 小节内「卡片子代理小节」描述同步为官方语义并挂 [subagent-dot.ts](../../src/client/subagent-dot.ts) 链接。

验证：tsc 两套零错误、pnpm test 全 PASS。

---

### v0.3.30（适配 DSH 0.2.0-rc.1；peer 区间一次放开到整条 0.x，之后 0.x 发版不再改号）

DSH 桌面端升到 0.2.0-rc.1 后，内置的 17 个 `@deepseek-ai/dsh-*` 运行时包同步升到 0.2.0-rc.1，而 0.3.29 的 peer 还是 `^0.1.7-rc.2`（语义上只覆盖 <0.2.0），应用内插件管理器的安装前置校验（`evaluatePluginCompatibility`，逐条 peer 区间比对运行时版本、includePrerelease）直接拒绝加载 dsh-meter。

- **兼容性修复（根因）**：peerDependencies 的 16 个 `@deepseek-ai/dsh-*` 区间由 `^0.1.7-rc.2` 放开为 `>=0.1.7-rc.2 <1.0.0`。用应用内实际打包的 `evaluatePluginCompatibility` 对打包产物 manifest 跑 0.2.0-rc.1 → 兼容；对 0.3.29 的 manifest 能复现原始拒绝信息。`workspace:*` 之外这是 DSH 唯一承认的「面向未来的宽区间」写法（`workspace:^`/`~`/`*` 只在源码工作区安装时可用，独立包用不了）。
- **防抖（本版的主要目的）**：0.x 线内 DSH 每次发版（0.2.0-rc.1、未来的 0.3/0.4…0.9）不再需要跟着改 peer 号；`<1.0.0` 保留 1.0 这一道真实分界线，届时只需重新核对一次 API。仍然停留 0.1.7-rc.1 / 0.1.5-rc.2 的老环境会被区间正确拒绝，继续用 0.3.23 / 0.3.21。
- **dev 依赖统一升到 0.2.0-rc.1**（17 个，含 session-projection-cache），pnpm-workspace 的 `minimumReleaseAgeExclude` 全量追加 `0.2.0-rc.1`。
- **0.1.7-rc.2 → 0.2.0-rc.1 API 影响面已逐文件核对（type 层面零破坏）**：两版从 npm 各装一份，对插件用到的 16 个包做 .d.ts 全量 diff——dsh-session 仅新增 `ToolCallRecovery` 导出、dsh-api-remotes 新增一个 type re-export、dsh-client-ui-primitives 新增 `pointerModality`、dsh-client-ui-conversation 只动 composer/draft/input 内部（`conversation.session.header.actions`、`settings.plugin.item` 两个槽位契约逐字未变），其余包逐文件相同；`SESSION_FORMAT_VERSION` 仍是 4。`tsc` 两套零错误 + `pnpm build` + `pnpm smoke` A1–A8/B 全 PASS + `pnpm test` 全 PASS，与 0.3.29 相比代码零改动。
- **文档**：README 版本要求改写为「0.x 整线覆盖 + 1.0 需重核」；迁移小节里过时的「`0.1.0-rc.7`」更正为 `0.2.0-rc.1`。

---

### v0.3.29（法定节假日日历：节假日不再按高峰计价）

上一版把"节假日未建模"写成了已知缺口。本版按讨论的方案 A 补上：**命名日历 + provider 显式 opt-in**。

- **内置 `cn` 日历**（2025–2026），来源是国务院办公厅两份通知（[2025：国办发明电〔2024〕12号](https://www.gov.cn/zhengce/content/202411/content_6986382.htm)、[2026：国办发明电〔2025〕7号](https://www.gov.cn/zhengce/content/202511/content_7047090.htm)）。DeepSeek 的两条路由默认挂 `calendar: cn`；**其它 provider 一律不预设** —— 网关的高峰窗口由其运营方决定，替它认定节假日是猜测。
- **只建模「放假日」，绝不建模「调休上班日」**：官方规则是「周一至周五（不含法定节假日）」，而 2026 年六个调休日**全部落在周末**，按规则本来就是空闲。用「工作日库」（chinese-days 之类）会把它们算成高峰，与官方规则相反 —— 这也是不引库、只用一份 ~60 行日期表的理由（其中只有 ~19 天/年是工作日）。
- **语义**：命中日历 = 该 **provider 时区下的本地日** 整天所有 `periods` 窗口不生效，按基准价（空闲）计；`EffectivePrice` 增 `holiday` 标志，只用于让 CLI/UI **显示原因**，价格口径不变（投影状态形状未变，无需升 stateVersion）。
- **性能**：判定复用已有的 `wallClock`（时区格式化器 + 分钟级缓存），本地日期在同一次 `formatToParts` 里取；日历编译成 `Set` 并用 WeakMap 按 `calendars` 对象缓存，所以折叠里每次请求只是「一次格式化 + 一次 Set 查找」，没有新增 Intl 开销。
- **格式**：顶层 `calendars:`（名字 → 日期列表），`providers.<id>.calendar: <名字>`。日期支持单日与闭区间，**加不加引号都接受**（YAML 会把未加引号的 `2026-10-01` 解析成日期对象 —— 这是写文件最容易踩的坑，格式显式接受并还原成写下的那天）。日期按 provider 时区判定，不是 UTC 切片。
- **合并语义**：`calendars` 同名取**并集**（"追加新年份"天然安全，不会覆盖内置年份）；`providers.<id>` 改为**按字段合并** —— 否则文件里只改一个币种就会把内置的 `calendar` 冲掉、节假日静默失效。
- **可见性**（这个功能最大的风险是"日历过期后静默按高峰计价"）：设置卡片与会话 catalog 报告日历名、日期数、覆盖区间/年份，并在**当前年份未覆盖**、**provider 引用了未声明的日历**、**有日期无法解析**时显示红字；host 启动日志同样逐条给出。CLI 增加 `--calendar` 报告与 `闲节` 标注（`--at <放假日>` 可直接验证），覆盖判断跟随 `--at` 的年份（所以"2027 覆盖了吗"是一条命令）。
- **测试**：`HOLIDAY CALENDAR CHECK`（国庆/春节整段、**调休上班的周六必须仍是空闲且不得标成节假日**、北京午夜前后各半小时的本地日期判定含同一时刻的 UTC 写法、2025 通知生效、2027 未覆盖按高峰、未 opt-in 的 provider 不受影响、区间展开/跨年/YAML Date/非法日期/倒序区间、覆盖统计不把区间串当日期）；文件格式新增 13 组（未加引号/引号两种写法、悬空 calendar 引用必须拒收、非法与倒序日期必须拒收、未被引用的日历允许、并集与字段级合并）；冒烟新增 A6/A7（文件日历经**已构建宿主**让国庆按空闲计价并被 catalog 报告；内置日历只作用于 DeepSeek 路由，自带高峰窗口的网关在节假日仍按高峰）。
- 文档：[docs/CONFIGURING.md](CONFIGURING.md) 新增「节假日日历」一节（写法、语义、调休陷阱、更新配方与自检步骤），并修正原先"节假日未建模"的反模式条目。

---

### v0.3.28（价格表配置文件 + 自检 CLI + 冒烟测试）

目标：别的用户给 Agent 一张截图、一个链接，就能直接把价格写进配置，不必在设置页一格格点；并把"冒烟 + 测试用例"补齐。

- **新增 Agent 可写的价格文件**：默认 `$DSH_HOME/dsh-meter/prices.yaml`（入口配置 `priceFile` 可改；支持绝对路径、`~/`、相对 DSH home）。格式 YAML/JSON，**正文就是价格表本身**；单位是**元/百万 tokens**（与价目页、设置页同一个数字），内部 1e-5 整数单位刻意不暴露——任何价格 > 100000/M 判为"抄了内部单位"，**整个文件拒收**。
- **三层优先级：显式配置（profile patch / 设置页保存）> 价格文件 > 内置默认**，按行（provider+model+effort）生效。"显式"取自 `settings.describe()` 的 `base`/`user` 两个原始层——resolved 配置分不出用户的航和内置默认行。于是：Agent 写的文件能覆盖内置默认，却不会被一次 GUI 保存悄悄吃掉；显式的行也不会被文件悄悄改价。设置卡片会显示「价格表来自配置文件 … · N 行生效 · M 行被显式配置覆盖」，不再有隐形来源。
- **坏文件不拖垮插件**：加载永不抛异常；任何错误 → 整文件忽略、回退内置/显式表、写日志（`billing: price file ignored — …`）、设置卡片显示红字。拒收条件：单位超限、重复行、非法 IANA 时区、空表、字段缺失/越界、YAML 语法错、顶层出现 `id`/`name`/`config`（贴了 patch 条目）。
- **改文件不用重启**：刷新路由重读文件；**并且**价格真变了时重挂投影，让 `stateVersion` 带上新表 revision——手工编辑文件不会触发 `settings/document-updated`，不重挂就可能让按旧价折出的 checkpoint 复活，这正是 revision 要防的事。
- **自检 CLI** `scripts/check-prices.mjs`（bin：`dsh-meter-prices`）：用**插件同一个加载器**校验，并打印每行在周一 10:00 / 13:00 / 15:00 / 周六 10:00（北京时间）的有效价，便于把抄来的数字逐格对回页面；支持 `--json` / `--at`，退出码 0 通过 / 1 文件有问题 / 2 跑不起来。
- **配置说明** [docs/CONFIGURING.md](CONFIGURING.md)：格式规范（字段、单位、上限保护、`tiers` 下标对齐）、三个配方（给链接 / 给截图 / 只给模型名，含查路由 id 的 catalog 命令）、强制自检、回报模板、反模式（不发明价格、不平均、不改 patch、**节假日未建模**要如实说明）、排错表、计价口径。附可运行示例 [docs/examples/prices.deepseek.yaml](examples/prices.deepseek.yaml)。
- **测试**（`pnpm verify` = typecheck + build + smoke + test）：
  - [tests/price-file-check.ts](../tests/price-file-check.ts)（11 组）：官方价换算与精度、JSON 输入、**原始单位整行拒收**（含只有大字段超限时才暴露的行）、patch 条目误贴、缺字段/越界/语法错/空表、重复行与未声明 provider、时区拼错、路径解析（默认/DSH_HOME/`~`/相对）、合并语义、ENOENT 非错误。
  - [tests/smoke.ts](../tests/smoke.ts)（跑**已构建产物**）：宿主 bundle 加载 → 注册 `/billing/api` 与 `billing` 投影 → **真跑一次 1M token 请求**验证三层计价、坏文件降级、文件编辑后由运行中的投影计新价且投影被重挂；客户端 bundle 走 `window.__ModuleLoader__` 交接、声明 `inject`、注册两个槽位。
  - 顺带修掉测试自身一个**恒真断言**（`typeof x, 'function' || …` 逗号写错，被 `tsc` 抓到）——正好说明为什么不能只靠"看起来通过"。

---

### v0.3.27（设置页 provider 头部重排：时区改可搜索下拉，字段一行对齐）

反馈是"错落的排版确实不太好看 / 放有用有必要的"。本版按这个口径重排 provider 头部，同时把时区做成你要的**可输入关键词筛选的下拉**。

- **时区：自由文本框 → 关键词可筛选下拉**。选项取自引擎自己的 `Intl.supportedValuesOf('timeZone')`（本机 418 个）——不手维护时区表，就不会随 tzdata 悄悄漂移。过滤匹配 IANA 名**或城市名**、段首命中优先：输入 `shanghai` 直接命中 `Asia/Shanghai`，输入 `asia/` 列出该区域。键盘 ↑/↓/Enter/Esc 可用；自由文本仍能失焦或回车提交，非法名照旧报错——下拉是便利，不是校验闸门。引擎没有 `supportedValuesOf` 时退化为纯文本框，校验不变。
- **筛选是纯函数**（[timezones.ts](src/client/timezones.ts) 的 `matchTimezones()`），新增 `TIMEZONE COMBOBOX CHECK`：城市关键词、大小写、首尾空格、区域前缀、无匹配、limit、段首优先，以及引擎列表本身（含默认时区、每个都能被 `Intl` 接受、每个都带城市标签）。选择器的筛选悄悄失效比纯文本框更糟——用户根本不知道为什么不出现选项。
- **头部重排**：原来是右对齐的一摞——label 在输入框上方的时区列 + 内联 label 的币种 + 一行裸提示 + 一条孤零零的按钮行，三种垂直节奏互不对齐。现在 = **标题行**（名称/展开箭头在左，provider 级动作「按官方规则配置」在右）+ **一行字段**（时区 · 币种 · 单位，同一基线、左对齐，窄了才换行）。单位不再是裸提示，而是与币种并列的带标签字段；按钮从字段流里移出，不再制造第四种节奏。
- 组合框浮层：绝对定位、`--billing-shadow` 阴影、hover/键盘高亮，`role="listbox"`/`role="option"` + `aria-expanded`/`aria-controls`/`aria-selected`/`aria-autocomplete`，选中用 `mousedown`（否则输入框 blur 先关列表）。设置面板内容区是 `overflow-y: auto`，列表在面板底缘会被裁并随滚动露出——普通内联组合框的固有行为，已在代码注释写明。

验证：`tsc` 两套零错误、`pnpm build` 通过、`pnpm test` 28 组全 PASS；用本机 Chrome 无头 + DSH 自己的 `design-platform.css` 令牌按真实尺寸渲染布局截图（改前/改后各一张），并核对了面板实际宽度（800px，卡片内容区约 700px）下字段确实一行放得下。

---

### v0.3.26（内置默认价格表补齐 DeepSeek 官方两条路由；修复设置页「应用」按钮）

**价格：按官方价目表（api-docs.deepseek.com/zh-cn/quick_start/pricing，2026-09）**

- 新增 `deepseek-official`（API key 路由）与 `deepseek-account`（登录账号路由）两组默认价——同一上游服务、同一价目表，因此同价：
  - `deepseek-flash`（V4.1-Flash，1M 上下文 / 最大 384K 输出）：空闲 **1/4/0.02**、高峰 **2/8/0.04**（元/百万 tokens）
  - `deepseek-v4-pro`（V4-Pro-0813）：空闲 **4.5/13.5/0.15**、高峰 **9/27/0.30**
  - 高峰 = 北京时间工作日 09:00–12:00 与 14:00–18:00；空闲价为高峰价的一半；缓存写入不单独计费（0）
- 两个**已下线但仍在服务**的旧模型名 `deepseek-v4-flash`、`deepseek-v4-flash-vision-exp` 按官方说明（仍可调用、由 V4.1-Flash 提供服务并按 Flash 价计费）建行——否则记录这些 id 的会话会显示「未登记价格」。
- **未建模法定节假日**：官方高峰定义是「周一至周五（**不含中国法定节假日**）」，插件没有节假日日历，节假日会按高峰计价。这是已知缺口，已写进模块注释而非悄悄放过。
- 官方窗口常量收敛为 `shared.ts` 的 `DEEPSEEK_PEAK_WINDOWS`，内置价格表与设置页的官方规则预设共用一份，两处对"官方"的定义不会再漂移。

**修复设置页的「应用」按钮（三处，都与它读起来的样子不符）**

- **只有第一个 provider 有按钮**：官方规则预设原来按 `provider.id === 'deepseek-official'` 精确判断，于是同族的 `deepseek-account` 没有它。两个 DeepSeek 路由并排、只有一个带按钮，看起来就是 UI 坏了。改为按 DeepSeek 路由族（`DEEPSEEK_PROVIDER_IDS`）。
- **它根本不是时区的按钮**：按钮原来贴在时区输入框右边，标签只有一个「应用」，于是被读成"时区要按应用才生效、而且只有第一个 provider 有"——时区本来是失焦即提交。现在移到独立一行，标签改用早已存在却从未被使用的「按官方规则配置」，说明文案写清它保留已有窗口、只在没有时才补。
- **会毁配置的 bug**：预设原来只保留**第一个**工作日窗口、把其余工作日窗口全部丢弃。DeepSeek 官方规则是两段（09–12、14–18），所以在配置正确的行上点一下「应用」会**静默删掉下午高峰**、把高峰覆盖砍半——这是价格变更，不是整理配置。改为保留**全部**工作日窗口（只补全星期掩码），一个工作日窗口都没有时才按官方两段补种（价格取该模型的空闲价，绝不擅自改价）。
- 纯逻辑抽到 [preset.ts](src/client/preset.ts) 的 `officialPeakPeriods()`，新增 `OFFICIAL-RULE PRESET CHECK`（6 组）锁定行为，含"两段官方窗口必须都留下"的回归与"输入不被修改"。

**本机 profile 同步（仓库外，不进版本库）**：desktop / web 两个 `cordis.patch.yml` 的 billing 配置里，`deepseek-official` 原来的 `deepseek-v4-flash` 行是 1.5/4.5/0.05（与现行官方价不符，model id 也是旧名），已换成官方四行；并补上 `deepseek-account` provider 与其四行。改前已备份，改后逐字段校验：其余 entry 与 30 行非 DeepSeek 价格**完全未变**。

---

### v0.3.25（修复「设置」按钮点错控件；齿轮真正自动跳到 设置→内置插件→计费价格）

0.1.7-rc.2 给设置面板的 `sidebar.settings` 槽位加了 **store seat**（rc.1 没有），seat 的 `openSection(id)` 能开面板并直接选中分区——这正是"自动跳转"一直缺的那块拼图。顺手把齿轮点错控件的老 bug 一起修了。

- **修复（真 bug，非 rc.2 回归）**：旧实现取 `[data-slot="sidebar.settings"]` 里的**第一个 `<button>`**。但标准组合下 `settings.launcher` 槽位被 `client-ui-settings-account` 的账户菜单占了，shell 自己那个 `aria-haspopup="dialog"` 的设置按钮**根本没渲染**，于是第一个 button 是左下角**账户菜单触发器**（`aria-haspopup="menu"`）。点「设置」打开的是账户菜单，不是设置面板。rc.1 同样如此——"还是不行"从那时就存在。
- **新增：自动跳转链路**。齿轮现在按 `seat → 面板 → 分区 → tab` 走完：
  - **打开面板并选中分区**：经公开快照 `slots.entries('sidebar.settings')` 读 shell 的 store seat，调 `openSection('plugins')`。这是 harness 支持的唯一选段途径（没有设置导航服务；面板的 open/activeId 是 shell 自己的 store 状态）。形状不符的 seat（工厂式、或不是设置 shell 的）会被跳过。
  - **按中计费 tab**：`settings.plugins.tab` 是分区的**标签页**，而分区只在某个 tab 被选中后才挂载它的面板，所以必须再按一下。tab 按钮 id 是 shell 稳定的 `<tabsId>-tab-<contribution id>` 形状，用后缀 `-tab-billing` 命中（单贡献时无 tablist，等不到就静默放弃）。
  - **定位模型**：之后交给卡片原有的 locate 逻辑——展开该 provider 分组并把当前模型行滚进视野（队列 + 窗口事件双通道，未变）。
- **兜底顺序**（seat 不存在/不可用时）：槽位内的 shell 触发按钮 → 被占用时按账户菜单触发器再按它的第一行（该启动器把「设置」排在第一）→ 帧级 `aria-haspopup="dialog"` 扫查（排除会话列，避免重演当年点到「本轮用量」药丸）。后三条只能开面板、不能选分区，注释里写明了。
- **新增回归测试** `tests/settings-nav-check.ts`（jsdom，5 组）：seat 路径开分区 + 按 tab、槽位内触发按钮优先、被占用的启动器按菜单行、无目标时不抛且保留 locate、形状不符的 seat 绝不被驱动。`test` 拆成 `test:pure` / `test:nav`；jsdom 29 无类型声明，`tests/jsdom.d.ts` 只声明用到的那一小块（不引入 `@types/jsdom`，免得 `prepare` 把成本转嫁给用户）。
- **tsdown 的 `PLATFORM` 对齐 shell 的 `PLATFORM_MODULES`**（`packages/client/web/src/platform.ts`）：补 `dsh-client-store` / `dsh-client-ui-dockkit`，去掉三个并非平台模块的项。原来若有人从 `dsh-client-store` 取值就会被**打进 bundle**，等于在第一个 store 引擎背后再造一个——正是 store 文档警告的"伪装单例"。
- **两项排查结论（都不是问题）**：`@deepseek-ai/dsh-client-ui-primitives` 是 shell 的**平台 seed 词**（`platform.ts` 的 `PLATFORM_MODULES` + `seed.ts` 静态导入），`require` 直接命中冻结模块表，**不需要**进 `dsh.client.inject`；`~/.dsh/profiles/node_modules` 是 `npx @deepseek-ai/dsh`（pnpm dlx）09-22 留下的**软链残渣**（指向 `~/Library/Caches/pnpm/dlx/…/@deepseek-ai/dsh@0.1.5-rc.2`，仅 16K），不在 desktop / web 任一 profile 的解析路径里。

---

### v0.3.24（适配 deepseek-harness 0.1.7-rc.2 + 内置默认价格表新增 wpsai 模型）

0.1.7-rc.2 是 rc.1 的补丁级跟进：客户端包几乎只有版本号变化，**没有移除任何本插件用到的导出**，所以本版没有 API 迁移，只做三件事——把 peer 版本区间放开、修掉一处会随 session 格式版本漂移的测试夹具、补默认价格表。

- **兼容性修复（插件装不上的根因）**：`peerDependencies` 里 `@deepseek-ai/dsh-client-ui-session` 被**精确钉死在 `0.1.7-rc.1`**，而 DSH 的安装前置校验（`evaluatePluginCompatibility`，逐条 peer 区间比对运行时 dsh 版本、`includePrerelease: true`）在 0.1.7-rc.2 上直接拒绝安装：`dsh: installation rejected: ... peerDependencies {"@deepseek-ai/dsh-client-ui-session":"0.1.7-rc.1"}`。改为与其余 16 个 peer 一致的 `^0.1.7-rc.2`（caret 区间在 `includePrerelease` 下同时接受 rc.2 与后续 0.1.7/0.1.x）；peer/dev 依赖与 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` 统一升到 0.1.7-rc.2。
- **测试夹具跟随 session 格式版本**：`tests/pure-check.ts` 的 `SessionHeader` 假头硬编码 `version: 3`，而 `SESSION_FORMAT_VERSION` 已是 4（rc.1 的 npm 包同样为 4，属既有隐患，`tsc -p tsconfig.tests.json` 一直报 TS2322）。改为 `const SESSION_VERSION: SessionHeader['version'] = 4`，以后上游再升版本这里会**编译报错**，而不是悄悄 mock 一个运行时会拒绝的 header。
- **rc.1 → rc.2 实际影响面（已逐条核对，均不影响本插件）**：`dsh-client-ui-session / ui-slots / ui-settings-plugins / client-connection / compaction / host-webserver / session-persistence / session-projection / session-projection-cache / settings` 只有版本号变化；`ui-primitives` 删掉无人引用的 `OnboardingSurface`、`Button` 改 `forwardRef`、`Tooltip`/`Menu`/`Modal` 增可选 props；`ui-conversation` 的 `ComposerBarInjected.hooks.stopShortcut`、`ConversationBinding.openTurn` 与 `ui-settings` 的 `SettingsLauncherOwnerProps.settingsOpen` 是**必填新增**，但本插件都不构造这些对象。插件真正依赖的 `conversation.session.header.actions` / `settings.plugins.tab` 两个槽位契约在 rc.2 未变；`request/header` 的 `startsSeries` 语义变化与新增 `developer/message` 事件也不动计费 fold（它只读 `header.config`，未知事件原样透传）。
- **新增 3 个 wpsai 官方参考价**：`xiaomi/mimo-v2.6-pro`（3/6/0.025）、`xiaomi/mimo-v2.6-flash`（1/2/0.02）、`zhipu/glm-5.3-flashx`（2/7/0.57），均为 1M 上下文、缓存写入「限时免费」（0）的平档价，与既有 wpsai 条目同构。未配置价格前这些模型显示「未登记价格」并按 0 计价，仅补默认表，不改任何口径/行为。
- **验证**：`tsc --noEmit`（`tsconfig.json` + `tsconfig.tests.json` 两套）零错误、`pnpm build` 通过、`pnpm test` 全 PASS；用 DSH 0.1.7-rc.2 应用里**实际打包的** `evaluatePluginCompatibility` 跑本包 manifest → `undefined`（兼容），对 HEAD 的 0.3.23 manifest 复现出原始拒绝信息。

---

### v0.3.23（适配 deepseek-harness 0.1.7-rc.1：settings 重构迁移 + 浮层半透明修复）

0.1.7-rc.1 把 settings 体系整体重构：**「命名空间注册」（`settings.register(ns, schema)` + `scope.watch`）→「按插件入口的 volatile Config」**（schema 挂在插件上、客户端走 `configForms`、变更走 `settings/document-updated` 事件）。旧写法一上来就撞 `ctx.settings.register is not a function`，本版完成迁移（15 个文件）并顺带修复迁移暴露的浮层样式回归。

- **宿主侧（host/index.ts）**：整张价格表变成一个 volatile ref——`Config = priceTableSchema.volatile()`（schema 默认值 = 内置 `DEFAULT_TABLE`），`apply(ctx, config)` 直接 `config.get()` 读当前表；`scope.watch` → `ctx.on('settings/document-updated')` 重挂投影（volatile 提交原地生效，fiber 不重启）；`settings.configure({auto:false})` 关掉自动生成的通用表单（保留自定义编辑页）。
- **客户端侧**：`settingsScope.bind({namespace})` → `configForms.get(BILLING_ENTRY_ID)`（`set('providers'/'models')` API 同构，调用点零改动）；设置页挂载点 `settings.plugin.item` → `settings.plugins.tab`（0.1.7 新槽位，带 order/label）；图标 `IconXxxOutline16/14` → `IconXxxOutlineMedium`；已死的 `dsh-client-runtime` → `dsh-client-ui-session`（`dsh.client.inject` 与 peer/dev 依赖同步）。
- **共享常量**：`PRICING_NAMESPACE='billing-pricing'` → `BILLING_ENTRY_ID='billing'`（host watcher / client 绑定单一事实源）。旧 `settings.yaml` 的 30 个模型 × 4 provider 价格覆盖已迁入 profile 侧 `cordis.patch.yml` 的 billing 配置（仓库外，不进版本库）。
- **依赖**：17 个 `@deepseek-ai/dsh-*` 0.1.5-rc.2 → 0.1.7-rc.1；cordis 4.0.2 → 4.0.4；schemastery 3.18.2 → 3.18.4；`pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` 追加 0.1.7-rc.1。
- **浮层半透明修复（迁移回归）**：0.1.7-rc.1 把 `--dsw-specific-menu` 从实色改成半透明（`#f8f9fa94`），官方规则是凡画该 token 的表面必须同时加 `backdrop-filter: var(--dsw-menu-backdrop-filter)`。卡片/逐轮面板/Tooltip 补上（新增 `--billing-menu-blur` 别名）；逐轮面板叠在深色蒙层上改用**不透明** `--billing-surface-panel`（layer-2，官方 Modal 对话框同款）。
- **头部入口对齐官方头标**：实测「标准模式」标签 12px/22px 行高/22px 高/6px 圆角/14px 图标，触发按钮从 28px 药丸改为同规格（新增 `--billing-header-label-size/height` token）；悬浮卡片头部三个 icon 统一 `size={14}`（此前 12/12/16 混排）。
- **修复：卡片齿轮打开设置后卡片仍悬浮**：`BillingPopover` 经 `closeRef` 把 `close()` 暴露给卡片，设置按钮先关卡片再开设置面板。
- **验证**：`pnpm build` + tsc 零错误、`pnpm test` 全 PASS；浏览器实测卡片/逐轮面板/设置页/头部入口渲染正常。

---

### v0.3.22（界面：悬浮卡片/微标/逐轮面板对齐官方统计面板样式）

官方 chat 的「本轮用量」弹层（`@deepseek-ai/dsh-client-ui-chat` 的 `TurnUsagePanel` + `stat-dialog.module.css`，rc.2 版）把弹层样式整体翻新了：字号、颜色梯、单位、显示方式都换了。本版把插件的三个客户端表面按同一套规格重做，**只动样式与文案，不动任何口径/数据**。

- **设计规格来源**：直接从运行中的 GUI（`dsh web` 的 rc.2 前端）里取出官方的 `stat-dialog.module.css` / `TurnUsagePanel.module.css` 原文（未压缩 CSS 在插件 bundle 里可读），逐条落进 `theme.module.css` 的 `--billing-*` 令牌层——组件 CSS 仍然**不直接引用 `--dsw-*`**。
- **token 单位与精度**：明细行改为官方口径——**精确计数 + 千位分隔 + ` tok` 单位**（`110,663 tok`），新增 `formatExactTokens` / `formatExactTok` / `formatCompactTok`。缓存命中改为官方 `formatCacheHitPercent` 语义：一位小数（`73.1%`），且**部分命中绝不四舍五入成 100%**（会逐位加精度直到诚实为止，如 `99.98%`）。
- **文案对齐官方**：`输入（缓存命中）/输入（缓存未命中）` → **`缓存读取` / `未缓存输入`**（+ `缓存写入` / `输出`），并新增 `提供方 / 模型` 行；逐轮面板的四段桶图例与明细表列头同步（`未缓存` / `读取` / `写入` / `输出`），同一面板不再有两套词汇。
- **统计卡片**：由「标题+副标题 + 两个 20px hero 数字 + 独立 token 小卡」改为官方版式——标题行（图标 + `本会话计费`，右侧为总费用，等宽数字）+ 0.5px 标题细线 + **单个 `dt/dd` 网格**（`grid-template-columns: minmax(76px,auto) minmax(0,1fr)`、`gap 6px 16px`；标签 tertiary、数值 secondary 右对齐、`tabular-nums`；长 model 路由 `overflow-wrap:anywhere`）。费用拆分、每轮图、子代理、上下文条改为同一细线分隔的小节，字号收敛到 12/18 与 11/16 两级。面板本体：`border:0` + **官方 prominent 阴影**（`0 0 0 .5px border-l1` 描边 + 两层柔光）、12px 圆角、16px 内边距、`--dsw-specific-menu` 底色、12px/18px 正文。刷新/详情/设置改为 22px ghost 图标按钮，hover/focus 卡片时才显形（`@media (hover:none)` 常显）。
- **头部微标**：改为官方药丸——`28px + --dsh-content-font-delta` 高、全圆角、`6px 8px` 内边距、`gap 4px`、`--dsh-content-font-size-secondary`（13px）tertiary 文字 + 图标（`IconDataOutline16`），hover 与 `aria-expanded=true` 共用 `interactive-bg-hover` 底色 + secondary 文字；去掉了原来的 chevron（官方药丸没有），高峰/空闲/未登记价格标签改为同行全圆角小 chip。字号跟随用户在设置里的字号档位（`--dsh-content-font-delta`）。
- **逐轮消耗面板**：对齐同一浮层规格（12px 圆角、prominent 阴影、细线标题线、13px/500 标题），把原来那枚**以整句 `refresh.title` 当按钮文字**的刷新按钮改成 22px ghost 图标按钮 + Tooltip（其 `aria-label` 顺带修正为新增的 `turn.reload`「重新加载逐轮明细」——该按钮只重拉明细，不重算价格，旧文案是错的）；图例/注释/分组计数由 10px 提到 11px。
- **上下文占用条**：轨道 4px → **6px 全圆角**，填充色由近黑 `label-secondary` 改为品牌蓝 `state-business-primary`（`--billing-progress-fill`）——DSH 的 `brand-primary` 实为近黑「墨色」（primary 按钮底色），当 6px 进度条读起来像分隔线。
- **叠放次序**：卡片 z-index 对齐官方弹层的 `1100`，遮罩/提示顺次上移（1200/1300），Tooltip 的硬编码 `300` 改走 `--billing-z-tooltip`。
- **颜色角色化（同日修订）**：原来的调色板有两处同色异义——琥珀既是「高峰时段」又是「输出 token」的堆叠段，蓝色既是费用柱又是未缓存输入桶，于是在逐轮面板里切换「费用 / Token」会悄悄改变同一个颜色的含义；卡片用灰柱、面板用蓝柱画同一件事也让两张图看着不像一套。现在按**角色**定色，同一角色在所有表面同色：**蓝 = token 量**（上下文进度条、每轮新增柱、三个输入桶；深蓝=更贵）、**绿 = 生成的输出 token**、**琥珀 = 高峰时段序列**（高峰柱、高峰图例、接近上限、未登记）、**灰 = 中性**（费用柱=钱、空闲序列、空值）。费用柱因此回到灰、输出桶改绿、空闲图例与头部「空闲」标签同为灰。头部**「高峰」标签保持红色**（按需求确认）——它是「此刻正在按高峰价计费」的实时告警，与图表里指代序列的琥珀是两个语域，不强行同色。
- **柱状 hover 不再变全黑（同日修订）**：每轮新增柱 hover 原来把柱子刷成 `label-primary`（近黑墨色），在时间轴上像一道黑渍。改为「同色系加深 + 柱位淡底」——普通柱 → 深一档蓝 + 12% 蓝洗底，高峰柱 → 深一档琥珀（`--billing-peak-strong`），柱位加圆角 hover 轨道。上下文轨道原来用 `bg-layer-3`，而卡片底色本身就是 `specific-menu`(`bg-layer-3`)，轨道不可见；改用 16% 蓝洗底，轨道在两种主题下都可见。
- **缓存命中口径统一（同日修订）**：逐轮明细表与卡片柱状 tooltip 原来各自 `Math.round(rate*100)`，会把 99.2% 显示成「100%」——与卡片刚改的「部分命中绝不显示 100%」自相矛盾。两处都改走同一个 `formatCacheHitPercent(cacheRead, prompt)`（分母同样剔掉缓存写入），无 prompt 输入时显示「–」。
- **修复：卡片齿轮点开的是对话里的「本轮用量」（同日修订，P0）**：`openBillingSettings` 原来用「排除法」找设置入口——「是 `aria-haspopup=dialog` 且既不是本插件、又没有 `aria-label` 的那个按钮」。官方把消息行的「用量 111K tok」药丸做成同一个弹层触发器（有 `aria-haspopup`、**没有** `aria-label`）之后，这个规则命中了它，于是齿轮打开的是对话的 token 用量弹层，而不是插件设置。改为**按槽位取**：先 `[data-slot="sidebar.settings"]`（DSH 侧栏设置入口，与 better-sidebar 样式表用的是同一个锚点），兜底再找「不在 `[data-slot^="conversation."]` 子树内」的弹层触发器——对话里的那些药丸全在 conversation 子树内，因此不会再被误点。
- **无行为变更**：投影形状、路由、价格口径、交互时序（hover 200ms / 离开 300ms / 点击固定）全不动；`pnpm typecheck` + `pnpm test` 全绿。

---

### v0.3.20（悬浮卡片：子代理费用统计）

subagent 在 harness 中是**独立会话**（header `origin: 'subagent'` + `parentSession`），其用量从不进父会话日志，父会话的 `billing` 投影天然看不到。本版把会话的后代子代理费用搬进悬浮卡片。

- **新路由 `/billing/api/subagents`**：入参 `{ sessionId }`，宿主枚举该会话的全部后代子代理并逐个折叠其**自身日志**（与父会话同一个 fold + 当前价格表），返回家族合计 + 每个子代理一行。**性能契约（v0.3.20 实测 341 子会话教训——首版每请求全量重折叠把宿主主线程阻塞到整页发白、会话出不来）**：每个子折叠按「水位」缓存（活会话 = 已折事件 seq；冷会话 = 持久化 revision token）+ 价格表指纹，未变化的直接复用零成本；冷会话读按请求预算（`COLD_FOLD_BUDGET=24`），本次响应立刻返回，**余量交后台 warmer 自热**——分片 drain、每片之间 `setImmediate` 让出主线程（一次只有一个 warmer 循环，新请求重排队列即接管），所以打开过一次的会话家族很快达到「全量已缓存」，之后每次打开秒出精确全量价。wire 的 `pendingCount` 告知客户端「合计还在增长」：卡片打开期间只要 `pendingCount > 0` 或有运行中子代就每 5s 继续轮询，并显示「统计中，还有 N 个历史会话在后台汇总…」。行按创建时间**倒序**（最新优先）后截断 `SUBAGENT_ROWS_CAP=100`。
- **枚举语义（对齐 harness `listDescendants`）**：live-preferred 双源语料（`ctx.sessions` + 可选 `sessionPersistence.list()`），live 记录整 id 优先；沿 header `parentSession` 树 pre-order 遍历（兄弟按 createdAt→id 排序），只有 `origin: 'subagent'` 的节点计为子代理——普通/fork 分支继续向下穿透（连续型子代理可能挂在其下）但**不增加计费深度**；visited 集合防 fork 回环。深度 = 相对根的**可计费跳数**（直接子代 = 1）。
- **运行态判定（纯折叠）**：log 尾部最后一个轮次边界决定——尾随 `turn/start` = 运行中；任何 `turn/end`（含 aborted/error）= 已结束；无边界 = 未开始。冷子会话读 `persistence.inspect()`（4 并发上限、单子失败降级省略该行不影响整体）；缺 persistence 时仅枚举活会话。
- **wire 类型（shared.ts）**：`SubagentBillingRow`（sessionId/label/depth/activity/requestCount/unpriced/inputTokens/outputTokens/per 币种 cost）+ `SubagentsBillingStats`（directCount/totalCount/runningCount/totals/per 币种 `billedCount`/cost/children/truncated）；行列表截断于 `SUBAGENT_ROWS_CAP=100`（合计与 `billedCount` 仍覆盖全部发现节点），发现树硬上限 `SUBAGENT_TREE_CAP=500`。label 取自子日志最后一条 `subagent/descriptor` 事件的 data.label（one-shot 可缺省 → 卡片显示短 id；类型标签在 envelope 层，dsh-subagent 不在依赖表内故结构化读取）。「平均费用」不入 wire——客户端用全量口径的 `billedCount` 现算除法（截断时可见行数不足以做分母），避免第二处口径漂移。
- **卡片「子代理」小节**：位于逐轮图与上下文占用条之间——汇总行（运行中 N + 官方 `StateDot` 旋转环 + 直接/总计个数）+ 合计/平均费用行 + 每子代一行（深度缩进、官方 `StateDot` 状态点——旋转环=运行中/实心绿点=已结束/中性灰点=历史冷会话；自绘的「绿=运行中、空心=历史」已在后续改动中按官方语义对齐，映射见 [subagent-dot.ts](../../src/client/subagent-dot.ts)、名称、输入→输出 token、右侧费用；未登记标琥珀色「未登记」）；超过 100 行时显示「仅显示前 100 行，合计已包含全部」。数据独立拉取：卡片打开即取，有运行中子代期间 5s 轮询自续（关闭卡片即停），点刷新按钮与主统计一起重取；无子代会话整节隐藏。**头部徽标与 hero 数字保持本会话口径不变**，子代费用独立成节不混入（多币种各自分列，不做汇率换算）。
- **投影零改动**：`SessionBillingStats` 形状、zod schema、`stateVersion` 均不动；改动收敛在 shared wire 类型、host 新模块（`subagent-pure.ts` 纯函数 / `subagent-stats.ts` IO 编排 / index 接线路由 + 抽出 `requireSessionId` 共用校验）、client 拉取与小节渲染、locales 双语。**拉取失败静默降级**——小节整个隐藏（旧宿主缺该方法时 404，绝不在每个会话上盖一条错误；下次打开/刷新自动重试）。
- **工程**：peer/devDep 新增 `@deepseek-ai/dsh-session-persistence`（类型擦除导入 + host 读冷会话，不引入 dsh-subagent 包——descriptor label 结构化读取）；新增测试：hasOpenTurn 边界判定（空日志/尾随 start/闭合 end/无边界）、树发现（pre-order、可计费深度、穿透普通分支、origin 无 parent 不计、未知根空结果）、聚合（直接数/运行数/token/多币种合并、130 行截断至 100 且合计仍覆盖 130）。

---

### v0.3.19（高峰时段：工作日/周末 + provider 时区判定 + DeepSeek 官方预设）

对应 DeepSeek 2026-08-23 峰谷计费新规——工作日保留峰谷、周末全天低谷价。

- **高峰窗口支持生效星期（`days` 编辑 UI）**：每个高峰窗口新增「生效星期」一行——快捷 chip「每天 / 工作日(周一至五) / 周末(周六日)」+ 逐日勾选（日一二三四五六）；`days` 按**窗口起始日**判定（周五 22:00–06:00 覆盖周六凌晨）。引擎早已支持 `days` 掩码（`inPeakWindow`），此前设置页无从编辑；「周末无高峰」= 周末无窗口命中 = 自动落到基础（低谷）价，无需新引擎逻辑。
- **provider 级时区（`ProviderCurrency.timezone`）**：设置页 provider 头部新增 IANA 时区输入（文本 + 校验，非法拒存并报错，留空 = `Asia/Shanghai`）。`inPeakWindow` 的小时**与**星期几都按该时区计算（`Intl.DateTimeFormat` 换算，按分钟缓存），host 折叠、client 高峰标签共用同一判定——多 provider 各算各的钟，不再依赖运行机器/浏览器时区（消除 K3 审阅 P1-6 已知限制）。
- **缺省时区 = `Asia/Shanghai`**：未配置 provider 时区（含全部旧配置）一律按北京时区判定。**行为变化**：此前按机器本地时区判定，若你的 host 不在 UTC+8 且配了高峰窗口，升级后归属可能变化——请为不按北京时区计费的 provider 显式配置时区。
- **DeepSeek 官方规则一键预设**：`deepseek-official` provider 设置区新增「应用」按钮——把该 provider 每个模型的高峰窗口批量设为**仅工作日**（替换已有工作日窗口、保留周末/全天窗口），provider 时区置 `Asia/Shanghai`，价格保留用户现有配置（窗口只表达「哪些天高峰」）；幂等可重放。
- **展示自动正确**：徽标「高峰/空闲」、卡片「空闲/高峰时段」拆分全部走共享 `inPeakWindow`——北京周末全天显示「空闲」、费用全入 off-peak 拆分。
- **测试**：新增时区窗口判定（同一时刻在 Asia/Shanghai 为高峰、在 America/New_York 为低谷）、缺省北京时区、非法时区退化不抛错、provider 时区折叠归属（同一时刻两个 provider 各自 peak/off-peak）、工作日掩码周六/周日低谷。OVERNIGHT DAYS 测试改显式传 `Asia/Shanghai`，与机器时区解耦。

---

### v0.3.18.1（修复：上下文占用条被裁掉不可见）

- **上下文占用条回归修复（P0）**：卡片中的上下文进度条（`上下文占用 N% · 已用 / 窗口`）在 v0.3.16 的 K3 审查批次把压缩触发线包进 `<Tooltip>` 后**渲染但不可见**——Tooltip 的锚点 `<span>`（`display:inline-flex`、继承 16px 行高）是 `contextTrack` 的**文档流内**元素，把紧随其后的静态定位 `contextFill` 推到 4px 轨道下方 ~18px，被轨道的 `overflow:hidden` 整个裁掉。修复：`contextFill` 改为 `position:absolute; top:0; left:0`，作为 `contextTrack`（`position:relative`）的定位子元素，与触发线同层；此后任何文档流内兄弟元素都无法再把进度条挤出轨道。已在真实浏览器验证：修复前轨道 y=447 / 填充 y=465（18px 间隙、被裁），修复后两者同 y、填充可见。

---

### v0.3.18（deepseek-harness rc.7 适配：设置迁移原生机制）

- **设置页迁移为原生设置卡片（P0，rc.7 新机制）**：独立 `settings.section` 计费页下线，改为按命名空间 `billing-pricing` 键控注册 `settings.plugin.item` 卡片（`@deepseek-ai/dsh-client-ui-settings-plugins`），出现在设置面板的「插件」配置页。卡片 chrome **1:1 对齐内置 `PluginCard`**（折叠头 = 名称 + 描述 + 「未保存」pill + 箭头；正文 = 只读提示 + 编辑区 + 失败/放弃/保存页脚；不可用命名空间整卡不渲染）——内置 `PluginCard`/`CardForm` 不对外开放（值不可导入），按其发布实现复刻（新增 dirty 追踪与放弃按钮，语义同款：任何编辑置脏、保存/放弃清脏）。
- **价格表读写迁移原生 settings RPC**：rc.7 移除了 settings RPC 的命名空间写死白名单并新增 client 侧 `settingsScope` 绑定，自建 `/billing/api/settings.get|update` 路由删除。编辑器初始化读 scope 快照（schema 校验过的生效表），保存改为 `scope.set('providers'|'models', …)` 逐字段 mutate（revision fencing；宿主拒绝时静默重读，通过比对 user 层 JSON 确认落盘，未落盘报「写入被拒绝」）。
- **跨端同步原生化**：删除 `billing:pricing-updated` window 事件 + localStorage 广播——保存提交 Host 文档后，`settings/document-updated` 让所有绑定端（含其他标签页）自动重播种；host 侧既有 `scope.watch` → 投影重挂载 → 全会话重算链路不变。徽标高峰标签从「fetch + 事件监听」改为订阅共享 scope 绑定（新增 `src/client/pricing-scope.ts`，apply 时 attach 一次，徽标/卡片共用）。
- **远程/非本机浏览器语义**：scope 为 `unavailable`/只读（设置 RPC 是特权通道）——卡片显示只读/不可用提示、禁用保存；徽标高峰标签不显示（与原 fence 403 表现一致）。`/billing/api` 其余路由（`catalog`/`turns`/`refresh`）保留 loopback fence 不变。
- **齿轮入口降级说明**：rc.7 的设置面板打开态/激活 tab 是组件本地 state，无导航 API——齿轮只能打开设置面板，无法直达「插件」页或展开卡片；locate 请求改为排队，卡片挂载（用户打开插件页）时消费并展开定位当前模型。
- **工程**：12 个 `@deepseek-ai/dsh-*` 依赖 `^0.1.0-rc.6` → `^0.1.0-rc.7`；peer 新增 `dsh-client-connection`/`dsh-api-remotes`/`dsh-client-ui-settings-plugins`，devDep 新增 settings-plugins（类型擦除导入）；`dsh.client.inject` 清单新增 connection + api-remotes（settingsScope binder 经调用方 fiber 解析这两个服务）；命名空间字符串收敛为 `shared.ts` 的 `PRICING_NAMESPACE` 常量（host/client 单一事实源）；cordis `inject` 增至 `['slots','locale','connection','remote','settingsScope']`；client bundle require 面仍为纯平台模块（react/react-dom/ui-primitives）。补齐 v0.3.17 漏升的 package.json 版本号（0.3.16 → 0.3.18；v0.3.17 变更已全部包含）。
- **rc.7 其余变更与本插件的关系**：DeepSeek 模型新增 `low` 推理强度（默认仍 `high`）——effort 专属价行按 `provider/model/effort` 字符串匹配，天然兼容，无需改动；逐包 diff 确认其余消费面（投影注册、图标导出、`dsh.client` 清单契约）零破坏。

---

### v0.3.17（V4 Pro 查漏补缺）

- **effort 专属价行 + 高峰窗口的标签判定对齐（P1）**：`peakModels` 的 key 在命中 effort 专属价行时带第三段 effort（`provider/model/effort`）；client 高峰标签按 effort 查同一行（`findPriceRow` 优先 effort 行）。原实现 key 只带 `provider/model`、标签永远查通用行——effort 行配高峰窗口时标签永不亮、与卡片分栏矛盾。
- **`boundTurns` 按轮号计数（P2）**：投影帧截断的「50 轮」原按 `turn:currency` 键控，多币种轮占 2 个名额，全多币种会话实际只留 ~25 轮；改为按轮号，多币种轮只占一个名额。
- **OVERNIGHT DAYS 测试时区无关化（P2）**：断言时刻从固定 `+08:00` 字面量改为本机本地时间构造（2026-08-21 周五 / 08-22 周六），UTC+9 以东机器不再误挂。
- **C3 修复扩展到多标签页（P2）**：设置页保存除同页事件外再写 localStorage 广播，其他标签页的徽标监听 `storage` 事件重取价格表——原只有保存的那一页高峰标签会更新。
- **测试**：新增 EFFORT PEAK KEY（effort 行高峰 key、无 effort 请求不产 key）与 TURN BOUND CURRENCY（多币种 50 轮截断）两组检查。

---

### v0.3.16（审查修复批次二，review-0818）

- **压缩摘要调用计入费用（P1）**：`compaction/summary` 携带的 `usage`（摘要一次性调用的真实 provider 用量，不产生 `assistant/message`）此前完全不计费——恰恰是最贵会话里的大头。现在计入会话费用总额与空闲/高峰拆分，并在卡片压缩历史行展示「摘要花费」；其 token 不进会话 token 桶（避免一次性重读稀释缓存命中率语义），累计在 `compactions.tokens` / `compactions.cost`。投影 schema 同步。
- **折叠状态瘦身（P1）**：`BillingFoldState` 只保留 `header.config`，不再持有完整 `EpochHeader`（system prompt/工具 schema 数十 KB 不再冗余进投影持久化 checkpoint）。
- **改价后冷读复活旧价（P1）**：价格表内容哈希（FNV-1a）混入投影 `stateVersion`（base 7→8）——改价即让用旧价格折叠的持久化 checkpoint 失效、冷读全量重折；同表同版本，重启后 checkpoint 仍有效。
- **reasoningEffort 匹配优先级（P1）**：新增共享 `findPriceRow`——effort 精确匹配优先于无 effort 通用行（原数组序依赖：通用行在前则 effort 专属价永不生效；无 effort 请求会误中 effort 行）；host 折叠、高峰窗口检测、client 高峰标签三处统一走它。
- **跨天窗口 × days 语义修正（P2）**：`days` 按**窗口起始日**判定——「周五 22:00–06:00」覆盖周六凌晨（原按请求发生的日历日过滤，周六 02:00 被错误排除）；起止相同 = 全天。
- **fence CSRF 加固（P2）**：`/billing/api` 在 loopback Host 之外增加 `sec-fetch-site`（拒 `cross-site`）与 `content-type: application/json` 检查——跨域网页经 simple request 改写本地价格表的写入面被封死。
- **杂项修复**：settings.update 校验失败返回 400（原 500）；未登记请求的 turn 行保留 provider 币种（原硬编码 CNY，多币种分组错位）。
- **client 修复**：悬浮卡片首次打开即测量高度（翻转/贴底分支首次生效；卡片宽度改实测并挂 ResizeObserver 跟随内容变化）；逐轮面板多币种分组头部按币种并列（原跨币种加总假数）；设置页保存后广播 `billing:pricing-updated`，徽标高峰标签即换新表（原修改已在用模型的高峰窗口后标签永远用旧表）；迷你图增长改按轮号键控（修多币种轮次错列与 React key 冲突）；旧数据高峰窗口的首次价格编辑即生效（原被旧平价播种吞掉）；`endHour` 最小 1（原可输 0 导致保存必 400）；`buildEditor` 只用无 effort 行播种（原 effort 行保存时被拆成两行）；压缩触发线统一 Tooltip（去掉最后的原生 `title`）；触发阈值统一 `COMPACT_TRIGGER_RATIO`。
- **工程**：版本号对齐 package.json ↔ 迭代记录（0.2.6 → 0.3.16）；`dsh-llm` 补入 peerDependencies；删死代码（`currentTurnOf`、6 个无引用 locale 键、未用 `NS` 导入）；`formatTokens` 进位到 1000K 时显示 `1.00M`；invariant 空态断言补全；`src/index.ts` 重复导出清理。
- **测试**：新增 EFFORT PRECEDENCE / OVERNIGHT DAYS / FENCE / UNPRICED CURRENCY / TURN GROWTH MAP 五组检查 + compaction 计价断言。
- **迷你图第 1 轮新增占用修正**：首轮增长此前按「无前驱 → 0」处理（柱高残 4px、tooltip 显示 0），改为**整轮快照**——第 1 轮的前驱是空上下文，其装载的全部内容都是新增；截断帧的首轮（前驱在窗口外）保持不计，避免把整轮快照误当增长。
- **迷你图布局改为从左到右**：`space-between` 两端贴边（v0.3.11）与「时间递增」读感冲突——柱距随宽度变化、末柱永远贴右缘，且与详情面板图表不一致；改为固定 3px 柱距左起排列，与详情面板同款。
- **文档**：docs/prd 重组（迭代记录拆分至 CHANGELOG、v0.3 迭代 PRD 归档 archive/、FR-6~9 与完整数据模型并入主 PRD）；README 重写精简。

### v0.3.15（快照差分模型：免疫缓存失效）
- **口径再修正**：v0.3.14 的「未缓存输入 + 输出」净增在**缓存失效**时会假性暴涨（下一轮历史重放为未缓存输入，7.5K 净增变 555K）。改为**快照差分**：每轮新增 = 该轮最后一个请求总输入 − 上一轮最后一个请求总输入——总输入与缓存状态无关，命中/未命中只是同一上下文的不同计费方式，差分天然免疫缓存波动（用户反馈确认）。
- 迷你图柱高/tooltip、压缩预估增速统一改快照差分（`turnSnapshots`/`turnGrowths`）；hover 文案改「新增占用」，区块标题「最近输入」→「每轮新增」。
- 测试重写（SNAPSHOT DELTA CHECK，含缓存失效场景断言）。

### v0.3.14（净增模型：缓存命中/写入不计入增长）
- **确立口径（真实日志验证）**：每轮净增 = Σ(未缓存输入 + 输出)；缓存命中是历史重读（18 轮中单轮 31M vs 净增 71K）、缓存写入是本轮自身输入，均不计入。此前三种口径（step 求和 11M 爆表 / 最后一个请求快照 / 水平差分）全部废弃。
- 迷你图柱高与 tooltip 改净增；压缩预估增速/ETA 改净增序列（`turnNetGrowths`）；测试重写（NET GROWTH CHECK）。

### v0.3.13（迷你图柱高改上下文水平，修复多 step 求和爆表）
- **柱高/输入 tooltip 改轮次结束水平**：新增 `turnInputLevels`（每轮取最后一个请求的总输入）；迷你图此前用 `aggregateTurns` 的 step 求和——工具调用轮每步重发全历史，84 step 轮次求和 15.7M、真实水平 215K，hover 出现「11M」这类突破上下文窗口的假数。
- 测试补 `turnInputLevels`（含进行中轮）断言。

### v0.3.12（压缩预估双窗口保守化 + 余量可验证）
- **增速取双窗口最小值**：全历史 trimmed mean 与最近 10 轮 trimmed mean 取较小者——早期一次性装载（system prompt/首批上下文）抬高的全历史均值不再虚增预估轮数；近期变轻也不会过度乐观。
- **文案带余量**：`净增 +X/轮，余量 Y，约 N 轮后触发压缩`——Y/X 可心算验证 N（此前只显示 X 和 N，N 无法核对）。
- 测试补双窗口保守取小用例（COMPACTION ETA CHECK）。

### v0.3.11（迷你图改 token 柱 + 对称布局）
- **迷你图从费用柱改为输入 token 柱**：该区块处于 token 上下文（输入/命中/输出/占用条），费用柱语义突兀；柱高 = 该轮总输入 token，高峰轮暖色标记保留（该轮输入按高峰计价）；区块标签「最近消耗」→「最近输入」。
- **tooltip 改富信息**：轮次 + token 消耗（输入）+ 费用消耗 + 命中率，一段文案齐备。
- **左右间距对称**：`.turnsChart` 去掉 `gap` 改 `justify-content: space-between`——首末柱贴边、余量均匀摊入柱间，消除右缘空档。

### v0.3.10（压缩预估消除轮边界跳变 + 迷你图满宽自适应）
- **预估只用已完成轮次**：新增 `completedTurnLevels`（纯函数，进行中的轮次被排除——其水平随每个请求增长，纳入会在轮边界跳变、轮内漂移）；`ContextBar` 增速取自完成轮次 trimmed mean。
- **headroom 单调位置**：`max(最近请求输入, 上一完成轮水平)`——缓存命中丰富时请求总输入可能低于历史水平，用 max 防止位置假性回退导致 ETA 反向跳高。
- **迷你图满宽**：`TurnsBarChart` 从写死 10 轮改为 ResizeObserver 实测容器宽度、按 18px 柱宽 + 3px 间距计算可容纳轮数（至少 4 根、首次测量前 fallback 10），右边不再留白。
- 新增测试：`TURN LEVELS CHECK`（完成轮提取 + 进行中轮排除语义）。

### v0.3.9（压缩预估稳定性 + 横轴强调方式）
- **预估改 trimmed mean**：增速从「最近 5 轮简单平均」改为**最近 10 轮正差分 trimmed mean**（去掉最大最小各一个），单轮偏轻/偏重不再左右预估；<3 个正差分或无余量不显示。纯函数 `estimateCompactionGrowth`/`estimateCompactionEta` 提取到 `shared.ts` 并补单元测试（COMPACTION ETA CHECK）。
- **横轴强调改到标签**：轮次首请求（`N.1`）不再给柱体加 1px 描边（观感差），改为标签加粗 + 提亮（`font-weight 600` + secondary 色），前导 8px 间距保留。

### v0.3.8（压缩预估模型修正 + 触发线口径 + 轮次边界分组）
- **修压缩预估模型（P0）**：原实现把「每轮请求总输入」当增速——但一轮输入包含全部历史，水平值可达几十 K，headroom 只有窗口的 38% 时算出「1 轮后压缩」。改为**相邻轮次输入的差分**（每轮净增 = 本轮总输入 − 上轮总输入；差分 ≤0 丢弃——压缩后水平重置），ETA = headroom ÷ 平均正差分；<2 轮或全无正差分不显示。文案改「净增 +X/轮，约 N 轮后触发」。v0.3.9 再修：轮级水平取**该轮最后一个请求**的输入（工具调用轮内每个 step 重发全上下文，求和会多倍虚增——曾算出 +12.61M/轮），差分对水平做。
- **触发线口径澄清**：`thresholdRatio` 是 compaction-basic 的**私有 cordis patch 配置**（当前宿主 bundle 未覆盖 = 默认 0.8），无 settings 命名空间、无运行时读取面——0.8 作为「默认触发线」如实标注（tooltip 说明「宿主若覆盖则此线为近似」），不再冒充读自配置。
- **触发线样式重做**：2px 实心琥珀竖线 → 1px 半透明（45%）hairline + 顶部 4px 缺口标记，读作参考线而非数据。
- **按请求图轮次边界分组**：dense 模式下每轮**第一个请求**（step=1）加 8px 前导间距；其横轴标签 `N.1` 必标（与抽稀正交）**并加粗 + 提亮**（原方案给柱体加 1px 描边，观感差，改为在横轴标签上强调），轮次起点一眼可寻。

### v0.3.7（压缩预测条 + 请求级密集图）
- **压缩预测条（卡片占用条升级）**：
  - host 折叠 `compaction/summary` 事件（类型经 `import type {} from '@deepseek-ai/dsh-compaction'` 的 declaration merge 引入）→ `SessionBillingStats.compactions`（`count`/`lastTime`/`lastShadowedTokens`，全部为 harness 写好的真实 shadow price，插件零估算）；投影 `stateVersion` 6 → 7；`assertEmptyBillingStats` 同步。
  - 占用条 80% 处加琥珀触发线（compaction-basic 默认 `thresholdRatio=0.8` × contextWindow，即自动压缩触发点）；有压缩史时显示「已压缩 N 次 · 上次 HH:MM:SS · 释放 X tokens」；用最近 ≤5 轮真实 usage 输入增速外推「预计 N 轮后触发压缩」（粗估：harness 计量全表面启发式估算、插件只见真实 usage，分母为输入+输出窗口；无增速/无余量不显示）。
  - 新增文案 `card.compactDone`/`card.compactEta`（zh/en）；依赖新增 `@deepseek-ai/dsh-compaction ^0.1.0-rc.6`（peer + dev）；测试补 compaction 折叠断言。
- **按请求密集图**：`TurnChart` 增加 `dense` 模式——「按请求」柱宽 24px → 12px（宏观趋势视角，精确值在 tooltip/表格），标签抽稀更激进（>40 根隔 4、>80 根隔 8，首尾必标）。

### v0.3.6（图表横轴可读性 + 占用条口径修正）
- **图表横轴改纯数字标签**：详情面板横轴从「轮次 N」改为纯数字（按轮次 `12`、按请求 `12.3`），表头与 tooltip 保留完整语义——原「轮次 N」中文标签在固定柱宽下被截成「轮次轮次轮次」，`N.step` 也被截断。
- **柱宽固定 24px**（原 18px），容纳 3-4 位数字标签不截断；抽稀阈值重定（>20 根隔 1 标、>40 根隔 4 标，首尾必标）。
- **占用条口径修正**：`request/context.contextWindow` 是 provider 声明的**输入+输出合计**窗口（harness `RequestContext` 定义），不是纯输入窗口——「最近一次请求输入占上下文 32%」这类提示是混合口径、无行动意义，已删除（`SINGLE_TURN_WARN_RATIO` 与 `turn.lastInput` 一并移除）；占用条保留并注明口径（输入 / 输入+输出总窗口），≥85% 预警语义不变（输入接近总窗口时输出空间所剩无几）。
- 死 CSS（`.contextHint`）与死文案清理。

### v0.3.5（交互与视觉规范统一）
- **交互节奏统一**：新增 `src/client/interaction.ts`——悬停打开 200ms / 离开关闭 300ms / 点击取消悬停打开 100ms / tooltip 延迟 400ms，卡片与图表/按钮 tooltip 共用同一套节奏（此前悬停卡片 120ms/150ms 与原生 title 的 OS 延迟明显不同步）。
- **统一 Tooltip 替代原生 `title`**：新增 `src/client/Tooltip.tsx`（portaled、跟随锚点、Esc 关闭、z-index 300 高于卡片 100 与详情 mask 200，`role="tooltip"`）；卡片三个按钮与两个图表（迷你图、详情面板）全部改用它，原生 title 全部移除（读屏不可达、触屏无 hover、延迟不可控）。
- **设计 token 单一事实源**：新增 `src/client/theme.module.css` 的 `--billing-*` 变量层（文本三阶/表面/边框/图表色/圆角/动效曲线），四个组件 CSS 全部改经该层解析（组件不再直接引用 `--dsw-*`），跨主题改一处生效。⚠️ 踩坑记录：dsw 主题变量定义在 `body`/`body[data-ds-dark-theme]` 上（非 `:root`），token 层曾误挂 `:root` 导致全部 alias 落到亮色 fallback、暗色模式整体失效——引用 `--dsw-*` 的 `--billing-*` 必须声明在 `body`，与主题无关的常量（z-index/圆角/动效）才放 `:root`。
- **修悬停死区**：卡片与触发器之间的 8px 空隙会立刻触发离开关闭，指针无法进入卡片（P0）；新增不可见桥接层 + 卡片自身进入/离开处理，空隙不再算作离开。
- **恢复输出上限展示**：卡片占用行重新显示 `maxOutputTokens`（v0.3 承诺，美化分支误删），与 `已用/窗口` 同行展示。
- **无障碍**：卡片按钮 aria-label 规范（设置按钮改用动作语义 `settings.open.aria`）；详情面板关闭按钮修复（原误用 `settings.open` 文案）。
- **杂项**：删除 `BillingCard` 死变量；设置页保存失败增加内联错误（原静默吞掉）；capability 行分隔符只在两个字段都存在时渲染（原单字段时也带 `·`）；投影 zod 收紧 `cacheHitRate` 0..1；catalog 按 provider 并发（原串行，慢 adapter 拖慢整页）；折叠改走 `priceRequest`（计价公式单点，原与 price.ts 双份漂移）；`assertEmptyBillingStats` 纳入测试。

### v0.3.4（逐轮面板方向与表头修正）
- **图表横轴改为时间递增**：详情面板费用/token 图改为**最老轮在左、最新轮在右**（轮次从左到右递增，与阅读顺序一致）——原实现最新轮在左的倒序与时间直觉相反。列表仍保持最新轮在最上的倒序（表格阅读习惯），图表与列表解耦。
- **明细表头去括号**：表头不再显示 `（缓存未命中）/（缓存命中）` 括号，改用简洁的「未命中 / 命中 / 写入 / 输出」（复用 `turn.*` 文案键，新增 `turn.cacheMiss`，zh/en 同步）。
- **请求序号始终带 step**：「按请求」视图中每个请求的序号一律显示 `turn.step`（如 `1.1`、`2.3`），单请求轮不再省略成裸 `N`——裸序号会与「按轮次」的轮次号混淆。
- **图表跟随视图切换**：图表不再是固定按轮次聚合——「按轮次」时每轮一根柱（工具调用 step 合并），「按请求」时每个请求一根柱（序号 `N.step`）。两个视图的图表粒度与明细表粒度一致，避免「图表一样、只换表格」的冗余（v0.3.4 后续修正）。

### v0.3.3（逐轮面板体验打磨 · 三轮反馈）
- **列表/图表按轮次倒序**：详情面板的费用/token 图与明细表均改为**最新轮在前**（图表最新轮在左、列表最新轮在最上），与卡片迷你图倒序一致——原按日志升序，长会话最新数据沉底。
- **「按请求」改为可折叠轮次分组**：切到「按请求」视图时不再平铺全部请求行，而是**每轮一行聚合（含展开箭头 + 请求数）+ 点击展开该轮的请求明细**（默认全部折叠）。一个含上百次工具调用的会话从「上百行平铺翻找」变成「先看轮次聚合、需要时再展开单轮」；轮内请求保持日志顺序。图表始终按轮次聚合，与折叠表一致。

### v0.3.2（逐轮面板体验打磨 · 二轮反馈）
- **按轮次有界投影（修漏轮）**：投影帧的 `turns` 截断从「最后 N 条请求」改为「**最后 N 轮**」（`boundTurns` 纯函数，保留一个轮次的全部 step 不拆散）——原实现按请求截断，长工具链会话的早期轮次（如第 1 轮 128 条请求）会被整轮挤掉，卡片迷你图只显示后几轮。
- **纵向刻度轴方向修正**：刻度从 0（底部）递增到最大值（顶部），与柱子自底向上的生长方向一致（原实现渲染为顶→底）。
- **最近消耗倒序**：卡片迷你图最新轮在**左**（倒序），符合阅读习惯。
- **token 配色重构**：四类桶改**蓝阶渐变 + 琥珀输出**（未命中 `deepseek-400`、命中 `deepseek-200`、写入 `deepseek-500`、输出 `amber-400`）——原 `success-tertiary`/`success-secondary`/`warn-tertiary`/`business-primary` 在亮色下未命中过浅、命中/输出过深，且 `state-business-secondary` 在设计 token 中不存在导致命中缓存渲染空白。
- **明细表输入列口径修正（修重复困惑）**：表格「输入」列从「总输入」改为**未命中部分**（`inputTokens - cacheRead - cacheWrite`），与命中/写入/输出四列互斥相加 = 总用量，不再与命中/写入列重叠；token 维度下附图例口径说明（四桶互斥相加 = 总用量，与主仓库 token-meter `usageTokens` 同口径）。

### v0.3.1（逐轮面板体验打磨，GUI 实测反馈）
- **默认按轮次聚合**：详情面板与卡片迷你图默认**按轮次（turn）**展示——一个轮次内的工具调用 step 合并为一条（`aggregateTurns` 纯函数：同轮 token/费用累加、命中率按合并桶重算、多币种不混并、未登记标记仅当该轮全部请求未登记）。「按请求」视图展开每条明细（保留原粒度）。
- **图表加纵向刻度轴**：详情面板图表左侧新增刻度轴（`niceStep` 取 1/2/5 步长，2-5 个刻度），费用维度带币种符号（`formatPriceAxis` 保留小数值精度）、token 维度紧凑单位。
- **修 token 堆叠配色**：命中缓存段原用 `--dsw-alias-state-business-secondary`——该 alias 在设计 token 中不存在，渲染为空白。改用已定义的语义 token：输入未命中 `state-success-tertiary`、命中 `state-success-secondary`、缓存写入 `state-warn-tertiary`、输出 `state-business-primary`，亮暗主题均可区分。
- **时段展示仅在配置高峰时段时出现**：详情面板的「时段」列与高峰/空闲图例、以及未登记图例，仅在会话 `hasPeakConfig` 时渲染——无高峰时段配置的会话不再显示「空闲时段」误导文案。

### v0.3（逐轮消耗可视化 + 上下文窗口占用）
- **逐轮消耗数据层**：`SessionBillingStats` 新增 `turns: TurnCost[]`（最近 ≤50 条，有界）与 `lastRequestInputTokens`；`foldEvent` 对每次带 `usage` 的 `assistant/message` 逐条产出 `TurnCost`（轮次/时间/四类 token/命中率/费用/币种/时段/是否已登记），纯折叠无新数据源、与会话总量同源同事务；投影 `stateVersion` 5 → 6；全量明细走新增 `/billing/api/turns` 按需路由。
- **上下文占用（日志真实数据，纯折叠）**：`request/context` last-wins 设置/清除 `contextWindow`；`request/header.config.maxTokens` 设置/清除 `maxOutputTokens`（no-op 快路径比较纳入 `maxTokens`）；分子 = 最近一次请求总输入（`lastRequestInputTokens`，非累计）。卡片显示进度条 + 百分比 + `已用/窗口` + `输出上限`，≥85% 预警「接近上限，建议开新会话」、单请求 ≥30% 附小字提示；任一缺省不显示（不估算）。
- **逐轮消耗展示**：卡片「最近消耗」迷你横条图（最近 10 条、每轮费用、peak/off-peak 着色、hover 详情）+ 「查看详情」按钮打开独立大面板（逐轮费用柱状图 + 四段 token 堆叠图 + 逐轮明细表，费用/token 维度切换），纯 CSS 绘制不引图表库。
- **设置页模型能力**：`catalog` 路由并行调 `ctx.llm.resolveModelInfo`（单模型失败降级缺省），每个模型行显示真实上下文窗口/最大输出能力（目录解析，失败不显示；输出上限仅部署显式配置时存在，标注「（配置）」）。
- 新增 `card.*`/`turn.*`/`capability.*` 文案（zh/en）；新增 `BillingTurnsPanel.tsx` 组件。

### v0.2.6（分段编辑器文案打磨）
- **分段按序编号**：开启分段开关后，默认段显示「区间 1」，新增分段依次为「区间 2」「区间 3」…——方便对照每次请求落在哪一段；开关关闭时不显示任何分段字样。
- **区间标注输入/输出（分两行堆叠）**：每段内部「输入区间」「输出区间」各占一行（各自带 `K tokens` 单位），区分两对 min–max 上下界；两行堆叠后长边界不再换行、不溢出（原单行横排超宽会折行错位）。
- **高峰时段结构统一**：每个高峰窗口顶部是时段（起止时间），其下「分段计费」块从**区间 1**（该窗口默认/平价）开始包含全部区间，与空闲分段完全相同的 tierBox 结构——只读区间行在上、四价字段在下；区间 1 不再留在分段计费块之外。
- **高峰区间改区间记号**：高峰每段只读区间改为区间记号——`输入长度 [0, 32)`、`输出长度 [0, 0.2)`、`[0.2+)`（下限缺省 = 0、上限缺省 = `+`，无约束的维度不显示、全无约束的默认段显示「全部」）。
- **抽公共组件**：`TierRangeLine`（可编辑/只读两种模式）+ `PriceFields`（四价字段）统一空闲与高峰的分段渲染；删除 `tierRangeLabel`/`tierLabel`。
- 新增 `settings.tier.range` / `settings.tier.inputRange` / `settings.tier.outputRange` / `settings.tier.all` 文案（zh/en），删除不再使用的 `settings.tier.default`。

### v0.2.5（审查修复批次，review-k3-0816）
- **修设置页跳转选择器**：齿轮不再用裸 `aria-haspopup="dialog"` 猜测（页面至少 3 个匹配，含插件自身徽标与 ContextMeter）；插件徽标加 `data-billing-trigger` 标记，排除自身与带 aria-label 的按钮后取剩余文本按钮，nav 点击改为轮询（最长 1s）而非固定 50ms。
- **修保存数据丢失**：设置页保存时把目录外模型与 `reasoningEffort` 价格行（含其 provider 币种）原样合并回提交负载；`buildEditor` 播种优先取无 effort 行。
- **修测试链路**：`SessionEvent` 改从 `@deepseek-ai/dsh-session` 导入（原从不导出它的 shared.ts 导入，因 tests 不进 typecheck 而隐形）；`pnpm test` 改为 `node tests/pure-check.ts`（原 vitest 配置捡主仓根配置、永远跑不到本测试）；新增 `tsconfig.tests.json` 纳入 tests typecheck；修掉暴露出的 fixture 类型错误（AssistantMessage 缺 id/source）。
- **修 host 生命周期**：`scope.watch` 包进 `ctx.effect`（原 disposer 丢弃、卸载后仍触发）；`ctx.inject` 整个生命周期只调一次（原每次重挂载都新建 fiber）；卡片刷新不再 remount 全局投影，只同步价格表并折叠单会话。
- **收紧 settings schema**：价格全部 `.min(0)`、`startHour` 0–23、`endHour` 1–24，阻止 API 直写非法值打挂投影 zod 校验。
- **多币种徽标并列**：`¥1.20 + $0.35`，不再只显示最大子合计。
- **共享常量归位**：`PRICE_PRECISION`/`formatPrice`/`EMPTY_STATS` 移入 `shared.ts`（host/client 原各一份）；`EMPTY_STATS` 冻结。
- **工程**：版本号对齐到 0.2.5；`prepare` 改为完整构建（原在首次 install 时因 tsc 产物缺失必失败）；删冗余脚本；package.json 加 `files` 白名单；修 `tsconfig.json` 的 `ignoreDeprecations: "6.0"`（TS 5.9 下 typecheck 直接报错）。
- **小修**：`tierLabel` 死分支删除、「全部」进 locales（新增 `settings.tier.all`）；价格/小时/长度输入在 unmount 时提交未失焦的草稿；`foldEvent` 在 header config 未变时返回原 state（不再推空帧）；移除 client 死注入 `remote`。

### v0.2.1
- **分段计费改为开关**：每个模型行标题右侧「分段计费」switch，开启后在基础价格下方显示分段编辑器（不再放在页面最底部）；关闭则清空分段。
- **输入/输出长度区间改为横向布局**：同一行内输入区间与输出区间并排，降低卡片高度。
- **0 即填 0**：下限默认显示 `0`（真实值），上限留空 = 不限（显示 `∞`），不再出现「不限～32K」这类歧义。
- **高峰时段区间复用、价格独立**：`PeakPeriod.tiers` 只存各段高峰价格，按索引对齐模型基础分段区间；新增高峰窗口时按基础分段结构预填各段价格（区间边界不再重复编辑）。
- **卡片底色区分**：模型行左侧加品牌色竖条 + 分层底色（group 用 bg-base、模型行用 layer-1、分段/高峰用 layer-2/3），提升辨识度。

### v0.2.2（暗色模式 token 修复）
- **修复悬浮卡片「当前模型」行 dark 下底色消失**：`.modelLine` 原来用 `interactive-bg-hover-solid`，其 dark 值（`neutral-bluish-800`）与卡片背景 `specific-menu`（=`bg-layer-3`）同色，导致底色不可见。
- **统一修复卡片/设置页内 hover 反馈**：`.refresh`/`.settings`/`.removePeriod` hover 背景从 `interactive-bg-hover-solid` 改为 `interactive-bg-hover`（半透明，与官方 Menu 一致），避免 dark 下与所在表面同色。
- **设置页层级对齐官方语义**：provider 分组改为透明 + `border-l2`（官方 rowCard 模式，不再用 `bg-base` 造成 dark 大黑坑）；模型行改 `bg-module-platform`（官方 editor 填充模块语义）；`.addPeriod:hover` 由改边框色改为半透明背景（边框 l1 比 l2 更淡，原 hover 反而变淡）。

### v0.2.3（当前模型行背景调弱）
- **「当前模型」行背景从 `interactive-bg-hover-accent` 改为 `markdown-tag`**：上一版用 accent（dark 下 24% 白叠加，Δ≈61）对纯信息展示过强，dark 下抢占视觉重点；`markdown-tag`（light=浅灰、dark=比卡片深一档，Δ≈10-12）是"标签信息块"语义，亮暗都柔和克制，不抢 token/费用数字的重点。

### v0.2.4（分段与默认价格统一为连续档）
- **默认价格成为第一段**：开启分段开关后，默认价格行显示可编辑区间，成为 `tiers[0]`；「添加分段」就在默认价格行下方直接增加新区间行——分段与默认价格是连续的一整套档，不再是独立区块。
- **分段字段复用默认命名**：每个分段用与默认价格完全一致的四个字段（输入命中/未命中、缓存写入、输出），去掉"分段输入/分段输出"等前缀命名；区间行紧凑单行，不换行、不挤压布局。
- **新增/删除分段时高峰窗口同步增删**：`addTier`/`removeTier` 同步给每个高峰窗口增删对应段（区间一致、价格独立可编辑）；关闭开关时清空高峰窗口的分段数组。
- **计价兜底语义**：`tierIndex` 把无区间约束的档（默认/全部）作为最后兜底——具体区间段优先匹配，无匹配时落到默认档价；peak 按索引对齐保持不变。
- **保存**：开启时分段保存为 `tiers`（`tiers[0]` = 默认档区间 + 顶层默认价）；关闭时 `tiers` 清空，仅存顶层默认价。

### v0.2
- **缓存写入独立计价**：`ModelPrice`/`PeakPeriod`/`PriceTier` 新增 `cacheWrite` 单价；折叠中 `cacheWriteTokens` 改按 `cacheWrite` 计（未配置缺省 0），不再按缓存命中价近似。命名统一为独立「缓存写入」（非「输入（缓存写入）」）。设置页基础价与每个高峰时段/分段增加「缓存写入」输入；统计卡片在会话存在缓存写入 token 时显示「缓存写入」行。
- **分段计费**：`ModelPrice` 新增 `tiers[]`（输入/输出长度区间 + 四价）；每个请求按总输入长度（未命中+命中+写入）与输出长度命中第一个匹配分段，整单按档计价；无匹配按所在档位平价。设置页每个模型可增删多个分段，长度以 K tokens 输入、留空不限、新增自动用基础价预填。
- **高峰时段自带分段**：`PeakPeriod` 新增 `tiers[]`；新增高峰窗口时自动复制模型基础分段，每个窗口可独立编辑自己的分段与价格；活跃高峰窗口用其自身分段（无匹配则用窗口平价）。
- **默认表新增 zai**：按 bigmodel.cn 官方价写入 GLM-5.1/GLM-5-Turbo/GLM-4.5-Air（输入分段）与 GLM-4.7（输入+输出分段），GLM-5.2 平档；缓存写入为限时免费（0）。
- host 投影 `stateVersion` 4 → 5（折叠语义变更，旧缓存失效重算）。

### v0.1.1
- 设置页 provider 分组**默认全部折叠**；折叠/展开控件从行首移到**标题右侧**的箭头图标按钮，移除「展开/折叠」文本按钮（整行仍可点击切换）。

### v0.1.2
- 悬浮卡片费用区三行标签（总费用/空闲时段/高峰时段）**左对齐**（去掉分栏缩进）；空闲/高峰拆分金额改用**灰色小字**，与时段标题一致，总费用行样式不变。
- 会话头部新增**红色「高峰」标签**：会话用到配置了高峰窗口的模型且当前时刻处于高峰时显示（实心红底圆角代码块样式，每分钟重算）。

### v0.1.3
- 设置页高峰时段起止时间改为**时钟样式**显示（`9:00` / `22:00`，结束可为 `24:00`）。
- 价格输入**自动补零到两位小数**（`10` → `10.00`），超过两位小数按实际值显示（`10.155` 不变）。

### v0.1.4
- 头部状态标签**弱饱和化**：高峰改浅红底红字（不再实心红）；新增**灰色「空闲」标签**（有高峰配置但当前不在高峰时显示）；无高峰配置不显示任何标签。
- 「未登记价格」改为**琥珀色圆角标签**，与高峰/空闲标签统一成同一套 chip 样式。
- 悬浮卡片「总费用」标签去掉币种符号 `(¥)`（金额右侧已带符号，避免重复）。

### v0.1.5
- 修复未定义 token：`--dsw-alias-fill-l1/l2` 在运行时不存在，头部标签底色与设置页所有填充背景改为**运行时确认存在的 token**（`bg-layer-1/2/3` 层级底色、`state-warn-tertiary` 琥珀底、`interactive-bg-hover-*` 悬浮底），「未登记价格」「空闲」标签底色可见。
- 悬浮卡片标题下方新增**当前模型行**（`provider / model` + reasoning effort）。
- 卡片齿轮设置改为**跳转并定位当前模型**：自动展开对应 provider 分组，滚动到该模型行（下方空间足够则置顶显示，否则靠底显示，不强行留白）。

### v0.1
- 首个可用版本：会话头部常驻入口 + hover/点击卡片 + 计费设置页 + 高峰/空闲计价 + 多 provider/多币种 + 未登记价格 + 热更新开发循环。
- 全部 9 项核心需求（US-1 ~ US-9）与热更新（US-10）已实现。