@angelyeye/dsh-cost-tracker 1.8.8 → 1.8.10

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,40 @@
2
2
 
3
3
  本文件用中文记录 dsh-cost-tracker 的版本变更。
4
4
 
5
+ ## v1.8.10(2026-09-17)
6
+
7
+ **修复:Windows 上落盘偶发 `EPERM`(rename 被瞬时占用),启动日志甩出吓人的堆栈**
8
+
9
+ - **现场**(v1.8.9 重启时):
10
+ ```
11
+ cost tracker persist failed Error: EPERM: operation not permitted,
12
+ rename '...cost-tracker-records.json.tmp' -> '...cost-tracker-records.json'
13
+ at renameSync (node:fs:1012:11)
14
+ at Object.persist (.../store.js:307:7)
15
+ ```
16
+ - **根因**:`persist()` 是「写临时文件 → rename 覆盖」,但**只尝试一次**。Windows 上 rename 需要**目标文件的删除权限**,以下都会瞬时失败:杀毒 / 搜索索引器刚扫过刚写完的临时文件;资源管理器预览、备份/同步工具正在读它;**上一个 dsh 实例还没退干净**(或同时跑了两个实例)。失败后数据仍在内存、下次写入会重试(本次实测 2 分钟后自动写成功、未丢数据),但用户看到的是完整堆栈,且这段时间磁盘上是旧数据。
17
+ - **修法**:
18
+ 1. 临时文件名带 **pid**(`<file>.<pid>.tmp`)——旧实现固定用 `<file>.tmp`,两个实例必然抢同一个临时文件;
19
+ 2. `renameSync` 遇 `EPERM/EACCES/EBUSY` **退避重试**(20/40/80/160ms,共 5 次 ≈ 0.35s);`ENOENT` 等代码类错误不重试;
20
+ 3. 仍失败**不做**「直接覆盖写」——那会让并发读方看到半个 JSON,而 `load()` 一旦读到半个 JSON 会把文件改名为 `.corrupt-*` 并清空,损失远大于「晚几秒落盘」;改为数据留在内存,由调用方重试;
21
+ 4. `index.js` 再排 **3 次延迟重试**(2s/4s/6s),覆盖「杀毒扫描持续数秒」这类同步重试兜不住的情况;重试链走完之前**不打日志**(quiet 模式),彻底放弃时才打印一次带「原因 + 影响」的说明;
22
+ 5. 退出前最后一次落盘给足重试(10 次 ≈ 2s),避免被瞬时占用就丢掉本次会话的记录。
23
+ - **实测**(真实 Windows 文件锁:`[System.IO.File]::Open(..., FileShare.Read)` 持锁):
24
+ - 持续占用 → 重试 5 次后放弃,**原文件字节不变**、无残留临时文件,日志变成三行可读说明;
25
+ - 持锁 120ms 后释放 → 第 3 次尝试成功落盘(`{ok:true, ms:82}`),**无需人工干预**;
26
+ - quiet 模式失败 → stderr 为空(由调用方决定何时报)。
27
+ - **测试**:`test/storage.test.js` 新增第 13 节(17 条断言):一次成功、退避重试、持续占用不覆盖目标且清理临时文件、非占用类错误只试一次、错误分类、真实落盘往返。
28
+
29
+ ## v1.8.9(2026-09-17)
30
+
31
+ **修正档位文案:「平峰」→「不分峰谷」,且为 0 时不再占图例**
32
+
33
+ - **问题**:按峰谷图的图例第三项写作「平峰」(内部 `period='flat'` 的直译)。官方定价**只有两档**——高峰(工作日 9:00-12:00、14:00-18:00)与闲时(高峰 × 0.5,周末全天闲时);`flat` 的真实含义是「**这笔计价不分峰谷**」(`price.tiered === false`:订阅套餐、非 DeepSeek provider 的兜底价、未识别模型的通用兜底价)。而中文电价语境里「平峰/平段」指峰谷之间的**第三个时段**,放在这里会让人以为 DeepSeek 有三档价。
34
+ - **另一层误导**:该项常驻图例,即使全区间为 0 也占一个色块(只跑 DeepSeek 按量调用时恒为 0),进一步强化「存在第三个时段」的错觉。
35
+ - **修法**:`client.js` 图例与 `periodText()`(最近记录「时段」列)、`index.js` 的 `cost_peak` 查询输出统一改为「**不分峰谷**」;图例与柱状图**仅在该窗口内 flat 合计 > 0 时**才带上第三项(其余情况只留 高峰 / 闲时 两项)。
36
+ - **未改口径**:`flat` 字段与计费逻辑不动,仅改措辞与显示条件。
37
+ - **测试**:`test/client-render.test.js` 新增 `[6]` 段——断言渲染文本含「不分峰谷」、不含「平峰」;把样本 `flat` 置 0 后,图例不得再出现第三项,而高峰/闲时仍在。
38
+
5
39
  ## v1.8.8(2026-09-15)
6
40
 
7
41
  **修复:「仅云端」视图只有请求次数、费用整列为 ¥0.0000(字段名未映射)**
package/README.md CHANGED
@@ -238,6 +238,28 @@ POST /api/cost-tracker/export 导出 CSV
238
238
 
239
239
  ## 更新记录
240
240
 
241
+ ### v1.8.10(2026-09-17)
242
+
243
+ **修复:Windows 上落盘偶发 `EPERM`(rename 被瞬时占用),启动日志出现吓人的堆栈**
244
+
245
+ - **现场**:重启 `dsh web` 时打印 `cost tracker persist failed Error: EPERM: operation not permitted, rename '...cost-tracker-records.json.tmp' -> '...cost-tracker-records.json'`,附完整调用栈。**数据没丢**(内存里还在、随后自动写成功),但这段堆栈看起来像崩溃。
246
+ - **根因**:`persist()` 是「写临时文件 → rename 覆盖」,但**只尝试一次**。Windows 上 rename 需要**目标文件的删除权限**,以下情况都会瞬时失败:杀毒 / 搜索索引器刚扫过临时文件;资源管理器预览或备份/同步工具正在读它;**上一个 dsh 实例还没退干净**(或同时跑了两个实例)。旧实现还固定用 `<file>.tmp` 作临时文件名,两个实例必然抢同一个名字。
247
+ - **修法**:
248
+ - 临时文件名带 **pid**;rename 遇 `EPERM/EACCES/EBUSY` **退避重试**(20/40/80/160ms,共 5 次 ≈ 0.35s),`ENOENT` 等代码类错误不重试;
249
+ - 应用层(`index.js`)再排 **3 次延迟重试**(2s/4s/6s),覆盖「杀毒扫描持续数秒」这种同步重试兜不住的情况;**重试链走完之前不打日志**,彻底放弃时才打印一次「原因 + 影响」说明;
250
+ - 仍失败**不做**「直接覆盖写」:那会让并发读方看到半个 JSON,而 `load()` 读到半个 JSON 会把文件改名为 `.corrupt-*` 并清空,损失远大于晚几秒落盘;数据留在内存,等下一次写入自动重试;
251
+ - 退出前最后一次落盘给足重试(10 次 ≈ 2s),避免被瞬时占用就丢掉本次会话的记录。
252
+ - **实测**(真实 Windows 文件锁):持续占用 → 重试后放弃、**原文件字节不变**、无残留临时文件、日志为三行可读说明;持锁 120ms 后释放 → 第 3 次尝试成功落盘,**无需人工干预**。
253
+
254
+ ### v1.8.9(2026-09-17)
255
+
256
+ **修正档位文案:「平峰」→「不分峰谷」,且为 0 时不再占图例**
257
+
258
+ - **问题**:按峰谷图的图例第三项写作「平峰」(内部 `period='flat'` 的直译)。官方定价**只有两档**——高峰(工作日 9:00-12:00、14:00-18:00)与闲时(高峰 × 0.5,周末全天闲时);`flat` 的真实含义是「**这笔计价不分峰谷**」(`price.tiered === false`:订阅套餐、非 DeepSeek provider 的兜底价、未识别模型的通用兜底价)。中文电价语境里「平峰/平段」指峰谷之间的**第三个时段**,放在这里会让人以为 DeepSeek 有三档价。
259
+ - **另一层误导**:该项常驻图例,即使全区间恒为 0(只跑 DeepSeek 按量调用时的真实情况)也要占一个色块,进一步强化「存在第三个时段」的错觉。
260
+ - **修法**:图例、最近记录「时段」列(`periodText()`)与 `cost_peak` 查询输出统一改为「**不分峰谷**」;图例与柱状图**仅在该窗口内 flat 合计 > 0 时**才带上第三项,其余情况只留 高峰 / 闲时 两项。计费口径与 `flat` 字段不动,只改措辞与显示条件。
261
+ - **测试**:`test/client-render.test.js` 新增 `[6]` 段(6 条断言)——渲染文本必须含「不分峰谷」且不含「平峰」;把样本 `flat` 置 0 后图例不得再出现第三项,而高峰 / 闲时仍在。样本 `recent` 同时补成两条真实记录(`peak` / `flat` 各一),否则「时段」列根本不会被渲染 —— 这正是该文案长期没被测到的原因。
262
+
241
263
  ### v1.8.8(2026-09-15)
242
264
 
243
265
  **修复:「仅云端」视图只有次数、费用整列 ¥0.0000**
package/client.js CHANGED
@@ -285,7 +285,11 @@ window.__ModuleLoader__.load({
285
285
  if (hr < 24) return hr + " 小时前";
286
286
  return fmtClock(t);
287
287
  }
288
- function periodText(p) { return p === "peak" ? "高峰" : p === "off-peak" ? "闲时" : "平峰"; }
288
+ // 档位文案。官方**只有两档**:peak = 高峰(工作日 9-12 / 14-18),off-peak = 闲时(高峰 × 0.5,含周末全天)。
289
+ // flat 不是「第三个时段」,而是「这笔计价不分峰谷」(订阅套餐、非 DeepSeek provider 的兜底价、
290
+ // 未识别模型的通用兜底价:price.tiered === false)。此前译作「平峰」——电价语境里「平段」指峰谷
291
+ // 之间的那一档,会让人以为 DeepSeek 有三个时段,故改为「不分峰谷」。
292
+ function periodText(p) { return p === "peak" ? "高峰" : p === "off-peak" ? "闲时" : "不分峰谷"; }
289
293
  function shortModel(m) { const i = m.lastIndexOf("/"); return i >= 0 ? m.slice(i + 1) : m; }
290
294
  // 订阅套餐友好名称:kimi-coding / kimi → Kimi Coding Plan,其余保留 provider 名
291
295
  function subPlanName(p) {
@@ -749,8 +753,14 @@ window.__ModuleLoader__.load({
749
753
  const titles = dash.byDay.map(d => d.date);
750
754
  const fmtMoneyValue = (v) => "¥" + fmtMoney(v);
751
755
  if (tab === "period") {
752
- const segs = [{ name: "闲时", color: BLUE }, { name: "高峰", color: AMBER }, { name: "平峰", color: GRAY }];
753
- const rows = dash.byDay.map(d => [d.off, d.peak, d.flat]);
756
+ // 图例只列真实存在的档位:官方定价只有「高峰 / 闲时」两档;
757
+ // flat(不分峰谷:订阅套餐、非 DeepSeek provider 兜底价等)**为 0 时不占图例位置**——
758
+ // 常驻一个恒为 0 的第三项,会被读成「还有第三个时段」,与计费规则不符。
759
+ const flatTotal = dash.byDay.reduce((s, d) => s + (Number(d.flat) || 0), 0);
760
+ const hasFlat = flatTotal > 0;
761
+ const segs = [{ name: "闲时", color: BLUE }, { name: "高峰", color: AMBER }]
762
+ .concat(hasFlat ? [{ name: "不分峰谷", color: GRAY }] : []);
763
+ const rows = dash.byDay.map(d => hasFlat ? [d.off, d.peak, d.flat] : [d.off, d.peak]);
754
764
  chart = e(StackedBarsChart, { labels, titles, segs, rows, fmtY: fmtAxisMoney, fmtValue: fmtMoneyValue });
755
765
  legend = segs;
756
766
  } else {
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.8'
22
+ const PLUGIN_VERSION = '1.8.10'
23
23
  setPluginVersion(PLUGIN_VERSION)
24
24
 
25
25
  /** 「设置 → 插件 → 插件配置」里的卡片字段(与 settings 命名空间一致) */
@@ -139,7 +139,32 @@ export default {
139
139
  const records = store.details
140
140
  const rollups = store.rollups
141
141
 
142
- function writeRecords() { store.persist() }
142
+ /**
143
+ * 落盘。store.persist() 内部已对「文件被短暂占用」退避重试(约 0.3s);
144
+ * 仍失败时在这里**再排 3 次延迟重试**(2s / 4s / 6s)——
145
+ * 杀毒或备份工具一次扫描常常持续数秒,仅靠同步重试兜不住,
146
+ * 而数据一直在内存里,晚几秒落盘没有任何损失。
147
+ *
148
+ * 期间对 store 用 quiet 模式:重试链没走完之前**不打日志**,
149
+ * 避免「其实马上就好了」的情况在启动日志里甩出一段吓人的 EPERM 堆栈
150
+ * (v1.8.9 重启时的真实现场)。彻底放弃时才打印一次带原因与影响的说明。
151
+ */
152
+ let persistRetry = 0
153
+ let persistRetryTimer = null
154
+ function writeRecords() {
155
+ if (store.persist({ quiet: true })) { persistRetry = 0; return true }
156
+ if (persistRetry >= 3) {
157
+ console.error(store.persistProblem())
158
+ return false
159
+ }
160
+ persistRetry += 1
161
+ const delay = 2000 * persistRetry
162
+ const fire = () => { persistRetryTimer = null; writeRecords() }
163
+ const timer = ctx.get('timer')
164
+ if (persistRetryTimer) { try { persistRetryTimer() } catch (e) {} }
165
+ persistRetryTimer = timer ? timer.timeout(fire, delay) : setTimeout(fire, delay)
166
+ return false
167
+ }
143
168
 
144
169
  // ---------- plugin config(峰谷计价 + 云端同步) ----------
145
170
  // 与记录分开存储:$DSH_HOME/storages/cost-tracker-config.json。
@@ -278,6 +303,7 @@ export default {
278
303
  function persistNow() {
279
304
  persistPending = false
280
305
  if (persistTimer) { try { persistTimer() } catch (e) {} persistTimer = null }
306
+ if (persistRetryTimer) { try { persistRetryTimer() } catch (e) {} persistRetryTimer = null }
281
307
  writeRecords()
282
308
  }
283
309
 
@@ -1259,7 +1285,7 @@ export default {
1259
1285
  const lines = ['花费统计(' + (v.days === 0 ? '全部' : '近 ' + v.days + ' 天') + ')']
1260
1286
  if (v.local) {
1261
1287
  lines.push('【本机】按量消费:¥' + v.local.realTotal + '(高峰 ¥' + v.local.peakCost + ' · 闲时 ¥' + v.local.offCost
1262
- + (v.local.flatCost > 0 ? ' · 平峰 ¥' + v.local.flatCost : '') + ')· 请求 ' + v.local.realCalls + ' 次 · Tokens ' + v.local.realTokens)
1288
+ + (v.local.flatCost > 0 ? ' · 不分峰谷 ¥' + v.local.flatCost : '') + ')· 请求 ' + v.local.realCalls + ' 次 · Tokens ' + v.local.realTokens)
1263
1289
  lines.push('【本机】订阅套餐:请求 ' + v.local.subCalls + ' 次 · Tokens ' + v.local.subTokens + ' · 等效 ¥' + v.local.subEquivalent + '(订阅已覆盖,仅供参考)')
1264
1290
  }
1265
1291
  if (v.cloud && v.cloud.ok) {
@@ -1381,7 +1407,9 @@ export default {
1381
1407
  startSyncTimer()
1382
1408
  if (cloudConfig.cloudEnabled) scheduleSync(5000)
1383
1409
  ctx.effect(() => () => {
1384
- try { writeRecords() } catch (e) {}
1410
+ // 退出前最后一次落盘:给足重试(10 次 ≈ 2s)——否则被瞬时占用就会丢掉本次会话的记录;
1411
+ // 这里不能用 writeRecords(),它失败后只是「排个延迟重试」,而进程马上要退出。
1412
+ try { store.persist({ tries: 10 }) } catch (e) {}
1385
1413
  if (syncTimer) { try { syncTimer() } catch (e) {} }
1386
1414
  if (syncDebounce) { try { syncDebounce() } catch (e) {} }
1387
1415
  }, 'cost-tracker: final flush')
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@angelyeye/dsh-cost-tracker",
3
- "version": "1.8.8",
3
+ "version": "1.8.10",
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/store.js CHANGED
@@ -16,7 +16,7 @@
16
16
  // v1(旧版裸数组)在 load() 时自动迁移;损坏文件自动备份为
17
17
  // .corrupt-<时间戳> 并从零开始,不阻断启动。
18
18
  // ============================================================
19
- import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
19
+ import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs'
20
20
  import { dirname } from 'node:path'
21
21
  import { createHash } from 'node:crypto'
22
22
 
@@ -53,6 +53,82 @@ export function emptyEntry(provider, model, subscription, estimated) {
53
53
  /** 单条日汇总最多记录多少条被吸收明细的键(云端据此排除重复,超出部分不再追溯) */
54
54
  export const MAX_ABSORBED_KEYS = 5000
55
55
 
56
+ // ---------- 原子落盘(Windows 友好) ----------
57
+ /**
58
+ * rename 的**瞬时**失败码。Windows 上目标文件被短暂占用时 renameSync 会抛这些:
59
+ * · 杀毒 / 搜索索引器刚扫过刚写完的临时文件;
60
+ * · 资源管理器预览、备份/同步工具正在读该文件;
61
+ * · 上一个 dsh 实例还没退干净(或同时跑了两个实例)。
62
+ * 这类「等一下就好」,退避重试即可;代码类错误(ENOENT、EISDIR…)不该重试。
63
+ */
64
+ const TRANSIENT_RENAME_CODES = new Set(['EPERM', 'EACCES', 'EBUSY'])
65
+ export function isTransientRenameError(e) {
66
+ return !!e && TRANSIENT_RENAME_CODES.has(String(e.code || ''))
67
+ }
68
+
69
+ /** 同步睡眠(Node 没有 sleepSync;Atomics.wait 不占 CPU) */
70
+ function sleepSync(ms) {
71
+ try {
72
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms)
73
+ } catch (e) {
74
+ const end = Date.now() + ms
75
+ while (Date.now() < end) { /* 无 SharedArrayBuffer 的极端环境下退化为忙等 */ }
76
+ }
77
+ }
78
+
79
+ /**
80
+ * 原子落盘:写临时文件 → rename 覆盖目标。
81
+ *
82
+ * · 临时文件名带 **pid**:两个实例各写各的临时文件,不会互相盖掉半个文件
83
+ * (旧实现固定用 `<file>.tmp`,两实例必然抢同一个临时文件)。
84
+ * · rename 遇瞬时占用时按 20/40/80/160ms 退避重试(默认 5 次,约 0.3s)。
85
+ * · 仍失败**不做**「直接覆盖写」:那会让并发读方看到半个 JSON,而 store.load()
86
+ * 一旦读到半个 JSON 会把文件改名为 `.corrupt-*` 并清空 —— 损失远大于「晚几秒落盘」。
87
+ * 数据留在内存里,由调用方稍后重试(见 index.js 的 writeRecords 重试链)。
88
+ *
89
+ * @returns {{ok:boolean, attempts:number, mode:'rename'|'failed', error?:Error|null, transient?:boolean}}
90
+ */
91
+ export function writeFileAtomic(filePath, data, opts) {
92
+ const o = opts || {}
93
+ const fs = Object.assign({ mkdirSync, writeFileSync, renameSync, unlinkSync }, o.fs || {})
94
+ const sleep = o.sleep || sleepSync
95
+ const tries = Math.max(1, Number(o.tries) || 5)
96
+ const tmp = filePath + '.' + process.pid + '.tmp'
97
+ const cleanup = () => { try { fs.unlinkSync(tmp) } catch (e) { /* 已被 rename 走或从未创建 */ } }
98
+ try {
99
+ fs.mkdirSync(dirname(filePath), { recursive: true })
100
+ fs.writeFileSync(tmp, data, 'utf8')
101
+ } catch (e) {
102
+ cleanup()
103
+ return { ok: false, attempts: 0, mode: 'failed', error: e, transient: isTransientRenameError(e) }
104
+ }
105
+ let attempts = 0
106
+ let last = null
107
+ for (let i = 0; i < tries; i++) {
108
+ attempts += 1
109
+ try {
110
+ fs.renameSync(tmp, filePath)
111
+ return { ok: true, attempts, mode: 'rename', error: last }
112
+ } catch (e) {
113
+ last = e
114
+ if (!isTransientRenameError(e)) break
115
+ if (i < tries - 1) sleep(20 * Math.pow(2, i))
116
+ }
117
+ }
118
+ cleanup()
119
+ return { ok: false, attempts, mode: 'failed', error: last, transient: isTransientRenameError(last) }
120
+ }
121
+
122
+ /** 给用户看的失败原因(区分「被占用」与「文件系统错误」) */
123
+ function explainPersistError(res) {
124
+ if (res.transient) {
125
+ return '记录文件被占用(杀毒/索引器/备份工具正在读它,或另有一个 dsh 实例在跑;'
126
+ + 'Windows 上 rename 需要目标文件的删除权限,被占用时会失败)'
127
+ }
128
+ return '文件系统错误(不是占用问题)'
129
+ }
130
+
131
+
56
132
  /**
57
133
  * 由插件侧统一计算明细的内容哈希键(与云端契约 §6 一致)。
58
134
  * 这里即时计算而不是在 store 里 import sync.js —— 该函数只依赖 node:crypto,
@@ -299,17 +375,45 @@ export function createStore(filePath, opts) {
299
375
  return r
300
376
  }
301
377
 
302
- function persist() {
303
- try {
304
- mkdirSync(dirname(filePath), { recursive: true })
305
- const tmp = filePath + '.tmp'
306
- writeFileSync(tmp, JSON.stringify({ v: 2, seq, resetEpoch, details, rollups }), 'utf8')
307
- renameSync(tmp, filePath)
378
+ // 落盘失败只报一次(避免每 1.5 秒刷屏);恢复后又失败会再次提示
379
+ let persistWarned = false
380
+ // 最近一次失败的原因(供调用方在重试链耗尽后打印)
381
+ let lastPersistError = null
382
+ let lastPersistTransient = false
383
+ /** 供调用方在「自己还有重试机会」时静默(quiet=1),等重试链耗尽再报一次 */
384
+ function persistProblemText(res) {
385
+ return 'cost tracker persist failed: ' + ((res.error && res.error.message) || String(res.error))
386
+ + '\n 原因:' + explainPersistError(res)
387
+ + '\n 影响:数据仍在内存中,会在下一次写入时自动重试(不会丢);'
388
+ + '若反复出现,请确认没有同时运行两个 dsh 实例'
389
+ }
390
+ function persist(opts) {
391
+ const o = opts || {}
392
+ const res = writeFileAtomic(filePath, JSON.stringify({ v: 2, seq, resetEpoch, details, rollups }), o)
393
+ if (res.ok) {
394
+ lastPersistError = null
395
+ lastPersistTransient = false
396
+ if (res.attempts > 1 && !persistWarned) {
397
+ persistWarned = true
398
+ console.error('cost tracker persist: 文件被短暂占用,重试 ' + res.attempts + ' 次后已写入('
399
+ + explainPersistError({ transient: true }) + ')')
400
+ } else if (res.attempts === 1) {
401
+ persistWarned = false
402
+ }
308
403
  return true
309
- } catch (e) {
310
- console.error('cost tracker persist failed', e)
311
- return false
312
404
  }
405
+ lastPersistError = res.error
406
+ lastPersistTransient = res.transient === true
407
+ if (!o.quiet && !persistWarned) {
408
+ persistWarned = true
409
+ console.error(persistProblemText(res))
410
+ }
411
+ return false
412
+ }
413
+ /** 重试链彻底放弃时由调用方打印(保证「只在真的没救时」才出现一次) */
414
+ function persistProblem() {
415
+ persistWarned = true
416
+ return persistProblemText({ error: lastPersistError, transient: lastPersistTransient })
313
417
  }
314
418
 
315
419
  function clear() {
@@ -328,7 +432,7 @@ export function createStore(filePath, opts) {
328
432
  }
329
433
 
330
434
  return {
331
- details, rollups, load, add, persist, clear, counts,
435
+ details, rollups, load, add, persist, persistProblem, clear, counts,
332
436
  /** 当前最大序号(云端水位比较用) */
333
437
  maxSeq: () => seq,
334
438
  /** 清空次数(参与去重键) */