zcf 1.2.0 → 2.0.1

package/README.md

@@ -2,30 +2,50 @@
 
 [![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)
 
 **中文** | [English](README_EN.md)
 
-> 零配置，一键搞定 Claude Code 环境设置 - 支持中英文双语配置和智能代理系统
+> 零配置，一键搞定 Claude Code 环境设置 - 支持中英文双语配置、智能代理系统和个性化AI助手
 
 ![效果图](./src/assets/screenshot.webp)
 
 ## 🚀 快速开始
 
-### 根据你的情况选择：
+### 🎯 推荐：使用交互式菜单（v2.0新增）
+
+```bash
+npx zcf          # 打开交互式菜单，根据你的需求选择操作
+```
+
+菜单选项包括：
+- `1` 完整初始化（等同于 `zcf i`）
+- `2` 导入工作流（等同于 `zcf u`）
+- `3-6` 配置管理（API、MCP、模型、AI个性等）
+- 更多功能选项...
+
+### 或者，直接使用命令：
 
 #### 🆕 首次使用 Claude Code
 
 ```bash
-npx zcf          # 完整初始化：安装 Claude Code + 导入工作流 + 配置 API + 设置 MCP 服务
+npx zcf i        # 直接执行完整初始化：安装 Claude Code + 导入工作流 + 配置 API + 设置 MCP 服务
+# 或
+npx zcf → 选择 1  # 通过菜单执行完整初始化
 ```
 
 #### 🔄 已有 Claude Code 环境
 
 ```bash
-npx zcf u        # 仅导入工作流：快速添加 AI 工作流和命令系统
+npx zcf u        # 仅更新工作流：快速添加 AI 工作流和命令系统
+# 或
+npx zcf → 选择 2  # 通过菜单执行工作流更新
 ```
 
-> **提示**：`zcf u` 是 `zcf update` 的缩写，专为已配置用户设计，只更新工作流相关文件，保留你的 API 和 MCP 配置。
+> **提示**：
+> - v2.0 起，`zcf` 默认打开交互式菜单，提供可视化操作界面
+> - 你可以通过菜单选择操作，也可以直接使用命令快捷执行
+> - `zcf i` = 完整初始化，`zcf u` = 仅更新工作流
 
 ### 初始化流程
 
@@ -58,13 +78,15 @@ npx zcf u        # 仅导入工作流：快速添加 AI 工作流和命令系统
 - 脚本交互语言：控制安装过程的提示语言
 - 配置文件语言：决定安装哪套配置文件（zh-CN/en）
 - AI 输出语言：选择 AI 回复使用的语言（支持简体中文、English 及自定义语言）
+- AI 个性化：支持多种预设人格（专业助手、猫娘助手、友好助手、导师模式）或自定义
 
 ### 🔧 智能安装
 
 - 自动检测 Claude Code 安装状态
 - 使用 npm 进行自动安装（确保兼容性）
 - 跨平台支持（Windows/macOS/Linux）
-- 自动配置 MCP 服务（新增）
+- 自动配置 MCP 服务
+- 智能配置合并和部分修改支持（v2.0新增）
 
 ### 📦 完整配置
 
@@ -80,25 +102,51 @@ npx zcf u        # 仅导入工作流：快速添加 AI 工作流和命令系统
   - **API Key**：适用于从 Anthropic Console 获取的 API 密钥
 - 自定义 API URL 支持
 - 支持稍后在 claude 命令中配置
+- 部分修改功能：仅更新需要的配置项（v2.0新增）
 
 ### 💾 配置管理
 
 - 智能备份现有配置（所有备份保存在 ~/.claude/backup/）
-- 配置合并选项
+- 配置合并选项（v2.0增强：支持深度合并）
 - 安全的覆盖机制
 - MCP 配置修改前自动备份
+- 默认模型配置（v2.0新增）
+- AI 记忆管理（v2.0新增）
+- ZCF 缓存清理（v2.0新增）
 
 ## 📖 使用说明
 
-### 交互式配置流程
+### 交互式菜单（v2.0）
 
 ```bash
 $ npx zcf
 
-? Select script language / 选择脚本语言:
+ ZCF - Zero-Config Claude-Code Flow v2.0.0
+
+? Select ZCF display language / 选择ZCF显示语言:
   ❯ 简体中文
     English
 
+请选择功能:
+  -------- Claude Code --------
+  1. 完整初始化配置 - 安装并配置所有内容
+  2. 导入工作流 - 更新 AI 工作流和命令
+  3. 配置 API - 管理 API 认证
+  4. 配置 MCP 服务 - 管理 MCP 集成
+  5. 配置默认模型 - 设置默认 AI 模型
+  6. 配置 AI 个性 - 设置 AI 助手人格
+  
+  ------------ ZCF ------------
+  0. 更改语言 - 切换界面语言
+  -. 清理缓存 - 清理 ZCF 缓存文件
+  q. 退出
+
+请输入选择: _
+```
+
+### 完整初始化流程（选择1或使用 `zcf i`）
+
+```bash
 ? 选择 Claude Code 配置语言:
   ❯ 简体中文 (zh-CN) - 中文版（便于中文用户自定义）
     English (en) - 英文版（推荐，token 消耗更低）
@@ -110,6 +158,13 @@ $ npx zcf
     Custom
     （支持日语、法语、德语等多种语言）
 
+? 选择 AI 个性化设置:
+  ❯ 专业助手(默认)
+    猫娘助手
+    友好助手
+    导师模式
+    自定义
+
 ? 检测到 Claude Code 未安装，是否自动安装？(Y/n)
 
 ✔ Claude Code 安装成功
@@ -154,10 +209,11 @@ $ npx zcf
 
 #### 命令速查表
 
-| 命令         | 缩写    | 说明                         |
-| ------------ | ------- | ---------------------------- |
-| `zcf`        | -       | 初始化配置（默认命令）       |
-| `zcf update` | `zcf u` | 更新 Prompt 文档并备份旧配置 |
+| 命令         | 缩写      | 说明                                    |
+| ------------ | --------- | --------------------------------------- |
+| `zcf`        | -         | 显示交互式菜单（v2.0默认命令）          |
+| `zcf init`   | `zcf i`   | 初始化 Claude Code 配置                 |
+| `zcf update` | `zcf u`   | 更新 Prompt 文档并备份旧配置            |
 
 #### 常用选项
 
@@ -186,15 +242,20 @@ npx zcf -v
 #### 使用示例
 
 ```bash
-# 首次安装，交互式配置
+# 显示交互式菜单（默认）
 npx zcf
 
+# 首次安装，完整初始化
+npx zcf i
+npx zcf init              # 完整命令
+
 # 更新 Prompt 文档并备份旧配置，保留 API 和 MCP 配置
 npx zcf u
+npx zcf update            # 完整命令
 
 # 强制使用中文配置重新初始化
-npx zcf --config-lang zh-CN --force
-npx zcf -c zh-CN -f      # 使用缩写
+npx zcf i --config-lang zh-CN --force
+npx zcf i -c zh-CN -f      # 使用缩写
 
 # 更新到英文版 Prompt（降低 token 消耗）
 npx zcf u --config-lang en
@@ -215,9 +276,12 @@ claude-code-config/
 │   ├── utils/           # 工具函数
 │   └── constants.ts     # 常量定义
 ├── templates/            # 配置模板
+│   ├── CLAUDE.md        # 项目级配置（v2.0新增）
 │   ├── settings.json    # 基础配置（含隐私保护环境变量）
 │   ├── en/              # 英文版
-│   │   ├── CLAUDE.md    # 核心原则
+│   │   ├── rules.md     # 核心原则（原CLAUDE.md）
+│   │   ├── personality.md # AI个性化（v2.0新增）
+│   │   ├── mcp.md       # MCP服务说明（v2.0新增）
 │   │   ├── agents/      # AI 代理
 │   │   └── commands/    # 命令定义
 │   └── zh-CN/           # 中文版
@@ -225,12 +289,13 @@ claude-code-config/
 └── dist/                # 构建输出
 ```
 
-## ✨ 核心特性
+## ✨ 核心特性（v2.0增强）
 
 ### 🤖 专业代理
 
 - **任务规划师**：将复杂任务拆解为可执行步骤
 - **UI/UX 设计师**：提供专业界面设计指导
+- **AI 个性化**：支持多种预设人格和自定义（v2.0新增）
 
 ### ⚡ 命令系统
 
@@ -239,9 +304,11 @@ claude-code-config/
 
 ### 🔧 智能配置
 
-- API 密钥管理
+- API 密钥管理（支持部分修改）
 - 细粒度权限控制
-- 多种 Claude 模型支持
+- 多种 Claude 模型支持（可配置默认模型）
+- 交互式菜单系统（v2.0新增）
+- AI 记忆管理（v2.0新增）
 
 ## 🎯 开发工作流