前言¶
在 DeepSeek Harness（DSH）里跑多个对话、切换不同 Provider 时，余额、本场 token 消耗、峰谷计费时段和后台任务状态往往分散在不同页面。想确认「还剩多少钱」「这场对话花了多少」「现在是不是高峰价」，通常要打断当前工作流去别处查看。
下面介绍的 DeepSeek Harness Control Center（npm 包名 deepseek-harness-wallet）由社区维护者 feibi-mochi 开发，是一个本地优先的 DSH 客户端插件。它把余额监控、用量估算、峰谷时钟、多账户切换、完成提醒和充值入口收拢到输入框旁，让你不用离开当前对话就能掌握账户状态。
这是什么¶
Control Center 是 DSH 生态中的客户端插件（分类：客户端），当前 GitHub 与 npm 稳定版为 v0.3.4，采用 MIT 许可证。
一句话定位：在 DSH 对话界面旁提供余额、用量、峰谷计费、加密多账户、健康检查、提醒、充值与会话控制的本地控制中心。
它与官方 DeepSeek 平台无从属关系；插件数据保存在本地，不存储提示词或回答正文。
核心功能¶
余额与会话用量¶
插件在输入框旁显示紧凑标签，典型形态如下：
余额 ¥5.89 · 本场 ¥0.72 · 官 18.8M | 三方 800K · ↗充
- 官方 DeepSeek：每 60 秒刷新余额（启动时有快速重试），并估算当前会话花费。花费按每次用量发生时的价格锁定，支持 2026-08-17 起实施的 v4 峰谷定价。
- 第三方 Provider：仅统计本会话 token（输入 / 缓存读 / 输出），不做余额猜测和费用换算，零配置。
- Provider 分桶：设置页列出已观察到的包装路由；勾选后后续调用计入官方 token/花费桶，既有历史不追溯重分桶。
点击标签可打开详情面板，查看按币种拆分的余额、token 明细、手动刷新，以及跳转官方充值页（首次点击会显示域名供确认，防钓鱼）。
v4 峰谷计费时钟¶
侧边栏提供 24 小时环形时钟，适用于 v4-flash、v4-pro 和 v4-flash-vision-exp：
- 工作日高峰：北京时间 09:00–12:00、14:00–18:00
- 周六、周日全天按低谷价计费（2026-08-23 起）
- 周五 18:00 后预览「周末全天低谷」；周一 09:00 前显示距高峰剩余时间
插件会定期同步官方价格页，只有完整校验通过的价格表才会应用；网络失败时沿用上次已验证规则。
365 天本地用量账本¶
从 v0.3.2 起收集本地用量事件，最多保留 365 天。稳定请求标识去重，官方费用按发生时锁定，官方与第三方数据分开存储，不保存提示词或回答正文。钱包设置页常态显示热力图；「清除本会话钱包数据」只清当前对话记录，与「清除历史账本」是独立操作。
多账户加密切换¶
在钱包面板 → 账户管理（Account Management） 中添加账户（名称 + API Key）、切换或删除：
- 添加的第一个账户自动成为当前账户，并同步写入 DSH 凭证库。
- 切换前会弹确认框——因为后续 LLM 请求将按新账户计费。
- 切换通过
credentials.set('DEEPSEEK_API_KEY', ...)写入凭证库，llm-deepseek路由按请求解析，下一次 LLM 调用即用新账户，无需重启。 - 账户 key 加密存于
$DSH_HOME/storages/accounts.json：Windows 使用 DPAPI，其他平台使用仅限所有者访问的 AES-GCM 密钥文件。界面只显示掩码 key。
若启动环境已提供 DEEPSEEK_API_KEY 环境变量，切换会被拒绝；需在 shell 中取消该变量后才能启用多账户切换。
Z.ai Coding Plan 监控¶
通过通用官方套餐适配器监控已配置的全球区和中国区套餐，不向浏览器暴露凭据。5 小时模型 Token 窗口与月度 MCP 工具额度分开显示，以剩余比例为主；查询失败时保留最近成功快照，不把套餐额度换算成人民币余额。
提醒、布局与会话控制¶
- 对话完成提醒：可选常驻或定时关闭；多对话同时完成时排队去重，跨标签页协调；系统通知不可用时改用页面内提醒。
- 低余额提醒：低于阈值时标签变红并触发一次桌面通知，余额回升后自动复位。阈值按账户与币种分别持久化，两位小数，不跨币种比较。
- 移动与缩放：标签可自由拖动、吸附，切换横排/竖排布局，比例 100%–125%；明细面板可脱离为悬浮窗口或最小化为圆点。
- 可选永久删除：仅当 DSH 宿主真正提供会话删除能力时，用户可在设置中开启；不支持的环境保持禁用。
安装与启用¶
从 npm 安装（当前稳定版 v0.3.4）：
dsh plugin --profile web add deepseek-harness-wallet
或直接安装 GitHub main 源码版：
dsh plugin --profile web add github:feibi-mochi/deepseek-harness-control-center
安装后重启 dsh web，并强制刷新页面。
更新与卸载：
dsh plugin --profile web update deepseek-harness-wallet
dsh plugin --profile web remove deepseek-harness-wallet
包名在 0.1.1 从
dsh-wallet改为deepseek-harness-wallet。若曾安装旧包名，请先执行dsh plugin --profile web remove dsh-wallet，避免两份副本同时注册 UI。
典型用法¶
经过上面的安装步骤后，按以下流程使用：
- 点击钱包卡片或峰谷卡片，打开控制面板；也可在 Harness 设置中查看健康检查卡片。
- 按需调整峰谷卡片横排/竖排和 100%–120% 缩放；钱包标签在输入框内为 100%–105%，停靠或浮动时最高 125%。
- 若需缩小卡片，可关闭官方充值按钮；官方和第三方数据可分别显示或隐藏。
- 将卡片拖到空白位置；布局切换后若找不到，在面板中点击「归位/停靠」恢复到侧边栏。
- 需要多账户时，打开钱包面板 → 账户管理，添加名称与 API Key，确认切换后即可按新账户计费。
卡片会跟随 DSH 浅色/深色主题；升级插件后请强制刷新，确保加载新版前端。
适用场景与注意¶
适合谁：
- 长期在 DSH 中使用官方 DeepSeek 或 Z.ai Coding Plan，需要随时查看余额和本场用量
- 需要在多个 DeepSeek 账户间切换，且希望 key 本地加密存储
- 使用 v4 模型，想对照峰谷时段控制调用成本
- 希望对话完成时收到提醒，或余额低于阈值时获得通知
使用前请注意：
- 插件以当前
dsh进程的权限运行，会向官方/user/balance接口发送当前 API Key 查询余额；启用多账户切换后，所选 key 还会写入 DSH 凭证库供后续模型请求使用。安装前应阅读源码并确认 MIT 许可证条款。 - 会话花费为插件本地估算，不是官方账单；以官方接口返回的余额为准。
- 用量账本从 v0.3.2 起收集，旧版聚合数据没有可信日期，不会回填。
- 本版已在 Windows + Edge + DSH Web 完成真实环境检查；其他浏览器和桌面壳按能力设计兼容，但不代表每种组合都做过真机验证。
结尾¶
DeepSeek Harness Control Center 把余额、用量、峰谷计费和账户管理收拢到对话旁，减少在多个页面间来回切换。如果你经常在 DSH 里跑长对话或多账户开发，这个插件值得试用。
- 社区目录：SkillHub 插件页
- 源码与文档：GitHub 仓库
