@whaletalk/dsh-codex-collab 0.1.1 → 0.1.3

package/README.md

@@ -47,20 +47,21 @@ 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）；5 个工具：`dsh_task` / `dsh_task_status` / `dsh_task_cancel` / `dsh_review` / `dsh_read_file` |
+| `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 宿主组合**（见下文） |
 | `cordis.patch.yml` | bundle patch | 把网关插件挂进 DSH 宿主组合；`dsh.bundle.patch` 指向它，所以 `dsh plugin add` 能自动 reconcile |
 
 ## 功能
 
 - **派活**：`dsh_task` / `task.mjs`，任意工作目录（`--cwd`，不存在自动创建并注册为工作区）
+- **接进已有会话**：`dsh_sessions` 只读搜索既有会话 → `dsh_task --session <id>` 把指令投递进去（`queue` 排队 / `steer` 插入当前回合）。**不新建会话、不新建工作区**；"找不到/接不上"一律返回稳定 reason 而不是静默新建
 - **并行分工**：同目录多 lane（`--lane`）+ 跨目录天然并行
 - **模型切换**：`fast`（deepseek-v4-flash）或 `pro`（deepseek-v4-pro），动态解析不写死
 - **双向评审**：独立评审子代理与编码员分离，读磁盘真实文件、静态审查、**实际运行构建/测试验证可跑通**，输出结构化报告
 - **Git 自动提交**：`--commit`，任务完成后在 cwd 自动 `git add -A` 并提交
 - **跨任务记忆**：持久子代理会话 + 历史摘要注入（冷恢复失败自动降级为一次性执行，功能不中断）
-- **任务管理**：`--list` / `--status <id>` / `--cancel <id>`
-- **结果回传**：任务汇报直接回 Codex 对话（`--wait` 默认）
+- **任务管理**：`--list` / `--status <id>` / `--cancel <id> [--force]`
+- **结果回传**：任务汇报直接回 Codex 对话（`--wait` 默认）；每个任务响应都回显 `target`，一眼看出是"新建"还是"接进哪条会话"
 
 ## 安装
 
@@ -162,11 +163,31 @@ tunnel-client run --profile dsh
 **命令行**（npm 安装后直接用；源码方式用 `node <脚本路径>`）：
 
 ```bash
+# 新建子代理（原有行为）
 dsh-task --in "<指令>" --cwd "<目录>" [--lane backend] [--model fast|pro] [--commit]
+
+# 接进已有会话：先找，再派
+dsh-task --sessions "<标题关键词>"                    # 只读列候选，拿 sessionId
+dsh-task --in "<指令>" --session "<sessionId>" [--steer]
+dsh-task --in "<指令>" --find "<标题关键词>"           # 唯一命中才派；否则退出码 4
+
 dsh-review --cwd "<目录>" [--diff git|@文件|"diff文本"] [--focus "<重点>"]
-dsh-task --list | --status <taskId> | --cancel <taskId>
+dsh-task --list | --status <taskId> | --cancel <taskId> [--force]
+```
+
+**已有会话派活**（对应"接进我正在用的那条对话"）：
+
+```bash
+# 1) 找到（只读，不创建任何东西）
+dsh-task --sessions "按文档启动OKX策略实验计划"
+# → {"items":[{"sessionId":"session-8d481ad9-...","snippet":"@okx-strategy-lab/ 开始按照文档进行计划"}]}
+
+# 2) 接通（指令投递进那条会话，跑完把这一轮的助手回复作为汇报返回）
+dsh-task --in "<继续推进的指令>" --session "session-8d481ad9-..."
 ```
 
+失败一律返回稳定 `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`）。
+
 ## 环境变量
 
 | 变量 | 默认 | 说明 |
@@ -175,10 +196,18 @@ dsh-task --list | --status <taskId> | --cancel <taskId>
 | `DSH_BRIDGE_WORKSPACE` | `D:\Harness` | 网关默认共享工作目录 |
 | `DSH_BRIDGE_ROOT` | `D:\Harness` | `dsh_read_file` 相对路径基准 |
 | `DSH_BRIDGE_HISTORY` | 多级降级 | 协作历史文件位置（默认 D 盘 → 用户目录 → 临时目录逐级降级） |
+| `DSH_BRIDGE_SESSION_DISPATCH_TIMEOUT_MS` | `120000` | 会话任务被接受后、迟迟没开始跑的容忍时间（仍在排队则报 `session-not-accepted`） |
+| `DSH_BRIDGE_SESSION_QUIET_TIMEOUT_MS` | `600000` | 见过 running 之后多久没有新助手文本算跑完 |
+| `DSH_BRIDGE_SESSION_TOTAL_TIMEOUT_MS` | `3600000` | 单个会话任务的总预算 |
 
 ## 已知限制
 
-- 网关插件需要 `webServer` 服务（由 `dsh-web-app` 提供），因此**只能挂 web / desktop profile**；headless profile 会一直 pending
+- 网关插件需要 `webServer` 服务（由 `dsh-web-app` 提供），因此**只能挂 web / desktop profile**；headless profile 会一直 pending。session 目标还需要同 bundle 的 `sessionController`，缺失时返回 `session-controller-unavailable`
+- **同一会话同时只允许一个在途 bridge 任务**：DSH 自己会排队，但无法可靠地把两次并发派活的回报各自归属，所以第二个会被明确拒绝（`session-busy`）而不是猜
+- **冷会话可能接不上**：DSH 激活 Agent 需要会话投影（`Agent activation requires a projected Session observation`），未激活的会话会返回 `session-not-activatable`；归档会话的回合会以 `blocked` 收口（`session-archived`）
+- **评审不支持会话目标**：评审员必须与编码会话隔离，"独立评审"才成立
+- session 目标不使用 `cwd`/`lane`/`model`/`--commit`（会话自带这些语义），传了会被判 `invalid-target`
+- 网关重启会丢失内存中的任务表（含 session 观察器），这是既有设计
 - Codex Desktop Windows 本地市场技能注入 bug（见上，MCP 通道不受影响）
 - 动态插件环境无 `AbortSignal`，冷恢复失败时自动降级为一次性执行；宿主组合持久化版无此问题
 - ChatGPT Plus 写入型 MCP 的开放度取决于 OpenAI 产品策略

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

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

package/codex-plugin/plugins/dsh/skills/dsh-collab/SKILL.md

@@ -1,59 +1,88 @@
 ---
 name: dsh-collab
-description: "与 DeepSeek Harness 编码协作。当用户要写代码、建项目、改代码时使用：把编码任务交给本机 DeepSeek Harness 的编码子代理执行（DeepSeek 写代码，你负责验收），在 --cwd 指定的工作目录（通常是 Codex 当前项目目录）中读文件验收；DeepSeek 完成后可自动 git 提交，并可用独立评审子代理审查 diff（评审员会实际跑通构建/测试）。不通过则发修正指令迭代，直到通过再向用户汇报。"
+description: "与 DeepSeek Harness 编码协作。当用户要写代码、建项目、改代码时使用：把编码任务交给本机 DeepSeek Harness 执行（DeepSeek 写代码，你负责验收）。两种派活方式——默认在 --cwd 指定的工作目录新建编码子代理；也可以把任务投递进**用户正在用的那一条已有会话**（保留它自己的上下文，不新建会话/工作区）。DeepSeek 完成后可自动 git 提交，并可用独立评审子代理审查 diff（评审员会实际跑通构建/测试）。不通过则发修正指令迭代，直到通过再向用户汇报。"
 ---
 
 # DeepSeek Harness 编码协作
 
 ## 角色
 
-- 你 = 项目经理 + 验收员。DeepSeek 编码子代理 = 程序员，在 `--cwd` 指定的工作目录中写代码（任意目录，Codex 打开哪个项目就传哪个目录）。
+- 你 = 项目经理 + 验收员。DeepSeek 编码子代理 = 程序员。
 - 子代理保留跨任务记忆；独立评审子代理与编码员分离，不信任口头报告，只认真实文件与真实运行结果。
 
+## 两种派活目标（先想清楚要哪一种）
+
+| 目标 | 什么时候用 | 效果 |
+|---|---|---|
+| **worker**（默认） | 全新任务、独立项目目录 | 在 `--cwd` 里新建一个持久编码子代理 |
+| **session** | 用户已经在某条会话里做着这件事（例如"按文档启动OKX策略实验计划"），你只是替他继续推进 | 指令**投递进那条会话**，用它自己的上下文继续，**不新建会话/工作区** |
+
+> 默认是 worker。如果你把任务派进了新建的会话，而用户期望的其实是"接着我原来那条对话做"，那是**派错了目标**——先查会话再派。
+
 ## 工具脚本（固定位置）
 
-- 派活：`D:/Harness/.codex-collab-tools/task.mjs`
-- 评审：`D:/Harness/.codex-collab-tools/review.mjs`
+- 派活：`dsh-task`（npm 全局安装后进 PATH）
+- 评审：`dsh-review`
+- MCP 服务器：`dsh-mcp`
+
+若 PATH 里没有，用包内绝对路径：`node "<包目录>/codex-plugin/plugins/dsh/skills/dsh-collab/scripts/task.mjs"`。
+
+## 找到已有会话（只读，不创建任何东西）
+
+```bash
+dsh-task --sessions "<标题或内容关键词>"
+```
+
+输出候选（`sessionId` + 片段）。**必须唯一命中**才能直接用；多条会返回 `candidates` 让你改用 `--session <id>`。退出码 `4` = 没命中或不唯一。
 
 ## 下发任务
 
 ```bash
-node "D:/Harness/.codex-collab-tools/task.mjs" --in "<完整中文指令>" --cwd "<工作目录>" [--lane <通道>] [--model fast|pro] [--commit] [--timeout 秒]
+# 1) 新建子代理（原有行为）
+dsh-task --in "<完整中文指令>" --cwd "<工作目录>" [--lane <通道>] [--model fast|pro] [--commit] [--timeout 秒]
+
+# 2) 投递进已有会话
+dsh-task --in "<完整中文指令>" --session "<sessionId>" [--steer] [--timeout 秒]
+dsh-task --in "<完整中文指令>" --find "<标题关键词>"     # 唯一命中才派发，否则退出码 4
 ```
 
-- `--cwd`：**默认传 Codex 当前打开的项目目录**（绝对路径，正斜杠）；不存在时自动创建并注册为 harness 工作区。
-- `--lane`：并行通道名（默认 main）。同一目录不同 lane 的任务**并行执行**（如 backend 与 frontend 各一路）；跨目录天然并行。
-- `--model`：`fast`（deepseek-v4-flash，快而省）或 `pro`（deepseek-v4-pro，质量优先）；默认继承当前模型。
-- `--commit`：任务完成后在 `--cwd` 自动 `git add -A` 并提交（提交信息含任务摘要）；非 git 仓库自动跳过。
-- 指令必须包含：目标与产出物、验收标准、约束。`--wait` 为默认行为（结果直接回本对话），最长 10 分钟，长任务加 `--timeout 1800`。
+- `--cwd`：**默认传 Codex 当前打开的项目目录**（绝对路径，正斜杠）；不存在时自动创建并注册为 harness 工作区。与 `--session`/`--find` 互斥。
+- `--lane`：并行通道名（默认 main）。同一目录不同 lane 的任务**并行执行**；跨目录天然并行。
+- `--model`：`fast`（deepseek-v4-flash，快而省）或 `pro`（deepseek-v4-pro，质量优先）；默认继承当前模型。session 目标不使用此参数（会话自己有模型）。
+- `--commit`：任务完成后在 `--cwd` 自动 `git add -A` 并提交；非 git 仓库自动跳过。session 目标禁止使用（会话自带工作目录，本工具不替它提交）。
+- `--steer`：仅 session 目标。默认 `queue`（排队，等它忙完再跑）；`--steer` 会插入当前回合、改变它正在做的事——**只在用户明确要求打断时用**。
+- 指令必须包含：目标与产出物、验收标准、约束。`--wait` 为默认行为（结果直接回本对话），长任务加 `--timeout 1800`。
+
+退出码：`0` 成功 / `1` 失败 / `2` 用法 / `3` 超时 / `4` 会话未命中或不唯一 / `5` session 目标取消被拒。
 
 ## 读取汇报与验收
 
 1. 脚本最后输出 `=== DeepSeek 汇报 ===`（做了什么、改动文件、如何验证、待决策问题）。
-2. 读 `--cwd` 中它声称改动的文件核对；必要时自己跑构建/测试。
-3. 通过 → 向用户汇报；不通过 → 发修正指令（子代理记得该目录上下文），迭代到通过。
+2. worker 目标：读 `--cwd` 中它声称改动的文件核对。session 目标：让用户到那条会话里看，或你再派一条只读指令让它回读。
+3. 通过 → 向用户汇报；不通过 → 发修正指令（子代理/会话记得上下文），迭代到通过。
 
 ## 双向评审（Codex 验收 DeepSeek 的变更）
 
-DeepSeek 任务完成后，把它的变更交给独立评审子代理：
-
 ```bash
-node "D:/Harness/.codex-collab-tools/review.mjs" --cwd "<工作目录>" [--diff git|git-staged|@文件|"diff 文本"] [--focus "<审查重点>"]
+dsh-review --cwd "<工作目录>" [--diff git|git-staged|@文件|"diff 文本"] [--focus "<审查重点>"]
 ```
 
 - `--diff` 默认取 `git diff`（未提交变更）；`git-staged` 取暂存区；也可直接给 diff 文本或文件（`@路径`）。
-- 评审员会：读 `--cwd` 真实文件核对 diff → 静态审查（正确性/健壮性/安全/测试缺口）→ **实际运行构建与测试验证可跑通** → 输出结构化报告（结论 + 问题列表 + 跑通验证 + 修改建议）。
-- 你阅读 `=== 评审报告 ===`，有问题就发修正指令给编码员，直到评审通过。
+- 评审员会：读 `--cwd` 真实文件核对 diff → 静态审查（正确性/健壮性/安全/测试缺口）→ **实际运行构建与测试验证可跑通** → 输出结构化报告。
+- **评审不支持 session 目标**：评审员必须与编码会话隔离，否则"独立评审"就不成立。
 
 ## 任务管理
 
 ```bash
-node "D:/Harness/.codex-collab-tools/task.mjs" --list              # 最近任务列表
-node "D:/Harness/.codex-collab-tools/task.mjs" --status <taskId>   # 查询单个任务
-node "D:/Harness/.codex-collab-tools/task.mjs" --cancel <taskId>   # 取消运行中的任务
+dsh-task --list                        # 最近任务列表
+dsh-task --status <taskId>             # 查询单个任务（含 target 回显）
+dsh-task --cancel <taskId>             # 取消 worker 任务
+dsh-task --cancel <taskId> --force     # 取消 session 目标任务（会打断用户自己的回合，默认被拒）
 ```
 
 ## 故障排查
 
-- 连接失败：DeepSeek Harness 未运行（应监听 http://127.0.0.1:3080），请提示用户启动。
+- 连接失败：DeepSeek Harness 未运行（网关应监听本机端口，默认 3080；挂在 web/desktop profile 时也可能就是 GUI 的端口）。
+- 派 session 任务返回 `session-writer-held` / `session-busy`：那条会话被别的写入方或另一个 bridge 任务占用；稍后重试，或改用 worker 目标。
+- 返回 `session-not-activatable` / `session-archived`：该会话当前接不了（冷会话未能激活，或已归档）；请用户先在客户端打开它，或解除归档。
 - 读不到 `--cwd` 目录：提示用户在 Codex 设置中把该目录加入可访问/可写目录。

package/codex-plugin/plugins/dsh/skills/dsh-collab/scripts/task.mjs

@@ -22,7 +22,7 @@ const HISTORY_CANDIDATES = process.env.DSH_BRIDGE_HISTORY
 const HISTORY_MAX = 40
 
 function parseArgs(argv) {
-  const out = { wait: true, timeoutSec: 600, instruction: '', cwd: '', lane: '', model: '', commit: false, list: false, cancel: '', status: '' }
+  const out = { wait: true, timeoutSec: 600, instruction: '', cwd: '', lane: '', model: '', commit: false, list: false, cancel: '', status: '', sessions: '', sessionId: '', find: '', steer: false, force: false }
   const rest = []
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i]
@@ -37,6 +37,11 @@ function parseArgs(argv) {
     else if (a === '--list') { out.list = true }
     else if (a === '--cancel') { out.cancel = argv[++i] || '' }
     else if (a === '--status') { out.status = argv[++i] || '' }
+    else if (a === '--sessions') { out.sessions = argv[++i] || '' }
+    else if (a === '--session') { out.sessionId = argv[++i] || '' }
+    else if (a === '--find') { out.find = argv[++i] || '' }
+    else if (a === '--steer') { out.steer = true }
+    else if (a === '--force') { out.force = true }
     else { rest.push(a) }
   }
   if (!out.instruction && rest.length > 0) out.instruction = rest.join(' ')
@@ -152,39 +157,84 @@ async function main() {
     finish(0)
   }
   if (opts.cancel) {
-    const res = await request('POST', GATEWAY + '/api/dsh-bridge/cancel', { taskId: opts.cancel })
+    const res = await request('POST', GATEWAY + '/api/dsh-bridge/cancel', { taskId: opts.cancel, force: opts.force === true })
     console.log(JSON.stringify(res.json, null, 2))
-    finish(0)
+    finish(res.status === 409 ? 5 : 0)
   }
   if (opts.status) {
     const res = await request('GET', GATEWAY + '/api/dsh-bridge/status?taskId=' + encodeURIComponent(opts.status))
     console.log(JSON.stringify(res.json, null, 2))
     finish(0)
   }
+  if (opts.sessions) {
+    const res = await request('POST', GATEWAY + '/api/dsh-bridge/sessions', { query: opts.sessions, inspect: true, limit: 20 })
+    if (res.json === null || typeof res.json !== 'object') {
+      console.error('task.mjs: 网关返回 ' + res.status + '，响应不是 JSON —— profile 里的插件可能还是旧版本（session 接口需要 0.1.2+）')
+      console.error(String(res.text || '').slice(0, 200))
+      finish(1)
+    }
+    console.log(JSON.stringify(res.json, null, 2))
+    const items = Array.isArray(res.json.items) ? res.json.items : []
+    finish(items.length > 0 ? 0 : 4)
+  }
 
   const instruction = opts.instruction.trim()
   if (!instruction) {
     console.error('用法: node task.mjs --in "<指令>" [--cwd 目录] [--lane 名] [--model fast|pro] [--commit] [--timeout 秒] [--no-wait]')
-    console.error('管理: node task.mjs --list | --status <taskId> | --cancel <taskId>')
+    console.error('      node task.mjs --in "<指令>" (--session <会话id> | --find "<标题关键词>") [--steer]   # 投递进已有会话')
+    console.error('查找: node task.mjs --sessions "<标题关键词>"   # 只读列出候选, 拿 sessionId 再派活')
+    console.error('管理: node task.mjs --list | --status <taskId> | --cancel <taskId> [--force]')
+    console.error('退出码: 0 成功 / 1 失败 / 2 用法 / 3 超时 / 4 会话未命中或不唯一 / 5 session 目标取消被拒')
     finish(2)
   }
   const cwd = (opts.cwd || process.env.DSH_BRIDGE_CWD || '').trim()
-  if (cwd) {
+  const sessionId = (opts.sessionId || '').trim()
+  const find = (opts.find || '').trim()
+  const sessionTarget = sessionId !== '' ? { sessionId } : (find !== '' ? { sessionQuery: find } : null)
+  if (sessionTarget !== null && (cwd !== '' || opts.commit)) {
+    console.error('task.mjs: --session/--find 不能与 --cwd/--commit 同时使用（已有会话自带工作目录，本工具不替它提交）')
+    finish(2)
+  }
+  if (sessionTarget === null && cwd) {
     try { fs.mkdirSync(cwd, { recursive: true }) } catch (e) {
       console.error('task.mjs: 无法创建目录 ' + cwd + ':', e.message)
       finish(2)
     }
   }
-  const history = readHistory()
+  const history = sessionTarget === null ? readHistory() : []
   const posted = await request('POST', GATEWAY + '/api/dsh-bridge/task', {
-    instruction, history,
-    ...(cwd ? { cwd } : {}),
-    ...(opts.lane ? { lane: opts.lane } : {}),
-    ...(opts.model ? { model: opts.model } : {}),
+    instruction,
+    ...(sessionTarget === null
+      ? {
+          ...{ history },
+          ...(cwd ? { cwd } : {}),
+          ...(opts.lane ? { lane: opts.lane } : {}),
+          ...(opts.model ? { model: opts.model } : {}),
+        }
+      : {
+          ...sessionTarget,
+          ...(opts.steer ? { deliver: 'steer' } : {}),
+        }),
   })
   const task = posted.json
+  if (task === null || typeof task !== 'object') {
+    console.error('task.mjs: 网关返回 ' + posted.status + '，响应不是 JSON —— profile 里的插件可能还是旧版本（session 目标需要 0.1.2+）')
+    console.error(String(posted.text || '').slice(0, 200))
+    finish(1)
+  }
   console.log(JSON.stringify({ phase: 'submitted', ...task }))
-  if (posted.status !== 202 || task.status === 'error') finish(posted.status === 202 ? 0 : 1)
+  if (task.reason === 'session-ambiguous' || task.reason === 'session-query-empty') {
+    console.error('task.mjs: ' + (task.error || task.reason))
+    if (Array.isArray(task.candidates) && task.candidates.length > 0) {
+      console.error('候选（改用 --session <id> 指定其一）:')
+      for (const c of task.candidates) console.error('  ' + c.sessionId + '  ' + c.snippet)
+    }
+    finish(4)
+  }
+  if (posted.status !== 202 || task.status === 'error') {
+    console.error('task.mjs: ' + (task.error || task.reason || 'submission failed'))
+    finish(1)
+  }
   if (!opts.wait) finish(0)
 
   const deadline = Date.now() + opts.timeoutSec * 1000
@@ -197,10 +247,13 @@ async function main() {
       console.log('=== DeepSeek 汇报 ===')
       console.log(status.result || status.error || '(无内容)')
       if (status.status === 'done') {
-        appendHistory([
-          { role: 'user', text: instruction },
-          { role: 'assistant', text: status.result || '(无输出)' },
-        ])
+        // session 目标的记忆就在那条会话里，不再往协作历史里塞一份。
+        if (sessionTarget === null) {
+          appendHistory([
+            { role: 'user', text: instruction },
+            { role: 'assistant', text: status.result || '(无输出)' },
+          ])
+        }
         if (opts.commit && cwd) gitCommit(cwd, '[task ' + task.taskId + '] ' + instruction)
       }
       finish(status.status === 'done' ? 0 : 1)