dsh-session-spend
源码：github.com/weiwang988/dsh-session-spend · 兼容 DSH 0.2.x 线（对照 dsh-v0.2.1-alpha.1 核实；session format v4 词表；devDeps 已升到 0.2.1-alpha.1，见兼容性注记）
DSH（DeepSeek Harness）Web 客户端插件：实时显示当前会话花费（¥），按官方峰谷计价逐笔选档，悬停查看节省分解。零 host 改动，纯客户端。适配 DSH 0.2.x（浏览器端契约 = @deepseek-ai/dsh-client-* 0.2.1-alpha.1，session format v4：assistant/attempt + 内嵌 stream、assistant/message 携带 usage、transient assistant/live-chunk、llm/retry-started 槽位语义）；host 半经 sessionPersistence.open(id,'read') → handle.read()（返回 {eventState, events}）直接读取解码后的逻辑事件流（v3 旧文件由 DSH 的 v3→v4 迁移链转换，assistant stream/usage 不在转换范围内、原样保留），完整会话账本同价同规则。
版本变更
- 0.2.4：适配 DSH 0.2.x 并修价目表。① 价目表的 Flash 三行（
deepseek-flash、deepseek-v4-flash、deepseek-v4-flash-vision-exp）改为共享同一个 flashRates 常量对象——DSH 0.2.x 已把两个旧名从 llm-deepseek 目录移除（feat(llm): remove the V4 Flash and V4 Flash Vision Exp defaults），它们只用于给已录制会话计价（你 9-16 那个会话里就有 192 笔 -vision-exp），共享引用可确保未来改 Flash 价时三行不会漂移。② devDeps 从 0.1.2-rc.1 升到 0.2.1-alpha.1，peer 改为 @deepseek-ai/cordis: ~4.0.5-alpha.1（0.2.1 契约包声明的 peer）。③ 逐一核对 0.2.x 的契约，结论：无破坏性变更——事件词表、sessionPersistence 签名、conversation.composer.dock 槽位、NodeDefinition/ViewDefinition/SnapshotMap 均未变；0.2.x 新增的插件兼容性闸门只检查名称以 @deepseek-ai/dsh- 开头的 peer，本包不命中故不受拦。
- 0.2.3：修复「对话结束后读数不更新、需手动刷新页面」——dock 条目的 host 摘要拉取原先以
lastTurn（回合级）为触发键，一轮内多步（工具循环）的每次结算都不会触发重新拉取，读数会定格在该轮第一步的金额，直到下一次换轮或手动刷新页面。现改为以 recordCount（每条新计价记录都会推进） 为触发键，并加 500 ms 尾部防抖把一轮内的密集事件合并为一次全量日志折叠。同时移除会话成本设置入口——不再注册 settings.plugin.item 设置卡，host 半也不再安装 session-cost 配置段（installSection / schemastery schema 一并删除，schemastery 运行时依赖移除）。价目与低谷系数改为内置常量：host 与浏览器两半统一使用 src/core/price.ts 的 officialPriceTable、src/core/window.ts 的 officialPeakWindow（低谷系数固定 0.5，与官方「低谷价 = 高峰价 × 1/2」一致）。升级影响：DSH 配置文档里遗留的 session-cost 段不再被读取（无害残留，可手动删除）；已固化的默认价目数值与移除前完全一致。
功能
- 会话花费：只算当前会话主对话调用——与聊天统计行的 token 账目同源且逐笔对齐（v2 规则：
assistant/attempt / assistant/message 各贡献其内嵌 stream 的最后一条 usage（data.usage 优先），按 (turn, step, generation) 槽位 last-wins；llm/retry-started 开新槽，重试请求与失败请求都计入——与 token-meter 的 replacement/retry 语义一致）。
- 峰谷计价：每笔请求按事件时间戳判定高峰/低谷，套对应单价；显示「当前高峰中/低谷中」徽标。
- 切模型按模型计：会话中途切换模型时，每笔按该步实际路由模型的单价计价（
message.source.model 逐笔归属；failed/attempt 记录无自带模型 → 归因最近先行 request/header 的 config.model，与 DSH 每请求的路由一致）；tooltip 的「模型分解」列出每个模型的花费份额。
- 节省分解（悬停 tooltip）：总计 / 低峰节省 / 缓存节省 / 模型分解；未配置价格的模型显示「价格未知」，从不猜测。
- 账户余额：每轮结束后同源刷新一次（事件驱动，无轮询）；经 host 端
GET /user/balance 官方接口（凭证取 DSH 设置的 DEEPSEEK_API_KEY），失败（未配置 key / 网络错误）静默隐藏，多币种非零显示。
- 口径：不含压缩总结、标题生成、子代理调用（后续版本提供开关）。
- 展示位：
conversation.composer.dock——与统计行同一横带（虚拟列表插槽，第三方可直接注册）。
官方价目（内置默认 · 采集日 2026-09-10）
来源：DeepSeek API 官方价目页（2026-09-10 抓取核对，Flash 系列当时刚降价 ~60%）。价目随插件版本固化为内置常量，官方调价后请更新 src/core/price.ts（峰谷窗口规则在 src/core/window.ts，未变）。
单位 ¥/百万 token：
| 模型 | 输入·缓存命中 峰/谷 | 输入·未命中 峰/谷 | 输出 峰/谷 |
|---|
| deepseek-flash（DeepSeek-V4.1-Flash，DSH 默认模型） | 0.04 / 0.02 | 2.0 / 1.0 | 8.0 / 4.0 |
| deepseek-v4-pro（DeepSeek-V4-Pro；计划路由到 Flash） | 0.30 / 0.15 | 9.0 / 4.5 | 27.0 / 13.5 |
| deepseek-v4-flash（旧名，仅用于给已录制会话计价） | 0.04 / 0.02 | 2.0 / 1.0 | 8.0 / 4.0 |
| deepseek-v4-flash-vision-exp（旧名，同上） | 0.04 / 0.02 | 2.0 / 1.0 | 8.0 / 4.0 |
官方口径注记：两个旧 flash 名已从 DSH 0.2.x 的 llm-deepseek 默认目录中移除，新请求无法再选到它们；本表保留这两行只为给历史会话计价（对应请求当时由 V4.1-Flash 承接、按 Flash 价计费），且三行共享同一常量对象以防价格漂移。deepseek-v4-pro 计划下线，北京时间 2026-09-14 12:00 之后其请求将全部路由到 V4.1 Flash 并按 Flash 价计费——到那天把 src/core/price.ts 的 pro 行改成 flashRates 即可（host 与浏览器两半共用这一张表）。
高峰时段 = 北京时间周一至周五 9:00–12:00、14:00–18:00（区间起点含、终点不含；周末、午间、晚间、凌晨均为低谷），低谷价 = 高峰价 × 0.5。
安装（bundle + profile 机制）
本包是一个 bundle（dsh.bundle + cordis.patch.yml），安装进 DSH 的 profile（$DSH_HOME/profiles/<name>）即生效——与其它 DSH 插件一致，"放进 profile"由 dsh plugin 命令完成：
# 1) 先构建（package.json 有 prepare 脚本；本地 add 链接的是源码检出，需要 lib/ 产物）
pnpm install && pnpm run build
# 2) 安装进你的 Web profile（`dsh web` 即 `--profile web`；相对路径以调用目录为准，所以在 checkout 内 `add .` 装的就是这个 checkout）
dsh plugin --profile web add .
# 或从任意目录：dsh plugin --profile web add ./dsh-session-spend
# 3) 核对层，然后启动
dsh --profile web --dump-config # 应出现 "# == dsh-session-spend" 层
dsh --profile web
其它来源同样支持（本包不发布 npm，推荐 GitHub git 安装或 tarball）：
dsh plugin --profile web add github:weiwang988/dsh-session-spend#v0.1.0 # git 安装（推荐，pin 发布标签）
# 包内有 prepare 会自动构建，
# 需按提示在 profile 的 pnpm-workspace.yaml
# 允许该包构建（allowBuilds）
dsh plugin --profile web add ./dsh-session-spend-0.1.0.tgz # pnpm pack 产物（免构建许可）
dsh plugin --profile web remove dsh-session-spend # 卸载
若未来要发 npm：pnpm publish 的 prepare 构建已配置好，发布后用户侧 dsh plugin --profile web add dsh-session-spend。
源码仓库：https://github.com/weiwang988/dsh-session-spend（main + 发布标签 v0.1.0）。
生效机制：patch 行 {id: session-spend, name: dsh-session-spend} 进入 Web 组合；@deepseek-ai/dsh-client-modules 扫描组合行，发现本包 dsh.client 清单 → 解析 exports["./client"] → 生成 window.__DSH_BOOT__ 清单并 serve /plugins/session-spend/client.js → 浏览器端 apply 注册定义/视图/dock 条目。无需 fork DSH、无需改任何 bundle 源码。
开发热更新：本地 add ./ 后改了源码，运行 pnpm run build（服务端 serve 的是 lib/client.js 而非源码），刷新浏览器即可。从未 build 就 add 会报 client-modules: ...exports no "./client" bundle。
层序：profile bundles 列表序 → 各 bundle patch → profile 自身 cordis.patch.yml → $DSH_HOME/cordis.patch.yml → --patch 参数。后续层可覆盖/禁用本包行（- {id: session-spend, disabled: true}），改动不用碰本包。
定义不再重复：本包同时声明 dsh.client（插件面）与 dsh.bundle（安装面）——两者可共存；只有 bundle 声明而无 client 清单的包装进去只算普通依赖，不会激活。
开发期自检
pnpm install && pnpm run build # 构建 lib/ 产物
npm test # node:test（纯函数核心 + ViewBuilder）
npm run typecheck # 需安装 @deepseek-ai/* 真实类型
npm run typecheck:offline # 无网络环境（经 types/ 类型镜像）
架构
事件流(窗口+实时) ──> conversationEvents.register(NodeDefinition 'session-cost')
每步一个 Context（step/start 起始；live-chunk/attempt/message/
retry-started 增量更新：append-only 采样+重试历史）
每个 request/header 一个 Context（路由模型事实）
└─> conversationViews.register(ViewDefinition 'cost')
全部节点 → seq 有序 foldCostItems：按 (turn,step,generation)
槽位 last-wins、retry 追加、header 模型归因 → 逐笔高峰/低谷计价
conversation.composer.dock 条目 ← 读快照 session.views.get('cost')
- 分页/重放：引擎
replaceWindow 重建全部节点（Context 从 matches 重放，append-only 状态确定），ViewBuilder replace() 全量重算——不会重复计费。
- 实时：live-chunk usage 帧
animation-frame 节奏刷新（引擎结算时 transient 被退休、Context 以其实际 matches 重放）；与统计行节奏一致，无流式粗估。
兼容性注记（适配 DSH 0.2.x 线）
适配对象为 format v4 事件词表（对照 dsh-v0.2.1-alpha.1 逐接口核实），要点：
- 持久化面：
sessionPersistence.open(id, 'read') → handle.read(offset?, length?, options?) 解析为 SessionHandleReadResult（{ eventState, events }）——本包取 .events；v3 及更早的旧文件由 DSH 的迁移链（v0→v1→v2→v3→v4）自动转换，未知词表 fail-closed。
- v4 对计费的影响：无。v3→v4 的转换只做四件事——工具结果上提、消息来源重命名（
plugin 包装器 → kind）、补齐有证据的中断回合、追加缺失的父目录事实；其规范明确 assistant 的 replay state 与 streams、工具参数/内容元数据保持原样。本包折叠所依赖的 step/start（{turn, step}）、assistant/message（{turn, step, message, stream, usage?}）、assistant/attempt（{turn, step, stream}）、llm/retry-started、request/header（header.config.model）在 0.2.1 的 SessionEventMap 中原样存在。
- 词表来源：
message.source.kind: 'model' 属"直接 source"，v4 的来源重命名只作用于 plugin 包装器，故 message.source.model 的模型归属仍然有效（assistant/attempt 仍无自带 model，按最近先行 request/header 归因）。
- 计费口径：usage =
data.usage ?? 内嵌 stream 中最后一条 usage chunk；llm/retry-started(turn,step) 开新槽位——重试后的样本是追加不是替换（失败请求与重试请求都真实计费）。token-meter 在 0.2.x 仍是同一语义（usageOf()：assistant/message 直取 data.usage，否则 lastAssistantStreamChunk(..., 'usage')）。
- 浏览器端契约：
conversation.composer.dock 仍是 { kind: 'list'; scope: 'session' }；AssistantLiveChunkEvent 仍是 {seq, time, data:{attemptId, turn, step, chunk}}；ConversationNodeDefinition（match/start/update/publication/buildViewNode）、ConversationViewDefinition（target/create）、ConversationViewSnapshotMap 均未变。0.1.2-rc.1 → 0.2.1-alpha.1 之间无破坏性变更。
- 插件兼容性闸门（0.2.x 新增）：
evaluatePluginCompatibility() 只检查名称等于 @deepseek-ai/dsh 或以 @deepseek-ai/dsh- 开头的 peer，不满足即拒绝安装与激活。本包 peer 只有 @deepseek-ai/cordis，不命中该检查；但也意味着运行时 API 漂移需要自行盯守（升 devDeps 后由 pnpm run typecheck 把关）。
- 依赖版本：devDeps 与 peer 已对齐 0.2.1-alpha.1 的契约包（
@deepseek-ai/dsh-client-*@0.2.1-alpha.1，peer ，后者由 0.2.1 契约包声明）。 的 同步收窄到本包实际使用的这些版本。
注：0.2.x 把聊天区统计入口改成 pill + 统计对话框，本包仍挂在 conversation.composer.dock，两者布局相互独立。ConversationViewDefinition 现在有可选的 activity 钩子（目标自报"我这块算不算可见活动"），本包目前仍按金额是否为零 gate，可作后续对齐点。
与现有同类插件的差异
RoxsLee/dsh-cost-plugin（峰谷按时间戳+余额）、Lzh3070/dsh-session-cost（逐消息+明细+余额）等已覆盖「统计行旁读金额」。本项目差异化：
- 事件级 last-wins（含重试槽位）与统计行账目逐笔对齐——failed attempt、重试与终值消息均按 token-meter 的 replacement/retry 语义折算，同一口径可逐笔核对；
- 低峰+缓存节省分解与峰/谷当前状态徽标；
- 未知模型不猜价、显示「价格未知」；
- 纯函数核心（window/price/fold/cost）独立可测，价目与峰谷窗口都是显式常量（单一来源
src/core/price.ts / src/core/window.ts，host 与浏览器两半共用）。
Known Limitations and Deferred Work
- 读数是"全量"且零窗口成本：会话总账由 host 端从持久化日志折叠（0.1.5 线
sessionPersistence.open(id, 'read') → handle.read() 取解码后的逻辑事件流（{eventState, events}；v0/v1/v2 旧文件由 DSH 格式链自动迁移到 v3，未知词表 fail-closed），客户端永不翻页——客户端窗口从不膨胀，会话二次进入零额外成本（补齐了纯客户端窗口方案的短板）。每次轮次结算 host 重读一次该会话日志（大日志的 host 侧成本，后续可加 revision 缓存）。注意 0.1.5 线的 eventState 指示事件值所有权——本包只读取折叠，不保留引用，无需特殊处理。
- 今日(DSH)：host 端跨所有会话按北京时间今日边界汇总（同口径=主对话调用）；与官方控制台差异（标题/压缩等隐性调用）依旧体现在"今日"之外。
- 「当前高峰/低谷」徽标由 60 秒心跳定时器驱动，空闲跨过峰谷边界也会自动翻牌；host 摘要里的
window.current 在每次拉取时刷新，两者以 host 值为准。
- 不含压缩总结/标题生成/子代理——这些调用在官方口径下同样计费；未来以配置开关引入（
includeCompaction / includeTitleGen / includeSubagents）。
- 默认价目为 2026-09-10 采集（Flash 系列降价后；
deepseek-flash/V4.1-Flash 为新默认，旧 flash 名按 Flash 价）——官方再次调价后需同步更新 src/core/price.ts（2026-09-14 12:00 后 pro 将路由到 Flash 计费，届时改 pro 行）。
- 余额/今日 = host 端能力：需要 Vite 同源
/_dsh-cost/summary 路由（本包 host 半）与 DSH 配置的 DEEPSEEK_API_KEY；未配置/失败时余额段静默隐藏（其余功能不受影响）。
- 本插件仅按模型单价估算，不构成官方账单；对账以 DeepSeek 控制台为准。
