# 更新记录

本文件记录 dsh-token-panel 的用户可见更新。格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)。

**中文** ｜ [English](CHANGELOG.en.md)

## [0.4.7] - 2026-08-15

### 修复

- **实时底部 "TOTAL · OUT" 数字误导**：TOTAL 原显示的是当前上下文压力（k 量级），与累计输出（M 量级）并排会让 OUT > TOTAL、看起来像 bug；现改为显示**累计总量**（与统计视图"累计消耗"口径一致），TOTAL ≥ OUT 恒成立，文案改为「累计 · 输出」
- **价格徽章颜色**：高峰时段徽章由琥珀色改为**红色**（贵 = 红），空闲时段保持**绿色**（便宜 = 绿），标准价保持中性灰——一眼可读

### 新增

- **一键卸载脚本**：随包附带 `scripts/uninstall.mjs`——刚发布的插件（不足约 24 小时）会被 DSH supply-chain 年龄校验拦住 `dsh plugin remove`，此脚本直接调用 pnpm 绕开该校验，并同步清理 `dsh.profile.bundles` 注册，一条命令完成卸载

### 文档

- 安装说明改用**精确版本号**（`dsh-token-panel@0.4.7`，发布新版本后同步更新）——`@latest` 在包龄不足 24 小时时会被 supply-chain 年龄校验干扰、可能解析回旧版；补充「装到旧版本」排查、`dsh` 命令找不到的解决方式、以及一键卸载的完整说明（安装/卸载流程均经手工实测）

## [0.4.6] - 2026-08-15

### 新增

- **长按菜单「隐藏 HUD」**：长按胶囊 / 面板头部弹出的位置菜单新增「隐藏 HUD」项，点击后整个面板（含胶囊）立即消失并记忆；恢复方式：DSH 设置里把 `hidden` 开关关掉（或改回 `false`）即可
- **DSH 设置开关**：设置页（插件 → token-panel）提供「隐藏」可视化开关，无需改配置文件

## [0.4.5] - 2026-08-15

### 新增

- **隐藏整个面板的开关**：新增 `hidden` 配置项（DSH 设置 / `cordis.patch.yml`），设为 `true` 后整个 HUD（含右下角胶囊）不再显示；改回 `false` 即恢复——不想看到面板时无需卸载插件

## [0.4.4] - 2026-08-15

### 修复

- **工具调用崩溃**（`Cannot read properties of undefined (reading 'prepare')`）：将 `@deepseek-ai/*`、`cordis`、`schemastery`、`react` 等从 `dependencies` 移入 `peerDependencies`，插件不再让 pnpm 安装第二份 DSH 内部代码——此前两份拷贝导致 `TOOL_RUNTIME_SCHEDULER`（Symbol）身份不一致，宿主每次工具调用都会报错

## [0.4.3] - 2026-08-15

### 新增

- **时间拖动条（实时）**：实时趋势曲线下方新增滑动条，向左拖动可回看历史缓冲区内更早时间段的曲线（窗口大小跟随 2m / 5m / 15m），峰值速率、最新值胶囊、悬浮气泡随窗口联动
- **时间拖动条（统计）**：按日 / 按月曲线下方新增滑动条，默认显示最近 14 天 / 6 个月，可滑动查看更早的日期段

### 修复

- **实时曲线时间刻度重叠**（2m / 5m / 15m）：数据有空闲缺口、时间分布不均时最后两个时间标签挤在一起；实时曲线改为按均匀时间位置布刻度

## [0.4.2] - 2026-08-15

### 变更

- 将 0.4.1 记录中的成本显示修复（`¥0.001` 小额显示、千分位分隔符）随本版**真正发布到 npm**——0.4.1 的 npm 包发布于这些修复之前
- README 安装说明补充：npm 安装无需构建；Git / 本地安装需 Node ≥ 22.5

## [0.4.1] - 2026-08-15

### 变更

- 发布流程启用 **Trusted Publisher（OpenID Connect）** 自动发布：从 `v*` 标签触发，带 **provenance 签名**，不再依赖本地 token

### 修复

- **小额花费显示 `¥0.1分` 的怪样子**：小于 0.01 元的金额改为显示 `¥0.001`（中英文一致），不再把 ¥ 符号和「分」单位混在一起
- **大金额可读性**：≥ ¥1 的金额增加千分位分隔符（如 `¥12,345.67`），精度保持到分；`¥0` 显示为 `¥0.00`

## [0.4.0] - 2026-08-15

### 新增

- **曲线悬停气泡（统计）**：按日 / 按月曲线上的数据点带小圆热区，鼠标悬停弹出该点 token 值气泡；当前日 / 月不弹泡（最新点已有浮动数值标签）
- **Steam 式跟随气泡（实时）**：鼠标移到实时趋势曲线上**任意位置**，气泡自动吸附最近采样点并跟随移动，显示该处 token 值，附淡色竖向引导线

### 变更

- **毛玻璃面板**：面板与收缩胶囊改为半透明磨砂玻璃（胶囊最透、面板次一档），浅色 / 深色主题统一；深色模式改用黑色投影、压暗边框并收敛辉光，去除浅色光晕
- 曲线下方渐变填充在深色模式下调暗（32% → 13%），曲线更"墨感"、不发光

### 修复

- **气泡数值白字看不见**：气泡文字颜色改用 `label-secondary`（原 `label-primary-foreground` 是蓝色胶囊上的白色前景，放在浅色气泡上不可见）
- **深色模式边缘过亮 / 面板发灰**：面板阴影由浅色 token 改为黑色投影、边框压暗、状态圆点辉光收敛、底板底色加深

## [0.3.0] - 2026-08-14

### 新增

- **按模型分别计价**：会话行、按日/按月统计按各会话实际使用的模型（v4-flash / v4-pro 等）套用对应价格表，切换过模型的会话不再整段按单一模型计价
- **auto 价格模式**：2026-08-17 零时（北京时间）前自动使用 flat 旧价，之后自动切换 DeepSeek 官方峰谷价（高峰 9-12 / 14-18），底部徽章同步显示「标准价 / 高峰价 / 空闲价」，无需手动改配置

### 变更

- 底部栏改为三列布局：状态 + 价格模式 ｜ 当前花费 ｜ 年月日 + 时间（重排 0.2.2 引入的「当前花费」）
- 统计视图排版精简：删除「汇总」「趋势」标题，累计消耗标签加大单行显示（0.2.2 排版重构的后续调整）
- 曲线 Y 轴重排：单位标签常驻、紧凑刻度（1B/500M）、当前值胶囊浮动在最新点旁，大数值不再重叠
- 统计与实时视图高度精确对齐；底部当前花费与统计口径统一

### 修复

- **预算进度条不可见**（0.2.2 引入的缺陷）：引用了不存在的主题 token（`state-success` 等），已替换为主题真实定义的带后缀变量，绿色进度/成本/徽章全部恢复显示
- **统计视图崩溃**（0.2.2 引入的缺陷）：React Hooks 顺序违规导致切换统计视图时面板消失
- **会话成本高估**：会话混用模型时整段按当前模型计价的问题（由按模型分别计价修复）
- 统计视图双层容器造成的多余空白与灰色滚动条条带（0.2.2 排版重构的遗留问题）

## [0.2.2] - 2026-08-14

### 新增

- **可编辑预算与余额**：统计视图点击数值行内编辑（回车保存 / Esc 取消），悬停气泡提示；余额按 token 消耗**本地估算递减**（累计基准法，刷新后保持），未设置时回退 API 余额
- **底部显示当前花费**：面板底部右侧统一显示累计估算花费
- **峰值读数**：实时趋势区显示窗口内峰值消耗速率（t/s）

### 变更

- **UI 排版重构**：分区小标题加大（13px）分隔「实时趋势 / 会话 / 汇总 / 趋势 / 按日」，大数字层级 + 分段控件，保留科技感（等宽字体/发光点缀）
- 会话列表默认只显示当前会话，展开才显示全部
- 按日 / 按月明细默认收起（0 行），点击展开全部

### 修复

- 移除统计视图旧的平铺布局与边框线（改留白分区）

## [0.2.1] - 2026-08-14

### 修复

- 会话行、账户余额悬停气泡全部改为自动消失样式（淡入约 1.5 秒后自动淡出，指针停留也不会一直显示），并移除浏览器原生 tooltip

## [0.2.0] - 2026-08-14

### 新增

- **会话花费显示**：实时视图每个会话行显示绿色 `¥` 估算花费，当前对话一眼可见
- **面板拖拽系统**：
  - 按住胶囊或面板头部栏拖动，位置跨刷新记忆
  - 允许把面板拖出屏幕边缘（上下左右），但始终保留一条可抓取的头部栏
  - 指针捕获 + 4px 阈值，快速拖拽不中断、单击不误触
- **长按位置菜单**（按住 0.6 秒）：
  - 回到默认位置（图标与文字随默认位置动态更新）
  - 「位置」二级菜单：**左上 / 右上 / 左下 / 右下**四角预设（按面板实际尺寸精确贴边）
  - **自定义位置**：选择后拖到任意位置松手即保存为默认，每次加载从那里出现
  - 菜单图标统一为 SVG 描边风格（与 DSH 设计语言一致）
- **Y 轴坐标**：所有曲线带纵坐标刻度与浅色网格线
- **自动缩放 Y 轴**：1/2/2.5/5×10ⁿ 取整 + 滞回（上升立即跟随、下降滞后），空闲时归零
- **当前值指示线**：曲线最新点带虚线引导线与实时数值胶囊标签
- **峰谷计价模式**：`priceMode: peak-offpeak` 按北京时间峰谷自动切换价格
- **TPS 显示**：胶囊与底部栏实时显示生成速度（t/s）
- **账户余额**：统计视图自动拉取 DeepSeek 余额（5 分钟缓存）
- **月预算**：`budgetMonthly` 配置后显示预算进度条，超支变红
- **历史会话持久化**：会话注册表落盘，重启后「展开全部」的历史会话不丢失

### 变更

- 点「✕」收起面板不再重置位置（原位置保持；归位走长按菜单）
- 统计视图「按日/按月」显示全部日期与月份

### 修复

- 曲线空闲时不再维持压力水平线，改为消耗增量（归零）
- 时间刻度不再被 SVG 边界裁切（自适应锚点 + 底部留白）
- 小数刻度保留一位（0.5 不再显示为 1）
- 统计视图切换即时刷新
- 拖拽与单击/长按手势冲突（单击打不开、拖后需点两次等）
- 预设角落偏上（改用实际尺寸计算）
- 拖出屏幕后无法抓回（把手保留可见）
- 单点打开面板（指针捕获时机修正）

## [0.1.0] - 2026-08-14

### 新增

- 初版发布：实时视图（会话压力/累计/详情/曲线）、统计视图（按日/按月/持久化日志）、DeepSeek 官方价成本估算、中英双语界面