一个 DeepSeek Harness（dsh web）插件，按请求把 Token 用量归属到中转站，支持按项目分组、余额、订阅配额、用量分析、费用估算与 CSV/JSON 导出——零配置、无需凭据。
DSH 适配
兼容
作者声明
安全审计
未审计
最后核验
2026-08-24
许可证
MIT
01它能帮你完成什么？
把 DeepSeek Harness 的 Token 用量归属到实际服务本次请求的中转站，并按项目分组、估算费用
Web 面板「用量账本」：中转站归因、按项目用量、余额、订阅配额、用量分析与 CSV/JSON 导出
通过中转站（New API / Sub2API / 官方 DeepSeek）跑流量的 DeepSeek Harness（dsh web）用户，需要对 Token 花费做账的人
02如何接入 DeepSeek Harness？
前置条件
- DeepSeek Harness 的 `web` profile —— `@deepseek-ai/dsh >= 0.1.0-rc.6`
- 中转站已在宿主的 provider 配置里写好 `baseURL`（插件自动发现，无需凭据）
安装步骤
- 01
运行 `dsh plugin --profile web add "github:zh667/TokenLedger"`
$ dsh plugin --profile web add "github:zh667/TokenLedger"
- 02
重启正在运行的 `dsh web` 并硬刷新浏览器；侧边栏底部出现「用量账本」入口
$ dsh web
- 03
要钉版本必须用完整的 40 位 commit SHA，如 `github:zh667/TokenLedger#<sha>`
- 04
升级用 `dsh plugin --profile web update dsh-tokenledger`；卸载用 `dsh plugin --profile web remove dsh-tokenledger`
$ dsh plugin --profile web update dsh-tokenledger
验证接入成功
作者未说明
回滚
- dsh plugin --profile web remove dsh-tokenledger
03DSH 适配与能力边界
通过 dsh plugin CLI 安装到 DeepSeek Harness 的 web profile，在侧边栏注册「用量账本」入口。要求 `@deepseek-ai/dsh >= 0.1.0-rc.6`。
中转站归属
宿主 provider 配置（各 provider 的 baseURL）→按归一化后的中转站 origin 分组；同一站多把 key 合成一行，站名即域名
按项目归属
会话启动所在目录→按会话启动目录分组（注册过的工作区用其标题，否则用目录名；子目录起的会话同样计入）
零配置发现
宿主 provider 配置→从中读取中转站，无需重填；只读 `baseURL`，绝不碰凭据
余额
每个账户一把普通 key（官方 DeepSeek / New API / Sub2API）→展示余额；不限额度的 key 报「已用」而非假余额
订阅配额
卖套餐不卖余额的中转账户→5 小时 / 每周 / 每月各自滚动、各自重置，每窗口一条进度条和一个重置时刻
用量分析
已记录的用量→今日 / 本月 / 累计三窗口、按站点/模型下钻、缓存命中率、一年活跃度热力图
费用估算
生效日期分段的费率表、分桶计价、峰谷时段→估算费用；未定价模型显示破折号而非 0
导出与诊断
已记录的用量→CSV / JSON 导出、索引健康度、归因不上的行数单独列出
只读回环
回环 GET 请求→两个端点仅接受回环 GET，并在 peer socket 地址上设防；从不读取提示词、工具参数或响应内容
暴露两个仅限回环的 GET 端点
04适合谁？何时不该用？
适合
- 通过中转站（New API / Sub2API / 官方 DeepSeek）跑流量的 DeepSeek Harness（dsh web）用户，需要对 Token 花费做账的人
不适合
- 要钉版本必须用完整的 40 位 commit SHA。包管理器拿 ref 和 `git ls-remote` 广播的引用列表比对，短 SHA 匹配不到任何东西，会直接报 `Could not resolve`。
05兼容性、维护与安全提示
- 插件绝不会把 API Key 或上游原始响应发到浏览器，也从不读取提示词、工具参数或响应内容。
- 要钉版本必须用完整的 40 位 commit SHA。包管理器拿 ref 和 `git ls-remote` 广播的引用列表比对，短 SHA 匹配不到任何东西，会直接报 `Could not resolve`。
- 需要 DeepSeek Harness 的 web profile（`@deepseek-ai/dsh >= 0.1.0-rc.6`）。面板只在 `dsh web` 内显示。
MIT · 活跃维护（最新发布 v0.1.0，2026-08-15）
06常见问题
我需要把 API key 填进 TokenLedger 吗？
不用。插件只从宿主的 provider 配置里读取 `baseURL` 来发现中转站；它绝不碰旁边的凭据，也不会把 API Key 或上游原始响应发到浏览器。
安装时怎么钉某个具体版本？
在 spec 里用完整的 40 位 commit SHA，例如 `github:zh667/TokenLedger#<sha>`。包管理器是拿 ref 和 `git ls-remote` 的引用列表比对的，短 SHA 不在列表里，会报 `Could not resolve`。
余额和配额支持哪些中转站？
官方 DeepSeek、New API、Sub2API——每个账户一把普通 key。不限额度的 key 报「已用」而非伪造余额；卖套餐的账户显示滚动的 5 小时 / 每周 / 每月配额进度条。
TokenLedger 从不读也不发什么？
它的两个端点只接受回环 GET，并在 peer socket 地址上设防。它从不读取提示词、工具参数或响应内容，也从不把 API Key 或上游原始响应发到浏览器。
怎么升级或卸载这个插件？
升级运行 `dsh plugin --profile web update dsh-tokenledger`，卸载运行 `dsh plugin --profile web remove dsh-tokenledger`。重新 add 同一 spec 会重新解析最新的 `main`。
07相关的 DSH 工作流
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tui
作者 ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件：鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件：自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆，很丝滑的开发体验。
dsh-damage-pulse
作者 wssfk12138
DeepSeek Harness Token 余额监控插件：鲸鱼娘待机/扣费/复苏动画、峰谷计费、连续扣费飘字与会话费用统计。
08数据与来源
需要 DeepSeek Harness `web` profile（`@deepseek-ai/dsh >= 0.1.0-rc.6`）。
dsh plugin --profile web add "github:zh667/TokenLedger"
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-08-24。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。