前言¶
DeepSeek Harness (DSH) 的插件生态旨在解决特定场景下的开发与运维问题。在团队协作或共享环境中，追踪 DeepSeek 的实际消耗和成本往往依赖于 API 调用或手动统计，不够直观。该插件通过读取本地日志来计算使用量，从而回答“这台机器消耗了什么”和“公司预算还剩多少”这两个问题。
插件定位¶
dsh-deepseek-budget 是一个 DeepSeek 花费计量器。它从本地 session 日志中读取 token 使用情况，按 DeepSeek 列表价格进行计费，不直接调用 API，因此可以使用共享 API 密钥。
核心能力¶
本地日志解析与内容发现¶
插件从本地日志（./.l）读取使用情况，无需 API 密钥。它通过内容发现检测本机上的所有 harness，不仅包含 DSH，还包括其他工具（如 Pi、Claude Code 等）的 DeepSeek 调用。DSH 使用专用适配器处理其 zstd 压缩日志，其他 harness 通过通用记录读取器解析。
重复记录处理¶
同一次调用可能被记录多次（如子代理转录和父会话日志）。插件基于 DeepSeek 的响应 ID 或指纹（时间、路由、token 数）全局折叠重复记录。例如，在测试机器上，这删除了 593 条记录，避免了因重复记录导致的 72% 支出高估。
定价与计费¶
插件使用 DeepSeek 的列表价格计算成本，而非发票金额。支持缓存命中/未命中统计，以及高峰和非高峰定价（UTC 时间）。
* 高峰时段：UTC 01:00-04:00 和 06:00-10:00，周一至周五（排除中国公共假期）。
* 缓存写入：按未命中费率计费。
* 支持模型：deepseek-flash、deepseek-v4-pro 等。
公司账户预算¶
本地日志只能描述本机。要查看公司账户的整体进度，需要配置 DEEPSEEK_USER_TOKEN（平台要求）。提供 GET /deepseek-budget/account API 获取账户余额、当月支出和预算进度。
安装与启用¶
将插件链接到 web profile：
dsh plugin --profile web add link:$(pwd)
安装后重启 DSH。
典型用法¶
- 查看仪表盘：在 DSH 设置中进入 DeepSeek Budget 页面，查看预算表、窗口选择器（Today/7 days/30 days/All）、按模型/按天成本等。
- 本地报告：使用
GET /deepseek-budget/report?window=all获取本地使用情况的 JSON。 - 设置预算：设置环境变量
DEEPSEEK_BUDGET_EUR（默认 50）。 - 公司账户：设置环境变量
DEEPSEEK_USER_TOKEN以查看公司账户支出。
适用场景与注意¶
- 仅限本机：插件以当前 DSH 进程权限运行，仅能统计本地日志中的调用。无法看到数据库日志或未记录的调用，也无法看到其他机器的消耗。
- 权限要求：公司账户部分需要
DEEPSEEK_USER_TOKEN，该 token 仅账户所有者可获取。 - 配置灵活性：支持通过
DEEPSEEK_BUDGET_ROOTS或DEEPSEEK_BUDGET_HOME自定义日志根目录。
