@zmice/zc 0.1.1 → 0.2.0

package/README.md

@@ -1,126 +1,153 @@
-# @zmice/zc
-
-> **让多个 AI CLI 组队干活。** 一条命令，将 Codex、Qwen Code 等 AI 编码工具编排为协作团队，并行处理开发任务。
-
-`@zmice/zc` 是一个多 CLI 智能体团队编排运行时（Multi-CLI Agent Team Orchestration Runtime）。它解决的核心问题是：**单个 AI CLI 一次只能做一件事，而真实项目需要多个任务并行推进。**
-
-## ✨ 核心特性
-
-| 特性 | 说明 |
-|------|------|
-| 🤖 **多 CLI 适配** | 统一适配 Codex CLI、Qwen Code 等主流 AI 编码工具，通过适配器层无缝切换 |
-| 🚀 **任务并行编排** | 多个 Worker 并行执行任务，自动分派、状态追踪、失败回滚 |
-| 🧠 **智能技能匹配** | 三模式技能注入——关键词匹配（中英文）/ AI 智能匹配 / 手动指定 |
-| 🌿 **Git Worktree 隔离** | 每个 Worker 在独立 worktree 中执行，互不干扰，安全合并 |
-| 💬 **团队消息通信** | 内置 Mailbox 系统，Worker 间实时消息传递与广播 |
-| 📋 **任务队列管理** | 优先级队列、任务认领、状态流转（pending → running → done/failed） |
-
-## 📦 安装
-
-```bash
-# npm 全局安装（推荐）
-npm install -g @zmice/zc
-
-# 验证
-zc --version
-```
-
-## 🚀 快速开始
-
-```bash
-# 1. 检查环境依赖
-zc doctor
-
-# 2. 单任务运行
-zc run "实现用户登录功能"
-
-# 3. 启动团队 — 2 个 Worker 并行处理 3 个任务
-zc team start \
-  -w "w1:codex,w2:qwen-code" \
-  -t "实现登录API" \
-  -t "编写登录页面" \
-  -t "添加认证中间件"
-
-# 4. 查看团队状态
-zc team status <team-name>
-
-# 5. 团队内通信
-zc msg send w1 "优先处理API端点"
-
-# 6. 关闭团队
-zc team shutdown <team-name>
-```
-
-## 🧠 智能技能匹配
-
-zc 为每个任务自动注入相关 Skill 上下文，支持三种匹配模式：
-
-```bash
-# 默认：关键词匹配（支持中英文任务描述）
-zc team start -w "w1:codex" -t "修复登录bug"
-
-# 手动指定 Skills
-zc team start -w "w1:codex" -t "任务描述" \
-  --skills debugging-and-error-recovery security-and-hardening
-
-# AI 智能匹配（自动分析任务意图）
-zc team start -w "w1:codex" -t "任务描述" \
-  --skill-match ai
-```
-
-## 🏗️ 架构概览
-
-```
-┌─────────────────────────────────────────────────┐
-│                   CLI 命令层                      │
-│   doctor │ setup │ run │ team │ task │ msg       │
-├─────────────────────────────────────────────────┤
-│                  团队引擎层                       │
-│   Orchestrator ← TaskQueue + WorkerManager      │
-│                    ↕ Mailbox                     │
-├─────────────────────────────────────────────────┤
-│                  运行时基础设施                    │
-│   SessionManager (tmux) + WorktreeManager (git) │
-├─────────────────────────────────────────────────┤
-│                  适配器层                         │
-│         CodexAdapter │ QwenCodeAdapter │ ...     │
-└─────────────────────────────────────────────────┘
-```
-
-- **适配器层**：统一封装不同 AI CLI 的调用接口，新增 CLI 只需实现适配器
-- **运行时**：基于 tmux 的会话管理 + 基于 git worktree 的执行隔离
-- **团队引擎**：Orchestrator 协调任务分派、Worker 生命周期、消息路由
-- **CLI 命令层**：基于 Commander.js，提供 6 组子命令
-
-## 📖 命令速览
-
-| 命令 | 说明 |
-|------|------|
-| `zc doctor` | 检查环境依赖（Node.js、git、tmux、CLI 工具） |
-| `zc setup` | 初始化项目配置 |
-| `zc run <prompt>` | 单 Worker 运行任务 |
-| `zc team start` | 启动多 Worker 团队 |
-| `zc team status` | 查看团队运行状态 |
-| `zc team shutdown` | 关闭团队 |
-| `zc team log` | 查看 Worker 日志 |
-| `zc task list/claim/done/fail` | 任务管理（查看 / 认领 / 完成 / 标记失败） |
-| `zc msg send/read/broadcast` | 团队消息（发送 / 读取 / 广播） |
-
-## ⚙️ 系统要求
-
-| 依赖 | 版本 | 说明 |
-|------|------|------|
-| Node.js | >= 20 | 运行时环境 |
-| git | 任意 | Worktree 隔离执行 |
-| tmux | 任意 | 团队模式会话管理（macOS / Linux / WSL） |
-
-## 🤝 支持的 AI CLI
-
-- **Codex CLI** — OpenAI 官方命令行编码工具
-- **Qwen Code** — 阿里云通义千问编码工具
-
-> 通过适配器接口可扩展支持更多 CLI 工具。
-
-## License
-
-MIT
+# @zmice/zc
+
+`@zmice/zc` 是 AI Coding Toolkit 的统一入口 CLI。
+
+它负责两类稳定能力：
+- runtime：启动单工人或团队协作运行时
+- product commands：查询 `toolkit` 内容、生成/安装 `platform` 产物
+
+它**不负责**仓库治理型事务。像 upstream 审阅、snapshot、report、导入提案这类能力，统一通过根级脚本：
+
+```bash
+pnpm upstream -- <subcommand>
+```
+
+## 适用场景
+
+你通常会在下面几种情况下使用 `zc`：
+- 想直接启动一个 AI CLI 工人执行任务：`zc run`
+- 想启动一组 worker 并做任务编排：`zc team ...`
+- 想查询 toolkit 里的 skills / commands / agents：`zc toolkit ...`
+- 想把内容安装到 Codex / Qoder / Qwen：`zc platform ...`
+
+## 快速开始
+
+在仓库内开发：
+
+```bash
+pnpm install
+pnpm build
+node apps/cli/dist/cli/index.js --help
+```
+
+本地开发态安装到本机全局命令：
+
+```bash
+pnpm install
+pnpm build
+pnpm --dir apps/cli link --global
+zc --help
+```
+
+安装公开发布包：
+
+```bash
+npm install -g @zmice/zc
+zc --help
+```
+
+更新时重复执行：
+
+```bash
+pnpm install
+pnpm build
+pnpm --dir apps/cli link --global
+```
+
+如果使用 registry 安装：
+
+```bash
+npm install -g @zmice/zc@latest
+```
+
+完整安装、更新、平台内容安装说明见：
+
+- [`docs/usage-guide.md`](../docs/usage-guide.md)
+
+## 命令分层
+
+### Runtime
+
+- `zc run`
+- `zc team ...`
+- `zc task ...`
+- `zc msg ...`
+- `zc doctor`
+
+### Toolkit
+
+- `zc toolkit lint`
+- `zc toolkit show <query>`
+- `zc toolkit search <keyword>`
+- `zc toolkit recommend <query>`
+
+`<query>` 同时支持：
+- 完整资产 ID，例如 `command:build`
+- 唯一名称，例如 `build`
+
+### Platform
+
+- `zc platform generate <qwen|codex|qoder>`
+- `zc platform install <qwen|codex|qoder>`
+- `zc platform status <qwen|codex|qoder>`
+- `zc platform update <qwen|codex|qoder>`
+- `zc platform where <qwen|codex|qoder>`
+
+常用安装目标参数：
+- `--project`
+- `--global`
+- `--dir <path>`
+
+常用输出参数：
+- `--plan`
+- `--json`
+- `--force`
+
+## 高频用法
+
+```bash
+# toolkit
+zc toolkit lint --json
+zc toolkit show build
+zc toolkit search review
+zc toolkit recommend build
+
+# platform
+zc platform generate qwen --plan --json
+zc platform install codex --plan --json
+zc platform install qoder
+zc platform install codex --global
+zc platform status codex --global --json
+zc platform update codex --global --plan --json
+zc platform where qoder --global --json
+```
+
+## 设计边界
+
+- `zc` 发现并消费 `packages/toolkit/src/content`，但不拥有 prompt 内容
+- `zc` 调用 `packages/platform-*` 完成平台产物生成和安装
+- `zc` 不承载仓库内 upstream 治理命令
+- `zc` 的公开命令面只保留实际产品能力，不保留历史重复入口
+- 公开发布时只发布 `@zmice/zc`；内部 `toolkit/platform-*` 能力会随 `zc` 一起打包
+
+## 开发者入口
+
+如果你要修改 `zc` 本身，优先看：
+- `apps/cli/src/cli/`
+- `apps/cli/src/runtime/`
+- `apps/cli/src/team/`
+
+尤其常改的命令文件：
+- `apps/cli/src/cli/index.ts`
+- `apps/cli/src/cli/toolkit.ts`
+- `apps/cli/src/cli/platform.ts`
+- `apps/cli/src/cli/team.ts`
+- `apps/cli/src/cli/run.ts`
+
+## 开发与验证
+
+```bash
+pnpm --dir apps/cli test
+pnpm --dir apps/cli build
+pnpm --dir apps/cli verify
+```

package/dist/adapters/codex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI1E,qBAAa,YAAa,YAAW,UAAU;IAC7C,QAAQ,CAAC,IAAI,WAAW;IAElB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAS1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAS1B,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBjD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAK1E"}
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI1E,qBAAa,YAAa,YAAW,UAAU;IAC7C,QAAQ,CAAC,IAAI,WAAW;IAElB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAS1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAS1B,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA0BjD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAK1E"}

package/dist/adapters/codex.js

@@ -22,7 +22,7 @@ export class CodexAdapter {
         }
     }
     async spawn(opts) {
-        const args = ["--quiet"];
+        const args = ["exec"];
         if (opts.model)
             args.push("--model", opts.model);
         if (opts.prompt)
@@ -34,6 +34,8 @@ export class CodexAdapter {
             stdio: ["pipe", "pipe", "pipe"],
             env: { ...process.env, ...opts.env },
         });
+        // Close stdin immediately so codex exec doesn't wait for additional input
+        proc.stdin?.end();
         return {
             pid: proc.pid ?? -1,
             process: proc,
@@ -54,7 +56,7 @@ export class CodexAdapter {
     }
     async query(prompt, opts) {
         const timeout = opts?.timeout ?? 15000;
-        const { stdout } = await execAsync(`codex --quiet ${JSON.stringify(prompt)}`, { timeout });
+        const { stdout } = await execAsync(`codex exec ${JSON.stringify(prompt)}`, { timeout });
         return stdout.trim();
     }
 }

package/dist/adapters/codex.js.map

@@ -1 +1 @@
-{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,OAAO,CAAC;IAExB,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAkB;QAC5B,MAAM,IAAI,GAAa,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YAChC,GAAG,EAAE,IAAI,CAAC,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;SACrC,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACnB,OAAO,EAAE,IAAI;YACb,KAAK,CAAC,IAAI;gBACR,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,wDAAwD;QACxD,+CAA+C;QAC/C,KAAK,GAAG,CAAC;IACX,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,IAA2B;QACrD,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;QACvC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,iBAAiB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3F,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,OAAO,CAAC;IAExB,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,iBAAiB,CAAC,CAAC;YACtD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAkB;QAC5B,MAAM,IAAI,GAAa,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YAChC,GAAG,EAAE,IAAI,CAAC,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;SACrC,CAAC,CAAC;QAEH,0EAA0E;QAC1E,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QAElB,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACnB,OAAO,EAAE,IAAI;YACb,KAAK,CAAC,IAAI;gBACR,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,wDAAwD;QACxD,+CAA+C;QAC/C,KAAK,GAAG,CAAC;IACX,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,IAA2B;QACrD,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;QACvC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,cAAc,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACxF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/adapters/qwen-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qwen-code.d.ts","sourceRoot":"","sources":["../../src/adapters/qwen-code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI1E,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,IAAI,eAAe;IAEtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAS1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAS1B,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBjD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAK1E"}
+{"version":3,"file":"qwen-code.d.ts","sourceRoot":"","sources":["../../src/adapters/qwen-code.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI1E,qBAAa,eAAgB,YAAW,UAAU;IAChD,QAAQ,CAAC,IAAI,eAAe;IAEtB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAS1B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAS1B,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IA0BjD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/B,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAK1E"}

package/dist/adapters/qwen-code.js

@@ -14,19 +14,19 @@ export class QwenCodeAdapter {
     }
     async version() {
         try {
-            const { stdout } = await execAsync("qwen --version");
-            return stdout.trim();
+            const { stdout, stderr } = await execAsync("qwen --version");
+            return stdout.trim() || stderr.trim() || "unknown version";
         }
         catch {
             return "not installed";
         }
     }
     async spawn(opts) {
-        const args = ["chat", "--agent"];
+        const args = [];
         if (opts.model)
             args.push("--model", opts.model);
         if (opts.prompt)
-            args.push("--message", opts.prompt);
+            args.push("-p", opts.prompt);
         if (opts.args)
             args.push(...opts.args);
         const proc = spawn("qwen", args, {
@@ -34,6 +34,8 @@ export class QwenCodeAdapter {
             stdio: ["pipe", "pipe", "pipe"],
             env: { ...process.env, ...opts.env },
         });
+        // Close stdin immediately so child process doesn't wait for additional input
+        proc.stdin?.end();
         return {
             pid: proc.pid ?? -1,
             process: proc,
@@ -53,7 +55,7 @@ export class QwenCodeAdapter {
     }
     async query(prompt, opts) {
         const timeout = opts?.timeout ?? 15000;
-        const { stdout } = await execAsync(`qwen chat --message ${JSON.stringify(prompt)}`, { timeout });
+        const { stdout } = await execAsync(`qwen -p ${JSON.stringify(prompt)}`, { timeout });
         return stdout.trim();
     }
 }

package/dist/adapters/qwen-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"qwen-code.js","sourceRoot":"","sources":["../../src/adapters/qwen-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,WAAW,CAAC;IAE5B,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,CAAC;YACrD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAkB;QAC5B,MAAM,IAAI,GAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;YAC/B,GAAG,EAAE,IAAI,CAAC,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;SACrC,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACnB,OAAO,EAAE,IAAI;YACb,KAAK,CAAC,IAAI;gBACR,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,wDAAwD;QACxD,KAAK,GAAG,CAAC;IACX,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,IAA2B;QACrD,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;QACvC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,uBAAuB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACjG,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"qwen-code.js","sourceRoot":"","sources":["../../src/adapters/qwen-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,WAAW,CAAC;IAE5B,KAAK,CAAC,MAAM;QACV,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,gBAAgB,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,EAAE,IAAI,iBAAiB,CAAC;QAC7D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,eAAe,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAkB;QAC5B,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE;YAC/B,GAAG,EAAE,IAAI,CAAC,OAAO;YACjB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;SACrC,CAAC,CAAC;QAEH,6EAA6E;QAC7E,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;QAElB,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACnB,OAAO,EAAE,IAAI;YACb,KAAK,CAAC,IAAI;gBACR,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACjB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,wDAAwD;QACxD,KAAK,GAAG,CAAC;IACX,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,IAA2B;QACrD,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;QACvC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;QACrF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/cli/__tests__/i18n.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=i18n.test.d.ts.map

package/dist/cli/__tests__/i18n.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.test.d.ts","sourceRoot":"","sources":["../../../src/cli/__tests__/i18n.test.ts"],"names":[],"mappings":""}

package/dist/cli/__tests__/i18n.test.js

@@ -0,0 +1,45 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+const adaptersMock = vi.hoisted(() => ({
+    getAdapter: vi.fn(),
+    listAdapters: vi.fn(),
+}));
+vi.mock("../../adapters/index.js", () => adaptersMock);
+import { createProgram } from "../index.js";
+import { executeRun } from "../run.js";
+describe("CLI 中文化", () => {
+    beforeEach(() => {
+        adaptersMock.getAdapter.mockReset();
+        adaptersMock.listAdapters.mockReset();
+        process.exitCode = undefined;
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("在根帮助中保留中文说明", () => {
+        const help = createProgram().helpInformation();
+        expect(help).toContain("AI Coding Toolkit 统一入口 CLI");
+        expect(help).toContain("团队编排命令");
+        expect(help).toContain("启动单个 CLI 工人执行任务");
+        expect(help).toContain("工具包资产管理命令");
+        expect(help).not.toContain("\n  runtime");
+        expect(help).not.toContain("\n  setup");
+    });
+    it("用中文提示未知的 run 适配器", async () => {
+        adaptersMock.getAdapter.mockReturnValue(undefined);
+        adaptersMock.listAdapters.mockReturnValue(["codex", "qwen-code"]);
+        const errorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        await executeRun("hello", { cli: "foo", workdir: process.cwd() });
+        expect(errorSpy).toHaveBeenCalledWith('[zc run] 错误：未知的 CLI 适配器 "foo"。可用适配器：codex, qwen-code');
+        expect(process.exitCode).toBe(1);
+    });
+    it("用中文提示 run 目标未安装或不可用", async () => {
+        adaptersMock.getAdapter.mockReturnValue({
+            detect: vi.fn().mockResolvedValue(false),
+        });
+        const errorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        await executeRun(undefined, { cli: "codex", workdir: process.cwd() });
+        expect(errorSpy).toHaveBeenCalledWith('[zc run] 错误：未检测到 "codex" CLI 或它当前不可用。请先安装后重试。');
+        expect(process.exitCode).toBe(1);
+    });
+});
+//# sourceMappingURL=i18n.test.js.map

package/dist/cli/__tests__/i18n.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.test.js","sourceRoot":"","sources":["../../../src/cli/__tests__/i18n.test.ts"],"names":[],"mappings":"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"}

package/dist/cli/__tests__/platform.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform.test.d.ts.map

package/dist/cli/__tests__/platform.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.test.d.ts","sourceRoot":"","sources":["../../../src/cli/__tests__/platform.test.ts"],"names":[],"mappings":""}