dsh-codex-pilot
把本机 OpenAI Codex CLI 接成 DeepSeek Harness 的原生工具：DSH 里的 agent 可以直接把一整块活派给 Codex，拿到结果、续接会话、甚至往运行中的会话里投消息。
同一套 op 语义有两种形态，按需选一种：
| 形态 | 入口 | 需要什么 |
|---|
| DSH 插件（推荐） | lib/index.js，注册 codex_* 工具 | 已装 DSH + 本机 codex |
| 独立桥 | standalone/bridge.cjs，HTTP + 文件信箱 | 只要 Node ≥ 20 |
两者都只是 codex CLI 的一层薄封装：不代理模型、不碰凭据，用的是你本机已经登录好的 Codex。
安装
# 从 GitHub 装（未发 npm 时）
dsh plugin --profile web add github:Dobo233/dsh-codex-pilot
# 本地开发
dsh plugin --profile web add E:\path\to\dsh-codex-pilot
装完重启 DSH（或让 patchReload 生效），工具面板里应出现 codex_run / codex_resume / codex_queue / codex_probe。
工具
| 工具 | 干什么 | 底层 |
|---|
codex_run | 开一次性会话跑一整块任务，同步返回输出 | codex exec [--skip-git-repo-check] -C <cwd> [-s <mode>] [-m <model>] "<prompt>" |
codex_resume | 续接已有会话 / 最近一个会话 | codex exec resume <id> "<prompt>"、codex exec resume --last |
codex_queue | 往正在运行的会话投一条消息，不打断当前回合 | codex queue --thread <id> --message <text> |
codex_probe | 体检：解析到的可执行文件、版本、子命令是否可用 | codex --version / exec --help / queue --help |
codex_probe 是排错第一站：codex_* 报错时先跑它，能区分「找不到 codex」「版本太老没有 queue」「cwd 不存在」。
配置
插件配置（cordis.patch.yml 的 config 字段，或 profile 里的条目 config）：
codexPath: null # 显式路径；null = 自动探测（LOCALAPPDATA\OpenAI\Codex\bin\*\codex.exe 按 mtime 取最新，再退 ~/.codex/.sandbox-bin/codex.exe，再退 PATH）
codexHome: null # CODEX_HOME；null = ~/.codex
defaultCwd: null # 默认工作目录；null = DSH 进程 cwd
timeoutMs: 600000 # 单次调用超时
maxOutputChars: 20000 # 返回给模型的输出上限，超长保留尾部（Codex 的结论在末尾）
skipGitRepoCheck: true # 是否给 codex exec 加 --skip-git-repo-check
extraEnv: {} # 追加给子进程的环境变量
自动探测是刻意的：Codex 每次升级会换 bin/<hash> 目录，写死路径必然失效。
独立桥（不用 DSH）
node standalone/bridge.cjs # 默认 http://127.0.0.1:8787
node standalone/bridge.cjs --config my.json
- HTTP：
GET /health、GET /probe、POST /run、POST /resume、POST /queue（别名 POST /codex、POST /start）
- 文件信箱：把请求写成
mailbox/inbox/<id>.json，结果落到 mailbox/results/<id>.json；坏 JSON 进 mailbox/quarantine/
- Windows 上
.\standalone\ask.ps1 "任务描述" 是最短路径（桥没起来会自动拉起）
请求体字段：{ prompt, cwd?, model?, sandbox?, timeoutMs?, sessionId?, last? }（/queue 用 { thread, message }）。
安全边界
- 只跑本机已登录的 Codex，不读取、不转发、不存储任何 token。
codex exec 有写文件和执行命令的能力 —— 想收紧就传 sandbox: "read-only"，或在 execArgs 里自己加旗标。- 桥只绑
127.0.0.1，没有鉴权：别改成 0.0.0.0，别暴露到公网。
- 插件声明
inject: ["tools"]，只用 ctx.tools.register，不碰文件系统之外的宿主能力。
兼容性
- DSH：
0.2.x（engines 未锁死，patch 走 dsh.bundle 清单）
- Node：
^22.19.0 || >=24.0.0
- Codex CLI：
0.163.x 实测；queue 需要较新版本，老版本 codex_probe 会明确报 queue 子命令: 不可用
English
dsh-codex-pilot exposes the local OpenAI Codex CLI as DSH tools (codex_run, codex_resume, codex_queue, codex_probe) plus a standalone loopback bridge (HTTP + file mailbox) for use without DSH. It wraps your already-authenticated codex binary — no model proxying, no credential handling. Binds 127.0.0.1 only, no auth: do not expose it.
License
MIT
