前言¶
DeepSeek Harness (DSH) 负责聊天界面，Codex CLI 负责任务执行与原生历史。传统的桥接方案往往需要引入第二个 AI 来转述或模拟上下文，导致延迟增加且历史记录不完整。本插件实现了 DSH 与 Codex CLI 的直连：DSH 仅作为客户端展示层，Codex CLI 作为宿主层，消息直接进入 Codex 的原生 turn，界面渲染的每一个字都由 Codex 自己推送的协议帧生成。
核心功能¶
- 打开旧对话：支持查询线程列表、读取历史并恢复会话。
- 新建任务：创建原生 Codex 线程，可指定工作目录、模型和权限策略。
- 发送消息：消息直接进入 Codex 的
turn/start，无中间转发。 - 流式输出：实时接收并渲染 Codex 的协议帧。
- 工具展示：显示命令执行、文件变更、工具调用等通知。
- 停止任务：通过
turn/interrupt真正中断执行。 - 审批与提问：界面接收服务端请求，用户选择后回传。
- 刷新与重启：支持断线重连和关联持久化。
安装与启用¶
前置条件：
* DeepSeek Harness（带 Web GUI：桌面端或 dsh web）。
* Codex CLI（已登录态）。
* Node.js 18+。
安装步骤：
1. 执行安装命令：
dsh plugin --profile desktop add git+https://github.com/447662/dsh-native-codex-cli.git
- 必须重启 DSH。profile 的 bundle 列表不会热加载，安装后需重启才能激活插件。
典型用法¶
插件提供多种交互入口：
- 会话绑定：在 DSH 会话中输入
@Codex <任务>，或点击输入框右侧的 Codex 按钮。 - 接管输入：绑定后，该会话的输入框被 Codex 接管，后续消息无需再写
@Codex，全部直接进 Codex。 - 独立工作台：点击侧边栏的 Codex 图标，进入独立的线程列表、新建任务、对话流和输入管理界面。
配置与排查¶
配置文件：~/.dsh/storages/dsh-native-codex-cli/config.json
插件不导出 Config schema 以避免 Cordis 验证错误，若配置文件缺失或损坏，会自动使用代码默认值。
排查建议：
* 插件日志位于 ~/.dsh/logs/dsh-native-codex-cli.log。
* Codex CLI 不强制依赖 PATH，会自动在常见路径（如 %LOCALAPPDATA%\Programs\OpenAI\Codex\bin）查找。
* 若安装后未生效，检查日志中是否有 [boot] module imported、[host] ... loaded 等标记。
适用场景¶
适合需要在 DSH 中通过熟悉的聊天界面直接驱动 Codex CLI 的开发者。插件以当前 DSH 进程权限运行，使用前建议检查源码与许可证（MIT）。
总结¶
该插件通过直连协议，让 DSH 的聊天界面成为 Codex CLI 的操作面板，实现了“界面由 DSH 管理，执行由 Codex 负责”的架构，避免了二次 AI 的开销。
资源：
* GitHub: https://github.com/447662/dsh-native-codex-cli
* 生态目录: https://www.skillhub.cn/plugins/447662/dsh-native-codex-cli
