DeepSeek Harness 插件：dsh-llm-openai-codex

前言¶

DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在本地模型推理或智能体开发中，调用 OpenAI Codex 是常见需求。现有的 DSH 插件通常依赖 API Key 进行鉴权，而 OpenAI Codex 后端基于 OAuth 机制，没有 API Key 可用。dsh-llm-openai-codex 插件解决了这一冲突，它复用 pi-ai 的通用请求 machinery，将 ChatGPT 的 OAuth 访问令牌作为鉴权凭证，从而在 DSH 中使用 Codex 模型。

插件概览¶

• 名称：dsh-llm-openai-codex
• 类型：模型推理
• 维护者：auggie246
• 许可证：MIT
• 核心能力：
  • 为 DSH 添加 openai-codex 路由。
  • 使用 OAuth 登录，无需 OPENAI_API_KEY。
  • 支持自动令牌刷新。
  • 支持自动模型发现。
  • 提供 Web 登录卡片（PKCE 或设备代码）。

安装与启用¶

安装前请确保环境满足以下要求：
* DeepSeek Harness 版本为 0.2.0-rc.2，且配置了 web profile（旧版 0.1.x 不支持）。
* Node.js 版本 >=22.19.0。
* 拥有包含 Codex 访问权限的 ChatGPT 订阅（Plus, Pro, Business 或 Enterprise）。
* 具备 DSH 管理的凭证或 Codex CLI 的共享登录文件。

1. 安装插件
使用以下命令安装：

dsh plugin --profile web add dsh-llm-openai-codex

2. 激活插件
编辑 ~/.dsh/profiles/web/cordis.patch.yml，添加以下内容：

- insert:
    - id: llm-openai-codex
      name: 'dsh-llm-openai-codex'

保存文件后，重启 dsh web 或 DSH 进程。

使用方法¶

插件激活后，在 DSH 的左侧侧边栏进入 Plugins 页面，找到 dsh-llm-openai-codex 插件条目。登录卡片位于插件描述下方。

1. 凭证来源
登录卡片支持两种凭证来源：
* DSH 管理凭证（默认）：插件会在 $DSH_HOME/credentials/openai-codex.json 存储令牌。
* 共享 Codex CLI：读取 ~/.codex/auth.json 或 $CODEX_HOME/auth.json。

2. 登录操作
* 点击 Connect ChatGPT in browser：通过浏览器进行 PKCE OAuth 登录，回调地址为 http://localhost:1455/auth/callback。
* 点击 Use device code：当回调端口被占用或浏览器处于远程环境时使用。

3. 选择模型
登录成功后，在 DSH 的模型选择器中选择 openai-codex/<model> 格式的模型。

配置项说明¶

在 cordis.patch.yml 的配置块中，storage 是唯一会被 Web 界面写入的键，用于指定凭证存储路径。其他配置项需重启 DSH 生效。常用配置包括：
* storage: 指定凭证来源（dsh 或路径）。
* modelDiscovery: auto: 自动从后端获取最新模型列表。
* refreshMarginMs: 令牌刷新前的剩余时间（默认 60000ms）。
* retryPolicy: 失败重试策略。

注意事项¶

• 不支持 API Key 登录：该插件不兼容仅使用 API Key 的 Codex CLI 登录方式。
• 登录卡片位置：登录入口在侧边栏的 Plugins 页面，而非 Settings 设置页。
• 无需 API Key：安装和运行过程中不需要设置 OPENAI_API_KEY 环境变量。

生态背景¶

该插件收录于社区目录。DSH 的插件生态由社区维护，旨在扩展框架的推理能力，与 DeepSeek 官方无直接从属关系。

参考资料¶

• GitHub 仓库
• 社区目录