zcf 2.12.11 → 2.12.12

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)
@@ -647,6 +647,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.12";
 const homepage = "https://github.com/UfoMiao/zcf";
 
 const i18n = i18next.createInstance();
@@ -717,6 +717,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 +2564,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 +2581,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()) {

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

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