在使用 DeepSeek Harness 时，如果同时运行多个会话或后台任务，容易忽略当前的负载情况。如果没有显式的 UI 指示，很难直观看到有多少会话处于活跃状态，或者 API 配额是否即将耗尽。此插件通过右下角卡片解决了这个问题。
插件简介¶
插件名称为 lovstudio/dsh-account-balance，由用户 lovstudio 维护。它是一个组合行，安装在 DeepSeek Harness 网页端后，会固定在界面右下角。插件负责统一展示当前会话和后台任务的状态，以及 GLM、KIMI 的配额条和 OpenRouter、DeepSeek 的余额信息。
核心功能¶
-
会话与任务状态
显示当前会话和后台任务的数量。卡片会显示为「空闲」或「N 会话 · M 任务」的形式。状态每 3 秒轮询一次，通过ctx.agents.list()和ctx.jobs.list()获取内存快照。 -
配额可视化
针对 GLM 和 KIMI，显示 5 小时和每周的配额条。配额条颜色根据使用率变化：绿色（<50%）、橙色（≥50%）、红色（≥80%）。鼠标悬停可查看具体使用量、剩余量及重置倒计时。 -
余额显示
显示 OpenRouter（美元）和 DeepSeek（人民币）的剩余余额。余额数据通过 Host API 每 60 秒轮询一次，并在缓存中保存 55 秒。 -
Host API 暴露
插件通过 Host API 暴露了两个接口：accountBalance.status(): 返回{ sessions, tasks }。accountBalance.quotas(): 返回{ at, rows: { glm, kimi, or, ds } }。
安装与启用¶
在安装前，请确保环境满足以下要求：
* Node.js 22.19+ 或 24+
* pnpm 11
使用以下命令安装插件：
pnpm dsh plugin --profile web add -w github:lovstudio/dsh-account-balance#v0.1.3
安装后，重启 DSH Web 界面即可看到右下角的卡片。插件是组合行，安装后会存活于页面重启。
典型用法¶
UI 直接查看¶
无需配置。插件会自动读取凭证服务中的凭据并展示数据。如果缺少某个 API Key，对应行会显示为「—」。
通过 Host API 获取状态¶
可以通过 accountBalance.status() 方法获取当前的会话和任务快照：
const result = await accountBalance.status();
// result.data 为 { sessions: number, tasks: number }
通过 Host API 获取配额¶
通过 accountBalance.quotas() 获取包含 GLM、KIMI、OpenRouter、DeepSeek 四家提供商的配额快照：
const result = await accountBalance.quotas();
// result.data 为 { at: string, rows: { glm, kimi, or, ds } }
适用场景与注意事项¶
适用场景：
* 需要持续监控 DeepSeek Harness 后台任务运行情况的用户。
* 需要直观查看 GLM/KIMI 配额消耗，避免超额扣费的用户。
* 需要通过 API 集成余额和状态数据的开发者。
注意事项：
* 权限与可见性：jobs.list() 的可见性可能受限。非当前会话拥有的作业可能不计入 tasks 统计中。
* 无模型调用：插件本身不执行任何模型调用，因此不会产生 Token 消耗，也不会影响 KV Cache。
* 容错处理：GLM 和 KIMI 的 API 形状变化时，插件会显示 no-data 而不是崩溃。
* 凭证读取：插件直接通过 ctx.credentials 读取凭据，不会将凭据发送到外部。
