@angelyeye/dsh-cost-tracker 1.8.6 → 1.8.7

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,23 @@
2
2
 
3
3
  本文件用中文记录 dsh-cost-tracker 的版本变更。
4
4
 
5
+ ## v1.8.7(2026-09-15)
6
+
7
+ **修复:`cost_recompute` 的默认范围只覆盖「最近一个价格时代」,更早的陈旧记录被静默跳过**
8
+
9
+ - **现场**:v1.8.6 修复后按提示执行补账,854 条被订正,但另有 **750 条 `deepseek-flash` 记录(seq 611–1360,北京时间 09-10 21:24 ~ 09-14 02:36)仍标着「估算」**。逐条核对发现它们**完全落在默认扫描范围之外**:旧默认 `since` = **最近一个价格时代的生效时刻**(本机为 `v41pro` = 09-14 12:00),该时刻之前的记录一条都没进扫描。补账只做了一半,提示却是「没有需要重算的记录」——**默认值本身就是陷阱**。
10
+ - **修法**:默认改为 **全时段扫描(`since = 0`)**。补账幂等、明细量级有限(本机 1600+ 条耗时毫秒级),全扫代价可忽略,收益是「调用一次必然覆盖全部历史」。
11
+ - 显式传入 `since`(ISO 或 epoch ms)仍可限定时段;`since: 0` 现在被正确识别为「全时段」,此前因 `> 0` 判断会被当成缺省值而回落到最近时代。
12
+ - `since === 0` 时返回值 `era` 为 `null`(全时段不存在单一时代),避免旧版误报 `era=legacy`;工具输出把范围显示为「全时段」。
13
+ - **实测(本机 2231 条明细)**:全时段扫描 `scanned=1642 / changed=772 / estimatedFlips=750 / delta=0.0000`,落盘后再跑一次 `changed=0`(幂等)。**全部 1643 条 `deepseek-flash` 记录的「估算」标记清零,金额一分未变**;仅剩 5 条 `k3-256k`(Kimi 订阅等效口径,本就应为估算)。
14
+
15
+ **加固**
16
+
17
+ - `test/client-registration.test.js` 新增 **[7] 版本号一致性**断言:`package.json` 的 `version` 必须等于 `index.js` 的 `PLUGIN_VERSION`。v1.8.6 发布时两处曾漂移(包 1.8.6 / 常量 1.8.5),而该常量会随上报信封发给云端用于排查设备版本,漂移会让云端看到错误版本。现已把它变成发布闸门。
18
+ - `test/recompute.test.js` 断言默认范围改为「全时段扫描 + `era=null` + 覆盖全部 5 条样本」。
19
+
20
+ **兼容**:无数据格式变更;`cost_recompute` 入参向后兼容(显式 `since` 行为不变,仅缺省值与 `since: 0` 的解析被修正)。
21
+
5
22
  ## v1.8.6(2026-09-15)
6
23
 
7
24
  **修复:计费规则与 DeepSeek 官方定价的两处口径偏差(金额口径 + 标记口径)**
package/README.md CHANGED
@@ -238,6 +238,15 @@ POST /api/cost-tracker/export 导出 CSV
238
238
 
239
239
  ## 更新记录
240
240
 
241
+ ### v1.8.7(2026-09-15)
242
+
243
+ **修复:`cost_recompute` 默认只扫描「最近一个价格时代」,更早的陈旧记录被静默跳过**
244
+
245
+ - v1.8.6 补账后本机仍有 **750 条 `deepseek-flash` 记录停留在「估算」标记**(时间落在 09-10 21:24 ~ 09-14 02:36):旧默认 `since` 取**最近一个价格时代的生效时刻**(`v41pro` = 09-14 12:00),该时刻之前的记录一条都没进扫描,而提示却是「没有需要重算的记录」。
246
+ - 默认改为**全时段扫描(`since = 0`)**;`since: 0` 现被正确识别为全时段(旧版因 `> 0` 判断会回落),全时段时 `era` 返回 `null` 不再误报单一时代。补账幂等,全扫代价可忽略。
247
+ - 本机实测:`scanned=1642 / changed=772 / estimatedFlips=750 / delta=0.0000`,再跑一次 `changed=0`;**1643 条 `deepseek-flash` 的「估算」标记清零、金额未变**(仅 Kimi 订阅的 5 条仍为估算,属正常)。
248
+ - 加固:`client-registration.test.js` 新增版本号一致性断言(`package.json` 版本必须等于 `index.js` 的 `PLUGIN_VERSION`,v1.8.6 发布时二者曾漂移)。
249
+
241
250
  ### v1.8.6(2026-09-15)
242
251
 
243
252
  **修复:计费规则与官方定价的两处口径偏差**(核查基准:官方[价格卡](https://api-docs.deepseek.com/zh-cn/quick_start/pricing) + [V4.1 Flash 发布通告](https://api-docs.deepseek.com/zh-cn/news/news260910))
package/index.js CHANGED
@@ -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.6'
22
+ const PLUGIN_VERSION = '1.8.7'
23
23
  setPluginVersion(PLUGIN_VERSION)
24
24
 
25
25
  /** 「设置 → 插件 → 插件配置」里的卡片字段(与 settings 命名空间一致) */
@@ -773,13 +773,16 @@ export default {
773
773
  // 重新选版计费,无需重新采集。
774
774
  // 只重算明细:明细保留最近 DETAIL_DAYS 天,更早的记录早已折叠进日汇总,
775
775
  // 而日汇总覆盖的时间段远早于任何价格切换窗口,故不涉及。
776
+ // **默认扫描全部明细**(since=0):早期版本默认「自最近一个价格时代起算」,
777
+ // 结果更早时代里被旧代码标错口径的记录(如现役名曾落入兜底而被标 estimated)
778
+ // 会被静默跳过——补账只做一半却提示「无需重算」。补账是幂等的,全扫代价可忽略。
776
779
  // 默认只试算(不落盘),传 apply: true 才写回。
777
780
  function recomputeCosts(args) {
778
781
  const a = args || {}
779
- const fallback = PRICE_ERAS[PRICE_ERAS.length - 1].since
780
- let since = fallback
782
+ // since:显式传入(ISO 或 epoch ms)则按它限定时段;缺省 0 = 全时段。
783
+ let since = 0
781
784
  if (typeof a.since === 'string' && Number.isFinite(Date.parse(a.since))) since = Date.parse(a.since)
782
- else if (Number.isFinite(a.since) && a.since > 0) since = a.since
785
+ else if (Number.isFinite(a.since) && a.since >= 0) since = a.since
783
786
  const apply = a.apply === true
784
787
  const byModel = {}
785
788
  let scanned = 0, changed = 0, oldCost = 0, newCost = 0, estimatedFlips = 0
@@ -825,7 +828,8 @@ export default {
825
828
  ok: true,
826
829
  applied: apply && changed > 0,
827
830
  since,
828
- era: eraAt(since).id,
831
+ // since=0 表示全时段:此时不存在「单一时代」,era 返回 null(旧版会误报为 legacy)
832
+ era: since === 0 ? null : eraAt(since).id,
829
833
  scanned,
830
834
  changed,
831
835
  estimatedFlips,
@@ -1157,21 +1161,23 @@ export default {
1157
1161
 
1158
1162
  ctx.tools.register({
1159
1163
  name: 'cost_recompute',
1160
- description: '按「计费时代」重算已入库记录的费用(一次性补账)。用于价格调整后宿主未及时重启、导致记录按旧价入库的情况;默认只试算不落盘,传 apply: true 才写回。',
1164
+ description: '按「计费时代」重算已入库记录的费用(一次性补账)。用于价格调整或计价口径修正后宿主未及时重启、导致记录按旧口径入库的情况;默认只试算不落盘,传 apply: true 才写回。默认扫描**全部**明细(since=0),避免更早时代里标错口径的记录被漏掉。',
1161
1165
  parameters: {
1162
1166
  type: 'object',
1163
1167
  properties: {
1164
1168
  apply: { type: 'boolean', description: '是否把重算结果写回(默认 false,仅试算)' },
1165
- since: { type: 'string', description: '重算起始时刻(ISO 字符串或 epoch ms);默认取最近一次价格时代的生效时刻' },
1169
+ since: { type: 'string', description: '重算起始时刻(ISO 字符串或 epoch ms);默认 0 = 全时段扫描(补账幂等,建议保持默认)' },
1166
1170
  },
1167
1171
  additionalProperties: true,
1168
1172
  },
1169
1173
  output: {
1170
1174
  schema: { type: 'object', additionalProperties: true },
1171
1175
  render: (args, v) => {
1172
- const when = new Date(v.since + 28800000).toISOString().replace('T', ' ').slice(0, 16).replace(/-/g, '/')
1176
+ const scope = v.since === 0
1177
+ ? '全时段'
1178
+ : ('自 ' + new Date(v.since + 28800000).toISOString().replace('T', ' ').slice(0, 16).replace(/-/g, '/') + ' 北京起 · era=' + v.era)
1173
1179
  const lines = [
1174
- '费用重算(自 ' + when + ' 北京起 · era=' + v.era + ')',
1180
+ '费用重算(' + scope + ')',
1175
1181
  '扫描 ' + v.scanned + ' 条,需修正 ' + v.changed + ' 条' + (v.estimatedFlips ? '(其中 ' + v.estimatedFlips + ' 条仅订正「估算」标记,金额不变)' : ''),
1176
1182
  '合计:¥' + v.oldCost + ' → ¥' + v.newCost + '(' + (v.delta >= 0 ? '+' : '') + v.delta + ')',
1177
1183
  ]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@angelyeye/dsh-cost-tracker",
3
- "version": "1.8.6",
3
+ "version": "1.8.7",
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",