前言¶

DeepSeek Harness 採用“一切皆插件”的架構，允許開發者通過擴展組件豐富系統功能。在集成外部模型時，授權流程往往需要額外的編排與安全處理。dsh-codex-auth 插件旨在解決這一問題，它爲 DeepSeek Harness 提供了 ChatGPT/Codex 的授權能力，允許用戶通過 Harness 官方授權服務完成登錄，並啓用 llm-pi-ai/openai-codex 模型路線。

插件簡介¶

這是一個獨立的工作區插件，主要維護者爲 mhdfy1988，採用 MIT 許可證。它通過 Cordis 插件 ID codex-auth 注入功能，負責處理 ChatGPT 登錄的授權編排、瀏覽器安全遠程接口以及模型路線的開關控制。

核心能力¶

該插件主要承擔以下職責：

1. 登錄入口擴展：在“設置 → 模型”的 openai-codex 提供方卡片中增加 ChatGPT 登錄操作。
2. 官方授權集成：調用 Harness 官方授權服務完成登錄流程。
3. 模型路由管理：提供模型路線開關，啓用 llm-pi-ai/openai-codex 路由。
4. 安全接口：提供授權編排與瀏覽器安全遠程接口。
5. 元數據讀取：讀取登錄狀態、憑據種類、是否可寫等元數據。

安裝與構建¶

本包的安裝、升級和卸載應使用 packages/plugin 構建出的 dsh-codex-auth-*.tgz 安裝包。根目錄下的 dsh-codex-auth-cli-proof 是私有的階段一 CLI 驗證程序，不屬於交付範圍。

若需自行構建，請使用以下命令：

pnpm.cmd install
pnpm.cmd --filter dsh-codex-auth test
pnpm.cmd --filter dsh-codex-auth build

生成版本化安裝包：

Push-Location packages/plugin
npm.cmd pack --pack-destination ..\..\artifacts
Pop-Location

使用方式¶

在獲得安裝包後，將其安裝至 Harness。安裝完成後，登錄操作入口會出現在“設置 → 模型”的 openai-codex 提供方卡片中。點擊該卡片中的登錄操作，會調用 Harness 官方授權服務完成認證，並自動啓用 llm-pi-ai/openai-codex 模型路線。

注意事項與邊界¶

使用本插件時需注意以下事實與限制：

1. 權限與安全

   • 瀏覽器接口只能讀取“是否已登錄、憑據種類、是否可寫”等元數據，不能讀取 access token 或 refresh token。
   • OAuth 地址和設備碼只在授權運行中返回，成功、取消或失敗後由宿主清除。

2. 功能範圍

   • 本包不修改 agent-loop，不實現第二套 OAuth，不另建 Token 文件，也不靜默回退到舊鏈路。
   • OAuth grant 的到期刷新讀改寫和跨進程鎖由 Harness 官方 llm-pi-ai 與 credentials-local 模塊覆蓋。

3. 遷移注意事項

   • 從早期的 link: 開發安裝遷移到 .tgz 時，應先通過 Harness 插件命令卸載舊包。
   • 確認 Profile 下的 node_modules/dsh-codex-auth 不再是指向源碼工作區的 junction（特別是 Windows 系統）。
   • Windows 上殘留的 junction 會讓 pnpm 沿舊鏈接讀取開發依賴，並在導入正式包時觸發 EPERM。必須清除該殘留鏈接後再安裝版本化 .tgz，不要回退到 link: 掩蓋問題。

4. 其他

   • 正式憑據的“退出登錄”按鈕未實現點擊邏輯，以免刪除用戶當前登錄；本包的刪除範圍由自動化測試覆蓋。