@mzzsfy/dsh-usage-dash 0.10.3 → 0.10.5

package/test/store.test.mjs

@@ -81,9 +81,13 @@ function fakeDomain({ failUpdate = () => null } = {}) {
   }
 }
 
+// F14 契约:record 按档保留资格过滤。夹具时钟固定在样本日次日,样本全部
+// 落在留存期内;超期丢弃语义由专项用例验证
+const FIXED_NOW = local(2026, 8, 3, 0, 0)
 const facilityOf = (domain, backupDomain) => ({
   open: async (definition) => (definition?.name === 'usage_stats_backup' ? (backupDomain ?? domain) : domain),
 })
+const makeStore = (domain, options = {}) => new UsageStore(facilityOf(domain), { now: () => FIXED_NOW, ...options })
 
 const tokenSample = (time, extra = {}) => ({
   time,
@@ -134,7 +138,7 @@ test('跨日跨时跨分边界:毫秒推进即换桶', () => {
 
 test('token 样本同刻落三粒度三行,行内无 g 字段', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
   await store.flushNow()
   const keys = ['D|2026-08-02', 'H|2026-08-02T14', 'M|2026-08-02T14:30'].map(
@@ -156,7 +160,7 @@ test('token 样本同刻落三粒度三行,行内无 g 字段', async () => {
 
 test('turn 样本落合成行:provider default 与 model (turns)', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.record({ time: local(2026, 8, 2, 14, 37), turn: true })
   await store.flushNow()
   const seen = domain.rows.get('D|2026-08-02|default|(turns)')
@@ -167,7 +171,7 @@ test('turn 样本落合成行:provider default 与 model (turns)', async () => {
 
 test('request 样本只计请求数,无归因落 (unknown)', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.record({ time: local(2026, 8, 2, 14, 37), request: true, model: 'deepseek-chat' })
   await store.record({ time: local(2026, 8, 2, 14, 38), request: true })
   await store.flushNow()
@@ -182,7 +186,7 @@ test('request 样本只计请求数,无归因落 (unknown)', async () => {
 
 test('token 样本时长落三粒度累加,request 与 turn 行时长恒 0', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const at = local(2026, 8, 2, 14, 37)
   await store.record(tokenSample(at, { durationMs: 6500 }))
   await store.record(tokenSample(at + 1000, { durationMs: 2500 }))
@@ -204,7 +208,7 @@ test('token 样本时长落三粒度累加,request 与 turn 行时长恒 0', asy
 
 test('老行缺 durationMs 字段:增量求和不产 NaN', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const at = local(2026, 8, 2, 14, 37)
   const key = 'D|2026-08-02|deepseek|deepseek/deepseek-chat'
   await store.record(tokenSample(at))
@@ -221,7 +225,7 @@ test('老行缺 durationMs 字段:增量求和不产 NaN', async () => {
 
 test('decode 配对与首字样本落三粒度累加,timing 样本不重复计 token', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const at = local(2026, 8, 2, 14, 37)
   // chunk 先发 token 样本:只有 token 桶
   await store.record(tokenSample(at, { durationMs: undefined }))
@@ -245,7 +249,7 @@ test('decode 配对与首字样本落三粒度累加,timing 样本不重复计 t
 
 test('timing 缺失样本:decodeTokens 与 ttft 字段按零累计', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const at = local(2026, 8, 2, 14, 37)
   await store.record(tokenSample(at))
   await store.flushNow()
@@ -258,7 +262,7 @@ test('timing 缺失样本:decodeTokens 与 ttft 字段按零累计', async () =>
 
 test('老行缺 decode/ttft 字段:增量求和不产 NaN', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const at = local(2026, 8, 2, 14, 37)
   const key = 'D|2026-08-02|deepseek|deepseek/deepseek-chat'
   await store.record(tokenSample(at))
@@ -279,7 +283,7 @@ test('老行缺 decode/ttft 字段:增量求和不产 NaN', async () => {
 
 test('missing-record 首写竞态:put 种子后重试写入真值', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
   await store.flushNow()
   assert.equal(domain.stats.puts, 3)
@@ -296,7 +300,7 @@ test('flush 中单粒度失败:错误经 onFlushError 上抛,失败行留 pendin
       return new Error('simulated hour failure')
     },
   })
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const errors = []
   store.onFlushError = (err) => errors.push(err)
   await store.readyPromise()
@@ -317,7 +321,7 @@ test('非 missing 错误不触发种子重试', async () => {
   const domain = fakeDomain({
     failUpdate: (candidate) => (candidate === key ? new Error('backend write failed') : null),
   })
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const errors = []
   store.onFlushError = (err) => errors.push(err)
   await store.readyPromise()
@@ -331,7 +335,7 @@ test('非 missing 错误不触发种子重试', async () => {
 
 test('rangeRows 按粒度前缀与桶串闭区间扫描', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const table = domain.table()
   await table.put('D|2026-07-31|a|m', rowOf('2026-07-31', 'a', 'm'))
   await table.put('D|2026-08-01|a|m', rowOf('2026-08-01', 'a', 'm'))
@@ -348,7 +352,7 @@ test('rangeRows 按粒度前缀与桶串闭区间扫描', async () => {
 
 test('pruneMinutes 按保留窗口清理分钟桶且不碰其他粒度', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain), { now: () => local(2026, 8, 10, 12, 0) })
+  const store = makeStore(domain, { now: () => local(2026, 8, 10, 12, 0) })
   const table = domain.table()
   await table.put('M|2026-08-08T11:00|a|m', rowOf('2026-08-08T11:00', 'a', 'm'))
   await table.put('M|2026-08-08T12:00|a|m', rowOf('2026-08-08T12:00', 'a', 'm'))
@@ -365,7 +369,7 @@ test('pruneMinutes 按保留窗口清理分钟桶且不碰其他粒度', async (
 
 test('保留窗口为 0 时分钟桶全部清理', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain), { now: () => local(2026, 8, 10, 12, 0) })
+  const store = makeStore(domain, { now: () => local(2026, 8, 10, 12, 0) })
   const table = domain.table()
   await table.put('M|2026-08-10T11:00|a|m', rowOf('2026-08-10T11:00', 'a', 'm'))
   await table.put('D|2026-08-10|a|m', rowOf('2026-08-10', 'a', 'm'))
@@ -376,7 +380,7 @@ test('保留窗口为 0 时分钟桶全部清理', async () => {
 
 test('分钟保留超上限时 clamp 到 7 天窗口', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain), { now: () => local(2026, 8, 10, 12, 0) })
+  const store = makeStore(domain, { now: () => local(2026, 8, 10, 12, 0) })
   const table = domain.table()
   // clamp 后窗口起点 = 08-03T12:00,7 天前的桶一律清理,即使注入 30 天
   await table.put('M|2026-08-01T00:00|a|m', rowOf('2026-08-01T00:00', 'a', 'm'))
@@ -388,7 +392,7 @@ test('分钟保留超上限时 clamp 到 7 天窗口', async () => {
 
 test('pruneHours 固定 15 天窗口清理小时桶且不碰其他粒度', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain), { now: () => local(2026, 8, 10, 12, 0) })
+  const store = makeStore(domain, { now: () => local(2026, 8, 10, 12, 0) })
   const table = domain.table()
   await table.put('H|2026-07-25T00:00|a|m', rowOf('2026-07-25T00:00', 'a', 'm'))
   await table.put('H|2026-07-26T12:00|a|m', rowOf('2026-07-26T12:00', 'a', 'm'))
@@ -404,7 +408,7 @@ test('pruneHours 固定 15 天窗口清理小时桶且不碰其他粒度', async
 test('每日本地日首次 flush 触发清理,同日后续 flush 不重复触发', async () => {
   let clock = local(2026, 8, 10, 12, 0)
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain), { now: () => clock, retentionDays: () => 0 })
+  const store = makeStore(domain, { now: () => clock, retentionDays: () => 0 })
   const table = domain.table()
   await table.put('M|2026-08-01T00:00|a|m', rowOf('2026-08-01T00:00', 'a', 'm'))
   await store.record(tokenSample(local(2026, 8, 10, 12, 0)))
@@ -422,7 +426,7 @@ test('每日本地日首次 flush 触发清理,同日后续 flush 不重复触
 
 test('并发 markSeenSessions 不丢 id', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await Promise.all([
     store.markSeenSessions(['a']),
     store.markSeenSessions(['b']),
@@ -433,7 +437,7 @@ test('并发 markSeenSessions 不丢 id', async () => {
 
 test('游标链串行:reset 排在先前 markSeen 之后,行与游标一致重置', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   const pending = store.markSeenSessions(['a'])
   await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
   await store.reset(new Map([['live-a', 7]]))
@@ -444,7 +448,7 @@ test('游标链串行:reset 排在先前 markSeen 之后,行与游标一致重
 
 test('reset 不带边界时游标清空', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.markLiveSequences([['s', 5]])
   await store.reset()
   assert.deepEqual(domain.global.get(), { backfilledSessions: [], liveFirstSeq: {} })
@@ -452,7 +456,7 @@ test('reset 不带边界时游标清空', async () => {
 
 test('markLiveSequences 保留最小 seq 且无变化不写 global', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.markLiveSequences([['s', 5]])
   assert.deepEqual(await store.liveSequences(), new Map([['s', 5]]))
   await store.markLiveSequences([['s', 3], ['t', 9]])
@@ -474,7 +478,7 @@ test('游标写单次失败不断链', async () => {
     }
     return originalSet(value)
   }
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await assert.rejects(store.markSeenSessions(['a']))
   await store.markSeenSessions(['b'])
   assert.deepEqual([...(await store.seenSessions())].sort(), ['b'])
@@ -483,7 +487,7 @@ test('游标写单次失败不断链', async () => {
 test('启动时游标为空且已有行则清空待重建', async () => {
   const domain = fakeDomain()
   await domain.table().put('D|2026-08-02|a|m', rowOf('2026-08-02', 'a', 'm'))
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.readyPromise()
   assert.equal(domain.rows.size, 0)
 })
@@ -492,7 +496,7 @@ test('启动时游标非空则既有行保留', async () => {
   const domain = fakeDomain()
   await domain.table().put('D|2026-08-02|a|m', rowOf('2026-08-02', 'a', 'm'))
   await domain.global.set({ backfilledSessions: ['old'], liveFirstSeq: {} })
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.readyPromise()
   assert.equal(domain.rows.size, 1)
 })
@@ -500,7 +504,7 @@ test('启动时游标非空则既有行保留', async () => {
 test('reset 前自动快照,restore 整体回退到快照态', async () => {
   const domain = fakeDomain()
   const backup = fakeDomain()
-  const store = new UsageStore(facilityOf(domain, backup))
+  const store = new UsageStore(facilityOf(domain, backup), { now: () => FIXED_NOW })
   await store.record(tokenSample(local(2026, 8, 2, 14, 0)))
   await store.markSeenSessions(['s1', 's2'])
   assert.equal(store.backupInfo().available, false)
@@ -521,7 +525,7 @@ test('reset 前自动快照,restore 整体回退到快照态', async () => {
 test('restore 前先快照当前态:回退动作自身可再回退', async () => {
   const domain = fakeDomain()
   const backup = fakeDomain()
-  const store = new UsageStore(facilityOf(domain, backup))
+  const store = new UsageStore(facilityOf(domain, backup), { now: () => FIXED_NOW })
   await store.record(tokenSample(local(2026, 8, 2, 14, 0)))
   await store.reset()
   await store.record(tokenSample(local(2026, 8, 3, 14, 0), { inputTokens: 99 }))
@@ -544,7 +548,7 @@ test('备份域不可用:重建照常,backupInfo 标记不可用,restore 报错'
       return domain
     },
   }
-  const store = new UsageStore(facility)
+  const store = new UsageStore(facility, { now: () => FIXED_NOW })
   await store.record(tokenSample(local(2026, 8, 2, 14, 0)))
   await store.reset()
   assert.equal(domain.rows.size, 0)
@@ -563,20 +567,125 @@ test('域打开失败进入降级:ready 可等待,操作按调用失败', async
   assert.deepEqual(await store.liveSequences(), new Map())
 })
 
-test('globalThis 单例复用同实例,重置缝生效', () => {
+test('globalThis 单例按 facility 关联:同 facility 同实例,异 facility 新实例', async () => {
   __resetSharedStoreForTests()
-  const first = sharedStore(facilityOf(fakeDomain()))
-  assert.equal(sharedStore(facilityOf(fakeDomain())), first)
+  const facilityA = facilityOf(fakeDomain())
+  const a = await sharedStore(facilityA)
+  assert.equal(await sharedStore(facilityA), a)
+  assert.notEqual(await sharedStore(facilityOf(fakeDomain())), a)
   __resetSharedStoreForTests()
-  assert.notEqual(sharedStore(facilityOf(fakeDomain())), first)
+})
+
+test('降级实例不复用:同 facility 再取重建新实例', async () => {
+  __resetSharedStoreForTests()
+  const facility = { open: () => Promise.reject(new Error("domain 'usage_stats' is already open")) }
+  const degraded = await sharedStore(facility)
+  await degraded.readyPromise()
+  assert.ok(degraded.degradation)
+  const fresh = sharedStore(facility)
+  assert.notEqual(fresh, degraded)
+  __resetSharedStoreForTests()
+})
+
+test('非对象 facility(服务缺席桩)不缓存:每次新建', () => {
+  __resetSharedStoreForTests()
+  assert.notEqual(sharedStore(undefined), sharedStore(undefined))
   __resetSharedStoreForTests()
 })
 
+// 同名域占用不证明无主;get 诊断面不可授权关闭活跃 owner。
+function facilityWithReserved({ withCode = true } = {}) {
+  const reserved = new Map()
+  const closes = []
+  const open = async (spec) => {
+    if (reserved.has(spec.name)) {
+      const err = new Error(`domain '${spec.name}' is already open`)
+      if (withCode) err.code = 'already-open'
+      throw err
+    }
+    const domain = fakeDomain()
+    domain.close = async () => {
+      closes.push(spec.name)
+      reserved.delete(spec.name)
+    }
+    reserved.set(spec.name, domain)
+    return domain
+  }
+  return { open, get: (name) => reserved.get(name), closes }
+}
+
+for (const withCode of [true, false]) {
+  test(`Given occupied domain with code=${withCode}, When another store opens, Then owner stays live and newcomer degrades`, async () => {
+    __resetSharedStoreForTests()
+    const facility = facilityWithReserved({ withCode })
+    const owner = await facility.open({ name: 'usage_stats' })
+    await facility.open({ name: 'usage_stats_backup' })
+    const store = sharedStore(facility)
+    await store.readyPromise()
+    assert.ok(store.degradation)
+    assert.equal(facility.get('usage_stats'), owner)
+    assert.deepEqual(facility.closes, [])
+    await owner.global.set({ stillLive: true })
+    assert.deepEqual(owner.global.get(), { stillLive: true })
+    await assert.rejects(store.record(tokenSample(local(2026, 8, 2, 14, 37))), /usage store degraded/)
+    __resetSharedStoreForTests()
+  })
+}
+
+test('UO1 Given old owner with seen cursor and pending tokens, When new generation opens, Then old owner flushes every bucket once', async () => {
+  __resetSharedStoreForTests()
+  const facility = facilityWithReserved()
+  const old = new UsageStore(facility, { now: () => FIXED_NOW })
+  await old.readyPromise()
+  await old.markSeenSessions(['s1'])
+  await old.record(tokenSample(local(2026, 8, 2, 14, 37)))
+  clearTimeout(old.flushTimer)
+  const newcomer = sharedStore(facility)
+  await newcomer.readyPromise()
+  assert.deepEqual(facility.closes, [])
+  assert.ok(newcomer.degradation)
+  await old.flushNow()
+  const rows = await old.rangeRows('D', '2026-08-02', '2026-08-02')
+  assert.equal(rows.length, 1)
+  assert.equal(rows[0].inputTokens, 10)
+  assert.equal(rows[0].outputTokens, 20)
+  assert.deepEqual(await old.seenSessions(), new Set(['s1']))
+  await old.flushNow()
+  assert.equal((await old.rangeRows('D', '2026-08-02', '2026-08-02'))[0].inputTokens, 10)
+  __resetSharedStoreForTests()
+})
+
+test('UO3 Given occupied backup only, When main opens, Then collection works and backup owner is untouched', async () => {
+  __resetSharedStoreForTests()
+  const facility = facilityWithReserved()
+  const backup = await facility.open({ name: 'usage_stats_backup' })
+  const store = sharedStore(facility)
+  await store.readyPromise()
+  assert.equal(store.degradation, undefined)
+  assert.equal(facility.get('usage_stats_backup'), backup)
+  assert.deepEqual(facility.closes, [])
+  await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
+  clearTimeout(store.flushTimer)
+  await store.flushNow()
+  assert.equal((await store.rangeRows('D', '2026-08-02', '2026-08-02'))[0].inputTokens, 10)
+  __resetSharedStoreForTests()
+})
+
+test('get 缝在场但孤儿已不存在:维持降级,不逃逸', async () => {
+  const store = new UsageStore({
+    open: () => Promise.reject(new Error("domain 'usage_stats' is already open")),
+    get: () => undefined,
+  })
+  await store.readyPromise()
+  assert.ok(store.degradation)
+  await assert.rejects(store.record(tokenSample(local(2026, 8, 2, 14, 37))), /usage store degraded/)
+})
+
 // —— 写合并(write-behind):record 同步入 pending,flush 周期落盘 ——
 
 test('record 只入 pending 不产生持久化写,flushNow 后每脏行恰一次 update', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.readyPromise()
   await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
   assert.equal(domain.rows.size, 0)
@@ -588,7 +697,7 @@ test('record 只入 pending 不产生持久化写,flushNow 后每脏行恰一次
 
 test('同桶多样本合并:pending 累加,一次 update 落全部计数', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.readyPromise()
   await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
   await store.record(tokenSample(local(2026, 8, 2, 14, 38)))
@@ -601,7 +710,7 @@ test('同桶多样本合并:pending 累加,一次 update 落全部计数', async
 
 test('flush 周期自动落盘', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain), { flushIntervalMs: 5 })
+  const store = makeStore(domain, { flushIntervalMs: 5 })
   await store.readyPromise()
   await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
   await new Promise((resolve) => setTimeout(resolve, 30))
@@ -610,7 +719,7 @@ test('flush 周期自动落盘', async () => {
 
 test('rangeRows 前自动 flush,读己之写', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.readyPromise()
   await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
   const rows = await store.rangeRows('D', '2026-08-02', '2026-08-02')
@@ -620,7 +729,7 @@ test('rangeRows 前自动 flush,读己之写', async () => {
 
 test('reset 前 pending 先落盘再清表', async () => {
   const domain = fakeDomain()
-  const store = new UsageStore(facilityOf(domain))
+  const store = makeStore(domain)
   await store.readyPromise()
   await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
   await store.reset(new Map())
@@ -633,3 +742,21 @@ test('降级态 record 仍按调用失败', async () => {
   await store.readyPromise()
   await assert.rejects(store.record(tokenSample(local(2026, 8, 2, 14, 37))), /usage store degraded/)
 })
+
+// ── F14: 入队保留资格过滤 ──────────────────────────────────────────────────
+test('F14: 超出档留存期的样本不入 pending 不落盘,回扫同通道受控', async () => {
+  const domain = fakeDomain()
+  // 时钟"今天" = 样本日次日 + 8 天:8/2 样本对分钟档(7 天)超期、小时档(15 天)与日档在期
+  const now = local(2026, 8, 10, 0, 0)
+  const store = new UsageStore(facilityOf(domain), { now: () => now })
+  await store.record(tokenSample(local(2026, 8, 2, 14, 37)))
+  await store.flushNow()
+  const prefixes = [...domain.rows.keys()].map((key) => key.split('|').slice(0, 2).join('|'))
+  assert.ok(!prefixes.some((p) => p.startsWith('M|')), `分钟档超期不得落行: ${prefixes.join(',')}`)
+  assert.ok(prefixes.some((p) => p.startsWith('D|')), '日档无留存上限恒写入')
+  assert.ok(prefixes.some((p) => p.startsWith('H|')), '小时档 15 天内在期')
+  // 分钟档保留 0(关闭):分钟样本一律不入队
+  const offStore = new UsageStore(facilityOf(fakeDomain()), { now: () => local(2026, 8, 2, 14, 38), retentionDays: () => 0 })
+  await offStore.record(tokenSample(local(2026, 8, 2, 14, 37)))
+  assert.equal(offStore.pending.size, 2, '关闭分钟档后仅日/小时两行入队')
+})

package/test/trend-tooltip.test.mjs

@@ -0,0 +1,182 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { CLIENT_SOURCE, CLIENT_BODY, DECLARATION_NAMES } from './client-eval.mjs'
+
+const core = new Function(`${CLIENT_BODY}\nreturn { ${DECLARATION_NAMES.join(', ')} }`)()
+const nodes = node => !node || typeof node !== 'object' ? [] : [node, ...(node.children ?? []).flatMap(nodes)]
+const text = node => typeof node === 'string' ? node : (node?.children ?? []).map(text).join('')
+const OTHER = core.OTHER_MODEL
+const slot = {
+  day: '2026-10-28', total: 16000, byModel: { 'p/a': 1000, 'p/b': 9000, [OTHER]: 6000 },
+  otherByModel: { 'p/c': 2000, 'p/d': 4000 }, cost: 12,
+  byCostModel: { 'p/a': 2, 'p/b': 9, [OTHER]: 1 }, otherCostByModel: { 'p/c': 0.75, 'p/d': 0.25 },
+  cacheHit: 3000, cacheMiss: 1000, speed: 12, ttft: 300,
+}
+
+function fixture({ money = false, costDisplay = true, currency = '¥', lang = 'zh', data = [slot] } = {}) {
+  let factory, cursor = 0
+  const states = [], refs = []
+  const React = {
+    createElement: (type, props, ...children) => ({ type, props: props ?? {}, children: children.flat(Infinity).filter(x => x != null && x !== false) }),
+    memo: fn => fn, useId: () => 'trend-test',
+    useState(seed) {
+      const i = cursor++
+      if (!(i in states)) states[i] = typeof seed === 'function' ? seed() : seed
+      return [states[i], value => { states[i] = typeof value === 'function' ? value(states[i]) : value }]
+    },
+    useRef(seed) { const i = cursor++; return refs[i] ??= { current: seed } },
+    useEffect() {}, useLayoutEffect() {}, useMemo: fn => fn(), useCallback: fn => fn,
+  }
+  const window = { __ModuleLoader__: { load: entry => { factory = entry.factory } } }
+  const source = CLIENT_SOURCE.replace("inject: ['slots', 'locale'],", "__test: { TrendChart }, inject: ['slots', 'locale'],")
+  new Function('window', 'localStorage', source)(window, { getItem: () => JSON.stringify({ costDisplay }), setItem() {} })
+  const { TrendChart } = factory(name => name === 'react' ? React : {}).__test
+  let tree
+  const props = {
+    title: 'trend', notes: [], slots: data, tipSlots: data, modelOrder: ['p/a', 'p/b', OTHER],
+    colorFor: () => 'currentColor', labelFor: key => key, labelMinPitch: 60,
+    legendModels: [], money, costCurrency: currency, t: core.createTranslator(lang === 'en' ? core.MESSAGES_EN : core.MESSAGES_ZH),
+  }
+  const render = () => {
+    cursor = 0
+    props.slots = props.money ? core.costSlotsOf(props.tipSlots) : props.tipSlots
+    tree = TrendChart(props)
+    return tree
+  }
+  const tip = () => nodes(tree).find(n => n.type?.name === 'ChartTip')
+  const rows = () => nodes(tip()).filter(n => n.props.className?.includes('ud-tip-row')).map(text)
+  const hover = (index = 0) => {
+    nodes(tree).filter(n => n.props.className === 'ud-bar-hit')[index].props.onMouseEnter({ clientX: 20, clientY: 20 })
+    render()
+  }
+  const select = (key, ctrl = false) => {
+    nodes(tree).find(n => n.type?.name === 'Legend').props.onItem(key, ctrl)
+    render()
+  }
+  render()
+  return { hover, select, rows, tip: () => text(tip()), update: changes => { Object.assign(props, changes); render() } }
+}
+
+test('Given 金额视图 When 悬浮 Then 总计和各模型展示估算费用，其他明细按费用排序', () => {
+  const f = fixture({ money: true }); f.hover()
+  assert.deepEqual(f.rows().slice(0, 5), ['估算费用: ≈ ¥12.00', 'p/a: ≈ ¥2.00', 'p/b: ≈ ¥9.00', '其他: ≈ ¥1.00', 'p/c: ≈ ¥0.75'])
+  assert.ok(f.rows().includes('p/d: ≈ ¥0.25'))
+  assert.doesNotMatch(f.tip(), /16,000|9,000|6,000/)
+})
+
+test('Given Token 视图 When 单选模型 Then 总计、费用、均价仅包含可见模型', () => {
+  const f = fixture(); f.hover(); f.select('p/a')
+  assert.deepEqual(f.rows(), ['所选用量: 1,000 tok', 'p/a: 1,000 tok', '≈ ¥2.00', '均价: ¥2,000.000/M'])
+})
+
+test('Given 金额视图 When Ctrl 多选包含其他 Then 合计不重复计其他子项', () => {
+  const f = fixture({ money: true }); f.hover(); f.select('p/a'); f.select(OTHER, true)
+  assert.equal(f.rows()[0], '所选估算费用: ≈ ¥3.00')
+  assert.doesNotMatch(f.tip(), /p\/b:/)
+  assert.ok(f.rows().includes('均价: ¥428.571/M'))
+})
+
+for (const [key, label, value] of [['speed', '平均生成速度', '12 tok/s'], ['rate', '缓存命中率', '75.0%'], ['ttft', '首 token 延迟', '0.3秒']]) {
+  test(`Given 仅选 ${key} 曲线 When 悬浮 Then 只有时段整体指标且不显示模型合计或费用`, () => {
+    const f = fixture({ money: true }); f.hover(); f.select(key)
+    assert.match(f.tip(), /时段整体指标/)
+    assert.deepEqual(f.rows(), [`${label}: ${value}`])
+  })
+}
+
+test('Given 有其他付费槽和零费用模型 When 在金额视图选择零费用模型 Then 保留零费用读数', () => {
+  const data = [{ ...slot, byCostModel: { ...slot.byCostModel, 'p/a': 0 }, cost: 10 }]
+  const f = fixture({ money: true, data }); f.hover(); f.select('p/a')
+  assert.deepEqual(f.rows(), ['所选估算费用: ≈ ¥0.00', 'p/a: ≈ ¥0.00'])
+})
+
+test('Given 当前槽中选中模型没有用量 When 悬浮 Then 不展示隐藏模型总计或空提示', () => {
+  const f = fixture({ data: [{ ...slot, byModel: { ...slot.byModel, 'p/a': 0 } }] }); f.hover(); f.select('p/a')
+  assert.equal(f.tip(), '')
+})
+
+test('Given 辅助费用偏好关闭 When 切换金额视图 Then 主金额读数仍展示并响应货币变化', () => {
+  const f = fixture({ costDisplay: false }); f.hover(); f.select('p/a')
+  assert.deepEqual(f.rows(), ['所选用量: 1,000 tok', 'p/a: 1,000 tok'])
+  f.update({ money: true, costCurrency: '$' })
+  assert.deepEqual(f.rows(), ['所选估算费用: ≈ $2.00', 'p/a: ≈ $2.00', '均价: $2,000.000/M'])
+})
+
+test('Given 悬浮时间桶 When 切换到不含该桶的窗口 Then 清除提示而不复用数组下标', () => {
+  const f = fixture(); f.hover()
+  f.update({ tipSlots: [{ ...slot, day: '2026-10-27' }] })
+  assert.equal(f.tip(), '')
+})
+
+test('Given 悬浮时间桶 When 窗口前插时间桶 Then 提示仍绑定原时间桶', () => {
+  const f = fixture(); f.hover()
+  f.update({ tipSlots: [{ ...slot, day: '2026-10-27' }, slot] })
+  assert.match(f.tip(), /^2026-10-28/)
+})
+
+test('Given 英文金额视图 When 单选模型 Then 使用英文费用标签及当前货币', () => {
+  const f = fixture({ money: true, lang: 'en', currency: '$' }); f.hover(); f.select('p/a')
+  assert.equal(f.rows()[0], 'Selected estimated cost: ≈ $2.00')
+})
+
+for (const [key, label, value] of [['speed', '平均生成速度', '0 tok/s'], ['ttft', '首 token 延迟', '0秒']]) {
+  test(`Given 只有 timing 的时间桶 When 仅选 ${key} Then 零值指标仍显示提示`, () => {
+    const timing = { ...slot, total: 0, byModel: {}, cost: 0, byCostModel: {}, cacheHit: 0, cacheMiss: 0, speed: 0, ttft: 0 }
+    const f = fixture({ data: [timing] }); f.select(key); f.hover()
+    assert.deepEqual(f.rows(), [`${label}: ${value}`])
+  })
+}
+
+for (const key of ['speed', 'ttft', 'rate']) {
+  test(`Given 所选 ${key} 在当前桶没有数据 When 悬浮 Then 不显示空指标提示`, () => {
+    const emptyMetrics = { ...slot, day: '2026-10-27', speed: undefined, ttft: undefined, cacheHit: 0, cacheMiss: 0 }
+    const f = fixture({ data: [emptyMetrics, slot] }); f.select(key); f.hover()
+    assert.equal(f.tip(), '')
+  })
+}
+
+test('Given 单选旧模型 When 新窗口不含该模型 Then 恢复默认可见模型且能继续单选', () => {
+  const f = fixture(); f.select('p/a'); f.hover()
+  f.update({ tipSlots: [{ ...slot, total: 100, byModel: { 'p/z': 100 }, cost: 1, byCostModel: { 'p/z': 1 } }], modelOrder: ['p/z'] })
+  assert.ok(f.rows().includes('p/z: 100 tok'))
+  assert.equal(f.rows()[0], '总用量: 100 tok')
+  f.select('p/z')
+  assert.ok(f.rows().includes('p/z: 100 tok'))
+})
+
+test('Given 单选速度 When 新窗口没有速度 Then 恢复可用模型', () => {
+  const f = fixture(); f.select('speed'); f.hover()
+  f.update({ tipSlots: [{ ...slot, speed: undefined }] })
+  assert.ok(f.rows().includes('p/a: 1,000 tok'))
+  assert.doesNotMatch(f.tip(), /平均生成速度:/)
+})
+
+test('Given 小时桶悬浮 When 切到分钟桶 Then 旧提示清除且新提示显示分钟桶数据', () => {
+  const f = fixture({ data: [{ ...slot, day: '2026-10-28T12' }] }); f.hover()
+  f.update({ tipSlots: [{ ...slot, day: '2026-10-28T12:10' }] })
+  assert.equal(f.tip(), '')
+  f.hover()
+  assert.match(f.tip(), /^2026-10-28T12:10/)
+})
+
+test('Given 单选模型在新窗口全部失效 When 返回原窗口 Then 保持默认显示而不复活旧单选', () => {
+  const f = fixture(); f.select('p/a'); f.hover()
+  f.update({ tipSlots: [{ ...slot, total: 100, byModel: { 'p/z': 100 }, cost: 1, byCostModel: { 'p/z': 1 } }], modelOrder: ['p/z'] })
+  f.update({ tipSlots: [slot], modelOrder: ['p/a', 'p/b', OTHER] })
+  assert.equal(f.rows()[0], '总用量: 16,000 tok')
+  assert.ok(f.rows().includes('p/b: 9,000 tok'))
+})
+
+test('Given 多选中部分模型在新窗口失效 When 返回原窗口 Then 只保留未失效的选择', () => {
+  const f = fixture(); f.select('p/a'); f.select('p/b', true); f.hover()
+  f.update({ tipSlots: [{ ...slot, total: 1000, byModel: { 'p/a': 1000 }, cost: 2, byCostModel: { 'p/a': 2 } }], modelOrder: ['p/a'] })
+  f.update({ tipSlots: [slot], modelOrder: ['p/a', 'p/b', OTHER] })
+  assert.equal(f.rows()[0], '所选用量: 1,000 tok')
+  assert.doesNotMatch(f.tip(), /p\/b:/)
+})
+
+test('Given 未配置费用 When 悬浮 Token 视图 Then 只展示用量及有效曲线', () => {
+  const { cost, byCostModel, otherCostByModel, ...unpriced } = slot
+  const f = fixture({ data: [unpriced] }); f.select('p/a'); f.hover()
+  assert.deepEqual(f.rows(), ['所选用量: 1,000 tok', 'p/a: 1,000 tok'])
+})