dsh-cost-stats

在 DeepSeek Harness 的每条助手消息旁,显示这次对话花了多少钱。

一个 DSH Web 插件:在消息尾行的原生「用量 612K tok」胶囊旁边,加一个 ≈¥0.709 的费用胶囊; 点开可以看到这一次对话的分档明细、计费模型、高峰/空闲时段,以及本次会话的累计费用。设置里还有一个费用统计页,把每一次计费项(回复 + 上下文压缩)列成流水。

数据来源与原生「用量」弹窗完全同源(供应商上报的 token 分档),不是估算 token 再套平均价; 价格用官方公布的两套价目表(人民币 + 美元),含旧模型名的计费归属与 2026-09-14 的 v4-pro 改路规则。不读任何凭据、不访问外网、不改 DSH 内核。

目录:效果 · 功能 · 安装 · 它怎么算 · 费用统计页 · 与账户余额核对 · 开发 · 已知边界

📸 效果

① 每条消息旁的 ≈¥0.100 费用胶囊(点开是这一回合的分档明细)

费用胶囊与明细面板

面板里给出的每一项都能核对:缓存命中 99.9%;未缓存输入 1,359 tok ×¥2/M = ¥0.0027; 缓存读取 1,255,552 tok ×¥0.04/M = ¥0.050;输出 5,839 tok ×¥8/M(其中推理 3,610)= ¥0.047; 单价是当前计费时段的档位(图里是高峰时段),并同时给出 ¥ 与 $ 两种合计。底部还能看到本插件与官方「用量 1.3M tok」「用时 37 秒」并排在同一行,互不干扰。

② 设置 → 费用统计:每一次计费项的流水(默认就是今天,可换日期/月份)

费用统计页

合计卡片:¥14.60 $2.19、回复 17 压缩 1 会话 2 用量 236.60M;
逐条明细:时间 / 会话 / 用量 / 费用,时间精确到分钟,费用同行给出 ¥ 与 $;
压缩 标签:上下文压缩是独立计费项(图里 14:17 那行 ¥1.45),它不属于任何回复,官方胶囊不显示它;
分页:每页 15 条,底部 第 1 / 2 页 · 共 18 条 · 每页 15 条。

两张图都是本机真实数据(2026-09-11),不是示意图;统计页那张的「会话」列做了打码。

✨ 功能


每条消息一个费用胶囊	位置在复制键与分支键之间(原生「用量」胶囊的左侧),显示 `≈¥0.709`,跟随 DSH 主题令牌与字号设置
点击展开明细	计费模型 / 计费时段 / 缓存命中率 / 未缓存输入·缓存读取·输出三项「token × 单价 = 金额」/ 合计(¥ 与 $ 同时给出)
本次会话累计	面板底部给出已加载回合的累计费用(¥ 与 $),便于和账户余额变化对照
设置页「费用统计」	设置 → 费用统计(在「侧边卡片」之后):默认打开就是今天的回复;点日期日历或月份日历可换范围(互斥,另有「清除筛选」与「刷新」)。逐条列出每一次计费项——回复与上下文压缩(带「压缩」标签)——的时间/会话/模型/用量/费用(五列统一左对齐,模型列的写法与上面那个下拉一致,悬停可看 `provider · model` 原始 id;¥ 与 $ 同行显示),每页 15 条并带上一页/下一页;顶部费用合计跟随查询(¥ 与 $ 同行,右侧回复/会话/用量居中显示)。数据由插件自己的宿主路由折遍所有会话日志得到
绝不编数字	拿不到路由归属(不知道用哪个模型计费)或模型无官方公示价时,胶囊不显示、统计页标 `无价目` 且不计入合计,而不是显示 0 或猜测值
官方数据缺失时自动兜底	DSH 核心的回合用量是「全有或全无」:一次重试请求没回报用量,官方「用量」胶囊就会整块消失(插件读的是同一个字段)。此时胶囊改用插件自己的宿主侧日志重算补上,并在标题与浮层里标注「按日志重算」,不与官方口径混淆;官方数据正常时永远优先用官方值
按模型筛选 + 查余额(0.10.0 → 0.15.0)	标题下方一行 `模型`:下拉第一项是 `全部`(默认,不做筛选:表格显示所选时间段里的全部计费项),后面与「设置 → 模型」一一对应:`DeepSeek 账号`(仅登录时)、`DeepSeek`、以及你自己配的 provider(一个中转站如果把自己的 `displayName` 写成 base URL,这里就显示那个 URL)。每次打开这一页都会重新拉一次清单(0.15.0),所以删掉的 provider、改了名字、登录/退出的变化立刻反映在下拉里。选中某个模型后,表格只显示这个模型产生的计费项(合计卡片跟着变);此时点右边的「查询余额」,读数就显示在按钮右侧(悬停看构成与查询时间)。不点就不查(刚打开时显示「未查询」)。选「全部」时点按钮 = 查 DSH 默认的 DeepSeek key
「DeepSeek 账号」的余额也查得到(0.12.0)	它是 DSH 的登录账号,凭据是登录令牌而不是 API key —— 实测拿那个令牌去问官方 `api.deepseek.com/user/balance` 得到 HTTP 401(`Authentication Fails, Your api key … is invalid`)。但它的余额并不需要 key:插件改问 DSH 自己的账号服务 `ctx.deepseekAccount.getBalance(...)`,拿到的就是「充值余额 + 赠金余额」—— 与「设置 → 账号与余额」那一页同一来源。0.15.0 起只有登录时这条才出现在下拉里;退出后它不再可选、也查不了余额,但它过去产生的明细仍然在表格里,`模型` 列照样写「DeepSeek 账号」(名字由清单里的 `providerLabels` 单独提供,不随可选项消失)
key 只在本机宿主侧用一下	插件不保存 key、不写进任何文件、不进仓库,页面也没有任何输入框:0.10.0 起连"手动粘贴 key"这个功能都不存在了(唯一入口是「设置 → 模型」)。查询时页面只说出名字,由宿主经 `ctx.credentials.resolve(<名字>)` 现取现用;账号那条则完全不碰凭据服务(有测试钉住)。key 只出现在发往 `api.deepseek.com` 的请求头里,不进页面渲染结果、不进日志、不进 URL(余额接口只接受 `GET`,没有请求体)。两个凭据路由都仅对本机请求开放(非本机 peer 或外部 `Host` 直接 403)
key 只在本机宿主侧用一下	插件不保存 key、不写进任何文件、不进仓库,页面也没有任何输入框:0.10.0 起连"手动粘贴 key"这个功能都不存在了(唯一入口是「设置 → 模型」)。查询时页面只说出名字,由宿主经 `ctx.credentials.resolve(<名字>)` 现取现用;key 只出现在发往 `api.deepseek.com` 的请求头里,不进页面渲染结果、不进日志、不进 URL(余额接口只接受 `GET`,没有请求体)。两个凭据路由都仅对本机请求开放(非本机 peer 或外部 `Host` 直接 403)
不碰官方控件	两个条目都包在错误边界里:本插件渲染出错只会让自己那一块消失,绝不牵连同一行的复制/反馈/分支/用量/用时控件,也不影响设置面板内容列(冒烟脚本里有专门的"抛错必须被隔离"断言)
唯一的外网请求是余额	除余额那次调用外,不读 API key、不写任何后端、不访问外部网络。其余请求都发往本机 DSH 自己的插件路由(`GET /cost-stats/usage`、`GET /cost-stats/keys`、`GET /cost-stats/balance`,同源),且只在「统计页打开」「官方数据缺失需要兜底」或「你点了查询余额」时发生
中英双语	字典跟随 DSH 界面语言(`locale` 命名空间 `cost-stats`)
无内核改动	只使用 DSH 公开的插件插槽 `conversation.chat.assistant-actions`、`settings.section` 与平台种子模块(`react` / `react-dom`)

📦 安装

前置:DSH 已能正常运行(dsh web 起得来);Node.js ≥ 20,pnpm ≥ 10。

支持的 DSH 版本:在 DSH 0.1.5-rc.2 / 0.1.7-rc.2 / 0.2.0-rc.2 上真机验证(含 0.1.7 引入的 会话日志格式 v4,以及 0.2.0 下 ctx.credentials.describe / set 的存在性实测)。插件只用公开插槽 (conversation.chat.assistant-actions、settings.section)与平台种子模块(react / react-dom), 不 import 任何 DSH 内部包,也不声明 peerDependencies(所以 0.1.7 起的 peer 校验不会禁用本插件), 对 DSH 小版本不敏感。

⚠️ 注意包名:npm 上另有一个同名老包 dsh-session-cost(别的作者,和你这个没关系), 所以本插件从 0.7.0 起改名为 dsh-cost-stats。安装请认准这个名字。

方式一:本机 tarball 安装(推荐,现在就能用,不依赖 npm 发布)

git clone https://github.com/AGImentu/dsh-cost-stats && cd dsh-cost-stats
pnpm install && pnpm build && pnpm pack          # 产出 dsh-cost-stats-<版本>.tgz
dsh plugin --profile web add ./dsh-cost-stats-0.7.0.tgz   # 文件名按上一步的输出替换

dsh plugin add 就是 pnpm add 的转发器,所以 tarball、目录、registry 名都接受;它会顺带把本包追加进 dsh.profile.bundles(因为本包声明了 dsh.bundle.patch),不需要手改任何配置文件。

方式二:源码 `link:` 安装(改代码即时生效,适合调试)

git clone https://github.com/AGImentu/dsh-cost-stats && cd dsh-cost-stats
pnpm install && pnpm build
dsh plugin --profile web add "link:$PWD"        # Windows PowerShell: "link:$($PWD.Path)"

或者用仓库里的一键脚本(等价的两步,并在 CLI 不在 PATH 时兜底):

node scripts/install-local.mjs --profile web

之后每次改代码:重新 pnpm run build → 重启 dsh web → 硬刷新浏览器。

方式三:从 npm 安装(包发布后可用)

dsh plugin --profile web add dsh-cost-stats@latest

方式四:交给 DSH 自己装

把下面这段原样发给任意一个 DSH 会话:

帮我装 dsh-cost-stats 插件（DSH 费用统计），步骤：
1. git clone https://github.com/AGImentu/dsh-cost-stats 到 ~/Code/dsh-cost-stats
2. 在该目录执行 pnpm install && pnpm build && pnpm pack（记下产出的 .tgz 文件名）
3. 执行 dsh plugin --profile web add ./<上一步的 .tgz 文件名>
4. 完成后提醒我：重启 dsh web，然后硬刷新浏览器（Ctrl/Cmd+Shift+R）
遇到报错先查 https://github.com/AGImentu/dsh-cost-stats 的 README「常见问题」表。

装完必须做的一步

重启 dsh web,然后硬刷新浏览器(Ctrl/Cmd+Shift+R)。

规则很简单:lib/client.js(浏览器半边)改动,硬刷新即可;lib/index.js(宿主半边)改动必须重启。 本插件的统计页与胶囊兜底都依赖宿主半边,所以第一次安装请重启一次。

更新

cd ~/Code/dsh-cost-stats && git pull && pnpm install && pnpm build && pnpm pack
dsh plugin --profile web add ./<上一步产出的 .tgz>     # tarball 方式
# 或 link: 方式：重新 pnpm run build 即可，profile 里已经是符号链接

改完:client 改动硬刷新即可,host 改动要重启 dsh web。

卸载

dsh plugin --profile web remove dsh-cost-stats

remove 同样会按已安装状态对账 dsh.profile.bundles,把本包从 bundle 层里摘掉—— 不需要手改 ~/.dsh/profiles/web/package.json。之后重启 dsh web。

常见问题

现象	原因与解决
统计页显示「读取费用数据失败(宿主侧路由不可用)」	宿主半边(host)没加载:只刷新页面不够,必须重启 `dsh web`。
设置里没有「费用统计」这一项	插件没挂上:确认 `~/.dsh/profiles/web/package.json` 的 `dependencies` 有本包、`dsh.profile.bundles` 里有 `dsh-cost-stats`,然后重启。
聊天里某个回合没有费用胶囊	该回合无官方价目(第三方 provider / 未公示模型)或拿不到路由归属时会故意不显示,不是崩溃。
页面出现两个费用胶囊	双挂载:profile 的 `cordis.patch.yml` 里还留着手写的挂载行,删掉那段(与 bundle 层重复)。
提示 `dsh: command not found`	先用 `npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-cost-stats@latest`,或从源码走方式一/二。
`pnpm add` 报 `Ignored build scripts`	本插件没有原生依赖、也没有生命周期脚本,正常不会出现;若你在同一 profile 装过别的插件(如带 `node-pty` 的),在 `~/.dsh/profiles/web` 下跑 `pnpm approve-builds --all`。
数字和官方「用量」弹窗对不上	精度口径见下方「与账户余额核对」:本插件是按官方价目表的估算,按回合起始时刻判高峰/空闲,并额外计入官方胶囊不显示的压缩。

🧮 它怎么算

价目表(官方公布值,单位:元或美元 / 百万 token)

	缓存命中(空闲/高峰)	未缓存输入(空闲/高峰)	输出(空闲/高峰)
DeepSeek-V4.1-Flash(`deepseek-flash`)	¥0.02 / ¥0.04	¥1 / ¥2	¥4 / ¥8
DeepSeek-V4-Pro-0813(`deepseek-v4-pro`)	¥0.15 / ¥0.30	¥4.5 / ¥9	¥13.5 / ¥27

美元表同样内置(Flash:$0.003/0.006、$0.15/0.3、$0.6/1.2;Pro:$0.022/0.044、$0.66/1.32、$1.98/3.96)。 两套表是官方各自独立公布的,不是换算关系,所以面板把两个数都给出来。

模型名 → 计费归属

请求的模型名	按哪个模型计费
`deepseek-flash`	V4.1-Flash(规范名)
`deepseek-v4-flash`、`deepseek-v4-flash-vision-exp`	V4.1-Flash(旧名已下线,请求仍可用但由 V4.1-Flash 提供服务并按 Flash 计费)
`deepseek-v4-pro`	V4-Pro-0813;自北京时间 2026-09-14 12:00 起改路由到 V4.1-Flash 并按 Flash 计费
其他 provider / 模型	无公示价 → 胶囊不显示

高峰时段

北京时间 周一至周五 09:00–12:00 与 14:00–18:00(窗口右端点不含:12:00 已属空闲);其余时间为空闲。按 DeepSeek 的官方公告,周末(含调休上班的周末)与中国法定节假日全天都按空闲价计费 —— 所以节假日里的工作日不会按高峰计。插件内置了 2026 年的法定节假日日历(src/holidays.ts, 数据来自《国务院办公厅关于 2026 年部分节假日安排的通知》),面板按回合起始时刻归类,并在跨时段时明确标注。

⚠️ 节假日的倍率由 DeepSeek 决定,我的换算基准是 2026-09-19 的公告(空闲价 = 高峰价的一半, 高峰为 9:00–12:00、14:00–18:00)。

精度边界(重要,如实列出)

token 分档是精确的——供应商上报值,与原生用量弹窗逐位一致;金额 = 分档 token × 单价,没有二次估算。
跨高峰边界的回合按起始时刻计价(DSH 的回合用量是聚合值,不含逐次请求时间戳),面板会标注。
一个回合内混用了多个计费模型时无法把 token 拆到各模型,按其中最高价估算上界,面板会标注。
子代理、后台会话、压缩(compaction)请求不计入——它们属于各自的会话/账目,不在当前对话的回合用量里。
这是估算值,不是账单:不含四舍五入、促销、provider 侧的最终结算细节。
缓存写入:官方价目表没有独立的缓存写入档(写入按未缓存输入计费),所以不单独计价。
法定节假日日历是按年维护的数据(src/holidays.ts,目前含 2026 全年)。 DeepSeek 每年随国务院通知调整放假安排,插件没有联网取日历:到了 2027 年,若那年的节假日还没补进列表, 那些日期的工作日就会按高峰价估算 —— 也就是偏高(最多一倍),不会偏低。补数据即可修正,不用改代码逻辑。验证方式:把「余额差额」与统计页的合计对一下(见下节「与账户余额核对」)。

📊 费用统计页(设置 → 费用统计)

注册进 DSH 设置面板的 settings.section 插槽,导航位置排在「侧边卡片」之后(同一个设置面板,不是弹窗套弹窗)。

两个日历选择器(不是选项卡):
- 选择日期 → 周一开头的日历(6×7 网格、可翻月、「今天」有标记),点某一天 → 下方只显示那一天的明细;
- 选择月份 → 12 个月 + 可翻年的月份网格,点某个月 → 下方只显示那个月的明细;
- 有数据的日期/月份在网格里加点显示,没数据的日子也能点(显示空态);两者互斥,另有「清除筛选」。
费用合计卡片:标注当前范围(费用合计 · 2026-09-11 / · 2026-09 / · 全部时间), 显示 ¥ 主、$ 次,以及回复数 / 会话数 / 用量 / 子代理数 / 未计价数。
一张明细表:每条助手回复一行 —— 时间(MM-DD HH:mm)、会话(带 子代理 / 无价目 标记)、用量、费用(¥ 主 / $ 次); 悬停会话名可看到 会话 · #回合 · 计费模型。页面没有第二张汇总表,所以不存在两套口径。

数据来自哪里

统计页读的是插件自己的宿主路由 GET /cost-stats/usage。宿主半边会:

ctx.sessionPersistence.list() 枚举存储里的会话(取最近的非空会话);
逐个打开并读取完整持久化日志(open(id,'read') → handle.read());
用 src/host/turn-fold.ts 把日志折叠成逐次回复:回合窗口(turn/start/turn/end)、该次回复实际使用的 message.source.provider/model(缺失时回退到最近一条 model/selection)、以及 assistant/message(与重试的 assistant/attempt)里的分档 usage;
用与聊天胶囊完全相同的价目表与高峰窗口逐条计价,按 TTL 缓存后返回 JSON。

因为走的是持久化日志(而不是浏览器已加载的聊天窗口),页面能覆盖所有会话、全部历史,不需要激活任何冷会话。逐条明细与日/月合计用的是同一批数字,所以合计不会有第二套口径。

🔍 与账户余额核对

两条路,建议用第一条:

A. 独立复算脚本(推荐)

node scripts/verify-balance.mjs 2026-09-11T11:07 2026-09-11T12:20

它绕过宿主、直接解码 $DSH_HOME/sessions/** 的会话日志,用同一套折叠与价目表复算,并给出你指定时刻的累计值; 把两次累计值相减,就是这段时间的花费,可直接与 API 余额的差值对比(注意:比差值,不要比余额绝对值—— 余额里还有你在这个插件之前的花费)。

开发现场实测的三个窗口(同一台机器、同一套脚本复现):

区间	余额下降	独立复算上升	结论
11:07 → 12:20	−$0.25	+$0.249	✓ 1 美分内
12:20 → 15:02	−$0.78	+$0.77	✓ 1 美分内
15:02 → 15:49	−$0.200	+$0.200	✓ 零误差

第三行这份对齐是 0.6.0 才成立的:在此之前复算只统计「回复」,而那段时间里触发过一次 上下文压缩(compaction/summary),按当时高峰价约 ¥1.45 / $0.218。压缩是一次独立的模型调用, 不属于任何回复,官方「用量」胶囊也看不见它;当时复算因此比余额少了 0.2 美元左右。 0.6.0 起压缩作为独立一行(带「压缩」标签)计入合计,差额随即消失。

结论:插件合计与账单一致到 1 美分左右,唯一需要留意的是「仍在进行的回合」会落在窗口边界上——对账时最好等当前回合结束再比。

B. 只看界面

在设置 → 费用统计里读合计的 $(默认就是今天);或读聊天里某个回合胶囊的 $;
与 API 平台余额的变化量对比(余额以美元计,看 $ 那一栏,不要直接拿 ¥ 去比);
口径提示:余额还包含标题生成等少量调用,以及仍在进行的请求; 列表里带「压缩」标签的行就是曾经的缺口,现在已计入。想复现上面那张对账表,用 pnpm run verify:balance <时刻1> <时刻2>。

人民币与美元的官方价目表相差约 7 倍(Flash 未缓存输入:¥1 ↔ $0.15),这是官方两套公布值,不是本插件做了汇率换算。

🛠️ 开发

pnpm install
pnpm run typecheck   # tsc --noEmit
pnpm test            # 158 项:计费/时段/别名规则 + 日志折叠(含压缩、分叉继承段、会话格式 v4) + 日历 + 统计与分页 + 兜底缓存 + 余额解析/凭据读取与 describe、写入 + key 清单解析与合并 + 按 key 名的缓存隔离 + 本机守卫 + locale 取法与翻译兜底 + **真 React + jsdom 整页渲染**
pnpm run build       # lib/index.js(host 半边:路由 + 日志折叠) + lib/client.js(浏览器半边)
pnpm run smoke       # 产物契约冒烟:在 Node 里跑 client.js,验证注册 id / 插件形状 / 两个插槽 / 字典注册 / 真实算价 / 抛错隔离 / 宿主请求 / 保留 prop(ref)警察
pnpm run verify      # typecheck + test + build + smoke
pnpm run verify:balance   # 独立复算全部会话累计 ← 与 API 余额对账用
pnpm run verify:paths     # 两种折叠入口(有头部 / 无头部+切点)逐条比对 ← 防止「离线验证通过、真机重复计费」
pnpm run watch       # 开发时增量重建(配合 dsh 的 client HMR;host 改动仍需重启)

pnpm run smoke 是这个项目里最有用的一道门:不需要浏览器、不需要重启 DSH,就能证明 lib/client.js ①以包名注册了工厂、②导出了 inject/apply、③把胶囊注册进 conversation.chat.assistant-actions、 ④把统计页注册进 settings.section、⑤对真实分档数据算出正确金额、⑥对无法计价的数据不渲染、 ⑦两个条目的渲染抛错都被隔离成"不显示"、⑧统计页确实向宿主路由取数。改了计费逻辑或页面结构先跑它。

目录结构

src/
  pricing.ts              计费模型:价目表、别名与改路规则、高峰窗口、cost 计算、金额格式化(纯函数,单测覆盖)
  rows.ts                 宿主路由与统计页共享的 wire 类型(计费项行 / 载荷;`compaction: true` = 压缩行)
  balance.ts              余额与 key 清单的 wire 类型(页面只看得到数字、**key 的名字**与失败原因码,永远看不到 key 值)
  routes.ts               路由常量(两半边共用,避免字符串漂移):usage / keys / balance
  index.ts                host 半边:注册三个路由,并作为一行 live Loader row
  host/
    turn-fold.ts          纯折叠:持久化事件 → 每次回复 + 每次压缩(窗口 / 模型 / 分档 token)
    cost-stats-index.ts 索引:枚举会话 → 读日志 → 折叠 → 逐条计价 → TTL 缓存
    balance.ts            余额解析(DeepSeek 的字符串金额 → 数字)+ 仅本机请求的守卫(纯函数,单测覆盖)
    api-key.ts            **唯一接触 key 值的模块**:`resolve` 现取现用、`describe` 只问"配了没"、`set` 只在你勾选时写进 DSH 凭据库
    key-catalog.ts        key 清单:读凭据库的 `refs` 名字 + 配置里的 `apiKeyEnv`(纯解析函数,单测覆盖),再用 `describe` 补「已配置 / 未配置」
    balance-route.ts      余额路由:本机校验 → 按**名字**取凭据或用手动 key → 调用官方接口 → 只回数字与名字(15 秒缓存**按 key 名分开**,`?refresh=1` 强制)
    keys-route.ts         key 清单路由(仅本机;只回名字,不解析任何值)
    contract.ts           host 侧契约镜像(sessionPersistence / webServer / 请求头、peer 地址与请求体迭代)
  client/
    index.tsx             浏览器半边:注入样式、注册字典、注册两个插槽条目(胶囊 + 统计页)
    CostChip.tsx          费用胶囊 + 明细面板(portal + 定位 + Esc/外部点击关闭)
    StatsSection.tsx      设置页「费用统计」:标题 + 余额胶囊 + 模型行、合计卡片、逐条计费项明细表(回复 / 压缩,单一列表 + 分页)
    BalanceChip.tsx       标题右侧的余额胶囊(数字 / 查询中 / 未配置 / 失败四种状态 + 悬停明细与来源模型)
    KeyPicker.tsx         模型行:供应商下拉(显示「设置 → 模型」里的名字)+ 「查询余额」按钮 + 手动输入(密码框)与「存入 DSH 凭据库」
    locale-service.ts     locale 服务的**非严格取法** + 翻译兜底(框架回显 key 时改用自带字典,避免页面显示 `stats.xxx`)
    balance-store.ts      余额的共享缓存(**按凭据名分开**、15 秒有效期、并发合并;手动粘贴的 key 不缓存)
    key-store.ts          模型清单的缓存 + 已选凭据名(只记**名字**,存 localStorage;手动 key 从不进这里)
    Pickers.tsx           两个日历选择器(选日期 / 选月份)+ 共享的锚定浮层
    calendar.ts           纯日历数学:周一为首的 6×7 网格、跨年月份平移、月份键解析
    stats-model.ts        统计模型(纯函数):日/月键 + 合计(回复/压缩分开计数)+ 分页切片
    select.ts             从聊天快照里取回合用量/时间窗/回合号的选择器(必须返回存储引用,避免逐 chunk 重渲染)
    usage-store.ts        宿主数据的共享缓存(30 秒有效期、并发合并):胶囊兜底路径的唯一数据来源
    contract.ts           本插件读取的 DSH 浏览器契约的镜像类型(见下)
    Boundary.tsx          错误边界:让插件的渲染失败只影响自己那一块
    locales.ts            中英字典 + 内置中文兜底
    styles.ts             插件自有样式(仅消费 DSH 设计令牌)
cordis.patch.yml          bundle patch:把本包挂成 profile 的一层
tsdown.config.ts          产出 host 半边(ESM)与浏览器半边(CJS 闭包工厂)
scripts/
  install-local.mjs       本地 link 安装 + bundles 对账
  smoke-client-bundle.mjs 产物契约冒烟(无浏览器)
  verify-balance.mjs      独立复算(绕过宿主直读会话日志)← 余额对账
  verify-fold-paths.mjs   双入口一致性检查(有头部 / 无头部+切点)← 防「离线通过、真机重复计费」
docs/architecture.md      接入契约与设计取舍
docs/images/              README 里那两张效果截图(胶囊 / 统计页)

🧩 为什么不 import DSH 的内部类型?

src/client/contract.ts 里的类型是镜像声明而不是 import,这是刻意的:

DSH 的客户端内部包(@deepseek-ai/dsh-client-ui-chat 等)在 npm 上的发布版本远落后于运行中的 shell(npm 上是 0.1.2-alpha.x / 0.0.1-rc.x,而 shell 已是 0.1.5-rc.2),跟着 npm 版本写类型会描述一个并不存在的宿主;
因此本插件只依赖两样东西:冻结的平台模块表(react / react/jsx-runtime / react-dom)与插槽契约;
每个字段在运行时都做了防御性读取:DSH 版本换代删改字段时,退化为「不渲染胶囊」而不是崩溃。

契约锚点与更多设计取舍见 docs/architecture.md。

🚀 发布(维护者向)

当前通道:GitHub 即发布——别人按上面的「方式一/二」从仓库装即可,不需要你做任何事。

想把它也发到 npm(那样别人一句 dsh plugin add dsh-cost-stats 就装好了),三步:

# 1. 登录 npm（只需一次；本机默认 registry 是镜像，发布要显式指定官方源）
npm login --registry https://registry.npmjs.org

# 2. 确认包名可用（0.7.0 起用的是 dsh-cost-stats，已确认未被占用）
npm view dsh-cost-stats version --registry https://registry.npmjs.org   # 期望 404

# 3. 发布（先 pnpm run verify 全绿）
pnpm run build && pnpm publish --access public --registry https://registry.npmjs.org

发版清单:

package.json 的 name / repository / author 已填好,dsh.plugin.json 已就位
pnpm run verify 全绿(typecheck + 56 项单测 + 构建 + 21 项产物冒烟)
推送到 https://github.com/AGImentu/dsh-cost-stats(main),CI 绿
发布 npm(上面三步)
给仓库打 dsh-plugin / deepseek-harness topic,便于被发现
价目表变化时更新 src/pricing.ts 与 tests/pricing.spec.ts,并在 CHANGELOG 记录

进阶:用 GitHub Actions 的 npm Trusted Publishing(OIDC) 免 token 自动发版 (npm 包设置里绑定 Org/Repo/Workflow,再在 Release 触发)——生态里成熟插件就是这么做的。

⚠️ 已知边界

聊天面板的「本次会话」只统计已加载到聊天窗口的回合;更早的历史需要向上滚动加载后才会计入。想看全部历史,用设置 → 费用统计(它走宿主路由读持久化日志)。
统计页读取存储里最近 120 个非空会话的完整日志,按 TTL 缓存;读取失败或没有任何已计价回复的会话计入 skipped,不影响其余行。
统计页与胶囊都是按官方价目表的估算,不是账单:不含四舍五入、促销与 provider 侧最终结算细节; 标题生成等少量模型调用不在折叠范围内(实测差值 < 1 美分);上下文压缩已在 0.6.0 计入(见下一条)。
只在 DeepSeek 官方路由(provider 含 deepseek)上有价目;第三方 provider 标 无价目 且不计入合计。
分叉 / 侧边对话的日志自带父会话副本:DSH 会把父会话的事件整段复制进子会话的日志,并在嫁接处写下 session/end-seed(data.inherited: true)。插件按这个接缝跳过继承段,只统计子会话自己产生的计费项 (0.7.1 修复;此前会把父会话的历史重复算一遍,当日金额一度虚高约 60%)。因此「会话数」统计的是真正产生过计费项的会话,不是存储里的日志个数。
上下文压缩已作为独立一行计入(带「压缩」标签):它不属于任何回合,官方「用量」胶囊不显示它, 但它是真实扣费(实测一次约 $0.2)。0.6.0 之前它不在合计里,这是过去与余额对不上的唯一系统性原因。
统计页需要宿主半边加载(即需要重启过 dsh web);只刷新页面而没重启时,页面会显示"宿主侧路由不可用"。
官方核心的回合用量是「全有或全无」:回合里只要有一次重试请求没回报用量,官方「用量」胶囊就会消失。本插件此时改用宿主侧日志重算补一个数(标题会写「按日志重算」),但日志里同样缺失的那部分用量, 会让这个数字偏低——它是不显示之外的次优选择,不是等价替代。
余额是「账号级」的,不是「key 级」:官方 GET /user/balance 只回答账号还剩多少钱(实测某账号只有 CNY 币种,所以显示 ¥;若账号持有美元,会同时列出 $)。它不区分是哪把 key 花的;要按 key/按天看明细,只能登录平台网页(那是需要登录态 userToken 的私有接口,本插件不碰)。
只有 DeepSeek 官方签发的 key 查得到余额:下拉里那些中转站/第三方的 key(如 MIXTOKEN_API_KEY)拿官方 user/balance 去问会得到 401,插件会如实显示「DeepSeek 拒绝了这个 API key(HTTP 401);只有 DeepSeek 官方的 key 能查余额」,而不是显示 0 或空白。
同一账号的两把 key 查出的是同一个数(见上一条:接口是账号级的);所以下拉切 key 时看到的钱一样,不代表插件取错了 key——悬停提示里的「来源:xxx」会告诉你这次用的是哪把。
余额只有 2 位小数:所以它适合看"还剩多少、今天掉了多少",不适合看单次调用花了多少(几分钱要累积到 0.01 才可见)。余额的变化量与统计页的本机累计互为对账:差额就是别的机器/别的工具花的。
余额的缓存是双层且刻意很短:宿主 15 秒 + 页面 15 秒,而且按 key 名分开缓存(换一把 key 绝不会显示上一把的数字);点「刷新」会带 ?refresh=1 绕过两层。手动粘贴的 key 完全不缓存,点一次查一次。
手动输入的 key 默认只活在当前页面:刷新/关掉页面就没了(这是刻意的,插件不替你保管密钥)。想长期用,要么在「设置 → 模型」里正式配置,要么在输入框旁勾选「存入 DSH 凭据库」——它写进的是 DSH 的凭据文件,下一份 DSH 凭据也是读那里。
会话日志格式 v4(DSH 0.1.7 起):v4 把工具结果提升为工具角色、重命名生产者来源、补齐中断回合。实测同一会话的 v3 与 v4 两份日志,共同回合逐条数字完全一致,因此本插件不需要改折算逻辑: 宿主半边本来就走 sessionPersistence(与格式无关),两个诊断脚本也已改为读取所有代际 (session.v*.jsonl*),不会因为格式升级而只扫到旧文件。
官方「用量」胶囊在 0.1.7 起只在**「性能与用量 = 详细」**模式下显示;本插件的胶囊渲染在 extraActions(插件单元格)里,不受该模式影响——也就是说关掉详细模式后,官方胶囊会消失而本插件仍在。
极窄视口下胶囊跟随原生 stat pill 的收缩策略(本插件未额外做图标化折叠)。

📄 License

MIT

English (overview)

dsh-cost-stats is a DeepSeek Harness Web plugin that shows the cost of each assistant turn next to the native turn-usage pill, using the provider-reported token buckets (exact) and the official published DeepSeek price tables in both CNY and USD. Clicking the chip opens an itemized panel (billed model, peak/off-peak window, cache-hit ratio, uncached / cached input and output lines, turn total, session total over the loaded turns) — see the screenshots above. A Cost stats settings page lists every billed item of every stored session, per reply and per context compaction, with day/month pickers and 15-row pages.

It renders nothing when an item cannot be priced and needs no core change: it registers into the documented conversation.chat.assistant-actions and settings.section slots, depends only on the frozen platform modules, and reads the durable session logs from its own host route (GET /cost-stats/usage, same origin, no external network). Both entries sit behind an error boundary, so a plugin failure can only remove the plugin's own UI, never the official controls beside it.

The settings page also shows the account balance (GET /user/balance) and, since 0.9.0, lets the reader pick which API key to query: a dropdown lists the credential NAMES this harness knows (DEEPSEEK_API_KEY, a relay's key, …) plus a "paste a key" entry, and Check key balance asks DeepSeek with the picked one. A name is all the page ever holds — the host resolves the value through DSH's own credential service and its describe member (which never returns a value); a pasted key travels in a POST body, lives in the page's memory only, and is written to DSH's credential store solely when the reader ticks the box that says so. Both credential routes answer loopback callers only, and no key value reaches a response, a log line or a URL.

Verified against the account balance: three reconciliation windows on 2026-09-11 matched to within one cent (0.25 vs 0.249, 0.78 vs 0.77, and 0.200 vs 0.200), with context compactions folded in from 0.6.0 on.

Install: dsh plugin --profile web add dsh-cost-stats (or node scripts/install-local.mjs from a checkout), then restart dsh web and hard-refresh the page.

dsh-cost-stats

在 DeepSeek Harness 的每条助手消息旁,显示这次对话花了多少钱。

数据来源与原生「用量」弹窗完全同源(供应商上报的 token 分档),不是估算 token 再套平均价; 价格用官方公布的两套价目表(人民币 + 美元),含旧模型名的计费归属与 2026-09-14 的 v4-pro 改路规则。不读任何凭据、不访问外网、不改 DSH 内核。

目录:效果 · 功能 · 安装 · 它怎么算 · 费用统计页 · 与账户余额核对 · 开发 · 已知边界

📸 效果

① 每条消息旁的 ≈¥0.100 费用胶囊(点开是这一回合的分档明细)

费用胶囊与明细面板

② 设置 → 费用统计:每一次计费项的流水(默认就是今天,可换日期/月份)

费用统计页

合计卡片:¥14.60 $2.19、回复 17 压缩 1 会话 2 用量 236.60M;
逐条明细:时间 / 会话 / 用量 / 费用,时间精确到分钟,费用同行给出 ¥ 与 $;
压缩 标签:上下文压缩是独立计费项(图里 14:17 那行 ¥1.45),它不属于任何回复,官方胶囊不显示它;
分页:每页 15 条,底部 第 1 / 2 页 · 共 18 条 · 每页 15 条。

两张图都是本机真实数据(2026-09-11),不是示意图;统计页那张的「会话」列做了打码。

✨ 功能


每条消息一个费用胶囊	位置在复制键与分支键之间(原生「用量」胶囊的左侧),显示 `≈¥0.709`,跟随 DSH 主题令牌与字号设置
点击展开明细	计费模型 / 计费时段 / 缓存命中率 / 未缓存输入·缓存读取·输出三项「token × 单价 = 金额」/ 合计(¥ 与 $ 同时给出)
本次会话累计	面板底部给出已加载回合的累计费用(¥ 与 $),便于和账户余额变化对照
设置页「费用统计」	设置 → 费用统计(在「侧边卡片」之后):默认打开就是今天的回复;点日期日历或月份日历可换范围(互斥,另有「清除筛选」与「刷新」)。逐条列出每一次计费项——回复与上下文压缩(带「压缩」标签)——的时间/会话/模型/用量/费用(五列统一左对齐,模型列的写法与上面那个下拉一致,悬停可看 `provider · model` 原始 id;¥ 与 $ 同行显示),每页 15 条并带上一页/下一页;顶部费用合计跟随查询(¥ 与 $ 同行,右侧回复/会话/用量居中显示)。数据由插件自己的宿主路由折遍所有会话日志得到
绝不编数字	拿不到路由归属(不知道用哪个模型计费)或模型无官方公示价时,胶囊不显示、统计页标 `无价目` 且不计入合计,而不是显示 0 或猜测值
官方数据缺失时自动兜底	DSH 核心的回合用量是「全有或全无」:一次重试请求没回报用量,官方「用量」胶囊就会整块消失(插件读的是同一个字段)。此时胶囊改用插件自己的宿主侧日志重算补上,并在标题与浮层里标注「按日志重算」,不与官方口径混淆;官方数据正常时永远优先用官方值
按模型筛选 + 查余额(0.10.0 → 0.15.0)	标题下方一行 `模型`:下拉第一项是 `全部`(默认,不做筛选:表格显示所选时间段里的全部计费项),后面与「设置 → 模型」一一对应:`DeepSeek 账号`(仅登录时)、`DeepSeek`、以及你自己配的 provider(一个中转站如果把自己的 `displayName` 写成 base URL,这里就显示那个 URL)。每次打开这一页都会重新拉一次清单(0.15.0),所以删掉的 provider、改了名字、登录/退出的变化立刻反映在下拉里。选中某个模型后,表格只显示这个模型产生的计费项(合计卡片跟着变);此时点右边的「查询余额」,读数就显示在按钮右侧(悬停看构成与查询时间)。不点就不查(刚打开时显示「未查询」)。选「全部」时点按钮 = 查 DSH 默认的 DeepSeek key
「DeepSeek 账号」的余额也查得到(0.12.0)	它是 DSH 的登录账号,凭据是登录令牌而不是 API key —— 实测拿那个令牌去问官方 `api.deepseek.com/user/balance` 得到 HTTP 401(`Authentication Fails, Your api key … is invalid`)。但它的余额并不需要 key:插件改问 DSH 自己的账号服务 `ctx.deepseekAccount.getBalance(...)`,拿到的就是「充值余额 + 赠金余额」—— 与「设置 → 账号与余额」那一页同一来源。0.15.0 起只有登录时这条才出现在下拉里;退出后它不再可选、也查不了余额,但它过去产生的明细仍然在表格里,`模型` 列照样写「DeepSeek 账号」(名字由清单里的 `providerLabels` 单独提供,不随可选项消失)
key 只在本机宿主侧用一下	插件不保存 key、不写进任何文件、不进仓库,页面也没有任何输入框:0.10.0 起连"手动粘贴 key"这个功能都不存在了(唯一入口是「设置 → 模型」)。查询时页面只说出名字,由宿主经 `ctx.credentials.resolve(<名字>)` 现取现用;账号那条则完全不碰凭据服务(有测试钉住)。key 只出现在发往 `api.deepseek.com` 的请求头里,不进页面渲染结果、不进日志、不进 URL(余额接口只接受 `GET`,没有请求体)。两个凭据路由都仅对本机请求开放(非本机 peer 或外部 `Host` 直接 403)
key 只在本机宿主侧用一下	插件不保存 key、不写进任何文件、不进仓库,页面也没有任何输入框:0.10.0 起连"手动粘贴 key"这个功能都不存在了(唯一入口是「设置 → 模型」)。查询时页面只说出名字,由宿主经 `ctx.credentials.resolve(<名字>)` 现取现用;key 只出现在发往 `api.deepseek.com` 的请求头里,不进页面渲染结果、不进日志、不进 URL(余额接口只接受 `GET`,没有请求体)。两个凭据路由都仅对本机请求开放(非本机 peer 或外部 `Host` 直接 403)
不碰官方控件	两个条目都包在错误边界里:本插件渲染出错只会让自己那一块消失,绝不牵连同一行的复制/反馈/分支/用量/用时控件,也不影响设置面板内容列(冒烟脚本里有专门的"抛错必须被隔离"断言)
唯一的外网请求是余额	除余额那次调用外,不读 API key、不写任何后端、不访问外部网络。其余请求都发往本机 DSH 自己的插件路由(`GET /cost-stats/usage`、`GET /cost-stats/keys`、`GET /cost-stats/balance`,同源),且只在「统计页打开」「官方数据缺失需要兜底」或「你点了查询余额」时发生
中英双语	字典跟随 DSH 界面语言(`locale` 命名空间 `cost-stats`)
无内核改动	只使用 DSH 公开的插件插槽 `conversation.chat.assistant-actions`、`settings.section` 与平台种子模块(`react` / `react-dom`)

📦 安装

前置:DSH 已能正常运行(dsh web 起得来);Node.js ≥ 20,pnpm ≥ 10。

⚠️ 注意包名:npm 上另有一个同名老包 dsh-session-cost(别的作者,和你这个没关系), 所以本插件从 0.7.0 起改名为 dsh-cost-stats。安装请认准这个名字。

方式一:本机 tarball 安装(推荐,现在就能用,不依赖 npm 发布)

git clone https://github.com/AGImentu/dsh-cost-stats && cd dsh-cost-stats
pnpm install && pnpm build && pnpm pack          # 产出 dsh-cost-stats-<版本>.tgz
dsh plugin --profile web add ./dsh-cost-stats-0.7.0.tgz   # 文件名按上一步的输出替换

方式二:源码 `link:` 安装(改代码即时生效,适合调试)

git clone https://github.com/AGImentu/dsh-cost-stats && cd dsh-cost-stats
pnpm install && pnpm build
dsh plugin --profile web add "link:$PWD"        # Windows PowerShell: "link:$($PWD.Path)"

或者用仓库里的一键脚本(等价的两步,并在 CLI 不在 PATH 时兜底):

node scripts/install-local.mjs --profile web

之后每次改代码:重新 pnpm run build → 重启 dsh web → 硬刷新浏览器。

方式三:从 npm 安装(包发布后可用)

dsh plugin --profile web add dsh-cost-stats@latest

方式四:交给 DSH 自己装

把下面这段原样发给任意一个 DSH 会话:

帮我装 dsh-cost-stats 插件（DSH 费用统计），步骤：
1. git clone https://github.com/AGImentu/dsh-cost-stats 到 ~/Code/dsh-cost-stats
2. 在该目录执行 pnpm install && pnpm build && pnpm pack（记下产出的 .tgz 文件名）
3. 执行 dsh plugin --profile web add ./<上一步的 .tgz 文件名>
4. 完成后提醒我：重启 dsh web，然后硬刷新浏览器（Ctrl/Cmd+Shift+R）
遇到报错先查 https://github.com/AGImentu/dsh-cost-stats 的 README「常见问题」表。

装完必须做的一步

重启 dsh web,然后硬刷新浏览器(Ctrl/Cmd+Shift+R)。

更新

cd ~/Code/dsh-cost-stats && git pull && pnpm install && pnpm build && pnpm pack
dsh plugin --profile web add ./<上一步产出的 .tgz>     # tarball 方式
# 或 link: 方式：重新 pnpm run build 即可，profile 里已经是符号链接

改完:client 改动硬刷新即可,host 改动要重启 dsh web。

卸载

dsh plugin --profile web remove dsh-cost-stats

remove 同样会按已安装状态对账 dsh.profile.bundles,把本包从 bundle 层里摘掉—— 不需要手改 ~/.dsh/profiles/web/package.json。之后重启 dsh web。

常见问题

现象	原因与解决
统计页显示「读取费用数据失败(宿主侧路由不可用)」	宿主半边(host)没加载:只刷新页面不够,必须重启 `dsh web`。
设置里没有「费用统计」这一项	插件没挂上:确认 `~/.dsh/profiles/web/package.json` 的 `dependencies` 有本包、`dsh.profile.bundles` 里有 `dsh-cost-stats`,然后重启。
聊天里某个回合没有费用胶囊	该回合无官方价目(第三方 provider / 未公示模型)或拿不到路由归属时会故意不显示,不是崩溃。
页面出现两个费用胶囊	双挂载:profile 的 `cordis.patch.yml` 里还留着手写的挂载行,删掉那段(与 bundle 层重复)。
提示 `dsh: command not found`	先用 `npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-cost-stats@latest`,或从源码走方式一/二。
`pnpm add` 报 `Ignored build scripts`	本插件没有原生依赖、也没有生命周期脚本,正常不会出现;若你在同一 profile 装过别的插件(如带 `node-pty` 的),在 `~/.dsh/profiles/web` 下跑 `pnpm approve-builds --all`。
数字和官方「用量」弹窗对不上	精度口径见下方「与账户余额核对」:本插件是按官方价目表的估算,按回合起始时刻判高峰/空闲,并额外计入官方胶囊不显示的压缩。

🧮 它怎么算

价目表(官方公布值,单位:元或美元 / 百万 token)

	缓存命中(空闲/高峰)	未缓存输入(空闲/高峰)	输出(空闲/高峰)
DeepSeek-V4.1-Flash(`deepseek-flash`)	¥0.02 / ¥0.04	¥1 / ¥2	¥4 / ¥8
DeepSeek-V4-Pro-0813(`deepseek-v4-pro`)	¥0.15 / ¥0.30	¥4.5 / ¥9	¥13.5 / ¥27

模型名 → 计费归属

请求的模型名	按哪个模型计费
`deepseek-flash`	V4.1-Flash(规范名)
`deepseek-v4-flash`、`deepseek-v4-flash-vision-exp`	V4.1-Flash(旧名已下线,请求仍可用但由 V4.1-Flash 提供服务并按 Flash 计费)
`deepseek-v4-pro`	V4-Pro-0813;自北京时间 2026-09-14 12:00 起改路由到 V4.1-Flash 并按 Flash 计费
其他 provider / 模型	无公示价 → 胶囊不显示

高峰时段

⚠️ 节假日的倍率由 DeepSeek 决定,我的换算基准是 2026-09-19 的公告(空闲价 = 高峰价的一半, 高峰为 9:00–12:00、14:00–18:00)。

精度边界(重要,如实列出)

token 分档是精确的——供应商上报值,与原生用量弹窗逐位一致;金额 = 分档 token × 单价,没有二次估算。
跨高峰边界的回合按起始时刻计价(DSH 的回合用量是聚合值,不含逐次请求时间戳),面板会标注。
一个回合内混用了多个计费模型时无法把 token 拆到各模型,按其中最高价估算上界,面板会标注。
子代理、后台会话、压缩(compaction)请求不计入——它们属于各自的会话/账目,不在当前对话的回合用量里。
这是估算值,不是账单:不含四舍五入、促销、provider 侧的最终结算细节。
缓存写入:官方价目表没有独立的缓存写入档(写入按未缓存输入计费),所以不单独计价。
法定节假日日历是按年维护的数据(src/holidays.ts,目前含 2026 全年)。 DeepSeek 每年随国务院通知调整放假安排,插件没有联网取日历:到了 2027 年,若那年的节假日还没补进列表, 那些日期的工作日就会按高峰价估算 —— 也就是偏高(最多一倍),不会偏低。补数据即可修正,不用改代码逻辑。验证方式:把「余额差额」与统计页的合计对一下(见下节「与账户余额核对」)。

📊 费用统计页(设置 → 费用统计)

注册进 DSH 设置面板的 settings.section 插槽,导航位置排在「侧边卡片」之后(同一个设置面板,不是弹窗套弹窗)。

两个日历选择器(不是选项卡):
- 选择日期 → 周一开头的日历(6×7 网格、可翻月、「今天」有标记),点某一天 → 下方只显示那一天的明细;
- 选择月份 → 12 个月 + 可翻年的月份网格,点某个月 → 下方只显示那个月的明细;
- 有数据的日期/月份在网格里加点显示,没数据的日子也能点(显示空态);两者互斥,另有「清除筛选」。
费用合计卡片:标注当前范围(费用合计 · 2026-09-11 / · 2026-09 / · 全部时间), 显示 ¥ 主、$ 次,以及回复数 / 会话数 / 用量 / 子代理数 / 未计价数。
一张明细表:每条助手回复一行 —— 时间(MM-DD HH:mm)、会话(带 子代理 / 无价目 标记)、用量、费用(¥ 主 / $ 次); 悬停会话名可看到 会话 · #回合 · 计费模型。页面没有第二张汇总表,所以不存在两套口径。

数据来自哪里

统计页读的是插件自己的宿主路由 GET /cost-stats/usage。宿主半边会:

ctx.sessionPersistence.list() 枚举存储里的会话(取最近的非空会话);
逐个打开并读取完整持久化日志(open(id,'read') → handle.read());
用 src/host/turn-fold.ts 把日志折叠成逐次回复:回合窗口(turn/start/turn/end)、该次回复实际使用的 message.source.provider/model(缺失时回退到最近一条 model/selection)、以及 assistant/message(与重试的 assistant/attempt)里的分档 usage;
用与聊天胶囊完全相同的价目表与高峰窗口逐条计价,按 TTL 缓存后返回 JSON。

🔍 与账户余额核对

两条路,建议用第一条:

A. 独立复算脚本(推荐)

node scripts/verify-balance.mjs 2026-09-11T11:07 2026-09-11T12:20

开发现场实测的三个窗口(同一台机器、同一套脚本复现):

区间	余额下降	独立复算上升	结论
11:07 → 12:20	−$0.25	+$0.249	✓ 1 美分内
12:20 → 15:02	−$0.78	+$0.77	✓ 1 美分内
15:02 → 15:49	−$0.200	+$0.200	✓ 零误差

结论:插件合计与账单一致到 1 美分左右,唯一需要留意的是「仍在进行的回合」会落在窗口边界上——对账时最好等当前回合结束再比。

B. 只看界面

在设置 → 费用统计里读合计的 $(默认就是今天);或读聊天里某个回合胶囊的 $;
与 API 平台余额的变化量对比(余额以美元计,看 $ 那一栏,不要直接拿 ¥ 去比);
口径提示:余额还包含标题生成等少量调用,以及仍在进行的请求; 列表里带「压缩」标签的行就是曾经的缺口,现在已计入。想复现上面那张对账表,用 pnpm run verify:balance <时刻1> <时刻2>。

人民币与美元的官方价目表相差约 7 倍(Flash 未缓存输入:¥1 ↔ $0.15),这是官方两套公布值,不是本插件做了汇率换算。

🛠️ 开发

pnpm install
pnpm run typecheck   # tsc --noEmit
pnpm test            # 158 项:计费/时段/别名规则 + 日志折叠(含压缩、分叉继承段、会话格式 v4) + 日历 + 统计与分页 + 兜底缓存 + 余额解析/凭据读取与 describe、写入 + key 清单解析与合并 + 按 key 名的缓存隔离 + 本机守卫 + locale 取法与翻译兜底 + **真 React + jsdom 整页渲染**
pnpm run build       # lib/index.js(host 半边:路由 + 日志折叠) + lib/client.js(浏览器半边)
pnpm run smoke       # 产物契约冒烟:在 Node 里跑 client.js,验证注册 id / 插件形状 / 两个插槽 / 字典注册 / 真实算价 / 抛错隔离 / 宿主请求 / 保留 prop(ref)警察
pnpm run verify      # typecheck + test + build + smoke
pnpm run verify:balance   # 独立复算全部会话累计 ← 与 API 余额对账用
pnpm run verify:paths     # 两种折叠入口(有头部 / 无头部+切点)逐条比对 ← 防止「离线验证通过、真机重复计费」
pnpm run watch       # 开发时增量重建(配合 dsh 的 client HMR;host 改动仍需重启)

目录结构

src/
  pricing.ts              计费模型:价目表、别名与改路规则、高峰窗口、cost 计算、金额格式化(纯函数,单测覆盖)
  rows.ts                 宿主路由与统计页共享的 wire 类型(计费项行 / 载荷;`compaction: true` = 压缩行)
  balance.ts              余额与 key 清单的 wire 类型(页面只看得到数字、**key 的名字**与失败原因码,永远看不到 key 值)
  routes.ts               路由常量(两半边共用,避免字符串漂移):usage / keys / balance
  index.ts                host 半边:注册三个路由,并作为一行 live Loader row
  host/
    turn-fold.ts          纯折叠:持久化事件 → 每次回复 + 每次压缩(窗口 / 模型 / 分档 token)
    cost-stats-index.ts 索引:枚举会话 → 读日志 → 折叠 → 逐条计价 → TTL 缓存
    balance.ts            余额解析(DeepSeek 的字符串金额 → 数字)+ 仅本机请求的守卫(纯函数,单测覆盖)
    api-key.ts            **唯一接触 key 值的模块**:`resolve` 现取现用、`describe` 只问"配了没"、`set` 只在你勾选时写进 DSH 凭据库
    key-catalog.ts        key 清单:读凭据库的 `refs` 名字 + 配置里的 `apiKeyEnv`(纯解析函数,单测覆盖),再用 `describe` 补「已配置 / 未配置」
    balance-route.ts      余额路由:本机校验 → 按**名字**取凭据或用手动 key → 调用官方接口 → 只回数字与名字(15 秒缓存**按 key 名分开**,`?refresh=1` 强制)
    keys-route.ts         key 清单路由(仅本机;只回名字,不解析任何值)
    contract.ts           host 侧契约镜像(sessionPersistence / webServer / 请求头、peer 地址与请求体迭代)
  client/
    index.tsx             浏览器半边:注入样式、注册字典、注册两个插槽条目(胶囊 + 统计页)
    CostChip.tsx          费用胶囊 + 明细面板(portal + 定位 + Esc/外部点击关闭)
    StatsSection.tsx      设置页「费用统计」:标题 + 余额胶囊 + 模型行、合计卡片、逐条计费项明细表(回复 / 压缩,单一列表 + 分页)
    BalanceChip.tsx       标题右侧的余额胶囊(数字 / 查询中 / 未配置 / 失败四种状态 + 悬停明细与来源模型)
    KeyPicker.tsx         模型行:供应商下拉(显示「设置 → 模型」里的名字)+ 「查询余额」按钮 + 手动输入(密码框)与「存入 DSH 凭据库」
    locale-service.ts     locale 服务的**非严格取法** + 翻译兜底(框架回显 key 时改用自带字典,避免页面显示 `stats.xxx`)
    balance-store.ts      余额的共享缓存(**按凭据名分开**、15 秒有效期、并发合并;手动粘贴的 key 不缓存)
    key-store.ts          模型清单的缓存 + 已选凭据名(只记**名字**,存 localStorage;手动 key 从不进这里)
    Pickers.tsx           两个日历选择器(选日期 / 选月份)+ 共享的锚定浮层
    calendar.ts           纯日历数学:周一为首的 6×7 网格、跨年月份平移、月份键解析
    stats-model.ts        统计模型(纯函数):日/月键 + 合计(回复/压缩分开计数)+ 分页切片
    select.ts             从聊天快照里取回合用量/时间窗/回合号的选择器(必须返回存储引用,避免逐 chunk 重渲染)
    usage-store.ts        宿主数据的共享缓存(30 秒有效期、并发合并):胶囊兜底路径的唯一数据来源
    contract.ts           本插件读取的 DSH 浏览器契约的镜像类型(见下)
    Boundary.tsx          错误边界:让插件的渲染失败只影响自己那一块
    locales.ts            中英字典 + 内置中文兜底
    styles.ts             插件自有样式(仅消费 DSH 设计令牌)
cordis.patch.yml          bundle patch:把本包挂成 profile 的一层
tsdown.config.ts          产出 host 半边(ESM)与浏览器半边(CJS 闭包工厂)
scripts/
  install-local.mjs       本地 link 安装 + bundles 对账
  smoke-client-bundle.mjs 产物契约冒烟(无浏览器)
  verify-balance.mjs      独立复算(绕过宿主直读会话日志)← 余额对账
  verify-fold-paths.mjs   双入口一致性检查(有头部 / 无头部+切点)← 防「离线通过、真机重复计费」
docs/architecture.md      接入契约与设计取舍
docs/images/              README 里那两张效果截图(胶囊 / 统计页)

🧩 为什么不 import DSH 的内部类型?

src/client/contract.ts 里的类型是镜像声明而不是 import,这是刻意的:

DSH 的客户端内部包(@deepseek-ai/dsh-client-ui-chat 等)在 npm 上的发布版本远落后于运行中的 shell(npm 上是 0.1.2-alpha.x / 0.0.1-rc.x,而 shell 已是 0.1.5-rc.2),跟着 npm 版本写类型会描述一个并不存在的宿主;
因此本插件只依赖两样东西:冻结的平台模块表(react / react/jsx-runtime / react-dom)与插槽契约;
每个字段在运行时都做了防御性读取:DSH 版本换代删改字段时,退化为「不渲染胶囊」而不是崩溃。

契约锚点与更多设计取舍见 docs/architecture.md。

🚀 发布(维护者向)

当前通道:GitHub 即发布——别人按上面的「方式一/二」从仓库装即可,不需要你做任何事。

想把它也发到 npm(那样别人一句 dsh plugin add dsh-cost-stats 就装好了),三步:

# 1. 登录 npm（只需一次；本机默认 registry 是镜像，发布要显式指定官方源）
npm login --registry https://registry.npmjs.org

# 2. 确认包名可用（0.7.0 起用的是 dsh-cost-stats，已确认未被占用）
npm view dsh-cost-stats version --registry https://registry.npmjs.org   # 期望 404

# 3. 发布（先 pnpm run verify 全绿）
pnpm run build && pnpm publish --access public --registry https://registry.npmjs.org

发版清单:

package.json 的 name / repository / author 已填好,dsh.plugin.json 已就位
pnpm run verify 全绿(typecheck + 56 项单测 + 构建 + 21 项产物冒烟)
推送到 https://github.com/AGImentu/dsh-cost-stats(main),CI 绿
发布 npm(上面三步)
给仓库打 dsh-plugin / deepseek-harness topic,便于被发现
价目表变化时更新 src/pricing.ts 与 tests/pricing.spec.ts,并在 CHANGELOG 记录

进阶:用 GitHub Actions 的 npm Trusted Publishing(OIDC) 免 token 自动发版 (npm 包设置里绑定 Org/Repo/Workflow,再在 Release 触发)——生态里成熟插件就是这么做的。

⚠️ 已知边界

聊天面板的「本次会话」只统计已加载到聊天窗口的回合;更早的历史需要向上滚动加载后才会计入。想看全部历史,用设置 → 费用统计(它走宿主路由读持久化日志)。
统计页读取存储里最近 120 个非空会话的完整日志,按 TTL 缓存;读取失败或没有任何已计价回复的会话计入 skipped,不影响其余行。
统计页与胶囊都是按官方价目表的估算,不是账单:不含四舍五入、促销与 provider 侧最终结算细节; 标题生成等少量模型调用不在折叠范围内(实测差值 < 1 美分);上下文压缩已在 0.6.0 计入(见下一条)。
只在 DeepSeek 官方路由(provider 含 deepseek)上有价目;第三方 provider 标 无价目 且不计入合计。
分叉 / 侧边对话的日志自带父会话副本:DSH 会把父会话的事件整段复制进子会话的日志,并在嫁接处写下 session/end-seed(data.inherited: true)。插件按这个接缝跳过继承段,只统计子会话自己产生的计费项 (0.7.1 修复;此前会把父会话的历史重复算一遍,当日金额一度虚高约 60%)。因此「会话数」统计的是真正产生过计费项的会话,不是存储里的日志个数。
上下文压缩已作为独立一行计入(带「压缩」标签):它不属于任何回合,官方「用量」胶囊不显示它, 但它是真实扣费(实测一次约 $0.2)。0.6.0 之前它不在合计里,这是过去与余额对不上的唯一系统性原因。
统计页需要宿主半边加载(即需要重启过 dsh web);只刷新页面而没重启时,页面会显示"宿主侧路由不可用"。
官方核心的回合用量是「全有或全无」:回合里只要有一次重试请求没回报用量,官方「用量」胶囊就会消失。本插件此时改用宿主侧日志重算补一个数(标题会写「按日志重算」),但日志里同样缺失的那部分用量, 会让这个数字偏低——它是不显示之外的次优选择,不是等价替代。
余额是「账号级」的,不是「key 级」:官方 GET /user/balance 只回答账号还剩多少钱(实测某账号只有 CNY 币种,所以显示 ¥;若账号持有美元,会同时列出 $)。它不区分是哪把 key 花的;要按 key/按天看明细,只能登录平台网页(那是需要登录态 userToken 的私有接口,本插件不碰)。
只有 DeepSeek 官方签发的 key 查得到余额:下拉里那些中转站/第三方的 key(如 MIXTOKEN_API_KEY)拿官方 user/balance 去问会得到 401,插件会如实显示「DeepSeek 拒绝了这个 API key(HTTP 401);只有 DeepSeek 官方的 key 能查余额」,而不是显示 0 或空白。
同一账号的两把 key 查出的是同一个数(见上一条:接口是账号级的);所以下拉切 key 时看到的钱一样,不代表插件取错了 key——悬停提示里的「来源:xxx」会告诉你这次用的是哪把。
余额只有 2 位小数:所以它适合看"还剩多少、今天掉了多少",不适合看单次调用花了多少(几分钱要累积到 0.01 才可见)。余额的变化量与统计页的本机累计互为对账:差额就是别的机器/别的工具花的。
余额的缓存是双层且刻意很短:宿主 15 秒 + 页面 15 秒,而且按 key 名分开缓存(换一把 key 绝不会显示上一把的数字);点「刷新」会带 ?refresh=1 绕过两层。手动粘贴的 key 完全不缓存,点一次查一次。
手动输入的 key 默认只活在当前页面:刷新/关掉页面就没了(这是刻意的,插件不替你保管密钥)。想长期用,要么在「设置 → 模型」里正式配置,要么在输入框旁勾选「存入 DSH 凭据库」——它写进的是 DSH 的凭据文件,下一份 DSH 凭据也是读那里。
会话日志格式 v4(DSH 0.1.7 起):v4 把工具结果提升为工具角色、重命名生产者来源、补齐中断回合。实测同一会话的 v3 与 v4 两份日志,共同回合逐条数字完全一致,因此本插件不需要改折算逻辑: 宿主半边本来就走 sessionPersistence(与格式无关),两个诊断脚本也已改为读取所有代际 (session.v*.jsonl*),不会因为格式升级而只扫到旧文件。
官方「用量」胶囊在 0.1.7 起只在**「性能与用量 = 详细」**模式下显示;本插件的胶囊渲染在 extraActions(插件单元格)里,不受该模式影响——也就是说关掉详细模式后,官方胶囊会消失而本插件仍在。
极窄视口下胶囊跟随原生 stat pill 的收缩策略(本插件未额外做图标化折叠)。

📄 License

MIT

English (overview)

Install: dsh plugin --profile web add dsh-cost-stats (or node scripts/install-local.mjs from a checkout), then restart dsh web and hard-refresh the page.

AGImentu/dsh-cost-stats

dsh-cost-stats

📸 效果

✨ 功能

📦 安装

方式一:本机 tarball 安装(推荐,现在就能用,不依赖 npm 发布)

方式二:源码 link: 安装(改代码即时生效,适合调试)

方式三:从 npm 安装(包发布后可用)

方式四:交给 DSH 自己装

装完必须做的一步

🧮 它怎么算

价目表(官方公布值,单位:元 或 美元 / 百万 token)

模型名 → 计费归属

高峰时段

精度边界(重要,如实列出)

📊 费用统计页(设置 → 费用统计)

数据来自哪里

🔍 与账户余额核对

🛠️ 开发

目录结构

🧩 为什么不 import DSH 的内部类型?

🚀 发布(维护者向)

⚠️ 已知边界

📄 License

English (overview)

Community comments

AGImentu/dsh-cost-stats

dsh-cost-stats

📸 效果

✨ 功能

📦 安装

方式一:本机 tarball 安装(推荐,现在就能用,不依赖 npm 发布)

方式二:源码 link: 安装(改代码即时生效,适合调试)

方式三:从 npm 安装(包发布后可用)

方式四:交给 DSH 自己装

装完必须做的一步

🧮 它怎么算

价目表(官方公布值,单位:元 或 美元 / 百万 token)

模型名 → 计费归属

高峰时段

精度边界(重要,如实列出)

📊 费用统计页(设置 → 费用统计)

数据来自哪里

🔍 与账户余额核对

🛠️ 开发

目录结构

🧩 为什么不 import DSH 的内部类型?

🚀 发布(维护者向)

⚠️ 已知边界

📄 License

English (overview)

Community comments

方式二:源码 `link:` 安装(改代码即时生效,适合调试)

价目表(官方公布值,单位:元或美元 / 百万 token)

方式二:源码 `link:` 安装(改代码即时生效,适合调试)

价目表(官方公布值,单位:元或美元 / 百万 token)