前言¶
在 DeepSeek Harness 里写对话、调模型时，账户里还剩多少钱、当前是高峰还是空闲价，往往要切到官网或控制台才能确认。官方界面在输入框下方已有「缓存命中 / 轮次」一类统计，但钱包余额和按时段变化的价目并不在同一条视线里。
下面介绍社区插件 dsh-wallet-pill（维护者 LumiDesk，分类：客户端）。它在 composer 输入框下方增加一颗「余额胶囊」，点开可看总额拆分、峰谷切换倒计时和价目表；Host 侧用你已配置的 DEEPSEEK_API_KEY 读余额，零配置、不落盘。插件为非官方社区作品，与 DeepSeek 官方无隶属关系。
这是什么¶
dsh-wallet-pill 是 DeepSeek Harness 的客户端插件：在输入框下方、官方统计行之后显示 余额 ¥…，点击展开价目面板。npm 包名 dsh-wallet-pill，当前版本 1.0.1；仓库 LumiDesk/dsh-wallet-pill，目录页 skillhub.cn/plugins/LumiDesk/dsh-wallet-pill。
要求 DeepSeek Harness ≥ 0.2.1-rc.3，Node ≥ 22（插件 Host 运行时零额外 npm 依赖）。
核心功能¶
余额胶囊¶
- 显示
DEEPSEEK_API_KEY对应账户钱包余额；读不到时显示余额 —并带状态点。 - 未在模型设置里配置 key 时，整条不渲染、不占位。
- 点击展开面板（
aria-haspopup="dialog"），Esc 或点外部关闭，焦点回到胶囊。
价目面板¶
| 区块 | 内容 |
|---|---|
| 余额 | 总额、充值余额、赠送余额；失败时给出可读原因 |
| 计费时段 | 当前高峰或空闲、下一切换时刻倒计时 |
| 价目 | 缓存命中 / 未命中 / 输出三档，空闲价与高峰价两列，当前时段高亮；多模型可切换 |
| 底部 | 上次读数时间、价目表版本、手动刷新 |
页面每 60 秒自动刷新（不可见时暂停），回到页面立即刷新。
数据与安全口径¶
- 余额：Host 用
DEEPSEEK_API_KEY请求GET https://api.deepseek.com/user/balance，60 秒缓存。密钥只在 Host 进程内使用；浏览器只访问本机/wallet-pill/state，响应为聚合金额。 - 峰谷：北京时间周一至周五 09:00–12:00、14:00–18:00 为高峰，其余（含周末、法定节假日全天）为空闲；高峰价为空闲价 2 倍。
- 价目（CNY / 百万 token，空闲价；高峰加倍）：
deepseek-flash0.02 / 1 / 4，deepseek-v4-pro0.15 / 4.5 / 13.5；表版本2026-09-19，来源为 DeepSeek 官方定价页。
插件不记账、不统计逐轮消耗、不写文件、无配置项；只支持 DEEPSEEK_API_KEY，无遥测，除读余额外不向第三方发请求。
安装与启用¶
已发布到 npm。桌面端与 Web/CLI 安装命令如下（摘自仓库 README）：
# 桌面端
dsh plugin --profile desktop add dsh-wallet-pill
# CLI / Web
dsh plugin --profile web add dsh-wallet-pill
固定版本可写 dsh-wallet-pill@1.0.1。也可从 GitHub 源安装（商店生成的命令）：
dsh plugin --profile web add github:LumiDesk/dsh-wallet-pill
装好后需重启 Harness 进程（Host 改动不能仅靠刷新页面），再刷新页面。
卸载示例（desktop）：
dsh plugin --profile desktop remove dsh-wallet-pill
典型用法¶
- 在 Harness 模型设置页填写
DEEPSEEK_API_KEY。 - 按上文命令安装插件并重启 Harness，刷新对话页。
- 在输入框下方找到与官方统计同排的余额胶囊；需要核对价目或时段时点击展开面板，必要时点底部「刷新」。
无额外配置文件；价目与节假日规则随插件发版更新，面板底部会显示价目表版本号。
适用场景与注意¶
适合：长期在 Harness 里开发、希望一眼看到余额并在同界面核对峰谷价与倒计时的开发者。
注意：
- 插件以当前 DSH 进程的权限运行；安装前建议浏览 源码 与 MIT 许可证，确认接受 Host 侧使用 API Key 读余额的行为。
- 价目表为仓库内静态数据（
src/host/pricing.ts）；官方调价或次年放假安排需维护者改代码发版，不能靠本地配置热更新。 - 账号登录态不属于本插件范围；仅依赖环境变量 / 设置里的
DEEPSEEK_API_KEY。
DeepSeek Harness 生态强调「一切皆插件」；社区目录站点与 DeepSeek、幻方无官方从属关系，本文介绍的为社区插件，非官方应用。
结尾¶
dsh-wallet-pill 把钱包余额和峰谷价目收进输入框下方一颗胶囊：零配置、密钥不出 Host、浏览器只读本机聚合状态。需要安装或 issue 时见 GitHub 仓库 与 SkillHub 目录页。
