🫘 dsh-suanpan（算盘）

三合一用量监控插件：一个插件同时监控 DeepSeek 余额、MiniMax Coding Plan 配额、OpenCode Go 订阅配额，以 /usage 命令 + composer 读条 + 悬浮窗面板三种形态呈现。

Unified usage monitor for dsh web: DeepSeek balance · MiniMax Coding Plan quota · OpenCode Go subscription quota, in one plugin — /usage command, composer readout and a floating panel.

---

中文 · English

✨ 功能一览

能力	说明
💳 DeepSeek 余额	官方 /user/balance 端点：可用/赠送/充值明细 + 峰谷计价时段（北京时间工作日 09:00-12:00 / 14:00-18:00 峰价，周末全天谷价）
📊 MiniMax Coding Plan	官方 /v1/coding_plan/remains 端点：每个模型的 Rolling / Weekly / Monthly 窗口配额、已用百分比、剩余倒计时
🎯 OpenCode Go	官方 /zen/go/v1/usage 端点：Rolling (3d) / Weekly / Monthly 窗口已用百分比与重置时间
⌨️ /usage 命令	/usage [deepseek|minimax|opencode] [rolling|weekly|monthly] [--json]，支持别名（ds/mm/ocg），未指定 provider 时输出全部三家
🧲 Composer 读条	输入框右下角常驻读条，按当前选中模型自动切换对应通道；其他 provider 自动隐藏；每 60s 刷新
🖥️ 悬浮窗面板	侧边栏底部入口，左下角 dock 一行三家汇总（颜色区分健康度），点击展开详情面板，每 5 分钟自动刷新
🔒 密钥安全	三家 API key 全部经 DSH 凭据 seam 在 host 端解析，绝不进入浏览器；key 名别名回退兼容不同环境

🔑 凭据配置（三选一，全配全显）

写入 ~/.dsh/.credentials.yaml：

DEEPSEEK_API_KEY: sk-...        # DeepSeek（兼容别名：无）
MINIMAX_API_KEY: sk-cp-...      # MiniMax（兼容别名：MINIMAX_CN_API_KEY）
OPENCODE_API_KEY: sk-...        # OpenCode Go（兼容别名：OPENCODE_GO_API_KEY）

也可设环境变量。缺哪个 key，对应通道在 UI 中显示 n/a，其余通道不受影响。

📦 安装

一键脚本（macOS/Linux）：

bash <(curl -sL https://raw.githubusercontent.com/mrzhangkris/dsh-suanpan/main/install.sh)

手动安装：

# 1. 进 web profile
cd ~/.dsh/profiles/web

# 2. 装依赖（npm 或 pnpm 均可）
npm install dsh-suanpan --save
# 或 pnpm add dsh-suanpan

# 3. 在 package.json 的 dsh.profile.bundles 中加入 "dsh-suanpan"
# 4. 在 cordis.patch.yml 追加：
# - insert:
#     - id: suanpan
#       name: 'dsh-suanpan'

# 5. 重启 dsh web 并硬刷新浏览器

本插件已声明 cordis.patch.yml bundle patch，若通过 dsh plugin add 安装会自动合入。

🧮 使用

• 输入 /usage 查看三家汇总报告
• 输入 /usage minimax weekly --json 查看 MiniMax Weekly 窗口原始 JSON
• 选中 DeepSeek/MiniMax/OpenCode 模型时，输入框右下角出现对应读条
• 点击侧边栏底部算盘图标展开悬浮窗面板

🧩 实现说明

• 借鉴：dsh-usage（Aisland-SJL, MIT）的 dock/panel 悬浮窗结构；dsh-usage-minimax-cn / dsh-usage-opencode-go / dsh-usage-deepseek（jooey, MIT）的端点语义与 Typert 分层。三者均为 MIT，本插件按 MIT 保留署名并重写实现。
• 架构：host 端三家查询器（lib/logic/，纯 fetch、零依赖、可单测）→ Typert 远程服务 suanpan/snapshot → 浏览器端读条与悬浮窗共用一份归一化快照。
• 测试：node --test test/ 覆盖归一化、key 别名回退、命令参数解析（12 用例）。

🗂️ 结构

lib/
├── index.js                # host 入口：/usage 命令 + Typert 网关
├── client.js               # 浏览器端：读条 + 悬浮窗
├── typert.host.js          # host Typert 清单
├── typert.remote-client.js # client Typert 清单
└── logic/
    ├── deepseek.js         # DeepSeek 余额 + 峰谷时段
    ├── minimax.js          # MiniMax Coding Plan 配额
    └── opencode.js         # OpenCode Go 配额
test/logic.test.js          # 冒烟测试

📄 License

MIT © mrzhangkris

---

English

A unified usage monitor for the DeepSeek Harness web GUI, covering DeepSeek balance, MiniMax Coding Plan quota and OpenCode Go subscription quota in one plugin.

Features

Capability	Description
💳 DeepSeek balance	Official /user/balance: available/granted/topped-up breakdown + peak/off-peak pricing window (Beijing weekdays 09:00-12:00 / 14:00-18:00 peak; weekends all-day off-peak)
📊 MiniMax Coding Plan	Official /v1/coding_plan/remains: per-model Rolling/Weekly/Monthly quota, used %, countdown to reset
🎯 OpenCode Go	Official /zen/go/v1/usage: Rolling (3d)/Weekly/Monthly used % and reset time
⌨️ /usage command	/usage [deepseek|minimax|opencode] [rolling|weekly|monthly] [--json], aliases ds/mm/ocg, all providers when omitted
🧲 Composer readout	Bottom-right chip that auto-switches by the currently selected model's provider; hides for other providers; refreshes every 60s
🖥️ Floating panel	Sidebar footer entry; bottom-left dock with one-line summary per provider (color-coded), click to expand details; refreshes every 5 min
🔒 Key safety	All three API keys resolved on the host through the DSH credentials seam — never sent to the browser; alias fallback for key names

Credentials

In ~/.dsh/.credentials.yaml (or env vars):

DEEPSEEK_API_KEY: sk-...     # alias fallback: none
MINIMAX_API_KEY: sk-cp-...   # alias fallback: MINIMAX_CN_API_KEY
OPENCODE_API_KEY: sk-...     # alias fallback: OPENCODE_GO_API_KEY

Missing keys degrade gracefully: the corresponding channel shows n/a, others keep working.

Install

One-liner (macOS/Linux):

bash <(curl -sL https://raw.githubusercontent.com/mrzhangkris/dsh-suanpan/main/install.sh)

Or manually:

cd ~/.dsh/profiles/web
npm install dsh-suanpan --save
# add "dsh-suanpan" to dsh.profile.bundles in package.json
# append to cordis.patch.yml:
# - insert:
#     - id: suanpan
#       name: 'dsh-suanpan'
# restart dsh web and hard-refresh

Usage

• /usage — all three providers
• /usage minimax weekly --json — raw JSON for the MiniMax weekly window
• Select a DeepSeek/MiniMax/OpenCode model to see the composer readout
• Click the abacus icon at the sidebar footer to open the floating panel

Credits & License

Inspired by dsh-usage (Aisland-SJL, MIT) for the dock/panel UI and the dsh-usage-* series (jooey, MIT) for endpoint semantics and the Typert layering — reimplemented here, all MIT-licensed.

MIT © mrzhangkris