zcf 3.2.1 → 3.2.3

package/README.md

@@ -1,5 +1,3 @@
-# ZCF - Zero-Config Code Flow
-
 [![npm version][npm-version-src]][npm-version-href]
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 [![License][license-src]][license-href]
@@ -8,13 +6,26 @@
 [![JSDocs][jsdocs-src]][jsdocs-href]
 [![Ask DeepWiki][deepwiki-src]][deepwiki-href]
 
-[中文](README_zh-CN.md) | **English** | [日本語](README_ja-JP.md) | [Changelog](CHANGELOG.md)
+<div align="center">
+  <img src="./src/assets/banner.webp" alt="Banner"/>
+
+  <h1>
+    ZCF - Zero-Config Code Flow
+  </h1>
+
+  <p align="center">
+  <b>English</b> | <a href="README_zh-CN.md">中文</a> | <a href="README_ja-JP.md">日本語</a> | <a href="CHANGELOG.md">Changelog</a>
 
 **✨ Quick Links**: [Codex Support](#-codex-support-v300-new) | [BMad Workflow](#-bmad-workflow-v27-new-feature) | [Spec Workflow](#-spec-workflow-v2124-new-feature) | [Open Web Search](#-open-web-search-v2129-new-feature) | [CCR Router](#-ccr-claude-code-router-support-v28-enhanced) | [CCometixLine](#-ccometixline-support-status-bar-tool-v299-new) | [Output Styles](#-ai-output-styles-v212-new-feature) | [Multi-Configuration Management](#-multi-configuration-management-v320-new)
 
 > Zero-config, one-click setup for Claude Code & Codex with bilingual support, intelligent agent system and personalized AI assistant
+</p>
+</div>
+
+## ♥️ Sponsor AI API
 
-![Rendering](./src/assets/screenshot-en.webp)
+[![Sponsor AI API](./src/assets/302.ai-en.jpg)](https://share.302.ai/gAT9VG)
+[302.AI](https://share.302.ai/gAT9VG) is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.
 
 ## 🚀 Quick Start
 
@@ -105,6 +116,17 @@ npx zcf i -s -g zh-CN -t api_key -k "sk-xxx" -u "https://xxx.xxx"
 
 # Complete version
 npx zcf i --skip-prompt --all-lang zh-CN --api-type api_key --api-key "sk-xxx" --api-url "https://xxx.xxx"
+
+# Shorthand version (with custom models)
+npx zcf i -s -t api_key -k "sk-xxx" -M "claude-sonnet-4-5" -F "claude-haiku-4-5"
+
+# Complete version (with custom models)
+npx zcf i --skip-prompt \
+  --api-type api_key \
+  --api-key "sk-xxx" \
+  --api-url "https://xxx.xxx" \
+  --api-model "claude-sonnet-4-5" \
+  --api-fast-model "claude-haiku-4-5"
 ```
 
 #### Non-interactive Mode Parameters
@@ -122,6 +144,8 @@ When using `--skip-prompt`, the following parameters are available:
 | `--api-type, -t`             | API configuration type                                   | `auth_token`, `api_key`, `ccr_proxy`, `skip`                                                       | No                                     | `skip`                                                                                                                           |
 | `--api-key, -k`              | API key (for both API key and auth token types)          | string                                                                                             | Required when `api-type` is not `skip` | -                                                                                                                                |
 | `--api-url, -u`              | Custom API URL                                           | URL string                                                                                         | No                                     | official API                                                                                                                     |
+| `--api-model, -M`            | Primary API model                                        | string (e.g., `claude-sonnet-4-5`)                                                                 | No                                     | -                                                                                                                                |
+| `--api-fast-model, -F`       | Fast API model (Claude Code only)                        | string (e.g., `claude-haiku-4-5`)                                                                  | No                                     | -                                                                                                                                |
 | `--mcp-services, -m`         | MCP services to install (multi-select, comma-separated)  | `context7`, `open-websearch`, `spec-workflow`, `mcp-deepwiki`, `Playwright`, `exa`, `serena`, or `skip` for none | No                                     | `all`                                                                                                                            |
 | `--workflows, -w`            | Workflows to install (multi-select, comma-separated)     | `commonTools`, `sixStepsWorkflow`, `featPlanUx`, `gitWorkflow`, `bmadWorkflow`, or `skip` for none | No                                     | `all`                                                                                                                            |
 | `--output-styles, -o`        | Output styles to install (multi-select, comma-separated) | `engineer-professional`, `nekomata-engineer`, `laowang-engineer`, `ojousama-engineer`, or `skip` for none               | No                                     | `all`                                                                                                                            |
@@ -198,6 +222,13 @@ ZCF allows seamless switching between Claude Code and Codex while preserving you
 
 ZCF now supports customizable AI output styles to personalize your Claude Code experience:
 
+<p align="center">
+<a href="https://github.com/Haleclipse">
+<img src="./src/assets/Haleclipse.gif" alt="Halley-chan" width="200"/>
+</a>
+<div align="center">Tsundere <a href="https://github.com/Haleclipse">Halley-chan</a> Ojou-sama (￣▽￣)ゞ</div>
+</p>
+
 **Available Output Styles:**
 
 - `engineer-professional`: Professional software engineer following SOLID, KISS, DRY, YAGNI principles
@@ -810,14 +841,26 @@ If you find this project helpful, please consider sponsoring its development. Yo
 ### Our Sponsors
 
 A huge thank you to all our sponsors for their generous support!
-
+- [302.AI](https://share.302.ai/gAT9VG) (first corporate sponsorship 🤠)
 - Tc (first sponsor)
 - Argolinhas (first ko-fi sponsor ٩(•̤̀ᵕ•̤́๑))
-- r\*r (first anonymous sponsor🤣)
-- \*\*康 (first KFC sponsor🍗)
-- \*东 (first coffee sponsor☕️)
-- 炼\*3 (first Termux user sponsor📱)
-- 16°C coffee (My best friend🤪, offered Claude Code max $200 package)
+- r\*r (first anonymous sponsor 🤣)
+- \*\*康 (first KFC sponsor 🍗)
+- \*东 (first coffee sponsor ☕️)
+- 炼\*3 (first Termux user sponsor 📱)
+- [chamo101](https://github.com/chamo101) (first GitHub issue sponsor 🎉)
+- 初屿贤 (first Codex user sponsor 🙅🏻‍♂️)
+- Protein (first 1688 sponsor 😏)
+- [BeatSeat](https://github.com/BeatSeat) (community expert 😎, provided $1000 Claude credits)
+- [wenwen](https://github.com/wenwen12345) (community expert 🤓, provided daily $100 Claude&GPT credits)
+- 16°C coffee (My best friend 🤪, offered ChatGPT Pro $200 package)
+
+### Promotion Thanks
+
+Thanks to the following authors for promoting this project:
+
+- 逛逛 GitHub, article: https://mp.weixin.qq.com/s/phqwSRb16MKCHHVozTFeiQ
+- Geek, tweet: https://x.com/geekbb/status/1955174718618866076
 
 ## 📄 License
 
@@ -825,6 +868,15 @@ A huge thank you to all our sponsors for their generous support!
 
 ---
 
+## 🚀 Contributors
+
+<a href="https://github.com/UfoMiao/zcf/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=UfoMiao/zcf" />
+</a>
+<br /><br />
+
+## ⭐️ Star History
+
 If this project helps you, please give me a ⭐️ Star!
 
 [![Star History Chart](https://api.star-history.com/svg?repos=UfoMiao/zcf&type=Date)](https://star-history.com/#UfoMiao/zcf&Date)

package/dist/chunks/claude-code-config-manager.mjs

@@ -222,8 +222,9 @@ class ClaudeCodeConfigManager {
           delete settings.env.ANTHROPIC_BASE_URL;
       }
       writeJsonConfig(SETTINGS_FILE, settings);
-      const { setPrimaryApiKey } = await import('./simple-config.mjs').then(function (n) { return n.b1; });
+      const { setPrimaryApiKey, addCompletedOnboarding } = await import('./simple-config.mjs').then(function (n) { return n.b1; });
       setPrimaryApiKey();
+      addCompletedOnboarding();
       if (shouldRestartCcr) {
         const { runCcrRestart } = await import('./commands.mjs');
         await runCcrRestart();

package/dist/chunks/claude-code-incremental-manager.mjs

@@ -131,9 +131,9 @@ ${i18n.t("multi-config:addingNewProfile")}`));
       }
     },
     {
-      type: "password",
+      type: "input",
       name: "apiKey",
-      message: i18n.t("multi-config:apiKeyPrompt") + i18n.t("common:inputHidden"),
+      message: i18n.t("multi-config:apiKeyPrompt"),
       when: (answers2) => answers2.authType !== "ccr_proxy",
       validate: (input) => {
         const trimmed = input.trim();
@@ -288,9 +288,9 @@ ${i18n.t("multi-config:editingProfile", { name: selectedProfile.name })}`));
       }
     },
     {
-      type: "password",
+      type: "input",
       name: "apiKey",
-      message: i18n.t("multi-config:apiKeyPrompt") + i18n.t("common:inputHidden"),
+      message: i18n.t("multi-config:apiKeyPrompt"),
       default: selectedProfile.apiKey,
       when: () => selectedProfile.authType !== "ccr_proxy",
       validate: (input) => {

package/dist/chunks/codex-config-switch.mjs

@@ -91,9 +91,9 @@ async function handleAddProvider() {
       default: "responses"
     },
     {
-      type: "password",
+      type: "input",
       name: "apiKey",
-      message: i18n.t("codex:providerApiKeyPrompt") + i18n.t("common:inputHidden"),
+      message: i18n.t("codex:providerApiKeyPrompt"),
       validate: (input) => !!input.trim() || i18n.t("codex:providerApiKeyRequired")
     }
   ]);
@@ -169,9 +169,9 @@ async function handleEditProvider(providers) {
       default: provider.wireApi
     },
     {
-      type: "password",
+      type: "input",
       name: "apiKey",
-      message: i18n.t("codex:providerApiKeyPrompt") + i18n.t("common:inputHidden"),
+      message: i18n.t("codex:providerApiKeyPrompt"),
       validate: (input) => !!input.trim() || i18n.t("codex:providerApiKeyRequired")
     }
   ]);

package/dist/chunks/simple-config.mjs

@@ -16,7 +16,7 @@ import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
 import i18next from 'i18next';
 import Backend from 'i18next-fs-backend';
 
-const version = "3.2.1";
+const version = "3.2.3";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const i18n = i18next.createInstance();
@@ -503,6 +503,7 @@ function displayBannerWithInfo(subtitle) {
 `));
 }
 
+const WINDOWS_WRAPPED_COMMANDS = ["npx", "uvx", "uv"];
 function getPlatform() {
   const p = platform();
   if (p === "win32")
@@ -571,11 +572,11 @@ function getWSLInfo() {
     version
   };
 }
-function getMcpCommand() {
-  if (isWindows()) {
-    return ["cmd", "/c", "npx"];
+function getMcpCommand(command = "npx") {
+  if (isWindows() && WINDOWS_WRAPPED_COMMANDS.includes(command)) {
+    return ["cmd", "/c", command];
   }
-  return ["npx"];
+  return [command];
 }
 function getSystemRoot() {
   if (!isWindows())
@@ -950,10 +951,12 @@ function mergeMcpServers(existing, newServers) {
   return config;
 }
 function applyPlatformCommand(config) {
-  if (config.command === "npx" && isWindows()) {
-    const mcpCmd = getMcpCommand();
-    config.command = mcpCmd[0];
-    config.args = [...mcpCmd.slice(1), ...config.args || []];
+  if (isWindows() && config.command) {
+    const mcpCmd = getMcpCommand(config.command);
+    if (mcpCmd[0] === "cmd") {
+      config.command = mcpCmd[0];
+      config.args = [...mcpCmd.slice(1), ...config.args || []];
+    }
   }
 }
 function buildMcpServerConfig(baseConfig, apiKey, placeholder = "YOUR_EXA_API_KEY", envVarName) {
@@ -1663,9 +1666,9 @@ async function configureCcrWithPreset(preset) {
   if (preset.requiresApiKey) {
     try {
       const { apiKey } = await inquirer.prompt({
-        type: "password",
+        type: "input",
         name: "apiKey",
-        message: i18n.t("ccr:enterApiKeyForProvider").replace("{provider}", preset.name) + i18n.t("common:inputHidden"),
+        message: i18n.t("ccr:enterApiKeyForProvider").replace("{provider}", preset.name),
         validate: async (value) => !!value || i18n.t("api:keyRequired")
       });
       provider.api_key = apiKey;
@@ -2784,10 +2787,12 @@ async function selectMcpServices() {
 }
 
 function applyCodexPlatformCommand(config) {
-  if (config.command === "npx" && isWindows()) {
-    const mcpCmd = getMcpCommand();
-    config.command = mcpCmd[0];
-    config.args = [...mcpCmd.slice(1), ...config.args || []];
+  if (isWindows() && config.command) {
+    const mcpCmd = getMcpCommand(config.command);
+    if (mcpCmd[0] === "cmd") {
+      config.command = mcpCmd[0];
+      config.args = [...mcpCmd.slice(1), ...config.args || []];
+    }
   }
 }
 
@@ -2862,9 +2867,9 @@ async function configureCodexMcp(options) {
     if (configInfo.requiresApiKey && configInfo.apiKeyEnvVar) {
       const promptMessage = serviceMeta?.apiKeyPrompt || i18n.t("mcp:apiKeyPrompt");
       const { apiKey } = await inquirer.prompt([{
-        type: "password",
+        type: "input",
         name: "apiKey",
-        message: promptMessage + i18n.t("common:inputHidden"),
+        message: promptMessage,
         validate: (input) => !!input || i18n.t("api:keyRequired")
       }]);
       if (!apiKey)
@@ -3579,7 +3584,7 @@ function createApiConfigChoices(providers, currentProvider, isCommented) {
   return choices;
 }
 async function applyCustomApiConfig(customApiConfig) {
-  const { type, token, baseUrl } = customApiConfig;
+  const { type, token, baseUrl, model } = customApiConfig;
   const backupPath = backupCodexComplete();
   if (backupPath) {
     console.log(ansis.gray(getBackupMessage(backupPath)));
@@ -3600,7 +3605,8 @@ async function applyCustomApiConfig(customApiConfig) {
     authEntries[providerId] = token;
   }
   const configData = {
-    model: "claude-3-5-sonnet-20241022",
+    model: model || "claude-3-5-sonnet-20241022",
+    // Use provided model or default
     modelProvider: providerId,
     modelProviderCommented: false,
     providers,
@@ -3737,9 +3743,9 @@ async function configureCodexApi(options) {
         default: (answers2) => existingMap.get(sanitizeProviderName(answers2.providerName))?.wireApi || "responses"
       },
       {
-        type: "password",
+        type: "input",
         name: "apiKey",
-        message: i18n.t("codex:providerApiKeyPrompt") + i18n.t("common:inputHidden"),
+        message: i18n.t("codex:providerApiKeyPrompt"),
         validate: (input) => !!input || i18n.t("codex:providerApiKeyRequired")
       }
     ]);
@@ -4141,12 +4147,16 @@ async function resolveCodeType(codeTypeParam) {
     const validAbbreviations = Object.keys(CODE_TYPE_ABBREVIATIONS);
     const validFullTypes = Object.values(CODE_TYPE_ABBREVIATIONS);
     const validOptions = [...validAbbreviations, ...validFullTypes].join(", ");
+    let defaultValue = DEFAULT_CODE_TOOL_TYPE;
+    try {
+      const config = await readZcfConfigAsync();
+      if (config?.codeToolType && isValidCodeType(config.codeToolType)) {
+        defaultValue = config.codeToolType;
+      }
+    } catch {
+    }
     throw new Error(
-      i18n.t(
-        "errors:invalidCodeType",
-        `Invalid code type: "${codeTypeParam}". Valid options are: ${validOptions}.`,
-        { value: codeTypeParam, validOptions }
-      )
+      i18n.t("errors:invalidCodeType", { value: codeTypeParam, validOptions, defaultValue })
     );
   }
   try {
@@ -4538,9 +4548,9 @@ async function configureApiCompletely(preselectedAuthType) {
     console.log(ansis.yellow(i18n.t("common:cancelled")));
     return null;
   }
-  const keyMessage = authType === "auth_token" ? i18n.t("api:enterAuthToken") + i18n.t("common:inputHidden") : i18n.t("api:enterApiKey") + i18n.t("common:inputHidden");
+  const keyMessage = authType === "auth_token" ? i18n.t("api:enterAuthToken") : i18n.t("api:enterApiKey");
   const { key } = await inquirer.prompt({
-    type: "password",
+    type: "input",
     name: "key",
     message: keyMessage,
     validate: async (value) => {
@@ -4611,9 +4621,9 @@ async function modifyApiConfigPartially(existingConfig) {
     }
   } else if (item === "key") {
     const authType = currentConfig.authType || "auth_token";
-    const keyMessage = authType === "auth_token" ? i18n.t("api:enterNewApiKey").replace("{key}", currentConfig.key ? formatApiKeyDisplay(currentConfig.key) : i18n.t("common:none")) + i18n.t("common:inputHidden") : i18n.t("api:enterNewApiKey").replace("{key}", currentConfig.key ? formatApiKeyDisplay(currentConfig.key) : i18n.t("common:none")) + i18n.t("common:inputHidden");
+    const keyMessage = authType === "auth_token" ? i18n.t("api:enterNewApiKey").replace("{key}", currentConfig.key ? formatApiKeyDisplay(currentConfig.key) : i18n.t("common:none")) : i18n.t("api:enterNewApiKey").replace("{key}", currentConfig.key ? formatApiKeyDisplay(currentConfig.key) : i18n.t("common:none"));
     const { key } = await inquirer.prompt({
-      type: "password",
+      type: "input",
       name: "key",
       message: keyMessage,
       validate: async (value) => {
@@ -5092,6 +5102,16 @@ function validateSkipPromptOptions(options) {
   if (options.apiConfigs && options.apiConfigsFile) {
     throw new Error(i18n.t("multi-config:conflictingParams"));
   }
+  if (options.apiModel && typeof options.apiModel !== "string") {
+    throw new Error(
+      i18n.t("errors:invalidApiModel", { value: options.apiModel })
+    );
+  }
+  if (options.apiFastModel && typeof options.apiFastModel !== "string") {
+    throw new Error(
+      i18n.t("errors:invalidApiFastModel", { value: options.apiFastModel })
+    );
+  }
   if (options.apiType === "api_key" && !options.apiKey) {
     throw new Error(i18n.t("errors:apiKeyRequiredForApiKey"));
   }
@@ -5284,7 +5304,9 @@ async function init(options = {}) {
       const customApiConfig = options.apiType === "api_key" && options.apiKey ? {
         type: "api_key",
         token: options.apiKey,
-        baseUrl: options.apiUrl
+        baseUrl: options.apiUrl,
+        model: options.apiModel
+        // Add model parameter for Codex
       } : void 0;
       let selectedWorkflows;
       if (Array.isArray(options.workflows)) {
@@ -5521,6 +5543,22 @@ async function init(options = {}) {
         console.log(ansis.gray(`  Key: ${formatApiKeyDisplay(configuredApi.key)}`));
       }
     }
+    if ((options.apiModel || options.apiFastModel) && action !== "docs-only" && codeToolType === "claude-code") {
+      if (options.skipPrompt) {
+        const { updateCustomModel } = await Promise.resolve().then(function () { return config$1; });
+        updateCustomModel(
+          options.apiModel || void 0,
+          options.apiFastModel || void 0
+        );
+        console.log(ansis.green(`\u2714 ${i18n.t("api:modelConfigSuccess")}`));
+        if (options.apiModel) {
+          console.log(ansis.gray(`  ${i18n.t("api:primaryModel")}: ${options.apiModel}`));
+        }
+        if (options.apiFastModel) {
+          console.log(ansis.gray(`  ${i18n.t("api:fastModel")}: ${options.apiFastModel}`));
+        }
+      }
+    }
     if (action !== "docs-only") {
       let shouldConfigureMcp = false;
       if (options.skipPrompt) {
@@ -5579,9 +5617,9 @@ async function init(options = {}) {
                 continue;
               } else {
                 const response = await inquirer.prompt({
-                  type: "password",
+                  type: "input",
                   name: "apiKey",
-                  message: service.apiKeyPrompt + i18n.t("common:inputHidden"),
+                  message: service.apiKeyPrompt,
                   validate: (value) => !!value || i18n.t("api:keyRequired")
                 });
                 if (!response.apiKey) {

package/dist/cli.mjs

@@ -328,9 +328,9 @@ async function configureMcpFeature() {
       let config = service.config;
       if (service.requiresApiKey) {
         const { apiKey } = await inquirer.prompt({
-          type: "password",
+          type: "input",
           name: "apiKey",
-          message: service.apiKeyPrompt + i18n.t("common:inputHidden"),
+          message: service.apiKeyPrompt,
           validate: async (value) => !!value || i18n.t("api:keyRequired")
         });
         if (apiKey) {
@@ -2113,8 +2113,21 @@ async function showCodexMenu() {
   }
   return void 0;
 }
-async function showMainMenu() {
+async function showMainMenu(options = {}) {
   try {
+    if (options.codeType) {
+      try {
+        const resolvedType = await resolveCodeType$1(options.codeType);
+        const currentType = getCurrentCodeTool();
+        if (resolvedType !== currentType) {
+          updateZcfConfig({ codeToolType: resolvedType });
+          console.log(ansis.green(`\u2714 ${i18n.t("menu:codeToolSwitched", { tool: getCodeToolLabel(resolvedType) })}`));
+        }
+      } catch (err) {
+        const errorMessage = err instanceof Error ? err.message : String(err);
+        console.error(ansis.yellow(errorMessage));
+      }
+    }
     let exitMenu = false;
     while (!exitMenu) {
       const codeTool = getCurrentCodeTool();
@@ -2482,6 +2495,8 @@ function customizeHelp(sections) {
       `  ${ansis.green("--api-type, -t")} <type>      ${i18n.t("cli:help.optionDescriptions.apiType")} (auth_token, api_key, ccr_proxy, skip)`,
       `  ${ansis.green("--api-key, -k")} <key>       ${i18n.t("cli:help.optionDescriptions.apiKey")}`,
       `  ${ansis.green("--api-url, -u")} <url>       ${i18n.t("cli:help.optionDescriptions.customApiUrl")}`,
+      `  ${ansis.green("--api-model, -M")} <model>   ${i18n.t("cli:help.optionDescriptions.apiModel")} (e.g., claude-sonnet-4-5)`,
+      `  ${ansis.green("--api-fast-model, -F")} <model> ${i18n.t("cli:help.optionDescriptions.apiFastModel")} (e.g., claude-haiku-4-5)`,
       `  ${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")} (${i18n.t("cli:help.defaults.prefix")} backup)`,
@@ -2544,10 +2559,10 @@ async function setupCommands(cli) {
     await initI18n(defaultLang);
   } catch {
   }
-  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").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").action(await withLanguageResolution(async () => {
-    await showMainMenu();
+  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").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").action(await withLanguageResolution(async (options) => {
+    await showMainMenu({ codeType: options.codeType });
   }));
-  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("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").option("--install-cometix-line, -x <value>", `Install CCometixLine statusline tool (true/false), ${i18n.t("cli:help.defaults.prefix")} true`).option("--api-configs <configs>", "API configurations as JSON string for multiple profiles").option("--api-configs-file <file>", "Path to JSON file containing API configurations").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("--api-model, -M <model>", "Primary API model (e.g., claude-sonnet-4-5)").option("--api-fast-model, -F <model>", "Fast API model (e.g., claude-haiku-4-5)").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("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").option("--install-cometix-line, -x <value>", `Install CCometixLine statusline tool (true/false), ${i18n.t("cli:help.defaults.prefix")} true`).option("--api-configs <configs>", "API configurations as JSON string for multiple profiles").option("--api-configs-file <file>", "Path to JSON file containing API configurations").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

@@ -3,6 +3,9 @@
   "apiConfigKey": "Key",
   "apiConfigSuccess": "API configured",
   "apiConfigUrl": "URL",
+  "modelConfigSuccess": "API models configured",
+  "primaryModel": "Primary model",
+  "fastModel": "Fast model",
   "apiKeyDesc": "For API keys from Anthropic Console",
   "apiKeyValidation.example": "Example format: sk-abcdef123456_789xyz",
   "authTokenDesc": "For tokens obtained via OAuth or browser login",

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

@@ -23,6 +23,8 @@
   "help.optionDescriptions.apiType": "API type",
   "help.optionDescriptions.apiKey": "API key (for both types)",
   "help.optionDescriptions.customApiUrl": "Custom API URL",
+  "help.optionDescriptions.apiModel": "Primary API model",
+  "help.optionDescriptions.apiFastModel": "Fast API model",
   "help.optionDescriptions.aiOutputLanguage": "AI output language",
   "help.optionDescriptions.setAllLanguageParams": "Set all language params",
   "help.optionDescriptions.configHandling": "Config handling",

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

@@ -11,7 +11,6 @@
   "goodbye": "👋 Thanks for using ZCF! Goodbye!",
   "returnToMenu": "Return to main menu?",
   "back": "Back",
-  "inputHidden": " (input will be hidden)",
   "operationFailed": "Operation failed",
   "backupCreated": "📁 Configuration backup created: {{path}}",
   "current": "current"

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

@@ -11,13 +11,15 @@
   "invalidDefaultOutputStyle": "Invalid default output style: {style}. Available styles: {validStyles}",
   "invalidWorkflow": "Invalid workflow: {workflow}. Available workflows: {validWorkflows}",
   "invalidModel": "Invalid model: {model}. Expected 'opus', 'sonnet', or 'sonnet[1m]'",
+  "invalidApiModel": "Invalid API model parameter: {value}",
+  "invalidApiFastModel": "Invalid fast model parameter: {value}",
   "invalidEnvConfig": "Invalid env configuration: expected object",
   "invalidBaseUrl": "Invalid ANTHROPIC_BASE_URL: expected string",
   "invalidApiKeyConfig": "Invalid ANTHROPIC_API_KEY: expected string",
   "invalidAuthTokenConfig": "Invalid ANTHROPIC_AUTH_TOKEN: expected string",
   "invalidPermissionsConfig": "Invalid permissions configuration: expected object",
   "invalidPermissionsAllow": "Invalid permissions.allow: expected array",
-  "invalidCodeType": "Invalid code type: \"{value}\". Valid options are: {validOptions}",
+  "invalidCodeType": "Invalid code type: \"{value}\". Valid options are: {validOptions}. Using default: {defaultValue}.",
   "generalError": "Error",
   "stackTrace": "Stack"
 }

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

@@ -3,6 +3,9 @@
   "apiConfigKey": "Key",
   "apiConfigSuccess": "API 配置完成",
   "apiConfigUrl": "URL",
+  "modelConfigSuccess": "API 模型配置完成",
+  "primaryModel": "主模型",
+  "fastModel": "快速模型",
   "apiKeyDesc": "适用于从 Anthropic Console 获取的 API 密钥",
   "apiKeyValidation.example": "示例格式: sk-abcdef123456_789xyz",
   "authTokenDesc": "适用于通过 OAuth 或浏览器登录获取的令牌",

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

@@ -23,6 +23,8 @@
   "help.optionDescriptions.apiType": "API类型",
   "help.optionDescriptions.apiKey": "API密钥（适用于所有类型）",
   "help.optionDescriptions.customApiUrl": "自定义API地址",
+  "help.optionDescriptions.apiModel": "主API模型",
+  "help.optionDescriptions.apiFastModel": "快速API模型",
   "help.optionDescriptions.aiOutputLanguage": "AI输出语言",
   "help.optionDescriptions.setAllLanguageParams": "统一设置所有语言参数",
   "help.optionDescriptions.configHandling": "配置处理",

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

@@ -11,7 +11,6 @@
   "goodbye": "👋 感谢使用 ZCF！再见！",
   "returnToMenu": "返回主菜单？",
   "back": "返回",
-  "inputHidden": "（输入会被隐藏）",
   "operationFailed": "操作失败",
   "backupCreated": "📁 已创建配置备份：{{path}}",
   "current": "当前"

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

@@ -11,13 +11,15 @@
   "invalidDefaultOutputStyle": "无效的默认输出样式：{style}。可用的样式：{validStyles}",
   "invalidWorkflow": "无效的工作流：{workflow}。可用的工作流：{validWorkflows}",
   "invalidModel": "无效的模型：{model}。期望的值：'opus', 'sonnet', 或 'sonnet[1m]'",
+  "invalidApiModel": "无效的 API 模型参数：{value}",
+  "invalidApiFastModel": "无效的快速模型参数：{value}",
   "invalidEnvConfig": "无效的环境配置：期望对象类型",
   "invalidBaseUrl": "无效的 ANTHROPIC_BASE_URL：期望字符串类型",
   "invalidApiKeyConfig": "无效的 ANTHROPIC_API_KEY：期望字符串类型",
   "invalidAuthTokenConfig": "无效的 ANTHROPIC_AUTH_TOKEN：期望字符串类型",
   "invalidPermissionsConfig": "无效的权限配置：期望对象类型",
   "invalidPermissionsAllow": "无效的 permissions.allow：期望数组类型",
-  "invalidCodeType": "无效的代码类型：\"{value}\"。可用的类型：{validOptions}",
+  "invalidCodeType": "无效的代码类型：\"{value}\"。可用的类型：{validOptions}。使用默认值：{defaultValue}。",
   "generalError": "错误",
   "stackTrace": "堆栈跟踪"
 }

package/dist/index.d.mts

@@ -46,6 +46,8 @@ interface InitOptions {
     apiType?: 'auth_token' | 'api_key' | 'ccr_proxy' | 'skip';
     apiKey?: string;
     apiUrl?: string;
+    apiModel?: string;
+    apiFastModel?: string;
     mcpServices?: string[] | string | boolean;
     workflows?: string[] | string | boolean;
     outputStyles?: string[] | string | boolean;

package/dist/index.d.ts

@@ -46,6 +46,8 @@ interface InitOptions {
     apiType?: 'auth_token' | 'api_key' | 'ccr_proxy' | 'skip';
     apiKey?: string;
     apiUrl?: string;
+    apiModel?: string;
+    apiFastModel?: string;
     mcpServices?: string[] | string | boolean;
     workflows?: string[] | string | boolean;
     outputStyles?: string[] | string | boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "3.2.1",
+  "version": "3.2.3",
   "description": "Zero-Config Code Flow - One-click configuration tool for Claude Code",
   "author": {
     "name": "Miao Da",

package/templates/claude-code/common/settings.json

@@ -29,7 +29,8 @@
       "mcp__mcp-deepwiki",
       "mcp__Playwright",
       "mcp__spec-workflow",
-      "mcp__open-websearch"
+      "mcp__open-websearch",
+      "mcp__serena"
     ],
     "deny": []
   },