docs: translate repository documentation to English (#72)

openspec/changes/localize-app-chinese-default/design.md

@@ -1,30 +1,30 @@
-# 设计：多语言支持
+# Design: Multilingual Support
 
-## 架构
+## Architecture
 
-应用使用 `react-i18next` 进行国际化，并配合 `i18next-browser-languagedetector` 进行语言检测。配置集中在 `src/localization/i18n.ts` 中。
+The application uses `react-i18next` for i18n and `i18next-browser-languagedetector` for language detection. Configuration is centralized in `src/localization/i18n.ts`.
 
-### 语言资源
+### Language Resources
 
-翻译资源将作为 JSON 对象构建在 `i18n.ts` 中（如果太大则分文件）。
-我们将在 `resources` 对象中添加 `zh-CN` 键。
+Translation resources are built as JSON objects in `i18n.ts` (or split into files if they grow large).
+We add a `zh-CN` key in the `resources` object.
 
-### 默认语言策略
+### Default Language Strategy
 
-我们将引入 `LanguageDetector` 插件。
-`i18n.use(LanguageDetector).init({...})` 将被配置为首先检查 `localStorage`，然后检查 `navigator`（浏览器/系统语言）。
-`fallbackLng` 将保持为 `'en'`，作为最后的兜底。
+We introduce the `LanguageDetector` plugin.
+`i18n.use(LanguageDetector).init({...})` is configured to check `localStorage` first, then `navigator` (browser/system language).
+`fallbackLng` remains `'en'` as the final fallback.
 
-### 键映射
+### Key Mapping
 
-我们将把现有的英文字符串映射到语义键（例如 `home.title`, `settings.theme`）。
+Existing English strings are mapped to semantic keys (for example, `home.title`, `settings.theme`).
 
-## 数据流
+## Data Flow
 
-1. 应用启动。
-2. `i18next` 初始化，通过 `LanguageDetector` 确定语言：
-   * 检查 `localStorage` 是否有保存的偏好。
-   * 如果无，检查 `navigator.language`。
-   * 如果检测到的语言受支持（`en` 或 `zh-CN`），则使用该语言。
-   * 否则，使用 `fallbackLng` (`en`)。
-3. 组件使用 `useTranslation` hook 根据当前语言获取字符串。
+1. App starts.
+2. `i18next` initializes and determines language via `LanguageDetector`:
+   * Check whether `localStorage` has a saved preference.
+   * If not, check `navigator.language`.
+   * If detected language is supported (`en` or `zh-CN`), use it.
+   * Otherwise, use `fallbackLng` (`en`).
+3. Components use `useTranslation` to resolve strings for the active language.

openspec/changes/localize-app-chinese-default/proposal.md

@@ -1,41 +1,41 @@
-# 提案：应用本地化（自动检测系统语言）
+# Proposal: App Localization (Automatic System Language Detection)
 
-**变更 ID：** `localize-app-auto-detect`
+**Change ID:** `localize-app-auto-detect`
 
-## 摘要
+## Summary
 
-为 Antigravity Manager 应用添加多语言支持，并根据用户的操作系统语言自动设置默认语言。如果系统语言不受支持，则回退到英语。这包括更新 i18n 配置，添加中文翻译资源，并集成语言检测插件。
+Add multilingual support to Antigravity Manager and automatically set the default UI language based on the user's OS language. If the OS language is unsupported, fall back to English. This includes updating i18n configuration, adding Chinese translation resources, and integrating a language detection plugin.
 
-## 动机
+## Motivation
 
-为了提供最佳的用户体验，应用应该能够适应用户的首选语言环境。自动检测系统语言可以减少用户的配置步骤，提供更自然的初次使用体验。
+To provide a better user experience, the app should adapt to users' preferred language environment. Automatically detecting system language reduces setup effort and improves first-run experience.
 
-## 建议变更
+## Proposed Changes
 
-1. **集成语言检测：** 安装并配置 `i18next-browser-languagedetector` 以自动检测用户语言。
-2. **更新 i18n 配置：** 修改 `src/localization/i18n.ts`，启用语言检测，并设置适当的回退语言（英语）。
-3. **添加中文资源：** 为 `zh-CN` 创建一个新的翻译资源文件，包含所有应用字符串。
-4. **更新语言操作：** 确保 `src/actions/language.ts` 正确处理自动检测和手动覆盖的逻辑。
-5. **UI 更新：** 确保所有 UI 组件使用翻译键而不是硬编码字符串。
+1. **Integrate language detection:** Install and configure `i18next-browser-languagedetector` to auto-detect user language.
+2. **Update i18n config:** Modify `src/localization/i18n.ts` to enable language detection and define a fallback language (English).
+3. **Add Chinese resources:** Create `zh-CN` translation resources covering all app strings.
+4. **Update language actions:** Ensure `src/actions/language.ts` correctly handles auto-detection and manual override.
+5. **UI updates:** Ensure all UI components use translation keys instead of hardcoded text.
 
-## 考虑的替代方案
+## Alternatives Considered
 
-* **强制默认中文：** 已拒绝，为了适应更广泛的国际用户群体，并尊重用户的系统设置。
-* **强制默认英语：** 已拒绝，同上。
+* **Force default Chinese:** Rejected, to support a broader international user base and respect system settings.
+* **Force default English:** Rejected, same reason.
 
-## 风险
+## Risks
 
-* **检测失败：** 在某些特殊环境（如 Linux 某些发行版）下，语言检测可能不准确，需要确保回退机制可靠。
+* **Detection failure:** In certain environments (for example, some Linux distros), language detection may be inaccurate. Fallback behavior must remain reliable.
 
-## 验收标准
+## Acceptance Criteria
 
-1. **自动检测：**
-   * 在系统语言设置为中文（简体）的环境下启动应用，应用界面默认显示为中文。
-   * 在系统语言设置为英语或其他非中文语言的环境下启动应用，应用界面默认显示为英语。
-2. **手动切换：**
-   * 用户可以在设置页面将语言从中文切换到英语，界面应立即更新，无需重启。
-   * 用户可以在设置页面将语言从英语切换到中文，界面应立即更新，无需重启。
-3. **持久化：**
-   * 用户手动更改语言后，重启应用，应用应保持用户选择的语言，而不是重新检测系统语言。
-4. **完整性：**
-   * 应用的所有可见文本（包括主页、设置页、状态栏、弹窗提示）都应正确显示对应的语言，没有遗漏的硬编码字符串。
+1. **Automatic detection:**
+   * When OS language is Simplified Chinese, app defaults to Chinese on first launch.
+   * When OS language is English or another non-Chinese language, app defaults to English on first launch.
+2. **Manual switching:**
+   * Users can switch from Chinese to English in Settings, and UI updates immediately without restart.
+   * Users can switch from English to Chinese in Settings, and UI updates immediately without restart.
+3. **Persistence:**
+   * After users manually change language, app restart preserves the selected language instead of re-detecting.
+4. **Completeness:**
+   * All visible strings (home page, settings page, status bar, popups) render correctly in the selected language with no leftover hardcoded text.

openspec/changes/localize-app-chinese-default/specs/localization/spec.md

@@ -1,59 +1,59 @@
-# 规格：本地化
+# Spec: Localization
 
 ## ADDED Requirements
 
-### Requirement: 自动语言检测
+### Requirement: Automatic Language Detection
 
-应用在首次启动时 MUST 自动检测用户的系统语言并设置相应的界面语言。
+On first launch, the application MUST automatically detect the user's system language and set the corresponding UI language.
 
-#### Scenario: 系统语言为中文
+#### Scenario: System language is Chinese
 
-Given 用户首次打开应用
-And 用户的系统语言设置为中文 (zh-CN)
-And 本地存储中没有保存语言偏好
-When 应用加载时
-Then 界面应该显示为简体中文 (`zh-CN`)
+Given the user opens the app for the first time
+And the user's system language is set to Chinese (`zh-CN`)
+And no language preference is saved in local storage
+When the app loads
+Then the UI should be displayed in Simplified Chinese (`zh-CN`)
 
-#### Scenario: 系统语言为其他（非中文）
+#### Scenario: System language is non-Chinese
 
-Given 用户首次打开应用
-And 用户的系统语言设置为法语 (fr)
-And 本地存储中没有保存语言偏好
-When 应用加载时
-Then 界面应该回退显示为英语 (`en`)
+Given the user opens the app for the first time
+And the user's system language is set to French (`fr`)
+And no language preference is saved in local storage
+When the app loads
+Then the UI should fall back to English (`en`)
 
-### Requirement: 语言切换
+### Requirement: Language Switching
 
-用户 MUST 能够在支持的语言之间切换，且手动选择 MUST 覆盖自动检测。
+Users MUST be able to switch between supported languages, and manual selection MUST override automatic detection.
 
-#### Scenario: 切换语言
+#### Scenario: Switch language
 
-Given 用户在设置页面
-When 用户从语言下拉菜单中选择 "English"
-Then 界面应该立即切换为英语
-And 偏好应该保存到本地存储
+Given the user is on the settings page
+When the user selects "English" from the language dropdown
+Then the UI should switch to English immediately
+And the preference should be saved to local storage
 
-### Requirement: 持久化
+### Requirement: Persistence
 
-用户的手动语言偏好 MUST 在会话之间持久化，并优先于系统语言。
+The user's manual language preference MUST persist across sessions and take precedence over system language.
 
-#### Scenario: 持久化语言偏好
+#### Scenario: Persist language preference
 
-Given 用户已手动选择 "English" 作为首选语言
-And 用户的系统语言设置为中文
-When 用户重启应用
-Then 界面应该显示为英语（尊重用户选择）
+Given the user has manually selected "English" as preferred language
+And the user's system language is Chinese
+When the user restarts the app
+Then the UI should display English (respecting user preference)
 
 ## MODIFIED Requirements
 
-### Requirement: i18n 配置更新
+### Requirement: Update i18n Configuration
 
-i18n 配置 MUST 更新以支持语言检测插件。
+i18n configuration MUST be updated to support the language detection plugin.
 
-#### Scenario: i18n 配置
+#### Scenario: i18n configuration
 
-`src/localization/i18n.ts` 文件必须更新为：
+`src/localization/i18n.ts` must be updated to:
 
-1. 集成 `i18next-browser-languagedetector`。
-2. 配置检测顺序：`['localStorage', 'navigator']`。
-3. 包含 `zh-CN` 资源对象。
+1. Integrate `i18next-browser-languagedetector`.
+2. Configure detection order as `['localStorage', 'navigator']`.
+3. Include `zh-CN` resource objects.

openspec/changes/localize-app-chinese-default/tasks.md

@@ -1,10 +1,10 @@
-# 任务：应用本地化（自动检测系统语言）
+# Tasks: App Localization (Automatic System Language Detection)
 
-* \[x] 安装 `i18next-browser-languagedetector` 依赖。 <!-- id: install-dependency -->
-* \[x] 更新 `src/localization/i18n.ts` 以配置语言检测器并包含 `zh-CN` 资源。 <!-- id: update-i18n-config -->
-* \[x] 验证 `src/actions/language.ts` 逻辑，确保与自动检测兼容。 <!-- id: verify-language-actions -->
-* \[x] 更新 `src/components/StatusBar.tsx` 以使用翻译。 <!-- id: localize-statusbar -->
-* \[x] 更新 `src/components/AccountCard.tsx` 以使用翻译。 <!-- id: localize-accountcard -->
-* \[x] 更新 `src/pages/index.tsx`（主页）以使用翻译。 <!-- id: localize-homepage -->
-* \[x] 更新 `src/pages/settings.tsx` 以使用翻译并添加语言切换器。 <!-- id: localize-settings -->
-* \[x] 运行应用验证语言检测和手动切换功能。 <!-- id: verify-localization -->
+* \[x] Install `i18next-browser-languagedetector`. <!-- id: install-dependency -->
+* \[x] Update `src/localization/i18n.ts` to configure language detection and include `zh-CN` resources. <!-- id: update-i18n-config -->
+* \[x] Verify `src/actions/language.ts` logic is compatible with auto-detection. <!-- id: verify-language-actions -->
+* \[x] Update `src/components/StatusBar.tsx` to use translations. <!-- id: localize-statusbar -->
+* \[x] Update `src/components/AccountCard.tsx` to use translations. <!-- id: localize-accountcard -->
+* \[x] Update `src/pages/index.tsx` (home page) to use translations. <!-- id: localize-homepage -->
+* \[x] Update `src/pages/settings.tsx` to use translations and add a language switcher. <!-- id: localize-settings -->
+* \[x] Run the app to verify language detection and manual switching. <!-- id: verify-localization -->

openspec/project.md

@@ -2,105 +2,108 @@
 
 ## Purpose
 
-Antigravity Manager 是一个综合性的 Antigravity 增强工具，旨在打破 AI 开发的资源限制。它不仅解决了 Antigravity IDE 客户端无法原生支持多账号切换的痛点，还引入了企业级的 AI 服务账号池管理功能。通过接管应用的配置状态和云端 API 资源，它允许用户在无限个本地账号和云端 AI 服务之间无缝切换，实现 "无限" 的 AI 调用体验。
+Antigravity Manager is a comprehensive enhancement tool for Antigravity, designed to remove AI development resource limits. It not only solves the lack of native multi-account switching in Antigravity IDE, but also introduces enterprise-grade AI account pool management. By taking control of app configuration state and cloud API resources, it allows users to switch seamlessly between unlimited local accounts and cloud AI services for an effectively "unlimited" AI usage experience.
 
-**核心目标：**
+**Core goals:**
 
-*   **本地多账号切换**：无缝切换 Antigravity IDE 的本地用户状态，保护数据完整性（自动备份）。
-*   **AI 资源池管理**（新）：集中管理 Google Gemini、Claude 3.5 等 AI 服务的账号池。
-*   **智能配额监控**（新）：实时监控 API 配额（Quota）和健康度，提供可视化仪表盘。
-*   **自动资源调度**（新）：当当前账号配额耗尽时，自动切换到最佳可用账号（Token 保活与轮询）。
-*   **跨平台支持**：统一的 macOS、Windows、Linux 体验。
+* **Local multi-account switching**: Seamlessly switch Antigravity IDE local user state while protecting data integrity (automatic backup).
+* **AI resource pool management (new)**: Centrally manage account pools for Google Gemini, Claude 3.5, and similar services.
+* **Intelligent quota monitoring (new)**: Monitor API quota and health in real time with a visual dashboard.
+* **Automatic resource scheduling (new)**: Automatically switch to the best available account when the current one runs out of quota (token keepalive + polling).
+* **Cross-platform support**: Consistent macOS, Windows, and Linux experience.
 
 ## Tech Stack
 
-*   **Electron 39** - 跨平台桌面应用框架
-*   **React 19.2** - UI 框架
-*   **TypeScript 5.9** - 类型安全的开发语言
-*   **Shadcn UI** - 现代化 UI 组件库
-*   **Tailwind CSS 4** - 样式框架
-*   **oRPC** - 类型安全的 IPC 通信
-*   **TanStack Router** - 文件路由
-*   **React Query** - 服务器状态管理
-*   **better-sqlite3** - SQLite 数据库访问
-*   **Vite** - 构建工具
-*   **Vitest** - 单元测试
-*   **Playwright** - 端到端测试
-*   **Electron Forge** - 应用打包和分发
+* **Electron 39** - Cross-platform desktop framework
+* **React 19.2** - UI framework
+* **TypeScript 5.9** - Type-safe development language
+* **Shadcn UI** - Modern UI component library
+* **Tailwind CSS 4** - Styling framework
+* **oRPC** - Type-safe IPC communication
+* **TanStack Router** - File-based routing
+* **React Query** - Server state management
+* **better-sqlite3** - SQLite data access
+* **Vite** - Build tool
+* **Vitest** - Unit testing
+* **Playwright** - End-to-end testing
+* **Electron Forge** - Packaging and distribution
 
 ## Project Conventions
 
 ### Code Style
 
-*   TypeScript strict mode
-*   ESLint + Prettier 自动格式化
-*   函数和变量使用 camelCase
-*   组件使用 PascalCase
-*   接口使用 PascalCase，以 I 开头（可选）
-*   类型使用 PascalCase
-*   2 空格缩进
-*   单引号字符串
-*   尾随逗号
+* TypeScript strict mode
+* ESLint + Prettier auto-formatting
+* Use camelCase for functions and variables
+* Use PascalCase for components
+* Use PascalCase for interfaces, optionally prefixed with `I`
+* Use PascalCase for types
+* 2-space indentation
+* Single-quoted strings
+* Trailing commas
 
 ### Architecture Patterns
 
-```
+```plaintext
 src/
-├── main.ts              # Electron 主进程
-├── preload.ts           # 预加载脚本
-├── renderer.ts          # 渲染进程入口
-├── ipc/                 # IPC 通信层
-│   ├── account/         # 本地 IDE 账号管理 IPC
-│   ├── cloud/           # 云端 AI 资源管理 IPC（新）
-│   ├── database/        # 数据库操作 IPC
-│   └── process/         # 进程管理 IPC
-├── services/            # 业务逻辑服务层（新）
-│   ├── QuotaService.ts  # 配额监控服务
-│   └── TokenService.ts  # Token 保活服务
-├── actions/             # 渲染进程操作（oRPC 客户端）
-├── components/          # React 组件
-├── routes/              # 页面路由
-├── layouts/             # 布局组件
-├── utils/               # 工具函数
-├── types/               # TypeScript 类型定义
-└── tests/               # 测试文件
+├── main.ts              # Electron main process
+├── preload.ts           # Preload script
+├── renderer.ts          # Renderer entry
+├── ipc/                 # IPC communication layer
+│   ├── account/         # Local IDE account IPC
+│   ├── cloud/           # Cloud AI resource IPC (new)
+│   ├── database/        # Database operation IPC
+│   └── process/         # Process management IPC
+├── services/            # Business service layer (new)
+│   ├── QuotaService.ts  # Quota monitoring service
+│   └── TokenService.ts  # Token keepalive service
+├── actions/             # Renderer actions (oRPC client)
+├── components/          # React components
+├── routes/              # Page routes
+├── layouts/             # Layout components
+├── utils/               # Utility functions
+├── types/               # TypeScript type definitions
+└── tests/               # Test files
 ```
 
-**设计模式：**
+**Design patterns:**
 
-*   **关注点分离**：主进程处理系统操作和网络代理，渲染进程处理 UI。
-*   **Service 层**：引入 Service 层处理复杂的配额轮询和 Token 刷新逻辑。
-*   **类型安全 IPC**：使用 oRPC 确保主进程和渲染进程之间的类型安全通信。
-*   **状态管理**：React Query 管理服务器状态和异步配额数据。
+* **Separation of concerns**: Main process handles system operations and network proxy; renderer handles UI.
+* **Service layer**: Encapsulates complex quota polling and token refresh logic.
+* **Type-safe IPC**: Uses oRPC to enforce type-safe communication between main and renderer.
+* **State management**: React Query manages server state and async quota data.
 
 ### Testing Strategy
 
-*   **单元测试（Vitest）**：测试 IPC 处理程序、Service 逻辑、工具函数。
-*   **集成测试（Vitest）**：测试完整的 IPC 流程。
-*   **端到端测试（Playwright）**：测试用户工作流。
-*   **覆盖率目标**：核心逻辑 >80%。
+* **Unit tests (Vitest)**: IPC handlers, service logic, utility functions.
+* **Integration tests (Vitest)**: End-to-end IPC flow.
+* **End-to-end tests (Playwright)**: User workflows.
+* **Coverage target**: Core logic > 80%.
 
 ### Git Workflow
 
-*   **主分支**：`main`
-*   **开发分支**：`develop`
-*   **提交规范**：语义化提交 (feat, fix, docs, refactor, test, chore)
+* **Main branch**: `main`
+* **Development branch**: `develop`
+* **Commit style**: Conventional commits (`feat`, `fix`, `docs`, `refactor`, `test`, `chore`)
 
 ## Domain Context
 
-### 1. Antigravity IDE 数据结构（本地）
+### 1. Antigravity IDE Data Structure (Local)
+
+**Database locations:**
 
-**数据库位置：**
 * macOS: `~/Library/Application Support/Antigravity/User/globalStorage/state.vscdb`
 * Windows: `%APPDATA%/Antigravity/User/globalStorage/state.vscdb`
 * Linux: `~/.config/Antigravity/User/globalStorage/state.vscdb`
 
-**关键数据库键：**
-* `antigravityAuthStatus`: 认证状态和用户信息。
+**Key database fields:**
 
-### 2. AI 服务资源结构（云端/新）
+* `antigravityAuthStatus`: Authentication status and user information.
+
+### 2. AI Service Resource Structure (Cloud / New)
+
+**Account model:**
 
-**账号模型：**
 ```json
 {
   "id": "uuid",
@@ -115,49 +118,49 @@ src/
 }
 ```
 
-### 3. 进程管理策略
+### 3. Process Management Strategy
 
-*   **三阶段关闭**：优雅关闭 -> SIGTERM -> SIGKILL。
+* **Three-phase shutdown**: Graceful close -> SIGTERM -> SIGKILL.
 
 ## Important Constraints
 
-### 技术约束
+### Technical Constraints
 
-*   **数据库访问**：访问本地 IDE 数据库时需注意文件锁。
-*   **网络访问**：需要访问外部 API (Google/Anthropic) 以获取配额信息。
-*   **凭证安全**：OAuth Token 和 Refresh Token 必须使用系统级加密存储 (Keytar / SQLite Encrypted)。
-*   **并发控制**：轮询配额时需注意频率，避免触发 API 封控。
+* **Database access**: Handle file locks when accessing local IDE databases.
+* **Network access**: External API access (Google/Anthropic) is required for quota retrieval.
+* **Credential security**: OAuth and refresh tokens must use system-level encrypted storage (Keytar / encrypted SQLite).
+* **Concurrency control**: Quota polling frequency must be controlled to avoid API throttling or blocking.
 
-### 用户体验约束
+### UX Constraints
 
-*   **响应时间**：账号切换应在 5 秒内完成。
-*   **静默运行**：支持最小化到托盘，后台自动刷新 Token。
-*   **数据安全**：切换前必须自动备份当前状态。
+* **Response time**: Account switching should complete within 5 seconds.
+* **Silent mode**: Support tray minimization and background token refresh.
+* **Data safety**: Always back up current state before switching.
 
 ## External Dependencies
 
-### 系统依赖
+### System Dependencies
 
-*   **Antigravity IDE**：本地管理目标。
-*   **SQLite**：本地数据读取。
+* **Antigravity IDE**: Local target to manage.
+* **SQLite**: Local data reads.
 
-### Node.js 依赖（重点）
+### Node.js Dependencies (Key)
 
-*   `better-sqlite3`: 数据库访问。
-*   `electron`: 桌面框架。
-*   `node-fetch` / `axios`: 网络请求。
-*   `tar` / `adm-zip`: 备份压缩。
+* `better-sqlite3`: Database access.
+* `electron`: Desktop framework.
+* `node-fetch` / `axios`: Network requests.
+* `tar` / `adm-zip`: Backup compression.
 
-### 外部服务
+### External Services
 
-*   **Google Gemini API**: 用于配额检查。
-*   **Anthropic API**: 用于配额检查。
-*   **OAuth 2.0 端点**: 用于账号授权。
+* **Google Gemini API**: For quota checks.
+* **Anthropic API**: For quota checks.
+* **OAuth 2.0 endpoints**: For account authorization.
 
-### 文件系统依赖
+### Filesystem Dependencies
 
-*   `~/.antigravity-agent/`
-    *   `accounts.json`: 本地 IDE 账号索引。
-    *   `cloud_accounts.db`: (新) 云端账号池数据库 (SQLite)。
-    *   `backups/`: 备份文件。
-    *   `app.log`: 应用日志。
+* `~/.antigravity-agent/`
+  * `accounts.json`: Local IDE account index.
+  * `cloud_accounts.db`: (new) Cloud account pool database (SQLite).
+  * `backups/`: Backup files.
+  * `app.log`: Application log.