zcf 2.7.1 → 2.8.1

package/README.md

@@ -24,7 +24,9 @@ Menu options include:
 
 - `1` Full initialization (equivalent to `zcf i`)
 - `2` Import workflows (equivalent to `zcf u`)
-- `3-6` Configuration management (API, MCP, Model, AI personality, etc.)
+- `3-7` Configuration management (API/CCR, MCP, Model settings, AI personality, etc.)
+- `R` Claude Code Router management (enhanced in v2.8.1)
+- `U` ccusage - Claude Code usage analysis
 - More features...
 
 ### Or, use direct commands:
@@ -45,9 +47,15 @@ npx zcf u        # Update workflows only: Quick add AI workflows and command sys
 npx zcf → select 2  # Execute workflow update via menu
 ```
 
-#### 🎯 BMad Workflow (New Feature)
+> **Note**:
+>
+> - 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
+
+#### 🎯 BMad Workflow (v2.7 New Feature)
 
-BMad (Business-Minded Agile Development) is an enterprise-grade workflow system that provides:
+[BMad](https://github.com/bmad-code-org/BMAD-METHOD) (BMad-Method: Universal AI Agent Framework) is an enterprise-grade workflow system that provides:
 
 - Complete team of specialized AI agents (PO, PM, Architect, Dev, QA, etc.)
 - Structured development process with quality gates
@@ -56,11 +64,38 @@ BMad (Business-Minded Agile Development) is an enterprise-grade workflow system
 
 After installation, use `/bmad-init` to initialize the BMad workflow in your project.
 
-> **Note**:
->
-> - 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
+#### 🚀 CCR (Claude Code Router) Support (v2.8+ Enhanced)
+
+[CCR](https://github.com/musistudio/claude-code-router/blob/main/README.md) is a powerful proxy router that enables:
+
+- **Free Model Access**: Use free AI models (like Gemini, DeepSeek) through Claude Code interface
+- **Custom Routing**: Route different types of requests to different models based on your rules
+- **Cost Optimization**: Significantly reduce API costs by using appropriate models for different tasks
+- **Easy Management**: Interactive menu for CCR configuration and service control
+- **Auto Updates**: Automatic version checking and updates for CCR and Claude Code (v2.8.1+)
+
+To access CCR features:
+
+```bash
+npx zcf ccr      # Open CCR management menu
+# or
+npx zcf → select R
+```
+
+Check for updates (v2.8.1+):
+
+```bash
+npx zcf check-updates  # Check and update Claude Code and CCR to latest versions
+```
+
+CCR menu options:
+
+- Initialize CCR - Install and configure CCR with preset providers
+- Start UI - Launch CCR web interface for advanced configuration
+- Service Control - Start/stop/restart CCR service
+- Check Status - View current CCR service status
+
+After CCR setup, ZCF automatically configures Claude Code to use CCR as the API proxy.
 
 ### Setup Process
 
@@ -68,7 +103,7 @@ Full initialization (`npx zcf`) will automatically:
 
 - ✅ Detect and install Claude Code
 - ✅ Select AI output language (new feature)
-- ✅ Configure API keys
+- ✅ Configure API keys or CCR proxy
 - ✅ Select and configure MCP services
 - ✅ Set up all necessary configuration files
 
@@ -138,7 +173,7 @@ After configuration:
 ```bash
 $ npx zcf
 
- ZCF - Zero-Config Claude-Code Flow v2.3.0
+ ZCF - Zero-Config Claude-Code Flow
 
 ? Select ZCF display language / 选择ZCF显示语言:
   ❯ 简体中文
@@ -146,18 +181,22 @@ $ npx zcf
 
 Select function:
   -------- Claude Code --------
-  1. Full initialization - Install Claude Code + Import workflow + Configure API + Configure MCP services
+  1. Full initialization - Install Claude Code + Import workflow + Configure API or CCR proxy + Configure MCP services
   2. Import workflow - Import/update workflow-related files only
-  3. Configure API - Configure API URL and authentication
+  3. Configure API - Configure API URL and authentication (supports CCR proxy)
   4. Configure MCP - Configure MCP services (includes Windows fix)
   5. Configure default model - Set default model (opus/sonnet)
   6. Configure Claude global memory - Configure AI output language and personality
   7. Import recommended environment variables and permissions - Import privacy protection environment variables and system permissions
 
+  --------- Other Tools ----------
+  R. CCR Management - Claude Code Router management
+  U. CCUsage - Claude Code usage analysis tool
+
   ------------ ZCF ------------
   0. Select display language / 更改显示语言 - Change ZCF interface language
   -. Clear preference cache - Clear preference language and other caches
-  q. Exit
+  Q. Exit
 
 Enter your choice: _
 ```
@@ -192,6 +231,8 @@ Enter your choice: _
     For tokens obtained via OAuth or browser login
     Use API Key (Key authentication)
     For API keys from Anthropic Console
+    Configure CCR Proxy (Claude Code Router)
+    Use free models and custom routing to reduce costs and explore the possibilities of Claude Code
     Skip (configure manually later)
 
 ? Enter API URL: https://api.anthropic.com
@@ -241,12 +282,13 @@ Enter your choice: _
 
 #### Commands Quick Reference
 
-| 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 |
-| `zcf ccu`    | -       | Run Claude Code usage analysis tool         |
+| 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                                          |
+| `zcf ccu`    | -       | Run Claude Code usage analysis tool - [ccusage](https://github.com/ryoppippi/ccusage) |
+| `zcf ccr`    | -       | Open CCR (Claude Code Router) management menu                                         |
 
 #### Common Options
 
@@ -438,14 +480,28 @@ To protect user data security, the following operations require explicit confirm
 
 ## 🙏 Acknowledgments
 
-Some prompts in this project are inspired by the following excellent works:
+This project is inspired by and incorporates the following open source projects:
 
-- [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)
+- [LINUX DO - The New Ideal Community](https://linux.do)
+- [CCR](https://github.com/musistudio/claude-code-router)
+- [ccusage](https://github.com/ryoppippi/ccusage)
+- [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD)
 
 Thanks to these community contributors for sharing!
 
+## ❤️ Support & Sponsorship
+
+If you find this project helpful, please consider sponsoring its development. Your support is greatly appreciated!
+
+[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/UfoMiao)
+
+<table>
+  <tr>
+    <td><img src="/src/assets/alipay.webp" width="200" alt="Alipay" /></td>
+    <td><img src="/src/assets/wechat.webp" width="200" alt="WeChat Pay" /></td>
+  </tr>
+</table>
+
 ## 📄 License
 
 MIT License

package/bin/zcf.mjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import '../dist/cli.mjs'
+import '../dist/cli.mjs';