@angelyeye/dsh-cost-tracker 1.7.0

package/index.js

@@ -0,0 +1,962 @@
+// ============================================================
+// DSH 花费统计插件 —— Host 半端（静态版）
+// 由动态版 cost-tracker.host.js 改造而来：
+//   harness.handle  → webServer HTTP 路由（/api/cost-tracker/*）
+//   harness.*Tool   → ctx.tools.register
+//   subprocess node → 原生 fetch + node:fs
+//   新增数据持久化 → ~/.dsh/storages/cost-tracker-records.json
+// ============================================================
+import { readFileSync, writeFileSync, mkdirSync, renameSync, existsSync, realpathSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { homedir } from 'node:os'
+import { createStore, collectTotals, DETAIL_DAYS, MAX_AXIS_DAYS } from './store.js'
+import { PRICE_ERAS, V41_EFFECTIVE_AT, exactModelsAt, eraAt, SUBSCRIPTION_RATES, PROVIDER_RATES, GENERIC_RATES, PEAK_WINDOWS, PEAK_HOUR_WINDOWS, isPeak, peakPhaseAt, priceFor, computeCost, normalizeTokens } from './pricing.js'
+import { normalizePeakConfig, defaultPeakConfig, peakEffective } from './config.js'
+
+// ============================================================
+// 启动信息日志开关（默认静默）
+//   设置 DSH_COST_TRACKER_LOG=1（或 true/yes/on）后，dsh web 启动时会打印：
+//   nav-icon 自检结果、数据恢复报告、就绪标记。
+//   错误日志（持久化失败、文件损坏等 console.error）始终打印，不受此开关影响。
+// ============================================================
+const STARTUP_LOG = /^(1|true|yes|on)$/i.test(String(process.env.DSH_COST_TRACKER_LOG || ''))
+function startupLog(msg) {
+  if (STARTUP_LOG) console.log(msg)
+}
+
+// ============================================================
+// 设置侧边栏图标补丁 · 启动自愈
+// DSH 设置外壳的 navIcon() 按 id 硬编码图标，未知 id 回退齿轮；
+// slot 注册不支持自带图标，只能给外壳产物打补丁。
+// DSH 升级/重装会覆盖外壳文件 —— 因此每次启动自检，缺失即重打。
+// 任何一步失败都静默跳过（侧边栏回退齿轮，面板内图标不受影响）。
+// ============================================================
+const NAV_ICON_BRANCH = 'if (id === "cost-dashboard") return (0, react_jsx_runtime.jsxs)("svg", { className: SettingsRoot_module_css_default.navIcon, width: 16, height: 16, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: [(0, react_jsx_runtime.jsx)("rect", { x: 1.5, y: 8.6, width: 3.1, height: 5.9, rx: 0.9, fill: "currentColor" }), (0, react_jsx_runtime.jsx)("rect", { x: 5.9, y: 5.2, width: 3.1, height: 9.3, rx: 0.9, fill: "currentColor" }), (0, react_jsx_runtime.jsxs)("g", { fill: "none", stroke: "currentColor", strokeWidth: 1.3, strokeLinecap: "round", strokeLinejoin: "round", children: [(0, react_jsx_runtime.jsx)("path", { d: "M10.7 4.9 L12.3 7.2 L13.9 4.9" }), (0, react_jsx_runtime.jsx)("path", { d: "M12.3 7.2 L12.3 10.9" }), (0, react_jsx_runtime.jsx)("path", { d: "M10.9 7.8 L13.7 7.8" }), (0, react_jsx_runtime.jsx)("path", { d: "M10.9 9.5 L13.7 9.5" })] })] }); // cost-tracker-icon-patch\n\t\t\t'
+
+export function ensureNavIconPatch(opts) {
+  const log = (opts && opts.log) || (() => {})
+  try {
+    const entry = (opts && opts.entry) || (process.argv && process.argv[1]) || ''
+    // 全局安装通常通过符号链接启动（如 /opt/homebrew/bin/dsh），需同时尝试 realpath
+    const entries = [entry]
+    try { const real = realpathSync(entry); if (real && real !== entry) entries.push(real) } catch (e) {}
+    let shellFile = ''
+    for (const e0 of entries) {
+      let dir = dirname(e0)
+      for (let i = 0; i < 8 && dir && dir !== dirname(dir); i++) {
+        const candidate = join(dir, 'node_modules', '@deepseek-ai', 'dsh-client-ui-settings-general', 'lib', 'client.js')
+        if (existsSync(candidate)) { shellFile = candidate; break }
+        dir = dirname(dir)
+      }
+      if (shellFile) break
+    }
+    if (!shellFile) { log('skip: settings shell not found'); return false }
+    const src = readFileSync(shellFile, 'utf8')
+    if (src.includes('id === "cost-dashboard"')) { log('ok: already patched'); return true }
+    const anchor = /function navIcon\(id\)\s*\{\s*/.exec(src)
+    if (!anchor) { log('skip: navIcon() not found (shell layout changed?)'); return false }
+    if (!src.includes('react_jsx_runtime') || !src.includes('SettingsRoot_module_css_default')) {
+      log('skip: expected identifiers missing (shell layout changed?)'); return false
+    }
+    if (!existsSync(shellFile + '.cost-tracker-bak')) writeFileSync(shellFile + '.cost-tracker-bak', src)
+    const at = anchor.index + anchor[0].length
+    const tmp = shellFile + '.cost-tracker-tmp'
+    writeFileSync(tmp, src.slice(0, at) + NAV_ICON_BRANCH + src.slice(at))
+    renameSync(tmp, shellFile)
+    log('ok: patch applied -> ' + shellFile)
+    return true
+  } catch (e) {
+    log('skip: ' + String(e && e.message ? e.message : e))
+    return false
+  }
+}
+
+export default {
+  name: 'cost-tracker',
+  inject: ['tools', 'webServer'],
+  apply(ctx) {
+    // 侧边栏图标补丁自愈（DSH 升级覆盖外壳后自动重打；失败静默跳过）
+    ensureNavIconPatch({ log: (m) => startupLog('[cost-tracker] nav-icon ' + m) })
+
+    // ---------- price tables (CNY per 1M tokens) ----------
+    // 单价表 / 峰谷 / 费用计算集中在 pricing.js（纯模块，可独立测试）；
+    // 单价按「计费时代」分版（PRICE_ERAS）：按记录时间戳选版，故历史记录口径不变。
+    // V4.1 Flash 价（北京时间 2026-09-10 12:00 起）生效后，V4-Pro 与旧 V4-Flash 系
+    // 的请求按官方规则路由到 V4.1 Flash 计费，记录亦以 V4.1 Flash 模型名入账。
+    // 视觉模型 deepseek-v4-flash-vision-exp 的图片 token 由接口 usage 计入 inputTokens
+
+    // ---------- state ----------
+    // 注意：records/rollups 在 persistence 段由 store 初始化（details/rollups 引用）
+    let kimiCache = null
+
+    // ---------- small helpers ----------
+    function pad2(n) { return n < 10 ? '0' + n : '' + n }
+    function toInt(x) { const n = parseInt(x, 10); return isNaN(n) ? 0 : n }
+    function toStr(x) { return x === undefined || x === null ? '' : String(x) }
+    function r2(x) { return Math.round(x * 100) / 100 }
+    function r4(x) { return Math.round(x * 10000) / 10000 }
+    function normProvider(p) { return toStr(p).toLowerCase().replace(/-official$/, '') }
+    function dayKey(ts) {
+      const d = new Date(ts + 28800000)
+      return d.getUTCFullYear() + '-' + pad2(d.getUTCMonth() + 1) + '-' + pad2(d.getUTCDate())
+    }
+    function timeLabel(ts) {
+      const d = new Date(ts + 28800000)
+      return (d.getUTCMonth() + 1) + '/' + d.getUTCDate() + ' ' + pad2(d.getUTCHours()) + ':' + pad2(d.getUTCMinutes())
+    }
+
+    // ---------- persistence ----------
+    // 数据文件路径：可用环境变量 DSH_COST_TRACKER_STORE 覆盖（测试/自定义用）；
+    // 默认 $DSH_HOME/storages/cost-tracker-records.json（未设 DSH_HOME 时为 ~/.dsh）。
+    // 明细保留最近 DETAIL_DAYS 天，更早自动压缩为永久日汇总（见 store.js）。
+    const STORE_FILE = process.env.DSH_COST_TRACKER_STORE || join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'storages', 'cost-tracker-records.json')
+    const store = createStore(STORE_FILE)
+    const records = store.details
+    const rollups = store.rollups
+
+    function writeRecords() { store.persist() }
+
+    // ---------- plugin config (peak pricing notice) ----------
+    // 与记录分开存储：$DSH_HOME/storages/cost-tracker-config.json。
+    // 提供读写与校验（默认值见 config.js），写失败不阻断（下次改设置重试）。
+    const CONFIG_FILE = join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'storages', 'cost-tracker-config.json')
+    let peakConfig = defaultPeakConfig()
+    let configLoadWarned = false
+
+    function loadConfig() {
+      try {
+        if (!existsSync(CONFIG_FILE)) return
+        const parsed = JSON.parse(readFileSync(CONFIG_FILE, 'utf8'))
+        peakConfig = normalizePeakConfig(parsed)
+      } catch (e) {
+        if (!configLoadWarned) { console.error('cost tracker config load failed, using defaults', e); configLoadWarned = true }
+      }
+    }
+
+    function saveConfig() {
+      try {
+        mkdirSync(dirname(CONFIG_FILE), { recursive: true })
+        const tmp = CONFIG_FILE + '.tmp'
+        writeFileSync(tmp, JSON.stringify(peakConfig), 'utf8')
+        renameSync(tmp, CONFIG_FILE)
+        return true
+      } catch (e) {
+        console.error('cost tracker config persist failed', e)
+        return false
+      }
+    }
+
+    function setPeakConfig(raw) {
+      peakConfig = normalizePeakConfig(raw)
+      saveConfig()
+      return peakConfig
+    }
+
+    // 峰谷相位快照（供客户端时段条 / 弹窗 / 倒计时）
+    function peakSnapshot() {
+      const now = Date.now()
+      const phase = peakPhaseAt(now)
+      return {
+        ok: true,
+        config: peakConfig,
+        enabled: peakConfig.peakEnabled,
+        effective: peakEffective(peakConfig, now),
+        notice: peakConfig.peakNotice,
+        style: peakConfig.peakStyle,
+        alert: {
+          enabled: peakConfig.peakAlertEnabled,
+          ahead: peakConfig.peakAlertAhead,
+          target: peakConfig.peakAlertTarget,
+          position: peakConfig.peakAlertPosition,
+          webNotify: peakConfig.peakAlertWebNotify,
+        },
+        phase,
+        peakWindows: PEAK_WINDOWS,
+        peakHours: PEAK_HOUR_WINDOWS,
+        effectiveAt: peakConfig.peakEffectiveAt,
+        now,
+      }
+    }
+
+    function loadRecords() {
+      const n = store.load()
+      const ru = Object.keys(rollups).length
+      if (n > 0 || ru > 0) startupLog('cost tracker restored ' + n + ' detail records, ' + ru + ' rollup days from ' + STORE_FILE)
+    }
+
+    let persistPending = false
+    let persistTimer = null
+    function schedulePersist() {
+      if (persistPending) return
+      persistPending = true
+      const run = () => {
+        persistPending = false
+        persistTimer = null
+        writeRecords()
+      }
+      const timer = ctx.get('timer')
+      persistTimer = timer ? timer.timeout(run, 1500) : setTimeout(run, 1500)
+    }
+    function persistNow() {
+      persistPending = false
+      if (persistTimer) { try { persistTimer() } catch (e) {} persistTimer = null }
+      writeRecords()
+    }
+
+    // ---------- recording ----------
+    function recordUsage(options, usage, ts) {
+      const provider = toStr(options && options.provider)
+      const model = toStr(options && options.model)
+      if (!provider && !model) return
+      const np = normProvider(provider)
+      // 按「调用发生的时刻」选单价版本（跨 2026-09-10 12:00 自动切换，无需重启）。
+      const price = priceFor(np, model, ts)
+      // 峰谷计费开关：随配置峰谷启用 + 生效时间门控；未启用时按非峰谷档（平价）计费。
+      const peak = peakEffective(peakConfig, ts) ? isPeak(ts) : false
+      // 视觉模型（deepseek-v4-flash-vision-exp）的图片 token 已含在接口
+      // prompt_tokens 中（每张≤384 tokens），由 normalizeTokens 归入 input
+      const tokens = normalizeTokens(usage)
+      store.add({
+        // 被路由的请求以「实际计费模型名」入账（如 V4-Pro → deepseek-v4.1-flash），
+        // 使按模型聚合看到的就是真实计费口径。
+        ts, provider, model: price.model || model,
+        sessionId: toStr(options && options.sessionId),
+        purpose: toStr(options && options.purpose),
+        cost: computeCost(price.rates, price.tiered, peak, tokens),
+        estimated: price.estimated,
+        period: price.tiered ? (peak ? 'peak' : 'off-peak') : 'flat',
+        tokens,
+        subscription: price.subscription,
+      })
+      schedulePersist()
+    }
+
+    async function* wrapStream(source, options) {
+      let usage = null
+      try {
+        for await (const chunk of source) {
+          if (chunk && chunk.type === 'usage' && chunk.usage) usage = chunk.usage
+          yield chunk
+        }
+      } finally {
+        if (usage) {
+          try { recordUsage(options, usage, Date.now()) } catch (e) { console.error('cost record failed', e) }
+        }
+      }
+    }
+
+    ctx.on('llm/stream', (options, next) => wrapStream(next(), options))
+
+    // ---------- network (native fetch) ----------
+    async function httpJson(url, headers, timeoutMs) {
+      const ac = new AbortController()
+      const t = setTimeout(() => ac.abort(), timeoutMs || 15000)
+      try {
+        const r = await fetch(url, { headers: headers || {}, signal: ac.signal })
+        const body = await r.text()
+        return { status: r.status, body: body.slice(0, 12000) }
+      } catch (e) {
+        return { status: 0, error: String(e && e.message ? e.message : e) }
+      } finally {
+        clearTimeout(t)
+      }
+    }
+
+    // ---------- key resolution ----------
+    function readCredFile(envName) {
+      try {
+        const p = join(homedir(), '.dsh', '.credentials.yaml')
+        const t = readFileSync(p, 'utf8')
+        const lines = t.split(/\r?\n/)
+        for (const line of lines) {
+          const m = line.match(/^([A-Za-z0-9_]+):\s*(.+)\s*$/)
+          if (m && m[1] === envName) return m[2]
+        }
+      } catch (e) {}
+      return ''
+    }
+
+    function kimiKeyEnv() {
+      const settings = ctx.get('settings')
+      if (settings) {
+        try {
+          const v = settings.get('llm-pi-ai')
+          const providers = v && v.providers
+          if (providers) {
+            const kc = providers['kimi-coding']
+            if (kc && kc.apiKeyEnv) return String(kc.apiKeyEnv)
+            const k = providers['kimi']
+            if (k && k.apiKeyEnv) return String(k.apiKeyEnv)
+          }
+        } catch (e) {}
+      }
+      return 'KIMI_CODING_API_KEY'
+    }
+
+    function deepseekKeyEnv() {
+      const settings = ctx.get('settings')
+      if (settings) {
+        try {
+          const v = settings.get('llm-deepseek')
+          if (v && v.apiKeyEnv) return String(v.apiKeyEnv)
+        } catch (e) {}
+        try {
+          const v = settings.get('llm-pi-ai')
+          const p = v && v.providers && v.providers['deepseek']
+          if (p && p.apiKeyEnv) return String(p.apiKeyEnv)
+        } catch (e) {}
+      }
+      return 'DEEPSEEK_API_KEY'
+    }
+
+    async function resolveApiKey(envName) {
+      const cred = ctx.get('credentials')
+      if (cred) {
+        try {
+          const r = await cred.resolve(envName)
+          if (r && r.value) return { value: String(r.value), source: 'credentials:' + toStr(r.source) }
+        } catch (e) {}
+      }
+      const v = readCredFile(envName)
+      if (v) return { value: v, source: 'file' }
+      return { value: '', source: 'none' }
+    }
+
+    // ---------- kimi subscription quota ----------
+    function emptyKimi(error, keySource, keyEnv) {
+      return { ok: false, error, weekly: { used: 0, limit: 0, remaining: 0, resetTime: '' }, windows: [], parallel: 0, membership: '', region: '', fetchedAt: Date.now(), keySource, keyEnv }
+    }
+
+    function parseKimi(j, key, keyEnv) {
+      const u = j && j.usage ? j.usage : {}
+      const windows = []
+      const limits = j && j.limits
+      if (Array.isArray(limits)) {
+        for (const l of limits) {
+          const w = l && l.window ? l.window : {}
+          const d = l && l.detail ? l.detail : {}
+          windows.push({ duration: toInt(w.duration), timeUnit: toStr(w.timeUnit), used: toInt(d.used), limit: toInt(d.limit), remaining: toInt(d.remaining), resetTime: toStr(d.resetTime) })
+        }
+      }
+      const user = j && j.user ? j.user : {}
+      const membership = user.membership ? user.membership.level : ''
+      return {
+        ok: true, error: '',
+        weekly: { used: toInt(u.used), limit: toInt(u.limit), remaining: toInt(u.remaining), resetTime: toStr(u.resetTime) },
+        windows,
+        parallel: toInt(j && j.parallel ? j.parallel.limit : 0),
+        membership: toStr(membership),
+        region: toStr(user.region),
+        fetchedAt: Date.now(),
+        keySource: key.source, keyEnv,
+      }
+    }
+
+    async function kimiUsage(force) {
+      const now = Date.now()
+      if (!force && kimiCache && now - kimiCache.fetchedAt < 120000) return kimiCache.data
+      const envName = kimiKeyEnv()
+      let data
+      try {
+        const key = await resolveApiKey(envName)
+        if (!key.value) {
+          data = emptyKimi('未找到 API Key（' + envName + '）', key.source, envName)
+        } else {
+          const headers = { Authorization: 'Bearer ' + key.value, 'User-Agent': 'KimiCLI/1.6' }
+          let r = await httpJson('https://api.kimi.com/coding/v1/usages', headers)
+          if (r.status === 404) r = await httpJson('https://api.kimi.com/coding/v1/usage', headers)
+          if (r.status === 200 && r.body) {
+            try {
+              data = parseKimi(JSON.parse(r.body), key, envName)
+            } catch (e) {
+              data = emptyKimi('响应解析失败', key.source, envName)
+            }
+          } else {
+            data = emptyKimi('HTTP ' + (r.status || 0) + (r.error ? ' · ' + r.error : ''), key.source, envName)
+          }
+        }
+      } catch (e) {
+        data = emptyKimi(toStr(e && e.message ? e.message : e), 'none', envName)
+      }
+      kimiCache = { fetchedAt: now, data }
+      return data
+    }
+
+    // ---------- deepseek balance ----------
+    async function balance(args) {
+      const manual = args && typeof args.apiKey === 'string' ? args.apiKey.trim() : ''
+      const key = manual ? { value: manual, source: 'manual' } : await resolveApiKey(deepseekKeyEnv())
+      if (!key.value) return { ok: false, error: '未找到 DeepSeek API Key', available: false, total: '', granted: '', toppedUp: '', currency: 'CNY', keySource: 'none' }
+      try {
+        const r = await httpJson('https://api.deepseek.com/user/balance', { Authorization: 'Bearer ' + key.value })
+        if (r.status !== 200 || !r.body) return { ok: false, error: 'HTTP ' + (r.status || 0) + (r.error ? ' · ' + r.error : ''), available: false, total: '', granted: '', toppedUp: '', currency: 'CNY', keySource: key.source }
+        const j = JSON.parse(r.body)
+        const infos = Array.isArray(j.balance_infos) ? j.balance_infos : []
+        let info = null
+        for (const b of infos) { if (b && b.currency === 'CNY') { info = b; break } }
+        if (!info) info = infos[0] || {}
+        return { ok: true, error: '', available: !!j.is_available, total: toStr(info.total_balance), granted: toStr(info.granted_balance), toppedUp: toStr(info.topped_up_balance), currency: toStr(info.currency) || 'CNY', keySource: key.source }
+      } catch (e) {
+        return { ok: false, error: toStr(e && e.message ? e.message : e), available: false, total: '', granted: '', toppedUp: '', currency: 'CNY', keySource: key.source }
+      }
+    }
+
+    // ---------- csv export ----------
+    function csvCell(s) {
+      s = String(s)
+      return /[",\n]/.test(s) ? '"' + s.replace(/"/g, '""') + '"' : s
+    }
+
+    function workspaceRoot() {
+      const policy = ctx.get('sandboxPolicy')
+      if (policy && policy.workspaceRoot) return policy.workspaceRoot
+      return process.cwd()
+    }
+
+    async function exportCsv() {
+      const rows = records.slice(-50000)
+      const lines = ['time,provider,model,sessionId,purpose,period,subscription,estimated,inputTokens,outputTokens,cacheReadTokens,cacheWriteTokens,totalTokens,costCNY']
+      for (const r of rows) {
+        const t = r.tokens
+        const d = new Date(r.ts + 28800000)
+        const ts = d.getUTCFullYear() + '-' + pad2(d.getUTCMonth() + 1) + '-' + pad2(d.getUTCDate()) + ' ' + pad2(d.getUTCHours()) + ':' + pad2(d.getUTCMinutes()) + ':' + pad2(d.getUTCSeconds())
+        lines.push([csvCell(ts), csvCell(r.provider), csvCell(r.model), csvCell(r.sessionId), csvCell(r.purpose), r.period, r.subscription ? '1' : '0', r.estimated ? '1' : '0', t.input, t.output, t.cacheRead, t.cacheWrite, t.input + t.output + t.cacheRead + t.cacheWrite, r4(r.cost)].join(','))
+      }
+      // 日汇总行（purpose=rollup）：早于保留窗口的记录按天+模型聚合后永久保留
+      let rollupRows = 0
+      for (const dk of Object.keys(rollups).sort()) {
+        for (const mk of Object.keys(rollups[dk]).sort()) {
+          const e = rollups[dk][mk]
+          const total = e.input + e.output + e.cacheRead + e.cacheWrite
+          lines.push([csvCell(dk + ' 12:00:00'), csvCell(e.provider), csvCell(e.model), '', 'rollup', '', e.subscription ? '1' : '0', e.estimated ? '1' : '0', e.input, e.output, e.cacheRead, e.cacheWrite, total, r4(e.cost)].join(','))
+          rollupRows += 1
+        }
+      }
+      const csv = '\uFEFF' + lines.join('\n') + '\n'
+      const name = 'cost-export-' + dayKey(Date.now()) + '.csv'
+      try {
+        const path = join(workspaceRoot(), name)
+        writeFileSync(path, csv, 'utf8')
+        return { ok: true, path, count: rows.length + rollupRows, error: '' }
+      } catch (e) {
+        return { ok: false, path: '', count: 0, error: toStr(e && e.message ? e.message : e).slice(0, 300) }
+      }
+    }
+
+    // ---------- prices ----------
+    function prices() {
+      const now = Date.now()
+      const era = eraAt(now)
+      return {
+        peakWindows: PEAK_WINDOWS,
+        offPeakFactor: 0.5,
+        unit: 'CNY / 1M tokens',
+        // exact = 当前生效时代的精确单价表（随价格时代自动切换）
+        exact: exactModelsAt(now),
+        era: era.id,
+        eraLabel: era.label,
+        // 全部价格时代（含生效时刻与路由规则），供工具/接口展示
+        eras: PRICE_ERAS.map((e) => ({ id: e.id, label: e.label, since: e.since, models: e.models, routes: e.routes || {} })),
+        v41EffectiveAt: V41_EFFECTIVE_AT,
+        subscription: SUBSCRIPTION_RATES,
+        providers: PROVIDER_RATES,
+        generic: GENERIC_RATES,
+      }
+    }
+
+    // ---------- aggregation ----------
+    function enumerateDays(startKey, endKey) {
+      const out = []
+      let t = Date.UTC(toInt(startKey.slice(0, 4)), toInt(startKey.slice(5, 7)) - 1, toInt(startKey.slice(8, 10)))
+      const end = Date.UTC(toInt(endKey.slice(0, 4)), toInt(endKey.slice(5, 7)) - 1, toInt(endKey.slice(8, 10)))
+      if (end - t > (MAX_AXIS_DAYS - 1) * 86400000) t = end - (MAX_AXIS_DAYS - 1) * 86400000
+      while (t <= end) {
+        const d = new Date(t)
+        out.push({ key: d.getUTCFullYear() + '-' + pad2(d.getUTCMonth() + 1) + '-' + pad2(d.getUTCDate()), label: (d.getUTCMonth() + 1) + '/' + d.getUTCDate() })
+        t += 86400000
+      }
+      return out
+    }
+
+    function buildDashboard(args) {
+      const days = args && typeof args.days === 'number' && isFinite(args.days) ? Math.max(0, Math.floor(args.days)) : 7
+      const now = Date.now()
+      const todayKey = dayKey(now)
+      const cutoff = days > 0 ? now - days * 86400000 : 0
+      const filt = []
+      for (const r of records) if (r.ts >= cutoff) filt.push(r)
+      // 保留窗口外的日汇总（按天+模型），仅取落在查询范围内的天
+      const ru = {}
+      {
+        const startDk = dayKey(cutoff)
+        for (const dk of Object.keys(rollups)) if (dk >= startDk) ru[dk] = rollups[dk]
+      }
+      let realCost = 0, realTokens = 0, peakCost = 0, offCost = 0, flatCost = 0, realCalls = 0
+      let subEquivalent = 0, subTokens = 0, subCalls = 0
+      // 今日（北京日历日）：消费 / 调用 / tokens，按量与订阅分开
+      let todayReal = 0, todayCalls = 0, todayTokens = 0, todaySub = 0, todaySubCalls = 0, todaySubTokens = 0
+      // 本月（北京日历月）：同样按量/订阅分开
+      const monthPrefix = todayKey.slice(0, 7) // YYYY-MM
+      let monthReal = 0, monthCalls = 0, monthTokens = 0, monthSub = 0, monthSubCalls = 0, monthSubTokens = 0
+      const modelMap = {}
+      for (const r of filt) {
+        const t = r.tokens
+        const total = t.input + t.output + t.cacheRead + t.cacheWrite
+        const key = r.provider + '/' + r.model
+        let m = modelMap[key]
+        if (!m) m = modelMap[key] = { model: key, subscription: r.subscription, estimated: r.estimated, calls: 0, tokens: 0, cost: 0, dayMap: {} }
+        m.calls += 1; m.tokens += total; m.cost += r.cost
+        const dk = dayKey(r.ts)
+        let dm = m.dayMap[dk]
+        if (!dm) dm = m.dayMap[dk] = { calls: 0, tokens: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 }
+        dm.calls += 1; dm.tokens += total; dm.input += t.input; dm.output += t.output; dm.cacheRead += t.cacheRead; dm.cacheWrite += t.cacheWrite; dm.cost += r.cost
+        if (dk === todayKey) {
+          if (r.subscription) { todaySub += r.cost; todaySubCalls += 1; todaySubTokens += total }
+          else { todayReal += r.cost; todayCalls += 1; todayTokens += total }
+        }
+        if (r.subscription) { subCalls += 1; subEquivalent += r.cost; subTokens += total }
+        else {
+          realCalls += 1; realCost += r.cost; realTokens += total
+          if (r.period === 'peak') peakCost += r.cost
+          else if (r.period === 'off-peak') offCost += r.cost
+          else flatCost += r.cost
+        }
+      }
+      // 本月（北京日历月）：与查询窗口无关，扫全部明细记录（本月必在 180 天明细窗口内）
+      for (const r of records) {
+        if (dayKey(r.ts).slice(0, 7) !== monthPrefix) continue
+        const total = r.tokens.input + r.tokens.output + r.tokens.cacheRead + r.tokens.cacheWrite
+        if (r.subscription) { monthSub += r.cost; monthSubCalls += 1; monthSubTokens += total }
+        else { monthReal += r.cost; monthCalls += 1; monthTokens += total }
+      }
+      // 全时段累计（明细 + 永久日汇总），永远精确
+      const full = collectTotals(records, rollups)
+      // 合并日汇总到总量 / 模型 / 按天明细
+      for (const dk of Object.keys(ru)) {
+        for (const mk of Object.keys(ru[dk])) {
+          const e = ru[dk][mk]
+          const total = e.input + e.output + e.cacheRead + e.cacheWrite
+          let m = modelMap[mk]
+          if (!m) m = modelMap[mk] = { model: mk, subscription: e.subscription, estimated: e.estimated, calls: 0, tokens: 0, cost: 0, dayMap: {} }
+          m.calls += e.calls; m.tokens += total; m.cost += e.cost
+          let dm = m.dayMap[dk]
+          if (!dm) dm = m.dayMap[dk] = { calls: 0, tokens: 0, input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 }
+          dm.calls += e.calls; dm.tokens += total; dm.input += e.input; dm.output += e.output; dm.cacheRead += e.cacheRead; dm.cacheWrite += e.cacheWrite; dm.cost += e.cost
+          if (e.subscription) { subCalls += e.calls; subEquivalent += e.cost; subTokens += total }
+          else {
+            realCalls += e.calls; realCost += e.cost; realTokens += total
+            peakCost += e.peak; offCost += e.off; flatCost += e.flat
+          }
+        }
+      }
+      const endKey = dayKey(now)
+      let startKey = endKey
+      if (days > 0) startKey = dayKey(cutoff)
+      else if (filt.length > 0) startKey = dayKey(filt[0].ts)
+      const ruKeys = Object.keys(ru)
+      if (ruKeys.length) {
+        const earliest = ruKeys.sort()[0]
+        if (earliest < startKey) startKey = earliest
+      }
+      const dates = enumerateDays(startKey, endKey)
+      const dayAgg = {}
+      for (const d of dates) dayAgg[d.key] = { peak: 0, off: 0, flat: 0 }
+      for (const r of filt) {
+        if (r.subscription) continue
+        const m = dayAgg[dayKey(r.ts)]
+        if (!m) continue
+        if (r.period === 'peak') m.peak += r.cost
+        else if (r.period === 'off-peak') m.off += r.cost
+        else m.flat += r.cost
+      }
+      for (const dk of Object.keys(ru)) {
+        const m = dayAgg[dk]
+        if (!m) continue
+        for (const mk of Object.keys(ru[dk])) {
+          const e = ru[dk][mk]
+          if (e.subscription) continue
+          m.peak += e.peak; m.off += e.off; m.flat += e.flat
+        }
+      }
+      const byDay = dates.map(d => ({ date: d.key, label: d.label, peak: r4(dayAgg[d.key].peak), off: r4(dayAgg[d.key].off), flat: r4(dayAgg[d.key].flat) }))
+      // 模型展示顺序：按总费用降序排名（与 DeepSeek 开放平台一致，排名决定取色/堆叠顺序）
+      const keys = Object.keys(modelMap).sort((a, b) => modelMap[b].cost - modelMap[a].cost)
+      const byModel = keys.map(k => {
+        const m = modelMap[k]
+        return { model: m.model, subscription: m.subscription, estimated: m.estimated, calls: m.calls, tokens: m.tokens, cost: r4(m.cost) }
+      })
+      const byModelDay = keys.map(k => {
+        const m = modelMap[k]
+        return {
+          model: m.model, subscription: m.subscription, estimated: m.estimated,
+          days: dates.map(d => {
+            const dm = m.dayMap[d.key]
+            return { date: d.key, label: d.label, calls: dm ? dm.calls : 0, tokens: dm ? dm.tokens : 0, input: dm ? dm.input : 0, output: dm ? dm.output : 0, cacheRead: dm ? dm.cacheRead : 0, cacheWrite: dm ? dm.cacheWrite : 0, cost: dm ? r4(dm.cost) : 0 }
+          }),
+        }
+      })
+      const recent = []
+      const start = Math.max(0, records.length - 20)
+      for (let i = records.length - 1; i >= start; i--) {
+        const r = records[i]
+        const t = r.tokens
+        recent.push({ ts: r.ts, time: timeLabel(r.ts), provider: r.provider, model: r.model, period: r.period, subscription: r.subscription, estimated: r.estimated, input: t.input, output: t.output, cacheRead: t.cacheRead, cacheWrite: t.cacheWrite, tokens: t.input + t.output + t.cacheRead + t.cacheWrite, cost: r4(r.cost) })
+      }
+      return {
+        ok: true, days,
+        realCost: r4(realCost), realCalls, realTokens,
+        subEquivalent: r4(subEquivalent), subCalls, subTokens,
+        peakCost: r4(peakCost), offCost: r4(offCost), flatCost: r4(flatCost),
+        today: { real: r4(todayReal), calls: todayCalls, tokens: todayTokens, sub: r4(todaySub), subCalls: todaySubCalls, subTokens: todaySubTokens },
+        month: { real: r4(monthReal), calls: monthCalls, tokens: monthTokens, sub: r4(monthSub), subCalls: monthSubCalls, subTokens: monthSubTokens },
+        all: { real: r4(full.realCost), calls: full.realCalls, tokens: full.realTokens, sub: r4(full.subEquivalent), subCalls: full.subCalls, subTokens: full.subTokens },
+        byDay, byModel, byModelDay, recent,
+        peakWindows: PEAK_WINDOWS,
+      }
+    }
+
+    function buildSummary(args) {
+      const sid = args && typeof args.sessionId === 'string' ? args.sessionId : ''
+      const now = Date.now()
+      const todayKey = dayKey(now)
+      let sessionCost = 0, sessionCalls = 0, sessionSub = 0, sessionSubCalls = 0, todayCost = 0
+      // 本会话按模型拆分（明细；订阅与按量分开，便于状态栏按会话实际内容展示）
+      const realMap = {}, subMap = {}
+      // 会话/当日只可能出现在明细里（日汇总早于保留窗口）
+      for (const r of records) {
+        if (r.subscription) {
+          if (r.sessionId === sid) { sessionSub += r.cost; sessionSubCalls += 1 }
+        } else {
+          if (dayKey(r.ts) === todayKey) todayCost += r.cost
+          if (r.sessionId === sid) { sessionCost += r.cost; sessionCalls += 1 }
+        }
+        if (r.sessionId === sid) {
+          const key = r.provider + '/' + r.model
+          const map = r.subscription ? subMap : realMap
+          let m = map[key]
+          if (!m) m = map[key] = { provider: r.provider, model: r.model, subscription: !!r.subscription, calls: 0, tokens: 0, cost: 0 }
+          m.calls += 1
+          m.tokens += (r.tokens.input + r.tokens.output + r.tokens.cacheRead + r.tokens.cacheWrite)
+          m.cost += r.cost
+        }
+      }
+      const fmtModels = (map) => Object.keys(map).map(k => map[k]).sort((a, b) => b.cost - a.cost)
+        .map(m => ({ provider: m.provider, model: m.model, subscription: m.subscription, calls: m.calls, tokens: m.tokens, cost: r4(m.cost) }))
+      const realModels = fmtModels(realMap)
+      const subModels = fmtModels(subMap)
+      const sessionModels = realModels.concat(subModels).sort((a, b) => b.cost - a.cost)
+      // 全时段总量 = 明细 + 永久日汇总，永远精确
+      const full = collectTotals(records, rollups)
+      let provider = '', model = ''
+      const adm = ctx.get('agentDefaultModel')
+      if (adm) {
+        try {
+          const sel = adm.currentSelection()
+          if (sel) { provider = toStr(sel.provider); model = toStr(sel.model) }
+        } catch (e) {}
+      }
+      const np = normProvider(provider)
+      const subscription = !!SUBSCRIPTION_RATES[np]
+      let kimiWeeklyRemaining = null
+      // 只要当前选择是订阅，或本会话实际用了订阅，就刷新 kimi 周配额
+      if (subscription || sessionSub > 0) {
+        if (!kimiCache || now - kimiCache.fetchedAt >= 120000) kimiUsage(false).catch(() => {})
+        if (kimiCache && kimiCache.data && kimiCache.data.ok) kimiWeeklyRemaining = kimiCache.data.weekly.remaining
+      }
+      return {
+        sessionCost: r4(sessionCost), sessionCalls,
+        sessionSub: r4(sessionSub), sessionSubCalls,
+        sessionRealModels: realModels,
+        sessionSubModels: subModels,
+        sessionModels,
+        todayCost: r4(todayCost), totalCost: r4(full.realCost), totalCalls: full.realCalls,
+        subEquivalent: r4(full.subEquivalent), subCalls: full.subCalls, subTokens: full.subTokens,
+        provider, model,
+        isDeepSeek: np === 'deepseek',
+        peak: peakEffective(peakConfig, now) ? isPeak(now) : false,
+        subscription,
+        kimiWeeklyRemaining,
+      }
+    }
+
+    function resetData() {
+      const n = store.counts().calls
+      store.clear()
+      kimiCache = null
+      persistNow()
+      return { ok: true, cleared: n }
+    }
+
+    // ---------- 一次性补账：按「计费时代」重算已入库记录 ----------
+    // 场景：价格时代切换时刻已过，但宿主仍加载着旧代码（插件未重启），
+    // 这段时间入库的记录用的是旧价。重启后调用一次即可按记录**自身的时间戳**
+    // 重新选版计费，无需重新采集。
+    // 只重算明细：明细保留最近 DETAIL_DAYS 天，更早的记录早已折叠进日汇总，
+    // 而日汇总覆盖的时间段远早于任何价格切换窗口，故不涉及。
+    // 默认只试算（不落盘），传 apply: true 才写回。
+    function recomputeCosts(args) {
+      const a = args || {}
+      const fallback = PRICE_ERAS[PRICE_ERAS.length - 1].since
+      let since = fallback
+      if (typeof a.since === 'string' && Number.isFinite(Date.parse(a.since))) since = Date.parse(a.since)
+      else if (Number.isFinite(a.since) && a.since > 0) since = a.since
+      const apply = a.apply === true
+      const byModel = {}
+      let scanned = 0, changed = 0, oldCost = 0, newCost = 0
+      for (const r of records) {
+        if (!(r.ts >= since)) continue
+        scanned += 1
+        const np = normProvider(r.provider)
+        const price = priceFor(np, r.model, r.ts)
+        const peak = peakEffective(peakConfig, r.ts) ? isPeak(r.ts) : false
+        const cost = computeCost(price.rates, price.tiered, peak, r.tokens)
+        const model = price.model || r.model
+        const period = price.tiered ? (peak ? 'peak' : 'off-peak') : 'flat'
+        oldCost += r.cost
+        newCost += cost
+        if (!(Math.abs(cost - r.cost) > 1e-9 || model !== r.model || period !== r.period)) continue
+        changed += 1
+        const key = r.provider + '|' + r.model + '|' + model
+        const m = byModel[key] || (byModel[key] = { provider: r.provider, from: r.model, to: model, calls: 0, oldCost: 0, newCost: 0 })
+        m.calls += 1
+        m.oldCost += r.cost
+        m.newCost += cost
+        if (apply) {
+          r.cost = cost
+          r.model = model
+          r.period = period
+          r.estimated = price.estimated
+          r.subscription = price.subscription
+        }
+      }
+      if (apply && changed > 0) persistNow()
+      const rows = Object.keys(byModel).map(k => {
+        const m = byModel[k]
+        return { provider: m.provider, from: m.from, to: m.to, calls: m.calls, oldCost: r4(m.oldCost), newCost: r4(m.newCost), delta: r4(m.newCost - m.oldCost) }
+      }).sort((x, y) => Math.abs(y.delta) - Math.abs(x.delta))
+      return {
+        ok: true,
+        applied: apply && changed > 0,
+        since,
+        era: eraAt(since).id,
+        scanned,
+        changed,
+        oldCost: r4(oldCost),
+        newCost: r4(newCost),
+        delta: r4(newCost - oldCost),
+        byModel: rows,
+        note: changed === 0 ? '没有需要重算的记录' : (apply ? '已重算并落盘' : '试算结果，未落盘（传 apply: true 生效）'),
+      }
+    }
+
+    // ---------- usage heatmap (Codex 风格 26 周每日用量方格热图) ----------
+    // 返回全时段累计 token + 按天聚合（明细 + 永久日汇总），供客户端渲染热力图。
+    // 汇总含按量与订阅（订阅为等效参考口径一致），days 覆盖最近约 27 周（含 26 周窗口余量）。
+    function buildUsageHeat() {
+      const now = Date.now()
+      const byDay = {}
+      const ensure = (dk) => {
+        let d = byDay[dk]
+        if (!d) d = byDay[dk] = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, calls: 0, cost: 0 }
+        return d
+      }
+      let totInput = 0, totOutput = 0, totCacheRead = 0, totCacheWrite = 0, totCalls = 0, totCost = 0
+      for (const r of records) {
+        const t = r.tokens
+        const d = ensure(dayKey(r.ts))
+        d.input += t.input; d.output += t.output; d.cacheRead += t.cacheRead; d.cacheWrite += t.cacheWrite; d.calls += 1; d.cost += r.cost
+        totInput += t.input; totOutput += t.output; totCacheRead += t.cacheRead; totCacheWrite += t.cacheWrite; totCalls += 1; totCost += r.cost
+      }
+      for (const dk of Object.keys(rollups)) {
+        for (const mk of Object.keys(rollups[dk])) {
+          const e = rollups[dk][mk]
+          const d = ensure(dk)
+          d.input += e.input; d.output += e.output; d.cacheRead += e.cacheRead; d.cacheWrite += e.cacheWrite; d.calls += e.calls; d.cost += e.cost
+          totInput += e.input; totOutput += e.output; totCacheRead += e.cacheRead; totCacheWrite += e.cacheWrite; totCalls += e.calls; totCost += e.cost
+        }
+      }
+      // 只保留最近约 27 周（客户端网格按周对齐，多留一周做余量，避免边缘缺格）
+      const startDk = dayKey(now - 27 * 7 * 86400000)
+      const days = []
+      for (const dk of Object.keys(byDay).sort()) {
+        if (dk < startDk) continue
+        const d = byDay[dk]
+        days.push({ date: dk, input: d.input, output: d.output, cacheRead: d.cacheRead, cacheWrite: d.cacheWrite, calls: d.calls, cost: r4(d.cost), tokens: d.input + d.output + d.cacheRead + d.cacheWrite })
+      }
+      return {
+        ok: true,
+        total: {
+          tokens: totInput + totOutput + totCacheRead + totCacheWrite,
+          input: totInput, cache: totCacheRead + totCacheWrite, output: totOutput,
+          calls: totCalls, cost: r4(totCost),
+        },
+        days,
+      }
+    }
+
+    // ---------- HTTP routes (client → host) ----------
+    const ROUTES = {
+      summary: (args) => buildSummary(args),
+      dashboard: (args) => buildDashboard(args),
+      'kimi-usage': (args) => kimiUsage(!!(args && args.force)),
+      balance: (args) => balance(args),
+      export: () => exportCsv(),
+      prices: () => prices(),
+      recompute: (args) => recomputeCosts(args),
+      usage: () => buildUsageHeat(),
+      peak: () => peakSnapshot(),
+      'peak-config': (args) => setPeakConfig(args),
+    }
+
+    async function handleRoute(req, res) {
+      const pathname = decodeURIComponent(new URL(req.url || '/', 'http://localhost').pathname)
+      const name = pathname.replace(/^\/api\/cost-tracker\//, '').replace(/\/+$/, '')
+      if (req.method === 'OPTIONS') { res.writeHead(204); res.end(); return }
+      if (req.method !== 'POST') { res.writeHead(405, { 'content-type': 'application/json; charset=utf-8' }); res.end(JSON.stringify({ ok: false, error: 'method not allowed' })); return }
+      const fn = ROUTES[name]
+      if (!fn) { res.writeHead(404, { 'content-type': 'application/json; charset=utf-8' }); res.end(JSON.stringify({ ok: false, error: 'unknown route' })); return }
+      let args = {}
+      try {
+        let raw = ''
+        for await (const chunk of req) {
+          raw += chunk
+          if (raw.length > 1048576) break
+        }
+        if (raw) args = JSON.parse(raw)
+      } catch (e) {}
+      try {
+        const out = await fn(args)
+        res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-cache' })
+        res.end(JSON.stringify(out))
+      } catch (e) {
+        res.writeHead(500, { 'content-type': 'application/json; charset=utf-8' })
+        res.end(JSON.stringify({ ok: false, error: toStr(e && e.message ? e.message : e) }))
+      }
+    }
+
+    ctx.effect(() => ctx.webServer.register({ kind: 'prefix', path: '/api/cost-tracker', handler: handleRoute }), 'cost-tracker: api routes')
+
+    // ---------- model tools ----------
+    ctx.tools.register({
+      name: 'cost_stats',
+      description: '查询本进程内记录的模型调用花费与用量统计（人民币 CNY 计价）。按量计费模型与订阅制套餐（等效费用，仅供参考）分开统计；数据持久化于磁盘，进程重启后自动恢复。',
+      parameters: {
+        type: 'object',
+        properties: { days: { type: 'integer', description: '统计最近 N 天；0 表示全部。默认 7。' } },
+        additionalProperties: true,
+      },
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render: (args, v) => [{ type: 'text', text: '花费统计（' + (v.days === 0 ? '全部' : '近 ' + v.days + ' 天') + '）\n按量消费：¥' + v.realTotal + '（高峰 ¥' + v.peakCost + ' · 闲时 ¥' + v.offCost + (v.flatCost > 0 ? ' · 平峰 ¥' + v.flatCost : '') + '）· 请求 ' + v.realCalls + ' 次 · Tokens ' + v.realTokens + '\n订阅套餐：请求 ' + v.subCalls + ' 次 · Tokens ' + v.subTokens + ' · 等效 ¥' + v.subEquivalent + '（订阅已覆盖，仅供参考）' }],
+      },
+      execute: async (args) => {
+        const d = buildDashboard(args && typeof args.days === 'number' ? { days: args.days } : { days: 7 })
+        return { ok: true, days: d.days, realTotal: d.realCost, realCalls: d.realCalls, realTokens: d.realTokens, peakCost: d.peakCost, offCost: d.offCost, flatCost: d.flatCost, subEquivalent: d.subEquivalent, subCalls: d.subCalls, subTokens: d.subTokens }
+      },
+    })
+
+    ctx.tools.register({
+      name: 'cost_prices',
+      description: '查看当前内置的模型单价表（CNY / 百万 tokens）与峰谷时段规则。',
+      parameters: {
+        type: 'object',
+        properties: {},
+        additionalProperties: true,
+      },
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render: (args, v) => {
+          const when = (s) => (s === 0 ? '初始价（长期有效）' : new Date(s + 28800000).toISOString().replace('T', ' ').slice(0, 16).replace(/-/g, '/') + '（北京时间）')
+          const lines = ['单价表（CNY / 百万 tokens）', '峰谷时段（北京时间）：' + v.peakWindows + '，闲时 = 高峰价 × ' + v.offPeakFactor]
+          for (const e of v.eras) {
+            lines.push('', '【' + e.label + '】生效：' + when(e.since))
+            for (const name of Object.keys(e.models)) {
+              const r = e.models[name]
+              lines.push('  ' + name + '：高峰 输入（未命中）' + r.input + ' / 输入（命中）' + r.cacheRead + ' / 输出 ' + r.output + '（闲时半价）')
+            }
+            for (const from of Object.keys(e.routes)) {
+              lines.push('  ↳ 路由：' + from + ' → 按 ' + e.routes[from] + ' 单价计费')
+            }
+          }
+          lines.push('', '当前生效：' + v.eraLabel + '（era=' + v.era + '）')
+          lines.push('视觉模型 deepseek-v4-flash-vision-exp：图片按官方规则换算 token（每张上限 384），以接口用量计费（已含在 inputTokens 内）。')
+          lines.push('kimi-coding（订阅等效，估算）：输入 6.5 / 缓存命中（含缓存写入）1.1 / 输出 27.0')
+          lines.push('缓存写入(cache write)按缓存命中价计费，与官方规则一致。其他 provider 兜底为估算平价（openai 10/30/5，anthropic 15/75/1.5，gemini 2.5/10/0.625，未知 2/8/0.5）；ollama/local 为 0。')
+          return [{ type: 'text', text: lines.join('\n') }]
+        },
+      },
+      execute: async () => prices(),
+    })
+
+    ctx.tools.register({
+      name: 'cost_reset',
+      description: '清空本进程内记录的全部模型调用花费与用量数据（同时清空磁盘持久化，不可恢复）。',
+      parameters: {
+        type: 'object',
+        properties: {},
+        additionalProperties: true,
+      },
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render: (args, v) => [{ type: 'text', text: '已清空 ' + v.cleared + ' 条花费记录。' }],
+      },
+      execute: async () => resetData(),
+    })
+
+    ctx.tools.register({
+      name: 'cost_recompute',
+      description: '按「计费时代」重算已入库记录的费用（一次性补账）。用于价格调整后宿主未及时重启、导致记录按旧价入库的情况；默认只试算不落盘，传 apply: true 才写回。',
+      parameters: {
+        type: 'object',
+        properties: {
+          apply: { type: 'boolean', description: '是否把重算结果写回（默认 false，仅试算）' },
+          since: { type: 'string', description: '重算起始时刻（ISO 字符串或 epoch ms）；默认取最近一次价格时代的生效时刻' },
+        },
+        additionalProperties: true,
+      },
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render: (args, v) => {
+          const when = new Date(v.since + 28800000).toISOString().replace('T', ' ').slice(0, 16).replace(/-/g, '/')
+          const lines = [
+            '费用重算（自 ' + when + ' 北京起 · era=' + v.era + '）',
+            '扫描 ' + v.scanned + ' 条，需修正 ' + v.changed + ' 条',
+            '合计：¥' + v.oldCost + ' → ¥' + v.newCost + '（' + (v.delta >= 0 ? '+' : '') + v.delta + '）',
+          ]
+          for (const m of (v.byModel || []).slice(0, 8)) {
+            lines.push('  ' + m.from + (m.to !== m.from ? ' → ' + m.to : '') + '：' + m.calls + ' 次 · ¥' + m.oldCost + ' → ¥' + m.newCost)
+          }
+          lines.push(v.note)
+          return [{ type: 'text', text: lines.join('\n') }]
+        },
+      },
+      execute: async (args) => recomputeCosts(args),
+    })
+
+    ctx.tools.register({
+      name: 'cost_peak',
+      description: '查询当前 DeepSeek 峰谷计价档位与下次切换倒计时（北京时间：高峰时段为周一至周五 9:00-12:00、14:00-18:00，其余为闲时，周末全天闲时）。',
+      parameters: {
+        type: 'object',
+        properties: {},
+        additionalProperties: true,
+      },
+      output: {
+        schema: { type: 'object', additionalProperties: true },
+        render: (args, v) => {
+          const p = v.phase
+          const phaseText = !p ? '未知' : p.weekend ? '周末全天闲时（全谷价）' : p.inPeak ? '高峰时段（按峰时价）' : '闲时时段（按谷时价）'
+          const nextText = p ? new Date(p.nextAtMs + 28800000).toISOString().replace('T', ' ').slice(0, 16).replace(/-/g, '/') + ' 转' + (p.nextIntoPeak ? '峰' : '谷') : '未知'
+          return [{ type: 'text', text: '峰谷计价：' + (v.enabled ? '已启用' : '已停用') + '（' + v.peakWindows + '）\n当前档位：' + phaseText + '\n下次切换：' + nextText + (v.effective ? '' : '（峰谷未生效，按平价计费）') }]
+        },
+      },
+      execute: async () => peakSnapshot(),
+    })
+
+    // ---------- lifecycle ----------
+    loadRecords()
+    loadConfig()
+    ctx.effect(() => () => { try { writeRecords() } catch (e) {} }, 'cost-tracker: final flush')
+    startupLog('cost tracker ready (static)')
+  },
+}