zcf 2.12.11 → 2.12.13

package/README.md

@@ -8,7 +8,7 @@
 [![JSDocs][jsdocs-src]][jsdocs-href]
 [![Ask DeepWiki][deepwiki-src]][deepwiki-href]
 
-[中文](README_zh-CN.md) | **English** | [Changelog](CHANGELOG.md)
+[中文](README_zh-CN.md) | **English** | [日本語](README_ja-JP.md) | [Changelog](CHANGELOG.md)
 
 > Zero-config, one-click setup for Claude Code with bilingual support, intelligent agent system and personalized AI assistant
 
@@ -288,7 +288,7 @@ After configuration:
 
 - Auto-detects Claude Code installation status
 - Uses npm for automatic installation (ensures compatibility)
-- Cross-platform support (Windows/macOS/Linux/Termux)
+- Cross-platform support (Windows/macOS/Linux/WSL/Termux)
 - Automatic MCP service configuration
 - Smart configuration merging and partial modification support (v2.0 new)
 - Enhanced command detection mechanism (v2.1 new)
@@ -350,7 +350,7 @@ Select function:
 
   ------------ ZCF ------------
   0. Select display language / 更改显示语言 - Change ZCF interface language
-  -. Clear preference cache - Clear preference language and other caches
+  -. Uninstall - Remove Claude Code configurations and tools from system
   +. Check updates - Check and update Claude Code, CCR and CCometixLine versions
   Q. Exit
 
@@ -473,6 +473,7 @@ Enter your choice: _
 | `zcf update`        | `zcf u` | Update workflow-related md files with backup                                          |
 | `zcf ccu`           | -       | Run Claude Code usage analysis tool - [ccusage](https://github.com/ryoppippi/ccusage) |
 | `zcf ccr`           | -       | Open CCR (Claude Code Router) management menu                                         |
+| `zcf uninstall`     | -       | Interactive uninstall tool for Claude Code configurations and tools                   |
 | `zcf check-updates` | -       | Check and update Claude Code, CCR and CCometixLine versions                           |
 
 #### Common Options
@@ -647,6 +648,17 @@ ZCF fully supports Windows platform:
 
 If you encounter MCP connection issues on Windows, running `npx zcf` will automatically fix the configuration format.
 
+#### WSL Support (v2.12.12+ new)
+
+ZCF now provides comprehensive support for Windows Subsystem for Linux (WSL):
+
+- **Smart Detection**: Multi-layered WSL environment detection using environment variables, system files, and mount points
+- **Distribution Recognition**: Automatically identifies WSL distribution (Ubuntu, Debian, etc.) for optimized configuration
+- **Seamless Installation**: Native Linux-style installation experience within WSL environment
+- **Path Management**: Intelligent handling of WSL-specific configuration paths and file locations
+
+If running in WSL, ZCF will automatically detect the environment and display appropriate installation messages.
+
 #### Termux Support (v2.1 new)
 
 ZCF now supports running in Android Termux environment:

package/dist/chunks/simple-config.mjs

@@ -15,7 +15,7 @@ import { rm, mkdir, copyFile as copyFile$1 } from 'node:fs/promises';
 import i18next from 'i18next';
 import Backend from 'i18next-fs-backend';
 
-const version = "2.12.11";
+const version = "2.12.13";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const i18n = i18next.createInstance();
@@ -32,6 +32,7 @@ const NAMESPACES = [
   "mcp",
   "menu",
   "tools",
+  "uninstall",
   "updater",
   "workflow"
 ];
@@ -717,6 +718,57 @@ function getTermuxPrefix() {
 function isWindows() {
   return getPlatform() === "windows";
 }
+function isWSL() {
+  if (process.env.WSL_DISTRO_NAME) {
+    return true;
+  }
+  if (existsSync("/proc/version")) {
+    try {
+      const version = readFileSync("/proc/version", "utf8");
+      if (version.includes("Microsoft") || version.includes("WSL")) {
+        return true;
+      }
+    } catch {
+    }
+  }
+  if (existsSync("/mnt/c")) {
+    return true;
+  }
+  return false;
+}
+function getWSLDistro() {
+  if (process.env.WSL_DISTRO_NAME) {
+    return process.env.WSL_DISTRO_NAME;
+  }
+  if (existsSync("/etc/os-release")) {
+    try {
+      const osRelease = readFileSync("/etc/os-release", "utf8");
+      const nameMatch = osRelease.match(/^PRETTY_NAME="(.+)"$/m);
+      if (nameMatch) {
+        return nameMatch[1];
+      }
+    } catch {
+    }
+  }
+  return null;
+}
+function getWSLInfo() {
+  if (!isWSL()) {
+    return null;
+  }
+  let version = null;
+  if (existsSync("/proc/version")) {
+    try {
+      version = readFileSync("/proc/version", "utf8").trim();
+    } catch {
+    }
+  }
+  return {
+    isWSL: true,
+    distro: getWSLDistro(),
+    version
+  };
+}
 function getMcpCommand() {
   if (isWindows()) {
     return ["cmd", "/c", "npx"];
@@ -2513,6 +2565,15 @@ async function installClaudeCode() {
     console.log(ansis.gray(`Node.js: ${termuxPrefix}/bin/node`));
     console.log(ansis.gray(`npm: ${termuxPrefix}/bin/npm`));
   }
+  if (isWSL()) {
+    const wslInfo = getWSLInfo();
+    if (wslInfo?.distro) {
+      console.log(ansis.yellow(`\u2139 ${i18n.t("installation:wslDetected", { distro: wslInfo.distro })}`));
+    } else {
+      console.log(ansis.yellow(`\u2139 ${i18n.t("installation:wslDetectedGeneric")}`));
+    }
+    console.log(ansis.gray(i18n.t("installation:wslPathInfo", { path: `${homedir()}/.claude/` })));
+  }
   console.log(i18n.t("installation:installing"));
   try {
     await exec("npm", ["install", "-g", "@anthropic-ai/claude-code"]);
@@ -2521,6 +2582,10 @@ async function installClaudeCode() {
       console.log(ansis.gray(`
 Claude Code installed to: ${getTermuxPrefix()}/bin/claude`));
     }
+    if (isWSL()) {
+      console.log(ansis.gray(`
+${i18n.t("installation:wslInstallSuccess")}`));
+    }
   } catch (error) {
     console.error(`\u2716 ${i18n.t("installation:installFailed")}`);
     if (isTermux()) {
@@ -3548,4 +3613,4 @@ async function openSettingsJson() {
   }
 }
 
-export { addNumbersToChoices as $, AI_OUTPUT_LANGUAGES as A, copyConfigFiles as B, CLAUDE_DIR as C, configureApi as D, mergeConfigs as E, updateCustomModel as F, updateDefaultModel as G, mergeSettingsFile as H, getExistingModelConfig as I, getExistingApiConfig as J, applyAiLanguageDirective as K, LEGACY_ZCF_CONFIG_FILE as L, isClaudeCodeInstalled as M, installClaudeCode as N, isLocalClaudeCodeInstalled as O, getInstallationStatus as P, removeLocalClaudeCode as Q, ensureI18nInitialized as R, SETTINGS_FILE as S, i18n as T, readCcrConfig as U, isCcrInstalled as V, installCcr as W, configureCcrFeature as X, handleExitPromptError as Y, ZCF_CONFIG_FILE as Z, handleGeneralError as _, commandExists as a, updateZcfConfig as a0, changeLanguage as a1, readZcfConfig as a2, configureOutputStyle as a3, isWindows as a4, selectMcpServices as a5, getMcpServices as a6, formatApiKeyDisplay as a7, modifyApiConfigPartially as a8, setupCcrConfiguration as a9, validateApiKey as aa, COMETIX_COMMAND_NAME as ab, COMETIX_COMMANDS as ac, installCometixLine as ad, checkAndUpdateTools as ae, displayBanner as af, resolveAiOutputLanguage as ag, updatePromptOnly as ah, selectAndInstallWorkflows as ai, checkClaudeCodeVersionAndPrompt as aj, version as ak, displayBannerWithInfo as al, readZcfConfigAsync as am, initI18n as an, selectScriptLanguage as ao, prompts as ap, importRecommendedEnv as b, cleanupPermissions as c, importRecommendedPermissions 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, getAiOutputLanguageLabel as k, getMcpConfigPath as l, mergeAndCleanPermissions as m, backupMcpConfig as n, openSettingsJson as o, mergeMcpServers as p, buildMcpServerConfig as q, readMcpConfig as r, fixWindowsMcpConfig as s, addCompletedOnboarding as t, ensureApiKeyApproved as u, removeApiKeyFromRejected as v, writeMcpConfig as w, manageApiKeyApproval as x, ensureClaudeDir as y, backupExistingConfig as z };
+export { addNumbersToChoices as $, AI_OUTPUT_LANGUAGES as A, copyConfigFiles as B, CLAUDE_DIR as C, configureApi as D, mergeConfigs as E, updateCustomModel as F, updateDefaultModel as G, mergeSettingsFile as H, getExistingModelConfig as I, getExistingApiConfig as J, applyAiLanguageDirective as K, LEGACY_ZCF_CONFIG_FILE as L, isClaudeCodeInstalled as M, installClaudeCode as N, isLocalClaudeCodeInstalled as O, getInstallationStatus as P, removeLocalClaudeCode as Q, ensureI18nInitialized as R, SETTINGS_FILE as S, i18n as T, readCcrConfig as U, isCcrInstalled as V, installCcr as W, configureCcrFeature as X, handleExitPromptError as Y, ZCF_CONFIG_FILE as Z, handleGeneralError as _, commandExists as a, updateZcfConfig as a0, changeLanguage as a1, readZcfConfig as a2, configureOutputStyle as a3, isWindows as a4, selectMcpServices as a5, getMcpServices as a6, formatApiKeyDisplay as a7, modifyApiConfigPartially as a8, setupCcrConfiguration as a9, validateApiKey as aa, COMETIX_COMMAND_NAME as ab, COMETIX_COMMANDS as ac, installCometixLine as ad, checkAndUpdateTools as ae, readJsonConfig as af, writeJsonConfig as ag, displayBanner as ah, resolveAiOutputLanguage as ai, updatePromptOnly as aj, selectAndInstallWorkflows as ak, checkClaudeCodeVersionAndPrompt as al, version as am, displayBannerWithInfo as an, readZcfConfigAsync as ao, initI18n as ap, selectScriptLanguage as aq, prompts as ar, importRecommendedEnv as b, cleanupPermissions as c, importRecommendedPermissions 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, getAiOutputLanguageLabel as k, getMcpConfigPath as l, mergeAndCleanPermissions as m, backupMcpConfig as n, openSettingsJson as o, mergeMcpServers as p, buildMcpServerConfig as q, readMcpConfig as r, fixWindowsMcpConfig as s, addCompletedOnboarding as t, ensureApiKeyApproved as u, removeApiKeyFromRejected as v, writeMcpConfig as w, manageApiKeyApproval as x, ensureClaudeDir as y, backupExistingConfig as z };

package/dist/cli.mjs

@@ -1,15 +1,17 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { R as ensureI18nInitialized, T as i18n, U as readCcrConfig, V as isCcrInstalled, W as installCcr, X as configureCcrFeature, Y as handleExitPromptError, _ as handleGeneralError, Z as ZCF_CONFIG_FILE, h as SUPPORTED_LANGS, $ as addNumbersToChoices, j as LANG_LABELS, a0 as updateZcfConfig, a1 as changeLanguage, o as openSettingsJson, d as importRecommendedPermissions, b as importRecommendedEnv, a2 as readZcfConfig, K as applyAiLanguageDirective, a3 as configureOutputStyle, I as getExistingModelConfig, F as updateCustomModel, G as updateDefaultModel, a4 as isWindows, r as readMcpConfig, s as fixWindowsMcpConfig, w as writeMcpConfig, a5 as selectMcpServices, n as backupMcpConfig, a6 as getMcpServices, q as buildMcpServerConfig, p as mergeMcpServers, J as getExistingApiConfig, a7 as formatApiKeyDisplay, t as addCompletedOnboarding, a8 as modifyApiConfigPartially, a9 as setupCcrConfiguration, aa as validateApiKey, D as configureApi, ab as COMETIX_COMMAND_NAME, ac as COMETIX_COMMANDS, ad as installCometixLine, ae as checkAndUpdateTools, af as displayBanner, ag as resolveAiOutputLanguage, ah as updatePromptOnly, ai as selectAndInstallWorkflows, aj as checkClaudeCodeVersionAndPrompt, ak as version, al as displayBannerWithInfo, i as init, am as readZcfConfigAsync, an as initI18n, ao as selectScriptLanguage } from './chunks/simple-config.mjs';
-import { existsSync, unlinkSync } from 'node:fs';
+import { R as ensureI18nInitialized, T as i18n, U as readCcrConfig, V as isCcrInstalled, W as installCcr, X as configureCcrFeature, Y as handleExitPromptError, _ as handleGeneralError, h as SUPPORTED_LANGS, $ as addNumbersToChoices, j as LANG_LABELS, a0 as updateZcfConfig, a1 as changeLanguage, o as openSettingsJson, d as importRecommendedPermissions, b as importRecommendedEnv, a2 as readZcfConfig, K as applyAiLanguageDirective, a3 as configureOutputStyle, I as getExistingModelConfig, F as updateCustomModel, G as updateDefaultModel, a4 as isWindows, r as readMcpConfig, s as fixWindowsMcpConfig, w as writeMcpConfig, a5 as selectMcpServices, n as backupMcpConfig, a6 as getMcpServices, q as buildMcpServerConfig, p as mergeMcpServers, J as getExistingApiConfig, a7 as formatApiKeyDisplay, t as addCompletedOnboarding, a8 as modifyApiConfigPartially, a9 as setupCcrConfiguration, aa as validateApiKey, D as configureApi, ab as COMETIX_COMMAND_NAME, ac as COMETIX_COMMANDS, ad as installCometixLine, ae as checkAndUpdateTools, af as readJsonConfig, ag as writeJsonConfig, ah as displayBanner, ai as resolveAiOutputLanguage, aj as updatePromptOnly, ak as selectAndInstallWorkflows, al as checkClaudeCodeVersionAndPrompt, am as version, an as displayBannerWithInfo, i as init, 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';
 import { join } from 'pathe';
 import { exec, spawn } from 'node:child_process';
 import { promisify } from 'node:util';
 import process from 'node:process';
-import { x } from 'tinyexec';
+import { x, exec as exec$1 } from 'tinyexec';
+import { pathExists } from 'fs-extra';
+import trash from 'trash';
 import 'dayjs';
 import 'node:url';
 import 'ora';
@@ -555,7 +557,7 @@ ${ansis.blue(`\u2139 ${i18n.t("configuration:existingLanguageConfig") || "Existi
         return;
       }
     }
-    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.ap; });
+    const { selectAiOutputLanguage } = await import('./chunks/simple-config.mjs').then(function (n) { return n.ar; });
     const aiOutputLang = await selectAiOutputLanguage();
     applyAiLanguageDirective(aiOutputLang);
     updateZcfConfig({ aiOutputLang });
@@ -564,25 +566,6 @@ ${ansis.blue(`\u2139 ${i18n.t("configuration:existingLanguageConfig") || "Existi
     await configureOutputStyle();
   }
 }
-async function clearZcfCacheFeature() {
-  ensureI18nInitialized();
-  const { confirm } = await inquirer.prompt({
-    type: "confirm",
-    name: "confirm",
-    message: i18n.t("configuration:confirmClearCache") || "Clear all ZCF preferences cache?",
-    default: false
-  });
-  if (!confirm) {
-    await handleCancellation();
-    return;
-  }
-  if (existsSync(ZCF_CONFIG_FILE)) {
-    unlinkSync(ZCF_CONFIG_FILE);
-    console.log(ansis.green(`\u2714 ${i18n.t("configuration:cacheCleared") || "ZCF cache cleared"}`));
-  } else {
-    console.log(ansis.yellow("No cache found"));
-  }
-}
 async function changeScriptLanguageFeature(currentLang) {
   ensureI18nInitialized();
   const { lang } = await inquirer.prompt({
@@ -866,6 +849,772 @@ async function checkUpdates(options = {}) {
   }
 }
 
+async function moveToTrash(paths) {
+  const pathArray = Array.isArray(paths) ? paths : [paths];
+  const results = [];
+  for (const path of pathArray) {
+    try {
+      const exists = await pathExists(path);
+      if (!exists) {
+        results.push({
+          success: false,
+          path,
+          error: "Path does not exist"
+        });
+        continue;
+      }
+      await trash(path);
+      results.push({
+        success: true,
+        path
+      });
+    } catch (error) {
+      results.push({
+        success: false,
+        path,
+        error: error.message || "Unknown error occurred"
+      });
+    }
+  }
+  return results;
+}
+
+class ZcfUninstaller {
+  _lang;
+  // Reserved for future i18n support
+  conflictResolution = /* @__PURE__ */ new Map();
+  constructor(lang = "en") {
+    this._lang = lang;
+    this.conflictResolution.set("claude-code", ["mcps"]);
+    void this._lang;
+  }
+  /**
+   * 1. Remove outputStyle field from settings.json and output-styles directory
+   */
+  async removeOutputStyles() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const settingsPath = join(homedir(), ".claude", "settings.json");
+      const outputStylesPath = join(homedir(), ".claude", "output-styles");
+      if (await pathExists(settingsPath)) {
+        const settings = readJsonConfig(settingsPath) || {};
+        if (settings.outputStyle) {
+          delete settings.outputStyle;
+          writeJsonConfig(settingsPath, settings);
+          result.removedConfigs.push("outputStyle field from settings.json");
+        }
+      } else {
+        result.warnings.push(i18n.t("uninstall:settingsJsonNotFound"));
+      }
+      if (await pathExists(outputStylesPath)) {
+        const trashResult = await moveToTrash(outputStylesPath);
+        if (!trashResult[0]?.success) {
+          result.warnings.push(trashResult[0]?.error || "Failed to move to trash");
+        }
+        result.removed.push("~/.claude/output-styles/");
+      } else {
+        result.warnings.push(i18n.t("uninstall:outputStylesDirectoryNotFound"));
+      }
+      result.success = true;
+    } catch (error) {
+      result.errors.push(`Failed to remove output styles: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 2. Remove custom commands directory (commands/zcf/)
+   */
+  async removeCustomCommands() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const commandsPath = join(homedir(), ".claude", "commands", "zcf");
+      if (await pathExists(commandsPath)) {
+        const trashResult = await moveToTrash(commandsPath);
+        if (!trashResult[0]?.success) {
+          result.warnings.push(trashResult[0]?.error || "Failed to move to trash");
+        }
+        result.removed.push("commands/zcf/");
+        result.success = true;
+      } else {
+        result.warnings.push(i18n.t("uninstall:commandsNotFound"));
+        result.success = true;
+      }
+    } catch (error) {
+      result.errors.push(`Failed to remove custom commands: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 3. Remove custom agents directory (agents/zcf/)
+   */
+  async removeCustomAgents() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const agentsPath = join(homedir(), ".claude", "agents", "zcf");
+      if (await pathExists(agentsPath)) {
+        const trashResult = await moveToTrash(agentsPath);
+        if (!trashResult[0]?.success) {
+          result.warnings.push(trashResult[0]?.error || "Failed to move to trash");
+        }
+        result.removed.push("agents/zcf/");
+        result.success = true;
+      } else {
+        result.warnings.push(i18n.t("uninstall:agentsNotFound"));
+        result.success = true;
+      }
+    } catch (error) {
+      result.errors.push(`Failed to remove custom agents: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 4. Remove global memory file (CLAUDE.md)
+   */
+  async removeClaudeMd() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const claudeMdPath = join(homedir(), ".claude", "CLAUDE.md");
+      if (await pathExists(claudeMdPath)) {
+        const trashResult = await moveToTrash(claudeMdPath);
+        if (!trashResult[0]?.success) {
+          result.warnings.push(trashResult[0]?.error || "Failed to move to trash");
+        }
+        result.removed.push("CLAUDE.md");
+        result.success = true;
+      } else {
+        result.warnings.push(i18n.t("uninstall:claudeMdNotFound"));
+        result.success = true;
+      }
+    } catch (error) {
+      result.errors.push(`Failed to remove CLAUDE.md: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 5. Remove permissions and environment variables
+   */
+  async removePermissionsAndEnvs() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const settingsPath = join(homedir(), ".claude", "settings.json");
+      if (await pathExists(settingsPath)) {
+        const settings = readJsonConfig(settingsPath) || {};
+        let modified = false;
+        if (settings.permissions) {
+          delete settings.permissions;
+          result.removedConfigs.push("permissions configuration");
+          modified = true;
+        }
+        if (settings.env) {
+          delete settings.env;
+          result.removedConfigs.push("environment variables");
+          modified = true;
+        }
+        if (modified) {
+          writeJsonConfig(settingsPath, settings);
+        }
+        result.success = true;
+      } else {
+        result.warnings.push(i18n.t("uninstall:settingsJsonNotFound"));
+        result.success = true;
+      }
+    } catch (error) {
+      result.errors.push(`Failed to remove permissions and envs: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 6. Remove MCP servers from .claude.json (mcpServers field only)
+   */
+  async removeMcps() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const claudeJsonPath = join(homedir(), ".claude.json");
+      if (await pathExists(claudeJsonPath)) {
+        const config = readJsonConfig(claudeJsonPath) || {};
+        if (config.mcpServers) {
+          delete config.mcpServers;
+          writeJsonConfig(claudeJsonPath, config);
+          result.removedConfigs.push("mcpServers from .claude.json");
+        }
+        result.success = true;
+      } else {
+        result.warnings.push(i18n.t("uninstall:claudeJsonNotFound"));
+        result.success = true;
+      }
+    } catch (error) {
+      result.errors.push(`Failed to remove MCP servers: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 7. Uninstall Claude Code Router and remove configuration
+   */
+  async uninstallCcr() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const ccrPath = join(homedir(), ".claude-code-router");
+      if (await pathExists(ccrPath)) {
+        const trashResult = await moveToTrash(ccrPath);
+        if (!trashResult[0]?.success) {
+          result.warnings.push(trashResult[0]?.error || "Failed to move to trash");
+        }
+        result.removed.push(".claude-code-router/");
+      }
+      try {
+        await exec$1("npm", ["uninstall", "-g", "@musistudio/claude-code-router"]);
+        result.removed.push("@musistudio/claude-code-router package");
+        result.success = true;
+      } catch (npmError) {
+        if (npmError.message.includes("not found") || npmError.message.includes("not installed")) {
+          result.warnings.push(i18n.t("uninstall:ccrPackageNotFound"));
+          result.success = true;
+        } else {
+          result.errors.push(`Failed to uninstall CCR package: ${npmError.message}`);
+        }
+      }
+    } catch (error) {
+      result.errors.push(`Failed to uninstall CCR: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 8. Uninstall CCometixLine
+   */
+  async uninstallCcline() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      await exec$1("npm", ["uninstall", "-g", "@cometix/ccline"]);
+      result.removed.push("@cometix/ccline package");
+      result.success = true;
+    } catch (error) {
+      if (error.message.includes("not found") || error.message.includes("not installed")) {
+        result.warnings.push(i18n.t("uninstall:cclinePackageNotFound"));
+        result.success = true;
+      } else {
+        result.errors.push(`Failed to uninstall CCometixLine: ${error.message}`);
+      }
+    }
+    return result;
+  }
+  /**
+   * 9. Uninstall Claude Code and remove entire .claude.json
+   */
+  async uninstallClaudeCode() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const claudeJsonPath = join(homedir(), ".claude.json");
+      if (await pathExists(claudeJsonPath)) {
+        const trashResult = await moveToTrash(claudeJsonPath);
+        if (!trashResult[0]?.success) {
+          result.warnings.push(trashResult[0]?.error || "Failed to move to trash");
+        }
+        result.removed.push(".claude.json (includes MCP configuration)");
+      }
+      try {
+        await exec$1("npm", ["uninstall", "-g", "@anthropic-ai/claude-code"]);
+        result.removed.push("@anthropic-ai/claude-code package");
+        result.success = true;
+      } catch (npmError) {
+        if (npmError.message.includes("not found") || npmError.message.includes("not installed")) {
+          result.warnings.push(i18n.t("uninstall:claudeCodePackageNotFound"));
+          result.success = true;
+        } else {
+          result.errors.push(`Failed to uninstall Claude Code package: ${npmError.message}`);
+        }
+      }
+    } catch (error) {
+      result.errors.push(`Failed to uninstall Claude Code: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 10. Remove backup files
+   */
+  async removeBackups() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const backupPath = join(homedir(), ".claude", "backup");
+      if (await pathExists(backupPath)) {
+        const trashResult = await moveToTrash(backupPath);
+        if (!trashResult[0]?.success) {
+          result.warnings.push(trashResult[0]?.error || "Failed to move to trash");
+        }
+        result.removed.push("backup/");
+        result.success = true;
+      } else {
+        result.warnings.push(i18n.t("uninstall:backupsNotFound"));
+        result.success = true;
+      }
+    } catch (error) {
+      result.errors.push(`Failed to remove backups: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * 11. Remove ZCF preference configuration
+   */
+  async removeZcfConfig() {
+    const result = {
+      success: false,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const zcfConfigPath = join(homedir(), ".zcf-config.json");
+      if (await pathExists(zcfConfigPath)) {
+        const trashResult = await moveToTrash(zcfConfigPath);
+        if (!trashResult[0]?.success) {
+          result.warnings.push(trashResult[0]?.error || "Failed to move to trash");
+        }
+        result.removed.push(".zcf-config.json");
+        result.success = true;
+      } else {
+        result.warnings.push(i18n.t("uninstall:zcfConfigNotFound"));
+        result.success = true;
+      }
+    } catch (error) {
+      result.errors.push(`Failed to remove ZCF config: ${error.message}`);
+    }
+    return result;
+  }
+  /**
+   * Complete uninstall - remove all directories and packages
+   */
+  async completeUninstall() {
+    const result = {
+      success: true,
+      removed: [],
+      removedConfigs: [],
+      errors: [],
+      warnings: []
+    };
+    try {
+      const directoriesToRemove = [
+        { path: join(homedir(), ".claude"), name: "~/.claude/" },
+        { path: join(homedir(), ".claude.json"), name: "~/.claude.json" },
+        { path: join(homedir(), ".claude-code-router"), name: "~/.claude-code-router/" }
+      ];
+      for (const dir of directoriesToRemove) {
+        try {
+          if (await pathExists(dir.path)) {
+            const trashResult = await moveToTrash(dir.path);
+            if (!trashResult[0]?.success) {
+              result.warnings.push(`Failed to move ${dir.name} to trash: ${trashResult[0]?.error || "Unknown error"}`);
+            }
+            result.removed.push(dir.name);
+          }
+        } catch (error) {
+          result.warnings.push(`Failed to remove ${dir.name}: ${error.message}`);
+        }
+      }
+      const packagesToUninstall = [
+        "@musistudio/claude-code-router",
+        "@cometix/ccline",
+        "@anthropic-ai/claude-code"
+      ];
+      for (const pkg of packagesToUninstall) {
+        try {
+          await exec$1("npm", ["uninstall", "-g", pkg]);
+          result.removed.push(`${pkg} package`);
+        } catch (error) {
+          if (error.message.includes("not found") || error.message.includes("not installed")) {
+            if (pkg.includes("claude-code-router")) {
+              result.warnings.push(i18n.t("uninstall:ccrPackageNotFound"));
+            } else if (pkg.includes("ccline")) {
+              result.warnings.push(i18n.t("uninstall:cclinePackageNotFound"));
+            } else {
+              result.warnings.push(i18n.t("uninstall:claudeCodePackageNotFound"));
+            }
+          } else {
+            result.warnings.push(`Failed to uninstall ${pkg}: ${error.message}`);
+          }
+        }
+      }
+    } catch (error) {
+      result.errors.push(`Complete uninstall failed: ${error.message}`);
+      result.success = false;
+    }
+    return result;
+  }
+  /**
+   * Custom uninstall with conflict resolution
+   */
+  async customUninstall(selectedItems) {
+    const resolvedItems = this.resolveConflicts(selectedItems);
+    const results = [];
+    for (const item of resolvedItems) {
+      try {
+        const result = await this.executeUninstallItem(item);
+        results.push(result);
+      } catch (error) {
+        results.push({
+          success: false,
+          removed: [],
+          removedConfigs: [],
+          errors: [`Failed to execute ${item}: ${error.message}`],
+          warnings: []
+        });
+      }
+    }
+    return results;
+  }
+  /**
+   * Resolve conflicts between uninstall items
+   */
+  resolveConflicts(items) {
+    const resolved = [...items];
+    for (const [primary, conflicts] of this.conflictResolution) {
+      if (resolved.includes(primary)) {
+        conflicts.forEach((conflict) => {
+          const index = resolved.indexOf(conflict);
+          if (index > -1) {
+            resolved.splice(index, 1);
+          }
+        });
+      }
+    }
+    return resolved;
+  }
+  /**
+   * Execute uninstall for a specific item
+   */
+  async executeUninstallItem(item) {
+    switch (item) {
+      case "output-styles":
+        return await this.removeOutputStyles();
+      case "commands":
+        return await this.removeCustomCommands();
+      case "agents":
+        return await this.removeCustomAgents();
+      case "claude-md":
+        return await this.removeClaudeMd();
+      case "permissions-envs":
+        return await this.removePermissionsAndEnvs();
+      case "mcps":
+        return await this.removeMcps();
+      case "ccr":
+        return await this.uninstallCcr();
+      case "ccline":
+        return await this.uninstallCcline();
+      case "claude-code":
+        return await this.uninstallClaudeCode();
+      case "backups":
+        return await this.removeBackups();
+      case "zcf-config":
+        return await this.removeZcfConfig();
+      default:
+        return {
+          success: false,
+          removed: [],
+          removedConfigs: [],
+          errors: [`Unknown uninstall item: ${item}`],
+          warnings: []
+        };
+    }
+  }
+}
+
+async function uninstall(options = {}) {
+  try {
+    ensureI18nInitialized();
+    const uninstaller = new ZcfUninstaller(options.lang || "en");
+    if (options.mode && options.mode !== "interactive") {
+      if (options.mode === "complete") {
+        await executeCompleteUninstall(uninstaller);
+        return;
+      } else if (options.mode === "custom" && options.items) {
+        let items;
+        if (typeof options.items === "string") {
+          items = options.items.split(",").map((item) => item.trim());
+        } else {
+          items = options.items;
+        }
+        await executeCustomUninstall(uninstaller, items);
+        return;
+      }
+    }
+    await showInteractiveUninstall(uninstaller);
+  } catch (error) {
+    if (!handleExitPromptError(error)) {
+      handleGeneralError(error);
+    }
+  }
+}
+async function showInteractiveUninstall(uninstaller) {
+  console.log(ansis.cyan.bold(i18n.t("uninstall:title")));
+  console.log(ansis.yellow(i18n.t("uninstall:warning")));
+  console.log("");
+  const { mainChoice } = await inquirer.prompt({
+    type: "list",
+    name: "mainChoice",
+    message: i18n.t("uninstall:selectMainOption"),
+    choices: addNumbersToChoices([
+      {
+        name: `${i18n.t("uninstall:completeUninstall")} - ${ansis.gray(i18n.t("uninstall:completeUninstallDesc"))}`,
+        value: "complete",
+        short: i18n.t("uninstall:completeUninstall")
+      },
+      {
+        name: `${i18n.t("uninstall:customUninstall")} - ${ansis.gray(i18n.t("uninstall:customUninstallDesc"))}`,
+        value: "custom",
+        short: i18n.t("uninstall:customUninstall")
+      }
+    ])
+  });
+  if (!mainChoice) {
+    console.log(ansis.yellow(i18n.t("common:cancelled")));
+    return;
+  }
+  if (mainChoice === "complete") {
+    await executeCompleteUninstall(uninstaller);
+  } else {
+    await showCustomUninstallMenu(uninstaller);
+  }
+}
+async function showCustomUninstallMenu(uninstaller) {
+  console.log("");
+  console.log(ansis.cyan(i18n.t("uninstall:selectCustomItems")));
+  const { customItems } = await inquirer.prompt({
+    type: "checkbox",
+    name: "customItems",
+    message: `${i18n.t("uninstall:selectItemsToRemove")} ${i18n.t("common:multiSelectHint")}`,
+    choices: [
+      {
+        name: i18n.t("uninstall:outputStyles"),
+        value: "output-styles"
+      },
+      {
+        name: i18n.t("uninstall:commands"),
+        value: "commands"
+      },
+      {
+        name: i18n.t("uninstall:agents"),
+        value: "agents"
+      },
+      {
+        name: i18n.t("uninstall:claudeMd"),
+        value: "claude-md"
+      },
+      {
+        name: i18n.t("uninstall:permissionsEnvs"),
+        value: "permissions-envs"
+      },
+      {
+        name: i18n.t("uninstall:mcps"),
+        value: "mcps"
+      },
+      {
+        name: i18n.t("uninstall:ccr"),
+        value: "ccr"
+      },
+      {
+        name: i18n.t("uninstall:ccline"),
+        value: "ccline"
+      },
+      {
+        name: i18n.t("uninstall:claudeCode"),
+        value: "claude-code"
+      },
+      {
+        name: i18n.t("uninstall:backups"),
+        value: "backups"
+      },
+      {
+        name: i18n.t("uninstall:zcfConfig"),
+        value: "zcf-config"
+      }
+    ],
+    validate: (answers) => {
+      if (answers.length === 0) {
+        return i18n.t("uninstall:selectAtLeastOne");
+      }
+      return true;
+    }
+  });
+  if (!customItems || customItems.length === 0) {
+    console.log(ansis.yellow(i18n.t("common:cancelled")));
+    return;
+  }
+  await executeCustomUninstall(uninstaller, customItems);
+}
+async function executeCompleteUninstall(uninstaller) {
+  console.log("");
+  console.log(ansis.red.bold(i18n.t("uninstall:executingComplete")));
+  console.log(ansis.yellow(i18n.t("uninstall:completeWarning")));
+  const { confirm } = await inquirer.prompt({
+    type: "confirm",
+    name: "confirm",
+    message: i18n.t("uninstall:confirmComplete"),
+    default: false
+  });
+  if (!confirm) {
+    console.log(ansis.yellow(i18n.t("common:cancelled")));
+    return;
+  }
+  console.log("");
+  console.log(ansis.cyan(i18n.t("uninstall:processingComplete")));
+  const result = await uninstaller.completeUninstall();
+  displayUninstallResult("complete", [result]);
+}
+async function executeCustomUninstall(uninstaller, items) {
+  console.log("");
+  console.log(ansis.cyan(i18n.t("uninstall:executingCustom")));
+  console.log(ansis.gray(i18n.t("uninstall:selectedItems")));
+  items.forEach((item) => {
+    console.log(`  \u2022 ${i18n.t(`uninstall:${item}`)}`);
+  });
+  const { confirm } = await inquirer.prompt({
+    type: "confirm",
+    name: "confirm",
+    message: i18n.t("uninstall:confirmCustom"),
+    default: false
+  });
+  if (!confirm) {
+    console.log(ansis.yellow(i18n.t("common:cancelled")));
+    return;
+  }
+  console.log("");
+  console.log(ansis.cyan(i18n.t("uninstall:processingCustom")));
+  const results = await uninstaller.customUninstall(items);
+  displayUninstallResult("custom", results);
+}
+function displayUninstallResult(mode, results) {
+  console.log("");
+  console.log(ansis.cyan("\u2500".repeat(50)));
+  let totalSuccess = 0;
+  let totalErrors = 0;
+  let totalWarnings = 0;
+  results.forEach((result) => {
+    if (result.success) {
+      totalSuccess++;
+    }
+    if (result.removed && result.removed.length > 0) {
+      console.log(ansis.green(`\u{1F5D1}\uFE0F ${i18n.t("uninstall:movedToTrash")}:`));
+      result.removed.forEach((item) => {
+        console.log(ansis.gray(`  \u2022 ${item}`));
+      });
+    }
+    if (result.removedConfigs && result.removedConfigs.length > 0) {
+      console.log(ansis.green(`\u2714 ${i18n.t("uninstall:removedConfigs")}:`));
+      result.removedConfigs.forEach((item) => {
+        console.log(ansis.gray(`  \u2022 ${item}`));
+      });
+    }
+    if (result.errors && result.errors.length > 0) {
+      totalErrors += result.errors.length;
+      console.log(ansis.red(`\u2716 ${i18n.t("uninstall:errors")}:`));
+      result.errors.forEach((error) => {
+        console.log(ansis.red(`  \u2022 ${error}`));
+      });
+    }
+    if (result.warnings && result.warnings.length > 0) {
+      totalWarnings += result.warnings.length;
+      console.log(ansis.yellow(`\u26A0 ${i18n.t("uninstall:warnings")}:`));
+      result.warnings.forEach((warning) => {
+        console.log(ansis.yellow(`  \u2022 ${warning}`));
+      });
+    }
+  });
+  const totalRemovedFiles = results.reduce((count, result) => count + (result.removed?.length || 0), 0);
+  const totalRemovedConfigs = results.reduce((count, result) => count + (result.removedConfigs?.length || 0), 0);
+  console.log("");
+  console.log(ansis.cyan("\u2500".repeat(50)));
+  if (mode === "complete") {
+    if (totalErrors === 0) {
+      console.log(ansis.green.bold(`\u2714 ${i18n.t("uninstall:completeSuccess")}`));
+    } else {
+      console.log(ansis.yellow.bold(`\u26A0 ${i18n.t("uninstall:completePartialSuccess")}`));
+    }
+  } else {
+    if (totalRemovedFiles > 0 && totalRemovedConfigs > 0) {
+      console.log(ansis.green.bold(`\u2714 ${i18n.t("uninstall:customSuccessBoth", {
+        fileCount: totalRemovedFiles,
+        configCount: totalRemovedConfigs
+      })}`));
+    } else if (totalRemovedFiles > 0) {
+      console.log(ansis.green.bold(`\u2714 ${i18n.t("uninstall:customSuccessFiles", {
+        count: totalRemovedFiles
+      })}`));
+    } else if (totalRemovedConfigs > 0) {
+      console.log(ansis.green.bold(`\u2714 ${i18n.t("uninstall:customSuccessConfigs", {
+        count: totalRemovedConfigs
+      })}`));
+    } else {
+      console.log(ansis.green.bold(`\u2714 ${i18n.t("uninstall:customSuccess", { count: totalSuccess })}`));
+    }
+    if (totalErrors > 0) {
+      console.log(ansis.red(`\u2716 ${i18n.t("uninstall:errorsCount", { count: totalErrors })}`));
+    }
+    if (totalWarnings > 0) {
+      console.log(ansis.yellow(`\u26A0 ${i18n.t("uninstall:warningsCount", { count: totalWarnings })}`));
+    }
+  }
+  console.log("");
+}
+
 async function update(options = {}) {
   try {
     if (!options.skipBanner) {
@@ -970,7 +1719,7 @@ async function showMainMenu() {
         )}`
       );
       console.log(
-        `  ${ansis.cyan("-.")} ${i18n.t("menu:menuOptions.clearCache")} ${ansis.gray(`- ${i18n.t("menu:menuDescriptions.clearCache")}`)}`
+        `  ${ansis.cyan("-.")} ${i18n.t("menu:menuOptions.uninstall")} ${ansis.gray(`- ${i18n.t("menu:menuDescriptions.uninstall")}`)}`
       );
       console.log(
         `  ${ansis.cyan("+.")} ${i18n.t("menu:menuOptions.checkUpdates")} ${ansis.gray(`- ${i18n.t("menu:menuDescriptions.checkUpdates")}`)}`
@@ -1031,7 +1780,7 @@ async function showMainMenu() {
           break;
         }
         case "-":
-          await clearZcfCacheFeature();
+          await uninstall();
           break;
         case "+":
           await checkUpdates();
@@ -1128,6 +1877,7 @@ function customizeHelp(sections) {
       `  ${ansis.cyan("zcf update")} | ${ansis.cyan("u")}   ${i18n.t("cli:help.commandDescriptions.updateWorkflowFiles")}`,
       `  ${ansis.cyan("zcf ccr")}          ${i18n.t("cli:help.commandDescriptions.configureCcrProxy")}`,
       `  ${ansis.cyan("zcf ccu")} [args]   ${i18n.t("cli:help.commandDescriptions.claudeCodeUsageAnalysis")}`,
+      `  ${ansis.cyan("zcf uninstall")}     ${i18n.t("cli:help.commandDescriptions.uninstallConfigurations")}`,
       `  ${ansis.cyan("zcf check-updates")} ${i18n.t("cli:help.commandDescriptions.checkUpdateVersions")}`,
       "",
       ansis.gray(`  ${i18n.t("cli:help.shortcuts")}`),
@@ -1180,6 +1930,9 @@ function customizeHelp(sections) {
       `  ${ansis.cyan("npx zcf ccu")}               ${ansis.gray(`# ${i18n.t("cli:help.defaults.dailyUsage")}`)}`,
       `  ${ansis.cyan("npx zcf ccu monthly --json")}`,
       "",
+      ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.uninstallConfigurations")}`),
+      `  ${ansis.cyan("npx zcf uninstall")}         ${ansis.gray(`# ${i18n.t("cli:help.defaults.interactiveUninstall")}`)}`,
+      "",
       ansis.gray(`  # ${i18n.t("cli:help.exampleDescriptions.checkAndUpdateTools")}`),
       `  ${ansis.cyan("npx zcf check-updates")}     ${ansis.gray(`# ${i18n.t("cli:help.defaults.updateTools")}`)}`,
       `  ${ansis.cyan("npx zcf check")}`,
@@ -1215,6 +1968,9 @@ async function setupCommands(cli) {
   cli.command("ccu [...args]", "Run Claude Code usage analysis tool").option("--lang, -l <lang>", "ZCF display language (zh-CN, en)").option("--all-lang, -g <lang>", "Set all language parameters to this value").allowUnknownOptions().action(await withLanguageResolution(async (args) => {
     await executeCcusage(args);
   }));
+  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();
   }));

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

@@ -9,6 +9,7 @@
   "help.commandDescriptions.updateWorkflowFiles": "Update workflow-related md files",
   "help.commandDescriptions.configureCcrProxy": "Configure Claude Code Router for model proxy",
   "help.commandDescriptions.claudeCodeUsageAnalysis": "Claude Code usage statistics analysis",
+  "help.commandDescriptions.uninstallConfigurations": "Remove Claude Code configurations and tools",
   "help.commandDescriptions.checkUpdateVersions": "Check and update to latest versions",
   "help.shortcutDescriptions.quickInit": "Quick init",
   "help.shortcutDescriptions.quickUpdate": "Quick update",
@@ -35,11 +36,13 @@
   "help.exampleDescriptions.updateWorkflowFilesOnly": "Update workflow-related md files only",
   "help.exampleDescriptions.configureClaudeCodeRouter": "Configure Claude Code Router",
   "help.exampleDescriptions.runClaudeCodeUsageAnalysis": "Run Claude Code usage analysis",
+  "help.exampleDescriptions.uninstallConfigurations": "Uninstall configurations and tools",
   "help.exampleDescriptions.checkAndUpdateTools": "Check and update 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",
   "help.defaults.dailyUsage": "Daily usage (default)",
+  "help.defaults.interactiveUninstall": "Interactive uninstall menu",
   "help.defaults.updateTools": "Update Claude Code, CCR and CCometixLine",
   "help.defaults.prefix": "default:"
 }

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

@@ -24,5 +24,9 @@
   "onlyLocalInstallationDetected": "Only local installation detected",
   "notInstalled": "not installed",
   "installingGlobalClaudeCode": "Installing global Claude Code",
-  "globalInstallationCompleted": "Global installation completed"
+  "globalInstallationCompleted": "Global installation completed",
+  "wslDetected": "WSL environment detected ({distro})",
+  "wslDetectedGeneric": "WSL environment detected",
+  "wslPathInfo": "Configuration path: {path}",
+  "wslInstallSuccess": "Claude Code successfully installed in WSL environment"
 }

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

@@ -3,7 +3,7 @@
   "menuDescriptions.ccusage": "Claude Code usage analysis",
   "menuDescriptions.changeLanguage": "Change ZCF interface language",
   "menuDescriptions.checkUpdates": "Check and update Claude Code, CCR and CCometixLine versions",
-  "menuDescriptions.clearCache": "Clear preference language and other caches",
+  "menuDescriptions.uninstall": "Remove Claude Code configurations and tools from your system",
   "menuDescriptions.cometixLine": "High-performance Claude Code statusline tool with Git integration and real-time usage tracking",
   "menuDescriptions.configureAiMemory": "Configure AI output language and output styles",
   "menuDescriptions.configureApiOrCcr": "Configure API URL, authentication or CCR proxy",
@@ -16,7 +16,7 @@
   "menuOptions.ccusage": "ccusage",
   "menuOptions.changeLanguage": "Select display language / 更改显示语言",
   "menuOptions.checkUpdates": "Check updates",
-  "menuOptions.clearCache": "Clear preference cache",
+  "menuOptions.uninstall": "Uninstall & Remove Configurations",
   "menuOptions.cometixLine": "CCometixLine",
   "menuOptions.configureAiMemory": "Configure Claude global memory",
   "menuOptions.configureApiOrCcr": "Configure API / CCR proxy",

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

@@ -0,0 +1,60 @@
+{
+  "title": "ZCF Uninstaller",
+  "warning": "⚠️  This will permanently remove Claude Code configurations and tools from your system.",
+  "selectMainOption": "Select uninstall option:",
+  "completeUninstall": "Complete Uninstall",
+  "completeUninstallDesc": "Remove all Claude Code related configurations and tools",
+  "customUninstall": "Custom Uninstall",
+  "customUninstallDesc": "Select specific items to remove",
+  "selectCustomItems": "Select items to remove:",
+  "selectItemsToRemove": "Choose configurations and tools to remove:",
+  "selectAtLeastOne": "Please select at least one item to remove.",
+  "executingComplete": "🗑️  Executing Complete Uninstall",
+  "executingCustom": "🗑️  Executing Custom Uninstall",
+  "completeWarning": "⚠️  This will remove ALL Claude Code configurations, directories, and tools. This action cannot be undone!",
+  "confirmComplete": "Are you sure you want to completely uninstall Claude Code and all related tools?",
+  "confirmCustom": "Are you sure you want to remove the selected items?",
+  "processingComplete": "🔄 Processing complete uninstall...",
+  "processingCustom": "🔄 Processing custom uninstall...",
+  "selectedItems": "Selected items:",
+  "removed": "Moved to trash/recycle bin",
+  "movedToTrash": "Moved to trash/recycle bin",
+  "removedConfigs": "Configuration removed",
+  "errors": "Errors occurred",
+  "warnings": "Warnings",
+  "completeSuccess": "Complete uninstall completed successfully! All files moved to trash/recycle bin.",
+  "completePartialSuccess": "Complete uninstall completed with some warnings.",
+  "customSuccess": "Custom uninstall completed successfully! Processed {{count}} items.",
+  "customSuccessFiles": "Custom uninstall completed successfully! Moved {{count}} files/directories to trash/recycle bin.",
+  "customSuccessConfigs": "Custom uninstall completed successfully! Removed {{count}} configuration items.",
+  "customSuccessBoth": "Custom uninstall completed successfully! Moved {{fileCount}} files/directories to trash/recycle bin and removed {{configCount}} configuration items.",
+  "errorsCount": "{{count}} errors occurred during uninstall.",
+  "warningsCount": "{{count}} warnings occurred during uninstall.",
+
+  "outputStyles": "Output Styles - Remove output style configurations",
+  "commands": "Commands - Remove custom ZCF commands",
+  "agents": "Agents - Remove custom ZCF agents",
+  "claudeMd": "CLAUDE.md - Remove global memory file",
+  "permissionsEnvs": "Permissions & Envs - Remove permissions and environment variables",
+  "mcps": "MCPs - Remove MCP server configurations",
+  "ccr": "Claude Code Router - Uninstall CCR and remove configurations",
+  "ccline": "CCometixLine - Uninstall status line tool",
+  "claudeCode": "Claude Code - Uninstall Claude Code and configurations",
+  "backups": "Backups - Remove backup files",
+  "zcfConfig": "ZCF Config - Remove ZCF preference configurations",
+
+  "outputStyleNotFound": "Output style field not found in settings.json",
+  "settingsJsonNotFound": "settings.json not found",
+  "commandsNotFound": "Commands directory not found",
+  "agentsNotFound": "Agents directory not found",
+  "claudeMdNotFound": "CLAUDE.md file not found",
+  "noPermissionsOrEnvFound": "No permissions or environment variables found",
+  "mcpServersNotFound": "MCP servers configuration not found",
+  "claudeJsonNotFound": ".claude.json file not found",
+  "ccrPackageNotFound": "Claude Code Router package not found",
+  "cclinePackageNotFound": "CCometixLine package not found",
+  "claudeCodePackageNotFound": "Claude Code package not found",
+  "backupsNotFound": "Backup directory not found",
+  "zcfConfigNotFound": "ZCF configuration file not found",
+  "outputStylesDirectoryNotFound": "Output styles directory not found"
+}

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

@@ -9,6 +9,7 @@
   "help.commandDescriptions.updateWorkflowFiles": "仅更新工作流相关md",
   "help.commandDescriptions.configureCcrProxy": "配置模型路由代理",
   "help.commandDescriptions.claudeCodeUsageAnalysis": "Claude Code 用量统计分析",
+  "help.commandDescriptions.uninstallConfigurations": "删除 Claude Code 配置和工具",
   "help.commandDescriptions.checkUpdateVersions": "检查并更新到最新版本",
   "help.shortcutDescriptions.quickInit": "快速初始化",
   "help.shortcutDescriptions.quickUpdate": "快速更新",
@@ -35,11 +36,13 @@
   "help.exampleDescriptions.updateWorkflowFilesOnly": "仅更新工作流相关md文件",
   "help.exampleDescriptions.configureClaudeCodeRouter": "配置 Claude Code Router",
   "help.exampleDescriptions.runClaudeCodeUsageAnalysis": "运行 Claude Code 用量分析",
+  "help.exampleDescriptions.uninstallConfigurations": "卸载配置和工具",
   "help.exampleDescriptions.checkAndUpdateTools": "检查并更新工具",
   "help.exampleDescriptions.nonInteractiveModeCicd": "非交互模式（CI/CD）",
   "banner.subtitle": "Claude Code 一键配置工具",
   "banner.updateSubtitle": "更新 Claude Code 配置",
   "help.defaults.dailyUsage": "每日用量（默认）",
+  "help.defaults.interactiveUninstall": "交互式卸载菜单",
   "help.defaults.updateTools": "更新 Claude Code、CCR 和 CCometixLine",
   "help.defaults.prefix": "默认:"
 }

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

@@ -24,5 +24,9 @@
   "onlyLocalInstallationDetected": "检测到仅有本地安装",
   "notInstalled": "未安装",
   "installingGlobalClaudeCode": "正在安装全局 Claude Code",
-  "globalInstallationCompleted": "全局安装完成"
+  "globalInstallationCompleted": "全局安装完成",
+  "wslDetected": "检测到 WSL 环境 ({distro})",
+  "wslDetectedGeneric": "检测到 WSL 环境",
+  "wslPathInfo": "配置文件位置：{path}",
+  "wslInstallSuccess": "Claude Code 已成功安装在 WSL 环境中"
 }

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

@@ -3,7 +3,7 @@
   "menuDescriptions.ccusage": "Claude Code 用量分析",
   "menuDescriptions.changeLanguage": "更改 ZCF 界面语言",
   "menuDescriptions.checkUpdates": "检查并更新 Claude Code、CCR 和 CCometixLine 的版本",
-  "menuDescriptions.clearCache": "清除偏好语言等缓存",
+  "menuDescriptions.uninstall": "从系统中删除 Claude Code 配置和工具",
   "menuDescriptions.cometixLine": "基于 Rust 的高性能 Claude Code 状态栏工具，集成 Git 信息和实时使用量跟踪",
   "menuDescriptions.configureAiMemory": "配置 AI 输出语言和输出风格",
   "menuDescriptions.configureApiOrCcr": "配置 API URL、认证信息或 CCR 代理",
@@ -16,7 +16,7 @@
   "menuOptions.ccusage": "ccusage",
   "menuOptions.changeLanguage": "更改显示语言 / Select display language",
   "menuOptions.checkUpdates": "检查更新",
-  "menuOptions.clearCache": "清除偏好缓存",
+  "menuOptions.uninstall": "卸载和删除配置",
   "menuOptions.cometixLine": "CCometixLine",
   "menuOptions.configureAiMemory": "配置 Claude 全局记忆",
   "menuOptions.configureApiOrCcr": "配置 API 或 CCR 代理",

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

@@ -0,0 +1,60 @@
+{
+  "title": "ZCF 卸载工具",
+  "warning": "⚠️  这将永久删除您系统中的 Claude Code 配置和工具。",
+  "selectMainOption": "选择卸载选项:",
+  "completeUninstall": "完全卸载",
+  "completeUninstallDesc": "删除所有 Claude Code 相关配置和工具",
+  "customUninstall": "自定义卸载",
+  "customUninstallDesc": "选择特定项目进行删除",
+  "selectCustomItems": "选择要删除的项目:",
+  "selectItemsToRemove": "选择要删除的配置和工具:",
+  "selectAtLeastOne": "请至少选择一个要删除的项目。",
+  "executingComplete": "🗑️  执行完全卸载",
+  "executingCustom": "🗑️  执行自定义卸载",
+  "completeWarning": "⚠️  这将删除所有 Claude Code 配置、目录和工具。此操作无法撤销！",
+  "confirmComplete": "您确定要完全卸载 Claude Code 和所有相关工具吗？",
+  "confirmCustom": "您确定要删除选定的项目吗？",
+  "processingComplete": "🔄 正在处理完全卸载...",
+  "processingCustom": "🔄 正在处理自定义卸载...",
+  "selectedItems": "选定项目:",
+  "removed": "已移至废纸篓/回收站",
+  "movedToTrash": "已移至废纸篓/回收站",
+  "removedConfigs": "已删除配置项",
+  "errors": "发生错误",
+  "warnings": "警告",
+  "completeSuccess": "完全卸载成功完成！所有文件已移至废纸篓/回收站。",
+  "completePartialSuccess": "完全卸载已完成，但有一些警告。",
+  "customSuccess": "自定义卸载成功完成！已处理 {{count}} 个项目。",
+  "customSuccessFiles": "自定义卸载成功完成！已将 {{count}} 个文件/目录移至废纸篓/回收站。",
+  "customSuccessConfigs": "自定义卸载成功完成！已删除 {{count}} 个配置项。",
+  "customSuccessBoth": "自定义卸载成功完成！已将 {{fileCount}} 个文件/目录移至废纸篓/回收站，已删除 {{configCount}} 个配置项。",
+  "errorsCount": "卸载过程中发生了 {{count}} 个错误。",
+  "warningsCount": "卸载过程中发生了 {{count}} 个警告。",
+
+  "outputStyles": "输出风格 - 删除输出风格配置",
+  "commands": "自定义指令 - 删除自定义 ZCF 指令",
+  "agents": "自定义代理 - 删除自定义 ZCF 代理",
+  "claudeMd": "CLAUDE.md - 删除全局记忆文件",
+  "permissionsEnvs": "权限和环境变量 - 删除权限配置和环境变量",
+  "mcps": "MCP 服务 - 删除 MCP 服务器配置",
+  "ccr": "Claude Code Router - 卸载 CCR 并删除配置",
+  "ccline": "CCometixLine - 卸载状态栏工具",
+  "claudeCode": "Claude Code - 卸载 Claude Code 和配置",
+  "backups": "备份文件 - 删除备份文件",
+  "zcfConfig": "ZCF 配置 - 删除 ZCF 偏好设置配置",
+
+  "outputStyleNotFound": "在 settings.json 中未找到输出风格字段",
+  "settingsJsonNotFound": "未找到 settings.json 文件",
+  "commandsNotFound": "未找到指令目录",
+  "agentsNotFound": "未找到代理目录",
+  "claudeMdNotFound": "未找到 CLAUDE.md 文件",
+  "noPermissionsOrEnvFound": "未找到权限或环境变量配置",
+  "mcpServersNotFound": "未找到 MCP 服务器配置",
+  "claudeJsonNotFound": "未找到 .claude.json 文件",
+  "ccrPackageNotFound": "未找到 Claude Code Router 包",
+  "cclinePackageNotFound": "未找到 CCometixLine 包",
+  "claudeCodePackageNotFound": "未找到 Claude Code 包",
+  "backupsNotFound": "未找到备份目录",
+  "zcfConfigNotFound": "未找到 ZCF 配置文件",
+  "outputStylesDirectoryNotFound": "未找到输出风格目录"
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "zcf",
   "type": "module",
-  "version": "2.12.11",
+  "version": "2.12.13",
   "description": "Zero-Config Claude-Code Flow - One-click configuration tool for Claude Code",
   "author": {
     "name": "Miao Da",
@@ -40,30 +40,33 @@
     "templates"
   ],
   "dependencies": {
-    "@types/semver": "^7.7.0",
+    "@types/semver": "^7.7.1",
     "ansis": "^4.1.0",
     "cac": "^6.7.14",
     "dayjs": "^1.11.18",
     "find-up-simple": "^1.0.1",
-    "i18next": "^25.4.2",
+    "fs-extra": "^11.3.1",
+    "i18next": "^25.5.2",
     "i18next-fs-backend": "^2.6.0",
     "inquirer": "^12.9.4",
     "ora": "^8.2.0",
     "pathe": "^2.0.3",
     "semver": "^7.7.2",
-    "tinyexec": "^1.0.1"
+    "tinyexec": "^1.0.1",
+    "trash": "^10.0.0"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^5.2.1",
-    "@changesets/cli": "^2.29.6",
+    "@antfu/eslint-config": "^5.3.0",
+    "@changesets/cli": "^2.29.7",
     "@commitlint/cli": "^19.8.1",
     "@commitlint/config-conventional": "^19.8.1",
     "@commitlint/types": "^19.8.1",
+    "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.9",
-    "@types/node": "^22.18.0",
+    "@types/node": "^22.18.3",
     "@vitest/coverage-v8": "^3.2.4",
     "@vitest/ui": "^3.2.4",
-    "eslint": "^9.34.0",
+    "eslint": "^9.35.0",
     "eslint-plugin-format": "^1.0.1",
     "glob": "^11.0.3",
     "husky": "^9.1.7",