前言¶
在 DSH 环境中，多供应商、多模型的调用会产生分散的 token 用量、延迟、费用和额度信息。DSH 的插件化方式允许把这类监控挂入 web profile。dsh-spend 是面向 DeepSeek Harness 的 Token usage & cost monitor：在 web UI 中提供悬浮窗口、多维统计、时间序列图表、自动识别的 Code/Token 计费计划和预计花费。仓库由 nonewind 维护，许可证为 MIT。资料中未确认目录页 URL，也不宜把它当作官方应用商店入口。
这是什么¶
dsh-spend 是一个 DSH web 插件，核心用途是把 $DSH_HOME/sessions 下的会话日志回放为用量与费用视图。它主要回答三类问题：近期用了多少 token；不同 provider、model、目录、会话分别对应多少费用；Code 计划额度或 Token 计划余额处于什么状态。计费计划会自动识别，显式 plans/pricing 配置可以覆盖自动识别。
核心功能¶
- 三级交互：悬浮胶囊常驻、hover 摘要预览、点击展开四标签页详情面板。
- 多维统计：按提供商、模型、小时、天、会话、工作目录、最近调用，含 TTFT、生成速度。
- 时间序列图表：今日逐小时、24h/72h/7d 时间曲线、52 周活跃热力图。
- 计费计划自动识别：内置 17 供应商 / 131 模型价格，自动区分 Code 与 Token。
- 实时额度 / 余额直读：9 家订阅商适配器，失败安全回退。
- DeepSeek 峰谷计价：按调用时刻自动按高峰/空闲价计费。
$ / ¥货币切换：实时汇率，失败回退usdCnyRate默认 7.2。- 工作区筛选：按项目限定统计口径，支持逐级下钻子目录。
- 数据导出：CSV / JSON / 调用明细 CSV。
- 自动刷新：默认 30s，面板内可手动刷新。
安装与启用¶
安装到 web profile。以下命令来自已核实资料：
dsh plugin --profile web add github:nonewind/dsh-spend
安装后验证组合配置中是否出现 usage-stats：
dsh --profile web --dump-config | grep usage-stats
插件需要重启 dsh web 加载，HMR 对插件不生效：
dsh web
典型用法¶
先看悬浮胶囊。它在 web UI 中常驻显示摘要信息；hover 可查看预览；点击进入四标签页详情面板。面板内可使用工作区筛选，把统计限定到某个项目或子目录；也可切换 $ / ¥ 显示。
如果需要直读 DeepSeek 或 Moonshot 的余额/额度，可配置凭据缝或环境变量，例如：
DEEPSEEK_API_KEY
MOONSHOT_API_KEY
凭据以只读方式复用本机登录态与凭据缝；接口失败时安全回退，不崩溃。OpenAI Codex、Claude Code、GitHub Copilot 需要本机登录态或 token，未登录时回退本地配额。
如需覆盖默认配置，在 ~/.dsh/profiles/web/cordis.patch.yml 中加入同 id（usage-stats）的 insert 行。资料中的完整配置项未确认，具体配置以仓库 README 为准。
适用场景与注意¶
适合在 DSH web 环境中运行多个模型、多个项目，需要核对 token 用量、费用、额度与延迟指标的开发者。插件会读取 $DSH_HOME/sessions 下所有会话的持久化日志；实时额度/余额适配器涉及非公开/逆向接口（chatgpt.com、api.anthropic.com、api.github.com 等），随时可能变化，失败不崩溃。
插件以当前 dsh 进程权限运行。安装前应检查源码、依赖与许可证；本资料确认的许可证为 MIT。
结尾¶
dsh-spend 把 token 用量、多维统计、时间序列、预计费用和订阅额度集中到 DSH web UI 中。GitHub 仓库：https://github.com/nonewind/dsh-spend。目录页 URL 未在本次核实资料中确认。
