余额悬浮窗（dsh-opencode-go-monitor）
DSH（DeepSeek Harness）Web UI 悬浮面板插件：四标签页 实时显示 DeepSeek / Command Code GOAT / OpenCode Go / Charm Hyper 的余额（标签切换带滑动+淡入动画）。
功能
- 四标签页：DeepSeek 余额 / Command Code GOAT 余额 / OpenCode Go 额度 / Charm Hyper 余额，点击切换，带方向滑动 + 淡入动画
- OpenCode Go 页：官方订阅额度三窗口（滚动 / 每周 / 每月）：剩余 %（绿≥50% / 橙≥25% / 红<25%）+ 进度条 + 已用 % + 重置倒计时，外加最近一次窗口重置倒计时
- Command Code GOAT 页：5 小时 / 每周 两档滚动窗口：剩余 %（绿≥50% / 橙≥25% / 红<25%）+ 进度条 + 已用 % + 重置倒计时，外加 月度余额（美元：月度+已购+免费三池合计）
- DeepSeek 页：余额、预计剩余 tokens（按官方现行价 + 本账户用量结构折算的有效单价估算，尾注当前空闲/高峰时段与单价）、当前模型
- Charm Hyper 页：余额（hypercredits）+ 约合美元（官方 balance_usd，或按 20 hc ≈ $1 折算）
- 可拖动（位置记忆）、右下角调整大小（尺寸记忆）
- 轮询：DeepSeek 每 30s、Command Code GOAT 每 60s、OpenCode Go 每 60s、Charm Hyper 每 30s
> 已移除原「省钱」功能：限额、超限断点截断、低耗压缩、官网用量分析、语音提醒、时段建议等。
预计剩余估算口径（2026-09 官方调价后）
官方现行价（¥/百万 tokens，空闲时段价；高峰时段 = 空闲 × 2）：
| 模型 | 输入·缓存命中 | 输入·缓存未命中 | 输出 |
|---|---|---|---|
deepseek-flash（旧名 deepseek-v4-flash / deepseek-v4-flash-vision-exp 现由 V4.1-Flash 提供服务，按 Flash 计费） |
0.02 | 1 | 4 |
| deepseek-v4-pro | 0.15 | 4.5 | 13.5 |
- 高峰时段：北京时间周一至周五 09:00-12:00、14:00-18:00；其余时间（含周末全天）为空闲时段
- 有效单价＝输入侧（缓存命中率加权）× 输入占比 ＋ 输出价 × 输出占比；命中率与占比取本账户 2026-08 官网平台实测（命中 721.98M / 未命中 6.84M / 输出 4.69M → 命中率 99.1%、输出占比 0.6%）
- 推算结果：Flash 空闲 ≈ ¥0.0546/百万、高峰 ≈ ¥0.1092/百万；Pro 空闲 ≈ ¥0.2759/百万、高峰 ≈ ¥0.5518/百万
- 面板「预计剩余」＝ 余额 ÷ 当前时段有效单价，行尾标注「空闲/高峰 + 单价」；鼠标悬浮可看完整口径（官方三档价、命中率、另一时段估算）
- 对照 2026-09 调价前（Flash 命中 0.05 / 未命中 1.5 / 输出 4.5）：同余额下预计剩余约为调价前的 2.2 倍
- 价格来源：DeepSeek 官方「模型 & 价格」页
> 估算仅为参考：实际花费取决于缓存命中率、输出占比与所用模型；切换模型（Flash ↔ Pro）后按对应价目重算。命中率与占比是本账户实测常数（其他部署请按自己账号的平台月报改 DS_USAGE_SAMPLE），改价只改 DS_PRICE_OFFPEAK 一处即可。
>
> 未建模：法定节假日（官方公告里也按空闲计价，影响 <1%）；若 V4 Pro 后续改由 Flash 提供服务，按模型名仍走 Pro 价目（估算偏保守）。
前置条件
| 依赖 | 说明 |
|---|---|
| DeepSeek Harness（web 或桌面端） | 插件运行在 DSH 内 |
| DeepSeek API key | DSH 设置 → 凭据 添加 DEEPSEEK_API_KEY（DeepSeek 余额标签页用） |
| Command Code GOAT 订阅 + API key | DSH 设置 → 凭据 添加 COMMANDCODE_API_KEY（在 commandcode.ai/settings 创建，user_ 开头；也兼容 COMMAND_CODE_API_KEY 命名或环境变量 COMMAND_CODE_API_KEY，未配置时尽力而为读取 Command Code CLI 登录凭据 ~/.commandcode/auth.json） |
| Charm Hyper 订阅 + API key | DSH 设置 → 凭据 添加 HYPER_API_KEY（兼容 HYPERCHARM_API_KEY 命名或环境变量） |
| OpenCode Go 订阅 | DSH 设置 → 凭据 添加 OPENCODE_GO_API_KEY（兼容 OPENCODE_API_KEY / 同名环境变量）；未配置时自动读 opencode 登录凭据 ~/.local/share/opencode/auth.json 的 opencode-go 条目，WSL 下还会探测 Windows 用户目录 /mnt/c/Users/<用户>/.local/share/opencode/auth.json |
隐私说明
- API key 只在进程内存中使用，用于调用官方余额接口，不落盘、不写日志、不发给任何第三方
- 仓库内不含任何密钥 —— 每个部署者在自己的机器上配置自己的凭据，看到的是自己的余额
安装
方式一：标准流程（热加载）
- 把插件文件夹（含
package.json和lib/）整个复制到$DSH_HOME/profiles/node_modules/dsh-opencode-go-monitor/ - 编辑
$DSH_HOME/profiles/web/cordis.patch.yml（没有则新建，内容为[]），追加：
# 余额悬浮窗
- insert:
- id: opencode-go-monitor
name: 'dsh-opencode-go-monitor'
cordis.patch.yml修改会热加载，无需重启；刷新浏览器页面（Ctrl+Shift+R）即可看到面板- 配置凭据：DSH 设置 → 凭据 → 添加
DEEPSEEK_API_KEY、COMMANDCODE_API_KEY、HYPER_API_KEY
方式二：super-injector（如果装有）
dev_install_package dir=<本文件夹绝对路径>
排错
| 现象 | 处理 |
|---|---|
| 状态行「余额失败：未配置 COMMAND_CODE_API_KEY 凭据」 | DSH 设置 → 凭据 添加 COMMANDCODE_API_KEY，或设置环境变量 COMMAND_CODE_API_KEY，或确认已 cmd login（自动读取 ~/.commandcode/auth.json） |
| 状态行「余额失败：HTTP 401」 | key 无效/过期，到对应服务商控制台重新生成 |
| DeepSeek 余额显示为负 | 账户余额已用超，注意在 platform.deepseek.com 充值 |
| 面板完全不显示 | 确认 cordis.patch.yml 注册行格式、profiles/node_modules/dsh-opencode-go-monitor 路径；浏览器硬刷新（Ctrl+Shift+R）；F12 控制台看红色报错 |
卸载
- 从
cordis.patch.yml删除注册行（热加载立即移除） - 删除
profiles/node_modules/dsh-opencode-go-monitor/文件夹
结构
├── package.json # 插件清单（dsh.client 双半声明）
└── lib/
├── index.js # host 半：/api/commandcode-goat/balance（GOAT 官方接口，60s 缓存）
│ # /api/deepseek/balance（DeepSeek 官方接口，5s 缓存）
│ # /api/opencode-go/balance（OpenCode Go 官方 /usage 接口，60s 缓存）
│ # /api/hypercharm/balance（Charm Hyper 官方接口，30s 缓存）
└── client.js # client 半：shell.overlay 悬浮面板（拖动/缩放/位置记忆）
└── test/
└── client-smoke.mjs # 无浏览器冒烟测试（最小 React/DOM shim 跑渲染路径并断言四标签页）
自测
node test/client-smoke.mjs # 不依赖 DSH / 浏览器，全 PASS 则四标签页（含 OpenCode Go 面板）渲染正常
