@angelyeye/dsh-cost-tracker 1.8.12 → 1.8.14

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/index.js CHANGED
@@ -10,16 +10,21 @@ import { readFileSync, writeFileSync, mkdirSync, renameSync, existsSync, realpat
10
10
  import { join, dirname } from 'node:path'
11
11
  import { homedir } from 'node:os'
12
12
  import { createStore, collectTotals, DETAIL_DAYS, MAX_AXIS_DAYS } from './store.js'
13
- import { PRICE_ERAS, V41_EFFECTIVE_AT, V41_PRO_ROUTE_AT, exactModelsAt, eraAt, SUBSCRIPTION_RATES, PROVIDER_RATES, GENERIC_RATES, PEAK_WINDOWS, PEAK_HOUR_WINDOWS, isPeak, peakPhaseAt, priceFor, computeCost, normalizeTokens } from './pricing.js'
13
+ import { PRICE_ERAS, V41_EFFECTIVE_AT, V41_PRO_ROUTE_AT, exactModelsAt, eraAt, SUBSCRIPTION_RATES, PROVIDER_RATES, GENERIC_RATES, PEAK_WINDOWS, PEAK_HOUR_WINDOWS, isPeak, peakPhaseAt, priceFor, computeCost, normalizeTokens, subscriptionPlanFor, volcenginePlanModels, VOLCENGINE_PLAN_PROVIDER_KEYS, VOLCENGINE_PLAN_RATES } from './pricing.js'
14
14
  import {
15
15
  normalizePeakConfig, defaultPeakConfig, peakEffective,
16
16
  normalizeCloudConfig, defaultCloudConfig, normalizePluginConfig,
17
+ normalizeUiConfig, defaultUiConfig, UI_SURFACES,
18
+ normalizeVolcengineConfig, defaultVolcengineConfig,
17
19
  } from './config.js'
20
+ import {
21
+ queryVolcenginePlan, VOLCENGINE_KEY_ENVS, VOLCENGINE_SECRET_ENVS, VOLC_WINDOW_LABELS,
22
+ } from './volcengine.js'
18
23
  import { createSyncEngine, setPluginVersion, SOURCE as SYNC_SOURCE, SYNC_VERSION, loadIdentity } from './sync.js'
19
24
  import { Schema } from './schema.js'
20
25
 
21
26
  /** 插件版本(写入上报信封,便于云端排查版本差异) */
22
- const PLUGIN_VERSION = '1.8.12'
27
+ const PLUGIN_VERSION = '1.8.14'
23
28
  setPluginVersion(PLUGIN_VERSION)
24
29
 
25
30
  /** 「设置 → 插件 → 插件配置」里的卡片字段(与 settings 命名空间一致) */
@@ -35,6 +40,13 @@ const SyncSchema = Schema.object({
35
40
  syncRollups: Schema.boolean().default(undefined).description('上报历史日汇总快照'),
36
41
  syncSinceDays: Schema.natural().default(undefined).description('补传起始窗口天数(0 = 不限)'),
37
42
  cloudView: Schema.string().default(undefined).description('看板视图:local / local+cloud / cloud'),
43
+ // 界面显示(v1.8.12):三个前端落点各自显隐,缺省/非布尔 = 可见
44
+ uiDockEnabled: Schema.boolean().default(undefined).description('显示输入框上方的花费胶囊'),
45
+ uiPeakEnabled: Schema.boolean().default(undefined).description('显示侧边栏峰谷时段条'),
46
+ uiDashboardEnabled: Schema.boolean().default(undefined).description('显示设置页「花费统计」看板'),
47
+ // 火山方舟配额(v1.8.14):留空即回落凭据发现链,老配置零改动可用
48
+ volcengineAccessKeyId: Schema.string().default(undefined).description('火山引擎 AccessKeyID(留空则用凭据库 / 环境变量)'),
49
+ volcengineSecretAccessKey: Schema.string().role('secret').default(undefined).description('火山引擎 SecretAccessKey(留空则用凭据库 / 环境变量)'),
38
50
  })
39
51
 
40
52
  // ============================================================
@@ -155,6 +167,11 @@ export default {
155
167
  // ---------- state ----------
156
168
  // 注意:records/rollups 在 persistence 段由 store 初始化(details/rollups 引用)
157
169
  let kimiCache = null
170
+ // 火山方舟配额缓存(与 kimiCache 同形:{ fetchedAt, data },120s TTL)
171
+ let volcengineCache = null
172
+ // 最近一次实际使用的 provider(归一化后)。用于判断「用户当下正在用哪家订阅」,
173
+ // 从而只预热该家的配额缓存,不为无关厂商发网络请求。
174
+ let lastProviderSeen = ''
158
175
 
159
176
  // ---------- small helpers ----------
160
177
  function pad2(n) { return n < 10 ? '0' + n : '' + n }
@@ -163,6 +180,16 @@ export default {
163
180
  function r2(x) { return Math.round(x * 100) / 100 }
164
181
  function r4(x) { return Math.round(x * 10000) / 10000 }
165
182
  function normProvider(p) { return toStr(p).toLowerCase().replace(/-official$/, '') }
183
+ /**
184
+ * 是否属于火山方舟(含用户自定的 Coding Plan provider 别名)。
185
+ * 用于「该不该预热/展示火山配额面板」这一判断——只看 provider 名即可,
186
+ * 与计费侧的模型级订阅判定(subscriptionPlanFor)是两件事。
187
+ */
188
+ function isVolcengineProvider(np) {
189
+ const n = toStr(np).toLowerCase()
190
+ if (VOLCENGINE_PLAN_PROVIDER_KEYS.indexOf(n) >= 0) return true
191
+ return /volcengine|volces|ark-?coding|byteblus|byteplus/.test(n)
192
+ }
166
193
  function dayKey(ts) {
167
194
  const d = new Date(ts + 28800000)
168
195
  return d.getUTCFullYear() + '-' + pad2(d.getUTCMonth() + 1) + '-' + pad2(d.getUTCDate())
@@ -217,6 +244,8 @@ export default {
217
244
  const CONFIG_FILE = join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'storages', 'cost-tracker-config.json')
218
245
  let peakConfig = defaultPeakConfig()
219
246
  let cloudConfig = defaultCloudConfig()
247
+ let uiConfig = defaultUiConfig()
248
+ let volcengineConfig = defaultVolcengineConfig()
220
249
  let configLoadWarned = false
221
250
 
222
251
  function loadConfig() {
@@ -225,6 +254,8 @@ export default {
225
254
  const parsed = JSON.parse(readFileSync(CONFIG_FILE, 'utf8'))
226
255
  peakConfig = normalizePeakConfig(parsed)
227
256
  cloudConfig = normalizeCloudConfig(parsed)
257
+ uiConfig = normalizeUiConfig(parsed)
258
+ volcengineConfig = normalizeVolcengineConfig(parsed)
228
259
  } catch (e) {
229
260
  if (!configLoadWarned) { console.error('cost tracker config load failed, using defaults', e); configLoadWarned = true }
230
261
  }
@@ -234,7 +265,7 @@ export default {
234
265
  try {
235
266
  mkdirSync(dirname(CONFIG_FILE), { recursive: true })
236
267
  const tmp = CONFIG_FILE + '.tmp'
237
- writeFileSync(tmp, JSON.stringify(Object.assign({}, peakConfig, cloudConfig)), 'utf8')
268
+ writeFileSync(tmp, JSON.stringify(Object.assign({}, peakConfig, cloudConfig, uiConfig, volcengineConfig)), 'utf8')
238
269
  renameSync(tmp, CONFIG_FILE)
239
270
  return true
240
271
  } catch (e) {
@@ -255,6 +286,20 @@ export default {
255
286
  return cloudConfig
256
287
  }
257
288
 
289
+ /** 界面显示开关:显式写 false 才隐藏,缺省保持可见(老配置升级后界面不变) */
290
+ function setUiConfig(raw) {
291
+ uiConfig = normalizeUiConfig(Object.assign({}, uiConfig, raw))
292
+ saveConfig()
293
+ return uiConfig
294
+ }
295
+
296
+ /** 火山方舟配额凭据:空串 = 未配置 = 走凭据发现链(凭据库 / 环境变量) */
297
+ function setVolcengineConfig(raw) {
298
+ volcengineConfig = normalizeVolcengineConfig(Object.assign({}, volcengineConfig, raw))
299
+ saveConfig()
300
+ return volcengineConfig
301
+ }
302
+
258
303
  // ---------- settings 命名空间(可选服务) ----------
259
304
  // 字段全部 .default(undefined):只有用户在卡片里显式保存才写入用户层,
260
305
  // 从而不覆盖我们自己配置文件里的既有值。
@@ -268,9 +313,35 @@ export default {
268
313
  const patch = {}
269
314
  for (const k of Object.keys(next)) if (next[k] !== undefined) patch[k] = next[k]
270
315
  if (!Object.keys(patch).length) return
271
- const before = JSON.stringify(cloudConfig)
272
- cloudConfig = normalizeCloudConfig(Object.assign({}, cloudConfig, patch))
273
- if (JSON.stringify(cloudConfig) !== before) saveConfig()
316
+ // 卡片里既有云端同步字段、界面显示字段,也有火山方舟凭据字段,
317
+ // 分给各自的规范化函数(互不覆盖)。
318
+ const cloudPatch = {}
319
+ const uiPatch = {}
320
+ const volcPatch = {}
321
+ for (const [k, v] of Object.entries(patch)) {
322
+ if (UI_SURFACES.some((s) => s.key === k)) uiPatch[k] = v
323
+ else if (k === 'volcengineAccessKeyId' || k === 'volcengineSecretAccessKey') volcPatch[k] = v
324
+ else cloudPatch[k] = v
325
+ }
326
+ let changed = false
327
+ if (Object.keys(cloudPatch).length) {
328
+ const before = JSON.stringify(cloudConfig)
329
+ cloudConfig = normalizeCloudConfig(Object.assign({}, cloudConfig, cloudPatch))
330
+ if (JSON.stringify(cloudConfig) !== before) changed = true
331
+ }
332
+ if (Object.keys(uiPatch).length) {
333
+ const before = JSON.stringify(uiConfig)
334
+ uiConfig = normalizeUiConfig(Object.assign({}, uiConfig, uiPatch))
335
+ if (JSON.stringify(uiConfig) !== before) changed = true
336
+ }
337
+ if (Object.keys(volcPatch).length) {
338
+ const before = JSON.stringify(volcengineConfig)
339
+ volcengineConfig = normalizeVolcengineConfig(Object.assign({}, volcengineConfig, volcPatch))
340
+ if (JSON.stringify(volcengineConfig) !== before) changed = true
341
+ // 凭据变更后作废缓存,用户改完 Key 立刻能拿到新结果,不必等 TTL 到期
342
+ volcengineCache = null
343
+ }
344
+ if (changed) saveConfig()
274
345
  }
275
346
 
276
347
  function installSettingsSection(provider, owner) {
@@ -319,6 +390,8 @@ export default {
319
390
  peakWindows: PEAK_WINDOWS,
320
391
  peakHours: PEAK_HOUR_WINDOWS,
321
392
  effectiveAt: peakConfig.peakEffectiveAt,
393
+ // 前端显隐开关(只影响渲染;与峰谷计价本身无关,因此不参与 enabled/effective 判定)
394
+ ui: Object.assign({}, uiConfig),
322
395
  now,
323
396
  }
324
397
  }
@@ -358,6 +431,8 @@ export default {
358
431
  const model = toStr(options && options.model)
359
432
  if (!provider && !model) return
360
433
  const np = normProvider(provider)
434
+ // 记下最近一次实际使用的 provider:summary 据此判断该预热哪家的配额缓存
435
+ if (np) lastProviderSeen = np
361
436
  // 按「调用发生的时刻」选单价版本(跨 2026-09-10 12:00 / 2026-09-14 12:00 自动切换,无需重启)。
362
437
  const price = priceFor(np, model, ts)
363
438
  // 峰谷计费开关:随配置峰谷启用 + 生效时间门控;未启用时按非峰谷档(平价)计费。
@@ -413,15 +488,43 @@ export default {
413
488
  }
414
489
 
415
490
  // ---------- key resolution ----------
491
+ /** 凭据文件路径:与数据/store 同源,跟随 DSH_HOME(此前硬编码 ~/.dsh,
492
+ * 在 DSH_HOME 被重定向的部署——含本仓库的沙箱测试——下永远读不到)。 */
493
+ function credFilePath() {
494
+ return join(process.env.DSH_HOME || join(homedir(), '.dsh'), '.credentials.yaml')
495
+ }
496
+
497
+ /**
498
+ * 从 .credentials.yaml 读取某个环境变量对应的值。
499
+ *
500
+ * 真实文件是以 `refs:` 段**缩进**存放的:
501
+ * refs:
502
+ * VOLC_ACCESSKEY: AKxxxx
503
+ * 早先的正则只匹配行首无缩进的键,于是所有键都读不出来 —— 这一路兜底
504
+ * 一直静默失效(有宿主凭据服务时被掩盖,没有时就直接报「未找到 Key」)。
505
+ * 现在允许缩进,并优先在 `refs:` 段内匹配;同时保留对「无缩进的旧版
506
+ * 平铺文件」的兼容。
507
+ */
416
508
  function readCredFile(envName) {
417
509
  try {
418
- const p = join(homedir(), '.dsh', '.credentials.yaml')
419
- const t = readFileSync(p, 'utf8')
510
+ const t = readFileSync(credFilePath(), 'utf8')
420
511
  const lines = t.split(/\r?\n/)
512
+ let inRefs = false
513
+ let fallback = ''
421
514
  for (const line of lines) {
422
- const m = line.match(/^([A-Za-z0-9_]+):\s*(.+)\s*$/)
423
- if (m && m[1] === envName) return m[2]
515
+ if (/^\S/.test(line)) {
516
+ // 顶层键:进入/离开 refs 段(records 等其它段不应被误读)
517
+ inRefs = /^refs\s*:/.test(line)
518
+ if (/^[A-Za-z0-9_]+\s*:/.test(line)) continue
519
+ }
520
+ const m = line.match(/^\s*([A-Za-z0-9_]+)\s*:\s*(.+?)\s*$/)
521
+ if (!m || m[1] !== envName) continue
522
+ const value = m[2].replace(/^["']|["']$/g, '')
523
+ if (!value) continue
524
+ if (inRefs) return value // refs 段内命中:最可信,立即返回
525
+ if (!fallback) fallback = value // 段外的同名键:留作兜底
424
526
  }
527
+ return fallback
425
528
  } catch (e) {}
426
529
  return ''
427
530
  }
@@ -532,6 +635,119 @@ export default {
532
635
  return data
533
636
  }
534
637
 
638
+ // ---------- volcengine (火山方舟) coding plan quota ----------
639
+ // 与 kimi 的差别:方舟配额走管控面 OpenAPI,需 AccessKeyID + SecretAccessKey
640
+ // 成对做 HMAC 签名(不是 Bearer),签名与解析在 volcengine.js 里(纯函数可单测)。
641
+
642
+ /** 环境变量名候选:用户自定 provider 的 apiKeyEnv 优先,其后是 SDK 约定名 */
643
+ function volcengineEnvCandidates() {
644
+ const out = []
645
+ const settings = ctx.get('settings')
646
+ if (settings) {
647
+ try {
648
+ const v = settings.get('llm-pi-ai')
649
+ const providers = (v && v.providers) || {}
650
+ for (const [id, p] of Object.entries(providers)) {
651
+ if (!p) continue
652
+ const base = String(p.baseURL || '')
653
+ const looksArkCoding = /ark\.cn-beijing\.volces\.com\/api\/coding/i.test(base)
654
+ const looksVolc = /volcengine/i.test(id) || /volces\.com/i.test(base)
655
+ if (!looksArkCoding && !looksVolc) continue
656
+ if (p.apiKeyEnv) out.push(String(p.apiKeyEnv))
657
+ }
658
+ } catch (e) {}
659
+ }
660
+ return out
661
+ }
662
+
663
+ /** 在候选名单里逐个查凭据库 + .credentials.yaml,返回首个命中 */
664
+ async function resolveAnyEnv(names) {
665
+ for (const n of names) {
666
+ if (!n) continue
667
+ const v = await resolveApiKey(n)
668
+ if (v.value) return { value: v.value, source: v.source + ':' + n, env: n }
669
+ }
670
+ return { value: '', source: 'none', env: names[0] || '' }
671
+ }
672
+
673
+ function emptyVolcengine(error, keySource, keyEnv) {
674
+ return {
675
+ ok: false, error,
676
+ windows: {}, windowList: [],
677
+ planType: '', action: '', updateTime: 0,
678
+ fetchedAt: Date.now(), keySource, keyEnv,
679
+ }
680
+ }
681
+
682
+ /** 把 volcengine.js 的 windows 归一成客户端要好用的形状(带 label,便于直接渲染) */
683
+ function volcengineWindowList(windows) {
684
+ const order = ['fiveHour', 'weekly', 'monthly', 'daily']
685
+ const list = []
686
+ for (const name of order) {
687
+ const w = windows[name]
688
+ if (!w) continue
689
+ list.push({ name, label: VOLC_WINDOW_LABELS[name] || name, percent: w.percent, resetsAt: w.resetsAt, quota: w.quota, used: w.used })
690
+ }
691
+ // 未识别的窗口名附在末尾(接口结构变化时不静默丢弃)
692
+ for (const name of Object.keys(windows)) {
693
+ if (order.indexOf(name) >= 0) continue
694
+ const w = windows[name]
695
+ list.push({ name, label: VOLC_WINDOW_LABELS[name] || name, percent: w.percent, resetsAt: w.resetsAt, quota: w.quota, used: w.used })
696
+ }
697
+ return list
698
+ }
699
+
700
+ /**
701
+ * 查询火山方舟 Coding Plan 配额。
702
+ * 凭据发现链:配置卡片字段 → 凭据库 / .credentials.yaml → 环境变量约定名。
703
+ * 全部失败一律软失败(ok:false + 中文原因),绝不抛到路由层。
704
+ * **返回值只含 keySource/keyEnv,绝不回显 AK/SK 本身。**
705
+ */
706
+ async function volcengineUsage(force) {
707
+ const now = Date.now()
708
+ if (!force && volcengineCache && now - volcengineCache.fetchedAt < 120000) return volcengineCache.data
709
+ const idEnvs = volcengineEnvCandidates().concat(VOLCENGINE_KEY_ENVS)
710
+ const secretEnvs = volcengineEnvCandidates().concat(VOLCENGINE_SECRET_ENVS)
711
+ let data
712
+ try {
713
+ let id = String(volcengineConfig.volcengineAccessKeyId || '')
714
+ let secret = String(volcengineConfig.volcengineSecretAccessKey || '')
715
+ let keySource = id ? 'config' : 'none'
716
+ let keyEnv = idEnvs[0] || 'VOLC_ACCESSKEY'
717
+ if (!id || !secret) {
718
+ const rid = await resolveAnyEnv(idEnvs)
719
+ const rsec = await resolveAnyEnv(secretEnvs)
720
+ if (!id && rid.value) { id = rid.value; keySource = rid.source; keyEnv = rid.env }
721
+ if (!secret && rsec.value) secret = rsec.value
722
+ }
723
+ if (!id || !secret) {
724
+ data = emptyVolcengine(
725
+ '未找到火山引擎访问密钥(需 AccessKeyID + SecretAccessKey)。配额查询走方舟管控面,'
726
+ + '与推理用的 ARK API Key 是两套凭据;请配置 ' + keyEnv + ' / VOLC_SECRETKEY,'
727
+ + '或在插件配置卡片里填写。',
728
+ keySource, keyEnv,
729
+ )
730
+ } else {
731
+ const r = await queryVolcenginePlan({ accessKeyId: id, secretAccessKey: secret })
732
+ const windows = r.windows || {}
733
+ data = {
734
+ ok: true, error: '',
735
+ windows,
736
+ windowList: volcengineWindowList(windows),
737
+ planType: '',
738
+ action: toStr(r.action),
739
+ updateTime: 0,
740
+ fetchedAt: Date.now(),
741
+ keySource, keyEnv,
742
+ }
743
+ }
744
+ } catch (e) {
745
+ data = emptyVolcengine(toStr(e && e.message ? e.message : e), 'none', idEnvs[0] || 'VOLC_ACCESSKEY')
746
+ }
747
+ volcengineCache = { fetchedAt: now, data }
748
+ return data
749
+ }
750
+
535
751
  // ---------- deepseek balance ----------
536
752
  async function balance(args) {
537
753
  const manual = args && typeof args.apiKey === 'string' ? args.apiKey.trim() : ''
@@ -610,6 +826,12 @@ export default {
610
826
  v41EffectiveAt: V41_EFFECTIVE_AT,
611
827
  v41ProRouteAt: V41_PRO_ROUTE_AT,
612
828
  subscription: SUBSCRIPTION_RATES,
829
+ // 火山方舟 Coding Plan 订阅:套餐内模型清单(等效参考价,非真实扣费)
830
+ volcenginePlan: {
831
+ providers: VOLCENGINE_PLAN_PROVIDER_KEYS,
832
+ models: Object.keys(volcenginePlanModels()),
833
+ rates: VOLCENGINE_PLAN_RATES,
834
+ },
613
835
  providers: PROVIDER_RATES,
614
836
  generic: GENERIC_RATES,
615
837
  }
@@ -807,13 +1029,21 @@ export default {
807
1029
  } catch (e) {}
808
1030
  }
809
1031
  const np = normProvider(provider)
810
- const subscription = !!SUBSCRIPTION_RATES[np]
1032
+ // 订阅判定必须带模型:同一 provider 下可能既有套餐内模型也有按量模型
1033
+ // (火山方舟即如此),只看 provider 会把按量调用错记成订阅。
1034
+ const subscription = !!subscriptionPlanFor(np, model)
1035
+ const isVolc = isVolcengineProvider(np)
811
1036
  let kimiWeeklyRemaining = null
812
1037
  // 只要当前选择是订阅,或本会话实际用了订阅,就刷新 kimi 周配额
813
1038
  if (subscription || sessionSub > 0) {
814
1039
  if (!kimiCache || now - kimiCache.fetchedAt >= 120000) kimiUsage(false).catch(() => {})
815
1040
  if (kimiCache && kimiCache.data && kimiCache.data.ok) kimiWeeklyRemaining = kimiCache.data.weekly.remaining
816
1041
  }
1042
+ // 火山的预热条件与 kimi 同源:当前选中的是火山订阅,或最近一次调用就走火山。
1043
+ // 面板自己也会主动拉取(volcengine-usage),这里只是让它在「正在用」时自动出数。
1044
+ if (isVolc || isVolcengineProvider(lastProviderSeen)) {
1045
+ if (!volcengineCache || now - volcengineCache.fetchedAt >= 120000) volcengineUsage(false).catch(() => {})
1046
+ }
817
1047
  return {
818
1048
  sessionCost: r4(sessionCost), sessionCalls,
819
1049
  sessionSub: r4(sessionSub), sessionSubCalls,
@@ -827,6 +1057,7 @@ export default {
827
1057
  peak: peakEffective(peakConfig, now) ? isPeak(now) : false,
828
1058
  subscription,
829
1059
  kimiWeeklyRemaining,
1060
+ volcengineActive: isVolc,
830
1061
  }
831
1062
  }
832
1063
 
@@ -834,6 +1065,7 @@ export default {
834
1065
  const n = store.counts().calls
835
1066
  store.clear()
836
1067
  kimiCache = null
1068
+ volcengineCache = null
837
1069
  persistNow()
838
1070
  return { ok: true, cleared: n }
839
1071
  }
@@ -964,7 +1196,7 @@ export default {
964
1196
  // ---------- cloud sync ----------
965
1197
  // 同步引擎:只上报、不回写;失败只影响云端视图,绝不影响本地记账。
966
1198
  const syncEngine = createSyncEngine({
967
- getConfig: () => Object.assign({}, peakConfig, cloudConfig),
1199
+ getConfig: () => Object.assign({}, peakConfig, cloudConfig, uiConfig),
968
1200
  getSnapshot: () => ({
969
1201
  details: records,
970
1202
  rollups,
@@ -1162,6 +1394,7 @@ export default {
1162
1394
  summary: (args) => buildSummary(args),
1163
1395
  dashboard: (args) => buildDashboard(args),
1164
1396
  'kimi-usage': (args) => kimiUsage(!!(args && args.force)),
1397
+ 'volcengine-usage': (args) => volcengineUsage(!!(args && args.force)),
1165
1398
  balance: (args) => balance(args),
1166
1399
  export: () => exportCsv(),
1167
1400
  prices: () => prices(),
@@ -1169,7 +1402,15 @@ export default {
1169
1402
  usage: () => buildUsageHeat(),
1170
1403
  peak: () => peakSnapshot(),
1171
1404
  'peak-config': (args) => setPeakConfig(args),
1172
- sync: () => syncEngine.status(),
1405
+ // 界面显示三开关(设置卡片的「界面显示」分组):patch 里只带这几个键,写回后原样回显
1406
+ 'ui-config': (args) => Object.assign({ ok: true }, setUiConfig(args || {})),
1407
+ // 火山方舟配额凭据:只回显是否已配置,**绝不回显 SecretAccessKey 明文**
1408
+ 'volcengine-config': (args) => {
1409
+ setVolcengineConfig(args || {})
1410
+ return Object.assign({ ok: true, volcengineHasKeys: !!(volcengineConfig.volcengineAccessKeyId && volcengineConfig.volcengineSecretAccessKey) })
1411
+ },
1412
+ // 同步状态里一并带上界面显示开关:配置卡片只需一次往返就能初始化表单
1413
+ sync: () => Object.assign({}, syncEngine.status(), uiConfig),
1173
1414
  'sync-now': async (args) => {
1174
1415
  const result = await syncEngine.runOnce({ manual: true, full: !!(args && args.full) })
1175
1416
  return Object.assign({ ok: result.ok !== false || !result.error, result }, syncEngine.status())
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@angelyeye/dsh-cost-tracker",
3
- "version": "1.8.12",
3
+ "version": "1.8.14",
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",
@@ -13,6 +13,7 @@
13
13
  "config.js",
14
14
  "schema.js",
15
15
  "sync.js",
16
+ "volcengine.js",
16
17
  "cordis.patch.yml",
17
18
  "CHANGELOG.md"
18
19
  ],
@@ -20,10 +21,11 @@
20
21
  ".": "./index.js",
21
22
  "./client": "./client.js",
22
23
  "./view": "./view.js",
24
+ "./volcengine": "./volcengine.js",
23
25
  "./package.json": "./package.json"
24
26
  },
25
27
  "scripts": {
26
- "test": "node test/storage.test.js && node test/pricing.test.js && node test/config.test.js && node test/recompute.test.js && node test/client-registration.test.js && node test/client-render.test.js && node test/cloud-read.test.js && node --no-warnings test/cloud-view-e2e.test.js && node test/sync.test.js && node test/view.test.js"
28
+ "test": "node test/storage.test.js && node test/pricing.test.js && node test/volcengine-plan.test.js && node test/volcengine-host.test.js && node test/config.test.js && node test/recompute.test.js && node test/client-registration.test.js && node test/ui-display.test.js && node test/client-render.test.js && node test/cloud-read.test.js && node --no-warnings test/cloud-view-e2e.test.js && node test/sync.test.js && node test/view.test.js"
27
29
  },
28
30
  "keywords": [
29
31
  "dsh-plugin",
package/pricing.js CHANGED
@@ -180,6 +180,163 @@ export const SUBSCRIPTION_RATES = {
180
180
  kimi: { input: 6.5, output: 27.0, cacheRead: 1.1, cacheWrite: 1.1 },
181
181
  }
182
182
 
183
+ /**
184
+ * 订阅套餐的**模型白名单**:provider 键 → 该套餐覆盖的模型。
185
+ *
186
+ * 为什么必须有这层:订阅制的判定原先只看 provider 名。这对 Kimi 成立
187
+ * (kimi 全部走订阅),但**火山方舟不是**——同一个 provider 下既有
188
+ * Coding Plan 套餐内的模型(订阅,不按量扣费),也有套餐外的模型
189
+ * (按量计费)。只看 provider 会把按量调用错记为订阅,金额从「真实花费」
190
+ * 里凭空消失,且原始记录被标成 subscription 后无法自动回滚。
191
+ *
192
+ * 值为 null 表示「该 provider 全部模型都属于这个套餐」(Kimi 即如此,
193
+ * 保持 1.8.13 及以前的既有行为逐字节不变)。
194
+ * 值为数组时按**归一化模型名**匹配(见 normalizeModelName),
195
+ * 另可用 `prefixes` 放行整族模型(如方舟自动调度的 ark-code 系)。
196
+ */
197
+ export const SUBSCRIPTION_MODELS = {
198
+ 'kimi-coding': null,
199
+ kimi: null,
200
+ }
201
+
202
+ /**
203
+ * 火山方舟(Volcengine Ark)Coding Plan 订阅套餐。
204
+ *
205
+ * provider 名由用户在 DSH 里自定,故登记多个常见别名(normProvider 已剥离
206
+ * `-official` 后缀)。用户实测 provider 为 `byteblus-coding-plan-cn`
207
+ * (baseURL 指向 ark.cn-beijing.volces.com/api/coding/v3),一并纳入。
208
+ *
209
+ * 模型白名单:套餐内含多厂商模型。**同名模型在按量侧也存在**
210
+ * (如 doubao-seed-2.0-pro、deepseek-v4-pro),因此判定必须靠
211
+ * 「provider 命中 + 模型在白名单内」双重限定,缺一不可。
212
+ *
213
+ * ⚠️ 单价口径(**估算,非官方账单**):套餐内的模型各自牌价差异很大
214
+ * (豆包 / GLM / Kimi / DeepSeek / MiniMax 各档不同),而套餐只有一个
215
+ * 固定月费、按窗口百分比计量,**官方没有给出「套餐内某次调用的等效单价」**。
216
+ * 故此处取**单一代表价**,与既有 Kimi 订阅(同样一个价位代表整档套餐)
217
+ * 的口径一致,仅用于横向比较订阅是否划算。
218
+ * 未逐一登记各模型第三方报价:可核实到的多为聚合站的美元估价,
219
+ * 与方舟官方人民币牌价不可直接对照,按本仓库「不编造价格」的约定不收录。
220
+ * 要精确到模型,请以方舟控制台账单为准。
221
+ */
222
+ const VOLC_PLAN_RATES = { input: 3.0, output: 12.0, cacheRead: 0.6, cacheWrite: 0.6 }
223
+
224
+ /** 火山方舟 Coding Plan 覆盖的 provider 别名 */
225
+ export const VOLCENGINE_PLAN_PROVIDER_KEYS = [
226
+ 'volcengine',
227
+ 'volcengine-coding',
228
+ 'volcengine-plan',
229
+ 'volcengine-coding-plan',
230
+ 'byteblus-coding-plan-cn',
231
+ 'byteplus-coding-plan-cn',
232
+ ]
233
+
234
+ /**
235
+ * **专属 Coding Plan 端点**的 provider(baseURL 指向 `.../api/coding/v3`)。
236
+ *
237
+ * 与上面的泛 `volcengine` 别名区别对待:这类 provider 本身就是订阅入口,
238
+ * 其可调模型全部来自套餐(调用套餐外模型需另配 `/api/v3` 在线推理 provider,
239
+ * 那属于另一个 provider 名),因此**不再逐模型限定**——这也解决了
240
+ * 「模型 id 带日期后缀、清单永远追不上」的问题。
241
+ *
242
+ * 泛 `volcengine` 走另一个分支:必须靠模型白名单,因为同一个 provider 下
243
+ * 套餐内外的模型混在一起(接入点 id 形如 ep-xxxx 就是按量)。
244
+ */
245
+ export const VOLCENGINE_PLAN_DEDICATED_PROVIDERS = [
246
+ 'byteblus-coding-plan-cn',
247
+ 'byteplus-coding-plan-cn',
248
+ 'volcengine-coding',
249
+ 'volcengine-plan',
250
+ 'volcengine-coding-plan',
251
+ ]
252
+
253
+ /**
254
+ * 火山方舟 Coding Plan 覆盖的具体模型(原始名,归一化后匹配)。
255
+ *
256
+ * 带上实测见到的**日期/版本后缀**变体:方舟模型 id 普遍带后缀
257
+ * (用户配置里就有 `glm-5-3-flash-260828`、`deepseek-v4-1-flash-260910`、
258
+ * `doubao-seed-2-1-pro-260915`),漏配的后果是订阅调用被当成未知模型、
259
+ * 标成「按量计费 · 价格为估算」——正是本次要修掉的那类误标。
260
+ */
261
+ const VOLCENGINE_PLAN_MODEL_IDS = [
262
+ 'ark-code-latest',
263
+ // 豆包
264
+ 'doubao-seed-code',
265
+ 'doubao-seed-2.0-code',
266
+ 'doubao-seed-2.0-pro',
267
+ 'doubao-seed-2.0-lite',
268
+ 'doubao-seed-2.1-pro',
269
+ // 智谱(含用户配置里的 5.3 flash 带日期变体)
270
+ 'glm-4.7',
271
+ 'glm-5.1',
272
+ 'glm-5.3-flash',
273
+ // Kimi / DeepSeek / MiniMax
274
+ 'kimi-k2.5',
275
+ 'deepseek-v3.2',
276
+ 'deepseek-v4-pro',
277
+ 'deepseek-v4.1-flash',
278
+ 'minimax-m2.5',
279
+ ]
280
+
281
+ /**
282
+ * 整族放行的模型前缀(归一化后)。
283
+ *
284
+ * **刻意收得很窄**:只放行方舟自动调度名(`ark-code-*`,会滚动升级,
285
+ * 逐一登记必然过期)。其余一律靠上面的显式清单——
286
+ * 前缀放太宽(如按 `deepseek` / `glm` 整族放行)会把该 provider 下
287
+ * 套餐外的按量模型一并算成订阅,金额从「真实花费」里消失,
288
+ * 那正是本门卫要防的方向,宁可漏配(可显式补清单)也不能错配。
289
+ */
290
+ export const VOLCENGINE_PLAN_MODEL_PREFIXES = ['arkcode']
291
+
292
+ export const VOLCENGINE_PLAN_RATES = VOLC_PLAN_RATES
293
+
294
+ /** 归一化模型名索引(惰性构建,与下方 eraIndex 同法,避免依赖声明顺序) */
295
+ let VOLC_MODEL_INDEX = null
296
+ function volcModelIndex() {
297
+ if (VOLC_MODEL_INDEX === null) {
298
+ VOLC_MODEL_INDEX = {}
299
+ for (const id of VOLCENGINE_PLAN_MODEL_IDS) VOLC_MODEL_INDEX[normalizeModelName(id)] = id
300
+ }
301
+ return VOLC_MODEL_INDEX
302
+ }
303
+
304
+ /** 供测试与展示:归一化模型名 → 套餐单价 */
305
+ export function volcenginePlanModels() {
306
+ const idx = volcModelIndex()
307
+ const out = {}
308
+ for (const k of Object.keys(idx)) out[k] = VOLC_PLAN_RATES
309
+ return out
310
+ }
311
+
312
+ /**
313
+ * 解析某次调用是否命中订阅套餐。
314
+ * @param {string} np - 归一化 provider 名
315
+ * @param {string} model - 模型名
316
+ * @returns {object|null} 命中返回单价表,否则 null
317
+ */
318
+ export function subscriptionPlanFor(np, model) {
319
+ const sub = SUBSCRIPTION_RATES[np]
320
+ if (sub) {
321
+ const allow = SUBSCRIPTION_MODELS[np]
322
+ // null = 该 provider 全部模型都属于订阅(Kimi:保持既有行为不变)
323
+ if (allow === null || allow === undefined) return sub
324
+ const n = normalizeModelName(model)
325
+ if (Array.isArray(allow) && allow.indexOf(n) >= 0) return sub
326
+ return null
327
+ }
328
+ // 火山方舟 Coding Plan:先看专属订阅端点的 provider(全部模型均属套餐),
329
+ // 再看泛 volcengine(必须靠模型白名单,因为套餐内外模型混在同一 provider 下)。
330
+ if (VOLCENGINE_PLAN_PROVIDER_KEYS.indexOf(np) < 0) return null
331
+ if (VOLCENGINE_PLAN_DEDICATED_PROVIDERS.indexOf(np) >= 0) return VOLC_PLAN_RATES
332
+ const n = normalizeModelName(model)
333
+ if (volcModelIndex()[n] !== undefined) return VOLC_PLAN_RATES
334
+ for (const p of VOLCENGINE_PLAN_MODEL_PREFIXES) {
335
+ if (n.startsWith(p)) return VOLC_PLAN_RATES
336
+ }
337
+ return null
338
+ }
339
+
183
340
  /** Provider 兜底单价(估算);缓存写入按缓存命中价计。
184
341
  * deepseek 兜底已同步至 V4.1 Flash 档(2.0/8.0/0.04),未知模型不再按旧价高估。 */
185
342
  export const PROVIDER_RATES = {
@@ -274,7 +431,8 @@ export function peakPhaseAt(ts, spanDays) {
274
431
  * 记账应以它入账;未命中精确表时为原模型名。
275
432
  */
276
433
  export function priceFor(np, model, ts) {
277
- if (SUBSCRIPTION_RATES[np]) return { rates: SUBSCRIPTION_RATES[np], tiered: false, estimated: true, subscription: true, model, era: null }
434
+ const sub = subscriptionPlanFor(np, model)
435
+ if (sub) return { rates: sub, tiered: false, estimated: true, subscription: true, model, era: null }
278
436
  const era = eraAt(ts)
279
437
  const hit = resolveModelInEra(era, model)
280
438
  if (hit) return { rates: era.models[hit], tiered: true, estimated: false, subscription: false, model: hit, era: era.id }