clawt 2.9.1 → 2.10.1

package/dist/postinstall.js

@@ -10,6 +10,248 @@ var LOGS_DIR = join(CLAWT_HOME, "logs");
 var WORKTREES_DIR = join(CLAWT_HOME, "worktrees");
 var VALIDATE_SNAPSHOTS_DIR = join(CLAWT_HOME, "validate-snapshots");
 
+// src/constants/messages/common.ts
+var COMMON_MESSAGES = {
+  /** 不在主 worktree 根目录 */
+  NOT_MAIN_WORKTREE: "\u8BF7\u5728\u4E3B worktree \u7684\u6839\u76EE\u5F55\u4E0B\u6267\u884C clawt",
+  /** Git 未安装 */
+  GIT_NOT_INSTALLED: "Git \u672A\u5B89\u88C5\u6216\u4E0D\u5728 PATH \u4E2D\uFF0C\u8BF7\u5148\u5B89\u88C5 Git",
+  /** Claude Code CLI 未安装 */
+  CLAUDE_NOT_INSTALLED: "Claude Code CLI \u672A\u5B89\u88C5\uFF0C\u8BF7\u5148\u5B89\u88C5\uFF1Anpm install -g @anthropic-ai/claude-code",
+  /** 分支已存在 */
+  BRANCH_EXISTS: (name) => `\u5206\u652F ${name} \u5DF2\u5B58\u5728\uFF0C\u65E0\u6CD5\u521B\u5EFA`,
+  /** 分支名清理后为空 */
+  BRANCH_NAME_EMPTY: (original) => `\u5206\u652F\u540D "${original}" \u4E2D\u4E0D\u5305\u542B\u5408\u6CD5\u5B57\u7B26\uFF0C\u65E0\u6CD5\u521B\u5EFA\u5206\u652F`,
+  /** 分支名被转换 */
+  BRANCH_SANITIZED: (original, sanitized) => `\u5206\u652F\u540D\u5DF2\u8F6C\u6362: ${original} \u2192 ${sanitized}`,
+  /** worktree 创建成功 */
+  WORKTREE_CREATED: (count) => `\u2713 \u5DF2\u521B\u5EFA ${count} \u4E2A worktree`,
+  /** worktree 移除成功 */
+  WORKTREE_REMOVED: (path) => `\u2713 \u5DF2\u79FB\u9664 worktree: ${path}`,
+  /** 没有 worktree */
+  NO_WORKTREES: "(\u65E0 worktree)",
+  /** 目标 worktree 不存在 */
+  WORKTREE_NOT_FOUND: (name) => `worktree ${name} \u4E0D\u5B58\u5728`,
+  /** 主 worktree 有未提交更改 */
+  MAIN_WORKTREE_DIRTY: "\u4E3B worktree \u6709\u672A\u63D0\u4EA4\u7684\u66F4\u6539\uFF0C\u8BF7\u5148\u5904\u7406",
+  /** 目标 worktree 无更改 */
+  TARGET_WORKTREE_CLEAN: "\u8BE5 worktree \u7684\u5206\u652F\u4E0A\u6CA1\u6709\u4EFB\u4F55\u66F4\u6539\uFF0C\u65E0\u9700\u9A8C\u8BC1",
+  /** 用户取消破坏性操作 */
+  DESTRUCTIVE_OP_CANCELLED: "\u5DF2\u53D6\u6D88\u64CD\u4F5C",
+  /** 请提供提交信息 */
+  COMMIT_MESSAGE_REQUIRED: "\u8BF7\u63D0\u4F9B\u63D0\u4EA4\u4FE1\u606F\uFF08-m \u53C2\u6570\uFF09",
+  /** 配置文件损坏，已重新生成默认配置 */
+  CONFIG_CORRUPTED: "\u914D\u7F6E\u6587\u4EF6\u635F\u574F\u6216\u65E0\u6CD5\u89E3\u6790\uFF0C\u5DF2\u91CD\u65B0\u751F\u6210\u9ED8\u8BA4\u914D\u7F6E",
+  /** worktree 状态获取失败 */
+  WORKTREE_STATUS_UNAVAILABLE: "(\u72B6\u6001\u4E0D\u53EF\u7528)",
+  /** 分隔线 */
+  SEPARATOR: "\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500",
+  /** 粗分隔线 */
+  DOUBLE_SEPARATOR: "\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550"
+};
+
+// src/constants/messages/run.ts
+var RUN_MESSAGES = {
+  /** 分支已存在时提示使用 resume */
+  BRANCH_EXISTS_USE_RESUME: (name) => `\u5206\u652F ${name} \u5DF2\u5B58\u5728\uFF0C\u8BF7\u4F7F\u7528 clawt resume -b ${name} \u6062\u590D\u4F1A\u8BDD`,
+  /** 检测到用户中断 */
+  INTERRUPTED: "\u68C0\u6D4B\u5230\u9000\u51FA\u6307\u4EE4\uFF0C\u5DF2\u505C\u6B62 Claude Code \u4EFB\u52A1",
+  /** 中断后自动清理完成 */
+  INTERRUPT_AUTO_CLEANED: (count) => `\u2713 \u5DF2\u81EA\u52A8\u6E05\u7406 ${count} \u4E2A worktree \u548C\u5BF9\u5E94\u5206\u652F`,
+  /** 中断后手动确认清理 */
+  INTERRUPT_CONFIRM_CLEANUP: "\u662F\u5426\u79FB\u9664\u521A\u521A\u521B\u5EFA\u7684 worktree \u548C\u5BF9\u5E94\u5206\u652F\uFF1F",
+  /** 中断后清理完成 */
+  INTERRUPT_CLEANED: (count) => `\u2713 \u5DF2\u6E05\u7406 ${count} \u4E2A worktree \u548C\u5BF9\u5E94\u5206\u652F`,
+  /** 中断后保留 worktree */
+  INTERRUPT_KEPT: "\u5DF2\u4FDD\u7559 worktree\uFF0C\u53EF\u7A0D\u540E\u4F7F\u7528 clawt remove \u624B\u52A8\u6E05\u7406"
+};
+
+// src/constants/messages/create.ts
+var CREATE_MESSAGES = {
+  /** 创建数量参数无效 */
+  INVALID_COUNT: (value) => `\u65E0\u6548\u7684\u521B\u5EFA\u6570\u91CF: "${value}"\uFF0C\u8BF7\u8F93\u5165\u6B63\u6574\u6570`
+};
+
+// src/constants/messages/merge.ts
+var MERGE_MESSAGES = {
+  /** merge 成功 */
+  MERGE_SUCCESS: (branch, message, pushed) => `\u2713 \u5206\u652F ${branch} \u5DF2\u6210\u529F\u5408\u5E76\u5230\u5F53\u524D\u5206\u652F
+  \u63D0\u4EA4\u4FE1\u606F: ${message}${pushed ? "\n  \u5DF2\u63A8\u9001\u5230\u8FDC\u7A0B\u4ED3\u5E93" : ""}`,
+  /** merge 成功（无提交信息，目标 worktree 已提交过） */
+  MERGE_SUCCESS_NO_MESSAGE: (branch, pushed) => `\u2713 \u5206\u652F ${branch} \u5DF2\u6210\u529F\u5408\u5E76\u5230\u5F53\u524D\u5206\u652F${pushed ? "\n  \u5DF2\u63A8\u9001\u5230\u8FDC\u7A0B\u4ED3\u5E93" : ""}`,
+  /** merge 冲突 */
+  MERGE_CONFLICT: "\u5408\u5E76\u5B58\u5728\u51B2\u7A81\uFF0C\u8BF7\u624B\u52A8\u5904\u7406\uFF1A\n  \u89E3\u51B3\u51B2\u7A81\u540E\u6267\u884C git add . && git merge --continue",
+  /** merge 后清理 worktree 和分支成功 */
+  WORKTREE_CLEANED: (branch) => `\u2713 \u5DF2\u6E05\u7406 worktree \u548C\u5206\u652F: ${branch}`,
+  /** 目标 worktree 有未提交修改但未指定 -m */
+  TARGET_WORKTREE_DIRTY_NO_MESSAGE: "\u76EE\u6807 worktree \u6709\u672A\u63D0\u4EA4\u7684\u4FEE\u6539\uFF0C\u8BF7\u901A\u8FC7 -m \u53C2\u6570\u63D0\u4F9B\u63D0\u4EA4\u4FE1\u606F",
+  /** 目标 worktree 既干净又无本地提交 */
+  TARGET_WORKTREE_NO_CHANGES: "\u76EE\u6807 worktree \u6CA1\u6709\u4EFB\u4F55\u53EF\u5408\u5E76\u7684\u53D8\u66F4\uFF08\u5DE5\u4F5C\u533A\u5E72\u51C0\u4E14\u65E0\u672C\u5730\u63D0\u4EA4\uFF09",
+  /** merge 命令检测到 validate 状态的提示 */
+  MERGE_VALIDATE_STATE_HINT: (branch) => `\u4E3B worktree \u53EF\u80FD\u5B58\u5728 validate \u6B8B\u7559\u72B6\u6001\uFF0C\u53EF\u5148\u6267\u884C clawt validate -b ${branch} --clean \u6E05\u7406`,
+  /** merge 检测到 auto-save 提交，提示用户是否压缩 */
+  MERGE_SQUASH_PROMPT: "\u68C0\u6D4B\u5230 sync \u4EA7\u751F\u7684\u4E34\u65F6\u63D0\u4EA4\uFF0C\u662F\u5426\u5C06\u6240\u6709\u63D0\u4EA4\u538B\u7F29\u4E3A\u4E00\u4E2A\uFF1F\n  \u538B\u7F29\u540E\u53D8\u66F4\u5C06\u4FDD\u7559\u5728\u76EE\u6807worktree\u7684\u6682\u5B58\u533A\uFF0C\u9700\u8981\u91CD\u65B0\u63D0\u4EA4\uFF08\u53EF\u4F7F\u7528 Claude Code Cli\u6216\u5176\u4ED6\u5DE5\u5177\u751F\u6210\u63D0\u4EA4\u4FE1\u606F\uFF09",
+  /** squash 完成且通过 -m 直接提交后的提示 */
+  MERGE_SQUASH_COMMITTED: (branch) => `\u2713 \u5DF2\u5C06\u5206\u652F ${branch} \u7684\u6240\u6709\u63D0\u4EA4\u538B\u7F29\u4E3A\u4E00\u4E2A`,
+  /** squash 完成但未提供 -m，提示用户自行提交 */
+  MERGE_SQUASH_PENDING: (worktreePath, branch) => `\u2713 \u5DF2\u5C06\u6240\u6709\u63D0\u4EA4\u538B\u7F29\u5230\u6682\u5B58\u533A
+  \u8BF7\u5728\u76EE\u6807 worktree \u4E2D\u63D0\u4EA4\u540E\u91CD\u65B0\u6267\u884C merge\uFF1A
+  cd ${worktreePath}
+  \u63D0\u4EA4\u5B8C\u6210\u540E\u6267\u884C\uFF1Aclawt merge -b ${branch}`,
+  /** merge 后 pull 冲突 */
+  PULL_CONFLICT: "\u81EA\u52A8 pull \u65F6\u53D1\u751F\u51B2\u7A81\uFF0Cmerge \u5DF2\u5B8C\u6210\u4F46\u8FDC\u7A0B\u540C\u6B65\u5931\u8D25\n  \u8BF7\u624B\u52A8\u89E3\u51B3\u51B2\u7A81\uFF1A\n  \u89E3\u51B3\u51B2\u7A81\u540E\u6267\u884C git add . && git commit\n  \u7136\u540E\u6267\u884C git push \u63A8\u9001\u5230\u8FDC\u7A0B",
+  /** push 失败 */
+  PUSH_FAILED: "\u81EA\u52A8 push \u5931\u8D25\uFF0Cmerge \u548C pull \u5DF2\u5B8C\u6210\n  \u8BF7\u624B\u52A8\u6267\u884C git push",
+  /** merge 无可用 worktree */
+  MERGE_NO_WORKTREES: "\u5F53\u524D\u9879\u76EE\u6CA1\u6709\u53EF\u7528\u7684 worktree\uFF0C\u8BF7\u5148\u901A\u8FC7 clawt run \u6216 clawt create \u521B\u5EFA",
+  /** merge 模糊匹配无结果，列出可用分支 */
+  MERGE_NO_MATCH: (name, branches) => `\u672A\u627E\u5230\u4E0E "${name}" \u5339\u914D\u7684\u5206\u652F
+  \u53EF\u7528\u5206\u652F\uFF1A
+${branches.map((b) => `    - ${b}`).join("\n")}`,
+  /** merge 交互选择提示 */
+  MERGE_SELECT_BRANCH: "\u8BF7\u9009\u62E9\u8981\u5408\u5E76\u7684\u5206\u652F",
+  /** merge 模糊匹配到多个结果提示 */
+  MERGE_MULTIPLE_MATCHES: (name) => `"${name}" \u5339\u914D\u5230\u591A\u4E2A\u5206\u652F\uFF0C\u8BF7\u9009\u62E9\uFF1A`
+};
+
+// src/constants/messages/validate.ts
+var VALIDATE_MESSAGES = {
+  /** validate 成功 */
+  VALIDATE_SUCCESS: (branch) => `\u2713 \u5DF2\u5C06\u5206\u652F ${branch} \u7684\u53D8\u66F4\u5E94\u7528\u5230\u4E3B worktree
+  \u53EF\u4EE5\u5F00\u59CB\u9A8C\u8BC1\u4E86`,
+  /** 增量 validate 成功提示 */
+  INCREMENTAL_VALIDATE_SUCCESS: (branch) => `\u2713 \u5DF2\u5C06\u5206\u652F ${branch} \u7684\u6700\u65B0\u53D8\u66F4\u5E94\u7528\u5230\u4E3B worktree\uFF08\u589E\u91CF\u6A21\u5F0F\uFF09
+  \u6682\u5B58\u533A = \u4E0A\u6B21\u5FEB\u7167\uFF0C\u5DE5\u4F5C\u76EE\u5F55 = \u6700\u65B0\u53D8\u66F4`,
+  /** 增量 validate 降级为全量模式提示 */
+  INCREMENTAL_VALIDATE_FALLBACK: "\u589E\u91CF\u5BF9\u6BD4\u5931\u8D25\uFF0C\u5DF2\u964D\u7EA7\u4E3A\u5168\u91CF\u6A21\u5F0F",
+  /** validate 状态已清理 */
+  VALIDATE_CLEANED: (branch) => `\u2713 \u5206\u652F ${branch} \u7684 validate \u72B6\u6001\u5DF2\u6E05\u7406`,
+  /** validate patch apply 失败，提示用户同步主分支 */
+  VALIDATE_PATCH_APPLY_FAILED: (branch) => `\u53D8\u66F4\u8FC1\u79FB\u5931\u8D25\uFF1A\u76EE\u6807\u5206\u652F\u4E0E\u4E3B\u5206\u652F\u5DEE\u5F02\u8FC7\u5927
+  \u8BF7\u5148\u6267\u884C clawt sync -b ${branch} \u540C\u6B65\u4E3B\u5206\u652F\u540E\u91CD\u8BD5`,
+  /** validate 无可用 worktree */
+  VALIDATE_NO_WORKTREES: "\u5F53\u524D\u9879\u76EE\u6CA1\u6709\u53EF\u7528\u7684 worktree\uFF0C\u8BF7\u5148\u901A\u8FC7 clawt run \u6216 clawt create \u521B\u5EFA",
+  /** validate 模糊匹配无结果，列出可用分支 */
+  VALIDATE_NO_MATCH: (name, branches) => `\u672A\u627E\u5230\u4E0E "${name}" \u5339\u914D\u7684\u5206\u652F
+  \u53EF\u7528\u5206\u652F\uFF1A
+${branches.map((b) => `    - ${b}`).join("\n")}`,
+  /** validate 交互选择提示 */
+  VALIDATE_SELECT_BRANCH: "\u8BF7\u9009\u62E9\u8981\u9A8C\u8BC1\u7684\u5206\u652F",
+  /** validate 模糊匹配到多个结果提示 */
+  VALIDATE_MULTIPLE_MATCHES: (name) => `"${name}" \u5339\u914D\u5230\u591A\u4E2A\u5206\u652F\uFF0C\u8BF7\u9009\u62E9\uFF1A`
+};
+
+// src/constants/messages/sync.ts
+var SYNC_MESSAGES = {
+  /** sync 自动保存未提交变更 */
+  SYNC_AUTO_COMMITTED: (branch) => `\u5DF2\u81EA\u52A8\u4FDD\u5B58 ${branch} \u5206\u652F\u7684\u672A\u63D0\u4EA4\u53D8\u66F4`,
+  /** sync 开始合并 */
+  SYNC_MERGING: (targetBranch, mainBranch) => `\u6B63\u5728\u5C06 ${mainBranch} \u5408\u5E76\u5230 ${targetBranch} ...`,
+  /** sync 成功 */
+  SYNC_SUCCESS: (targetBranch, mainBranch) => `\u2713 \u5DF2\u5C06 ${mainBranch} \u7684\u6700\u65B0\u4EE3\u7801\u540C\u6B65\u5230 ${targetBranch}`,
+  /** sync 冲突 */
+  SYNC_CONFLICT: (worktreePath) => `\u5408\u5E76\u5B58\u5728\u51B2\u7A81\uFF0C\u8BF7\u8FDB\u5165\u76EE\u6807 worktree \u624B\u52A8\u89E3\u51B3\uFF1A
+  cd ${worktreePath}
+  \u89E3\u51B3\u51B2\u7A81\u540E\u6267\u884C git add . && git merge --continue
+  clawt validate -b <branch> \u9A8C\u8BC1\u53D8\u66F4`,
+  /** sync 无可用 worktree */
+  SYNC_NO_WORKTREES: "\u5F53\u524D\u9879\u76EE\u6CA1\u6709\u53EF\u7528\u7684 worktree\uFF0C\u8BF7\u5148\u901A\u8FC7 clawt run \u6216 clawt create \u521B\u5EFA",
+  /** sync 模糊匹配无结果，列出可用分支 */
+  SYNC_NO_MATCH: (name, branches) => `\u672A\u627E\u5230\u4E0E "${name}" \u5339\u914D\u7684\u5206\u652F
+  \u53EF\u7528\u5206\u652F\uFF1A
+${branches.map((b) => `    - ${b}`).join("\n")}`,
+  /** sync 交互选择提示 */
+  SYNC_SELECT_BRANCH: "\u8BF7\u9009\u62E9\u8981\u540C\u6B65\u7684\u5206\u652F",
+  /** sync 模糊匹配到多个结果提示 */
+  SYNC_MULTIPLE_MATCHES: (name) => `"${name}" \u5339\u914D\u5230\u591A\u4E2A\u5206\u652F\uFF0C\u8BF7\u9009\u62E9\uFF1A`
+};
+
+// src/constants/messages/resume.ts
+var RESUME_MESSAGES = {
+  /** resume 无可用 worktree */
+  RESUME_NO_WORKTREES: "\u5F53\u524D\u9879\u76EE\u6CA1\u6709\u53EF\u7528\u7684 worktree\uFF0C\u8BF7\u5148\u901A\u8FC7 clawt run \u6216 clawt create \u521B\u5EFA",
+  /** resume 模糊匹配无结果，列出可用分支 */
+  RESUME_NO_MATCH: (name, branches) => `\u672A\u627E\u5230\u4E0E "${name}" \u5339\u914D\u7684\u5206\u652F
+  \u53EF\u7528\u5206\u652F\uFF1A
+${branches.map((b) => `    - ${b}`).join("\n")}`,
+  /** resume 交互选择提示 */
+  RESUME_SELECT_BRANCH: "\u8BF7\u9009\u62E9\u8981\u6062\u590D\u7684\u5206\u652F",
+  /** resume 模糊匹配到多个结果提示 */
+  RESUME_MULTIPLE_MATCHES: (name) => `"${name}" \u5339\u914D\u5230\u591A\u4E2A\u5206\u652F\uFF0C\u8BF7\u9009\u62E9\uFF1A`
+};
+
+// src/constants/messages/remove.ts
+var REMOVE_MESSAGES = {
+  /** remove 无可用 worktree */
+  REMOVE_NO_WORKTREES: "\u5F53\u524D\u9879\u76EE\u6CA1\u6709\u53EF\u7528\u7684 worktree\uFF0C\u65E0\u9700\u79FB\u9664",
+  /** remove 多选交互提示 */
+  REMOVE_SELECT_BRANCH: "\u8BF7\u9009\u62E9\u8981\u79FB\u9664\u7684\u5206\u652F\uFF08\u7A7A\u683C\u9009\u62E9\uFF0C\u56DE\u8F66\u786E\u8BA4\uFF09",
+  /** remove 模糊匹配到多个结果提示 */
+  REMOVE_MULTIPLE_MATCHES: (name) => `"${name}" \u5339\u914D\u5230\u591A\u4E2A\u5206\u652F\uFF0C\u8BF7\u9009\u62E9\u8981\u79FB\u9664\u7684\uFF08\u7A7A\u683C\u9009\u62E9\uFF0C\u56DE\u8F66\u786E\u8BA4\uFF09\uFF1A`,
+  /** remove 模糊匹配无结果，列出可用分支 */
+  REMOVE_NO_MATCH: (name, branches) => `\u672A\u627E\u5230\u4E0E "${name}" \u5339\u914D\u7684\u5206\u652F
+  \u53EF\u7528\u5206\u652F\uFF1A
+${branches.map((b) => `    - ${b}`).join("\n")}`,
+  /** 批量移除部分失败 */
+  REMOVE_PARTIAL_FAILURE: (failures) => `\u4EE5\u4E0B worktree \u79FB\u9664\u5931\u8D25\uFF1A
+${failures.map((f) => `  \u2717 ${f.path}: ${f.error}`).join("\n")}`
+};
+
+// src/constants/messages/reset.ts
+var RESET_MESSAGES = {
+  /** reset 成功 */
+  RESET_SUCCESS: "\u2713 \u4E3B worktree \u5DE5\u4F5C\u533A\u548C\u6682\u5B58\u533A\u5DF2\u91CD\u7F6E",
+  /** reset 时工作区和暂存区已干净 */
+  RESET_ALREADY_CLEAN: "\u4E3B worktree \u5DE5\u4F5C\u533A\u548C\u6682\u5B58\u533A\u5DF2\u662F\u5E72\u51C0\u72B6\u6001\uFF0C\u65E0\u9700\u91CD\u7F6E"
+};
+
+// src/constants/messages/config.ts
+var CONFIG_CMD_MESSAGES = {
+  /** 配置已恢复为默认值 */
+  CONFIG_RESET_SUCCESS: "\u2713 \u914D\u7F6E\u5DF2\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C"
+};
+
+// src/constants/messages/status.ts
+var STATUS_MESSAGES = {
+  /** status 命令标题 */
+  STATUS_TITLE: (projectName) => `\u9879\u76EE\u72B6\u6001\u603B\u89C8: ${projectName}`,
+  /** status 主 worktree 区块标题 */
+  STATUS_MAIN_SECTION: "\u4E3B Worktree",
+  /** status worktrees 区块标题 */
+  STATUS_WORKTREES_SECTION: "Worktree \u5217\u8868",
+  /** status 快照区块标题 */
+  STATUS_SNAPSHOTS_SECTION: "\u672A\u6E05\u7406\u7684 Validate \u5FEB\u7167",
+  /** status 无 worktree */
+  STATUS_NO_WORKTREES: "(\u65E0\u6D3B\u8DC3 worktree)",
+  /** status 无未清理快照 */
+  STATUS_NO_SNAPSHOTS: "(\u65E0\u672A\u6E05\u7406\u7684\u5FEB\u7167)",
+  /** status 变更状态：已提交 */
+  STATUS_CHANGE_COMMITTED: "\u5DF2\u63D0\u4EA4",
+  /** status 变更状态：未提交修改 */
+  STATUS_CHANGE_UNCOMMITTED: "\u672A\u63D0\u4EA4\u4FEE\u6539",
+  /** status 变更状态：合并冲突 */
+  STATUS_CHANGE_CONFLICT: "\u5408\u5E76\u51B2\u7A81",
+  /** status 变更状态：无变更 */
+  STATUS_CHANGE_CLEAN: "\u65E0\u53D8\u66F4",
+  /** status 快照对应 worktree 已不存在 */
+  STATUS_SNAPSHOT_ORPHANED: "(\u5BF9\u5E94 worktree \u5DF2\u4E0D\u5B58\u5728)"
+};
+
+// src/constants/messages/index.ts
+var MESSAGES = {
+  ...COMMON_MESSAGES,
+  ...RUN_MESSAGES,
+  ...CREATE_MESSAGES,
+  ...MERGE_MESSAGES,
+  ...VALIDATE_MESSAGES,
+  ...SYNC_MESSAGES,
+  ...RESUME_MESSAGES,
+  ...REMOVE_MESSAGES,
+  ...RESET_MESSAGES,
+  ...CONFIG_CMD_MESSAGES,
+  ...STATUS_MESSAGES
+};
+
 // src/constants/config.ts
 var CONFIG_DEFINITIONS = {
   autoDeleteBranch: {

package/docs/spec.md

@@ -25,6 +25,7 @@
   - [5.11 在已有 Worktree 中恢复会话](#511-在已有-worktree-中恢复会话)
   - [5.12 将主分支代码同步到目标 Worktree](#512-将主分支代码同步到目标-worktree)
   - [5.13 重置主 Worktree 工作区和暂存区](#513-重置主-worktree-工作区和暂存区)
+  - [5.14 项目全局状态总览](#514-项目全局状态总览)
 - [6. 错误处理规范](#6-错误处理规范)
 - [7. 非功能性需求](#7-非功能性需求)
   - [7.1 性能](#71-性能)
@@ -170,13 +171,14 @@ git show-ref --verify refs/heads/<branchName> 2>/dev/null
 | `clawt run`           | 批量创建 worktree + 启动 Claude Code 执行任务    | 5.2      |
 | `clawt validate`      | 在主 worktree 验证某个 worktree 分支的变更        | 5.4      |
 | `clawt merge`         | 合并某个已验证的 worktree 分支到主 worktree       | 5.6      |
-| `clawt remove`        | 移除 worktree（支持单个/批量/全部）               | 5.5      |
+| `clawt remove`        | 移除 worktree（支持模糊匹配/多选/全部）             | 5.5      |
 | `clawt list`          | 列出当前项目所有 worktree（支持 `--json` 格式输出） | 5.8      |
 | `clawt config`        | 查看全局配置                                     | 5.10     |
 | `clawt config reset`  | 将配置恢复为默认值                                | 5.10     |
 | `clawt resume`        | 在已有 worktree 中恢复 Claude Code 交互式会话      | 5.11     |
 | `clawt sync`          | 将主分支最新代码同步到目标 worktree                  | 5.12     |
 | `clawt reset`         | 重置主 worktree 工作区和暂存区                       | 5.13     |
+| `clawt status`        | 显示项目全局状态总览（支持 `--json` 格式输出）          | 5.14     |
 
 **全局选项：**
 
@@ -572,29 +574,42 @@ git apply --cached < patch
 **命令：**
 
 ```bash
-clawt remove [options]
+# 移除当前项目所有 worktree
+clawt remove --all
+
+# 指定分支名（支持模糊匹配）
+clawt remove -b <branchName>
+
+# 不指定参数（列出所有分支供多选）
+clawt remove
 ```
 
 **参数：**
 
-| 参数      | 说明                                                       |
-| --------- | ---------------------------------------------------------- |
-| `--all`   | 移除当前项目 (`~/.clawt/worktrees/<project>/`) 下所有 worktree |
-| `-b <branchName>` | 移除匹配 branchName 或 branchName-* 的 worktree      |
+| 参数      | 必填 | 说明                                                                   |
+| --------- | ---- | ---------------------------------------------------------------------- |
+| `--all`   | 否   | 移除当前项目 (`~/.clawt/worktrees/<project>/`) 下所有 worktree           |
+| `-b`      | 否   | 指定分支名（支持模糊匹配，不传则列出所有分支供多选）                       |
 
-**三种移除粒度：**
-
-| 粒度 | 命令示例                                 | 移除范围                                                      |
-| ---- | ---------------------------------------- | ------------------------------------------------------------- |
-| 全部 | `clawt remove --all`                     | `~/.clawt/worktrees/<project>/` 下所有 worktree                |
-| 分支 | `clawt remove -b feature-scheme`         | `~/.clawt/worktrees/<project>/feature-scheme-*` 的所有 worktree |
-| 单个 | `clawt remove -b feature-scheme-2`       | 仅移除 `feature-scheme-2` 对应的 worktree（完整分支名精确匹配）    |
+> **提示：** 不传 `--all` 也不传 `-b` 时，会列出当前项目所有 worktree 供交互式多选。
 
 **运行流程：**
 
 1. **主 worktree 校验** (2.1)
 2. **获取项目名** (2.2)
-3. 根据参数确定要移除的 worktree 列表
+3. **确定待移除的 worktree 列表**：
+   - **指定 `--all`** → 选中当前项目所有 worktree
+   - **未指定 `--all`** → 通过 `resolveTargetWorktrees` 解析目标 worktree（多选版本），匹配策略如下：
+     - **未传 `-b` 参数**：
+       - 无可用 worktree → 报错退出
+       - 仅 1 个 worktree → 直接使用，无需选择
+       - 多个 worktree → 通过交互式多选列表（Enquirer.MultiSelect）让用户选择（空格选择，回车确认）
+     - **传了 `-b` 参数**：
+       1. **精确匹配优先**：在 worktree 列表中查找分支名完全相同的 worktree，找到则直接使用
+       2. **模糊匹配**（子串匹配，大小写不敏感）：
+          - 唯一匹配 → 直接使用
+          - 多个匹配 → 通过交互式多选列表让用户从匹配结果中选择
+       3. **无匹配** → 报错退出，并列出所有可用分支名
 4. 列出即将移除的 worktree 及对应分支：
 
 ```
@@ -1122,6 +1137,139 @@ clawt reset
 
 ---
 
+### 5.14 项目全局状态总览
+
+**命令：**
+
+```bash
+clawt status [--json]
+```
+
+**参数：**
+
+| 参数     | 必填 | 说明                                     |
+| -------- | ---- | ---------------------------------------- |
+| `--json` | 否   | 以 JSON 格式输出完整状态数据              |
+
+**使用场景：**
+
+在管理多个 worktree 时，快速了解项目全局状态：主 worktree 当前分支及干净状态、所有 worktree 的变更情况和与主分支的同步状态、未清理的 validate 快照。
+
+**运行流程：**
+
+1. **主 worktree 校验** (2.1)
+2. **收集主 worktree 状态**：
+   - 获取当前分支名（`getCurrentBranch()`）
+   - 检测工作区是否干净（`isWorkingDirClean()`）
+   - 获取项目名（`getProjectName()`）
+3. **收集各 worktree 详细状态**：
+   - 获取项目所有 worktree（`getProjectWorktrees()`）
+   - 对每个 worktree 收集以下信息：
+     - **变更状态**（优先级：合并冲突 > 未提交修改 > 已提交 > 无变更）
+     - **行数差异**（新增/删除行数，通过 `getDiffStat()` 获取）
+     - **提交差异**（相对于主分支的领先提交数 `getCommitCountAhead()` 和落后提交数 `getCommitCountBehind()`）
+     - **快照状态**（是否存在 validate 快照）
+4. **收集未清理的 validate 快照**：
+   - 通过 `getProjectSnapshotBranches()` 扫描快照目录下的 `.tree` 文件获取所有存在快照的分支名
+   - 对比现有 worktree 分支列表，标识孤立快照（对应 worktree 已不存在的快照）
+5. **输出状态信息**：
+   - 指定 `--json` → 以 JSON 格式输出完整状态数据（`JSON.stringify`）
+   - 未指定 → 以文本格式输出
+
+**文本输出格式（默认）：**
+
+输出分为三个区块：主 Worktree、Worktree 列表、未清理的 Validate 快照。
+
+```
+════════════════════════════════════════
+  项目状态总览: main-project
+════════════════════════════════════════
+
+  ◆ 主 Worktree
+    分支: main
+    状态: ✓ 干净
+
+────────────────────────────────────────
+
+  ◆ Worktree 列表 (2 个)
+
+  ● feature-login   [已提交]
+    +120 -30   3 个本地提交   与主分支同步
+    有 validate 快照
+
+  ● feature-signup   [未提交修改]
+    +45 -10   1 个本地提交   落后主分支 2 个提交
+
+────────────────────────────────────────
+
+  ◆ 未清理的 Validate 快照 (1 个)
+
+  ⚠ old-feature   (对应 worktree 已不存在)
+
+════════════════════════════════════════
+```
+
+**变更状态标签：**
+
+| 状态        | 标签           | 颜色   | 说明                          |
+| ----------- | -------------- | ------ | ----------------------------- |
+| `committed` | 已提交         | 绿色   | 有已提交内容，工作区干净       |
+| `uncommitted` | 未提交修改   | 黄色   | 有未提交的修改                 |
+| `conflict`  | 合并冲突       | 红色   | 存在合并冲突                   |
+| `clean`     | 无变更         | 灰色   | 工作区干净且无本地提交          |
+
+**差异统计行展示规则：**
+
+- 行数变更（`+N -N`）仅在有变更时展示
+- 本地提交数（`N 个本地提交`）仅在有提交时展示
+- 与主分支同步状态始终展示（落后时显示黄色，同步时显示绿色）
+
+**快照区块：**
+
+- 每个快照显示对应的分支名
+- 如果对应的 worktree 仍存在，显示蓝色圆点图标
+- 如果对应的 worktree 已不存在（孤立快照），显示黄色警告图标并标注 `(对应 worktree 已不存在)`
+
+**JSON 输出格式（`--json`）：**
+
+```json
+{
+  "main": {
+    "branch": "main",
+    "isClean": true,
+    "projectName": "main-project"
+  },
+  "worktrees": [
+    {
+      "path": "~/.clawt/worktrees/main-project/feature-login",
+      "branch": "feature-login",
+      "changeStatus": "committed",
+      "commitsAhead": 3,
+      "commitsBehind": 0,
+      "hasSnapshot": true,
+      "insertions": 120,
+      "deletions": 30
+    }
+  ],
+  "snapshots": [
+    {
+      "branch": "old-feature",
+      "worktreeExists": false
+    }
+  ],
+  "totalWorktrees": 1
+}
+```
+
+**实现要点：**
+
+- 类型定义在 `src/types/status.ts`：`WorktreeDetailedStatus`、`MainWorktreeStatus`、`SnapshotInfo`、`StatusResult`
+- 消息常量在 `MESSAGES.STATUS_*` 系列
+- `getCommitCountBehind()` 是新增的工具函数（在 `src/utils/git.ts`），通过 `git rev-list --count <branch>..HEAD` 计算落后提交数
+- `getProjectSnapshotBranches()` 是新增的工具函数（在 `src/utils/validate-snapshot.ts`），通过扫描快照目录下的 `.tree` 文件提取分支名列表
+
+---
+
 ## 6. 错误处理规范
 
 ### 6.1 通用错误处理

package/package.json

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

package/src/commands/remove.ts

@@ -19,7 +19,17 @@ import {
   confirmAction,
   removeSnapshot,
   removeProjectSnapshots,
+  resolveTargetWorktrees,
 } from '../utils/index.js';
+import type { WorktreeMultiResolveMessages } from '../utils/index.js';
+
+/** remove 命令的分支解析消息配置 */
+const REMOVE_RESOLVE_MESSAGES: WorktreeMultiResolveMessages = {
+  noWorktrees: MESSAGES.REMOVE_NO_WORKTREES,
+  selectBranch: MESSAGES.REMOVE_SELECT_BRANCH,
+  multipleMatches: MESSAGES.REMOVE_MULTIPLE_MATCHES,
+  noMatch: MESSAGES.REMOVE_NO_MATCH,
+};
 
 /**
  * 注册 remove 命令：移除 worktree
@@ -30,38 +40,12 @@ export function registerRemoveCommand(program: Command): void {
     .command('remove')
     .description('移除 worktree（支持单个/批量/全部）')
     .option('--all', '移除当前项目下所有 worktree')
-    .option('-b, --branch <branchName>', '指定分支名（完整分支名精确匹配）')
+    .option('-b, --branch <branchName>', '指定分支名（支持模糊匹配，不传则列出所有分支）')
     .action(async (options: RemoveOptions) => {
       await handleRemove(options);
     });
 }
 
-/**
- * 根据参数确定要移除的 worktree 列表
- * @param {RemoveOptions} options - 命令选项
- * @returns {Array<{path: string, branch: string}>} 待移除的 worktree 列表
- */
-function resolveWorktreesToRemove(options: RemoveOptions): Array<{ path: string; branch: string }> {
-  const allWorktrees = getProjectWorktrees();
-
-  if (options.all) {
-    return allWorktrees;
-  }
-
-  if (!options.branch) {
-    throw new ClawtError('请指定 --all 或 -b <branchName> 参数');
-  }
-
-  // 分支级移除：匹配 branchName 或 branchName-*
-  const matched = allWorktrees.filter(
-    (wt) => wt.branch === options.branch || wt.branch.startsWith(`${options.branch}-`),
-  );
-  if (matched.length === 0) {
-    throw new ClawtError(MESSAGES.WORKTREE_NOT_FOUND(options.branch));
-  }
-  return matched;
-}
-
 /**
  * 执行 remove 命令的核心逻辑
  * @param {RemoveOptions} options - 命令选项
@@ -72,7 +56,16 @@ async function handleRemove(options: RemoveOptions): Promise<void> {
   const projectName = getProjectName();
   logger.info(`remove 命令执行，项目: ${projectName}`);
 
-  const worktreesToRemove = resolveWorktreesToRemove(options);
+  const allWorktrees = getProjectWorktrees();
+
+  // 确定待移除的 worktree 列表
+  let worktreesToRemove;
+  if (options.all) {
+    worktreesToRemove = allWorktrees;
+  } else {
+    // 通过 fuzzy search 解析目标 worktree（精确匹配 / 模糊匹配 / 交互多选）
+    worktreesToRemove = await resolveTargetWorktrees(allWorktrees, REMOVE_RESOLVE_MESSAGES, options.branch);
+  }
 
   if (worktreesToRemove.length === 0) {
     printInfo(MESSAGES.NO_WORKTREES);