前言¶
在 DeepSeek Harness（DSH）里切换模型、跑长会话时，用量和费用往往分散在各家控制台或零散插件里。想确认「今天花了多少 Token」「本月预算还剩多少」「GLM / Kimi 订阅窗口还剩几成」，通常要另开页面或手工对账。
下面介绍社区插件 dsh-token-dash（维护者 spartawhy117），在 DSH 输入框旁和整页看板里汇总按量余额、月度预算与订阅配额，并在本地估算费用与真实 Tokens，支持导出 / 导入当月账本备份。插件分类为 admin-security，当前 npm 包版本 1.3.0，许可证 MIT。
这是什么¶
dsh-token-dash 是 DSH 的 Web 客户端插件：读本地会话 usage 做记账，凭宿主 credentials 拉取余额与配额，费用与 Tokens 按内置价格表在本地估算，不发起计费请求。三个入口共用同一份本地账本：底栏 Pill（当前模型）、浮层（预算 / 余额 / 用量表）、整页看板（7 家供应商卡片与模型明细）。
目录页：skillhub.cn/plugins/spartawhy117/dsh-token-dash
源码与说明：github.com/spartawhy117/dsh-token-dash
支持的供应商与凭据¶
在 DSH 凭据设置中按下列名称保存 Key；插件只通过宿主 credentials 读取，不读环境变量或本机登录文件。填 Key 后自动探测计费形态（订阅 / 按量）；GLM、Kimi、OpenCode Go、Command Code 可在整页看板底部重新检测订阅。
| 供应商 | 计费形态 | 凭据 | 能看到什么 |
|---|---|---|---|
| DeepSeek | 按量 | DS 账号钱包 / DEEPSEEK_API_KEY |
账户余额、本月已花、预算 |
| 智谱 GLM Coding | 订阅 / 按量 | ZHIPU_API_KEY / GLM_API_KEY / ZAI_API_KEY |
5h + 周窗口 |
| Kimi Coding | 订阅 / 按量 | KIMI_API_KEY / KIMI_CODING_API_KEY，可选 MOONSHOT_API_KEY |
5h + 周/月窗口；订阅查询失败可回落余额 |
| OpenRouter | 按量 | OPENROUTER_API_KEY |
Credits（USD） |
| 通义千问 | 按量 | DASHSCOPE_API_KEY（CNY）/ DASHSCOPE_INTL_API_KEY（USD） |
仅用量；余额不支持 |
| OpenCode Go | 订阅 | OPENCODE_GO_API_KEY |
5h / 周 / 月窗口（USD） |
| Command Code | 订阅 | COMMAND_CODE_API_KEY + COMMAND_CODE_ORG_ID |
5h + 周窗口、Credits（CNY） |
订阅模型计入 Tokens，但不计费用；余额、配额、用量分开展示；余额接口失败不会把当天的 Token 记账清零。
界面与典型操作¶
底栏 Pill 与浮层¶
Pill 区分按量 / 订阅两种形态，点击展开浮层，点击外部、× 或 Esc 收起。
浮层固定宽度 380，单行四组信息：已用环、已用·预算、真实余额、本月已花（按量）；订阅形态则展示最多三个固定槽位的窗口环、剩余百分比与倒计时。时间范围可选当天 / 7 天 / 30 天 / 全部，下方是用量表；模型列上限 150，Tokens / 请求 / 命中右对齐。
整页看板¶
整页展示 7 家供应商卡片、摘要带、8 列模型明细（模型 / Tokens / 输入 / 缓存 / 输出 / 请求 / 命中 / 费用），底部为设置胶囊：刷新间隔、账户余额开关、日志、导出导入、价格表与版本。按量卡可设预算；订阅卡每个窗口一个环。明细除模型列外右对齐。
导出与导入¶
导出 / 导入在本地完成：导出设置与当月使用数据，不含配额、余额与日志；导入覆盖前会备份原文件。换机或重装 DSH 后可用导入恢复当月账本。
安装与启用¶
需要 DSH 0.2.1 或更新；README 标明已在 DSH 0.2.2-rc.1 上验证。DSH 0.2.2 自身要求 Node 24.9+；插件包 engines.node 为 >=20。
推荐通过 npm 安装到 desktop profile：
dsh plugin --profile desktop add dsh-token-dash
也可从 GitHub 直装（纯 JS，无构建）：
dsh plugin --profile desktop add github:spartawhy117/dsh-token-dash
离线场景可下载 Releases 中的 dsh-token-dash-x.y.z.tgz 后本地安装：
dsh plugin --profile desktop add /path/to/dsh-token-dash-x.y.z.tgz
更新使用同名 update 命令（npm / github: 各自同名），或在插件设置页「价格与版本」右侧的更新入口完成。卸载用 remove 同名命令；账本与设置保留在 $DSH_HOME/dsh-token-dash/，不随插件包删除。
数据、隐私与排障¶
默认数据目录为 $DSH_HOME/dsh-token-dash/：daily.json、months/、prefs.json。只读本地会话 usage，不统计标题生成；凭据经宿主解析，不落盘、不写日志。余额访问官方接口；成功结果缓存 60s、失败结果缓存 10s，并发请求会合并。
日志位于 $DSH_HOME/logs/dsh-token-dash/，JSONL 格式。在插件仓库目录可执行：
npm run logs -- --tail 50
npm run logs -- --module adapter.*
npm run logs -- --module provider,route
常见前缀为 [TD:adapter.*]（配额 / 余额 / 侦测）、[TD:provider]（探测与缓存）、[TD:route]（路由异常）。
适用场景与注意¶
适合需要在 DSH 内持续对照 月度预算、订阅窗口、账户余额 与 真实 Tokens / 本地估算费用 的开发者。通义千问仅统计用量；上游接口有速率限制，展示以接口实际返回为准。
DSH 生态是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。插件以当前 DSH 进程权限运行，安装前请阅读源码与 MIT 许可证，自行评估凭据与出站请求范围。升级 DSH 后插件可能从 profile 消失，重装同一 tarball 即可，账本不会被删。
结尾¶
dsh-token-dash 把当前模型 Pill、浮层用量与七家供应商整页看板绑在同一份本地账本上，便于在 Harness 里看清花费与配额，并用 JSON 备份当月数据。
- 目录页：https://www.skillhub.cn/plugins/spartawhy117/dsh-token-dash
- GitHub：https://github.com/spartawhy117/dsh-token-dash
