dsh-cost-meter 1.5.32 → 1.5.34

package/README.en.md

@@ -6,7 +6,7 @@
 
 Per-conversation cost · daily totals · OpenCode Go subscription quota display · budget with usage percentage · official account balance · custom provider balance · balance progress bar · history · peak/off-peak pricing hours display (peak hours UTC 01:00–04:00, 06:00–10:00) · pre-switch popup & system-notification alerts for peak/off-peak changes (position / lead time / alert type configurable) · one-click price sync from the official docs · Codex-style token usage heat grid · multi-vendor model pricing (built-in 90+ model price catalog with auto-matching) · mainstream Coding Plan quota queries & display (Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet) · quota strip above the input box (budget / Go / coding-plan usage in one row, toggleable)
 
-[![version](https://img.shields.io/badge/version-1.5.32-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.34-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
 [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-dsh--plugin-4176E6)](https://github.com/deepseek-ai/deepseek-harness)
@@ -228,22 +228,22 @@ Real captures from an actual DSH sidebar of the period strip and collapsed verti
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.5.32`** — review the script before running):
+**PowerShell one-click script** (copy the whole line, paste, press Enter; pnpm is provisioned automatically, git is auto-detected — no clone needed; the install chain is **pinned to the release tag `v1.5.34`** — review the script before running):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.32/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.34/install.ps1 | iex
 ```
 
 **Or a plain command line** (the machine must already have pnpm and git; also pinned to the tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.32
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.34
 ```
 
 Without git, use the GitHub tag archive:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.32.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.34.tar.gz
 ```
 
 After installing, **restart** `dsh web` (plugin rows, the Typert manifest and the client bundle are all scanned at startup):

package/README.md

@@ -6,7 +6,7 @@
 
 本会话费用 · 当日费用 · OpenCode Go 订阅额度显示 · 预算与已用百分比 · 官方账户余额 · 自定义 Provider 余额查询(可配任意 HTTP 端点) · 余额三段进度条 · 历史记录 · 峰谷计价时段显示(UTC 01:00–04:00、06:00–10:00 为峰时段) · 峰/谷切换前弹窗与系统通知提醒(位置/提前量/提醒类型可配) · 官方价格一键同步 · 类 Codex Token 用量热图 · 多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配) · 主流 Coding Plan 额度查询与显示(Anthropic / Z.ai / MiniMax / Kimi / OpenRouter / SiliconFlow / CommandCode / SCNet 八家) · 输入框上方额度横条(预算/Go/Coding Plan 用量一条横排显示,可开关)
 
-[![version](https://img.shields.io/badge/version-1.5.32-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
+[![version](https://img.shields.io/badge/version-1.5.34-4176E6)](https://github.com/Han-1413141/dsh-cost-meter)
 [![npm](https://img.shields.io/npm/v/dsh-cost-meter?label=npm)](https://www.npmjs.com/package/dsh-cost-meter)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-dsh--plugin-4176E6)](https://github.com/deepseek-ai/deepseek-harness)
@@ -230,22 +230,22 @@
 dsh plugin --profile web add dsh-cost-meter
 ```
 
-**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.32`**,建议先下载审阅再运行):
+**PowerShell 一键脚本**(复制整行粘贴回车;自动补齐 pnpm、自动探测 git,无需克隆仓库;安装链**固定到发布 tag `v1.5.34`**,建议先下载审阅再运行):
 
 ```powershell
-irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.32/install.ps1 | iex
+irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.5.34/install.ps1 | iex
 ```
 
 **或直接命令行**(机器上需已有 pnpm 与 git;同样固定到 tag):
 
 ```sh
-dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.32
+dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.5.34
 ```
 
 没有 git 时可用 GitHub tag 打包直链:
 
 ```sh
-dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.32.tar.gz
+dsh plugin --profile web add https://github.com/Han-1413141/dsh-cost-meter/archive/refs/tags/v1.5.34.tar.gz
 ```
 
 安装后**重启** `dsh web`(插件行、Typert 清单与客户端 bundle 均在启动时扫描):

package/lib/backfill.js

@@ -138,10 +138,23 @@ export function listSessionLogs(root) {
  * 回放单个会话的事件流,重建逐次用量。与 costUsage 投影同规则:
  * request/header 切换当前 provider/model;usage 块按 (turn, step) 去重,
  * 同键最终样本替换流式样本(先减后加);按事件时刻计价。
+ *
+ * fork 种子分段(issue #38):DSH 的 fork 把父会话事件流整段拷贝进子会话
+ * 日志(header 带 parentSession / seedLength),拷贝事件的时间戳早于
+ * header.createdAt。回放时把 time < createdAt 的种子事件单独聚合进
+ * seedDays(供一次性清洗扣账),不再计入 days——父会话已计过,重复计费
+ * 即虚高。非 fork 会话 createdAt 早于全部事件,判定不生效,无回归影响。
+ *
+ * 状态机与旧版逐字一致(header 一律切换 provider/model、单一 (turn,step)
+ * 去重跨种子/own 段连续生效),仅聚合目标按事件分段路由:旧版把种子段
+ * 写进账本的量与新算的 seedDays 逐字段相等,清洗扣账才不偏不漏;若 own
+ * 段样本复用了种子段最后的 (turn,step) 键,先减项路由回 seedDays,days
+ * 只含 own 部分——同样与旧版账本内容对齐。
+ *
  * @param records - readSessionRecords 的输出。
  * @param config - 账本配置(prices / peak* / priceMatch / priceOverrides)。
  * @param wantDates - 只统计这些日期键(YYYY-MM-DD)内的调用;null = 全部。
- * @returns { sessionId, title, createdAt, days: { date: { providerKey: 桶 } } }。
+ * @returns { sessionId, title, createdAt, days, seedDays }。
  */
 export function replaySessionRecords(records, config, wantDates = null) {
   const zeroBuckets = () => ({ input: 0, output: 0, cacheRead: 0, cacheWrite: 0, reasoning: 0, calls: 0, cost: 0 })
@@ -156,8 +169,9 @@ export function replaySessionRecords(records, config, wantDates = null) {
   let model = 'default'
   let last = null
   const days = {}
-  const shift = (sample, sign) => {
-    const dayMap = days[sample.date] ?? (days[sample.date] = {})
+  const seedDays = {}
+  const shift = (sample, sign, target) => {
+    const dayMap = target[sample.date] ?? (target[sample.date] = {})
     const current = dayMap[sample.providerKey] ?? zeroBuckets()
     dayMap[sample.providerKey] = {
       input: current.input + sign * sample.buckets.input,
@@ -184,7 +198,13 @@ export function replaySessionRecords(records, config, wantDates = null) {
       continue
     }
     if (PACKED_ROW_TYPES.has(event.type)) continue
+    const eventMs = Number(event.time)
+    // fork 种子事件判定:时间戳早于会话创建时刻 = 从父会话拷来的历史。
+    const isSeed = createdAt > 0 && Number.isFinite(eventMs) && eventMs > 0 && eventMs < createdAt
     if (event.type === 'request/header') {
+      // header 一律更新计费口径(与旧版状态机一致):种子段用量必须按
+      // 父会话当时的模型计价,seedDays 才能与旧版写入账本的污染量对齐,
+      // 清洗扣账逐字段精确;fork 后自己首轮也几乎总带着新 header,不受影响。
       const nextModel = event.data?.header?.config?.model
       const nextProvider = event.data?.header?.config?.provider
       model = typeof nextModel === 'string' && nextModel.length > 0 ? nextModel : 'default'
@@ -205,7 +225,7 @@ export function replaySessionRecords(records, config, wantDates = null) {
     } else {
       continue
     }
-    const atMs = Number(event.time)
+    const atMs = eventMs
     if (!Number.isFinite(atMs) || atMs <= 0) continue
     const date = localDayKey(atMs)
     if (wantDates !== null && !wantDates.has(date)) continue
@@ -217,6 +237,7 @@ export function replaySessionRecords(records, config, wantDates = null) {
       reasoning: num(usage.reasoningTokens),
     }
     const key = `${turn}:${step}`
+    // 去重与旧版完全一致:单一 (turn,step) 状态机跨种子/own 段连续生效。
     const prev = last !== null && last.key === key ? last : null
     if (prev !== null && prev.providerKey === `${provider}:${model}`
       && prev.buckets.input === buckets.input && prev.buckets.output === buckets.output
@@ -236,12 +257,14 @@ export function replaySessionRecords(records, config, wantDates = null) {
     }
     const cost = resolved.priced ? costOf(buckets, resolved.entry, atMs, peak) : 0
     const providerKey = `${provider}:${model}`
-    if (prev !== null) shift(prev, -1)
-    const sample = { key, date, providerKey, buckets, cost }
-    shift(sample, 1)
+    // 聚合目标按事件分段路由;被替换的旧样本从它当时所在的段扣回(与旧版
+    // 单流先减后加的净效果一致,仅种子段的量落到 seedDays 而非 days)。
+    if (prev !== null) shift(prev, -1, prev.seed ? seedDays : days)
+    const sample = { key, date, providerKey, buckets, cost, seed: isSeed }
+    shift(sample, 1, isSeed ? seedDays : days)
     last = sample
   }
-  return { sessionId, title, createdAt, days }
+  return { sessionId, title, createdAt, days, seedDays }
 }
 
 /**
@@ -581,3 +604,81 @@ export async function importLegacyHistory(ledger, sessionsRoot) {
   }
   return result
 }
+
+/** 从目标桶(可变)中减去源桶,逐字段 clamp ≥ 0(清洗不产生负数)。 */
+function subtractBucketInto(target, source) {
+  target.input = Math.max(0, (target.input ?? 0) - (source.input ?? 0))
+  target.output = Math.max(0, (target.output ?? 0) - (source.output ?? 0))
+  target.cacheRead = Math.max(0, (target.cacheRead ?? 0) - (source.cacheRead ?? 0))
+  target.cacheWrite = Math.max(0, (target.cacheWrite ?? 0) - (source.cacheWrite ?? 0))
+  target.reasoning = Math.max(0, (target.reasoning ?? 0) - (source.reasoning ?? 0))
+  target.calls = Math.max(0, (target.calls ?? 0) - (source.calls ?? 0))
+  target.cost = Math.max(0, (target.cost ?? 0) - (source.cost ?? 0))
+}
+
+/**
+ * fork 种子重复计费一次性清洗(issue #38):旧版把 fork 会话日志里从父会话
+ * 拷贝的种子事件(time < createdAt)也计入了账本(该会话条目与所在日期合
+ * 计均虚高)。本函数扫描全部会话日志,对 header 带 parentSession 的 fork
+ * 会话重算种子聚合(seedDays),从账本对应会话条目与日合计中扣除等量污染。
+ *
+ * 幂等由调用方用账本 migrations 标记(fork-seed-dedup-v1)保证只跑一次;
+ * 减法逐字段 clamp ≥ 0,即使账本未被污染(种子量为 0)也无副作用。
+ * @param ledger - 已打开的账本。
+ * @param sessionsRoot - 宿主会话根目录($DSH_HOME/sessions)。
+ * @returns { sessions, days, scanned } 受影响的 fork 会话数、扣除的日期数与扫描文件数。
+ */
+export function repairForkSeed(ledger, sessionsRoot) {
+  const result = { sessions: 0, days: 0, scanned: 0 }
+  for (const path of listSessionLogs(sessionsRoot)) {
+    result.scanned += 1
+    let records
+    try {
+      records = readSessionRecords(path)
+    } catch {
+      continue // 单文件损坏不阻断整体清洗。
+    }
+    // 只处理 fork 会话(header 带 parentSession);普通会话日志无种子段。
+    const header = records.find(r => r?.type === 'session')
+    if (header === undefined || header === null || typeof header.parentSession !== 'string' || header.parentSession.length === 0) continue
+    let replayed
+    try {
+      replayed = replaySessionRecords(records, ledger.config, null)
+    } catch {
+      continue
+    }
+    if (replayed.sessionId.length === 0) continue
+    let touched = false
+    for (const [date, pm] of Object.entries(replayed.seedDays)) {
+      const totals = sumDayMap(pm)
+      if (totals.calls <= 0) continue
+      const day = ledger.days[date]
+      if (day === null || typeof day !== 'object') continue
+      const session = Array.isArray(day.sessions) ? day.sessions.find(s => s?.id === replayed.sessionId) : null
+      if (session === undefined || session === null) continue
+      // 会话条目:顶层字段与 byProviderModel 拆分同步扣除种子污染。
+      subtractBucketInto(session, totals)
+      if (session.byProviderModel !== null && typeof session.byProviderModel === 'object') {
+        for (const [providerKey, bucket] of Object.entries(pm)) {
+          const current = session.byProviderModel[providerKey]
+          if (current !== null && typeof current === 'object') subtractBucketInto(current, bucket)
+        }
+      }
+      // 日合计:顶层字段与 byProviderModel 同步扣除。
+      subtractBucketInto(day, totals)
+      if (day.byProviderModel !== null && typeof day.byProviderModel === 'object') {
+        for (const [providerKey, bucket] of Object.entries(pm)) {
+          const current = day.byProviderModel[providerKey]
+          if (current !== null && typeof current === 'object') subtractBucketInto(current, bucket)
+        }
+      }
+      touched = true
+      result.days += 1
+    }
+    if (touched) {
+      result.sessions += 1
+      ledger.scheduleWrite()
+    }
+  }
+  return result
+}

package/lib/client.js

@@ -2751,11 +2751,22 @@ window.__ModuleLoader__.load({
     // 更新后的提醒(issue #37):告知侧边栏余额/额度图框支持点击立即刷新;
     // 「知道了」写回 balance.clickHintSeen=true 后永久消失(挂常驻 sidebar.footer.action)。
     // 仅在侧边栏确有可点击图框(官方余额 / 自定义余额 / Coding Plan)时展示,避免噪音。
+    // 已读标记双通道:配置标记(跨设备) + localStorage 本地兜底。后者防御版本错位——
+    // 服务端/网关若运行旧版 typert schema(decode 时 zod parse 会剥离 schema 未声明的键),
+    // 新增的配置标记在到达客户端前就被剥掉,卡片会在每次刷新后重现;localStorage 不经 RPC 链路,不受影响。
+    const BALANCE_CLICK_HINT_LS_KEY = 'dsh-cost-meter:balance-click-hint-seen'
+    const readBalanceClickHintLS = () => {
+      try { return window.localStorage.getItem(BALANCE_CLICK_HINT_LS_KEY) === '1' } catch (_) { return false } // 隐私模式等场景静默
+    }
+    const writeBalanceClickHintLS = () => {
+      try { window.localStorage.setItem(BALANCE_CLICK_HINT_LS_KEY, '1') } catch (_) { /* 配置标记仍是主通道 */ }
+    }
     function BalanceClickGuide(props) {
       // Hook 全部前置(promptSeen 类标记翻转时会提前 return null,顺序必须稳定)。
       const costStore = props.useCost ? props.useCost(s => s) : undefined
       const busyRef = useRef(false)
       const [dismissed, setDismissed] = useState(false)
+      const [lsSeen] = useState(readBalanceClickHintLS)
       const state = costStore?.state
       if (!state) return null
       const config = state.config
@@ -2766,7 +2777,7 @@ window.__ModuleLoader__.load({
         const entry = config.codingPlans?.[r.id]
         return entry?.enabled === true && (entry.display === 'sidebar' || entry.display === 'both')
       })
-      if (dismissed || config.balance?.clickHintSeen === true || (!sidebarBalanceOn && !sidebarCustomOn && !sidebarPlansOn)) return null
+      if (dismissed || lsSeen || config.balance?.clickHintSeen === true || (!sidebarBalanceOn && !sidebarCustomOn && !sidebarPlansOn)) return null
       // 串行展示:横条引导(QuotaStripGuide)与本卡同为 fixed 顶部卡片,同屏会完全重叠,
       // 点掉一张露出另一张,视觉上像「点了没反应」。等横条引导处理完(promptSeen)再出现。
       if (config.quotaStrip?.promptSeen !== true) return null
@@ -2776,6 +2787,7 @@ window.__ModuleLoader__.load({
         // 乐观消失:点击立即隐藏,落盘确认失败才恢复可见(避免宿主渲染时序让卡片看起来「点不掉」)。
         setDismissed(true)
         busyRef.current = true
+        writeBalanceClickHintLS() // 本地兜底同步落点,不依赖 RPC 成败
         props.api.updateConfig({ balance: { ...(config.balance ?? {}), clickHintSeen: true } })
           .catch(() => { busyRef.current = false; setDismissed(false) })
       }

package/lib/index.js

@@ -19,7 +19,7 @@ import { join } from 'node:path'
 import { credentialRef } from '@deepseek-ai/dsh-credentials'
 import { resolveDshHome } from '@deepseek-ai/dsh-home-paths'
 import { Ledger, applyConfigPatch, localDayKey, pickBalanceInfo, reconcileBalanceDelta, zeroDay } from './store.js'
-import { backfillLegacyLedger, importLegacyHistory } from './backfill.js'
+import { backfillLegacyLedger, importLegacyHistory, repairForkSeed } from './backfill.js'
 import { OFFICIAL_PRICING_URL, normalizePrice, parsePricingHtml, costOf, priceEntryFor, providerPriceEntryFor, buildPriceCatalog } from './pricing.js'
 import { CODING_PLAN_PROVIDERS, CODING_PLAN_PROVIDER_IDS, queryCodingPlan, scnetTokenPlanWindows, emptyCustomBalance, queryCustomBalance } from './coding-plans.js'
 import { fetchWithRetry } from './net.js'
@@ -153,6 +153,64 @@ const usageProjectionSchema = z.object({
   })).optional(),
 })
 
+/** 投影内部 state 的持久化校验 schema(dsh 0.1.1-rc.1 起的 stateSchema 契约)。 */
+const usageProjectionStateSchema = z.object({
+  provider: z.string(),
+  model: z.string(),
+  totals: z.object({
+    input: z.number(),
+    output: z.number(),
+    cacheRead: z.number(),
+    cacheWrite: z.number(),
+    reasoning: z.number(),
+    cost: z.number(),
+  }),
+  byModel: z.record(z.string(), z.object({
+    input: z.number(),
+    output: z.number(),
+    cacheRead: z.number(),
+    cacheWrite: z.number(),
+    reasoning: z.number().optional(),
+    cost: z.number(),
+  })),
+  byProviderModel: z.record(z.string(), z.object({
+    input: z.number(),
+    output: z.number(),
+    cacheRead: z.number(),
+    cacheWrite: z.number(),
+    reasoning: z.number(),
+    cost: z.number(),
+  })).optional(),
+  last: z.object({
+    key: z.string(),
+    provider: z.string(),
+    model: z.string(),
+    buckets: z.object({
+      input: z.number(),
+      output: z.number(),
+      cacheRead: z.number(),
+      cacheWrite: z.number(),
+      reasoning: z.number(),
+    }),
+    cost: z.number(),
+  }).nullable(),
+  createdAt: z.number(),
+})
+
+/** state → wire payload 读侧投影(新版 wire.view 与旧版 view 共用同一实现)。 */
+function projectionView(state) {
+  return {
+    input: state.totals.input,
+    output: state.totals.output,
+    cacheRead: state.totals.cacheRead,
+    cacheWrite: state.totals.cacheWrite,
+    reasoning: state.totals.reasoning,
+    cost: state.totals.cost,
+    byModel: state.byModel,
+    byProviderModel: state.byProviderModel,
+  }
+}
+
 /**
  * costUsage 会话投影工厂:闭包账本,按事件时刻(event.time)用当时的价格档位
  * 逐次计费(峰谷时代前按 legacyBase,之后按峰谷两档),保证会话徽章历史正确。
@@ -166,17 +224,35 @@ function makeCostUsageProjection(ledger) {
   })
   return {
     key: 'costUsage',
+    // 新旧宿主双兼容:dsh 0.1.1-rc.1 起契约为 stateSchema + wire(见下),
+    // 0.1.0 及更早版本读取 schema + view——两套字段并存,各自宿主各取所需。
     schema: usageProjectionSchema,
-    stateVersion: 3,
-    init: () => ({ provider: 'deepseek', model: 'default', totals: zeroBuckets(), byModel: {}, byProviderModel: {}, last: null }),
+    stateSchema: usageProjectionStateSchema,
+    stateVersion: 4,
+    init: () => ({ provider: 'deepseek', model: 'default', totals: zeroBuckets(), byModel: {}, byProviderModel: {}, last: null, createdAt: 0 }),
     apply(state, event) {
+      // fork 种子过滤(issue #38):DSH 的 fork 把父会话事件流整段拷贝进子会话
+      // 日志,time < header.createdAt 的事件是拷贝(父会话已计费),一律跳过;
+      // 非 fork 会话 createdAt 早于全部事件,判定不生效。stateVersion 3→4
+      // 触发宿主重放重建,已受污染的投影状态随之自愈。
+      if (event.type === 'session') {
+        const created = Number(event.createdAt)
+        if (!Number.isFinite(created) || created <= 0 || created === state.createdAt) return state
+        return { ...state, createdAt: created }
+      }
+      const eventMs = Number(event.time)
+      const isSeed = state.createdAt > 0 && Number.isFinite(eventMs) && eventMs > 0 && eventMs < state.createdAt
       if (event.type === 'request/header') {
+        // header 一律更新计费口径(与回放器/旧版状态机一致):种子 header
+        // 只推进 provider/model 状态;fork 后自己首轮若未带新 header,
+        // 沿用父会话最后的模型比回退 default 更接近真实计费。
         const model = event.data?.header?.config?.model
         const provider = event.data?.header?.config?.provider
         const nextModel = typeof model === 'string' && model.length > 0 ? model : 'default'
         const nextProvider = typeof provider === 'string' && provider.length > 0 ? provider : 'deepseek'
         return nextModel === state.model && nextProvider === state.provider ? state : { ...state, model: nextModel, provider: nextProvider }
       }
+      if (isSeed) return state
       let usage = null
       let turn = 0
       let step = 0
@@ -248,19 +324,19 @@ function makeCostUsageProjection(ledger) {
       }
       if (prev !== null) shift(prev.provider, prev.model, prev.buckets, prev.cost, -1)
       shift(state.provider, state.model, buckets, billed, 1)
-      return { provider: state.provider, model: state.model, totals, byModel, byProviderModel, last: { key, provider: state.provider, model: state.model, buckets, cost: billed } }
+      // createdAt 必须随状态携带:usage 样本更新不能丢掉 fork 过滤基准。
+      return { provider: state.provider, model: state.model, totals, byModel, byProviderModel, createdAt: state.createdAt, last: { key, provider: state.provider, model: state.model, buckets, cost: billed } }
     },
-    view(state) {
-      return {
-        input: state.totals.input,
-        output: state.totals.output,
-        cacheRead: state.totals.cacheRead,
-        cacheWrite: state.totals.cacheWrite,
-        reasoning: state.totals.reasoning,
-        cost: state.totals.cost,
-        byModel: state.byModel,
-        byProviderModel: state.byProviderModel,
-      }
+    view: projectionView,
+    // DSH 0.1.1-rc.1 起会话投影需声明 wire 才会向客户端推送(PR #39 by
+    // @aaronlei):无 wire 的投影在 snapshot/onChanged/refold 中被跳过,
+    // 客户端 useProjection('costUsage') 恒为空,输入区下方的会话费用随之
+    // 隐藏。stateSchema 同为新契约必填——持久化恢复路径 restore() 会调用
+    // stateSchema.parse(row.val) 且无 try-catch,缺省会在 checkpoint 恢复
+    // 时 TypeError。wire.view 与外层 view 复用同一实现,避免两份取值漂移。
+    wire: {
+      viewSchema: usageProjectionSchema,
+      view: projectionView,
     },
   }
 }
@@ -1036,6 +1112,16 @@ export async function runStartupImports(ledger, sessionsRoot) {
     ].filter(Boolean).join(',')
     console.log(`[dsh-cost-meter] 历史按模型统计回填完成:${extras}(扫描 ${filled.scanned} 份会话日志)`)
   }
+  // fork 种子重复计费一次性清洗(issue #38):账本 migrations 标记保证只跑一次;
+  // 回放过滤(replaySessionRecords 跳过种子)已堵住新污染,此处只清历史存量。
+  if (!ledger.migrations.includes('fork-seed-dedup-v1')) {
+    const repaired = repairForkSeed(ledger, sessionsRoot)
+    ledger.migrations.push('fork-seed-dedup-v1')
+    ledger.scheduleWrite()
+    if (repaired.sessions > 0) {
+      console.log(`[dsh-cost-meter] fork 会话重复计费清洗完成:扣除 ${repaired.sessions} 个会话 / ${repaired.days} 天的种子污染(扫描 ${repaired.scanned} 份会话日志)`)
+    }
+  }
   if (!(Number(ledger.config?.legacyAutoImportedAt) > 0)) {
     const stats = await importLegacyHistory(ledger, sessionsRoot)
     if (stats.days > 0 || stats.sessions > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cost-meter",
-  "version": "1.5.32",
+  "version": "1.5.34",
   "description": "DeepSeek Harness 会话费用统计插件:本会话成本、当日费用、历史记录与官方价格同步,支持多厂商多模型价格计费(内置 90+ 模型价格目录与自动匹配)、主流 Coding Plan 订阅额度查询与显示(7 家,含 SCNet Token Plan 本地 Credits 计量)、自定义 Provider 余额查询(可配任意 HTTP 端点)与余额进度条、峰谷计价时段显示与切换前弹窗/系统通知提醒(位置/提前量/类型可配),界面中英双语。Session cost tracking plugin for DeepSeek Harness: per-conversation cost, daily totals, history and official price sync, with multi-vendor model pricing (built-in 90+ model catalog with auto-matching), Coding Plan quota queries & display for 7 vendors (incl. local credits metering for the SCNet Token Plan), custom provider balance lookup (configurable HTTP endpoint) and balance progress bar, plus peak/off-peak pricing display with pre-switch popup & system-notification alerts (position / lead time / type configurable), in a bilingual (Chinese/English) UI.",
   "type": "module",
   "main": "lib/index.js",