dsh-deepseek-budget

团队共用 DeepSeek API 密钥时，账单往往只出现在控制台，而真实消耗却分散在本机 Cursor、DSH、Pi 等各个编码 Harness 的会话日志里。只看单一工具会严重低估开销；README 中的例子表明，忽略子代理转录等日志时，统计可能只有实际花费的不到三分之一。dsh-deepseek-budget 把「这台机器到底用了多少」和「公司预算还剩多少」放在同一块视图里，用提供商回传的 Token 数字按 DeepSeek 刊例价折算，本地侧不调用 DeepSeek API、也不保存 API 密钥，因此适合共享密钥、又不愿把平台登录交给每个人的环境。

插件会统计本机上所有能发现的 Harness，而不只是 DSH：DSH 有专用适配器处理 zstd 压缩日志，其余工具通过在家目录扫描含 deepseek 字样的 json/jsonl，并用通用解析器识别带 Token 用量的 DeepSeek 路由记录；未预料到的新工具只要日志形态符合常见字段，也会被纳入。重复写入父子会话的同一笔调用会按 response id 或时间、路由与 Token 指纹去重，避免虚高。计量涵盖缓存命中/未命中输入、输出与推理 Token、刊例价成本，以及 DSH 日志中的首 Token 延迟与输出速度；成本以官方刊例为准，Harness 自记金额仅作对照。

在 DSH Web 的「Settings → DeepSeek Budget」可查看预算仪表、时间窗口、按模型/按日成本、缓存命中率与速度；Agent 可用 deepseek_usage 工具自述消耗，本机还提供仅 loopback 的 JSON 报告接口。若配置 DEEPSEEK_USER_TOKEN，面板会单独展示公司账户余额、本月全账户消耗与预算进度；未配置时说明原因而非猜测。适合需要把控本机多工具 DeepSeek 开销的开发者，以及要为团队设定预算上限、又希望本地日志与账户视角能对上的管理员。

可通过环境变量设置预算金额与汇率、自定义扫描根目录，且不强依赖 DSH 是否曾在本机运行；无法覆盖仅存数据库的用量、完全没有本地日志的调用，或其他同事机器上的消耗——后一类需依赖已配置的用户令牌下的账户视图。