clawt 3.9.13 → 3.10.1

package/docs/config-file.md

@@ -16,6 +16,7 @@
 
 ```json
 {
+  "language": "en",
   "autoDeleteBranch": false,
   "claudeCodeCommand": "claude",
   "autoPullPush": false,
@@ -34,6 +35,7 @@
 
 | 配置项             | 类型      | 默认值    | 说明                                               |
 | ------------------ | --------- | --------- | -------------------------------------------------- |
+| `language` | `'en' \| 'zh-CN'` | `"en"` | 界面语言：`en`（英文）、`zh-CN`（中文）。控制 CLI 输出、提示消息、命令描述等所有面向用户的文本语言。修改后无需重启，下次命令执行时自动生效 |
 | `autoDeleteBranch` | `boolean` | `false`   | 移除 worktree 时是否自动删除对应本地分支（无需每次确认）；merge 成功后是否自动清理 worktree 和分支；run 任务被中断（Ctrl+C）后是否自动清理本次创建的 worktree 和分支 |
 | `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时和 `clawt resume` 在 worktree 中打开交互式界面。可被项目级配置 `claudeCodeCommand` 覆盖（优先级：项目级 > 全局级，详见 [project-config.md](./project-config.md)） |
 | `autoPullPush` | `boolean` | `false` | merge 成功后是否自动执行 git pull 和 git push |

package/docs/config.md

@@ -26,7 +26,7 @@ clawt config reset
 2. 列出所有配置项供用户选择（`Enquirer.Select`），每项显示：
    - 配置项名称
    - 当前值（布尔值绿色/黄色，字符串和数字青色）
-   - 配置项描述（暗淡色 dim）
+   - 配置项描述（暗淡色 dim，根据当前 `language` 配置显示中文或英文描述，通过 `getI18nConfigDescriptions()` 获取）
    - 对象类型配置项（如 `aliases`）标灰不可选，提示用户通过专用命令管理
 3. 用户选择某个配置项后，根据值类型自动选择提示策略：
    - **boolean 类型** → `Select`（true / false）
@@ -84,6 +84,7 @@ clawt config reset
 **实现要点：**
 
 - 配置项类型定义：`ConfigItemDefinition` 新增可选字段 `allowedValues`（`readonly string[]`），仅对 string 类型有效，用于枚举值校验和交互式 Select 提示
+- 配置描述国际化：`getI18nConfigDescriptions()`（`src/constants/config.ts`）根据当前语言返回中文或英文的配置项描述映射，供 `interactiveConfigEditor` 在构建选择列表时使用
 - 值解析与提示策略：`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` 中的通用配置写入函数，将完整配置对象持久化到文件

package/docs/init.md

@@ -50,7 +50,7 @@ clawt init show --json
    - 配置缺少 `clawtMainWorkBranch` 字段 → 抛出错误 `项目配置缺少主工作分支信息，请重新执行 clawt init 设置主工作分支`
    - 配置存在且合法 → 继续
 2.5. **`--json` 模式判断**：如果指定了 `--json` 选项，直接以 JSON 格式输出当前项目配置，跳过交互式流程并返回
-3. **交互式配置编辑**：调用 `interactiveConfigEditor`（`src/utils/config-strategy.ts`），基于 `PROJECT_CONFIG_DEFINITIONS` 构建配置项列表（详见 [project-config.md](./project-config.md)）
+3. **交互式配置编辑**：调用 `interactiveConfigEditor`（`src/utils/config-strategy.ts`），基于 `PROJECT_CONFIG_DEFINITIONS` 构建配置项列表（详见 [project-config.md](./project-config.md)）。配置项描述根据当前 `language` 配置自动选择中文或英文，通过 `getI18nProjectConfigDescriptions()` 获取国际化描述并替换 `PROJECT_CONFIG_DEFINITIONS` 中的 `description` 字段
    - 列出所有项目配置项，显示名称、当前值和描述
    - 用户选择配置项后，根据值类型自动选择输入方式（与全局配置的交互式编辑逻辑一致）
 4. **持久化修改**：将修改后的值合并到当前配置，经 `normalizeProjectConfig` 归一化处理后写入配置文件（可选字段的空字符串会被移除，等同于未设置）
@@ -84,7 +84,8 @@ clawt init show --json
 
 - `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`
+- 国际化支持：`init show` 通过 `getI18nProjectConfigDescriptions()` 获取当前语言的配置项描述，替换 `PROJECT_CONFIG_DEFINITIONS` 中的 `description` 字段后再传入 `interactiveConfigEditor`，使交互式面板根据 `language` 配置显示中文或英文描述
+- 消息常量：`MESSAGES.INIT_SELECT_PROMPT`（选择配置项提示语）、`MESSAGES.INIT_SET_SUCCESS`（修改成功提示），定义在 `src/constants/messages/init.ts`（已双语化，根据 `language` 配置自动选择语言）
 - `handleInitShow` 使用 `normalizeProjectConfig` 对修改后的配置进行归一化处理：可选字段（如 `validateRunCommand`、`postCreate`、`claudeCodeCommand`）设为空字符串时自动移除该键，避免 JSON 文件中出现冗余的 `"field": ""` 条目
 
 ---

package/docs/project-config.md

@@ -61,6 +61,9 @@ export const PROJECT_DEFAULT_CONFIG: Required<ProjectConfig> = deriveDefaultConf
 
 /** 项目配置项描述映射（从 PROJECT_CONFIG_DEFINITIONS 自动派生） */
 export const PROJECT_CONFIG_DESCRIPTIONS: Record<keyof Required<ProjectConfig>, string> = deriveConfigDescriptions(PROJECT_CONFIG_DEFINITIONS);
+
+/** 获取国际化项目配置项描述映射（根据当前语言返回中文或英文描述） */
+export function getI18nProjectConfigDescriptions(): Record<keyof Required<ProjectConfig>, string>;
 ```
 
 #### 相关类型定义
@@ -109,6 +112,12 @@ export type ProjectConfigDefinitions = {
 | `resolveClaudeCodeCommand` | `() => string` | 解析当前项目生效的 Claude Code 启动指令，优先级：项目级配置 > 全局配置 |
 | `normalizeProjectConfig` | `(config: ProjectConfig, key: string, value: unknown) => ProjectConfig` | 归一化项目配置：可选字段的空字符串等同于未设置，从对象中删除该键以保持 JSON 文件整洁 |
 
+**国际化函数**（位于 `src/constants/project-config.ts`）：
+
+| 函数 | 签名 | 说明 |
+| --- | --- | --- |
+| `getI18nProjectConfigDescriptions` | `() => Record<keyof Required<ProjectConfig>, string>` | 获取国际化项目配置项描述映射，根据当前语言返回中文或英文描述 |
+
 #### 设置方式
 
 通过 `clawt init` 命令设置（详见 [init.md](./init.md)）：
@@ -124,7 +133,7 @@ clawt init -b <branchName>
 clawt init show
 ```
 
-`init show` 子命令调用通用的 `interactiveConfigEditor`（`src/utils/config-strategy.ts`），基于 `PROJECT_CONFIG_DEFINITIONS` 构建配置项列表，提供交互式面板供用户查看和修改所有项目配置项。
+`init show` 子命令调用通用的 `interactiveConfigEditor`（`src/utils/config-strategy.ts`），基于 `PROJECT_CONFIG_DEFINITIONS` 构建配置项列表，提供交互式面板供用户查看和修改所有项目配置项。配置项描述通过 `getI18nProjectConfigDescriptions()` 获取国际化版本，根据当前 `language` 配置自动显示中文或英文。
 
 #### 前置校验
 

package/docs/spec.md

@@ -11,7 +11,8 @@
 - [2. 核心概念](#2-核心概念)
   - [2.5 验证分支](#25-验证分支)
   - [2.6 项目级配置](#26-项目级配置)（详见 [project-config.md](./project-config.md)）
-  - [2.7 通用交互式配置编辑器](#27-通用交互式配置编辑器)
+  - [2.7 国际化（i18n）](#27-国际化i18n)
+  - [2.8 通用交互式配置编辑器](#28-通用交互式配置编辑器)
 - [3. 全局目录结构](#3-全局目录结构)
 - [4. 命令总览](#4-命令总览)
 - [5. 需求场景详细设计](#5-需求场景详细设计)
@@ -206,7 +207,49 @@ export const VALIDATE_BRANCH_PREFIX = 'clawt-validate-';
 
 详细的配置项列表、类型定义、工具函数和设置方式见 [项目级配置文档](./project-config.md)。
 
-### 2.7 通用交互式配置编辑器
+### 2.7 国际化（i18n）
+
+Clawt 支持中英双语界面，通过全局配置 `language` 字段控制输出语言。
+
+**核心机制：**
+
+- **语言配置**：`ClawtConfig.language`（`'en'` | `'zh-CN'`），默认 `'en'`
+- **语言获取**：`getCurrentLanguage()`（`src/utils/i18n.ts`），优先使用内存缓存，缓存不存在时从配置文件读取，读取失败默认 `'en'`
+- **消息国际化**：所有消息常量（`src/constants/messages/` 下）从单语字符串改为 `{ en, 'zh-CN' }` 双语映射，运行时通过 `createMessages()` 根据当前语言选择对应文本。导出的消息对象类型与原单语版本保持一致，消费方无需改动
+- **配置描述国际化**：`getI18nConfigDescriptions()` 和 `getI18nProjectConfigDescriptions()` 分别提供全局配置和项目配置项描述的国际化版本，供交互式配置编辑器使用
+- **CLI 描述国际化**：`src/constants/messages/cli-descriptions.ts` 集中管理 Commander.js 的命令描述和选项文本（双语映射），通过 `CLI_DESCRIPTIONS` 导出当前语言的描述对象
+
+**i18n 工具函数**（`src/utils/i18n.ts`）：
+
+| 函数 | 签名 | 说明 |
+| --- | --- | --- |
+| `getCurrentLanguage` | `() => Language` | 获取当前语言（优先缓存 → 配置文件 → 默认 `'en'`） |
+| `setCurrentLanguage` | `(lang: Language) => void` | 设置当前语言（用于测试和 CLI 初始化） |
+| `resetLanguageCache` | `() => void` | 重置语言缓存（配置变更后调用，使下次读取时重新加载） |
+| `createMessages` | `<T>(i18nMap: T) => { [K in keyof T]: ExtractLang<T[K]> }` | 从双语映射创建当前语言的消息对象 |
+
+**双语映射模式：**
+
+```typescript
+// 定义双语消息映射
+const MESSAGES_I18N = {
+  NOT_MAIN_WORKTREE: {
+    en: 'Please run clawt in the root directory of the main worktree',
+    'zh-CN': '请在主 worktree 的根目录下执行 clawt',
+  },
+  BRANCH_EXISTS: {
+    en: (name: string) => `Branch ${name} already exists`,
+    'zh-CN': (name: string) => `分支 ${name} 已存在`,
+  },
+};
+
+// 运行时根据语言选择
+export const MESSAGES = createMessages(MESSAGES_I18N);
+// MESSAGES.NOT_MAIN_WORKTREE → string（当前语言的文本）
+// MESSAGES.BRANCH_EXISTS → (name: string) => string（当前语言的函数）
+```
+
+### 2.8 通用交互式配置编辑器
 
 `interactiveConfigEditor`（`src/utils/config-strategy.ts`）是一个通用的交互式配置编辑函数，供全局配置（`config` 命令）和项目级配置（`init show` 子命令）复用。
 
@@ -357,6 +400,30 @@ async function interactiveConfigEditor<T extends object>(
 
 ## 6. 验证架构规则
 
+### 6.0 消息常量双语化
+
+`src/constants/messages/` 下所有消息常量已支持中英双语。每个消息常量文件的结构为：
+
+1. 定义双语映射对象（`*_I18N`），每个消息条目为 `{ en: ..., 'zh-CN': ... }` 结构
+2. 通过 `createMessages()` 运行时根据当前语言选择对应文本，导出的消息对象类型与原单语版本一致
+3. 消费方（各命令模块）无需改动，直接使用导出的消息对象即可
+
+```typescript
+// 定义双语映射
+const MESSAGES_I18N = {
+  SOME_MESSAGE: {
+    en: 'English text',
+    'zh-CN': '中文文本',
+  },
+};
+
+// 运行时导出
+export const MESSAGES = createMessages(MESSAGES_I18N);
+// MESSAGES.SOME_MESSAGE → 'English text' 或 '中文文本'（取决于 language 配置）
+```
+
+已双语化的消息常量文件包括：`common.ts`、`cli-descriptions.ts`、`init.ts`、`create.ts`、`run.ts`、`validate.ts`、`merge.ts`、`remove.ts`、`resume.ts`、`sync.ts`、`reset.ts`、`status.ts`、`alias.ts`、`completion.ts`、`home.ts`、`cover-validate.ts`、`projects.ts`、`tasks.ts`、`interactive-panel.ts`、`post-create.ts`、`config.ts`。
+
 以下规则适用于验证分支架构的所有实现工作：
 
 1. **不兼容旧版本**：本次重构不考虑旧版本数据、旧版本创建的 worktree 或旧版本配置的兼容性。所有命令均假定验证分支和项目级配置已按新架构存在。用户需删除旧 worktree 后重新创建。

package/package.json

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

package/src/commands/alias.ts

@@ -3,6 +3,7 @@ import chalk from 'chalk';
 import { MESSAGES } from '../constants/index.js';
 import { logger } from '../logger/index.js';
 import { loadConfig, writeConfig, printInfo, printSuccess, printError, printSeparator } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /**
  * 从 Commander 实例动态获取所有已注册的命令名
@@ -104,28 +105,28 @@ function handleAliasRemove(alias: string): void {
 export function registerAliasCommand(program: Command): void {
   const aliasCmd = program
     .command('alias')
-    .description('管理命令别名（列出 / 设置 / 移除）')
+    .description(getCurrentLanguage() === 'en' ? 'Manage command aliases (list / set / remove)' : '管理命令别名（列出 / 设置 / 移除）')
     .action(() => {
       handleAliasList();
     });
 
   aliasCmd
     .command('list')
-    .description('列出所有别名')
+    .description(getCurrentLanguage() === 'en' ? 'List all aliases' : '列出所有别名')
     .action(() => {
       handleAliasList();
     });
 
   aliasCmd
     .command('set <alias> <command>')
-    .description('设置命令别名')
+    .description(getCurrentLanguage() === 'en' ? 'Set a command alias' : '设置命令别名')
     .action((alias: string, command: string) => {
       handleAliasSet(program, alias, command);
     });
 
   aliasCmd
     .command('remove <alias>')
-    .description('移除命令别名')
+    .description(getCurrentLanguage() === 'en' ? 'Remove a command alias' : '移除命令别名')
     .action((alias: string) => {
       handleAliasRemove(alias);
     });

package/src/commands/completion.ts

@@ -7,6 +7,7 @@ import { MESSAGES } from '../constants/messages/index.js';
 import { printSuccess, printInfo, printWarning, printError } from '../utils/index.js';
 import { getBashScript, getZshScript } from '../utils/completion-scripts.js';
 import { generateCompletions } from '../utils/completion-engine.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /**
  * 向文件中追加内容（如果不存在），或者创建新文件
@@ -89,7 +90,7 @@ export function registerCompletionCommand(program: Command): void {
   completionCommand
     .command('_complete [args...]')
     .allowUnknownOption()
-    .description('内部使用的动态补全方法，不对外公开')
+    .description(getCurrentLanguage() === 'en' ? 'Internal dynamic completion method, not for public use' : '内部使用的动态补全方法，不对外公开')
     .action((args: string[]) => {
       // args 中包含了: shell, cword, ...words
       if (!args || args.length < 2) return;

package/src/commands/config.ts

@@ -1,5 +1,5 @@
 import type { Command } from 'commander';
-import { DEFAULT_CONFIG, CONFIG_DEFINITIONS, MESSAGES, CONFIG_ALIAS_DISABLED_HINT } from '../constants/index.js';
+import { DEFAULT_CONFIG, CONFIG_DEFINITIONS, MESSAGES, CONFIG_ALIAS_DISABLED_HINT, getI18nConfigDescriptions } from '../constants/index.js';
 import { logger } from '../logger/index.js';
 import {
   loadConfig,
@@ -14,6 +14,7 @@ import {
   parseConfigValue,
   interactiveConfigEditor,
 } from '../utils/index.js';
+import { getCurrentLanguage, resetLanguageCache } from '../utils/i18n.js';
 
 /**
  * 注册 config 命令组：查看和管理全局配置
@@ -22,28 +23,28 @@ import {
 export function registerConfigCommand(program: Command): void {
   const configCmd = program
     .command('config')
-    .description('交互式查看和修改全局配置')
+    .description(getCurrentLanguage() === 'en' ? 'Interactively view and modify global configuration' : '交互式查看和修改全局配置')
     .action(async () => {
       await handleConfigSet();
     });
 
   configCmd
     .command('reset')
-    .description('将配置恢复为默认值')
+    .description(getCurrentLanguage() === 'en' ? 'Reset configuration to default values' : '将配置恢复为默认值')
     .action(async () => {
       await handleConfigReset();
     });
 
   configCmd
     .command('set [key] [value]')
-    .description('修改配置项（无参数进入交互式配置）')
+    .description(getCurrentLanguage() === 'en' ? 'Modify configuration (enter interactive mode without arguments)' : '修改配置项（无参数进入交互式配置）')
     .action(async (key?: string, value?: string) => {
       await handleConfigSet(key, value);
     });
 
   configCmd
     .command('get <key>')
-    .description('获取单个配置项的值')
+    .description(getCurrentLanguage() === 'en' ? 'Get the value of a single configuration item' : '获取单个配置项的值')
     .action((key: string) => {
       handleConfigGet(key);
     });
@@ -57,7 +58,7 @@ async function handleConfigReset(): Promise<void> {
 
   const confirmed = await confirmDestructiveAction(
     'config reset',
-    '当前配置将被覆盖为默认值',
+    MESSAGES.CONFIG_RESET_WARNING,
   );
 
   if (!confirmed) {
@@ -66,6 +67,7 @@ async function handleConfigReset(): Promise<void> {
   }
 
   writeDefaultConfig();
+  resetLanguageCache();
   printSuccess(MESSAGES.CONFIG_RESET_SUCCESS);
 }
 
@@ -105,6 +107,11 @@ async function handleConfigSet(key?: string, value?: string): Promise<void> {
   (config as unknown as Record<string, unknown>)[key] = result.value;
   saveConfig(config);
 
+  // 语言配置变更时刷新缓存，使后续消息立即使用新语言
+  if (key === 'language') {
+    resetLanguageCache();
+  }
+
   logger.info(`config set 命令执行，设置 ${key} = ${String(result.value)}`);
   printSuccess(MESSAGES.CONFIG_SET_SUCCESS(key, String(result.value)));
 }
@@ -125,7 +132,13 @@ async function handleInteractiveConfigSet(): Promise<void> {
     }
   }
 
-  const { key, newValue } = await interactiveConfigEditor(config, CONFIG_DEFINITIONS, {
+  // 使用 i18n 后的描述替换 CONFIG_DEFINITIONS 中的中文 description
+  const i18nDescriptions = getI18nConfigDescriptions();
+  const i18nDefinitions = Object.fromEntries(
+    Object.entries(CONFIG_DEFINITIONS).map(([k, def]) => [k, { ...def, description: i18nDescriptions[k as keyof typeof i18nDescriptions] }]),
+  ) as typeof CONFIG_DEFINITIONS;
+
+  const { key, newValue } = await interactiveConfigEditor(config, i18nDefinitions, {
     disabledKeys,
   });
 
@@ -133,6 +146,11 @@ async function handleInteractiveConfigSet(): Promise<void> {
   (config as unknown as Record<string, unknown>)[key as string] = newValue;
   saveConfig(config);
 
+  // 语言配置变更时刷新缓存，使后续消息立即使用新语言
+  if (key === 'language') {
+    resetLanguageCache();
+  }
+
   printSuccess(MESSAGES.CONFIG_SET_SUCCESS(key as string, String(newValue)));
 }
 

package/src/commands/cover-validate.ts

@@ -22,6 +22,7 @@ import {
   isWorkingDirClean,
   confirmAction,
 } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /**
  * 注册 cover-validate 命令：将验证分支上的修改覆盖回目标 worktree
@@ -30,7 +31,7 @@ import {
 export function registerCoverValidateCommand(program: Command): void {
   program
     .command('cover')
-    .description('将验证分支上的修改覆盖回目标 worktree（自动推导目标分支）')
+    .description(getCurrentLanguage() === 'en' ? 'Overwrite changes from the validation branch back to the target worktree (auto-detect target branch)' : '将验证分支上的修改覆盖回目标 worktree（自动推导目标分支）')
     .action(async () => {
       await handleCoverValidate();
     });
@@ -113,7 +114,7 @@ async function handleCoverValidate(): Promise<void> {
   // 步骤 3.5：工作区干净时提示确认，避免误操作
   if (isWorkingDirClean(mainWorktreePath)) {
     printInfo(MESSAGES.COVER_VALIDATE_WORKING_DIR_CLEAN);
-    const confirmed = await confirmAction('是否继续执行覆盖？');
+    const confirmed = await confirmAction(getCurrentLanguage() === 'en' ? 'Proceed with cover?' : '是否继续执行覆盖？');
     if (!confirmed) return;
   }
 

package/src/commands/create.ts

@@ -13,6 +13,7 @@ import {
   printSeparator,
   runPostCreateHooks,
 } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /**
  * 注册 create 命令：批量创建 worktree 及对应分支（含验证分支）
@@ -21,10 +22,10 @@ import {
 export function registerCreateCommand(program: Command): void {
   program
     .command('create')
-    .description('批量创建 worktree 及对应分支（含验证分支）')
-    .requiredOption('-b, --branch <branchName>', '分支名')
-    .option('-n, --number <count>', '创建数量', '1')
-    .option('--post-create', '执行 postCreate hook（默认开启，--no-post-create 跳过）', true)
+    .description(getCurrentLanguage() === 'en' ? 'Batch create worktrees and corresponding branches (including validation branches)' : '批量创建 worktree 及对应分支（含验证分支）')
+    .requiredOption('-b, --branch <branchName>', getCurrentLanguage() === 'en' ? 'Branch name' : '分支名')
+    .option('-n, --number <count>', getCurrentLanguage() === 'en' ? 'Number of worktrees to create' : '创建数量', '1')
+    .option('--post-create', getCurrentLanguage() === 'en' ? 'Execute postCreate hook (enabled by default, use --no-post-create to skip)' : '执行 postCreate hook（默认开启，--no-post-create 跳过）', true)
     .action(async (options: CreateOptions) => {
       await handleCreate(options);
     });
@@ -58,10 +59,10 @@ async function handleCreate(options: CreateOptions): Promise<void> {
   printInfo('');
 
   worktrees.forEach((wt, index) => {
-    printInfo(`目录路径${index + 1}：`);
+    printInfo(getCurrentLanguage() === 'en' ? `Directory path ${index + 1}:` : `目录路径${index + 1}：`);
     printInfo(`  ${wt.path}`);
-    printInfo(`  分支名: ${wt.branch}`);
-    printInfo(`  验证分支: ${getValidateBranchName(wt.branch)}`);
+    printInfo(getCurrentLanguage() === 'en' ? `  Branch: ${wt.branch}` : `  分支名: ${wt.branch}`);
+    printInfo(getCurrentLanguage() === 'en' ? `  Validation branch: ${getValidateBranchName(wt.branch)}` : `  验证分支: ${getValidateBranchName(wt.branch)}`);
     printSeparator();
   });
 }

package/src/commands/home.ts

@@ -13,6 +13,7 @@ import {
   printHint,
   printError,
 } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /**
  * 注册 home 命令：快速切换回主工作分支
@@ -21,7 +22,7 @@ import {
 export function registerHomeCommand(program: Command): void {
   program
     .command('home')
-    .description('切换回主工作分支')
+    .description(getCurrentLanguage() === 'en' ? 'Switch back to the main work branch' : '切换回主工作分支')
     .action(async () => {
       await handleHome();
     });

package/src/commands/init.ts

@@ -1,7 +1,7 @@
 import type { Command } from 'commander';
 import { Command as Cmd } from 'commander';
 import { logger } from '../logger/index.js';
-import { MESSAGES, PROJECT_CONFIG_DEFINITIONS } from '../constants/index.js';
+import { MESSAGES, PROJECT_CONFIG_DEFINITIONS, getI18nProjectConfigDescriptions } from '../constants/index.js';
 import type { InitOptions, InitShowOptions, ProjectConfig } from '../types/index.js';
 import {
   runPreChecks,
@@ -15,6 +15,7 @@ import {
   safeStringify,
   normalizeProjectConfig,
 } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /**
  * 注册 init 命令：初始化项目级配置，设置主工作分支
@@ -23,8 +24,8 @@ import {
 export function registerInitCommand(program: Command): void {
   const initCmd = program
     .command('init')
-    .description('初始化项目级配置，设置主工作分支')
-    .option('-b, --branch <branchName>', '指定主工作分支名（默认使用当前分支）')
+    .description(getCurrentLanguage() === 'en' ? 'Initialize project configuration and set the main work branch' : '初始化项目级配置，设置主工作分支')
+    .option('-b, --branch <branchName>', getCurrentLanguage() === 'en' ? 'Specify the main work branch name (defaults to current branch)' : '指定主工作分支名（默认使用当前分支）')
     .action(async (options: InitOptions) => {
       await handleInit(options);
     });
@@ -32,8 +33,8 @@ export function registerInitCommand(program: Command): void {
   // 注册 show 子命令：交互式查看和修改项目配置（支持 --json 格式输出）
   initCmd.addCommand(
     new Cmd('show')
-      .description('交互式查看和修改项目配置（支持 --json 格式输出）')
-      .option('--json', '以 JSON 格式输出')
+      .description(getCurrentLanguage() === 'en' ? 'Interactively view and modify project configuration (supports --json output)' : '交互式查看和修改项目配置（支持 --json 格式输出）')
+      .option('--json', getCurrentLanguage() === 'en' ? 'Output in JSON format' : '以 JSON 格式输出')
       .action(async (options: InitShowOptions) => {
         await handleInitShow(options);
       }),
@@ -56,9 +57,15 @@ async function handleInitShow(options: InitShowOptions): Promise<void> {
 
   logger.info('init show 命令执行，进入交互式项目配置');
 
+  // 使用 i18n 后的描述替换 PROJECT_CONFIG_DEFINITIONS 中的中文 description
+  const i18nDescriptions = getI18nProjectConfigDescriptions();
+  const i18nDefinitions = Object.fromEntries(
+    Object.entries(PROJECT_CONFIG_DEFINITIONS).map(([k, def]) => [k, { ...def, description: i18nDescriptions[k as keyof typeof i18nDescriptions] }]),
+  ) as typeof PROJECT_CONFIG_DEFINITIONS;
+
   const { key, newValue } = await interactiveConfigEditor(
     config as Required<ProjectConfig>,
-    PROJECT_CONFIG_DEFINITIONS,
+    i18nDefinitions,
     { selectPrompt: MESSAGES.INIT_SELECT_PROMPT },
   );
 

package/src/commands/list.ts

@@ -12,6 +12,7 @@ import {
   isWorktreeIdle,
   printInfo,
 } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 // getWorktreeStatus 和 formatWorktreeStatus 仅在文本模式下使用
 
 /**
@@ -21,8 +22,8 @@ import {
 export function registerListCommand(program: Command): void {
   program
     .command('list')
-    .description('列出当前项目所有 worktree（支持 --json 格式输出）')
-    .option('--json', '以 JSON 格式输出')
+    .description(getCurrentLanguage() === 'en' ? 'List all worktrees for the current project (supports --json output)' : '列出当前项目所有 worktree（支持 --json 格式输出）')
+    .option('--json', getCurrentLanguage() === 'en' ? 'Output in JSON format' : '以 JSON 格式输出')
     .action(async (options: ListOptions) => {
       await handleList(options);
     });
@@ -72,7 +73,8 @@ function printListAsJson(projectName: string, worktrees: import('../types/index.
  * @param {import('../types/index.js').WorktreeInfo[]} worktrees - worktree 列表
  */
 function printListAsText(projectName: string, worktrees: import('../types/index.js').WorktreeInfo[]): void {
-  printInfo(`当前项目: ${projectName}\n`);
+  const lang = getCurrentLanguage();
+  printInfo(`${lang === 'en' ? 'Current project' : '当前项目'}: ${projectName}\n`);
 
   if (worktrees.length === 0) {
     printInfo(`  ${MESSAGES.NO_WORKTREES}`);
@@ -95,6 +97,6 @@ function printListAsText(projectName: string, worktrees: import('../types/index.
 
       printInfo('');
     }
-    printInfo(`共 ${worktrees.length} 个 worktree`);
+    printInfo(`${worktrees.length} ${lang === 'en' ? 'worktree(s)' : '个 worktree'}`);
   }
 }

package/src/commands/merge.ts

@@ -39,6 +39,7 @@ import {
   isNonInteractive,
 } from '../utils/index.js';
 import type { WorktreeResolveMessages } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /**
  * 注册 merge 命令：合并验证过的分支到主 worktree
@@ -47,10 +48,10 @@ import type { WorktreeResolveMessages } from '../utils/index.js';
 export function registerMergeCommand(program: Command): void {
   program
     .command('merge')
-    .description('合并某个已验证的 worktree 分支到主 worktree')
-    .option('-b, --branch <branchName>', '要合并的分支名（支持模糊匹配，不传则列出所有分支供选择）')
-    .option('-m, --message <commitMessage>', '提交信息（目标 worktree 工作区有修改时必填）')
-    .option('--auto', '遇到冲突直接调用 AI 解决，不再询问')
+    .description(getCurrentLanguage() === 'en' ? 'Merge a validated worktree branch into the main worktree' : '合并某个已验证的 worktree 分支到主 worktree')
+    .option('-b, --branch <branchName>', getCurrentLanguage() === 'en' ? 'Branch name to merge (supports fuzzy match, lists all branches if not provided)' : '要合并的分支名（支持模糊匹配，不传则列出所有分支供选择）')
+    .option('-m, --message <commitMessage>', getCurrentLanguage() === 'en' ? 'Commit message (required when target worktree has uncommitted changes)' : '提交信息（目标 worktree 工作区有修改时必填）')
+    .option('--auto', getCurrentLanguage() === 'en' ? 'Resolve conflicts with AI automatically without prompting' : '遇到冲突直接调用 AI 解决，不再询问')
     .action(async (options: MergeOptions) => {
       await handleMerge(options);
     });
@@ -141,11 +142,11 @@ async function handleSquashIfNeeded(
 async function shouldCleanupAfterMerge(branchName: string): Promise<boolean> {
   const autoDelete = getConfigValue('autoDeleteBranch');
   if (autoDelete) {
-    printInfo(`已配置自动删除，merge 成功后将自动清理 worktree 和分支: ${branchName}`);
+    printInfo(MESSAGES.AUTO_DELETE_CONFIGURED(branchName));
     return true;
   }
   // 非交互模式下自动删除
-  return confirmAction(`是否删除对应的 worktree 和分支 (${branchName})？`, true);
+  return confirmAction(MESSAGES.CONFIRM_DELETE_WORKTREE_BRANCH(branchName), true);
 }
 
 /**
@@ -260,7 +261,7 @@ async function handleMerge(options: MergeOptions): Promise<void> {
       return;
     }
   } else {
-    printInfo('已跳过自动 pull/push，请手动执行 git pull && git push');
+    printInfo(getCurrentLanguage() === 'en' ? 'Auto pull/push skipped, please run git pull && git push manually' : '已跳过自动 pull/push，请手动执行 git pull && git push');
   }
 
   // 步骤 8：输出成功提示（根据是否有 message 选择对应模板）

package/src/commands/projects.ts

@@ -21,6 +21,7 @@ import {
   printSeparator,
   printError,
 } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /**
  * 注册 projects 命令：统一管理多个项目的 worktree 状态
@@ -29,8 +30,8 @@ import {
 export function registerProjectsCommand(program: Command): void {
   program
     .command('projects [name]')
-    .description('展示所有项目的 worktree 概览，或查看指定项目的 worktree 详情')
-    .option('--json', '以 JSON 格式输出')
+    .description(getCurrentLanguage() === 'en' ? 'Show worktree overview across projects, or view details for a specific project' : '展示所有项目的 worktree 概览，或查看指定项目的 worktree 详情')
+    .option('--json', getCurrentLanguage() === 'en' ? 'Output in JSON format' : '以 JSON 格式输出')
     .action((name: string | undefined, options: { json?: boolean }) => {
       handleProjects({ name, json: options.json });
     });
@@ -258,7 +259,8 @@ function printProjectsOverviewAsText(result: ProjectsOverviewResult): void {
 
   printSeparator();
   printInfo('');
-  printInfo(`  共 ${chalk.bold(String(result.totalProjects))} 个项目   ${chalk.gray(MESSAGES.PROJECTS_TOTAL_DISK_USAGE(formatDiskSize(result.totalDiskUsage)))}`);
+  const lang = getCurrentLanguage();
+  printInfo(`  ${chalk.bold(String(result.totalProjects))} ${lang === 'en' ? 'project(s)' : '个项目'}   ${chalk.gray(MESSAGES.PROJECTS_TOTAL_DISK_USAGE(formatDiskSize(result.totalDiskUsage)))}`);
   printInfo('');
   printDoubleSeparator();
 }

package/src/commands/remove.ts

@@ -26,6 +26,7 @@ import {
   getCurrentBranch,
 } from '../utils/index.js';
 import type { WorktreeMultiResolveMessages } from '../utils/index.js';
+import { getCurrentLanguage } from '../utils/i18n.js';
 
 /** remove 命令的分支解析消息配置 */
 const REMOVE_RESOLVE_MESSAGES: WorktreeMultiResolveMessages = {
@@ -42,9 +43,9 @@ const REMOVE_RESOLVE_MESSAGES: WorktreeMultiResolveMessages = {
 export function registerRemoveCommand(program: Command): void {
   program
     .command('remove')
-    .description('移除 worktree（支持模糊匹配/多选/全部）')
-    .option('--all', '移除当前项目下所有 worktree')
-    .option('-b, --branch <branchName>', '指定分支名（支持模糊匹配，不传则列出所有分支）')
+    .description(getCurrentLanguage() === 'en' ? 'Remove worktrees (supports fuzzy match / multi-select / all)' : '移除 worktree（支持模糊匹配/多选/全部）')
+    .option('--all', getCurrentLanguage() === 'en' ? 'Remove all worktrees in the current project' : '移除当前项目下所有 worktree')
+    .option('-b, --branch <branchName>', getCurrentLanguage() === 'en' ? 'Specify branch name (supports fuzzy match, lists all branches if not provided)' : '指定分支名（支持模糊匹配，不传则列出所有分支）')
     .action(async (options: RemoveOptions) => {
       await handleRemove(options);
     });
@@ -89,9 +90,9 @@ async function handleRemove(options: RemoveOptions): Promise<void> {
   }
 
   // 列出即将移除的 worktree
-  printInfo('即将移除以下 worktree 及本地分支：\n');
+  printInfo(getCurrentLanguage() === 'en' ? 'The following worktrees and local branches will be removed:\n' : '即将移除以下 worktree 及本地分支：\n');
   worktreesToRemove.forEach((wt, index) => {
-    printInfo(`  ${index + 1}. ${wt.path}  →  分支: ${wt.branch}  验证分支: ${getValidateBranchName(wt.branch)}`);
+    printInfo(getCurrentLanguage() === 'en' ? `  ${index + 1}. ${wt.path}  →  branch: ${wt.branch}  validate branch: ${getValidateBranchName(wt.branch)}` : `  ${index + 1}. ${wt.path}  →  分支: ${wt.branch}  验证分支: ${getValidateBranchName(wt.branch)}`);
   });
   printInfo('');
 
@@ -141,7 +142,7 @@ async function handleRemove(options: RemoveOptions): Promise<void> {
   if (failures.length > 0) {
     printError(MESSAGES.REMOVE_PARTIAL_FAILURE(failures));
     throw new ClawtError(
-      `${failures.length} 个 worktree 移除失败`,
+      getCurrentLanguage() === 'en' ? `${failures.length} worktree removal(s) failed` : `${failures.length} 个 worktree 移除失败`,
     );
   }
 }