zcf 3.2.2 → 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>
 
-![Rendering](./src/assets/screenshot-en.webp)
+## ♥️ Sponsor AI API
+
+[![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
 
@@ -211,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
@@ -823,15 +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📱)
+- 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 🎉)
-- 16°C coffee (My best friend🤪, offered ChatGPT Pro $200 package)
+- 初屿贤 (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
 
@@ -839,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-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.2";
+const version = "3.2.3";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const i18n = i18next.createInstance();
@@ -1666,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;
@@ -2867,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)
@@ -3743,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")
       }
     ]);
@@ -4147,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 {
@@ -4544,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) => {
@@ -4617,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) => {
@@ -5613,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();
@@ -2546,8 +2559,8 @@ 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("--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);

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

@@ -19,7 +19,7 @@
   "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/common.json

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

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

@@ -19,7 +19,7 @@
   "invalidAuthTokenConfig": "无效的 ANTHROPIC_AUTH_TOKEN：期望字符串类型",
   "invalidPermissionsConfig": "无效的权限配置：期望对象类型",
   "invalidPermissionsAllow": "无效的 permissions.allow：期望数组类型",
-  "invalidCodeType": "无效的代码类型：\"{value}\"。可用的类型：{validOptions}",
+  "invalidCodeType": "无效的代码类型：\"{value}\"。可用的类型：{validOptions}。使用默认值：{defaultValue}。",
   "generalError": "错误",
   "stackTrace": "堆栈跟踪"
 }

package/package.json

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