@angelyeye/dsh-cost-tracker 1.8.4 → 1.8.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,6 +2,47 @@
2
2
 
3
3
  本文件用中文记录 dsh-cost-tracker 的版本变更。
4
4
 
5
+ ## v1.8.6(2026-09-15)
6
+
7
+ **修复:计费规则与 DeepSeek 官方定价的两处口径偏差(金额口径 + 标记口径)**
8
+
9
+ 核查基准:官方价格卡 <https://api-docs.deepseek.com/zh-cn/quick_start/pricing> 与发布通告 <https://api-docs.deepseek.com/zh-cn/news/news260910>。核查方法:用独立脚本按官方牌价重算全部已入库记录,与插件记账逐条比对(1985 条记录金额差额 `0.000000`,说明**数值本来就是对的一分不差**;以下两处修复的是口径与标记)。
10
+
11
+ - **V4-Pro 路由生效时刻提前了 4 天(金额口径,会低估花费)**
12
+ - 旧实现把 `deepseek-v4-pro → V4.1 Flash` 的路由与 Flash 调价合并成同一时刻(北京时间 2026-09-10 12:00),但官方通告的措辞是:「北京时间 **2026 年 9 月 14 日 12:00** 之后……用户访问 `deepseek-v4-pro` 的请求将全部路由到 V4.1 Flash,并按 V4.1 Flash 单价计费」(价格卡脚注 (2) 同口径)。
13
+ - 影响:2026-09-10 12:00 ~ 09-14 12:00 之间的 V4-Pro 调用会被**低估约 4.5 倍**(9/27/0.30 → 2/8/0.04)。本机记录该窗口内无 V4-Pro 调用,故无历史金额损失,但属潜伏缺陷。
14
+ - 修法:新增 `V41_PRO_ROUTE_AT`(`2026-09-14T04:00:00Z`)与时代 `v41pro`,把路由从 `v41` 拆出来;`v41` 时代保留 V4-Pro 自有牌价(9/27/0.30),避免这 4 天落入 provider 兜底而被误标「估算」。
15
+
16
+ - **官方现役模型名 `deepseek-flash` 不在精确单价表内(标记口径,已在真实数据中触发)**
17
+ - 官方脚注 (1):「模型名请使用 `deepseek-flash`」。旧实现的规范名是 `deepseek-v4.1-flash`(官方文档中并不可调用的写法),于是宿主实际上报的 `deepseek-flash` 落入 provider 兜底分支——**金额恰好相同,但被标记为「估算」**。本机 1402 条 `deepseek-flash` 记录 100% 命中该问题,云端 `cost_basis` 也随之为 `estimated`,污染「估算占比 / 口径漂移」统计。
18
+ - 修法:`V41_FLASH_MODEL` 改为 `deepseek-flash`(官方现役名),并新增 `MODEL_ALIASES` 别名归一表,使 `deepseek-v4.1-flash` / `deepseek-v4-1-flash` / `deepseek-v41-flash` / `deepseek_flash` 等等价写法解析到同一规范名(单价表本身不重复列项)。路由目标与入账名统一为 `deepseek-flash`。
19
+
20
+ **修复:`cost_recompute` 不再漏判「仅标记变化」的记录**
21
+ - 变更判定此前只看费用 / 模型名 / 档位,于是「模型名从兜底升为精确档、金额分毫不变」的记录不会被订正。现纳入 `estimated` / `subscription` 标记比对,返回值新增 `estimatedFlips` 计数,工具输出会明确写出「其中 N 条仅订正『估算』标记,金额不变」,避免补账看起来「改了 0 条」。
22
+
23
+ **变更**
24
+ - `export const V41_FLASH_MODEL = 'deepseek-flash'`(原 `'deepseek-v4.1-flash'`);新增导出 `V41_PRO_ROUTE_AT` / `MODEL_ALIASES`。
25
+ - `PRICE_ERAS` 由 2 版增至 3 版:`legacy` / `v41`(09-10 12:00 起,含 V4-Pro 自有牌价)/ `v41pro`(09-14 12:00 起,含 V4-Pro 路由);`v41` 时代新增 `proRouteSince` 说明字段。
26
+ - `cost_prices` 的 `eras` / 渲染文本同步展示 V4-Pro 路由时刻与官方现役名口径。
27
+
28
+ **测试**
29
+ - `test/pricing.test.js`:新增 V4-Pro 路由时刻边界用例(`12:00:00.000` 前一毫秒仍按自有牌价、整点起路由)、`deepseek-flash` 精确命中与别名归一用例。
30
+ - `test/recompute.test.js`:补账样本改为覆盖「路由前窗口金额不变」「路由后改写为 `deepseek-flash`」「误标估算记录被订正」三类,新增 `estimatedFlips` 断言。
31
+
32
+ **计费影响**
33
+ - **已入库记录金额零变化**(数值本即正确);仅 `estimated` 标记、V4-Pro 在 9/10–9/14 窗口的口径、以及历史 `deepseek-v4.1-flash` 记录(本机 22 条)与 `deepseek-flash` 的桶名归并发生变化。
34
+ - 涉及历史桶名/标记的机器建议执行一次 `cost_recompute`(默认试算,`apply: true` 落盘),幂等可重复执行。
35
+
36
+ ## v1.8.5(2026-09-15)
37
+
38
+ **修复**
39
+ - **v1.8.4 的自动回填会中途短路,只补一批就宣告完成**:`runOnce` 推进游标时采信的是**服务端返回的水位**,而服务端 `/api/v1/ingest/records` 回的是它库里该设备明细的 `MAX(client_seq)` —— **整体最大值**,含更早已上传、序号更高的记录,不是"本批"的最大值。于是在**它本来要修的那个场景**里(本机缺 1..723、云端已有 724..1457):第一轮补发 1..500 后服务端回 `maxClientSeq=1457`,游标一步跨到顶,下一批为空,`break` —— 501..723 照样补不回来。现改为游标只推进到**本批实际送达**的 `maxClientSeq`,多轮循环才能真正逐段覆盖全部历史。实测现场:17:16 那次回填只发出 1 批 500 条,预期的 3 批只完成 1 批。
40
+ - **回填算法加版本号**:状态文件新增 `backfillVer`。v1.8.4 已经跑过(有缺陷的)回填的部署,`legacySent` 已是 `true` 而缺口仍在,靠布尔量无法区分"补过且补全"与"补过但短路"。现在低于当前算法版本(2)的部署会**再补跑一次**;`cost_sync action=now full=true` 同样会强制重新回填一轮。
41
+
42
+ **测试**
43
+ - `test/sync.test.js` 新增 8d 组:复现「服务端水位 = 整体最大值 + 云端只有最新的 500 条」这一真实故障现场,断言一轮同步必须把 1..1200 全部送达、云端不留空洞、版本号落盘。**该组在 v1.8.4 代码上报 5 条红**(只发出第一批、留下 650 个空洞),修复后全绿。
44
+ - 断言回填成功后必须落 `backfillVer=2`,中途失败时不得落(否则缺口会被永久放过)。全量 `npm test` 通过;无数据迁移、无破坏性变更。
45
+
5
46
  ## v1.8.4(2026-09-15)
6
47
 
7
48
  **修复**
package/README.en.md CHANGED
@@ -29,10 +29,11 @@
29
29
  | | Feature | Description |
30
30
  | --- | --- | --- |
31
31
  | 💰 | **Cost tracking** | Every API call is recorded automatically: input / output / cache-hit / cache-write tokens and cost (cache write billed at the cache-hit price), aggregated by day and by model |
32
- | ⏰ | **Peak/off-peak pricing** | Built-in price table; peak windows (Mon–Fri 9:00–12:00, 14:00–18:00 Beijing time) vs half-price off-peak handled automatically; **weekends are fully off-peak**; local models (e.g. ollama) count as 0; the table is **versioned by pricing era** and switches automatically to V4.1 Flash rates at 2026-09-10 12:00 Beijing time (peak 2.0 / 0.04 / 8.0), routing V4-Pro and the legacy V4-Flash family to V4.1 Flash billing per the official rules |
32
+ | ⏰ | **Peak/off-peak pricing** | Built-in price table; peak windows (Mon–Fri 9:00–12:00, 14:00–18:00 Beijing time) vs half-price off-peak handled automatically; **weekends are fully off-peak**; local models (e.g. ollama) count as 0; the table is **versioned by pricing era** and switches automatically to V4.1 Flash rates at 2026-09-10 12:00 Beijing time (peak 2.0 / 0.04 / 8.0), routing the legacy V4-Flash family to V4.1 Flash billing per the official rules; **V4-Pro is routed from 2026-09-14 12:00 only** (before that it keeps its own rates 9.0 / 27.0 / 0.30) |
33
33
  | 🔔 | **Peak-price notice** | A "Peak/off-peak pricing & notice" panel in Settings: current tier + countdown strip, style switch (**compact single-row · 24h-proportional** / **ring dial · phase dot**), an optional **two-row compact** stacked layout for the compact style (bar-above-text / text-above-bar), a "Show time" toggle, popup alert + browser notification before a tier switch, lead time, popup position (bottom-right/center), alert type; a persistent strip in the sidebar footer (adapts to rail/collapsed). Mirrors `dsh-cost-meter` |
34
34
  | 📌 | **Six overview cards** | Six cards at the top of Settings: Today / This month / Total spend / API requests / Tokens / **Account balance**. The three spend cards **exclude subscription equivalent cost** (shown as an annotation instead) |
35
- | 👁️ | **Vision model** | Supports `deepseek-v4-flash-vision-exp`: priced as flash in the legacy era, billed at V4.1 Flash rates from 2026-09-10 12:00; images are converted to tokens per the official rule (≤384 tokens each, billed per API usage) |
35
+ | 👁️ | **Vision model** | Supports `deepseek-v4-flash-vision-exp`: priced as flash in the legacy era, billed at V4.1 Flash rates from 2026-09-10 12:00 (that legacy id is retired; requests are served by V4.1 Flash); images are converted to tokens per the official rule (≤384 tokens each, billed per API usage) |
36
+ | 🏷️ | **Official model-name alignment** | Billing recognises the official current name **`deepseek-flash`** (price-card note (1): "use the model name `deepseek-flash`"); older spellings such as `deepseek-v4.1-flash` normalize to the same rate, so an official rename can never silently drop usage into the fallback estimate |
36
37
  | 📊 | **Visual dashboard** | A new "Cost Statistics" page in Settings: overview cards, cost bar charts (by peak period / by model), per-model request & token charts — **all with hover tooltips** |
37
38
  | 📈 | **Subscription quota** | Kimi Coding Plan and similar subscriptions: weekly quota, 5-hour rolling window limit, pay-as-you-go-equivalent cost for reference |
38
39
  | 💳 | **Balance lookup** | One-click DeepSeek account balance (total / topped-up / granted / status) |
@@ -236,6 +237,15 @@ Example: `curl -X POST http://127.0.0.1:3080/api/cost-tracker/summary -d '{}'`
236
237
 
237
238
  ## Changelog
238
239
 
240
+ ### v1.8.6 (2026-09-15)
241
+
242
+ **Fixed: two basis mismatches against DeepSeek's official pricing** (checked against the official [price card](https://api-docs.deepseek.com/zh-cn/quick_start/pricing) and the [V4.1 Flash announcement](https://api-docs.deepseek.com/zh-cn/news/news260910))
243
+
244
+ - **The V4-Pro routing date was 4 days early (understated spend)**: the old code merged `deepseek-v4-pro → V4.1 Flash` routing with the Flash price change (09-10 12:00), but the official wording is "after **2026-09-14 12:00 Beijing time**". V4-Pro calls in that 4-day window were understated by roughly 4.5×. The eras are now split with `v41pro` (`V41_PRO_ROUTE_AT = 2026-09-14T04:00:00Z`), and era `v41` keeps V4-Pro's own rates (9 / 27 / 0.30).
245
+ - **The official current model name `deepseek-flash` was missing from the exact table (records mislabelled "estimated")**: the official docs say "use the model name `deepseek-flash`", while the code used the non-callable `deepseek-v4.1-flash` as its canonical name — so the real name fell through to the provider fallback. The amount was exactly right, but every record was flagged `estimated: true` (1402 local records affected). `deepseek-flash` is now canonical, with an alias table (`MODEL_ALIASES`) mapping equivalent spellings.
246
+ - **`cost_recompute` no longer skips "flag-only" changes**: it now reports `estimatedFlips` and states explicitly that N records only had their "estimated" flag corrected with no amount change.
247
+ - **Stored amounts do not change**: only the `estimated` flag, the V4-Pro basis inside the 09-10…09-14 window, and the bucket merge of historical `deepseek-v4.1-flash` records (22 locally) into `deepseek-flash`. Running `cost_recompute` once is recommended (dry-run by default, `apply: true` to persist).
248
+
239
249
  ### v1.6.0 (2026-09-10)
240
250
 
241
251
  **Added**
package/README.md CHANGED
@@ -29,10 +29,11 @@
29
29
  | | 功能 | 说明 |
30
30
  | --- | --- | --- |
31
31
  | 💰 | **花费统计** | 每一次 API 调用自动记账:输入 / 输出 / 缓存命中 / 缓存写入 Tokens 与费用(缓存写入按缓存命中价计),按天、按模型聚合 |
32
- | ⏰ | **峰谷定价** | 内置单价表,高峰时段(北京时间周一至周五 9:00–12:00、14:00–18:00)与闲时半价自动区分,**周末全天计为闲时**,本地模型(ollama 等)计 0;**单价表按「计费时代」分版**,北京时间 2026-09-10 12:00 起自动切换为 V4.1 Flash 新价(2.0 / 0.04 / 8.0 高峰),并按官方规则把 V4-Pro 与旧 V4-Flash 系请求路由到 V4.1 Flash 计费 |
32
+ | ⏰ | **峰谷定价** | 内置单价表,高峰时段(北京时间周一至周五 9:00–12:00、14:00–18:00)与闲时半价自动区分,**周末全天计为闲时**,本地模型(ollama 等)计 0;**单价表按「计费时代」分版**,北京时间 2026-09-10 12:00 起自动切换为 V4.1 Flash 新价(2.0 / 0.04 / 8.0 高峰),并按官方规则把旧 V4-Flash 系请求路由到 V4.1 Flash 计费;**V4-Pro 自 2026-09-14 12:00 起才路由**(此前仍按自有牌价 9.0 / 27.0 / 0.30) |
33
33
  | 🔔 | **峰谷计价提示** | 设置页「峰谷计价与提示」面板:当前档位/距下次切换倒计时时段条、样式切换(**简洁单行·按24h比例** / **环形表盘·相位色点**)、简洁样式可选**双行紧凑**(上下布局,条上文下/文上条下)、「显示时间」开关、峰/谷切换前弹窗提醒与浏览器系统通知、提前提醒分钟、弹窗位置(右下角/屏幕中心)、提醒类型;侧边栏底部常驻显示时段条(窄栏/展开自适应)。对齐 `dsh-cost-meter` 交互 |
34
34
  | 📌 | **六组概览卡** | 设置页顶部六张卡:今日费用 / 本月费用 / 总花费 / API 请求次数 / Tokens / **总余额**。前三个金额卡**不含订阅会员等效费用**,订阅以附注展示 |
35
- | 👁️ | **视觉模型** | 支持 `deepseek-v4-flash-vision-exp`:legacy 时代单价与 flash 一致,2026-09-10 12:00 起随 V4.1 Flash 新价计费;图片按官方规则换算 token(每张上限 384 个,以接口用量计费) |
35
+ | 👁️ | **视觉模型** | 支持 `deepseek-v4-flash-vision-exp`:legacy 时代单价与 flash 一致,2026-09-10 12:00 起随 V4.1 Flash 新价计费(该旧名已下线,请求由 V4.1 Flash 提供);图片按官方规则换算 token(每张上限 384 个,以接口用量计费) |
36
+ | 🏷️ | **官方模型名对齐** | 计费支持**官方现役名 `deepseek-flash`**(价格卡脚注 (1):「模型名请使用 `deepseek-flash`」),旧写法 `deepseek-v4.1-flash` 等归一化后命中同一档价,避免因官方改名而落入兜底估算 |
36
37
  | 📊 | **可视化仪表盘** | 设置页新增「花费统计」:概览卡片、消费柱状图(按峰谷/按模型)、分模型的请求次数与 Tokens 图表,**全部支持鼠标悬停查看明细** |
37
38
  | 🔥 | **用量热力图** | 设置页新增「Token 用量统计」:类 Codex 的 **26 周日用量方格热图**,按天着色(输入 / 缓存 / 输出 / 费用),悬停看当日明细、今天高亮描边,顶部显示全时段累计 |
38
39
  | 📈 | **订阅配额监控** | Kimi Coding Plan 等订阅套餐:本周配额、5 小时滚动窗口限额、等效按量费用参考 |
@@ -237,6 +238,15 @@ POST /api/cost-tracker/export 导出 CSV
237
238
 
238
239
  ## 更新记录
239
240
 
241
+ ### v1.8.6(2026-09-15)
242
+
243
+ **修复:计费规则与官方定价的两处口径偏差**(核查基准:官方[价格卡](https://api-docs.deepseek.com/zh-cn/quick_start/pricing) + [V4.1 Flash 发布通告](https://api-docs.deepseek.com/zh-cn/news/news260910))
244
+
245
+ - **V4-Pro 路由时刻提前了 4 天(会低估花费)**:旧实现把 `deepseek-v4-pro → V4.1 Flash` 的路由与 Flash 调价合并为同一时刻(09-10 12:00),而官方口径是「北京时间 **2026-09-14 12:00** 之后」才路由。这 4 天内的 V4-Pro 调用会被低估约 4.5 倍。现拆出时代 `v41pro`(`V41_PRO_ROUTE_AT = 2026-09-14T04:00:00Z`),`v41` 时代保留 V4-Pro 自有牌价 9/27/0.30。
246
+ - **官方现役名 `deepseek-flash` 未进精确表(会被误标「估算」)**:官方要求使用 `deepseek-flash`,旧代码的规范名却是不可调用的 `deepseek-v4.1-flash`,导致现役名走 provider 兜底——金额分毫不差,但记录被标 `estimated: true`(本机 1402 条全部中招)。现以 `deepseek-flash` 为规范名,并加别名归一表(`MODEL_ALIASES`)。
247
+ - **`cost_recompute` 不再漏判「仅标记变化」**:返回值新增 `estimatedFlips`,输出会写明「其中 N 条仅订正『估算』标记,金额不变」。
248
+ - **已入库记录金额零变化**:仅 `estimated` 标记、V4-Pro 在 09-10~09-14 的口径、以及历史 `deepseek-v4.1-flash` 记录(22 条)与 `deepseek-flash` 的桶名归并变化;建议执行一次 `cost_recompute`(默认试算,`apply: true` 落盘)。
249
+
240
250
  ### v1.6.0(2026-09-10)
241
251
 
242
252
  **新增**
package/index.js CHANGED
@@ -10,7 +10,7 @@ import { readFileSync, writeFileSync, mkdirSync, renameSync, existsSync, realpat
10
10
  import { join, dirname } from 'node:path'
11
11
  import { homedir } from 'node:os'
12
12
  import { createStore, collectTotals, DETAIL_DAYS, MAX_AXIS_DAYS } from './store.js'
13
- import { PRICE_ERAS, V41_EFFECTIVE_AT, exactModelsAt, eraAt, SUBSCRIPTION_RATES, PROVIDER_RATES, GENERIC_RATES, PEAK_WINDOWS, PEAK_HOUR_WINDOWS, isPeak, peakPhaseAt, priceFor, computeCost, normalizeTokens } from './pricing.js'
13
+ import { PRICE_ERAS, V41_EFFECTIVE_AT, V41_PRO_ROUTE_AT, exactModelsAt, eraAt, SUBSCRIPTION_RATES, PROVIDER_RATES, GENERIC_RATES, PEAK_WINDOWS, PEAK_HOUR_WINDOWS, isPeak, peakPhaseAt, priceFor, computeCost, normalizeTokens } from './pricing.js'
14
14
  import {
15
15
  normalizePeakConfig, defaultPeakConfig, peakEffective,
16
16
  normalizeCloudConfig, defaultCloudConfig, normalizePluginConfig,
@@ -19,7 +19,7 @@ import { createSyncEngine, setPluginVersion, SOURCE as SYNC_SOURCE, SYNC_VERSION
19
19
  import { Schema } from './schema.js'
20
20
 
21
21
  /** 插件版本(写入上报信封,便于云端排查版本差异) */
22
- const PLUGIN_VERSION = '1.8.4'
22
+ const PLUGIN_VERSION = '1.8.6'
23
23
  setPluginVersion(PLUGIN_VERSION)
24
24
 
25
25
  /** 「设置 → 插件 → 插件配置」里的卡片字段(与 settings 命名空间一致) */
@@ -105,8 +105,9 @@ export default {
105
105
  // ---------- price tables (CNY per 1M tokens) ----------
106
106
  // 单价表 / 峰谷 / 费用计算集中在 pricing.js(纯模块,可独立测试);
107
107
  // 单价按「计费时代」分版(PRICE_ERAS):按记录时间戳选版,故历史记录口径不变。
108
- // V4.1 Flash 价(北京时间 2026-09-10 12:00 起)生效后,V4-Pro 与旧 V4-Flash 系
109
- // 的请求按官方规则路由到 V4.1 Flash 计费,记录亦以 V4.1 Flash 模型名入账。
108
+ // V4.1 Flash 价(北京时间 2026-09-10 12:00 起)生效后,旧 V4-Flash 系的请求路由到
109
+ // V4.1 Flash 计费;V4-Pro 自北京时间 2026-09-14 12:00 起才路由(官方通告口径)。
110
+ // 记录一律以官方现役模型名 `deepseek-flash` 入账。
110
111
  // 视觉模型 deepseek-v4-flash-vision-exp 的图片 token 由接口 usage 计入 inputTokens
111
112
 
112
113
  // ---------- state ----------
@@ -286,7 +287,7 @@ export default {
286
287
  const model = toStr(options && options.model)
287
288
  if (!provider && !model) return
288
289
  const np = normProvider(provider)
289
- // 按「调用发生的时刻」选单价版本(跨 2026-09-10 12:00 自动切换,无需重启)。
290
+ // 按「调用发生的时刻」选单价版本(跨 2026-09-10 12:00 / 2026-09-14 12:00 自动切换,无需重启)。
290
291
  const price = priceFor(np, model, ts)
291
292
  // 峰谷计费开关:随配置峰谷启用 + 生效时间门控;未启用时按非峰谷档(平价)计费。
292
293
  const peak = peakEffective(peakConfig, ts) ? isPeak(ts) : false
@@ -294,8 +295,8 @@ export default {
294
295
  // prompt_tokens 中(每张≤384 tokens),由 normalizeTokens 归入 input
295
296
  const tokens = normalizeTokens(usage)
296
297
  store.add({
297
- // 被路由的请求以「实际计费模型名」入账(如 V4-Pro → deepseek-v4.1-flash),
298
- // 使按模型聚合看到的就是真实计费口径。
298
+ // 被路由的请求以「实际计费模型规范名」入账(如 V4-Pro → deepseek-flash、
299
+ // 旧名 deepseek-v4-flash → deepseek-flash),使按模型聚合看到的就是真实计费口径。
299
300
  ts, provider, model: price.model || model,
300
301
  sessionId: toStr(options && options.sessionId),
301
302
  purpose: toStr(options && options.purpose),
@@ -536,6 +537,7 @@ export default {
536
537
  // 全部价格时代(含生效时刻与路由规则),供工具/接口展示
537
538
  eras: PRICE_ERAS.map((e) => ({ id: e.id, label: e.label, since: e.since, models: e.models, routes: e.routes || {} })),
538
539
  v41EffectiveAt: V41_EFFECTIVE_AT,
540
+ v41ProRouteAt: V41_PRO_ROUTE_AT,
539
541
  subscription: SUBSCRIPTION_RATES,
540
542
  providers: PROVIDER_RATES,
541
543
  generic: GENERIC_RATES,
@@ -780,7 +782,7 @@ export default {
780
782
  else if (Number.isFinite(a.since) && a.since > 0) since = a.since
781
783
  const apply = a.apply === true
782
784
  const byModel = {}
783
- let scanned = 0, changed = 0, oldCost = 0, newCost = 0
785
+ let scanned = 0, changed = 0, oldCost = 0, newCost = 0, estimatedFlips = 0
784
786
  for (const r of records) {
785
787
  if (!(r.ts >= since)) continue
786
788
  scanned += 1
@@ -790,27 +792,34 @@ export default {
790
792
  const cost = computeCost(price.rates, price.tiered, peak, r.tokens)
791
793
  const model = price.model || r.model
792
794
  const period = price.tiered ? (peak ? 'peak' : 'off-peak') : 'flat'
795
+ const estimated = price.estimated === true
796
+ const subscription = price.subscription === true
793
797
  oldCost += r.cost
794
798
  newCost += cost
795
- if (!(Math.abs(cost - r.cost) > 1e-9 || model !== r.model || period !== r.period)) continue
799
+ // 变更判定含 estimated/subscription:模型名从兜底口径升为精确档时,
800
+ // 金额可能分毫不变,但「估算」标记必须一并订正(否则看板长期误报估算占比)。
801
+ const flip = (r.estimated === true) !== estimated || (r.subscription === true) !== subscription
802
+ if (!(Math.abs(cost - r.cost) > 1e-9 || model !== r.model || period !== r.period || flip)) continue
796
803
  changed += 1
804
+ if (flip) estimatedFlips += 1
797
805
  const key = r.provider + '|' + r.model + '|' + model
798
- const m = byModel[key] || (byModel[key] = { provider: r.provider, from: r.model, to: model, calls: 0, oldCost: 0, newCost: 0 })
806
+ const m = byModel[key] || (byModel[key] = { provider: r.provider, from: r.model, to: model, calls: 0, oldCost: 0, newCost: 0, flips: 0 })
799
807
  m.calls += 1
800
808
  m.oldCost += r.cost
801
809
  m.newCost += cost
810
+ if (flip) m.flips += 1
802
811
  if (apply) {
803
812
  r.cost = cost
804
813
  r.model = model
805
814
  r.period = period
806
- r.estimated = price.estimated
807
- r.subscription = price.subscription
815
+ r.estimated = estimated
816
+ r.subscription = subscription
808
817
  }
809
818
  }
810
819
  if (apply && changed > 0) persistNow()
811
820
  const rows = Object.keys(byModel).map(k => {
812
821
  const m = byModel[k]
813
- return { provider: m.provider, from: m.from, to: m.to, calls: m.calls, oldCost: r4(m.oldCost), newCost: r4(m.newCost), delta: r4(m.newCost - m.oldCost) }
822
+ return { provider: m.provider, from: m.from, to: m.to, calls: m.calls, oldCost: r4(m.oldCost), newCost: r4(m.newCost), delta: r4(m.newCost - m.oldCost), estimatedFlips: m.flips }
814
823
  }).sort((x, y) => Math.abs(y.delta) - Math.abs(x.delta))
815
824
  return {
816
825
  ok: true,
@@ -819,11 +828,16 @@ export default {
819
828
  era: eraAt(since).id,
820
829
  scanned,
821
830
  changed,
831
+ estimatedFlips,
822
832
  oldCost: r4(oldCost),
823
833
  newCost: r4(newCost),
824
834
  delta: r4(newCost - oldCost),
825
835
  byModel: rows,
826
- note: changed === 0 ? '没有需要重算的记录' : (apply ? '已重算并落盘' : '试算结果,未落盘(传 apply: true 生效)'),
836
+ note: changed === 0
837
+ ? '没有需要重算的记录'
838
+ : (apply
839
+ ? '已重算并落盘' + (estimatedFlips ? '(其中 ' + estimatedFlips + ' 条仅订正「估算」标记,金额不变)' : '')
840
+ : '试算结果,未落盘(传 apply: true 生效)'),
827
841
  }
828
842
  }
829
843
 
@@ -1115,6 +1129,8 @@ export default {
1115
1129
  }
1116
1130
  }
1117
1131
  lines.push('', '当前生效:' + v.eraLabel + '(era=' + v.era + ')')
1132
+ lines.push('模型名口径:官方现役名为 deepseek-flash(被路由的请求一律以此名入账);deepseek-v4.1-flash 等写法归一化后命中同一档。')
1133
+ lines.push('V4-Pro 路由生效:' + when(v.v41ProRouteAt) + '(此前 deepseek-v4-pro 仍按 V4-Pro 自有牌价计费)。')
1118
1134
  lines.push('视觉模型 deepseek-v4-flash-vision-exp:图片按官方规则换算 token(每张上限 384),以接口用量计费(已含在 inputTokens 内)。')
1119
1135
  lines.push('kimi-coding(订阅等效,估算):输入 6.5 / 缓存命中(含缓存写入)1.1 / 输出 27.0')
1120
1136
  lines.push('缓存写入(cache write)按缓存命中价计费,与官方规则一致。其他 provider 兜底为估算平价(openai 10/30/5,anthropic 15/75/1.5,gemini 2.5/10/0.625,未知 2/8/0.5);ollama/local 为 0。')
@@ -1156,11 +1172,11 @@ export default {
1156
1172
  const when = new Date(v.since + 28800000).toISOString().replace('T', ' ').slice(0, 16).replace(/-/g, '/')
1157
1173
  const lines = [
1158
1174
  '费用重算(自 ' + when + ' 北京起 · era=' + v.era + ')',
1159
- '扫描 ' + v.scanned + ' 条,需修正 ' + v.changed + ' 条',
1175
+ '扫描 ' + v.scanned + ' 条,需修正 ' + v.changed + ' 条' + (v.estimatedFlips ? '(其中 ' + v.estimatedFlips + ' 条仅订正「估算」标记,金额不变)' : ''),
1160
1176
  '合计:¥' + v.oldCost + ' → ¥' + v.newCost + '(' + (v.delta >= 0 ? '+' : '') + v.delta + ')',
1161
1177
  ]
1162
1178
  for (const m of (v.byModel || []).slice(0, 8)) {
1163
- lines.push(' ' + m.from + (m.to !== m.from ? ' → ' + m.to : '') + ':' + m.calls + ' 次 · ¥' + m.oldCost + ' → ¥' + m.newCost)
1179
+ lines.push(' ' + m.from + (m.to !== m.from ? ' → ' + m.to : '') + ':' + m.calls + ' 次 · ¥' + m.oldCost + ' → ¥' + m.newCost + (m.estimatedFlips ? ' · 标记订正 ' + m.estimatedFlips + ' 条' : ''))
1164
1180
  }
1165
1181
  lines.push(v.note)
1166
1182
  return [{ type: 'text', text: lines.join('\n') }]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@angelyeye/dsh-cost-tracker",
3
- "version": "1.8.4",
3
+ "version": "1.8.6",
4
4
  "description": "DeepSeek Harness (DSH) plugin: LLM token usage & cost tracking with a settings dashboard, agent tools, HTTP API, persistent storage and multi-device cloud sync.",
5
5
  "type": "module",
6
6
  "main": "index.js",
package/pricing.js CHANGED
@@ -7,10 +7,16 @@
7
7
  // 空闲时段 = 高峰 × 0.5。周末(周六/周日)全天计入空闲时段(该窗口两版价通用)。
8
8
  // - **单价随时间调整**:故单价表按生效时刻分版(见 PRICE_ERAS),按记录时间戳选版。
9
9
  // · legacy :V4-Flash 3.0/9.0/0.10、V4-Pro 9.0/27.0/0.30
10
- // · v41 :V4.1 Flash 2.0/8.0/0.04(北京时间 2026-09-10 12:00 起生效),
11
- // V4-Pro 与旧 V4-Flash 系(含 vision-exp)的请求全部路由到
12
- // V4.1 Flash 并按 V4.1 Flash 单价计费(V4.1 Pro 上线前)。
10
+ // · v41 :V4.1 Flash 2.0/8.0/0.04(北京时间 2026-09-10 12:00 起生效)。
11
+ // 官方现役模型名为 `deepseek-flash`;旧名 `deepseek-v4-flash` 与
12
+ // `deepseek-v4-flash-vision-exp` 已下线但仍可调用,请求由 V4.1 Flash
13
+ // 提供服务并按 Flash 价计费,故一并路由到 `deepseek-flash`。
14
+ // · v41pro :同一档单价,**V4-Pro 路由在此才开始**:官方通告为「北京时间 2026-09-14
15
+ // 12:00 之后,deepseek-v4-pro 的请求全部路由到 V4.1 Flash 并按 V4.1 Flash
16
+ // 单价计费」(价格卡脚注 (2) 同口径)。9/10 12:00 ~ 9/14 12:00 之间的
17
+ // V4-Pro 请求按 V4-Pro 自有牌价 9.0/27.0/0.30 计费,不可提前折算。
13
18
  // - deepseek-v4-flash-vision-exp 与 deepseek-v4-flash 在 legacy 时代单价一致。
19
+ // - 模型名归一化后 `deepseek-v4.1-flash` 等同为 `deepseek-flash` 的等价写法,命中同一档。
14
20
  //
15
21
  // 视觉模型 Token 规则:
16
22
  // https://api-docs.deepseek.com/zh-cn/guides/vision#token-usage
@@ -30,14 +36,27 @@
30
36
  * 均为「高峰时段」价;空闲时段 = 高峰 × 0.5(两版价格的空闲档都恰好是半价)。
31
37
  *
32
38
  * routes:某个时代内把指定模型名的请求**改按另一档单价计费**,记录也以被路由
33
- * 到的模型名入账,便于按模型聚合时看到真实计费口径。
39
+ * 到的**计费模型规范名**(当前为官方现役名 `deepseek-flash`)入账,
40
+ * 便于按模型聚合时看到真实计费口径。
34
41
  */
35
42
 
36
43
  /** V4.1 Flash 价格的生效时刻:北京时间 2026-09-10 12:00(UTC+8)= 2026-09-10T04:00:00Z */
37
44
  export const V41_EFFECTIVE_AT = Date.UTC(2026, 8, 10, 4, 0, 0)
38
45
 
39
- /** V4.1 Flash 的规范模型名(被路由的请求一律以此名入账) */
40
- export const V41_FLASH_MODEL = 'deepseek-v4.1-flash'
46
+ /**
47
+ * V4-Pro 请求被路由到 V4.1 Flash 的生效时刻:北京时间 2026-09-14 12:00。
48
+ * 官方表述:「北京时间 2026 年 9 月 14 日 12:00 之后,至未来 V4.1 Pro 上线之前,
49
+ * 用户访问 deepseek-v4-pro 的请求将全部路由到 V4.1 Flash,并按 V4.1 Flash 单价计费」。
50
+ * 注意它与 V41_EFFECTIVE_AT(9-10 12:00)不是同一时刻,提前折算会低估 V4-Pro 花费。
51
+ */
52
+ export const V41_PRO_ROUTE_AT = Date.UTC(2026, 8, 14, 4, 0, 0)
53
+
54
+ /**
55
+ * V4.1 Flash 档的规范(官方现役)模型名。
56
+ * 官方文档:「模型名请使用 `deepseek-flash`」——被路由的请求一律以此名入账,
57
+ * 使按模型聚合的口径与官方账单一致。`deepseek-v4.1-flash` 归一化后等价命中本档。
58
+ */
59
+ export const V41_FLASH_MODEL = 'deepseek-flash'
41
60
 
42
61
  export const PRICE_ERAS = [
43
62
  {
@@ -53,14 +72,31 @@ export const PRICE_ERAS = [
53
72
  },
54
73
  {
55
74
  id: 'v41',
56
- label: 'V4.1 Flash 价(V4-Pro 与旧 V4-Flash 系均路由至此)',
75
+ label: 'V4.1 Flash 价(2026-09-10 12:00 起;V4-Pro 此时仍按自有牌价)',
57
76
  since: V41_EFFECTIVE_AT,
58
77
  models: {
59
78
  // 高峰价:输入(缓存命中)0.04 / 输入(缓存未命中)2 / 输出 8;空闲减半
60
79
  [V41_FLASH_MODEL]: { input: 2.0, output: 8.0, cacheRead: 0.04, cacheWrite: 0.04 },
80
+ // V4-Pro 尚在「自有牌价」窗口(9-14 12:00 前不路由),故本时代仍需保留其单价,
81
+ // 否则会落入 provider 兜底而被误标记为「估算」。
82
+ 'deepseek-v4-pro': { input: 9.0, output: 27.0, cacheRead: 0.30, cacheWrite: 0.30 },
61
83
  },
62
- // V4.1 Pro 上线前,V4-Pro 的请求全部路由到 V4.1 Flash 并按 V4.1 Flash 单价计费;
63
- // 旧 V4-Flash 系(含视觉版)已被 V4.1 Flash 取代,一并按新价计费。
84
+ // 旧 V4-Flash 系(含视觉版)已下线,请求由 V4.1 Flash 提供并按 Flash 价计费。
85
+ // V4-Pro 此时尚未路由(官方路由时刻为 9-14 12:00,见下一个时代)。
86
+ routes: {
87
+ 'deepseek-v4-flash': V41_FLASH_MODEL,
88
+ 'deepseek-v4-flash-vision-exp': V41_FLASH_MODEL,
89
+ },
90
+ proRouteSince: V41_PRO_ROUTE_AT,
91
+ },
92
+ {
93
+ id: 'v41pro',
94
+ label: 'V4.1 Flash 价 + V4-Pro 路由(2026-09-14 12:00 起)',
95
+ since: V41_PRO_ROUTE_AT,
96
+ models: {
97
+ [V41_FLASH_MODEL]: { input: 2.0, output: 8.0, cacheRead: 0.04, cacheWrite: 0.04 },
98
+ },
99
+ // V4.1 Pro 上线前,V4-Pro 的请求全部路由到 V4.1 Flash 并按 V4.1 Flash 单价计费。
64
100
  routes: {
65
101
  'deepseek-v4-pro': V41_FLASH_MODEL,
66
102
  'deepseek-v4-flash': V41_FLASH_MODEL,
@@ -69,7 +105,8 @@ export const PRICE_ERAS = [
69
105
  },
70
106
  ]
71
107
 
72
- /** 旧价精确单价表(legacy 时代)。保留导出,兼容既有调用与历史口径。 */
108
+ /** 旧价精确单价表(**仅 legacy 时代**)。保留导出,兼容既有调用与历史口径;
109
+ * 当前时代的精确表请用 `exactModelsAt(ts)`(会随时代切换)。 */
73
110
  export const EXACT_MODELS = PRICE_ERAS[0].models
74
111
 
75
112
  /** 归一化模型名:小写并剔除分隔符,使 v4.1 / v4-1 / v41 等写法命中同一档价。 */
@@ -77,6 +114,18 @@ export function normalizeModelName(m) {
77
114
  return String(m == null ? '' : m).toLowerCase().replace(/[^a-z0-9]/g, '')
78
115
  }
79
116
 
117
+ /**
118
+ * 规范名别名表(归一化后 → 官方现役规范名)。
119
+ * 官方文档口径:「模型名请使用 `deepseek-flash`」,`deepseek-v4.1-flash` 是同一档价的
120
+ * 等价写法(历史记录与旧文档中出现)。此处**不**把它们加进单价表,以免在单价表展示里
121
+ * 重复列出;只在解析阶段归一到规范名,保证 `estimated=false` 且按模型聚合同一个桶。
122
+ */
123
+ export const MODEL_ALIASES = {
124
+ deepseekv41flash: V41_FLASH_MODEL, // deepseek-v4.1-flash / deepseek-v41-flash / deepseek_v4.1_flash …
125
+ deepseekv41: V41_FLASH_MODEL, // deepseek-v41
126
+ deepseekflashv41: V41_FLASH_MODEL, // deepseek-flash-v4.1
127
+ }
128
+
80
129
  const ERA_INDEX = new Map()
81
130
  function eraIndex(era) {
82
131
  let idx = ERA_INDEX.get(era)
@@ -90,13 +139,14 @@ function eraIndex(era) {
90
139
  }
91
140
 
92
141
  /**
93
- * 某模型在指定时代下命中的**计费模型规范名**:先查本时代单价表,
94
- * 再查路由表(路由目标须在本时代单价表内);均未命中返回 null。
142
+ * 某模型在指定时代下命中的**计费模型规范名**:先按别名表归一,再查本时代单价表,
143
+ * 最后查路由表(路由目标须在本时代单价表内);均未命中返回 null。
95
144
  */
96
145
  export function resolveModelInEra(era, model) {
97
146
  if (!era) return null
98
- const n = normalizeModelName(model)
147
+ let n = normalizeModelName(model)
99
148
  if (!n) return null
149
+ if (MODEL_ALIASES[n]) n = normalizeModelName(MODEL_ALIASES[n])
100
150
  const idx = eraIndex(era)
101
151
  if (idx.models.has(n)) return idx.models.get(n)
102
152
  const target = idx.routes.get(n)
package/sync.js CHANGED
@@ -24,6 +24,14 @@ export const SYNC_VERSION = 1
24
24
  const US = '\u001f'
25
25
  const DAY_MS = 86400000
26
26
  const MAX_BATCH_BYTES = 900 * 1024
27
+ /**
28
+ * 历史回填算法版本(记录在状态文件 `backfillVer` 里)。
29
+ * 低于本值的部署,下一轮同步会做一次「水位归零 + 由旧到新全量补发」。
30
+ * 1 = v1.8.4:已废弃 —— 多轮循环用服务端返回的水位(整体 MAX(client_seq))
31
+ * 推进游标,会一步跨过本批之后尚未补发的记录,回填只发一批就短路。
32
+ * 2 = v1.8.5 起:游标只推进到**本批实际送达**的 maxClientSeq,多轮可覆盖全部。
33
+ */
34
+ const BACKFILL_VER = 2
27
35
 
28
36
  // ------------------------------------------------------------
29
37
  // 共享设备身份(与其它 agent 的适配器共用同一份文件)
@@ -197,6 +205,7 @@ export function defaultSyncState() {
197
205
  backoffMs: 0,
198
206
  pendingFailures: 0,
199
207
  legacySent: false,
208
+ backfillVer: 0,
200
209
  rollups: {},
201
210
  records: 0,
202
211
  }
@@ -447,12 +456,14 @@ export function createSyncEngine(deps) {
447
456
  running = true
448
457
  try {
449
458
  const st = readSyncState(safeSnapshot().storageDir || process.cwd())
450
- if (full) { st.watermark = 0; st.legacySent = false }
459
+ if (full) { st.watermark = 0; st.legacySent = false; st.backfillVer = 0 }
451
460
  // 一次性历史回填:≤1.8.3 的取批方向是"最新优先",首批传完水位就跳到了最新
452
461
  // seq,更旧的记录被 `seq <= watermark` 永久跳过(云端因此缺一段历史)。
453
462
  // 这里在升级后的第一轮同步把水位归零、由旧到新把全部历史补齐一次;
454
463
  // 服务端按内容哈希幂等,重复的记录只会被计为 duplicates。
455
- const backfill = !st.legacySent
464
+ // 用 backfillVer 而不是布尔量:v1.8.4 的回填算法本身有缺陷(见常量注释),
465
+ // 必须让已经跑过 v1 回填的部署再补跑一次 v2。
466
+ const backfill = Number(st.backfillVer) !== BACKFILL_VER
456
467
  if (backfill) st.watermark = 0
457
468
  st.deviceId = await ensureDevice(cfg, st)
458
469
  if (!identityOf().nameLocked && cfg.deviceName) {
@@ -501,10 +512,12 @@ export function createSyncEngine(deps) {
501
512
  result.duplicates += dup
502
513
  result.updated = (result.updated || 0) + updated
503
514
  result.invalid = (result.invalid || 0) + invalid
504
- // 水位只在服务端确实处理了本批记录时推进;否则本批下次会重发(幂等,安全)
515
+ // 游标只推进到**本批实际送达**的最大 seq。
516
+ // 服务端回的是它库里该设备明细的 MAX(client_seq)(可能含更早已上传的、
517
+ // 序号更高的记录),直接采信会一步跨过本批之后尚未补发的记录,
518
+ // 让下面的多轮循环当场 break —— 那正是历史缺口补不回来的原因。
505
519
  if (accepted + dup + updated > 0) {
506
- const wm = Number(r.body.watermark && r.body.watermark.maxClientSeq) || 0
507
- if (wm > st.watermark) st.watermark = wm
520
+ if (pending.maxClientSeq > st.watermark) st.watermark = pending.maxClientSeq
508
521
  } else if (invalid > 0) {
509
522
  throw Object.assign(new Error('云端拒绝了本批全部 ' + invalid + ' 条记录'), { fatal: true })
510
523
  }
@@ -514,8 +527,9 @@ export function createSyncEngine(deps) {
514
527
  }
515
528
  result.sentRecords = sentRecords
516
529
  // 明细已由旧到新走完一轮(或达到轮次上限,水位同样可精确续传)→ 历史已对齐。
517
- // 只在真正跑完明细阶段后置位:中途失败时保持 false,下次仍会从头补,绝不漏发。
530
+ // 只在真正跑完明细阶段后落版本号:中途失败时保持旧值,下次仍会从头补,绝不漏发。
518
531
  st.legacySent = true
532
+ st.backfillVer = BACKFILL_VER
519
533
 
520
534
  // ---- 2. 日汇总快照(后发,声明 absorbed) ----
521
535
  if (cfg.syncRollups) {