在 DeepSeek Harness（DSH）生态中，资源监控是日常操作的基础。DSH 的核心理念是“一切皆插件”，dsh-usage-indicator 正是为此类需求设计的工具。该插件在侧边栏顶部实时显示上下文余量、账户余额以及预计下次压缩轮次。数据在本地闭环，API Key 不会离开本机。
核心功能¶
该插件通过侧边栏提供三种主要的信息反馈：
- 上下文占用 / 模型窗口：显示当前上下文占用的进度条。当接近压缩阈值时进度条变黄，达到阈值时变红。
- 账户余额：显示账户余额的进度条。当余额低于设定的警示线时，整条进度条变红。
- 压缩倒计时：使用 EMA（指数移动平均）算法估算「N 轮后压缩」。若历史数据不足，状态显示为「评估中」。
- 视图切换：侧边栏展开时显示详细卡片，收起时自动切换为紧凑的圆环视图 + 余额状态点。
- 热生效配置：通过 Web 设置面板调整满条额度与警示线，配置写入
settings.yaml后无需重启即可生效。
安装与启用¶
安装前需确保已安装 DSH 与 pnpm（缺 pnpm 先执行 npm install -g pnpm）。
- 下载对应版本的 Release 包。
- 执行安装命令：
dsh plugin --profile web add C:\path\to\dsh-usage-indicator-<version>.tgz
安装完成后，重启 dsh web 即可生效。
配置与用法¶
- 余额查询：插件默认读取环境变量
DEEPSEEK_API_KEY来获取余额信息。 - Web 设置面板：在 Web 界面的「API 用量指示」选项中，可以修改满条额度（默认 100）、警示线（默认 20）以及刷新间隔等参数。
- 一致性要求：上下文压缩阈值（
thresholdRatio）默认为 0.8，需与dsh-compaction-basic保持一致。
注意事项¶
- 隐私安全：数据本地闭环，API Key 不离开本机。
- 前置条件：需要安装 DSH 与 pnpm。
- 兼容性：必须与
dsh-compaction-basic保持一致。
总结¶
dsh-usage-indicator 将分散的上下文与余额信息集中展示，帮助用户在智能体开发或日常交互中及时掌握资源状态。更多详情可参考 GitHub 仓库 或 插件目录。
