@angelyeye/dsh-cost-tracker 1.8.4 → 1.8.5

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,16 @@
2
2
 
3
3
  本文件用中文记录 dsh-cost-tracker 的版本变更。
4
4
 
5
+ ## v1.8.5(2026-09-15)
6
+
7
+ **修复**
8
+ - **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 批。
9
+ - **回填算法加版本号**:状态文件新增 `backfillVer`。v1.8.4 已经跑过(有缺陷的)回填的部署,`legacySent` 已是 `true` 而缺口仍在,靠布尔量无法区分"补过且补全"与"补过但短路"。现在低于当前算法版本(2)的部署会**再补跑一次**;`cost_sync action=now full=true` 同样会强制重新回填一轮。
10
+
11
+ **测试**
12
+ - `test/sync.test.js` 新增 8d 组:复现「服务端水位 = 整体最大值 + 云端只有最新的 500 条」这一真实故障现场,断言一轮同步必须把 1..1200 全部送达、云端不留空洞、版本号落盘。**该组在 v1.8.4 代码上报 5 条红**(只发出第一批、留下 650 个空洞),修复后全绿。
13
+ - 断言回填成功后必须落 `backfillVer=2`,中途失败时不得落(否则缺口会被永久放过)。全量 `npm test` 通过;无数据迁移、无破坏性变更。
14
+
5
15
  ## v1.8.4(2026-09-15)
6
16
 
7
17
  **修复**
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.4'
22
+ const PLUGIN_VERSION = '1.8.5'
23
23
  setPluginVersion(PLUGIN_VERSION)
24
24
 
25
25
  /** 「设置 → 插件 → 插件配置」里的卡片字段(与 settings 命名空间一致) */
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.5",
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/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) {