dsh-plugin-codex

通过官方 Codex App Server，把 Codex 作为独立模型提供方接入 DeepSeek Harness Web。插件保留 DSH 的会话、模型选择器和权限 UI，同时使用 Codex 自己的 AGENTS.md、skills、MCP 与原生编码工具。

安装

宿主机先完成 Codex CLI 登录。推荐直接通过 npx 安装到 Web profile：

npx dsh-plugin-codex

安装器默认使用 web profile；可通过 --profile <名称>、--force 或 --dsh <路径> 调整。如果 PATH 中没有 dsh，安装器会临时使用兼容的 @deepseek-ai/dsh CLI。

也可以使用已有的 DSH CLI 安装：

dsh plugin --profile web add dsh-plugin-codex
dsh web

网页模型选择器中会出现 Codex。插件精确携带 @openai/[email protected]，不会调用 PATH 中其他版本的 Codex。

配置

默认配置可直接使用。需要覆盖时，在 profile 的 cordis.patch.yml 中完整重述：

- id: codex
  config:
    codexHome: /home/me/.codex
    startupTimeoutMs: 15000
    shutdownGraceMs: 3000
    commandOutputLimitBytes: 262144

codexHome 省略时继承宿主 CODEX_HOME，再由 Codex 回退到 ~/.codex。认证文件和密钥不会发送到浏览器。

行为

• 同一 DSH 会话恢复同一 Codex thread；DSH fork 创建独立 Codex fork。
• 从其他模型切回 Codex 时，以网页可见对话建立新 thread，并明确显示上下文重建提示。Codex 的隐藏推理和旧工具状态不会跨 provider 切换保留。
• DSH 的 read-only、workspace-write、danger-full-access 以及 ask、never 映射到 Codex 的 turn 权限；审批和提问在网页完成。
• 文本、图片、最终答案、推理、命令、文件修改、计划、MCP、搜索、usage 和取消均接入。命令详情按 UTF-8 字节上限截断。

已知限制

• V1 复用宿主 Codex 登录，不提供网页登录流程。
• shell 网络在 workspace-write 下默认关闭；需要网络时由 Codex 发起权限请求。
• MCP structured form 的复杂字段当前以通用审批详情展示；拒绝和取消始终 fail-closed。