clawt 2.7.1 → 2.7.3

package/.claude/agent-memory/docs-sync-updater/MEMORY.md

@@ -7,7 +7,7 @@
 - 命令流程在 `5. 需求场景详细设计` 下，每个命令一个子章节（5.1-5.13）
 - run 命令对应 `5.2 批量创建 Worktree + 执行 Claude Code 任务`，流程按步骤编号描述
 - merge 命令对应 `5.6 合并验证过的分支`，-b 可选，支持模糊匹配（与 resume/validate 共享匹配逻辑），流程按步骤编号描述
-- config 命令对应 `5.10 查看全局配置`，只读展示配置
+- config 命令对应 `5.10 查看和管理全局配置`，包含查看配置和 config reset 子命令两部分（使用 `####` 子标题区分）
 - resume 命令对应 `5.11 在已有 Worktree 中恢复会话`，支持模糊匹配和交互式分支选择（-b 可选）
 - validate 命令对应 `5.4 在主 Worktree 验证其他分支`，-b 可选，支持模糊匹配（与 resume 共享匹配逻辑）
 - sync 命令对应 `5.12 将主分支代码同步到目标 Worktree`，-b 可选，支持模糊匹配（与 resume/validate/merge 共享匹配逻辑）
@@ -22,7 +22,7 @@
 
 ## 关键约定
 - `autoDeleteBranch` 配置项影响三处：remove 命令、merge 命令、run 中断清理
-- `confirmDestructiveOps` 配置项影响两处：reset 命令、validate --clean
+- `confirmDestructiveOps` 配置项影响三处：reset 命令、validate --clean、config reset
 - merge 的清理确认和清理操作均在 merge 成功后执行（避免 merge 冲突时提前询问用户造成困惑）
 - merge 成功后自动清理对应的 validate 快照（hasSnapshot + removeSnapshot）
 - merge 成功消息根据 `autoPullPush` 配置动态显示推送状态
@@ -35,7 +35,7 @@
 - `launchInteractiveClaude` 是 run（交互式模式）和 resume 共用的公共函数（在 src/utils/claude.ts）
 - killAllChildProcesses 是 run 专用的子进程终止函数（在 src/utils/shell.ts）
 - validate 快照管理函数在 `src/utils/validate-snapshot.ts`，被 validate、merge 和 remove 三个命令使用
-- `confirmDestructiveAction` 在 `src/utils/formatter.ts`，被 reset 和 validate --clean 使用
+- `confirmDestructiveAction` 在 `src/utils/formatter.ts`，被 reset、validate --clean 和 config reset 使用
 - sanitizeBranchName 清理后为空串时抛出 BRANCH_NAME_EMPTY 错误
 
 ## 配置项同步检查点

package/README.md

@@ -246,7 +246,7 @@ clawt list [--json]
 | ---- | ---- | ---- |
 | `--json` | 否 | 以 JSON 格式输出（仅包含 path 和 branch） |
 
-列出当前项目在 `~/.clawt/worktrees/` 下的所有 worktree 及对应分支。指定 `--json` 时以 JSON 格式输出，便于脚本解析。
+列出当前项目在 `~/.clawt/worktrees/` 下的所有 worktree 及对应分支。文本模式下，如果某个 worktree 处于空闲状态（0 个提交、无变更、无未提交修改），其路径会以橙色高亮显示，方便快速识别可能需要清理或还未开始工作的 worktree。指定 `--json` 时以 JSON 格式输出，便于脚本解析。
 
 ```bash
 # 文本格式输出（默认）
@@ -269,14 +269,20 @@ clawt reset
 clawt reset
 ```
 
-### `clawt config` — 查看全局配置
+### `clawt config` — 查看和管理全局配置
 
 ```bash
+# 查看全局配置
 clawt config
+
+# 将配置恢复为默认值
+clawt config reset
 ```
 
 读取并展示全局配置文件 `~/.clawt/config.json` 中的所有配置项，包括每项的当前值和描述说明。编辑配置需直接修改配置文件。
 
+`config reset` 子命令可将配置文件恢复为默认值，执行前会弹出确认提示（受 `confirmDestructiveOps` 配置项控制）。
+
 ## 配置文件
 
 安装后会自动在 `~/.clawt/config.json` 生成全局配置文件：
@@ -295,7 +301,7 @@ clawt config
 | `autoDeleteBranch` | `boolean` | `false` | 移除 worktree 时自动删除对应本地分支；merge 成功后自动清理 worktree 和分支；run 中断后自动清理本次创建的 worktree 和分支 |
 | `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时和 `clawt resume` 在 worktree 中打开交互式界面 |
 | `autoPullPush` | `boolean` | `false` | merge 成功后是否自动执行 git pull 和 git push |
-| `confirmDestructiveOps` | `boolean` | `true` | 执行破坏性操作（reset、validate --clean）前是否提示确认 |
+| `confirmDestructiveOps` | `boolean` | `true` | 执行破坏性操作（reset、validate --clean、config reset）前是否提示确认 |
 
 ## 分支名规则
 

package/dist/index.js

@@ -76,6 +76,8 @@ var MESSAGES = {
   INTERRUPT_KEPT: "\u5DF2\u4FDD\u7559 worktree\uFF0C\u53EF\u7A0D\u540E\u4F7F\u7528 clawt remove \u624B\u52A8\u6E05\u7406",
   /** 配置文件损坏，已重新生成默认配置 */
   CONFIG_CORRUPTED: "\u914D\u7F6E\u6587\u4EF6\u635F\u574F\u6216\u65E0\u6CD5\u89E3\u6790\uFF0C\u5DF2\u91CD\u65B0\u751F\u6210\u9ED8\u8BA4\u914D\u7F6E",
+  /** 配置已恢复为默认值 */
+  CONFIG_RESET_SUCCESS: "\u2713 \u914D\u7F6E\u5DF2\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C",
   /** 分隔线 */
   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",
   /** 粗分隔线 */
@@ -497,6 +499,9 @@ function confirmDestructiveAction(dangerousCommand, description) {
   printWarning(`\u5373\u5C06\u6267\u884C ${chalk.red.bold(dangerousCommand)}\uFF0C${description}`);
   return confirmAction("\u662F\u5426\u7EE7\u7EED\uFF1F");
 }
+function isWorktreeIdle(status) {
+  return status.commitCount === 0 && status.insertions === 0 && status.deletions === 0 && !status.hasDirtyFiles;
+}
 function formatWorktreeStatus(status) {
   const parts = [];
   parts.push(chalk.yellow(`${status.commitCount} \u4E2A\u63D0\u4EA4`));
@@ -852,8 +857,10 @@ function printListAsText(projectName, worktrees) {
     printInfo(`  ${MESSAGES.NO_WORKTREES}`);
   } else {
     for (const wt of worktrees) {
-      printInfo(`  ${wt.path}   [${wt.branch}]`);
       const status = getWorktreeStatus(wt);
+      const isIdle = status ? isWorktreeIdle(status) : false;
+      const pathDisplay = isIdle ? chalk2.hex("#FF8C00")(wt.path) : wt.path;
+      printInfo(`  ${pathDisplay}   [${wt.branch}]`);
       if (status) {
         printInfo(`    ${formatWorktreeStatus(status)}`);
       } else {
@@ -1445,9 +1452,12 @@ async function handleMerge(options) {
 // src/commands/config.ts
 import chalk3 from "chalk";
 function registerConfigCommand(program2) {
-  program2.command("config").description("\u67E5\u770B\u5168\u5C40\u914D\u7F6E").action(() => {
+  const configCmd = program2.command("config").description("\u67E5\u770B\u548C\u7BA1\u7406\u5168\u5C40\u914D\u7F6E").action(() => {
     handleConfig();
   });
+  configCmd.command("reset").description("\u5C06\u914D\u7F6E\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C").action(async () => {
+    await handleConfigReset();
+  });
 }
 function handleConfig() {
   const config = loadConfig();
@@ -1469,6 +1479,19 @@ ${chalk3.dim("\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84:")} ${CONFIG_PATH}
   }
   printSeparator();
 }
+async function handleConfigReset() {
+  logger.info("config reset \u547D\u4EE4\u6267\u884C\uFF0C\u6062\u590D\u9ED8\u8BA4\u914D\u7F6E");
+  const confirmed = await confirmDestructiveAction(
+    "config reset",
+    "\u5F53\u524D\u914D\u7F6E\u5C06\u88AB\u8986\u76D6\u4E3A\u9ED8\u8BA4\u503C"
+  );
+  if (!confirmed) {
+    printInfo(MESSAGES.DESTRUCTIVE_OP_CANCELLED);
+    return;
+  }
+  writeDefaultConfig();
+  printSuccess(MESSAGES.CONFIG_RESET_SUCCESS);
+}
 function formatConfigValue(value) {
   if (typeof value === "boolean") {
     return value ? chalk3.green("true") : chalk3.yellow("false");

package/docs/spec.md

@@ -21,7 +21,7 @@
   - [5.7 默认配置文件](#57-默认配置文件)
   - [5.8 获取当前项目所有 Worktree](#58-获取当前项目所有-worktree)
   - [5.9 日志系统](#59-日志系统)
-  - [5.10 查看全局配置](#510-查看全局配置)
+  - [5.10 查看和管理全局配置](#510-查看和管理全局配置)
   - [5.11 在已有 Worktree 中恢复会话](#511-在已有-worktree-中恢复会话)
   - [5.12 将主分支代码同步到目标 Worktree](#512-将主分支代码同步到目标-worktree)
   - [5.13 重置主 Worktree 工作区和暂存区](#513-重置主-worktree-工作区和暂存区)
@@ -168,6 +168,7 @@ git show-ref --verify refs/heads/<branchName> 2>/dev/null
 | `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     |
@@ -775,7 +776,7 @@ clawt merge [-m <commitMessage>]
 | `autoDeleteBranch` | `boolean` | `false`   | 移除 worktree 时是否自动删除对应本地分支（无需每次确认）；merge 成功后是否自动清理 worktree 和分支；run 任务被中断（Ctrl+C）后是否自动清理本次创建的 worktree 和分支 |
 | `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时和 `clawt resume` 在 worktree 中打开交互式界面 |
 | `autoPullPush` | `boolean` | `false` | merge 成功后是否自动执行 git pull 和 git push |
-| `confirmDestructiveOps` | `boolean` | `true` | 执行破坏性操作（reset、validate --clean）前是否提示确认 |
+| `confirmDestructiveOps` | `boolean` | `true` | 执行破坏性操作（reset、validate --clean、config reset）前是否提示确认 |
 
 ---
 
@@ -805,6 +806,8 @@ clawt list [--json]
 
 **文本输出格式（默认）：**
 
+每个 worktree 会显示路径、分支名和变更状态。如果某个 worktree 处于空闲状态（0 个提交、无变更、无未提交修改），其路径会以橙色高亮显示，方便用户快速识别可能需要清理或还未开始工作的 worktree。
+
 ```
 当前项目: main-project
 
@@ -878,14 +881,20 @@ clawt list [--json]
 
 ---
 
-### 5.10 查看全局配置
+### 5.10 查看和管理全局配置
 
 **命令：**
 
 ```bash
+# 查看全局配置
 clawt config
+
+# 将配置恢复为默认值
+clawt config reset
 ```
 
+#### 查看配置
+
 **运行流程：**
 
 1. 读取全局配置文件 `~/.clawt/config.json`
@@ -916,6 +925,14 @@ clawt config
 
 ```
 
+#### 恢复默认配置
+
+**运行流程：**
+
+1. 如果配置项 `confirmDestructiveOps` 为 `true`，提示确认（显示即将执行的操作和后果：当前配置将被覆盖为默认值），用户取消则退出
+2. 将默认配置写入 `~/.clawt/config.json`（覆盖现有配置文件）
+3. 输出成功提示：`✓ 配置已恢复为默认值`
+
 ---
 
 ### 5.11 在已有 Worktree 中恢复会话

package/package.json

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

package/src/commands/config.ts

@@ -1,21 +1,28 @@
 import type { Command } from 'commander';
 import chalk from 'chalk';
-import { CONFIG_PATH, DEFAULT_CONFIG, CONFIG_DESCRIPTIONS } from '../constants/index.js';
+import { CONFIG_PATH, DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, MESSAGES } from '../constants/index.js';
 import { logger } from '../logger/index.js';
-import { loadConfig, printInfo, printSeparator } from '../utils/index.js';
+import { loadConfig, writeDefaultConfig, printInfo, printSuccess, printSeparator, confirmDestructiveAction } from '../utils/index.js';
 import type { ClawtConfig } from '../types/index.js';
 
 /**
- * 注册 config 命令：查看全局配置
+ * 注册 config 命令组：查看和管理全局配置
  * @param {Command} program - Commander 实例
  */
 export function registerConfigCommand(program: Command): void {
-  program
+  const configCmd = program
     .command('config')
-    .description('查看全局配置')
+    .description('查看和管理全局配置')
     .action(() => {
       handleConfig();
     });
+
+  configCmd
+    .command('reset')
+    .description('将配置恢复为默认值')
+    .action(async () => {
+      await handleConfigReset();
+    });
 }
 
 /**
@@ -48,6 +55,26 @@ function handleConfig(): void {
   printSeparator();
 }
 
+/**
+ * 执行 config reset 子命令的核心逻辑，将配置恢复为默认值
+ */
+async function handleConfigReset(): Promise<void> {
+  logger.info('config reset 命令执行，恢复默认配置');
+
+  const confirmed = await confirmDestructiveAction(
+    'config reset',
+    '当前配置将被覆盖为默认值',
+  );
+
+  if (!confirmed) {
+    printInfo(MESSAGES.DESTRUCTIVE_OP_CANCELLED);
+    return;
+  }
+
+  writeDefaultConfig();
+  printSuccess(MESSAGES.CONFIG_RESET_SUCCESS);
+}
+
 /**
  * 格式化配置值的显示样式
  * @param {ClawtConfig[keyof ClawtConfig]} value - 配置值

package/src/commands/list.ts

@@ -9,6 +9,7 @@ import {
   getProjectWorktrees,
   getWorktreeStatus,
   formatWorktreeStatus,
+  isWorktreeIdle,
   printInfo,
 } from '../utils/index.js';
 // getWorktreeStatus 和 formatWorktreeStatus 仅在文本模式下使用
@@ -77,10 +78,15 @@ function printListAsText(projectName: string, worktrees: import('../types/index.
     printInfo(`  ${MESSAGES.NO_WORKTREES}`);
   } else {
     for (const wt of worktrees) {
-      printInfo(`  ${wt.path}   [${wt.branch}]`);
-
       // 获取并展示 worktree 变更状态
       const status = getWorktreeStatus(wt);
+
+      // 空闲状态的 worktree 路径用橙色高亮，提示用户关注
+      const isIdle = status ? isWorktreeIdle(status) : false;
+      const pathDisplay = isIdle ? chalk.hex('#FF8C00')(wt.path) : wt.path;
+
+      printInfo(`  ${pathDisplay}   [${wt.branch}]`);
+
       if (status) {
         printInfo(`    ${formatWorktreeStatus(status)}`);
       } else {

package/src/constants/messages.ts

@@ -60,6 +60,8 @@ export const MESSAGES = {
   INTERRUPT_KEPT: '已保留 worktree，可稍后使用 clawt remove 手动清理',
   /** 配置文件损坏，已重新生成默认配置 */
   CONFIG_CORRUPTED: '配置文件损坏或无法解析，已重新生成默认配置',
+  /** 配置已恢复为默认值 */
+  CONFIG_RESET_SUCCESS: '✓ 配置已恢复为默认值',
   /** 分隔线 */
   SEPARATOR: '────────────────────────────────────────',
   /** 粗分隔线 */

package/src/utils/config.ts

@@ -27,7 +27,7 @@ export function loadConfig(): ClawtConfig {
 /**
  * 将默认配置写入配置文件
  */
-function writeDefaultConfig(): void {
+export function writeDefaultConfig(): void {
   writeFileSync(CONFIG_PATH, JSON.stringify(DEFAULT_CONFIG, null, 2), 'utf-8');
 }
 

package/src/utils/formatter.ts

@@ -78,6 +78,18 @@ export function confirmDestructiveAction(dangerousCommand: string, description:
   return confirmAction('是否继续？');
 }
 
+/**
+ * 判断 worktree 是否处于空闲状态（0 个提交、无变更、无未提交修改）
+ * @param {WorktreeStatus} status - worktree 变更统计信息
+ * @returns {boolean} 是否空闲
+ */
+export function isWorktreeIdle(status: WorktreeStatus): boolean {
+  return status.commitCount === 0
+    && status.insertions === 0
+    && status.deletions === 0
+    && !status.hasDirtyFiles;
+}
+
 /**
  * 将 WorktreeStatus 格式化为带颜色的字符串
  * @param {WorktreeStatus} status - worktree 变更统计信息

package/src/utils/index.ts

@@ -47,8 +47,8 @@ export {
 export { sanitizeBranchName, generateBranchNames, validateBranchesNotExist } from './branch.js';
 export { validateMainWorktree, validateGitInstalled, validateClaudeCodeInstalled } from './validation.js';
 export { createWorktrees, getProjectWorktrees, getProjectWorktreeDir, cleanupWorktrees, getWorktreeStatus } from './worktree.js';
-export { loadConfig, getConfigValue, ensureClawtDirs } from './config.js';
-export { printSuccess, printError, printWarning, printInfo, printSeparator, printDoubleSeparator, confirmAction, confirmDestructiveAction, formatWorktreeStatus } from './formatter.js';
+export { loadConfig, writeDefaultConfig, getConfigValue, ensureClawtDirs } from './config.js';
+export { printSuccess, printError, printWarning, printInfo, printSeparator, printDoubleSeparator, confirmAction, confirmDestructiveAction, formatWorktreeStatus, isWorktreeIdle } from './formatter.js';
 export { ensureDir, removeEmptyDir } from './fs.js';
 export { multilineInput } from './prompt.js';
 export { launchInteractiveClaude } from './claude.js';