DeepSeek Harness 插件：接入 OpenAI Codex (ChatGPT Plus/Pro OAuth)

前言¶

DeepSeek Harness (DSH) 采用插件架构。ddll8023/dsh-codex 是一个 DSH 插件，允许用户通过 ChatGPT Plus/Pro OAuth 直接接入 OpenAI Codex 模型。它不依赖 DeepSeek API Key，解决了需要使用 Codex 模型但不想配置 DeepSeek Key 的场景。

核心功能¶

接入 Codex 模型：不依赖 DeepSeek API Key，通过 OAuth 登录。
登录方式：支持浏览器 OAuth 登录和 Device Code 无浏览器登录。
模型与输入：模型选择器自动发现 Codex 模型，支持文本流、工具调用和图片输入。
Fast 模式：聊天输入框可按会话在 Standard 与 Fast 间切换。
原生网络搜索：支持 Codex Native Web Search。
凭证与用量：凭证使用 DSH 自身凭证服务保存，自动刷新；用量显示通过 /codex status 和 /codex usage。

安装与启用¶

适配目标为 DSH Desktop 0.1.7-rc.2 包系列。
推荐使用 dsh plugin 安装：

dsh plugin --profile web add github:ddll8023/dsh-codex

安装后重启 dsh web。验证是否启用：

dsh --profile web --dump-config | grep -A2 llm-codex

启用后模型选择器中会出现 OpenAI Codex Provider。

配置项¶

通过 Host 插件设置表单编辑，或放入 profile 中 llm-codex 条目的 config 对象。

baseURL: https://chatgpt.com/backend-api
modelCatalogClientVersion: "0.157.0"
transport: sse
cacheRetention: short
nativeWebSearch: true
webSearchMode: live
refreshLeadTimeMs: 300000
streamIdleTimeoutMs: 300000
retryPolicy:
  mode: normal
  maxRetries: 2

命令行使用¶

登录相关：
* /codex login：浏览器 OAuth 登录（Authorization Code + PKCE，回调 http://localhost:1455/auth/callback）。
* /codex login --device：无浏览器环境的 Device Code 流程（显示设备码与验证 URL）。
* /codex logout：删除本地 OAuth 凭证。
* /codex cancel：取消进行中的登录。
用量与状态：
* /codex status：登录状态、账号 ID、token 有效期及当前配额用量。
* /codex usage：只查询并显示当前账号配额用量（5h/每周/Spark 子额度，含重置倒计时）。
模式切换：
* /codex speed standard：将当前会话切回 Standard。
* /codex speed fast：将当前会话切换为 Fast。

安全与注意事项¶

凭证安全：凭证保存在 DSH 自身凭证服务（ctx.credentials，即 $DSH_HOME/.credentials.yaml），文件权限 0600，热加载、串行写入。Token 永不进入日志、session 事件、telemetry 或错误信息。
Key 分离：DeepSeek 的 API key 与 Codex token 互不干扰。
配置冲突：不要在 llm-pi-ai.providers 中添加 openai-codex，这会激活宿主的另一套适配器并与本插件冲突。
适配版本：适配目标为 DSH Desktop 0.1.7-rc.2 包系列。

结尾¶

该插件通过 OAuth 接入 Codex，提供了原生 Fast 模式和网络搜索能力，并解决了凭证管理与用量监控问题。更多细节可参考 GitHub 仓库。