@angelyeye/dsh-cost-tracker 1.8.3 → 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,29 @@
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
+
15
+ ## v1.8.4(2026-09-15)
16
+
17
+ **修复**
18
+ - **云端「全时段」缺失最早一段历史**:`sync.js` 的 `buildRecordsPayload()` 从**最新**记录往回取批,首批装满 `syncBatchSize`(默认 500)后水位立刻跳到最新 seq,而跳过条件是 `seq <= watermark` —— 比首批更旧的记录被判成"已上报",**再也不会被发送**。凡是"先攒下一批本地明细、之后才开启云端同步"的部署都会中招,且 `cost_sync action=now full=true` 也救不回来:全量只是把水位归零,选片方向照旧从最新开始,重复发同一批后水位又跳回顶端。实测现场:本机 1456 条明细,云端只收到 722 条(最早 `2026-08-24 22:53:57`,正好是首轮 500 条批次的起点),**缺 723 条、¥36.68**。现改为**由旧到新**取批,水位逐批连续推进,每轮最多 40 批,多轮即可覆盖全部历史。
19
+ - **已上线部署自动补齐**:启用状态文件里一直闲置的 `legacySent` 标记做**一次性历史回填** —— 升级后的第一轮同步把水位归零、由旧到新重发全部历史(服务端按内容哈希幂等,已存在的记录只计 `duplicates`);该标记**只在明细阶段真正跑完一轮后才置位**,中途失败保持 `false`,下次同步继续补,绝不漏发。
20
+
21
+ **测试**
22
+ - `test/sync.test.js` 新增 3 组护栏共 21 条断言:
23
+ - **取片方向**:批上限截断时必须取**最旧**的若干条(≤1.8.3 返回最新的,断言立即报红);
24
+ - **现场复现**:1200 条明细 + 水位被推到 1100 + `legacySent=false`,一轮同步必须完整送达 1200 条(升序、无重复、水位推进到 1200、置位 `legacySent`);置位后只发增量;
25
+ - **失败可恢复**:中途 500 时不得置位 `legacySent`,下一次同步仍能把 1200 条全部补齐。
26
+ - 上述 11 条断言在 v1.8.3 代码上全部报红,修复后全绿;全量 `npm test` 通过;无数据迁移、无破坏性变更。
27
+
5
28
  ## v1.8.3(2026-09-15)
6
29
 
7
30
  **修复**
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.3'
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.3",
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
  }
@@ -312,7 +321,10 @@ export function createSyncEngine(deps) {
312
321
  const cutoff = cfg.syncSinceDays > 0 ? now() - cfg.syncSinceDays * DAY_MS : 0
313
322
  const out = []
314
323
  let bytes = 0
315
- for (let k = details.length - 1; k >= 0; k -= 1) {
324
+ // 必须**由旧到新**收集:水位语义是"已成功上送的最大 seq",
325
+ // 若从最新往回取批,首批只覆盖最新 limit 条,水位随即跳过更旧的记录,
326
+ // 它们就再也不会被选中(历史数据永久缺失)。
327
+ for (let k = 0; k < details.length; k += 1) {
316
328
  const r = details[k]
317
329
  if (!r || typeof r.ts !== 'number') continue
318
330
  const seq = Number.isFinite(r.seq) ? r.seq : 0
@@ -345,7 +357,7 @@ export function createSyncEngine(deps) {
345
357
  bytes += size
346
358
  if (out.length >= limit) break
347
359
  }
348
- out.reverse() // 按时间升序上送,便于服务端推进水位
360
+ // details 本身按时间升序,顺序收集即为升序上送(便于服务端推进水位)
349
361
  return {
350
362
  records: out,
351
363
  maxClientSeq: out.length ? Math.max(...out.map((r) => Number(r.seq) || 0)) : 0,
@@ -444,7 +456,15 @@ export function createSyncEngine(deps) {
444
456
  running = true
445
457
  try {
446
458
  const st = readSyncState(safeSnapshot().storageDir || process.cwd())
447
- if (full) { st.watermark = 0; st.legacySent = false }
459
+ if (full) { st.watermark = 0; st.legacySent = false; st.backfillVer = 0 }
460
+ // 一次性历史回填:≤1.8.3 的取批方向是"最新优先",首批传完水位就跳到了最新
461
+ // seq,更旧的记录被 `seq <= watermark` 永久跳过(云端因此缺一段历史)。
462
+ // 这里在升级后的第一轮同步把水位归零、由旧到新把全部历史补齐一次;
463
+ // 服务端按内容哈希幂等,重复的记录只会被计为 duplicates。
464
+ // 用 backfillVer 而不是布尔量:v1.8.4 的回填算法本身有缺陷(见常量注释),
465
+ // 必须让已经跑过 v1 回填的部署再补跑一次 v2。
466
+ const backfill = Number(st.backfillVer) !== BACKFILL_VER
467
+ if (backfill) st.watermark = 0
448
468
  st.deviceId = await ensureDevice(cfg, st)
449
469
  if (!identityOf().nameLocked && cfg.deviceName) {
450
470
  identity.machineName = cfg.deviceName
@@ -492,10 +512,12 @@ export function createSyncEngine(deps) {
492
512
  result.duplicates += dup
493
513
  result.updated = (result.updated || 0) + updated
494
514
  result.invalid = (result.invalid || 0) + invalid
495
- // 水位只在服务端确实处理了本批记录时推进;否则本批下次会重发(幂等,安全)
515
+ // 游标只推进到**本批实际送达**的最大 seq。
516
+ // 服务端回的是它库里该设备明细的 MAX(client_seq)(可能含更早已上传的、
517
+ // 序号更高的记录),直接采信会一步跨过本批之后尚未补发的记录,
518
+ // 让下面的多轮循环当场 break —— 那正是历史缺口补不回来的原因。
496
519
  if (accepted + dup + updated > 0) {
497
- const wm = Number(r.body.watermark && r.body.watermark.maxClientSeq) || 0
498
- if (wm > st.watermark) st.watermark = wm
520
+ if (pending.maxClientSeq > st.watermark) st.watermark = pending.maxClientSeq
499
521
  } else if (invalid > 0) {
500
522
  throw Object.assign(new Error('云端拒绝了本批全部 ' + invalid + ' 条记录'), { fatal: true })
501
523
  }
@@ -504,6 +526,10 @@ export function createSyncEngine(deps) {
504
526
  pending = next
505
527
  }
506
528
  result.sentRecords = sentRecords
529
+ // 明细已由旧到新走完一轮(或达到轮次上限,水位同样可精确续传)→ 历史已对齐。
530
+ // 只在真正跑完明细阶段后落版本号:中途失败时保持旧值,下次仍会从头补,绝不漏发。
531
+ st.legacySent = true
532
+ st.backfillVer = BACKFILL_VER
507
533
 
508
534
  // ---- 2. 日汇总快照(后发,声明 absorbed) ----
509
535
  if (cfg.syncRollups) {