zcf 2.6.1 → 2.7.1

package/README.md

@@ -6,7 +6,7 @@
 [![codecov](https://codecov.io/gh/UfoMiao/zcf/graph/badge.svg?token=HZI6K4Y7D7)](https://codecov.io/gh/UfoMiao/zcf)
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/UfoMiao/zcf)
 
-[中文](README_zh-CN.md) | **English**
+[中文](README_zh-CN.md) | **English** | [Changelog](CHANGELOG.md)
 
 > Zero-config, one-click setup for Claude Code with bilingual support, intelligent agent system and personalized AI assistant
 
@@ -48,6 +48,7 @@ npx zcf → select 2  # Execute workflow update via menu
 #### 🎯 BMad Workflow (New Feature)
 
 BMad (Business-Minded Agile Development) is an enterprise-grade workflow system that provides:
+
 - Complete team of specialized AI agents (PO, PM, Architect, Dev, QA, etc.)
 - Structured development process with quality gates
 - Automatic documentation generation
@@ -245,6 +246,7 @@ Enter your choice: _
 | `zcf`        | -       | Show interactive menu (v2.0 default command) |
 | `zcf init`   | `zcf i` | Initialize Claude Code configuration         |
 | `zcf update` | `zcf u` | Update workflow-related md files with backup |
+| `zcf ccu`    | -       | Run Claude Code usage analysis tool         |
 
 #### Common Options
 
@@ -291,6 +293,9 @@ npx zcf i -c zh-CN -f      # Using short options
 # Update to English prompts (lower token consumption)
 npx zcf u --config-lang en
 npx zcf u -c en            # Using short option
+
+# Run Claude Code usage analysis tool (powered by ccusage)
+npx zcf ccu               # Daily usage (default), or use: monthly, session, blocks
 ```
 
 ## 📁 Project Structure

package/dist/cli.mjs

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { I as I18N, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, j as LANG_LABELS, H as updateZcfConfig, o as openSettingsJson, b as importRecommendedPermissions, a as importRecommendedEnv, J as readZcfConfig, K as resolveAiOutputLanguage, w as applyAiLanguageDirective, N as configureAiPersonality, u as updateDefaultModel, O as isWindows, y as readMcpConfig, F as fixWindowsMcpConfig, z as writeMcpConfig, P as selectMcpServices, B as backupMcpConfig, M as MCP_SERVICES, E as buildMcpServerConfig, D as mergeMcpServers, v as getExistingApiConfig, Q as formatApiKeyDisplay, R as modifyApiConfigPartially, T as validateApiKey, r as configureApi, U as displayBanner, V as selectScriptLanguage, W as updatePromptOnly, X as selectAndInstallWorkflows, Y as version, _ as handleExitPromptError, $ as handleGeneralError, a0 as displayBannerWithInfo, a1 as readZcfConfigAsync, i as init } from './shared/zcf.BjaE63-h.mjs';
+import { I as I18N, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, j as LANG_LABELS, H as updateZcfConfig, o as openSettingsJson, b as importRecommendedPermissions, a as importRecommendedEnv, J as readZcfConfig, K as resolveAiOutputLanguage, w as applyAiLanguageDirective, N as configureAiPersonality, u as updateDefaultModel, O as isWindows, y as readMcpConfig, F as fixWindowsMcpConfig, z as writeMcpConfig, P as selectMcpServices, B as backupMcpConfig, M as MCP_SERVICES, E as buildMcpServerConfig, D as mergeMcpServers, v as getExistingApiConfig, Q as formatApiKeyDisplay, R as modifyApiConfigPartially, T as validateApiKey, r as configureApi, U as readZcfConfigAsync, V as displayBanner, W as selectScriptLanguage, X as updatePromptOnly, Y as selectAndInstallWorkflows, _ as version, $ as handleExitPromptError, a0 as handleGeneralError, a1 as displayBannerWithInfo, i as init } from './shared/zcf.CZ3RjfyP.mjs';
 import inquirer from 'inquirer';
 import { existsSync, unlinkSync } from 'node:fs';
+import { x } from 'tinyexec';
 import 'pathe';
 import 'dayjs';
 import 'node:url';
-import 'tinyexec';
 import 'node:fs/promises';
 import 'node:os';
 
@@ -295,6 +295,106 @@ async function configureEnvPermissionFeature(scriptLang) {
   }
 }
 
+async function executeCcusage(args = []) {
+  try {
+    const zcfConfig = await readZcfConfigAsync();
+    const rawLang = zcfConfig?.preferredLang || "en";
+    const lang = getValidLanguage(rawLang);
+    const i18n = I18N[lang];
+    const command = "npx";
+    const commandArgs = ["ccusage@latest", ...args];
+    console.log(ansis.cyan(i18n.runningCcusage));
+    console.log(ansis.gray(`$ npx ccusage@latest ${args.join(" ")}`));
+    console.log("");
+    await x(command, commandArgs, {
+      nodeOptions: {
+        stdio: "inherit"
+      }
+    });
+  } catch (error) {
+    const zcfConfig = await readZcfConfigAsync();
+    const rawLang = zcfConfig?.preferredLang || "en";
+    const lang = getValidLanguage(rawLang);
+    const i18n = I18N[lang];
+    console.error(ansis.red(i18n.ccusageFailed));
+    console.error(ansis.yellow(i18n.checkNetworkConnection));
+    if (process.env.DEBUG) {
+      console.error(ansis.gray(i18n.errorDetails), error);
+    }
+    if (process.env.NODE_ENV !== "test") {
+      process.exit(1);
+    }
+    throw error;
+  }
+}
+
+function getValidLanguage(lang) {
+  return lang && lang in I18N ? lang : "en";
+}
+async function runCcusageFeature(scriptLang) {
+  const validLang = getValidLanguage(scriptLang);
+  const i18n = I18N[validLang];
+  console.log("");
+  console.log(ansis.cyan(i18n.menuOptions.ccusage));
+  console.log(ansis.gray(`${i18n.ccusageDescription} - https://github.com/ryoppippi/ccusage`));
+  console.log("");
+  const choices = [
+    { name: i18n.ccusageModes.daily, value: "daily" },
+    { name: i18n.ccusageModes.monthly, value: "monthly" },
+    { name: i18n.ccusageModes.session, value: "session" },
+    { name: i18n.ccusageModes.blocks, value: "blocks" },
+    { name: i18n.ccusageModes.custom, value: "custom" },
+    { name: i18n.back, value: "back" }
+  ];
+  const { mode } = await inquirer.prompt({
+    type: "list",
+    name: "mode",
+    message: i18n.selectAnalysisMode,
+    choices
+  });
+  if (mode === "back") {
+    return;
+  }
+  let args = [];
+  if (mode === "custom") {
+    const { customArgs } = await inquirer.prompt({
+      type: "input",
+      name: "customArgs",
+      message: i18n.enterCustomArgs,
+      default: ""
+    });
+    if (customArgs === null || customArgs === void 0 || customArgs === "") {
+      args = [];
+    } else {
+      const argsString = String(customArgs).trim();
+      if (!argsString) {
+        args = [];
+      } else {
+        const argPattern = /"([^"]*)"|'([^']*)'|([^\s]+)/g;
+        const matches = [];
+        let match;
+        while ((match = argPattern.exec(argsString)) !== null) {
+          const value = match[1] || match[2] || match[3];
+          if (value) {
+            matches.push(value);
+          }
+        }
+        args = matches;
+      }
+    }
+  } else {
+    args = [mode];
+  }
+  console.log("");
+  await executeCcusage(args);
+  console.log("");
+  await inquirer.prompt({
+    type: "input",
+    name: "continue",
+    message: ansis.gray(i18n.pressEnterToContinue)
+  });
+}
+
 async function update(options = {}) {
   try {
     if (!options.skipBanner) {
@@ -382,6 +482,11 @@ async function showMainMenu() {
         )}`
       );
       console.log("");
+      console.log(`  --------- ${i18n.menuSections.otherTools} ----------`);
+      console.log(
+        `  ${ansis.cyan("U.")} ${i18n.menuOptions.ccusage} ${ansis.gray("- " + i18n.menuDescriptions.ccusage)}`
+      );
+      console.log("");
       console.log("  ------------ ZCF ------------");
       console.log(
         `  ${ansis.cyan("0.")} ${i18n.menuOptions.changeLanguage} ${ansis.gray(
@@ -391,14 +496,14 @@ async function showMainMenu() {
       console.log(
         `  ${ansis.cyan("-.")} ${i18n.menuOptions.clearCache} ${ansis.gray("- " + i18n.menuDescriptions.clearCache)}`
       );
-      console.log(`  ${ansis.red("q.")} ${ansis.red(i18n.menuOptions.exit)}`);
+      console.log(`  ${ansis.red("Q.")} ${ansis.red(i18n.menuOptions.exit)}`);
       console.log("");
       const { choice } = await inquirer.prompt({
         type: "input",
         name: "choice",
-        message: i18n.enterChoice || "Enter your choice",
+        message: i18n.enterChoice,
         validate: (value) => {
-          const valid = ["1", "2", "3", "4", "5", "6", "7", "0", "-", "q", "Q"];
+          const valid = ["1", "2", "3", "4", "5", "6", "7", "u", "U", "0", "-", "q", "Q"];
           return valid.includes(value) || i18n.invalidChoice;
         }
       });
@@ -429,6 +534,10 @@ async function showMainMenu() {
         case "7":
           await configureEnvPermissionFeature(scriptLang);
           break;
+        case "u":
+        case "U":
+          await runCcusageFeature(scriptLang);
+          break;
         case "0":
           const newLang = await changeScriptLanguageFeature(scriptLang);
           if (newLang !== scriptLang) {
@@ -444,7 +553,7 @@ async function showMainMenu() {
           break;
       }
       if (!exitMenu && choice.toLowerCase() !== "q") {
-        if (choice === "0" || choice === "-") {
+        if (choice === "0" || choice === "-" || choice.toLowerCase() === "u") {
           console.log("\n" + ansis.dim("\u2500".repeat(50)) + "\n");
           continue;
         }
@@ -478,6 +587,9 @@ function setupCommands(cli) {
   cli.command("update", "Update Claude Code prompts only").alias("u").option("--config-lang, -c <lang>", "Configuration language (zh-CN, en)").action(async (options) => {
     await handleUpdateCommand(options);
   });
+  cli.command("ccu [...args]", "Run Claude Code usage analysis tool").allowUnknownOptions().action(async (args) => {
+    await executeCcusage(args);
+  });
   cli.help((sections) => customizeHelp(sections));
   cli.version(version);
 }
@@ -516,6 +628,7 @@ function customizeHelp(sections) {
         "i"
       )}     Initialize Claude Code configuration / \u521D\u59CB\u5316 Claude Code \u914D\u7F6E`,
       `  ${ansis.cyan("zcf update")} | ${ansis.cyan("u")}   Update workflow-related md files / \u4EC5\u66F4\u65B0\u5DE5\u4F5C\u6D41\u76F8\u5173md`,
+      `  ${ansis.cyan("zcf ccu")} [args]   Run Claude Code usage analysis / \u8FD0\u884C Claude Code \u7528\u91CF\u5206\u6790`,
       "",
       ansis.gray("  Shortcuts / \u5FEB\u6377\u65B9\u5F0F:"),
       `  ${ansis.cyan("zcf i")}            Quick init / \u5FEB\u901F\u521D\u59CB\u5316`,
@@ -546,6 +659,10 @@ function customizeHelp(sections) {
       ansis.gray("  # Update workflow-related md files only / \u4EC5\u66F4\u65B0\u5DE5\u4F5C\u6D41\u76F8\u5173md\u6587\u4EF6"),
       `  ${ansis.cyan("npx zcf u")}`,
       "",
+      ansis.gray("  # Run Claude Code usage analysis / \u8FD0\u884C Claude Code \u7528\u91CF\u5206\u6790"),
+      `  ${ansis.cyan("npx zcf ccu")}               ${ansis.gray("# Daily usage (default)")}`,
+      `  ${ansis.cyan("npx zcf ccu monthly --json")}`,
+      "",
       ansis.gray("  # Force overwrite with Chinese config / \u5F3A\u5236\u4F7F\u7528\u4E2D\u6587\u914D\u7F6E\u8986\u76D6"),
       `  ${ansis.cyan("npx zcf --init -c zh-CN -f")}`,
       `  ${ansis.cyan("npx zcf --init --config-lang zh-CN --force")}`

package/dist/index.d.mts

@@ -12,6 +12,9 @@ interface TranslationKeys {
     spaceToSelectReturn: string;
     enterChoice: string;
     invalidChoice: string;
+    goodbye: string;
+    returnToMenu: string;
+    back: string;
     selectScriptLang: string;
     selectConfigLang: string;
     selectAiOutputLang: string;
@@ -95,8 +98,9 @@ interface TranslationKeys {
     selectMcpOption: string;
     windowsDetected: string;
     selectFunction: string;
-    returnToMenu: string;
-    goodbye: string;
+    menuSections: {
+        otherTools: string;
+    };
     menuOptions: {
         fullInit: string;
         importWorkflow: string;
@@ -105,6 +109,7 @@ interface TranslationKeys {
         configureModel: string;
         configureAiMemory: string;
         configureEnvPermission: string;
+        ccusage: string;
         installBmad: string;
         clearCache: string;
         changeLanguage: string;
@@ -118,6 +123,7 @@ interface TranslationKeys {
         configureModel: string;
         configureAiMemory: string;
         configureEnvPermission: string;
+        ccusage: string;
         installBmad: string;
         clearCache: string;
         changeLanguage: string;
@@ -141,6 +147,21 @@ interface TranslationKeys {
     confirmClearCache: string;
     cacheCleared: string;
     noCacheFound: string;
+    runningCcusage: string;
+    ccusageDescription: string;
+    selectAnalysisMode: string;
+    ccusageModes: {
+        daily: string;
+        monthly: string;
+        session: string;
+        blocks: string;
+        custom: string;
+    };
+    enterCustomArgs: string;
+    pressEnterToContinue: string;
+    ccusageFailed: string;
+    checkNetworkConnection: string;
+    errorDetails: string;
     selectEnvPermissionOption: string;
     importRecommendedEnv: string;
     importRecommendedEnvDesc: string;

package/dist/index.d.ts

@@ -12,6 +12,9 @@ interface TranslationKeys {
     spaceToSelectReturn: string;
     enterChoice: string;
     invalidChoice: string;
+    goodbye: string;
+    returnToMenu: string;
+    back: string;
     selectScriptLang: string;
     selectConfigLang: string;
     selectAiOutputLang: string;
@@ -95,8 +98,9 @@ interface TranslationKeys {
     selectMcpOption: string;
     windowsDetected: string;
     selectFunction: string;
-    returnToMenu: string;
-    goodbye: string;
+    menuSections: {
+        otherTools: string;
+    };
     menuOptions: {
         fullInit: string;
         importWorkflow: string;
@@ -105,6 +109,7 @@ interface TranslationKeys {
         configureModel: string;
         configureAiMemory: string;
         configureEnvPermission: string;
+        ccusage: string;
         installBmad: string;
         clearCache: string;
         changeLanguage: string;
@@ -118,6 +123,7 @@ interface TranslationKeys {
         configureModel: string;
         configureAiMemory: string;
         configureEnvPermission: string;
+        ccusage: string;
         installBmad: string;
         clearCache: string;
         changeLanguage: string;
@@ -141,6 +147,21 @@ interface TranslationKeys {
     confirmClearCache: string;
     cacheCleared: string;
     noCacheFound: string;
+    runningCcusage: string;
+    ccusageDescription: string;
+    selectAnalysisMode: string;
+    ccusageModes: {
+        daily: string;
+        monthly: string;
+        session: string;
+        blocks: string;
+        custom: string;
+    };
+    enterCustomArgs: string;
+    pressEnterToContinue: string;
+    ccusageFailed: string;
+    checkNetworkConnection: string;
+    errorDetails: string;
     selectEnvPermissionOption: string;
     importRecommendedEnv: string;
     importRecommendedEnvDesc: string;

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, j as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILE, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, G as addCompletedOnboarding, w as applyAiLanguageDirective, p as backupExistingConfig, B as backupMcpConfig, E as buildMcpServerConfig, d as cleanupPermissions, c as commandExists, r as configureApi, q as copyConfigFiles, n as ensureClaudeDir, F as fixWindowsMcpConfig, v as getExistingApiConfig, x as getMcpConfigPath, g as getPlatform, a as importRecommendedEnv, b as importRecommendedPermissions, i as init, l as installClaudeCode, k as isClaudeCodeInstalled, m as mergeAndCleanPermissions, s as mergeConfigs, D as mergeMcpServers, t as mergeSettingsFile, o as openSettingsJson, y as readMcpConfig, u as updateDefaultModel, z as writeMcpConfig } from './shared/zcf.BjaE63-h.mjs';
+export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, e as CLAUDE_MD_FILE, f as ClAUDE_CONFIG_FILE, I as I18N, j as LANG_LABELS, L as LEGACY_ZCF_CONFIG_FILE, M as MCP_SERVICES, S as SETTINGS_FILE, h as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, G as addCompletedOnboarding, w as applyAiLanguageDirective, p as backupExistingConfig, B as backupMcpConfig, E as buildMcpServerConfig, d as cleanupPermissions, c as commandExists, r as configureApi, q as copyConfigFiles, n as ensureClaudeDir, F as fixWindowsMcpConfig, v as getExistingApiConfig, x as getMcpConfigPath, g as getPlatform, a as importRecommendedEnv, b as importRecommendedPermissions, i as init, l as installClaudeCode, k as isClaudeCodeInstalled, m as mergeAndCleanPermissions, s as mergeConfigs, D as mergeMcpServers, t as mergeSettingsFile, o as openSettingsJson, y as readMcpConfig, u as updateDefaultModel, z as writeMcpConfig } from './shared/zcf.CZ3RjfyP.mjs';
 import 'inquirer';
 import 'ansis';
 import 'node:fs';

package/dist/shared/{zcf.BjaE63-h.mjs → zcf.CZ3RjfyP.mjs}

@@ -8,7 +8,7 @@ import { exec } from 'tinyexec';
 import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
 import { homedir, platform } from 'node:os';
 
-const version = "2.6.1";
+const version = "2.7.1";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const common$1 = {
@@ -23,10 +23,11 @@ const common$1 = {
   none: "\u65E0",
   notConfigured: "\u672A\u914D\u7F6E",
   spaceToSelectReturn: "- \u7A7A\u683C\u9009\u62E9\uFF0C\u56DE\u8F66\u63D0\u4EA4",
-  enterChoice: "\u8BF7\u8F93\u5165\u9009\u9879\uFF0C\u56DE\u8F66\u786E\u8BA4",
+  enterChoice: "\u8BF7\u8F93\u5165\u9009\u9879\uFF0C\u56DE\u8F66\u786E\u8BA4\uFF08\u4E0D\u533A\u5206\u5927\u5C0F\u5199\uFF09",
   invalidChoice: "\u65E0\u6548\u9009\u62E9\u3002\u8BF7\u8F93\u5165\u6709\u6548\u9009\u9879\u3002",
   goodbye: "\u{1F44B} \u611F\u8C22\u4F7F\u7528 ZCF\uFF01\u518D\u89C1\uFF01",
-  returnToMenu: "\u8FD4\u56DE\u4E3B\u83DC\u5355\uFF1F"
+  returnToMenu: "\u8FD4\u56DE\u4E3B\u83DC\u5355\uFF1F",
+  back: "\u8FD4\u56DE"
 };
 
 const language$1 = {
@@ -167,6 +168,9 @@ const mcp$1 = {
 
 const menu$1 = {
   selectFunction: "\u8BF7\u9009\u62E9\u529F\u80FD",
+  menuSections: {
+    otherTools: "\u5176\u4ED6\u5DE5\u5177"
+  },
   menuOptions: {
     fullInit: "\u5B8C\u6574\u521D\u59CB\u5316",
     importWorkflow: "\u5BFC\u5165\u5DE5\u4F5C\u6D41",
@@ -175,6 +179,7 @@ const menu$1 = {
     configureModel: "\u914D\u7F6E\u9ED8\u8BA4\u6A21\u578B",
     configureAiMemory: "\u914D\u7F6E Claude \u5168\u5C40\u8BB0\u5FC6",
     configureEnvPermission: "\u5BFC\u5165\u63A8\u8350\u73AF\u5883\u53D8\u91CF\u548C\u6743\u9650\u914D\u7F6E",
+    ccusage: "ccusage",
     installBmad: "\u5B89\u88C5 BMad Method",
     clearCache: "\u6E05\u9664\u504F\u597D\u7F13\u5B58",
     changeLanguage: "\u66F4\u6539\u663E\u793A\u8BED\u8A00 / Select display language",
@@ -188,6 +193,7 @@ const menu$1 = {
     configureModel: "\u8BBE\u7F6E\u9ED8\u8BA4\u6A21\u578B\uFF08opus/sonnet\uFF09",
     configureAiMemory: "\u914D\u7F6E AI \u8F93\u51FA\u8BED\u8A00\u548C\u89D2\u8272\u98CE\u683C",
     configureEnvPermission: "\u5BFC\u5165\u9690\u79C1\u4FDD\u62A4\u73AF\u5883\u53D8\u91CF\u548C\u7CFB\u7EDF\u6743\u9650\u914D\u7F6E",
+    ccusage: "Claude Code \u7528\u91CF\u5206\u6790",
     installBmad: "AI \u9A71\u52A8\u7684\u5F00\u53D1\u65B9\u6CD5\u8BBA\u6846\u67B6",
     clearCache: "\u6E05\u9664\u504F\u597D\u8BED\u8A00\u7B49\u7F13\u5B58",
     changeLanguage: "\u66F4\u6539 ZCF \u754C\u9762\u8BED\u8A00"
@@ -301,6 +307,25 @@ const errors$1 = {
   failedToApplyPersonality: "\u5E94\u7528\u4E2A\u6027\u6307\u4EE4\u5931\u8D25\uFF1A"
 };
 
+const tools$1 = {
+  // CCUsage
+  runningCcusage: "\u6B63\u5728\u8FD0\u884C Claude Code \u7528\u91CF\u5206\u6790\u5DE5\u5177...",
+  ccusageDescription: "\u5206\u6790\u4EE4\u724C\u4F7F\u7528\u91CF\u548C\u6210\u672C - https://github.com/ryoppippi/ccusage",
+  selectAnalysisMode: "\u9009\u62E9\u5206\u6790\u6A21\u5F0F:",
+  ccusageModes: {
+    daily: "\u6BCF\u65E5\u4F7F\u7528\u91CF",
+    monthly: "\u6BCF\u6708\u4F7F\u7528\u91CF",
+    session: "\u4F1A\u8BDD\u7EDF\u8BA1",
+    blocks: "\u533A\u5757\u7EDF\u8BA1",
+    custom: "\u81EA\u5B9A\u4E49\u53C2\u6570"
+  },
+  enterCustomArgs: "\u8F93\u5165\u81EA\u5B9A\u4E49\u53C2\u6570 (\u4F8B\u5982: daily --json):",
+  pressEnterToContinue: "\u6309 Enter \u952E\u7EE7\u7EED...",
+  ccusageFailed: "\u8FD0\u884C ccusage \u5931\u8D25",
+  checkNetworkConnection: "\u8BF7\u68C0\u67E5\u7F51\u7EDC\u8FDE\u63A5\u5E76\u91CD\u8BD5",
+  errorDetails: "\u9519\u8BEF\u8BE6\u60C5:"
+};
+
 const zhCN = {
   ...common$1,
   ...language$1,
@@ -312,7 +337,8 @@ const zhCN = {
   ...workflow$1,
   ...cli$1,
   ...bmad$1,
-  ...errors$1
+  ...errors$1,
+  ...tools$1
 };
 
 const common = {
@@ -327,10 +353,11 @@ const common = {
   none: "None",
   notConfigured: "Not configured",
   spaceToSelectReturn: "- Space to select. Return to submit",
-  enterChoice: "Enter your choice, and press enter",
+  enterChoice: "Enter your choice and press enter (case-insensitive)",
   invalidChoice: "Invalid choice. Please enter a valid option.",
   goodbye: "\u{1F44B} Thanks for using ZCF! Goodbye!",
-  returnToMenu: "Return to main menu?"
+  returnToMenu: "Return to main menu?",
+  back: "Back"
 };
 
 const language = {
@@ -471,6 +498,9 @@ const mcp = {
 
 const menu = {
   selectFunction: "Select function",
+  menuSections: {
+    otherTools: "Other Tools"
+  },
   menuOptions: {
     fullInit: "Full initialization",
     importWorkflow: "Import workflow",
@@ -479,6 +509,7 @@ const menu = {
     configureModel: "Configure default model",
     configureAiMemory: "Configure Claude global memory",
     configureEnvPermission: "Import recommended environment variables and permissions",
+    ccusage: "ccusage",
     installBmad: "Install BMad Method",
     clearCache: "Clear preference cache",
     changeLanguage: "Select display language / \u66F4\u6539\u663E\u793A\u8BED\u8A00",
@@ -492,6 +523,7 @@ const menu = {
     configureModel: "Set default model (opus/sonnet)",
     configureAiMemory: "Configure AI output language and personality",
     configureEnvPermission: "Import privacy protection environment variables and system permissions",
+    ccusage: "Claude Code usage analysis",
     installBmad: "AI-driven development methodology framework",
     clearCache: "Clear preference language and other caches",
     changeLanguage: "Change ZCF interface language"
@@ -605,6 +637,25 @@ const errors = {
   failedToApplyPersonality: "Failed to apply personality directive:"
 };
 
+const tools = {
+  // CCUsage
+  runningCcusage: "Running Claude Code usage analysis tool...",
+  ccusageDescription: "Analyze token usage and costs - https://github.com/ryoppippi/ccusage",
+  selectAnalysisMode: "Select analysis mode:",
+  ccusageModes: {
+    daily: "Daily usage",
+    monthly: "Monthly usage",
+    session: "Session statistics",
+    blocks: "Block statistics",
+    custom: "Custom parameters"
+  },
+  enterCustomArgs: "Enter custom arguments (e.g., daily --json):",
+  pressEnterToContinue: "Press Enter to continue...",
+  ccusageFailed: "Failed to run ccusage",
+  checkNetworkConnection: "Please check your network connection and try again",
+  errorDetails: "Error details:"
+};
+
 const en = {
   ...common,
   ...language,
@@ -616,7 +667,8 @@ const en = {
   ...workflow,
   ...cli,
   ...bmad,
-  ...errors
+  ...errors,
+  ...tools
 };
 
 const translations = {
@@ -696,8 +748,8 @@ const MCP_SERVICES = [
     },
     requiresApiKey: true,
     apiKeyPrompt: {
-      "zh-CN": "\u8BF7\u8F93\u5165 Exa API Key",
-      en: "Enter Exa API Key"
+      "zh-CN": "\u8BF7\u8F93\u5165 Exa API Key\uFF08\u53EF\u4ECE https://dashboard.exa.ai/api-keys \u83B7\u53D6\uFF09",
+      en: "Enter Exa API Key (get from https://dashboard.exa.ai/api-keys)"
     },
     apiKeyEnvVar: "EXA_API_KEY",
     config: {
@@ -2294,4 +2346,4 @@ async function openSettingsJson() {
   }
 }
 
-export { handleGeneralError as $, AI_OUTPUT_LANGUAGES as A, backupMcpConfig as B, CLAUDE_DIR as C, mergeMcpServers as D, buildMcpServerConfig as E, fixWindowsMcpConfig as F, addCompletedOnboarding as G, updateZcfConfig as H, I18N as I, readZcfConfig as J, resolveAiOutputLanguage as K, LEGACY_ZCF_CONFIG_FILE as L, MCP_SERVICES as M, configureAiPersonality as N, isWindows as O, selectMcpServices as P, formatApiKeyDisplay as Q, modifyApiConfigPartially as R, SETTINGS_FILE as S, validateApiKey as T, displayBanner as U, selectScriptLanguage as V, updatePromptOnly as W, selectAndInstallWorkflows as X, version as Y, ZCF_CONFIG_FILE as Z, handleExitPromptError as _, importRecommendedEnv as a, displayBannerWithInfo as a0, readZcfConfigAsync as a1, importRecommendedPermissions as b, commandExists as c, cleanupPermissions as d, CLAUDE_MD_FILE as e, ClAUDE_CONFIG_FILE as f, getPlatform as g, SUPPORTED_LANGS as h, init as i, LANG_LABELS as j, isClaudeCodeInstalled as k, installClaudeCode as l, mergeAndCleanPermissions as m, ensureClaudeDir as n, openSettingsJson as o, backupExistingConfig as p, copyConfigFiles as q, configureApi as r, mergeConfigs as s, mergeSettingsFile as t, updateDefaultModel as u, getExistingApiConfig as v, applyAiLanguageDirective as w, getMcpConfigPath as x, readMcpConfig as y, writeMcpConfig as z };
+export { handleExitPromptError as $, AI_OUTPUT_LANGUAGES as A, backupMcpConfig as B, CLAUDE_DIR as C, mergeMcpServers as D, buildMcpServerConfig as E, fixWindowsMcpConfig as F, addCompletedOnboarding as G, updateZcfConfig as H, I18N as I, readZcfConfig as J, resolveAiOutputLanguage as K, LEGACY_ZCF_CONFIG_FILE as L, MCP_SERVICES as M, configureAiPersonality as N, isWindows as O, selectMcpServices as P, formatApiKeyDisplay as Q, modifyApiConfigPartially as R, SETTINGS_FILE as S, validateApiKey as T, readZcfConfigAsync as U, displayBanner as V, selectScriptLanguage as W, updatePromptOnly as X, selectAndInstallWorkflows as Y, ZCF_CONFIG_FILE as Z, version as _, importRecommendedEnv as a, handleGeneralError as a0, displayBannerWithInfo as a1, importRecommendedPermissions as b, commandExists as c, cleanupPermissions as d, CLAUDE_MD_FILE as e, ClAUDE_CONFIG_FILE as f, getPlatform as g, SUPPORTED_LANGS as h, init as i, LANG_LABELS as j, isClaudeCodeInstalled as k, installClaudeCode as l, mergeAndCleanPermissions as m, ensureClaudeDir as n, openSettingsJson as o, backupExistingConfig as p, copyConfigFiles as q, configureApi as r, mergeConfigs as s, mergeSettingsFile as t, updateDefaultModel as u, getExistingApiConfig as v, applyAiLanguageDirective as w, getMcpConfigPath as x, readMcpConfig as y, writeMcpConfig as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.6.1",
+  "version": "2.7.1",
   "description": "Zero-Config Claude-Code Flow - One-click configuration tool for Claude Code",
   "license": "MIT",
   "homepage": "https://github.com/UfoMiao/zcf",