zcf 2.1.2 → 2.3.0

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import ansis from 'ansis';
 import cac from 'cac';
-import { d as SUPPORTED_LANGS, I as I18N, L as LANG_LABELS, z as updateZcfConfig, Z as ZCF_CONFIG_FILE, B as readZcfConfig, D as resolveAiOutputLanguage, p as applyAiLanguageDirective, E as configureAiPersonality, u as updateDefaultModel, F as isWindows, r as readMcpConfig, x as fixWindowsMcpConfig, w as writeMcpConfig, G as selectMcpServices, s as backupMcpConfig, M as MCP_SERVICES, v as buildMcpServerConfig, t as mergeMcpServers, o as getExistingApiConfig, H as formatApiKeyDisplay, J as modifyApiConfigPartially, K as validateApiKey, l as configureApi, N as displayBanner, O as selectScriptLanguage, S as SETTINGS_FILE, P as updatePromptOnly, Q as version, R as handleExitPromptError, T as handleGeneralError, U as displayBannerWithInfo, i as init } from './shared/zcf.BAnSslet.mjs';
+import { d as SUPPORTED_LANGS, I as I18N, L as LANG_LABELS, z as updateZcfConfig, Z as ZCF_CONFIG_FILE, B as readZcfConfig, D as resolveAiOutputLanguage, p as applyAiLanguageDirective, E as configureAiPersonality, u as updateDefaultModel, F as isWindows, r as readMcpConfig, x as fixWindowsMcpConfig, w as writeMcpConfig, G as selectMcpServices, s as backupMcpConfig, M as MCP_SERVICES, v as buildMcpServerConfig, t as mergeMcpServers, o as getExistingApiConfig, H as formatApiKeyDisplay, J as modifyApiConfigPartially, K as validateApiKey, l as configureApi, N as displayBanner, O as selectScriptLanguage, S as SETTINGS_FILE, P as updatePromptOnly, Q as version, R as handleExitPromptError, T as handleGeneralError, U as displayBannerWithInfo, i as init } from './shared/zcf.ChHPmCup.mjs';
 import inquirer from 'inquirer';
 import { existsSync, unlinkSync } from 'node:fs';
 import 'node:os';

package/dist/index.mjs

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

package/dist/shared/{zcf.BAnSslet.mjs → zcf.ChHPmCup.mjs}

@@ -7,7 +7,7 @@ import dayjs from 'dayjs';
 import { fileURLToPath } from 'node:url';
 import { exec } from 'tinyexec';
 
-const version = "2.1.2";
+const version = "2.3.0";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const CLAUDE_DIR = join(homedir(), ".claude");

package/package.json

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

package/templates/CLAUDE.md

@@ -1,4 +1,5 @@
 @language.md
 @personality.md
 @rules.md
+@technical-guides.md
 @mcp.md

package/templates/en/commands/feat.md

@@ -1,23 +1,5 @@
 ---
 description: Add New Feature
-
-allowed-tools:
-  - Task
-  - Bash
-  - Glob
-  - Grep
-  - Read
-  - Edit
-  - MultiEdit
-  - Write
-  - WebFetch
-  - WebSearch
-  - Notebook.*
-  - Edit|Write
-  - mcp__.*
-  - mcp__memory__.*
-  - mcp__filesystem__.*
-  - mcp__github__.*
 ---
 
 $ARGUMENTS

package/templates/en/commands/workflow.md

@@ -1,22 +1,5 @@
 ---
 description: 'Professional AI programming assistant with structured workflow (Research -> Ideate -> Plan -> Execute -> Optimize -> Review) for developers'
-allowed-tools:
-  - Task
-  - Bash
-  - Glob
-  - Grep
-  - Read
-  - Edit
-  - MultiEdit
-  - Write
-  - WebFetch
-  - WebSearch
-  - Notebook.*
-  - Edit|Write
-  - mcp__.*
-  - mcp__memory__.*
-  - mcp__filesystem__.*
-  - mcp__github__.*
 ---
 
 # Workflow - Professional Development Assistant

package/templates/en/technical-guides.md

@@ -0,0 +1,73 @@
+# Technical Execution Guidelines
+
+This document provides best practices for Claude Code when executing technical tasks.
+
+## Dangerous Operations Confirmation
+
+**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
+- **Data Operations**: Database deletions, schema changes, bulk updates
+- **Network Requests**: Send sensitive data, call production APIs
+- **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
+
+## Command Execution Best Practices
+
+### Path Handling Standards
+
+**Important**: Always use double quotes to wrap file paths when executing commands.
+
+```bash
+# ✅ Correct
+cd "C:\Users\name\My Documents"
+node "/path/with spaces/app.js"
+
+# ❌ Incorrect
+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
+# ✅ Preferred
+rg "pattern" .
+rg -t js "console.log" .
+
+# ⚠️ Fallback
+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
+
+## Tool Usage Principles
+
+1. **Prefer Specialized Tools**: Use Read, Write, Edit instead of cat, echo
+2. **Batch Operations**: Call multiple tools simultaneously for efficiency
+3. **Error Handling**: Check path quoting first when commands fail
+
+## Performance Optimization
+
+- Use Task tool for complex searches in large projects
+- Understand project structure before searching
+- Use file type filters wisely for efficiency

package/templates/settings.json

@@ -8,19 +8,23 @@
   "includeCoAuthoredBy": false,
   "permissions": {
     "allow": [
-      "Bash(*)",
-      "LS(*)",
-      "Read(*)",
-      "Write(*)",
-      "Edit(*)",
-      "MultiEdit(*)",
-      "Glob(*)",
-      "Grep(*)",
-      "WebFetch(*)",
-      "WebSearch(*)",
-      "TodoWrite(*)",
-      "NotebookRead(*)",
-      "NotebookEdit(*)"
+      "Bash",
+      "LS",
+      "Read",
+      "Write",
+      "Edit",
+      "MultiEdit",
+      "Glob",
+      "Grep",
+      "WebFetch",
+      "WebSearch",
+      "TodoWrite",
+      "NotebookRead",
+      "NotebookEdit",
+      "mcp__exa",
+      "mcp__context7",
+      "mcp__mcp-deepwiki",
+      "mcp__Playwright"
     ],
     "deny": []
   },

package/templates/zh-CN/commands/feat.md

@@ -1,23 +1,5 @@
 ---
 description: '用于新增功能开发的命令，支持完整的开发流程和工具集成'
-
-allowed-tools:
-  - Task
-  - Bash
-  - Glob
-  - Grep
-  - Read
-  - Edit
-  - MultiEdit
-  - Write
-  - WebFetch
-  - WebSearch
-  - Notebook.*
-  - Edit|Write
-  - mcp__.*
-  - mcp__memory__.*
-  - mcp__filesystem__.*
-  - mcp__github__.*
 ---
 
 $ARGUMENTS

package/templates/zh-CN/commands/workflow.md

@@ -1,22 +1,5 @@
 ---
 description: '专业AI编程助手，提供结构化六阶段开发工作流（研究→构思→计划→执行→优化→评审），适用于专业开发者'
-allowed-tools:
-  - Task
-  - Bash
-  - Glob
-  - Grep
-  - Read
-  - Edit
-  - MultiEdit
-  - Write
-  - WebFetch
-  - WebSearch
-  - Notebook.*
-  - Edit|Write
-  - mcp__.*
-  - mcp__memory__.*
-  - mcp__filesystem__.*
-  - mcp__github__.*
 ---
 
 # Workflow - 专业开发助手

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

@@ -0,0 +1,73 @@
+# 技术执行指南
+
+本文档提供 Claude Code 执行技术任务时的最佳实践。
+
+## 危险操作确认机制
+
+**重要**：以下操作需要明确的用户确认后才能执行：
+
+### 需确认的操作类型
+- **文件系统**：删除文件/目录、批量修改、移动系统文件
+- **代码提交**：`git commit`、`git push`、`git reset --hard`
+- **系统配置**：修改环境变量、系统设置、权限变更
+- **数据操作**：数据库删除、结构变更、批量更新
+- **网络请求**：发送敏感数据、调用生产环境API
+- **包管理**：全局安装/卸载、更新核心依赖
+
+### 确认方式
+执行危险操作前，必须：
+1. 明确说明即将执行的操作及其影响
+2. 等待用户明确确认（如"是"、"确认"、"继续"）
+3. 用户未确认或表示犹豫时，提供更多信息或替代方案
+
+## 命令执行最佳实践
+
+### 路径处理规范
+
+**重要**：执行命令时**始终使用双引号包裹文件路径**。
+
+```bash
+# ✅ 正确
+cd "C:\Users\name\My Documents"
+node "/path/with spaces/app.js"
+
+# ❌ 错误
+cd C:\Users\name\My Documents
+```
+
+### 跨平台兼容性
+- 优先使用正斜杠 `/` 作为路径分隔符
+- 使用反斜杠时确保路径被双引号包裹
+
+## 搜索工具使用
+
+### 内容搜索
+**始终优先使用 `rg` (ripgrep)**，速度更快且不会超时。
+
+```bash
+# ✅ 优先使用
+rg "pattern" .
+rg -t js "console.log" .
+
+# ⚠️ 备选方案
+grep -r "pattern" .
+```
+
+> 提示：如 `rg` 不可用，提醒用户安装：`brew/scoop/apt install ripgrep`
+
+### 文件查找
+- 使用 Glob 工具进行模式匹配
+- 使用 LS 工具列出目录
+- 避免使用 `find` 命令
+
+## 工具使用原则
+
+1. **优先专用工具**：使用 Read、Write、Edit 而非 cat、echo
+2. **批量操作**：同时调用多个工具以提高效率
+3. **错误处理**：命令失败时先检查路径引号问题
+
+## 性能优化
+
+- 大型项目使用 Task 工具进行复杂搜索
+- 搜索前了解项目结构，缩小范围
+- 合理使用文件类型过滤提高效率