@whaletalk/dsh-codex-collab 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DSH Collab contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,188 @@
+<p align="center">
+  <img src="./dsh-banner.png.png" width="100%">
+</p>
+
+# DSH Collab — Codex × DeepSeek Harness 双向编码协作
+
+**Codex 主导，DeepSeek 执行，Codex 验收。** 一个插件体系，让 ChatGPT（Codex）像项目经理一样把编码任务派给本机 DeepSeek Harness 的编码子代理，实时回传结果，读文件验收，并由独立评审员实际跑通构建/测试后出具评审报告。
+
+```
+Codex 工作区 (ChatGPT)
+   │  派活 / 评审 / 验收
+   ▼
+DeepSeek Harness 网关 ── 编码子代理（多工作区、多 lane、fast/pro 模型）
+   │                     独立评审子代理（必须跑通构建/测试）
+   ▼
+共享工作目录（任意目录，--cwd 指定）
+```
+
+```mermaid
+flowchart LR
+    subgraph Codex["Codex (ChatGPT) — 项目经理 + 验收员"]
+        A1[dsh_task 派活]
+        A2[dsh_review 评审]
+        A3[dsh_read_file 验收]
+    end
+    subgraph DSH["DeepSeek Harness"]
+        B1[HTTP 网关 /api/dsh-bridge]
+        B2[编码子代理<br/>多工作区 · 多 lane · fast/pro]
+        B3[独立评审子代理<br/>必须跑通构建/测试]
+    end
+    subgraph FS["共享工作目录"]
+        C1[任意项目目录]
+    end
+    A1 --> B1
+    A2 --> B1
+    A3 --> C1
+    B1 --> B2 --> C1
+    B1 --> B3 --> C1
+    B2 -.实时回传汇报.-> B1
+    B1 -.任务结果.-> A1
+```
+
+---
+
+## 组件
+
+| 目录 | 内容 | 说明 |
+|---|---|---|
+| `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` |
+| `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`，不存在自动创建并注册为工作区）
+- **并行分工**：同目录多 lane（`--lane`）+ 跨目录天然并行
+- **模型切换**：`fast`（deepseek-v4-flash）或 `pro`（deepseek-v4-pro），动态解析不写死
+- **双向评审**：独立评审子代理与编码员分离，读磁盘真实文件、静态审查、**实际运行构建/测试验证可跑通**，输出结构化报告
+- **Git 自动提交**：`--commit`，任务完成后在 cwd 自动 `git add -A` 并提交
+- **跨任务记忆**：持久子代理会话 + 历史摘要注入（冷恢复失败自动降级为一次性执行，功能不中断）
+- **任务管理**：`--list` / `--status <id>` / `--cancel <id>`
+- **结果回传**：任务汇报直接回 Codex 对话（`--wait` 默认）
+
+## 安装
+
+### 0. 一条命令装全部（推荐，npm）
+
+```sh
+# 1) 网关插件装进 harness profile（自动 reconcile bundles，无需手工复制文件）
+dsh plugin --profile web add @whaletalk/dsh-codex-collab
+
+# 2) MCP 服务器交给 Codex
+npm install -g @whaletalk/dsh-codex-collab
+```
+
+之后 `dsh-mcp` / `dsh-task` / `dsh-review` 三个命令进入 PATH，`~/.codex/config.toml` 里写：
+
+```toml
+[mcp_servers.dsh]
+command = 'dsh-mcp'
+startup_timeout_sec = 120
+```
+
+装完**必须重启 profile 进程**——`dsh plugin add` 改的是 bundles 列表与 node_modules，HMR 不监控这两处。
+
+> 本包只提供 bundle patch，不含 profile 之外的强依赖：`@deepseek-ai/dsh-tools` 是 optional peer，由 DSH 安装树在运行时提供。因此 `npm install` 不会去 registry 拉它，也不会因它缺失而报错。
+
+<details>
+<summary>不想用 npm？仍可手工安装（源码方式）</summary>
+
+### 1. DeepSeek Harness 网关（必需，后端）
+
+把 `harness/dsh-bridge.mjs` 复制到你的 dsh profile 目录（例如 `$DSH_HOME/profiles/web/`），并在该目录的 `cordis.patch.yml` 中追加：
+
+```yaml
+- insert:
+    - id: dsh-bridge
+      name: './dsh-bridge.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`，两者不要混用。
+
+### 2. Codex 侧（二选一或都用）
+
+**A. MCP 工具（推荐，走 Codex 官方通道）**：把 `mcp/dsh-mcp.mjs` 放到本机任意位置，在 `~/.codex/config.toml` 追加：
+
+```toml
+[mcp_servers.dsh]
+command = 'node'
+args = ['<绝对路径>/dsh-mcp.mjs']
+startup_timeout_sec = 120
+```
+
+重启 Codex，会话中出现 `mcp__dsh__*` 工具。
+
+**B. 本地市场插件（技能形式）**：把 `codex-plugin/` 放到任意位置，在个人市场清单 `~/.agents/plugins/marketplace.json` 中追加插件条目（`"path": "./plugins/dsh"`），并把插件目录放到 `~/plugins/dsh/`，然后：
+
+```bash
+codex plugin add dsh@personal
+```
+
+npm 安装后，插件目录已在包内，用一行拿到绝对路径：
+
+```bash
+node -p "require.resolve('@whaletalk/dsh-codex-collab/package.json').replace(/package\.json$/,'codex-plugin')"
+```
+
+> ⚠️ 已知问题：Codex Desktop 26.803 在 Windows 上存在插件技能不注入会话的 bug（[openai/codex#26037](https://github.com/openai/codex/issues/26037)、[#22078](https://github.com/openai/codex/issues/22078)）。技能形式可能不生效，**以 MCP 方式为准**。
+
+### 3. ChatGPT 普通聊天区（可选，受账户限制）
+
+ChatGPT 不能直连 localhost MCP。官方通道是 [Secure MCP Tunnel](https://github.com/openai/tunnel-client)：
+
+1. 在 `https://platform.openai.com/settings/organization/tunnels` 创建隧道（需组织上下文），创建 Runtime API key；
+2. 启动本地 HTTP MCP：`node dsh-mcp.mjs --http 127.0.0.1:4800`；
+3. 启动隧道客户端（含 `HTTPS_PROXY` 环境变量若需代理）：
+
+```bash
+tunnel-client init --sample sample_mcp_remote_no_auth --profile dsh --tunnel-id tunnel_xxx --mcp-server-url http://127.0.0.1:4800/mcp
+tunnel-client run --profile dsh
+```
+
+4. ChatGPT → 设置 → Connectors 中连接。
+
+> 注意：写入型 MCP 工具对 ChatGPT 个人订阅（Plus）的开放度存在产品级限制，此路径仅供有能力/有组织的账户使用。
+
+</details>
+
+## 使用
+
+**Codex 工作区会话**（MCP 工具就绪后）：
+
+> 用 dsh_task 让 DeepSeek 生成一个随机密码 CLI + 测试 + README，放在当前项目目录，完成后你用 dsh_read_file 验收，再 dsh_review 评审
+
+**命令行**（npm 安装后直接用；源码方式用 `node <脚本路径>`）：
+
+```bash
+dsh-task --in "<指令>" --cwd "<目录>" [--lane backend] [--model fast|pro] [--commit]
+dsh-review --cwd "<目录>" [--diff git|@文件|"diff文本"] [--focus "<重点>"]
+dsh-task --list | --status <taskId> | --cancel <taskId>
+```
+
+## 环境变量
+
+| 变量 | 默认 | 说明 |
+|---|---|---|
+| `DSH_BRIDGE_URL` | `http://127.0.0.1:3080` | 网关地址 |
+| `DSH_BRIDGE_WORKSPACE` | `D:\Harness` | 网关默认共享工作目录 |
+| `DSH_BRIDGE_ROOT` | `D:\Harness` | `dsh_read_file` 相对路径基准 |
+| `DSH_BRIDGE_HISTORY` | 多级降级 | 协作历史文件位置（默认 D 盘 → 用户目录 → 临时目录逐级降级） |
+
+## 已知限制
+
+- 网关插件需要 `webServer` 服务（由 `dsh-web-app` 提供），因此**只能挂 web / desktop profile**；headless profile 会一直 pending
+- Codex Desktop Windows 本地市场技能注入 bug（见上，MCP 通道不受影响）
+- 动态插件环境无 `AbortSignal`，冷恢复失败时自动降级为一次性执行；宿主组合持久化版无此问题
+- ChatGPT Plus 写入型 MCP 的开放度取决于 OpenAI 产品策略
+
+## License
+
+MIT

package/codex-plugin/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "dsh-local",
+  "interface": {
+    "displayName": "DeepSeek Harness (Local)"
+  },
+  "plugins": [
+    {
+      "name": "dsh",
+      "source": {
+        "source": "local",
+        "path": "./plugins/dsh"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Developer Tools"
+    }
+  ]
+}

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

@@ -0,0 +1,34 @@
+{
+  "name": "dsh",
+  "version": "0.1.0",
+  "description": "Codex 主导的双向编码协作插件：ChatGPT 把编码任务下发给本机 DeepSeek Harness 的持久编码子代理执行，DeepSeek 在共享工作目录 D:\\Harness 中写代码并实时回传进度与汇报，Codex 读文件验收、反馈修正，直到通过。",
+  "author": {
+    "name": "FuJackGao"
+  },
+  "keywords": [
+    "deepseek",
+    "harness",
+    "collaboration",
+    "coding",
+    "pair-programming"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "DeepSeek Harness 协作",
+    "shortDescription": "DeepSeek 写代码，Codex 验收",
+    "longDescription": "通过本机 DeepSeek Harness 的持久编码子代理执行编码任务：你下指令、DeepSeek 在共享目录 D:\\Harness 写代码并实时回传汇报、你在 Codex 中读文件验收并迭代修正，直到验收通过。",
+    "developerName": "FuJackGao",
+    "category": "Developer Tools",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "让 DeepSeek 帮我在共享目录里写一个待办事项应用，我负责验收",
+      "把这个 bug 交给 DeepSeek 修复，修完我来检查"
+    ],
+    "brandColor": "#4D6BFE",
+    "screenshots": []
+  }
+}

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

@@ -0,0 +1,59 @@
+---
+name: dsh-collab
+description: "与 DeepSeek Harness 编码协作。当用户要写代码、建项目、改代码时使用：把编码任务交给本机 DeepSeek Harness 的编码子代理执行（DeepSeek 写代码，你负责验收），在 --cwd 指定的工作目录（通常是 Codex 当前项目目录）中读文件验收；DeepSeek 完成后可自动 git 提交，并可用独立评审子代理审查 diff（评审员会实际跑通构建/测试）。不通过则发修正指令迭代，直到通过再向用户汇报。"
+---
+
+# DeepSeek Harness 编码协作
+
+## 角色
+
+- 你 = 项目经理 + 验收员。DeepSeek 编码子代理 = 程序员，在 `--cwd` 指定的工作目录中写代码（任意目录，Codex 打开哪个项目就传哪个目录）。
+- 子代理保留跨任务记忆；独立评审子代理与编码员分离，不信任口头报告，只认真实文件与真实运行结果。
+
+## 工具脚本（固定位置）
+
+- 派活：`D:/Harness/.codex-collab-tools/task.mjs`
+- 评审：`D:/Harness/.codex-collab-tools/review.mjs`
+
+## 下发任务
+
+```bash
+node "D:/Harness/.codex-collab-tools/task.mjs" --in "<完整中文指令>" --cwd "<工作目录>" [--lane <通道>] [--model fast|pro] [--commit] [--timeout 秒]
+```
+
+- `--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`。
+
+## 读取汇报与验收
+
+1. 脚本最后输出 `=== DeepSeek 汇报 ===`（做了什么、改动文件、如何验证、待决策问题）。
+2. 读 `--cwd` 中它声称改动的文件核对；必要时自己跑构建/测试。
+3. 通过 → 向用户汇报；不通过 → 发修正指令（子代理记得该目录上下文），迭代到通过。
+
+## 双向评审（Codex 验收 DeepSeek 的变更）
+
+DeepSeek 任务完成后，把它的变更交给独立评审子代理：
+
+```bash
+node "D:/Harness/.codex-collab-tools/review.mjs" --cwd "<工作目录>" [--diff git|git-staged|@文件|"diff 文本"] [--focus "<审查重点>"]
+```
+
+- `--diff` 默认取 `git diff`（未提交变更）；`git-staged` 取暂存区；也可直接给 diff 文本或文件（`@路径`）。
+- 评审员会：读 `--cwd` 真实文件核对 diff → 静态审查（正确性/健壮性/安全/测试缺口）→ **实际运行构建与测试验证可跑通** → 输出结构化报告（结论 + 问题列表 + 跑通验证 + 修改建议）。
+- 你阅读 `=== 评审报告 ===`，有问题就发修正指令给编码员，直到评审通过。
+
+## 任务管理
+
+```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>   # 取消运行中的任务
+```
+
+## 故障排查
+
+- 连接失败：DeepSeek Harness 未运行（应监听 http://127.0.0.1:3080），请提示用户启动。
+- 读不到 `--cwd` 目录：提示用户在 Codex 设置中把该目录加入可访问/可写目录。

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

@@ -0,0 +1,122 @@
+#!/usr/bin/env node
+// Codex → DeepSeek Harness 评审脚本：把代码变更 diff 交给独立评审子代理。
+// 评审员会读 cwd 真实文件、静态审查、并实际运行构建/测试验证可跑通。
+// 用法: node review.mjs --cwd <目录> [--diff <diff 文本|@文件|git|git-staged>] [--focus <审查重点>] [--timeout 秒]
+import fs from 'node:fs'
+import http from 'node:http'
+import { execFileSync } from 'node:child_process'
+
+const GATEWAY = process.env.DSH_BRIDGE_URL || 'http://127.0.0.1:3080'
+
+function parseArgs(argv) {
+  const out = { timeoutSec: 900, cwd: '', diff: '', focus: '' }
+  const rest = []
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    if (a === '--cwd') { out.cwd = argv[++i] || '' }
+    else if (a === '--diff') { out.diff = argv[++i] || '' }
+    else if (a === '--focus') { out.focus = argv[++i] || '' }
+    else if (a === '--timeout') { const v = Number(argv[++i]); if (Number.isFinite(v)) out.timeoutSec = v }
+    else { rest.push(a) }
+  }
+  return out
+}
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+// node:http + Connection: close，避免 undici keep-alive 退出断言
+function request(method, urlStr, body) {
+  return new Promise((resolve, reject) => {
+    let u
+    try { u = new URL(urlStr) } catch (e) { reject(e); return }
+    const payload = body !== undefined ? JSON.stringify(body) : undefined
+    const headers = { 'Content-Type': 'application/json', Connection: 'close' }
+    if (payload !== undefined) headers['Content-Length'] = Buffer.byteLength(payload)
+    const req = http.request({
+      hostname: u.hostname,
+      port: u.port ? Number(u.port) : 80,
+      path: u.pathname + u.search,
+      method,
+      headers,
+    }, (res) => {
+      const chunks = []
+      res.on('data', (c) => chunks.push(c))
+      res.on('end', () => {
+        const text = Buffer.concat(chunks).toString('utf8')
+        let json = null
+        try { json = text === '' ? null : JSON.parse(text) } catch (e) { /* non-JSON */ }
+        resolve({ status: res.statusCode || 0, text, json })
+      })
+    })
+    req.setTimeout(30000, () => req.destroy(new Error('request timeout')))
+    req.on('error', reject)
+    if (payload !== undefined) req.write(payload)
+    req.end()
+  })
+}
+
+function resolveDiff(cwd, diffSpec) {
+  if (!diffSpec || diffSpec === '' || diffSpec === 'git') {
+    try {
+      return execFileSync('git', ['-C', cwd, 'diff'], { stdio: 'pipe', windowsHide: true, maxBuffer: 1024 * 1024 * 4 }).toString('utf8')
+    } catch (e) { return '' }
+  }
+  if (diffSpec === 'git-staged' || diffSpec === 'git-cached') {
+    try {
+      return execFileSync('git', ['-C', cwd, 'diff', '--cached'], { stdio: 'pipe', windowsHide: true, maxBuffer: 1024 * 1024 * 4 }).toString('utf8')
+    } catch (e) { return '' }
+  }
+  if (diffSpec.startsWith('@')) {
+    const file = diffSpec.slice(1)
+    try { return fs.readFileSync(file, 'utf8') } catch (e) {
+      console.error('review.mjs: 无法读取 diff 文件 ' + file)
+      finish(2)
+    }
+  }
+  return diffSpec
+}
+
+async function main() {
+  const opts = parseArgs(process.argv.slice(2))
+  const cwd = (opts.cwd || '').trim()
+  if (!cwd) {
+    console.error('用法: node review.mjs --cwd <目录> [--diff git|git-staged|@文件|"diff 文本"] [--focus <重点>] [--timeout 秒]')
+    finish(2)
+  }
+  if (!fs.existsSync(cwd)) {
+    console.error('review.mjs: 目录不存在: ' + cwd)
+    finish(2)
+  }
+  const diff = resolveDiff(cwd, opts.diff)
+  console.log('[review] diff 长度: ' + diff.length + ' 字符')
+  const posted = await request('POST', GATEWAY + '/api/dsh-bridge/review', {
+    cwd, diff,
+    ...(opts.focus ? { focus: opts.focus } : {}),
+  })
+  const task = posted.json
+  console.log(JSON.stringify({ phase: 'submitted', ...task }))
+  if (posted.status !== 202 || task.status === 'error') finish(posted.status === 202 ? 0 : 1)
+
+  const deadline = Date.now() + opts.timeoutSec * 1000
+  while (Date.now() < deadline) {
+    await sleep(3000)
+    const res = await request('GET', GATEWAY + '/api/dsh-bridge/status?taskId=' + encodeURIComponent(task.taskId))
+    const status = res.json
+    if (status.status === 'done' || status.status === 'error' || status.status === 'cancelled') {
+      console.log(JSON.stringify({ phase: 'finished', ...status }))
+      console.log('=== 评审报告 ===')
+      console.log(status.result || status.error || '(无内容)')
+      finish(status.status === 'done' ? 0 : 1)
+    }
+  }
+  console.error('等待超时(' + opts.timeoutSec + 's)，评审仍在后台执行:')
+  console.error(GATEWAY + '/api/dsh-bridge/status?taskId=' + encodeURIComponent(task.taskId))
+  finish(3)
+}
+
+function finish(code) {
+  try { process.stderr.write = () => true } catch (e) { /* ignore */ }
+  process.exit(code)
+}
+
+main().catch((e) => { console.error('review.mjs 失败:', (e && e.message) || e); finish(1) })

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

@@ -0,0 +1,221 @@
+#!/usr/bin/env node
+// Codex → DeepSeek Harness 任务脚本：POST 指令到桥网关，可轮询等待结果。
+// 功能：--cwd 工作目录 / --lane 并行通道 / --model 模型别名 / --commit 完成后 Git 提交
+//       --wait 等待结果（默认）/ --list 任务列表 / --cancel <taskId> / --status <taskId>
+// 用法: node task.mjs --in "<指令>" [--cwd 目录] [--lane 名] [--model fast|pro] [--commit] [--timeout 秒]
+import fs from 'node:fs'
+import http from 'node:http'
+import path from 'node:path'
+import { execFileSync } from 'node:child_process'
+
+const GATEWAY = process.env.DSH_BRIDGE_URL || 'http://127.0.0.1:3080'
+
+// 历史文件候选位置（按优先顺序）：Codex 沙箱可能拒绝写入工作目录，逐级降级。
+// 可用环境变量 DSH_BRIDGE_HISTORY 指定唯一位置。
+const HISTORY_CANDIDATES = process.env.DSH_BRIDGE_HISTORY
+  ? [process.env.DSH_BRIDGE_HISTORY]
+  : [
+      path.join('D:', path.sep, 'Harness', '.dsh-collab', 'history.ndjson'),
+      path.join(process.env.USERPROFILE || '.', '.dsh-collab', 'history.ndjson'),
+      path.join(process.env.TEMP || '.', 'dsh-collab-history.ndjson'),
+    ]
+const HISTORY_MAX = 40
+
+function parseArgs(argv) {
+  const out = { wait: true, timeoutSec: 600, instruction: '', cwd: '', lane: '', model: '', commit: false, list: false, cancel: '', status: '' }
+  const rest = []
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    if (a === '--in') { out.instruction = argv[++i] || '' }
+    else if (a === '--cwd') { out.cwd = argv[++i] || '' }
+    else if (a === '--lane') { out.lane = argv[++i] || '' }
+    else if (a === '--model') { out.model = argv[++i] || '' }
+    else if (a === '--commit') { out.commit = true }
+    else if (a === '--wait') { out.wait = true }
+    else if (a === '--no-wait') { out.wait = false }
+    else if (a === '--timeout') { const v = Number(argv[++i]); if (Number.isFinite(v)) out.timeoutSec = v }
+    else if (a === '--list') { out.list = true }
+    else if (a === '--cancel') { out.cancel = argv[++i] || '' }
+    else if (a === '--status') { out.status = argv[++i] || '' }
+    else { rest.push(a) }
+  }
+  if (!out.instruction && rest.length > 0) out.instruction = rest.join(' ')
+  return out
+}
+
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms))
+
+// ---- 请求层：node:http + Connection: close，避免 undici keep-alive 退出断言 ----
+function request(method, urlStr, body) {
+  return new Promise((resolve, reject) => {
+    let u
+    try { u = new URL(urlStr) } catch (e) { reject(e); return }
+    const payload = body !== undefined ? JSON.stringify(body) : undefined
+    const headers = { 'Content-Type': 'application/json', Connection: 'close' }
+    if (payload !== undefined) headers['Content-Length'] = Buffer.byteLength(payload)
+    const req = http.request({
+      hostname: u.hostname,
+      port: u.port ? Number(u.port) : 80,
+      path: u.pathname + u.search,
+      method,
+      headers,
+    }, (res) => {
+      const chunks = []
+      res.on('data', (c) => chunks.push(c))
+      res.on('end', () => {
+        const text = Buffer.concat(chunks).toString('utf8')
+        let json = null
+        try { json = text === '' ? null : JSON.parse(text) } catch (e) { /* non-JSON body */ }
+        resolve({ status: res.statusCode || 0, text, json })
+      })
+    })
+    req.setTimeout(30000, () => req.destroy(new Error('request timeout')))
+    req.on('error', reject)
+    if (payload !== undefined) req.write(payload)
+    req.end()
+  })
+}
+
+// ---- 历史：多位置读取合并 + 逐级降级写入 ----
+function readHistory() {
+  const entries = []
+  const seen = new Set()
+  for (const file of HISTORY_CANDIDATES) {
+    try {
+      if (!fs.existsSync(file)) continue
+      for (const line of fs.readFileSync(file, 'utf8').split('\n')) {
+        const t = line.trim()
+        if (!t) continue
+        try {
+          const h = JSON.parse(t)
+          if (h && (h.role === 'user' || h.role === 'assistant') && typeof h.text === 'string') {
+            const key = h.role + ':' + h.text
+            if (!seen.has(key)) { seen.add(key); entries.push(h) }
+          }
+        } catch (e) { /* skip */ }
+      }
+    } catch (e) { /* skip */ }
+  }
+  while (entries.length > HISTORY_MAX) entries.shift()
+  return entries
+}
+
+function appendHistory(newEntries) {
+  const all = readHistory().concat(newEntries)
+  while (all.length > HISTORY_MAX) all.shift()
+  const content = all.map((h) => JSON.stringify(h)).join('\n') + '\n'
+  for (const file of HISTORY_CANDIDATES) {
+    try {
+      fs.mkdirSync(path.dirname(file), { recursive: true })
+      fs.writeFileSync(file, content)
+      return
+    } catch (e) { /* try next candidate */ }
+  }
+  // 全部位置不可写：不阻塞任务结果，仅提示
+  console.error('task.mjs: 协作历史无法落盘（沙箱限制），跨进程记忆将在本次会话后丢失')
+}
+
+function gitCommit(cwd, message) {
+  try {
+    const isRepo = (() => {
+      try { execFileSync('git', ['-C', cwd, 'rev-parse', '--is-inside-work-tree'], { stdio: 'pipe', windowsHide: true }); return true } catch (e) { return false }
+    })()
+    if (!isRepo) {
+      console.log('[commit] ' + cwd + ' 不是 git 仓库，跳过自动提交')
+      return null
+    }
+    execFileSync('git', ['-C', cwd, 'add', '-A'], { stdio: 'pipe', windowsHide: true })
+    const changed = (() => {
+      try { execFileSync('git', ['-C', cwd, 'diff', '--cached', '--quiet'], { stdio: 'pipe', windowsHide: true }); return false } catch (e) { return true }
+    })()
+    if (!changed) {
+      console.log('[commit] 无变更，跳过提交')
+      return null
+    }
+    const msg = message.replace(/\r?\n/g, ' ').slice(0, 200)
+    execFileSync('git', ['-C', cwd, 'commit', '-m', '[dsh-collab] ' + msg], { stdio: 'pipe', windowsHide: true })
+    const hash = execFileSync('git', ['-C', cwd, 'rev-parse', 'HEAD'], { stdio: 'pipe', windowsHide: true }).toString('utf8').trim()
+    console.log('[commit] 已提交: ' + hash)
+    return hash
+  } catch (e) {
+    console.error('[commit] 提交失败:', e.message)
+    return null
+  }
+}
+
+async function main() {
+  const opts = parseArgs(process.argv.slice(2))
+
+  if (opts.list) {
+    const res = await request('GET', GATEWAY + '/api/dsh-bridge/tasks')
+    console.log(JSON.stringify(res.json, null, 2))
+    finish(0)
+  }
+  if (opts.cancel) {
+    const res = await request('POST', GATEWAY + '/api/dsh-bridge/cancel', { taskId: opts.cancel })
+    console.log(JSON.stringify(res.json, null, 2))
+    finish(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)
+  }
+
+  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>')
+    finish(2)
+  }
+  const cwd = (opts.cwd || process.env.DSH_BRIDGE_CWD || '').trim()
+  if (cwd) {
+    try { fs.mkdirSync(cwd, { recursive: true }) } catch (e) {
+      console.error('task.mjs: 无法创建目录 ' + cwd + ':', e.message)
+      finish(2)
+    }
+  }
+  const history = 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 } : {}),
+  })
+  const task = posted.json
+  console.log(JSON.stringify({ phase: 'submitted', ...task }))
+  if (posted.status !== 202 || task.status === 'error') finish(posted.status === 202 ? 0 : 1)
+  if (!opts.wait) finish(0)
+
+  const deadline = Date.now() + opts.timeoutSec * 1000
+  while (Date.now() < deadline) {
+    await sleep(3000)
+    const res = await request('GET', GATEWAY + '/api/dsh-bridge/status?taskId=' + encodeURIComponent(task.taskId))
+    const status = res.json
+    if (status.status === 'done' || status.status === 'error' || status.status === 'cancelled') {
+      console.log(JSON.stringify({ phase: 'finished', ...status }))
+      console.log('=== DeepSeek 汇报 ===')
+      console.log(status.result || status.error || '(无内容)')
+      if (status.status === 'done') {
+        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)
+    }
+  }
+  console.error('等待超时(' + opts.timeoutSec + 's)，任务仍在后台执行。可用 status 接口继续查询:')
+  console.error(GATEWAY + '/api/dsh-bridge/status?taskId=' + encodeURIComponent(task.taskId))
+  finish(3)
+}
+
+// 退出收尾：先静默 stderr（抑制 Node 退出时的 libuv 断言噪音），再按码退出。
+// 任务结果以 stdout 中 "=== DeepSeek 汇报 ===" 为准。
+function finish(code) {
+  try { process.stderr.write = () => true } catch (e) { /* ignore */ }
+  process.exit(code)
+}
+
+main().catch((e) => { console.error('task.mjs 失败:', (e && e.message) || e); finish(1) })