zcf 2.8.0 → 2.8.2

package/README.md

@@ -24,8 +24,9 @@ Menu options include:
 
 - `1` Full initialization (equivalent to `zcf i`)
 - `2` Import workflows (equivalent to `zcf u`)
-- `3-7` Configuration management (API/CCR, MCP, Model, AI personality, etc.)
-- `R` Claude Code Router management (new feature)
+- `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:
@@ -54,7 +55,7 @@ npx zcf → select 2  # Execute workflow update via menu
 
 #### 🎯 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
@@ -63,19 +64,28 @@ BMad (Business-Minded Agile Development) is an enterprise-grade workflow system
 
 After installation, use `/bmad-init` to initialize the BMad workflow in your project.
 
-#### 🚀 CCR (Claude Code Router) Support (v2.8 New Feature)
+#### 🚀 CCR (Claude Code Router) Support (v2.8+ Enhanced)
 
-CCR is a powerful proxy router that enables:
+[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:
@@ -163,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显示语言:
   ❯ 简体中文
@@ -179,10 +189,14 @@ Select function:
   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: _
 ```
@@ -268,13 +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           |
-| `zcf ccr`    | -       | Open CCR (Claude Code Router) management menu |
+| 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
 
@@ -466,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/dist/{shared/zcf.CLtDS8Pu.mjs → chunks/simple-config.mjs}

@@ -5,13 +5,21 @@ import { join, dirname } from 'pathe';
 import dayjs from 'dayjs';
 import { fileURLToPath } from 'node:url';
 import { exec } from 'tinyexec';
-import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
-import { exec as exec$1 } from 'node:child_process';
-import { promisify } from 'node:util';
+import { exec as exec$1 } from 'child_process';
+import { promisify } from 'util';
+import ora from 'ora';
+import prompts$1 from 'prompts';
+import { readFile as readFile$1, writeFile as writeFile$1, mkdir } from 'fs/promises';
+import { join as join$1 } from 'path';
+import { homedir as homedir$1 } from 'os';
+import semver from 'semver';
+import { rm, mkdir as mkdir$1, copyFile as copyFile$1 } from 'node:fs/promises';
+import { exec as exec$2 } from 'node:child_process';
+import { promisify as promisify$1 } from 'node:util';
 import { homedir, platform } from 'node:os';
-import { join as join$1 } from 'node:path';
+import { join as join$2 } from 'node:path';
 
-const version = "2.8.0";
+const version = "2.8.2";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const common$1 = {
@@ -123,11 +131,21 @@ const configuration$1 = {
   // Model configuration
   selectDefaultModel: "\u9009\u62E9\u9ED8\u8BA4\u6A21\u578B",
   modelConfigSuccess: "\u9ED8\u8BA4\u6A21\u578B\u5DF2\u914D\u7F6E",
+  existingModelConfig: "\u68C0\u6D4B\u5230\u5DF2\u6709\u6A21\u578B\u914D\u7F6E",
+  currentModel: "\u5F53\u524D\u6A21\u578B",
+  modifyModel: "\u662F\u5426\u4FEE\u6539\u6A21\u578B\u914D\u7F6E\uFF1F",
+  keepModel: "\u4FDD\u6301\u5F53\u524D\u6A21\u578B\u914D\u7F6E",
+  defaultModelOption: "\u9ED8\u8BA4\uFF08\u8BA9 Claude Code \u81EA\u52A8\u9009\u62E9\uFF09",
+  modelConfigured: "\u9ED8\u8BA4\u6A21\u578B\u5DF2\u914D\u7F6E",
   // AI memory configuration
   selectMemoryOption: "\u9009\u62E9\u914D\u7F6E\u9009\u9879",
   configureAiLanguage: "\u914D\u7F6E AI \u8F93\u51FA\u8BED\u8A00",
   configureAiPersonality: "\u914D\u7F6E AI \u4E2A\u6027\u98CE\u683C",
   aiLanguageConfigured: "AI \u8F93\u51FA\u8BED\u8A00\u5DF2\u914D\u7F6E",
+  existingLanguageConfig: "\u68C0\u6D4B\u5230\u5DF2\u6709 AI \u8F93\u51FA\u8BED\u8A00\u914D\u7F6E",
+  currentLanguage: "\u5F53\u524D\u8BED\u8A00",
+  modifyLanguage: "\u662F\u5426\u4FEE\u6539 AI \u8F93\u51FA\u8BED\u8A00\uFF1F",
+  keepLanguage: "\u4FDD\u6301\u5F53\u524D\u8BED\u8A00\u914D\u7F6E",
   // AI personality
   selectAiPersonality: "\u9009\u62E9 AI \u4E2A\u6027\u98CE\u683C",
   customPersonalityHint: "\u5B9A\u4E49\u4F60\u81EA\u5DF1\u7684\u4E2A\u6027",
@@ -430,6 +448,24 @@ const ccrMessages$1 = {
   ccrUiApiKeyHint: "\u4F7F\u7528\u6B64\u5BC6\u94A5\u767B\u5F55 CCR UI \u754C\u9762"
 };
 
+const updater$1 = {
+  checkingVersion: "\u6B63\u5728\u68C0\u67E5\u7248\u672C...",
+  checkingTools: "\u68C0\u67E5\u5DE5\u5177\u7248\u672C",
+  ccrNotInstalled: "CCR \u672A\u5B89\u88C5",
+  ccrUpToDate: "CCR \u5DF2\u662F\u6700\u65B0\u7248\u672C (v{version})",
+  claudeCodeNotInstalled: "Claude Code \u672A\u5B89\u88C5",
+  claudeCodeUpToDate: "Claude Code \u5DF2\u662F\u6700\u65B0\u7248\u672C (v{version})",
+  cannotCheckVersion: "\u65E0\u6CD5\u68C0\u67E5\u6700\u65B0\u7248\u672C",
+  currentVersion: "\u5F53\u524D\u7248\u672C: v{version}",
+  latestVersion: "\u6700\u65B0\u7248\u672C: v{version}",
+  confirmUpdate: "\u662F\u5426\u66F4\u65B0 {tool} \u5230\u6700\u65B0\u7248\u672C\uFF1F",
+  updateSkipped: "\u5DF2\u8DF3\u8FC7\u66F4\u65B0",
+  updating: "\u6B63\u5728\u66F4\u65B0 {tool}...",
+  updateSuccess: "{tool} \u66F4\u65B0\u6210\u529F\uFF01",
+  updateFailed: "{tool} \u66F4\u65B0\u5931\u8D25",
+  checkFailed: "\u7248\u672C\u68C0\u67E5\u5931\u8D25"
+};
+
 const zhCN = {
   common: common$1,
   language: language$1,
@@ -443,7 +479,8 @@ const zhCN = {
   bmad: bmad$1,
   errors: errors$1,
   tools: tools$1,
-  ccr: ccrMessages$1
+  ccr: ccrMessages$1,
+  updater: updater$1
 };
 
 const common = {
@@ -555,11 +592,21 @@ const configuration = {
   // Model configuration
   selectDefaultModel: "Select default model",
   modelConfigSuccess: "Default model configured",
+  existingModelConfig: "Existing model configuration detected",
+  currentModel: "Current model",
+  modifyModel: "Modify model configuration?",
+  keepModel: "Keeping existing model configuration",
+  defaultModelOption: "Default (Let Claude Code choose)",
+  modelConfigured: "Default model configured",
   // AI memory configuration
   selectMemoryOption: "Select configuration option",
   configureAiLanguage: "Configure AI output language",
   configureAiPersonality: "Configure AI personality",
   aiLanguageConfigured: "AI output language configured",
+  existingLanguageConfig: "Existing AI output language configuration detected",
+  currentLanguage: "Current language",
+  modifyLanguage: "Modify AI output language?",
+  keepLanguage: "Keeping existing language configuration",
   // AI personality
   selectAiPersonality: "Select AI personality",
   customPersonalityHint: "Define your own personality",
@@ -862,6 +909,24 @@ const ccrMessages = {
   ccrUiApiKeyHint: "Use this API key to login to CCR UI"
 };
 
+const updater = {
+  checkingVersion: "Checking version...",
+  checkingTools: "Checking tool versions",
+  ccrNotInstalled: "CCR is not installed",
+  ccrUpToDate: "CCR is up to date (v{version})",
+  claudeCodeNotInstalled: "Claude Code is not installed",
+  claudeCodeUpToDate: "Claude Code is up to date (v{version})",
+  cannotCheckVersion: "Cannot check latest version",
+  currentVersion: "Current version: v{version}",
+  latestVersion: "Latest version: v{version}",
+  confirmUpdate: "Update {tool} to the latest version?",
+  updateSkipped: "Update skipped",
+  updating: "Updating {tool}...",
+  updateSuccess: "{tool} updated successfully!",
+  updateFailed: "{tool} update failed",
+  checkFailed: "Version check failed"
+};
+
 const en = {
   common,
   language,
@@ -875,7 +940,8 @@ const en = {
   bmad,
   errors,
   tools,
-  ccr: ccrMessages
+  ccr: ccrMessages,
+  updater
 };
 
 const I18N$1 = {
@@ -1672,7 +1738,11 @@ function updateDefaultModel(model) {
   if (existingSettings) {
     settings = existingSettings;
   }
-  settings.model = model;
+  if (model === "default") {
+    delete settings.model;
+  } else {
+    settings.model = model;
+  }
   writeJsonConfig(SETTINGS_FILE, settings);
 }
 function mergeSettingsFile(templatePath, targetPath) {
@@ -1720,6 +1790,16 @@ function mergeSettingsFile(templatePath, targetPath) {
     }
   }
 }
+function getExistingModelConfig() {
+  const settings = readJsonConfig(SETTINGS_FILE);
+  if (!settings) {
+    return null;
+  }
+  if (!settings.model) {
+    return "default";
+  }
+  return settings.model;
+}
 function getExistingApiConfig() {
   const settings = readJsonConfig(SETTINGS_FILE);
   if (!settings || !settings.env) {
@@ -1953,11 +2033,223 @@ async function updatePromptOnly(configLang, scriptLang, aiOutputLang) {
   console.log("\n" + ansis.cyan(i18n.common.complete));
 }
 
+function format(template, replacements) {
+  return template.replace(/\{(\w+)\}/g, (match, key) => {
+    return replacements[key] || match;
+  });
+}
+
+const execAsync$3 = promisify(exec$1);
+const CACHE_DIR = join$1(homedir$1(), ".claude", "cache");
+const CACHE_FILE = join$1(CACHE_DIR, "version-cache.json");
+const CACHE_DURATION = 24 * 60 * 60 * 1e3;
+async function ensureCacheDir() {
+  try {
+    await mkdir(CACHE_DIR, { recursive: true });
+  } catch (error) {
+  }
+}
+async function readCache() {
+  try {
+    const content = await readFile$1(CACHE_FILE, "utf-8");
+    return JSON.parse(content);
+  } catch {
+    return {};
+  }
+}
+async function writeCache(cache) {
+  await ensureCacheDir();
+  await writeFile$1(CACHE_FILE, JSON.stringify(cache, null, 2));
+}
+async function getInstalledVersion(command) {
+  try {
+    let stdout;
+    try {
+      const result = await execAsync$3(`${command} -v`);
+      stdout = result.stdout;
+    } catch {
+      const result = await execAsync$3(`${command} --version`);
+      stdout = result.stdout;
+    }
+    const versionMatch = stdout.match(/(\d+\.\d+\.\d+(?:-[\w.]+)?)/);
+    return versionMatch ? versionMatch[1] : null;
+  } catch {
+    return null;
+  }
+}
+async function getLatestVersion(packageName, useCache = true) {
+  if (useCache) {
+    const cache = await readCache();
+    const cached = cache[packageName];
+    if (cached && Date.now() - cached.checkedAt < CACHE_DURATION) {
+      return cached.version;
+    }
+  }
+  try {
+    const { stdout } = await execAsync$3(`npm view ${packageName} version`);
+    const version = stdout.trim();
+    const cache = await readCache();
+    cache[packageName] = {
+      version,
+      checkedAt: Date.now()
+    };
+    await writeCache(cache);
+    return version;
+  } catch {
+    return null;
+  }
+}
+function compareVersions(current, latest) {
+  if (!semver.valid(current) || !semver.valid(latest)) {
+    return -1;
+  }
+  return semver.compare(current, latest);
+}
+function shouldUpdate(current, latest) {
+  return compareVersions(current, latest) < 0;
+}
+async function checkCcrVersion() {
+  const currentVersion = await getInstalledVersion("ccr");
+  let latestVersion = await getLatestVersion("@musistudio/claude-code-router");
+  if (!latestVersion) {
+    latestVersion = await getLatestVersion("claude-code-router");
+  }
+  return {
+    installed: currentVersion !== null,
+    currentVersion,
+    latestVersion,
+    needsUpdate: currentVersion && latestVersion ? shouldUpdate(currentVersion, latestVersion) : false
+  };
+}
+async function checkClaudeCodeVersion() {
+  const currentVersion = await getInstalledVersion("claude");
+  const latestVersion = await getLatestVersion("@anthropic-ai/claude-code");
+  return {
+    installed: currentVersion !== null,
+    currentVersion,
+    latestVersion,
+    needsUpdate: currentVersion && latestVersion ? shouldUpdate(currentVersion, latestVersion) : false
+  };
+}
+
+const execAsync$2 = promisify(exec$1);
+async function updateCcr(scriptLang, force = false) {
+  const i18n = getTranslation(scriptLang);
+  const spinner = ora(i18n.updater.checkingVersion).start();
+  try {
+    const { installed, currentVersion, latestVersion, needsUpdate } = await checkCcrVersion();
+    spinner.stop();
+    if (!installed) {
+      console.log(ansis.yellow(i18n.updater.ccrNotInstalled));
+      return false;
+    }
+    if (!needsUpdate && !force) {
+      console.log(ansis.green(format(i18n.updater.ccrUpToDate, { version: currentVersion || "" })));
+      return true;
+    }
+    if (!latestVersion) {
+      console.log(ansis.yellow(i18n.updater.cannotCheckVersion));
+      return false;
+    }
+    console.log(ansis.cyan(format(i18n.updater.currentVersion, { version: currentVersion || "" })));
+    console.log(ansis.cyan(format(i18n.updater.latestVersion, { version: latestVersion })));
+    const { confirm } = await prompts$1({
+      type: "confirm",
+      name: "confirm",
+      message: format(i18n.updater.confirmUpdate, { tool: "CCR" }),
+      initial: true
+    });
+    if (!confirm) {
+      console.log(ansis.gray(i18n.updater.updateSkipped));
+      return true;
+    }
+    const updateSpinner = ora(format(i18n.updater.updating, { tool: "CCR" })).start();
+    try {
+      try {
+        await execAsync$2("npm update -g @musistudio/claude-code-router");
+      } catch {
+        await execAsync$2("npm update -g claude-code-router");
+      }
+      updateSpinner.succeed(format(i18n.updater.updateSuccess, { tool: "CCR" }));
+      return true;
+    } catch (error) {
+      updateSpinner.fail(format(i18n.updater.updateFailed, { tool: "CCR" }));
+      console.error(ansis.red(error instanceof Error ? error.message : String(error)));
+      return false;
+    }
+  } catch (error) {
+    spinner.fail(i18n.updater.checkFailed);
+    console.error(ansis.red(error instanceof Error ? error.message : String(error)));
+    return false;
+  }
+}
+async function updateClaudeCode(scriptLang, force = false) {
+  const i18n = getTranslation(scriptLang);
+  const spinner = ora(i18n.updater.checkingVersion).start();
+  try {
+    const { installed, currentVersion, latestVersion, needsUpdate } = await checkClaudeCodeVersion();
+    spinner.stop();
+    if (!installed) {
+      console.log(ansis.yellow(i18n.updater.claudeCodeNotInstalled));
+      return false;
+    }
+    if (!needsUpdate && !force) {
+      console.log(ansis.green(format(i18n.updater.claudeCodeUpToDate, { version: currentVersion || "" })));
+      return true;
+    }
+    if (!latestVersion) {
+      console.log(ansis.yellow(i18n.updater.cannotCheckVersion));
+      return false;
+    }
+    console.log(ansis.cyan(format(i18n.updater.currentVersion, { version: currentVersion || "" })));
+    console.log(ansis.cyan(format(i18n.updater.latestVersion, { version: latestVersion })));
+    const { confirm } = await prompts$1({
+      type: "confirm",
+      name: "confirm",
+      message: format(i18n.updater.confirmUpdate, { tool: "Claude Code" }),
+      initial: true
+    });
+    if (!confirm) {
+      console.log(ansis.gray(i18n.updater.updateSkipped));
+      return true;
+    }
+    const updateSpinner = ora(format(i18n.updater.updating, { tool: "Claude Code" })).start();
+    try {
+      await execAsync$2("npm update -g @anthropic-ai/claude-code");
+      updateSpinner.succeed(format(i18n.updater.updateSuccess, { tool: "Claude Code" }));
+      return true;
+    } catch (error) {
+      updateSpinner.fail(format(i18n.updater.updateFailed, { tool: "Claude Code" }));
+      console.error(ansis.red(error instanceof Error ? error.message : String(error)));
+      return false;
+    }
+  } catch (error) {
+    spinner.fail(i18n.updater.checkFailed);
+    console.error(ansis.red(error instanceof Error ? error.message : String(error)));
+    return false;
+  }
+}
+async function checkAndUpdateTools(scriptLang) {
+  const i18n = getTranslation(scriptLang);
+  console.log(ansis.bold.cyan(`
+\u{1F50D} ${i18n.updater.checkingTools}
+`));
+  await updateCcr(scriptLang);
+  console.log();
+  await updateClaudeCode(scriptLang);
+}
+
 async function isClaudeCodeInstalled() {
   return await commandExists("claude");
 }
 async function installClaudeCode(lang) {
   const i18n = getTranslation(lang);
+  const installed = await isClaudeCodeInstalled();
+  if (installed) {
+    console.log(ansis.green(`\u2714 ${i18n.installation.alreadyInstalled}`));
+    await updateClaudeCode(lang);
+    return;
+  }
   if (isTermux()) {
     console.log(ansis.yellow(`\u2139 ${i18n.installation.termuxDetected}`));
     const termuxPrefix = getTermuxPrefix();
@@ -2064,6 +2356,13 @@ async function resolveAiOutputLanguage(scriptLang, commandLineOption, savedConfi
   return await selectAiOutputLanguage(scriptLang, scriptLang);
 }
 
+const prompts = {
+  __proto__: null,
+  resolveAiOutputLanguage: resolveAiOutputLanguage,
+  selectAiOutputLanguage: selectAiOutputLanguage,
+  selectScriptLanguage: selectScriptLanguage
+};
+
 async function selectMcpServices(scriptLang) {
   const i18n = getTranslation(scriptLang);
   const choices = MCP_SERVICES.map((service) => ({
@@ -2182,7 +2481,7 @@ async function installWorkflowWithDependencies(config, configLang, scriptLang) {
 \u{1F4E6} ${i18n.workflow.installingWorkflow}: ${workflowName}...`));
   const commandsDir = join(CLAUDE_DIR, "commands", "zcf");
   if (!existsSync(commandsDir)) {
-    await mkdir(commandsDir, { recursive: true });
+    await mkdir$1(commandsDir, { recursive: true });
   }
   for (const commandFile of config.commands) {
     const commandSource = join(rootDir, "templates", configLang, "workflow", config.category, "commands", commandFile);
@@ -2204,7 +2503,7 @@ async function installWorkflowWithDependencies(config, configLang, scriptLang) {
   if (config.autoInstallAgents && config.agents.length > 0) {
     const agentsCategoryDir = join(CLAUDE_DIR, "agents", "zcf", config.category);
     if (!existsSync(agentsCategoryDir)) {
-      await mkdir(agentsCategoryDir, { recursive: true });
+      await mkdir$1(agentsCategoryDir, { recursive: true });
     }
     for (const agent of config.agents) {
       const agentSource = join(rootDir, "templates", configLang, "workflow", config.category, "agents", agent.filename);
@@ -2270,7 +2569,7 @@ async function cleanupOldVersionFiles(scriptLang) {
   }
 }
 
-const execAsync$1 = promisify(exec$1);
+const execAsync$1 = promisify$1(exec$2);
 async function isCcrInstalled() {
   try {
     await execAsync$1("ccr version");
@@ -2289,6 +2588,7 @@ async function installCcr(scriptLang) {
   const installed = await isCcrInstalled();
   if (installed) {
     console.log(ansis.green(`\u2714 ${i18n.ccr.ccrAlreadyInstalled}`));
+    await updateCcr(scriptLang);
     return;
   }
   console.log(ansis.cyan(`\u{1F4E6} ${i18n.ccr.installingCcr}`));
@@ -2298,6 +2598,7 @@ async function installCcr(scriptLang) {
   } catch (error) {
     if (error.message?.includes("EEXIST")) {
       console.log(ansis.yellow(`\u26A0 ${i18n.ccr.ccrAlreadyInstalled}`));
+      await updateCcr(scriptLang);
       return;
     }
     console.error(ansis.red(`\u2716 ${i18n.ccr.ccrInstallFailed}`));
@@ -2453,9 +2754,9 @@ function getFallbackPresets() {
   ];
 }
 
-const execAsync = promisify(exec$1);
-const CCR_CONFIG_DIR = join$1(homedir(), ".claude-code-router");
-const CCR_CONFIG_FILE = join$1(CCR_CONFIG_DIR, "config.json");
+const execAsync = promisify$1(exec$2);
+const CCR_CONFIG_DIR = join$2(homedir(), ".claude-code-router");
+const CCR_CONFIG_FILE = join$2(CCR_CONFIG_DIR, "config.json");
 const CCR_BACKUP_DIR = CCR_CONFIG_DIR;
 function ensureCcrConfigDir() {
   if (!existsSync(CCR_CONFIG_DIR)) {
@@ -2470,7 +2771,7 @@ function backupCcrConfig(scriptLang) {
     }
     const timestamp = dayjs().format("YYYY-MM-DDTHH-mm-ss-SSS") + "Z";
     const backupFileName = `config.json.${timestamp}.bak`;
-    const backupPath = join$1(CCR_BACKUP_DIR, backupFileName);
+    const backupPath = join$2(CCR_BACKUP_DIR, backupFileName);
     console.log(ansis.cyan(`${i18n.ccr.backupCcrConfig}`));
     copyFileSync(CCR_CONFIG_FILE, backupPath);
     console.log(ansis.green(`\u2714 ${i18n.ccr.ccrBackupSuccess.replace("{path}", backupPath)}`));
@@ -3078,4 +3379,4 @@ async function openSettingsJson() {
   }
 }
 
-export { readCcrConfig as $, AI_OUTPUT_LANGUAGES as A, backupMcpConfig as B, CLAUDE_DIR as C, mergeMcpServers as D, buildMcpServerConfig as E, fixWindowsMcpConfig as F, addCompletedOnboarding as G, getTranslation as H, I18N as I, addNumbersToChoices as J, updateZcfConfig as K, LEGACY_ZCF_CONFIG_FILE as L, MCP_SERVICES as M, readZcfConfig as N, resolveAiOutputLanguage as O, configureAiPersonality as P, isWindows as Q, selectMcpServices as R, SETTINGS_FILE as S, formatApiKeyDisplay as T, modifyApiConfigPartially as U, isCcrInstalled as V, installCcr as W, setupCcrConfiguration as X, validateApiKey as Y, ZCF_CONFIG_FILE as Z, readZcfConfigAsync as _, importRecommendedEnv as a, configureCcrFeature as a0, handleExitPromptError as a1, handleGeneralError as a2, displayBanner as a3, selectScriptLanguage as a4, updatePromptOnly as a5, selectAndInstallWorkflows as a6, version as a7, displayBannerWithInfo as a8, importRecommendedPermissions as b, commandExists as c, cleanupPermissions as d, CLAUDE_MD_FILE as e, ClAUDE_CONFIG_FILE as f, getPlatform as g, SUPPORTED_LANGS as h, init as i, LANG_LABELS as j, isClaudeCodeInstalled as k, installClaudeCode as l, mergeAndCleanPermissions as m, ensureClaudeDir as n, openSettingsJson as o, backupExistingConfig as p, copyConfigFiles as q, configureApi as r, mergeConfigs as s, mergeSettingsFile as t, updateDefaultModel as u, getExistingApiConfig as v, applyAiLanguageDirective as w, getMcpConfigPath as x, readMcpConfig as y, writeMcpConfig as z };
+export { readCcrConfig as $, AI_OUTPUT_LANGUAGES as A, writeMcpConfig as B, CLAUDE_DIR as C, backupMcpConfig as D, mergeMcpServers as E, buildMcpServerConfig as F, fixWindowsMcpConfig as G, addCompletedOnboarding as H, I18N as I, getTranslation as J, addNumbersToChoices as K, LEGACY_ZCF_CONFIG_FILE as L, MCP_SERVICES as M, updateZcfConfig as N, readZcfConfig as O, configureAiPersonality as P, isWindows as Q, selectMcpServices as R, SETTINGS_FILE as S, formatApiKeyDisplay as T, modifyApiConfigPartially as U, isCcrInstalled as V, installCcr as W, setupCcrConfiguration as X, validateApiKey as Y, ZCF_CONFIG_FILE as Z, readZcfConfigAsync as _, importRecommendedEnv as a, configureCcrFeature as a0, handleExitPromptError as a1, handleGeneralError as a2, displayBanner as a3, selectScriptLanguage as a4, resolveAiOutputLanguage as a5, updatePromptOnly as a6, selectAndInstallWorkflows as a7, version as a8, displayBannerWithInfo as a9, checkAndUpdateTools as aa, prompts as ab, importRecommendedPermissions as b, commandExists as c, cleanupPermissions as d, CLAUDE_MD_FILE as e, ClAUDE_CONFIG_FILE as f, getPlatform as g, SUPPORTED_LANGS as h, init as i, LANG_LABELS as j, isClaudeCodeInstalled as k, installClaudeCode as l, mergeAndCleanPermissions as m, ensureClaudeDir as n, openSettingsJson as o, backupExistingConfig as p, copyConfigFiles as q, configureApi as r, mergeConfigs as s, mergeSettingsFile as t, updateDefaultModel as u, getExistingModelConfig as v, getExistingApiConfig as w, applyAiLanguageDirective as x, getMcpConfigPath as y, readMcpConfig as z };

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { H as getTranslation, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, J as addNumbersToChoices, j as LANG_LABELS, K as updateZcfConfig, o as openSettingsJson, b as importRecommendedPermissions, a as importRecommendedEnv, N as readZcfConfig, O as resolveAiOutputLanguage, w as applyAiLanguageDirective, P as configureAiPersonality, u as updateDefaultModel, Q as isWindows, y as readMcpConfig, F as fixWindowsMcpConfig, z as writeMcpConfig, R as selectMcpServices, B as backupMcpConfig, M as MCP_SERVICES, E as buildMcpServerConfig, D as mergeMcpServers, v as getExistingApiConfig, T as formatApiKeyDisplay, G as addCompletedOnboarding, U as modifyApiConfigPartially, V as isCcrInstalled, W as installCcr, X as setupCcrConfiguration, Y as validateApiKey, r as configureApi, _ as readZcfConfigAsync, I as I18N, $ as readCcrConfig, a0 as configureCcrFeature, a1 as handleExitPromptError, a2 as handleGeneralError, a3 as displayBanner, a4 as selectScriptLanguage, a5 as updatePromptOnly, a6 as selectAndInstallWorkflows, a7 as version, a8 as displayBannerWithInfo, i as init } from './shared/zcf.CLtDS8Pu.mjs';
+import { J as getTranslation, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, K as addNumbersToChoices, j as LANG_LABELS, N as updateZcfConfig, o as openSettingsJson, b as importRecommendedPermissions, a as importRecommendedEnv, O as readZcfConfig, x as applyAiLanguageDirective, P as configureAiPersonality, v as getExistingModelConfig, u as updateDefaultModel, Q as isWindows, z as readMcpConfig, G as fixWindowsMcpConfig, B as writeMcpConfig, R as selectMcpServices, D as backupMcpConfig, M as MCP_SERVICES, F as buildMcpServerConfig, E as mergeMcpServers, w as getExistingApiConfig, T as formatApiKeyDisplay, H as addCompletedOnboarding, U as modifyApiConfigPartially, V as isCcrInstalled, W as installCcr, X as setupCcrConfiguration, Y as validateApiKey, r as configureApi, _ as readZcfConfigAsync, I as I18N, $ as readCcrConfig, a0 as configureCcrFeature, a1 as handleExitPromptError, a2 as handleGeneralError, a3 as displayBanner, a4 as selectScriptLanguage, a5 as resolveAiOutputLanguage, a6 as updatePromptOnly, a7 as selectAndInstallWorkflows, a8 as version, a9 as displayBannerWithInfo, i as init, aa as checkAndUpdateTools } from './chunks/simple-config.mjs';
 import inquirer from 'inquirer';
 import { existsSync, unlinkSync } from 'node:fs';
 import { x } from 'tinyexec';
@@ -12,6 +12,12 @@ import { promisify } from 'util';
 import 'pathe';
 import 'dayjs';
 import 'node:url';
+import 'ora';
+import 'prompts';
+import 'fs/promises';
+import 'path';
+import 'os';
+import 'semver';
 import 'node:fs/promises';
 import 'node:child_process';
 import 'node:util';
@@ -26,9 +32,15 @@ async function configureApiFeature(scriptLang) {
   if (existingApiConfig) {
     console.log("\n" + ansis.blue(`\u2139 ${i18n.api.existingApiConfig}`));
     console.log(ansis.gray(`  ${i18n.api.apiConfigUrl}: ${existingApiConfig.url || i18n.common.notConfigured}`));
-    console.log(ansis.gray(`  ${i18n.api.apiConfigKey}: ${existingApiConfig.key ? formatApiKeyDisplay(existingApiConfig.key) : i18n.common.notConfigured}`));
-    console.log(ansis.gray(`  ${i18n.api.apiConfigAuthType}: ${existingApiConfig.authType || i18n.common.notConfigured}
-`));
+    console.log(
+      ansis.gray(
+        `  ${i18n.api.apiConfigKey}: ${existingApiConfig.key ? formatApiKeyDisplay(existingApiConfig.key) : i18n.common.notConfigured}`
+      )
+    );
+    console.log(
+      ansis.gray(`  ${i18n.api.apiConfigAuthType}: ${existingApiConfig.authType || i18n.common.notConfigured}
+`)
+    );
     const { action } = await inquirer.prompt({
       type: "list",
       name: "action",
@@ -209,21 +221,44 @@ async function configureMcpFeature(scriptLang) {
   }
 }
 async function configureDefaultModelFeature(scriptLang) {
+  const i18n = getTranslation(scriptLang);
+  const existingModel = getExistingModelConfig();
+  if (existingModel) {
+    console.log("\n" + ansis.blue(`\u2139 ${i18n.configuration.existingModelConfig || "Existing model configuration"}`));
+    const modelDisplay = existingModel === "default" ? i18n.configuration.defaultModelOption || "Default (Let Claude Code choose)" : existingModel.charAt(0).toUpperCase() + existingModel.slice(1);
+    console.log(ansis.gray(`  ${i18n.configuration.currentModel || "Current model"}: ${modelDisplay}
+`));
+    const { modify } = await inquirer.prompt({
+      type: "confirm",
+      name: "modify",
+      message: i18n.configuration.modifyModel || "Modify model configuration?",
+      default: false
+    });
+    if (!modify) {
+      console.log(ansis.green(`\u2714 ${i18n.configuration.keepModel || "Keeping existing model configuration"}`));
+      return;
+    }
+  }
   const { model } = await inquirer.prompt({
     type: "list",
     name: "model",
-    message: "Select default model",
+    message: i18n.configuration.selectDefaultModel || "Select default model",
     choices: addNumbersToChoices([
+      {
+        name: i18n.configuration.defaultModelOption || "Default (Let Claude Code choose)",
+        value: "default"
+      },
       { name: "Opus", value: "opus" },
       { name: "Sonnet", value: "sonnet" }
-    ])
+    ]),
+    default: existingModel ? ["opus", "sonnet", "default"].indexOf(existingModel) : 2
   });
   if (!model) {
     handleCancellation(scriptLang);
     return;
   }
   updateDefaultModel(model);
-  console.log(ansis.green(`\u2714 Default model configured`));
+  console.log(ansis.green(`\u2714 ${i18n.configuration.modelConfigured || "Default model configured"}`));
 }
 async function configureAiMemoryFeature(scriptLang) {
   const i18n = getTranslation(scriptLang);
@@ -247,7 +282,26 @@ async function configureAiMemoryFeature(scriptLang) {
   }
   if (option === "language") {
     const zcfConfig = readZcfConfig();
-    const aiOutputLang = await resolveAiOutputLanguage(scriptLang, void 0, zcfConfig);
+    const existingLang = zcfConfig?.aiOutputLang;
+    if (existingLang) {
+      console.log(
+        "\n" + ansis.blue(`\u2139 ${i18n.configuration.existingLanguageConfig || "Existing AI output language configuration"}`)
+      );
+      console.log(ansis.gray(`  ${i18n.configuration.currentLanguage || "Current language"}: ${existingLang}
+`));
+      const { modify } = await inquirer.prompt({
+        type: "confirm",
+        name: "modify",
+        message: i18n.configuration.modifyLanguage || "Modify AI output language?",
+        default: false
+      });
+      if (!modify) {
+        console.log(ansis.green(`\u2714 ${i18n.configuration.keepLanguage || "Keeping existing language configuration"}`));
+        return;
+      }
+    }
+    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.ab; });
+    const aiOutputLang = await selectAiOutputLanguage(scriptLang, scriptLang);
     applyAiLanguageDirective(aiOutputLang);
     updateZcfConfig({ aiOutputLang });
     console.log(ansis.green(`\u2714 ${i18n.configuration.aiLanguageConfigured || "AI output language configured"}`));
@@ -280,10 +334,12 @@ async function changeScriptLanguageFeature(currentLang) {
     type: "list",
     name: "lang",
     message: i18n.language.selectScriptLang,
-    choices: addNumbersToChoices(SUPPORTED_LANGS.map((l) => ({
-      name: LANG_LABELS[l],
-      value: l
-    }))),
+    choices: addNumbersToChoices(
+      SUPPORTED_LANGS.map((l) => ({
+        name: LANG_LABELS[l],
+        value: l
+      }))
+    ),
     default: SUPPORTED_LANGS.indexOf(currentLang)
   });
   if (!lang) {
@@ -302,15 +358,21 @@ async function configureEnvPermissionFeature(scriptLang) {
     message: i18n.configuration?.selectEnvPermissionOption || "Select option",
     choices: addNumbersToChoices([
       {
-        name: `${i18n.configuration?.importRecommendedEnv || "Import environment"} ${ansis.gray("- " + (i18n.configuration?.importRecommendedEnvDesc || "Import env settings"))}`,
+        name: `${i18n.configuration?.importRecommendedEnv || "Import environment"} ${ansis.gray(
+          "- " + (i18n.configuration?.importRecommendedEnvDesc || "Import env settings")
+        )}`,
         value: "env"
       },
       {
-        name: `${i18n.configuration?.importRecommendedPermissions || "Import permissions"} ${ansis.gray("- " + (i18n.configuration?.importRecommendedPermissionsDesc || "Import permission settings"))}`,
+        name: `${i18n.configuration?.importRecommendedPermissions || "Import permissions"} ${ansis.gray(
+          "- " + (i18n.configuration?.importRecommendedPermissionsDesc || "Import permission settings")
+        )}`,
         value: "permissions"
       },
       {
-        name: `${i18n.configuration?.openSettingsJson || "Open settings"} ${ansis.gray("- " + (i18n.configuration?.openSettingsJsonDesc || "View settings file"))}`,
+        name: `${i18n.configuration?.openSettingsJson || "Open settings"} ${ansis.gray(
+          "- " + (i18n.configuration?.openSettingsJsonDesc || "View settings file")
+        )}`,
         value: "open"
       }
     ])
@@ -443,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) {
@@ -859,6 +927,16 @@ async function ccr(options = {}) {
   }
 }
 
+async function checkUpdates(options = {}) {
+  const scriptLang = options.lang || await selectScriptLanguage();
+  try {
+    await checkAndUpdateTools(scriptLang);
+  } catch (error) {
+    console.error(ansis.red("Error checking updates:"), error);
+    process.exit(1);
+  }
+}
+
 function setupCommands(cli) {
   cli.command("[lang]", "Show interactive menu (default)").option("--init", "Run full initialization directly").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--force, -f", "Force overwrite existing configuration").action(async (lang, options) => {
     await handleDefaultCommand(lang, options);
@@ -875,6 +953,9 @@ function setupCommands(cli) {
   cli.command("ccu [...args]", "Run Claude Code usage analysis tool").allowUnknownOptions().action(async (args) => {
     await executeCcusage(args);
   });
+  cli.command("check-updates", "Check and update Claude Code and CCR to latest versions").alias("check").option("--lang, -l <lang>", "Display language (zh-CN, en)").action(async (options) => {
+    await checkUpdates({ lang: options.lang });
+  });
   cli.help((sections) => customizeHelp(sections));
   cli.version(version);
 }

package/dist/index.d.mts

@@ -13,6 +13,7 @@ interface TranslationStructure {
     errors: any;
     tools: any;
     ccr: any;
+    updater: any;
 }
 
 interface McpService {
@@ -105,12 +106,16 @@ declare function backupExistingConfig(): string | null;
 declare function copyConfigFiles(lang: SupportedLang, onlyMd?: boolean): void;
 declare function configureApi(apiConfig: ApiConfig | null): ApiConfig | null;
 declare function mergeConfigs(sourceFile: string, targetFile: string): void;
-declare function updateDefaultModel(model: 'opus' | 'sonnet'): void;
+declare function updateDefaultModel(model: 'opus' | 'sonnet' | 'default'): void;
 /**
  * Merge settings.json intelligently
  * Preserves user's environment variables and custom configurations
  */
 declare function mergeSettingsFile(templatePath: string, targetPath: string): void;
+/**
+ * Get existing model configuration from settings.json
+ */
+declare function getExistingModelConfig(): 'opus' | 'sonnet' | 'default' | null;
 /**
  * Get existing API configuration from settings.json
  */
@@ -150,5 +155,5 @@ declare function cleanupPermissions(templatePermissions: string[], userPermissio
  */
 declare function mergeAndCleanPermissions(templatePermissions: string[] | undefined, userPermissions: string[] | undefined): string[];
 
-export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.d.ts

@@ -13,6 +13,7 @@ interface TranslationStructure {
     errors: any;
     tools: any;
     ccr: any;
+    updater: any;
 }
 
 interface McpService {
@@ -105,12 +106,16 @@ declare function backupExistingConfig(): string | null;
 declare function copyConfigFiles(lang: SupportedLang, onlyMd?: boolean): void;
 declare function configureApi(apiConfig: ApiConfig | null): ApiConfig | null;
 declare function mergeConfigs(sourceFile: string, targetFile: string): void;
-declare function updateDefaultModel(model: 'opus' | 'sonnet'): void;
+declare function updateDefaultModel(model: 'opus' | 'sonnet' | 'default'): void;
 /**
  * Merge settings.json intelligently
  * Preserves user's environment variables and custom configurations
  */
 declare function mergeSettingsFile(templatePath: string, targetPath: string): void;
+/**
+ * Get existing model configuration from settings.json
+ */
+declare function getExistingModelConfig(): 'opus' | 'sonnet' | 'default' | null;
 /**
  * Get existing API configuration from settings.json
  */
@@ -150,5 +155,5 @@ declare function cleanupPermissions(templatePermissions: string[], userPermissio
  */
 declare function mergeAndCleanPermissions(templatePermissions: string[] | undefined, userPermissions: string[] | undefined): string[];
 
-export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, j as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILE, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, G as addCompletedOnboarding, w as applyAiLanguageDirective, p as backupExistingConfig, B as backupMcpConfig, E as buildMcpServerConfig, d as cleanupPermissions, c as commandExists, r as configureApi, q as copyConfigFiles, n as ensureClaudeDir, F as fixWindowsMcpConfig, v as getExistingApiConfig, x as getMcpConfigPath, g as getPlatform, a as importRecommendedEnv, b as importRecommendedPermissions, i as init, l as installClaudeCode, k as isClaudeCodeInstalled, m as mergeAndCleanPermissions, s as mergeConfigs, D as mergeMcpServers, t as mergeSettingsFile, o as openSettingsJson, y as readMcpConfig, u as updateDefaultModel, z as writeMcpConfig } from './shared/zcf.CLtDS8Pu.mjs';
+export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, j as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILE, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, H as addCompletedOnboarding, x as applyAiLanguageDirective, p as backupExistingConfig, D as backupMcpConfig, F as buildMcpServerConfig, d as cleanupPermissions, c as commandExists, r as configureApi, q as copyConfigFiles, n as ensureClaudeDir, G as fixWindowsMcpConfig, w as getExistingApiConfig, v as getExistingModelConfig, y as getMcpConfigPath, g as getPlatform, a as importRecommendedEnv, b as importRecommendedPermissions, i as init, l as installClaudeCode, k as isClaudeCodeInstalled, m as mergeAndCleanPermissions, s as mergeConfigs, E as mergeMcpServers, t as mergeSettingsFile, o as openSettingsJson, z as readMcpConfig, u as updateDefaultModel, B as writeMcpConfig } from './chunks/simple-config.mjs';
 import 'inquirer';
 import 'ansis';
 import 'node:fs';
@@ -6,6 +6,14 @@ import 'pathe';
 import 'dayjs';
 import 'node:url';
 import 'tinyexec';
+import 'child_process';
+import 'util';
+import 'ora';
+import 'prompts';
+import 'fs/promises';
+import 'path';
+import 'os';
+import 'semver';
 import 'node:fs/promises';
 import 'node:child_process';
 import 'node:util';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.8.0",
+  "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",
@@ -21,12 +21,17 @@
     "templates"
   ],
   "dependencies": {
+    "@types/prompts": "^2.4.9",
+    "@types/semver": "^7.7.0",
     "ansis": "^3.17.0",
     "cac": "^6.7.14",
     "dayjs": "^1.11.13",
     "find-up-simple": "^1.0.1",
     "inquirer": "^12.9.0",
+    "ora": "^8.2.0",
     "pathe": "^2.0.3",
+    "prompts": "^2.4.2",
+    "semver": "^7.7.2",
     "tinyexec": "^1.0.1"
   },
   "devDependencies": {

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 工具读取文件内容。