clawt 2.14.0 → 2.14.1

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

@@ -7,7 +7,7 @@
 - 命令流程在 `5. 需求场景详细设计` 下，每个命令一个子章节（5.1-5.14）
 - run 命令对应 `5.2 批量创建 Worktree + 执行 Claude Code 任务`，流程按步骤编号描述
 - merge 命令对应 `5.6 合并验证过的分支`，-b 可选，支持模糊匹配（与 resume/validate 共享匹配逻辑），流程按步骤编号描述
-- config 命令对应 `5.10 查看和管理全局配置`，包含查看配置和 config reset 子命令两部分（使用 `####` 子标题区分）
+- config 命令对应 `5.10 交互式查看和修改全局配置`，包含四个子章节：交互式修改（config / config set 无参数）、直接设置（config set key value）、获取（config get）、恢复默认（config reset），使用 `####` 子标题区分
 - resume 命令对应 `5.11 在已有 Worktree 中恢复会话`，统一使用多选交互（resolveTargetWorktrees），选 1 个当前终端恢复，选多个在独立终端 Tab 批量恢复（-b 可选）
 - validate 命令对应 `5.4 在主 Worktree 验证其他分支`，-b 可选，支持模糊匹配（与 resume 共享匹配逻辑）
 - sync 命令对应 `5.12 将主分支代码同步到目标 Worktree`，-b 可选，支持模糊匹配（与 resume/validate/merge 共享匹配逻辑）
@@ -72,9 +72,9 @@ run 命令有两种模式（自 claudeCodeCommand 特性后）：
   - `formatDuration` 从 `src/utils/progress.ts` 移至 `src/utils/formatter.ts`
   - 进度面板每个任务行末尾显示 worktree 路径（终端可点击跳转）
 
-## 命令清单（11 个）
+## 命令清单（12 个）
 
-`create`、`run`、`resume`、`list`、`remove`、`validate`、`merge`、`config`、`sync`、`reset`、`status`
+`create`、`run`、`resume`、`list`、`remove`、`validate`、`merge`、`config`、`sync`、`reset`、`status`、`alias`
 
 Notes:
 - resume 和 run（交互式模式）共用 `launchInteractiveClaude()`，该函数从 run.ts 提取到 src/utils/claude.ts
@@ -91,6 +91,11 @@ Notes:
 - `promptMultiSelectBranches` 支持「全选」选项（顶部 [select-all]），通过扩展 MultiSelect 覆写 space() 实现全选 toggle
 - `SELECT_ALL_NAME` 和 `SELECT_ALL_LABEL` 常量定义在 `src/constants/prompt.ts`
 - `VALID_TERMINAL_APPS` 和 `ITERM2_APP_PATH` 常量定义在 `src/constants/terminal.ts`
+- config 交互式修改：对象类型配置项（如 `aliases`）在 Enquirer.Select 列表中标灰不可选（`disabled: CONFIG_ALIAS_DISABLED_HINT`），提示用户通过专用命令管理
+- `CONFIG_ALIAS_DISABLED_HINT` 常量定义在 `src/constants/messages/config.ts`，通过 `src/constants/messages/index.ts` 和 `src/constants/index.ts` 导出
+- `parseConfigValue()` 和 `promptConfigValue()` 在 `src/utils/config-strategy.ts`，基于配置项类型和 `allowedValues` 自动分发值解析/提示策略
+- `saveConfig()` 在 `src/utils/config.ts`，通用配置写入函数
+- `ConfigItemDefinition` 支持可选 `allowedValues` 字段（`readonly string[]`），用于 string 类型枚举校验
 
 ## validate 快照机制
 

package/README.md

@@ -143,11 +143,28 @@ clawt status --json   # JSON 格式
 clawt reset
 ```
 
-### `clawt config` — 查看配置
+### `clawt config` — 交互式查看和修改配置
 
 ```bash
-clawt config          # 查看当前配置
-clawt config reset    # 恢复默认配置
+clawt config                          # 交互式修改配置（选择配置项并修改值）
+clawt config set <key> <value>        # 直接设置某个配置项
+clawt config get <key>                # 获取某个配置项的值
+clawt config reset                    # 恢复默认配置
+```
+
+**使用示例：**
+
+```bash
+# 交互式修改（列出所有配置项，方向键选择，根据类型自动提示）
+clawt config
+
+# 直接设置
+clawt config set autoDeleteBranch true
+clawt config set maxConcurrency 4
+clawt config set terminalApp iterm2
+
+# 查看某项配置
+clawt config get maxConcurrency
 ```
 
 ### `clawt alias` — 管理命令别名

package/dist/index.js

@@ -249,6 +249,7 @@ var RESET_MESSAGES = {
 };
 
 // src/constants/messages/config.ts
+var CONFIG_ALIAS_DISABLED_HINT = "(\u901A\u8FC7 clawt alias \u547D\u4EE4\u7BA1\u7406)";
 var CONFIG_CMD_MESSAGES = {
   /** 配置已恢复为默认值 */
   CONFIG_RESET_SUCCESS: "\u2713 \u914D\u7F6E\u5DF2\u6062\u590D\u4E3A\u9ED8\u8BA4\u503C",
@@ -377,7 +378,7 @@ var CONFIG_DEFINITIONS = {
   },
   aliases: {
     defaultValue: {},
-    description: "\u547D\u4EE4\u522B\u540D\u6620\u5C04\uFF08\u901A\u8FC7 clawt alias \u547D\u4EE4\u7BA1\u7406\uFF09"
+    description: "\u547D\u4EE4\u522B\u540D\u6620\u5C04"
   }
 };
 function deriveDefaultConfig(definitions) {
@@ -2469,10 +2470,14 @@ async function handleInteractiveConfigSet() {
   const config2 = loadConfig();
   const keys = Object.keys(DEFAULT_CONFIG);
   logger.info("config set \u547D\u4EE4\u6267\u884C\uFF0C\u8FDB\u5165\u4EA4\u4E92\u5F0F\u914D\u7F6E");
-  const choices = keys.map((k) => ({
-    name: k,
-    message: `${k}: ${formatConfigValue(config2[k])}  ${chalk6.dim(`\u2014 ${CONFIG_DESCRIPTIONS[k]}`)}`
-  }));
+  const choices = keys.map((k) => {
+    const isObject = typeof DEFAULT_CONFIG[k] === "object";
+    return {
+      name: k,
+      message: `${k}: ${isObject ? chalk6.dim(JSON.stringify(config2[k])) : formatConfigValue(config2[k])}  ${chalk6.dim(`\u2014 ${CONFIG_DESCRIPTIONS[k]}`)}`,
+      ...isObject && { disabled: CONFIG_ALIAS_DISABLED_HINT }
+    };
+  });
   const selectedKey = await new Enquirer5.Select({
     message: MESSAGES.CONFIG_SELECT_PROMPT,
     choices

package/dist/postinstall.js

@@ -357,7 +357,7 @@ var CONFIG_DEFINITIONS = {
   },
   aliases: {
     defaultValue: {},
-    description: "\u547D\u4EE4\u522B\u540D\u6620\u5C04\uFF08\u901A\u8FC7 clawt alias \u547D\u4EE4\u7BA1\u7406\uFF09"
+    description: "\u547D\u4EE4\u522B\u540D\u6620\u5C04"
   }
 };
 function deriveDefaultConfig(definitions) {

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-工作区和暂存区)
@@ -174,7 +174,9 @@ git show-ref --verify refs/heads/<branchName> 2>/dev/null
 | `clawt merge`         | 合并某个已验证的 worktree 分支到主 worktree       | 5.6      |
 | `clawt remove`        | 移除 worktree（支持模糊匹配/多选/全部）             | 5.5      |
 | `clawt list`          | 列出当前项目所有 worktree（支持 `--json` 格式输出） | 5.8      |
-| `clawt config`        | 查看全局配置                                     | 5.10     |
+| `clawt config`        | 交互式查看和修改全局配置（等同于 `config set`）      | 5.10     |
+| `clawt config set`    | 修改配置项（无参数进入交互式，有参数直接设置）          | 5.10     |
+| `clawt config get`    | 获取单个配置项的值                                 | 5.10     |
 | `clawt config reset`  | 将配置恢复为默认值                                | 5.10     |
 | `clawt resume`        | 在已有 worktree 中恢复 Claude Code 会话（支持多选批量恢复） | 5.11     |
 | `clawt sync`          | 将主分支最新代码同步到目标 worktree                  | 5.12     |
@@ -1000,51 +1002,82 @@ clawt validate -b feature-scheme --debug
 
 ---
 
-### 5.10 查看和管理全局配置
+### 5.10 交互式查看和修改全局配置
 
 **命令：**
 
 ```bash
-# 查看全局配置
+# 交互式修改配置（等同于 config set 无参数）
 clawt config
 
+# 修改配置项（无参数进入交互式，有参数直接设置）
+clawt config set [key] [value]
+
+# 获取单个配置项的值
+clawt config get <key>
+
 # 将配置恢复为默认值
 clawt config reset
 ```
 
-#### 查看配置
+#### 交互式修改配置（`config` / `config set`）
+
+直接执行 `clawt config` 或 `clawt config set`（不带参数）进入交互式配置修改模式。
 
 **运行流程：**
 
 1. 读取全局配置文件 `~/.clawt/config.json`
-2. 遍历所有配置项（以 `CONFIG_DEFINITIONS` 为单一数据源），逐项展示：
-   - 配置项名称（粗体）
+2. 列出所有配置项供用户选择（`Enquirer.Select`），每项显示：
+   - 配置项名称
    - 当前值（布尔值绿色/黄色，字符串青色）
    - 配置项描述（灰色）
-3. 输出配置文件路径，提示用户可直接编辑
+   - 对象类型配置项（如 `aliases`）标灰不可选，提示用户通过专用命令管理
+3. 用户选择某个配置项后，根据值类型自动选择提示策略：
+   - **boolean 类型** → `Select`（true / false）
+   - **number 类型** → `Input`（带数字校验）
+   - **string 类型 + 有 `allowedValues`** → `Select`（枚举列表）
+   - **string 类型 + 无 `allowedValues`** → `Input`（自由输入）
+4. 将修改后的配置持久化到配置文件
+5. 输出成功提示：`✓ <key> 已设置为 <value>`
 
-**输出格式：**
+#### 直接设置配置项（`config set <key> <value>`）
 
-```
-配置文件路径: ~/.clawt/config.json
-────────────────────────────────────────
-  autoDeleteBranch: false
-  移除 worktree 时是否自动删除对应本地分支
+当带参数执行 `clawt config set <key> <value>` 时，直接修改指定配置项。
 
-  claudeCodeCommand: claude
-  Claude Code CLI 启动指令
+**参数：**
 
-  autoPullPush: false
-  merge 成功后是否自动执行 git pull 和 git push
+| 参数 | 必填 | 说明 |
+| ---- | ---- | ---- |
+| `key` | 否 | 配置项名称（不传则进入交互式模式） |
+| `value` | 否 | 配置值（传了 `key` 时必填） |
 
-  confirmDestructiveOps: true
-  执行破坏性操作（reset、validate --clean）前是否提示确认
+**运行流程：**
 
-────────────────────────────────────────
+1. 校验 `key` 是否为有效的配置项名称（基于 `DEFAULT_CONFIG` 的键列表），无效则输出错误及可用配置项列表
+2. 校验 `value` 是否缺失，缺失则提示用法：`clawt config set <key> <value>`
+3. 根据目标配置项的类型解析并校验值：
+   - **boolean** → 仅接受 `true` 或 `false`
+   - **number** → `Number()` 解析，`NaN` 报错
+   - **string + 有 `allowedValues`** → 校验值是否在枚举列表中
+   - **string + 无 `allowedValues`** → 无额外校验
+4. 加载配置、修改目标项、持久化
+5. 输出成功提示：`✓ <key> 已设置为 <value>`
 
-```
+#### 获取单个配置项（`config get <key>`）
 
-#### 恢复默认配置
+**参数：**
+
+| 参数 | 必填 | 说明 |
+| ---- | ---- | ---- |
+| `key` | 是 | 配置项名称 |
+
+**运行流程：**
+
+1. 校验 `key` 是否为有效的配置项名称，无效则输出错误及可用配置项列表
+2. 读取配置文件，获取目标配置项的值
+3. 输出：`<key> = <value>`
+
+#### 恢复默认配置（`config reset`）
 
 **运行流程：**
 
@@ -1052,6 +1085,13 @@ clawt config reset
 2. 将默认配置写入 `~/.clawt/config.json`（覆盖现有配置文件）
 3. 输出成功提示：`✓ 配置已恢复为默认值`
 
+**实现要点：**
+
+- 配置项类型定义：`ConfigItemDefinition` 新增可选字段 `allowedValues`（`readonly string[]`），仅对 string 类型有效，用于枚举值校验和交互式 Select 提示
+- 值解析与提示策略：`src/utils/config-strategy.ts` 中的 `parseConfigValue()`（CLI 字符串解析）和 `promptConfigValue()`（交互式提示），基于类型和 `allowedValues` 自动分发
+- `saveConfig(config)`：`src/utils/config.ts` 中新增的通用配置写入函数，将完整配置对象持久化到文件
+- `formatConfigValue(value)`：支持 boolean、string、number、对象类型（如 `aliases`，按键值对逐行展示）的格式化显示
+
 ---
 
 ### 5.11 在已有 Worktree 中恢复会话

package/package.json

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

package/src/commands/config.ts

@@ -1,7 +1,7 @@
 import type { Command } from 'commander';
 import chalk from 'chalk';
 import Enquirer from 'enquirer';
-import { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, MESSAGES } from '../constants/index.js';
+import { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, MESSAGES, CONFIG_ALIAS_DISABLED_HINT } from '../constants/index.js';
 import { logger } from '../logger/index.js';
 import {
   loadConfig,
@@ -123,10 +123,15 @@ async function handleInteractiveConfigSet(): Promise<void> {
   logger.info('config set 命令执行，进入交互式配置');
 
   // 构建选择列表，显示配置项名称、当前值和描述
-  const choices = keys.map((k) => ({
-    name: k,
-    message: `${k}: ${formatConfigValue(config[k])}  ${chalk.dim(`— ${CONFIG_DESCRIPTIONS[k]}`)}`,
-  }));
+  // 对象类型配置项（如 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({

package/src/constants/config.ts

@@ -37,7 +37,7 @@ export const CONFIG_DEFINITIONS: ConfigDefinitions = {
   },
   aliases: {
     defaultValue: {} as Record<string, string>,
-    description: '命令别名映射（通过 clawt alias 命令管理）',
+    description: '命令别名映射',
   },
 };
 

package/src/constants/index.ts

@@ -1,6 +1,7 @@
 export { CLAWT_HOME, CONFIG_PATH, LOGS_DIR, WORKTREES_DIR, VALIDATE_SNAPSHOTS_DIR, CLAUDE_PROJECTS_DIR } from './paths.js';
 export { INVALID_BRANCH_CHARS } from './branch.js';
 export { MESSAGES } from './messages/index.js';
+export { CONFIG_ALIAS_DISABLED_HINT } from './messages/index.js';
 export { EXIT_CODES } from './exitCodes.js';
 export { ENABLE_BRACKETED_PASTE, DISABLE_BRACKETED_PASTE, PASTE_THRESHOLD_MS, VALID_TERMINAL_APPS, ITERM2_APP_PATH } from './terminal.js';
 export { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, CONFIG_DEFINITIONS, APPEND_SYSTEM_PROMPT } from './config.js';

package/src/constants/messages/config.ts

@@ -1,3 +1,6 @@
+/** 对象类型配置项禁用提示（如 aliases 需通过专用命令管理） */
+export const CONFIG_ALIAS_DISABLED_HINT = '(通过 clawt alias 命令管理)';
+
 /** config 命令专属提示消息 */
 export const CONFIG_CMD_MESSAGES = {
   /** 配置已恢复为默认值 */

package/src/constants/messages/index.ts

@@ -7,7 +7,9 @@ import { SYNC_MESSAGES } from './sync.js';
 import { RESUME_MESSAGES } from './resume.js';
 import { REMOVE_MESSAGES } from './remove.js';
 import { RESET_MESSAGES } from './reset.js';
-import { CONFIG_CMD_MESSAGES } from './config.js';
+import { CONFIG_CMD_MESSAGES, CONFIG_ALIAS_DISABLED_HINT } from './config.js';
+
+export { CONFIG_ALIAS_DISABLED_HINT };
 import { STATUS_MESSAGES } from './status.js';
 import { ALIAS_MESSAGES } from './alias.js';
 

package/tests/unit/commands/config.test.ts

@@ -2,15 +2,17 @@ import { describe, it, expect, vi, beforeEach } from 'vitest';
 import { Command } from 'commander';
 
 // mock enquirer（必须在所有 import 之前）
-const { mockSelectRun, mockInputRun } = vi.hoisted(() => {
+const { mockSelectRun, mockInputRun, mockSelectConstructorArgs } = vi.hoisted(() => {
   const mockSelectRun = vi.fn();
   const mockInputRun = vi.fn();
-  return { mockSelectRun, mockInputRun };
+  /** 用于捕获 Select 构造时传入的参数 */
+  const mockSelectConstructorArgs: unknown[] = [];
+  return { mockSelectRun, mockInputRun, mockSelectConstructorArgs };
 });
 
 vi.mock('enquirer', () => ({
   default: {
-    Select: function MockSelect() { return { run: mockSelectRun }; },
+    Select: function MockSelect(opts: unknown) { mockSelectConstructorArgs.push(opts); return { run: mockSelectRun }; },
     Input: function MockInput() { return { run: mockInputRun }; },
   },
 }));
@@ -48,6 +50,7 @@ vi.mock('../../../src/constants/index.js', () => ({
     confirmDestructiveOps: true,
     maxConcurrency: 0,
     terminalApp: 'auto',
+    aliases: {},
   },
   CONFIG_DESCRIPTIONS: {
     autoDeleteBranch: '自动删除分支',
@@ -56,6 +59,7 @@ vi.mock('../../../src/constants/index.js', () => ({
     confirmDestructiveOps: '破坏性操作确认',
     maxConcurrency: '最大并发数',
     terminalApp: '终端应用',
+    aliases: '命令别名映射',
   },
   CONFIG_DEFINITIONS: {
     autoDeleteBranch: { defaultValue: false, description: '自动删除分支' },
@@ -64,7 +68,9 @@ vi.mock('../../../src/constants/index.js', () => ({
     confirmDestructiveOps: { defaultValue: true, description: '破坏性操作确认' },
     maxConcurrency: { defaultValue: 0, description: '最大并发数' },
     terminalApp: { defaultValue: 'auto', description: '终端应用', allowedValues: ['auto', 'iterm2', 'terminal'] },
+    aliases: { defaultValue: {}, description: '命令别名映射' },
   },
+  CONFIG_ALIAS_DISABLED_HINT: '(通过 clawt alias 命令管理)',
   MESSAGES: {
     CONFIG_RESET_SUCCESS: '配置已恢复为默认值',
     DESTRUCTIVE_OP_CANCELLED: '已取消操作',
@@ -104,6 +110,7 @@ function createMockConfig() {
     confirmDestructiveOps: true,
     maxConcurrency: 0,
     terminalApp: 'auto',
+    aliases: {},
   };
 }
 
@@ -117,6 +124,7 @@ beforeEach(() => {
   mockedConfirmDestructiveAction.mockReset();
   mockSelectRun.mockReset();
   mockInputRun.mockReset();
+  mockSelectConstructorArgs.length = 0;
 });
 
 describe('registerConfigCommand', () => {
@@ -374,6 +382,29 @@ describe('handleConfigSet — 交互模式', () => {
     );
     expect(mockedPrintSuccess).toHaveBeenCalled();
   });
+
+  it('aliases 选项带 disabled 属性且不可选', async () => {
+    mockedLoadConfig.mockReturnValue(createMockConfig());
+    // 选择一个普通配置项完成交互流程
+    mockSelectRun.mockResolvedValueOnce('autoDeleteBranch');
+    mockSelectRun.mockResolvedValueOnce('true');
+
+    const program = new Command();
+    program.exitOverride();
+    registerConfigCommand(program);
+    await program.parseAsync(['config', 'set'], { from: 'user' });
+
+    // 捕获第一次 Select 构造参数（配置项选择列表）
+    const selectOpts = mockSelectConstructorArgs[0] as { choices: Array<{ name: string; disabled?: string }> };
+    const aliasesChoice = selectOpts.choices.find((c) => c.name === 'aliases');
+    expect(aliasesChoice).toBeDefined();
+    expect(aliasesChoice!.disabled).toBe('(通过 clawt alias 命令管理)');
+
+    // 普通配置项不应有 disabled 属性
+    const normalChoice = selectOpts.choices.find((c) => c.name === 'autoDeleteBranch');
+    expect(normalChoice).toBeDefined();
+    expect(normalChoice!.disabled).toBeUndefined();
+  });
 });
 
 describe('handleConfigGet', () => {