MIT 协议、本地优先的 token/成本分析看板，原生读取 DeepSeek Harness 会话数据，提供热力图、成本追踪与配额监控。
DSH 适配
兼容
作者声明
安全审计
未审计
最后核验
2026-08-29
许可证
MIT
01它能帮你完成什么？
在一个本地看板中跟踪并分析各 AI 编码工具的 token 用量与成本
本地 Web 看板中的热力图、精确 token 拆分、成本统计与配额重置倒计时，以及可选的菜单栏伴侣应用
运行 DeepSeek Harness、Claude Code、Codex、Kimi 等 Agent、希望本地掌握 token 与成本花费的开发者和团队
监控订阅配额窗口与重置倒计时
配额标签页中的订阅窗口条与重置计时器，数据来自本地日志或 opt-in 实时轮询
使用按量或订阅套餐（Codex、Claude Code、Antigravity）并需要避免触达配额上限的用户
02如何接入 DeepSeek Harness？
前置条件
- Python **3.10+**
- One or more [supported clients](docs/reference/SUPPORTED_CLIENTS.md) installed
安装步骤
- 01
pipx install tokdash
- 02
python3 -m pip install --user tokdash
- 03
tokdash setup
- 04
tokdash setup --auto --json
- 05
tokdash setup --dry-run
验证接入成功
- tokdash doctor
- tokdash doctor --json
回滚
- tokdash uninstall
03DSH 适配与能力边界
从 $DSH_HOME/sessions 本地读取 DeepSeek Harness（dsh）会话，无需 API Key，仅限本机访问，兼容 DSH 数据布局
精确 token 计数
Agent 会话日志（本地文件）→Input / Output / Cache token 拆分
贡献日历
历史用量记录→以 Tokens / Cost / Messages 为指标的 2D 热力图 + 3D 等距视图
配额标签页
本地会话日志或 opt-in 实时配额轮询→Codex、Claude Code、Antigravity 的订阅窗口条与重置倒计时
开启的实时轮询会使用本地 CLI 凭据调用各服务商自己的配额接口状态栏集成
本地 HTTP 接口（Tokdash API）→Claude Code 状态栏或任意可访问本地接口的 Agent 的实时 token 用量指示
伴侣状态栏应用
已配置的 Tokdash 端点→在 macOS 菜单栏或 Windows 通知区显示花费与订阅配额
伴侣应用只连接你配置的 Tokdash 端点
04适合谁？何时不该用？
适合
- 运行 DeepSeek Harness、Claude Code、Codex、Kimi 等 Agent、希望本地掌握 token 与成本花费的开发者和团队
- 使用按量或订阅套餐（Codex、Claude Code、Antigravity）并需要避免触达配额上限的用户
不适合
- 可选的配额轮询仅使用你本地的 CLI 凭据调用服务商自己的配额接口，并将响应存入本地 usage SQLite 数据库；默认关闭，且需要逐服务商授权。
05兼容性、维护与安全提示
- Tokdash 默认仅绑定回环地址（loopback）；看板与本地 API 均为只读且仅限 localhost，Tokdash 未运行时会静默失败。
- 可选的配额轮询仅使用你本地的 CLI 凭据调用服务商自己的配额接口，并将响应存入本地 usage SQLite 数据库；默认关闭，且需要逐服务商授权。
- 成本默认按内置定价库计算，可能滞后于服务商实际价格；请视作估算，重要时以账单为准核对。
- 支持 macOS；Windows 原生支持尚处于实验阶段。
MIT · 活跃维护中（最新发布 v2.4.0，2026-08-28）
06常见问题
Tokdash 如何接入 DeepSeek Harness？
它从本地的 $DSH_HOME/sessions（默认 ~/.dsh）直接读取 DSH 会话，无需 API Key 或联网。每个 zstd 日志帧都会被解码，并跳过分叉会话的继承前缀，避免 token 重复计费。
Tokdash 需要联网吗？
不需要。默认全部在 localhost 运行，只读本地日志文件。只有在你主动开启实时配额轮询时才会联网，且仅使用你已有的 CLI 凭据调用各服务商的配额接口。
如何安装并验证 Tokdash？
用 `pipx install tokdash`（或 `python3 -m pip install --user tokdash`）安装，运行 `tokdash setup` 引导，再用 `tokdash doctor` 确认运行时、服务、端口与数据路径。
成本数字准确吗？
token 计数来自各客户端本地日志；成本按内置定价库计算，可能滞后于服务商实际价格。请将其视作估算，重要时以账单为准核对。
如何卸载 Tokdash？
运行 `tokdash uninstall` 可精确撤销 setup 所创建的内容，默认保留用量历史；加 `--purge` 可一并清除历史。
07相关的 DSH 工作流
dsh-cost-meter
作者 han-1413141
DeepSeek Harness 会话与当日 API 费用、预算与官方余额统计插件：历史看板、峰谷计价与官方价格一键同步。
dsh-usage-stats
作者 ychris12138
为 DeepSeek Harness Web GUI 提供提供方余额、订阅额度与 Token 用量分析。
dsh-balance-meter
作者 ghost011118
在 DSH Web 输入框下方实时显示 DeepSeek 账户余额与本场会话花费，自动抓取官方价格并支持峰谷计价。
dsh-plugin-langfuse
作者 linyp
Langfuse 可观测性插件：以 OpenTelemetry 追踪树导出会话至 Langfuse OTLP 端点
08数据与来源
DeepSeek Harness (`dsh`) usage and sessions are read locally from `$DSH_HOME/sessions/*/*/session.jsonl.zstd` (or the un…
| DeepSeek Harness | ✅ | ✅ |
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-29。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。