alanbox 0.1.1

package/0commondflowv1/AGENTS.md

@@ -0,0 +1,51 @@
+## 0commondflowv1
+
+`C:\Users\lenovo\Desktop\my-project\101my-aitool\aibox\0commondflowv1` 是 `alanbox` 当前主实现层，承接 CLI 命令、参数解析、Codex/Claude 子进程 runner、worker 编排、handoff、用户级 `.multirunagent` 存储、prompt 构造和 Codex/Claude 资源安装。根目录 `bin/multirunagent.js` 和 `index.js` 只负责转发到 `0commondflowv1/src/cli.js`。
+
+**Important:** `0commondflowv1` 是当前稳定入口；npm 包名是 `alanbox`，CLI bin 同时暴露 `alanbox` 和兼容名 `multirunagent`。不要在没有迁移计划的情况下重命名用户级 `.multirunagent` 存储目录。
+
+**Important:** `src/runner/config.json` 默认 provider 是系统 `codex` CLI；Claude CLI 只能作为可选 provider/worker 配置启用。不要把个人 Antigravity cockpit 路径、全局 npm 安装路径或私有 home 写成通用默认配置。
+
+### Important files
+
+- `src/cli.js` — 0commondflowv1 主命令分发器；加载配置、解析运行上下文，并路由到 `doctor`、`info`、`install/init`、`swarm`；`swam` 是 `swarm` 的兼容别名。
+- `src/args.js` — CLI 参数解析器；新增 flag 或命令参数时优先在这里统一处理。
+- `src/commands/swarm/index.js` — `swarm` 命令入口与路由；`cli.js` 通过 `require('./commands/swarm')` 解析到此，`--auto` / `--resume` 委托 `swarm/auto.js`，否则走 `swarm/custom.js`。
+- `src/commands/swarm/custom.js` — 多 worker 编排主流程；负责 worker spec 执行。
+- `src/commands/swarm/auto.js` — auto workflow 状态机；负责 GOAP 推荐、确认门、pending/resume、执行、失败重规划。
+- `src/commands/doctor.js` — 子 Codex 环境和账号健康检查。
+- `src/commands/info.js` — 输出当前配置、worker 和命令信息。
+- `src/commands/install.js` — 显式安装 Codex/Claude skills、hooks、mcp、scripts；Codex 额外安装 plugin manifest 和 marketplace entry。
+- `src/runner/codex-runner.js` — Codex 子进程执行层；负责读取配置、设置 `CODEX_HOME`、spawn `codex exec/login/doctor`。
+- `src/runner/config.json` — 当前内置最小配置来源；默认只声明 `providers.codex`、可选 `providers.claude` 和 `timeoutMs`，不预设 worker/account，默认使用各 CLI 的原生 home 和登录态。
+- `src/core/workers.js` — worker spec 解析、分组并行阶段解析、worker 名称归一化和依赖层构建。
+- `src/core/swarm-executor.js` — 普通 swarm 和 auto workflow 共用的 task graph 执行器；`swarm --parallel-workers` 通过同一执行器并行调度。
+- `src/core/workflow-planner.js` — 本地最小 GOAP planner；把目标、agent specs 和 plan hint 转成 workflow phases/actions。
+- `src/core/workflow-storage.js` — auto workflow 的 AgentDB-lite 文件存储；写 run/plan/state/steps JSON。
+- `src/core/prompt-templates.js` — auto workflow role 模板查找、渲染和 fallback。
+- `src/core/handoff.js` — prior results context 与 `HANDOFF_JSON` 提取/构造逻辑。
+- `src/core/storage.js` — 用户级 `.multirunagent` 结果与 memory 写入；查询、resume、logs 能力应优先扩展这里。
+- `src/core/prompt-builder.js` — 注入 role、context、skill-file、handoff 协议的 prompt 构造逻辑。
+
+### Implementation notes
+
+- `swam`/`swarm` 是 worker 执行的唯一业务入口；单 worker 使用一个 `--worker`，需要全并行时使用 `swarm --parallel-workers`，需要混合串行/并行时用 `--worker "[spec1,spec2]"` 表示同一阶段并行。不要恢复独立 `exec` 或 `parallel` 命令。
+- CLI 的 `--worker` 输入和未来 workflow JSON 最终都应转换为统一 task 数组，再交给同一个执行器处理。
+- 调整参数解析时，同步检查 `src/cli.js` 的 usage 文案、README 命令示例和相关 skills。
+- 调整 worker/handoff/storage 协议时，同步检查根目录 `skills/aibox-swam` 和 `skills/sub-codex-*` 的说明，避免 skill 仍指导旧参数或旧输出格式。
+- `install --target codex|claude|both` 是安装入口；未传 target 时只在交互终端询问，非交互模式必须显式传 target，避免误写用户目录。
+- `%USERPROFILE%\.multirunagent\<namespace>` 是运行结果和 handoff 的持久化位置；改写存储格式前要考虑旧 run 的读取兼容。项目内 `.sub-codex` 是旧位置，不应再作为默认输出目录。
+- scheduler、retry、resume、workflow JSON 等能力如果新增，应先复用现有 `swarm` 执行链路，再扩展状态机；当前 `swarm --auto` 已通过 `swarm/auto.js` + `swarm-executor.js` 复用普通 swarm 执行链路。
+- 默认不隔离 CLI home：不设置 `CODEX_HOME` / `CLAUDE_CONFIG_DIR`，让 Codex/Claude 使用原生登录态；只有显式配置 `accountsDir`、worker account 或 home 时才启用隔离。
+- 不要限制 worker 数量；`--worker "codex:role:prompt"` 会按任务序号生成 `worker-1`、`worker-2`、`worker-3` 等动态 worker，默认配置不需要提前列出这些 worker。
+- Claude CLI 非交互模式使用 `claude -p <prompt>`；`claude:role:prompt` 或 `provider: "claude"` 的 worker 应走 Claude provider，不要复用 Codex 专属的 `codex exec` 参数。
+- Windows 兼容是硬约束：路径拼接、`.cmd`、PowerShell、绝对路径和 `CODEX_HOME` 隔离都要实际验证。
+
+### Verification
+
+- 从包根目录运行烟雾检查：`npm test`
+- 从包根目录运行轻量验证：`npm run validate`
+- 直接查看信息：`node bin/multirunagent.js info`
+- 直接检查环境：`node bin/multirunagent.js doctor`
+- 检查安装参数解析：`node bin/multirunagent.js install --target codex` 或 `--target claude`（会真实复制资源，确认目标目录后再运行）
+- 注意：`--dry-run` 已移除，swarm/auto 不再有离线预览，运行即调用真实 provider；确认参数与命令构造请用 `info`。

package/0commondflowv1/res/three-lens-review.js

@@ -0,0 +1,124 @@
+//下面是workflow的示例,参考的不要固定,可以根据需要修改,但要保证整体的结构和逻辑清晰.
+
+export const meta = {
+  // 当前工作流/命令的唯一名称，外部列表或运行器通常用它识别这个 review 流程。
+  name: 'three-lens-review',
+  // 给用户或命令面板看的简短说明，不参与审查逻辑。
+  description: 'Review a project from correctness, security, and maintainability lenses',
+  // 声明流程会展示的阶段；phase('...') 需要和这里的 title 对应，便于 UI/日志分段显示。
+  phases: [
+    // Review 阶段：并行启动多个 reviewer agent，分别从不同视角检查项目。
+    { title: 'Review', detail: 'Run independent review agents' },
+    // Synthesize 阶段：把多个 reviewer 的结构化结果合并成最终中文报告。
+    { title: 'Synthesize', detail: 'Merge review results' }
+  ]
+}
+
+// FINDINGS_SCHEMA 约束 reviewer agent 必须返回的 JSON 结构。
+// 它的作用是把自由文本审查结果变成稳定字段，方便后续 flatMap 合并和 summary agent 汇总。
+const FINDINGS_SCHEMA = {
+  // 顶层返回值必须是对象，例如：{ findings: [...] }。
+  type: 'object',
+  // properties 定义顶层对象允许出现哪些字段。
+  properties: {
+    // findings 是审查发现列表；每个 reviewer 都把自己发现的问题放在这个数组里。
+    findings: {
+      // items 定义 findings 数组中每一项问题对象的结构。
+      items: {
+        // 单条问题必须是对象，不能是字符串或其他类型。
+        type: 'object',
+        // properties 定义单条问题对象允许出现的字段。
+        properties: {
+          // title：问题标题，用来快速说明发现了什么，后续汇总时也常用它判断重复问题。
+          title: { type: 'string' },
+          // severity：严重程度，例如 high/medium/low；summary agent 会据此排序。
+          severity: { type: 'string' },
+          // file：问题所在文件路径；让用户能定位到具体文件，汇总报告也依赖它保留上下文。
+          file: { type: 'string' },
+          // explanation：问题解释，说明为什么这是问题、可能造成什么影响。
+          explanation: { type: 'string' }
+        },
+        // required 表示每条 finding 必须包含这些字段，缺少任一字段都不算合格输出。
+        required: ['title', 'severity', 'file', 'explanation'],
+        // 禁止 reviewer 返回 schema 之外的字段，避免不同 agent 输出不一致导致后续处理变复杂。
+        additionalProperties: false
+      }
+    }
+  },
+  // 顶层必须有 findings 字段；即使没有发现问题，也应该返回 findings: []。
+  required: ['findings'],
+  // 顶层同样禁止额外字段，让 reviews.flatMap(r => r.findings) 的输入保持稳定。
+  additionalProperties: false
+}
+
+// lenses 定义本流程要启动哪些审查视角；数组中每一项都会变成一个独立 reviewer agent。
+const lenses = [
+  {
+    // key 是审查视角的短标识，用在 label: review:<key> 中，方便日志定位来源。
+    key: 'correctness',
+    // prompt 是交给该 reviewer agent 的具体任务说明；这里要求只报告高置信正确性 bug。
+    prompt: '检查当前项目是否有明显的正确性 bug。只报告真实、高置信的问题。'
+  },
+  {
+    // security 视角只看安全风险，避免和正确性/维护性审查混在一起。
+    key: 'security',
+    // 这个 prompt 控制 agent 把注意力放在安全问题上，并限制只报告真实、高置信风险。
+    prompt: '检查当前项目是否有安全风险。只报告真实、高置信的问题。'
+  },
+  {
+    // maintainability 视角关注后续维护成本，不一定是立即会触发的 bug。
+    key: 'maintainability',
+    // 这个 prompt 让 agent 查找可维护性、复用和简化问题。
+    prompt: '检查当前项目是否有可维护性、复用、简化方面的问题。'
+  }
+]
+
+// 切换到 Review 阶段；通常用于运行器 UI 或日志显示当前进度。
+phase('Review')
+
+// reviews 保存三个 reviewer agent 的返回结果，顺序对应 lenses 数组。
+const reviews = await parallel(
+  // parallel 接收一组任务函数；这里每个 lens 映射成一个可并发执行的 agent 调用。
+  lenses.map(lens => () =>
+    agent(lens.prompt, {
+      // label 是本次 agent 调用的日志名，例如 review:correctness。
+      label: `review:${lens.key}`,
+      // phase 告诉运行器这个 agent 属于 Review 阶段。
+      phase: 'Review',
+      // agentType 指定使用代码审查类型的 agent，而不是通用写作/汇总 agent。
+      agentType: 'code-reviewer',
+      // schema 要求 reviewer 按 FINDINGS_SCHEMA 返回结构化 JSON。
+      schema: FINDINGS_SCHEMA
+    })
+  )
+)
+
+// 切换到 Synthesize 阶段；从这里开始不再审查代码，而是整理审查结果。
+phase('Synthesize')
+
+// findings 是所有 reviewer 原始发现的合并列表。
+const findings = reviews
+  // 某个 reviewer 如果失败或没有返回结果，这里会先跳过，避免访问空值报错。
+  .filter(Boolean)
+  // 每个 reviewer 返回 { findings: [...] }；flatMap 把多个 findings 数组合并成一个数组。
+  .flatMap(r => r.findings ?? [])
+
+// summary 是最终给用户看的中文整理报告。
+// JSON.stringify 把结构化 findings 嵌入提示词，让汇总 agent 基于原始审查发现工作。
+const summary = await agent(`
+请用中文整理这些审查结果，去重，并按严重程度排序：
+
+${JSON.stringify(findings, null, 2)}
+`, {
+  // label 是汇总 agent 的日志名。
+  label: 'synthesize',
+  // phase 告诉运行器这个 agent 属于 Synthesize 阶段。
+  phase: 'Synthesize'
+})
+
+return {
+  // findings：机器可处理的原始结构化审查结果，保留每个 reviewer 的具体发现。
+  findings,
+  // summary：面向用户阅读的中文汇总，已去重并按严重程度排序。
+  summary
+}

package/0commondflowv1/src/AGENTS.md

@@ -0,0 +1,26 @@
+## 0commondflowv1 src
+
+`0commondflowv1/src` 是 `alanbox` 的当前主源码目录，负责 CLI 参数解析、命令分发、worker 编排、runner 执行、handoff、存储和 prompt 构造。入口由包根 `bin/multirunagent.js` / `index.js` 转发到 `cli.js`，npm 发布后同时暴露 `alanbox` 和兼容 bin `multirunagent`。
+
+**Important:** 这里是 0commondflowv1 的稳定实现层。新增命令、flag、provider、worker 协议或存储行为时，要同步检查 `0commondflowv1/AGENTS.md`、README、skills 说明和 `alanbox info` / `--help` 输出；本地源码验证仍可用 `node bin/multirunagent.js ...`。
+
+### Important files
+
+- `cli.js` — CLI 主分发器；命令入口和 usage 文案在这里维护。
+- `args.js` — 通用参数解析；新增 flag 时优先在这里统一处理。
+- `commands/` — 具体 CLI 命令实现；`swarm` 拆分为 `commands/swarm/`（`index.js` 路由、`custom.js` 手动 worker、`auto.js` 推荐/确认/恢复流程），修改前先读 `commands/AGENTS.md`。
+- `core/` — worker、handoff、storage、prompt 构造等核心协议；修改前先读 `core/AGENTS.md`。
+- `prompt/` — 可复用 Markdown 提示词模板；修改前先读 `prompt/AGENTS.md`。
+- `runner/` — Codex / Claude CLI 子进程执行与配置解析；修改前先读 `runner/AGENTS.md`。
+
+### Implementation notes
+
+- `swarm` 是 worker 执行的唯一业务入口；单 worker 使用一个 `--worker`，全并行多 worker 走 `swarm --parallel-workers`，混合串行/并行用 `--worker "[spec1,spec2]"` 表达同一阶段并行，不要复制出独立 `exec` 或 `parallel` 命令。
+- 默认使用原生 CLI 登录态；只有显式配置隔离 home 时才设置 `CODEX_HOME` 或 `CLAUDE_CONFIG_DIR`。
+- 多 worker 输出默认写入 `%USERPROFILE%\.multirunagent\<namespace>`，不要重新写回项目内 `.sub-codex`。
+- Windows 兼容是长期约束；路径拼接使用 Node `path`，命令文案和示例要考虑 PowerShell。
+
+### Verification
+
+- 从包根目录运行：`npm run validate`
+- 直接检查配置与参数解析：`node bin/multirunagent.js info`

package/0commondflowv1/src/args.js

@@ -0,0 +1,75 @@
+/**
+ * multirunagent 的 CLI 参数解析器。
+ * 统一处理 flag、位置 prompt 和多 worker 任务规格。
+ */
+
+function parseArgs(argv, command = 'swarm') {
+  const result = { _: [] };
+  const autoSwarm = command === 'swarm' && hasFlag(argv, 'auto');
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === '--') {
+      result._.push(...argv.slice(i + 1));
+      break;
+    }
+    if (!arg.startsWith('-')) {
+      result._.push(arg);
+      continue;
+    }
+
+    const [keyPart, inlineValue] = arg.split('=', 2);
+    const key = keyPart.replace(/^--?/, '');
+
+    if (BOOLEAN_FLAGS.includes(key)) {
+      result[key] = true;
+      continue;
+    }
+
+    const value = inlineValue !== undefined ? inlineValue : argv[i + 1];
+    if (inlineValue === undefined) i += 1;
+
+    if (value === undefined) {
+      throw new Error(`missing value for ${arg}`);
+    }
+
+    if (['task', 't'].includes(key) || (command === 'swarm' && ['worker', 'w'].includes(key))) {
+      result.task = result.task || [];
+      result.task.push(value);
+      continue;
+    }
+
+    if (autoSwarm && ['agent', 'a'].includes(key)) {
+      result.agent = result.agent || [];
+      result.agent.push(value);
+      continue;
+    }
+
+    if (autoSwarm && ['plan-hint', 'hint', 'p'].includes(key)) {
+      result.planHint = [result.planHint, value].filter(Boolean).join('\n');
+      continue;
+    }
+
+    result[key] = value;
+  }
+
+  return result;
+}
+
+const BOOLEAN_FLAGS = [
+  'parallel',
+  'parallel-workers',
+  'auto',
+  'y',
+  'codex',
+  'claude',
+  'both',
+];
+
+function hasFlag(argv, name) {
+  return argv.some((arg) => arg === `--${name}` || arg.startsWith(`--${name}=`));
+}
+
+module.exports = {
+  parseArgs,
+};

package/0commondflowv1/src/cli.js

@@ -0,0 +1,121 @@
+/**
+ * 主命令分发器。
+ * 负责加载配置、解析运行上下文，并路由到具体命令处理器。
+ */
+
+const { loadConfig } = require('./runner/codex-runner');
+const { parseArgs } = require('./args');
+const { runDoctor } = require('./commands/doctor');
+const { runInfo } = require('./commands/info');
+const { runInstall } = require('./commands/install');
+const { runSwarm } = require('./commands/swarm');
+
+async function main(argv = process.argv.slice(2)) {
+  if (argv.includes('-h') || argv.includes('--help') || argv[0] === 'help') {
+    printUsage();
+    return;
+  }
+
+  let command = argv[0] && !argv[0].startsWith('-') ? argv.shift() : 'swarm';
+  if (command === 'swam') {
+    command = 'swarm';
+    console.error('[alanbox] `swam` 已按 `swarm` 兼容处理。');
+  }
+
+  if (command === 'help') {
+    printUsage();
+    return;
+  }
+
+  const args = parseArgs(argv, command);
+  const config = loadConfig();
+  const worker = args.worker || args.w || config.defaultWorker;
+  const workerConfig = config.workers?.[worker] || null;
+  const account = args.account || (!args.auto ? args.a : '') || workerConfig?.account || config.defaultAccount;
+  const cwd = args.cwd || args.C || workerConfig?.cwd || config.defaultProjectPath;
+  const timeoutMs = args.timeout ? Number(args.timeout) : config.timeoutMs;
+  const context = { args, config, account, worker, workerConfig, cwd, timeoutMs };
+
+  if (command === 'doctor') {
+    await runDoctor(context);
+    return;
+  }
+
+  if (command === 'info') {
+    await runInfo(context);
+    return;
+  }
+
+  if (command === 'install' || command === 'init') {
+    await runInstall(context);
+    return;
+  }
+
+  if (command === 'swarm') {
+    await runSwarm(context);
+    return;
+  }
+
+  throw new Error(`unknown command: ${command}`);
+}
+
+function printUsage() {
+  console.log(`
+alanbox CLI runner
+
+Usage:
+  node index.js info [--account 30428]
+  node index.js doctor [--account 30428]
+  node index.js install [--target codex|claude|both]
+  node index.js swarm [options] --worker "codex:<role>:<prompt>" --worker "claude:<role>:<prompt>"
+  node index.js swam [options] --worker "codex:<role>:<prompt>"
+  node index.js swarm --worker "codex:a:先做 A" --worker "[codex:c:并行 C,codex:d:并行 D]" --worker "codex:e:最后汇总"
+  node index.js swarm --auto "<goal>" -a "codex:reviewer:复核代码" -p "最好每个子文件夹一个子agent并行"
+  node index.js swam --auto "<goal>" -a "codex:reviewer:复核代码"
+  node index.js swarm --resume <runId> --namespace <name> -y
+
+Options:
+  --account, -a <name>       Isolated Codex account home. Default: codex-1
+                              In swarm --auto, -a means repeatable agent spec; use --account for account.
+  --cwd, -C <path>           Project working directory
+  --model, -m <model>        Model passed to codex exec / claude -p
+  --profile, -p <profile>    Codex profile under CODEX_HOME
+                              In swarm --auto, -p means planning hint; use --profile for profile.
+  --sandbox, -s <mode>       read-only | workspace-write | danger-full-access
+  --output, -o <file>        Write last Codex message to a file
+  --timeout <ms>             Process timeout
+  --context <text>           Shared background prompt injected into workers
+  --context-file <path>      Read shared background prompt from file
+  --skill-file <path>        Inject a skill/instruction file into the prompt
+  --namespace <name>         Shared namespace label for multi-agent runs
+  --worker, -w <spec>        Swarm worker spec: codex:role:prompt, claude:role:prompt, or worker-9:role:prompt.
+                              Use "[spec1,spec2]" as one parallel stage in the default dependency order.
+                              Escape literal commas inside a grouped prompt as "\\,".
+  --task <spec>              Backward-compatible alias for --worker in swarm mode
+  --parallel-workers         Run swarm workers in parallel instead of dependency order
+
+Install options:
+  --target <target>          codex | claude | both. If omitted, install asks interactively.
+  --codex                    Install only Codex resources
+  --claude                   Install only Claude resources
+  --both                     Install Codex and Claude resources
+
+Auto workflow options:
+  --auto                     Let GOAP planner recommend workflow before execution
+  --agent, -a <spec>         Repeatable auto agent spec. Example: codex:reviewer:复核 src 代码
+  --plan-hint, -p <text>     Extra planning hint. Example: 最好每个子文件夹一个子agent并行
+  --y, -y                    Execute without interactive confirmation
+  --resume <runId>           Resume a pending auto workflow run
+  --max-replans <n>          Replan up to n times after failures
+
+Account isolation:
+  By default this runner uses the provider CLI native home and login state.
+  Configure accountsDir/account home only when you explicitly need isolation.
+  OPENAI_API_KEY is only removed automatically when an isolated home is active.
+`);
+}
+
+module.exports = {
+  main,
+  printUsage,
+};

package/0commondflowv1/src/commands/AGENTS.md

@@ -0,0 +1,29 @@
+## commands
+
+`0commondflowv1/src/commands` 存放 `alanbox` 的具体 CLI 命令处理器。每个文件只负责一个命令的行为编排，底层 worker 解析、runner 执行、handoff 和 storage 应复用 `core/`、`runner/`、`prompt/`。
+
+**Important:** 新增或修改命令参数时，必须同步检查 `src/args.js`、`src/cli.js` usage 文案、README 和相关 skills，避免 CLI 行为和说明不一致。
+
+### Important files
+
+- `swarm/index.js` — `swarm` 命令入口与路由；`--auto` / `--resume` 委托 `swarm/auto.js`，否则走 `swarm/custom.js`。`cli.js` 通过 `require('./commands/swarm')` 解析到此目录。
+- `swarm/custom.js` — 多 worker 串行/依赖层编排；解析 worker specs 后复用共享 executor。
+- `swarm/auto.js` — `swarm --auto` 状态机；负责 GOAP workflow 推荐、确认门、pending/resume、执行和失败重规划。
+- `doctor.js` — 环境和 provider 健康检查；用于诊断 CLI 命令、home、认证和 dry-run。
+- `info.js` — 输出当前配置和运行信息；应避免泄露 secret 或本机敏感路径之外的无关细节。
+- `install.js` — 显式安装 Codex/Claude skills、hooks、mcp 和 scripts；Codex 额外维护 plugin manifest 与 marketplace。不要让普通包加载隐式安装资源。
+
+### Implementation notes
+
+- `swarm` 的 runDir 应来自 `core/storage.js`，默认在 `%USERPROFILE%\.multirunagent\<namespace>`；auto workflow run 使用 `%USERPROFILE%\.multirunagent\<namespace>\runs\<runId>`。
+- `swarm --auto` 中 `-a` 表示 repeatable agent spec、`-p` 表示 plan hint；非 auto 命令仍保持旧 account/profile 语义，文档和 usage 必须同步说明。
+- worker 执行统一通过 `swam`/`swarm` 开启；单 worker 使用一个 `--worker`，全并行多 worker 使用 `swarm --parallel-workers`，混合串行/并行用 `--worker "[spec1,spec2]"` 表达同一阶段并行。不要恢复独立 `exec` / `parallel` 命令或复制执行链路。
+- `install` 支持 `--target codex|claude|both`、`--codex`、`--claude`、`--both`；未传目标时只在交互终端询问，脚本/CI 中必须显式传目标。
+- `alanbox info` 输出解析后的 provider、command、env 和 worker 配置，是用户排查的重要依据；改动 provider、env、args 解析时要实际运行 `info` 检查（本地源码可用 `node bin/multirunagent.js info`，`--dry-run` 预览已移除）。
+
+### Verification
+
+- 从包根目录运行：`npm run validate`
+- 修改命令参数或 provider/env 展示后：`node bin/multirunagent.js info`
+- 修改 auto workflow、planner 或模板后，需实际运行一次 `swarm --auto`（已无 dry-run/JSON 离线预览）验证。
+- 修改安装命令后额外检查：`node bin/multirunagent.js install --target codex`、`--target claude` 或 `--target both`（会真实复制资源，确认目标目录后再运行）。

package/0commondflowv1/src/commands/doctor.js

@@ -0,0 +1,17 @@
+/**
+ * doctor 命令处理器。
+ * 把环境和 Codex CLI 诊断委托给 0commondflowv1/src/runner/codex-runner。
+ */
+
+const { doctor } = require('../runner/codex-runner');
+
+async function runDoctor({ config, account, cwd, timeoutMs }) {
+  const result = await doctor({ config, account, cwd, timeoutMs });
+  process.exitCode = result.code || 0;
+}
+
+module.exports = {
+  runDoctor,
+};
+
+

package/0commondflowv1/src/commands/info.js

@@ -0,0 +1,33 @@
+/**
+ * info 命令处理器。
+ * 输出解析后的账号、worker、命令、sandbox 和 worker 配置。
+ */
+
+const {
+  resolveAccountHome,
+  resolveProvider,
+  resolveCommandArgs,
+} = require('../runner/codex-runner');
+
+async function runInfo({ config, account, worker, workerConfig, cwd }) {
+  const provider = resolveProvider(config, workerConfig);
+  console.log(JSON.stringify({
+    account,
+    worker,
+    provider: provider.name,
+    accountHome: resolveAccountHome(config, account),
+    cwd,
+    command: workerConfig?.command || provider.command || config.codexNodeCommand || config.codexCommandPath || config.codexCommand,
+    commandArgs: resolveCommandArgs(config, workerConfig, provider),
+    sandbox: config.sandbox,
+    skipGitRepoCheck: config.skipGitRepoCheck,
+    inheritOpenAIKey: config.inheritOpenAIKey,
+    workers: config.workers,
+  }, null, 2));
+}
+
+module.exports = {
+  runInfo,
+};
+
+