MIT 开源的 DSH 插件，把经过 `llm/stream` 的调用记成本地计费账本，提供按平台 / 模型明细、峰谷价、人工导入价格、官方账单对齐与 HTML / PDF / CSV 导出。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-13
许可证
MIT
01它能帮你完成什么？
看清 DeepSeek Harness 的模型调用到底花了多少钱，按平台、按模型
侧栏面板里的调用次数、失败与中止次数、输入 / 输出 / 缓存命中 token 与花费，并可从某一天下钻到小时桶
在 DSH 里同时跑多个 provider 或中转平台、需要知道钱花在哪的开发者
把本地账本和平台账单对上
按平台 / 日期把官方金额（可选再抄调用次数与 token）与插件当天记录逐项对比，并显示差额
结账前需要解释或核对平台账单的人
把花费报表交给不跑 DSH 的人
按平台 / 模型分组、带时间明细的自包含 HTML 报表或 PDF 文档，或给表格用的 CSV
需要一份文件而不是实时面板的团队负责人、财务与客户
02如何接入 DeepSeek Harness？
前置条件
- DSH Web UI 版本在 `>=0.2.1-rc.5 <0.3.0`，Node.js `>=20` —— README 已在 Windows 11 + DSH `0.2.1-rc.5`、`0.2.2-rc.1` 实机验证
- 一个你能改 package.json 的 DSH profile（README 用 `link:` 形式登记依赖）
- `pdfkit` 已列在 dependencies、安装时自动装；`@deepseek-ai/schemastery` 是可选 peer
安装步骤
- 01
把插件目录放进你的工作区
- 02
在 profile 的 package.json 里把它登记为依赖 —— `link:` 形式即可
- 03
重启应用，侧栏出现「计费统计」入口
- 04
从 1.12.x 升级：先在 Plugin Manager 卸载旧 bundle（旧名 `dsh-billing-insights`，更早是 `llm-usage-insights`），避免两个 bundle 同时注册同一个侧栏页面
验证接入成功
- 重启后侧栏出现计费统计入口，页面按平台 / 模型列出调用记录
回滚
- README 没有给出卸载命令：它只说明卸载不会自动删除账本，想清掉数据需要手动删除 `$DSH_HOME/llm-usage-insights/` 目录
03DSH 适配与能力边界
DSH 插件 bundle：在工作区放好目录、在 profile 的 package.json 里以 `link:` 登记为依赖后重启，侧栏出现「计费统计」入口，页面读取 DSH `llm/stream` 的使用记录
按平台 / 模型的用量明细
DSH `llm/stream` 记录下来的调用→每个平台与模型的调用、失败与中止次数、输入 / 输出 / 缓存命中 token 与花费，每天下面还有小时桶
把计数、token 与价格来源追加写入 `$DSH_HOME/llm-usage-insights/` 的 `usage.json`峰谷价与阶梯计价
token 数量加一张价格表→按峰时窗口（默认北京时间，可用 `utcOffsetHours` 调整）与阶梯价算出的花费，金额记到 6 位小数
每行都标出价格来源，估算价不会被显示成官方价人工导入价格（表格或 CSV 模板）
在平台行弹窗里填的单价，或填好的 CSV 模板→持久保存的人工价，可带 `09:00-12:00, 14:00-18:00` 这类峰时窗口，按每天 / 工作日 / 周末生效
人工价不会被后续目录刷新覆盖DeepSeek 官方价要显式保存后才会变成人工覆盖官方账单对齐
从平台后台按平台与日期抄来的金额（可选再带调用次数与 token）→与插件当天记录逐项对比并显示差额
插件不登录也不抓取平台后台 —— 数字由你自己粘贴报表导出（HTML / PDF / CSV）
选好的统计范围与是否包含时间明细→自包含 HTML 报表、PDF 文档或 CSV
PDF 导出依赖 `pdfkit` 与本机中文字体，缺字体时直接报错而不是生成乱码报表
04适合谁？何时不该用？
适合
- 在 DSH 里同时跑多个 provider 或中转平台、需要知道钱花在哪的开发者
- 结账前需要解释或核对平台账单的人
- 需要一份文件而不是实时面板的团队负责人、财务与客户
不适合
- 只记录经过 DSH `llm/stream` 的调用——DSH 没运行时发出的请求、直连 API、其他客户端的请求都不在账本里，所以数字是按 DSH 口径统计，而不是按账号。
- 金额是按 models.dev、DeepSeek 官方价或你导入的人工价估算出来的；结算以官方账单为准，账单对齐只是把官方数字和本地观测放在一起。
- 数据只在本机 `$DSH_HOME/llm-usage-insights/` 下，没有云同步或多机合并；按小时明细 30 天后被裁剪（`retainDays` 可调），月度汇总长期保留，卸载不会删除这个目录。
05兼容性、维护与安全提示
- 只记录经过 DSH `llm/stream` 的调用——DSH 没运行时发出的请求、直连 API、其他客户端的请求都不在账本里，所以数字是按 DSH 口径统计，而不是按账号。
- 金额是按 models.dev、DeepSeek 官方价或你导入的人工价估算出来的；结算以官方账单为准，账单对齐只是把官方数字和本地观测放在一起。
- 数据只在本机 `$DSH_HOME/llm-usage-insights/` 下，没有云同步或多机合并；按小时明细 30 天后被裁剪（`retainDays` 可调），月度汇总长期保留，卸载不会删除这个目录。
- 面向 `>=0.2.1-rc.5 <0.3.0` 的 DSH Web UI 与 Node.js `>=20`；页面路由只接受同源 / 环回地址访问，PDF 导出在没有中文字体时会直接失败。
MIT · 仅 README 证据，最新版本 v1.14.0，未做安全审计
06常见问题
在 DeepSeek Harness 里怎么装这个插件？
把目录放进工作区，在 profile 的 package.json 里以 `link:` 形式登记为依赖，然后重启应用，侧栏就会出现计费统计入口。README 面向 `>=0.2.1-rc.5 <0.3.0` 的 DSH Web UI 与 Node.js `>=20`。从 1.12.x 升级时先卸载旧的 `dsh-billing-insights` bundle，避免两个 bundle 注册同一个侧栏页面。
它会往 DSH 工作区写什么，会保存我的提示词吗？
写在 `$DSH_HOME/llm-usage-insights/` 下：`usage.json` 只有计数、token 与价格来源，`manual-prices.json` 只存你导入的价格表，models.dev 目录缓存在旁边。README 明确不保存任何 prompt / 回复内容。没有云同步，卸载也不会删除这个目录。
它会拦截或限制 DeepSeek Harness 的调用吗？
不会。它不接管模型请求，只记录已经经过 DSH `llm/stream` 的调用；也没有日 / 月预算、超额阻断、余额查询或自动充值，只做统计和展示。
models.dev 里没有的平台怎么定价？
价格匹配顺序是自定义 `pricing` → 人工导入价格 → DeepSeek 官方自动价（仅官方 API）→ models.dev 目录 → 内置参考价，页面上会标出用的是哪一种。按调用次数收费的中转站可以在弹窗里勾选纯按次计费，此时 token 单价与峰时价都不参与计算；`chargeFailedCalls` 决定失败 / 中断的请求是否也收一次费。
PDF 导出为什么失败？
PDF 导出依赖 `pdfkit` 与本机中文字体，找不到可用字体时会直接报错，而不会静默生成乱码报表。可以改用自包含 HTML 报表，或在机器上装好中文字体。
07相关的 DSH 工作流
weknora
作者 tencent
开源的 LLM 知识库平台：把原始文档转化为可检索的 RAG 知识库、自主推理智能体和自动维护的 Wiki 系统，支持多租户部署。
honcho
作者 plastic-labs
用于构建有状态 AI 智能体的记忆库，支持跨会话连续学习与上下文工程。
webnovel-writer
作者 lingfengqaq
基于 Claude Code 的长篇网文辅助创作系统，解决 AI 写作中的「遗忘」和「幻觉」问题，支持 200 万字量级 连载创作。
reme
作者 agentscope-ai
ReMe：面向 AI Agent 的记忆管理套件——帮 Agent「记住我、优化我」，支持 RAG 与长期记忆。
08数据与来源
`dsh-billing-statistics` 是 DSH 的本地计费账本：把经过 `llm/stream` 的模型调用按平台、模型和小时记下来，用价格表估算花费，并提供报表与官方账单对照。它不接管模型请求，也不替你登录任何平台。
- 按 **平台 / 模型** 汇总调用次数、失败与中止次数、输入 / 输出 / 缓存命中 token、花费。
# 1. 把本目录放到工作区 # 2. 在 profile 的 package.json 里登记为依赖（link: 形式即可） # 3. 重启应用，在侧栏看到「计费统计」入口
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-11-13。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。