zcf 2.4.1 → 2.5.1

package/README.md

@@ -3,124 +3,126 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Claude Code](https://img.shields.io/badge/Claude-Code-blue)](https://claude.ai/code)
 [![Version](https://img.shields.io/npm/v/zcf)](https://www.npmjs.com/package/zcf)
+[![codecov](https://codecov.io/gh/UfoMiao/zcf/graph/badge.svg?token=HZI6K4Y7D7)](https://codecov.io/gh/UfoMiao/zcf)
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/UfoMiao/zcf)
 
-**中文** | [English](README_EN.md)
+[中文](README_zh.md) | **English**
 
-> 零配置，一键搞定 Claude Code 环境设置 - 支持中英文双语配置、智能代理系统和个性化 AI 助手
+> Zero-config, one-click setup for Claude Code with bilingual support, intelligent agent system and personalized AI assistant
 
-![效果图](./src/assets/screenshot.webp)
+![Rendering](./src/assets/screenshot-en.webp)
 
-## 🚀 快速开始
+## 🚀 Quick Start
 
-### 🎯 推荐：使用交互式菜单（v2.0 新增）
+### 🎯 Recommended: Use Interactive Menu (v2.0 New)
 
 ```bash
-npx zcf          # 打开交互式菜单，根据你的需求选择操作
+npx zcf          # Open interactive menu and choose operations based on your needs
 ```
 
-菜单选项包括：
+Menu options include:
 
-- `1` 完整初始化（等同于 `zcf i`）
-- `2` 导入工作流（等同于 `zcf u`）
-- `3-6` 配置管理（API、MCP、模型、AI 个性等）
-- 更多功能选项...
+- `1` Full initialization (equivalent to `zcf i`)
+- `2` Import workflows (equivalent to `zcf u`)
+- `3-6` Configuration management (API, MCP, Model, AI personality, etc.)
+- More features...
 
-### 或者，直接使用命令：
+### Or, use direct commands:
 
-#### 🆕 首次使用 Claude Code
+#### 🆕 First time using Claude Code
 
 ```bash
-npx zcf i        # 直接执行完整初始化：安装 Claude Code + 导入工作流 + 配置 API + 设置 MCP 服务
-# 或
-npx zcf → 选择 1  # 通过菜单执行完整初始化
+npx zcf i        # Execute full initialization directly: Install Claude Code + Import workflows + Configure API + Set up MCP services
+# or
+npx zcf → select 1  # Execute full initialization via menu
 ```
 
-#### 🔄 已有 Claude Code 环境
+#### 🔄 Already have Claude Code installed
 
 ```bash
-npx zcf u        # 仅更新工作流：快速添加 AI 工作流和命令系统
-# 或
-npx zcf → 选择 2  # 通过菜单执行工作流更新
+npx zcf u        # Update workflows only: Quick add AI workflows and command system
+# or
+npx zcf → select 2  # Execute workflow update via menu
 ```
 
-> **提示**：
+> **Note**:
 >
-> - v2.0 起，`zcf` 默认打开交互式菜单，提供可视化操作界面
-> - 你可以通过菜单选择操作，也可以直接使用命令快捷执行
-> - `zcf i` = 完整初始化，`zcf u` = 仅更新工作流
+> - Since v2.0, `zcf` opens the interactive menu by default, providing a visual operation interface
+> - You can choose operations through the menu or use commands directly for quick execution
+> - `zcf i` = full initialization, `zcf u` = update workflows only
 
-### 初始化流程
+### Setup Process
 
-完整初始化（`npx zcf`）会自动：
+Full initialization (`npx zcf`) will automatically:
 
-- ✅ 检测并安装 Claude Code
-- ✅ 选择 AI 输出语言（新增）
-- ✅ 配置 API 密钥
-- ✅ 选择并配置 MCP 服务
-- ✅ 设置所有必要的配置文件
+- ✅ Detect and install Claude Code
+- ✅ Select AI output language (new feature)
+- ✅ Configure API keys
+- ✅ Select and configure MCP services
+- ✅ Set up all necessary configuration files
 
-### 使用方式
+### Usage
 
-配置完成后：
+After configuration:
 
-- **项目第一次使用强烈建议先运行 `/init` 进行初始化，生成 CLAUDE.md 便于 AI 理解项目架构**
-- `<任务描述>` - 不使用任何工作流直接执行，会遵循 SOLID、KISS、DRY 和 YAGNI 原则，适合修复 Bug 等小任务
-- `/feat <任务描述>` - 开始新功能开发，分为 plan 和 ui 两个阶段
-- `/workflow <任务描述>` - 执行完整开发工作流，不是自动化，开始会给出多套方案，每一步会询问用户意见，可随时修改方案，掌控力 MAX
+- **For first-time project use, strongly recommend running `/init` to generate CLAUDE.md for better AI understanding of project architecture**
+- `<task description>` - Execute directly without workflow, following SOLID, KISS, DRY, and YAGNI principles, suitable for small tasks like bug fixes
+- `/feat <task description>` - Start new feature development, divided into plan and UI phases
+- `/workflow <task description>` - Execute complete development workflow, not automated, starts with multiple solution options, asks for user feedback at each step, allows plan modifications, maximum control
 
 > **PS**:
 >
-> - feat 和 workflow 这两套各有优势，可以都试试比较一下
-> - 生成的文档位置默认都是项目根目录下的 `.claude/xxx.md`，可以把 `.claude/` 加入项目的 `.gitignore` 里
+> - Both feat and workflow have their advantages, try both to compare
+> - Generated documents are located by default at `.claude/xxx.md` in project root, you can add `.claude/` to your project's `.gitignore`
 
-## ✨ ZCF 工具特性
+## ✨ ZCF Tool Features
 
-### 🌏 多语言支持
+### 🌏 Multi-language Support
 
-- 脚本交互语言：控制安装过程的提示语言
-- 配置文件语言：决定安装哪套配置文件（zh-CN/en）
-- AI 输出语言：选择 AI 回复使用的语言（支持简体中文、English 及自定义语言）
-- AI 个性化：支持多种预设人格（专业助手、猫娘助手、友好助手、导师模式）或自定义
+- Script interaction language: Controls installation prompts language
+- Configuration file language: Determines which configuration set to install (zh-CN/en)
+- AI output language: Choose the language for AI responses (supports Chinese, English, and custom languages)
+- AI personality: Support multiple preset personalities (Professional, Catgirl, Friendly, Mentor) or custom
 
-### 🔧 智能安装
+### 🔧 Smart Installation
 
-- 自动检测 Claude Code 安装状态
-- 使用 npm 进行自动安装（确保兼容性）
-- 跨平台支持（Windows/macOS/Linux/Termux）
-- 自动配置 MCP 服务
-- 智能配置合并和部分修改支持（v2.0 新增）
-- 增强的命令检测机制（v2.1 新增）
-- 危险操作确认机制（v2.3 新增）
+- Auto-detects Claude Code installation status
+- Uses npm for automatic installation (ensures compatibility)
+- Cross-platform support (Windows/macOS/Linux/Termux)
+- Automatic MCP service configuration
+- Smart configuration merging and partial modification support (v2.0 new)
+- Enhanced command detection mechanism (v2.1 new)
+- Dangerous operation confirmation mechanism (v2.3 new)
 
-### 📦 完整配置
+### 📦 Complete Configuration
 
-- CLAUDE.md 系统指令
-- settings.json 设置文件
-- commands 自定义命令
-- agents AI 代理配置
+- CLAUDE.md system instructions
+- settings.json configuration file
+- commands custom commands
+- agents AI agent configurations
 
-### 🔐 API 配置
+### 🔐 API Configuration
 
-- 支持两种认证方式：
-  - **Auth Token**：适用于通过 OAuth 或浏览器登录获取的令牌
-  - **API Key**：适用于从 Anthropic Console 获取的 API 密钥
-- 自定义 API URL 支持
-- 支持稍后在 claude 命令中配置
-- 部分修改功能：仅更新需要的配置项（v2.0 新增）
+- Supports two authentication methods:
+  - **Auth Token**: For tokens obtained via OAuth or browser login
+  - **API Key**: For API keys from Anthropic Console
+- Custom API URL support
+- Support for manual configuration later
+- Partial modification: Update only needed configuration items (v2.0 new)
 
-### 💾 配置管理
+### 💾 Configuration Management
 
-- 智能备份现有配置（所有备份保存在 ~/.claude/backup/）
-- 配置合并选项（v2.0 增强：支持深度合并）
-- 安全的覆盖机制
-- MCP 配置修改前自动备份
-- 默认模型配置（v2.0 新增）
-- AI 记忆管理（v2.0 新增）
-- ZCF 缓存清理（v2.0 新增）
+- Smart backup of existing configurations (all backups saved in ~/.claude/backup/)
+- Configuration merge option (v2.0 enhanced: supports deep merge)
+- Safe overwrite mechanism
+- Automatic backup before MCP configuration changes
+- Default model configuration (v2.0 new)
+- AI memory management (v2.0 new)
+- ZCF cache cleanup (v2.0 new)
 
-## 📖 使用说明
+## 📖 Usage Instructions
 
-### 交互式菜单（v2.0）
+### Interactive Menu (v2.0)
 
 ```bash
 $ npx zcf
@@ -131,283 +133,283 @@ $ npx zcf
   ❯ 简体中文
     English
 
-请选择功能:
+Select function:
   -------- Claude Code --------
-  1. 完整初始化配置 - 安装并配置所有内容
-  2. 导入工作流 - 更新 AI 工作流和命令
-  3. 配置 API - 管理 API 认证
-  4. 配置 MCP 服务 - 管理 MCP 集成
-  5. 配置默认模型 - 设置默认 AI 模型
-  6. 配置 AI 个性 - 设置 AI 助手人格
-  7. 配置 AI 记忆 - 管理 AI 记忆设置
+  1. Full initialization - Install and configure everything
+  2. Import workflows - Update AI workflows and commands
+  3. Configure API - Manage API authentication
+  4. Configure MCP services - Manage MCP integrations
+  5. Configure default model - Set default AI model
+  6. Configure AI personality - Set AI assistant personality
+  7. Configure AI memory - Set up AI memory management
 
   ------------ ZCF ------------
-  0. 更改语言 - 切换界面语言
-  -. 清理缓存 - 清理 ZCF 缓存文件
-  q. 退出
+  0. Change language - Switch interface language
+  -. Clear cache - Clear ZCF cache files
+  q. Exit
 
-请输入选择: _
+Enter your choice: _
 ```
 
-### 完整初始化流程（选择 1 或使用 `zcf i`）
+### Full Initialization Flow (Select 1 or use `zcf i`)
 
 ```bash
-? 选择 Claude Code 配置语言:
-  ❯ 简体中文 (zh-CN) - 中文版（便于中文用户自定义）
-    English (en) - 英文版（推荐，token 消耗更低）
+? Select Claude Code configuration language:
+  ❯ 简体中文 (zh-CN) - Chinese (easier for Chinese users to customize)
+    English (en) - English (recommended, lower token consumption)
 
-? 选择 AI 输出语言:
-  AI 将使用此语言回复你的问题
+? Select AI output language:
+  AI will respond to you in this language
   ❯ 简体中文
     English
     Custom
-    （支持日语、法语、德语等多种语言）
+    (Supports Japanese, French, German, and more)
 
-? 选择 AI 个性化设置:
-  ❯ 专业助手(默认)
-    猫娘助手
-    友好助手
-    导师模式
-    自定义
+? Select AI personality:
+  ❯ Professional Assistant(Default)
+    Catgirl Assistant
+    Friendly Assistant
+    Mentor Mode
+    Custom
 
-? 检测到 Claude Code 未安装，是否自动安装？(Y/n)
+? Claude Code not found. Install automatically? (Y/n)
 
-✔ Claude Code 安装成功
+✔ Claude Code installed successfully
 
-? 选择 API 认证方式
-  ❯ 使用 Auth Token (OAuth 认证)
-    适用于通过 OAuth 或浏览器登录获取的令牌
-    使用 API Key (密钥认证)
-    适用于从 Anthropic Console 获取的 API 密钥
-    跳过（稍后手动配置）
+? Select API authentication method
+  ❯ Use Auth Token (OAuth authentication)
+    For tokens obtained via OAuth or browser login
+    Use API Key (Key authentication)
+    For API keys from Anthropic Console
+    Skip (configure manually later)
 
-? 请输入 API URL: https://api.anthropic.com
-? 请输入 Auth Token 或 API Key: xxx
+? Enter API URL: https://api.anthropic.com
+? Enter Auth Token or API Key: xxx
 
-? 检测到已有配置文件，如何处理？
-  ❯ 备份并覆盖全部
-    仅更新工作流相关md并备份旧配置
-    合并配置
-    跳过
+? Existing config detected. How to proceed?
+  ❯ Backup and overwrite all
+    Update workflow-related md files only with backup
+    Merge config
+    Skip
 
-✔ 已备份所有配置文件到 ~/.claude/backup/xxx
-✔ 配置文件已复制到 ~/.claude
-✔ API 配置完成
+✔ All config files backed up to ~/.claude/backup/xxx
+✔ Config files copied to ~/.claude
+✔ API configured
 
-? 是否配置 MCP 服务？(Y/n)
+? Configure MCP services? (Y/n)
 
-? 选择要安装的 MCP 服务（空格选择，回车确认）
-  ❯ ◯ 全部安装
-    ◯ Context7 文档查询 - 查询最新的库文档和代码示例
-    ◯ DeepWiki - 查询 GitHub 仓库文档和示例
-    ◯ Playwright 浏览器控制 - 直接控制浏览器进行自动化操作
-    ◯ Exa AI 搜索 - 使用 Exa AI 进行网页搜索
+? Select MCP services to install (space to select, enter to confirm)
+  ❯ ◯ Install all
+    ◯ Context7 Documentation Query - Query latest library docs and code examples
+    ◯ DeepWiki - Query GitHub repository docs and examples
+    ◯ Playwright Browser Control - Direct browser automation control
+    ◯ Exa AI Search - Web search using Exa AI
 
-? 请输入 Exa API Key（可从 https://dashboard.exa.ai/api-keys 获取）
+? Enter Exa API Key (get from https://dashboard.exa.ai/api-keys)
 
-✔ MCP 服务已配置
+✔ MCP services configured
 
-🎉 配置完成！使用 'claude' 命令开始体验。
+🎉 Setup complete! Use 'claude' command to start.
 ```
 
-### 命令行参数
+### Command Line Options
 
-#### 命令速查表
+#### Commands Quick Reference
 
-| 命令         | 缩写    | 说明                            |
-| ------------ | ------- | ------------------------------- |
-| `zcf`        | -       | 显示交互式菜单（v2.0 默认命令） |
-| `zcf init`   | `zcf i` | 初始化 Claude Code 配置         |
-| `zcf update` | `zcf u` | 更新 Prompt 文档并备份旧配置    |
+| Command      | Alias   | Description                                  |
+| ------------ | ------- | -------------------------------------------- |
+| `zcf`        | -       | Show interactive menu (v2.0 default command) |
+| `zcf init`   | `zcf i` | Initialize Claude Code configuration         |
+| `zcf update` | `zcf u` | Update workflow-related md files with backup |
 
-#### 常用选项
+#### Common Options
 
 ```bash
-# 指定配置语言
+# Specify configuration language
 npx zcf --config-lang zh-CN
-npx zcf -c zh-CN            # 使用缩写
+npx zcf -c zh-CN            # Using short option
 
-# 强制覆盖现有配置
+# Force overwrite existing configuration
 npx zcf --force
-npx zcf -f                 # 使用缩写
+npx zcf -f                 # Using short option
 
-# 更新 Prompt 文档并备份旧配置（保留 API 和 MCP 配置）
-npx zcf u                  # 使用 update 命令
-npx zcf update             # 完整命令
+# Update workflow-related md files with backup (preserve API and MCP configs)
+npx zcf u                  # Using update command
+npx zcf update             # Full command
 
-# 查看帮助信息
+# Show help information
 npx zcf --help
 npx zcf -h
 
-# 查看版本
+# Show version
 npx zcf --version
 npx zcf -v
 ```
 
-#### 使用示例
+#### Usage Examples
 
 ```bash
-# 显示交互式菜单（默认）
+# Show interactive menu (default)
 npx zcf
 
-# 首次安装，完整初始化
+# First-time installation, complete initialization
 npx zcf i
-npx zcf init              # 完整命令
+npx zcf init              # Full command
 
-# 更新 Prompt 文档并备份旧配置，保留 API 和 MCP 配置
+# Update workflow-related md files with backup, keep API and MCP configs
 npx zcf u
-npx zcf update            # 完整命令
+npx zcf update            # Full command
 
-# 强制使用中文配置重新初始化
+# Force reinitialize with Chinese config
 npx zcf i --config-lang zh-CN --force
-npx zcf i -c zh-CN -f      # 使用缩写
+npx zcf i -c zh-CN -f      # Using short options
 
-# 更新到英文版 Prompt（降低 token 消耗）
+# Update to English prompts (lower token consumption)
 npx zcf u --config-lang en
-npx zcf u -c en            # 使用缩写
+npx zcf u -c en            # Using short option
 ```
 
-## 📁 项目结构
+## 📁 Project Structure
 
 ```
-claude-code-config/
-├── README.md              # 说明文档
-├── package.json           # npm 包配置
+zcf/
+├── README.md              # Documentation
+├── package.json           # npm package configuration
 ├── bin/
-│   └── zcf.mjs           # CLI 入口
-├── src/                  # 源代码
-│   ├── cli.ts           # CLI 主逻辑
-│   ├── commands/        # 命令实现
-│   ├── utils/           # 工具函数
-│   └── constants.ts     # 常量定义
-├── templates/            # 配置模板
-│   ├── CLAUDE.md        # 项目级配置（v2.0新增）
-│   ├── settings.json    # 基础配置（含隐私保护环境变量）
-│   ├── en/              # 英文版
-│   │   ├── rules.md     # 核心原则（原CLAUDE.md）
-│   │   ├── personality.md # AI个性化（v2.0新增）
-│   │   ├── mcp.md       # MCP服务说明（v2.0新增）
-│   │   ├── agents/      # AI 代理
-│   │   └── commands/    # 命令定义
-│   └── zh-CN/           # 中文版
-│       └── ... (相同结构)
-└── dist/                # 构建输出
+│   └── zcf.mjs           # CLI entry point
+├── src/                  # Source code
+│   ├── cli.ts           # CLI main logic
+│   ├── commands/        # Command implementations
+│   ├── utils/           # Utility functions
+│   └── constants.ts     # Constant definitions
+├── templates/            # Configuration templates
+│   ├── CLAUDE.md        # Project level config (v2.0 new)
+│   ├── settings.json    # Base configuration (with privacy env vars)
+│   ├── en/              # English version
+│   │   ├── rules.md     # Core principles (formerly CLAUDE.md)
+│   │   ├── personality.md # AI personality (v2.0 new)
+│   │   ├── mcp.md       # MCP services guide (v2.0 new)
+│   │   ├── agents/      # AI agents
+│   │   └── commands/    # Command definitions
+│   └── zh-CN/           # Chinese version
+│       └── ... (same structure)
+└── dist/                # Build output
 ```
 
-## ✨ 核心特性（v2.0 增强）
+## ✨ Core Features (v2.0 Enhanced)
 
-### 🤖 专业代理
+### 🤖 Professional Agents
 
-- **任务规划师**：将复杂任务拆解为可执行步骤
-- **UI/UX 设计师**：提供专业界面设计指导
-- **AI 个性化**：支持多种预设人格和自定义（v2.0 新增）
+- **Task Planner**: Breaks down complex tasks into executable steps
+- **UI/UX Designer**: Provides professional interface design guidance
+- **AI Personality**: Support multiple preset personalities and custom (v2.0 new)
 
-### ⚡ 命令系统
+### ⚡ Command System
 
-- **功能开发** (`/feat`)：结构化新功能开发
-- **工作流** (`/workflow`)：完整的六阶段开发流程
+- **Feature Development** (`/feat`): Structured new feature development
+- **Workflow** (`/workflow`): Complete six-phase development workflow
 
-### 🔧 智能配置
+### 🔧 Smart Configuration
 
-- API 密钥管理（支持部分修改）
-- 细粒度权限控制
-- 多种 Claude 模型支持（可配置默认模型）
-- 交互式菜单系统（v2.0 新增）
-- AI 记忆管理（v2.0 新增）
+- API key management (supports partial modification)
+- Fine-grained permission control
+- Multiple Claude model support (configurable default model)
+- Interactive menu system (v2.0 new)
+- AI memory management (v2.0 new)
 
-## 🎯 开发工作流
+## 🎯 Development Workflow
 
-### 六阶段工作流
+### Six-Phase Workflow
 
-1. [模式：研究] - 理解需求
-2. [模式：构思] - 设计方案
-3. [模式：计划] - 制定详细计划
-4. [模式：执行] - 实施开发
-5. [模式：优化] - 提升质量
-6. [模式：评审] - 最终评估
+1. [Mode: Research] - Understand requirements
+2. [Mode: Ideate] - Design solutions
+3. [Mode: Plan] - Create detailed plan
+4. [Mode: Execute] - Implement development
+5. [Mode: Optimize] - Improve quality
+6. [Mode: Review] - Final assessment
 
-## 🛠️ 开发
+## 🛠️ Development
 
 ```bash
-# 克隆项目
+# Clone the project
 git clone https://github.com/UfoMiao/zcf.git
 cd zcf
 
-# 安装依赖（使用 pnpm）
+# Install dependencies (using pnpm)
 pnpm install
 
-# 构建项目
+# Build project
 pnpm build
 
-# 本地测试
+# Local testing
 node bin/zcf.mjs
 ```
 
-## 💡 最佳实践
+## 💡 Best Practices
 
-1. **任务分解**：保持任务独立可测试
-2. **代码质量**：遵循 SOLID、KISS、DRY 和 YAGNI 原则
-3. **文档管理**：计划存储在项目根目录的`.claude/plan/` 目录下
+1. **Task Breakdown**: Keep tasks independent and testable
+2. **Code Quality**: Follow SOLID, KISS, DRY, and YAGNI principles
+3. **Documentation Management**: The plan will be stored in the `.claude/plan/` directory at the project root
 
-## 🔧 故障排除
+## 🔧 Troubleshooting
 
-如果遇到问题，可以：
+If you encounter issues:
 
-1. 重新运行 `npx zcf` 重新配置
-2. 检查 `~/.claude/` 目录下的配置文件
-3. 确保 Claude Code 已正确安装
-4. 如果路径包含空格，ZCF 会自动处理引号包裹
-5. 优先使用 ripgrep (`rg`) 进行文件搜索以获得更好性能
+1. Re-run `npx zcf` to reconfigure
+2. Check configuration files in `~/.claude/` directory
+3. Ensure Claude Code is properly installed
+4. If paths contain spaces, ZCF will automatically handle quote wrapping
+5. Use ripgrep (`rg`) preferentially for file searching for better performance
 
-### 跨平台支持
+### Cross-Platform Support
 
-#### Windows 平台
+#### Windows Platform
 
-ZCF 已完全支持 Windows 平台：
+ZCF fully supports Windows platform:
 
-- **自动检测**：在 Windows 系统上会自动使用兼容的 `cmd /c npx` 格式
-- **配置修复**：现有的错误配置会在更新时自动修复
-- **零配置**：Windows 用户无需任何额外操作，与 macOS/Linux 体验一致
+- **Auto-detection**: Automatically uses compatible `cmd /c npx` format on Windows systems
+- **Config repair**: Existing incorrect configurations are automatically fixed during updates
+- **Zero-config**: Windows users don't need any extra steps, same experience as macOS/Linux
 
-如果在 Windows 上遇到 MCP 连接问题，运行 `npx zcf` 会自动修复配置格式。
+If you encounter MCP connection issues on Windows, running `npx zcf` will automatically fix the configuration format.
 
-#### Termux 支持（v2.1 新增）
+#### Termux Support (v2.1 new)
 
-ZCF 现已支持在 Android Termux 环境中运行：
+ZCF now supports running in Android Termux environment:
 
-- **自动适配**：自动检测 Termux 环境并使用兼容配置
-- **增强检测**：智能识别可用命令，确保在受限环境中正常工作
-- **完整功能**：在 Termux 中享受与桌面系统相同的完整功能
+- **Auto-adaptation**: Automatically detects Termux environment and uses compatible configuration
+- **Enhanced detection**: Intelligently identifies available commands, ensuring normal operation in restricted environments
+- **Full functionality**: Enjoy the same complete features in Termux as on desktop systems
 
-### 安全特性（v2.3 新增）
+### Security Features (v2.3 new)
 
-#### 危险操作确认机制
+#### Dangerous Operation Confirmation Mechanism
 
-为保护用户数据安全，以下操作需要明确确认：
+To protect user data security, the following operations require explicit confirmation:
 
-- **文件系统**：删除文件/目录、批量修改、移动系统文件
-- **代码提交**：`git commit`、`git push`、`git reset --hard`
-- **系统配置**：修改环境变量、系统设置、权限变更
-- **数据操作**：数据库删除、模式更改、批量更新
-- **网络请求**：发送敏感数据、调用生产环境 API
-- **包管理**：全局安装/卸载、更新核心依赖
+- **File System**: Delete files/directories, bulk modifications, move system files
+- **Code Commits**: `git commit`, `git push`, `git reset --hard`
+- **System Config**: Modify environment variables, system settings, permissions
+- **Data Operations**: Database deletions, schema changes, bulk updates
+- **Network Requests**: Send sensitive data, call production APIs
+- **Package Management**: Global install/uninstall, update core dependencies
 
-## 🙏 鸣谢
+## 🙏 Acknowledgments
 
-本项目的部分 Prompt 参考了以下优秀作品：
+Some prompts in this project are inspired by the following excellent works:
 
-- [Linux.do - 分享一个让 AI 只生成必要的代码的通用 Prompt，欢迎一起调优~](https://linux.do/t/topic/830802)
-- [Linux.do - claude code 降智不怕，使用 agent 与 command 结合将任务做详细的拆分大概可以帮助到你](https://linux.do/t/topic/815230)
-- [Linux.do - cursor 快速开发规则](https://linux.do/t/topic/697566)
+- [Linux.do - Share a universal Prompt for AI to generate only necessary code, welcome to optimize together~](https://linux.do/t/topic/830802)
+- [Linux.do - Don't worry about claude code degradation, using agent and command combination to break down tasks in detail may help you](https://linux.do/t/topic/815230)
+- [Linux.do - cursor rapid development rules](https://linux.do/t/topic/697566)
 
-感谢这些社区贡献者的分享！
+Thanks to these community contributors for sharing!
 
-## 📄 许可证
+## 📄 License
 
-MIT 许可证
+MIT License
 
 ---
 
-如果这个项目对你有帮助，请给我一个 ⭐️ Star！
+If this project helps you, please give me a ⭐️ Star!
 
-[![Star History Chart](https://api.star-history.com/svg?repos=UfoMiao/claude-code-config&type=Date)](https://star-history.com/#UfoMiao/claude-code-config&Date)
+[![Star History Chart](https://api.star-history.com/svg?repos=UfoMiao/zcf&type=Date)](https://star-history.com/#UfoMiao/zcf&Date)

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import ansis from 'ansis';
 import cac from 'cac';
-import { h as SUPPORTED_LANGS, I as I18N, L as LANG_LABELS, G as updateZcfConfig, Z as ZCF_CONFIG_FILE, o as openSettingsJson, b as importRecommendedPermissions, a as importRecommendedEnv, H as readZcfConfig, J as resolveAiOutputLanguage, v as applyAiLanguageDirective, K as configureAiPersonality, u as updateDefaultModel, N as isWindows, x as readMcpConfig, E as fixWindowsMcpConfig, y as writeMcpConfig, O as selectMcpServices, z as backupMcpConfig, M as MCP_SERVICES, D as buildMcpServerConfig, B as mergeMcpServers, t as getExistingApiConfig, P as formatApiKeyDisplay, Q as modifyApiConfigPartially, R as validateApiKey, q as configureApi, T as displayBanner, U as selectScriptLanguage, S as SETTINGS_FILE, V as updatePromptOnly, W as version, X as handleExitPromptError, Y as handleGeneralError, _ as displayBannerWithInfo, i as init } from './shared/zcf.CYdvtE_u.mjs';
+import ansis from 'ansis';
+import { h as SUPPORTED_LANGS, I as I18N, L as LANG_LABELS, G as updateZcfConfig, Z as ZCF_CONFIG_FILE, o as openSettingsJson, b as importRecommendedPermissions, a as importRecommendedEnv, H as readZcfConfig, J as resolveAiOutputLanguage, v as applyAiLanguageDirective, K as configureAiPersonality, u as updateDefaultModel, N as isWindows, x as readMcpConfig, E as fixWindowsMcpConfig, y as writeMcpConfig, O as selectMcpServices, z as backupMcpConfig, M as MCP_SERVICES, D as buildMcpServerConfig, B as mergeMcpServers, t as getExistingApiConfig, P as formatApiKeyDisplay, Q as modifyApiConfigPartially, R as validateApiKey, q as configureApi, T as displayBanner, U as selectScriptLanguage, S as SETTINGS_FILE, V as updatePromptOnly, W as version, X as handleExitPromptError, Y as handleGeneralError, _ as displayBannerWithInfo, i as init } from './shared/zcf.DnmrEWlk.mjs';
 import inquirer from 'inquirer';
 import { existsSync, unlinkSync } from 'node:fs';
 import 'pathe';
@@ -149,7 +149,7 @@ async function configureMcpFeature(scriptLang) {
           validate: (value) => !!value || i18n.keyRequired
         });
         if (apiKey) {
-          config = buildMcpServerConfig(service.config, apiKey, service.apiKeyPlaceholder);
+          config = buildMcpServerConfig(service.config, apiKey, service.apiKeyPlaceholder, service.apiKeyEnvVar);
         } else {
           continue;
         }
@@ -470,8 +470,20 @@ async function showMainMenu() {
   }
 }
 
-const cli = cac("zcf");
-cli.command("[lang]", "Show interactive menu (default)").option("--init", "Run full initialization directly").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--force, -f", "Force overwrite existing configuration").action(async (lang, options) => {
+function setupCommands(cli) {
+  cli.command("[lang]", "Show interactive menu (default)").option("--init", "Run full initialization directly").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--force, -f", "Force overwrite existing configuration").action(async (lang, options) => {
+    await handleDefaultCommand(lang, options);
+  });
+  cli.command("init", "Initialize Claude Code configuration").alias("i").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--ai-output-lang, -a <lang>", "AI output language").option("--force, -f", "Force overwrite existing configuration").action(async (options) => {
+    await handleInitCommand(options);
+  });
+  cli.command("update", "Update Claude Code prompts only").alias("u").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").action(async (options) => {
+    await handleUpdateCommand(options);
+  });
+  cli.help((sections) => customizeHelp(sections));
+  cli.version(version);
+}
+async function handleDefaultCommand(lang, options) {
   if (options.init) {
     await init({
       lang: lang || options.lang,
@@ -481,19 +493,19 @@ cli.command("[lang]", "Show interactive menu (default)").option("--init", "Run f
   } else {
     await showMainMenu();
   }
-});
-cli.command("init", "Initialize Claude Code configuration").alias("i").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--ai-output-lang, -a <lang>", "AI output language").option("--force, -f", "Force overwrite existing configuration").action(async (options) => {
+}
+async function handleInitCommand(options) {
   await init({
     lang: options.lang,
     configLang: options.configLang,
     aiOutputLang: options.aiOutputLang,
     force: options.force
   });
-});
-cli.command("update", "Update Claude Code prompts only").alias("u").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").action(async (options) => {
+}
+async function handleUpdateCommand(options) {
   await update({ configLang: options.configLang });
-});
-cli.help((sections) => {
+}
+function customizeHelp(sections) {
   sections.unshift({
     title: "",
     body: ansis.cyan.bold(`ZCF - Zero-Config Claude-Code Flow v${version}`)
@@ -542,6 +554,8 @@ cli.help((sections) => {
     ].join("\n")
   });
   return sections;
-});
-cli.version(version);
+}
+
+const cli = cac("zcf");
+setupCommands(cli);
 cli.parse();

package/dist/index.d.mts

@@ -14,6 +14,7 @@ interface McpService {
         'zh-CN': string;
     };
     apiKeyPlaceholder?: string;
+    apiKeyEnvVar?: string;
     config: McpServerConfig;
 }
 interface McpServerConfig {
@@ -446,7 +447,7 @@ declare function readMcpConfig(): ClaudeConfiguration | null;
 declare function writeMcpConfig(config: ClaudeConfiguration): void;
 declare function backupMcpConfig(): string | null;
 declare function mergeMcpServers(existing: ClaudeConfiguration | null, newServers: Record<string, McpServerConfig>): ClaudeConfiguration;
-declare function buildMcpServerConfig(baseConfig: McpServerConfig, apiKey?: string, placeholder?: string): McpServerConfig;
+declare function buildMcpServerConfig(baseConfig: McpServerConfig, apiKey?: string, placeholder?: string, envVarName?: string): McpServerConfig;
 declare function fixWindowsMcpConfig(config: ClaudeConfiguration): ClaudeConfiguration;
 declare function addCompletedOnboarding(): void;
 

package/dist/index.d.ts

@@ -14,6 +14,7 @@ interface McpService {
         'zh-CN': string;
     };
     apiKeyPlaceholder?: string;
+    apiKeyEnvVar?: string;
     config: McpServerConfig;
 }
 interface McpServerConfig {
@@ -446,7 +447,7 @@ declare function readMcpConfig(): ClaudeConfiguration | null;
 declare function writeMcpConfig(config: ClaudeConfiguration): void;
 declare function backupMcpConfig(): string | null;
 declare function mergeMcpServers(existing: ClaudeConfiguration | null, newServers: Record<string, McpServerConfig>): ClaudeConfiguration;
-declare function buildMcpServerConfig(baseConfig: McpServerConfig, apiKey?: string, placeholder?: string): McpServerConfig;
+declare function buildMcpServerConfig(baseConfig: McpServerConfig, apiKey?: string, placeholder?: string, envVarName?: string): McpServerConfig;
 declare function fixWindowsMcpConfig(config: ClaudeConfiguration): ClaudeConfiguration;
 declare function addCompletedOnboarding(): void;
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, L as LANG_LABELS, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, F as addCompletedOnboarding, v as applyAiLanguageDirective, n as backupExistingConfig, z as backupMcpConfig, D as buildMcpServerConfig, d as cleanupPermissions, c as commandExists, q as configureApi, p as copyConfigFiles, l as ensureClaudeDir, E as fixWindowsMcpConfig, t as getExistingApiConfig, w as getMcpConfigPath, g as getPlatform, a as importRecommendedEnv, b as importRecommendedPermissions, i as init, k as installClaudeCode, j as isClaudeCodeInstalled, m as mergeAndCleanPermissions, r as mergeConfigs, B as mergeMcpServers, s as mergeSettingsFile, o as openSettingsJson, x as readMcpConfig, u as updateDefaultModel, y as writeMcpConfig } from './shared/zcf.CYdvtE_u.mjs';
+export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, L as LANG_LABELS, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, F as addCompletedOnboarding, v as applyAiLanguageDirective, n as backupExistingConfig, z as backupMcpConfig, D as buildMcpServerConfig, d as cleanupPermissions, c as commandExists, q as configureApi, p as copyConfigFiles, l as ensureClaudeDir, E as fixWindowsMcpConfig, t as getExistingApiConfig, w as getMcpConfigPath, g as getPlatform, a as importRecommendedEnv, b as importRecommendedPermissions, i as init, k as installClaudeCode, j as isClaudeCodeInstalled, m as mergeAndCleanPermissions, r as mergeConfigs, B as mergeMcpServers, s as mergeSettingsFile, o as openSettingsJson, x as readMcpConfig, u as updateDefaultModel, y as writeMcpConfig } from './shared/zcf.DnmrEWlk.mjs';
 import 'inquirer';
 import 'ansis';
 import 'node:fs';

package/dist/shared/{zcf.CYdvtE_u.mjs → zcf.DnmrEWlk.mjs}

@@ -7,7 +7,7 @@ import { fileURLToPath } from 'node:url';
 import { exec } from 'tinyexec';
 import { homedir, platform } from 'node:os';
 
-const version = "2.4.1";
+const version = "2.5.1";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const CLAUDE_DIR = join(homedir(), ".claude");
@@ -465,12 +465,14 @@ const MCP_SERVICES = [
       "zh-CN": "\u8BF7\u8F93\u5165 Exa API Key",
       en: "Enter Exa API Key"
     },
-    apiKeyPlaceholder: "YOUR_EXA_API_KEY",
+    apiKeyEnvVar: "EXA_API_KEY",
     config: {
       type: "stdio",
       command: "npx",
-      args: ["-y", "mcp-remote", "https://mcp.exa.ai/mcp?exaApiKey=YOUR_EXA_API_KEY"],
-      env: {}
+      args: ["-y", "exa-mcp-server"],
+      env: {
+        EXA_API_KEY: "YOUR_EXA_API_KEY"
+      }
     }
   }
 ];
@@ -1391,12 +1393,16 @@ function applyPlatformCommand(config) {
     config.args = [...mcpCmd.slice(1), ...config.args || []];
   }
 }
-function buildMcpServerConfig(baseConfig, apiKey, placeholder = "YOUR_EXA_API_KEY") {
+function buildMcpServerConfig(baseConfig, apiKey, placeholder = "YOUR_EXA_API_KEY", envVarName) {
   const config = deepClone(baseConfig);
   applyPlatformCommand(config);
   if (!apiKey) {
     return config;
   }
+  if (envVarName && config.env) {
+    config.env[envVarName] = apiKey;
+    return config;
+  }
   if (config.args) {
     config.args = config.args.map((arg) => arg.replace(placeholder, apiKey));
   }
@@ -1742,7 +1748,7 @@ async function init(options = {}) {
                 continue;
               }
               if (apiKey) {
-                config = buildMcpServerConfig(service.config, apiKey, service.apiKeyPlaceholder);
+                config = buildMcpServerConfig(service.config, apiKey, service.apiKeyPlaceholder, service.apiKeyEnvVar);
               } else {
                 continue;
               }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.4.1",
+  "version": "2.5.1",
   "description": "Zero-Config Claude-Code Flow - One-click configuration tool for Claude Code",
   "license": "MIT",
   "homepage": "https://github.com/UfoMiao/zcf",
@@ -33,9 +33,12 @@
     "@changesets/cli": "^2.29.5",
     "@types/inquirer": "^9.0.8",
     "@types/node": "^22.17.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/ui": "^3.2.4",
     "tsx": "^4.20.3",
     "typescript": "^5.9.2",
-    "unbuild": "^3.6.0"
+    "unbuild": "^3.6.0",
+    "vitest": "^3.2.4"
   },
   "keywords": [
     "claude",
@@ -54,7 +57,11 @@
     "dev": "tsx ./src/cli.ts",
     "build": "unbuild",
     "typecheck": "tsc",
-    "test": "npm run build && node bin/zcf.mjs",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage",
+    "test:run": "vitest run",
+    "test:watch": "vitest watch",
     "changeset": "changeset",
     "version": "changeset version",
     "release": "pnpm build && changeset publish"