DeepSeek Harness 插件：dsh-chatgpt-codex

前言¶

DeepSeek Harness (DSH) 采用插件化架构。目前，DSH 的主模型路由并不包含 ChatGPT/Codex OAuth 支持。dsh-chatgpt-codex 插件填补了这一空白。它允许在 DSH 中直接使用 ChatGPT 账户和 Codex 模型，支持浏览器回调和设备码登录，且不依赖 pi-ai 适配器。

核心功能¶

该插件负责管理 ChatGPT 认证的生命周期，并将 Codex 响应流式传输到 DSH 原生协议中。

认证方式：支持浏览器回调（PKCE，严格状态检查，localhost 回调）和设备码登录（适合 SSH、容器或无头环境）。
凭证管理：自动刷新访问令牌，支持进程内和跨进程锁防止并发冲突；凭证以原子方式存储在 $DSH_HOME 下，权限受限。
模型支持：注册为原生的 openai-codex DSH 模型提供者，无需 pi-ai。支持 GPT-5.6 (Luna, Terra, Sol) 及 GPT-5.5/5.4 等模型。
流式传输与回放：支持文本、推理摘要、函数调用、图片、Usage 及 Finish Reasons 的流式传输。使用加密推理项目回放，确保多轮对话的正确性。

安装与启用¶

1. 登录¶

在安装插件前，需先完成认证。根据环境选择方式：

桌面浏览器回调（推荐）：

    dsh-chatgpt-codex login

设备码登录（推荐用于 SSH 或容器）：

    dsh-chatgpt-codex login --device

认证文件默认存储在 `$DSH_HOME/chatgpt-codex/auth.json`。

2. 添加插件¶

使用官方安装命令将插件注册到指定 profile：

dsh plugin --profile codex add github:sudipnext/dsh-chatgpt-codex#v0.1.0

3. 运行 Harness¶

切换到插件定义的 profile 启动：

dsh --profile codex

该 profile 会注册 openai-codex 提供者，并将 gpt-5.6-luna 设为默认模型。

使用方法¶

安装并登录后，可使用以下命令管理凭证：

查看状态（安全输出，不打印令牌）：

    dsh-chatgpt-codex status

查看 JSON 状态：

    dsh-chatgpt-codex status --json

手动刷新令牌：

    dsh-chatgpt-codex refresh

登出（仅移除本地凭证，不远程撤销会话）：

    dsh-chatgpt-codex logout

注意事项¶

独立项目：这是一个独立的社区插件，并非 OpenAI 或 DeepSeek 的官方项目。
模型可用性：模型目录仅作参考，实际可用性取决于您的 ChatGPT 订阅计划、工作区策略、区域以及 OpenAI 的当前发布进度。
安全提示：logout 命令仅删除本地存储的凭证文件，不会远程注销 OpenAI 会话。请确保在不再使用时妥善保管凭证文件。