DeepSeek Harness (DSH) 提供了插件化的运行时环境。当开发者需要在 DSH 的上下文中直接利用 ChatGPT Codex 进行代码生成、图像创作或网络检索时，通常需要维护额外的 CLI 进程或处理复杂的跨进程通信。DSH Codex Adapter 插件通过适配器模式，将 ChatGPT 的能力直接集成到 DSH 的工作流中，提供统一的账号管理与界面入口。
这是一个由 baixianger 维护的 DSH 插件，属于模型推理类别。它的核心价值在于复用 ChatGPT 的 Codex 后端，支持流式回复、图像上下文传递，并提供了账号登录、用量监控和本地化设置界面，使开发者无需脱离 DSH 环境即可使用 ChatGPT 的能力。
核心功能¶
- 编码对话：提供
openai-codex模型路由，支持流式回复以及图片上下文输入。 - 账号与用量管理：支持 ChatGPT 账号登录、CLI 登录导入、取消操作及登出功能。支持查看计划和用量窗口（当服务返回数据时）。
- 图像生成：集成
imagegen工具，支持生成过程中的内联预览、尺寸设置、下载以及保存至工作区的状态显示。 - 参考图像编辑：支持基于工作区中的图片或最近的图像附件进行编辑。
- Web 搜索：提供 Codex 搜索提供者，支持缓存、索引和实时三种搜索模式。
- 原生设置：提供完整的 Codex 设置页面、紧凑的插件卡片，并支持亮/暗主题切换及中/英文标签。
安装与启用¶
在安装前，请确保你的环境满足以下要求：
* DSH 版本 0.1.5 及以上（适配器接口版本）。
* Node.js 版本 22.19+ 或 24+。
如果环境中已安装 dsh-codex 插件，由于两者均占用 openai-codex 路由，安装前需要先移除旧插件：
dsh plugin --profile web remove dsh-codex
安装新插件并启动 Web 界面：
dsh plugin --profile web add dsh-codex-adapter@latest
dsh web
安装完成后，打开 Settings → Codex 进行登录配置。你可以通过浏览器或设备登录 ChatGPT，也可以导入现有的 CLI 登录凭证。登录状态由 DSH 的凭证服务统一管理。
典型用法¶
图像生成
在对话中输入提示词，插件会通过 imagegen 工具处理请求。例如：
Generate one watercolor illustration of an orange cat by a sunny window, with a small green plant and no text. Save it as window-cat.png.
生成结果会以图片卡片形式展示，包含尺寸、大小、下载按钮及工作区保存状态。生成的图片作为持久化附件，支持后续对话中的上下文引用。
Web 搜索配置
在 DSH 的配置文件中指定 Codex 作为搜索提供者（DSH 的抓取提供者仍由 DSH 自身管理）：
# ~/.dsh/profiles/web/cordis.patch.yml
- id: web
config:
searchProvider: openai-codex
fetchProvider: http
状态查询
使用 CLI 命令查看插件状态或导入凭证：
dsh plugin --profile web exec dsh-codex-adapter status
dsh plugin --profile web exec dsh-codex-adapter import
适用场景与注意¶
该插件适合需要将 ChatGPT 的编码、绘图和搜索能力嵌入到 DSH 工作流中的开发者。插件以当前 DSH 进程的权限运行，安装前应检查源码与许可证。
需要注意的是，该插件不实现快速模式、原生压缩或 /codex 终端命令。生成的图片仅在提供二进制写入权限的远程文件系统中支持保存至工作区，否则将作为附件保留。
总结¶
DSH Codex Adapter 通过复用 pi-ai 库的认证流和 DSH 的 PiAiAdapter 契约，实现了对 ChatGPT Codex 能力的无缝集成。它不仅提供了功能接口，还完善了账号管理与设置界面，降低了在 DSH 中调用 ChatGPT 能力的门槛。更多详情与反馈，请参考 GitHub 仓库。
