zcf 2.8.1 → 2.8.2

package/dist/chunks/simple-config.mjs

@@ -19,7 +19,7 @@ import { promisify as promisify$1 } from 'node:util';
 import { homedir, platform } from 'node:os';
 import { join as join$2 } from 'node:path';
 
-const version = "2.8.1";
+const version = "2.8.2";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const common$1 = {

package/dist/cli.mjs

@@ -505,8 +505,14 @@ async function runCcrStart(scriptLang) {
     if (stderr) console.error(ansis.yellow(stderr));
     console.log(ansis.green(`\u2714 ${i18n.ccr.ccrStarted}`));
   } catch (error) {
-    console.error(ansis.red(`\u2716 ${i18n.ccr.ccrCommandFailed}: ${error instanceof Error ? error.message : String(error)}`));
-    throw error;
+    if (error.stdout && error.stdout.includes("Loaded JSON config from:")) {
+      console.log(error.stdout);
+      if (error.stderr) console.error(ansis.yellow(error.stderr));
+      console.log(ansis.green(`\u2714 ${i18n.ccr.ccrStarted}`));
+    } else {
+      console.error(ansis.red(`\u2716 ${i18n.ccr.ccrCommandFailed}: ${error instanceof Error ? error.message : String(error)}`));
+      throw error;
+    }
   }
 }
 async function runCcrStop(scriptLang) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "description": "Zero-Config Claude-Code Flow - One-click configuration tool for Claude Code",
   "license": "MIT",
   "homepage": "https://github.com/UfoMiao/zcf",

package/templates/en/memory/mcp.md

@@ -1,6 +1,22 @@
-### Prioritize using MCP service
+## MCP Services Usage Guide
 
-- `Context7`: Query latest library documentation/examples
-- `DeepWiki`: Query related GitHub repository documentation/examples
-- `Exa`: Use Exa AI for web search - real-time web search, can capture specific URL content. Supports configurable result count and returns most relevant website content
-- `Playwright`: Direct browser control for browser-related operations
+### Documentation & Code Queries
+- **Context7**: Query latest library docs and code examples
+  - Use case: When learning new framework or library usage
+  - Examples: React Hooks, Vue Composition API queries
+
+- **DeepWiki**: Query GitHub repository documentation
+  - Use case: When deep-diving into open source implementations
+  - Examples: Project architecture, contribution guides
+
+### Information Search
+- **Exa**: AI-powered web search
+  - Real-time search for latest tech news
+  - Extract complete content from specific URLs
+  - Return most relevant search results
+
+### Browser Automation
+- **Playwright**: Browser control
+  - Automate web operations and testing
+  - Screenshots and page analysis
+  - Form filling and interaction testing

package/templates/en/memory/technical-guides.md

@@ -7,6 +7,7 @@ This document provides best practices for Claude Code when executing technical t
 **Important**: The following operations require explicit user confirmation before execution:
 
 ### Operations Requiring Confirmation
+
 - **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
@@ -15,7 +16,9 @@ This document provides best practices for Claude Code when executing technical t
 - **Package Management**: Global install/uninstall, update core dependencies
 
 ### Confirmation Process
+
 Before executing dangerous operations:
+
 1. Clearly explain the operation and its impacts
 2. Wait for explicit user confirmation (e.g., "yes", "confirm", "proceed")
 3. If user hesitates or declines, provide more information or alternatives
@@ -36,12 +39,14 @@ cd C:\Users\name\My Documents
 ```
 
 ### Cross-Platform Compatibility
+
 - Prefer forward slashes `/` as path separators
 - When using backslashes, ensure paths are double-quoted
 
 ## Search Tool Usage
 
 ### Content Search
+
 **Always prioritize `rg` (ripgrep)** - faster and won't timeout.
 
 ```bash
@@ -56,6 +61,7 @@ grep -r "pattern" .
 > Note: If `rg` unavailable, remind user to install: `brew/scoop/apt install ripgrep`
 
 ### File Finding
+
 - Use Glob tool for pattern matching
 - Use LS tool for directory listings
 - Avoid using `find` command
@@ -77,12 +83,14 @@ grep -r "pattern" .
 Automatically check documentation update needs after task completion:
 
 ### Criteria
+
 - **New Features**: Update README, CHANGELOG, usage docs
 - **API Changes**: Update API docs, type definitions, interface specs
 - **Config Changes**: Update config guides, CLAUDE.md, env var docs
 - **Bug Fixes**: Usually no doc updates needed (unless usage affected)
 
 ### Process
+
 1. Analyze code change type and impact scope
 2. Auto-identify documentation files in project
 3. List documents needing updates
@@ -90,8 +98,29 @@ Automatically check documentation update needs after task completion:
 5. Update relevant docs after confirmation
 
 ### Common Document Types
+
 - **README.md**: Features, usage, configuration
 - **CHANGELOG.md**: Version history
 - **CLAUDE.md**: AI assistant config and instructions
 - **API Docs**: Interface definitions, parameters
-- **Config Docs**: Environment variables, settings
+- **Config Docs**: Environment variables, settings
+
+## AI Assistant Behavior Guidelines
+
+The following guidelines define core behavioral standards that AI assistants should follow when executing tasks:
+
+### 1. Persist Until Complete Resolution
+
+Remember, you are an agent - please keep going until the user's query is completely resolved, before ending your turn and yielding back to the user. Only terminate your turn when you are sure that the problem is solved.
+
+### 2. Base Responses on Facts, Not Guesses
+
+If you are not sure about information pertaining to the user's request, use your tools to read files and gather the relevant information: do NOT guess or make up an answer.
+
+### 3. Plan Extensively and Reflect Thoroughly
+
+You MUST plan extensively before each function call, and reflect extensively on the outcomes of the previous function calls, ensuring user's query is completely resolved. DO NOT do this entire process by making function calls only, as this can impair your ability to solve the problem and think insightfully. In addition, ensure function calls have the correct arguments.
+
+### 4. Read Before Write Principle
+
+Before updating or modifying files, first use the Read tool to read the file contents.

package/templates/zh-CN/memory/mcp.md

@@ -1,6 +1,22 @@
-# 优先使用 MCP 服务：
+## MCP 服务使用指南
 
-- `Context7`: 查询最新库文档/示例。
-- `DeepWiki`: 查询相关 GitHub 仓库的文档/示例。
-- `exa`: 使用 Exa AI 进行网页搜索 - 实时网页搜索，能够抓取特定 URL 的内容。支持可配置的结果数量，并返回最相关网站的内容。
-- `Playwright`: 直接操控浏览器，进行浏览器相关操作。
+### 文档与代码查询
+- **Context7**: 查询最新库文档和代码示例
+  - 使用场景：需要了解新框架或库的用法时
+  - 示例：查询 React Hooks、Vue Composition API 等
+
+- **DeepWiki**: 查询 GitHub 仓库文档
+  - 使用场景：需要深入了解开源项目实现时
+  - 示例：查看项目架构、贡献指南等
+
+### 信息搜索
+- **Exa**: AI 驱动的网页搜索
+  - 实时搜索最新技术资讯
+  - 抓取特定 URL 的完整内容
+  - 返回最相关的搜索结果
+
+### 浏览器自动化
+- **Playwright**: 浏览器操控
+  - 自动化网页操作和测试
+  - 截图和页面分析
+  - 表单填写和交互测试

package/templates/zh-CN/memory/technical-guides.md

@@ -7,15 +7,18 @@
 **重要**：以下操作需要明确的用户确认后才能执行：
 
 ### 需确认的操作类型
+
 - **文件系统**：删除文件/目录、批量修改、移动系统文件
 - **代码提交**：`git commit`、`git push`、`git reset --hard`
 - **系统配置**：修改环境变量、系统设置、权限变更
 - **数据操作**：数据库删除、结构变更、批量更新
-- **网络请求**：发送敏感数据、调用生产环境API
+- **网络请求**：发送敏感数据、调用生产环境 API
 - **包管理**：全局安装/卸载、更新核心依赖
 
 ### 确认方式
+
 执行危险操作前，必须：
+
 1. 明确说明即将执行的操作及其影响
 2. 等待用户明确确认（如"是"、"确认"、"继续"）
 3. 用户未确认或表示犹豫时，提供更多信息或替代方案
@@ -36,12 +39,14 @@ cd C:\Users\name\My Documents
 ```
 
 ### 跨平台兼容性
+
 - 优先使用正斜杠 `/` 作为路径分隔符
 - 使用反斜杠时确保路径被双引号包裹
 
 ## 搜索工具使用
 
 ### 内容搜索
+
 **始终优先使用 `rg` (ripgrep)**，速度更快且不会超时。
 
 ```bash
@@ -56,6 +61,7 @@ grep -r "pattern" .
 > 提示：如 `rg` 不可用，提醒用户安装：`brew/scoop/apt install ripgrep`
 
 ### 文件查找
+
 - 使用 Glob 工具进行模式匹配
 - 使用 LS 工具列出目录
 - 避免使用 `find` 命令
@@ -77,12 +83,14 @@ grep -r "pattern" .
 任务完成后自动检查文档更新需求：
 
 ### 判断标准
+
 - **新功能**：需更新 README、CHANGELOG、使用文档
-- **API变更**：需更新 API文档、类型定义、接口说明
+- **API 变更**：需更新 API 文档、类型定义、接口说明
 - **配置变更**：需更新配置说明、CLAUDE.md、环境变量文档
-- **Bug修复**：通常无需更新文档（除非影响使用方式）
+- **Bug 修复**：通常无需更新文档（除非影响使用方式）
 
 ### 执行流程
+
 1. 分析代码变更类型和影响范围
 2. 自动识别项目中的文档文件
 3. 列出需更新的文档清单
@@ -90,8 +98,29 @@ grep -r "pattern" .
 5. 获得确认后逐一更新相关文档
 
 ### 常见文档类型
+
 - **README.md**：功能说明、使用方法、配置说明
 - **CHANGELOG.md**：版本更新记录
-- **CLAUDE.md**：AI助手配置和指令
-- **API文档**：接口定义、参数说明
-- **配置文档**：环境变量、配置项说明
+- **CLAUDE.md**：AI 助手配置和指令
+- **API 文档**：接口定义、参数说明
+- **配置文档**：环境变量、配置项说明
+
+## AI 助手行为准则
+
+以下准则定义了 AI 助手在执行任务时应遵循的核心行为规范：
+
+### 1. 持续解决问题直至完成
+
+记住，你是一个 AI 助手 - 请持续工作直到用户的问题完全解决，再结束你的回合并交还给用户。只有在确信问题已解决时才终止你的回合。
+
+### 2. 基于事实而非猜测
+
+如果你对用户请求相关的信息不确定，使用你的工具读取文件并收集相关信息：不要猜测或编造答案。
+
+### 3. 充分规划与反思
+
+你必须在每次函数调用前进行充分的规划，并对之前函数调用的结果进行充分的反思，确保用户的问题完全解决。不要仅通过函数调用来完成整个过程，因为这可能会损害你解决问题和深入思考的能力。此外，确保函数调用具有正确的参数。
+
+### 4. 先读后写原则
+
+在更新或修改文件前，先使用 Read 工具读取文件内容。