@whaletalk/dsh-codex-collab 0.1.5 → 0.1.6

package/README.md

@@ -6,38 +6,51 @@
 
 **Codex 主导，DeepSeek 执行，Codex 验收。** 一个插件体系，让 ChatGPT（Codex）像项目经理一样把编码任务派给本机 DeepSeek Harness 的编码子代理，实时回传结果，读文件验收，并由独立评审员实际跑通构建/测试后出具评审报告。
 
+派活有**两种目标**，必须显式选一种——"接进用户正在用的那条对话"和"新建一个干活的子代理"是两件事：
+
+| 目标 | 什么时候用 | 效果 |
+|---|---|---|
+| `worker`（默认） | 全新任务、独立项目目录 | 在 `--cwd` 里新建持久编码子代理（多工作区 · 多 lane · fast/pro 模型） |
+| `session` | 用户已经在某条对话里推进这件事，你只是替他继续 | 指令**投递进那条会话**，沿用它的上下文，**不新建会话/工作区** |
+
 ```
 Codex 工作区 (ChatGPT)
-   │  派活 / 评审 / 验收
+   │  dsh_task / dsh_sessions / dsh_review / dsh_read_file
    ▼
-DeepSeek Harness 网关 ── 编码子代理（多工作区、多 lane、fast/pro 模型）
-   │                     独立评审子代理（必须跑通构建/测试）
-   ▼
-共享工作目录（任意目录，--cwd 指定）
+DeepSeek Harness 网关 /api/dsh-bridge
+   ├─ worker 目标 ──→ 新建编码子代理（多工作区 · 多 lane · fast/pro）─┐
+   ├─ session 目标 ─→ 已有那条会话（prompt 投递，queue / steer）  ──┤
+   └─ 独立评审子代理（必须跑通构建/测试）───────────────────────────┴→ 共享目录 / 原会话
 ```
 
 ```mermaid
 flowchart LR
     subgraph Codex["Codex (ChatGPT) — 项目经理 + 验收员"]
-        A1[dsh_task 派活]
-        A2[dsh_review 评审]
-        A3[dsh_read_file 验收]
+        A1[dsh_sessions 找会话]
+        A2[dsh_task 派活]
+        A3[dsh_review 评审]
+        A4[dsh_read_file 验收]
     end
     subgraph DSH["DeepSeek Harness"]
         B1[HTTP 网关 /api/dsh-bridge]
-        B2[编码子代理<br/>多工作区 · 多 lane · fast/pro]
-        B3[独立评审子代理<br/>必须跑通构建/测试]
+        B2[worker 目标<br/>新建编码子代理]
+        B3[session 目标<br/>投递进已有会话]
+        B4[独立评审子代理<br/>必须跑通构建/测试]
     end
-    subgraph FS["共享工作目录"]
-        C1[任意项目目录]
+    subgraph FS["工作现场"]
+        C1[共享工作目录]
+        C2[已有会话与其上下文]
     end
-    A1 --> B1
+    A1 -->|只读查找| B1
     A2 --> B1
-    A3 --> C1
+    A3 --> B1
+    A4 --> C1
     B1 --> B2 --> C1
-    B1 --> B3 --> C1
+    B1 --> B3 --> C2
+    B1 --> B4 --> C1
     B2 -.实时回传汇报.-> B1
-    B1 -.任务结果.-> A1
+    B3 -.实时回传汇报.-> B1
+    B1 -.任务结果.-> A2
 ```
 
 ---
@@ -48,7 +61,10 @@ flowchart LR
 |---|---|---|
 | `codex-plugin/` | Codex 本地市场插件包 | 标准 marketplace 结构（`.agents/plugins/marketplace.json` + 插件目录），含协作技能 `dsh-collab` |
 | `mcp/dsh-mcp.mjs` | MCP 服务器（零依赖 Node） | stdio 传输（Codex `[mcp_servers]` 直连）+ Streamable HTTP 传输（`--http`，供 Secure MCP Tunnel / cloudflared 桥接 ChatGPT）；6 个工具：`dsh_task` / `dsh_sessions` / `dsh_task_status` / `dsh_task_cancel` / `dsh_review` / `dsh_read_file` |
-| `harness/dsh-bridge.mjs` | DeepSeek Harness 宿主组合网关插件 | 提供 HTTP 网关（`/api/dsh-bridge/*`）、WS 推送、原生工具，管理编码/评审子代理会话。**必须装进 harness 宿主组合**（见下文） |
+| `harness/dsh-bridge.mjs` | DeepSeek Harness 宿主组合网关插件 | 提供 HTTP 网关（`/api/dsh-bridge/*`）、WS 推送、原生工具；管理编码/评审子代理，并把任务投递进已有会话。**必须装进 harness 宿主组合**（见下文） |
+| `harness/session-target.mjs` | 会话目标的纯决策层 | 目标判定、候选挑选（0/1/N 不猜）、RemoteError→稳定 reason、基线切分、汇报选文。无 DSH import，可单测；`dsh-bridge.mjs` 依赖它，**两个文件必须一起部署** |
+| `test/` | 25 项 Node 测试 | `session-target` 纯函数单测 + `dsh-bridge` 路由级回归测试（假 DSH 运行时加载真实 bridge）。CI 每次都跑 |
+| `templates/codex-mcp/` | 反向通道配置模板 | 把 Codex CLI 当 MCP 服务端挂进 DSH（得到 `mcp__codex__*` 工具），让 DSH 侧也能调用 Codex。见下文「反向通道」 |
 | `cordis.patch.yml` | bundle patch | 把网关插件挂进 DSH 宿主组合；`dsh.bundle.patch` 指向它，所以 `dsh plugin add` 能自动 reconcile |
 
 ## 功能
@@ -69,7 +85,8 @@ flowchart LR
 
 ```sh
 # 1) 网关插件装进 harness profile（自动 reconcile bundles，无需手工复制文件）
-dsh plugin --profile web add @whaletalk/dsh-codex-collab
+dsh plugin --profile desktop add @whaletalk/dsh-codex-collab
+#    ↑ DSH 客户端用的就是 desktop profile；纯 Web 部署换成 --profile web
 
 # 2) MCP 服务器交给 Codex
 npm install -g @whaletalk/dsh-codex-collab
@@ -81,9 +98,27 @@ npm install -g @whaletalk/dsh-codex-collab
 [mcp_servers.dsh]
 command = 'dsh-mcp'
 startup_timeout_sec = 120
+env = { DSH_BRIDGE_URL = "http://127.0.0.1:3080" }   # 见下方"端口"；不写则默认 3080
 ```
 
-装完**必须重启 profile 进程**——`dsh plugin add` 改的是 bundles 列表与 node_modules，HMR 不监控这两处。
+**端口**：网关挂在 profile 的 `webServer` 上，地址取决于 profile 怎么起的——独立 harness 通常 `3080`，而 DSH 客户端里就是 **GUI 自己的端口**（例如 `http://127.0.0.1:19387`）。MCP 与 CLI 都用 `DSH_BRIDGE_URL` 找网关，指错只会看到连接失败或 401。验证：
+
+```sh
+curl http://127.0.0.1:3080/api/dsh-bridge/status
+```
+
+装完**必须重启 profile 进程**——`dsh plugin add` 改的是 bundles 列表与 node_modules，HMR 不监控这两处；**替换包内容也不会热重载**（ESM 缓存），只有重启进程才加载新版本。
+
+### 升级到新版本（有坑，照做）
+
+```sh
+# 1) 带精确版本号安装：不带版本号时 lockfile 会把旧版按回来
+dsh plugin --profile desktop add @whaletalk/dsh-codex-collab@<新版本>
+# 2) 重启 profile 进程：不重启不会加载新的 JS 模块
+```
+
+- **不要用"卸载 → 重装"**：卸载会把这个包从 `dsh.profile.bundles` 移除；重装后若没被重新选中，插件根本不会挂载（表现：所有 `/api/dsh-bridge/*` 都落到网关鉴权层返回 **401**）。真遇到了就在客户端插件页把它的开关打开。
+- **刚发布的版本约 24 小时内装不上**：profile 的 pnpm 带 `minimumReleaseAge` 供应链冷却（`ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`）。管理器会把它写进 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` 才放行；手工安装可临时加 `--config.minimumReleaseAge=0`。
 
 > 本包只提供 bundle patch，不含 profile 之外的强依赖：`@deepseek-ai/dsh-tools` 是 optional peer，由 DSH 安装树在运行时提供。因此 `npm install` 不会去 registry 拉它，也不会因它缺失而报错。
 
@@ -92,21 +127,23 @@ startup_timeout_sec = 120
 
 ### 1. DeepSeek Harness 网关（必需，后端）
 
-把 `harness/dsh-bridge.mjs` 复制到你的 dsh profile 目录（例如 `$DSH_HOME/profiles/web/`），并在该目录的 `cordis.patch.yml` 中追加：
+把 **`harness/` 整个目录**复制到你的 dsh profile 目录（例如 `$DSH_HOME/profiles/web/` 下的 `harness/`），并在该目录的 `cordis.patch.yml` 中追加：
 
 ```yaml
 - insert:
     - id: dsh-bridge
-      name: './dsh-bridge.mjs'
+      name: './harness/dsh-bridge.mjs'
 ```
 
+> `dsh-bridge.mjs` 会 `import './session-target.mjs'`——**两个文件必须在一起**，只复制前者会直接加载失败。
+
 重启 harness。默认共享工作目录为 `D:\Harness`，可用环境变量 `DSH_BRIDGE_WORKSPACE` 覆盖。验证：
 
 ```
 GET http://127.0.0.1:3080/api/dsh-bridge/status
 ```
 
-> 手工方式必须用相对路径 `'./dsh-bridge.mjs'`，因为文件就在 profile 目录里；npm 方式则用包子路径 `@whaletalk/dsh-codex-collab/bridge`，两者不要混用。
+> 手工方式必须用相对路径（文件就在 profile 目录里）；npm 方式则用包子路径 `@whaletalk/dsh-codex-collab/bridge`，两者不要混用。
 
 ### 2. Codex 侧（二选一或都用）
 
@@ -158,12 +195,27 @@ tunnel-client run --profile dsh
 
 **Codex 工作区会话**（MCP 工具就绪后）：
 
-> 用 dsh_task 让 DeepSeek 生成一个随机密码 CLI + 测试 + README，放在当前项目目录，完成后你用 dsh_read_file 验收，再 dsh_review 评审
+> **新建子代理**：用 dsh_task 让 DeepSeek 生成一个随机密码 CLI + 测试 + README，放在当前项目目录，完成后你用 dsh_read_file 验收，再 dsh_review 评审
+>
+> **接进原对话**：先用 dsh_sessions 按标题找到用户正在用的那条会话，再用 dsh_task 带 sessionId 把下一步指令投递进去（不要新建会话）
+
+**MCP 工具**（Codex 侧首选，工具名带 `mcp__dsh__` 前缀）：
+
+```jsonc
+// 1) 找到会话（只读）
+dsh_sessions({ "query": "按文档启动OKX策略实验计划" })
+// → { "items": [{ "sessionId": "session-8d481ad9-…", "snippet": "按文档启动OKX策略实验计划",
+//                 "agentAvailable": true }], "matchedBy": "list" }
+
+// 2) 投递进那条会话
+dsh_task({ "instruction": "继续推进第 3 步…", "sessionId": "session-8d481ad9-…" })
+// deliver 可选 "queue"（默认，排队）或 "steer"（插入当前回合）
+```
 
 **命令行**（npm 安装后直接用；源码方式用 `node <脚本路径>`）：
 
 ```bash
-# 新建子代理（原有行为）
+# 新建子代理（默认行为）
 dsh-task --in "<指令>" --cwd "<目录>" [--lane backend] [--model fast|pro] [--commit]
 
 # 接进已有会话：先找，再派
@@ -180,19 +232,74 @@ dsh-task --list | --status <taskId> | --cancel <taskId> [--force]
 ```bash
 # 1) 找到（只读，不创建任何东西）
 dsh-task --sessions "按文档启动OKX策略实验计划"
-# → {"items":[{"sessionId":"session-8d481ad9-...","snippet":"@okx-strategy-lab/ 开始按照文档进行计划"}]}
+# → {"items":[{"sessionId":"session-8d481ad9-…","snippet":"按文档启动OKX策略实验计划",
+#              "agentAvailable":true}],"total":1,"matchedBy":"list"}
 
-# 2) 接通（指令投递进那条会话，跑完把这一轮的助手回复作为汇报返回）
-dsh-task --in "<继续推进的指令>" --session "session-8d481ad9-..."
+# 2) 接通（投递进那条会话；这一轮的助手回复作为汇报返回，只回报本轮新增文本）
+dsh-task --in "<继续推进的指令>" --session "session-8d481ad9-…"
 ```
 
+`matchedBy` 说明"找到"走了哪条路：`search` = 会话搜索索引；`list` = 索引被部署禁用时退回遍历列表 + 标题投影（都不激活 Agent）。
+
 失败一律返回稳定 `reason` 且**不创建任何会话/工作区**：`session-query-empty`（没命中）、`session-ambiguous`（多条命中，附 `candidates`）、`session-not-found`、`session-busy`、`session-writer-held`（会话被别的写入方占用）、`session-archived`、`session-not-accepted`、`session-timeout`、`session-cancel-refused`（取消会话目标默认被拒，需 `--force`）。
 
+## 反向通道：让 DSH 调用 Codex
+
+上面的链路都是 **Codex → DSH**。反过来的 **DSH → Codex** 也能做，但要分清两种含义：
+
+| 含义 | 可行性 |
+|---|---|
+| 让 DSH 调用 Codex（把 Codex 当执行器/评审员） | ✅ 两端原生支持，见下 |
+| 让 DSH 往你**正开着的某条 ChatGPT/Codex 对话**里插一条消息、就地开一轮 | ❌ 做不到 |
+
+第二种做不到的原因：现有链路是 Codex 主动（它启动 `dsh-mcp` 子进程调工具），而 MCP 是
+**客户端发起**的协议——服务端无法命令客户端开一轮。服务端→客户端只有 `notifications/*`
+（纯通知，不触发回合）、`sampling/createMessage`、`elicitation/create`（取决于客户端是否
+实现，且不等于"在对话里跑工具"）；ChatGPT 侧同样没有公开 API 能向用户会话投消息。
+
+### 方案 A：反向通道已内置在本包里（推荐）
+
+**装本包就同时得到两个方向**——`cordis.patch.yml` 里插了两行：`dsh-bridge`（Codex → DSH 派活）与 `codex-mcp`（DSH → Codex 反向调用）。原理是两端各有一个原生件：
+
+- DSH 侧 `@deepseek-ai/dsh-mcp-client`（harness 自带）：连外部 MCP 服务器，并把工具以 `mcp__<serverName>__<tool>` 注册进 `ctx.tools`；
+- Codex 侧 `codex mcp-server`（stdio）：把 Codex 暴露成 MCP 服务端。
+
+内置的那一行等价于：
+
+```yaml
+- insert:
+    - id: codex-mcp
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: codex
+        transport: stdio
+        command: codex                 # 跨平台：SDK 用 cross-spawn，Windows 的 .cmd 垫片也能解析
+        args: ['mcp-server']
+        failOnStartupError: false      # 没装/没登录 Codex 只是没这批工具，不会拖垮 harness
+        toolCallTimeoutMs: 600000      # 默认只有 60s，Codex 跑一轮常常不够
+```
+
+- 前提：本机装了 Codex CLI 并已登录（`codex --version` / `codex mcp-server --help` 能跑）。
+- **不需要反向通道**？在 profile 的 `cordis.patch.yml` 里覆盖一行即可关掉：`- id: codex-mcp` + `disabled: true`。
+- 想单独用反向通道（不装本插件主体）可以用独立模板 [`templates/codex-mcp/`](templates/codex-mcp/README.md)。
+- 装完需**重启 profile 进程**；连接失败只是这批工具不出现（日志里有原因）。
+- 排查：若 `codex` 不在 DSH 进程的 PATH 上，把 `command` 换成 `node` + `args: ['<...>/@openai/codex/bin/codex.js', 'mcp-server']`，或直接指向平台 `codex.exe`。
+
+### 方案 B：worker 里直接跑 `codex exec`
+
+```powershell
+codex exec "把刚才的 diff 审一遍，只回结论" --cd E:\proj
+```
+
+一次性、零协议改动；代价是每次都是新会话（无跨轮记忆），且需要执行 shell 的权限。
+
+> 注意：插件自带的 `dsh_collab_send` / `dsh_collab_review` 是 **DSH 侧入口**，只回到同一个网关，**不经过 Codex**。要"叫 Codex 干活"用上面 A/B；要"让 Codex 那条对话继续"，只能等 Codex 自己下一轮（`dsh_task --wait` 或 `dsh_task_status`）。
+
 ## 环境变量
 
 | 变量 | 默认 | 说明 |
 |---|---|---|
-| `DSH_BRIDGE_URL` | `http://127.0.0.1:3080` | 网关地址 |
+| `DSH_BRIDGE_URL` | `http://127.0.0.1:3080` | 网关地址。**必须指向插件实际挂载的那个 profile 的端口**（DSH 客户端里就是 GUI 端口，例如 19387） |
 | `DSH_BRIDGE_WORKSPACE` | `D:\Harness` | 网关默认共享工作目录 |
 | `DSH_BRIDGE_ROOT` | `D:\Harness` | `dsh_read_file` 相对路径基准 |
 | `DSH_BRIDGE_HISTORY` | 多级降级 | 协作历史文件位置（默认 D 盘 → 用户目录 → 临时目录逐级降级） |
@@ -211,12 +318,26 @@ dsh-task --in "<继续推进的指令>" --session "session-8d481ad9-..."
 - **评审不支持会话目标**：评审员必须与编码会话隔离，"独立评审"才成立
 - session 目标不使用 `cwd`/`lane`/`model`/`--commit`（会话自带这些语义），传了会被判 `invalid-target`
 - 网关重启会丢失内存中的任务表（含 session 观察器），这是既有设计
+- **替换包内容不会热重载**：升级后必须重启 profile 进程，否则跑的还是旧 JS 模块（HMR 只重挂组合，不复用新代码）
+- **组合包被取消选中 = 插件完全不挂载**：此时所有 `/api/dsh-bridge/*` 都落到网关鉴权层返回 401（不是 404，容易误判成没装）
 - **DSH profile 的 pnpm 供应链冷却**：新发布的版本约 24 小时内会被 `minimumReleaseAge` 拒绝安装（`ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION`）；管理器会把它写进 `pnpm-workspace.yaml` 的 `minimumReleaseAgeExclude` 才放行。刚发版就装不上属正常，不是包的问题
-- 升级已装组合包 = **卸载 → 重新安装**；卸载会把该包从 `dsh.profile.bundles` 移除，所以重装后**要确认它被重新选中**，否则插件不会挂载（表现为所有 `/api/dsh-bridge/*` 都落到网关鉴权层返回 401）
+- 升级已装组合包：客户端插件页没有升级入口，官方姿势是**卸载 → 重装**；但卸载会把该包从 `dsh.profile.bundles` 移除，重装后**要确认它被重新选中**，否则插件不会挂载（表现为所有 `/api/dsh-bridge/*` 都落到网关鉴权层返回 401）。更省事的做法是直接 `dsh plugin add <包>@<版本>`，见上文「升级到新版本」
 - Codex Desktop Windows 本地市场技能注入 bug（见上，MCP 通道不受影响）
 - 动态插件环境无 `AbortSignal`，冷恢复失败时自动降级为一次性执行；宿主组合持久化版无此问题
 - ChatGPT Plus 写入型 MCP 的开放度取决于 OpenAI 产品策略
 
+## 开发与测试
+
+```sh
+node test/session-target.test.mjs      # 纯函数：目标判定 / 候选挑选 / 错误映射 / 基线切分 / 汇报选文
+node test/dsh-bridge.test.mjs          # 路由级：假 DSH 运行时 + 桩 peer，加载真实 bridge 跑真实路由
+node --test test/*.test.mjs            # 两个一起跑（CI 用的是这条）
+```
+
+- 路由级测试会断言 **worker 分支确实调用了 `startContinuable`**、**session 分支只调用 `prompt` 且不建 owner/子代理**——这类"参数遮蔽/串线"缺陷只有在这一层才抓得到（v0.1.2~0.1.4 的 `deliver` 遮蔽 bug 就是它抓回来的）。
+- CI（`.github/workflows/publish.yml`）每次 tag 都跑：语法检查 → 单测 → 包契约 → 版本号三处一致 → tarball 清单 → 干净目录安装 + CLI/MCP 冒烟 → 6 工具握手断言 → bridge 导出契约。**任何一步失败都不会发布**。
+- 发布：`package.json` / `.codex-plugin/plugin.json` / `mcp/dsh-mcp.mjs` 的 `SERVER_VERSION` 三处同步改版本 → commit → 打 tag `vX.Y.Z` → 推 tag，CI 自动带 provenance 发布。
+
 ## License
 
 MIT

package/codex-plugin/plugins/dsh/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Codex 主导的双向编码协作插件：ChatGPT 把编码任务下发给本机 DeepSeek Harness 的持久编码子代理执行，DeepSeek 在共享工作目录 D:\\Harness 中写代码并实时回传进度与汇报，Codex 读文件验收、反馈修正，直到通过。",
   "author": {
     "name": "FuJackGao"

package/cordis.patch.yml

@@ -1,20 +1,45 @@
-# DSH Collab bundle layer — 双向编码协作网关。
+# DSH Collab bundle layer —— 双向协作：Codex → DSH 派活 + DSH → Codex 反向调用。
 #
 # 安装（npm）：
-#   dsh plugin --profile web add @whaletalk/dsh-codex-collab
-# `dsh plugin add` 会把本包加入 profile 的 dsh.profile.bundles，并自动套用本
-# patch，无需手工复制 dsh-bridge.mjs。
+#   dsh plugin --profile desktop add @whaletalk/dsh-codex-collab
+# `dsh plugin add` 会把本包加入 profile 的 dsh.profile.bundles，并自动套用本 patch。
 #
-# 下面这一行把宿主网关插件插进 bundle：
-#   - id  dsh-bridge       —— 行 id。用户的 patch 层可用同 id 覆盖整段 config。
-#   - name用包子路径而非相对路径（对比 './dsh-bridge.mjs'）：只有这样从 npm 安装
-#     后解析器才能定位到包内文件，同时保持 profile 目录干净。
+# 本 bundle 插两行：
 #
-# 依赖的服务：webServer / agents / subagents / tools 四个注入，加上运行时取用的
-# timer、sessionQuery、agentPresets、sessionPersistence、workspaceRegistry、llm。
-# 其中 webServer 由 dsh-web-app 提供 —— 因此本 bundle 只能挂 web / desktop
-# profile，headless profile 没有该服务会一直 pending。
-# 本插件不使用 workflowEngine，所以 web GUI 默认禁用 workflow 引擎不影响它。
+# 1) dsh-bridge —— 宿主网关插件（Codex → DSH 的派活通道）
+#    - id  行 id；用户的 patch 层可用同 id 覆盖整段 config。
+#    - name 用包子路径而非相对路径（对比 './dsh-bridge.mjs'）：只有这样从 npm 安装
+#      后解析器才能定位到包内文件，同时保持 profile 目录干净。
+#    依赖的服务：webServer / agents / subagents / tools 四个注入，加上运行时取用的
+#    timer、sessionQuery、agentPresets、sessionPersistence、workspaceRegistry、llm。
+#    其中 webServer 由 dsh-web-app 提供 —— 因此本 bundle 只能挂 web / desktop
+#    profile，headless profile 没有该服务会一直 pending。
+#    本插件不使用 workflowEngine，所以 web GUI 默认禁用 workflow 引擎不影响它。
+#
+# 2) codex-mcp —— 反向通道（DSH → Codex）
+#    把 Codex CLI 当 MCP 服务端挂进来：DSH 侧 agent 会拿到 mcp__codex__* 工具，
+#    可以把活交回 Codex。两端都是现成的（DSH 自带 @deepseek-ai/dsh-mcp-client，
+#    Codex 自带 `codex mcp-server`），这里只是配置。
+#
+#    - command 写裸名 `codex` 即可跨平台：MCP SDK 的 stdio 用 cross-spawn
+#      （shell:false）spawn，它在 Windows 上会正确解析 npm 的 .cmd 垫片。
+#      若你的 codex 不在 PATH 上，改成 `node` + args 指向
+#      `...\@openai\codex\bin\codex.js`，或直接指向平台 codex.exe。
+#    - toolCallTimeoutMs 默认只有 60s，Codex 跑一轮读仓库常常不够。
+#    - failOnStartupError:false：没装/没登录 Codex 时只是这批工具不出现并记一条
+#      日志，不会拖垮 harness。
+#    - 不需要反向通道？在 profile 的 cordis.patch.yml 里加一行覆盖即可关掉：
+#        - id: codex-mcp
+#          disabled: true
 - insert:
     - id: dsh-bridge
-      name: '@whaletalk/dsh-codex-collab/bridge'
+      name: '@whaletalk/dsh-codex-collab/bridge'
+    - id: codex-mcp
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: codex
+        transport: stdio
+        command: codex
+        args: ['mcp-server']
+        failOnStartupError: false
+        toolCallTimeoutMs: 600000

package/mcp/dsh-mcp.mjs

@@ -6,7 +6,7 @@
 //      客户端（Secure MCP Tunnel / cloudflared）桥接给 ChatGPT 等远程产品。
 const GATEWAY = process.env.DSH_BRIDGE_URL || 'http://127.0.0.1:3080'
 const SERVER_NAME = 'dsh-bridge'
-const SERVER_VERSION = '0.1.5'
+const SERVER_VERSION = '0.1.6'
 const PROTOCOL_VERSION = '2024-11-05'
 
 const log = (...args) => console.error('[dsh-mcp]', ...args)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whaletalk/dsh-codex-collab",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Codex × DeepSeek Harness 双向编码协作：Codex 主导派活与验收，DeepSeek Harness 编码子代理在共享工作目录执行并回传，独立评审子代理实际跑通构建/测试后出具报告。提供 DSH 宿主网关插件、零依赖 MCP 服务器与 Codex 技能三件套。",
   "license": "MIT",
   "type": "module",
@@ -23,6 +23,7 @@
     "harness/",
     "mcp/",
     "codex-plugin/",
+    "templates/",
     "cordis.patch.yml",
     "README.md",
     "LICENSE",

package/templates/codex-mcp/README.md

@@ -0,0 +1,84 @@
+# templates/codex-mcp —— 反向通道：让 DSH 调用 Codex
+
+> **注意：主包已内置这一行。** 装 `@whaletalk/dsh-codex-collab` 时会同时挂上
+> `dsh-bridge`（Codex → DSH 派活）和 `codex-mcp`（DSH → Codex），不需要再单独装。
+> 本目录是**独立版本**：只想用反向通道、或想单独调参时用。关掉内置的那一行只需在
+> profile 的 `cordis.patch.yml` 里覆盖 `- id: codex-mcp` + `disabled: true`。
+
+把 **Codex CLI 当作 MCP 服务端**挂进 DeepSeek Harness，于是 DSH 侧的 agent（包括
+本插件派出去的 worker）会拿到 `mcp__codex__*` 工具，可以把活**交回 Codex**。
+
+- DSH 侧负责连接的是 harness 自带的 `@deepseek-ai/dsh-mcp-client`（把外部 MCP
+  服务器的工具注册进 `ctx.tools`，支持 `stdio` 与 `streamable-http`，带断线重连）。
+- Codex 侧负责暴露的是 `codex mcp-server`（stdio）。
+
+## 装法
+
+**A. 并进你现有的 profile patch**（推荐，最少文件）：把 `cordis.patch.yml` 里那行
+`insert` 追加到 `~/.dsh/profiles/<profile>/cordis.patch.yml` 数组末尾。
+
+**B. 当作独立 bundle 安装**：
+
+```sh
+dsh plugin --profile desktop add "<本目录绝对路径>"
+```
+
+两种方式都一样：**装完必须重启 profile 进程**（新增组合包不会热挂载），
+重启后工具才会出现在列表里。
+
+## 配置要点
+
+| 字段 | 说明 |
+|---|---|
+| `serverName` | 工具命名空间，工具名形如 `mcp__codex__<tool>`；同时挂多个服务器时各自独立 |
+| `transport` | `stdio`（本地进程）或 `streamable-http`（远端） |
+| `command` / `args` / `env` / `cwd` | 仅 stdio：可执行文件、参数、追加环境变量、工作目录 |
+| `failOnStartupError` | `false` = 连不上也照常启动 harness，只是没有这批工具 |
+| `toolCallTimeoutMs` | 每次 `tools/call` 超时；**默认只有 60s**，Codex 跑一轮常常不够，建议 600000 |
+
+### `command` 怎么写（Windows 也能用裸名）
+
+**默认写裸名 `codex` 即可，跨平台。** DSH 的 MCP 客户端走官方 SDK 的
+`StdioClientTransport`，它内部用 **cross-spawn**（`shell: false`）spawn——cross-spawn
+在 Windows 上会正确解析 npm 的 `.cmd` 垫片。实测：
+
+```
+cross-spawn('codex', ['--version']) → exit 0, "codex-cli 0.147.0"
+```
+
+只有当 `codex` 不在 DSH 进程的 PATH 上（或你想完全绕开 npm 垫片）时才需要换写法：
+
+```yaml
+# 备选 1：node 跑垫片背后的 JS
+command: node
+args: ['C:\Users\<you>\AppData\Roaming\npm\node_modules\@openai\codex\bin\codex.js', 'mcp-server']
+
+# 备选 2：直接指向平台二进制（路径随版本/架构略有不同）
+command: 'C:\Users\<you>\AppData\Roaming\npm\node_modules\@openai\codex\node_modules\@openai\codex-win32-x64\vendor\x86_64-pc-windows-msvc\bin\codex.exe'
+args: ['mcp-server']
+```
+
+## 验证
+
+```sh
+codex --version                 # 需要 CLI 已登录可用
+codex mcp-server --help         # 应打印 "Start Codex as an MCP server (stdio)"
+```
+
+接好后在 DSH 侧让 agent 调一次 `mcp__codex__*`；工具没出现就去看 harness 日志
+（连接失败会记录原因，且不会中止启动）。
+
+## 能做什么、不能做什么
+
+| | 可行性 |
+|---|---|
+| 让 DSH 调用 Codex（当执行器/评审员） | ✅ 本目录的做法 |
+| 让 DSH 往你**正开着的某条 ChatGPT/Codex 对话**里插消息、就地开一轮 | ❌ 做不到 |
+
+原因：现有链路是 Codex 主动（它启动 `dsh-mcp` 子进程调工具），MCP 是**客户端发起**
+的协议，服务端无法命令客户端开一轮；服务端→客户端只有 `notifications/*`（不触发
+回合）、`sampling/createMessage`、`elicitation/create`（取决于客户端实现，且不等于
+"在对话里跑工具"）。ChatGPT 侧同样没有公开 API 能向用户会话投消息。
+
+> 另注：本插件自带的 `dsh_collab_send` / `dsh_collab_review` 是 **DSH 侧入口**，
+> 它们只回到同一个网关，**不经过 Codex**。

package/templates/codex-mcp/cordis.patch.yml

@@ -0,0 +1,46 @@
+# 反向通道：把 Codex 挂成 DSH 的一个 MCP 服务端。
+#
+# 谁提供什么：
+#   - DSH 侧：@deepseek-ai/dsh-mcp-client（harness 自带）——连外部 MCP 服务器，
+#     并把它们的工具以 mcp__<serverName>__<tool> 注册进 ctx.tools。
+#   - Codex 侧：codex mcp-server（stdio）——把 Codex 暴露成 MCP 服务端。
+#
+# 用法（二选一）：
+#   A) 把下面这行 insert 追加到你的 profile cordis.patch.yml 数组末尾；
+#   B) 把本目录当作一个 bundle 安装（路径写绝对路径）：
+#        dsh plugin --profile <profile> add <本目录绝对路径>
+#
+# 注意：主包 @whaletalk/dsh-codex-collab 已内置等价的一行；本文件是**独立版本**，
+# 用于只想单独挂反向通道、或想单独调参的场景。
+#
+# 装完必须**重启 profile 进程**：新增组合包不会热挂载，只有重启后工具才会出现。
+# 之后在 DSH 侧的工具列表里找 mcp__codex__*（例如 mcp__codex__codex）。
+- insert:
+    - id: codex-mcp
+      name: '@deepseek-ai/dsh-mcp-client'
+      config:
+        serverName: codex
+        transport: stdio
+
+        # 裸名 `codex` 跨平台可用：DSH 的 MCP 客户端用官方 SDK 的
+        # StdioClientTransport，内部是 cross-spawn（shell:false），在 Windows 上
+        # 也能正确解析 npm 的 .cmd 垫片（本机实测 exit 0）。
+        command: codex
+        args: ['mcp-server']
+
+        # 若 codex 不在 DSH 进程的 PATH 上，改成下面任一种：
+        #   command: node
+        #   args: ['C:\Users\<you>\AppData\Roaming\npm\node_modules\@openai\codex\bin\codex.js', 'mcp-server']
+        # 或直接指向平台二进制：
+        #   command: 'C:\Users\<you>\AppData\Roaming\npm\node_modules\@openai\codex\node_modules\@openai\codex-win32-x64\vendor\x86_64-pc-windows-msvc\bin\codex.exe'
+        #   args: ['mcp-server']
+
+        # 远端 Codex（有人把 mcp-server 包成 HTTP 时）用：
+        #   transport: streamable-http
+        #   url: http://127.0.0.1:3000/mcp
+        #   headers: { Authorization: 'Bearer ...' }
+
+        # 启动失败不拖垮 harness：插件仍激活，只是不注册这批工具，日志里有原因。
+        failOnStartupError: false
+        # Codex 一轮可能跑很久（要读完仓库再答），给足超时；默认只有 60s。
+        toolCallTimeoutMs: 600000

package/templates/codex-mcp/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "dsh-codex-mcp-bridge",
+  "version": "1.0.0",
+  "private": true,
+  "type": "module",
+  "description": "把 Codex CLI 当作 MCP 服务端挂进 DeepSeek Harness：DSH 侧 agent 获得 mcp__codex__* 工具，可反向调用 Codex。",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  }
+}