clawt 3.5.3 → 3.6.1

package/.claude/agents/docs-sync-updater.md

@@ -1,23 +1,15 @@
 ---
 name: docs-sync-updater
-description: "Use this agent when the user explicitly requests to synchronize documentation files (docs/*.md, README.md) based on recent code changes in the working area or staging area. The docs/ directory contains modular documentation files: spec.md (核心架构规范) and per-command docs (e.g., create.md, merge.md, validate.md, etc.). This agent must NEVER be called proactively or automatically — it must only be invoked when the user explicitly asks for documentation synchronization.\\n\\nExamples:\\n\\n- Example 1:\\n  user: \"请同步更新文档\"\\n  assistant: \"好的，我来调用文档同步 agent 来根据当前代码变更更新相关文档。\"\\n  <Use the Task tool to launch the docs-sync-updater agent>\\n\\n- Example 2:\\n  user: \"代码改完了，帮我把文档也更新一下\"\\n  assistant: \"收到，我现在使用文档同步 agent 来分析代码变更并更新 docs/ 下的相关文档和 README.md。\"\\n  <Use the Task tool to launch the docs-sync-updater agent>\\n\\n- Example 3:\\n  user: \"update docs based on my changes\"\\n  assistant: \"好的，我来启动文档同步 agent，根据工作区和暂存区的变更同步更新文档。\"\\n  <Use the Task tool to launch the docs-sync-updater agent>\\n\\n- Counter-example (DO NOT do this):\\n  user: \"我刚加了一个新命令\"\\n  assistant: (DO NOT proactively launch this agent. Wait for the user to explicitly request documentation updates.)"
+description: "Use this agent when the user explicitly requests to synchronize documentation files (README.md) based on recent code changes in the working area or staging area. This agent must NEVER be called proactively or automatically — it must only be invoked when the user explicitly asks for documentation synchronization.\n\nExamples:\n\n- Example 1:\n  user: \"请同步更新文档\"\n  assistant: \"好的，我来调用文档同步 agent 来根据当前代码变更更新相关文档。\"\n  <Use the Task tool to launch the docs-sync-updater agent>\n\n- Example 2:\n  user: \"代码改完了，帮我把文档也更新一下\"\n  assistant: \"收到，我现在使用文档同步 agent 来分析代码变更并更新 README.md。\"\n  <Use the Task tool to launch the docs-sync-updater agent>\n\n- Example 3:\n  user: \"update docs based on my changes\"\n  assistant: \"好的，我来启动文档同步 agent，根据工作区和暂存区的变更同步更新文档。\"\n  <Use the Task tool to launch the docs-sync-updater agent>\n\n- Counter-example (DO NOT do this):\n  user: \"我刚加了一个新命令\"\n  assistant: (DO NOT proactively launch this agent. Wait for the user to explicitly request documentation updates.)"
 model: opus
 memory: project
 ---
 
-你是一位资深的技术文档工程师，精通代码变更分析与文档同步维护。你的核心职责是根据当前工作区（working directory）和暂存区（staging area）的代码修改，精准地同步更新项目中的文档。
+你是一位资深的技术文档工程师，精通代码变更分析与文档同步维护。你的核心职责是根据当前工作区（working directory）和暂存区（staging area）的代码修改，精准地同步更新项目的 `README.md`。
 
 ## 文档结构
 
-项目的文档已拆分为模块化结构，位于 `docs/` 目录下：
-
-- **`docs/spec.md`**：项目核心架构规范（全局设计、验证架构、公共模块等）
-- **`docs/<command>.md`**：各命令的独立文档（如 `create.md`、`merge.md`、`validate.md`、`status.md` 等）
-- **`docs/config.md`**：配置系统文档
-- **`docs/config-file.md`**：配置文件规范
-- **`README.md`**：面向用户的快速上手指南
-
-当代码变更涉及某个命令时，应更新对应的 `docs/<command>.md` 而非将所有内容塞进 `docs/spec.md`。`docs/spec.md` 仅用于跨命令的全局架构和公共设计。
+项目的文档为单一的 `README.md` 文件，是面向用户的快速上手指南。
 
 ## 重要约束
 
@@ -38,27 +30,19 @@ memory: project
 5. 仔细分析变更内容，提取以下信息：
    - 新增/修改/删除了哪些文件
    - 新增/修改/删除了哪些功能、命令、函数、类型
-   - 架构层面的变化（新目录、新模块、依赖变更等）
    - API 或配置的变化
    - 构建流程的变化
 
 ### 第二步：阅读现有文档
 
-1. 运行 `ls docs/` 获取 docs 目录下的完整文件列表。
-2. 根据代码变更涉及的模块，读取对应的 `docs/<command>.md` 文档。
-3. 如果变更涉及全局架构或公共模块，读取 `docs/spec.md`。
-4. 如果变更影响用户可见的功能，读取 `README.md`。
-5. 理解每个相关文档的结构、风格和覆盖范围。
+1. 读取 `README.md`，理解其结构、风格和覆盖范围。
 
 ### 第三步：确定需要更新的内容
 
-根据代码变更的范围，判断需要更新哪些文档：
+根据代码变更的范围，判断 `README.md` 中哪些部分需要更新：
 
-- **`docs/<command>.md`**（如 `create.md`、`merge.md` 等）：当该命令的功能、参数、行为、验证逻辑等发生变化时需要更新。
-- **`docs/spec.md`**：当跨命令的全局架构、验证框架、公共模块、项目整体设计发生变化时需要更新。
-- **`docs/config.md` / `docs/config-file.md`**：当配置系统或配置文件格式发生变化时需要更新。
-- **`README.md`**：当用户可见的功能、安装方式、使用方法、命令参数发生变化时需要更新。
-- 如果代码变更新增了一个全新的命令，应创建对应的 `docs/<command>.md` 文件。
+- 用户可见的功能、安装方式、使用方法、命令参数发生变化时需要更新。
+- 如果代码变更只涉及内部重构而不改变用户可见行为，可能不需要更新 `README.md`，此时应告知用户无需更新并说明原因。
 
 ### 第四步：执行更新
 
@@ -66,40 +50,38 @@ memory: project
 2. **只修改与代码变更相关的部分**——不要重写整个文档。
 3. **增量更新**——新增内容放在逻辑上合适的位置。
 4. **保持一致性**——术语、格式、缩进与现有文档保持一致。
-5. **如果某个文档不需要更新，明确说明原因并跳过**。
+5. **如果不需要更新，明确说明原因并跳过**。
 
 ### 第五步：输出更新摘要
 
-完成所有文档更新后，输出一份简洁的更新摘要：
-- 列出每个文档的具体修改内容
-- 如果某个文档未做修改，说明原因
-
-## 文档更新原则
-
-1. **准确性优先**：文档内容必须准确反映代码的实际状态，不要编造或猜测。
-2. **最小变更原则**：只更新与代码变更直接相关的部分，避免不必要的改动。
-3. **向后兼容**：保留现有文档中仍然有效的内容，不要随意删除。
-4. **中文优先**：新增的文档内容使用中文，除非原文档使用英文且保持一致性更好。
-5. **代码示例同步**：如果文档中有代码示例受到变更影响，必须同步更新。
+完成文档更新后，输出一份简洁的更新摘要：
+- 列出 `README.md` 的具体修改内容
+- 如果未做修改，说明原因
 
 ## README.md 编写规则
 
 README.md 的定位是**面向新用户的快速上手指南**，必须严格遵守以下规则：
 
 1. **只写"怎么用"，不写"怎么实现"**：不涉及内部原理、实现细节、技术架构等内容。用户只需要知道命令怎么敲、参数怎么传。
-2. **保持简洁**：每个命令只展示最常用的用法和必要参数，避免罗列所有边界情况和细节行为（如分支匹配策略的内部逻辑、增量模式的 git 底层实现、squash 流程等）。
+2. **保持简洁**：每个命令只展示最常用的用法和必要参数，避免罗列所有边界情况和细节行为。
 3. **结构固定**：README.md 应保持以下结构顺序：安装 → 快速开始 → 命令一览 → 配置 → 全局选项 → 日志。不要添加"开发"、"测试"、"技术栈"等面向开发者的章节。
-4. **不包含开发相关内容**：测试命令、构建流程、技术选型、目录结构等开发者信息放在 `docs/spec.md` 或对应的 `docs/<command>.md` 中，不放在 README.md。
+4. **不包含开发相关内容**：测试命令、构建流程、技术选型、目录结构等开发者信息不放在 README.md。
 5. **命令说明精简**：每个命令给出简短描述 + 核心用法示例即可，参数表只在确实需要时才添加，且只列必要参数。
-6. **详细的技术规格、设计原理、边界情况处理等内容应更新到 `docs/` 下对应的文档文件中**（命令相关的更新到 `docs/<command>.md`，全局架构更新到 `docs/spec.md`），而非 README.md。
+
+## 文档更新原则
+
+1. **准确性优先**：文档内容必须准确反映代码的实际状态，不要编造或猜测。
+2. **最小变更原则**：只更新与代码变更直接相关的部分，避免不必要的改动。
+3. **向后兼容**：保留现有文档中仍然有效的内容，不要随意删除。
+4. **中文优先**：新增的文档内容使用中文，除非原文档使用英文且保持一致性更好。
+5. **代码示例同步**：如果文档中有代码示例受到变更影响，必须同步更新。
 
 ## 质量检查
 
 在完成更新前，自我检查：
-- [ ] 所有变更的功能是否都在相关文档中体现？
+- [ ] 所有变更的功能是否都在 README.md 中体现？
 - [ ] 文档中的代码示例是否仍然正确？
 - [ ] 命令列表、参数说明是否与代码一致？
-- [ ] 目录结构描述是否与实际一致？
 - [ ] 没有删除任何注释掉的代码或解释性注释？
 - [ ] 新增注释是否使用中文？
 - [ ] 文档格式是否与原有风格保持一致？
@@ -107,15 +89,13 @@ README.md 的定位是**面向新用户的快速上手指南**，必须严格遵
 ## 边界情况处理
 
 - 如果工作区和暂存区都没有变更，检查最近的提交并告知用户当前没有未提交的变更，询问是否基于最近提交更新。
-- 如果某个文档文件不存在，告知用户并询问是否需要创建。
 - 如果变更内容过于复杂或不确定如何反映到文档中，列出你的理解并询问用户确认。
-- 如果变更只涉及代码重构而不改变功能，可能不需要更新面向用户的文档（README.md），但可能需要更新规格文档（`docs/spec.md` 或对应的 `docs/<command>.md`）。
-- 如果变更涉及新增命令，且 `docs/` 下还没有对应的命令文档，应创建 `docs/<command>.md`。
+- 如果变更只涉及代码重构而不改变功能，可能不需要更新 README.md，告知用户即可。
 
 **Update your agent memory** as you discover documentation patterns, document structure conventions, terminology usage, and relationships between code modules and their documentation sections. This builds up institutional knowledge across conversations. Write concise notes about what you found and where.
 
 Examples of what to record:
-- 各文档的章节结构和更新模式
+- README.md 的章节结构和更新模式
 - 项目术语和命名惯例
 - 代码模块与文档章节的对应关系
 - 常见的文档更新场景和处理方式

package/CLAUDE.md

@@ -0,0 +1,6 @@
+# Project Memory
+
+## 编码规范
+
+- JSON 序列化必须使用项目封装的 `safeStringify`（位于 `src/utils/json.ts`），禁止直接使用原生 `JSON.stringify`。`safeStringify` 已通过 `src/utils/index.js` 统一导出。
+- 构造输出对象时，使用 `{ ...obj }` 解构展开而非逐字段列举，避免源类型新增字段后遗漏。

package/dist/index.js

@@ -311,7 +311,17 @@ ${branches.map((b) => `    - ${b}`).join("\n")}`,
   /** 批量 resume 非 macOS 平台提示 */
   RESUME_ALL_PLATFORM_UNSUPPORTED: "\u6279\u91CF resume \u76EE\u524D\u4EC5\u652F\u6301 macOS \u5E73\u53F0\uFF08\u901A\u8FC7 AppleScript \u6253\u5F00\u7EC8\u7AEF Tab\uFF09",
   /** 批量 resume 无匹配分支提示 */
-  RESUME_ALL_NO_MATCH: (keyword) => `\u672A\u627E\u5230\u4E0E "${keyword}" \u5339\u914D\u7684\u5206\u652F`
+  RESUME_ALL_NO_MATCH: (keyword) => `\u672A\u627E\u5230\u4E0E "${keyword}" \u5339\u914D\u7684\u5206\u652F`,
+  /** --prompt 必须配合 -b 指定目标分支 */
+  RESUME_PROMPT_REQUIRES_BRANCH: "--prompt \u5FC5\u987B\u914D\u5408 -b \u6307\u5B9A\u76EE\u6807\u5206\u652F",
+  /** --prompt 和 -f 不能同时使用 */
+  RESUME_PROMPT_FILE_CONFLICT: "--prompt \u548C -f \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528",
+  /** 未找到对应 worktree */
+  RESUME_WORKTREE_NOT_FOUND: (branch, available) => `\u672A\u627E\u5230\u5206\u652F "${branch}" \u5BF9\u5E94\u7684 worktree
+  \u53EF\u7528\u5206\u652F\uFF1A
+${available.map((b) => `    - ${b}`).join("\n")}`,
+  /** 追问文件加载完成 */
+  RESUME_FOLLOW_UP_FILE_LOADED: (count, path2) => `\u4ECE ${path2} \u52A0\u8F7D\u4E86 ${count} \u4E2A\u8FFD\u95EE\u4EFB\u52A1`
 };
 
 // src/constants/messages/remove.ts
@@ -537,7 +547,11 @@ var HOME_MESSAGES = {
   /** 已在主工作分支上 */
   HOME_ALREADY_ON_MAIN: (branch) => `\u5DF2\u5728\u4E3B\u5DE5\u4F5C\u5206\u652F ${branch} \u4E0A\uFF0C\u65E0\u9700\u5207\u6362`,
   /** 切换成功 */
-  HOME_SWITCH_SUCCESS: (from, to) => `\u2713 \u5DF2\u4ECE ${from} \u5207\u6362\u5230\u4E3B\u5DE5\u4F5C\u5206\u652F ${to}`
+  HOME_SWITCH_SUCCESS: (from, to) => `\u2713 \u5DF2\u4ECE ${from} \u5207\u6362\u5230\u4E3B\u5DE5\u4F5C\u5206\u652F ${to}`,
+  /** 当前在子 worktree，提示用户手动 cd 到主 worktree */
+  HOME_NOT_IN_MAIN_WORKTREE: (mainPath) => `\u5F53\u524D\u4E0D\u5728\u4E3B worktree\uFF0C\u8BF7\u5148\u5207\u6362\u5230\u4E3B worktree\uFF1A
+
+  cd ${mainPath}`
 };
 
 // src/constants/messages/tasks.ts
@@ -1074,9 +1088,29 @@ import { execSync as execSync2, execFileSync as execFileSync2 } from "child_proc
 function getGitCommonDir(cwd) {
   return execCommand("git rev-parse --git-common-dir", { cwd });
 }
+function isMainWorktree(cwd) {
+  try {
+    return getGitCommonDir(cwd) === ".git";
+  } catch {
+    return false;
+  }
+}
+function isInsideGitRepo(cwd) {
+  try {
+    execCommand("git rev-parse --is-inside-work-tree", { cwd });
+    return true;
+  } catch {
+    return false;
+  }
+}
 function getGitTopLevel(cwd) {
   return execCommand("git rev-parse --show-toplevel", { cwd });
 }
+function getMainWorktreePath(cwd) {
+  const output = execCommand("git worktree list --porcelain", { cwd });
+  const firstLine = output.split("\n")[0] || "";
+  return firstLine.replace("worktree ", "");
+}
 function getProjectName(cwd) {
   const topLevel = getGitTopLevel(cwd);
   return basename(topLevel);
@@ -2762,10 +2796,14 @@ function parseStreamEvent(event) {
 }
 
 // src/utils/task-executor.ts
-function executeClaudeTask(worktree, task, onActivity) {
+function executeClaudeTask(worktree, task, onActivity, continueSession) {
+  const args = ["-p", task, "--output-format", "stream-json", "--verbose", "--permission-mode", "bypassPermissions"];
+  if (continueSession) {
+    args.push("--continue");
+  }
   const child = spawnProcess(
     "claude",
-    ["-p", task, "--output-format", "stream-json", "--verbose", "--permission-mode", "bypassPermissions"],
+    args,
     {
       cwd: worktree.path,
       // stdin 必须设置为 'ignore'，不能用 'pipe'
@@ -2875,7 +2913,7 @@ function updateRendererStatus(renderer, index, result, startTime) {
     );
   }
 }
-async function executeWithConcurrency(worktrees, tasks, concurrency, renderer, startTime, isInterrupted, childProcesses) {
+async function executeWithConcurrency(worktrees, tasks, concurrency, renderer, startTime, isInterrupted, childProcesses, continueFlags) {
   const total = tasks.length;
   const results = new Array(total);
   let nextIndex = 0;
@@ -2891,7 +2929,7 @@ async function executeWithConcurrency(worktrees, tasks, concurrency, renderer, s
       renderer.markRunning(index);
       const handle = executeClaudeTask(wt, task, (activityText) => {
         renderer.updateActivityText(index, activityText);
-      });
+      }, continueFlags?.[index]);
       childProcesses.push(handle.child);
       handle.promise.then((result) => {
         results[index] = result;
@@ -2911,13 +2949,13 @@ async function executeWithConcurrency(worktrees, tasks, concurrency, renderer, s
     }
   });
 }
-async function executeAllParallel(worktrees, tasks, renderer, startTime, isInterrupted, childProcesses) {
+async function executeAllParallel(worktrees, tasks, renderer, startTime, isInterrupted, childProcesses, continueFlags) {
   const handles = worktrees.map((wt, index) => {
     const task = tasks[index];
     logger.info(`\u542F\u52A8\u4EFB\u52A1 ${index + 1}: ${task} (worktree: ${wt.path})`);
     const handle = executeClaudeTask(wt, task, (activityText) => {
       renderer.updateActivityText(index, activityText);
-    });
+    }, continueFlags?.[index]);
     childProcesses.push(handle.child);
     return handle;
   });
@@ -2933,8 +2971,13 @@ async function executeAllParallel(worktrees, tasks, renderer, startTime, isInter
   );
   return results;
 }
-async function executeBatchTasks(worktrees, tasks, concurrency) {
+async function executeBatchTasks(worktrees, tasks, concurrency, continueFlags) {
   const count = tasks.length;
+  if (continueFlags && continueFlags.length !== count) {
+    throw new ClawtError(
+      `continueFlags \u957F\u5EA6 (${continueFlags.length}) \u4E0E\u4EFB\u52A1\u6570 (${count}) \u4E0D\u4E00\u81F4`
+    );
+  }
   if (concurrency > 0) {
     printInfo(MESSAGES.CONCURRENCY_INFO(concurrency, count));
     printInfo("");
@@ -2968,10 +3011,10 @@ async function executeBatchTasks(worktrees, tasks, concurrency) {
     process.exit(1);
   };
   process.on("SIGINT", sigintHandler);
-  const results = concurrency > 0 ? await executeWithConcurrency(worktrees, tasks, concurrency, renderer, startTime, isInterrupted, childProcesses) : await executeAllParallel(worktrees, tasks, renderer, startTime, isInterrupted, childProcesses);
+  const results = concurrency > 0 ? await executeWithConcurrency(worktrees, tasks, concurrency, renderer, startTime, isInterrupted, childProcesses, continueFlags) : await executeAllParallel(worktrees, tasks, renderer, startTime, isInterrupted, childProcesses, continueFlags);
   renderer.stop();
   process.removeListener("SIGINT", sigintHandler);
-  if (interrupted) return;
+  if (interrupted) return [];
   const totalDurationMs = Date.now() - startTime;
   const summary = {
     total: results.length,
@@ -2981,6 +3024,7 @@ async function executeBatchTasks(worktrees, tasks, concurrency) {
     totalCostUsd: results.reduce((sum, r) => sum + (r.result?.total_cost_usd ?? 0), 0)
   };
   printTaskSummary(summary);
+  return results;
 }
 
 // src/utils/dry-run.ts
@@ -3295,6 +3339,56 @@ async function checkForUpdates(currentVersion) {
   }
 }
 
+// src/utils/json.ts
+function primitiveToString(value) {
+  if (value === void 0) {
+    return "undefined";
+  }
+  if (value === null) {
+    return "null";
+  }
+  if (typeof value === "symbol") {
+    return value.toString();
+  }
+  if (typeof value === "function") {
+    return `[Function: ${value.name || "anonymous"}]`;
+  }
+  return String(value);
+}
+function safeStringify(value, indent = 2) {
+  if (value === null || typeof value !== "object") {
+    return primitiveToString(value);
+  }
+  try {
+    const seen = /* @__PURE__ */ new WeakSet();
+    return JSON.stringify(
+      value,
+      (_key, val) => {
+        if (typeof val === "bigint") {
+          return val.toString();
+        }
+        if (typeof val === "undefined" || typeof val === "function" || typeof val === "symbol") {
+          return primitiveToString(val);
+        }
+        if (typeof val === "object" && val !== null) {
+          if (seen.has(val)) {
+            return "[Circular]";
+          }
+          seen.add(val);
+        }
+        return val;
+      },
+      indent
+    );
+  } catch {
+    try {
+      return JSON.stringify(String(value), null, indent);
+    } catch {
+      return "[Unserializable]";
+    }
+  }
+}
+
 // src/utils/validate-runner.ts
 function handleErrorClipboard(clipboardContent) {
   const success = copyToClipboard(clipboardContent);
@@ -4439,12 +4533,26 @@ var RESUME_RESOLVE_MESSAGES = {
   noMatch: MESSAGES.RESUME_NO_MATCH
 };
 function registerResumeCommand(program2) {
-  program2.command("resume").description("\u5728\u5DF2\u6709 worktree \u4E2D\u6062\u590D Claude Code \u4F1A\u8BDD\uFF08\u652F\u6301\u591A\u9009\u6279\u91CF\u6062\u590D\uFF09").option("-b, --branch <branchName>", "\u8981\u6062\u590D\u7684\u5206\u652F\u540D\uFF08\u652F\u6301\u6A21\u7CCA\u5339\u914D\uFF0C\u4E0D\u4F20\u5219\u5217\u51FA\u6240\u6709\u5206\u652F\uFF09").action(async (options) => {
+  program2.command("resume").description("\u5728\u5DF2\u6709 worktree \u4E2D\u6062\u590D Claude Code \u4F1A\u8BDD\uFF08\u652F\u6301\u591A\u9009\u6279\u91CF\u6062\u590D\uFF09").option("-b, --branch <branchName>", "\u8981\u6062\u590D\u7684\u5206\u652F\u540D\uFF08\u652F\u6301\u6A21\u7CCA\u5339\u914D\uFF0C\u4E0D\u4F20\u5219\u5217\u51FA\u6240\u6709\u5206\u652F\uFF09").option("--prompt <content>", "\u975E\u4EA4\u4E92\u5F0F\u8FFD\u95EE\uFF08\u9700\u914D\u5408 -b \u6307\u5B9A\u5206\u652F\uFF09").option("-f, --file <path>", "\u4ECE\u4EFB\u52A1\u6587\u4EF6\u6279\u91CF\u8FFD\u95EE\uFF08\u901A\u8FC7 branch \u540D\u5339\u914D\u5DF2\u6709 worktree\uFF09").option("-c, --concurrency <n>", "\u6279\u91CF\u8FFD\u95EE\u6700\u5927\u5E76\u53D1\u6570\uFF0C0 \u8868\u793A\u4E0D\u9650\u5236").action(async (options) => {
     await handleResume(options);
   });
 }
 async function handleResume(options) {
   await runPreChecks(PRE_CHECK_RESUME);
+  if (options.prompt && options.file) {
+    throw new ClawtError(MESSAGES.RESUME_PROMPT_FILE_CONFLICT);
+  }
+  if (options.prompt) {
+    if (!options.branch) {
+      throw new ClawtError(MESSAGES.RESUME_PROMPT_REQUIRES_BRANCH);
+    }
+    const worktrees2 = getProjectWorktrees();
+    const worktree = resolveWorktreeByBranch(options.branch, worktrees2);
+    return handleNonInteractiveSingleResume(worktree, options.prompt);
+  }
+  if (options.file) {
+    return handleNonInteractiveBatchResume(options.file, options);
+  }
   logger.info(`resume \u547D\u4EE4\u6267\u884C\uFF0C\u5206\u652F\u8FC7\u6EE4: ${options.branch ?? "(\u65E0)"}`);
   const worktrees = getProjectWorktrees();
   let targetWorktrees;
@@ -4468,6 +4576,35 @@ async function handleResume(options) {
     await handleBatchResume(targetWorktrees);
   }
 }
+function resolveWorktreeByBranch(branch, worktrees) {
+  const match = findExactMatch(worktrees, branch);
+  if (!match) {
+    const available = worktrees.map((wt) => wt.branch);
+    throw new ClawtError(MESSAGES.RESUME_WORKTREE_NOT_FOUND(branch, available));
+  }
+  return match;
+}
+async function handleNonInteractiveSingleResume(worktree, prompt) {
+  const hasPrevious = hasClaudeSessionHistory(worktree.path);
+  await executeBatchTasks([worktree], [prompt], 0, [hasPrevious]);
+}
+async function handleNonInteractiveBatchResume(filePath, options) {
+  const entries = loadTaskFile(filePath, { branchRequired: true });
+  printSuccess(MESSAGES.RESUME_FOLLOW_UP_FILE_LOADED(entries.length, filePath));
+  const allWorktrees = getProjectWorktrees();
+  const worktrees = [];
+  const tasks = [];
+  const continueFlags = [];
+  for (const entry of entries) {
+    const worktree = resolveWorktreeByBranch(entry.branch, allWorktrees);
+    worktrees.push(worktree);
+    tasks.push(entry.task);
+    continueFlags.push(hasClaudeSessionHistory(worktree.path));
+  }
+  const concurrency = parseConcurrency(options.concurrency, getConfigValue("maxConcurrency"));
+  logger.info(`resume \u547D\u4EE4\uFF08\u6279\u91CF\u8FFD\u95EE\u6A21\u5F0F\uFF09\u6267\u884C\uFF0C\u4EFB\u52A1\u6570: ${entries.length}\uFF0C\u5E76\u53D1\u6570: ${concurrency || "\u4E0D\u9650\u5236"}`);
+  await executeBatchTasks(worktrees, tasks, concurrency, continueFlags);
+}
 function printBatchResumePreview(worktrees, sessionMap) {
   printInfo("\u5373\u5C06\u6062\u590D\u7684\u5206\u652F\uFF1A");
   for (const wt of worktrees) {
@@ -5672,14 +5809,18 @@ function registerInitCommand(program2) {
     await handleInit(options);
   });
   initCmd.addCommand(
-    new Cmd("show").description("\u4EA4\u4E92\u5F0F\u67E5\u770B\u548C\u4FEE\u6539\u9879\u76EE\u914D\u7F6E").action(async () => {
-      await handleInitShow();
+    new Cmd("show").description("\u4EA4\u4E92\u5F0F\u67E5\u770B\u548C\u4FEE\u6539\u9879\u76EE\u914D\u7F6E\uFF08\u652F\u6301 --json \u683C\u5F0F\u8F93\u51FA\uFF09").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA").action(async (options) => {
+      await handleInitShow(options);
     })
   );
 }
-async function handleInitShow() {
+async function handleInitShow(options) {
   await runPreChecks({ requireMainWorktree: true, requireProjectConfig: true });
   const config2 = requireProjectConfig();
+  if (options.json) {
+    printInitShowAsJson(config2);
+    return;
+  }
   logger.info("init show \u547D\u4EE4\u6267\u884C\uFF0C\u8FDB\u5165\u4EA4\u4E92\u5F0F\u9879\u76EE\u914D\u7F6E");
   const { key, newValue } = await interactiveConfigEditor(
     config2,
@@ -5690,6 +5831,9 @@ async function handleInitShow() {
   saveProjectConfig(updatedConfig);
   printSuccess(MESSAGES.INIT_SET_SUCCESS(key, String(newValue)));
 }
+function printInitShowAsJson(config2) {
+  console.log(safeStringify({ ...config2 }));
+}
 async function handleInit(options) {
   await runPreChecks({ requireMainWorktree: true });
   const existingConfig = loadProjectConfig();
@@ -5717,7 +5861,16 @@ function registerHomeCommand(program2) {
   });
 }
 async function handleHome() {
-  await runPreChecks({ requireMainWorktree: true, requireHead: true, requireProjectConfig: true, requireMainBranchExists: true });
+  if (!isInsideGitRepo()) {
+    printError(MESSAGES.NOT_MAIN_WORKTREE);
+    return;
+  }
+  if (!isMainWorktree()) {
+    const mainPath = getMainWorktreePath();
+    printHint(MESSAGES.HOME_NOT_IN_MAIN_WORKTREE(mainPath));
+    return;
+  }
+  await runPreChecks({ requireHead: true, requireProjectConfig: true, requireMainBranchExists: true });
   const mainBranch = getMainWorkBranch();
   const currentBranch = getCurrentBranch();
   if (currentBranch === mainBranch) {

package/dist/postinstall.js

@@ -302,7 +302,17 @@ ${branches.map((b) => `    - ${b}`).join("\n")}`,
   /** 批量 resume 非 macOS 平台提示 */
   RESUME_ALL_PLATFORM_UNSUPPORTED: "\u6279\u91CF resume \u76EE\u524D\u4EC5\u652F\u6301 macOS \u5E73\u53F0\uFF08\u901A\u8FC7 AppleScript \u6253\u5F00\u7EC8\u7AEF Tab\uFF09",
   /** 批量 resume 无匹配分支提示 */
-  RESUME_ALL_NO_MATCH: (keyword) => `\u672A\u627E\u5230\u4E0E "${keyword}" \u5339\u914D\u7684\u5206\u652F`
+  RESUME_ALL_NO_MATCH: (keyword) => `\u672A\u627E\u5230\u4E0E "${keyword}" \u5339\u914D\u7684\u5206\u652F`,
+  /** --prompt 必须配合 -b 指定目标分支 */
+  RESUME_PROMPT_REQUIRES_BRANCH: "--prompt \u5FC5\u987B\u914D\u5408 -b \u6307\u5B9A\u76EE\u6807\u5206\u652F",
+  /** --prompt 和 -f 不能同时使用 */
+  RESUME_PROMPT_FILE_CONFLICT: "--prompt \u548C -f \u4E0D\u80FD\u540C\u65F6\u4F7F\u7528",
+  /** 未找到对应 worktree */
+  RESUME_WORKTREE_NOT_FOUND: (branch, available) => `\u672A\u627E\u5230\u5206\u652F "${branch}" \u5BF9\u5E94\u7684 worktree
+  \u53EF\u7528\u5206\u652F\uFF1A
+${available.map((b) => `    - ${b}`).join("\n")}`,
+  /** 追问文件加载完成 */
+  RESUME_FOLLOW_UP_FILE_LOADED: (count, path) => `\u4ECE ${path} \u52A0\u8F7D\u4E86 ${count} \u4E2A\u8FFD\u95EE\u4EFB\u52A1`
 };
 
 // src/constants/messages/remove.ts
@@ -514,7 +524,11 @@ var HOME_MESSAGES = {
   /** 已在主工作分支上 */
   HOME_ALREADY_ON_MAIN: (branch) => `\u5DF2\u5728\u4E3B\u5DE5\u4F5C\u5206\u652F ${branch} \u4E0A\uFF0C\u65E0\u9700\u5207\u6362`,
   /** 切换成功 */
-  HOME_SWITCH_SUCCESS: (from, to) => `\u2713 \u5DF2\u4ECE ${from} \u5207\u6362\u5230\u4E3B\u5DE5\u4F5C\u5206\u652F ${to}`
+  HOME_SWITCH_SUCCESS: (from, to) => `\u2713 \u5DF2\u4ECE ${from} \u5207\u6362\u5230\u4E3B\u5DE5\u4F5C\u5206\u652F ${to}`,
+  /** 当前在子 worktree，提示用户手动 cd 到主 worktree */
+  HOME_NOT_IN_MAIN_WORKTREE: (mainPath) => `\u5F53\u524D\u4E0D\u5728\u4E3B worktree\uFF0C\u8BF7\u5148\u5207\u6362\u5230\u4E3B worktree\uFF1A
+
+  cd ${mainPath}`
 };
 
 // src/constants/messages/tasks.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawt",
-  "version": "3.5.3",
+  "version": "3.6.1",
   "description": "本地并行执行多个Claude Code Agent任务，融合 Git Worktree 与 Claude Code CLI 的命令行工具",
   "type": "module",
   "main": "dist/index.js",

package/src/commands/home.ts

@@ -5,9 +5,13 @@ import {
   ensureOnMainWorkBranch,
   getCurrentBranch,
   getMainWorkBranch,
+  isMainWorktree,
+  isInsideGitRepo,
+  getMainWorktreePath,
   printSuccess,
   printInfo,
-  guardMainWorkBranchExists,
+  printHint,
+  printError,
 } from '../utils/index.js';
 
 /**
@@ -25,9 +29,27 @@ export function registerHomeCommand(program: Command): void {
 
 /**
  * 执行 home 命令：切换回主工作分支
+ * 三种场景：
+ * 1. 不在 git 仓库中 → 报错
+ * 2. 在子 worktree 中 → 输出提示和 cd 命令
+ * 3. 在主 worktree 中 → 切换到主工作分支
  */
 async function handleHome(): Promise<void> {
-  await runPreChecks({ requireMainWorktree: true, requireHead: true, requireProjectConfig: true, requireMainBranchExists: true });
+  // 场景 1：不在 git 仓库中，直接报错
+  if (!isInsideGitRepo()) {
+    printError(MESSAGES.NOT_MAIN_WORKTREE);
+    return;
+  }
+
+  // 场景 2：在子 worktree 中，输出 cd 提示
+  if (!isMainWorktree()) {
+    const mainPath = getMainWorktreePath();
+    printHint(MESSAGES.HOME_NOT_IN_MAIN_WORKTREE(mainPath));
+    return;
+  }
+
+  // 场景 3：在主 worktree 中，切换到主工作分支
+  await runPreChecks({ requireHead: true, requireProjectConfig: true, requireMainBranchExists: true });
 
   const mainBranch = getMainWorkBranch();
   const currentBranch = getCurrentBranch();

package/src/commands/init.ts

@@ -2,7 +2,7 @@ import type { Command } from 'commander';
 import { Command as Cmd } from 'commander';
 import { logger } from '../logger/index.js';
 import { MESSAGES, PROJECT_CONFIG_DEFINITIONS } from '../constants/index.js';
-import type { InitOptions, ProjectConfig } from '../types/index.js';
+import type { InitOptions, InitShowOptions, ProjectConfig } from '../types/index.js';
 import {
   runPreChecks,
   validateHeadExists,
@@ -12,6 +12,7 @@ import {
   requireProjectConfig,
   printSuccess,
   interactiveConfigEditor,
+  safeStringify,
 } from '../utils/index.js';
 
 /**
@@ -27,23 +28,31 @@ export function registerInitCommand(program: Command): void {
       await handleInit(options);
     });
 
-  // 注册 show 子命令：交互式查看和修改项目配置
+  // 注册 show 子命令：交互式查看和修改项目配置（支持 --json 格式输出）
   initCmd.addCommand(
     new Cmd('show')
-      .description('交互式查看和修改项目配置')
-      .action(async () => {
-        await handleInitShow();
+      .description('交互式查看和修改项目配置（支持 --json 格式输出）')
+      .option('--json', '以 JSON 格式输出')
+      .action(async (options: InitShowOptions) => {
+        await handleInitShow(options);
       }),
   );
 }
 
 /**
  * 处理 init show 子命令：交互式面板展示和修改项目配置
+ * @param {InitShowOptions} options - 子命令选项
  */
-async function handleInitShow(): Promise<void> {
+async function handleInitShow(options: InitShowOptions): Promise<void> {
   await runPreChecks({ requireMainWorktree: true, requireProjectConfig: true });
   const config = requireProjectConfig();
 
+  // --json 模式：直接输出 JSON 格式配置，跳过交互式流程
+  if (options.json) {
+    printInitShowAsJson(config);
+    return;
+  }
+
   logger.info('init show 命令执行，进入交互式项目配置');
 
   const { key, newValue } = await interactiveConfigEditor(
@@ -59,6 +68,14 @@ async function handleInitShow(): Promise<void> {
   printSuccess(MESSAGES.INIT_SET_SUCCESS(key as string, String(newValue)));
 }
 
+/**
+ * 以 JSON 格式输出项目配置
+ * @param {ProjectConfig} config - 项目配置对象
+ */
+function printInitShowAsJson(config: ProjectConfig): void {
+  console.log(safeStringify({ ...config }));
+}
+
 /**
  * 执行 init 命令的核心逻辑
  * 无论是否已初始化，始终执行设置/切换主工作分支