前言¶
DeepSeek Harness（dsh）采用「一切皆插件」的思路，模型提供方、设置页、命令等都可以通过插件扩展。如果你已经有 ChatGPT / Codex 订阅，并希望在 dsh 中调用订阅额度，这个插件提供了一条直接路径。
dsh-llm-codex-oauth 由 Player-MINEPIG 维护，采用 MIT 许可证。它的作用是把 pi-ai 内置的 openai-codex provider（openai-codex-responses 线上协议）注册为 dsh LLM seam 的 codex-oauth 提供方，让 dsh 可以在模型设置里选择 codex-oauth 提供方下的模型进行对话。
核心功能¶
订阅模型接入¶
插件会注册一个名为 codex-oauth 的模型提供方。模型目录随所装 pi-ai 版本维护，例如：
gpt-5.3-codex-sparkgpt-5.4gpt-5.5gpt-5.6-*
安装后，具体可用模型以你当前安装的 pi-ai 模型目录为准。
图片输入¶
Web 端粘贴或拖放图片时，走 dsh 耐久附件，支持：
- PNG
- JPEG
- WebP
- GIF
只有模型目录中声明支持 image 的模型会接收图片。read_image 等工具结果里的图片也会转发到下一轮。
看图需要 profile 挂载 attachments；web profile 默认有该能力。纯文本模型或未挂载附件服务时，图片请求会被拒绝。
PDF / Office 等非图片文件不会作为多模态块发送。需要处理时，可以放入工作区后用文件工具读取。
OAuth 登录与凭据¶
登录走 auth.openai.com，使用与 Codex CLI 相同的 OAuth client，采用设备码登录流程。该流程 headless 友好，无需本地回调服务器。
凭据处理如下：
- refresh token / access token 只存在 dsh 凭据库
$DSH_HOME/.credentials.yaml。 - 该文件权限为
0600。 - token 不进配置、不进会话日志、不进本仓库。
- access token 过期时，由 pi-ai 在串行化的写路径里自动用 refresh token 续期。
- 登录状态中的设备码仅存于进程内存，重启后以凭据库为准。
设置页与命令¶
设置页提供「Codex 订阅 (ChatGPT)」区块，包含登录 / 登出按钮与实时状态。
对话侧保留只读命令：
/codex-status/codex-logout
多轮对话¶
插件完整保留 provider 原生回放元数据，例如签名等，支持跨轮次多轮请求。
安装与启用¶
安装命令如下：
dsh plugin --profile web add file:/path/to/dsh-llm-codex-oauth
这里的 file: 前缀必须保留。直接传目录路径时，pnpm 会以 link: 方式安装，可能导致 Node 按真实路径解析插件内部依赖时找不到 node_modules。
如果 pnpm 11 的 ignored-builds 提示导致 dsh plugin 报 pnpm failed，可以把 profile 目录中 pnpm-workspace.yaml 的 allowBuilds: 占位值改为 false，然后重跑同一条安装命令。
安装完成后，运行下面的命令验证：
dsh --profile web --dump-config
如果通过 npx 临时使用 dsh，也可以使用：
npx @deepseek-ai/dsh --profile web --dump-config
输出中应能看到 llm-codex-oauth 行。
典型用法¶
1、重启 dsh 后打开设置页，在侧栏选择「Codex 订阅 (ChatGPT)」。
2、点击「登录 ChatGPT 账号」，按提示打开验证网址、输入设备码，并登录你的 ChatGPT 账号。
3、状态变为「已连接」后，进入 Models 设置页，把模型切到 codex-oauth 提供方下的某个模型。
4、需要登出时，可以回设置页点击「登出」，或在对话里输入 /codex-logout。随时可用 /codex-status 查看状态。
适用场景与注意¶
这个插件适合已经在 dsh 中使用插件体系、并且拥有 ChatGPT / Codex 订阅的使用者。它主要解决「把订阅额度接入 dsh 对话」的问题，并不提供图片生成能力。
使用前需要注意以下限制：
- Codex ChatGPT 后端不接受
temperature、maxTokens、stop。 temperature/maxTokens会被静默忽略。stop仍会被拒绝。reasoningEffort与sessionId会继续下发。- 插件不做图片生成。
- PDF / Office 等非图片文件不会作为多模态块发送。
- 模型目录跟随所装 pi-ai 版本。
安全风险也需要明确：该插件调用未公开、官方不支持的 ChatGPT 网页版后端 chatgpt.com/backend-api，存在违反 OpenAI 服务条款、账号受限的风险。是否使用需要自行评估。
仓库内不包含秘密。如果你要推送仓库，确认 .gitignore 生效，永远不要提交 $DSH_HOME/.credentials.yaml 或其中内容。
安装前建议检查源码，并确认 MIT 许可证符合你的使用要求。启用后，插件运行在当前 dsh 进程权限下。
结尾¶
dsh-llm-codex-oauth 的核心价值，是把 ChatGPT / Codex 订阅通过 OAuth 设备码登录接入 dsh 的 codex-oauth 提供方，同时保留凭据隔离、图片输入、多轮回放等必要能力。
GitHub 仓库：
https://github.com/Player-MINEPIG/dsh-llm-codex-oauth
社区目录是独立站点，不应把它理解成官方应用商店；当前资料未提供可确认的目录页地址。
