前言¶

DeepSeek Harness (DSH) 在解析 Provider 憑證時，通常期望配置一個 API Key。然而，本地安裝的 Codex CLI 或 Claude Code 僅持有 OAuth 令牌，並不存在傳統的 API Key。dsh-llm-local-token 插件解決了這個斷層，它直接讀取本地 CLI 維護的憑證文件，將 OAuth 令牌轉化爲 DSH 可用的模型路由，同時提供訂閱使用量的實時展示。

插件簡介¶

這是一個 DeepSeek Harness 插件，由 tianxia-- 維護，遵循 MIT 許可證。它的核心作用是將本地已登錄的 Codex 和 Claude 訂閱直接轉化爲 DSH 內部的模型路由，無需爲 DSH 單獨配置 API Key。

核心功能¶

1. 複用本地訂閱：讀取 Codex 和 Claude 的本地 OAuth 令牌，將其註冊爲 openai-codex 和 anthropic 路由。
2. 使用量 Badge：在 Composer 工具欄顯示訂閱的使用情況（配額、使用率、重置倒計時）。
3. 自動刷新令牌：當令牌臨近過期時自動刷新。
4. 自動配置注入：通過 profile bundle 自動插入 loader 行，無需手動編輯 cordis.patch.yml。

安裝與啓用¶

使用官方命令安裝：

dsh plugin --profile web add dsh-llm-local-token

安裝完成後重啓 dsh。該插件聲明瞭一個 profile bundle (dsh.bundle.patch -> cordis.patch.yml)，DSH 會自動處理配置文件的注入，你不需要手動修改 profile 下的 cordis.patch.yml。

典型用法¶

安裝完成後，路由會自動出現在模型選擇器中。若要將 Codex 設爲默認模型，可在 ~/.dsh/settings.yaml 中配置：

agent-default-model:
  provider: openai-codex
  model: gpt-5.6-terra
  reasoningEffort: medium

注意事項與適用場景¶

• 路由缺失處理：如果某個路由的憑證缺失，插件會跳過該路由，而不會導致 DSH 啓動失敗。
• GLM 行爲：插件僅報告 GLM Coding Plan 的配額，不會註冊新的 GLM 路由（DSH 自身已通過 zai-coding-cn 路由服務 GLM）。
• 傳輸協議與配額：配額 Badge 依賴 sse 傳輸協議。若將 codexTransport 設置爲 auto，DSH 會優先使用 WebSocket，此時無法獲取 Codex 的配額數據。
• GLM 配額來源：GLM 配額優先從配置項、環境變量 (ZAI_CODING_CN_API_KEY)、credentials.yaml 或本地 zcode 文件中讀取。
• 版本要求：需要 Node.js >= 22.13.0。