@angelyeye/dsh-cost-tracker 1.8.9 → 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 +24 -0
- package/README.md +13 -0
- package/index.js +31 -3
- package/package.json +1 -1
- package/store.js +115 -11
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,30 @@
|
|
|
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
|
+
|
|
5
29
|
## v1.8.9(2026-09-17)
|
|
6
30
|
|
|
7
31
|
**修正档位文案:「平峰」→「不分峰谷」,且为 0 时不再占图例**
|
package/README.md
CHANGED
|
@@ -238,6 +238,19 @@ 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
|
+
|
|
241
254
|
### v1.8.9(2026-09-17)
|
|
242
255
|
|
|
243
256
|
**修正档位文案:「平峰」→「不分峰谷」,且为 0 时不再占图例**
|
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.
|
|
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
|
-
|
|
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
|
|
|
@@ -1381,7 +1407,9 @@ export default {
|
|
|
1381
1407
|
startSyncTimer()
|
|
1382
1408
|
if (cloudConfig.cloudEnabled) scheduleSync(5000)
|
|
1383
1409
|
ctx.effect(() => () => {
|
|
1384
|
-
|
|
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.
|
|
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
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
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
|
/** 清空次数(参与去重键) */
|