前言¶
DeepSeek Harness (DSH) 允许在同一环境中混合使用 DeepSeek 和 GPT 等不同模型。然而,GPT-5.6 等模型在 DSH 默认的 Standard 模式下表现不佳,因为它们的后训练期望的是 Codex 使用的提示词、工具、架构和结果格式。dsh-codex 插件通过注入 Codex 风格的工具接口和系统提示词,为 GPT 模型创建一个熟悉的编程环境,同时保留 DSH 对 DeepSeek 模型的原生支持。
核心能力¶
该插件通过一个即插即用的扩展包,为选定的 GPT 模型注入以下能力:
- 结构化补丁工具:提供基于语法的 OpenAI 自定义工具调用,专门用于
apply_patch操作,确保补丁格式符合预期。 - 统一执行环境:将
exec_command和write_stdin统一为 Codex 风格的执行接口,支持生成后台会话和交互式 PTY(伪终端)。 - 终端视图定制:使用原生的 Web Bash 行替换通用视图,并展示 Codex 风格的“仅进程”后台终端列表。
- 协作与规划工具:引入
update_plan、request_user_input和view_image等工具,支持/plan协作模式和/goal长期工作流。 - 系统提示词注入:从用户选择的提示词库中加载 GPT-5.6 Sol Codex 系统提示词。
- 底层行为保留:在 Codex 风格的线缆格式之下,继续使用 DSH 原生的沙箱、审批、待办列表、提问、附件和工具展示逻辑。
安装与启用¶
安装该插件需要将包添加到 DSH 的 profile 中。安装完成后,需重启进程并选择相应的预设。
dsh plugin --profile web add @ryantzhou/dsh-codex
安装完成后,重启对应的 DSH 进程。在创建会话时,选择 Codex-style mode 以启用该环境。
若需卸载,执行以下命令:
dsh plugin --profile web remove @ryantzhou/dsh-codex
兼容性与注意¶
在部署前需注意以下技术细节:
- 版本依赖:版本 0.2.0 专为 DSH 0.1.0-rc.6 和 pi-ai 0.82.1 设计。
- 模型路由要求:语法约束的工具(如
apply_patch)需要使用 GPT-5+ 的 pi-ai 路由,且该路由的模型元数据中必须启用supportsOpenAIGrammarTools。若路由不支持,插件将回退到 pi-ai 的标准函数工具。 - 依赖锁定:依赖项已锁定。若升级 DSH 导致依赖不兼容,安装将失败,避免因版本冲突导致行为静默变更。
- 许可证:原始代码为 MIT 许可证。Codex 衍生的语法和行为参考保留 OpenAI 的 Apache-2.0 通知。
结语¶
dsh-codex 让 GPT 模型能够在 DSH 中发挥其针对 Codex 接口优化的编程能力,同时也让开发者能够继续使用 DSH 原生的状态管理和审批机制。这使得在同一 DSH 实例中混合使用 DeepSeek 和 GPT 模型成为可能。
- GitHub 仓库:ryanzhou/dsh-codex
- 插件目录:ryanzhou/dsh-codex