feat: Add ollama translator support

--story=1

Author: studyzy

.codebuddy/commands/openspec/apply.md

@@ -0,0 +1,23 @@
+---
+name: OpenSpec: 实施
+description: 实施已批准的OpenSpec变更并保持任务同步。
+category: OpenSpec
+tags: [openspec, apply]
+---
+<!-- 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,27 @@
+---
+name: OpenSpec: 归档
+description: 归档已部署的OpenSpec变更并更新规范。
+category: OpenSpec
+tags: [openspec, archive]
+---
+<!-- 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,28 @@
+---
+name: OpenSpec: 提案
+description: 搭建新的OpenSpec变更提案并进行严格验证。
+category: OpenSpec
+tags: [openspec, change]
+---
+<!-- 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 -->

.codei18n/mappings.json

@@ -176,7 +176,8 @@
       "zh-CN": "// Config 代表项目配置"
     },
     "12643a2e6591197284f266a6b70eb9a428be38d0": {
-      "en": "// Verify the last doc comments (lines 15, 17, 18)\n// We expect them to be separate but have the same symbol"
+      "en": "// Verify the last doc comments (lines 15, 17, 18)\n// We expect them to be separate but have the same symbol",
+      "zh-CN": "// 验证最后的文档注释（第15、17、18行）\n// 我们希望它们是独立的但具有相同的符号"
     },
     "1311d6e062c85e73fb969ffe451e40f1630f6317": {
       "en": "// If I pass server.URL to NewLLMTranslator, the client will append /chat/completions?",
@@ -475,7 +476,8 @@
       "zh-CN": "// 块注释 /* */"
     },
     "2972276bec78563545bf4fe31350177a7bd5e811": {
-      "en": "// Verify range logic for first comment (line 1)"
+      "en": "// Verify range logic for first comment (line 1)",
+      "zh-CN": "// 验证第一条注释（第1行）的范围逻辑"
     },
     "2aa5b10fd959f6d7a34647fca6b0bb705129c105": {
       "en": "// - If zh-CN exists but en is missing: zh-CN -\u003e en",
@@ -566,7 +568,8 @@
       "zh-CN": "// GenerateCommentID 为评论计算一个稳定的ID"
     },
     "32e60c112bd0efa971fb7c9196461e55d8630829": {
-      "en": "/// This is an optimization that allows us to keep using the static precompiles"
+      "en": "/// This is an optimization that allows us to keep using the static precompiles",
+      "zh-CN": "/// 这是一种优化，允许我们继续使用静态预编译合约"
     },
     "338f41c80244b4be6d7a151887fbeeb46cdce772": {
       "en": "// Create the content to hash",
@@ -877,7 +880,8 @@
       "zh-CN": "// LanguageAdapter 定义了语言特定解析器的接口"
     },
     "543f716248798f3acd7c15dee782360393de062c": {
-      "en": "// Line 17"
+      "en": "// Line 17",
+      "zh-CN": "// 第17行"
     },
     "55cf0f288a1869934366533f97c2e4d25d295a2a": {
       "en": "// Append content\n// Ensure we have a newline between them if not present in the last one",
@@ -908,7 +912,8 @@
       "zh-CN": "// 确定策略"
     },
     "58ec13c61728d38e31e55efd6b36342f81dfc3f2": {
-      "en": "//! It happened on Ethereum block 1_920_000"
+      "en": "//! It happened on Ethereum block 1_920_000",
+      "zh-CN": "//! 这发生在以太坊区块 1_920_000"
     },
     "5a7adb029281a1a578262900b2e3858e677bf683": {
       "en": "// Normalize current comment text for comparison",
@@ -947,7 +952,8 @@
       "zh-CN": "// Version 是映射文件格式的版本号（例如：\"1.0\"）"
     },
     "5f25ee88be7bdce1231e3d92513b03fb6204d6f2": {
-      "en": "// good"
+      "en": "// good",
+      "zh-CN": "// 好"
     },
     "5f9a3b66d0c811823df0e16c9bcfe939990b65b3": {
       "en": "// Mixed batch, fallback to sequential loop manually here\n// This shouldn't happen often if we sort, but safety net.",
@@ -1102,7 +1108,8 @@
       "zh-CN": "// - 如果存在英文版本但缺少中文简体版本：英文 -\u003e 中文简体"
     },
     "724a4e4b73aeb0efed82ddce315d7e237ff59f0a": {
-      "en": "// Line 15"
+      "en": "// Line 15",
+      "zh-CN": "// 第15行"
     },
     "725c0ca4655e8edf6ff0d91fc134e2ab89da386f": {
       "en": "// var result map[string]interface{}",
@@ -1361,7 +1368,8 @@
       "zh-CN": "// Mapping 表示映射文件的结构"
     },
     "8e97132c83930a78177bb7133078f0fc7dd3cee0": {
-      "en": "//! DAO Fork related constants from [EIP-779](https://eips.ethereum.org/EIPS/eip-779)."
+      "en": "//! DAO Fork related constants from [EIP-779](https://eips.ethereum.org/EIPS/eip-779).",
+      "zh-CN": "//! 来自[EIP-779](https://eips.ethereum.org/EIPS/eip-779)的DAO分叉相关常量。"
     },
     "8ecb1b5c0b7cab6b8a3ab8cf964ffb26738ee732": {
       "en": "// Check if ID exists",
@@ -1496,7 +1504,8 @@
       "zh-CN": "// RustAdapter 为 Rust 语言实现了 LanguageAdapter 接口。\n// 它使用 Tree-sitter 解析 Rust 源代码，并提取注释及其上下文。"
     },
     "9e0769f27a5a61c5920154b1a31a031fe77f9aea": {
-      "en": "// luck"
+      "en": "// luck",
+      "zh-CN": "// 运气"
     },
     "9e9ff4ff1867057fb3508f8f3a3c7cee3e5c5ddf": {
       "en": "// Comment represents a single comment extracted from AST",
@@ -1543,7 +1552,8 @@
       "zh-CN": "// 它返回一个包含评论文本、位置和上下文符号的 domain.Comment 结构体列表。"
     },
     "a419be8974323121254abe6995f87c098872262d": {
-      "en": "// Expect 11 comments without merging:\n// 1. Inner doc (line 1)\n// 2. Inner doc (line 2)\n// 3. Inner doc (line 4)\n// 4. Outer doc (line 6)\n// 5. Line comment (line 8)\n// 6. Block comment (lines 9-10)\n// 7. Line comment (line 11)\n// 8. Line comment (line 12)\n// 9. Doc comment (line 15)\n// 10. Doc comment (line 17) - line 16 is empty and filtered\n// 11. Doc comment (line 18)"
+      "en": "// Expect 11 comments without merging:\n// 1. Inner doc (line 1)\n// 2. Inner doc (line 2)\n// 3. Inner doc (line 4)\n// 4. Outer doc (line 6)\n// 5. Line comment (line 8)\n// 6. Block comment (lines 9-10)\n// 7. Line comment (line 11)\n// 8. Line comment (line 12)\n// 9. Doc comment (line 15)\n// 10. Doc comment (line 17) - line 16 is empty and filtered\n// 11. Doc comment (line 18)",
+      "zh-CN": "// 预期有11条未合并的注释：\n// 1. 内部文档注释（第1行）\n// 2. 内部文档注释（第2行）\n// 3. 内部文档注释（第4行）\n// 4. 外部文档注释（第6行）\n// 5. 行注释（第8行）\n// 6. 块注释（第9-10行）\n// 7. 行注释（第11行）\n// 8. 行注释（第12行）\n// 9. 文档注释（第15行）\n// 10. 文档注释（第17行）- 第16行为空行已被过滤\n// 11. 文档注释（第18行）"
     },
     "a42bbc48bddf39a3604678b584e5271e273f1dea": {
       "en": "// Test empty array",
@@ -1670,7 +1680,8 @@
       "zh-CN": "// 但命令行界面可以扫描目录。"
     },
     "b0c4b4afb41326693301a70f826bbad28f563336": {
-      "en": "// Line 18"
+      "en": "// Line 18",
+      "zh-CN": "// 第18行"
     },
     "b0e8c7ede9066d54d8d0eac233cf1190b0a6e936": {
       "en": "// [MOCK zh-CN-\u003een] // Remove comment markers",
@@ -2025,7 +2036,8 @@
       "zh-CN": "// Tree-sitter 通常将 macro_rules! 的主体解析为令牌树或特定结构\n// 看看它是否能捕获注释。\n// 更新：这取决于语法中如何定义 'macro_rules'。\n// 如果它能提取出来，很好。如果不能，目前可以接受（根据规范）。"
     },
     "d10588558d7105c5b9504114eab6e27b4b342e3c": {
-      "en": "/// until we need to modify them, at which point we convert to the dynamic representation."
+      "en": "/// until we need to modify them, at which point we convert to the dynamic representation.",
+      "zh-CN": "/// 在需要修改之前，我们保持使用静态表示，需要修改时再转换为动态表示。"
     },
     "d119c66734dec806c571617b36d48bc0a2b31a0e": {
       "en": "// Debug: Print mappings.json",
@@ -2132,7 +2144,8 @@
       "zh-CN": "// 这是一个行注释，添加到缓冲区"
     },
     "d996bb683a5ad1c81f8565f44d68da8f20ca4dca": {
-      "en": "/// A mapping of precompile contracts that can be either static (builtin) or dynamic."
+      "en": "/// A mapping of precompile contracts that can be either static (builtin) or dynamic.",
+      "zh-CN": "/// 预编译合约的映射，可以是静态（内置）或动态的。"
     },
     "da486cda0e857bd7dd13c9ed12ca40a65c20030f": {
       "en": "// c.SourceText is EN",

AGENTS.md

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

CODEBUDDY.md

@@ -1,3 +1,32 @@
+<!-- OPENSPEC:START -->
+# OpenSpec 使用说明
+
+这些说明适用于在此项目中工作的AI助手。
+
+## 语言偏好设置
+
+**默认使用中文**：除非明确说明使用英文，否则所有输出都应使用中文，包括：
+- 文档内容
+- 代码注释
+- 提交信息
+- 规范说明
+
+## 工作流程
+
+当请求满足以下条件时，始终打开`@/openspec/AGENTS.md`：
+- 提及规划或提案（如提案、规范、变更、计划等词语）
+- 引入新功能、重大变更、架构变更或大型性能/安全工作时
+- 听起来不明确，需要在编码前了解权威规范时
+
+使用`@/openspec/AGENTS.md`了解：
+- 如何创建和应用变更提案
+- 规范格式和约定
+- 项目结构和指南
+
+保持此托管块，以便'openspec-cn update'可以刷新说明。
+
+<!-- OPENSPEC:END -->
+
 # CODEBUDDY.md
 
 本文件为 CodeBuddy Code 在此仓库中工作时提供指导。
@@ -183,12 +212,17 @@ type Translator interface {
 ```
 
 ### 策略
-- **本地缓存优先**（避免提交时实时调用 API）
-- 支持的后端：
-  - DeepL
-  - OpenAI
-  - 自定义术语词典
-- 翻译失败可阻断提交（可配置）
+- **本地缓存优先**：优先复用已有翻译结果，避免在提交路径上频繁调用外部服务。
+- 支持的翻译后端（通过 `translationProvider` 选择）：
+  - 远程 LLM（`openai` / `llm`）：基于 OpenAI 兼容协议的翻译服务（官方 OpenAI、DeepSeek 或自建代理），使用 `OPENAI_API_KEY` 和可选 `OPENAI_BASE_URL`。
+  - 本地 Ollama（`ollama`）：调用本地 Ollama 实例的 REST API，使用本地模型（如 `llama3`、`qwen3` 等）。调用时默认关闭思维链（`think=false`），避免额外延迟。
+  - Mock（`mock`）：仅用于测试和集成测试，不用于生产环境。
+- 翻译失败可阻断提交（可配置），建议在 CI 环节或预翻译阶段完成大部分工作，在 pre-commit 仅做增量检查。
+
+### 配置约定
+
+- 顶层字段：`translationProvider`（`openai`/`llm`/`ollama`）
+- 细节字段：`translationConfig`（如 `baseUrl`、`model`、`endpoint`）
 
 ## 映射文件
 
@@ -256,6 +290,11 @@ codei18n scan --file xxx.go --lang zh-CN --format json
 {
   "sourceLanguage": "en",
   "localLanguage": "zh-CN",
+  "translationProvider": "openai",
+  "translationConfig": {
+    "baseUrl": "https://api.openai.com/v1",
+    "model": "gpt-4.1-mini"
+  },
   "ide": {
     "vscode": {
       "displayMode": "overlay"
@@ -267,6 +306,11 @@ codei18n scan --file xxx.go --lang zh-CN --format json
 }
 ```
 
+说明：
+- `translationProvider`：选择翻译后端，当前推荐 `openai`（也支持别名 `llm`）或本地 `ollama`。
+- `translationConfig`：不同后端的细节配置，如 `baseUrl`、`model`（OpenAI/DeepSeek）或 `endpoint`（Ollama）。
+
+
 ## 开发路线图
 
 ### v0.1 (MVP)