DeepSeek Harness — OpenAI Codex 插件

DeepSeek Harness（DSH）采用插件化架构。该插件允许将 ChatGPT Plus 或 Pro 订阅作为 LLM 提供商接入 DeepSeek Harness，解决在本地环境中通过 Web 界面或命令行使用 ChatGPT Codex 模型的需求。

核心功能¶

该插件提供以下能力：

设备码登录：通过 Web 设置界面添加设备码 OAuth 登录流程。
Slash 命令：在 Harness 中添加交互式的 /codex 斜杠命令。
无本地服务：不运行浏览器回调服务器或 localhost 监听器。
模型集成：使 Codex 模型与其他提供商并列显示。
自动刷新：令牌在过期前自动刷新。
用量展示：在 Codex 用量弹窗中显示 5 小时和每周的用量限制。

安装¶

DSH 按配置文件（Profile）管理插件。需要在启用该插件或 /codex 命令的每个配置文件中安装。以下示例以 web 配置文件为例：

dsh plugin --profile web add -w @syncended/dsh-codex

安装或升级后，需要重启对应的配置文件。

若要移除插件：

dsh plugin --profile web remove @syncended/dsh-codex

使用方法¶

Web 界面登录¶

打开 Settings（设置） → OpenAI Codex。
点击 Sign in。插件会在另一个标签页打开 OpenAI 的设备登录页面。
返回 DSH，复制显示的一次性代码，并粘贴到 OpenAI 页面中。
授权访问并返回 DSH。设置页面会自动更新为 Connected。
在标准模型选择器中选择一个 openai-codex/... 模型，并发送测试提示词。
使用 Settings 上方的 Codex limits 检查归一化后的 5 小时和每周余额。

CLI 交互命令¶

/codex 是 Harness 的斜杠命令，而非 shell 可执行文件。需在安装了该插件且处于交互模式的配置文件中运行：

命令	描述
`/codex login`	启动设备码流程，打印验证 URL 和代码。
`/codex status`	显示令牌状态和过期时间。
`/codex logout`	删除存储的令牌文件并取消发布活跃凭证。

配置与存储¶

插件默认将令牌存储在 $DSH_HOME/openai-codex.json 文件中。它仅将活跃的访问令牌发布到 DSH 凭证服务中，环境变量名为 OPENAI_CODEX_TOKEN。

插件注册了 openai-codex 路由并自动映射凭证，因此通常无需执行 dsh settings set 命令。若需修改默认配置，可以编辑对应配置文件目录下的 cordis.patch.yml 文件：

- id: openai-codex
  config:
    # clientId: app_EMoamEEZ…hrann
    credentialRef: OPENAI_CODEX_TOKEN
    deviceCodeTimeoutSeconds: 900
    refreshWindowMs: 300000
    # dshHome: /absolute/path/to/dsh-home
    # tokenFile: /absolute/private/path/openai-codex.json

环境要求与注意事项¶

订阅要求：需要拥有 Codex 访问权限的 ChatGPT Plus 或 Pro 订阅。
DSH 版本：DeepSeek Harness 0.1.0-rc.6 或兼容版本。
运行环境：Node.js 18 或更新版本；dsh plugin 命令需可用 pnpm。
网络访问：需要出站 HTTPS 访问 auth.openai.com 和 chatgpt.com。
Web 登录限制：Web 登录受限于回环/同源 Host 会话。对于远程 Host，请使用经过身份验证的 SSH/本地隧道连接其回环 Web UI，而非公开暴露凭证操作。
用量限制接口：用量视图使用 OpenAI 未记录的 Codex 用量端点，其可用性和响应格式可能会在没有通知的情况下发生变化。
安全提示：$DSH_HOME 目录包含敏感的本地凭证状态。请确保该目录权限安全。/codex logout 会删除该文件并清除发布的凭证。

总结¶

该插件通过设备码 OAuth 和 Slash 命令，将 ChatGPT Codex 模型无缝集成到 DeepSeek Harness 生态中，支持自动令牌刷新和用量监控，适合需要在本地 DSH 环境中调用 Codex 模型的开发者。

更多详情与源码，请访问：GitHub 仓库