zcf 1.1.6 → 1.2.0

package/README.md

@@ -285,6 +285,16 @@ node bin/zcf.mjs
 2. 检查 `~/.claude/` 目录下的配置文件
 3. 确保 Claude Code 已正确安装
 
+### Windows 平台支持
+
+ZCF 已完全支持 Windows 平台：
+
+- **自动检测**：在 Windows 系统上会自动使用兼容的 `cmd /c npx` 格式
+- **配置修复**：现有的错误配置会在更新时自动修复
+- **零配置**：Windows 用户无需任何额外操作，与 macOS/Linux 体验一致
+
+如果在 Windows 上遇到 MCP 连接问题，运行 `npx zcf` 会自动修复配置格式。
+
 ## 🙏 鸣谢
 
 本项目的部分 Prompt 参考了以下优秀作品：

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { u as displayBanner, v as selectScriptLanguage, x as readZcfConfig, I as I18N, S as SETTINGS_FILE, d as SUPPORTED_LANGS, L as LANG_LABELS, y as resolveAiOutputLanguage, z as updatePromptOnly, B as updateZcfConfig, D as version, i as init } from './shared/zcf.Dke_fzoC.mjs';
+import { v as displayBanner, x as selectScriptLanguage, y as readZcfConfig, I as I18N, S as SETTINGS_FILE, d as SUPPORTED_LANGS, L as LANG_LABELS, z as resolveAiOutputLanguage, B as updatePromptOnly, D as updateZcfConfig, E as version, i as init } from './shared/zcf.D3MMT8L8.mjs';
 import prompts from '@posva/prompts';
 import { existsSync } from 'node:fs';
 import 'node:os';

package/dist/index.d.mts

@@ -212,7 +212,8 @@ declare function writeMcpConfig(config: ClaudeConfiguration): void;
 declare function backupMcpConfig(): string | null;
 declare function mergeMcpServers(existing: ClaudeConfiguration | null, newServers: Record<string, McpServerConfig>): ClaudeConfiguration;
 declare function buildMcpServerConfig(baseConfig: McpServerConfig, apiKey?: string, placeholder?: string): McpServerConfig;
+declare function fixWindowsMcpConfig(config: ClaudeConfiguration): ClaudeConfiguration;
 declare function addCompletedOnboarding(): void;
 
-export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, getMcpConfigPath, getPlatform, init, installClaudeCode, isClaudeCodeInstalled, mergeConfigs, mergeMcpServers, readMcpConfig, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getMcpConfigPath, getPlatform, init, installClaudeCode, isClaudeCodeInstalled, mergeConfigs, mergeMcpServers, readMcpConfig, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.d.ts

@@ -212,7 +212,8 @@ declare function writeMcpConfig(config: ClaudeConfiguration): void;
 declare function backupMcpConfig(): string | null;
 declare function mergeMcpServers(existing: ClaudeConfiguration | null, newServers: Record<string, McpServerConfig>): ClaudeConfiguration;
 declare function buildMcpServerConfig(baseConfig: McpServerConfig, apiKey?: string, placeholder?: string): McpServerConfig;
+declare function fixWindowsMcpConfig(config: ClaudeConfiguration): ClaudeConfiguration;
 declare function addCompletedOnboarding(): void;
 
-export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, getMcpConfigPath, getPlatform, init, installClaudeCode, isClaudeCodeInstalled, mergeConfigs, mergeMcpServers, readMcpConfig, writeMcpConfig };
+export { AI_OUTPUT_LANGUAGES, CLAUDE_DIR, CLAUDE_MD_FILE, ClAUDE_CONFIG_FILE, I18N, LANG_LABELS, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, addCompletedOnboarding, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, fixWindowsMcpConfig, getMcpConfigPath, getPlatform, init, installClaudeCode, isClaudeCodeInstalled, mergeConfigs, mergeMcpServers, readMcpConfig, writeMcpConfig };
 export type { AiOutputLanguage, ApiConfig, ClaudeConfiguration, McpServerConfig, McpService, SupportedLang };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, a as CLAUDE_MD_FILE, b as ClAUDE_CONFIG_FILE, I as I18N, L as LANG_LABELS, M as MCP_SERVICES, S as SETTINGS_FILE, d as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, t as addCompletedOnboarding, n as applyAiLanguageDirective, j as backupExistingConfig, p as backupMcpConfig, s as buildMcpServerConfig, c as commandExists, l as configureApi, k as copyConfigFiles, h as ensureClaudeDir, o as getMcpConfigPath, g as getPlatform, i as init, f as installClaudeCode, e as isClaudeCodeInstalled, m as mergeConfigs, q as mergeMcpServers, r as readMcpConfig, w as writeMcpConfig } from './shared/zcf.Dke_fzoC.mjs';
+export { A as AI_OUTPUT_LANGUAGES, C as CLAUDE_DIR, a as CLAUDE_MD_FILE, b as ClAUDE_CONFIG_FILE, I as I18N, L as LANG_LABELS, M as MCP_SERVICES, S as SETTINGS_FILE, d as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, u as addCompletedOnboarding, n as applyAiLanguageDirective, j as backupExistingConfig, p as backupMcpConfig, s as buildMcpServerConfig, c as commandExists, l as configureApi, k as copyConfigFiles, h as ensureClaudeDir, t as fixWindowsMcpConfig, o as getMcpConfigPath, g as getPlatform, i as init, f as installClaudeCode, e as isClaudeCodeInstalled, m as mergeConfigs, q as mergeMcpServers, r as readMcpConfig, w as writeMcpConfig } from './shared/zcf.D3MMT8L8.mjs';
 import '@posva/prompts';
 import 'ansis';
 import 'node:fs';

package/dist/shared/{zcf.Dke_fzoC.mjs → zcf.D3MMT8L8.mjs}

@@ -6,7 +6,7 @@ import { join, dirname } from 'pathe';
 import dayjs from 'dayjs';
 import { exec } from 'tinyexec';
 
-const version = "1.1.6";
+const version = "1.2.0";
 
 const CLAUDE_DIR = join(homedir(), ".claude");
 const SETTINGS_FILE = join(CLAUDE_DIR, "settings.json");
@@ -415,6 +415,15 @@ function getPlatform() {
   if (p === "darwin") return "macos";
   return "linux";
 }
+function isWindows() {
+  return getPlatform() === "windows";
+}
+function getMcpCommand() {
+  if (isWindows()) {
+    return ["cmd", "/c", "npx"];
+  }
+  return ["npx"];
+}
 async function commandExists(command) {
   try {
     const cmd = getPlatform() === "windows" ? "where" : "which";
@@ -492,11 +501,19 @@ function mergeMcpServers(existing, newServers) {
   Object.assign(config.mcpServers, newServers);
   return config;
 }
+function applyPlatformCommand(config) {
+  if (config.command === "npx" && isWindows()) {
+    const mcpCmd = getMcpCommand();
+    config.command = mcpCmd[0];
+    config.args = [...mcpCmd.slice(1), ...config.args || []];
+  }
+}
 function buildMcpServerConfig(baseConfig, apiKey, placeholder = "YOUR_EXA_API_KEY") {
+  const config = JSON.parse(JSON.stringify(baseConfig));
+  applyPlatformCommand(config);
   if (!apiKey) {
-    return { ...baseConfig };
+    return config;
   }
-  const config = JSON.parse(JSON.stringify(baseConfig));
   if (config.args) {
     config.args = config.args.map((arg) => arg.replace(placeholder, apiKey));
   }
@@ -505,6 +522,18 @@ function buildMcpServerConfig(baseConfig, apiKey, placeholder = "YOUR_EXA_API_KE
   }
   return config;
 }
+function fixWindowsMcpConfig(config) {
+  if (!isWindows() || !config.mcpServers) {
+    return config;
+  }
+  const fixed = { ...config };
+  for (const [, serverConfig] of Object.entries(fixed.mcpServers)) {
+    if (serverConfig && typeof serverConfig === "object" && "command" in serverConfig) {
+      applyPlatformCommand(serverConfig);
+    }
+  }
+  return fixed;
+}
 function addCompletedOnboarding() {
   try {
     let config = readMcpConfig();
@@ -512,6 +541,7 @@ function addCompletedOnboarding() {
       config = { mcpServers: {} };
     }
     config.hasCompletedOnboarding = true;
+    config = fixWindowsMcpConfig(config);
     writeMcpConfig(config);
   } catch (error) {
     console.error("Failed to add hasCompletedOnboarding flag:", error);
@@ -870,6 +900,9 @@ async function init(options = {}) {
         process.exit(0);
       }
       if (mcpResponse.shouldConfigureMcp) {
+        if (isWindows()) {
+          console.log(ansis.blue(`\u2139 ${scriptLang === "zh-CN" ? "\u68C0\u6D4B\u5230 Windows \u7CFB\u7EDF\uFF0C\u5C06\u81EA\u52A8\u914D\u7F6E\u517C\u5BB9\u683C\u5F0F" : "Windows detected, will configure compatible format"}`));
+        }
         const choices = [
           {
             title: ansis.bold(i18n.allServices),
@@ -928,7 +961,8 @@ async function init(options = {}) {
             newServers[service.id] = config;
           }
           const existingConfig = readMcpConfig();
-          const mergedConfig = mergeMcpServers(existingConfig, newServers);
+          let mergedConfig = mergeMcpServers(existingConfig, newServers);
+          mergedConfig = fixWindowsMcpConfig(mergedConfig);
           try {
             writeMcpConfig(mergedConfig);
             console.log(ansis.green(`\u2714 ${i18n.mcpConfigSuccess}`));
@@ -951,4 +985,4 @@ async function init(options = {}) {
   }
 }
 
-export { AI_OUTPUT_LANGUAGES as A, updateZcfConfig as B, CLAUDE_DIR as C, version as D, I18N as I, LANG_LABELS as L, MCP_SERVICES as M, SETTINGS_FILE as S, ZCF_CONFIG_FILE as Z, CLAUDE_MD_FILE as a, ClAUDE_CONFIG_FILE as b, commandExists as c, SUPPORTED_LANGS as d, isClaudeCodeInstalled as e, installClaudeCode as f, getPlatform as g, ensureClaudeDir as h, init as i, backupExistingConfig as j, copyConfigFiles as k, configureApi as l, mergeConfigs as m, applyAiLanguageDirective as n, getMcpConfigPath as o, backupMcpConfig as p, mergeMcpServers as q, readMcpConfig as r, buildMcpServerConfig as s, addCompletedOnboarding as t, displayBanner as u, selectScriptLanguage as v, writeMcpConfig as w, readZcfConfig as x, resolveAiOutputLanguage as y, updatePromptOnly as z };
+export { AI_OUTPUT_LANGUAGES as A, updatePromptOnly as B, CLAUDE_DIR as C, updateZcfConfig as D, version as E, I18N as I, LANG_LABELS as L, MCP_SERVICES as M, SETTINGS_FILE as S, ZCF_CONFIG_FILE as Z, CLAUDE_MD_FILE as a, ClAUDE_CONFIG_FILE as b, commandExists as c, SUPPORTED_LANGS as d, isClaudeCodeInstalled as e, installClaudeCode as f, getPlatform as g, ensureClaudeDir as h, init as i, backupExistingConfig as j, copyConfigFiles as k, configureApi as l, mergeConfigs as m, applyAiLanguageDirective as n, getMcpConfigPath as o, backupMcpConfig as p, mergeMcpServers as q, readMcpConfig as r, buildMcpServerConfig as s, fixWindowsMcpConfig as t, addCompletedOnboarding as u, displayBanner as v, writeMcpConfig as w, selectScriptLanguage as x, readZcfConfig as y, resolveAiOutputLanguage as z };

package/package.json

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