前言¶

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