前言¶
在 DeepSeek Harness（DSH）里跑长对话或切换多个 Provider 时，余额、本场 token 和模型单价往往分散在官方页、第三方控制台和宿主日志里。官方账单有延迟，第三方又没有统一口径，很难在输入框旁一眼判断「这一会话大概花了多少、现在是不是峰谷价」。
下面介绍社区维护的 deepseek-harness-wallet-patched（npm 包名同插件 id）。它是 feibi-mochi/deepseek-harness-control-center 的个人修补分支：上游自 2026-09-09 起未再更新，ThinkofRain1213 在此继续维护可用版本。插件归类为「模型推理」相关能力，面向 web profile 的 DSH 宿主。
这是什么¶
DeepSeek Harness 监控、提醒、充值与会话控制中心——本地优先：余额尽量走官方接口，费用在本机按用量与价格规则估算；不保存提示词或回答正文。
典型界面摘要形如：
余额 ¥5.89 · 本场 ¥0.72 · 官 18.8M | 三方 800K · ↗ 充值
维护者说明精力有限、可能断更；上游若恢复维护会优先回归上游。当前 README 标注版本 v0.3.13；npm 发布为 0.3.13-patched.6，许可证 MIT。
核心功能¶
官方 DeepSeek 与 V4 峰谷¶
- 余额约 60 秒全局刷新，启动时快速重试；本会话花费为本机估算（非官方账单），每次用量按发生时价格锁定，含 2026-08-17 起峰谷价规则。
- v4 峰谷计费时钟（侧边栏环形钟）：适用于
v4-flash、v4-pro、v4-flash-vision-exp。工作日高峰为北京时间 09:00–12:00、14:00–18:00；周五 18:00 后提示周末低谷，周六、周日显示全天低谷，周一 09:00 前显示距高峰剩余时间；周五 18:00 至周一 09:00 视为连续低谷周期。 - 视觉模型计费：
deepseek-v4-flash-vision-exp按 V4 Flash 价格计；Harness 上报的图片 token 与文本 token 一并计入。 - 官方价格同步：定期检查 DeepSeek 官方价格页；仅完整校验通过的价格表才会应用。网络失败沿用上一次已验证规则（首次同步前用内置规则）；页面结构无法识别时标记待复核，不静默改计费。
跟随 Provider 与第三方¶
- 输入框标签和侧边栏时钟跟随当前会话的 Provider/模型。选 Z.ai（含透明
vision-toolkit-变体）时用套餐窗口摘要替代 DeepSeek 余额、充值与峰谷钟；其他第三方主要显示本会话 token；切回 DeepSeek V4 恢复钱包与峰谷视图。 - Z.ai Coding Plan：通过官方套餐适配器监控已配置的全球区/中国区套餐，不向浏览器暴露凭据；5 小时模型 Token 与月度 MCP 额度分开显示。
- 第三方合计：本会话 token（输入 / 缓存读 / 输出）零配置可用。
- 第三方自定义价格：可按 Provider/模型填写币种及每百万 Token 的输入、缓存读、缓存写、输出价，并配置 IANA 时区、星期与跨午夜分时段价；365 天账本与本会话按发生时间重算，并标注为自定义估算。
- Provider 分桶：设置页列出已观察的包装路由；勾选后后续调用计入官方 token/花费桶并按官方价表计费，历史不追溯。
账本、面板与提醒¶
- 本地用量账本（最多 365 天 / 20,000 条）：官方/第三方分开，稳定请求标识去重；从 v0.3.2 升级后开始收集，旧聚合数据不回填伪造日期。
- 点开面板可看余额拆分、花费与 token 明细、按账户与币种设置低余额阈值（两位小数、不跨币种相加）、手动刷新、跳转官方充值（首次点击域名确认）。
- 对话完成提醒、低余额提醒（标签变红呼吸 + 桌面通知，余额回升复位）；多标签页排队去重，系统通知不可用时用页面内提醒。
- 卡片可拖动、吸附、缩放；可浮窗或最小化为圆点；主题跟随 DSH
--dsw-alias-*变量。 - 清除本会话钱包数据仅清当前对话 token/花费，不删对话；清历史账本为独立操作。
多账户¶
在钱包面板 账户管理 中添加名称 + API Key、切换或删除。切换会写入宿主凭证库（credentials.set('DEEPSEEK_API_KEY', ...)），下一次 LLM 调用即用新账户计费，无需重启。Key 加密存于 $DSH_HOME/storages/accounts.json（Windows DPAPI，其他系统 AES-GCM 密钥文件）；界面仅掩码显示。若环境已提供 DEEPSEEK_API_KEY，切换会被拒绝，需在 shell 中取消该环境变量。
安装与启用¶
插件以 web profile 安装；安装后需重启 dsh web 并强制刷新页面。Node 要求见包声明：^22.19.0 || >=24.0.0；DSH 兼容范围为 >=0.1.2-alpha.3 <0.1.3 || >=0.1.5-alpha.1 <0.1.8（README 本轮兼容验证见 0.3.13 文档，官方 0.1.5-alpha.1 未提供插件要求的永久删除能力，相关开关保持禁用）。
从 npm 安装：
dsh plugin --profile web add deepseek-harness-wallet-patched
或直接安装 GitHub main：
dsh plugin --profile web add github:ThinkofRain1213/deepseek-harness-wallet-patched
更新与卸载：
dsh plugin --profile web update deepseek-harness-wallet-patched
dsh plugin --profile web remove deepseek-harness-wallet-patched
典型用法¶
- 点击钱包卡片或峰谷卡片打开控制面板；也可在 Harness 设置中打开健康检查卡片。
- 峰谷卡片支持横排/竖排与 100%–120% 缩放；钱包标签在输入框内约 100%–105%，停靠或浮动时最高 125%。
- 可关闭官方充值按钮以缩小卡片；官方与第三方数据可分别显示或隐藏。
- 将卡片拖到空白处；找不到时可在面板使用「归位/停靠」回到侧边栏。
- 升级插件后强制刷新，确保加载新版前端。
Electron/Tauri 等桌面宿主若限制通知或外链，可在钱包脚本加载前按需注入 window.__DSH_WALLET_ADAPTER__（storage、notify、openExternal、capabilities 等字段均可选）；细节见仓库 README「浏览器、桌面端与系统兼容」一节。
适用场景与注意¶
适合：希望在 DSH 对话时查看 DeepSeek 余额、V4 峰谷时段、本会话与近一年 token 账本，或管理多 API Key、为第三方 API 配置本机估价规则的用户。
注意：
- 插件在 当前 DSH 进程权限 下运行，会向官方
/user/balance等接口发起请求；多账户切换还会改写 DSH 凭证库中的DEEPSEEK_API_KEY。安装前应阅读 GitHub 源码 与 MIT 许可证，确认符合你的安全策略。 - 本场花费、第三方自定义价均为本机估算，不能替代供应商账单或实时汇率（美元账户的「本约 $x」按固定 7.25 CNY/USD 系数展示，非官方美元单价）。
- DSH 生态是「一切皆插件」；SkillHub 目录页 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
deepseek-harness-wallet-patched 把余额、峰谷钟、价格同步、本地账本和多账户切换收进输入框旁的控制中心，适合长期用 DSH 做模型推理时跟踪消耗。更多信息见目录页与仓库：
