feat: I18n --story=1

Author: studyzy

.codebuddy/commands/openspec/apply.md

@@ -0,0 +1,22 @@
+---
+name: OpenSpec: 实施
+description: 实施已批准的OpenSpec变更并保持任务同步。
+argument-hint: "[change-id]"
+---
+<!-- OPENSPEC:START -->
+**护栏规则**
+- 优先使用简单、最小的实现，仅在请求或明确需要时才添加复杂性。
+- 将变更紧密限制在请求的结果范围内。
+- 如果需要额外的OpenSpec约定或澄清，请参考`openspec/AGENTS.md`（位于`openspec/`目录中—如果看不到，请运行`ls openspec`或`openspec-cn update`）。
+
+**步骤**
+将这些步骤作为TODO跟踪并逐一完成。
+1. 阅读`openspec/changes/<id>/proposal.md`、`design.md`（如果存在）和`tasks.md`以确认范围和验收标准。
+2. 按顺序完成任务，保持编辑最小化并专注于请求的变更。
+3. 在更新状态前确认完成—确保`tasks.md`中的每个项目都已完成。
+4. 所有工作完成后更新清单，使每个任务标记为`- [x]`并反映实际情况。
+5. 需要额外上下文时参考`openspec-cn list`或`openspec-cn show <item>`。
+
+**参考**
+- 如果在实施过程中需要提案的额外上下文，请使用`openspec-cn show <id> --json --deltas-only`。
+<!-- OPENSPEC:END -->

.codebuddy/commands/openspec/archive.md

@@ -0,0 +1,26 @@
+---
+name: OpenSpec: 归档
+description: 归档已部署的OpenSpec变更并更新规范。
+argument-hint: "[change-id]"
+---
+<!-- OPENSPEC:START -->
+**护栏规则**
+- 优先使用简单、最小的实现，仅在请求或明确需要时才添加复杂性。
+- 将变更紧密限制在请求的结果范围内。
+- 如果需要额外的OpenSpec约定或澄清，请参考`openspec/AGENTS.md`（位于`openspec/`目录中—如果看不到，请运行`ls openspec`或`openspec-cn update`）。
+
+**步骤**
+1. 确定要归档的变更ID：
+   - 如果此提示已包含特定变更ID（例如在由斜杠命令参数填充的`<ChangeId>`块内），在修剪空格后使用该值。
+   - 如果对话松散地引用变更（例如通过标题或摘要），运行`openspec-cn list`以显示可能的ID，分享相关候选者，并确认用户意图归档哪一个。
+   - 否则，查看对话，运行`openspec-cn list`，并询问用户要归档哪个变更；在继续前等待确认的变更ID。
+   - 如果仍然无法识别单个变更ID，停止并告诉用户您还无法归档任何内容。
+2. 通过运行`openspec-cn list`（或`openspec-cn show <id>`）验证变更ID，如果变更缺失、已归档或尚未准备好归档，则停止。
+3. 运行`openspec-cn archive <id> --yes`，以便CLI在没有提示的情况下移动变更并应用规范更新（仅对仅工具工作使用`--skip-specs`）。
+4. 查看命令输出以确认目标规范已更新且变更已放入`openspec/changes/archive/`。
+5. 使用`openspec-cn validate --strict`验证，如果出现异常，使用`openspec-cn show <id>`检查。
+
+**参考**
+- 在归档前使用`openspec-cn list`确认变更ID。
+- 使用`openspec-cn list --specs`检查刷新的规范，并在交前解决任何验证问题。
+<!-- OPENSPEC:END -->

.codebuddy/commands/openspec/proposal.md

@@ -0,0 +1,27 @@
+---
+name: OpenSpec: 提案
+description: 搭建新的OpenSpec变更提案并进行严格验证。
+argument-hint: "[feature description or request]"
+---
+<!-- OPENSPEC:START -->
+**护栏规则**
+- 优先使用简单、最小的实现，仅在请求或明确需要时才添加复杂性。
+- 将变更紧密限制在请求的结果范围内。
+- 如果需要额外的OpenSpec约定或澄清，请参考`openspec/AGENTS.md`（位于`openspec/`目录中—如果看不到，请运行`ls openspec`或`openspec-cn update`）。
+- 识别任何模糊或不明确的细节，并在编辑文件前询问必要的后续问题。
+- 在提案阶段不要编写任何代码。仅创建设计文档（proposal.md、tasks.md、design.md和规范增量）。实施在批准后的apply阶段进行。
+
+**步骤**
+1. 查看`openspec/project.md`，运行`openspec-cn list`和`openspec-cn list --specs`，并检查相关代码或文档（例如通过`rg`/`ls`）以使提案基于当前行为；注意任何需要澄清的空白。
+2. 选择唯一的动词开头`change-id`并在`openspec/changes/<id>/`下创建`proposal.md`、`tasks.md`和`design.md`（需要时）。
+3. 将变更映射为具体功能或需求，将多范围工作分解为具有明确关系和顺序的独立规范增量。
+4. 当解决方案跨越多个系统、引入新模式或在提交规范前需要权衡讨论时，在`design.md`中记录架构推理。
+5. 在`openspec/changes/<id>/specs/<capability>/spec.md`中起草规范增量（每个功能一个文件夹），使用`## 新增需求|修改需求|移除需求|重命名需求`，每个需求至少有一个`#### 场景：`，并在相关时交叉引用相关功能。
+6. 将`tasks.md`起草为有序的小型可验证工作项列表，这些项提供用户可见的进展，包括验证（测试、工具），并突出显示依赖关系或可并行工作。
+7. 使用`openspec-cn validate <id> --strict`验证并在分享提案前解决每个问题。
+
+**参考**
+- 当验证失败时，使用`openspec-cn show <id> --json --deltas-only`或`openspec-cn show <spec> --type spec`检查详情。
+- 在编写新需求前，使用`rg -n "需求：|场景：" openspec/specs`搜索现有需求。
+- 使用`rg <keyword>`、`ls`或直接文件读取探索代码库，以便提案与当前实现现实保持一致。
+<!-- OPENSPEC:END -->

AGENTS.md

@@ -0,0 +1,28 @@
+<!-- OPENSPEC:START -->
+# OpenSpec 使用说明
+
+这些说明适用于在此项目中工作的AI助手。
+
+## 语言偏好设置
+
+**默认使用中文**：除非明确说明使用英文，否则所有输出都应使用中文，包括：
+- 文档内容
+- 代码注释
+- 提交信息
+- 规范说明
+
+## 工作流程
+
+当请求满足以下条件时，始终打开`@/openspec/AGENTS.md`：
+- 提及规划或提案（如提案、规范、变更、计划等词语）
+- 引入新功能、重大变更、架构变更或大型性能/安全工作时
+- 听起来不明确，需要在编码前了解权威规范时
+
+使用`@/openspec/AGENTS.md`了解：
+- 如何创建和应用变更提案
+- 规范格式和约定
+- 项目结构和指南
+
+保持此托管块，以便'openspec-cn update'可以刷新说明。
+
+<!-- OPENSPEC:END -->

CODEBUDDY.md

@@ -0,0 +1,28 @@
+<!-- OPENSPEC:START -->
+# OpenSpec 使用说明
+
+这些说明适用于在此项目中工作的AI助手。
+
+## 语言偏好设置
+
+**默认使用中文**：除非明确说明使用英文，否则所有输出都应使用中文，包括：
+- 文档内容
+- 代码注释
+- 提交信息
+- 规范说明
+
+## 工作流程
+
+当请求满足以下条件时，始终打开`@/openspec/AGENTS.md`：
+- 提及规划或提案（如提案、规范、变更、计划等词语）
+- 引入新功能、重大变更、架构变更或大型性能/安全工作时
+- 听起来不明确，需要在编码前了解权威规范时
+
+使用`@/openspec/AGENTS.md`了解：
+- 如何创建和应用变更提案
+- 规范格式和约定
+- 项目结构和指南
+
+保持此托管块，以便'openspec-cn update'可以刷新说明。
+
+<!-- OPENSPEC:END -->

README.md

@@ -15,6 +15,7 @@ AICLI is a Go tool that brings natural-language operations to your terminal. You
 - **Safety confirmations**: detects risky commands (e.g., bulk delete/format) and asks before executing
 - **Command history**: stores past prompts/commands and supports retry
 - **Multiple LLM providers**: OpenAI, Anthropic, local models, and other OpenAI-compatible APIs
+- **Internationalization (i18n)**: supports Chinese and English with automatic detection from OS locale
 - **Cross-platform**: Linux, macOS, and Windows
 
 ## Quick start
@@ -51,6 +52,7 @@ Create `~/.aicli.json`:
 ```json
 {
   "version": "1.0",
+  "language": "en",
   "llm": {
     "provider": "openai",
     "api_key": "your-api-key-here",
@@ -68,6 +70,12 @@ Create `~/.aicli.json`:
 }
 ```
 
+**Language setting**: The `language` field is optional. Supported values:
+- `"zh"` - Chinese (中文)
+- `"en"` - English
+
+If not set, AICLI automatically detects your system locale from `LANG` or `LC_ALL` environment variables. Default is Chinese.
+
 You can also set the API key via environment variable:
 
 ```bash
@@ -218,6 +226,7 @@ go test ./...
 
 - [Architecture](docs/architecture.md)
 - [Configuration](docs/configuration.md)
+- [Internationalization Guide](docs/i18n-guide.md)
 - [Development guide](docs/development.md)
 
 ## Security & privacy

README_CN.md

@@ -15,6 +15,7 @@
 - 🛡️ **安全确认机制**：自动检测危险命令（删除、格式化等），执行前需要用户确认
 - 📜 **历史记录**：保存命令历史，支持查看和重新执行
 - 🔌 **多 LLM 提供商**：支持 OpenAI、Anthropic、本地模型等多种 LLM 服务
+- 🌐 **国际化支持**：支持中文和英文，自动检测操作系统语言
 - 🌍 **跨平台**：支持 Linux、macOS 和 Windows 系统
 
 ## 🚀 快速开始
@@ -51,6 +52,7 @@ aicli init
 ```json
 {
   "version": "1.0",
+  "language": "zh",
   "llm": {
     "provider": "openai",
     "api_key": "your-api-key-here",
@@ -68,6 +70,12 @@ aicli init
 }
 ```
 
+**语言设置**：`language` 字段可选，支持以下值：
+- `"zh"` - 中文
+- `"en"` - English (英文)
+
+如果不设置，AICLI 会自动从 `LANG` 或 `LC_ALL` 环境变量检测系统语言。默认为中文。
+
 也可以通过环境变量配置 API 密钥：
 
 ```bash
@@ -508,6 +516,7 @@ go tool cover -html=coverage.out
 
 - [架构设计](docs/architecture.md)
 - [配置说明](docs/configuration.md)
+- [国际化指南](docs/i18n-guide.md)
 - [开发指南](docs/development.md)
 
 ## 🔐 安全与隐私

cmd/aicli/init.go

@@ -9,6 +9,7 @@ import (
 
 	"github.com/spf13/cobra"
 	"github.com/studyzy/aicli/pkg/config"
+	"github.com/studyzy/aicli/pkg/i18n"
 )
 
 const (
@@ -20,8 +21,8 @@ const (
 
 var initCmd = &cobra.Command{
 	Use:   "init",
-	Short: "初始化配置",
-	Long:  `引导用户设置 LLM 配置并生成配置文件 ~/.aicli.json`,
+	Short: "初始化配置 / Initialize configuration",
+	Long:  "引导用户设置 LLM 配置并生成配置文件 ~/.aicli.json / Guide user to set up LLM configuration",
 	RunE:  runInit,
 }
 
@@ -30,6 +31,10 @@ func init() {
 }
 
 func runInit(cmd *cobra.Command, args []string) error {
+	// 初始化 i18n (在配置文件加载前使用默认配置)
+	cfg := config.Default()
+	i18n.Init(cfg)
+
 	reader := bufio.NewReader(os.Stdin)
 
 	configPath, err := getConfigPath()
@@ -41,12 +46,10 @@ func runInit(cmd *cobra.Command, args []string) error {
 		return err
 	}
 
-	fmt.Println("欢迎使用 aicli 配置向导！")
-	fmt.Println("我们将引导您完成基本配置。")
+	fmt.Println(i18n.T(i18n.MsgWelcomeInit))
+	fmt.Println(i18n.T(i18n.MsgInitGuide))
 	fmt.Println()
 
-	cfg := config.Default()
-
 	if err := configureProvider(reader, cfg); err != nil {
 		return err
 	}
@@ -69,31 +72,32 @@ func getConfigPath() (string, error) {
 
 	homeDir, err := os.UserHomeDir()
 	if err != nil {
-		return "", fmt.Errorf("获取用户主目录失败: %w", err)
+		return "", fmt.Errorf("%s: %w", i18n.T(i18n.ErrGetUserHome), err)
 	}
 	return homeDir + "/.aicli.json", nil
 }
 
 func checkExistingConfig(reader *bufio.Reader, configPath string) error {
 	if _, err := os.Stat(configPath); err == nil {
-		fmt.Printf("配置文件 %s 已存在。\n", configPath)
-		if !promptBool(reader, "是否覆盖？", false) {
-			fmt.Println("操作已取消。")
-			return fmt.Errorf("用户取消操作")
+		msg := i18n.T(i18n.MsgConfigExists, configPath)
+		fmt.Printf("%s\n", msg)
+		if !promptBool(reader, i18n.T(i18n.PromptOverwriteConfig), false) {
+			fmt.Println(i18n.T(i18n.MsgOperationCancelled))
+			return fmt.Errorf("%s", i18n.T(i18n.ErrUserCancelled))
 		}
 	}
 	return nil
 }
 
 func configureProvider(reader *bufio.Reader, cfg *config.Config) error {
-	fmt.Println("请选择 LLM 提供商:")
-	fmt.Println("1. OpenAI (GPT-4, GPT-3.5)")
-	fmt.Println("2. Anthropic (Claude)")
-	fmt.Println("3. Local (Ollama, LocalAI)")
-	fmt.Println("4. DeepSeek (深度求索)")
-	fmt.Println("5. Other (兼容 OpenAI 协议)")
+	fmt.Println(i18n.T(i18n.PromptSelectProvider) + ":")
+	fmt.Println(i18n.T(i18n.InitProviderOpenAI))
+	fmt.Println(i18n.T(i18n.InitProviderAnthropic))
+	fmt.Println(i18n.T(i18n.InitProviderLocal))
+	fmt.Println(i18n.T(i18n.InitProviderDeepSeek))
+	fmt.Println(i18n.T(i18n.InitProviderOther))
 
-	providerChoice := prompt(reader, "请输入序号 [1-5]", "1")
+	providerChoice := prompt(reader, i18n.T(i18n.PromptInputChoice)+" [1-5]", "1")
 
 	switch providerChoice {
 	case "1":
@@ -117,7 +121,7 @@ func configureProvider(reader *bufio.Reader, cfg *config.Config) error {
 		cfg.LLM.Model = "gpt-3.5-turbo"
 		cfg.LLM.APIBase = apiBaseOpenAI
 	default:
-		fmt.Println("无效的选择，默认使用 OpenAI")
+		fmt.Println(i18n.T(i18n.MsgDefaultUseOpenAI))
 		cfg.LLM.Provider = providerOpenAI
 	}
 
@@ -126,34 +130,37 @@ func configureProvider(reader *bufio.Reader, cfg *config.Config) error {
 
 func configureAPI(reader *bufio.Reader, cfg *config.Config) error {
 	if cfg.LLM.Provider != providerLocal {
-		cfg.LLM.APIKey = prompt(reader, "请输入 API Key", "")
+		cfg.LLM.APIKey = prompt(reader, i18n.T(i18n.PromptEnterAPIKey), "")
 		if cfg.LLM.APIKey == "" {
-			fmt.Println("警告: API Key 为空，您可能需要在环境变量 AICLI_API_KEY 中设置。")
+			fmt.Println(i18n.T(i18n.WarnAPIKeyEmpty))
 		}
 	}
 
-	cfg.LLM.Model = prompt(reader, fmt.Sprintf("请输入模型名称 (默认: %s)", cfg.LLM.Model), cfg.LLM.Model)
-	cfg.LLM.APIBase = prompt(reader, fmt.Sprintf("请输入 API Base URL (默认: %s)", cfg.LLM.APIBase), cfg.LLM.APIBase)
+	modelPrompt := fmt.Sprintf("%s (%s: %s)", i18n.T(i18n.PromptEnterModel), i18n.T(i18n.MsgDefault), cfg.LLM.Model)
+	cfg.LLM.Model = prompt(reader, modelPrompt, cfg.LLM.Model)
+	
+	apiBasePrompt := fmt.Sprintf("%s (%s: %s)", i18n.T(i18n.PromptEnterAPIBase), i18n.T(i18n.MsgDefault), cfg.LLM.APIBase)
+	cfg.LLM.APIBase = prompt(reader, apiBasePrompt, cfg.LLM.APIBase)
 
 	return nil
 }
 
 func configureOtherSettings(reader *bufio.Reader, cfg *config.Config) error {
-	fmt.Println("\n--- 其他设置 ---")
-	cfg.Safety.EnableChecks = promptBool(reader, "是否启用危险命令安全检查？", true)
-	cfg.History.Enabled = promptBool(reader, "是否启用历史记录？", true)
+	fmt.Println("\n" + i18n.T(i18n.MsgOtherSettings))
+	cfg.Safety.EnableChecks = promptBool(reader, i18n.T(i18n.PromptEnableCheck), true)
+	cfg.History.Enabled = promptBool(reader, i18n.T(i18n.PromptEnableHistory), true)
 	return nil
 }
 
 func saveConfig(cfg *config.Config, configPath string) error {
-	fmt.Println("\n正在保存配置...")
+	fmt.Println("\n" + i18n.T(i18n.MsgSavingConfig))
 	if err := cfg.Save(configPath); err != nil {
-		return fmt.Errorf("保存配置失败: %w", err)
+		return fmt.Errorf("%s: %w", i18n.T(i18n.ErrSaveConfig), err)
 	}
 
-	fmt.Printf("配置已成功保存到 %s\n", configPath)
-	fmt.Println("现在您可以开始使用 aicli 了！")
-	fmt.Println("示例: aicli \"查询我的公网IP\"")
+	fmt.Println(i18n.T(i18n.MsgConfigSaved, configPath))
+	fmt.Println(i18n.T(i18n.MsgNowCanUse))
+	fmt.Println(i18n.T(i18n.MsgExampleUsage))
 
 	return nil
 }