前言¶

DeepSeek Harness（DSH）的插件生態強調把模型、能力和設置拆成可組合的插件；社區目錄頁是獨立站點，不應等同於 DeepSeek / 幻方官方應用商店。

如果你在 DSH 中需要接入 ChatGPT Codex，並且希望登錄、模型目錄、Fast 模型、1M / 上下文 picker 行，以及可選 Search、圖像能力放在一個插件裏管理，NOirBRight/dsh-llm-codex 提供的是這類能力。

下面介紹它的定位、核心能力、安裝方式和典型用法。

這是什麼¶

dsh-llm-codex 是 NOirBRight 維護的 DeepSeek Harness 插件，定位是：

ChatGPT Codex login, sortable catalog, and Fast models for DeepSeek Harness

它貢獻 Settings → LLM Providers 下的 Codex 卡片，以及 Host 側的 Codex llm route。

需要注意的是，LLM Providers 頁面和 shared order store 僅由 dsh-llm-providers-ui 擁有；本插件只貢獻 Codex card 和 Host llm route。

核心能力¶

dsh-llm-codex 已覈實的能力包括：

1. ChatGPT Codex login 與 OAuth 會話管理。
2. LLM Providers 設置頁中的 Codex 卡片。
3. 卡片顯示 usage limits。
4. 模型目錄保存在 settings.models。
5. 默認目錄包含：
   - gpt-5.6-sol / gpt-5.6-sol-fast
   - gpt-5.6-terra / gpt-5.6-terra-fast
   - gpt-5.6-luna / gpt-5.6-luna-fast
6. Fast 行發送 service_tier: priority。
7. 支持 1M 行與 -<n>k / -<n>m 上下文 picker 行。
8. 默認 reasoning effort 可按模型行編輯。
9. 可選 Search、view_image、codex_generate_image 能力，默認關閉。
10. 在 dsh-model-switch v0.2+ 下注冊可選 Search / Image adapters。

此外，已覈實資料中明確：

• 沒有 apiKeyEnv。
• 沒有 user-editable base URL。
• 不讀寫 ~/.codex/auth.json。
• 不與 dsh-codex-connect 共享 credential file。

安裝與啓用¶

先確認 DSH 版本。README 要求 DeepSeek Harness 0.1.0-rc.6 或更高；Release 安裝段稱 artifact 目標爲 DeepSeek Harness 0.1.2-alpha.1。

從 GitHub 安裝指定版本：

dsh plugin --profile web add github:NOirBRight/dsh-llm-codex#v0.3.7

如果要在 Web 中使用 Settings → LLM Providers 頁面，需要同時安裝 dsh-llm-providers-ui。headless Host 路由可不需要 Owner。

登錄與會話¶

進入 Settings → LLM Providers → Codex，點擊 Sign in with ChatGPT，啓動官方 ChatGPT OAuth 流程。

會話僅保存在 Host 的：

$DSH_HOME/codex-oauth.json

文件權限爲 0600。點擊 Sign out 會刪除該文件。

登錄完成後，Codex 卡片會顯示 usage limits。

模型目錄¶

模型目錄使用 settings.models。默認目錄包含六行：

gpt-5.6-sol / gpt-5.6-sol-fast
gpt-5.6-terra / gpt-5.6-terra-fast
gpt-5.6-luna / gpt-5.6-luna-fast

Fast 行在請求中發送：

"service_tier": "priority"

1M 行不在默認目錄中，可以從官方 picker 添加，例如：

gpt-5.6-sol-1m

Picker id 也可以使用 -<n>k 或 -<n>m 這類上下文後綴，例如：

gpt-5.6-sol-272k
gpt-5.6-sol-1m

插件會剝掉後綴，並設置 DSH compaction budget。

默認 reasoning effort 可按模型行編輯。

可選能力¶

Search、view_image、codex_generate_image 默認關閉。

啓用任一能力後點擊 Save，會立即註冊或取消註冊，無需重啓。

已覈實的 Search 行爲包括：

• Search model dropdown 默認 gpt-5.6-luna。
• search modes 爲 cached、indexed、live。
• 默認 mode 爲 cached。
• Search 不寫入 web.searchProvider。
• Search 不寫入 agent-default-model。

codex_generate_image 使用 Codex usage，通常約 3–5 倍於一次 text turn。生成文件默認位於：

generated-images/

除非設置 path。

Model Switch 集成¶

當 dsh-model-switch v0.2+ 存在時，Codex 會註冊可選 Search / Image adapters。

已覈實資料中明確：

• Model Switch 集成不註冊 Vision adapter。

錯誤與會話狀態¶

已覈實的失敗狀態包括：

• Chat 沒有 session 時失敗 MISSING_CREDENTIAL。
• stored session refresh 失敗 reported AUTH。

適用場景與注意¶

適合的使用場景：

• 在 DSH 中接入 ChatGPT Codex。
• 需要統一維護 Codex 登錄、usage limits、模型目錄。
• 需要 Fast 行、1M 行或 -<n>k / -<n>m picker 行。
• 需要可選 Search、view_image、codex_generate_image 能力。

不適合或不依賴的場景：

• 不希望直接讀取 ~/.codex/auth.json。
• 不希望與 dsh-codex-connect 共享 credential file。
• 期望插件提供 user-editable base URL 或 apiKeyEnv。

安裝前應檢查源碼與許可證。該插件許可證爲 MIT。插件以當前 dsh 進程權限運行，建議先確認來源、版本和行爲符合預期。

Web 使用時，LLM Providers 頁面和 shared order store 仍由 dsh-llm-providers-ui 擁有；本插件只貢獻 Codex card 和 Host llm route。

結尾¶

dsh-llm-codex 爲 DeepSeek Harness 提供 ChatGPT Codex 登錄、模型目錄、Fast 模型行、1M / 上下文 picker 行，以及默認關閉的可選 Search 與圖像能力。

GitHub：

https://github.com/NOirBRight/dsh-llm-codex

目錄頁：

https://www.skillhub.cn/plugins/NOirBRight/dsh-llm-codex