DeepSeek Harness (DSH) 的插件机制允许开发者按需扩展功能。在处理多模型路由时，直接为 ChatGPT Codex 添加认证能力有时需要额外的模型适配器。@sipi/dsh-openai-codex-auth 插件旨在解决这一场景，它通过提供 OAuth 存储和交互式认证控制器，在不引入额外模型适配器的情况下，为 pi-ai 路由增加设备代码登录支持。
插件介绍¶
该插件由 z331225718 维护，是一个独立版本化的安装包。它主要负责存储 OAuth 凭证并注册 openai-codex 交互式认证控制器，使得用户可以在 Models 页面直接使用 ChatGPT 的设备代码登录方式。
核心功能¶
插件提供以下能力：
* 提供 OAuth 存储。
* 提供 openai-codex 交互式认证控制器。
* 在 Models 页面支持 ChatGPT 设备代码登录。
* OAuth 请求在 DSH Node 进程中运行。
安装与启用¶
安装命令如下：
dsh plugin --profile web add @sipi/dsh-openai-codex-auth
安装成功后，插件会插入一个 openai-codex-auth 配置行。若要卸载该插件及其凭证贡献，不改变基础适配器，可执行：
dsh plugin --profile web remove @sipi/dsh-openai-codex-auth
典型用法¶
安装后，Models 页面会提供 ChatGPT 设备代码登录入口。OAuth 请求在 DSH Node 进程中执行。
在 Node 24 环境中，如果需要使用代理环境变量，需设置以下环境变量：
NODE_USE_ENV_PROXY=1
若需自定义 OAuth 存储位置，可配置 path 或 dshHome。例如：
- id: openai-codex-auth
name: '@sipi/dsh-openai-codex-auth'
config:
dshHome: ~/.dsh
适用场景与注意¶
该插件仅支持 OpenAI 的设备授权方式。它依赖 @deepseek-ai/dsh-llm-pi-ai 目录暴露 openai-codex OAuth，否则激活会失败。
在使用过程中需注意以下事项：
* Node 版本依赖：在 Node 24 中，OAuth 代理环境变量需要 NODE_USE_ENV_PROXY=1（或 --use-env-proxy）。
* 文件权限：POSIX 文件以 0600 模式原子替换；Windows 用户需保护 DSH_HOME 的 ACL。
* 数据隔离：浏览器 RPC 状态不包含令牌或原始提供者响应。
* 启动依赖：开发或使用时需确保 pi-ai 目录已暴露 openai-codex OAuth。
总结¶
该插件为 DSH 用户在不增加模型适配器的情况下，提供了一套完整的 OpenAI Codex 设备登录解决方案。相关源码与目录信息请访问：
