前言¶

DeepSeek Harness (DSH) 的 Web UI 提供了插件扩展能力。在使用 OpenAI Codex 进行开发时，监控 API 配额（Rate Limits）是日常需求。dsh-codex-usage 插件通过在 DSH 的设置行右侧增加一个原生样式的环形指示器，解决了这一需求。它通过轻量级的轮询机制，在不泄露凭证的前提下，展示 Codex 的详细配额使用情况。

核心功能¶

该插件实现了以下能力：
* 原生视觉呈现：使用 DSH 设计令牌和 28px 几何标准，复刻对话上下文计费圆环的视觉效果。
* 详细配额展示：提供每个 Codex 限制桶的完整详情，包括滚动窗口、使用百分比、重置时间、计划类型、信用额度及消费控制。
* 智能轮询与缓存：默认 5 分钟轮询，支持通过配置调整；鼠标悬停时通过 250ms 防抖刷新数据；具备失败节流和“最后已知良好”的数据回退机制。
* 安全性：完全在本地运行，不读取 ~/.codex/auth，不处理 OAuth 令牌；API 路由仅接受来自本地（loopback）的 GET 请求，响应中不包含邮箱、ID、令牌等敏感字段。
* 跨平台支持：支持 Windows、macOS 和 Linux 命令行启动。

安装与启用¶

在使用前，需确保环境满足要求（详见下方注意事项）。

1. 登录 Codex：
   在终端中运行以下命令以通过 ChatGPT 计划登录 Codex：

    codex login

2. 添加插件：
   在插件源码目录下执行 DSH 插件安装命令：

    dsh plugin --profile web add .

配置与使用¶

启用插件后，进入 DSH 的设置界面。

1. 进入配置页面：
   路径为 Settings → Plugins → Codex usage。

2. 配置刷新间隔：
   插件支持在配置文件中调整以下参数（默认值如下）：

    - id: codex-usage
      name: dsh-codex-usage
      config:
        refreshIntervalMs: 300000      # 后台轮询间隔（毫秒），最小 60 秒
        hoverRefreshMinAgeMs: 30000    # 悬停刷新的最小间隔（毫秒），最小 5 秒
        requestTimeoutMs: 15000        # 单个请求超时时间（毫秒）
        codexCommand: codex             # Codex 可执行文件名或绝对路径

修改配置后保存，无需重启 DSH，设置会立即生效。

注意事项与要求¶

本插件对运行环境有特定依赖，且涉及安全策略。

• 版本依赖：

  • Node.js 20 或更新版本
  • pnpm 10
  • DeepSeek Harness 0.1.2-alpha.2 或兼容版本
  • OpenAI Codex CLI 0.149.0（需包含稳定 app-server API）

• 安全机制：

  • 插件不会读取用户的 ~/.codex/auth.json 文件，也不会直接处理 OAuth 令牌。
  • 所有凭据管理、令牌刷新和账户选择均由官方 Codex app-server 进程负责。
  • Web API 路由仅允许本地回环请求，并会校验 Origin、Referer 和 Fetch Metadata，拒绝跨站请求。

• 生态说明：

  • 该插件遵循 MIT 许可证，可在 SkillHub 等社区目录查看详情。
  • 插件以当前 DSH 进程的权限运行，安装前建议检查源码。

参考资料¶

• GitHub 仓库：https://github.com/leonardoxr/dsh-codex-usage
• 插件目录：https://www.skillhub.cn/plugins/leonardoxr/dsh-codex-usage