clawt 3.1.2 → 3.2.0

package/dist/postinstall.js

@@ -171,6 +171,8 @@ var VALIDATE_MESSAGES = {
   \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 检测到目标 worktree 无新变更 */
+  INCREMENTAL_VALIDATE_NO_CHANGES: (branch) => `\u5206\u652F ${branch} \u81EA\u4E0A\u6B21 validate \u4EE5\u6765\u6CA1\u6709\u65B0\u7684\u53D8\u66F4\uFF0C\u5DF2\u6062\u590D\u5230\u4E0A\u6B21\u9A8C\u8BC1\u72B6\u6001`,
   /** validate 状态已清理 */
   VALIDATE_CLEANED: (branch) => `\u2713 \u5206\u652F ${branch} \u7684 validate \u72B6\u6001\u5DF2\u6E05\u7406`,
   /** validate patch apply 失败，提示用户同步主分支 */
@@ -437,7 +439,11 @@ var INIT_MESSAGES = {
   /** 项目未初始化（requireProjectConfig 使用） */
   PROJECT_NOT_INITIALIZED: "\u9879\u76EE\u5C1A\u672A\u521D\u59CB\u5316\uFF0C\u8BF7\u5148\u6267\u884C clawt init \u8BBE\u7F6E\u4E3B\u5DE5\u4F5C\u5206\u652F",
   /** 项目配置缺少 clawtMainWorkBranch 字段 */
-  PROJECT_CONFIG_MISSING_BRANCH: "\u9879\u76EE\u914D\u7F6E\u7F3A\u5C11\u4E3B\u5DE5\u4F5C\u5206\u652F\u4FE1\u606F\uFF0C\u8BF7\u91CD\u65B0\u6267\u884C clawt init \u8BBE\u7F6E\u4E3B\u5DE5\u4F5C\u5206\u652F"
+  PROJECT_CONFIG_MISSING_BRANCH: "\u9879\u76EE\u914D\u7F6E\u7F3A\u5C11\u4E3B\u5DE5\u4F5C\u5206\u652F\u4FE1\u606F\uFF0C\u8BF7\u91CD\u65B0\u6267\u884C clawt init \u8BBE\u7F6E\u4E3B\u5DE5\u4F5C\u5206\u652F",
+  /** init show 交互式面板选择配置项提示 */
+  INIT_SELECT_PROMPT: "\u9009\u62E9\u8981\u4FEE\u6539\u7684\u9879\u76EE\u914D\u7F6E\u9879",
+  /** init show 交互式面板配置项修改成功 */
+  INIT_SET_SUCCESS: (key, value) => `\u2713 \u9879\u76EE\u914D\u7F6E ${key} \u5DF2\u8BBE\u7F6E\u4E3A ${value}`
 };
 
 // src/constants/messages/interactive-panel.ts
@@ -553,6 +559,32 @@ function deriveConfigDescriptions(definitions) {
 var DEFAULT_CONFIG = deriveDefaultConfig(CONFIG_DEFINITIONS);
 var CONFIG_DESCRIPTIONS = deriveConfigDescriptions(CONFIG_DEFINITIONS);
 
+// src/constants/project-config.ts
+var PROJECT_CONFIG_DEFINITIONS = {
+  clawtMainWorkBranch: {
+    defaultValue: "",
+    description: "\u4E3B worktree \u7684\u5DE5\u4F5C\u5206\u652F\u540D"
+  },
+  validateRunCommand: {
+    defaultValue: void 0,
+    description: "validate \u6210\u529F\u540E\u81EA\u52A8\u6267\u884C\u7684\u547D\u4EE4\uFF08-r \u7684\u9ED8\u8BA4\u503C\uFF09"
+  }
+};
+function deriveDefaultConfig2(definitions) {
+  const entries = Object.entries(definitions).map(
+    ([key, def]) => [key, def.defaultValue]
+  );
+  return Object.fromEntries(entries);
+}
+function deriveConfigDescriptions2(definitions) {
+  const entries = Object.entries(definitions).map(
+    ([key, def]) => [key, def.description]
+  );
+  return Object.fromEntries(entries);
+}
+var PROJECT_DEFAULT_CONFIG = deriveDefaultConfig2(PROJECT_CONFIG_DEFINITIONS);
+var PROJECT_CONFIG_DESCRIPTIONS = deriveConfigDescriptions2(PROJECT_CONFIG_DEFINITIONS);
+
 // src/constants/update.ts
 var UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 

package/docs/config.md

@@ -85,7 +85,8 @@ clawt config reset
 
 - 配置项类型定义：`ConfigItemDefinition` 新增可选字段 `allowedValues`（`readonly string[]`），仅对 string 类型有效，用于枚举值校验和交互式 Select 提示
 - 值解析与提示策略：`src/utils/config-strategy.ts` 中的 `parseConfigValue()`（CLI 字符串解析）和 `promptConfigValue()`（交互式提示），基于类型和 `allowedValues` 自动分发
+- 交互式配置编辑：`handleInteractiveConfigSet` 调用通用的 `interactiveConfigEditor`（`src/utils/config-strategy.ts`），传入 `CONFIG_DEFINITIONS` 和 `disabledKeys`（对象类型配置项禁用映射），不再在 config 命令中直接构建选择列表和调用 `promptConfigValue`
 - `saveConfig(config)`：`src/utils/config.ts` 中新增的通用配置写入函数，将完整配置对象持久化到文件
-- `formatConfigValue(value)`：支持 boolean（绿色/黄色）和 string/number（青色）的格式化显示。对象类型配置项（如 `aliases`）在交互式列表中通过 `JSON.stringify` 以暗淡色显示
+- `formatConfigValue(value)`：支持 boolean（绿色/黄色）和 string/number（青色）的格式化显示。`undefined` / `null` 值显示为暗淡色的 `(未设置)`。对象类型配置项（如 `aliases`）在交互式列表中通过 `JSON.stringify` 以暗淡色显示
 
 ---

package/docs/init.md

@@ -18,11 +18,11 @@ clawt init show
 | 参数/子命令 | 必填 | 说明 |
 | --- | --- | --- |
 | `-b` | 否 | 指定主工作分支名。不传则使用当前分支 |
-| `show` | 否 | 查看当前项目的 init 配置 |
+| `show` | 否 | 交互式查看和修改项目配置 |
 
 **功能说明：**
 
-初始化项目级配置，将指定分支记录为该项目的主工作分支（`clawtMainWorkBranch`）。该配置用于 `create` / `run` 时检测当前分支是否为主工作分支，并在偏离时提醒用户。详见 [2.6 项目级配置](#26-项目级配置)。
+初始化项目级配置，将指定分支记录为该项目的主工作分支（`clawtMainWorkBranch`）。该配置用于 `create` / `run` 时检测当前分支是否为主工作分支，并在偏离时提醒用户。`init show` 子命令提供交互式面板，可查看和修改所有项目配置项（如 `validateRunCommand`）。项目级配置的完整说明见 [project-config.md](./project-config.md)。
 
 **运行流程（设置模式）：**
 
@@ -40,7 +40,12 @@ clawt init show
 1. **主 worktree 校验** (2.1)
 2. **读取项目级配置**：读取 `~/.clawt/projects/<projectName>/config.json`
    - 配置不存在 → 抛出错误 `项目尚未初始化，请先执行 clawt init 设置主工作分支`
-   - 配置存在 → 以 JSON 格式输出配置内容
+   - 配置存在 → 进入交互式面板
+3. **交互式配置编辑**：调用 `interactiveConfigEditor`（`src/utils/config-strategy.ts`），基于 `PROJECT_CONFIG_DEFINITIONS` 构建配置项列表（详见 [project-config.md](./project-config.md)）
+   - 列出所有项目配置项，显示名称、当前值和描述
+   - 用户选择配置项后，根据值类型自动选择输入方式（与全局配置的交互式编辑逻辑一致）
+4. **持久化修改**：将修改后的值合并到当前配置并写入配置文件
+5. **输出成功提示**：`✓ 项目配置 <key> 已设置为 <value>`
 
 **输出格式：**
 
@@ -51,10 +56,8 @@ clawt init show
 # 更新已有配置
 ✓ 已将主工作分支从 develop 更新为 main
 
-# show 查看配置（JSON 格式输出）
-{
-  "clawtMainWorkBranch": "main"
-}
+# show 交互式修改成功
+✓ 项目配置 validateRunCommand 已设置为 npm test
 
 # show 未初始化（抛出错误）
 项目尚未初始化，请先执行 clawt init 设置主工作分支
@@ -62,4 +65,10 @@ clawt init show
 
 **重复执行：** 支持重复执行，后一次覆盖前一次的配置。
 
+**实现要点：**
+
+- `init show` 子命令从 JSON 展示改为交互式面板，调用 `interactiveConfigEditor`（`src/utils/config-strategy.ts`）实现通用交互式配置编辑
+- 配置项定义来自 `PROJECT_CONFIG_DEFINITIONS`（`src/constants/project-config.ts`），详见 [项目级配置文档](./project-config.md)
+- 消息常量：`MESSAGES.INIT_SELECT_PROMPT`（选择配置项提示语）、`MESSAGES.INIT_SET_SUCCESS`（修改成功提示），定义在 `src/constants/messages/init.ts`
+
 ---

package/docs/project-config.md

@@ -0,0 +1,132 @@
+### 项目级配置
+
+#### 概述
+
+项目级配置是每个 Git 项目独立的 clawt 配置，用于记录该项目特有的设置（如主工作分支名、validate 自动运行命令等）。与全局配置（`~/.clawt/config.json`，见 [config-file.md](./config-file.md)）不同，项目级配置按项目隔离存储。
+
+#### 存放路径
+
+```
+~/.clawt/projects/<projectName>/config.json
+```
+
+其中 `<projectName>` 为项目根目录的目录名（通过 `git rev-parse --show-toplevel` 获取后取 `basename`）。
+
+#### 配置项列表
+
+```json
+{
+  "clawtMainWorkBranch": "main",
+  "validateRunCommand": "npm test"
+}
+```
+
+| 配置项 | 类型 | 必填 | 默认值 | 说明 |
+| --- | --- | --- | --- | --- |
+| `clawtMainWorkBranch` | `string` | 是 | `""` | 项目的主工作分支名，用于 create 时检测当前分支是否为主分支，以及 sync、merge 等命令获取主分支名 |
+| `validateRunCommand` | `string` | 否 | `undefined` | validate 成功后自动执行的命令（作为 `-r` 选项的默认值）。不传 `-r` 时，validate 命令会自动从此项读取 |
+
+#### 配置项定义数据源
+
+项目级配置项的完整定义集中在 `src/constants/project-config.ts` 中的 `PROJECT_CONFIG_DEFINITIONS` 常量，作为**单一数据源**（Single Source of Truth）。新增项目配置项只需在此处维护，`PROJECT_DEFAULT_CONFIG` 和 `PROJECT_CONFIG_DESCRIPTIONS` 会自动从中派生：
+
+```typescript
+// src/constants/project-config.ts
+
+export const PROJECT_CONFIG_DEFINITIONS: ProjectConfigDefinitions = {
+  clawtMainWorkBranch: {
+    defaultValue: '',
+    description: '主 worktree 的工作分支名',
+  },
+  validateRunCommand: {
+    defaultValue: undefined as unknown as string | undefined,
+    description: 'validate 成功后自动执行的命令（-r 的默认值）',
+  },
+};
+
+/** 项目默认配置（从 PROJECT_CONFIG_DEFINITIONS 自动派生） */
+export const PROJECT_DEFAULT_CONFIG: Required<ProjectConfig> = deriveDefaultConfig(PROJECT_CONFIG_DEFINITIONS);
+
+/** 项目配置项描述映射（从 PROJECT_CONFIG_DEFINITIONS 自动派生） */
+export const PROJECT_CONFIG_DESCRIPTIONS: Record<keyof Required<ProjectConfig>, string> = deriveConfigDescriptions(PROJECT_CONFIG_DEFINITIONS);
+```
+
+#### 相关类型定义
+
+类型定义位于 `src/types/projectConfig.ts`：
+
+| 类型 | 说明 |
+| --- | --- |
+| `ProjectConfig` | 项目级配置接口，包含 `clawtMainWorkBranch`（必填）和 `validateRunCommand`（可选） |
+| `ProjectConfigItemDefinition<T>` | 单个配置项定义，含 `defaultValue`（默认值）、`description`（描述）、可选 `allowedValues`（枚举值列表，仅对 string 类型有效） |
+| `ProjectConfigDefinitions` | 所有配置项的完整定义映射，键为 `ProjectConfig` 的所有属性名，值为对应的 `ProjectConfigItemDefinition` |
+
+```typescript
+// src/types/projectConfig.ts
+
+export interface ProjectConfig {
+  clawtMainWorkBranch: string;
+  validateRunCommand?: string;
+}
+
+export interface ProjectConfigItemDefinition<T> {
+  defaultValue: T;
+  description: string;
+  allowedValues?: T extends string ? readonly string[] : never;
+}
+
+export type ProjectConfigDefinitions = {
+  [K in keyof Required<ProjectConfig>]: ProjectConfigItemDefinition<ProjectConfig[K]>;
+};
+```
+
+#### 工具函数
+
+工具函数位于 `src/utils/project-config.ts`：
+
+| 函数 | 签名 | 说明 |
+| --- | --- | --- |
+| `getProjectConfigPath` | `(projectName: string) => string` | 获取项目配置文件的完整路径 |
+| `loadProjectConfig` | `() => ProjectConfig \| null` | 加载当前项目的配置，配置文件不存在或解析失败时返回 `null` |
+| `saveProjectConfig` | `(config: ProjectConfig) => void` | 保存项目配置到文件，自动创建项目子目录 |
+| `requireProjectConfig` | `() => ProjectConfig` | 获取当前项目配置，不存在或缺少 `clawtMainWorkBranch` 时抛出 `ClawtError` |
+| `getMainWorkBranch` | `() => string` | 从项目配置中获取主工作分支名（内部调用 `requireProjectConfig`） |
+| `getValidateRunCommand` | `() => string \| undefined` | 从项目配置中获取 validate 自动执行命令，未配置时返回 `undefined` |
+
+#### 设置方式
+
+通过 `clawt init` 命令设置（详见 [init.md](./init.md)）：
+
+```bash
+# 以当前分支作为主工作分支初始化
+clawt init
+
+# 指定主工作分支名
+clawt init -b <branchName>
+
+# 交互式查看和修改所有项目配置项
+clawt init show
+```
+
+`init show` 子命令调用通用的 `interactiveConfigEditor`（`src/utils/config-strategy.ts`），基于 `PROJECT_CONFIG_DEFINITIONS` 构建配置项列表，提供交互式面板供用户查看和修改所有项目配置项。
+
+#### 前置校验
+
+除 `clawt init` 以外的所有核心命令（create、run、validate、sync、remove、merge、reset），执行时都会校验项目级配置是否存在。如果未执行过 `clawt init`，命令会直接报错并提示用户先初始化：
+
+```
+✗ 该项目尚未初始化，请先执行 clawt init -b<branchName>设置主工作分支
+```
+
+> **实现细节**：`ensureOnMainWorkBranch()` 内部已通过 `getMainWorkBranch()` -> `requireProjectConfig()` 完成了项目配置校验，因此调用了 `ensureOnMainWorkBranch` 的命令（create、run、validate、sync、remove、merge）无需再显式调用 `requireProjectConfig()`，避免重复校验。仅 reset 命令因不调用 `ensureOnMainWorkBranch`，需要自行调用 `requireProjectConfig()`。
+
+#### 路径常量
+
+在 `src/constants/paths.ts` 中定义：
+
+```typescript
+/** 项目级配置目录 ~/.clawt/projects/ */
+export const PROJECTS_CONFIG_DIR = join(CLAWT_HOME, 'projects');
+```
+
+---

package/docs/spec.md

@@ -10,7 +10,8 @@
 - [1. 技术栈](#1-技术栈)
 - [2. 核心概念](#2-核心概念)
   - [2.5 验证分支](#25-验证分支)
-  - [2.6 项目级配置](#26-项目级配置)
+  - [2.6 项目级配置](#26-项目级配置)（详见 [project-config.md](./project-config.md)）
+  - [2.7 通用交互式配置编辑器](#27-通用交互式配置编辑器)
 - [3. 全局目录结构](#3-全局目录结构)
 - [4. 命令总览](#4-命令总览)
 - [5. 需求场景详细设计](#5-需求场景详细设计)
@@ -197,38 +198,46 @@ export const VALIDATE_BRANCH_PREFIX = 'clawt-validate-';
 
 ### 2.6 项目级配置
 
-#### 存放位置
+每个 Git 项目独立的 clawt 配置，存放在 `~/.clawt/projects/<projectName>/config.json`。包含项目的主工作分支名（`clawtMainWorkBranch`）、validate 自动运行命令（`validateRunCommand`）等配置项。通过 `clawt init` 命令设置，核心命令执行前会校验该配置是否存在。
 
-```
-~/.clawt/projects/<projectName>/config.json
-```
+详细的配置项列表、类型定义、工具函数和设置方式见 [项目级配置文档](./project-config.md)。
 
-#### 配置内容
+### 2.7 通用交互式配置编辑器
 
-```json
-{
-  "clawtMainWorkBranch": "main"
-}
+`interactiveConfigEditor`（`src/utils/config-strategy.ts`）是一个通用的交互式配置编辑函数，供全局配置（`config` 命令）和项目级配置（`init show` 子命令）复用。
+
+**函数签名：**
+
+```typescript
+async function interactiveConfigEditor<T extends object>(
+  config: T,
+  definitions: Record<string, { description: string; allowedValues?: readonly string[] }>,
+  options?: { selectPrompt?: string; disabledKeys?: Record<string, string> },
+): Promise<{ key: keyof T; newValue: unknown }>
 ```
 
-| 配置项 | 类型 | 说明 |
-| --- | --- | --- |
-| `clawtMainWorkBranch` | `string` | 项目的主工作分支名，用于 create 时检测当前分支是否为主分支 |
+**参数说明：**
 
-#### 设置方式
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| `config` | `T` | 当前配置对象 |
+| `definitions` | `Record<string, { description; allowedValues? }>` | 配置项定义映射（含描述和可选枚举值） |
+| `options.selectPrompt` | `string` | 可选，选择配置项的提示语（默认使用全局配置的提示语） |
+| `options.disabledKeys` | `Record<string, string>` | 可选，不可编辑的键及其禁用提示文本 |
 
-通过 `clawt init` 命令设置（见 [5.19 初始化项目级配置](#519-初始化项目级配置)）。
+**行为：**
 
-除 `clawt init` 以外的所有核心命令（create、run、validate、sync、remove、merge、reset），执行时都会校验项目级配置是否存在。如果未执行过 `clawt init`，命令会直接报错并提示用户先初始化。
+1. 根据 `definitions` 构建选择列表，显示配置项名称、当前值（通过 `formatConfigValue` 格式化）和描述
+2. `disabledKeys` 中的配置项标灰不可选，显示禁用提示
+3. 用户选择配置项后，根据值类型自动选择输入方式（布尔 → Select、数字 → Input、字符串+枚举 → Select、字符串 → Input）
+4. 返回用户修改的 key 和新值，由调用方负责持久化
 
-#### 路径常量
+**调用场景：**
 
-在 `src/constants/paths.ts` 中新增：
+- `config` 命令：传入 `loadConfig()` + `CONFIG_DEFINITIONS` + `disabledKeys`（对象类型配置项禁用）
+- `init show`：传入 `requireProjectConfig()` + `PROJECT_CONFIG_DEFINITIONS` + `selectPrompt`
 
-```typescript
-/** 项目级配置目录 ~/.clawt/projects/ */
-export const PROJECTS_CONFIG_DIR = join(CLAWT_HOME, 'projects');
-```
+同时，`promptConfigValue` 和 `formatConfigValue` 的类型签名已从 `ClawtConfig` 专用类型放宽为通用类型（`string` / `unknown`），以支持不同配置体系复用。`formatConfigValue` 新增了 `undefined` / `null` 值的处理，显示为暗淡色的 `(未设置)`。
 
 ---
 
@@ -245,6 +254,7 @@ export const PROJECTS_CONFIG_DIR = join(CLAWT_HOME, 'projects');
 │   └── <project-name>/                  # 以项目名分组
 │       ├── <branchName>.tree            # 每个分支一个 tree hash 快照文件（存储 git tree 对象的 hash）
 │       ├── <branchName>.head            # 每个分支一个 HEAD commit hash 快照文件（存储快照时验证分支的 HEAD commit hash）
+│       ├── <branchName>.staged          # 每个分支一个 staged tree hash 快照文件（存储 validate 结束时暂存区对应的 tree hash，用于无变更时恢复）
 │       └── ...
 ├── projects/<project-name>/             # 项目级配置目录
 │   └── config.json                      # 项目级配置（含 clawtMainWorkBranch）

package/docs/validate.md

@@ -16,7 +16,7 @@ clawt validate [--clean] [-r <command>]
 | ------------- | ---- | ------------------------------------------------------------------------ |
 | `-b`          | 否   | 要验证的 worktree 分支名（支持模糊匹配，不传则列出所有分支供选择）           |
 | `--clean`     | 否   | 清理 validate 状态（重置主 worktree 并删除快照）                            |
-| `-r, --run`   | 否   | validate 成功后在主 worktree 中执行的命令（如测试、构建等）                  |
+| `-r, --run`   | 否   | validate 成功后在主 worktree 中执行的命令（如测试、构建等）。不传时自动从项目配置的 `validateRunCommand` 读取 |
 
 > **限制：** 单次只能验证一个分支，不支持批量验证。
 
@@ -30,7 +30,7 @@ validate 不再在主工作分支上直接 apply patch，而是先切换到目
 
 **快照机制：**
 
-validate 命令引入了**快照（snapshot）机制**来支持增量对比。每次 validate 执行成功后，会将当前全量变更通过 `git write-tree` 保存为 git tree 对象，并将 tree hash 记录到文件（`~/.clawt/validate-snapshots/<project>/<branchName>.tree`），同时将验证分支的 HEAD commit hash 记录到文件（`~/.clawt/validate-snapshots/<project>/<branchName>.head`），用于增量 validate 时对齐基准。当再次执行 validate 时，如果验证分支 HEAD 未变化（正常情况），通过 `git read-tree` 将上次快照的 tree 对象载入暂存区；如果验证分支 HEAD 已变化（sync 后重建了验证分支），则将旧变更 patch（旧 tree 相对于旧 HEAD 的差异）重放到当前 HEAD 暂存区上，避免新旧 tree 基准不同导致 diff 混入 HEAD 变化的内容。最终用户可通过 `git diff` 查看两次 validate 之间的增量差异。
+validate 命令引入了**快照（snapshot）机制**来支持增量对比。每次 validate 执行成功后，会将当前全量变更通过 `git write-tree` 保存为 git tree 对象，并将 tree hash 记录到文件（`~/.clawt/validate-snapshots/<project>/<branchName>.tree`），同时将验证分支的 HEAD commit hash 记录到文件（`~/.clawt/validate-snapshots/<project>/<branchName>.head`），以及 validate 结束时暂存区对应的 tree hash 记录到文件（`~/.clawt/validate-snapshots/<project>/<branchName>.staged`），用于增量 validate 时对齐基准和无变更恢复。当再次执行 validate 时，先计算当前变更的 tree hash 与旧快照对比：如果没有新变更（tree hash 和 HEAD 均未变化），直接通过 `git read-tree` 恢复上次 validate 结束时的暂存区状态，跳过后续步骤；如果有新变更，则继续执行暂存区载入流程——如果验证分支 HEAD 未变化（正常情况），通过 `git read-tree` 将上次快照的 tree 对象载入暂存区；如果验证分支 HEAD 已变化（sync 后重建了验证分支），则将旧变更 patch（旧 tree 相对于旧 HEAD 的差异）重放到当前 HEAD 暂存区上，避免新旧 tree 基准不同导致 diff 混入 HEAD 变化的内容。最终用户可通过 `git diff` 查看两次 validate 之间的增量差异。
 
 **运行流程：**
 
@@ -181,7 +181,7 @@ git restore --staged .
 
 ##### 步骤 7：执行 `--run` 命令（可选）
 
-如果用户传入了 `-r, --run` 选项，在 validate 成功后自动在主 worktree 中执行指定命令：
+如果用户传入了 `-r, --run` 选项，在 validate 成功后自动在主 worktree 中执行指定命令。**如果未传 `-r`，则自动从项目配置的 `validateRunCommand` 字段读取默认命令**（通过 `resolveRunCommand` 解析优先级：`-r` 参数 > 项目配置 > 不执行）。
 
 ```bash
 # 示例：单命令
@@ -281,6 +281,7 @@ clawt validate -b feature-scheme-1 -r "pnpm test & pnpm build"
 - 并行执行：`runParallelCommands()`（`src/utils/shell.ts`），返回 `ParallelCommandResult[]`
 - 结果汇总：`reportParallelResults()`（`src/commands/validate.ts`）
 - 消息常量：`MESSAGES.VALIDATE_PARALLEL_*` 系列（`src/constants/messages/validate.ts`）
+- 命令解析优先级：`resolveRunCommand()`（`src/commands/validate.ts`）负责解析最终要执行的命令，优先使用 `-r` 参数，否则从项目配置读取 `validateRunCommand`（通过 `getValidateRunCommand()`，`src/utils/project-config.ts`）
 
 #### 增量 validate（存在历史快照）
 
@@ -288,7 +289,7 @@ clawt validate -b feature-scheme-1 -r "pnpm test & pnpm build"
 
 ##### 步骤 1：读取旧快照
 
-在清空主 worktree 之前，读取上次保存的快照 tree hash 及当时的 HEAD commit hash。
+在清空主 worktree 之前，读取上次保存的快照 tree hash、当时的 HEAD commit hash 和暂存区 tree hash（`stagedTreeHash`）。
 
 ##### 步骤 2：确保主 worktree 干净
 
@@ -306,9 +307,27 @@ git checkout clawt-validate-<branchName>
 
 通过 patch 方式从目标分支获取最新全量变更（流程同首次 validate 的步骤 4）。如果 patch apply 失败，同样进入自动 sync 交互流程（见首次 validate 的 [patch apply 失败后的自动 sync 流程](#patch-apply-失败后的自动-sync-流程)），validate 流程提前结束。
 
-##### 步骤 5：保存最新快照为 git tree 对象
+##### 步骤 5：检测是否有新变更
 
-将最新全量变更保存为新的 tree 对象（覆盖旧快照），同时记录验证分支的 HEAD commit hash（流程同首次 validate 的步骤 5）。
+计算当前工作目录变更的 tree hash（`git add . → git write-tree → git restore --staged .`），并与旧快照的 tree hash 及 HEAD commit hash 对比：
+
+```bash
+# 计算当前变更的 tree hash
+git add .
+git write-tree  # → newTreeHash
+git restore --staged .
+
+# 获取当前 HEAD
+git rev-parse HEAD  # → currentHeadCommitHash
+
+# 判断是否有新变更
+hasNewChanges = (newTreeHash !== oldTreeHash) || (oldHeadCommitHash !== currentHeadCommitHash)
+```
+
+- **无新变更**（tree hash 和 HEAD 均未变化）→ 不更新快照，直接通过 `git read-tree <oldStagedTreeHash>` 恢复上次 validate 结束时的暂存区状态，输出提示后返回
+- **有新变更** → 继续步骤 6
+
+> 无变更检测避免了重复 validate 时不必要的快照更新和暂存区重载操作。恢复上次暂存区状态后，用户看到的 `git diff` 结果与上次 validate 结束时完全一致。
 
 ##### 步骤 6：将旧变更状态载入暂存区
 
@@ -322,8 +341,8 @@ git checkout clawt-validate-<branchName>
 git read-tree <旧 tree hash>
 ```
 
-- **读取成功** → 结果：暂存区=上次快照，工作目录=最新全量变更（用户可通过 `git diff` 查看增量差异）
-- **读取失败**（tree 对象可能被 git gc 回收）→ 降级为全量模式，暂存区保持为空，等同于首次 validate 的结果
+- **读取成功** → 记录 `newStagedTreeHash = oldTreeHash`，结果：暂存区=上次快照，工作目录=最新全量变更（用户可通过 `git diff` 查看增量差异）
+- **读取失败**（tree 对象可能被 git gc 回收）→ 降级为全量模式，写入快照（`stagedTreeHash` 为空）后返回，暂存区保持为空，等同于首次 validate 的结果
 
 > 这是最常见的路径。相比重构前，正常情况不再需要处理 HEAD 变化的复杂逻辑，代码路径更简单、更可靠。
 
@@ -343,26 +362,49 @@ git apply --cached --check < patch
 
 # 无冲突：apply --cached 到当前 HEAD 暂存区
 git apply --cached < patch
+
+# 记录暂存区的 tree hash
+git write-tree  # → newStagedTreeHash
 ```
 
 - **patch 为空**（旧变更为空）→ 暂存区保持干净
-- **无冲突** → apply --cached 到当前 HEAD 暂存区，结果与正常情况一致
-- **有冲突** → 降级为全量模式（暂存区保持为空），等同于首次 validate 的结果
+- **无冲突** → apply --cached 到当前 HEAD 暂存区，通过 `git write-tree` 记录 `newStagedTreeHash`，结果与正常情况一致
+- **有冲突** → 降级为全量模式（暂存区保持为空），写入快照（`stagedTreeHash` 为空）后返回
 
-##### 步骤 7：输出成功提示
+##### 步骤 7：写入新快照
+
+将步骤 5 计算的 `newTreeHash`、当前 HEAD commit hash 和步骤 6 记录的 `newStagedTreeHash` 写入快照文件，供下次 validate 使用：
+
+```bash
+# 写入 ~/.clawt/validate-snapshots/<project>/<branchName>.tree
+echo <newTreeHash>
+
+# 写入 ~/.clawt/validate-snapshots/<project>/<branchName>.head
+echo <currentHeadCommitHash>
+
+# 写入 ~/.clawt/validate-snapshots/<project>/<branchName>.staged
+echo <newStagedTreeHash>
+```
+
+> `stagedTreeHash` 记录了 validate 结束时暂存区的完整状态。下次 validate 如果检测到无新变更，可直接通过此值恢复暂存区，避免重复执行 read-tree 或 apply --cached 流程。
+
+##### 步骤 8：输出成功提示
 
 ```
 # 增量模式成功
 ✓ 已将分支 feature-scheme-1 的最新变更应用到主 worktree（增量模式）
   暂存区 = 上次快照，工作目录 = 最新变更
 
+# 增量无变更
+分支 feature-scheme-1 自上次 validate 以来没有新的变更，已恢复到上次验证状态
+
 # 增量降级为全量
 ✓ 已切换到验证分支 clawt-validate-feature-scheme-1 并应用分支 feature-scheme-1 的变更
   可以开始验证了
 ```
 
-##### 步骤 8：执行 `--run` 命令（可选）
+##### 步骤 9：执行 `--run` 命令（可选）
 
-与首次 validate 的步骤 7 相同，增量 validate 成功后也会执行 `-r, --run` 指定的命令。
+与首次 validate 的步骤 7 相同，增量 validate 成功后也会执行 `-r, --run` 指定的命令（或从项目配置 `validateRunCommand` 读取的默认命令）。
 
 ---

package/package.json

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

package/src/commands/config.ts

@@ -1,7 +1,5 @@
 import type { Command } from 'commander';
-import chalk from 'chalk';
-import Enquirer from 'enquirer';
-import { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, MESSAGES, CONFIG_ALIAS_DISABLED_HINT } from '../constants/index.js';
+import { DEFAULT_CONFIG, CONFIG_DEFINITIONS, MESSAGES, CONFIG_ALIAS_DISABLED_HINT } from '../constants/index.js';
 import { logger } from '../logger/index.js';
 import {
   loadConfig,
@@ -14,10 +12,8 @@ import {
   isValidConfigKey,
   getValidConfigKeys,
   parseConfigValue,
-  promptConfigValue,
-  formatConfigValue,
+  interactiveConfigEditor,
 } from '../utils/index.js';
-import type { ClawtConfig } from '../types/index.js';
 
 /**
  * 注册 config 命令组：查看和管理全局配置
@@ -118,36 +114,26 @@ async function handleConfigSet(key?: string, value?: string): Promise<void> {
  */
 async function handleInteractiveConfigSet(): Promise<void> {
   const config = loadConfig();
-  const keys = Object.keys(DEFAULT_CONFIG) as Array<keyof ClawtConfig>;
 
   logger.info('config set 命令执行，进入交互式配置');
 
-  // 构建选择列表，显示配置项名称、当前值和描述
-  // 对象类型配置项（如 aliases）标灰不可选，提示用户通过专用命令管理
-  const choices = keys.map((k) => {
-    const isObject = typeof DEFAULT_CONFIG[k] === 'object';
-    return {
-      name: k,
-      message: `${k}: ${isObject ? chalk.dim(JSON.stringify(config[k])) : formatConfigValue(config[k])}  ${chalk.dim(`— ${CONFIG_DESCRIPTIONS[k]}`)}`,
-      ...(isObject && { disabled: CONFIG_ALIAS_DISABLED_HINT }),
-    };
-  });
-
-  // @ts-expect-error enquirer 类型声明未导出 Select 类，但运行时存在
-  const selectedKey: keyof ClawtConfig = await new Enquirer.Select({
-    message: MESSAGES.CONFIG_SELECT_PROMPT,
-    choices,
-  }).run();
+  // 构建对象类型配置项的禁用映射（如 aliases 需通过专用命令管理）
+  const disabledKeys: Record<string, string> = {};
+  for (const k of Object.keys(DEFAULT_CONFIG)) {
+    if (typeof DEFAULT_CONFIG[k as keyof typeof DEFAULT_CONFIG] === 'object') {
+      disabledKeys[k] = CONFIG_ALIAS_DISABLED_HINT;
+    }
+  }
 
-  // 根据类型和 allowedValues 自动选择提示策略
-  const currentValue = config[selectedKey];
-  const newValue = await promptConfigValue(selectedKey, currentValue);
+  const { key, newValue } = await interactiveConfigEditor(config, CONFIG_DEFINITIONS, {
+    disabledKeys,
+  });
 
   // 持久化并提示成功
-  (config as unknown as Record<string, unknown>)[selectedKey] = newValue;
+  (config as unknown as Record<string, unknown>)[key as string] = newValue;
   saveConfig(config);
 
-  printSuccess(MESSAGES.CONFIG_SET_SUCCESS(selectedKey, String(newValue)));
+  printSuccess(MESSAGES.CONFIG_SET_SUCCESS(key as string, String(newValue)));
 }
 
 /**

package/src/commands/init.ts

@@ -1,8 +1,8 @@
 import type { Command } from 'commander';
 import { Command as Cmd } from 'commander';
 import { logger } from '../logger/index.js';
-import { MESSAGES } from '../constants/index.js';
-import type { InitOptions } from '../types/index.js';
+import { MESSAGES, PROJECT_CONFIG_DEFINITIONS } from '../constants/index.js';
+import type { InitOptions, ProjectConfig } from '../types/index.js';
 import {
   validateMainWorktree,
   getCurrentBranch,
@@ -10,8 +10,7 @@ import {
   saveProjectConfig,
   requireProjectConfig,
   printSuccess,
-  printInfo,
-  safeStringify,
+  interactiveConfigEditor,
 } from '../utils/index.js';
 
 /**
@@ -27,24 +26,36 @@ export function registerInitCommand(program: Command): void {
       await handleInit(options);
     });
 
-  // 注册 show 子命令：展示当前项目配置
+  // 注册 show 子命令：交互式查看和修改项目配置
   initCmd.addCommand(
     new Cmd('show')
-      .description('展示当前项目的 init 配置')
-      .action(() => {
-        handleInitShow();
+      .description('交互式查看和修改项目配置')
+      .action(async () => {
+        await handleInitShow();
       }),
   );
 }
 
 /**
- * 处理 init show 子命令：以 JSON 格式展示当前项目完整配置
+ * 处理 init show 子命令：交互式面板展示和修改项目配置
  */
-function handleInitShow(): void {
+async function handleInitShow(): Promise<void> {
   validateMainWorktree();
   const config = requireProjectConfig();
-  const configJson = safeStringify(config);
-  printInfo(MESSAGES.INIT_SHOW(configJson));
+
+  logger.info('init show 命令执行，进入交互式项目配置');
+
+  const { key, newValue } = await interactiveConfigEditor(
+    config as Required<ProjectConfig>,
+    PROJECT_CONFIG_DEFINITIONS,
+    { selectPrompt: MESSAGES.INIT_SELECT_PROMPT },
+  );
+
+  // 合并修改后的值并持久化
+  const updatedConfig: ProjectConfig = { ...config, [key]: newValue };
+  saveProjectConfig(updatedConfig);
+
+  printSuccess(MESSAGES.INIT_SET_SUCCESS(key as string, String(newValue)));
 }
 
 /**