前言¶
在 DeepSeek Harness（DSH）裏接 OpenAI Codex，常見做法是單獨配 API Key、再分別處理搜索和圖片工具。如果你本機已經用官方 Codex CLI 完成 ChatGPT 登錄，登錄態寫在 ~/.codex/auth.json（或 $CODEX_HOME/auth.json），另一套憑證管理就顯得重複。
下面介紹社區插件 dsh-codex-auth（維護者 suntianc）。它把 Codex CLI 的登錄態接到 DSH 的 openai-codex 路由，並補上網頁搜索、圖片生成，以及原生的 GPT Auth 設置分區。插件歸類爲「客戶端」，當前 npm 版本爲 v0.3.0。
這是什麼¶
dsh-codex-auth 是一個自包含的 DSH Codex 能力包。一句話概括：複用本地 Codex CLI 的 ChatGPT 登錄，爲 DSH 提供 LLM 路由、全局搜索提供方、圖片工具，以及帶登錄與能力卡片的 GPT Auth 設置界面。
它不是 DeepSeek 或幻方官方出品；社區目錄 SkillHub 是獨立站點，與上游無官方從屬關係。GitHub 倉庫 suntianc/dsh-codex-auth 截至撰寫時約 13 stars、4 forks。
核心功能¶
共享 Codex 登錄態¶
LLM、搜索、圖片共用一個僅運行於 Host 的認證協調器。憑證從版本綁定的 auth.json 快照解析，配合短時內存緩存與到期前主動刷新；進程內合併併發刷新，OAuth 網絡 I/O 前後使用短跨進程鎖。
可在 GPT Auth 卡片中啓動官方 codex login（瀏覽器或設備碼流程），也可事先在終端執行 codex login。設置頁展示連接狀態，以及盡力獲取的周剩餘額度與重置時間。插件自有的 /codex-auth Connection RPC 僅允許 loopback，不向瀏覽器發送 token 值。
openai-codex LLM 路由¶
註冊 openai-codex 提供方，模型選擇器中顯示爲 OpenAI Codex (chatgpt)（可通過 Host 配置 displayName 修改）。默認流式傳輸爲 sse；也支持 websocket 與 auto。
GPT Auth 設置提供默認關閉的 1M 上下文開關，可將 gpt-5.6-luna、gpt-5.6-sol、gpt-5.6-terra 向 DSH 報告的上下文窗口從 272,000 Token 提升到 1,000,000 Token，供 DSH 計算 Token 壓力與壓縮時機。超過 272K 的請求可能更快消耗賬戶配額，且不會展開已壓縮的歷史。
網頁搜索¶
通過 codex-search Host 行向 @deepseek-ai/dsh-web 註冊 ID 爲 codex 的搜索提供方，並作爲部署全局 Search Provider 接入 DSH 內置 web_search 工具。每次搜索請求官方端點：
https://chatgpt.com/backend-api/codex/alpha/search
若調用方是 openai-codex Agent，搜索使用該 Agent 的當前模型；否則使用設置中的備用模型（默認 gpt-5.4）。網絡錯誤與 HTTP 5xx 最多重試五次（指數退避）；HTTP 429 立即返回。
默認可調項包括：啓用（true）、模式（live）、上下文大小（medium）、備用模型、最大輸出 Token（2048）。
圖片創作¶
generate_image 對模型呈現爲單一操作，按有無參考圖分發到：
POST https://chatgpt.com/backend-api/codex/images/generations
POST https://chatgpt.com/backend-api/codex/images/edits
支持必填 prompt、最多五個參考圖、1–10 張輸出，以及尺寸/質量/背景等選項。參考圖須明確來源，例如：
{ "kind": "session", "handle": "image:<attachmentId>" }
{ "kind": "workspace", "path": "assets/reference.png" }
生成結果經校驗後通過 ctx.attachments.saveImage(...) 持久保存，在 DSH 標準圖片畫廊中展示。list_images 供模型在上下文壓縮後查閱會話中的持久圖片，默認分頁 5 張、最多 10 張。
圖片工具僅註冊到聲明支持圖片輸入的 openai-codex Agent；本地識別爲 Free 套餐時標記爲不可用。
環境要求¶
安裝前確認以下條件：
- DeepSeek Harness
0.1.1-rc.1或兼容的後續0.1.x版本。 - Node.js
^22.19.0或>=24.0.0。 codexCLI 已加入PATH。- 已執行
codex login，或準備在 GPT Auth 卡片中登錄。
若 Codex 將憑證僅存於系統鑰匙串、auth.json 無可用 token，可在 ~/.codex/config.toml 設置 cli_auth_credentials_store = "file" 後重新登錄。
安裝與啓用¶
推薦從 npm 安裝。包內已含預構建的 Host 與瀏覽器 bundle，不需要安裝期構建權限：
dsh plugin --profile web add dsh-codex-auth
安裝完成後重啓 dsh web，打開設置並選擇 GPT Auth。
升級到當前版本時，先停止正在運行的 dsh web，再執行：
dsh plugin --profile web add dsh-codex-auth@0.3.0
dsh plugin --profile web list
列表顯示 dsh-codex-auth@0.3.0 後，重新啓動 dsh web 並刷新瀏覽器。
其他安裝方式（預構建 Release tarball、GitHub 源碼、本地 pack）見倉庫 README；從 GitHub 源碼安裝時，pnpm 10+ 可能要求將 allowBuilds 鍵寫入 ~/.dsh/profiles/web/pnpm-workspace.yaml，僅在審查並信任源碼後授權。
典型用法¶
1. 登錄與檢查狀態¶
- 安裝插件並重啓
dsh web。 - 進入設置 → GPT Auth。
- 若未登錄，在登錄卡片啓動
codex login；或提前在終端執行：
codex login
- 卡片會顯示連接狀態與周用量信息（盡力獲取）。
2. 使用 openai-codex 模型¶
在 DSH 模型選擇器中選擇 OpenAI Codex (chatgpt) 下的模型（如 gpt-5.6-luna）。需要更長上下文時，在 GPT Auth 的 LLM 上下文卡片開啓 1M 上下文開關。
3. 啓用搜索與圖片¶
網頁搜索與圖片創作默認啓用。可在 GPT Auth 對應卡片中調整模式、備用模型、圖片尺寸等；詳細項可收起爲緊湊行。Agent 使用 openai-codex 且支持圖片輸入時，generate_image 與 list_images 自動可用。
Host 配置（可選）¶
能力包 patch 按依賴順序啓用三條 Host 行：
| 行 | Export | 作用 |
|---|---|---|
llm-codex-auth |
dsh-codex-auth |
共享認證協調器與 LLM 路由 |
codex-search |
dsh-codex-auth/search |
全局搜索提供方 |
codex-image |
dsh-codex-auth/image |
Agent scope 圖片工具 |
不要在 llm-pi-ai.providers 下重複添加 openai-codex，也不要與 dsh-codex 同時安裝；重複路由所有權會被明確拒絕。僅需搜索/圖片、不需要 LLM 路由時，可設 llmEnabled: false 保留共享登錄協調器。
適用場景與注意¶
適合誰： 本機已用 Codex CLI 登錄 ChatGPT、希望在 DSH Web Profile 裏統一使用 openai-codex 模型、網頁搜索和圖片能力的個人開發者。
務必注意：
- 插件走私有、受賬戶權限控制的
chatgpt.com/backend-api，屬非官方通道，可隨時撤銷、限流或變更，README 明確標註「僅限個人開發」，勿用於生產任務。 - DSH 插件以當前
dsh進程權限運行；安裝前應檢查源碼與許可證（倉庫見 GitHub）。 - Token 值不進入瀏覽器、設置、日誌或工具 metadata；僅 Host 側請求攜帶認證 header。
- 不要與
dsh-codex或手寫openai-codexprovider 配置疊加，以免路由衝突。
結尾¶
dsh-codex-auth 把 Codex CLI 已有的 ChatGPT 登錄態接到 DSH，一次安裝即可覆蓋 LLM、搜索、圖片與 GPT Auth 設置，減少重複配憑證。若你正在 DSH 生態裏探索 Codex 接入，可從社區目錄或 GitHub 查看詳情：
- 目錄頁：https://www.skillhub.cn/plugins/suntianc/dsh-codex-auth
- GitHub：https://github.com/suntianc/dsh-codex-auth
