zcf 1.1.5 → 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 { t as displayBanner, u as selectScriptLanguage, v as readZcfConfig, I as I18N, S as SETTINGS_FILE, b as SUPPORTED_LANGS, L as LANG_LABELS, x as resolveAiOutputLanguage, y as updatePromptOnly, z as updateZcfConfig, B as version, i as init } from './shared/zcf.CeJug3gT.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

@@ -23,14 +23,15 @@ interface McpServerConfig {
     url?: string;
     env?: Record<string, string>;
 }
-interface McpConfiguration {
+interface ClaudeConfiguration {
     mcpServers: Record<string, McpServerConfig>;
+    hasCompletedOnboarding?: boolean;
 }
 
 declare const CLAUDE_DIR: string;
 declare const SETTINGS_FILE: string;
 declare const CLAUDE_MD_FILE: string;
-declare const MCP_CONFIG_FILE: string;
+declare const ClAUDE_CONFIG_FILE: string;
 declare const ZCF_CONFIG_FILE: string;
 declare const SUPPORTED_LANGS: readonly ["zh-CN", "en"];
 type SupportedLang = (typeof SUPPORTED_LANGS)[number];
@@ -206,11 +207,13 @@ declare function mergeConfigs(sourceFile: string, targetFile: string): void;
 declare function applyAiLanguageDirective(aiOutputLang: AiOutputLanguage | string): void;
 
 declare function getMcpConfigPath(): string;
-declare function readMcpConfig(): McpConfiguration | null;
-declare function writeMcpConfig(config: McpConfiguration): void;
+declare function readMcpConfig(): ClaudeConfiguration | null;
+declare function writeMcpConfig(config: ClaudeConfiguration): void;
 declare function backupMcpConfig(): string | null;
-declare function mergeMcpServers(existing: McpConfiguration | null, newServers: Record<string, McpServerConfig>): McpConfiguration;
+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, I18N, LANG_LABELS, MCP_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, getMcpConfigPath, getPlatform, init, installClaudeCode, isClaudeCodeInstalled, mergeConfigs, mergeMcpServers, readMcpConfig, writeMcpConfig };
-export type { AiOutputLanguage, ApiConfig, McpConfiguration, McpServerConfig, McpService, SupportedLang };
+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

@@ -23,14 +23,15 @@ interface McpServerConfig {
     url?: string;
     env?: Record<string, string>;
 }
-interface McpConfiguration {
+interface ClaudeConfiguration {
     mcpServers: Record<string, McpServerConfig>;
+    hasCompletedOnboarding?: boolean;
 }
 
 declare const CLAUDE_DIR: string;
 declare const SETTINGS_FILE: string;
 declare const CLAUDE_MD_FILE: string;
-declare const MCP_CONFIG_FILE: string;
+declare const ClAUDE_CONFIG_FILE: string;
 declare const ZCF_CONFIG_FILE: string;
 declare const SUPPORTED_LANGS: readonly ["zh-CN", "en"];
 type SupportedLang = (typeof SUPPORTED_LANGS)[number];
@@ -206,11 +207,13 @@ declare function mergeConfigs(sourceFile: string, targetFile: string): void;
 declare function applyAiLanguageDirective(aiOutputLang: AiOutputLanguage | string): void;
 
 declare function getMcpConfigPath(): string;
-declare function readMcpConfig(): McpConfiguration | null;
-declare function writeMcpConfig(config: McpConfiguration): void;
+declare function readMcpConfig(): ClaudeConfiguration | null;
+declare function writeMcpConfig(config: ClaudeConfiguration): void;
 declare function backupMcpConfig(): string | null;
-declare function mergeMcpServers(existing: McpConfiguration | null, newServers: Record<string, McpServerConfig>): McpConfiguration;
+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, I18N, LANG_LABELS, MCP_CONFIG_FILE, MCP_SERVICES, SETTINGS_FILE, SUPPORTED_LANGS, ZCF_CONFIG_FILE, applyAiLanguageDirective, backupExistingConfig, backupMcpConfig, buildMcpServerConfig, commandExists, configureApi, copyConfigFiles, ensureClaudeDir, getMcpConfigPath, getPlatform, init, installClaudeCode, isClaudeCodeInstalled, mergeConfigs, mergeMcpServers, readMcpConfig, writeMcpConfig };
-export type { AiOutputLanguage, ApiConfig, McpConfiguration, McpServerConfig, McpService, SupportedLang };
+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, I as I18N, L as LANG_LABELS, M as MCP_CONFIG_FILE, d as MCP_SERVICES, S as SETTINGS_FILE, b as SUPPORTED_LANGS, Z as ZCF_CONFIG_FILE, 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.CeJug3gT.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.CeJug3gT.mjs → zcf.D3MMT8L8.mjs}

@@ -6,12 +6,12 @@ import { join, dirname } from 'pathe';
 import dayjs from 'dayjs';
 import { exec } from 'tinyexec';
 
-const version = "1.1.5";
+const version = "1.2.0";
 
 const CLAUDE_DIR = join(homedir(), ".claude");
 const SETTINGS_FILE = join(CLAUDE_DIR, "settings.json");
 const CLAUDE_MD_FILE = join(CLAUDE_DIR, "CLAUDE.md");
-const MCP_CONFIG_FILE = join(homedir(), ".claude.json");
+const ClAUDE_CONFIG_FILE = join(homedir(), ".claude.json");
 const ZCF_CONFIG_FILE = join(homedir(), ".zcf.json");
 const SUPPORTED_LANGS = ["zh-CN", "en"];
 const LANG_LABELS = {
@@ -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";
@@ -444,14 +453,14 @@ async function installClaudeCode(lang) {
 }
 
 function getMcpConfigPath() {
-  return MCP_CONFIG_FILE;
+  return ClAUDE_CONFIG_FILE;
 }
 function readMcpConfig() {
-  if (!existsSync(MCP_CONFIG_FILE)) {
+  if (!existsSync(ClAUDE_CONFIG_FILE)) {
     return null;
   }
   try {
-    const content = readFileSync(MCP_CONFIG_FILE, "utf-8");
+    const content = readFileSync(ClAUDE_CONFIG_FILE, "utf-8");
     return JSON.parse(content);
   } catch (error) {
     console.error("Failed to parse MCP config:", error);
@@ -459,14 +468,14 @@ function readMcpConfig() {
   }
 }
 function writeMcpConfig(config) {
-  const dir = dirname(MCP_CONFIG_FILE);
+  const dir = dirname(ClAUDE_CONFIG_FILE);
   if (!existsSync(dir)) {
     mkdirSync(dir, { recursive: true });
   }
-  writeFileSync(MCP_CONFIG_FILE, JSON.stringify(config, null, 2));
+  writeFileSync(ClAUDE_CONFIG_FILE, JSON.stringify(config, null, 2));
 }
 function backupMcpConfig() {
-  if (!existsSync(MCP_CONFIG_FILE)) {
+  if (!existsSync(ClAUDE_CONFIG_FILE)) {
     return null;
   }
   const timestamp = dayjs().format("YYYY-MM-DD_HH-mm-ss");
@@ -476,7 +485,7 @@ function backupMcpConfig() {
     if (!existsSync(backupBaseDir)) {
       mkdirSync(backupBaseDir, { recursive: true });
     }
-    const content = readFileSync(MCP_CONFIG_FILE, "utf-8");
+    const content = readFileSync(ClAUDE_CONFIG_FILE, "utf-8");
     writeFileSync(backupPath, content);
     return backupPath;
   } catch (error) {
@@ -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,32 @@ 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();
+    if (!config) {
+      config = { mcpServers: {} };
+    }
+    config.hasCompletedOnboarding = true;
+    config = fixWindowsMcpConfig(config);
+    writeMcpConfig(config);
+  } catch (error) {
+    console.error("Failed to add hasCompletedOnboarding flag:", error);
+    throw error;
+  }
+}
 
 function readZcfConfig() {
   try {
@@ -838,6 +881,11 @@ async function init(options = {}) {
         console.log(ansis.green(`\u2714 ${i18n.apiConfigSuccess}`));
         console.log(ansis.gray(`  URL: ${configuredApi.url}`));
         console.log(ansis.gray(`  Key: ${formatApiKeyDisplay(configuredApi.key)}`));
+        try {
+          addCompletedOnboarding();
+        } catch (error) {
+          console.error(ansis.red("Failed to set onboarding completion flag:"), error);
+        }
       }
     }
     if (!onlyUpdateDocs) {
@@ -852,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),
@@ -910,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}`));
@@ -933,4 +985,4 @@ async function init(options = {}) {
   }
 }
 
-export { AI_OUTPUT_LANGUAGES as A, version as B, CLAUDE_DIR as C, I18N as I, LANG_LABELS as L, MCP_CONFIG_FILE as M, SETTINGS_FILE as S, ZCF_CONFIG_FILE as Z, CLAUDE_MD_FILE as a, SUPPORTED_LANGS as b, commandExists as c, MCP_SERVICES 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, displayBanner as t, selectScriptLanguage as u, readZcfConfig as v, writeMcpConfig as w, resolveAiOutputLanguage as x, updatePromptOnly as y, updateZcfConfig 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.5",
+  "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",