ccg-workflow 1.7.80 → 1.7.82

package/README.md

@@ -243,6 +243,7 @@ npx ccg-workflow menu  # Select "Configure MCP"
 
 **Code retrieval** (choose one):
 - **ace-tool** (recommended) — Code search via `search_context`. [Official](https://augmentcode.com/) | [Third-party proxy](https://acemcp.heroman.wtf/)
+- **fast-context** (recommended) — Windsurf Fast Context, AI-powered search without full-repo indexing. Requires Windsurf account
 - **ContextWeaver** (alternative) — Local hybrid search, requires SiliconFlow API Key (free)
 
 **Optional tools**:
@@ -353,4 +354,4 @@ MIT
 
 ---
 
-v1.7.79 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)
+v1.7.82 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [Contributing](./CONTRIBUTING.md)

package/README.zh-CN.md

@@ -241,8 +241,9 @@ npx ccg-workflow menu  # 选择「安装 Claude Code」
 npx ccg-workflow menu  # 选择「配置 MCP」
 ```
 
-**代码检索**（二选一）：
+**代码检索**（多选一）：
 - **ace-tool**（推荐）— 代码检索 `search_context` 可用。[官方](https://augmentcode.com/) | [第三方中转](https://acemcp.heroman.wtf/)
+- **fast-context**（推荐）— Windsurf Fast Context，AI 驱动搜索，无需全量索引。需 Windsurf 账号
 - **ContextWeaver**（备选）— 本地混合搜索，需要硅基流动 API Key（免费）
 
 **辅助工具**（可选）：
@@ -353,4 +354,4 @@ MIT
 
 ---
 
-v1.7.79 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [参与贡献](./CONTRIBUTING.md)
+v1.7.82 | [Issues](https://github.com/fengshao1227/ccg-workflow/issues) | [参与贡献](./CONTRIBUTING.md)

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import cac from 'cac';
 import ansis from 'ansis';
-import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.DKLTZQCk.mjs';
+import { z as diagnoseMcpConfig, A as isWindows, B as readClaudeCodeConfig, C as fixWindowsMcpConfig, D as writeClaudeCodeConfig, r as readCcgConfig, b as initI18n, a as i18n, s as showMainMenu, i as init, E as configMcp, F as version } from './shared/ccg-workflow.C7wxgYrc.mjs';
 import 'inquirer';
 import 'node:child_process';
 import 'node:util';

package/dist/index.d.mts

@@ -93,6 +93,10 @@ interface AceToolConfig {
     baseUrl: string;
     token: string;
 }
+interface FastContextConfig {
+    apiKey?: string;
+    includeSnippets?: boolean;
+}
 
 declare function init(options?: InitOptions): Promise<void>;
 
@@ -226,4 +230,4 @@ declare function checkForUpdates(): Promise<{
 }>;
 
 export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, update, writeCcgConfig };
-export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };
+export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, FastContextConfig, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };

package/dist/index.d.ts

@@ -93,6 +93,10 @@ interface AceToolConfig {
     baseUrl: string;
     token: string;
 }
+interface FastContextConfig {
+    apiKey?: string;
+    includeSnippets?: boolean;
+}
 
 declare function init(options?: InitOptions): Promise<void>;
 
@@ -226,4 +230,4 @@ declare function checkForUpdates(): Promise<{
 }>;
 
 export { changeLanguage, checkForUpdates, compareVersions, createDefaultConfig, createDefaultRouting, getCcgDir, getConfigPath, getCurrentVersion, getLatestVersion, getWorkflowById, getWorkflowConfigs, i18n, init, initI18n, installAceTool, installAceToolRs, installWorkflows, migrateToV1_4_0, needsMigration, readCcgConfig, showMainMenu, uninstallAceTool, uninstallWorkflows, update, writeCcgConfig };
-export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };
+export type { AceToolConfig, CcgConfig, CliOptions, CollaborationMode, FastContextConfig, InitOptions, InstallResult, ModelRouting, ModelType, RoutingStrategy, SupportedLang, WorkflowConfig };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.DKLTZQCk.mjs';
+export { c as changeLanguage, x as checkForUpdates, y as compareVersions, d as createDefaultConfig, e as createDefaultRouting, g as getCcgDir, f as getConfigPath, t as getCurrentVersion, v as getLatestVersion, j as getWorkflowById, h as getWorkflowConfigs, a as i18n, i as init, b as initI18n, l as installAceTool, m as installAceToolRs, k as installWorkflows, p as migrateToV1_4_0, q as needsMigration, r as readCcgConfig, s as showMainMenu, o as uninstallAceTool, n as uninstallWorkflows, u as update, w as writeCcgConfig } from './shared/ccg-workflow.C7wxgYrc.mjs';
 import 'ansis';
 import 'inquirer';
 import 'node:child_process';

package/dist/shared/{ccg-workflow.DKLTZQCk.mjs → ccg-workflow.C7wxgYrc.mjs}

@@ -10,7 +10,7 @@ import { parse, stringify } from 'smol-toml';
 import i18next from 'i18next';
 import ora from 'ora';
 
-const version = "1.7.80";
+const version = "1.7.82";
 
 function isWindows() {
   return process.platform === "win32";
@@ -563,6 +563,9 @@ function injectConfigVariables(content, config) {
   } else if (mcpProvider === "contextweaver") {
     processed = processed.replace(/\{\{MCP_SEARCH_TOOL\}\}/g, "mcp__contextweaver__codebase-retrieval");
     processed = processed.replace(/\{\{MCP_SEARCH_PARAM\}\}/g, "information_request");
+  } else if (mcpProvider === "fast-context") {
+    processed = processed.replace(/\{\{MCP_SEARCH_TOOL\}\}/g, "mcp__fast-context__fast_context_search");
+    processed = processed.replace(/\{\{MCP_SEARCH_PARAM\}\}/g, "query");
   } else {
     processed = processed.replace(/\{\{MCP_SEARCH_TOOL\}\}/g, "mcp__ace-tool__search_context");
     processed = processed.replace(/\{\{MCP_SEARCH_PARAM\}\}/g, "query");
@@ -1134,6 +1137,161 @@ async function uninstallContextWeaver() {
     };
   }
 }
+async function installFastContext(config) {
+  const { apiKey, includeSnippets } = config;
+  try {
+    let existingConfig = await readClaudeCodeConfig();
+    if (!existingConfig) {
+      existingConfig = { mcpServers: {} };
+    }
+    if (existingConfig.mcpServers && Object.keys(existingConfig.mcpServers).length > 0) {
+      const backupPath = await backupClaudeCodeConfig();
+      if (backupPath) {
+        console.log(`  \u2713 Backup created: ${backupPath}`);
+      }
+    }
+    const env = {};
+    if (apiKey) {
+      env.WINDSURF_API_KEY = apiKey;
+    }
+    if (includeSnippets) {
+      env.FC_INCLUDE_SNIPPETS = "true";
+    }
+    const fastContextConfig = buildMcpServerConfig({
+      type: "stdio",
+      command: "npx",
+      args: ["-y", "--prefer-online", "fast-context-mcp@latest"],
+      ...Object.keys(env).length > 0 ? { env } : {}
+    });
+    let mergedConfig = mergeMcpServers(existingConfig, {
+      "fast-context": fastContextConfig
+    });
+    if (isWindows()) {
+      mergedConfig = fixWindowsMcpConfig(mergedConfig);
+      console.log("  \u2713 Applied Windows MCP configuration fixes");
+    }
+    await writeClaudeCodeConfig(mergedConfig);
+    return {
+      success: true,
+      message: isWindows() ? "fast-context MCP configured successfully with Windows compatibility" : "fast-context MCP configured successfully",
+      configPath: join(homedir(), ".claude.json")
+    };
+  } catch (error) {
+    return {
+      success: false,
+      message: `Failed to configure fast-context: ${error}`
+    };
+  }
+}
+async function uninstallFastContext() {
+  try {
+    const existingConfig = await readClaudeCodeConfig();
+    if (existingConfig?.mcpServers?.["fast-context"]) {
+      delete existingConfig.mcpServers["fast-context"];
+      await writeClaudeCodeConfig(existingConfig);
+    }
+    return {
+      success: true,
+      message: "fast-context MCP uninstalled successfully"
+    };
+  } catch (error) {
+    return {
+      success: false,
+      message: `Failed to uninstall fast-context: ${error}`
+    };
+  }
+}
+const FAST_CONTEXT_PROMPT = `# fast-context MCP \u5DE5\u5177\u4F7F\u7528\u6307\u5357
+
+## \u6838\u5FC3\u539F\u5219
+
+**\u4EFB\u4F55\u9700\u8981\u7406\u89E3\u4EE3\u7801\u4E0A\u4E0B\u6587\u3001\u63A2\u7D22\u6027\u641C\u7D22\u3001\u6216\u81EA\u7136\u8BED\u8A00\u5B9A\u4F4D\u4EE3\u7801\u7684\u573A\u666F\uFF0C\u4F18\u5148\u4F7F\u7528 \`mcp__fast-context__fast_context_search\`**
+
+## \u4F7F\u7528\u573A\u666F
+
+### \u5FC5\u987B\u7528 fast_context_search
+- \u63A2\u7D22\u6027\u641C\u7D22\uFF08\u4E0D\u786E\u5B9A\u4EE3\u7801\u5728\u54EA\u4E2A\u6587\u4EF6/\u76EE\u5F55\uFF09
+- \u7528\u81EA\u7136\u8BED\u8A00\u63CF\u8FF0\u8981\u627E\u7684\u903B\u8F91\uFF08\u5982"\u90E8\u7F72\u6D41\u7A0B"\u3001"\u4E8B\u4EF6\u5904\u7406"\uFF09
+- \u7406\u89E3\u4E1A\u52A1\u903B\u8F91\u548C\u8C03\u7528\u94FE\u8DEF
+- \u8DE8\u6A21\u5757\u3001\u8DE8\u5C42\u7EA7\u67E5\u8BE2\uFF08\u5982\u4ECE router \u8FFD\u5230 service \u5230 model\uFF09
+- \u65B0\u4EFB\u52A1\u5F00\u59CB\u524D\u7684\u4EE3\u7801\u8C03\u7814\u548C\u67B6\u6784\u7406\u89E3
+- \u4E2D\u6587\u8BED\u4E49\u641C\u7D22\uFF08\u5DE5\u5177\u652F\u6301\u4E2D\u82F1\u6587\u53CC\u8BED\u67E5\u8BE2\uFF09
+
+### \u6839\u636E\u9700\u6C42\u9009\u62E9\u5DE5\u5177
+- **\u8BED\u4E49\u641C\u7D22 / \u4E0D\u786E\u5B9A\u4F4D\u7F6E** \u2192 \`mcp__fast-context__fast_context_search\`\uFF08\u8FD4\u56DE\u6587\u4EF6+\u884C\u53F7\u8303\u56F4+grep\u5173\u952E\u8BCD\u5EFA\u8BAE\uFF09
+- **\u7CBE\u786E\u5173\u952E\u8BCD\u641C\u7D22** \u2192 Grep
+- **\u5DF2\u77E5\u6587\u4EF6\u8DEF\u5F84\uFF0C\u67E5\u770B\u5185\u5BB9** \u2192 Read
+- **\u6309\u6587\u4EF6\u540D\u6A21\u5F0F\u67E5\u627E** \u2192 Glob
+- **\u7F16\u8F91\u5DF2\u6709\u6587\u4EF6** \u2192 Edit
+
+### fast_context_search \u53C2\u6570\u8C03\u4F18
+- \`tree_depth=1, max_turns=1\` \u2014 \u5FEB\u901F\u7C97\u67E5\uFF0C\u9002\u5408\u5C0F\u9879\u76EE\u6216\u521D\u6B65\u5B9A\u4F4D
+- \`tree_depth=3, max_turns=3\`\uFF08\u9ED8\u8BA4\uFF09\u2014 \u5E73\u8861\u7CBE\u5EA6\u4E0E\u901F\u5EA6\uFF0C\u9002\u5408\u5927\u591A\u6570\u573A\u666F
+- \`max_turns=5\` \u2014 \u6DF1\u5EA6\u641C\u7D22\uFF0C\u9002\u5408\u590D\u6742\u8C03\u7528\u94FE\u8FFD\u8E2A
+- \`project_path\` \u2014 \u6307\u5B9A\u641C\u7D22\u7684\u9879\u76EE\u6839\u76EE\u5F55\uFF0C\u9ED8\u8BA4\u4E3A\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55
+
+### \u7981\u6B62\u884C\u4E3A
+- \u274C \u731C\u6D4B\u4EE3\u7801\u4F4D\u7F6E\uFF08"\u5E94\u8BE5\u5728 service/firmware \u91CC"\uFF09
+- \u274C \u8DF3\u8FC7\u641C\u7D22\u76F4\u63A5\u56DE\u7B54\uFF08"\u6839\u636E\u6846\u67B6\u60EF\u4F8B\uFF0C\u5E94\u8BE5\u662F..."\uFF09
+- \u274C \u9047\u5230\u641C\u7D22\u5C31\u542F\u52A8\u5B50\u4EE3\u7406\uFF08fast-context + Grep \u7EC4\u5408\u4F18\u5148\uFF09
+
+### \u5B50\u4EE3\u7406\u4F7F\u7528\u6761\u4EF6
+\u4EC5\u5F53\u9700\u8981\u8BFB\u53D6 10+ \u6587\u4EF6\u4EA4\u53C9\u6BD4\u5BF9\u3001\u6216\u591A\u8F6E\u641C\u7D22\u4F1A\u6491\u7206\u4E0A\u4E0B\u6587\u65F6\uFF0C\u624D\u542F\u52A8\u5B50\u4EE3\u7406\u3002
+`;
+const FC_MARKER_START = "<!-- CCG-FAST-CONTEXT-START -->";
+const FC_MARKER_END = "<!-- CCG-FAST-CONTEXT-END -->";
+async function writeFastContextPrompt() {
+  const markerStart = FC_MARKER_START;
+  const markerEnd = FC_MARKER_END;
+  const markedBlock = `
+${markerStart}
+${FAST_CONTEXT_PROMPT}
+${markerEnd}
+`;
+  const markerRegex = new RegExp(
+    `\\n?${markerStart.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${markerEnd.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\n?`
+  );
+  async function injectIntoFile(filePath) {
+    const dir = dirname(filePath);
+    await fs.ensureDir(dir);
+    if (await fs.pathExists(filePath)) {
+      let content = await fs.readFile(filePath, "utf-8");
+      if (content.includes(markerStart)) {
+        content = content.replace(markerRegex, markedBlock);
+      } else {
+        content += markedBlock;
+      }
+      await fs.writeFile(filePath, content, "utf-8");
+    } else {
+      await fs.writeFile(filePath, markedBlock.trim() + "\n", "utf-8");
+    }
+  }
+  const rulesDir = join(homedir(), ".claude", "rules");
+  await fs.ensureDir(rulesDir);
+  await fs.writeFile(join(rulesDir, "ccg-fast-context.md"), FAST_CONTEXT_PROMPT, "utf-8");
+  await injectIntoFile(join(homedir(), ".codex", "AGENTS.md"));
+  await injectIntoFile(join(homedir(), ".gemini", "GEMINI.md"));
+}
+async function removeFastContextPrompt() {
+  const markerRegex = new RegExp(
+    `\\n?${FC_MARKER_START.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?${FC_MARKER_END.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\n?`
+  );
+  async function removeFromFile(filePath) {
+    if (await fs.pathExists(filePath)) {
+      let content = await fs.readFile(filePath, "utf-8");
+      if (content.includes(FC_MARKER_START)) {
+        content = content.replace(markerRegex, "");
+        await fs.writeFile(filePath, content, "utf-8");
+      }
+    }
+  }
+  const rulePath = join(homedir(), ".claude", "rules", "ccg-fast-context.md");
+  if (await fs.pathExists(rulePath)) {
+    await fs.remove(rulePath);
+  }
+  await removeFromFile(join(homedir(), ".codex", "AGENTS.md"));
+  await removeFromFile(join(homedir(), ".gemini", "GEMINI.md"));
+}
 async function installMcpServer(id, command, args, env = {}) {
   try {
     await backupClaudeCodeConfig();
@@ -1166,7 +1324,8 @@ const CCG_MCP_IDS = /* @__PURE__ */ new Set([
   "context7",
   "ace-tool",
   "ace-tool-rs",
-  "contextweaver"
+  "contextweaver",
+  "fast-context"
 ]);
 async function syncMcpToCodex() {
   const synced = [];
@@ -1237,6 +1396,50 @@ async function syncMcpToCodex() {
     };
   }
 }
+async function syncMcpToGemini() {
+  const synced = [];
+  const removed = [];
+  try {
+    const claudeConfig = await readClaudeCodeConfig();
+    const claudeMcpServers = claudeConfig?.mcpServers || {};
+    const serversToSync = {};
+    for (const [id, config] of Object.entries(claudeMcpServers)) {
+      if (CCG_MCP_IDS.has(id) && config) {
+        serversToSync[id] = config;
+      }
+    }
+    const geminiDir = join(homedir(), ".gemini");
+    const geminiSettingsPath = join(geminiDir, "settings.json");
+    await fs.ensureDir(geminiDir);
+    let geminiSettings = {};
+    if (await fs.pathExists(geminiSettingsPath)) {
+      geminiSettings = await fs.readJSON(geminiSettingsPath);
+    }
+    if (!geminiSettings.mcpServers) {
+      geminiSettings.mcpServers = {};
+    }
+    for (const [id, claudeServer] of Object.entries(serversToSync)) {
+      geminiSettings.mcpServers[id] = claudeServer;
+      synced.push(id);
+    }
+    for (const id of CCG_MCP_IDS) {
+      if (!serversToSync[id] && geminiSettings.mcpServers[id]) {
+        delete geminiSettings.mcpServers[id];
+        removed.push(id);
+      }
+    }
+    if (synced.length === 0 && removed.length === 0) {
+      return { success: true, message: "No CCG MCP servers to sync to Gemini", synced: [], removed: [] };
+    }
+    await fs.writeJSON(geminiSettingsPath, geminiSettings, { spaces: 2 });
+    const parts = [];
+    if (synced.length > 0) parts.push(`synced: ${synced.join(", ")}`);
+    if (removed.length > 0) parts.push(`removed: ${removed.join(", ")}`);
+    return { success: true, message: `Gemini MCP mirror complete (${parts.join("; ")})`, synced, removed };
+  } catch (error) {
+    return { success: false, message: `Failed to sync MCP to Gemini: ${error}`, synced, removed };
+  }
+}
 
 async function configMcp() {
   console.log();
@@ -1247,7 +1450,7 @@ async function configMcp() {
     name: "action",
     message: "\u9009\u62E9\u64CD\u4F5C",
     choices: [
-      { name: `${ansis.green("\u279C")} \u4EE3\u7801\u68C0\u7D22 MCP ${ansis.gray("(ace-tool / ContextWeaver)")}`, value: "code-retrieval" },
+      { name: `${ansis.green("\u279C")} \u4EE3\u7801\u68C0\u7D22 MCP ${ansis.gray("(ace-tool / fast-context / ContextWeaver)")}`, value: "code-retrieval" },
       { name: `${ansis.green("\u279C")} \u8054\u7F51\u641C\u7D22 MCP ${ansis.gray("(grok-search\uFF0C\u6BD4\u5185\u7F6E\u8054\u7F51\u66F4\u597D\u7528)")}`, value: "grok-search" },
       { name: `${ansis.blue("\u279C")} \u8F85\u52A9\u5DE5\u5177 MCP ${ansis.gray("(context7 / Playwright / exa...)")}`, value: "auxiliary" },
       { name: `${ansis.red("\u2715")} \u5378\u8F7D MCP`, value: "uninstall" },
@@ -1276,6 +1479,7 @@ async function handleCodeRetrieval() {
     choices: [
       { name: `ace-tool ${ansis.green("(\u63A8\u8350)")} ${ansis.gray("- \u4EE3\u7801\u68C0\u7D22\uFF08enhance_prompt \u5DF2\u4E0D\u53EF\u7528\uFF09")}`, value: "ace-tool" },
       { name: `ace-tool-rs ${ansis.green("(\u63A8\u8350)")} ${ansis.gray("- Rust \u7248\u672C")}`, value: "ace-tool-rs" },
+      { name: `fast-context ${ansis.green("(\u63A8\u8350)")} ${ansis.gray("- Windsurf Fast Context\uFF08\u514D\u8D39/\u4F4E\u6210\u672C\uFF09")}`, value: "fast-context" },
       { name: `ContextWeaver ${ansis.gray("- \u672C\u5730\u6DF7\u5408\u641C\u7D22\uFF08\u9700\u7845\u57FA\u6D41\u52A8 API Key\uFF09")}`, value: "contextweaver" },
       new inquirer.Separator(),
       { name: `${ansis.gray("\u8FD4\u56DE")}`, value: "cancel" }
@@ -1285,6 +1489,8 @@ async function handleCodeRetrieval() {
     return;
   if (tool === "contextweaver") {
     await handleInstallContextWeaver();
+  } else if (tool === "fast-context") {
+    await handleInstallFastContext();
   } else {
     await handleInstallAceTool(tool === "ace-tool-rs");
   }
@@ -1340,6 +1546,39 @@ async function handleInstallContextWeaver() {
     console.log(ansis.red(`\u2717 ContextWeaver MCP \u914D\u7F6E\u5931\u8D25: ${result.message}`));
   }
 }
+async function handleInstallFastContext() {
+  console.log();
+  console.log(ansis.cyan("\u{1F4D6} Fast Context (Windsurf Fast Context)\uFF1A"));
+  console.log(`   ${ansis.gray("\u2022")} \u9700\u8981 Windsurf \u8D26\u53F7\u7684 API Key`);
+  console.log(`   ${ansis.gray("\u2022")} \u672C\u5730\u88C5\u8FC7 Windsurf \u5E76\u767B\u5F55 \u2192 Key \u53EF\u81EA\u52A8\u63D0\u53D6\uFF0C\u4E5F\u53EF\u624B\u52A8\u586B\u5165`);
+  console.log(`   ${ansis.gray("\u2022")} Key \u83B7\u53D6\uFF1A\u5B89\u88C5 Windsurf \u2192 \u767B\u5F55 \u2192 \u4ECE\u672C\u5730 SQLite \u63D0\u53D6 apiKey`);
+  console.log(`   ${ansis.gray("\u2022")} \u8F7B\u91CF\u6A21\u5F0F\u8FD4\u56DE\u6587\u4EF6\u8DEF\u5F84+\u884C\u8303\u56F4\uFF0C\u5B8C\u6574\u6A21\u5F0F\u989D\u5916\u8FD4\u56DE\u4EE3\u7801\u7247\u6BB5`);
+  console.log();
+  const answers = await inquirer.prompt([
+    { type: "input", name: "apiKey", message: `WINDSURF_API_KEY ${ansis.gray("(\u672C\u5730\u88C5\u4E86 Windsurf \u53EF\u7559\u7A7A\u81EA\u52A8\u63D0\u53D6)")}` },
+    {
+      type: "confirm",
+      name: "includeSnippets",
+      message: `\u8FD4\u56DE\u5B8C\u6574\u4EE3\u7801\u7247\u6BB5\uFF1F${ansis.gray("(FC_INCLUDE_SNIPPETS\uFF0C\u8F93\u51FA ~40KB\uFF0C\u5426\u5219\u4EC5\u8DEF\u5F84+\u884C\u53F7 ~2KB)")}`,
+      default: false
+    }
+  ]);
+  console.log();
+  console.log(ansis.yellow("\u23F3 \u6B63\u5728\u914D\u7F6E fast-context MCP..."));
+  const result = await installFastContext({
+    apiKey: answers.apiKey?.trim() || void 0,
+    includeSnippets: answers.includeSnippets
+  });
+  console.log();
+  if (result.success) {
+    await writeFastContextPrompt();
+    console.log(ansis.green("\u2713 fast-context MCP \u914D\u7F6E\u6210\u529F\uFF01"));
+    console.log(ansis.green("\u2713 \u641C\u7D22\u63D0\u793A\u8BCD\u5DF2\u5199\u5165 ~/.claude/rules/ + ~/.codex/AGENTS.md + ~/.gemini/GEMINI.md"));
+    console.log(ansis.gray("  \u91CD\u542F Claude Code CLI \u4F7F\u914D\u7F6E\u751F\u6548"));
+  } else {
+    console.log(ansis.red(`\u2717 fast-context MCP \u914D\u7F6E\u5931\u8D25: ${result.message}`));
+  }
+}
 const GROK_SEARCH_PROMPT = `## 0. Language and Format Standards
 
 - **Interaction Language**: Tools and models must interact exclusively in **English**; user outputs must be in **Chinese**.
@@ -1485,6 +1724,7 @@ async function handleUninstall() {
   console.log();
   const allMcps = [
     { name: "ace-tool", value: "ace-tool" },
+    { name: "fast-context", value: "fast-context" },
     { name: "ContextWeaver", value: "contextweaver" },
     { name: "grok-search", value: "grok-search" },
     ...AUXILIARY_MCPS.map((m) => ({ name: m.name, value: m.id }))
@@ -1505,6 +1745,9 @@ async function handleUninstall() {
     let result;
     if (target === "ace-tool") {
       result = await uninstallAceTool();
+    } else if (target === "fast-context") {
+      result = await uninstallFastContext();
+      await removeFastContextPrompt();
     } else if (target === "contextweaver") {
       result = await uninstallContextWeaver();
     } else {
@@ -2714,6 +2957,8 @@ async function init(options = {}) {
   let aceToolBaseUrl = "";
   let aceToolToken = "";
   let contextWeaverApiKey = "";
+  let fastContextApiKey = "";
+  let fastContextIncludeSnippets = false;
   if (options.skipMcp) {
     mcpProvider = "skip";
   } else if (!options.skipPrompt) {
@@ -2726,11 +2971,15 @@ async function init(options = {}) {
       message: i18n.t("init:mcp.selectProvider"),
       choices: [
         {
-          name: `ace-tool ${ansis.green(`(${i18n.t("common:info")})`)} ${ansis.gray("- search_context (enhance_prompt N/A)")}`,
+          name: `fast-context ${ansis.green(`(${i18n.t("common:info")})`)} ${ansis.gray("- Windsurf Fast Context, AI \u9A71\u52A8\u641C\u7D22")}`,
+          value: "fast-context"
+        },
+        {
+          name: `ace-tool ${ansis.gray("- search_context (enhance_prompt N/A)")}`,
           value: "ace-tool"
         },
         {
-          name: `ace-tool-rs ${ansis.green(`(${i18n.t("common:info")})`)} ${ansis.gray("(Rust) - search_context")}`,
+          name: `ace-tool-rs ${ansis.gray("(Rust) - search_context")}`,
           value: "ace-tool-rs"
         },
         {
@@ -2742,7 +2991,7 @@ async function init(options = {}) {
           value: "skip"
         }
       ],
-      default: "ace-tool"
+      default: "fast-context"
     }]);
     mcpProvider = selectedMcp;
     if (selectedMcp === "ace-tool" || selectedMcp === "ace-tool-rs") {
@@ -2792,6 +3041,46 @@ async function init(options = {}) {
         console.log(ansis.gray(`     \u2022 ${i18n.t("init:mcp.configLater", { cmd: ansis.cyan("npx ccg config mcp") })}`));
         console.log();
       }
+    } else if (selectedMcp === "fast-context") {
+      console.log();
+      console.log(ansis.cyan.bold(`  \u{1F527} Fast Context MCP`));
+      console.log(ansis.gray(`     Windsurf Fast Context \u2014 AI \u9A71\u52A8\u4EE3\u7801\u641C\u7D22\uFF0C\u65E0\u9700\u5168\u91CF\u7D22\u5F15`));
+      console.log();
+      const { skipKey } = await inquirer.prompt([{
+        type: "confirm",
+        name: "skipKey",
+        message: "\u8DF3\u8FC7 API Key \u914D\u7F6E\uFF1F\uFF08\u672C\u5730\u88C5\u4E86 Windsurf \u5E76\u767B\u5F55\u53EF\u81EA\u52A8\u63D0\u53D6\uFF09",
+        default: false
+      }]);
+      if (!skipKey) {
+        console.log();
+        console.log(ansis.cyan(`     \u{1F4D6} \u83B7\u53D6 WINDSURF_API_KEY\uFF1A`));
+        console.log();
+        console.log(`     ${ansis.gray("\u2022")} \u5B89\u88C5 Windsurf \u7F16\u8F91\u5668 \u2192 \u767B\u5F55 \u2192 Key \u81EA\u52A8\u5B58\u5165\u672C\u5730 SQLite`);
+        console.log(`     ${ansis.gray("\u2022")} \u4E5F\u53EF\u624B\u52A8\u4ECE SQLite \u63D0\u53D6\uFF08AI \u53EF\u8C03\u7528 extract_windsurf_key \u5DE5\u5177\uFF09`);
+        console.log();
+        const fcAnswers = await inquirer.prompt([
+          {
+            type: "input",
+            name: "apiKey",
+            message: `WINDSURF_API_KEY ${ansis.gray("(\u7559\u7A7A\u5219\u542F\u52A8\u65F6\u81EA\u52A8\u63D0\u53D6)")}`,
+            default: ""
+          },
+          {
+            type: "confirm",
+            name: "includeSnippets",
+            message: `\u8FD4\u56DE\u5B8C\u6574\u4EE3\u7801\u7247\u6BB5\uFF1F${ansis.gray("(\u5426\u5219\u4EC5\u8DEF\u5F84+\u884C\u53F7\uFF0C\u66F4\u7701 token)")}`,
+            default: false
+          }
+        ]);
+        fastContextApiKey = fcAnswers.apiKey?.trim() || "";
+        fastContextIncludeSnippets = fcAnswers.includeSnippets;
+      } else {
+        console.log();
+        console.log(ansis.yellow(`  \u2139\uFE0F  API Key \u5DF2\u8DF3\u8FC7`));
+        console.log(ansis.gray(`     \u2022 fast-context MCP \u5C06\u4E0D\u5E26 Key \u5B89\u88C5\uFF08\u542F\u52A8\u65F6\u81EA\u52A8\u4ECE\u672C\u5730 Windsurf \u63D0\u53D6\uFF09`));
+        console.log();
+      }
     } else if (selectedMcp === "contextweaver") {
       console.log();
       console.log(ansis.cyan.bold(`  \u{1F527} ContextWeaver MCP`));
@@ -2941,7 +3230,13 @@ async function init(options = {}) {
   console.log();
   console.log(`  ${ansis.cyan(i18n.t("init:summary.modelRouting"))}  ${ansis.green("Gemini")} (Frontend) + ${ansis.blue("Codex")} (Backend)`);
   console.log(`  ${ansis.cyan(i18n.t("init:summary.commandCount"))}  ${ansis.yellow(selectedWorkflows.length.toString())}`);
-  console.log(`  ${ansis.cyan(i18n.t("init:summary.mcpTool"))}  ${mcpProvider === "ace-tool" || mcpProvider === "ace-tool-rs" ? aceToolToken ? ansis.green(mcpProvider) : ansis.yellow(`${mcpProvider} (${i18n.t("init:summary.pendingConfig")})`) : mcpProvider === "contextweaver" ? contextWeaverApiKey ? ansis.green("contextweaver") : ansis.yellow(`contextweaver (${i18n.t("init:summary.pendingConfig")})`) : ansis.gray(i18n.t("init:summary.skipped"))}`);
+  const mcpSummary = (() => {
+    if (mcpProvider === "fast-context") return ansis.green("fast-context");
+    if (mcpProvider === "ace-tool" || mcpProvider === "ace-tool-rs") return aceToolToken ? ansis.green(mcpProvider) : ansis.yellow(`${mcpProvider} (${i18n.t("init:summary.pendingConfig")})`);
+    if (mcpProvider === "contextweaver") return contextWeaverApiKey ? ansis.green("contextweaver") : ansis.yellow(`contextweaver (${i18n.t("init:summary.pendingConfig")})`);
+    return ansis.gray(i18n.t("init:summary.skipped"));
+  })();
+  console.log(`  ${ansis.cyan(i18n.t("init:summary.mcpTool"))}  ${mcpSummary}`);
   console.log(`  ${ansis.cyan(i18n.t("init:summary.webUI"))}    ${liteMode ? ansis.gray(i18n.t("init:summary.disabled")) : ansis.green(i18n.t("init:summary.enabled"))}`);
   if (wantGrokSearch) {
     console.log(`  ${ansis.cyan("grok-search")}    ${tavilyKey ? ansis.green("\u2713") : ansis.yellow(`(${i18n.t("init:summary.pendingConfig")})`)}`);
@@ -3021,6 +3316,22 @@ async function init(options = {}) {
         spinner.warn(ansis.yellow(mcpProvider === "ace-tool-rs" ? i18n.t("init:aceToolRs.failed") : i18n.t("init:aceTool.failed")));
         console.log(ansis.gray(`      ${aceResult.message}`));
       }
+    } else if (mcpProvider === "fast-context") {
+      spinner.text = "Configuring fast-context MCP...";
+      const fcResult = await installFastContext({
+        apiKey: fastContextApiKey || void 0,
+        includeSnippets: fastContextIncludeSnippets
+      });
+      if (fcResult.success) {
+        spinner.succeed(ansis.green(i18n.t("init:installSuccess")));
+        console.log();
+        console.log(`    ${ansis.green("\u2713")} fast-context MCP ${ansis.gray(`\u2192 ${fcResult.configPath}`)}`);
+        await writeFastContextPrompt();
+        console.log(`    ${ansis.green("\u2713")} \u641C\u7D22\u63D0\u793A\u8BCD ${ansis.gray("\u2192 ~/.claude/rules/ + ~/.codex/AGENTS.md + ~/.gemini/GEMINI.md")}`);
+      } else {
+        spinner.warn(ansis.yellow("fast-context MCP \u914D\u7F6E\u5931\u8D25"));
+        console.log(ansis.gray(`      ${fcResult.message}`));
+      }
     } else if (mcpProvider === "contextweaver" && contextWeaverApiKey) {
       spinner.text = i18n.t("init:mcp.cwConfiguring");
       const cwResult = await installContextWeaver({
@@ -3133,6 +3444,15 @@ async function init(options = {}) {
         console.log(`    ${ansis.yellow("\u26A0")} Codex MCP sync failed`);
         console.log(ansis.gray(`      ${codexSyncResult.message}`));
       }
+      const geminiSyncResult = await syncMcpToGemini();
+      if (geminiSyncResult.success && geminiSyncResult.synced.length > 0) {
+        console.log();
+        console.log(`    ${ansis.green("\u2713")} Gemini MCP sync: ${geminiSyncResult.synced.join(", ")} ${ansis.gray("\u2192 ~/.gemini/settings.json")}`);
+      } else if (!geminiSyncResult.success) {
+        console.log();
+        console.log(`    ${ansis.yellow("\u26A0")} Gemini MCP sync failed`);
+        console.log(ansis.gray(`      ${geminiSyncResult.message}`));
+      }
     }
     if (hookMethod === "hook") {
       const hasJq = await checkJqAvailable();
@@ -3275,13 +3595,16 @@ ${exportCommand}
       console.log();
       console.log(ansis.gray(`     ${i18n.t("init:mcp.mcpOptionsHint")}`));
       console.log();
-      console.log(`     ${ansis.green("1.")} ${ansis.cyan("ace-tool / ace-tool-rs")}: ${ansis.underline("https://augmentcode.com/")}`);
+      console.log(`     ${ansis.green("1.")} ${ansis.cyan("fast-context")} ${ansis.yellow("(\u63A8\u8350)")}: Windsurf Fast Context`);
+      console.log(`        ${ansis.gray("AI \u9A71\u52A8\u4EE3\u7801\u641C\u7D22\uFF0C\u9700 Windsurf \u8D26\u53F7\uFF0C\u514D\u8D39/\u4F4E\u6210\u672C")}`);
+      console.log();
+      console.log(`     ${ansis.green("2.")} ${ansis.cyan("ace-tool / ace-tool-rs")}: ${ansis.underline("https://augmentcode.com/")}`);
       console.log(`        ${ansis.gray(i18n.t("init:mcp.promptEnhancement"))}`);
       console.log();
-      console.log(`     ${ansis.green("2.")} ${ansis.cyan("ace-tool " + i18n.t("init:mcp.proxyService"))} ${ansis.yellow(`(${i18n.t("init:mcp.noSignup")})`)}: ${ansis.underline("https://acemcp.heroman.wtf/")}`);
+      console.log(`     ${ansis.green("3.")} ${ansis.cyan("ace-tool " + i18n.t("init:mcp.proxyService"))} ${ansis.yellow(`(${i18n.t("init:mcp.noSignup")})`)}: ${ansis.underline("https://acemcp.heroman.wtf/")}`);
       console.log(`        ${ansis.gray(i18n.t("init:mcp.communityProxy"))}`);
       console.log();
-      console.log(`     ${ansis.green("3.")} ${ansis.cyan("ContextWeaver")} ${ansis.yellow(`(${i18n.t("init:mcp.freeQuota")})`)}: ${ansis.underline("https://siliconflow.cn/")}`);
+      console.log(`     ${ansis.green("4.")} ${ansis.cyan("ContextWeaver")} ${ansis.yellow(`(${i18n.t("init:mcp.freeQuota")})`)}: ${ansis.underline("https://siliconflow.cn/")}`);
       console.log(`        ${ansis.gray(i18n.t("init:mcp.localEngine"))}`);
       console.log();
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-workflow",
-  "version": "1.7.80",
+  "version": "1.7.82",
   "description": "Claude + Codex + Gemini multi-model collaboration system - smart routing development workflow",
   "type": "module",
   "packageManager": "pnpm@10.17.1",

package/templates/commands/commit.md

@@ -68,27 +68,34 @@ description: '智能 Git 提交：分析改动生成 Conventional Commit 信息
 
 **语言**：根据最近 50 次提交判断中文/英文
 
-### 📦 阶段 5：Context 压缩（若 .context/ 存在）
+### 📦 阶段 5：Context 自动归档（若 .context/ 存在）
 
 `[模式：上下文归档]`
 
-仅在项目存在 `.context/` 目录时执行，否则跳过。
+**前置判断**：
+- 若 `.context/` 目录不存在 → 在提交成功后输出提示：`💡 建议执行 /ccg:context init 启用决策追踪`，不阻断
+- 若 `.context/` 存在 → 执行以下步骤
+
+**从 git diff 自动生成 ContextEntry**：
 
 1. 获取当前分支名：`git branch --show-current`
-2. 检查 `.context/current/branches/<branch>/session.log` 是否存在且非空
-3. 若有内容：
-   - **脱敏**：扫描 token/key/password/secret 模式 → 替换为 `[REDACTED]`
-   - **压缩**：从 session.log 提取 decisions / bugs / alternatives，生成 ContextEntry JSON
-   - **追加**：将 ContextEntry 作为一行追加到 `.context/history/commits.jsonl`
-   - **重生成**：更新 `.context/history/commits.md` 人类视图
-   - **暂存**：`git add .context/history/`
-   - **清空**：清空 session.log（不删除文件）
-   - **Trailer**：在 commit message 中添加 `Context-Id: <uuid>` trailer
-4. 若 session.log 为空或不存在，跳过此阶段
+2. 获取暂存区变更：`git diff --cached --stat` + `git diff --cached`（完整 diff）
+3. **分析 diff 生成 ContextEntry**：
+   - `summary`：从阶段 4 生成的 commit message 中取首行
+   - `decisions`：分析 diff 中的关键变更（新增依赖、架构调整、接口变更、配置修改），推断决策理由
+   - `bugs`：若 commit type 为 `fix`，从 diff 中提取 bug 症状、根因、修复方式
+   - `changes.files`：从 `git diff --cached --name-only` 提取
+   - `tests`：若变更包含测试文件，记录测试相关信息
+4. **合并 session.log**（可选）：若 `.context/current/branches/<branch>/session.log` 存在且非空，将其中的手动记录合并到 decisions/bugs 中，然后清空 session.log
+5. **脱敏**：扫描 token/key/password/secret 模式 → 替换为 `[REDACTED]`
+6. **追加**：将 ContextEntry 作为一行追加到 `.context/history/commits.jsonl`
+7. **重生成**：更新 `.context/history/commits.md` 人类视图
+8. **暂存**：`git add .context/history/`
+9. **Trailer**：在 commit message 中添加 `Context-Id: <uuid>` trailer
 
 **ContextEntry 格式**参见 `/ccg:context` 命令中的 Schema 定义。
 
-**失败降级**：若压缩过程出错，不阻断提交。写入 minimal ContextEntry（仅 summary + error），继续正常提交。
+**失败降级**：若归档过程出错，不阻断提交。写入 minimal ContextEntry（仅 summary + files），继续正常提交。
 
 ### ✅ 阶段 6：执行提交
 

package/templates/commands/context.md

@@ -17,12 +17,14 @@ description: '项目上下文管理：初始化 .context 目录、记录决策
 | 子命令 | 说明 |
 |--------|------|
 | `init` | 初始化 `.context/` 目录结构 |
-| `log <message>` | 手动追加决策日志到 session.log |
+| `log <message>` | （可选）手动追加备注到 session.log，commit 时会合并 |
 | `show` | 查看当前分支的 session.log |
-| `compress` | 压缩 session.log → uncommit.md |
+| `compress` | 压缩 session.log → uncommit.md（手动预览用） |
 | `history` | 查看 history/commits.md |
 | `squash <ids...>` | 合并多条 history 记录（配合 git squash） |
 
+> **核心用法**：`init` 一次，之后只管开发。`/ccg:commit` 提交时自动从 git diff 分析决策并归档到 history/。`log` 仅在你想手动补充备注时使用。
+
 ---
 
 ## 执行工作流