dsh-dock 0.9.6 → 0.9.7

package/features/tokenlog/host.js

@@ -1,678 +1,678 @@
-// dsh-dock · 功能模块【用量记录】· 宿主半部（v0.4.0，移植自 @wycto/dsh-token-usage lib/index.js）
-//
-// 记录 DSH 会话日志中的每次 LLM 调用（assistant/message 的 usage），
-// 支持历史全量扫描 + 实时 session/event 增量；RPC 经 webServer HTTP 路由
-//   POST /dsh-dock/tokenlog/query|export|scan|hello
-// 向浏览器半部提供查询/统计/导出。
-//
-// 数据模型（标量，无 Host 对象引用）：
-// {
-//   id, time, sessionId, provider, model, apiKey(掩码),
-//   inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens, reasoningTokens,
-//   billedInput, totalTokens, cacheHitPercent, cost, effort, status, llmMs, turn, step
-// }
-//
-// 定价可经 settings.yaml 的 dsh-dock-tokenlog 命名空间覆盖（未注册 schema，读原始用户层）：
-//   dsh-dock-tokenlog:
-//     usdCnyRate: 7.2
-//     pricingUrl: 'https://api-docs.deepseek.com/zh-cn/quick_start/pricing'
-//     pricingFetchIntervalHours: 24
-//     pricing:
-//       deepseek-v4-flash: { input: 1.5, output: 4.5, cacheRead: 0.05, cacheWrite: 0 }
-import { sendJson, readBody } from '../../src/host-core.js'
-
-/** 本功能的 settings 覆盖命名空间（未注册 schema：读取原始用户层，字段全部可选）。 */
-const NS = 'dsh-dock-tokenlog'
-
-export const feature = {
-  id: 'tokenlog',
-  name: '用量记录',
-  description: '记录全部 LLM API 调用并统计 Token 用量与花费',
-  defaultEnabled: false,
-  setup(ctx) {
-    const disposers = []
-    const dispose = () => {
-      while (disposers.length > 0) {
-        const fn = disposers.pop()
-        try { if (typeof fn === 'function') fn() } catch { /* 停用清理失败不阻断 */ }
-      }
-    }
-
-    // 用 Map<id, record> 存记录: id = sessionId:seq 天然唯一。
-    // 实时监听与历史扫描存在重叠窗口(活跃会话既被实时 push 又被扫描全量读),
-    // 用 set 幂等去重, 避免同一条 LLM 调用被统计两次(此前用数组 push 导致"两倍")。
-    const records = new Map()
-    let scannedSessions = new Set()
-    const headerCache = new Map()
-    const turnError = new Map()
-    const turnStatus = new Map()
-    const stepStart = new Map()
-
-    function num(v) { return typeof v === 'number' && Number.isFinite(v) ? v : 0 }
-
-    // ===== 定价与金额估算 =====
-    // 定价表以「人民币元 / 百万 tokens」为基准(DeepSeek/智谱官方刊例即人民币), 金额先算 CNY,
-    // 对外记录的 cost 保持 USD，供旧版客户端兼容；当前客户端和 CSV 统一展示人民币。
-    // usdCnyRate 与 pricing 均可被 settings.yaml 覆盖:
-    //   dsh-dock-tokenlog:
-    //     usdCnyRate: 7.2                    # USD↔CNY 汇率
-    //     pricing:                            # 可选: 覆盖/新增定价条目(modelPattern -> {...})
-    //       deepseek-v4-flash:
-    //         input: 1.5  output: 4.5  cacheRead: 0.05  cacheWrite: 0
-    //         peak: { start: 9, end: 14, input: 3.0, output: 9.0, cacheRead: 0.10, cacheWrite: 0 }
-    // 官方价格随时会变动: 改价只改 settings.yaml 即可, 无需升级插件; 重启/重扫后历史记录按新价重算。
-    let usdCnyRate = 7.2
-    let fallbackPricing = { match: '*', input: 2.16, output: 6.48, cacheRead: 0.43, cacheWrite: 4.32 }
-    // 内置定价表(人民币元 / 百万 tokens), 按 model 子串匹配; 未匹配走 fallback。
-    // 支持峰谷定价: 条目带 peak={start,end,input,output,cacheRead,cacheWrite},
-    // 高峰时段(插件运行机器本地时间 [start,end))用峰价, 其余用基础价。
-    // 官方来源: DeepSeek-V4 系列 2026-08-17 生效的峰谷刊例(高峰每日 9:00-14:00, 空闲为高峰一半)。
-    const DEFAULT_PRICING = [
-      { match: 'deepseek-v4-flash', input: 1.5, output: 4.5, cacheRead: 0.05, cacheWrite: 0,
-        peak: { start: 9, end: 14, input: 3.0, output: 9.0, cacheRead: 0.10, cacheWrite: 0 } },
-      { match: 'deepseek-v4-pro', input: 4.5, output: 13.5, cacheRead: 0.15, cacheWrite: 0,
-        peak: { start: 9, end: 14, input: 9.0, output: 27.0, cacheRead: 0.30, cacheWrite: 0 } },
-      { match: 'deepseek-v3', input: 3.6, output: 7.2, cacheRead: 0.72, cacheWrite: 7.2 },
-      { match: 'deepseek-chat', input: 1.94, output: 7.92, cacheRead: 0.5, cacheWrite: 7.92 },
-      { match: 'deepseek-reasoner', input: 3.96, output: 15.77, cacheRead: 1.01, cacheWrite: 7.92 },
-      { match: 'nemotron', input: 1.08, output: 2.88, cacheRead: 0.22, cacheWrite: 2.16 },
-      { match: 'glm', input: 2.88, output: 8.64, cacheRead: 0.58, cacheWrite: 7.2 },
-    ]
-    let pricingTable = DEFAULT_PRICING
-
-    function normalizePricing(match, e) {
-      const n = (x) => (typeof x === 'number' && Number.isFinite(x) ? x : 0)
-      const row = { match, input: n(e.input), output: n(e.output), cacheRead: n(e.cacheRead), cacheWrite: n(e.cacheWrite) }
-      if (e.peak && typeof e.peak === 'object') {
-        row.peak = {
-          start: n(e.peak.start), end: n(e.peak.end),
-          input: n(e.peak.input), output: n(e.peak.output),
-          cacheRead: n(e.peak.cacheRead), cacheWrite: n(e.peak.cacheWrite),
-        }
-      }
-      return row
-    }
-
-    // 读取 settings.yaml 的 dsh-dock-tokenlog { usdCnyRate?, pricing? } 覆盖默认值。
-    // pricing: map modelPattern -> {input,output,cacheRead,cacheWrite,peak?};
-    // 设置条目排前面优先命中(同 match 覆盖内置); 键 '*' 覆盖 fallback。幂等, 可重复调用。
-    function loadPricingConfig() {
-      try {
-        const settings = ctx.get('settings')
-        if (!settings || typeof settings.get !== 'function') return
-        const v = settings.get(NS)
-        if (!v || typeof v !== 'object') return
-        if (typeof v.usdCnyRate === 'number' && v.usdCnyRate > 0) usdCnyRate = v.usdCnyRate
-        if (v.pricing && typeof v.pricing === 'object') {
-          const overrides = []
-          for (const [match, entry] of Object.entries(v.pricing)) {
-            if (!entry || typeof entry !== 'object') continue
-            const row = normalizePricing(String(match).toLowerCase(), entry)
-            if (row.match === '*') fallbackPricing = row
-            else overrides.push(row)
-          }
-          pricingTable = overrides.concat(DEFAULT_PRICING)
-        }
-      } catch (e) {
-        console.error('[dsh-dock] tokenlog read pricing config failed', e && e.message)
-      }
-    }
-
-    // 命中定价行: 优先官网自动获取 → settings.yaml 覆盖+内置 → fallback; 再按调用时刻取峰/谷价。
-    // 官网获取的数据若为 USD 则自动折成 CNY(内置表已是 CNY)。返回人民币单价(元/百万 tokens)。
-    function resolvePricing(model, timeMs) {
-      const m = String(model || '').toLowerCase()
-      let row = null
-      let fromFetch = false
-      // 1. 优先: 官网自动获取的定价(48h 内有效, 超时回退内置)
-      const fetched = fetchedPricing
-      if (fetched && fetched.length > 0 && (Date.now() - lastFetchTime < FETCH_INTERVAL_MS * 2)) {
-        for (const r of fetched) {
-          if (m.includes(r.match)) { row = r; fromFetch = true; break }
-        }
-      }
-      // 2. 回退: settings.yaml 覆盖 + 内置表
-      if (!row) {
-        for (const r of pricingTable) {
-          if (m.includes(r.match)) { row = r; break }
-        }
-      }
-      if (!row) row = fallbackPricing
-      // 3. 峰谷判断(本地时间 [start,end) 用峰价)
-      const h = (typeof timeMs === 'number' && Number.isFinite(timeMs)) ? new Date(timeMs).getHours() : -1
-      let prices
-      if (row.peak && h >= row.peak.start && h < row.peak.end) {
-        prices = { input: row.peak.input, output: row.peak.output, cacheRead: row.peak.cacheRead, cacheWrite: row.peak.cacheWrite }
-      } else {
-        prices = { input: row.input, output: row.output, cacheRead: row.cacheRead, cacheWrite: row.cacheWrite }
-      }
-      // 4. 币种转换: 获取的数据若是 USD 则折成 CNY(内置表已是 CNY, 无需转换)
-      if (fromFetch && row.currency === 'usd') {
-        prices.input *= usdCnyRate
-        prices.output *= usdCnyRate
-        prices.cacheRead *= usdCnyRate
-        prices.cacheWrite *= usdCnyRate
-      }
-      return prices
-    }
-    // 金额估算: 表为人民币价 → 先算 CNY, 再折成 USD(= CNY / usdCnyRate) 供客户端/CSV 使用。
-    function estimateCost(usage, model, timeMs) {
-      const p = resolvePricing(model, timeMs)
-      const cny = (
-        num(usage.inputTokens) * p.input +
-        num(usage.cacheReadTokens) * p.cacheRead +
-        num(usage.cacheWriteTokens) * p.cacheWrite +
-        num(usage.outputTokens) * p.output
-      ) / 1e6
-      return cny / usdCnyRate
-    }
-
-    // ===== 官网定价自动获取 =====
-    // 每 24 小时从 DeepSeek 官网抓取最新定价并解析 HTML 表格; 抓取/解析失败时使用内置默认值。
-    const FETCH_INTERVAL_MS = 24 * 60 * 60 * 1000
-    let fetchedPricing = null  // Array<{ match, input, output, cacheRead, cacheWrite, currency }>
-    let lastFetchTime = 0
-
-    function getPricingFetchConfig() {
-      let url = 'https://api-docs.deepseek.com/zh-cn/quick_start/pricing'
-      let intervalMs = FETCH_INTERVAL_MS
-      try {
-        const settings = ctx.get('settings')
-        if (settings && typeof settings.get === 'function') {
-          const v = settings.get(NS)
-          if (v && typeof v === 'object') {
-            if (typeof v.pricingUrl === 'string' && v.pricingUrl) url = v.pricingUrl
-            if (typeof v.pricingFetchIntervalHours === 'number' && v.pricingFetchIntervalHours > 0) intervalMs = v.pricingFetchIntervalHours * 3600000
-          }
-        }
-      } catch (e) { /* 用默认 */ }
-      return { url, intervalMs }
-    }
-
-    // 从 HTML 中提取所有 <table> 的行列数据
-    function extractHTMLTables(html) {
-      const tables = []
-      const tableRe = /<table[^>]*>([\s\S]*?)<\/table>/gi
-      let tm
-      while ((tm = tableRe.exec(html)) !== null) {
-        const rows = []
-        const trRe = /<tr[^>]*>([\s\S]*?)<\/tr>/gi
-        let tr
-        while ((tr = trRe.exec(tm[1])) !== null) {
-          const cells = []
-          const tdRe = /<t[hd][^>]*>([\s\S]*?)<\/t[hd]>/gi
-          let td
-          while ((td = tdRe.exec(tr[1])) !== null) {
-            cells.push(td[1].replace(/<[^>]+>/g, '').replace(/&[a-z]+;/g, ' ').trim())
-          }
-          if (cells.length > 0) rows.push(cells)
-        }
-        if (rows.length >= 2) tables.push(rows)
-      }
-      return tables
-    }
-
-    // 从价格字符串提取数字(支持 "$0.27", "0.27", "¥1.5", "1.5元", "1,500" 等格式)
-    function parsePrice(s) {
-      if (!s) return null
-      const cleaned = String(s).replace(/,/g, '').replace(/￥|¥|元|\/.*$/g, '').trim()
-      const m = cleaned.match(/(\d+\.?\d*)/)
-      return m ? parseFloat(m[1]) : null
-    }
-
-    // 识别定价表列: 通过表头关键词定位各列
-    function identifyPricingColumns(headers) {
-      const h = headers.map(x => x.toLowerCase())
-      const find = (...patterns) => {
-        for (const p of patterns) {
-          const idx = h.findIndex(x => x.includes(p))
-          if (idx >= 0) return idx
-        }
-        return -1
-      }
-      return {
-        model: find('模型', 'model', '名称', 'name'),
-        inputMiss: find('缓存未命中', '未缓存', 'cache miss', 'uncached'),
-        inputHit: find('缓存命中', 'cache hit', 'cached'),
-        output: find('输出', 'output'),
-        peak: find('高峰', 'peak', 'busy', 'on-peak'),
-      }
-    }
-
-    // 从 HTML 解析 DeepSeek 官网定价
-    // 策略: 提取所有 <table>, 找到含"价格/缓存/输入/输出"关键词的表, 逐行提取模型名+价格;
-    // 识别 $ 标记区分 USD/CNY 币种; 无法解析时返回空数组(回退内置默认)。
-    function parsePricingFromHTML(html) {
-      const tables = extractHTMLTables(html)
-      const results = []
-      for (const rows of tables) {
-        const headers = rows[0]
-        const cols = identifyPricingColumns(headers)
-        // 至少需要模型名 + 一个价格列
-        if (cols.model < 0) continue
-        if (cols.inputMiss < 0 && cols.output < 0 && cols.inputHit < 0) continue
-        // 表头需与定价相关
-        const headerText = headers.join(' ')
-        if (!/价格|price|缓存|cache|输入|input|输出|output|tokens/i.test(headerText)) continue
-        for (let i = 1; i < rows.length; i++) {
-          const row = rows[i]
-          const name = (row[cols.model] || '').trim()
-          if (!name || /^(模型|model|名称|合计|total|---)/i.test(name)) continue
-          const input = cols.inputMiss >= 0 ? parsePrice(row[cols.inputMiss]) : null
-          const output = cols.output >= 0 ? parsePrice(row[cols.output]) : null
-          const cacheHit = cols.inputHit >= 0 ? parsePrice(row[cols.inputHit]) : null
-          if (input === null && output === null && cacheHit === null) continue
-          // 判断币种
-          const allText = row.join(' ')
-          const isUSD = /\$|USD|dollar/i.test(allText)
-          results.push({
-            match: name.toLowerCase(),
-            input: input || 0,
-            output: output || 0,
-            cacheRead: cacheHit || 0,
-            cacheWrite: 0, // DeepSeek 官方不收取缓存写入
-            currency: isUSD ? 'usd' : 'cny',
-          })
-        }
-      }
-      return results
-    }
-
-    // 从官网获取最新定价(异步, 失败静默回退内置默认)
-    async function fetchOfficialPricing() {
-      try {
-        const { url } = getPricingFetchConfig()
-        console.log('[dsh-dock] tokenlog fetching official pricing from:', url)
-        const res = await fetch(url, {
-          headers: { 'User-Agent': 'dsh-dock-tokenlog/0.4', 'Accept': 'text/html,*/*' }
-        })
-        if (!res.ok) throw new Error('HTTP ' + res.status)
-        const html = await res.text()
-        console.log('[dsh-dock] tokenlog pricing page fetched, size:', html.length)
-        if (html.length < 500) {
-          console.warn('[dsh-dock] tokenlog page too small, likely SPA shell — using defaults')
-          return
-        }
-        const parsed = parsePricingFromHTML(html)
-        if (parsed.length > 0) {
-          fetchedPricing = parsed
-          lastFetchTime = Date.now()
-          console.log('[dsh-dock] tokenlog parsed', parsed.length, 'models from official pricing')
-        } else {
-          console.warn('[dsh-dock] tokenlog parsed 0 models from pricing page — check page structure, using defaults')
-        }
-      } catch (e) {
-        console.error('[dsh-dock] tokenlog fetch official pricing failed:', e && e.message, '— using built-in defaults')
-      }
-    }
-
-    // 读取 settings.yaml 的 llm-pi-ai 命名空间, 返回「现有提供商」路由名 -> [模型 id]。
-    // 用途: 前端提供商/模型下拉 = 现有配置 ∪ 历史记录, 去重合并 ——
-    //   - 没有任何记录时仍可选现有提供商;
-    //   - 提供商/模型已从配置删除时, 因有历史记录仍可选中(兼容两者)。
-    function readConfiguredProviders() {
-      const out = {}
-      try {
-        const settings = ctx.get('settings')
-        if (!settings || typeof settings.get !== 'function') return out
-        const sec = settings.get('llm-pi-ai')
-        const providers = sec && typeof sec === 'object' && sec.providers ? sec.providers : {}
-        for (const pid of Object.keys(providers || {})) {
-          const p = providers[pid]
-          if (!p || typeof p !== 'object') { out[pid] = []; continue }
-          const models = Array.isArray(p.models) ? p.models : []
-          const ids = []
-          for (const m of models) {
-            const id = m && typeof m === 'object' ? m.id : m
-            if (typeof id === 'string' && id) ids.push(id)
-          }
-          out[pid] = ids
-        }
-      } catch (e) {
-        console.error('[dsh-dock] tokenlog read configured providers failed', e && e.message)
-      }
-      return out
-    }
-
-    // ---------- 事件采集 ----------
-
-    // 预扫描 turn/end: 先建立 turn -> status/error 映射, 再生成记录
-    // (解决顺序处理导致的状态缺失: assistant/message 先于 turn/end 到达)
-    function preScanTurnEnds(sessionId, events) {
-      for (const e of events) {
-        if (e.type !== 'turn/end') continue
-        const t = e.data && e.data.turn
-        const r = e.data && e.data.reason
-        let status = 'completed'
-        if (r && typeof r === 'object') status = r.kind || 'completed'
-        else if (typeof r === 'string') status = r
-        turnStatus.set(sessionId + ':' + t, status)
-        let errInfo = null
-        if (r && typeof r === 'object' && r.error) {
-          const er = r.error
-          errInfo = {
-            statusCode: typeof er.status === 'number' ? er.status : 0,
-            errorCode: er.code || '',
-            errorMsg: er.message || '',
-          }
-        }
-        turnError.set(sessionId + ':' + t, errInfo)
-      }
-    }
-
-    function ingestEvent(sessionId, event) {
-      if (event.type === 'request/header') {
-        const h = event.data && event.data.header
-        if (h && h.config) {
-          headerCache.set(sessionId, {
-            provider: h.config.provider || '',
-            model: h.config.model || '',
-            effort: h.config.reasoningEffort || '',
-          })
-        }
-      }
-      if (event.type === 'turn/end') {
-        const t = event.data && event.data.turn
-        const r = event.data && event.data.reason
-        let status = 'completed'
-        if (r && typeof r === 'object') status = r.kind || 'completed'
-        else if (typeof r === 'string') status = r
-        turnStatus.set(sessionId + ':' + t, status)
-        let errInfo = null
-        if (r && typeof r === 'object' && r.error) {
-          const e = r.error
-          errInfo = {
-            statusCode: typeof e.status === 'number' ? e.status : 0,
-            errorCode: e.code || '',
-            errorMsg: e.message || '',
-          }
-        }
-        turnError.set(sessionId + ':' + t, errInfo)
-      }
-      if (event.type === 'step/start') {
-        stepStart.set(sessionId + ':' + event.data.turn + ':' + event.data.step, event.time)
-      }
-      if (event.type !== 'assistant/message') return null
-      const d = event.data || {}
-      let usage = d.usage
-      if (!usage || typeof usage !== 'object') usage = { inputTokens: 0, outputTokens: 0 }
-      const head = headerCache.get(sessionId) || { provider: '', model: '', effort: '' }
-      const turn = num(d.turn)
-      const step = num(d.step)
-      const startK = sessionId + ':' + turn + ':' + step
-      const startMs = stepStart.get(startK)
-      const llmMs = typeof startMs === 'number' ? Math.max(0, event.time - startMs) : null
-      const status = turnStatus.get(sessionId + ':' + turn) || 'in-progress'
-      const ei = turnError.get(sessionId + ':' + turn) || null
-      const input = num(usage.inputTokens)
-      const output = num(usage.outputTokens)
-      const cacheRead = num(usage.cacheReadTokens)
-      const cacheWrite = num(usage.cacheWriteTokens)
-      const reasoning = num(usage.reasoningTokens)
-      const cost = estimateCost(usage, head.model, event.time)
-      stepStart.delete(startK)
-      return {
-        id: sessionId + ':' + event.seq,
-        time: event.time,
-        sessionId,
-        provider: head.provider || '',
-        model: head.model || '',
-        apiKey: '',
-        inputTokens: input,
-        outputTokens: output,
-        cacheReadTokens: cacheRead,
-        cacheWriteTokens: cacheWrite,
-        reasoningTokens: reasoning,
-        billedInput: input + cacheRead + cacheWrite,
-        totalTokens: input + output + cacheRead + cacheWrite,
-        cacheHitPercent: (input + cacheRead) > 0 ? Math.round((cacheRead / (input + cacheRead)) * 100) : 0,
-        cost,
-        effort: head.effort || '',
-        status,
-        statusCode: ei ? ei.statusCode : 0,
-        errorCode: ei ? ei.errorCode : '',
-        errorMsg: ei ? ei.errorMsg : '',
-        llmMs,
-        turn,
-        step,
-      }
-    }
-
-    function ingestEvents(sessionId, events) {
-      const out = []
-      for (const e of events) {
-        const r = ingestEvent(sessionId, e)
-        if (r) out.push(r)
-      }
-      return out
-    }
-
-    // 历史扫描: 遍历所有会话, 读取完整日志, 重建索引
-    async function scanHistory() {
-      if (!sessionQuery) return
-      try {
-        const sessions = await sessionQuery.listSessions()
-        let added = 0
-        for (const s of sessions) {
-          const sid = s && s.header ? s.header.id : (s && s.id)
-          if (!sid || scannedSessions.has(sid)) continue
-          scannedSessions.add(sid)
-          try {
-            const snap = await sessionQuery.readSession(sid)
-            const events = snap && snap.events ? snap.events : []
-            // 两遍: 先建 turn/end 映射, 再生成记录
-            preScanTurnEnds(sid, events)
-            const recs = ingestEvents(sid, events)
-            for (const r of recs) records.set(r.id, r)
-            added += recs.length
-          } catch (e) {
-            console.error('[dsh-dock] tokenlog scan session failed', sid, e && e.message)
-          }
-        }
-        console.log('[dsh-dock] tokenlog history scanned: +' + added + ' records, total ' + records.size)
-      } catch (e) {
-        console.error('[dsh-dock] tokenlog scanHistory failed', e && e.message)
-      }
-    }
-
-    function buildQuery(args) {
-      const q = args || {}
-      const from = typeof q.from === 'number' ? q.from : 0
-      const to = typeof q.to === 'number' ? q.to : Infinity
-      const provider = (q.provider || '').trim()
-      const model = (q.model || '').trim()
-      const status = (q.status || '').trim()
-      const effort = (q.effort || '').trim()
-      const sessionId = (q.sessionId || '').trim()
-      return [...records.values()].filter((r) => {
-        if (r.time < from || r.time > to) return false
-        if (provider && r.provider !== provider) return false
-        if (model && r.model !== model) return false
-        if (status && r.status !== status) return false
-        if (effort && r.effort !== effort) return false
-        if (sessionId && r.sessionId !== sessionId) return false
-        return true
-      })
-    }
-
-    function summarize(list, dim) {
-      const map = new Map()
-      for (const r of list) {
-        const key = r[dim] || '(none)'
-        const e = map.get(key)
-        if (e) {
-          e.calls += 1
-          e.inputTokens += r.inputTokens
-          e.outputTokens += r.outputTokens
-          e.cacheReadTokens += r.cacheReadTokens
-          e.cacheWriteTokens += r.cacheWriteTokens
-          e.reasoningTokens += r.reasoningTokens
-          e.billedInput += r.billedInput
-          e.totalTokens += r.totalTokens
-          e.cost += r.cost
-          if (typeof r.llmMs === 'number') { e.llmMs += r.llmMs; e.timed += 1 }
-        } else {
-          map.set(key, {
-            key, calls: 1,
-            inputTokens: r.inputTokens, outputTokens: r.outputTokens,
-            cacheReadTokens: r.cacheReadTokens, cacheWriteTokens: r.cacheWriteTokens,
-            reasoningTokens: r.reasoningTokens, billedInput: r.billedInput,
-            totalTokens: r.totalTokens, cost: r.cost,
-            llmMs: typeof r.llmMs === 'number' ? r.llmMs : 0,
-            timed: typeof r.llmMs === 'number' ? 1 : 0,
-          })
-        }
-      }
-      return [...map.values()]
-        .map((e) => ({ ...e, cacheHitPct: e.billedInput > 0 ? Math.round((e.cacheReadTokens / e.billedInput) * 100) : 0 }))
-        .sort((a, b) => b.calls - a.calls)
-    }
-
-    function totals(list) {
-      const t = { calls: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, reasoningTokens: 0, billedInput: 0, totalTokens: 0, cost: 0, llmMs: 0, timed: 0 }
-      for (const r of list) {
-        t.calls += 1
-        t.inputTokens += r.inputTokens
-        t.outputTokens += r.outputTokens
-        t.cacheReadTokens += r.cacheReadTokens
-        t.cacheWriteTokens += r.cacheWriteTokens
-        t.reasoningTokens += r.reasoningTokens
-        t.billedInput += r.billedInput
-        t.totalTokens += r.totalTokens
-        t.cost += r.cost
-        if (typeof r.llmMs === 'number') { t.llmMs += r.llmMs; t.timed += 1 }
-      }
-      t.cacheHitPct = t.billedInput > 0 ? Math.round((t.cacheReadTokens / t.billedInput) * 100) : 0
-      return t
-    }
-
-    // ---------- RPC（webServer HTTP 路由，前缀 /dsh-dock/tokenlog/） ----------
-
-    // 实时监听 + 历史扫描: 必须等 sessionQuery 服务就绪。
-    // 注意: 不能在 setup 时用 ctx.get('sessionQuery') 软获取——profile 插件无 inject 声明,
-    // 可能早于 sessionQuery 提供方激活, 拿到 undefined 会让 监听+扫描 整条采集链路静默失效。
-    // 改用 ctx.inject(['sessionQuery'], ...): 服务已就绪则立即执行, 否则挂起等待。
-    let sessionQuery = null
-    disposers.push(ctx.inject(['sessionQuery'], (sqCtx) => {
-      sessionQuery = sqCtx.sessionQuery
-      // 服务就绪后加载 settings 定价配置(汇率 + pricing 覆盖), 供采集/重扫/导出使用
-      loadPricingConfig()
-      // 从官网获取最新定价(启动时 + 每 24h 自动刷新)
-      fetchOfficialPricing()
-      const fetchTimer = setInterval(fetchOfficialPricing, getPricingFetchConfig().intervalMs)
-      sqCtx.effect(() => () => clearInterval(fetchTimer))
-      // 实时监听: session/event (root scope 可收到所有 session 事件, 与官方 persistence 同款订阅)
-      disposers.push(sqCtx.on('session/event', (session, event) => {
-        try {
-          const sid = typeof session === 'object' && session ? (session.id || '') : String(session || '')
-          const rec = ingestEvent(sid, event)
-          if (rec) records.set(rec.id, rec)
-          // turn/end 到达后回填该 turn 已有记录的状态/错误(实时增量场景)
-          if (event.type === 'turn/end') {
-            const t = event.data && event.data.turn
-            const key = sid + ':' + t
-            const st = turnStatus.get(key)
-            const ei = turnError.get(key) || null
-            if (st) {
-              for (const r of records.values()) {
-                if (r.sessionId === sid && String(r.turn) === String(t)) {
-                  r.status = st
-                  r.statusCode = ei ? ei.statusCode : 0
-                  r.errorCode = ei ? ei.errorCode : ''
-                  r.errorMsg = ei ? ei.errorMsg : ''
-                }
-              }
-            }
-          }
-        } catch (err) {
-          console.error('[dsh-dock] tokenlog ingest error', err)
-        }
-      }))
-      // 服务就绪后立即做一次历史全量扫描
-      scanHistory()
-    }))
-
-    // webServer 就绪后注册 /dsh-dock/tokenlog 前缀路由(ctx.inject 保证就绪后再执行)
-    disposers.push(ctx.inject(['webServer'], (wsCtx) => {
-      wsCtx.effect(() => wsCtx.webServer.register({
-        kind: 'prefix',
-        path: '/dsh-dock/tokenlog',
-        async handler(req, res) {
-          try {
-            const url = new URL(req.url || '/', 'http://dsh.internal')
-            const method = url.pathname.replace(/^\/dsh-dock\/tokenlog\/?/, '').split('/')[0] || ''
-            const payload = await readBody(req)
-            if (method === 'query') {
-              loadPricingConfig()
-              const list = buildQuery(payload || {})
-              const rows = [...list].sort((a, b) => b.time - a.time)
-              const all = [...records.values()]
-              const cfg = readConfiguredProviders()
-              // 提供商/模型下拉 = 现有配置(llm-pi-ai.providers) ∪ 历史记录, 去重排序。
-              // 兼容两种场景: 无记录时仍可选现有提供商; 提供商/模型已删除时因记录仍可选中。
-              const providerSet = new Set(all.map((r) => r.provider).filter(Boolean))
-              const modelSet = new Set(all.map((r) => r.model).filter(Boolean))
-              for (const pid of Object.keys(cfg)) if (pid) providerSet.add(pid)
-              for (const ids of Object.values(cfg)) for (const id of ids) modelSet.add(id)
-              // 提供商 -> 模型 映射(供前端联动筛选: 选中提供商后模型下拉只显示其下模型)
-              const modelsByProvider = {}
-              const initMbp = (p) => { if (!modelsByProvider[p]) modelsByProvider[p] = [] }
-              for (const p of providerSet) initMbp(p)
-              for (const r of all) {
-                if (!r.model) continue
-                const p = r.provider || '(none)'
-                initMbp(p)
-                if (!modelsByProvider[p].includes(r.model)) modelsByProvider[p].push(r.model)
-              }
-              for (const [pid, ids] of Object.entries(cfg)) {
-                initMbp(pid)
-                for (const id of ids) if (!modelsByProvider[pid].includes(id)) modelsByProvider[pid].push(id)
-              }
-              for (const p of Object.keys(modelsByProvider)) modelsByProvider[p].sort()
-              return sendJson(res, 200, {
-                ok: true,
-                data: {
-                  records: rows,
-                  counts: { total: records.size, matching: rows.length },
-                  providers: [...providerSet].sort(),
-                  models: [...modelSet].sort(),
-                  modelsByProvider,
-                  statuses: [...new Set(all.map((r) => r.status).filter(Boolean))],
-                  efforts: [...new Set(all.map((r) => r.effort).filter(Boolean))],
-                  sessionIds: [...new Set(all.map((r) => r.sessionId).filter(Boolean))].sort(),
-                  rateUsdCny: usdCnyRate,
-                  totals: totals(list),
-                  summary: payload && payload.dim ? summarize(list, payload.dim) : [],
-                }
-              })
-            }
-            if (method === 'export') {
-              loadPricingConfig()
-              const list = buildQuery(payload || {})
-              const header = ['time', 'provider', 'model', 'apiKey', 'inputTokens', 'outputTokens', 'cacheReadTokens', 'cacheWriteTokens', 'reasoningTokens', 'billedInput', 'cacheHitPercent', 'totalTokens', 'costCny', 'effort', 'status', 'statusCode', 'errorCode', 'errorMsg', 'llmMs', 'sessionId', 'turn', 'step']
-              const esc = (v) => {
-                const s = String(v === undefined || v === null ? '' : v)
-                return /[,"\n]/.test(s) ? '"' + s.replace(/"/g, '""') + '"' : s
-              }
-              const lines = [header.map(esc).join(',')]
-              for (const r of list) lines.push(header.map((h) => esc(h === 'costCny' ? ((Number(r.cost) || 0) * usdCnyRate) : r[h])).join(','))
-              return sendJson(res, 200, { ok: true, data: { csv: lines.join('\n'), count: list.length } })
-            }
-            if (method === 'scan') {
-              await scanHistory()
-              return sendJson(res, 200, { ok: true, data: { total: records.size } })
-            }
-            if (method === 'hello') {
-              return sendJson(res, 200, { ok: true, data: { ok: true, records: records.size, scanned: scannedSessions.size } })
-            }
-            return sendJson(res, 404, { ok: false, error: { code: 'method-not-found', message: 'unknown method: ' + method, details: {} } })
-          } catch (e) {
-            return sendJson(res, 500, { ok: false, error: { code: 'internal', message: (e && e.message) || String(e), details: {} } })
-          }
-        }
-      }), 'dsh-dock tokenlog: /dsh-dock/tokenlog HTTP route')
-    }))
-
-    return dispose
-  },
-}
+// dsh-dock · 功能模块【用量记录】· 宿主半部（v0.4.0，移植自 @wycto/dsh-token-usage lib/index.js）
+//
+// 记录 DSH 会话日志中的每次 LLM 调用（assistant/message 的 usage），
+// 支持历史全量扫描 + 实时 session/event 增量；RPC 经 webServer HTTP 路由
+//   POST /dsh-dock/tokenlog/query|export|scan|hello
+// 向浏览器半部提供查询/统计/导出。
+//
+// 数据模型（标量，无 Host 对象引用）：
+// {
+//   id, time, sessionId, provider, model, apiKey(掩码),
+//   inputTokens, outputTokens, cacheReadTokens, cacheWriteTokens, reasoningTokens,
+//   billedInput, totalTokens, cacheHitPercent, cost, effort, status, llmMs, turn, step
+// }
+//
+// 定价可经 settings.yaml 的 dsh-dock-tokenlog 命名空间覆盖（未注册 schema，读原始用户层）：
+//   dsh-dock-tokenlog:
+//     usdCnyRate: 7.2
+//     pricingUrl: 'https://api-docs.deepseek.com/zh-cn/quick_start/pricing'
+//     pricingFetchIntervalHours: 24
+//     pricing:
+//       deepseek-v4-flash: { input: 1.5, output: 4.5, cacheRead: 0.05, cacheWrite: 0 }
+import { sendJson, readBody } from '../../src/host-core.js'
+
+/** 本功能的 settings 覆盖命名空间（未注册 schema：读取原始用户层，字段全部可选）。 */
+const NS = 'dsh-dock-tokenlog'
+
+export const feature = {
+  id: 'tokenlog',
+  name: '用量记录',
+  description: '记录全部 LLM API 调用并统计 Token 用量与花费',
+  defaultEnabled: false,
+  setup(ctx) {
+    const disposers = []
+    const dispose = () => {
+      while (disposers.length > 0) {
+        const fn = disposers.pop()
+        try { if (typeof fn === 'function') fn() } catch { /* 停用清理失败不阻断 */ }
+      }
+    }
+
+    // 用 Map<id, record> 存记录: id = sessionId:seq 天然唯一。
+    // 实时监听与历史扫描存在重叠窗口(活跃会话既被实时 push 又被扫描全量读),
+    // 用 set 幂等去重, 避免同一条 LLM 调用被统计两次(此前用数组 push 导致"两倍")。
+    const records = new Map()
+    let scannedSessions = new Set()
+    const headerCache = new Map()
+    const turnError = new Map()
+    const turnStatus = new Map()
+    const stepStart = new Map()
+
+    function num(v) { return typeof v === 'number' && Number.isFinite(v) ? v : 0 }
+
+    // ===== 定价与金额估算 =====
+    // 定价表以「人民币元 / 百万 tokens」为基准(DeepSeek/智谱官方刊例即人民币), 金额先算 CNY,
+    // 对外记录的 cost 保持 USD，供旧版客户端兼容；当前客户端和 CSV 统一展示人民币。
+    // usdCnyRate 与 pricing 均可被 settings.yaml 覆盖:
+    //   dsh-dock-tokenlog:
+    //     usdCnyRate: 7.2                    # USD↔CNY 汇率
+    //     pricing:                            # 可选: 覆盖/新增定价条目(modelPattern -> {...})
+    //       deepseek-v4-flash:
+    //         input: 1.5  output: 4.5  cacheRead: 0.05  cacheWrite: 0
+    //         peak: { start: 9, end: 14, input: 3.0, output: 9.0, cacheRead: 0.10, cacheWrite: 0 }
+    // 官方价格随时会变动: 改价只改 settings.yaml 即可, 无需升级插件; 重启/重扫后历史记录按新价重算。
+    let usdCnyRate = 7.2
+    let fallbackPricing = { match: '*', input: 2.16, output: 6.48, cacheRead: 0.43, cacheWrite: 4.32 }
+    // 内置定价表(人民币元 / 百万 tokens), 按 model 子串匹配; 未匹配走 fallback。
+    // 支持峰谷定价: 条目带 peak={start,end,input,output,cacheRead,cacheWrite},
+    // 高峰时段(插件运行机器本地时间 [start,end))用峰价, 其余用基础价。
+    // 官方来源: DeepSeek-V4 系列 2026-08-17 生效的峰谷刊例(高峰每日 9:00-14:00, 空闲为高峰一半)。
+    const DEFAULT_PRICING = [
+      { match: 'deepseek-v4-flash', input: 1.5, output: 4.5, cacheRead: 0.05, cacheWrite: 0,
+        peak: { start: 9, end: 14, input: 3.0, output: 9.0, cacheRead: 0.10, cacheWrite: 0 } },
+      { match: 'deepseek-v4-pro', input: 4.5, output: 13.5, cacheRead: 0.15, cacheWrite: 0,
+        peak: { start: 9, end: 14, input: 9.0, output: 27.0, cacheRead: 0.30, cacheWrite: 0 } },
+      { match: 'deepseek-v3', input: 3.6, output: 7.2, cacheRead: 0.72, cacheWrite: 7.2 },
+      { match: 'deepseek-chat', input: 1.94, output: 7.92, cacheRead: 0.5, cacheWrite: 7.92 },
+      { match: 'deepseek-reasoner', input: 3.96, output: 15.77, cacheRead: 1.01, cacheWrite: 7.92 },
+      { match: 'nemotron', input: 1.08, output: 2.88, cacheRead: 0.22, cacheWrite: 2.16 },
+      { match: 'glm', input: 2.88, output: 8.64, cacheRead: 0.58, cacheWrite: 7.2 },
+    ]
+    let pricingTable = DEFAULT_PRICING
+
+    function normalizePricing(match, e) {
+      const n = (x) => (typeof x === 'number' && Number.isFinite(x) ? x : 0)
+      const row = { match, input: n(e.input), output: n(e.output), cacheRead: n(e.cacheRead), cacheWrite: n(e.cacheWrite) }
+      if (e.peak && typeof e.peak === 'object') {
+        row.peak = {
+          start: n(e.peak.start), end: n(e.peak.end),
+          input: n(e.peak.input), output: n(e.peak.output),
+          cacheRead: n(e.peak.cacheRead), cacheWrite: n(e.peak.cacheWrite),
+        }
+      }
+      return row
+    }
+
+    // 读取 settings.yaml 的 dsh-dock-tokenlog { usdCnyRate?, pricing? } 覆盖默认值。
+    // pricing: map modelPattern -> {input,output,cacheRead,cacheWrite,peak?};
+    // 设置条目排前面优先命中(同 match 覆盖内置); 键 '*' 覆盖 fallback。幂等, 可重复调用。
+    function loadPricingConfig() {
+      try {
+        const settings = ctx.get('settings')
+        if (!settings || typeof settings.get !== 'function') return
+        const v = settings.get(NS)
+        if (!v || typeof v !== 'object') return
+        if (typeof v.usdCnyRate === 'number' && v.usdCnyRate > 0) usdCnyRate = v.usdCnyRate
+        if (v.pricing && typeof v.pricing === 'object') {
+          const overrides = []
+          for (const [match, entry] of Object.entries(v.pricing)) {
+            if (!entry || typeof entry !== 'object') continue
+            const row = normalizePricing(String(match).toLowerCase(), entry)
+            if (row.match === '*') fallbackPricing = row
+            else overrides.push(row)
+          }
+          pricingTable = overrides.concat(DEFAULT_PRICING)
+        }
+      } catch (e) {
+        console.error('[dsh-dock] tokenlog read pricing config failed', e && e.message)
+      }
+    }
+
+    // 命中定价行: 优先官网自动获取 → settings.yaml 覆盖+内置 → fallback; 再按调用时刻取峰/谷价。
+    // 官网获取的数据若为 USD 则自动折成 CNY(内置表已是 CNY)。返回人民币单价(元/百万 tokens)。
+    function resolvePricing(model, timeMs) {
+      const m = String(model || '').toLowerCase()
+      let row = null
+      let fromFetch = false
+      // 1. 优先: 官网自动获取的定价(48h 内有效, 超时回退内置)
+      const fetched = fetchedPricing
+      if (fetched && fetched.length > 0 && (Date.now() - lastFetchTime < FETCH_INTERVAL_MS * 2)) {
+        for (const r of fetched) {
+          if (m.includes(r.match)) { row = r; fromFetch = true; break }
+        }
+      }
+      // 2. 回退: settings.yaml 覆盖 + 内置表
+      if (!row) {
+        for (const r of pricingTable) {
+          if (m.includes(r.match)) { row = r; break }
+        }
+      }
+      if (!row) row = fallbackPricing
+      // 3. 峰谷判断(本地时间 [start,end) 用峰价)
+      const h = (typeof timeMs === 'number' && Number.isFinite(timeMs)) ? new Date(timeMs).getHours() : -1
+      let prices
+      if (row.peak && h >= row.peak.start && h < row.peak.end) {
+        prices = { input: row.peak.input, output: row.peak.output, cacheRead: row.peak.cacheRead, cacheWrite: row.peak.cacheWrite }
+      } else {
+        prices = { input: row.input, output: row.output, cacheRead: row.cacheRead, cacheWrite: row.cacheWrite }
+      }
+      // 4. 币种转换: 获取的数据若是 USD 则折成 CNY(内置表已是 CNY, 无需转换)
+      if (fromFetch && row.currency === 'usd') {
+        prices.input *= usdCnyRate
+        prices.output *= usdCnyRate
+        prices.cacheRead *= usdCnyRate
+        prices.cacheWrite *= usdCnyRate
+      }
+      return prices
+    }
+    // 金额估算: 表为人民币价 → 先算 CNY, 再折成 USD(= CNY / usdCnyRate) 供客户端/CSV 使用。
+    function estimateCost(usage, model, timeMs) {
+      const p = resolvePricing(model, timeMs)
+      const cny = (
+        num(usage.inputTokens) * p.input +
+        num(usage.cacheReadTokens) * p.cacheRead +
+        num(usage.cacheWriteTokens) * p.cacheWrite +
+        num(usage.outputTokens) * p.output
+      ) / 1e6
+      return cny / usdCnyRate
+    }
+
+    // ===== 官网定价自动获取 =====
+    // 每 24 小时从 DeepSeek 官网抓取最新定价并解析 HTML 表格; 抓取/解析失败时使用内置默认值。
+    const FETCH_INTERVAL_MS = 24 * 60 * 60 * 1000
+    let fetchedPricing = null  // Array<{ match, input, output, cacheRead, cacheWrite, currency }>
+    let lastFetchTime = 0
+
+    function getPricingFetchConfig() {
+      let url = 'https://api-docs.deepseek.com/zh-cn/quick_start/pricing'
+      let intervalMs = FETCH_INTERVAL_MS
+      try {
+        const settings = ctx.get('settings')
+        if (settings && typeof settings.get === 'function') {
+          const v = settings.get(NS)
+          if (v && typeof v === 'object') {
+            if (typeof v.pricingUrl === 'string' && v.pricingUrl) url = v.pricingUrl
+            if (typeof v.pricingFetchIntervalHours === 'number' && v.pricingFetchIntervalHours > 0) intervalMs = v.pricingFetchIntervalHours * 3600000
+          }
+        }
+      } catch (e) { /* 用默认 */ }
+      return { url, intervalMs }
+    }
+
+    // 从 HTML 中提取所有 <table> 的行列数据
+    function extractHTMLTables(html) {
+      const tables = []
+      const tableRe = /<table[^>]*>([\s\S]*?)<\/table>/gi
+      let tm
+      while ((tm = tableRe.exec(html)) !== null) {
+        const rows = []
+        const trRe = /<tr[^>]*>([\s\S]*?)<\/tr>/gi
+        let tr
+        while ((tr = trRe.exec(tm[1])) !== null) {
+          const cells = []
+          const tdRe = /<t[hd][^>]*>([\s\S]*?)<\/t[hd]>/gi
+          let td
+          while ((td = tdRe.exec(tr[1])) !== null) {
+            cells.push(td[1].replace(/<[^>]+>/g, '').replace(/&[a-z]+;/g, ' ').trim())
+          }
+          if (cells.length > 0) rows.push(cells)
+        }
+        if (rows.length >= 2) tables.push(rows)
+      }
+      return tables
+    }
+
+    // 从价格字符串提取数字(支持 "$0.27", "0.27", "¥1.5", "1.5元", "1,500" 等格式)
+    function parsePrice(s) {
+      if (!s) return null
+      const cleaned = String(s).replace(/,/g, '').replace(/￥|¥|元|\/.*$/g, '').trim()
+      const m = cleaned.match(/(\d+\.?\d*)/)
+      return m ? parseFloat(m[1]) : null
+    }
+
+    // 识别定价表列: 通过表头关键词定位各列
+    function identifyPricingColumns(headers) {
+      const h = headers.map(x => x.toLowerCase())
+      const find = (...patterns) => {
+        for (const p of patterns) {
+          const idx = h.findIndex(x => x.includes(p))
+          if (idx >= 0) return idx
+        }
+        return -1
+      }
+      return {
+        model: find('模型', 'model', '名称', 'name'),
+        inputMiss: find('缓存未命中', '未缓存', 'cache miss', 'uncached'),
+        inputHit: find('缓存命中', 'cache hit', 'cached'),
+        output: find('输出', 'output'),
+        peak: find('高峰', 'peak', 'busy', 'on-peak'),
+      }
+    }
+
+    // 从 HTML 解析 DeepSeek 官网定价
+    // 策略: 提取所有 <table>, 找到含"价格/缓存/输入/输出"关键词的表, 逐行提取模型名+价格;
+    // 识别 $ 标记区分 USD/CNY 币种; 无法解析时返回空数组(回退内置默认)。
+    function parsePricingFromHTML(html) {
+      const tables = extractHTMLTables(html)
+      const results = []
+      for (const rows of tables) {
+        const headers = rows[0]
+        const cols = identifyPricingColumns(headers)
+        // 至少需要模型名 + 一个价格列
+        if (cols.model < 0) continue
+        if (cols.inputMiss < 0 && cols.output < 0 && cols.inputHit < 0) continue
+        // 表头需与定价相关
+        const headerText = headers.join(' ')
+        if (!/价格|price|缓存|cache|输入|input|输出|output|tokens/i.test(headerText)) continue
+        for (let i = 1; i < rows.length; i++) {
+          const row = rows[i]
+          const name = (row[cols.model] || '').trim()
+          if (!name || /^(模型|model|名称|合计|total|---)/i.test(name)) continue
+          const input = cols.inputMiss >= 0 ? parsePrice(row[cols.inputMiss]) : null
+          const output = cols.output >= 0 ? parsePrice(row[cols.output]) : null
+          const cacheHit = cols.inputHit >= 0 ? parsePrice(row[cols.inputHit]) : null
+          if (input === null && output === null && cacheHit === null) continue
+          // 判断币种
+          const allText = row.join(' ')
+          const isUSD = /\$|USD|dollar/i.test(allText)
+          results.push({
+            match: name.toLowerCase(),
+            input: input || 0,
+            output: output || 0,
+            cacheRead: cacheHit || 0,
+            cacheWrite: 0, // DeepSeek 官方不收取缓存写入
+            currency: isUSD ? 'usd' : 'cny',
+          })
+        }
+      }
+      return results
+    }
+
+    // 从官网获取最新定价(异步, 失败静默回退内置默认)
+    async function fetchOfficialPricing() {
+      try {
+        const { url } = getPricingFetchConfig()
+        console.log('[dsh-dock] tokenlog fetching official pricing from:', url)
+        const res = await fetch(url, {
+          headers: { 'User-Agent': 'dsh-dock-tokenlog/0.4', 'Accept': 'text/html,*/*' }
+        })
+        if (!res.ok) throw new Error('HTTP ' + res.status)
+        const html = await res.text()
+        console.log('[dsh-dock] tokenlog pricing page fetched, size:', html.length)
+        if (html.length < 500) {
+          console.warn('[dsh-dock] tokenlog page too small, likely SPA shell — using defaults')
+          return
+        }
+        const parsed = parsePricingFromHTML(html)
+        if (parsed.length > 0) {
+          fetchedPricing = parsed
+          lastFetchTime = Date.now()
+          console.log('[dsh-dock] tokenlog parsed', parsed.length, 'models from official pricing')
+        } else {
+          console.warn('[dsh-dock] tokenlog parsed 0 models from pricing page — check page structure, using defaults')
+        }
+      } catch (e) {
+        console.error('[dsh-dock] tokenlog fetch official pricing failed:', e && e.message, '— using built-in defaults')
+      }
+    }
+
+    // 读取 settings.yaml 的 llm-pi-ai 命名空间, 返回「现有提供商」路由名 -> [模型 id]。
+    // 用途: 前端提供商/模型下拉 = 现有配置 ∪ 历史记录, 去重合并 ——
+    //   - 没有任何记录时仍可选现有提供商;
+    //   - 提供商/模型已从配置删除时, 因有历史记录仍可选中(兼容两者)。
+    function readConfiguredProviders() {
+      const out = {}
+      try {
+        const settings = ctx.get('settings')
+        if (!settings || typeof settings.get !== 'function') return out
+        const sec = settings.get('llm-pi-ai')
+        const providers = sec && typeof sec === 'object' && sec.providers ? sec.providers : {}
+        for (const pid of Object.keys(providers || {})) {
+          const p = providers[pid]
+          if (!p || typeof p !== 'object') { out[pid] = []; continue }
+          const models = Array.isArray(p.models) ? p.models : []
+          const ids = []
+          for (const m of models) {
+            const id = m && typeof m === 'object' ? m.id : m
+            if (typeof id === 'string' && id) ids.push(id)
+          }
+          out[pid] = ids
+        }
+      } catch (e) {
+        console.error('[dsh-dock] tokenlog read configured providers failed', e && e.message)
+      }
+      return out
+    }
+
+    // ---------- 事件采集 ----------
+
+    // 预扫描 turn/end: 先建立 turn -> status/error 映射, 再生成记录
+    // (解决顺序处理导致的状态缺失: assistant/message 先于 turn/end 到达)
+    function preScanTurnEnds(sessionId, events) {
+      for (const e of events) {
+        if (e.type !== 'turn/end') continue
+        const t = e.data && e.data.turn
+        const r = e.data && e.data.reason
+        let status = 'completed'
+        if (r && typeof r === 'object') status = r.kind || 'completed'
+        else if (typeof r === 'string') status = r
+        turnStatus.set(sessionId + ':' + t, status)
+        let errInfo = null
+        if (r && typeof r === 'object' && r.error) {
+          const er = r.error
+          errInfo = {
+            statusCode: typeof er.status === 'number' ? er.status : 0,
+            errorCode: er.code || '',
+            errorMsg: er.message || '',
+          }
+        }
+        turnError.set(sessionId + ':' + t, errInfo)
+      }
+    }
+
+    function ingestEvent(sessionId, event) {
+      if (event.type === 'request/header') {
+        const h = event.data && event.data.header
+        if (h && h.config) {
+          headerCache.set(sessionId, {
+            provider: h.config.provider || '',
+            model: h.config.model || '',
+            effort: h.config.reasoningEffort || '',
+          })
+        }
+      }
+      if (event.type === 'turn/end') {
+        const t = event.data && event.data.turn
+        const r = event.data && event.data.reason
+        let status = 'completed'
+        if (r && typeof r === 'object') status = r.kind || 'completed'
+        else if (typeof r === 'string') status = r
+        turnStatus.set(sessionId + ':' + t, status)
+        let errInfo = null
+        if (r && typeof r === 'object' && r.error) {
+          const e = r.error
+          errInfo = {
+            statusCode: typeof e.status === 'number' ? e.status : 0,
+            errorCode: e.code || '',
+            errorMsg: e.message || '',
+          }
+        }
+        turnError.set(sessionId + ':' + t, errInfo)
+      }
+      if (event.type === 'step/start') {
+        stepStart.set(sessionId + ':' + event.data.turn + ':' + event.data.step, event.time)
+      }
+      if (event.type !== 'assistant/message') return null
+      const d = event.data || {}
+      let usage = d.usage
+      if (!usage || typeof usage !== 'object') usage = { inputTokens: 0, outputTokens: 0 }
+      const head = headerCache.get(sessionId) || { provider: '', model: '', effort: '' }
+      const turn = num(d.turn)
+      const step = num(d.step)
+      const startK = sessionId + ':' + turn + ':' + step
+      const startMs = stepStart.get(startK)
+      const llmMs = typeof startMs === 'number' ? Math.max(0, event.time - startMs) : null
+      const status = turnStatus.get(sessionId + ':' + turn) || 'in-progress'
+      const ei = turnError.get(sessionId + ':' + turn) || null
+      const input = num(usage.inputTokens)
+      const output = num(usage.outputTokens)
+      const cacheRead = num(usage.cacheReadTokens)
+      const cacheWrite = num(usage.cacheWriteTokens)
+      const reasoning = num(usage.reasoningTokens)
+      const cost = estimateCost(usage, head.model, event.time)
+      stepStart.delete(startK)
+      return {
+        id: sessionId + ':' + event.seq,
+        time: event.time,
+        sessionId,
+        provider: head.provider || '',
+        model: head.model || '',
+        apiKey: '',
+        inputTokens: input,
+        outputTokens: output,
+        cacheReadTokens: cacheRead,
+        cacheWriteTokens: cacheWrite,
+        reasoningTokens: reasoning,
+        billedInput: input + cacheRead + cacheWrite,
+        totalTokens: input + output + cacheRead + cacheWrite,
+        cacheHitPercent: (input + cacheRead) > 0 ? Math.round((cacheRead / (input + cacheRead)) * 100) : 0,
+        cost,
+        effort: head.effort || '',
+        status,
+        statusCode: ei ? ei.statusCode : 0,
+        errorCode: ei ? ei.errorCode : '',
+        errorMsg: ei ? ei.errorMsg : '',
+        llmMs,
+        turn,
+        step,
+      }
+    }
+
+    function ingestEvents(sessionId, events) {
+      const out = []
+      for (const e of events) {
+        const r = ingestEvent(sessionId, e)
+        if (r) out.push(r)
+      }
+      return out
+    }
+
+    // 历史扫描: 遍历所有会话, 读取完整日志, 重建索引
+    async function scanHistory() {
+      if (!sessionQuery) return
+      try {
+        const sessions = await sessionQuery.listSessions()
+        let added = 0
+        for (const s of sessions) {
+          const sid = s && s.header ? s.header.id : (s && s.id)
+          if (!sid || scannedSessions.has(sid)) continue
+          scannedSessions.add(sid)
+          try {
+            const snap = await sessionQuery.readSession(sid)
+            const events = snap && snap.events ? snap.events : []
+            // 两遍: 先建 turn/end 映射, 再生成记录
+            preScanTurnEnds(sid, events)
+            const recs = ingestEvents(sid, events)
+            for (const r of recs) records.set(r.id, r)
+            added += recs.length
+          } catch (e) {
+            console.error('[dsh-dock] tokenlog scan session failed', sid, e && e.message)
+          }
+        }
+        console.log('[dsh-dock] tokenlog history scanned: +' + added + ' records, total ' + records.size)
+      } catch (e) {
+        console.error('[dsh-dock] tokenlog scanHistory failed', e && e.message)
+      }
+    }
+
+    function buildQuery(args) {
+      const q = args || {}
+      const from = typeof q.from === 'number' ? q.from : 0
+      const to = typeof q.to === 'number' ? q.to : Infinity
+      const provider = (q.provider || '').trim()
+      const model = (q.model || '').trim()
+      const status = (q.status || '').trim()
+      const effort = (q.effort || '').trim()
+      const sessionId = (q.sessionId || '').trim()
+      return [...records.values()].filter((r) => {
+        if (r.time < from || r.time > to) return false
+        if (provider && r.provider !== provider) return false
+        if (model && r.model !== model) return false
+        if (status && r.status !== status) return false
+        if (effort && r.effort !== effort) return false
+        if (sessionId && r.sessionId !== sessionId) return false
+        return true
+      })
+    }
+
+    function summarize(list, dim) {
+      const map = new Map()
+      for (const r of list) {
+        const key = r[dim] || '(none)'
+        const e = map.get(key)
+        if (e) {
+          e.calls += 1
+          e.inputTokens += r.inputTokens
+          e.outputTokens += r.outputTokens
+          e.cacheReadTokens += r.cacheReadTokens
+          e.cacheWriteTokens += r.cacheWriteTokens
+          e.reasoningTokens += r.reasoningTokens
+          e.billedInput += r.billedInput
+          e.totalTokens += r.totalTokens
+          e.cost += r.cost
+          if (typeof r.llmMs === 'number') { e.llmMs += r.llmMs; e.timed += 1 }
+        } else {
+          map.set(key, {
+            key, calls: 1,
+            inputTokens: r.inputTokens, outputTokens: r.outputTokens,
+            cacheReadTokens: r.cacheReadTokens, cacheWriteTokens: r.cacheWriteTokens,
+            reasoningTokens: r.reasoningTokens, billedInput: r.billedInput,
+            totalTokens: r.totalTokens, cost: r.cost,
+            llmMs: typeof r.llmMs === 'number' ? r.llmMs : 0,
+            timed: typeof r.llmMs === 'number' ? 1 : 0,
+          })
+        }
+      }
+      return [...map.values()]
+        .map((e) => ({ ...e, cacheHitPct: e.billedInput > 0 ? Math.round((e.cacheReadTokens / e.billedInput) * 100) : 0 }))
+        .sort((a, b) => b.calls - a.calls)
+    }
+
+    function totals(list) {
+      const t = { calls: 0, inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheWriteTokens: 0, reasoningTokens: 0, billedInput: 0, totalTokens: 0, cost: 0, llmMs: 0, timed: 0 }
+      for (const r of list) {
+        t.calls += 1
+        t.inputTokens += r.inputTokens
+        t.outputTokens += r.outputTokens
+        t.cacheReadTokens += r.cacheReadTokens
+        t.cacheWriteTokens += r.cacheWriteTokens
+        t.reasoningTokens += r.reasoningTokens
+        t.billedInput += r.billedInput
+        t.totalTokens += r.totalTokens
+        t.cost += r.cost
+        if (typeof r.llmMs === 'number') { t.llmMs += r.llmMs; t.timed += 1 }
+      }
+      t.cacheHitPct = t.billedInput > 0 ? Math.round((t.cacheReadTokens / t.billedInput) * 100) : 0
+      return t
+    }
+
+    // ---------- RPC（webServer HTTP 路由，前缀 /dsh-dock/tokenlog/） ----------
+
+    // 实时监听 + 历史扫描: 必须等 sessionQuery 服务就绪。
+    // 注意: 不能在 setup 时用 ctx.get('sessionQuery') 软获取——profile 插件无 inject 声明,
+    // 可能早于 sessionQuery 提供方激活, 拿到 undefined 会让 监听+扫描 整条采集链路静默失效。
+    // 改用 ctx.inject(['sessionQuery'], ...): 服务已就绪则立即执行, 否则挂起等待。
+    let sessionQuery = null
+    disposers.push(ctx.inject(['sessionQuery'], (sqCtx) => {
+      sessionQuery = sqCtx.sessionQuery
+      // 服务就绪后加载 settings 定价配置(汇率 + pricing 覆盖), 供采集/重扫/导出使用
+      loadPricingConfig()
+      // 从官网获取最新定价(启动时 + 每 24h 自动刷新)
+      fetchOfficialPricing()
+      const fetchTimer = setInterval(fetchOfficialPricing, getPricingFetchConfig().intervalMs)
+      sqCtx.effect(() => () => clearInterval(fetchTimer))
+      // 实时监听: session/event (root scope 可收到所有 session 事件, 与官方 persistence 同款订阅)
+      disposers.push(sqCtx.on('session/event', (session, event) => {
+        try {
+          const sid = typeof session === 'object' && session ? (session.id || '') : String(session || '')
+          const rec = ingestEvent(sid, event)
+          if (rec) records.set(rec.id, rec)
+          // turn/end 到达后回填该 turn 已有记录的状态/错误(实时增量场景)
+          if (event.type === 'turn/end') {
+            const t = event.data && event.data.turn
+            const key = sid + ':' + t
+            const st = turnStatus.get(key)
+            const ei = turnError.get(key) || null
+            if (st) {
+              for (const r of records.values()) {
+                if (r.sessionId === sid && String(r.turn) === String(t)) {
+                  r.status = st
+                  r.statusCode = ei ? ei.statusCode : 0
+                  r.errorCode = ei ? ei.errorCode : ''
+                  r.errorMsg = ei ? ei.errorMsg : ''
+                }
+              }
+            }
+          }
+        } catch (err) {
+          console.error('[dsh-dock] tokenlog ingest error', err)
+        }
+      }))
+      // 服务就绪后立即做一次历史全量扫描
+      scanHistory()
+    }))
+
+    // webServer 就绪后注册 /dsh-dock/tokenlog 前缀路由(ctx.inject 保证就绪后再执行)
+    disposers.push(ctx.inject(['webServer'], (wsCtx) => {
+      wsCtx.effect(() => wsCtx.webServer.register({
+        kind: 'prefix',
+        path: '/dsh-dock/tokenlog',
+        async handler(req, res) {
+          try {
+            const url = new URL(req.url || '/', 'http://dsh.internal')
+            const method = url.pathname.replace(/^\/dsh-dock\/tokenlog\/?/, '').split('/')[0] || ''
+            const payload = await readBody(req)
+            if (method === 'query') {
+              loadPricingConfig()
+              const list = buildQuery(payload || {})
+              const rows = [...list].sort((a, b) => b.time - a.time)
+              const all = [...records.values()]
+              const cfg = readConfiguredProviders()
+              // 提供商/模型下拉 = 现有配置(llm-pi-ai.providers) ∪ 历史记录, 去重排序。
+              // 兼容两种场景: 无记录时仍可选现有提供商; 提供商/模型已删除时因记录仍可选中。
+              const providerSet = new Set(all.map((r) => r.provider).filter(Boolean))
+              const modelSet = new Set(all.map((r) => r.model).filter(Boolean))
+              for (const pid of Object.keys(cfg)) if (pid) providerSet.add(pid)
+              for (const ids of Object.values(cfg)) for (const id of ids) modelSet.add(id)
+              // 提供商 -> 模型 映射(供前端联动筛选: 选中提供商后模型下拉只显示其下模型)
+              const modelsByProvider = {}
+              const initMbp = (p) => { if (!modelsByProvider[p]) modelsByProvider[p] = [] }
+              for (const p of providerSet) initMbp(p)
+              for (const r of all) {
+                if (!r.model) continue
+                const p = r.provider || '(none)'
+                initMbp(p)
+                if (!modelsByProvider[p].includes(r.model)) modelsByProvider[p].push(r.model)
+              }
+              for (const [pid, ids] of Object.entries(cfg)) {
+                initMbp(pid)
+                for (const id of ids) if (!modelsByProvider[pid].includes(id)) modelsByProvider[pid].push(id)
+              }
+              for (const p of Object.keys(modelsByProvider)) modelsByProvider[p].sort()
+              return sendJson(res, 200, {
+                ok: true,
+                data: {
+                  records: rows,
+                  counts: { total: records.size, matching: rows.length },
+                  providers: [...providerSet].sort(),
+                  models: [...modelSet].sort(),
+                  modelsByProvider,
+                  statuses: [...new Set(all.map((r) => r.status).filter(Boolean))],
+                  efforts: [...new Set(all.map((r) => r.effort).filter(Boolean))],
+                  sessionIds: [...new Set(all.map((r) => r.sessionId).filter(Boolean))].sort(),
+                  rateUsdCny: usdCnyRate,
+                  totals: totals(list),
+                  summary: payload && payload.dim ? summarize(list, payload.dim) : [],
+                }
+              })
+            }
+            if (method === 'export') {
+              loadPricingConfig()
+              const list = buildQuery(payload || {})
+              const header = ['time', 'provider', 'model', 'apiKey', 'inputTokens', 'outputTokens', 'cacheReadTokens', 'cacheWriteTokens', 'reasoningTokens', 'billedInput', 'cacheHitPercent', 'totalTokens', 'costCny', 'effort', 'status', 'statusCode', 'errorCode', 'errorMsg', 'llmMs', 'sessionId', 'turn', 'step']
+              const esc = (v) => {
+                const s = String(v === undefined || v === null ? '' : v)
+                return /[,"\n]/.test(s) ? '"' + s.replace(/"/g, '""') + '"' : s
+              }
+              const lines = [header.map(esc).join(',')]
+              for (const r of list) lines.push(header.map((h) => esc(h === 'costCny' ? ((Number(r.cost) || 0) * usdCnyRate) : r[h])).join(','))
+              return sendJson(res, 200, { ok: true, data: { csv: lines.join('\n'), count: list.length } })
+            }
+            if (method === 'scan') {
+              await scanHistory()
+              return sendJson(res, 200, { ok: true, data: { total: records.size } })
+            }
+            if (method === 'hello') {
+              return sendJson(res, 200, { ok: true, data: { ok: true, records: records.size, scanned: scannedSessions.size } })
+            }
+            return sendJson(res, 404, { ok: false, error: { code: 'method-not-found', message: 'unknown method: ' + method, details: {} } })
+          } catch (e) {
+            return sendJson(res, 500, { ok: false, error: { code: 'internal', message: (e && e.message) || String(e), details: {} } })
+          }
+        }
+      }), 'dsh-dock tokenlog: /dsh-dock/tokenlog HTTP route')
+    }))
+
+    return dispose
+  },
+}