clawt 2.13.0 → 2.14.1

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.13.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,8 +1,22 @@
 import type { Command } from 'commander';
 import chalk from 'chalk';
-import { CONFIG_PATH, DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, MESSAGES } from '../constants/index.js';
+import Enquirer from 'enquirer';
+import { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, MESSAGES, CONFIG_ALIAS_DISABLED_HINT } from '../constants/index.js';
 import { logger } from '../logger/index.js';
-import { loadConfig, writeDefaultConfig, printInfo, printSuccess, printSeparator, confirmDestructiveAction } from '../utils/index.js';
+import {
+  loadConfig,
+  saveConfig,
+  writeDefaultConfig,
+  printInfo,
+  printSuccess,
+  printError,
+  confirmDestructiveAction,
+  isValidConfigKey,
+  getValidConfigKeys,
+  parseConfigValue,
+  promptConfigValue,
+  formatConfigValue,
+} from '../utils/index.js';
 import type { ClawtConfig } from '../types/index.js';
 
 /**
@@ -12,9 +26,9 @@ import type { ClawtConfig } from '../types/index.js';
 export function registerConfigCommand(program: Command): void {
   const configCmd = program
     .command('config')
-    .description('查看和管理全局配置')
-    .action(() => {
-      handleConfig();
+    .description('交互式查看和修改全局配置')
+    .action(async () => {
+      await handleConfigSet();
     });
 
   configCmd
@@ -23,36 +37,20 @@ export function registerConfigCommand(program: Command): void {
     .action(async () => {
       await handleConfigReset();
     });
-}
-
-/**
- * 执行 config 命令的核心逻辑，读取并展示配置列表
- */
-function handleConfig(): void {
-  const config = loadConfig();
 
-  logger.info('config 命令执行，展示全局配置');
-
-  printInfo(`\n${chalk.dim('配置文件路径:')} ${CONFIG_PATH}\n`);
-  printSeparator();
-
-  const keys = Object.keys(DEFAULT_CONFIG) as Array<keyof ClawtConfig>;
-
-  for (let i = 0; i < keys.length; i++) {
-    const key = keys[i];
-    const value = config[key];
-    const description = CONFIG_DESCRIPTIONS[key];
-    const formattedValue = formatConfigValue(value);
-
-    // 第一个配置项前增加空行，与下横线前的空行对称
-    if (i === 0) printInfo('');
-    printInfo(`  ${chalk.bold(key)}: ${formattedValue}`);
-    printInfo(`  ${chalk.dim(description)}`);
-    // 配置项之间及最后一项与下横线之间保持统一空行间距
-    printInfo('');
-  }
+  configCmd
+    .command('set [key] [value]')
+    .description('修改配置项（无参数进入交互式配置）')
+    .action(async (key?: string, value?: string) => {
+      await handleConfigSet(key, value);
+    });
 
-  printSeparator();
+  configCmd
+    .command('get <key>')
+    .description('获取单个配置项的值')
+    .action((key: string) => {
+      handleConfigGet(key);
+    });
 }
 
 /**
@@ -76,22 +74,96 @@ async function handleConfigReset(): Promise<void> {
 }
 
 /**
- * 格式化配置值的显示样式
- * @param {ClawtConfig[keyof ClawtConfig]} value - 配置值
- * @returns {string} 格式化后的字符串
+ * 执行 config set 子命令：直接设置或交互式配置
+ * @param {string} [key] - 配置项名称（可选，无参数进入交互式）
+ * @param {string} [value] - 配置值（可选）
  */
-function formatConfigValue(value: ClawtConfig[keyof ClawtConfig]): string {
-  if (typeof value === 'boolean') {
-    return value ? chalk.green('true') : chalk.yellow('false');
+async function handleConfigSet(key?: string, value?: string): Promise<void> {
+  // 无参数进入交互式配置
+  if (!key) {
+    await handleInteractiveConfigSet();
+    return;
+  }
+
+  // 校验 key 有效性
+  if (!isValidConfigKey(key)) {
+    printError(MESSAGES.CONFIG_INVALID_KEY(key, getValidConfigKeys()));
+    return;
+  }
+
+  // 有 key 无 value 时提示缺少参数
+  if (value === undefined) {
+    printError(MESSAGES.CONFIG_MISSING_VALUE(key));
+    return;
+  }
+
+  // 解析并校验值
+  const result = parseConfigValue(key, value);
+  if (!result.success) {
+    printError(result.error);
+    return;
   }
-  // 对象类型（如 aliases）按键值对逐行展示
-  if (typeof value === 'object' && value !== null) {
-    const entries = Object.entries(value);
-    if (entries.length === 0) {
-      return chalk.dim('(无)');
-    }
-    const lines = entries.map(([k, v]) => `    ${chalk.cyan(k)} → ${chalk.cyan(String(v))}`);
-    return '\n' + lines.join('\n');
+
+  // 加载、修改、持久化
+  const config = loadConfig();
+  (config as unknown as Record<string, unknown>)[key] = result.value;
+  saveConfig(config);
+
+  logger.info(`config set 命令执行，设置 ${key} = ${String(result.value)}`);
+  printSuccess(MESSAGES.CONFIG_SET_SUCCESS(key, String(result.value)));
+}
+
+/**
+ * 交互式配置修改：列出所有配置项供用户选择并修改
+ */
+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();
+
+  // 根据类型和 allowedValues 自动选择提示策略
+  const currentValue = config[selectedKey];
+  const newValue = await promptConfigValue(selectedKey, currentValue);
+
+  // 持久化并提示成功
+  (config as unknown as Record<string, unknown>)[selectedKey] = newValue;
+  saveConfig(config);
+
+  printSuccess(MESSAGES.CONFIG_SET_SUCCESS(selectedKey, String(newValue)));
+}
+
+/**
+ * 执行 config get 子命令：获取单个配置项的值
+ * @param {string} key - 配置项名称
+ */
+function handleConfigGet(key: string): void {
+  // 校验 key 有效性
+  if (!isValidConfigKey(key)) {
+    printError(MESSAGES.CONFIG_INVALID_KEY(key, getValidConfigKeys()));
+    return;
   }
-  return chalk.cyan(String(value));
+
+  const config = loadConfig();
+  const value = config[key];
+
+  logger.info(`config get 命令执行，获取 ${key} = ${String(value)}`);
+  printInfo(MESSAGES.CONFIG_GET_VALUE(key, String(value)));
 }

package/src/constants/config.ts

@@ -1,4 +1,5 @@
 import type { ClawtConfig, ConfigDefinitions } from '../types/index.js';
+import { VALID_TERMINAL_APPS } from './terminal.js';
 
 /** Claude Code 系统约束提示，禁止代码执行完成后构建项目验证 */
 export const APPEND_SYSTEM_PROMPT =
@@ -32,10 +33,11 @@ export const CONFIG_DEFINITIONS: ConfigDefinitions = {
   terminalApp: {
     defaultValue: 'auto',
     description: '批量 resume 使用的终端应用：auto（自动检测）、iterm2、terminal（macOS）',
+    allowedValues: VALID_TERMINAL_APPS,
   },
   aliases: {
     defaultValue: {} as Record<string, string>,
-    description: '命令别名映射（通过 clawt alias 命令管理）',
+    description: '命令别名映射',
   },
 };
 

package/src/constants/index.ts

@@ -1,9 +1,10 @@
 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, APPEND_SYSTEM_PROMPT } from './config.js';
+export { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, CONFIG_DEFINITIONS, APPEND_SYSTEM_PROMPT } from './config.js';
 export { AUTO_SAVE_COMMIT_MESSAGE } from './git.js';
 export { DEBUG_LOG_PREFIX, DEBUG_TIMESTAMP_FORMAT } from './logger.js';
 export {

package/src/constants/messages/config.ts

@@ -1,5 +1,30 @@
+/** 对象类型配置项禁用提示（如 aliases 需通过专用命令管理） */
+export const CONFIG_ALIAS_DISABLED_HINT = '(通过 clawt alias 命令管理)';
+
 /** config 命令专属提示消息 */
 export const CONFIG_CMD_MESSAGES = {
   /** 配置已恢复为默认值 */
   CONFIG_RESET_SUCCESS: '✓ 配置已恢复为默认值',
+  /** 配置项设置成功 */
+  CONFIG_SET_SUCCESS: (key: string, value: string) => `✓ ${key} 已设置为 ${value}`,
+  /** 获取配置值显示 */
+  CONFIG_GET_VALUE: (key: string, value: string) => `${key} = ${value}`,
+  /** 无效配置项名称 */
+  CONFIG_INVALID_KEY: (key: string, validKeys: string[]) =>
+    `无效的配置项: ${key}\n可用的配置项: ${validKeys.join(', ')}`,
+  /** 布尔类型值无效 */
+  CONFIG_INVALID_BOOLEAN: (key: string) =>
+    `配置项 ${key} 为布尔类型，仅接受 true 或 false`,
+  /** 数字类型值无效 */
+  CONFIG_INVALID_NUMBER: (key: string) =>
+    `配置项 ${key} 为数字类型，请输入有效的数字`,
+  /** 枚举类型配置项值无效（通用版） */
+  CONFIG_INVALID_ENUM: (key: string, validValues: readonly string[]) =>
+    `配置项 ${key} 仅接受以下值: ${validValues.join(', ')}`,
+  /** 交互式选择配置项提示 */
+  CONFIG_SELECT_PROMPT: '选择要修改的配置项',
+  /** 交互式输入新值提示 */
+  CONFIG_INPUT_PROMPT: (key: string) => `输入 ${key} 的新值`,
+  /** 缺少 value 参数提示 */
+  CONFIG_MISSING_VALUE: (key: string) => `缺少配置值，用法: clawt config set ${key} <value>`,
 } as const;

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/src/types/config.ts

@@ -22,6 +22,8 @@ export interface ConfigItemDefinition<T> {
   defaultValue: T;
   /** 配置项描述，用于 config 命令展示 */
   description: string;
+  /** 可选：允许的枚举值列表，仅对 string 类型有效 */
+  allowedValues?: T extends string ? readonly string[] : never;
 }
 
 /** 所有配置项的完整定义映射 */

package/src/utils/config-strategy.ts

@@ -0,0 +1,196 @@
+import chalk from 'chalk';
+import Enquirer from 'enquirer';
+import { DEFAULT_CONFIG, CONFIG_DEFINITIONS, MESSAGES } from '../constants/index.js';
+import type { ClawtConfig } from '../types/index.js';
+
+/**
+ * 校验 key 是否为有效的配置项名称
+ * @param {string} key - 待校验的配置项名称
+ * @returns {boolean} 是否有效
+ */
+export function isValidConfigKey(key: string): key is keyof ClawtConfig {
+  return key in DEFAULT_CONFIG;
+}
+
+/**
+ * 获取所有有效配置项名称列表
+ * @returns {string[]} 配置项名称数组
+ */
+export function getValidConfigKeys(): string[] {
+  return Object.keys(DEFAULT_CONFIG);
+}
+
+/**
+ * 将字符串值解析并校验为目标配置项的正确类型
+ *
+ * 策略分发规则：
+ * - boolean → 解析 'true'/'false'
+ * - number → Number() 解析
+ * - string + 有 allowedValues → 枚举校验
+ * - string + 无 allowedValues → 无额外校验
+ *
+ * @param {keyof ClawtConfig} key - 配置项名称
+ * @param {string} rawValue - 原始字符串值
+ * @returns {{ success: true; value: ClawtConfig[keyof ClawtConfig] } | { success: false; error: string }} 解析结果
+ */
+export function parseConfigValue(
+  key: keyof ClawtConfig,
+  rawValue: string,
+): { success: true; value: ClawtConfig[keyof ClawtConfig] } | { success: false; error: string } {
+  const expectedType = typeof DEFAULT_CONFIG[key];
+
+  // 布尔类型策略
+  if (expectedType === 'boolean') {
+    if (rawValue === 'true') return { success: true, value: true };
+    if (rawValue === 'false') return { success: true, value: false };
+    return { success: false, error: MESSAGES.CONFIG_INVALID_BOOLEAN(key) };
+  }
+
+  // 数字类型策略
+  if (expectedType === 'number') {
+    const num = Number(rawValue);
+    if (Number.isNaN(num)) {
+      return { success: false, error: MESSAGES.CONFIG_INVALID_NUMBER(key) };
+    }
+    return { success: true, value: num };
+  }
+
+  // 字符串类型：根据 allowedValues 自动选择校验策略
+  const definition = CONFIG_DEFINITIONS[key];
+  if (definition.allowedValues && !definition.allowedValues.includes(rawValue)) {
+    return { success: false, error: MESSAGES.CONFIG_INVALID_ENUM(key, definition.allowedValues) };
+  }
+
+  return { success: true, value: rawValue };
+}
+
+/**
+ * 交互式提示用户输入配置值
+ *
+ * 策略分发规则：
+ * - boolean → Select(true, false)
+ * - number → Input(带数字校验)
+ * - string + 有 allowedValues → Select(枚举列表)
+ * - string + 无 allowedValues → Input(自由输入)
+ *
+ * @param {keyof ClawtConfig} key - 配置项名称
+ * @param {ClawtConfig[keyof ClawtConfig]} currentValue - 当前值
+ * @returns {Promise<ClawtConfig[keyof ClawtConfig]>} 用户输入/选择的新值
+ */
+export async function promptConfigValue(
+  key: keyof ClawtConfig,
+  currentValue: ClawtConfig[keyof ClawtConfig],
+): Promise<ClawtConfig[keyof ClawtConfig]> {
+  const expectedType = typeof currentValue;
+
+  // 布尔类型策略
+  if (expectedType === 'boolean') {
+    return promptBooleanValue(key, currentValue as boolean);
+  }
+
+  // 数字类型策略
+  if (expectedType === 'number') {
+    return promptNumberValue(key, currentValue as number);
+  }
+
+  // 字符串类型：根据 allowedValues 自动选择提示策略
+  const definition = CONFIG_DEFINITIONS[key];
+  if (definition.allowedValues) {
+    return promptEnumValue(key, currentValue as string, definition.allowedValues);
+  }
+
+  return promptStringValue(key, currentValue as string);
+}
+
+/**
+ * 格式化配置值的显示样式
+ * @param {ClawtConfig[keyof ClawtConfig]} value - 配置值
+ * @returns {string} 格式化后的字符串
+ */
+export function formatConfigValue(value: ClawtConfig[keyof ClawtConfig]): string {
+  if (typeof value === 'boolean') {
+    return value ? chalk.green('true') : chalk.yellow('false');
+  }
+  return chalk.cyan(String(value));
+}
+
+/**
+ * 交互式布尔值选择（内部辅助函数）
+ * @param {keyof ClawtConfig} key - 配置项名称
+ * @param {boolean} currentValue - 当前值
+ * @returns {Promise<boolean>} 用户选择的布尔值
+ */
+async function promptBooleanValue(key: keyof ClawtConfig, currentValue: boolean): Promise<boolean> {
+  const choices = [
+    { name: 'true', message: 'true' },
+    { name: 'false', message: 'false' },
+  ];
+
+  // @ts-expect-error enquirer 类型声明未导出 Select 类，但运行时存在
+  const selected: string = await new Enquirer.Select({
+    message: MESSAGES.CONFIG_INPUT_PROMPT(key),
+    choices,
+    initial: currentValue ? 0 : 1,
+  }).run();
+
+  return selected === 'true';
+}
+
+/**
+ * 交互式数字输入（内部辅助函数）
+ * @param {keyof ClawtConfig} key - 配置项名称
+ * @param {number} currentValue - 当前值
+ * @returns {Promise<number>} 用户输入的数字值
+ */
+async function promptNumberValue(key: keyof ClawtConfig, currentValue: number): Promise<number> {
+  // @ts-expect-error enquirer 类型声明未导出 Input 类，但运行时存在
+  const input: string = await new Enquirer.Input({
+    message: MESSAGES.CONFIG_INPUT_PROMPT(key),
+    initial: String(currentValue),
+    validate: (val: string) => {
+      if (Number.isNaN(Number(val))) return '请输入有效的数字';
+      return true;
+    },
+  }).run();
+
+  return Number(input);
+}
+
+/**
+ * 交互式枚举值选择（内部辅助函数，用于有 allowedValues 的 string 配置项）
+ * @param {keyof ClawtConfig} key - 配置项名称
+ * @param {string} currentValue - 当前值
+ * @param {readonly string[]} allowedValues - 允许的枚举值列表
+ * @returns {Promise<string>} 用户选择的枚举值
+ */
+async function promptEnumValue(
+  key: keyof ClawtConfig,
+  currentValue: string,
+  allowedValues: readonly string[],
+): Promise<string> {
+  const choices = allowedValues.map((v) => ({
+    name: v,
+    message: v,
+  }));
+
+  // @ts-expect-error enquirer 类型声明未导出 Select 类，但运行时存在
+  return await new Enquirer.Select({
+    message: MESSAGES.CONFIG_INPUT_PROMPT(key),
+    choices,
+    initial: allowedValues.indexOf(currentValue),
+  }).run();
+}
+
+/**
+ * 交互式字符串自由输入（内部辅助函数，用于无 allowedValues 的 string 配置项）
+ * @param {keyof ClawtConfig} key - 配置项名称
+ * @param {string} currentValue - 当前值
+ * @returns {Promise<string>} 用户输入的字符串值
+ */
+async function promptStringValue(key: keyof ClawtConfig, currentValue: string): Promise<string> {
+  // @ts-expect-error enquirer 类型声明未导出 Input 类，但运行时存在
+  return await new Enquirer.Input({
+    message: MESSAGES.CONFIG_INPUT_PROMPT(key),
+    initial: currentValue,
+  }).run();
+}

package/src/utils/config.ts

@@ -39,6 +39,14 @@ export function writeDefaultConfig(): void {
   writeConfig(DEFAULT_CONFIG);
 }
 
+/**
+ * 将配置对象完整写入配置文件
+ * @param {ClawtConfig} config - 要持久化的配置对象
+ */
+export function saveConfig(config: ClawtConfig): void {
+  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), 'utf-8');
+}
+
 /**
  * 获取配置中指定字段的值
  * @param {keyof ClawtConfig} key - 配置字段名

package/src/utils/index.ts

@@ -48,7 +48,7 @@ export {
 export { sanitizeBranchName, generateBranchNames, validateBranchesNotExist } from './branch.js';
 export { validateMainWorktree, validateGitInstalled, validateClaudeCodeInstalled } from './validation.js';
 export { createWorktrees, getProjectWorktrees, getProjectWorktreeDir, cleanupWorktrees, getWorktreeStatus, createWorktreesByBranches } from './worktree.js';
-export { loadConfig, writeDefaultConfig, writeConfig, getConfigValue, ensureClawtDirs } from './config.js';
+export { loadConfig, writeDefaultConfig, writeConfig, saveConfig, getConfigValue, ensureClawtDirs } from './config.js';
 export { printSuccess, printError, printWarning, printInfo, printSeparator, printDoubleSeparator, confirmAction, confirmDestructiveAction, formatWorktreeStatus, isWorktreeIdle, formatDuration } from './formatter.js';
 export { ensureDir, removeEmptyDir } from './fs.js';
 export { multilineInput } from './prompt.js';
@@ -61,4 +61,5 @@ export { parseTaskFile, loadTaskFile } from './task-file.js';
 export { executeBatchTasks } from './task-executor.js';
 export { detectTerminalApp, openCommandInNewTerminalTab } from './terminal.js';
 export { applyAliases } from './alias.js';
+export { isValidConfigKey, getValidConfigKeys, parseConfigValue, promptConfigValue, formatConfigValue } from './config-strategy.js';