控制中心 feibi-mochi/deepseek-harness-control-center

DeepSeek Harness Control Center

DeepSeek Harness 监控、提醒、充值与会话控制中心。

余额 ¥5.89 · 本场 ¥0.72 · 官 18.8M | 三方 800K · ↗充

English · 简体中文 · 安装 · 兼容性 · 更新日志

本地优先的伴生工具，把账户状态、每段对话用量、完成提醒、官方充值、灵活布局和受宿主管控的会话操作，都放在 DSH 输入框旁边。

版本： v0.3.13。

如果 DeepSeek Harness Control Center 帮到了你，欢迎点个 ⭐ Star。谢谢！

它能做什么

钱包界面目前以中文为主，还没有跟随宿主语言设置（#32）。DeepSeek 余额来自官方 API；费用统计是本地估算。

余额 ¥5.89 · 本场 ¥0.72 · 官 18.8M | 三方 800K · ↗充

- 官方 DeepSeek —— 实时余额（全局 60 秒刷新，启动时快速重试）、当前会话预估费用（不是官方账单），按每次用量事件生效时的价格计算，已包含 2026-08-17 上线的峰谷价，还有 token 明细。
- 视觉模型计费 —— deepseek-v4-flash-vision-exp 按 V4 Flash 的价格计费；Harness 上报的图片 token 会和文本 token 一起计入。
- v4 峰谷环形时钟 —— 常驻侧边栏底部的 24 小时小部件，支持 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 官方价格页面，只在整张表完全通过校验后才应用。网络失败时保留上一次通过校验的规则（首次同步成功前则用内置规则）；页面结构无法识别时标记为待复核，而不是悄悄改动计费。
- Z.ai Coding Plan 配额 — 通用官方套餐适配器监控已配置的 Global 和 China 套餐，不暴露凭据。它把 5 小时模型 token 窗口与每月 MCP 工具用量分开，优先展示剩余配额，从 100% 往下递减，用量只作为次要信息；失败时保留上一次成功快照，绝不把订阅配额换算成人民币余额。
- 服务商感知的输入区界面 — 芯片和侧边栏时钟跟随会话选中的服务商/模型。Z.ai——包括透明的 vision-toolkit- 变体——替换 DeepSeek 余额、充值和高峰定价，改为展示套餐窗口摘要；无关服务商只显示自己的会话 token，DeepSeek V4 则恢复钱包和高峰时钟。
- 本地用量账本（最长 365 天 / 20,000 条事件） — 钱包设置里热力图保持可见，紧凑的钱包面板里热力图可折叠。稳定的请求标识会去重，官方成本在用量发生时锁定，官方与第三方数据分开存放，提示词和回复一律不存储。升级到 v0.3.2 后开始采集；更早的聚合计数器没有可信日期，不做回填。
- 第三方合计 — 当前会话 token（输入 / 缓存读取 / 输出）零配置即可查看。
- 自定义第三方定价 — 填入精确的 Provider/model 路由、货币，以及每百万输入/缓存读取/缓存写入/输出的基础费率，然后可选添加多个 IANA 时区、星期和跨午夜定价窗口。当前会话和 365 天账本的成本按发生时间在本地重算，并明确标注为用户自定义估算，绝不当作服务商余额或账单。
- 服务商分类 — 观察到的包装路由会出现在设置页面；选择加入的路由会加入官方 token/成本统计桶，后续调用按官方价格表计价。已有历史不做追溯重分类。
- 点击芯片打开详情面板：按货币正确格式化的余额、成本与 token 拆分、当前账户和货币下可自由编辑的低余额阈值（两位小数，按账户持久化；告警绝不混用货币）、手动刷新，以及跳转到官方充值页面（首次点击会显示域名供确认——防钓鱼）。
- 移动、停靠与缩放 —— 自由拖动悬浮片，预览附近的吸附目标，使用紧凑的横向或纵向布局，在控制面板里调整缩放，并独立显示官方或第三方数据。峰值时钟背景可以显式设为透明（悬停时变实心）或实心；没有自动模式。这些选择会保存在本地。
- 输入框标签控制与皮肤兼容 —— 独立显示或隐藏输入框标签，或将其精简为仅保留主要剩余值（DeepSeek 余额、Z.ai 五小时配额），同时不关闭提醒、设置、套餐监控或历史记录。标准悬浮片还能抵抗宽泛的皮肤按钮规则，并与 maid-atelier 的 38px 藏青配金色输入框工具栏对齐。
- 浮动窗口模式 —— 将详情面板分离为可拖动的窗口，位置会被记住，或直接最小化为可自由移动的圆点；低于阈值时圆点变红。
- 完成提醒 —— 可选在对话结束时通知，支持常驻或定时模式，对同时完成的对话排队去重，跨标签页协调，并在系统通知不可用时提供页内回退。
- 低余额告警 —— 低于阈值时悬浮片变红并播放呼吸动画，同时触发一次桌面通知；余额恢复后自动重置。
- 主题原生 UI —— 使用 DSH --dsw-alias-* 变量并配有安全的回退颜色，浅色和深色主题都能正确渲染；点击外部时面板关闭，靠近屏幕边缘时翻转展开方向。
- 清除当前会话钱包数据 —— 一个按钮只清除当前打开的对话的 token/费用记录；不会删除对话，其他对话也不受影响。清除历史账本是单独的操作。

多账号

- 打开钱包面板 → Account Management（账户管理） 添加账号（名称 + API key）、切换当前账号或删除账号。
- 添加第一个账号时会尝试将其 key 同步到宿主凭据存储。只有写入成功才会激活；写入被拒绝时保留已保存的账号，但不将其标记为计费激活。
- 切换时会弹出确认，因为这会改变后续请求的 LLM 计费：切换会把账号 key 写入凭据接缝（credentials.set('DEEPSEEK_API_KEY', ...)），而 llm-deepseek 服务商路由会在每次请求时解析该引用，所以下一次 LLM 调用就会用新账号计费 —— 无需重启。
- 账号 key 在 $DSH_HOME/storages/accounts.json 中静态加密：Windows 使用当前用户的 DPAPI；其他平台使用仅限所有者访问的 AES-GCM 密钥文件。加密的 .bak 可在主文件缺失、损坏或无法解密时恢复；如果两份副本都无法读取，写入会被锁定，而不是覆盖账号数据。UI 只显示掩码后的 key。
- 会话用量估算按当前账号的结算货币显示：美元结算账号显示 本约 $x，由人民币价目表按 1 美元 ≈ 7.25 人民币的固定估算换算而来（既不是实时汇率，也不是官方美元价目）；人民币账号显示 本场 ¥x。这些只是本地估算，不是官方账单。
- 如果启动环境里带了 DEEPSEEK_API_KEY，切换会被拒绝，并给出明确报错（凭据服务商拒绝被遮蔽的写入）——在 shell 里 unset 它才能切换。

项目概览

DeepSeek Harness Wallet 面向这些用户：想在对话中查看余额、比较模型开销，或者管理多个账号。输入框旁边有个小卡片，显示所选模型的余额、剩余套餐额度或 token 用量；点开看详情，也可以拖出来变成浮动面板。设置里汇集了加密账号、低余额与完成提醒、用量热力图，以及第三方 API 的固定价格或分时价格。DeepSeek 余额和 Z.ai 额度来自各自的 API。开销根据宿主上报的用量在本地估算，帮你跟踪消耗，但不替代服务商账单。

安装

从 npm 安装：

dsh plugin --profile web add deepseek-harness-wallet

或者从 GitHub main 安装：

dsh plugin --profile web add github:feibi-mochi/deepseek-harness-control-center

重启 dsh web，然后强制刷新页面。

快速上手

1. 点击钱包卡片或峰谷卡片，打开它的控制面板；打开 Harness 设置卡片可以做健康检查与兼容性检查。
2. 峰谷卡片支持横向/纵向布局，以及 100%–120% 缩放。钱包卡片用另一套缩放：在输入框里是 100%–105%，停靠或浮动时最高 125%。
3. 想要更小的卡片，就把官方充值按钮关掉；官方行和第三方行也可以各自单独显示。
4. 把卡片拖到任意空白区域。如果改完布局后不好找，用面板里的 Reset/Dock（归位/停靠） 把它送回侧边栏。
5. 卡片跟随宿主的浅色/深色主题。升级后强制刷新一次，确保加载新的客户端 bundle。

更新

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 卸载它。

浏览器、桌面端与操作系统兼容性

见 0.3.13 兼容性证据。官方 0.1.5-alpha.1 宿主不提供本插件的永久删除能力，所以那个开关保持禁用；旧的源码集成补丁不能直接当升级包用。
客户端里没有针对操作系统的功能分支，它只检查自己需要的 Web 与宿主能力。这样同一份代码就能跨平台，但代码可移植不等于真机验证过：

| 验证层级 | 覆盖范围 |
| 当前本地验证 | Windows + Node 24.18.1 + DSH 0.1.5-alpha.1；无密钥 Web UI 与隔离生命周期检查。未做付费 API 实网验收 |
| 精确宿主覆盖 | 本次更新检查了 0.1.5-alpha.1；更早的 0.1.2-alpha.3/alpha.4/alpha.5/rc.1 证据属于之前的钱包版本。其他版本仍未验证 |
| 自动化兼容性检查 | 浏览器通知失败、页内兜底、跨标签页兜底、存储兜底、CSS 缩放兜底，以及同步/异步桌面适配器 |
| 能力兼容目标 | Windows/macOS/Linux 上的当前 Chrome、Edge、Firefox；macOS 上的 Safari；提供下列要求的 Electron/Tauri 风格 DSH 包装器 |

最后一行说的是预期兼容性，并不代表每个浏览器/操作系统/包装器组合都实测过。如果系统通知不可用或被拒绝，提醒会退回页内提示；如果 Web Locks 不可用，就用可续期的本地存储租约在标签页之间协调提醒归属。CSS zoom 也有 transform 兜底。钱包核心数据、控件、拖拽、停靠、缩放和可见性设置都走这些共享路径，而不是检查操作系统名称。

Electron、Tauri 和其他 DSH 桌面包装器只要提供常规的 DSH Web 插件加载器、插槽、钱包 HTTP 端点、DOM 和 fetch，就能运行钱包。如果包装器限制了原生通知、持久化存储或外部链接，可以在插件包加载前定义一个可选适配器：

window.__DSH_WALLET_ADAPTER__ = {
// All fields are optional. Keep storage synchronous and localStorage-compatible.
storage: { getItem, setItem, removeItem },
notify({ title, body, tag, requireInteraction, onClick, onClose }) {
// May return a notification-like handle, Promise, or nothing.
// Call the supplied onClick/onClose callbacks for native events.
},
requestNotificationPermission() { return 'granted' },
openExternal(url) { return true },
capabilities: { permanentDelete: true },
}
notify() 可能返回一个类似通知的句柄、一个 Promise，或者什么都不返回，用于原生 API 的即发即忘场景。payload 里还带有 onClick / onClose 回调，这样 Electron IPC、Tauri 通知动作以及其他桌面桥接层就能回传事件，不必复制钱包逻辑；返回 false 表示要求钱包改用浏览器兜底方案。requestNotificationPermission() 对 Tauri、macOS 这类需要原生权限请求的宿主是可选项。openExternal() 返回 false 同样表示要求钱包尝试浏览器兜底方案。只有当宿主真正实现了钱包偏好和会话菜单动作时，才声明 permanentDelete；兼容的宿主会自动声明它，不支持的宿主则显示一个禁用控件，而不是一个毫无作用的开关。平台适配刻意限制在 src/client/core.js 里的 createCompatibilityAdapter() 中，这样智能体添加新包装层时，无需改动钱包记账或 UI 逻辑。

对于可构建的 DSH 宿主，npm 包和仓库包含一套带版本号的 智能体辅助永久删除集成套件，其中有中文指南、完整的智能体提示词、只读预检、兼容性清单、上游声明，以及一份精确基线的参考补丁。这个补丁不是通用安装器：不同的 DSH 提交必须按语义检查并适配，闭源或无法重新构建的桌面应用仍然不受支持。

可选的宿主集成

永久会话删除由宿主实现，不由钱包实现。它的开关在官方 0.1.5-alpha.1 宿主上仍处于禁用状态。如需源码集成，请参阅指南和智能体适配提示词；旧的参考补丁不能直接用于较新的宿主。

数据与信任

客户端开发现在使用 src/client/ 下的五个可读文件，以及一个提交进仓库的 lib/client.js 产物；修改源码后请运行 npm ci、npm run build:client 和 npm run check:client。安装过程不运行任何构建脚本。精确版本的冒烟检查记录在 0.3.10 兼容性证据中。

| 项目 | 行为 |
| Token 记账 | 监听 llm/stream 事件，按会话和服务商分桶：deepseek-official 以及显式选择加入的包装路由使用官方桶；其他服务商仍归为第三方；每个用量事件还会锁定当时的官方价格，因此多个会话和多个定价窗口永远不会混淆。 |
| 余额 | 钱包插件自身只把当前激活的密钥直接发送到官方 /user/balance 端点。启用多账号切换后，选中的密钥也会写入 DSH 凭据接缝；DSH 之后可能会用它发起模型请求。 |
| Accounts | 密钥加密存放在 $DSH_HOME/storages/accounts.json，另有一份加密的 accounts.json.bak 作为兜底，应对主文件缺失、损坏或无法解密的情况。Windows 使用当前用户 DPAPI；其他平台使用仅限所有者访问的 AES-GCM 密钥文件，所以迁移时要同时移动 accounts.json、.bak 和 .key。如果两份副本都读不出来，账户写入会失败关闭。 |
| Usage ledger | 本地事件和自定义第三方价格规则存放在 $DSH_HOME/storages/wallet.json，另有一份 wallet.json.bak 用于恢复。主文件缺失或损坏时会自动恢复；如果两份副本都读不出来，钱包写入会失败关闭。最多保留 365 天、20,000 条事件，内容涵盖会话/服务商/模型/token 元数据和官方锁定成本——绝不包含提示词、工具参数、响应体或 API 密钥。第三方估算会按当前自定义规则和每条保留事件的发生时间重新计算；没有保留时间戳的聚合用量会安全回退到基础费率。 |
| Local settings | 布局、缩放、可见性、提醒和面板设置存放在浏览器兼容的本地存储中。 |
| Permanent deletion | 需主动开启，且由宿主控制。除非宿主实现了匹配的会话删除路径，钱包不会对外宣传该操作。 |
| Model surface | 不注册任何工具，不注入提示词，零 token 成本。 |
| Recharge | URL 硬编码为官方 https://platform.deepseek.com/top_up，用户不可配置（防钓鱼）。 |

Pricing timeline

人民币每 1M token，整理自官方公告（缓存写入不计费）：

- Since 2025-02-09 — deepseek-chat 2/8（缓存读取 0.5），deepseek-reasoner 4/16（缓存读取 1）
- Since 2026-04-24 — v4-flash 1/2（缓存读取 0.02），v4-pro 3/6（缓存读取 0.025）
- Since 2026-08-17 00:00 Beijing — v4 模型启用高峰/低谷定价（高峰时段为北京时间 09:00–12:00 / 14:00–18:00；低谷费率为高峰的一半）：
- v4-flash（低谷 / 高峰）：缓存读取 0.05 / 0.10，输入 1.5 / 3，输出 4.5 / 9
- v4-pro（低谷 / 高峰）：缓存读取 0.15 / 0.30，输入 4.5 / 9，输出 13.5 / 27
- Since 2026-08-21 — v4-flash-vision-exp 发布，采用 V4 Flash 高峰/低谷表：缓存读取 0.05 / 0.10，输入 1.5 / 3，输出 4.5 / 9。
- Since 2026-08-23 00:00 Beijing — 周六和周日不再划分高峰/低谷时段；周末调用全天使用低谷费率。工作日高峰时段仍为 09:00–12:00 和 14:00–18:00。

历史 deepseek-chat 和 deepseek-reasoner 记录保留原有的固定费率表；这并不表示这些旧模型名称目前仍然可用。每条用量事件在到达时定价；从 0.1.2 升级时会用当时的费率一次性迁移旧计数器。成本为估算值；以 API 返回的余额为准。

Roadmap

- [x] 365-day Token heatmap and rebuildable local usage ledger
- [x] Z.ai Coding Plan Global/China monitoring on a generic official-plan adapter contract
- [x] 用户自定义第三方服务商/模型 base 与分时定价
- [ ] 仅在真实账号验证通过后，才添加更多服务商价格/余额适配器

License

MIT