feibi-mochi/deepseek-harness-control-center

DeepSeek Harness 控制中心

npm version
GitHub release
CI
DeepSeek Harness
License: MIT

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

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

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

一款本地优先的配套工具，将账户状态、按对话用量、完成提醒、官方充值、灵活布局以及由宿主控制的会话管理功能，置于 DSH 输入框旁。

版本： v0.3.13。

如果 DeepSeek Harness 控制中心对你有帮助，欢迎点个 ⭐ 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 拆分、针对活动账户和货币的可自由编辑低余额阈值（两位小数，按账户持久化；警报绝不混用货币）、手动刷新，以及跳转到官方充值页面（首次点击会显示域名以供确认——反钓鱼）。
- 移动、停靠和缩放 — 自由拖动芯片，预览附近的吸附目标，使用紧凑的水平或垂直布局，从控制面板调整其缩放比例，并独立显示官方或第三方数据。峰值时钟背景可以显式设置为透明（悬停时变为纯色）或纯色；没有自动模式。这些选择会在本地记住。
- Composer 标签控制和皮肤兼容性 — 独立显示/隐藏 composer 标签，或将其缩减为主要剩余值（DeepSeek 余额、Z.ai 五小时配额），而不会禁用提醒、设置、计划监控或历史记录。标准芯片还能抵抗宽泛的皮肤按钮规则，并与 maid-atelier 的 38px 海军蓝和金色 composer 工具栏对齐。
- 浮动窗口模式 — 将详情面板分离为可拖动的窗口，并记住其位置，或直接将其最小化为可自由移动的圆点；当低于阈值时，圆点变为红色。
- 完成提醒 — 可选地在对话完成时通知，支持持久或定时模式、对同时完成进行排队和去重、跨标签页协调，以及在系统通知不可用时提供页面内回退。
- 低余额警报 — 低于阈值时，芯片变为红色并带有呼吸动画，同时触发一次桌面通知；一旦余额恢复，它会自动重置。
- 主题原生 UI — 使用 DSH --dsw-alias-* 变量并带有安全回退颜色，因此浅色和深色主题都能正确渲染；点击外部时面板会关闭，并在屏幕边缘附近翻转打开方向。
- 清除当前会话钱包数据 — 一个按钮仅清除当前打开的对话的 token/成本记录；它不会删除对话，其他所有对话都不受影响。历史账本清除是单独的操作。

多账户

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

项目概览

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 不返回任何内容。载荷还包含 onClick / onClose 回调，因此 Electron IPC、Tauri 通知操作以及其他桌面桥接层可以返回事件，而无需复制钱包逻辑；返回 false 会要求钱包使用其浏览器回退方案。对于 Tauri 和 macOS 等需要原生权限请求的宿主，requestNotificationPermission() 是可选的。从 openExternal() 返回 false 同样会要求钱包尝试浏览器回退方案。仅当宿主实际实现了钱包偏好和会话菜单操作时，才声明 permanentDelete；兼容的宿主会自动声明它，而不支持的宿主会显示一个禁用控件，而不是一个没有任何效果的开关。平台适配被有意限制在 src/client/core.js 中的 createCompatibilityAdapter() 内，因此 Agent 可以添加新的包装器，而无需编辑钱包记账或 UI 逻辑。

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

可选宿主集成

永久会话删除由宿主实现，而非钱包。其开关在官方 0.1.5-alpha.1 宿主上保持禁用。如需源码集成，请参阅指南和 Agent 适配提示词；旧参考补丁并非适用于较新宿主的直接替换更新。

数据与信任

客户端开发现在使用 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 可能会将其用于后续模型请求。 |
| 账户 | 密钥以加密形式存放在 $DSH_HOME/storages/accounts.json 中，并带有加密的 accounts.json.bak 作为主文件缺失、损坏或无法解密时的回退。Windows 使用当前用户 DPAPI；其他平台使用仅限所有者访问的 AES-GCM 密钥文件，因此请将 accounts.json、.bak 和 .key 一起移动。如果两份副本都无法读取，账户写入将失败关闭。 |
| 用量账本 | 本地事件和自定义第三方价格规则存放在 $DSH_HOME/storages/wallet.json 中，并带有 wallet.json.bak 恢复副本。主文件缺失/损坏时会自动恢复；如果两份副本都无法读取，钱包写入将失败关闭。最多保留 365 天和 20,000 条事件的会话/提供商/模型/令牌元数据以及官方锁定成本——绝不保留提示词、工具参数、响应正文或 API 密钥。第三方估算会根据当前自定义规则和每个保留事件的发生时间重新计算；没有保留时间戳的聚合用量会安全地回退到基础费率。 |
| 本地设置 | 布局、缩放、可见性、提醒和面板设置保存在浏览器兼容的本地存储中。 |
| 永久删除 | 需选择加入并由宿主控制。除非宿主实现了匹配的会话删除路径，否则钱包绝不会宣传该操作。 |
| 模型表面 | 未注册任何工具，无提示词注入，零令牌成本。 |
| 充值 | URL 硬编码为官方 https://platform.deepseek.com/top_up，且用户不可配置（防钓鱼）。 |

定价时间线

每 1M 令牌的人民币价格，根据官方公告整理（缓存写入不计费）：

- 自 2025-02-09 起 — deepseek-chat 2/8（缓存读取 0.5），deepseek-reasoner 4/16（缓存读取 1）
- 自 2026-04-24 起 — v4-flash 1/2（缓存读取 0.02），v4-pro 3/6（缓存读取 0.025）
- 自 2026-08-17 00:00 北京时间起 — 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
- 自 2026-08-21 起 — v4-flash-vision-exp 发布，采用 V4 Flash 峰谷表：缓存读取 0.05 / 0.10，输入 1.5 / 3，输出 4.5 / 9。
- 自 2026-08-23 00:00 北京时间起 — 周六和周日不再划分为高峰/低谷时段；周末调用全天使用低谷费率。工作日高峰时段仍为 09:00–12:00 和 14:00–18:00。

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

路线图

- [x] 365 天 Token 热力图和可重建的本地用量账本
- [x] 基于通用官方套餐适配器契约的 Z.ai Coding Plan Global/China 监控
- [x] 用户定义的第三方提供商/模型基础与分时定价
- [ ] 仅在真实账户验证后添加额外的提供商价格/余额适配器

许可证

MIT