zcf 2.12.7 → 2.12.8

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 UfoMiao & WitMiao
+Copyright (c) 2025-PRESENT UfoMiao <https://github.com/UfoMiao> & Miao Da <https://github.com/WitMiao>
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/README.md

@@ -24,13 +24,29 @@ 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 settings, AI output style, environment permissions, etc.)
+- `3` Configure API or CCR - API configuration or CCR proxy setup
+- `4` Configure MCP - MCP service configuration and management
+- `5` Configure default model - Set default model (opus/sonnet/opusplan/custom)
+- `6` Configure AI memory - Configure AI output language and global output style
+- `7` Configure environment permissions - Import environment variables and permissions
 - `R` Claude Code Router management (enhanced in v2.8.1)
 - `U` ccusage - Claude Code usage analysis
 - `L` CCometixLine - High-performance statusline tool with Git integration and real-time usage tracking (v2.9.9+ new)
 - `+` Check updates - Check and update Claude Code, CCR and CCometixLine versions (v2.9.9+ enhanced)
 - More features...
 
+#### 🎯 Key Configuration Features
+
+**Model Configuration (Option 5)**: Configure your default Claude model with flexible options:
+- **Default**: Let Claude Code automatically choose the best model for each task
+- **Opus**: Use Claude-3.5-Opus exclusively (high token consumption, use with caution)
+- **OpusPlan**: Use Opus for planning, Sonnet for implementation (recommended balance)
+- **Custom**: Specify your own model names for both primary and fast tasks (supports any custom model)
+
+**AI Memory Configuration (Option 6)**: Personalize your AI assistant:
+- **AI Output Language**: Set the language for AI responses (Chinese, English, or custom)
+- **Global Output Style**: Configure AI personality and response style
+
 ### Or, use direct commands:
 
 #### 🆕 First time using Claude Code
@@ -311,7 +327,7 @@ Select function:
   2. Import workflow - Import/update workflow-related files only
   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)
+  5. Configure default model - Set default model (opus/sonnet/opusplan/custom)
   6. Configure Claude global memory - Configure AI output language and output styles
   7. Import recommended environment variables and permissions - Import privacy protection environment variables and system permissions
 

package/dist/chunks/simple-config.mjs

@@ -2,20 +2,20 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, readd
 import process from 'node:process';
 import ansis from 'ansis';
 import inquirer from 'inquirer';
-import { fileURLToPath } from 'node:url';
-import i18next from 'i18next';
-import Backend from 'i18next-fs-backend';
-import { dirname, join } from 'pathe';
 import { exec as exec$1 } from 'node:child_process';
 import { homedir, platform } from 'node:os';
 import { promisify } from 'node:util';
 import dayjs from 'dayjs';
+import { dirname, join } from 'pathe';
+import { fileURLToPath } from 'node:url';
 import ora from 'ora';
 import semver from 'semver';
 import { exec } from 'tinyexec';
 import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
+import i18next from 'i18next';
+import Backend from 'i18next-fs-backend';
 
-const version = "2.12.7";
+const version = "2.12.8";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const i18n = i18next.createInstance();
@@ -345,22 +345,10 @@ const AI_OUTPUT_LANGUAGES = {
   "en": { directive: "Always respond in English" },
   "custom": { directive: "" }
 };
-let _i18n = null;
-function getI18nInstance() {
-  if (!_i18n) {
-    try {
-      const i18nModule = eval('require("./i18n")');
-      _i18n = i18nModule.i18n;
-    } catch {
-    }
-  }
-  return _i18n;
-}
 function getAiOutputLanguageLabel(lang) {
   if (lang in LANG_LABELS) {
     return LANG_LABELS[lang];
   }
-  const i18n = getI18nInstance();
   if (lang === "custom" && i18n?.isInitialized) {
     try {
       return i18n.t("language:labels.custom");
@@ -883,14 +871,42 @@ function mergeConfigs(sourceFile, targetFile) {
   const merged = deepMerge(target, source);
   writeJsonConfig(targetFile, merged);
 }
+function updateCustomModel(primaryModel, fastModel) {
+  if (!primaryModel?.trim() && !fastModel?.trim()) {
+    return;
+  }
+  let settings = getDefaultSettings();
+  const existingSettings = readJsonConfig(SETTINGS_FILE);
+  if (existingSettings) {
+    settings = existingSettings;
+  }
+  delete settings.model;
+  settings.env = settings.env || {};
+  if (primaryModel?.trim()) {
+    settings.env.ANTHROPIC_MODEL = primaryModel.trim();
+  }
+  if (fastModel?.trim()) {
+    settings.env.ANTHROPIC_SMALL_FAST_MODEL = fastModel.trim();
+  }
+  writeJsonConfig(SETTINGS_FILE, settings);
+}
 function updateDefaultModel(model) {
   let settings = getDefaultSettings();
   const existingSettings = readJsonConfig(SETTINGS_FILE);
   if (existingSettings) {
     settings = existingSettings;
   }
+  if (!settings.env) {
+    settings.env = {};
+  }
+  if (model !== "custom" && settings.env) {
+    delete settings.env.ANTHROPIC_MODEL;
+    delete settings.env.ANTHROPIC_SMALL_FAST_MODEL;
+  }
   if (model === "default") {
     delete settings.model;
+  } else if (model === "custom") {
+    delete settings.model;
   } else {
     settings.model = model;
   }
@@ -940,6 +956,9 @@ function getExistingModelConfig() {
   if (!settings) {
     return null;
   }
+  if (settings.env && (settings.env.ANTHROPIC_MODEL || settings.env.ANTHROPIC_SMALL_FAST_MODEL)) {
+    return "custom";
+  }
   if (!settings.model) {
     return "default";
   }
@@ -1484,8 +1503,7 @@ async function checkClaudeCodeVersionAndPrompt(skipPrompt = false) {
       return;
     }
     const { updateClaudeCode } = await Promise.resolve().then(function () { return autoUpdater; });
-    const forceUpdate = skipPrompt;
-    await updateClaudeCode(forceUpdate);
+    await updateClaudeCode(false, skipPrompt);
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     console.warn(`Claude Code version check failed: ${errorMessage}`);
@@ -1493,7 +1511,7 @@ async function checkClaudeCodeVersionAndPrompt(skipPrompt = false) {
 }
 
 const execAsync$2 = promisify(exec$1);
-async function updateCcr(force = false) {
+async function updateCcr(force = false, skipPrompt = false) {
   ensureI18nInitialized();
   const spinner = ora(i18n.t("updater:checkingVersion")).start();
   try {
@@ -1513,15 +1531,19 @@ async function updateCcr(force = false) {
     }
     console.log(ansis.cyan(format(i18n.t("updater:currentVersion"), { version: currentVersion || "" })));
     console.log(ansis.cyan(format(i18n.t("updater:latestVersion"), { version: latestVersion })));
-    const { confirm } = await inquirer.prompt({
-      type: "confirm",
-      name: "confirm",
-      message: format(i18n.t("updater:confirmUpdate"), { tool: "CCR" }),
-      default: true
-    });
-    if (!confirm) {
-      console.log(ansis.gray(i18n.t("updater:updateSkipped")));
-      return true;
+    if (!skipPrompt) {
+      const { confirm } = await inquirer.prompt({
+        type: "confirm",
+        name: "confirm",
+        message: format(i18n.t("updater:confirmUpdate"), { tool: "CCR" }),
+        default: true
+      });
+      if (!confirm) {
+        console.log(ansis.gray(i18n.t("updater:updateSkipped")));
+        return true;
+      }
+    } else {
+      console.log(ansis.cyan(format(i18n.t("updater:autoUpdating"), { tool: "CCR" })));
     }
     const updateSpinner = ora(format(i18n.t("updater:updating"), { tool: "CCR" })).start();
     try {
@@ -1539,7 +1561,7 @@ async function updateCcr(force = false) {
     return false;
   }
 }
-async function updateClaudeCode(force = false) {
+async function updateClaudeCode(force = false, skipPrompt = false) {
   ensureI18nInitialized();
   const spinner = ora(i18n.t("updater:checkingVersion")).start();
   try {
@@ -1559,15 +1581,19 @@ async function updateClaudeCode(force = false) {
     }
     console.log(ansis.cyan(format(i18n.t("updater:currentVersion"), { version: currentVersion || "" })));
     console.log(ansis.cyan(format(i18n.t("updater:latestVersion"), { version: latestVersion })));
-    const { confirm } = await inquirer.prompt({
-      type: "confirm",
-      name: "confirm",
-      message: format(i18n.t("updater:confirmUpdate"), { tool: "Claude Code" }),
-      default: true
-    });
-    if (!confirm) {
-      console.log(ansis.gray(i18n.t("updater:updateSkipped")));
-      return true;
+    if (!skipPrompt) {
+      const { confirm } = await inquirer.prompt({
+        type: "confirm",
+        name: "confirm",
+        message: format(i18n.t("updater:confirmUpdate"), { tool: "Claude Code" }),
+        default: true
+      });
+      if (!confirm) {
+        console.log(ansis.gray(i18n.t("updater:updateSkipped")));
+        return true;
+      }
+    } else {
+      console.log(ansis.cyan(format(i18n.t("updater:autoUpdating"), { tool: "Claude Code" })));
     }
     const updateSpinner = ora(format(i18n.t("updater:updating"), { tool: "Claude Code" })).start();
     try {
@@ -1585,7 +1611,7 @@ async function updateClaudeCode(force = false) {
     return false;
   }
 }
-async function updateCometixLine(force = false) {
+async function updateCometixLine(force = false, skipPrompt = false) {
   ensureI18nInitialized();
   const spinner = ora(i18n.t("updater:checkingVersion")).start();
   try {
@@ -1605,15 +1631,19 @@ async function updateCometixLine(force = false) {
     }
     console.log(ansis.cyan(format(i18n.t("updater:currentVersion"), { version: currentVersion || "" })));
     console.log(ansis.cyan(format(i18n.t("updater:latestVersion"), { version: latestVersion })));
-    const { confirm } = await inquirer.prompt({
-      type: "confirm",
-      name: "confirm",
-      message: format(i18n.t("updater:confirmUpdate"), { tool: "CCometixLine" }),
-      default: true
-    });
-    if (!confirm) {
-      console.log(ansis.gray(i18n.t("updater:updateSkipped")));
-      return true;
+    if (!skipPrompt) {
+      const { confirm } = await inquirer.prompt({
+        type: "confirm",
+        name: "confirm",
+        message: format(i18n.t("updater:confirmUpdate"), { tool: "CCometixLine" }),
+        default: true
+      });
+      if (!confirm) {
+        console.log(ansis.gray(i18n.t("updater:updateSkipped")));
+        return true;
+      }
+    } else {
+      console.log(ansis.cyan(format(i18n.t("updater:autoUpdating"), { tool: "CCometixLine" })));
     }
     const updateSpinner = ora(format(i18n.t("updater:updating"), { tool: "CCometixLine" })).start();
     try {
@@ -1631,16 +1661,49 @@ async function updateCometixLine(force = false) {
     return false;
   }
 }
-async function checkAndUpdateTools() {
+async function checkAndUpdateTools(skipPrompt = false) {
   ensureI18nInitialized();
   console.log(ansis.bold.cyan(`
 \u{1F50D} ${i18n.t("updater:checkingTools")}
 `));
-  await updateCcr();
+  const results = [];
+  try {
+    const success = await updateCcr(false, skipPrompt);
+    results.push({ tool: "CCR", success });
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.error(ansis.red(`\u274C ${format(i18n.t("updater:updateFailed"), { tool: "CCR" })}: ${errorMessage}`));
+    results.push({ tool: "CCR", success: false, error: errorMessage });
+  }
   console.log();
-  await updateClaudeCode();
+  try {
+    const success = await updateClaudeCode(false, skipPrompt);
+    results.push({ tool: "Claude Code", success });
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.error(ansis.red(`\u274C ${format(i18n.t("updater:updateFailed"), { tool: "Claude Code" })}: ${errorMessage}`));
+    results.push({ tool: "Claude Code", success: false, error: errorMessage });
+  }
   console.log();
-  await updateCometixLine();
+  try {
+    const success = await updateCometixLine(false, skipPrompt);
+    results.push({ tool: "CCometixLine", success });
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.error(ansis.red(`\u274C ${format(i18n.t("updater:updateFailed"), { tool: "CCometixLine" })}: ${errorMessage}`));
+    results.push({ tool: "CCometixLine", success: false, error: errorMessage });
+  }
+  if (skipPrompt) {
+    console.log(ansis.bold.cyan(`
+\u{1F4CB} ${i18n.t("updater:updateSummary")}`));
+    for (const result of results) {
+      if (result.success) {
+        console.log(ansis.green(`\u2714 ${result.tool}: ${i18n.t("updater:success")}`));
+      } else {
+        console.log(ansis.red(`\u274C ${result.tool}: ${i18n.t("updater:failed")} ${result.error ? `(${result.error})` : ""}`));
+      }
+    }
+  }
 }
 
 const autoUpdater = {
@@ -3156,4 +3219,4 @@ async function openSettingsJson() {
   }
 }
 
-export { getMcpServices as $, AI_OUTPUT_LANGUAGES as A, readMcpConfig as B, CLAUDE_DIR as C, writeMcpConfig as D, backupMcpConfig as E, mergeMcpServers as F, buildMcpServerConfig as G, fixWindowsMcpConfig as H, addCompletedOnboarding as I, ensureI18nInitialized as J, i18n as K, LEGACY_ZCF_CONFIG_FILE as L, readCcrConfig as M, isCcrInstalled as N, installCcr as O, configureCcrFeature as P, handleExitPromptError as Q, handleGeneralError as R, SETTINGS_FILE as S, addNumbersToChoices as T, updateZcfConfig as U, changeLanguage as V, readZcfConfig as W, configureOutputStyle as X, isWindows as Y, ZCF_CONFIG_FILE as Z, selectMcpServices as _, commandExists as a, formatApiKeyDisplay as a0, modifyApiConfigPartially as a1, setupCcrConfiguration as a2, validateApiKey as a3, COMETIX_COMMAND_NAME as a4, COMETIX_COMMANDS as a5, installCometixLine as a6, checkAndUpdateTools as a7, displayBanner as a8, resolveAiOutputLanguage as a9, updatePromptOnly as aa, selectAndInstallWorkflows as ab, checkClaudeCodeVersionAndPrompt as ac, version as ad, displayBannerWithInfo as ae, readZcfConfigAsync as af, initI18n as ag, selectScriptLanguage as ah, prompts as ai, importRecommendedEnv as b, cleanupPermissions as c, importRecommendedPermissions 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, getAiOutputLanguageLabel as k, ensureClaudeDir as l, mergeAndCleanPermissions as m, backupExistingConfig as n, openSettingsJson as o, copyConfigFiles as p, configureApi as q, mergeConfigs as r, mergeSettingsFile as s, getExistingModelConfig as t, updateDefaultModel as u, getExistingApiConfig as v, applyAiLanguageDirective as w, isClaudeCodeInstalled as x, installClaudeCode as y, getMcpConfigPath as z };
+export { selectMcpServices as $, AI_OUTPUT_LANGUAGES as A, getMcpConfigPath as B, CLAUDE_DIR as C, readMcpConfig as D, writeMcpConfig as E, backupMcpConfig as F, mergeMcpServers as G, buildMcpServerConfig as H, fixWindowsMcpConfig as I, addCompletedOnboarding as J, ensureI18nInitialized as K, LEGACY_ZCF_CONFIG_FILE as L, i18n as M, readCcrConfig as N, isCcrInstalled as O, installCcr as P, configureCcrFeature as Q, handleExitPromptError as R, SETTINGS_FILE as S, handleGeneralError as T, addNumbersToChoices as U, updateZcfConfig as V, changeLanguage as W, readZcfConfig as X, configureOutputStyle as Y, ZCF_CONFIG_FILE as Z, isWindows as _, commandExists as a, getMcpServices as a0, formatApiKeyDisplay as a1, modifyApiConfigPartially as a2, setupCcrConfiguration as a3, validateApiKey as a4, COMETIX_COMMAND_NAME as a5, COMETIX_COMMANDS as a6, installCometixLine as a7, checkAndUpdateTools as a8, displayBanner as a9, resolveAiOutputLanguage as aa, updatePromptOnly as ab, selectAndInstallWorkflows as ac, checkClaudeCodeVersionAndPrompt as ad, version as ae, displayBannerWithInfo as af, readZcfConfigAsync as ag, initI18n as ah, selectScriptLanguage as ai, prompts as aj, importRecommendedEnv as b, cleanupPermissions as c, importRecommendedPermissions 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, getAiOutputLanguageLabel as k, ensureClaudeDir as l, mergeAndCleanPermissions as m, backupExistingConfig as n, openSettingsJson as o, copyConfigFiles as p, configureApi as q, mergeConfigs as r, updateDefaultModel as s, mergeSettingsFile as t, updateCustomModel as u, getExistingModelConfig as v, getExistingApiConfig as w, applyAiLanguageDirective as x, isClaudeCodeInstalled as y, installClaudeCode as z };

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { J as ensureI18nInitialized, K as i18n, M as readCcrConfig, N as isCcrInstalled, O as installCcr, P as configureCcrFeature, Q as handleExitPromptError, R as handleGeneralError, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, T as addNumbersToChoices, j as LANG_LABELS, U as updateZcfConfig, V as changeLanguage, o as openSettingsJson, d as importRecommendedPermissions, b as importRecommendedEnv, W as readZcfConfig, w as applyAiLanguageDirective, X as configureOutputStyle, t as getExistingModelConfig, u as updateDefaultModel, Y as isWindows, B as readMcpConfig, H as fixWindowsMcpConfig, D as writeMcpConfig, _ as selectMcpServices, E as backupMcpConfig, $ as getMcpServices, G as buildMcpServerConfig, F as mergeMcpServers, v as getExistingApiConfig, a0 as formatApiKeyDisplay, I as addCompletedOnboarding, a1 as modifyApiConfigPartially, a2 as setupCcrConfiguration, a3 as validateApiKey, q as configureApi, a4 as COMETIX_COMMAND_NAME, a5 as COMETIX_COMMANDS, a6 as installCometixLine, a7 as checkAndUpdateTools, a8 as displayBanner, a9 as resolveAiOutputLanguage, aa as updatePromptOnly, ab as selectAndInstallWorkflows, ac as checkClaudeCodeVersionAndPrompt, ad as version, ae as displayBannerWithInfo, i as init, af as readZcfConfigAsync, ag as initI18n, ah as selectScriptLanguage } from './chunks/simple-config.mjs';
+import { K as ensureI18nInitialized, M as i18n, N as readCcrConfig, O as isCcrInstalled, P as installCcr, Q as configureCcrFeature, R as handleExitPromptError, T as handleGeneralError, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, U as addNumbersToChoices, j as LANG_LABELS, V as updateZcfConfig, W as changeLanguage, o as openSettingsJson, d as importRecommendedPermissions, b as importRecommendedEnv, X as readZcfConfig, x as applyAiLanguageDirective, Y as configureOutputStyle, v as getExistingModelConfig, u as updateCustomModel, s as updateDefaultModel, _ as isWindows, D as readMcpConfig, I as fixWindowsMcpConfig, E as writeMcpConfig, $ as selectMcpServices, F as backupMcpConfig, a0 as getMcpServices, H as buildMcpServerConfig, G as mergeMcpServers, w as getExistingApiConfig, a1 as formatApiKeyDisplay, J as addCompletedOnboarding, a2 as modifyApiConfigPartially, a3 as setupCcrConfiguration, a4 as validateApiKey, q as configureApi, a5 as COMETIX_COMMAND_NAME, a6 as COMETIX_COMMANDS, a7 as installCometixLine, a8 as checkAndUpdateTools, a9 as displayBanner, aa as resolveAiOutputLanguage, ab as updatePromptOnly, ac as selectAndInstallWorkflows, ad as checkClaudeCodeVersionAndPrompt, ae as version, af as displayBannerWithInfo, i as init, ag as readZcfConfigAsync, ah as initI18n, ai as selectScriptLanguage } from './chunks/simple-config.mjs';
 import { existsSync, unlinkSync } from 'node:fs';
 import { homedir } from 'node:os';
 import inquirer from 'inquirer';
@@ -10,13 +10,13 @@ import { exec, spawn } from 'node:child_process';
 import { promisify } from 'node:util';
 import process from 'node:process';
 import { x } from 'tinyexec';
-import 'node:url';
-import 'i18next';
-import 'i18next-fs-backend';
 import 'dayjs';
+import 'node:url';
 import 'ora';
 import 'semver';
 import 'node:fs/promises';
+import 'i18next';
+import 'i18next-fs-backend';
 
 const execAsync$1 = promisify(exec);
 async function runCcrUi(apiKey) {
@@ -340,10 +340,11 @@ ${ansis.blue(`\u2139 ${i18n.t("api:existingApiConfig")}`)}`);
   const { url } = await inquirer.prompt({
     type: "input",
     name: "url",
-    message: i18n.t("api:enterApiUrl"),
-    validate: async (value) => {
-      if (!value)
-        return i18n.t("api:urlRequired");
+    message: `${i18n.t("api:enterApiUrl")}${i18n.t("common:emptyToSkip")}`,
+    validate: (value) => {
+      if (!value) {
+        return true;
+      }
       try {
         void new URL(value);
         return true;
@@ -352,27 +353,27 @@ ${ansis.blue(`\u2139 ${i18n.t("api:existingApiConfig")}`)}`);
       }
     }
   });
-  if (!url) {
+  if (url === void 0 || !url) {
     await handleCancellation();
     return;
   }
-  const keyMessage = apiChoice === "auth_token" ? i18n.t("api:enterAuthToken") : i18n.t("api:enterApiKey");
+  const keyMessage = apiChoice === "auth_token" ? `${i18n.t("api:enterAuthToken")}${i18n.t("common:emptyToSkip")}` : `${i18n.t("api:enterApiKey")}${i18n.t("common:emptyToSkip")}`;
   const { key } = await inquirer.prompt({
     type: "input",
     name: "key",
     message: keyMessage,
-    validate: async (value) => {
+    validate: (value) => {
       if (!value) {
-        return i18n.t("api:keyRequired");
+        return true;
       }
-      const validation = await validateApiKey(value);
+      const validation = validateApiKey(value);
       if (!validation.isValid) {
         return validation.error || i18n.t("api:invalidKeyFormat");
       }
       return true;
     }
   });
-  if (!key) {
+  if (key === void 0 || !key) {
     await handleCancellation();
     return;
   }
@@ -473,17 +474,46 @@ ${ansis.blue(`\u2139 ${i18n.t("configuration:existingModelConfig") || "Existing
       {
         name: i18n.t("configuration:opusPlanModelOption") || "OpusPlan - Use Opus for planning, write code with sonnet, recommended",
         value: "opusplan"
+      },
+      {
+        name: i18n.t("configuration:customModelOption") || "Custom - Specify custom model names",
+        value: "custom"
       }
     ]),
-    default: existingModel ? ["default", "opus", "opusplan"].indexOf(existingModel) : 0
+    default: existingModel ? ["default", "opus", "opusplan", "custom"].indexOf(existingModel) : 0
   });
   if (!model) {
     await handleCancellation();
     return;
   }
+  if (model === "custom") {
+    const { primaryModel, fastModel } = await promptCustomModels();
+    if (!primaryModel.trim() && !fastModel.trim()) {
+      console.log(ansis.yellow(`\u26A0 ${i18n.t("configuration:customModelSkipped") || "Custom model configuration skipped"}`));
+      return;
+    }
+    updateCustomModel(primaryModel, fastModel);
+    console.log(ansis.green(`\u2714 ${i18n.t("configuration:customModelConfigured") || "Custom model configuration completed"}`));
+    return;
+  }
   updateDefaultModel(model);
   console.log(ansis.green(`\u2714 ${i18n.t("configuration:modelConfigured") || "Default model configured"}`));
 }
+async function promptCustomModels() {
+  const { primaryModel } = await inquirer.prompt({
+    type: "input",
+    name: "primaryModel",
+    message: `${i18n.t("configuration:enterPrimaryModel")}${i18n.t("common:emptyToSkip")}`,
+    default: ""
+  });
+  const { fastModel } = await inquirer.prompt({
+    type: "input",
+    name: "fastModel",
+    message: `${i18n.t("configuration:enterFastModel")}${i18n.t("common:emptyToSkip")}`,
+    default: ""
+  });
+  return { primaryModel, fastModel };
+}
 async function configureAiMemoryFeature() {
   ensureI18nInitialized();
   const { option } = await inquirer.prompt({
@@ -525,7 +555,7 @@ ${ansis.blue(`\u2139 ${i18n.t("configuration:existingLanguageConfig") || "Existi
         return;
       }
     }
-    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.ai; });
+    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aj; });
     const aiOutputLang = await selectAiOutputLanguage();
     applyAiLanguageDirective(aiOutputLang);
     updateZcfConfig({ aiOutputLang });
@@ -825,11 +855,13 @@ async function runCometixMenuFeature() {
   await showCometixMenu();
 }
 
-async function checkUpdates() {
+async function checkUpdates(options = {}) {
   try {
-    await checkAndUpdateTools();
+    const skipPrompt = options.skipPrompt || false;
+    await checkAndUpdateTools(skipPrompt);
   } catch (error) {
-    console.error(ansis.red(i18n.t("updater:errorCheckingUpdates")), error);
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    console.error(ansis.red(`${i18n.t("updater:errorCheckingUpdates")} ${errorMessage}`));
     process.exit(1);
   }
 }

package/dist/i18n/locales/en/common.json

@@ -1,6 +1,7 @@
 {
   "multiSelectHint": " (Space to select, a to select all, i to invert, Enter to confirm)",
   "skip": "Skip",
+  "emptyToSkip": " (press Enter with empty content to skip)",
   "cancelled": "Operation cancelled",
   "error": "Error",
   "complete": "🎉 Setup complete! Use 'claude' command to start.",

package/dist/i18n/locales/en/configuration.json

@@ -8,10 +8,15 @@
   "configureAiLanguage": "Configure AI output language",
   "configureOutputStyle": "Configure global AI output style",
   "confirmClearCache": "Confirm clear all ZCF preference cache?",
+  "customModelConfigured": "Custom model configuration completed",
+  "customModelOption": "Custom - Specify custom model names",
+  "customModelSkipped": "Custom model configuration skipped",
   "currentLanguage": "Current language",
   "currentModel": "Current model",
   "defaultModelOption": "Default - Let Claude Code choose",
   "defaultStyle": "Default style",
+  "enterFastModel": "Enter fast model name for background tasks",
+  "enterPrimaryModel": "Enter primary model name",
   "envImportSuccess": "Environment variables imported",
   "existingConfig": "Existing config detected. How to proceed?",
   "existingLanguageConfig": "Existing AI output language configuration detected",

package/dist/i18n/locales/en/menu.json

@@ -9,7 +9,7 @@
   "menuDescriptions.configureApiOrCcr": "Configure API URL, authentication or CCR proxy",
   "menuDescriptions.configureEnvPermission": "Import privacy protection environment variables and system permissions",
   "menuDescriptions.configureMcp": "Configure MCP services (includes Windows fix)",
-  "menuDescriptions.configureModel": "Set default model (opus/sonnet)",
+  "menuDescriptions.configureModel": "Set default model (opus/sonnet/opusplan/custom)",
   "menuDescriptions.fullInit": "Install Claude Code + Import workflow + Configure API or CCR proxy + Configure MCP services",
   "menuDescriptions.importWorkflow": "Import/update workflow-related files only",
   "menuOptions.ccrManagement": "CCR",

package/dist/i18n/locales/en/updater.json

@@ -1,4 +1,5 @@
 {
+  "autoUpdating": "Auto-updating {tool}...",
   "cannotCheckVersion": "Cannot check latest version",
   "ccrNotInstalled": "CCR is not installed",
   "ccrUpToDate": "CCR is up to date (v{version})",
@@ -12,9 +13,12 @@
   "confirmUpdate": "Update {tool} to the latest version?",
   "currentVersion": "Current version: v{version}",
   "errorCheckingUpdates": "Error checking updates:",
+  "failed": "failed",
   "latestVersion": "Latest version: v{version}",
+  "success": "success",
   "updateFailed": "{tool} update failed",
   "updateSkipped": "Update skipped",
   "updateSuccess": "{tool} updated successfully!",
+  "updateSummary": "Update Summary",
   "updating": "Updating {tool}..."
 }

package/dist/i18n/locales/zh-CN/common.json

@@ -1,6 +1,7 @@
 {
   "multiSelectHint": "（空格选择，a全选，i反选，回车确认）",
   "skip": "跳过",
+  "emptyToSkip": "（空内容回车则跳过）",
   "cancelled": "操作已取消",
   "error": "错误",
   "complete": "🎉 配置完成！使用 'claude' 命令开始体验。",

package/dist/i18n/locales/zh-CN/configuration.json

@@ -8,10 +8,15 @@
   "configureAiLanguage": "配置 AI 输出语言",
   "configureOutputStyle": "配置全局 AI 输出风格",
   "confirmClearCache": "确认清除所有 ZCF 偏好缓存？",
+  "customModelConfigured": "自定义模型配置完成",
+  "customModelOption": "自定义 - 指定自定义模型名称",
+  "customModelSkipped": "已跳过自定义模型配置",
   "currentLanguage": "当前语言",
   "currentModel": "当前模型",
   "defaultModelOption": "默认 - 让 Claude Code 自动选择",
   "defaultStyle": "默认风格",
+  "enterFastModel": "请输入后台任务的快速模型名称",
+  "enterPrimaryModel": "请输入主要使用的模型名称",
   "envImportSuccess": "环境变量已导入",
   "existingConfig": "检测到已有配置文件，如何处理？",
   "existingLanguageConfig": "检测到已有 AI 输出语言配置",

package/dist/i18n/locales/zh-CN/menu.json

@@ -9,7 +9,7 @@
   "menuDescriptions.configureApiOrCcr": "配置 API URL、认证信息或 CCR 代理",
   "menuDescriptions.configureEnvPermission": "导入隐私保护环境变量和系统权限配置",
   "menuDescriptions.configureMcp": "配置 MCP 服务（含 Windows 修复）",
-  "menuDescriptions.configureModel": "设置默认模型（opus/sonnet）",
+  "menuDescriptions.configureModel": "设置默认模型（opus/sonnet/opusplan/自定义）",
   "menuDescriptions.fullInit": "安装 Claude Code + 导入工作流 + 配置 API 或 CCR 代理 + 配置 MCP 服务",
   "menuDescriptions.importWorkflow": "仅导入/更新工作流相关文件",
   "menuOptions.ccrManagement": "CCR",

package/dist/i18n/locales/zh-CN/updater.json

@@ -1,4 +1,5 @@
 {
+  "autoUpdating": "正在自动更新 {tool}...",
   "cannotCheckVersion": "无法检查最新版本",
   "ccrNotInstalled": "CCR 未安装",
   "ccrUpToDate": "CCR 已是最新版本 (v{version})",
@@ -12,9 +13,12 @@
   "confirmUpdate": "将 {tool} 更新到最新版本？",
   "currentVersion": "当前版本: v{version}",
   "errorCheckingUpdates": "检查更新时出错：",
+  "failed": "失败",
   "latestVersion": "最新版本: v{version}",
+  "success": "成功",
   "updateFailed": "{tool} 更新失败",
   "updateSkipped": "跳过更新",
   "updateSuccess": "{tool} 更新成功！",
+  "updateSummary": "更新摘要",
   "updating": "正在更新 {tool}..."
 }

package/dist/index.d.mts

@@ -79,7 +79,18 @@ declare function backupExistingConfig(): string | null;
 declare function copyConfigFiles(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' | 'opusplan' | 'default'): void;
+/**
+ * Update custom model configuration using environment variables
+ * @param primaryModel - Primary model name for general tasks
+ * @param fastModel - Fast model name for background tasks (optional)
+ */
+declare function updateCustomModel(primaryModel?: string, fastModel?: string): void;
+/**
+ * Update the default model configuration in settings.json
+ * @param model - The model type to set: opus, sonnet, opusplan, default, or custom
+ * Note: 'custom' model type is handled differently - it should use environment variables instead
+ */
+declare function updateDefaultModel(model: 'opus' | 'sonnet' | 'opusplan' | 'default' | 'custom'): void;
 /**
  * Merge settings.json intelligently
  * Preserves user's environment variables and custom configurations
@@ -88,7 +99,7 @@ declare function mergeSettingsFile(templatePath: string, targetPath: string): vo
 /**
  * Get existing model configuration from settings.json
  */
-declare function getExistingModelConfig(): 'opus' | 'sonnet' | 'opusplan' | 'default' | null;
+declare function getExistingModelConfig(): 'opus' | 'sonnet' | 'opusplan' | 'default' | 'custom' | null;
 /**
  * Get existing API configuration from settings.json
  */
@@ -127,12 +138,12 @@ declare function cleanupPermissions(templatePermissions: string[], userPermissio
  */
 declare function mergeAndCleanPermissions(templatePermissions: string[] | undefined, userPermissions: string[] | undefined): string[];
 
-declare function getPlatform(): "windows" | "macos" | "linux";
+declare function getPlatform(): 'windows' | 'macos' | 'linux';
 declare function commandExists(command: string): Promise<boolean>;
 
 declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, 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, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateCustomModel, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.d.ts

@@ -79,7 +79,18 @@ declare function backupExistingConfig(): string | null;
 declare function copyConfigFiles(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' | 'opusplan' | 'default'): void;
+/**
+ * Update custom model configuration using environment variables
+ * @param primaryModel - Primary model name for general tasks
+ * @param fastModel - Fast model name for background tasks (optional)
+ */
+declare function updateCustomModel(primaryModel?: string, fastModel?: string): void;
+/**
+ * Update the default model configuration in settings.json
+ * @param model - The model type to set: opus, sonnet, opusplan, default, or custom
+ * Note: 'custom' model type is handled differently - it should use environment variables instead
+ */
+declare function updateDefaultModel(model: 'opus' | 'sonnet' | 'opusplan' | 'default' | 'custom'): void;
 /**
  * Merge settings.json intelligently
  * Preserves user's environment variables and custom configurations
@@ -88,7 +99,7 @@ declare function mergeSettingsFile(templatePath: string, targetPath: string): vo
 /**
  * Get existing model configuration from settings.json
  */
-declare function getExistingModelConfig(): 'opus' | 'sonnet' | 'opusplan' | 'default' | null;
+declare function getExistingModelConfig(): 'opus' | 'sonnet' | 'opusplan' | 'default' | 'custom' | null;
 /**
  * Get existing API configuration from settings.json
  */
@@ -127,12 +138,12 @@ declare function cleanupPermissions(templatePermissions: string[], userPermissio
  */
 declare function mergeAndCleanPermissions(templatePermissions: string[] | undefined, userPermissions: string[] | undefined): string[];
 
-declare function getPlatform(): "windows" | "macos" | "linux";
+declare function getPlatform(): 'windows' | 'macos' | 'linux';
 declare function commandExists(command: string): Promise<boolean>;
 
 declare function importRecommendedEnv(): Promise<void>;
 declare function importRecommendedPermissions(): Promise<void>;
 declare function openSettingsJson(): Promise<void>;
 
-export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, 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, LANG_LABELS, LEGACY_ZCF_CONFIG_FILE, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, cleanupPermissions, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getAiOutputLanguageLabel, getExistingApiConfig, getExistingModelConfig, getMcpConfigPath, getPlatform, importRecommendedEnv, importRecommendedPermissions, init, installClaudeCode, isClaudeCodeInstalled, mergeAndCleanPermissions, mergeConfigs, mergeMcpServers, mergeSettingsFile, openSettingsJson, readMcpConfig, updateCustomModel, updateDefaultModel, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.mjs

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

package/package.json

@@ -1,14 +1,20 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.12.7",
+  "version": "2.12.8",
   "description": "Zero-Config Claude-Code Flow - One-click configuration tool for Claude Code",
+  "author": {
+    "name": "Miao Da",
+    "email": "ufo025174@gmail.com",
+    "url": "https://github.com/WitMiao"
+  },
   "license": "MIT",
   "homepage": "https://github.com/UfoMiao/zcf",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/UfoMiao/zcf.git"
   },
+  "bugs": "https://github.com/UfoMiao/zcf/issues",
   "keywords": [
     "claude",
     "claude-code",
@@ -35,13 +41,13 @@
   ],
   "dependencies": {
     "@types/semver": "^7.7.0",
-    "ansis": "^3.17.0",
+    "ansis": "^4.1.0",
     "cac": "^6.7.14",
-    "dayjs": "^1.11.13",
+    "dayjs": "^1.11.18",
     "find-up-simple": "^1.0.1",
     "i18next": "^25.4.2",
     "i18next-fs-backend": "^2.6.0",
-    "inquirer": "^12.9.0",
+    "inquirer": "^12.9.4",
     "ora": "^8.2.0",
     "pathe": "^2.0.3",
     "semver": "^7.7.2",
@@ -49,19 +55,29 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^5.2.1",
-    "@changesets/cli": "^2.29.5",
-    "@types/inquirer": "^9.0.8",
-    "@types/node": "^22.17.0",
+    "@changesets/cli": "^2.29.6",
+    "@commitlint/cli": "^19.8.1",
+    "@commitlint/config-conventional": "^19.8.1",
+    "@commitlint/types": "^19.8.1",
+    "@types/inquirer": "^9.0.9",
+    "@types/node": "^22.18.0",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
-    "eslint": "^9.33.0",
+    "eslint": "^9.34.0",
     "eslint-plugin-format": "^1.0.1",
     "glob": "^11.0.3",
-    "tsx": "^4.20.3",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.1.6",
+    "tsx": "^4.20.5",
     "typescript": "^5.9.2",
-    "unbuild": "^3.6.0",
+    "unbuild": "^3.6.1",
     "vitest": "^3.2.4"
   },
+  "lint-staged": {
+    "*": [
+      "pnpm lint"
+    ]
+  },
   "scripts": {
     "dev": "tsx ./src/cli.ts",
     "build": "unbuild",
@@ -76,6 +92,9 @@
     "test:watch": "vitest watch",
     "changeset": "changeset",
     "version": "changeset version",
-    "release": "pnpm build && changeset publish"
+    "update:deps": "pnpx taze major -r -w",
+    "release": "pnpm build && changeset publish",
+    "commitlint": "commitlint",
+    "commitlint:check": "commitlint --from HEAD~1 --to HEAD --verbose"
   }
 }

package/templates/common/settings.json

@@ -22,6 +22,7 @@
       "TodoWrite",
       "NotebookRead",
       "NotebookEdit",
+      "mcp__ide",
       "mcp__exa",
       "mcp__context7",
       "mcp__mcp-deepwiki",