前言¶
在 DeepSeek Harness（DSH）里跑多路由、多模型时，token 消耗往往分散在单次请求里；若还要切到单独报表或控制台核对花费，上下文会被打断。下面介绍社区插件 dsh-api-ledger（维护者 LAwLi3tCoding）：在对话内、设置页、Composer 下方和侧栏汇总用量，并按路由/模型做可解释的估价，支持 CNY/USD 展示切换。
这是什么¶
dsh-api-ledger 的定位是：为 DSH 记录 API token 用量，并给出估算费用（非发票、非账户余额）。数据与偏好在插件本地处理；README 明确说明不读取 API Key 明文、也不把账本上传到插件自有服务。
- 仓库：LAwLi3tCoding/dsh-api-ledger
- 社区目录：SkillHub 插件页
- 分类：admin-security
- 当前 package 版本：0.4.0（MIT 许可证）
- 环境要求：Node.js 20+；README 注明在 DSH Desktop 2.0.13 / bundled DSH 0.1.5-rc.2 上测试，无构建步骤、无运行时 npm 依赖
四个视图分别回答什么¶
| 视图 | 作用 |
|---|---|
| 对话 → API Ledger | 本会话花了多少：近期调用、模型费用、token 构成与趋势 |
| Settings → API Ledger | 跨会话支出分布：日期范围、今昨对比、定价偏好 |
| Composer 下方 | 当前会话累计用量/花费 |
| 侧栏页脚 | 今日一行汇总；点击可进入设置页完整报表 |
CNY/USD 为展示换算（固定 1 CNY = 0.14 USD），不是实时汇率。调用在结束时写入 usage；可见视图约每 10 秒刷新；「今日」按客户端日历。
定价与路由¶
定价按路由（account）+ 模型分开配置，同一模型在不同路由可以不同价，避免官方端点与网关互相污染估算。
- 路由默认分开统计；可为多条路由设置相同 billing group 合并报表。共享 Key 引用不会静默合并账户或暗示共享余额。
- 每条路由可为多个模型分别定价；未配置时默认 Usage only（只记 token，不虚构费用）。
- 三种模式（Settings → API Ledger → Accounts and pricing）：
- Price-book estimate：绑定价目表（含可选峰谷时段；按价目表时区在请求开始时判断）。
- Custom price estimate：按百万 token 设 uncached input、output、cache read、cache write；货币与单价可设，0 合法。
- Usage only：仅记录用量。
内置价目表 deepseek-public-2026（README 标注 verified 2026-09-21）覆盖 deepseek-flash、deepseek-v4-flash、deepseek-v4-flash-vision-exp、deepseek-v4-pro，含上海时区峰谷与 2026 节假日规则；任意账户都可绑定，官方 DeepSeek 端点仅是在识别为官方 URL 时默认绑定。价目随插件发布更新，无 live pricing API。
高级用户可在 $DSH_HOME/api-ledger/config.json 的 tariffs 段添加自定义价目（UI 暂无编辑器），例如：
"tariffs": {
"acme-gateway": {
"label": "ACME gateway", "currency": "CNY", "timeZone": "Asia/Shanghai",
"verifiedAt": "2026-10-01", "source": "https://intranet.example/pricing",
"peak": { "days": "mon-fri", "windows": ["09:00-12:00"], "multiplier": 1.5 },
"holidays": { "2026": [["01-01", "01-03"]] },
"models": { "deepseek-v4-pro": { "inputPerM": 4, "outputPerM": 12, "cacheReadPerM": 0.4 } }
}
}
绑定示例：
"pricing": { "corporate-gateway/deepseek-v4-pro": { "mode": "tariff", "tariff": "deepseek-public-2026", "window": "auto" } }
历史调用保留当时使用的费率；改价只影响后续请求。未知价格保持「未计价」，不会显示为 0 元。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议阅读仓库源码与 MIT 许可证。SkillHub 为社区目录站点，与 DeepSeek / 幻方无官方从属关系。
DSH Desktop（GitHub 安装）¶
README 给出的步骤如下。安装会链接到克隆目录，需保留该目录；更新用 git pull 后重启。
git clone https://github.com/LAwLi3tCoding/dsh-api-ledger.git
cd dsh-api-ledger
node scripts/install.mjs
重启 DSH Desktop 后，打开 Settings → API Ledger，或在对话中的 API Ledger 标签页使用。卸载链接安装：
node scripts/install.mjs --uninstall
DSH CLI（profile 管理）¶
将 web 换成你实际管理的 profile。DSH 0.1.5-rc.2 保留 desktop 给 Electron，dsh plugin --profile desktop add ... 会被拒绝；Desktop 请用上节方式或等 marketplace 上架。
# From GitHub
dsh plugin --profile web add github:LAwLi3tCoding/dsh-api-ledger
# From npm
dsh plugin --profile web add dsh-api-ledger
典型用法¶
- 完成安装并重启 DSH。
- 在 Settings → API Ledger → Accounts and pricing 为各路由/模型选择价目表或自定义单价，Save route 保存。
- 正常对话发请求；在 Composer 下看会话累计，侧栏看今日一行。
- 打开对话内 API Ledger 查看本会话明细；在设置页 API Ledger 做跨会话对比与货币展示切换。
近期调用会标明定价来源，便于核对估算依据。
适用场景与注意¶
适合：需要在 DSH 工作流内持续看到 token 与估算成本、多路由/多网关分别计价、希望 CNY/USD 统一展示的开发者或团队。
务必知晓：
- 数字是估算，不是服务商账单、剩余额度或订阅费；部分计价时合计只含已知项。
- 展示汇率固定，不代表实际结算币种。
- Reset/delete 仅清除该路由的 ledger 偏好，不删 DSH 模型设置或历史调用记录。
结尾¶
dsh-api-ledger 把用量捕获和偏好留在本地插件里，用四个入口把「这场对话、这个会话、今天、全局」串起来，并按路由/模型让估价可解释。更多细节见仓库 README 与 README.zh.md；安装与分类信息也可在 SkillHub 目录页 查阅。
