@shawnkung/dsh-balance-monitor
DSH Web 侧边栏余额与用量监控插件，支持 DeepSeek、Kimi、智谱 GLM 和 TeamoRouter。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @shawnkung/dsh-balance-monitor@0.1.16
Balance Monitor 以 @shawnkung/dsh-balance-monitor 发布，当前版本为 0.1.16。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
侧边栏展示选定渠道的余额；点击入口可查看各渠道详情，并在设置中调整展示、精度与凭据来源。
| 渠道 | 余额 | 每日/区间消费 | Token 用量 | 自动刷新识别 |
|---|---|---|---|---|
| DeepSeek 官方 API | 是 | 否 | 否 | deepseek.com、deepseek-official、deepseek |
| Kimi 官方 API | 是 | 否 | 否 | moonshot.cn、moonshotai-cn |
| 智谱 GLM | 是 | 否 | 否 | bigmodel.cn |
| TeamoRouter | 是 | 是 | 是 | teamorouter.cn |
Provider 配置了 baseURL 时，以实际 hostname 为准；未配置 URL 时，仅识别与余额账户体系一致的内置 Provider。未知域名、缺失 Provider 或无效 URL 不会触发兜底全量刷新。
前置条件：
dsh web 可以正常运行。dsh plugin --profile web add @shawnkung/dsh-balance-monitor@latest
dsh plugin --profile web list
安装后先在列表中确认实际版本，再重启 DSH Web 进程并硬刷新浏览器（macOS：Cmd+Shift+R；Windows/Linux：Ctrl+Shift+R）。
git clone https://github.com/ShawnKung/dsh-balance-monitor.git
cd dsh-balance-monitor
npm ci
npm run build
npm run check
npm test
dsh plugin --profile web add link:"$(pwd)"
仓库提交并发布预构建的 client.js，安装过程不会运行构建脚本。link: 会让 DSH Profile 直接引用当前目录；首次安装以及每次修改 src/client.js 后都应显式执行 npm run build。修改 Host 代码后还需要重启 DSH Web。
dsh plugin --profile web add @shawnkung/dsh-balance-monitor@latest
dsh plugin --profile web list
进入 DSH 的“设置 → 插件 → DSH Balance Monitor”：
DEEPSEEK_API_KEY。KIMI_API_KEY，调用 CN Host https://api.moonshot.cn/v1/users/me/balance。ZAI_API_KEY，通过智谱官方域名的账户接口查询按量余额。TEAMO_API_KEY。API Key 通过 DSH credentials 服务解析和写入，明文不会发送到浏览器。凭据优先级为环境变量、模型 Provider 配置、用户配置；模型凭据按 provider 的实际 API 域名匹配，并通过 apiKeyEnv 凭据引用复用。只有插件请求端点仍属于同一受支持渠道域名时才会复用；若同一渠道存在多个不同的 Provider 凭据，插件不会擅自选择。
插件启动时会刷新全部可解析到凭据的渠道。此后：
turn/start 成功创建渠道任务。baseURL 时按 hostname 匹配渠道。deepseek-official、deepseek 和 moonshotai-cn，分别刷新 DeepSeek 或 Kimi。Host 快照带有单调递增的 revision，前端会拒绝迟到的旧快照，避免启动阶段的 loading 覆盖已完成结果。
插件启动时及之后每 10 分钟会由 Host 异步检查 npm latest 版本，不阻塞 DSH 运行。更新状态由 Host 中的全局单例维护，余额弹窗和设置页只通过 HTTP/SSE 读取同一状态；任一入口点击后，两处会同步展示更新进度。Host 使用固定包名和 Registry 返回的精确 SemVer 调用当前 DSH CLI，安装结果会再次从 profile 校验，成功后显示“重启后生效”，但不会自动重启 DSH。
本地 link:、file:、Git 和 workspace 安装不会被自动替换，也不会显示 Registry 更新入口。
>=20。>=0.1.2-rc.1 <0.2.0。web。0.1.2-rc.1、0.1.5-rc.1。其他版本只有完成一次性 Profile 的安装、配置加载、Web 冷启动和卸载验证后，才会在 manifest 中标记为兼容。包不包含 preinstall、install、postinstall 或 prepare 脚本。构建只在开发者显式运行 npm run build、CI 执行 npm run ci，以及 npm 发布前执行 prepublishOnly 时发生。
运行时依赖及用途：
@deepseek-ai/schemastery：由 DSH Profile 提供的 peer dependency，用于声明插件配置 Schema；开发环境同时将其列为 dev dependency。semver：比较已安装版本与 npm Registry 返回的版本。client.js，仅作为开发依赖参与前端构建，不会作为独立运行时依赖安装。| 能力 | 使用范围 |
|---|---|
| 网络 | 请求 DeepSeek、Kimi、智谱和 TeamoRouter 的余额或用量接口；请求 registry.npmjs.org 检查插件更新。 |
| 凭据 | 仅通过 DSH credentials 服务解析、写入或移除插件声明的 API Key 引用；Key 不发送到浏览器。 |
| 文件 | 仅读取 ~/.dsh/profiles/web/package.json 和当前插件的 package.json，用于确认安装来源与版本。 |
| 命令 | 仅在用户点击插件更新后，通过当前 Node.js 进程调用当前 DSH CLI，执行固定包名和精确版本的 plugin --profile web add。 |
| 浏览器接口 | 仅接受 loopback 且同源的 HTTP/SSE 请求，用于 Host 与插件前端同步状态。 |
外部渠道请求彼此隔离；单个渠道失败不会阻塞其他渠道，并会保留上次成功结果。更新检查或安装失败不会修改当前运行版本；更新成功后也不会自动重启 DSH。未识别的 provider 不会触发兜底刷新。
ctx.credentials.resolve()；插件不直接读取环境变量或凭据文件。URL.hostname 做精确域名或子域名匹配，不使用字符串包含判断。package.json#files 白名单控制，并在 CI 中执行 tarball 审计。安全问题请参阅 SECURITY.md。
npm ci
npm run check
npm test
npm run build
完整检查：
npm run ci
npm pack --dry-run
提交信息必须遵循 Conventional Commits：
feat: add a new balance channel
fix: prevent stale snapshots from replacing fresh data
docs: clarify local installation
详细流程见 CONTRIBUTING.md。
package.json 和 CHANGELOG.md 中的版本。vX.Y.Z 的 Tag。release.yml 校验 Tag 与包版本一致后，通过 npm Trusted Publishing 自动发布，并创建 GitHub Release。MIT © ShawnKung