@jcy2387/dsh-codex-provider-plugin

English | 中文

一个独立发布、可通过 dsh plugin add 安装的 OpenAI Codex Provider。它使用 ChatGPT OAuth 登录，通过 Harness 原生 LLM 服务注册 openai-codex，并在 Web 设置页提供浏览器登录和设备代码登录。

本包不修改 deepseek-harness 源码，也不把 Codex 当作 subagent。Codex 模型仍使用 Harness 的普通 Agent loop、工具、权限、session、流式输出和自动压缩链路。

此插件使用 pi-ai 的 openai-codex Provider 访问 ChatGPT Codex 后端，不是 OpenAI Platform API Key 集成。接口行为、模型权限和配额由 OpenAI 控制，可能变化。请仅用于符合账号与适用条款的场景。

架构

一个 npm 包同时包含两张运行面：

• Host： 注册 openai-codex LLM adapter，通过 Harness credential provider 保存 OAuth 状态、读取账号用量，并提供插件自有的 loopback-only Connection RPC。
• Browser： 通过 dsh.client manifest 加载原生设置页，只接收经过校验且不含敏感信息的认证与用量快照；Token 和账号 ID 都不会进入浏览器。

Harness 当前只提供扁平的 Settings section 列表，Models 页面也没有外部内容 Slot。因此插件保持为紧随模型之后的独立 OpenAI Codex 页面，不修改 Harness，也不做脆弱的 DOM 注入。

cordis.patch.yml 只插入一个由本包拥有的插件行。本包不导入或修改 @deepseek-ai/dsh-api-remotes，安装时不需要 Harness 增加静态 Remote 注册。

模型 ID、contextWindow 和 maxTokens 直接来自 pi-ai 的 Codex catalog。Harness 通过正常的 ctx.llm.resolveModelInfo() 路径读取这些字段，因此 session 上下文预算和自动压缩不需要 Provider 专属接线。

从 npm 安装

dsh plugin --profile web add @jcy2387/dsh-codex-provider-plugin
dsh web

设置 OpenAI Codex

本插件使用 ChatGPT OAuth 登录，不需要 OPENAI_API_KEY，也不是 OpenAI Platform API Key 集成。

设置页大致如下：

1. 执行 dsh web 启动 Web UI。
2. 打开设置 → OpenAI Codex，点击连接 Codex。
3. 选择浏览器登录，使用 ChatGPT 账号完成授权；如果 Host 是无头或远程环境，则选择设备代码登录。
4. 状态变为已连接后，页面会显示 OpenAI 当前返回的用量周期，并每 60 秒刷新一次。接口没有返回的周期不会显示，插件不会硬编码 5 小时限制。
5. 在正常的模型选择器中选择 openai-codex 下的模型。安装插件不会自动修改默认模型。

浏览器登录要求浏览器和 dsh Host 在同一台机器上运行。设备代码登录可能需要先在 ChatGPT 安全设置或工作区权限中启用。账号或工作区必须拥有 Codex 访问权限；模型可用性和配额由 OpenAI 控制。用量数据来自 OpenAI 的 ChatGPT 账号接口，可能随其服务变化。