zcf 3.1.2 → 3.1.4

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { a5 as ensureI18nInitialized, a0 as i18n, a8 as readCcrConfig, a9 as isCcrInstalled, aa as installCcr, ab as configureCcrFeature, ac as handleExitPromptError, ad as handleGeneralError, p as SUPPORTED_LANGS, a7 as addNumbersToChoices, q as LANG_LABELS, ae as updateZcfConfig, af as changeLanguage, ag as readZcfConfig, o as openSettingsJson, d as importRecommendedPermissions, b as importRecommendedEnv, T as applyAiLanguageDirective, ah as configureOutputStyle, Q as getExistingModelConfig, N as updateCustomModel, O as updateDefaultModel, ai as isWindows, t as readMcpConfig, y as fixWindowsMcpConfig, w as writeMcpConfig, aj as selectMcpServices, u as backupMcpConfig, ak as getMcpServices, x as buildMcpServerConfig, v as mergeMcpServers, al as setupCcrConfiguration, R as getExistingApiConfig, V as promptApiConfigurationAction, am as modifyApiConfigPartially, an as validateApiKey, K as configureApi, ao as formatApiKeyDisplay, U as switchToOfficialLogin, ap as COMETIX_COMMAND_NAME, aq as COMETIX_COMMANDS, ar as installCometixLine, as as checkAndUpdateTools, at as readJsonConfig, au as writeJsonConfig, j as ZCF_CONFIG_FILE, av as displayBanner, aw as runCodexUpdate, ax as version, ay as resolveAiOutputLanguage, az as updatePromptOnly, aA as selectAndInstallWorkflows, aB as checkClaudeCodeVersionAndPrompt, n as isCodeToolType, D as DEFAULT_CODE_TOOL_TYPE, aC as displayBannerWithInfo, l as CODE_TOOL_BANNERS, aD as runCodexUninstall, aE as configureCodexMcp, aF as configureCodexApi, aG as runCodexWorkflowImport, aH as runCodexFullInit, i as init, aI as listCodexProviders, aJ as getCurrentCodexProvider, aK as switchCodexProvider, a1 as readCodexConfig, aL as switchToOfficialLogin$1, aM as switchToProvider, aN as readZcfConfigAsync, aO as initI18n, aP as selectScriptLanguage } from './chunks/simple-config.mjs';
+import { a5 as ensureI18nInitialized, a0 as i18n, a8 as readCcrConfig, a9 as isCcrInstalled, aa as installCcr, ab as configureCcrFeature, ac as handleExitPromptError, ad as handleGeneralError, p as SUPPORTED_LANGS, a7 as addNumbersToChoices, q as LANG_LABELS, ae as updateZcfConfig, af as changeLanguage, ag as readZcfConfig, o as openSettingsJson, d as importRecommendedPermissions, b as importRecommendedEnv, T as applyAiLanguageDirective, ah as configureOutputStyle, Q as getExistingModelConfig, N as updateCustomModel, O as updateDefaultModel, ai as isWindows, t as readMcpConfig, y as fixWindowsMcpConfig, w as writeMcpConfig, aj as selectMcpServices, u as backupMcpConfig, ak as getMcpServices, x as buildMcpServerConfig, v as mergeMcpServers, al as setupCcrConfiguration, R as getExistingApiConfig, V as promptApiConfigurationAction, am as modifyApiConfigPartially, an as validateApiKey, K as configureApi, ao as formatApiKeyDisplay, U as switchToOfficialLogin, ap as COMETIX_COMMAND_NAME, aq as COMETIX_COMMANDS, ar as installCometixLine, as as checkAndUpdateTools, at as runCodexUpdate, au as resolveCodeType, av as readJsonConfig, aw as writeJsonConfig, j as ZCF_CONFIG_FILE, ax as displayBanner, ay as version, az as resolveAiOutputLanguage, aA as updatePromptOnly, aB as selectAndInstallWorkflows, aC as checkClaudeCodeVersionAndPrompt, n as isCodeToolType, D as DEFAULT_CODE_TOOL_TYPE, aD as displayBannerWithInfo, l as CODE_TOOL_BANNERS, aE as runCodexUninstall, aF as configureCodexMcp, aG as configureCodexApi, aH as runCodexWorkflowImport, aI as runCodexFullInit, i as init, aJ as listCodexProviders, aK as getCurrentCodexProvider, aL as switchCodexProvider, a1 as readCodexConfig, aM as switchToOfficialLogin$1, aN as switchToProvider, aO as readZcfConfigAsync, aP as initI18n, aQ as selectScriptLanguage } from './chunks/simple-config.mjs';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import inquirer from 'inquirer';
@@ -553,7 +553,7 @@ ${ansis.blue(`\u2139 ${i18n.t("configuration:existingLanguageConfig") || "Existi
         return;
       }
     }
-    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aR; });
+    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aS; });
     const aiOutputLang = await selectAiOutputLanguage();
     applyAiLanguageDirective(aiOutputLang);
     updateZcfConfig({ aiOutputLang });
@@ -586,7 +586,7 @@ async function changeScriptLanguageFeature(currentLang) {
 }
 async function configureCodexDefaultModelFeature() {
   ensureI18nInitialized();
-  const { readCodexConfig } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aS; });
+  const { readCodexConfig } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aT; });
   const existingConfig = readCodexConfig();
   const currentModel = existingConfig?.model;
   if (currentModel) {
@@ -691,7 +691,7 @@ ${ansis.blue(`\u2139 ${i18n.t("configuration:existingLanguageConfig") || "Existi
         return;
       }
     }
-    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aR; });
+    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aS; });
     const aiOutputLang = await selectAiOutputLanguage();
     await updateCodexLanguageDirective(aiOutputLang);
     updateZcfConfig({ aiOutputLang });
@@ -699,14 +699,14 @@ ${ansis.blue(`\u2139 ${i18n.t("configuration:existingLanguageConfig") || "Existi
   } else if (option === "systemPrompt") {
     const zcfConfig = readZcfConfig();
     const currentLang = zcfConfig?.aiOutputLang || "English";
-    const { runCodexSystemPromptSelection } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aS; });
+    const { runCodexSystemPromptSelection } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aT; });
     await runCodexSystemPromptSelection();
     await ensureLanguageDirectiveInAgents(currentLang);
     console.log(ansis.green(`\u2714 ${i18n.t("configuration:systemPromptConfigured")}`));
   }
 }
 async function updateCodexModelProvider(modelProvider) {
-  const { readCodexConfig, writeCodexConfig, backupCodexConfig, getBackupMessage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aS; });
+  const { readCodexConfig, writeCodexConfig, backupCodexConfig, getBackupMessage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aT; });
   const backupPath = backupCodexConfig();
   if (backupPath) {
     console.log(ansis.gray(getBackupMessage(backupPath)));
@@ -727,7 +727,7 @@ async function updateCodexModelProvider(modelProvider) {
   writeCodexConfig(updatedConfig);
 }
 async function ensureLanguageDirectiveInAgents(aiOutputLang) {
-  const { readFile, writeFile, exists } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aQ; });
+  const { readFile, writeFile, exists } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aR; });
   const { homedir } = await import('node:os');
   const { join } = await import('pathe');
   const CODEX_AGENTS_FILE = join(homedir(), ".codex", "AGENTS.md");
@@ -745,7 +745,7 @@ async function ensureLanguageDirectiveInAgents(aiOutputLang) {
   const langLabel = languageLabels[aiOutputLang] || aiOutputLang;
   const hasLanguageDirective = /\*\*Most Important:\s*Always respond in [^*]+\*\*/i.test(content);
   if (!hasLanguageDirective) {
-    const { backupCodexAgents, getBackupMessage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aS; });
+    const { backupCodexAgents, getBackupMessage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aT; });
     const backupPath = backupCodexAgents();
     if (backupPath) {
       console.log(ansis.gray(getBackupMessage(backupPath)));
@@ -762,8 +762,8 @@ async function ensureLanguageDirectiveInAgents(aiOutputLang) {
   }
 }
 async function updateCodexLanguageDirective(aiOutputLang) {
-  const { readFile, writeFile, exists } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aQ; });
-  const { backupCodexAgents, getBackupMessage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aS; });
+  const { readFile, writeFile, exists } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aR; });
+  const { backupCodexAgents, getBackupMessage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aT; });
   const { homedir } = await import('node:os');
   const { join } = await import('pathe');
   const CODEX_AGENTS_FILE = join(homedir(), ".codex", "AGENTS.md");
@@ -1042,10 +1042,55 @@ async function runCometixMenuFeature() {
   await showCometixMenu();
 }
 
+class ToolUpdateScheduler {
+  /**
+   * Update tools based on code type
+   * @param codeType - The code tool type to update
+   * @param skipPrompt - Whether to skip interactive prompts
+   */
+  async updateByCodeType(codeType, skipPrompt = false) {
+    await ensureI18nInitialized();
+    switch (codeType) {
+      case "claude-code":
+        await this.updateClaudeCodeTools(skipPrompt);
+        break;
+      case "codex":
+        await this.updateCodexTools(skipPrompt);
+        break;
+      default:
+        throw new Error(`Unsupported code type: ${codeType}`);
+    }
+  }
+  /**
+   * Update Claude Code related tools
+   * @param skipPrompt - Whether to skip interactive prompts
+   */
+  async updateClaudeCodeTools(skipPrompt) {
+    await checkAndUpdateTools(skipPrompt);
+  }
+  /**
+   * Update Codex tools
+   * @param skipPrompt - Whether to skip interactive prompts
+   */
+  async updateCodexTools(skipPrompt) {
+    await runCodexUpdate(false, skipPrompt);
+  }
+}
+
 async function checkUpdates(options = {}) {
   try {
     const skipPrompt = options.skipPrompt || false;
-    await checkAndUpdateTools(skipPrompt);
+    let codeType;
+    try {
+      codeType = await resolveCodeType(options.codeType);
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : String(err);
+      console.error(ansis.red(`${errorMessage}
+Defaulting to "claude-code".`));
+      codeType = "claude-code";
+    }
+    const scheduler = new ToolUpdateScheduler();
+    await scheduler.updateByCodeType(codeType, skipPrompt);
   } catch (error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     console.error(ansis.red(`${i18n.t("updater:errorCheckingUpdates")} ${errorMessage}`));
@@ -1824,13 +1869,15 @@ async function update(options = {}) {
       }
       return;
     }
-    const { resolveTemplateLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aR; });
+    const { resolveTemplateLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.aS; });
     const configLang = await resolveTemplateLanguage(
       options.configLang,
       // Command line option
-      zcfConfig
+      zcfConfig,
+      options.skipPrompt
+      // Non-interactive mode flag
     );
-    const aiOutputLang = await resolveAiOutputLanguage(i18n.language, options.aiOutputLang, zcfConfig);
+    const aiOutputLang = await resolveAiOutputLanguage(i18n.language, options.aiOutputLang, zcfConfig, options.skipPrompt);
     console.log(ansis.cyan(`
 ${i18n.t("configuration:updatingPrompts")}
 `));
@@ -2356,7 +2403,7 @@ function customizeHelp(sections) {
       `  ${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("--code-type, -T")} <type>   ${i18n.t("cli:help.optionDescriptions.codeToolType")} (claude-code, codex)`,
+      `  ${ansis.green("--code-type, -T")} <type>   ${i18n.t("cli:help.optionDescriptions.codeToolType")} (claude-code, codex, cc=claude-code, cx=codex)`,
       `  ${ansis.green("--install-cometix-line, -x")} <value> ${i18n.t("cli:help.optionDescriptions.installStatuslineTool")} (${i18n.t("cli:help.defaults.prefix")} true)`
     ].join("\n")
   });
@@ -2387,6 +2434,14 @@ function customizeHelp(sections) {
       `  ${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.checkClaudeCode")}`),
+      `  ${ansis.cyan("npx zcf check --code-type claude-code")}`,
+      `  ${ansis.cyan("npx zcf check -T cc")}`,
+      "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.checkCodex")}`),
+      `  ${ansis.cyan("npx zcf check --code-type codex")}`,
+      `  ${ansis.cyan("npx zcf check -T cx")}`,
+      "",
       ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.nonInteractiveModeCicd")}`),
       `  ${ansis.cyan('npx zcf i --skip-prompt --api-type api_key --api-key "sk-ant-..."')}`,
       `  ${ansis.cyan('npx zcf i --skip-prompt --all-lang zh-CN --api-type api_key --api-key "key"')}`,
@@ -2403,10 +2458,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)").action(await withLanguageResolution(async () => {
+  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)").option("--install-cometix-line, -x <value>", `Install CCometixLine statusline tool (true/false), ${i18n.t("cli:help.defaults.prefix")} 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("--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`).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) => {
@@ -2427,8 +2482,8 @@ async function setupCommands(cli) {
   cli.command("uninstall", "Remove ZCF configurations and tools").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").option("--mode, -m <mode>", "Uninstall mode (complete/custom/interactive), default: interactive").option("--items, -i <items>", "Comma-separated items for custom uninstall mode").action(await withLanguageResolution(async (options) => {
     await uninstall(options);
   }));
-  cli.command("check-updates", "Check and update Claude Code and CCR to latest versions").alias("check").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").action(await withLanguageResolution(async () => {
-    await checkUpdates();
+  cli.command("check-updates", "Check and update Claude Code and CCR to latest versions").alias("check").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").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)").action(await withLanguageResolution(async (options) => {
+    await checkUpdates(options);
   }));
   cli.help((sections) => customizeHelp(sections));
   cli.version(version);

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

@@ -39,6 +39,8 @@
   "help.exampleDescriptions.runClaudeCodeUsageAnalysis": "Run Claude Code usage analysis",
   "help.exampleDescriptions.uninstallConfigurations": "Uninstall configurations and tools",
   "help.exampleDescriptions.checkAndUpdateTools": "Check and update tools",
+  "help.exampleDescriptions.checkClaudeCode": "Check and update Claude Code tools",
+  "help.exampleDescriptions.checkCodex": "Check and update Codex 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",

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

@@ -17,6 +17,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}",
   "generalError": "Error",
   "stackTrace": "Stack"
 }

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

@@ -39,6 +39,8 @@
   "help.exampleDescriptions.runClaudeCodeUsageAnalysis": "运行 Claude Code 用量分析",
   "help.exampleDescriptions.uninstallConfigurations": "卸载配置和工具",
   "help.exampleDescriptions.checkAndUpdateTools": "检查并更新工具",
+  "help.exampleDescriptions.checkClaudeCode": "检查并更新Claude Code工具",
+  "help.exampleDescriptions.checkCodex": "检查并更新Codex工具",
   "help.exampleDescriptions.nonInteractiveModeCicd": "非交互模式（CI/CD）",
   "banner.subtitle": "Claude Code 一键配置工具",
   "banner.updateSubtitle": "更新 Claude Code 配置",

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

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

package/dist/index.d.mts

@@ -37,7 +37,7 @@ interface InitOptions {
     force?: boolean;
     skipBanner?: boolean;
     skipPrompt?: boolean;
-    codeType?: CodeToolType;
+    codeType?: CodeToolType | string;
     configAction?: 'new' | 'backup' | 'merge' | 'docs-only' | 'skip';
     apiType?: 'auth_token' | 'api_key' | 'ccr_proxy' | 'skip';
     apiKey?: string;

package/dist/index.d.ts

@@ -37,7 +37,7 @@ interface InitOptions {
     force?: boolean;
     skipBanner?: boolean;
     skipPrompt?: boolean;
-    codeType?: CodeToolType;
+    codeType?: CodeToolType | string;
     configAction?: 'new' | 'backup' | 'merge' | 'docs-only' | 'skip';
     apiType?: 'auth_token' | 'api_key' | 'ccr_proxy' | 'skip';
     apiKey?: string;

package/package.json

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

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

@@ -10,17 +10,19 @@
   "permissions": {
     "allow": [
       "Bash",
-      "Read",
-      "Write",
+      "BashOutput",
       "Edit",
-      "MultiEdit",
       "Glob",
       "Grep",
+      "KillShell",
+      "NotebookEdit",
+      "Read",
+      "SlashCommand",
+      "Task",
+      "TodoWrite",
       "WebFetch",
       "WebSearch",
-      "TodoWrite",
-      "NotebookRead",
-      "NotebookEdit",
+      "Write",
       "mcp__ide",
       "mcp__exa",
       "mcp__context7",

package/templates/codex/en/workflow/git/prompts/git-cleanBranches.md

@@ -0,0 +1,102 @@
+---
+description: Safely find and clean up merged or stale Git branches with dry-run mode and custom base/protected branches support
+allowed-tools: Read(**), Exec(git fetch, git config, git branch, git remote, git push, git for-each-ref, git log), Write()
+argument-hint: [--base <branch>] [--stale <days>] [--remote] [--force] [--dry-run] [--yes]
+# examples:
+#   - /git-cleanBranches --dry-run
+#   - /git-cleanBranches --base release/v2.1 --stale 90
+#   - /git-cleanBranches --remote --yes
+---
+
+# Claude Command: Clean Branches
+
+This command **safely** identifies and cleans up **merged** or **stale** Git branches.
+Runs in **read-only preview (`--dry-run`)** mode by default, requiring explicit instructions to perform deletions.
+
+---
+
+## Usage
+
+```bash
+# [Safest] Preview branches to be cleaned without executing any deletions
+/git-cleanBranches --dry-run
+
+# Clean local branches merged to main and inactive for over 90 days (requires individual confirmation)
+/git-cleanBranches --stale 90
+
+# Clean local and remote branches merged to release/v2.1 (auto-confirm)
+/git-cleanBranches --base release/v2.1 --remote --yes
+
+# [Dangerous] Force delete an unmerged local branch
+/git-cleanBranches --force outdated-feature
+```
+
+### Options
+
+- `--base <branch>`: Specify the base branch for cleanup (defaults to repository's `main`/`master`).
+- `--stale <days>`: Clean branches with no commits for specified days (disabled by default).
+- `--remote`: Also clean remote merged/stale branches.
+- `--dry-run`: **Default behavior**. Only list branches to be deleted without executing any operations.
+- `--yes`: Skip individual confirmations and delete all identified branches directly (suitable for CI/CD).
+- `--force`: Use `-D` to force delete local branches (even if unmerged).
+
+---
+
+## What This Command Does
+
+1. **Configuration and Safety Checks**
+   - **Update Information**: Automatically executes `git fetch --all --prune` to ensure branch status is current.
+   - **Read Protected Branches**: Reads the list of branches that should not be cleaned from Git config (see "Configuration" below).
+   - **Determine Base**: Uses `--base` parameter or auto-detected `main`/`master` as comparison baseline.
+
+2. **Analysis and Identification (Find)**
+   - **Merged Branches**: Find local (and remote if `--remote` is added) branches fully merged to `--base`.
+   - **Stale Branches**: If `--stale <days>` is specified, find branches with last commit N days ago.
+   - **Exclude Protected Branches**: Remove all configured protected branches from cleanup list.
+
+3. **Report and Preview (Report)**
+   - Clearly list "merged branches to be deleted" and "stale branches to be deleted".
+   - Without `--yes` parameter, **command ends here**, waiting for user confirmation to re-execute (without `--dry-run`).
+
+4. **Execute Cleanup (Execute)**
+   - **Only executed without `--dry-run` and after user confirmation** (or with `--yes`).
+   - Delete identified branches one by one, unless user chooses to skip in interactive confirmation.
+   - Local: `git branch -d <branch>`; Remote: `git push origin --delete <branch>`.
+   - If `--force` is specified, local deletion uses `git branch -D <branch>`.
+
+---
+
+## Configuration (Configure Once, Use Forever)
+
+To prevent accidental deletion of important branches (e.g., `develop`, `release/*`), add protection rules to the repository's Git config. The command reads them automatically.
+
+```bash
+# Protect develop branch
+git config --add branch.cleanup.protected develop
+
+# Protect all branches starting with release/ (wildcard)
+git config --add branch.cleanup.protected 'release/*'
+
+# View all configured protected branches
+git config --get-all branch.cleanup.protected
+```
+
+---
+
+## Best Practices for Embedded Devs
+
+- **Prioritize `--dry-run`**: Develop the habit of previewing before executing.
+- **Leverage `--base`**: When maintaining long-term `release` branches, use it to clean `feature` or `hotfix` branches merged to that release.
+- **Careful with `--force`**: Don't force delete unless you're 100% certain an unmerged branch is useless.
+- **Team Collaboration**: Notify the team channel before cleaning shared remote branches.
+- **Regular Runs**: Run monthly or quarterly to keep the repository clean.
+
+---
+
+## Why This Version Is Better
+
+- ✅ **Safer**: Default read-only preview with configurable protected branch list.
+- ✅ **More Flexible**: Supports custom base branches, perfectly fits `release` / `develop` workflows.
+- ✅ **More Compatible**: Avoids commands with inconsistent behavior across systems like `date -d`.
+- ✅ **More Intuitive**: Condenses complex 16-step checklist into a single command with safety options.
+- ✅ **Consistent Style**: Shares similar parameter design and documentation structure with `/commit` command.

package/templates/codex/en/workflow/git/prompts/git-commit.md

@@ -0,0 +1,157 @@
+---
+description: Analyze changes with Git only and auto-generate conventional commit messages with optional emoji; suggests splitting commits when needed, runs local Git hooks by default (use --no-verify to skip)
+allowed-tools: Read(**), Exec(git status, git diff, git add, git restore --staged, git commit, git rev-parse, git config), Write(.git/COMMIT_EDITMSG)
+argument-hint: [--no-verify] [--all] [--amend] [--signoff] [--emoji] [--scope <scope>] [--type <type>]
+# examples:
+#   - /git-commit                           # Analyze current changes, generate commit message
+#   - /git-commit --all                     # Stage all changes and commit
+#   - /git-commit --no-verify               # Skip Git hooks
+#   - /git-commit --emoji                   # Include emoji in commit message
+#   - /git-commit --scope ui --type feat    # Specify scope and type
+#   - /git-commit --amend --signoff         # Amend last commit with signature
+---
+
+# Claude Command: Commit (Git-only)
+
+This command works **without any package manager/build tools**, using only **Git** to:
+
+- Read changes (staged/unstaged)
+- Determine if changes should be **split into multiple commits**
+- Generate **Conventional Commits** style messages with optional emoji for each commit
+- Execute `git add` and `git commit` as needed (runs local Git hooks by default; use `--no-verify` to skip)
+
+---
+
+## Usage
+
+```bash
+/git-commit
+/git-commit --no-verify
+/git-commit --emoji
+/git-commit --all --signoff
+/git-commit --amend
+/git-commit --scope ui --type feat --emoji
+```
+
+### Options
+
+- `--no-verify`: Skip local Git hooks (`pre-commit`/`commit-msg` etc.).
+- `--all`: When staging area is empty, automatically `git add -A` to include all changes in the commit.
+- `--amend`: **Amend** the last commit without creating a new one (preserves author and timestamp unless local Git config specifies otherwise).
+- `--signoff`: Add `Signed-off-by` line (use when following DCO process).
+- `--emoji`: Include emoji prefix in commit message (omit for plain text).
+- `--scope <scope>`: Specify commit scope (e.g., `ui`, `docs`, `api`), written to message header.
+- `--type <type>`: Force commit type (e.g., `feat`, `fix`, `docs`), overrides automatic detection.
+
+> Note: If the framework doesn't support interactive confirmation, enable `confirm: true` in front-matter to avoid mistakes.
+
+---
+
+## What This Command Does
+
+1. **Repository/Branch Validation**
+   - Check if in a Git repository using `git rev-parse --is-inside-work-tree`.
+   - Read current branch/HEAD status; if in rebase/merge conflict state, prompt to resolve conflicts first.
+
+2. **Change Detection**
+   - Get staged and unstaged changes using `git status --porcelain` and `git diff`.
+   - If staged files = 0:
+     - If `--all` is passed → Execute `git add -A`.
+     - Otherwise prompt choice: continue analyzing unstaged changes for **suggestions**, or cancel to manually group staging.
+
+3. **Split Suggestions (Split Heuristics)**
+   - Cluster by **concerns**, **file modes**, **change types** (e.g., source code vs docs/tests; different directories/packages; additions vs deletions).
+   - If **multiple independent changesets** or large diff detected (e.g., > 300 lines / across multiple top-level directories), suggest splitting commits with pathspecs for each group (for subsequent `git add <paths>`).
+
+4. **Commit Message Generation (Conventional with Optional Emoji)**
+   - Auto-infer `type` (`feat`/`fix`/`docs`/`refactor`/`test`/`chore`/`perf`/`style`/`ci`/`revert`...) and optional `scope`.
+   - Generate message header: `[<emoji>] <type>(<scope>)?: <subject>` (first line ≤ 72 chars, imperative mood, emoji included only with `--emoji` flag).
+   - Generate message body: bullet points (motivation, implementation details, impact scope, BREAKING CHANGE if any).
+   - Write draft to `.git/COMMIT_EDITMSG` for use with `git commit`.
+
+5. **Execute Commit**
+   - Single commit scenario: `git commit [-S] [--no-verify] [-s] -F .git/COMMIT_EDITMSG`
+   - Multiple commit scenario (if split accepted): Provide clear instructions for `git add <paths> && git commit ...` per group; execute sequentially if allowed.
+
+6. **Safe Rollback**
+   - If mistakenly staged, use `git restore --staged <paths>` to unstage (command provides instructions, doesn't modify file contents).
+
+---
+
+## Best Practices for Commits
+
+- **Atomic commits**: One commit does one thing, easier to trace and review.
+- **Group before committing**: Split by directory/module/feature.
+- **Clear subject**: First line ≤ 72 chars, imperative mood (e.g., "add... / fix...").
+- **Body with context**: Explain motivation, solution, impact scope, risks, and next steps.
+- **Follow Conventional Commits**: `<type>(<scope>): <subject>`.
+
+---
+
+## Type to Emoji Mapping (When --emoji is Used)
+
+- ✨ `feat`: New feature
+- 🐛 `fix`: Bug fix (includes 🔥 remove code/files, 🚑️ hotfix, 👽️ adapt to external API changes, 🔒️ security fix, 🚨 fix warnings, 💚 fix CI)
+- 📝 `docs`: Documentation and comments
+- 🎨 `style`: Code style/formatting (no semantic changes)
+- ♻️ `refactor`: Refactoring (no new features, no bug fixes)
+- ⚡️ `perf`: Performance improvements
+- ✅ `test`: Add/fix tests, snapshots
+- 🔧 `chore`: Build/tools/misc tasks (merge branches, update configs, release tags, pin dependencies, .gitignore, etc.)
+- 👷 `ci`: CI/CD configuration and scripts
+- ⏪️ `revert`: Revert commits
+- 💥 `feat`: Breaking changes (explained in `BREAKING CHANGE:` section)
+
+> If `--type`/`--scope` is passed, it will **override** auto-detection.
+> Emoji is only included when `--emoji` flag is specified.
+
+---
+
+## Guidelines for Splitting Commits
+
+1. **Different concerns**: Unrelated feature/module changes should be split.
+2. **Different types**: Don't mix `feat`, `fix`, `refactor` in the same commit.
+3. **File modes**: Source code vs docs/tests/configs should be grouped separately.
+4. **Size threshold**: Large diffs (e.g., >300 lines or across multiple top-level directories) should be split.
+5. **Revertability**: Ensure each commit can be independently reverted.
+
+---
+
+## Examples
+
+**Good (with --emoji)**
+
+- ✨ feat(ui): add user authentication flow
+- 🐛 fix(api): handle token refresh race condition
+- 📝 docs: update API usage examples
+- ♻️ refactor(core): extract retry logic into helper
+- ✅ test: add unit tests for rate limiter
+- 🔧 chore: update git hooks and repository settings
+- ⏪️ revert: revert "feat(core): introduce streaming API"
+
+**Good (without --emoji)**
+
+- feat(ui): add user authentication flow
+- fix(api): handle token refresh race condition
+- docs: update API usage examples
+- refactor(core): extract retry logic into helper
+- test: add unit tests for rate limiter
+- chore: update git hooks and repository settings
+- revert: revert "feat(core): introduce streaming API"
+
+**Split Example**
+
+- `feat(types): add new type defs for payment method`
+- `docs: update API docs for new types`
+- `test: add unit tests for payment types`
+- `fix: address linter warnings in new files` ← (if your repo has hook errors)
+
+---
+
+## Important Notes
+
+- **Git only**: No package manager/build commands (`pnpm`/`npm`/`yarn` etc.).
+- **Respects hooks**: Executes local Git hooks by default; use `--no-verify` to skip.
+- **No source code changes**: Command only reads/writes `.git/COMMIT_EDITMSG` and staging area; doesn't directly edit working directory files.
+- **Safety prompts**: In rebase/merge conflicts, detached HEAD states, prompts to handle/confirm before continuing.
+- **Auditable and controllable**: If `confirm: true` is enabled, each actual `git add`/`git commit` step requires confirmation.