wycto/dsh-balance-panel

dsh-balance-panel · DSH 模型余额面板

仓库名 dsh-model-balance；npm 包名 @wycto/dsh-balance-panel（scoped 命名，绑定 npm 账号 wycto，杜绝包名冲突；旧无前缀名 dsh-balance-panel 已废弃）。 DeepSeek Harness 插件：在侧边栏底部显示当前 DSH 配置的所有模型 Provider 的账号余额， 点击打开余额面板查看每个 Provider 的模型列表、密钥状态与余额明细。

功能特性

• 只列已配置项：只展示你在 settings 里实际配置过的 Provider（user/base 层有 profile，或为默认模型选中的 Provider）与其实际配置的模型；休眠声明与 schema 默认的全量模型列表不会出现。
• 真实余额：内置 DeepSeek 官方 /user/balance 接口；其他 Provider 可自定义余额接口（见下文）。
• 密钥状态：每个 Provider 显示其 apiKeyEnv 凭证是否已配置（密钥本身永不出 Host 进程）。
• 侧边栏入口：设置按钮旁的小胶囊显示当前余额摘要（如 余额 64.23 CNY），每 5 分钟自动刷新。
• 余额面板：点击胶囊打开全屏面板，逐 Provider 展示模型 chips、余额明细（总额/赠送/充值）与状态徽标。
• 优雅降级：无密钥 / 接口不支持 / 查询失败都给出明确文案，不影响其他 Provider（不支持的显示「不支持」）。

工作原理

┌────────────────────────── 浏览器（Client 半身 lib/client.js）──────────────────────────┐
│  tool.view.cordis        ← Run 卡片内嵌余额视图（最新一次运行卡片内）                     │
│  sidebar.footer.action   ← 余额胶囊（摘要 + 点击开面板）                                  │
│  shell.overlay           ← 余额面板（已配置的 Provider / 模型 / 余额）                    │
│          │  GET /dsh-balance-panel（同源 fetch，每 5 分钟 + 手动刷新）                          │
└──────────┼───────────────────────────────────────────────────────────────────────────────┘
           ▼
┌────────────────────────── Host 进程（Host 半身 lib/host.js）─────────────────────────────┐
│ 1. llm.listConfigurableProviders()  →  声明目录（含休眠条目，逐个过滤）                   │
│ 2. settings.describe({redactSecrets}) → 按 user/base 层定位已配置 profile（默认值不算）   │
│ 3. credentials.describe/resolve    →  密钥状态 / 密钥值（只在本进程内使用）               │
│ 4. 余额策略 → fetch 余额接口（DeepSeek /user/balance 或 profile.balance 自定义）          │
│ 5. webServer 注册 GET /dsh-balance-panel，返回归一化 JSON                                     │
└───────────────────────────────────────────────────────────────────────────────────────────┘

目录结构

dsh-balance-panel/
├── package.json           # npm 包元数据 + dsh 元数据（bundle.patch / client.inject）
├── cordis.patch.yml       # 插件加载行（- insert: { id: dsh-balance-panel, name: 包名 }）
├── lib/                   # 发布产物（files 只发布 lib/ + 上述文件）
│   ├── host.js            #   Host 半身（ESM；Node 全局 fetch；注册 /dsh-balance-panel 路由）
│   └── client.js          #   浏览器半身（__ModuleLoader__ 格式 bundle，由 src/client.js 生成）
├── src/                   # 源码
│   ├── host.js            #   Host 半身源码（= lib/host.js）
│   └── client.js          #   浏览器半身源码（纯 JS，React.createElement，无 JSX）
├── scripts/
│   └── build-client.mjs   # 把 src/client.js 打包成 lib/client.js（无需 esbuild）
├── README.md              # 本文档
├── LICENSE                # MIT
└── .gitignore