clawt 3.7.0 → 3.8.0

package/docs/remove.md

@@ -0,0 +1,90 @@
+### 5.5 移除 Worktree
+
+**命令：**
+
+```bash
+# 移除当前项目所有 worktree
+clawt remove --all
+
+# 指定分支名（支持模糊匹配）
+clawt remove -b <branchName>
+
+# 不指定参数（列出所有分支供多选）
+clawt remove
+```
+
+**参数：**
+
+| 参数      | 必填 | 说明                                                                   |
+| --------- | ---- | ---------------------------------------------------------------------- |
+| `--all`   | 否   | 移除当前项目 (`~/.clawt/worktrees/<project>/`) 下所有 worktree           |
+| `-b`      | 否   | 指定分支名（支持模糊匹配，不传则列出所有分支供多选）                       |
+
+> **提示：** 不传 `--all` 也不传 `-b` 时，会列出当前项目所有 worktree 供交互式多选。
+
+**运行流程：**
+
+1. **前置校验**：
+   - 主 worktree 校验 (2.1)
+   - HEAD 存在性校验
+   - 项目配置文件校验（确保项目已通过 `clawt init` 初始化）
+2. **获取项目名** (2.2)
+3. **确定待移除的 worktree 列表**：
+   - **指定 `--all`** → 选中当前项目所有 worktree（若当前项目无 worktree，则提示并退出）
+   - **未指定 `--all`** → 通过 `resolveTargetWorktrees` 解析目标 worktree（多选版本），匹配策略如下：
+     - **未传 `-b` 参数**：
+       - 无可用 worktree → 报错退出
+       - 仅 1 个 worktree → 直接使用，无需选择
+       - 多个 worktree → 通过交互式多选列表（Enquirer.MultiSelect）让用户选择（空格选择，回车确认）
+     - **传了 `-b` 参数**：
+       1. **精确匹配优先**：在 worktree 列表中查找分支名完全相同的 worktree，找到则直接使用
+       2. **模糊匹配**（子串匹配，大小写不敏感）：
+          - 唯一匹配 → 直接使用
+          - 多个匹配 → 通过交互式多选列表让用户从匹配结果中选择
+       3. **无匹配** → 报错退出，并列出所有可用分支名
+4. **当前分支安全检查**：逐个检查待移除的分支，如果该分支或其对应的验证分支（`clawt-validate-<branchName>`）是主 worktree 当前所在分支，则抛出错误并阻止移除。
+5. 列出即将移除的 worktree 及对应分支：
+
+```
+即将移除以下 worktree 及本地分支：
+
+  1. ~/.clawt/worktrees/main-project/feature-scheme-1  →  分支: feature-scheme-1  验证分支: clawt-validate-feature-scheme-1
+  2. ~/.clawt/worktrees/main-project/feature-scheme-2  →  分支: feature-scheme-2  验证分支: clawt-validate-feature-scheme-2
+  3. ~/.clawt/worktrees/main-project/feature-scheme-3  →  分支: feature-scheme-3  验证分支: clawt-validate-feature-scheme-3
+
+是否同时删除对应的本地分支和验证分支？(y/N)
+```
+
+6. **判断是否删除本地分支**：
+   - 如果配置文件 `~/.clawt/config.json` 中 `autoDeleteBranch` 为 `true`，则跳过询问，直接删除分支
+   - 否则询问用户是否删除，用户拒绝时提示可稍后手动删除
+7. 对每个 worktree 依次执行（单个失败不影响其他）：
+
+```bash
+# 移除 worktree
+git worktree remove -f <worktree路径>
+
+# 如果用户选择了删除分支（或 autoDeleteBranch 为 true）
+git branch -D <branchName>
+
+# 无条件删除验证分支（不受用户确认控制，存在则删除）
+git branch -D clawt-validate-<branchName>
+# 无条件清理该分支对应的 validate 快照
+```
+
+8. 如果使用 `--all` 模式，额外清理整个项目的 validate 快照目录。
+
+9. 移除完成后执行清理：
+   - `git worktree prune` 清理已失效的 worktree 引用
+   - 如果 `~/.clawt/worktrees/<project>/` 下已无 worktree，则删除该项目目录
+
+10. 批量移除时，单个 worktree 移除失败不会中断整个流程，而是收集所有失败项，最后汇总报告并以错误状态退出（抛出 ClawtError）。
+
+**实现要点：**
+
+- 消息常量定义在 `src/constants/messages/remove.ts`
+- 分支解析逻辑复用公共模块 `resolveTargetWorktrees`（`src/utils/worktree-matcher.ts`）
+- 验证分支删除通过 `deleteValidateBranch`（`src/utils/validate-branch.ts`），内部判断分支是否存在后才执行删除
+- 快照清理通过 `removeSnapshot` 和 `removeProjectSnapshots`（`src/utils/validate-snapshot.ts`）
+
+---

package/docs/reset.md

@@ -0,0 +1,37 @@
+### 5.13 重置主 Worktree 工作区和暂存区
+
+**命令：**
+
+```bash
+clawt reset
+```
+
+**无参数。**
+
+**使用场景：**
+
+当用户通过 `clawt validate` 将分支变更迁移到主 worktree 后，希望快速清除工作区和暂存区的所有修改，恢复到干净状态。与 `clawt validate --clean` 的区别在于：`reset` 仅重置工作区和暂存区，**不删除** validate 快照文件，也**不切换分支**，适用于只想清空变更而保留快照以便后续增量 validate 的场景。
+
+> **设计原因**：reset 的职责是「重置工作区状态」，分支切换属于 validate --clean 和 remove 等命令的职责。将分支切换耦合到 reset 会违反单一职责原则。
+
+**运行流程：**
+
+1. **前置校验**（`runPreChecks`）：
+   - `requireMainWorktree`：主 worktree 校验 (2.1)
+   - `requireHead`：HEAD 存在校验
+   - `requireProjectConfig`：项目级配置校验
+2. **检测工作区状态**：通过 `git status --porcelain` 检测主 worktree 是否有未提交的更改
+   - **工作区干净** → 输出提示 `主 worktree 工作区和暂存区已是干净状态，无需重置`，退出
+   - **工作区不干净** → 继续
+3. **确认破坏性操作**：如果配置项 `confirmDestructiveOps` 为 `true`，提示确认（显示即将执行的危险指令 `git reset --hard + git clean -fd` 和操作后果 `丢弃所有未提交的更改`），用户取消则输出 `已取消操作` 并退出
+4. **重置工作区和暂存区**：
+   ```bash
+   git reset --hard HEAD
+   git clean -fd
+   ```
+5. **输出成功提示**：
+   ```
+   ✓ 主 worktree 工作区和暂存区已重置
+   ```
+
+---

package/docs/resume.md

@@ -0,0 +1,132 @@
+### 5.11 在已有 Worktree 中恢复会话
+
+**命令：**
+
+```bash
+# 指定分支名（支持模糊匹配）
+clawt resume -b <branchName>
+
+# 不指定分支名（列出所有分支供多选）
+clawt resume
+
+# 非交互式追问（指定分支 + 追问内容）
+clawt resume -b <branchName> --prompt "追问内容"
+
+# 从任务文件批量追问（通过 branch 名匹配已有 worktree）
+clawt resume -f tasks.md
+
+# 批量追问时限制并发数
+clawt resume -f tasks.md -c 2
+```
+
+**参数：**
+
+| 参数 | 必填 | 说明                                                  |
+| ---- | ---- | ----------------------------------------------------- |
+| `-b` | 否   | 要恢复的分支名（支持模糊匹配，不传则列出所有分支供多选） |
+| `--prompt` | 否 | 非交互式追问内容（需配合 `-b` 指定分支，与 `-f` 互斥） |
+| `-f, --file` | 否 | 从任务文件批量追问（通过 branch 名匹配已有 worktree，与 `--prompt` 互斥） |
+| `-c, --concurrency` | 否 | 批量追问最大并发数，`0` 表示不限制 |
+
+**使用场景：**
+
+当用户之前通过 `clawt run` 或 `clawt create` 创建了 worktree 但会话已结束，希望在该 worktree 中重新打开 Claude Code 交互式界面继续工作。支持一次选中多个分支，自动在独立终端 Tab 中批量恢复。
+
+此外还支持**非交互式追问模式**：通过 `--prompt` 对指定分支进行追问，或通过 `-f` 从任务文件批量追问多个分支。追问模式下会自动检测是否有历史会话，有则追加 `--continue` 继续上次对话。
+
+**互斥约束：**
+
+- `--prompt` 和 `-f` **不能同时使用**
+- `--prompt` 必须配合 `-b` 指定分支
+
+**运行流程：**
+
+1. **前置校验**（`PRE_CHECK_RESUME`）：主 worktree 校验 (2.1) + HEAD 存在性校验 + Claude Code CLI 可用性校验
+2. **非交互式追问分支**：
+   - **`--prompt` 和 `-f` 互斥校验**：两者同时传入则报错退出
+   - **`--prompt` 模式**（单分支追问）：
+     - 必须配合 `-b` 指定分支，否则报错退出
+     - 通过精确匹配查找目标 worktree，找不到则列出可用分支报错
+     - 检查目标 worktree 是否有历史会话，有则追加 `--continue`
+     - 调用 `executeBatchTasks` 执行单任务追问
+   - **`-f` 模式**（批量追问）：
+     - 从任务文件解析追问条目（branch 为必填字段）
+     - 按 branch 名精确匹配已有 worktree，构建执行参数
+     - 按 worktree 独立检查是否有历史会话
+     - 解析并发数（`-c` 参数 > 全局配置 `maxConcurrency`）
+     - 调用 `executeBatchTasks` 批量执行追问
+3. **交互式恢复逻辑**（未传 `--prompt` 和 `-f` 时）：解析目标 worktree：根据是否传入 `-b` 参数以及 worktree 数量，采用不同的解析策略：
+   - **未传 `-b` 参数**：
+     - 获取当前项目所有 worktree
+     - 无可用 worktree → 报错退出
+     - 仅 1 个 worktree → 通过 `resolveTargetWorktrees` 直接使用，无需选择
+     - 多个 worktree → 通过 `promptGroupedMultiSelectBranches` 展示**按日期分组的交互式多选列表**（详见下文「按日期分组多选」）
+   - **传了 `-b` 参数**：通过 `resolveTargetWorktrees` 解析，匹配策略如下：
+     1. **精确匹配优先**：在 worktree 列表中查找分支名完全相同的 worktree，找到则直接使用
+     2. **模糊匹配**（子串匹配，大小写不敏感）：
+        - 唯一匹配 → 直接使用
+        - 多个匹配 → 通过交互式多选列表让用户从匹配结果中选择
+     3. **无匹配** → 报错退出，并列出所有可用分支名
+3. **根据选中数量自动分发**：
+   - **用户未选择任何分支** → 直接退出
+   - **选中 1 个** → 根据全局配置项 `resumeInPlace` 决定打开方式：
+     - `resumeInPlace: true` → 在当前终端就地恢复，通过 `launchInteractiveClaude()` 启动（使用 `spawnSync` + `inherit stdio`）
+     - `resumeInPlace: false`（默认） → 通过 `launchInteractiveClaudeInNewTerminal()` 在新终端 Tab 中恢复，终端类型由 `terminalApp` 配置控制
+   - **选中多个** → 进入批量恢复流程（见下文），始终在新终端 Tab 中打开，不受 `resumeInPlace` 影响
+
+**批量恢复流程：**
+
+1. **计算会话状态**：一次性遍历所有选中的 worktree，通过 `hasClaudeSessionHistory()` 检测是否存在历史会话，构建 sessionMap 避免重复 I/O
+2. **输出预览**：列出即将恢复的分支及其会话状态（"继续上次对话"或"新对话"）
+3. **用户确认**：提示即将在 N 个独立终端 Tab 中恢复会话，等待用户确认
+4. **逐个在新终端 Tab 中启动**：通过 `launchInteractiveClaudeInNewTerminal()` 构建 shell 命令并通过 AppleScript 在新终端 Tab 中执行
+5. **输出完成提示**
+
+**终端 Tab 管理：**
+
+批量恢复通过 `openCommandInNewTerminalTab()`（`src/utils/terminal.ts`）在新终端 Tab 中启动 Claude Code。终端类型由配置项 `terminalApp` 控制：
+
+| 配置值     | 行为                                                         |
+| ---------- | ------------------------------------------------------------ |
+| `auto`     | 自动检测：优先检测 iTerm2 是否已安装（`/Applications/iTerm.app`），已安装则使用 iTerm2，否则降级到 Terminal.app |
+| `iterm2`   | 强制使用 iTerm2                                               |
+| `terminal` | 强制使用 Terminal.app                                         |
+
+**平台限制：** 批量恢复目前仅支持 macOS 平台（通过 AppleScript 打开终端 Tab）。非 macOS 平台会抛出错误。
+
+**权限要求：** Terminal.app 通过 System Events 模拟键盘操作（`Cmd+T`）新建 Tab，需要在「系统设置 → 隐私与安全性 → 辅助功能」中授权终端应用。iTerm2 使用原生 AppleScript 接口，无需辅助功能权限。
+
+启动命令通过配置项 `claudeCodeCommand`（默认值 `claude`）指定，与 `clawt run` 不传 `--tasks` 时的交互式界面行为一致。
+
+**按日期分组多选：**
+
+当未传 `-b` 且有多个 worktree 时，使用 `promptGroupedMultiSelectBranches` 展示按创建日期分组的交互式多选列表，实现流程如下：
+
+1. **日期分组**（`groupWorktreesByDate`）：通过 `statSync` 获取各 worktree 目录的文件系统创建时间（`birthtime`），按本地时区格式化为 `YYYY-MM-DD` 作为分组键。无法获取创建时间的分支归入「未知日期」组。分组按日期降序排列，未知日期组在最后。
+2. **构建选项列表**（`buildGroupedChoices`）：生成包含以下元素的 Enquirer MultiSelect choices 数组：
+   - 顶部：全局全选选项 `[select-all]`
+   - 每组：日期分隔线（显示日期和相对时间，如「2026-02-26（昨天）」）→ 组级全选选项 `[select-all: YYYY-MM-DD]` → 该组内各分支
+2.5. **构建组成员映射**（`buildGroupMembershipMap`）：生成"组全选 name → 该组分支 name 列表"的 Map，供三级联动的 `space()` 方法快速查找某个组全选项对应的所有分支
+3. **三级联动选择**：通过继承 Enquirer MultiSelect 并覆写 `space()` 方法实现，同步逻辑由 `syncGlobalSelectAll` 和 `syncGroupSelectAll` 两个内部函数负责：
+   - **全局全选**：toggle 所有 choices（含组全选）
+   - **组级全选**：toggle 该组内所有分支，并同步全局全选状态
+   - **普通分支**：toggle 该分支，同步所属组全选和全局全选状态
+4. **过滤结果**：返回时过滤掉全选项和组全选项，只返回实际选中的 worktree
+
+相对日期显示规则：`formatRelativeDate` 基于自然日差值计算——今天 / 昨天 / N 天前 / N 个月前 / N 年前。
+
+相关常量定义在 `src/constants/prompt.ts`：
+
+| 常量 | 说明 |
+| ---- | ---- |
+| `GROUP_SELECT_ALL_PREFIX` | 组级全选选项的 name 前缀（`__group_select_all_`） |
+| `GROUP_SELECT_ALL_LABEL(dateLabel)` | 生成组级全选选项的显示文本 |
+| `GROUP_SEPARATOR_LABEL(dateLabel, relativeTime)` | 生成日期分隔线的显示文本（含 chalk 高亮） |
+| `UNKNOWN_DATE_GROUP` | 无法获取创建日期时的默认分组名称（`未知日期`） |
+| `UNKNOWN_DATE_SEPARATOR_LABEL` | 未知日期分组的分隔线显示文本 |
+| `SELECT_ALL_NAME` | 全局全选选项的标识名称（`__select_all__`） |
+| `SELECT_ALL_LABEL` | 全局全选选项的显示文本（`[select-all]`） |
+
+**会话自动续接：** 启动前会自动检测该 worktree 是否存在 Claude Code 历史会话（通过检查 `~/.claude/projects/<encoded-path>/` 下是否有 `.jsonl` 文件判断），如果存在则自动追加 `--continue` 参数继续上次对话，否则打开新对话。启动信息中会显示当前模式（"继续上次对话"或"新对话"）。路径编码规则：将绝对路径中所有非字母数字字符替换为 `-`（与 Claude Code 源码的编码逻辑一致）。
+
+---

package/docs/run.md

@@ -0,0 +1,150 @@
+### 5.2 批量创建 Worktree + 执行 Claude Code 任务
+
+> **注意：** run 命令内部调用 `createWorktrees` 或 `createWorktreesByBranches`，因此验证分支的创建和主工作分支检测逻辑（包括工作区脏状态处理）**自动继承** create 命令的变更，无需额外修改 run 命令本身。
+
+**命令：**
+
+```bash
+# 方式一：通过 --tasks 参数直接指定任务（多任务并行，支持 variadic 语法）
+clawt run -b <branchName> --tasks <task1> <task2> <task3>
+
+# 方式二：通过 -f 从任务文件读取任务列表
+clawt run -f <path>
+
+# 方式三：不传 --tasks 也不传 -f，在 worktree 中打开 Claude Code 交互式界面
+clawt run -b <branchName>
+```
+
+**参数：**
+
+| 参数      | 必填 | 说明                                                        |
+| --------- | ---- | ----------------------------------------------------------- |
+| `-b`      | 否   | 分支名（使用 `-f` 时可选，否则必填）                          |
+| `--tasks` | 否   | 任务描述（可多次指定，每个 --tasks 对应一个任务，任务数量即 worktree 数量）。不传则在 worktree 中打开 Claude Code 交互式界面 |
+| `-f`      | 否   | 从任务文件读取任务列表（与 `--tasks` 互斥）                    |
+| `-c`      | 否   | 最大并发数，`0` 表示不限制                                    |
+| `--dry-run` | 否 | 试运行模式，仅输出预览信息不实际执行                            |
+| `--post-create` | 否 | 执行 postCreate hook（默认开启，`--no-post-create` 跳过）。详见 [post-create-hook.md](./post-create-hook.md) |
+
+**互斥约束：**
+
+- `--file` 和 `--tasks` **不能同时使用**
+- 非 `-f` 模式必须指定 `-b`
+
+**交互式 Claude Code 界面模式：**
+
+当不传 `--tasks` 也不传 `-f` 时，会创建单个 worktree，然后通过 `spawnSync` + `inherit stdio` 在该 worktree 中直接启动 Claude Code CLI 交互式界面，让用户与 Claude Code 直接交互。
+
+启动命令通过配置项 `claudeCodeCommand`（默认值 `claude`）指定，支持自定义命令及参数。
+
+#### 任务文件格式
+
+任务文件使用嵌入 HTML 注释标签的自定义格式，不限制文件类型，标签外的任何文本都不会被解析。
+
+```markdown
+这里可以写任何说明文字，会被忽略
+
+<!-- CLAWT-TASKS:START -->
+# branch: feat-login
+实现用户登录功能
+<!-- CLAWT-TASKS:END -->
+
+<!-- CLAWT-TASKS:START -->
+# branch: fix-bug
+修复内存泄漏问题
+这是多行任务描述
+可以写很多行
+<!-- CLAWT-TASKS:END -->
+```
+
+**格式规则：**
+
+1. **任务块界定**：每个任务用 `<!-- CLAWT-TASKS:START -->` 和 `<!-- CLAWT-TASKS:END -->` 包裹
+2. **分支名声明**：块内必须有一行 `# branch: <分支名>`（冒号前后的空格可灵活）
+3. **任务描述**：块内除分支名行以外的所有行，合并为任务描述（支持多行）
+4. **块外内容忽略**：标签外的任何文本都不会被解析
+5. **必填校验**：每个块必须包含任务描述；分支名默认必填，但使用 `-b` 参数时分支名为可选（会被忽略，用 `-b` 值自动编号）
+
+**解析实现：** `src/utils/task-file.ts` 中的 `parseTaskFile()`、`loadTaskFile()` 和 `parseTasksFromOptions()` 函数，类型定义为 `TaskFileEntry`（`src/types/taskFile.ts`）。
+
+#### 任务文件模式运行流程
+
+使用 `-f` 时的执行路径（`handleRun` → `handleRunFromFile`）：
+
+1. 调用 `loadTaskFile(options.file)` 读取解析文件
+2. **有 `-b` 参数**：忽略文件中的分支名，用 `-b` 值自动编号创建 worktree（`createWorktrees(branch, count)`）
+3. **无 `-b` 参数**：使用文件中每个任务的独立分支名，先 `sanitizeBranchName` 清理后调用 `createWorktreesByBranches(branches)`
+4. **执行 postCreate hook**：调用 `runPostCreateHooks(worktrees, !options.postCreate)`，以 fire-and-forget 模式后台异步并行执行，不阻塞后续流程。详见 [post-create-hook.md](./post-create-hook.md)
+5. 调用 `executeBatchTasks(worktrees, tasks, concurrency)` 执行
+
+#### --tasks 模式运行流程
+
+1. 若传了 `--tasks`，解析得到任务数组 `tasks[]`；若未传，先检测分支是否已存在（已存在则提示使用 `clawt resume -b <branchName>` 恢复会话），然后创建单个 worktree，执行 postCreate hook（fire-and-forget）后启动 Claude Code 交互式界面（`launchInteractiveClaude(worktree)`），流程结束，不进入后续并行执行阶段
+2. `n = tasks.length`
+3. 按照 **5.1** 的流程创建 `n` 个 worktree
+4. **执行 postCreate hook**：调用 `runPostCreateHooks(worktrees, !options.postCreate)`，以 fire-and-forget 模式后台异步并行执行，不阻塞后续流程。详见 [post-create-hook.md](./post-create-hook.md)
+5. 通过公共函数 `executeBatchTasks`（`src/utils/task-executor.ts`）启动批量任务执行，该函数负责进度面板渲染、SIGINT 中断处理、并发控制和汇总输出。对每个 worktree 并行启动 Claude Code CLI：
+   ```bash
+   cd ~/.clawt/worktrees/<project>/<branchName>-<i>
+   claude -p "<tasks[i]>" --output-format stream-json --verbose --permission-mode bypassPermissions --append-system-prompt "<系统提示>"
+   ```
+   其中 `--append-system-prompt` 使用统一的 `APPEND_SYSTEM_PROMPT` 常量（定义在 `src/constants/config.ts`）。
+   使用 `stream-json` 格式可实时获取 Claude Code 的流式事件（工具调用、文本输出、最终结果），用于在进度面板中显示每个任务的实时活动描述和结果预览。流式事件解析由 `src/utils/stream-parser.ts` 负责。
+6. 进入**事件监听通知**阶段（见 [5.3](#53-任务完成通知机制)）
+7. **中断处理（Ctrl+C / SIGINT）**
+   - 监听 `SIGINT` 信号，用户按下 Ctrl+C 时触发
+   - 向所有正在运行的 Claude Code 子进程发送 `SIGTERM` 终止信号
+   - 等待所有子进程退出后，进入清理流程：
+     - 如果 `autoDeleteBranch` 为 `true`：自动清理本次创建的所有 worktree 和对应分支
+     - 否则：交互式询问用户是否移除刚刚创建的 worktree 和对应分支
+       - 用户选择保留时，提示可使用 `clawt remove` 手动清理
+   - 清理完成后以退出码 `1` 退出
+
+**注意：** 当 `n = 1` 时（只有一个任务），worktree 目录命名规则同 **5.1**（不加 `-1` 后缀）。
+
+#### `--dry-run` 预览模式
+
+传入 `--dry-run` 时不实际创建 worktree 和执行任务，仅输出预览信息供用户确认。预览由 `printDryRunPreview()`（`src/utils/dry-run.ts`）负责渲染。
+
+**输出格式：**
+
+```
+════════════════════════════════════════
+  Dry Run 预览
+════════════════════════════════════════
+任务数: 3 │ 并发数: 不限制 │ Worktree: ~/.clawt/worktrees/project
+────────────────────────────────────────
+✓ [1/3] feat-login
+  路径: ~/.clawt/worktrees/project/feat-login
+  任务: 实现登录功能
+
+⚠ [2/3] feat-signup — 分支 feat-signup 已存在
+  路径: ~/.clawt/worktrees/project/feat-signup
+  任务: 实现注册功能
+
+✓ [3/3] fix-bug
+  路径: ~/.clawt/worktrees/project/fix-bug
+  任务: 修复内存泄漏
+
+════════════════════════════════════════
+✓ 预览完成，无冲突。移除 --dry-run 即可正式执行。
+```
+
+**格式规则：**
+
+1. **标题区**：双线分隔符包裹标题 `Dry Run 预览`
+2. **摘要行**：任务数、并发数、Worktree 目录路径合并为一行，用灰色 `│` 分隔；交互式模式（无 `--tasks`）会额外追加模式信息
+3. **分支列表**：
+   - 正常分支：行首绿色 `✓` + 序号 + 青色分支名
+   - 冲突分支：行首黄色 `⚠` + 序号 + 黄色分支名 + 灰色 `—` + 黄色警告文本（如 `分支 xxx 已存在`），警告合并在序号行
+4. **路径/任务行**：2 空格缩进，灰色标签前缀（`路径:` / `任务:`）
+5. **任务描述截断**：超过 80 字符时末尾加 `...`，多行合并为单行
+6. **结尾**：双线分隔符后根据冲突情况输出结论——无冲突时绿色 `✓` 提示，有冲突时黄色 `⚠` 警告
+
+**实现要点：**
+
+- 常量定义在 `src/constants/messages/run.ts`（`DRY_RUN_*` 系列）
+- `DRY_RUN_WORKTREE_DIR` 前缀为 `Worktree:`（简短形式）
+- `truncateTaskDesc()` 负责截断任务描述（最大长度 80 字符，定义在 `src/utils/dry-run.ts`）
+
+---