前言¶
DeepSeek Harness（DSH）在对话轮次中不提供每轮用量与费用的可视化信息，开发者难以逐轮追踪成本与余额变化。DSH Token Admin 在每条已完成的对话下方显示本轮 token 用量、估算费用与 DeepSeek 余额，便于精细控制成本与余额状态。
是什么¶
DSH Token Admin（插件包名 dsh-turn-cost）是一个 DSH 插件，由 YuGaN525 维护，分类为客户端插件。它利用 ui-chat 的 turn-tail.tokenUsage 数据，在每轮对话底部展示 token 细分（未缓存输入、缓存读取、缓存写入、输出、推理、合计与路由）与费用，同时提供余额查询与峰谷计价能力。
核心功能¶
- 每轮独立显示：基于 ui-chat 写入的
turn-tail.tokenUsage，按轮展示，不重算官方用量。 - 费用估算：按 token 桶 × DeepSeek 官方价目计算，自动识别峰时/谷时、周末与法定节假日。
- 余额展示：优先使用 DSH 账号服务
deepseekAccount.getBalance（充值钱包 + 赠金钱包），无账号服务时回退为DEEPSEEK_API_KEY调用/user/balance。密钥不落日志、不下发浏览器。 - 历史轮次：已完成的历史对话同样显示每轮 token 与费用；余额为最近一次查询结果，不是历史快照。
- 失败开放：余额读取失败显示“余额 —”，费用照常；价目或路由不可用时显示“本轮 —”，不影响 Chat 本身。
- 主题适配：使用 DSH 主题变量，深浅色自动跟随；无动画、无额外依赖。
数据来源¶
- 每轮 token：ui-chat
turn-tail数据中的精确tokenUsage（未缓存输入 / 缓存读取 / 缓存写入 / 输出 / 推理 / 合计 / 路由）。 - 费用：浏览器端根据 host 下发的价目表计算。
- 余额：DSH
deepseekAccount.getBalance，或DEEPSEEK_API_KEY→https://api.deepseek.com/user/balance。 - 价目：内置 DeepSeek 官方 CNY 价目（2026-09-10 起），可通过配置覆盖。
安装¶
方式 A：DSH 插件管理器
让 DSH 会话执行：
plugin_manager(action: "install_bundle", target: "<本目录绝对路径>")
方式 B：desktop profile 手动安装
pwsh -File install.ps1
脚本会备份 profile 的 package.json、添加 link: 依赖、把 dsh-turn-cost 加入 dsh.profile.bundles，并在 profile 的 node_modules 下建 junction。完全退出并重新打开 DSH Desktop 才会加载新的 bundle。卸载：
pwsh -File install.ps1 -Uninstall
配置¶
配置写在 cordis.patch.yml 的 config:，或安装后的 profile patch 里（按 id dsh-turn-cost 覆盖）。
| 键 | 默认 | 说明 |
|---|---|---|
refreshSeconds |
30 |
余额缓存时间（秒），也是浏览器刷新余额的 TTL |
balanceSource |
auto |
auto = 先账号后 API key；account / apikey 强制单路 |
pricing.currency |
CNY |
费用显示币种；余额按接口返回币种单独显示 |
pricing.peakMultiplier |
2 |
峰时价格倍率 |
pricing.peakWindows |
[[540,720],[840,1080]] |
峰时窗口（当地分钟数，09:00–12:00、14:00–18:00） |
pricing.weekendValley |
true |
周末按谷时计价 |
pricing.holidays |
2026 法定节假日 | 节假日全天谷时；每年安排公布后补下一年的日期 |
pricing.timeZone |
Asia/Shanghai |
判断峰谷用的 IANA 时区 |
pricing.defaultModel |
flash |
未匹配到模型时使用的价位 |
pricing.models |
flash / pro 两档 |
每档 cacheHit、cacheMiss、output，单位为 元/百万 token |
覆盖示例：
- id: dsh-turn-cost
config:
refreshSeconds: 60
pricing:
models:
flash:
cacheHit: 0.02
cacheMiss: 1
output: 4
pro:
cacheHit: 0.15
cacheMiss: 4.5
output: 13.5
只写一个字段也会与默认值合并，例如只改 flash.cacheHit 不会把 cacheMiss / output 清零。
计费口径¶
费用 = (未缓存输入 × cacheMiss + 缓存读取 × cacheHit + 缓存写入 × cacheMiss + 输出 × output) / 1,000,000 × 峰时倍率
reasoningTokens已包含在outputTokens中，不重复计费。- 一次 Turn 内有多个模型路由时，按首个模型价格估算，并在 tooltip 标注“多模型路由”。
- 费用是估算值，实际账单以 DeepSeek 账单为准；余额是最近一次查询结果。
限制¶
- 余额是当前值：历史轮次也显示最近一次查询余额，不是该轮结束时的余额。若需要严格的逐轮余额快照，可再扩展宿主侧记账。
- 只在 Web/Desktop 客户端显示：插件通过
conversation.chat.turnTail插槽渲染；TUI/headless 不加载客户端半边。 - 需要精确用量：ui-chat 只有在已加载窗口包含
turn/start且每次模型尝试都报告完整用量时才提供tokenUsage；不完整时页脚自动隐藏。 - 价目需要维护：DeepSeek 调整价格或发布下一年节假日安排后，更新
pricing配置或lib/index.js的DEFAULT_PRICING。 - 余额接口：只支持 DSH DeepSeek 账号与 DeepSeek API key；使用其他提供方时 token/费用仍可显示，但余额可能为
—。
文件结构¶
lib/index.js— 宿主：余额、价目、/dsh-turn-cost/state.json路由、同源/连接栅栏。lib/client.js— 浏览器：conversation.chat.turnTail页脚、费用计算、状态缓存。cordis.patch.yml— bundle 挂载声明。install.ps1/install.cmd— desktop profile 安装器。
生态背景¶
DSH 理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
适用场景与注意¶
适合需要按轮统计 token 用量、估算费用与实时查看 DeepSeek 余额的开发者与用户。插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
结尾¶
DSH Token Admin 为 DSH 带来了可视化的每轮用量与费用信息，帮助在对话过程中把控成本与余额。目录页：https://www.skillhub.cn/plugins/YuGaN525/DSH-token-admin；GitHub：https://github.com/YuGaN525/DSH-token-admin。
