前言¶
DeepSeek Harness（DSH）是一个客户端框架。在本地使用时，追踪每次对话和上下文压缩的具体费用需要手动计算或依赖第三方工具。dsh-cost-stats 插件直接利用 DSH 内部路由，在消息旁显示费用胶囊，并在设置页提供详细的费用统计流水。
核心功能¶
- 消息旁的费用胶囊：在每条助手消息旁显示费用胶囊（¥/$）。
- 分档明细：点击胶囊可查看分档明细，包括模型、时段、缓存命中率、Token 数量与单价。
- 会话累计：显示本次会话的累计费用。
- 设置页「费用统计」：列出每次计费项（回复 + 上下文压缩），支持日期/月份筛选和分页。
- 数据来源：与官方「用量」弹窗同源，使用供应商上报的 token 分档。
- 官方价目表：使用官方公布的 CNY/USD 价目表，包含旧模型名的计费归属。
- 时段感知：支持高峰/空闲时段感知。
- 模型筛选：支持按模型筛选计费项。
- 余额查询：支持查询余额功能。
- 隐私与安全：不读任何凭据、不访问外网（余额查询除外）、不改 DSH 内核。
- 多语言：支持中英双语。
安装与启用¶
安装：
dsh plugin --profile web add dsh-cost-stats@latest
启用：
1. 重启 dsh web。
2. 在浏览器中硬刷新页面（Ctrl/Cmd + Shift + R）。
支持的 DSH 版本：
0.1.5-rc.2 / 0.1.7-rc.2 / 0.2.0-rc.2
注意事项¶
- 数据缺失处理：如果该回合无官方价目或拿不到路由归属，胶囊不显示。如果官方数据缺失（重试失败），使用宿主侧日志重算，并标注「按日志重算」。
- 密钥安全：Key 只在本机宿主侧使用，不保存、不进文件、不进仓库。唯一的外网请求是余额查询。
- 更新与重启：更改代码后，客户端改动需硬刷新，宿主改动需重启
dsh web。 - 包名识别：npm 上有同名老包
dsh-session-cost，需认准dsh-cost-stats。
