省钱+余额监控悬浮窗（dsh-opencode-go-monitor）

DSH（DeepSeek Harness）Web UI 悬浮面板插件：双标签页 实时显示 DeepSeek 与 OpenCode Go 的额度余额（标签切换带滑动+淡入动画）。

• 双标签页：DeepSeek 余额 / OpenCode Go 余额，点击切换，带方向滑动 + 淡入动画
• OpenCode Go 页：月度 / 滚动 / 每周 三档额度：剩余 %（绿≥50% / 橙≥25% / 红<25%）+ 进度条 + 已用 % + 重置时间
• DeepSeek 页：余额、预计剩余 tokens（按 ¥4/百万估算）、当前模型、官网平台用量（当月 token 总量 / 花费金额 / API 请求次数 / 日均）
• 可拖动（位置记忆）、右下角调整大小（尺寸记忆）
• 轮询：DeepSeek 每 30s、OpenCode Go 每 60s、官网用量每 30s

省钱功能

• DeepSeek 官方高低价时段（自动展示）：高峰 = 北京时间 09:00-12:00 / 14:00-18:00，其余为空闲时段（半价）；面板显示当前时段状态与距下次切换倒计时（DeepSeek 页，纯时间计算）
• 限额（金额 + tok 量，DeepSeek 页）：
  • 「省钱」开关：显示 每日金额 / 每日 tok 两条进度条（今日用量来自官网平台），超限红色告警（金额超限 / tok 超限分别提示）
  • 「分析」按钮循环切换两种模式（设置里也有选择）：
    • 关：仅手动限额
    • 官网用量分析：基于官网平台当月数据（活跃日平均）——每日建议 = 官网日均 token / 金额；每小时建议 = 日均 ÷ 24；高价时段 2 倍价建议每小时用量减半
  • 分析建议显示在悬浮窗，点「采纳」一键套用到手动限额（分析模式永不自动修改限额）：每日 tok=官网日均、每日金额=官网日均金额
• 金额来源：全部金额来自 DeepSeek 官网平台（/api/v0/usage/cost，人民币），不再采用本地网关记账或本地推算
• 官网平台用量（DeepSeek 页，可选）：配置凭据 DEEPSEEK_PLATFORM_TOKEN（登录 platform.deepseek.com 后，浏览器 DevTools → 存储 → Local Storage → userToken 的值）后，显示官网当月 token 总量 / 花费金额 / API 请求次数与日均（官方控制台私有端点 /api/v0/usage/amount|cost）；未配置时显示提示。用量数据全部以官网为准（已移除本地 opencode 记录）
  • 金额单位：设置 → 常规可选「人民币 ¥ / 美元 $」，全部金额（余额、今日/累计花费、限额、建议金额）统一按所选单位换算显示；汇率自动获取（USD→CNY，失败时用默认值）
  • 高价区每小时限额：设置 → 常规：高价区每小时 tok 上限(手动，高峰自动减半)——填基准每小时（= 官网日均 ÷ 24），高峰时段（09-12/14-18）自动减半即高价区生效上限；小时颗粒度 = 官网日数据定基准 + 本地 session 事件推算实时增量（监听每轮 agent 请求的 provider token 用量累计当前小时）；面板「小时」进度条显示当前小时 token / 生效限额，接近或超限有红色告警与语音提醒（小时超限不拦截请求，仅提醒）
  • 设置 → 常规：每日金额上限(手动) / 每日 tok 上限(手动) / 高价区每小时 tok 上限(手动，高峰自动减半) 手动输入 + 金额单位 + 分析模式选择
• 额外功能：超限断点截断（默认关，开启前有确认警告）：今日金额或 tok 超限后，模型回复允许完整生成并执行工具调用（工具请求是天然断点），随后拦截后续请求——不截断思考链、不回传异常 reasoning context；超限后 agent 不再响应新请求，调整限额或关闭本功能即恢复（今日用量 = 官网平台；官网日统计未结算时今日为 0，不触发拦截）
• 额外功能：低耗压缩（工具结果只留变化）（默认关，开启前有确认警告）：高峰时段（09-12 / 14-18，可关）且用量达到阈值（默认 80%）时，较长工具结果自动与上次执行结果做行级 diff，只保留变化行（完全相同则只剩一句"无变化"），大幅降低上下文与花费；开启弹窗会提醒与断点截断搭配使用最佳（压缩先省输入、超限再硬停）
• 语音提醒（TTS）：接近限额（剩余 ≤2%）小音量提醒、达到限额大音量提醒；音量可调（接近 0-1 / 超限 0-10），带「试听」按钮（先接近后超限连播）

本插件已合并原「余额悬浮窗」（dsh-balance-window）的面板，部署时请将旧插件注册改为 disabled（见安装步骤），避免两个面板重叠。

风格与 DSH 自带「余额悬浮窗」（dsh-balance-window，DeepSeek 余额）一致。

隐私说明（重要）

• 不依赖本地 opencode：不读取任何 opencode 配置文件；用量/金额全部来自 DeepSeek 官网平台
• API key / token 来源（按优先级）：
  1. DSH 凭据系统：写在 $DSH_HOME/.credentials.yaml 本地文件（设置 → 凭据）
  2. 环境变量兜底
• key/token 只在进程内存中使用，用于调用官方接口，不落盘、不写日志、不发给任何第三方
• 仓库内不含任何密钥 —— 每个部署者在自己的机器上配置自己的凭据，看到的是自己的余额与官网用量

前置条件

依赖	说明
DeepSeek Harness（web 或桌面端）	插件运行在 DSH 内
DeepSeek API key	DSH 设置 → 凭据 添加 DEEPSEEK_API_KEY（DeepSeek 余额标签页用）
OpenCode Go 订阅 + API key	DSH 设置 → 凭据 添加 OPENCODE_GO_API_KEY（在 opencode.ai/auth 获取）
DeepSeek 官网登录会话 token	DSH 设置 → 凭据 添加 DEEPSEEK_PLATFORM_TOKEN（查看自己官网用量/金额/小时粒度的必需项，获取方法见下）

安装

文件分享安装（zip 包，最简单）

拿到 dsh-opencode-go-monitor-1.0.0.zip（30 KB 单文件，可直接用微信/QQ/U 盘分享）后：

1. 解压得到 dsh-opencode-go-monitor/ 文件夹（内含 package.json、lib/、README.md）

2. 把整个文件夹复制到 $DSH_HOME/profiles/node_modules/ 下（Windows 默认 C:\Users\<你>\.dsh\profiles\node_modules\）

3. 编辑 $DSH_HOME/profiles/web/cordis.patch.yml（没有则新建，内容为 []），追加：

   # 省钱+余额监控悬浮窗
   - insert:
       - id: opencode-go-monitor
         name: 'dsh-opencode-go-monitor'
   

4. 保存后热加载生效，浏览器硬刷新（Ctrl+Shift+R）即可看到悬浮窗

5. 配置凭据：见下方「前置条件」与「获取 DEEPSEEK_PLATFORM_TOKEN」（登录过官网的浏览器一般会自动读取，零配置）

zip 包内不含任何密钥；需要升级时用新 zip 覆盖 lib/ 与 package.json 再刷新即可（或删掉旧文件夹重新解压）。

从 GitHub 获取

git clone https://github.com/<owner>/dsh-save-balance-monitor.git dsh-opencode-go-monitor

clone 出来的 dsh-opencode-go-monitor/ 就是插件文件夹（含 package.json 和 lib/），按下方方式一或方式二安装即可。所有密钥都不在仓库里，需要你自己配置（见上文「前置条件」与「获取 DEEPSEEK_PLATFORM_TOKEN」）。

方式一：标准流程（推荐，热加载）

1. 把插件文件夹（含 package.json 和 lib/）整个复制到 $DSH_HOME/profiles/node_modules/dsh-opencode-go-monitor/

   $DSH_HOME 默认位置：Windows ~\.dsh；macOS / Linux ~/.dsh（可用 echo $DSH_HOME 确认）

2. 编辑 $DSH_HOME/profiles/web/cordis.patch.yml（没有则新建，内容为 []），追加：

   # OpenCode Go 余额悬浮窗
   - insert:
       - id: opencode-go-monitor
         name: 'dsh-opencode-go-monitor'
   

3. cordis.patch.yml 修改会热加载，无需重启；刷新浏览器页面（Ctrl+Shift+R）即可看到面板

4. 配置凭据：DSH 设置 → 凭据 → 添加 DEEPSEEK_API_KEY、OPENCODE_GO_API_KEY，以及 DEEPSEEK_PLATFORM_TOKEN（官网用量必需，见下）

5. 若旧版「余额悬浮窗」（dsh-balance-window）还注册着，把它的 insert: 块替换为禁用条目：

   - id: balance-window
     disabled: true
   

获取 DEEPSEEK_PLATFORM_TOKEN（查看自己官网用量/金额）

DeepSeek 官网控制台的用量/金额端点需要登录会话 token（API key 认证不了）。每个用户都要用自己的。

插件会先尝试自动读取：启动后自动扫描本机 Chrome / Edge / 360 极速浏览器（含各 profile）的 Local Storage，找到 platform.deepseek.com 域下的 userToken 并用官网实体验证后直接使用——只要你在这些浏览器里登录过官网，通常无需任何手动配置（读到的 token 只在内存中使用，不落盘、不写凭据文件）。

⚠ 自动读取是"尽力而为"：token 若被浏览器压缩进 LevelDB 的 snappy 块（旧数据），可能读不到。此时按下面手动配置一次即可（读不到时面板会有提示）。

手动配置（自动读取无效时）：

1. 用任意浏览器（Chrome / Edge / 360 极速「极速模式」）登录 https://platform.deepseek.com
2. 打开开发者工具：F12（或右键 → 检查）
3. 切到 Application / 应用程序 → Local Storage / 本地存储 → https://platform.deepseek.com
4. 找到键 userToken，复制它的值（很长一串，eyJ... 开头）
   • 若找不到：切到 Console / 控制台，输入 localStorage.getItem('userToken') 回车，复制引号里的内容
5. 把这段值填到 DSH 设置 → 凭据 → DEEPSEEK_PLATFORM_TOKEN（或写进 ~/.dsh/.credentials.yaml：DEEPSEEK_PLATFORM_TOKEN: <值>）
6. 面板 DeepSeek 页 30 秒内出现「官网当月」行（token 总量 / 花费 / 请求次数 / 日均）即成功

⚠ token 与你的官网登录会话绑定：退出登录、清理浏览器缓存后失效，重新按上面取一次即可。token 只存在你自己机器的凭据文件里，绝不提交进代码/仓库。

方式二：super-injector（如果装有）

dev_install_package dir=<本文件夹绝对路径>

自定义（环境变量）

变量	默认值	说明
OGM_API_KEY	—	OpenCode Go 备用 key（无 DSH 凭据时使用）
OGM_PLATFORM_TOKEN	—	DeepSeek 官网 userToken 备用（无 DSH 凭据时使用）
OGM_BASE	https://opencode.ai/zen/go/v1/usage	余额接口地址

排错

现象	处理
状态行「余额失败：未配置 OPENCODE_GO_API_KEY 凭据」	DSH 设置 → 凭据 添加 OPENCODE_GO_API_KEY，或设置环境变量 OGM_API_KEY
状态行「余额失败：HTTP 401」	key 无效/过期，到 opencode.ai/auth 重新生成
面板 DeepSeek 页「官网用量: 未配置 DEEPSEEK_PLATFORM_TOKEN 凭据」	按上文「获取 DEEPSEEK_PLATFORM_TOKEN」配置
面板「官网用量: Platform token 无效或已过期」	token 失效，重新从浏览器 localStorage 取新的
DeepSeek 余额显示为负	账户余额已用超，注意在 platform.deepseek.com 充值
面板完全不显示	确认 cordis.patch.yml 注册行格式、profiles/node_modules/dsh-opencode-go-monitor 路径；浏览器硬刷新（Ctrl+Shift+R）；F12 控制台看红色报错
两个面板重叠	直接把其中一个拖开即可（位置记忆）

卸载

1. 从 cordis.patch.yml 删除注册行（热加载立即移除）
2. 删除 profiles/node_modules/dsh-opencode-go-monitor/ 文件夹

结构

├── package.json      # 插件清单（dsh.client 双半声明）
└── lib/
    ├── index.js      # host 半：/api/opencode-go/balance（官方接口，凭据读 key，60s 缓存）
    │                 #       /api/opencode-go/usage（可选：本地 SQLite 只读聚合）
    └── client.js     # client 半：shell.overlay 悬浮面板（拖动/缩放/记忆）