dsh-wallet-pill

DeepSeek Harness 的余额胶囊：在输入框下方显示账户余额，点开查看峰谷价目与切换倒计时。零配置、不落盘。

非官方社区插件，与 DeepSeek 官方无隶属关系。

预览

深色主题	浅色主题

胶囊在输入框下方，与官方的「缓存命中 / 轮次」统计条同排；点开是价目面板。

它做什么

胶囊（输入框下方，官方统计行之后）

• 余额 ¥12.34 —— 取 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-flash 0.02 / 1 / 4，deepseek-v4-pro 0.15 / 4.5 / 13.5（空闲价；高峰加倍）。来源为 DeepSeek 官方定价页，版本 2026-09-19。

官方调价或公布次年放假安排时，改 src/host/pricing.ts 里的 MODELS / HOLIDAYS 与 PRICE_TABLE_VERSION，面板上显示的版本号会跟着变。

安装

已发布到 npm：dsh-wallet-pill，当前版本 1.0.1。

# 桌面端
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 侧改动不是刷新页面就能生效），再刷新页面。

卸载：

dsh plugin --profile desktop remove dsh-wallet-pill

开发

pnpm install        # 安装依赖
pnpm hooks:install  # 可选：装 husky git hooks
pnpm build          # host（tsc）+ client（esbuild）
pnpm typecheck      # host / client / test 三个 tsconfig 各过一遍
pnpm lint           # eslint
pnpm test           # node --test，会先自动 build
pnpm format         # prettier --write
pnpm release patch  # 发版：校验 → 升版本 → 打 tag → npm publish

Node 22+（本机 24），pnpm 12。客户端产物是 dist/client.js，包在 Harness 的 window.__ModuleLoader__.load(...) 工厂里；react 与 react-dom 从页面模块表取，不打包。

仓库不声明 prepare 等安装期脚本：pnpm 12 默认拒绝执行 git 依赖的构建脚本，保留它会让商店生成的 github: 安装命令报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED；git hooks 用 pnpm hooks:install 手动装。

dist/ 是入库的构建产物，不是临时目录：npm tarball 通过 files 带上它，商店的 github:owner/repo 安装则直接从 commit 取文件、不执行构建，pnpm 也默认拒绝 git 依赖的安装期脚本。不提交 dist/ 时，GitHub 源安装能装上但找不到 dist/index.js / dist/client.js。改完 src/ 后运行 pnpm build 并提交 dist/；pnpm release 的 version 脚本会自动 build 并 git add dist。

技术栈

层	选择
语言	TypeScript（strict、noUncheckedIndexedAccess），全仓无 any
Host	Node 22+ ESM，tsc 编译到 dist/index.js，运行时零依赖
Client	React 18（宿主页面模块表提供，不打包）+ esbuild 打成 __ModuleLoader__ 工厂
样式	只用宿主 --dsw-* 主题 token，无 CSS 框架；浮层复用官方 menu surface（--dsw-specific-menu + --dsw-elevation-prominent）
测试	node --test 直接跑 .ts（Node 24 类型剥离），39 条用例，零测试框架
规范	ESLint + Prettier + Commitlint（Conventional Commits）+ Husky + lint-staged
兼容	DeepSeek Harness ≥ 0.2.1-rc.3；不声明 @deepseek-ai/dsh-* 的 peer 依赖（否则会被安装闸门拒绝）

目录

src/host/index.ts        Host 入口：HTTP 路由、信任栅栏、状态装配
src/host/balance.ts      余额取数、缓存、错误映射
src/host/pricing.ts      价目表、峰谷判定、节假日
src/client/index.tsx     Client 入口：槽位注册、字典、样式注入
src/client/pill.tsx      胶囊与面板
src/client/api.ts        状态请求
src/client/format.ts     金额 / 时长 / 时间格式化
src/client/locales.ts    zh / en 文案
scripts/build-client.mjs Client 的 IIFE 打包
scripts/release.mjs      发版助手
dist/                    入库的构建产物：npm tarball 与 GitHub 源安装都直接使用
test/                     node --test 测试与 TS 项目
locale/                  插件元数据（zh / en）
docs/assets/             README 截图（深色 / 浅色）
cordis.patch.yml         Bundle patch（插入一行 Host 插件）

dist/ 已入库：npm tarball 和商店的 GitHub 源安装都直接使用它。改完 src/ 后必须重新 pnpm build 并提交；pnpm release 会自动做这一步（原因见开发一节）。

边界

• 只读余额与价目：不记账、不统计逐轮消耗、不写任何文件、没有配置项。
• 只支持 DEEPSEEK_API_KEY（在模型设置页填写）：账号登录态不属于本插件的范围。
• 价目表是静态数据，官方调价必须改代码发版；面板显示版本号，方便判断读到的是哪一版。
• 无遥测，不向任何第三方发起请求；唯一的出站请求是读取你自己的余额。

许可

MIT。价目表与峰谷规则来自 DeepSeek 官方定价页。