前言¶

DSH 的理念是「一切皆插件」。在 DeepSeek Harness Web profile 中，用量信息分散在 provider dispatch、重试、缓存 token 和 session 历史里；如果希望重启后仍能查看，并按提供方、模型和时间范围筛选，下面介绍一个社区仓库：xie-tj/dsh-token-usage-ledger。

社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，本文不把它描述为官方应用商店。

这是什么¶

xie-tj/dsh-token-usage-ledger 为 DeepSeek Harness Web profile 提供持久化用量账本和可视化 Usage 仪表盘。仓库 owner 为 xie-tj；资料未单独标注“维护者”字段，因此本文只按仓库名和安装命令描述。

许可证为 MIT。

它解决的事情包括：

• 记录每次 provider dispatch，包括失败与重试，并保存输入、输出和缓存 token。
• 使用 session 历史回填数据。
• 在 Settings → Usage 中按提供方、模型和时间范围查看用量。
• 提供独立持久化账本：重启后保留历史，并对已有 session 执行 best-effort 回填。

核心功能¶

下面列出已核实能力。

记录与回填¶

• 记录每次 provider dispatch，包括失败与重试。
• 保存输入、输出和缓存 token。
• 使用 session 历史回填数据。
• 独立持久化账本：重启后保留历史，并对已有 session 执行 best-effort 回填。

展示与筛选¶

• 在 Settings → Usage 中查看用量。
• 支持提供方、模型和最近 7 天／30 天筛选。
• 曲线、柱状图和 API 请求次数保留精确值。
• 模型明细使用 K/M/B/T 紧凑单位。
• Token 流量图表的悬停提示显示当日输入、输出、缓存和总计。
• 单独展示缓存命中 token，并保留失败、未计量和重试请求。

数据与接口¶

• 打开版本为 2 的 usage_ledger storage domain。
• 提供 Remote 方法 usageLedgerPlugin/snapshot，返回 events、models 和 daily。

安装与启用¶

先安装到 Web profile，再启动 Web profile。已核实资料给出的命令如下：

dsh plugin --profile web add github:xie-tj/dsh-token-usage-ledger
dsh --profile web

安装后打开 Settings → Usage 查看用量。

生产环境应将 Git spec 固定到 commit SHA。例如：

dsh plugin --profile web add github:xie-tj/dsh-token-usage-ledger#<commit-sha>

当前版本按 @deepseek-ai/dsh 0.1.0-rc.8 依赖线构建，要求 Node.js ^22.19.0 || >=24.0.0。

典型用法¶

查看用量¶

1、安装到 Web profile：

dsh plugin --profile web add github:xie-tj/dsh-token-usage-ledger

2、启动 Web profile：

dsh --profile web

3、打开 Settings → Usage。

4、使用提供方、模型和最近 7 天／30 天筛选。

卸载¶

dsh plugin --profile web remove dsh-plugin-usage-ledger

卸载不会删除 usage_ledger storage domain 中的已有数据。

从源码构建¶

pnpm install
pnpm run build

提交前验证：

pnpm run typecheck
pnpm run build
pnpm run test
pnpm run pack:check

运行依赖与限制¶

Host 依赖¶

Host 插件硬依赖以下服务：

• storageDomain：打开版本为 2 的 usage_ledger storage domain。
• sessions。
• sessionPersistence。

可选依赖：

• settings。

cordis.patch.yml 不会安装 storage-domain backend、session persistence provider，也不会为自定义 profile 增加服务路由。持久化能力取决于 profile 为 storageDomain 配置的 backend。

数据边界¶

• 账本为 best-effort 派生数据，不是请求事务的一部分。
• 插件不估算 token，不计算费用、折扣、缓存价格或配额影响。
• 页面合并展示 cache read/write，未分别绘图；也不显示价格或金额。
• 持久化保留、清理、导出和迁移工具未实现。
• 回归测试不替代真实 Web profile 启动测试。

当前限制¶

• Web 尚无 workspace 选择器。
• Legacy session 可能显示 unknown route。
• 插件设置卡当前只读，没有运行时配置项。

适用场景与注意¶

适合在 DSH Web profile 中查看持久化用量、缓存 token、失败与重试请求，并按提供方和模型筛选的人。

注意以下几点：

• 插件会作为 DSH 插件代码加载进 Web profile，运行权限等同于当前 dsh 进程；安装前应检查源码与许可证。
• 许可证为 MIT。
• 生产环境应将 Git spec 固定到 commit SHA。
• 卸载不会删除 usage_ledger storage domain 中的已有数据。
• 插件不计算费用、折扣、缓存价格或配额影响。

结尾¶

这个仓库的价值，是把用量数据落到独立 usage_ledger storage domain，并在 Settings → Usage 中提供按提供方、模型和时间范围查看的可视化界面。

目录页链接未在已核实资料中出现，本文不列具体地址。

GitHub：https://github.com/xie-tj/dsh-token-usage-ledger