Plugin directory / Developer / dsh-usage-indicator
dsh-usage-indicator
Verified · install-tested on dsh TiferKing
What it does
简约的余额指示器，一眼看尽 DeepSeek 用量。上下文余量、账户余额、压缩倒计时，全部在侧边栏顶部。
Works — verified, early-stage project
简约的余额指示器，一眼看尽 DeepSeek 用量。上下文余量、账户余额、压缩倒计时，全部在侧边栏顶部。 It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
README
dsh-usage-indicator
DSH（DeepSeek Harness）Web 侧边栏插件：实时显示上下文余量、账户余额和预计下次上下文压缩轮次。数据本地闭环，API Key 不离开本机。
功能
- 上下文占用 / 模型窗口进度条，接近压缩阈值变黄、达到变红
- 账户余额进度条，低于警示线整条变红
- 「N 轮后压缩」EMA 估算，数据不足显示"评估中"
- Web 设置面板可调整满条额度与警示线，热生效
- 侧边栏收起时为紧凑圆环 + 余额状态点
安装
前置：已安装 DSH 与 pnpm（缺 pnpm 先执行 npm install -g pnpm）。
方式一：Release 包（推荐）
dsh plugin --profile web add C:\path\to\dsh-usage-indicator-<version>.tgz
方式二：源码安装（clone 即用，内置 lib/ 无需构建）
git clone https://github.com/TiferKing/dsh-usage-indicator.git
dsh plugin --profile web add .\dsh-usage-indicator
安装后重启 dsh web 生效；更新用新包再执行一次 add；卸载：dsh plugin --profile web remove dsh-usage-indicator。
使用与配置
默认读取环境变量 DEEPSEEK_API_KEY 查余额，侧边栏顶部实时显示卡片；收起侧边栏自动切换为圆环视图。Web 设置面板「API 用量指示」可修改满条额度与警示线，写入 settings.yaml 热生效。
| 字段 | 默认值 | 说明 |
|---|---|---|
apiKeyEnv |
DEEPSEEK_API_KEY |
余额接口的凭证引用 |
baseURL |
$DEEPSEEK_BASE_URL → https://api.deepseek.com |
余额接口基址（自定义网关时配置） |
refreshIntervalMs |
60000 |
host 轮询周期（毫秒），下限 30 秒 |
thresholdRatio |
0.8 |
上下文压缩阈值，需与 dsh-compaction-basic 保持一致 |
fullBalance |
100 |
资金条满条金额 |
warnBalance |
20 |
余额低于该值时资金条变红 |
开发
npm install
npm run build # 产出 lib/index.js + lib/client.js
npm run typecheck # 类型检查
npm test # 运行测试（需 Node ≥ 22.18）
结构：src/index.ts（host：轮询 + /api/usage-indicator 路由）、src/client.tsx（侧边栏卡片与设置页）、src/balance.ts（余额解析）、test/。欢迎提交 Issue 与 PR。
License
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-usage-indicator for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:TiferKing/dsh-usage-indicatorHeadless (CLI) profile:
dsh plugin --profile headless add github:TiferKing/dsh-usage-indicatorTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-usage-indicator/)<a href="https://dshbase.com/plugins/dsh-usage-indicator/"><img src="https://dshbase.com/badges/dsh-usage-indicator.svg" alt="dshbase install-tested"></a>