前言¶

DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。对于使用 MiniMax Coding Plan 的开发者而言，监控 API 配额消耗是日常开发中的常见需求。此插件将 MiniMax 的配额使用情况直接渲染到 DSH 的侧边栏，提供实时进度条和重置倒计时，避免开发者手动切换页面或打开网页进行查询。

插件介绍¶

名称：owen-si-zhou/dsh-plugin-minimax-usage
定位：DSH 客户端插件
维护者：owen-si-zhou
核心价值：在 DSH 侧边栏直接显示 5 小时窗口和每周配额的剩余进度。

核心功能¶

1. 5 小时配额条：实时显示当前间隔（5小时窗口）的剩余额度进度。
2. 每周配额条：概览本周额度的使用情况，直观展示剩余百分比。
3. 重置倒计时：显示窗口重置的精确时间（例如：重置于 2h 17m）。
4. 可折叠面板：点击面板箭头可折叠/展开。折叠状态下显示紧凑摘要。
5. 自动刷新：每 60 秒通过服务端缓存自动更新数据。
6. 侧边栏集成：渲染在 sidebar.footer.action 区域，位于“设置”按钮上方。
7. 轻量级：使用纯 React.createElement 构建，无 CSS 框架依赖，无外部图片资源。

安装与启用¶

插件安装目录为 ~/.dsh/profiles/web。

1. 安装插件
   进入插件目录并使用包管理器安装。以 pnpm 为例：

   cd ~/.dsh/profiles/web
   pnpm add /path/to/this/plugin

或使用 npm link：

   cd ~/.dsh/profiles/web
   npm link /path/to/this/plugin

2. 注册插件
   将以下内容追加到 ~/.dsh/profiles/web/cordis.patch.yml：

   - insert:
       - id: minimax-usage
         name: '@dsh-external/minimax-usage'

3. 配置 API 密钥
   插件在请求时从 ~/.zshrc.secret 读取 MINIMAX_API_KEY。请确保该文件中已导出密钥：

   export MINIMAX_API_KEY='your-minimax-api-key-here'

4. 重启与刷新
   重启 DSH web 服务：

   dsh web

在浏览器中强制刷新页面以加载插件。

技术细节与注意事项¶

• 时间戳精度：API 返回的 end_time、start_time、weekly_end_time 和 weekly_start_time 字段均为 Unix 毫秒时间戳。
• 倒计时计算：API 的 remains_time 字段不可靠（可能错误地返回 96 天）。插件通过 end_time - Date.now() 计算重置时间，确保准确性。
• 百分比格式：API 返回的配额百分比为 0-100 的整数。
• 容错机制：若未配置 MINIMAX_API_KEY，插件会在侧边栏显示错误信息，不会导致程序崩溃。

适用场景¶

适合需要频繁查看 MiniMax 配额状态的开发者，特别是将 DSH 作为主要开发环境，希望将配额监控集成到侧边栏以减少操作中断的用户。

结语¶

该插件通过纯 React 组件实现了轻量级的配额监控功能，并直接集成于 DSH 侧边栏。更多详情与源码可参考：GitHub。