Codex 订阅接入zzjxmy/dsh-llm-codex

@dsh/llm-codex

为 DeepSeek Harness LLM 接入层提供 ChatGPT Plus/Pro（Codex）适配器。

通过你的 ChatGPT Plus/Pro 订阅 接入 codex provider（路由到
https://chatgpt.com/backend-api/codex/responses），不需要 OpenAI API key，也不依赖 Codex 桌面端。OAuth 流程、账户/地区请求头、请求翻译均对照 OpenCode 的
plugins/openai/codex.ts，因此使用同一 ChatGPT 账户、同一公开 client。

截图

| 模型选择器（ChatGPT Codex 组已注册） | /codex-status 输出 |
|---|---|
| model picker | codex-status |

安装（接入 DSH profile）

插件自带 dsh.bundle 清单，CLI 会自动把它作为 profile 层挂载，无需手动编辑 cordis.patch.yml。

钉到发布 tag（推荐，可复现）
dsh plugin --profile web add github:zzjxmy/dsh-llm-codex#v0.1.0

跟踪 main 分支最新提交（HEAD）
dsh plugin --profile web add github:zzjxmy/dsh-llm-codex

本地开发
dsh plugin --profile web add file:/path/to/dsh-llm-codex

重启 profile / web host 让新的 bundle 层生效：

在跑 web host 的终端里
Ctrl-C
dsh web

#last 不是合法的 git ref，请用分支名、commit SHA 或发布 tag。

插件的 peer 依赖（@deepseek-ai/dsh-llm、dsh-credentials、dsh-settings、
dsh-launch-environment、@deepseek-ai/schemastery）从 DSH 安装环境获取；在 npm 上它们的 dist-tag 是 next (>=0.1.0-rc.8)。

使用

在 GUI 输入框：

/codex-login

- browser（默认）—— 浏览器打开 auth.openai.com OAuth 授权，回调在
http://localhost:1455/auth/callback 捕获。
- headless —— 输出 URL + 验证码，在 auth.openai.com/codex/device 输入（无需浏览器）。

授权完成后用 /codex-status 确认，然后在模型选择器里选 ChatGPT Codex 组下的任意模型：

| id | 备注 |
|---|---|
| gpt-5.6-sol | 旗舰 Codex 模型（Sol），400k 上下文 |
| gpt-5.6-terra | 高吞吐 Codex 模型（Terra） |
| gpt-5.5 | 旗舰 Codex 模型，400k 上下文 |
| gpt-5.4 | 通用 Codex 模型 |
| gpt-5.4-mini | 轻量快速 |
| gpt-5.3-codex-spark | 低延迟 |

退出登录：/codex-logout。

配置（可选）

在 ~/.dsh/settings.yaml 的 llm-codex: 段下（支持热重载）：

llm-codex:
callbackPort: 1455          # OAuth 回调端口（被占用时自动换端口）
issuer: https://auth.openai.com
codexApiEndpoint: https://chatgpt.com/backend-api/codex/responses
tokenRef: CHATGPT_OAUTH_TOKEN

添加 / 覆盖模型

内置白名单只是建议性的；可以在 llm-codex: 段追加或整体替换。重复 id 的后条目会被丢弃，所以用设置覆盖内置条目时不必删除原条目。

llm-codex:
extraModels:
- id: gpt-5.6
name: GPT-5.6 (Codex)
contextWindow: 400000
maxTokens: 128000
或整体替换目录：
models:
- { id: gpt-5.5, name: GPT-5.5 (Codex), contextWindow: 400000, maxTokens: 128000 }

目录是提示性的——能选不等于能用。Codex 后端按你的 ChatGPT 账户实际放行模型
（如 gpt-5.6 会以 "not supported when using Codex with a ChatGPT account" 被拒），所以内置白名单已将其排除。

环境变量 CODEX_API_ENDPOINT / CODEX_ISSUER 可覆盖端点；CHATGPT_OAUTH_TOKEN 以
JSON {"refresh":...,"access":...,"expires":...,"accountId":...} 形式导出也可作为凭据来源。

故障排查

- MISSING_CRED → 运行 /codex-login。
- AUTH（401/403）—— 通常是 refresh token 被轮换（OpenCode 或共享同一账户的其它客户端）。重新运行 /codex-login。GUI 的报错信息已直接提示此情况。
- HTTP 400 —— 检查 llm-codex 设置与模型 id。

"选了 Codex 模型后整个应用都不可用"

宿主的 session.selectModel 会把每次选中的模型持久化为全局默认模型（settings.yaml 的 agent-default-model: 段），所有新建/恢复的会话都会默认路由到它。一旦 Codex 不可用（令牌被轮换、订阅失效、后端拒绝、网络卡住），每个会话每条消息都会失败——看起来"整个应用都坏了"，而且重启也不恢复。不要删除 ~/.dsh。 恢复方法：

1. 打开模型选择器切回 DeepSeek 等其它模型（会自动写回默认模型）；
2. 或编辑 ~/.dsh/settings.yaml，删除整个 agent-default-model: 段；
3. 或运行 /codex-logout（只清凭据，不清默认模型，需配合上面任一操作）。

/codex-status 现在也会检测这种情况并给出恢复提示，一眼就能看出原因。

注意事项

- 计费 —— 使用你的 ChatGPT Plus/Pro 订阅通过 OAuth 接入，与 OpenAI API key 计费路径完全分开，不需要 API key。
- 共享账户 —— DSH 与 OpenCode 同时使用同一 ChatGPT 账户时，各持一份 refresh token。任一方刷新后另一方可能被轮换失效；/codex-login 可恢复。
- 代理 —— 适配器自动读取 http_proxy / https_proxy / no_proxy 环境变量（undici EnvHttpProxyAgent）。在 auth.openai.com 因 Node fetch 的 TLS 指纹拒绝请求（伪装成 unsupported_country_region_territory）的网络环境下，OAuth/设备码端点会自动通过系统 curl 二进制重试，curl 同样会读取代理环境变量。
- 图片 —— 声明支持图像输入；适配器按需解析宿主附件服务并以 data URL 发送。宿主未挂载附件服务时为 no-op。
- 推理内容 —— Codex 后端通过 summary 事件流式输出推理；reasoning-delta 按尽力而为处理。重放的 assistant 轮会丢弃推理内容（Responses API 的输入格式拒绝 summary_text 内容块；作为独立推理输入项需要 id，而 harness 不保留）。

许可证

MIT —— 详见 LICENSE。