zcf 3.1.4 → 3.2.1

package/README.md

@@ -10,7 +10,7 @@
 
 [中文](README_zh-CN.md) | **English** | [日本語](README_ja-JP.md) | [Changelog](CHANGELOG.md)
 
-**✨ Quick Links**: [Codex Support](#-codex-support-v300-new) | [BMad Workflow](#-bmad-workflow-v27-new-feature) | [Spec Workflow](#-spec-workflow-v2124-new-feature) | [Open Web Search](#-open-web-search-v2129-new-feature) | [CCR Router](#-ccr-claude-code-router-support-v28-enhanced) | [CCometixLine](#-ccometixline-support-status-bar-tool-v299-new) | [Output Styles](#-ai-output-styles-v212-new-feature)
+**✨ Quick Links**: [Codex Support](#-codex-support-v300-new) | [BMad Workflow](#-bmad-workflow-v27-new-feature) | [Spec Workflow](#-spec-workflow-v2124-new-feature) | [Open Web Search](#-open-web-search-v2129-new-feature) | [CCR Router](#-ccr-claude-code-router-support-v28-enhanced) | [CCometixLine](#-ccometixline-support-status-bar-tool-v299-new) | [Output Styles](#-ai-output-styles-v212-new-feature) | [Multi-Configuration Management](#-multi-configuration-management-v320-new)
 
 > Zero-config, one-click setup for Claude Code & Codex with bilingual support, intelligent agent system and personalized AI assistant
 
@@ -83,7 +83,7 @@ ZCF supports bilingual operation with automatic language switching for all comma
 # Use Chinese for all operations
 npx zcf --lang zh-CN          # Interactive menu in Chinese
 npx zcf init --lang zh-CN      # Initialize with Chinese interface  
-npx zcf ccr --allLang zh-CN    # Configure CCR in Chinese
+npx zcf ccr --all-lang zh-CN    # Configure CCR in Chinese
 
 # Language parameter priority (highest to lowest):
 # --all-lang > --lang > saved user preference > interactive prompt
@@ -117,12 +117,12 @@ When using `--skip-prompt`, the following parameters are available:
 | `--lang, -l`                 | ZCF display language (applies to all commands)           | `zh-CN`, `en`                                                                                      | No                                     | `en` or user's saved preference                                                                                                  |
 | `--config-lang, -c`          | Configuration language (template files language)         | `zh-CN`, `en`                                                                                      | No                                     | `en`                                                                                                                             |
 | `--ai-output-lang, -a`       | AI output language                                       | `zh-CN`, `en`, custom string                                                                       | No                                     | `en`                                                                                                                             |
-| `--all-lang, -g`             | Set all language parameters (applies to all commands)    | `zh-CN`, `en`, custom string                                                                       | No                                     | - (Priority: allLang > lang > user preference > prompt. Custom string sets AI output language to custom while interaction and config languages remain 'en') |
+| `--all-lang, -g`             | Set all language parameters (applies to all commands)    | `zh-CN`, `en`, custom string                                                                       | No                                     | - (Priority: `--all-lang` > `--lang` > saved user preference > interactive prompt. Custom string sets AI output language to custom while interaction and config languages remain 'en') |
 | `--config-action, -r`        | Config handling                                          | `new`, `backup`, `merge`, `docs-only`, `skip`                                                      | No                                     | `backup`                                                                                                                         |
 | `--api-type, -t`             | API configuration type                                   | `auth_token`, `api_key`, `ccr_proxy`, `skip`                                                       | No                                     | `skip`                                                                                                                           |
 | `--api-key, -k`              | API key (for both API key and auth token types)          | string                                                                                             | Required when `api-type` is not `skip` | -                                                                                                                                |
 | `--api-url, -u`              | Custom API URL                                           | URL string                                                                                         | No                                     | official API                                                                                                                     |
-| `--mcp-services, -m`         | MCP services to install (multi-select, comma-separated)  | `context7`, `open-websearch`, `spec-workflow`, `mcp-deepwiki`, `Playwright`, `exa`, or `skip` for none | No                                     | `all`                                                                                                                            |
+| `--mcp-services, -m`         | MCP services to install (multi-select, comma-separated)  | `context7`, `open-websearch`, `spec-workflow`, `mcp-deepwiki`, `Playwright`, `exa`, `serena`, or `skip` for none | No                                     | `all`                                                                                                                            |
 | `--workflows, -w`            | Workflows to install (multi-select, comma-separated)     | `commonTools`, `sixStepsWorkflow`, `featPlanUx`, `gitWorkflow`, `bmadWorkflow`, or `skip` for none | No                                     | `all`                                                                                                                            |
 | `--output-styles, -o`        | Output styles to install (multi-select, comma-separated) | `engineer-professional`, `nekomata-engineer`, `laowang-engineer`, `ojousama-engineer`, or `skip` for none               | No                                     | `all`                                                                                                                            |
 | `--default-output-style, -d` | Default output style                                     | Same as output styles plus built-in: `default`, `explanatory`, `learning`                          | No                                     | `engineer-professional`                                                                                                          |
@@ -179,6 +179,7 @@ npx zcf → Select 4  # Configure Codex MCP services
 4. **MCP Services**: Full compatibility with existing MCP services including:
    - Context7, Open WebSearch, Spec Workflow
    - DeepWiki, Playwright, EXA search
+   - Serena Assistant for semantic code retrieval and editing
    - Automatic service configuration with API key management
 
 **File Locations:**
@@ -189,18 +190,6 @@ npx zcf → Select 4  # Configure Codex MCP services
 - Workflows: `~/.codex/prompts/`
 - Backups: `~/.codex/backup/`
 
-**Command Line Operations:**
-
-Dedicated command line tool for Codex (v3.0.0+ New):
-
-```bash
-# Codex API provider switching
-npx zcf config-switch     # Interactive provider selection
-npx zcf cs                # Using alias
-npx zcf cs provider-name  # Direct switch to specified provider
-npx zcf cs --list         # List all available providers
-```
-
 **Migration Between Tools:**
 
 ZCF allows seamless switching between Claude Code and Codex while preserving your preferences and workflow configurations. Both tools share the same MCP services and workflow templates for consistent development experience.
@@ -302,8 +291,6 @@ CCR menu options:
 
 After CCR setup, ZCF automatically configures Claude Code to use CCR as the API proxy.
 
-**Important Notice for v2.9.9 Users**: If you previously installed CCometixLine using ZCF v2.9.9, please rerun the installation process to ensure that the CCometixLine configuration is correctly added. Run `npx zcf` -> `Select L` -> `Select 1` to add the CCometixLine configuration.
-
 
 #### 📊 CCometixLine Support (Status Bar Tool) (v2.9.9+ New)
 
@@ -401,6 +388,50 @@ After configuration:
 - AI memory management (v2.0 new)
 - ZCF cache cleanup (v2.0 new)
 
+### 🧩 Multi-Configuration Management (v3.2.0 New)
+
+Unified, incremental, interactive management for both Claude Code and Codex:
+
+- Claude Code: Manage API profiles (add/edit/delete, default profile, duplicate detection)
+- Codex: Manage model providers (list/switch, official login via interactive)
+- Safe backups; prevents deleting the last profile (Claude Code)
+- Applies environment to `~/.claude/settings.json` and restarts CCR when needed
+- Config storage: `~/.ufomiao/zcf/config.toml` (backups `config.backup.YYYY-MM-DD_HH-mm-ss.toml`)
+
+Choose tool type explicitly:
+
+```bash
+# -T accepts: claude-code|codex or short aliases cc|cx
+npx zcf cs --list -T cc    # List Claude Code profiles
+npx zcf cs --list -T cx    # List Codex providers
+npx zcf cs -l -T cc        # Short option for --list
+npx zcf cs -l -T cx        # Short option for --list
+```
+
+Claude Code usage:
+
+```bash
+# Quick switch
+npx zcf cs official -T cc  # Switch to official login
+npx zcf cs ccr -T cc       # Switch to CCR proxy
+npx zcf cs my-profile -T cc
+```
+
+Codex usage:
+
+```bash
+# List and switch providers
+npx zcf cs --list -T cx
+npx zcf cs my-provider -T cx
+
+# Switch to official login (interactive selection)
+npx zcf config-switch -T cx
+```
+
+Notes:
+- ENV mapping (Claude Code): API Key → `ANTHROPIC_API_KEY`, Auth Token → `ANTHROPIC_AUTH_TOKEN`, Base URL → `ANTHROPIC_BASE_URL`.
+- Active code tool type is stored in ZCF config; use `-T cc/cx` only when targeting a different tool than the current one.
+
 ## 📖 Usage Instructions
 
 ### Interactive Menu (v2.0)
@@ -513,6 +544,7 @@ Enter your choice: _
 ◉ DeepWiki - Query GitHub repository docs and examples
 ◉ Playwright Browser Control - Direct browser automation control
 ◉ Exa AI Search - Web search using Exa AI
+◉ Serena Assistant - Semantic code retrieval and editing akin to an IDE
 ◯ Install all services
 
 ✔ MCP services configured
@@ -536,7 +568,7 @@ Enter your choice: _
 | `zcf update`        | `zcf u` | Update workflow-related md files with backup                                          |
 | `zcf ccu`           | -       | Run Claude Code usage analysis tool - [ccusage](https://github.com/ryoppippi/ccusage) |
 | `zcf ccr`           | -       | Open CCR (Claude Code Router) management menu                                         |
-| `zcf config-switch` | `zcf cs` | Codex API provider switching tool - Switch between official login and custom providers |
+| `zcf config-switch` | `zcf cs` | API provider/config switching for Claude Code and Codex (`-T cc` / `-T cx`) |
 | `zcf uninstall`     | -       | Interactive uninstall tool for Claude Code configurations and tools                   |
 | `zcf check-updates` | -       | Check and update Claude Code, CCR and CCometixLine versions                           |