zcf 2.12.6 → 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.6";
+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);
   }
 }
@@ -1120,12 +1152,12 @@ function customizeHelp(sections) {
       `  ${ansis.green("--api-url, -u")} <url>       ${i18n.t("cli:help.optionDescriptions.customApiUrl")}`,
       `  ${ansis.green("--ai-output-lang, -a")} <lang> ${i18n.t("cli:help.optionDescriptions.aiOutputLanguage")}`,
       `  ${ansis.green("--all-lang, -g")} <lang>     ${i18n.t("cli:help.optionDescriptions.setAllLanguageParams")}`,
-      `  ${ansis.green("--config-action, -r")} <action> ${i18n.t("cli:help.optionDescriptions.configHandling")} (default: backup)`,
-      `  ${ansis.green("--mcp-services, -m")} <list>  ${i18n.t("cli:help.optionDescriptions.mcpServices")} (default: all non-key services)`,
-      `  ${ansis.green("--workflows, -w")} <list>    ${i18n.t("cli:help.optionDescriptions.workflows")} (default: all workflows)`,
-      `  ${ansis.green("--output-styles, -o")} <styles> ${i18n.t("cli:help.optionDescriptions.outputStyles")} (default: all custom styles)`,
-      `  ${ansis.green("--default-output-style, -d")} <style> ${i18n.t("cli:help.optionDescriptions.defaultOutputStyle")} (default: engineer-professional)`,
-      `  ${ansis.green("--install-cometix-line, -x")} <value> ${i18n.t("cli:help.optionDescriptions.installStatuslineTool")} (default: true)`
+      `  ${ansis.green("--config-action, -r")} <action> ${i18n.t("cli:help.optionDescriptions.configHandling")} (${i18n.t("cli:help.defaults.prefix")} backup)`,
+      `  ${ansis.green("--mcp-services, -m")} <list>  ${i18n.t("cli:help.optionDescriptions.mcpServices")} (${i18n.t("cli:help.defaults.prefix")} all non-key services)`,
+      `  ${ansis.green("--workflows, -w")} <list>    ${i18n.t("cli:help.optionDescriptions.workflows")} (${i18n.t("cli:help.defaults.prefix")} all workflows)`,
+      `  ${ansis.green("--output-styles, -o")} <styles> ${i18n.t("cli:help.optionDescriptions.outputStyles")} (${i18n.t("cli:help.defaults.prefix")} all custom styles)`,
+      `  ${ansis.green("--default-output-style, -d")} <style> ${i18n.t("cli:help.optionDescriptions.defaultOutputStyle")} (${i18n.t("cli:help.defaults.prefix")} engineer-professional)`,
+      `  ${ansis.green("--install-cometix-line, -x")} <value> ${i18n.t("cli:help.optionDescriptions.installStatuslineTool")} (${i18n.t("cli:help.defaults.prefix")} true)`
     ].join("\n")
   });
   sections.push({
@@ -1145,11 +1177,11 @@ function customizeHelp(sections) {
       `  ${ansis.cyan("npx zcf ccr")}`,
       "",
       ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.runClaudeCodeUsageAnalysis")}`),
-      `  ${ansis.cyan("npx zcf ccu")}               ${ansis.gray("# Daily usage (default)")}`,
+      `  ${ansis.cyan("npx zcf ccu")}               ${ansis.gray(`# ${i18n.t("cli:help.defaults.dailyUsage")}`)}`,
       `  ${ansis.cyan("npx zcf ccu monthly --json")}`,
       "",
       ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.checkAndUpdateTools")}`),
-      `  ${ansis.cyan("npx zcf check-updates")}     ${ansis.gray("# Update Claude Code, CCR and CCometixLine")}`,
+      `  ${ansis.cyan("npx zcf check-updates")}     ${ansis.gray(`# ${i18n.t("cli:help.defaults.updateTools")}`)}`,
       `  ${ansis.cyan("npx zcf check")}`,
       "",
       ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.nonInteractiveModeCicd")}`),
@@ -1171,7 +1203,7 @@ async function setupCommands(cli) {
   cli.command("", "Show interactive menu (default)").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--force, -f", "Force overwrite existing configuration").action(await withLanguageResolution(async () => {
     await showMainMenu();
   }));
-  cli.command("init", "Initialize Claude Code configuration").alias("i").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--ai-output-lang, -a <lang>", "AI output language").option("--force, -f", "Force overwrite existing configuration").option("--skip-prompt, -s", "Skip all interactive prompts (non-interactive mode)").option("--config-action, -r <action>", "Config handling (new/backup/merge/docs-only/skip), default: backup").option("--api-type, -t <type>", "API type (auth_token/api_key/ccr_proxy/skip)").option("--api-key, -k <key>", "API key (used for both API key and auth token types)").option("--api-url, -u <url>", "Custom API URL").option("--mcp-services, -m <services>", 'Comma-separated MCP services to install (context7,mcp-deepwiki,Playwright,exa), "skip" to skip all, "all" for all non-key services, default: all').option("--workflows, -w <workflows>", 'Comma-separated workflows to install (sixStepsWorkflow,featPlanUx,gitWorkflow,bmadWorkflow), "skip" to skip all, "all" for all workflows, default: all').option("--output-styles, -o <styles>", 'Comma-separated output styles (engineer-professional,nekomata-engineer,laowang-engineer,default,explanatory,learning), "skip" to skip all, "all" for all custom styles, default: all').option("--default-output-style, -d <style>", "Default output style, default: engineer-professional").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--install-cometix-line, -x <value>", "Install CCometixLine statusline tool (true/false), default: true").action(await withLanguageResolution(async (options) => {
+  cli.command("init", "Initialize Claude Code configuration").alias("i").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").option("--ai-output-lang, -a <lang>", "AI output language").option("--force, -f", "Force overwrite existing configuration").option("--skip-prompt, -s", "Skip all interactive prompts (non-interactive mode)").option("--config-action, -r <action>", `Config handling (new/backup/merge/docs-only/skip), ${i18n.t("cli:help.defaults.prefix")} backup`).option("--api-type, -t <type>", "API type (auth_token/api_key/ccr_proxy/skip)").option("--api-key, -k <key>", "API key (used for both API key and auth token types)").option("--api-url, -u <url>", "Custom API URL").option("--mcp-services, -m <services>", `Comma-separated MCP services to install (context7,mcp-deepwiki,Playwright,exa), "skip" to skip all, "all" for all non-key services, ${i18n.t("cli:help.defaults.prefix")} all`).option("--workflows, -w <workflows>", `Comma-separated workflows to install (sixStepsWorkflow,featPlanUx,gitWorkflow,bmadWorkflow), "skip" to skip all, "all" for all workflows, ${i18n.t("cli:help.defaults.prefix")} all`).option("--output-styles, -o <styles>", `Comma-separated output styles (engineer-professional,nekomata-engineer,laowang-engineer,default,explanatory,learning), "skip" to skip all, "all" for all custom styles, ${i18n.t("cli:help.defaults.prefix")} all`).option("--default-output-style, -d <style>", `Default output style, ${i18n.t("cli:help.defaults.prefix")} engineer-professional`).option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--install-cometix-line, -x <value>", `Install CCometixLine statusline tool (true/false), ${i18n.t("cli:help.defaults.prefix")} true`).action(await withLanguageResolution(async (options) => {
     await init(options);
   }));
   cli.command("update", "Update Claude Code prompts only").alias("u").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").action(await withLanguageResolution(async (options) => {

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

@@ -11,8 +11,8 @@
   "enterApiKey": "Enter API Key",
   "enterApiUrl": "Enter API URL",
   "enterAuthToken": "Enter Auth Token",
-  "enterNewApiKey": "Enter new API Key (current: {{key}})",
-  "enterNewApiUrl": "Enter new API URL (current: {{url}})",
+  "enterNewApiKey": "Enter new API Key (current: {key})",
+  "enterNewApiUrl": "Enter new API URL (current: {url})",
   "existingApiConfig": "Existing API configuration detected:",
   "invalidKeyFormat": "Invalid key format",
   "invalidUrl": "Invalid URL",
@@ -26,7 +26,7 @@
   "modifyPartialConfig": "Modify partial configuration",
   "selectApiAction": "Select API processing operation",
   "selectModifyItems": "Select items to modify",
-  "selectNewAuthType": "Select new auth type (current: {{type}})",
+  "selectNewAuthType": "Select new auth type (current: {type})",
   "skipApi": "Skip (configure manually later)",
   "urlRequired": "URL is required",
   "useApiKey": "Use API Key (Key authentication)",

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

@@ -1,9 +1,9 @@
 {
-  "help.commands": "Commands:",
-  "help.shortcuts": "Shortcuts:",
-  "help.options": "Options:",
-  "help.examples": "Examples:",
-  "help.nonInteractiveMode": "Non-interactive mode (for CI/CD):",
+  "help.commands": "Commands",
+  "help.shortcuts": "Shortcuts",
+  "help.options": "Options",
+  "help.examples": "Examples",
+  "help.nonInteractiveMode": "Non-interactive mode (for CI/CD)",
   "help.commandDescriptions.showInteractiveMenuDefault": "Show interactive menu (default)",
   "help.commandDescriptions.initClaudeCodeConfig": "Initialize Claude Code configuration",
   "help.commandDescriptions.updateWorkflowFiles": "Update workflow-related md files",
@@ -38,5 +38,8 @@
   "help.exampleDescriptions.checkAndUpdateTools": "Check and update tools",
   "help.exampleDescriptions.nonInteractiveModeCicd": "Non-interactive mode (CI/CD)",
   "banner.subtitle": "One-click configuration tool for Claude Code",
-  "banner.updateSubtitle": "Update configuration for Claude Code"
+  "banner.updateSubtitle": "Update configuration for Claude Code",
+  "help.defaults.dailyUsage": "Daily usage (default)",
+  "help.defaults.updateTools": "Update Claude Code, CCR and CCometixLine",
+  "help.defaults.prefix": "default:"
 }

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/errors.json

@@ -2,15 +2,15 @@
   "failedToRemoveFile": "Failed to remove file:",
   "failedToSetOnboarding": "Failed to set onboarding completion flag:",
   "failedToWriteMcpConfig": "Failed to write MCP config:",
-  "invalidConfigAction": "Invalid configAction value: {{value}}. Must be 'new', 'backup', 'merge', 'docs-only', or 'skip'",
-  "invalidApiType": "Invalid apiType value: {{value}}. Must be 'auth_token', 'api_key', 'ccr_proxy', or 'skip'",
+  "invalidConfigAction": "Invalid configAction value: {value}. Must be 'new', 'backup', 'merge', 'docs-only', or 'skip'",
+  "invalidApiType": "Invalid apiType value: {value}. Must be 'auth_token', 'api_key', 'ccr_proxy', or 'skip'",
   "apiKeyRequiredForApiKey": "API key is required when apiType is \"api_key\"",
   "apiKeyRequiredForAuthToken": "API key is required when apiType is \"auth_token\"",
-  "invalidMcpService": "Invalid MCP service: {{service}}. Available services: {{validServices}}",
-  "invalidOutputStyle": "Invalid output style: {{style}}. Available styles: {{validStyles}}",
-  "invalidDefaultOutputStyle": "Invalid default output style: {{style}}. Available styles: {{validStyles}}",
-  "invalidWorkflow": "Invalid workflow: {{workflow}}. Available workflows: {{validWorkflows}}",
-  "invalidModel": "Invalid model: {{model}}. Expected 'opus', 'sonnet', or 'opusplan'",
+  "invalidMcpService": "Invalid MCP service: {service}. Available services: {validServices}",
+  "invalidOutputStyle": "Invalid output style: {style}. Available styles: {validStyles}",
+  "invalidDefaultOutputStyle": "Invalid default output style: {style}. Available styles: {validStyles}",
+  "invalidWorkflow": "Invalid workflow: {workflow}. Available workflows: {validWorkflows}",
+  "invalidModel": "Invalid model: {model}. Expected 'opus', 'sonnet', or 'opusplan'",
   "invalidEnvConfig": "Invalid env configuration: expected object",
   "invalidBaseUrl": "Invalid ANTHROPIC_BASE_URL: expected string",
   "invalidApiKeyConfig": "Invalid ANTHROPIC_API_KEY: expected string",

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,20 +1,24 @@
 {
+  "autoUpdating": "Auto-updating {tool}...",
   "cannotCheckVersion": "Cannot check latest version",
   "ccrNotInstalled": "CCR is not installed",
-  "ccrUpToDate": "CCR is up to date (v{{version}})",
+  "ccrUpToDate": "CCR is up to date (v{version})",
   "checkFailed": "Version check failed",
   "checkingTools": "Checking tool versions",
   "checkingVersion": "Checking version...",
   "claudeCodeNotInstalled": "Claude Code is not installed",
-  "claudeCodeUpToDate": "Claude Code is up to date (v{{version}})",
+  "claudeCodeUpToDate": "Claude Code is up to date (v{version})",
   "cometixLineNotInstalled": "CCometixLine is not installed",
-  "cometixLineUpToDate": "CCometixLine is up to date (v{{version}})",
-  "confirmUpdate": "Update {{tool}} to the latest version?",
-  "currentVersion": "Current version: v{{version}}",
+  "cometixLineUpToDate": "CCometixLine is up to date (v{version})",
+  "confirmUpdate": "Update {tool} to the latest version?",
+  "currentVersion": "Current version: v{version}",
   "errorCheckingUpdates": "Error checking updates:",
-  "latestVersion": "Latest version: v{{version}}",
-  "updateFailed": "{{tool}} update failed",
+  "failed": "failed",
+  "latestVersion": "Latest version: v{version}",
+  "success": "success",
+  "updateFailed": "{tool} update failed",
   "updateSkipped": "Update skipped",
-  "updateSuccess": "{{tool}} updated successfully!",
-  "updating": "Updating {{tool}}..."
+  "updateSuccess": "{tool} updated successfully!",
+  "updateSummary": "Update Summary",
+  "updating": "Updating {tool}..."
 }

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

@@ -11,8 +11,8 @@
   "enterApiKey": "请输入 API Key",
   "enterApiUrl": "请输入 API URL",
   "enterAuthToken": "请输入 Auth Token",
-  "enterNewApiKey": "请输入新的 API Key（当前：{{key}}）",
-  "enterNewApiUrl": "请输入新的 API URL（当前：{{url}}）",
+  "enterNewApiKey": "请输入新的 API Key（当前：{key}）",
+  "enterNewApiUrl": "请输入新的 API URL（当前：{url}）",
   "existingApiConfig": "检测到已有 API 配置：",
   "invalidKeyFormat": "无效的密钥格式",
   "invalidUrl": "无效的 URL",
@@ -26,7 +26,7 @@
   "modifyPartialConfig": "修改部分配置",
   "selectApiAction": "请选择API处理操作",
   "selectModifyItems": "请选择要修改的项",
-  "selectNewAuthType": "选择新的认证类型（当前：{{type}}）",
+  "selectNewAuthType": "选择新的认证类型（当前：{type}）",
   "skipApi": "跳过（稍后手动配置）",
   "urlRequired": "URL 为必填项",
   "useApiKey": "使用 API Key (密钥认证)",

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

@@ -1,9 +1,9 @@
 {
-  "help.commands": "命令:",
-  "help.shortcuts": "快捷方式:",
-  "help.options": "选项:",
-  "help.examples": "示例:",
-  "help.nonInteractiveMode": "非交互模式（适用于CI/CD）:",
+  "help.commands": "命令",
+  "help.shortcuts": "快捷方式",
+  "help.options": "选项",
+  "help.examples": "示例",
+  "help.nonInteractiveMode": "非交互模式（适用于CI/CD）",
   "help.commandDescriptions.showInteractiveMenuDefault": "显示交互式菜单（默认）",
   "help.commandDescriptions.initClaudeCodeConfig": "初始化 Claude Code 配置",
   "help.commandDescriptions.updateWorkflowFiles": "仅更新工作流相关md",
@@ -38,5 +38,8 @@
   "help.exampleDescriptions.checkAndUpdateTools": "检查并更新工具",
   "help.exampleDescriptions.nonInteractiveModeCicd": "非交互模式（CI/CD）",
   "banner.subtitle": "Claude Code 一键配置工具",
-  "banner.updateSubtitle": "更新 Claude Code 配置"
+  "banner.updateSubtitle": "更新 Claude Code 配置",
+  "help.defaults.dailyUsage": "每日用量（默认）",
+  "help.defaults.updateTools": "更新 Claude Code、CCR 和 CCometixLine",
+  "help.defaults.prefix": "默认:"
 }

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/errors.json

@@ -2,15 +2,15 @@
   "failedToRemoveFile": "删除文件失败：",
   "failedToSetOnboarding": "设置入门完成标志失败：",
   "failedToWriteMcpConfig": "写入 MCP 配置失败：",
-  "invalidConfigAction": "无效的配置操作值：{{value}}。必须是 'new', 'backup', 'merge', 'docs-only', 或 'skip'",
-  "invalidApiType": "无效的 API 类型值：{{value}}。必须是 'auth_token', 'api_key', 'ccr_proxy', 或 'skip'",
+  "invalidConfigAction": "无效的配置操作值：{value}。必须是 'new', 'backup', 'merge', 'docs-only', 或 'skip'",
+  "invalidApiType": "无效的 API 类型值：{value}。必须是 'auth_token', 'api_key', 'ccr_proxy', 或 'skip'",
   "apiKeyRequiredForApiKey": "当 apiType 为 \"api_key\" 时需要 API key",
   "apiKeyRequiredForAuthToken": "当 apiType 为 \"auth_token\" 时需要 API key",
-  "invalidMcpService": "无效的 MCP 服务：{{service}}。可用的服务：{{validServices}}",
-  "invalidOutputStyle": "无效的输出样式：{{style}}。可用的样式：{{validStyles}}",
-  "invalidDefaultOutputStyle": "无效的默认输出样式：{{style}}。可用的样式：{{validStyles}}",
-  "invalidWorkflow": "无效的工作流：{{workflow}}。可用的工作流：{{validWorkflows}}",
-  "invalidModel": "无效的模型：{{model}}。期望的值：'opus', 'sonnet', 或 'opusplan'",
+  "invalidMcpService": "无效的 MCP 服务：{service}。可用的服务：{validServices}",
+  "invalidOutputStyle": "无效的输出样式：{style}。可用的样式：{validStyles}",
+  "invalidDefaultOutputStyle": "无效的默认输出样式：{style}。可用的样式：{validStyles}",
+  "invalidWorkflow": "无效的工作流：{workflow}。可用的工作流：{validWorkflows}",
+  "invalidModel": "无效的模型：{model}。期望的值：'opus', 'sonnet', 或 'opusplan'",
   "invalidEnvConfig": "无效的环境配置：期望对象类型",
   "invalidBaseUrl": "无效的 ANTHROPIC_BASE_URL：期望字符串类型",
   "invalidApiKeyConfig": "无效的 ANTHROPIC_API_KEY：期望字符串类型",

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,20 +1,24 @@
 {
+  "autoUpdating": "正在自动更新 {tool}...",
   "cannotCheckVersion": "无法检查最新版本",
   "ccrNotInstalled": "CCR 未安装",
-  "ccrUpToDate": "CCR 已是最新版本 (v{{version}})",
+  "ccrUpToDate": "CCR 已是最新版本 (v{version})",
   "checkFailed": "版本检查失败",
   "checkingTools": "检查工具版本",
   "checkingVersion": "检查版本中...",
   "claudeCodeNotInstalled": "Claude Code 未安装",
-  "claudeCodeUpToDate": "Claude Code 已是最新版本 (v{{version}})",
+  "claudeCodeUpToDate": "Claude Code 已是最新版本 (v{version})",
   "cometixLineNotInstalled": "CCometixLine 未安装",
-  "cometixLineUpToDate": "CCometixLine 已是最新版本 (v{{version}})",
-  "confirmUpdate": "将 {{tool}} 更新到最新版本？",
-  "currentVersion": "当前版本: v{{version}}",
+  "cometixLineUpToDate": "CCometixLine 已是最新版本 (v{version})",
+  "confirmUpdate": "将 {tool} 更新到最新版本？",
+  "currentVersion": "当前版本: v{version}",
   "errorCheckingUpdates": "检查更新时出错：",
-  "latestVersion": "最新版本: v{{version}}",
-  "updateFailed": "{{tool}} 更新失败",
+  "failed": "失败",
+  "latestVersion": "最新版本: v{version}",
+  "success": "成功",
+  "updateFailed": "{tool} 更新失败",
   "updateSkipped": "跳过更新",
-  "updateSuccess": "{{tool}} 更新成功！",
-  "updating": "正在更新 {{tool}}..."
+  "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.6",
+  "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",
@@ -71,11 +87,14 @@
     "lint:fix": "eslint --fix",
     "test": "vitest",
     "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage",
+    "test:coverage": "vitest run --coverage",
     "test:run": "vitest run",
     "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",