前言¶
DeepSeek Harness (DSH) 是一个面向开发者的工具,提供了对话、工作区和工具管理等核心能力。对于需要在 DSH 中使用 Codex 模型的用户来说,在保持 DSH 界面流畅的同时调用 Codex,可以避免频繁切换客户端或维护额外的代码分支。relay-dsh-plugin-codex 旨在实现这一目标。
插件简介¶
- 名称:
relay-dsh-plugin-codex - 维护者: yangbobo2021
- 类别: 模型推理
- 许可证: MIT
该插件为 DSH 提供了原生的 Codex 对话后端,通过 Codex App Server 运行,同时保留 DSH 的会话管理、工作区和工具支持。
核心功能¶
- 原生 Codex 后端: 将 Codex 作为对话后端直接接入 DSH。
- 保留 DSH 上下文: 保留 DSH 的工作区、对话历史、编辑器、审批和工具。
- 会话关联: 每个 DSH 会话对应一个 Codex App Server 线程,确保对话的连续性。
- 统一对话: 在同一次对话中可以使用 Codex 模型、推理能力、图片、中断机制以及 DSH 贡献的工具。
安装与启用¶
安装前需确保环境满足要求:
-
环境要求:
- Node.js 22.13 或更新版本
pnpm已添加到系统路径
-
执行安装:
使用官方提供的命令安装最新稳定版本:
npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-codex@latest
- 启动 DSH:
npx @deepseek-ai/dsh@0.1.2-rc.1 web
典型用法¶
使用前需完成 Codex 的身份验证。
- 身份验证:
在第一次创建会话前,确保已通过官方 Codex 客户端登录。使用 CLI 时可执行:
codex login
- 创建会话:
打开 DSH,点击 New Session,选择一个工作区,从模式菜单中选择 Codex,然后发送消息。
适用场景与限制¶
适用场景:
* 需要在 DSH 内部使用 Codex 模型,避免界面切换。
* 希望保留 DSH 原生的对话历史、编辑器和工具能力。
* 需要在同一个对话中混合使用 Codex 模型和 DSH 的工具。
已知限制与注意事项:
* DSH 状态: DSH 目前处于开发者预览阶段,可能会引入破坏兼容性的变更。
* 不包含的功能: 该插件不添加 Relay Events、文件浏览或终端面板。
* 已知问题: 偶尔会出现空的本地命令事件。
* 功能差异: 不具备完整的桌面端功能对等性。
总结¶
该插件通过集成 Codex App Server,让 DSH 用户能在同一环境中享受 Codex 的推理能力,同时维持 DSH 现有的工作流习惯。相关源码与目录页可参考下方链接。