前言¶
用 DeepSeek Harness（DSH）做长对话或反复调模型时，平台账单是事后才看的；输入框附近通常只有 token 统计，没有和「账户还剩多少钱、这一轮大概花了多少」绑在一起。下面介绍社区客户端插件 dsh-token-budget-pill（维护者 gutddts）：在对话输入框下方的统计条里增加一个 ¥ 胶囊，展示 DeepSeek 账户可用余额与本会话 token 费用估算，点击可展开明细。它是纯客户端插件，不改 DSH 源码、不启独立服务、不写会话、不发模型请求。
这是什么¶
dsh-token-budget-pill 是 DSH 客户端类插件，通过 conversation.composer.dock 插槽挂在输入框统计条里。余额来自 DSH 账号 Remote（ctx.remote.account.getBalance()），本会话用量来自 Session 投影（tokenUsage、sessionStats、modelSelection），费用按插件内置的 DeepSeek 官方价目表估算。许可证 MIT，package 版本 1.0.0，面向 DSH 0.2.x（README 标明 DSH 0.2.x badge）。
界面与核心功能¶
统计条胶囊¶
在已有消息的会话里，输入框下方统计条会多出一项，形态类似：
[¥] ¥56.68 · 本会话 ¥6.43
- 左侧：DeepSeek 账户当前可用余额（充值余额 + 赠送余额）
- 右侧：本会话 token 的估算费用（按当前模型与当前峰谷时段计价）
- 点击：展开明细面板
明细面板¶
明细包含：可用余额、充值余额、赠送余额（支持 CNY / USD 钱包）；本会话估算费用及占「起始额度」的百分比进度条；按本会话平均花费估算的「约可再用 N 轮 / X tokens」；Token 明细（缓存命中输入、缓存未命中输入、缓存写入、输出）；费用明细（缓存命中、缓存未命中、输出及缓存命中节省）；手动刷新与最近更新时间。
刷新策略¶
页面可见时每 90 秒自动刷新余额；每轮对话结束后约 4 秒也会自动刷新。刷新失败时保留上一次成功数字，并标注「显示上次结果」。
计价口径¶
插件识别 deepseek-flash / deepseek-v4-pro，并区分高峰 / 空闲时段（高峰为北京时间周一至周五 09:00–12:00、14:00–18:00；周末与法定节假日为空闲；节假日未单独识别）。价目表（元 / 百万 tokens）如下：
| 模型 | 缓存命中输入（空闲 / 高峰） | 缓存未命中输入（空闲 / 高峰） | 输出（空闲 / 高峰） |
|---|---|---|---|
deepseek-flash |
¥0.02 / ¥0.04 | ¥1 / ¥2 | ¥4 / ¥8 |
deepseek-v4-pro |
¥0.15 / ¥0.30 | ¥4.5 / ¥9 | ¥13.5 / ¥27 |
「本会话估算」仅作参照，实际扣费以 DeepSeek 平台账单为准。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前建议自行查看 GitHub 仓库 源码与 MIT 许可证。
方式一：命令行从 GitHub 安装¶
Web profile：
# dsh web（Web profile）
dsh plugin --profile web add github:gutddts/dsh-token-budget-pill && dsh web
桌面版 profile：
# DSH Desktop（桌面版 profile）
dsh plugin --profile desktop add github:gutddts/dsh-token-budget-pill
安装器没有可用 Git 时，可用 tarball：
dsh plugin --profile web add https://github.com/gutddts/dsh-token-budget-pill/archive/refs/heads/main.tar.gz
方式二：插件管理页¶
打开 设置 → 插件 → 安装插件，输入：
github:gutddts/dsh-token-budget-pill
安装后刷新对话页或重启 DSH。注意：需进入已有对话的会话才能看到 dock；新会话欢迎页为 hero 模式，不渲染该插槽。
典型用法¶
- 进入任意一个已有消息的会话。
- 看输入框下方统计条：
[¥] 余额 · 本会话费用。 - 点击胶囊展开明细；点明细右上角「刷新」立即重新读取余额。
未登录 DeepSeek 账号（例如仅使用 API Key）时，余额区域会提示不可用；本会话 token 与费用估算仍可用。
数据来源、隐私与兼容性¶
| 数据 | 来源 |
|---|---|
| 账户余额 | DSH 账号 Remote ctx.remote.account.getBalance() |
| Token 用量 | Session 投影 tokenUsage |
| 轮次数 | Session 投影 sessionStats |
| 当前模型 | Session 投影 modelSelection |
| 价格 | 插件内置 DeepSeek 官方价目表 |
凭证不进入页面：余额查询由 DSH 宿主侧完成，浏览器只接收金额快照。插件不写 Session、不发模型请求、不向第三方上报；唯一写入的是页面内一个 <style> 标签（插件样式）。
兼容性要求：DSH 0.2.x，且包含 conversation.composer.dock 插槽与账号 Remote。README 记录已在 DSH Desktop 0.2.1-rc.2 上实测余额读取、峰谷价估算与 UI 正常。
适用场景与注意¶
适合在 DSH Web 或 Desktop 里长时间对话、需要对照余额与会话花费的开发者。社区目录 SkillHub 插件页 与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系。
安装插件前请确认信任维护者与代码；会话费用为估算值，高峰时段判定与官方账单可能存在差异。
结尾¶
dsh-token-budget-pill 把账户余额和本会话 token 费用估算放到输入框下方，减少「聊完才发现余额或花费超预期」的情况。进一步了解可访问目录页 https://www.skillhub.cn/plugins/gutddts/dsh-token-budget-pill 与源码 https://github.com/gutddts/dsh-token-budget-pill。
