zcf 3.2.1 → 3.2.2

package/README.md

@@ -105,6 +105,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 +133,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`                                                                                                                            |
@@ -817,7 +830,8 @@ A huge thank you to all our sponsors for their generous support!
 - \*\*康 (first KFC sponsor🍗)
 - \*东 (first coffee sponsor☕️)
 - 炼\*3 (first Termux user sponsor📱)
-- 16°C coffee (My best friend🤪, offered Claude Code max $200 package)
+- [chamo101](https://github.com/chamo101) (first GitHub issue sponsor 🎉)
+- 16°C coffee (My best friend🤪, offered ChatGPT Pro $200 package)
 
 ## 📄 License
 

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/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.2";
 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) {
@@ -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 || []];
+    }
   }
 }
 
@@ -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,
@@ -5092,6 +5098,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 +5300,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 +5539,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) {

package/dist/cli.mjs

@@ -2482,6 +2482,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)`,
@@ -2547,7 +2549,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").option("--code-type, -T <codeType>", "Select code tool type (claude-code, codex, cc, cx)").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), ${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/errors.json

@@ -11,6 +11,8 @@
   "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",

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

@@ -11,6 +11,8 @@
   "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：期望字符串类型",

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.2",
   "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": []
   },