前言¶

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