在使用 DeepSeek Harness（DSH）进行开发或调试时，频繁切换页面查看账户余额或 Kimi Code 配额会打断工作流。dsh-usage-widget 插件通过在左侧栏底部提供一个常驻的紧凑型小部件，解决了这一痛点。
dsh-usage-widget 是一个 DSH 插件，由 AHui-Lab 维护。它将用量监控功能直接集成到 Web/Desktop 界面的左侧栏底部，提供实时的账户状态概览。
核心功能¶
该插件在左侧栏底部注册了一个“用量”入口，具备以下特性：
- 数据展示：显示 DeepSeek 账户余额，以及 Kimi Code 配额（包含 5 小时窗口配额与每周配额）。
- 布局与交互：始终可见于侧边栏底部。点击条目可折叠或展开，支持 DeepSeek 与 Kimi 的切换开关。
- 自动刷新：每 60 秒自动刷新数据。
安装与启用¶
插件支持通过 GitHub 仓库或 npm 包安装，安装后需重启 DSH。
# 通过 GitHub 仓库安装（推荐）
dsh plugin --profile <name> add github:AHui-Lab/dsh-usage-widget
# 通过 npm 包安装
dsh plugin --profile <name> add dsh-usage-widget
重启 DSH 后，在左侧栏底部即可找到“用量”条目。
数据流与配置¶
由于浏览器存在 CORS 限制，无法直接调用 api.kimi.com，插件提供了两种数据获取路径和对应的密钥配置方式。
数据路径¶
-
主机路由模式（优先）：
插件在主机 Web 服务器上注册了/usage-monitor/deepseek和/usage-monitor/kimi路由。该路由通过上游 API 获取数据，并优先使用客户端发送的Authorization头，否则回退到 DSH 凭据服务或环境变量。 -
浏览器直接回退（备用）：
当主机路由不可用时，插件尝试在浏览器端直接请求上游。DeepSeek 支持 CORS，此模式有效；Kimi 在此模式下受 CORS 限制无法直接访问。
API 密钥配置¶
密钥是按机器配置的，不会随插件分发。
-
主机模式：
在~/.dsh/.credentials.yaml中设置以下环境变量：DEEPSEEK_API_KEYKIMI_CODING_API_KEY
主机进程会读取这些配置。
-
浏览器模式：
打开插件面板，点击齿轮图标，将 API Key 和 Token 粘贴到面板中。这些密钥仅保存在浏览器的localStorage中（前缀为usage-monitor.key.*），并仅用于上游请求。
开发与注意事项¶
- 无需构建：插件仓库中已包含
lib/目录（包含index.js和client.js），安装即用，无需执行构建步骤。 - 适用场景：适合需要在不离开 DSH 界面的情况下持续监控 API 用量的开发者。
- 社区插件：该插件为社区维护项目，非 DeepSeek 官方插件。
- 依赖：需要 DSH Web/Desktop 配置文件，且插件针对浏览器客户端设计。
生态与链接¶
DSH 的设计理念是“一切皆插件”，该插件属于社区生态的一部分。若需查看源码或提交问题，可访问：
