0.4.1

feat: collapse and close the card, rendered by one component and one …

v0.3.2

修复

• 轮换凭据不再与落盘竞态：写入后只标记过期（stale: true，期间继续展示上一次的数字），由下一个轮询周期重扫。此前会在同一 tick 内重扫，请求带着旧值发出并返回 auth-failed，看起来像新 token 无效
• invalidate() 不再清空缓存：重扫未必能复现更早的月份，清空会让卡片无故退回本地口径
• createPlatformHistory 支持注入 fetchImpl，测试不再可能触达真实网络

改进

• --check-only 新增 stored token 遮蔽指纹，轮换前后可直接对比确认新值生效
• 探测脚本优先测试插件实际使用的那份凭据（refs:DEEPSEEK_USER_TOKEN）并打印其指纹；此前它不测这一份，导致"轮换是否成功"恰好无法回答
• platform.history 新增 stale 与 invalidations 诊断字段

文档

• 排障笔记扩到十个坑（新增第 10 条：写入后立刻重扫的竞态）

测试 56 个用例。

v0.3.1

新增

• 用量口径可切换：¥ 计费 token（默认，不含缓存读取）/ Σ token 总量（含缓存读取）；今日 / 本月 / 累计三行永远同口径
• 「累计消费 / 累计用量」：可选读取开放平台账号历史（platformHistory），逐月扫描 + 10 分钟缓存 + 落盘
• tools/set-platform-token.mjs：支持 --from-file（最可靠）/ --prompt / 环境变量三种写入方式
• tools/probe-platform-usage.mjs：控制台接口诊断

修复

• billed 改为按类型累加，不再用减法（减法会吞掉 PROMPT_TOKEN 桶）
• 旧 schema 的缓存 payload 会被拒收并重扫，不再把原始总和当计费量显示
• 扫描失败记成具名原因（auth-failed / http-429 / failed:2026-07:TimeoutError）
• token 写入前校验长度与字符集，拒绝 PASTE、整条命令行、被截断的粘贴

文档

• 新增「排障笔记：这个接口真实存在的九个坑」——控制台接口只认会话 token、两个端点 biz_data 形状不同、Read-Host -AsSecureString 会把粘贴截成 1 字符等

测试 55 个用例。

v0.3.0

新增

• 「累计消费 / 累计用量」两行：可选读取开放平台账号历史（platformHistory，默认关闭）
• 逐月扫描历史（最多 48 个月，连续 3 个空月自动停止）、10 分钟缓存 + 落盘，重启后立即可见
• tools/probe-platform-usage.mjs：控制台接口诊断（只打印结构，不打印凭据）
• tools/set-platform-token.mjs：把控制台 token 存入 DSH 凭据服务；--check-only 查看扫描状态
• POST /quota-card/token：唯一写入路由，回环 + 非跨站校验，仅回显遮蔽片段

修复

• 历史扫描不再把空白月计入覆盖区间
• 全空账号不再扫满上限，并给出明确的 all-empty 状态

说明

• 该历史来自 platform.deepseek.com/api/v0/usage/*（未公开接口）。失效或未配置凭据时静默退回本地账本口径，余额/今日/本月/峰谷判定不受影响
• 测试增至 50 个用例

开启方式见 README（需要控制台 token）。

dsh-quota-card v0.2.0

Add dsh-quota-card: sidebar quota card for DeepSeek Harness