claude-code-workflow 6.3.25 → 6.3.26

package/ccw/src/templates/dashboard-js/components/hook-manager.js

@@ -49,43 +49,17 @@ const HOOK_TEMPLATES = {
     description: 'Auto-update code index when files are written or edited',
     category: 'indexing'
   },
-  'memory-update-related': {
+  'memory-update-queue': {
     event: 'Stop',
     matcher: '',
     command: 'bash',
-    args: ['-c', 'ccw tool exec update_module_claude \'{"strategy":"related","tool":"gemini"}\''],
-    description: 'Update CLAUDE.md for changed modules when session ends',
+    args: ['-c', 'ccw tool exec memory_queue "{\\"action\\":\\"add\\",\\"path\\":\\"$CLAUDE_PROJECT_DIR\\"}"'],
+    description: 'Queue CLAUDE.md update when session ends (batched by threshold/timeout)',
     category: 'memory',
     configurable: true,
     config: {
-      tool: { type: 'select', options: ['gemini', 'qwen', 'codex'], default: 'gemini', label: 'CLI Tool' },
-      strategy: { type: 'select', options: ['related', 'single-layer'], default: 'related', label: 'Strategy' }
-    }
-  },
-  'memory-update-periodic': {
-    event: 'PostToolUse',
-    matcher: 'Write|Edit',
-    command: 'bash',
-    args: ['-c', 'INTERVAL=300; LAST_FILE="$HOME/.claude/.last_memory_update"; mkdir -p "$HOME/.claude"; NOW=$(date +%s); LAST=0; [ -f "$LAST_FILE" ] && LAST=$(cat "$LAST_FILE" 2>/dev/null || echo 0); if [ $((NOW - LAST)) -ge $INTERVAL ]; then echo $NOW > "$LAST_FILE"; ccw tool exec update_module_claude \'{"strategy":"related","tool":"gemini"}\' & fi'],
-    description: 'Periodically update CLAUDE.md (default: 5 min interval)',
-    category: 'memory',
-    configurable: true,
-    config: {
-      tool: { type: 'select', options: ['gemini', 'qwen', 'codex'], default: 'gemini', label: 'CLI Tool' },
-      interval: { type: 'number', default: 300, min: 60, max: 3600, label: 'Interval (seconds)', step: 60 }
-    }
-  },
-  'memory-update-count-based': {
-    event: 'PostToolUse',
-    matcher: 'Write|Edit',
-    command: 'bash',
-    args: ['-c', 'THRESHOLD=10; COUNT_FILE="$HOME/.claude/.memory_update_count"; mkdir -p "$HOME/.claude"; INPUT=$(cat); FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // .tool_input.path // empty" 2>/dev/null); [ -z "$FILE_PATH" ] && exit 0; COUNT=0; [ -f "$COUNT_FILE" ] && COUNT=$(cat "$COUNT_FILE" 2>/dev/null || echo 0); COUNT=$((COUNT + 1)); echo $COUNT > "$COUNT_FILE"; if [ $COUNT -ge $THRESHOLD ]; then echo 0 > "$COUNT_FILE"; ccw tool exec update_module_claude \'{"strategy":"related","tool":"gemini"}\' & fi'],
-    description: 'Update CLAUDE.md when file changes reach threshold (default: 10 files)',
-    category: 'memory',
-    configurable: true,
-    config: {
-      tool: { type: 'select', options: ['gemini', 'qwen', 'codex'], default: 'gemini', label: 'CLI Tool' },
-      threshold: { type: 'number', default: 10, min: 3, max: 50, label: 'File count threshold', step: 1 }
+      threshold: { type: 'number', default: 5, min: 1, max: 20, label: 'Threshold (paths)', step: 1 },
+      timeout: { type: 'number', default: 300, min: 60, max: 1800, label: 'Timeout (seconds)', step: 60 }
     }
   },
   // SKILL Context Loader templates
@@ -210,33 +184,19 @@ const HOOK_TEMPLATES = {
 const WIZARD_TEMPLATES = {
   'memory-update': {
     name: 'Memory Update Hook',
-    description: 'Automatically update CLAUDE.md documentation based on code changes',
+    description: 'Queue-based CLAUDE.md updates with configurable threshold and timeout',
     icon: 'brain',
     options: [
       {
-        id: 'on-stop',
-        name: 'On Session End',
-        description: 'Update documentation when Claude session ends',
-        templateId: 'memory-update-related'
-      },
-      {
-        id: 'periodic',
-        name: 'Periodic Update',
-        description: 'Update documentation at regular intervals during session',
-        templateId: 'memory-update-periodic'
-      },
-      {
-        id: 'count-based',
-        name: 'Count-Based Update',
-        description: 'Update documentation when file changes reach threshold',
-        templateId: 'memory-update-count-based'
+        id: 'queue',
+        name: 'Queue-Based Update',
+        description: 'Batch updates when threshold reached or timeout expires',
+        templateId: 'memory-update-queue'
       }
     ],
     configFields: [
-      { key: 'tool', type: 'select', label: 'CLI Tool', options: ['gemini', 'qwen', 'codex'], default: 'gemini', description: 'Tool for documentation generation' },
-      { key: 'interval', type: 'number', label: 'Interval (seconds)', default: 300, min: 60, max: 3600, step: 60, showFor: ['periodic'], description: 'Time between updates' },
-      { key: 'threshold', type: 'number', label: 'File Count Threshold', default: 10, min: 3, max: 50, step: 1, showFor: ['count-based'], description: 'Number of file changes to trigger update' },
-      { key: 'strategy', type: 'select', label: 'Update Strategy', options: ['related', 'single-layer'], default: 'related', description: 'Related: changed modules, Single-layer: current directory' }
+      { key: 'threshold', type: 'number', label: 'Threshold (paths)', default: 5, min: 1, max: 20, step: 1, description: 'Number of paths to trigger batch update' },
+      { key: 'timeout', type: 'number', label: 'Timeout (seconds)', default: 300, min: 60, max: 1800, step: 60, description: 'Auto-flush queue after this time' }
     ]
   },
   'skill-context': {
@@ -730,9 +690,7 @@ function renderWizardModalContent() {
   // Helper to get translated option names
   const getOptionName = (optId) => {
     if (wizardId === 'memory-update') {
-      if (optId === 'on-stop') return t('hook.wizard.onSessionEnd');
-      if (optId === 'periodic') return t('hook.wizard.periodicUpdate');
-      if (optId === 'count-based') return t('hook.wizard.countBasedUpdate');
+      if (optId === 'queue') return t('hook.wizard.queueBasedUpdate') || 'Queue-Based Update';
     }
     if (wizardId === 'memory-setup') {
       if (optId === 'file-read') return t('hook.wizard.fileReadTracker');
@@ -748,9 +706,7 @@ function renderWizardModalContent() {
 
   const getOptionDesc = (optId) => {
     if (wizardId === 'memory-update') {
-      if (optId === 'on-stop') return t('hook.wizard.onSessionEndDesc');
-      if (optId === 'periodic') return t('hook.wizard.periodicUpdateDesc');
-      if (optId === 'count-based') return t('hook.wizard.countBasedUpdateDesc');
+      if (optId === 'queue') return t('hook.wizard.queueBasedUpdateDesc') || 'Batch updates when threshold reached or timeout expires';
     }
     if (wizardId === 'memory-setup') {
       if (optId === 'file-read') return t('hook.wizard.fileReadTrackerDesc');
@@ -767,20 +723,16 @@ function renderWizardModalContent() {
   // Helper to get translated field labels
   const getFieldLabel = (fieldKey) => {
     const labels = {
-      'tool': t('hook.wizard.cliTool'),
-      'interval': t('hook.wizard.intervalSeconds'),
-      'threshold': t('hook.wizard.fileCountThreshold'),
-      'strategy': t('hook.wizard.updateStrategy')
+      'threshold': t('hook.wizard.thresholdPaths') || 'Threshold (paths)',
+      'timeout': t('hook.wizard.timeoutSeconds') || 'Timeout (seconds)'
     };
     return labels[fieldKey] || wizard.configFields.find(f => f.key === fieldKey)?.label || fieldKey;
   };
 
   const getFieldDesc = (fieldKey) => {
     const descs = {
-      'tool': t('hook.wizard.toolForDocGen'),
-      'interval': t('hook.wizard.timeBetweenUpdates'),
-      'threshold': t('hook.wizard.fileCountThresholdDesc'),
-      'strategy': t('hook.wizard.relatedStrategy')
+      'threshold': t('hook.wizard.thresholdPathsDesc') || 'Number of paths to trigger batch update',
+      'timeout': t('hook.wizard.timeoutSecondsDesc') || 'Auto-flush queue after this time'
     };
     return descs[fieldKey] || wizard.configFields.find(f => f.key === fieldKey)?.description || '';
   };
@@ -1154,21 +1106,10 @@ function generateWizardCommand() {
   }
 
   // Handle memory-update wizard (default)
-  const tool = wizardConfig.tool || 'gemini';
-  const strategy = wizardConfig.strategy || 'related';
-  const interval = wizardConfig.interval || 300;
-  const threshold = wizardConfig.threshold || 10;
-
-  // Build the ccw tool command based on configuration
-  const params = JSON.stringify({ strategy, tool });
-
-  if (triggerType === 'periodic') {
-    return `INTERVAL=${interval}; LAST_FILE="$HOME/.claude/.last_memory_update"; mkdir -p "$HOME/.claude"; NOW=$(date +%s); LAST=0; [ -f "$LAST_FILE" ] && LAST=$(cat "$LAST_FILE" 2>/dev/null || echo 0); if [ $((NOW - LAST)) -ge $INTERVAL ]; then echo $NOW > "$LAST_FILE"; ccw tool exec update_module_claude '${params}' & fi`;
-  } else if (triggerType === 'count-based') {
-    return `THRESHOLD=${threshold}; COUNT_FILE="$HOME/.claude/.memory_update_count"; mkdir -p "$HOME/.claude"; INPUT=$(cat); FILE_PATH=$(echo "$INPUT" | jq -r ".tool_input.file_path // .tool_input.path // empty" 2>/dev/null); [ -z "$FILE_PATH" ] && exit 0; COUNT=0; [ -f "$COUNT_FILE" ] && COUNT=$(cat "$COUNT_FILE" 2>/dev/null || echo 0); COUNT=$((COUNT + 1)); echo $COUNT > "$COUNT_FILE"; if [ $COUNT -ge $THRESHOLD ]; then echo 0 > "$COUNT_FILE"; ccw tool exec update_module_claude '${params}' & fi`;
-  } else {
-    return `ccw tool exec update_module_claude '${params}'`;
-  }
+  // Now uses memory_queue for batched updates with configurable threshold/timeout
+  // The command adds to queue, configuration is applied separately via submitHookWizard
+  const params = `"{\\"action\\":\\"add\\",\\"path\\":\\"$CLAUDE_PROJECT_DIR\\"}"`;
+  return `ccw tool exec memory_queue ${params}`;
 }
 
 async function submitHookWizard() {
@@ -1263,6 +1204,26 @@ async function submitHookWizard() {
   }
 
   await saveHook(scope, baseTemplate.event, hookData);
+
+  // For memory-update wizard, also configure queue settings
+  if (wizard.id === 'memory-update') {
+    const threshold = wizardConfig.threshold || 5;
+    const timeout = wizardConfig.timeout || 300;
+    try {
+      const configParams = JSON.stringify({ action: 'configure', threshold, timeout });
+      const response = await fetch('/api/tools/execute', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ tool: 'memory_queue', params: configParams })
+      });
+      if (response.ok) {
+        showRefreshToast(`Queue configured: threshold=${threshold}, timeout=${timeout}s`, 'success');
+      }
+    } catch (e) {
+      console.warn('Failed to configure memory queue:', e);
+    }
+  }
+
   closeHookWizardModal();
 }
 

package/ccw/src/templates/dashboard-js/components/mcp-manager.js

@@ -84,6 +84,147 @@ function getCliMode() {
   return currentCliMode;
 }
 
+// ========== Cross-Platform MCP Helpers ==========
+
+/**
+ * Build cross-platform MCP server configuration
+ * On Windows, wraps npx/node/python commands with cmd /c for proper execution
+ * @param {string} command - The command to run (e.g., 'npx', 'node', 'python')
+ * @param {string[]} args - Command arguments
+ * @param {object} [options] - Additional options (env, type, etc.)
+ * @returns {object} MCP server configuration
+ */
+function buildCrossPlatformMcpConfig(command, args = [], options = {}) {
+  const { env, type, ...rest } = options;
+
+  // Commands that need cmd /c wrapper on Windows
+  const windowsWrappedCommands = ['npx', 'npm', 'node', 'python', 'python3', 'pip', 'pip3', 'pnpm', 'yarn', 'bun'];
+  const needsWindowsWrapper = isWindowsPlatform && windowsWrappedCommands.includes(command.toLowerCase());
+
+  const config = needsWindowsWrapper
+    ? { command: 'cmd', args: ['/c', command, ...args] }
+    : { command, args };
+
+  // Add optional fields
+  if (type) config.type = type;
+  if (env && Object.keys(env).length > 0) config.env = env;
+  Object.assign(config, rest);
+
+  return config;
+}
+
+/**
+ * Check if MCP config needs Windows cmd /c wrapper
+ * @param {object} serverConfig - MCP server configuration
+ * @returns {object} { needsWrapper: boolean, command: string }
+ */
+function checkWindowsMcpCompatibility(serverConfig) {
+  if (!isWindowsPlatform) return { needsWrapper: false };
+
+  const command = serverConfig.command?.toLowerCase() || '';
+  const windowsWrappedCommands = ['npx', 'npm', 'node', 'python', 'python3', 'pip', 'pip3', 'pnpm', 'yarn', 'bun'];
+
+  // Already wrapped with cmd
+  if (command === 'cmd') return { needsWrapper: false };
+
+  const needsWrapper = windowsWrappedCommands.includes(command);
+  return { needsWrapper, command: serverConfig.command };
+}
+
+/**
+ * Auto-fix MCP config for Windows platform
+ * @param {object} serverConfig - Original MCP server configuration
+ * @returns {object} Fixed configuration (or original if no fix needed)
+ */
+function autoFixWindowsMcpConfig(serverConfig) {
+  const { needsWrapper, command } = checkWindowsMcpCompatibility(serverConfig);
+
+  if (!needsWrapper) return serverConfig;
+
+  // Create new config with cmd /c wrapper
+  const fixedConfig = {
+    ...serverConfig,
+    command: 'cmd',
+    args: ['/c', command, ...(serverConfig.args || [])]
+  };
+
+  return fixedConfig;
+}
+
+/**
+ * Show Windows compatibility warning for MCP config
+ * @param {string} serverName - Name of the MCP server
+ * @param {object} serverConfig - MCP server configuration
+ * @returns {Promise<boolean>} True if user confirms auto-fix, false to keep original
+ */
+async function showWindowsMcpCompatibilityWarning(serverName, serverConfig) {
+  const { needsWrapper, command } = checkWindowsMcpCompatibility(serverConfig);
+
+  if (!needsWrapper) return false;
+
+  // Show warning toast with auto-fix option
+  const message = t('mcp.windows.compatibilityWarning', {
+    name: serverName,
+    command: command
+  });
+
+  return new Promise((resolve) => {
+    // Create custom toast with action buttons
+    const toastContainer = document.getElementById('refreshToast') || createToastContainer();
+    const toastId = `windows-mcp-warning-${Date.now()}`;
+
+    const toastHtml = `
+      <div id="${toastId}" class="fixed bottom-4 right-4 bg-warning text-warning-foreground p-4 rounded-lg shadow-lg max-w-md z-50 animate-slide-up">
+        <div class="flex items-start gap-3">
+          <i data-lucide="alert-triangle" class="w-5 h-5 flex-shrink-0 mt-0.5"></i>
+          <div class="flex-1">
+            <p class="font-medium mb-2">${t('mcp.windows.title')}</p>
+            <p class="text-sm opacity-90 mb-3">${message}</p>
+            <div class="flex gap-2">
+              <button class="px-3 py-1.5 text-sm bg-background text-foreground rounded hover:opacity-90"
+                      onclick="document.getElementById('${toastId}').remove(); window._mcpWindowsResolve && window._mcpWindowsResolve(true)">
+                ${t('mcp.windows.autoFix')}
+              </button>
+              <button class="px-3 py-1.5 text-sm border border-current rounded hover:opacity-90"
+                      onclick="document.getElementById('${toastId}').remove(); window._mcpWindowsResolve && window._mcpWindowsResolve(false)">
+                ${t('mcp.windows.keepOriginal')}
+              </button>
+            </div>
+          </div>
+          <button onclick="document.getElementById('${toastId}').remove(); window._mcpWindowsResolve && window._mcpWindowsResolve(false)"
+                  class="text-current opacity-70 hover:opacity-100">
+            <i data-lucide="x" class="w-4 h-4"></i>
+          </button>
+        </div>
+      </div>
+    `;
+
+    // Store resolve function globally for button clicks
+    window._mcpWindowsResolve = (result) => {
+      delete window._mcpWindowsResolve;
+      resolve(result);
+    };
+
+    document.body.insertAdjacentHTML('beforeend', toastHtml);
+
+    // Initialize icons
+    if (typeof lucide !== 'undefined') {
+      lucide.createIcons();
+    }
+
+    // Auto-dismiss after 15 seconds (keep original)
+    setTimeout(() => {
+      const toast = document.getElementById(toastId);
+      if (toast) {
+        toast.remove();
+        if (window._mcpWindowsResolve) {
+          window._mcpWindowsResolve(false);
+        }
+      }
+    }, 15000);
+  });
+}
+
 // ========== Codex MCP Functions ==========
 
 /**
@@ -847,6 +988,19 @@ async function submitMcpCreateFromJson() {
 }
 
 async function createMcpServerWithConfig(name, serverConfig, scope = 'project') {
+  // Check Windows compatibility and offer auto-fix if needed
+  const { needsWrapper } = checkWindowsMcpCompatibility(serverConfig);
+  let finalConfig = serverConfig;
+
+  if (needsWrapper) {
+    // Show warning and ask user whether to auto-fix
+    const shouldAutoFix = await showWindowsMcpCompatibilityWarning(name, serverConfig);
+    if (shouldAutoFix) {
+      finalConfig = autoFixWindowsMcpConfig(serverConfig);
+      console.log('[MCP] Auto-fixed config for Windows:', finalConfig);
+    }
+  }
+
   // Submit to API
   try {
     let response;
@@ -859,7 +1013,7 @@ async function createMcpServerWithConfig(name, serverConfig, scope = 'project')
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
           serverName: name,
-          serverConfig: serverConfig
+          serverConfig: finalConfig
         })
       });
       scopeLabel = 'Codex';
@@ -869,7 +1023,7 @@ async function createMcpServerWithConfig(name, serverConfig, scope = 'project')
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({
           serverName: name,
-          serverConfig: serverConfig
+          serverConfig: finalConfig
         })
       });
       scopeLabel = 'global';
@@ -880,7 +1034,7 @@ async function createMcpServerWithConfig(name, serverConfig, scope = 'project')
         body: JSON.stringify({
           projectPath: projectPath,
           serverName: name,
-          serverConfig: serverConfig
+          serverConfig: finalConfig
         })
       });
       scopeLabel = 'project';
@@ -1231,16 +1385,14 @@ const RECOMMENDED_MCP_SERVERS = [
         descKey: 'mcp.ace-tool.field.token.desc'
       }
     ],
-    buildConfig: (values) => ({
-      command: 'npx',
-      args: [
-        'ace-tool',
-        '--base-url',
-        values.baseUrl || 'https://acemcp.heroman.wtf/relay/',
-        '--token',
-        values.token
-      ]
-    })
+    // Uses buildCrossPlatformMcpConfig for automatic Windows cmd /c wrapping
+    buildConfig: (values) => buildCrossPlatformMcpConfig('npx', [
+      'ace-tool',
+      '--base-url',
+      values.baseUrl || 'https://acemcp.heroman.wtf/relay/',
+      '--token',
+      values.token
+    ])
   },
   {
     id: 'chrome-devtools',
@@ -1249,12 +1401,8 @@ const RECOMMENDED_MCP_SERVERS = [
     icon: 'chrome',
     category: 'browser',
     fields: [],
-    buildConfig: () => ({
-      type: 'stdio',
-      command: 'npx',
-      args: ['chrome-devtools-mcp@latest'],
-      env: {}
-    })
+    // Uses buildCrossPlatformMcpConfig for automatic Windows cmd /c wrapping
+    buildConfig: () => buildCrossPlatformMcpConfig('npx', ['chrome-devtools-mcp@latest'], { type: 'stdio' })
   },
   {
     id: 'exa',
@@ -1273,16 +1421,10 @@ const RECOMMENDED_MCP_SERVERS = [
         descKey: 'mcp.exa.field.apiKey.desc'
       }
     ],
+    // Uses buildCrossPlatformMcpConfig for automatic Windows cmd /c wrapping
     buildConfig: (values) => {
-      const config = {
-        command: 'npx',
-        args: ['-y', 'exa-mcp-server']
-      };
-      // Only add env if API key is provided
-      if (values.apiKey) {
-        config.env = { EXA_API_KEY: values.apiKey };
-      }
-      return config;
+      const env = values.apiKey ? { EXA_API_KEY: values.apiKey } : undefined;
+      return buildCrossPlatformMcpConfig('npx', ['-y', 'exa-mcp-server'], { env });
     }
   }
 ];

package/ccw/src/templates/dashboard-js/components/notifications.js

@@ -415,10 +415,15 @@ function handleNotification(data) {
           'CodexLens'
         );
       }
-      // Invalidate CodexLens page cache to ensure fresh data on next visit
+      // Invalidate all CodexLens related caches to ensure fresh data on refresh
+      // Must clear both codexlens-specific cache AND global status cache
+      if (window.cacheManager) {
+        window.cacheManager.invalidate('all-status');
+        window.cacheManager.invalidate('dashboard-init');
+      }
       if (typeof window.invalidateCodexLensCache === 'function') {
         window.invalidateCodexLensCache();
-        console.log('[CodexLens] Cache invalidated after installation');
+        console.log('[CodexLens] All caches invalidated after installation');
       }
       // Refresh CLI status if active
       if (typeof loadCodexLensStatus === 'function') {
@@ -443,10 +448,15 @@ function handleNotification(data) {
           'CodexLens'
         );
       }
-      // Invalidate CodexLens page cache to ensure fresh data on next visit
+      // Invalidate all CodexLens related caches to ensure fresh data on refresh
+      // Must clear both codexlens-specific cache AND global status cache
+      if (window.cacheManager) {
+        window.cacheManager.invalidate('all-status');
+        window.cacheManager.invalidate('dashboard-init');
+      }
       if (typeof window.invalidateCodexLensCache === 'function') {
         window.invalidateCodexLensCache();
-        console.log('[CodexLens] Cache invalidated after uninstallation');
+        console.log('[CodexLens] All caches invalidated after uninstallation');
       }
       // Refresh CLI status if active
       if (typeof loadCodexLensStatus === 'function') {

package/ccw/src/templates/dashboard-js/i18n.js

@@ -261,6 +261,13 @@ const i18n = {
     'cli.wrapper': 'Wrapper',
     'cli.customClaudeSettings': 'Custom Claude CLI settings',
     'cli.updateFailed': 'Failed to update',
+    
+    // CLI Tool Config - Environment File
+    'cli.envFile': 'Environment File',
+    'cli.envFileOptional': '(optional)',
+    'cli.envFilePlaceholder': 'Path to .env file (e.g., ~/.gemini-env or C:/Users/xxx/.env)',
+    'cli.envFileHint': 'Load environment variables (e.g., API keys) before CLI execution. Supports ~ for home directory.',
+    'cli.envFileBrowse': 'Browse',
 
     // CodexLens Configuration
     'codexlens.config': 'CodexLens Configuration',
@@ -995,6 +1002,12 @@ const i18n = {
     'mcp.clickToEdit': 'Click to edit',
     'mcp.clickToViewDetails': 'Click to view details',
 
+    // Windows MCP Compatibility
+    'mcp.windows.title': 'Windows Compatibility Warning',
+    'mcp.windows.compatibilityWarning': 'The MCP server "{name}" uses "{command}" which requires "cmd /c" wrapper on Windows to work properly with Claude Code.',
+    'mcp.windows.autoFix': 'Auto-fix (Recommended)',
+    'mcp.windows.keepOriginal': 'Keep Original',
+
     // Hook Manager
     'hook.projectHooks': 'Project Hooks',
     'hook.projectFile': '.claude/settings.json',
@@ -2415,6 +2428,13 @@ const i18n = {
     'cli.wrapper': '封装',
     'cli.customClaudeSettings': '自定义 Claude CLI 配置',
     'cli.updateFailed': '更新失败',
+    
+    // CLI 工具配置 - 环境文件
+    'cli.envFile': '环境文件',
+    'cli.envFileOptional': '（可选）',
+    'cli.envFilePlaceholder': '.env 文件路径（如 ~/.gemini-env 或 C:/Users/xxx/.env）',
+    'cli.envFileHint': '在 CLI 执行前加载环境变量（如 API 密钥）。支持 ~ 表示用户目录。',
+    'cli.envFileBrowse': '浏览',
 
     // CodexLens 配置
     'codexlens.config': 'CodexLens 配置',
@@ -3128,6 +3148,12 @@ const i18n = {
     'mcp.clickToEdit': '点击编辑',
     'mcp.clickToViewDetails': '点击查看详情',
 
+    // Windows MCP 兼容性
+    'mcp.windows.title': 'Windows 兼容性警告',
+    'mcp.windows.compatibilityWarning': 'MCP 服务器 "{name}" 使用的 "{command}" 命令需要在 Windows 上添加 "cmd /c" 包装才能与 Claude Code 正常工作。',
+    'mcp.windows.autoFix': '自动修复（推荐）',
+    'mcp.windows.keepOriginal': '保持原样',
+
     // Hook Manager
     'hook.projectHooks': '项目钩子',
     'hook.projectFile': '.claude/settings.json',

package/ccw/src/templates/dashboard-js/views/cli-manager.js

@@ -523,6 +523,27 @@ function buildToolConfigModalContent(tool, config, models, status) {
       '</div>' +
     '</div>' +
 
+    // Environment File Section (only for builtin tools: gemini, qwen)
+    (tool === 'gemini' || tool === 'qwen' ? (
+    '<div class="tool-config-section">' +
+      '<h4><i data-lucide="file-key" class="w-3.5 h-3.5"></i> ' + t('cli.envFile') + ' <span class="text-muted">' + t('cli.envFileOptional') + '</span></h4>' +
+      '<div class="env-file-input-group">' +
+        '<div class="env-file-input-row">' +
+          '<input type="text" id="envFileInput" class="tool-config-input" ' +
+            'placeholder="' + t('cli.envFilePlaceholder') + '" ' +
+            'value="' + (config.envFile ? escapeHtml(config.envFile) : '') + '" />' +
+          '<button type="button" class="btn-sm btn-outline" id="envFileBrowseBtn">' +
+            '<i data-lucide="folder-open" class="w-3.5 h-3.5"></i> ' + t('cli.envFileBrowse') +
+          '</button>' +
+        '</div>' +
+        '<p class="env-file-hint">' +
+          '<i data-lucide="info" class="w-3 h-3"></i> ' +
+          t('cli.envFileHint') +
+        '</p>' +
+      '</div>' +
+    '</div>'
+    ) : '') +
+
     // Footer
     '<div class="tool-config-footer">' +
       '<button class="btn btn-outline" onclick="closeModal()">' + t('common.cancel') + '</button>' +
@@ -701,12 +722,23 @@ function initToolConfigModalEvents(tool, currentConfig, models) {
         return;
       }
 
+      // Get envFile value (only for gemini/qwen)
+      var envFileInput = document.getElementById('envFileInput');
+      var envFile = envFileInput ? envFileInput.value.trim() : '';
+
       try {
-        await updateCliToolConfig(tool, {
+        var updateData = {
           primaryModel: primaryModel,
           secondaryModel: secondaryModel,
           tags: currentTags
-        });
+        };
+
+        // Only include envFile for gemini/qwen tools
+        if (tool === 'gemini' || tool === 'qwen') {
+          updateData.envFile = envFile || null;
+        }
+
+        await updateCliToolConfig(tool, updateData);
         // Reload config to reflect changes
         await loadCliToolConfig();
         showRefreshToast('Configuration saved', 'success');
@@ -719,6 +751,44 @@ function initToolConfigModalEvents(tool, currentConfig, models) {
     };
   }
 
+  // Environment file browse button (only for gemini/qwen)
+  var envFileBrowseBtn = document.getElementById('envFileBrowseBtn');
+  if (envFileBrowseBtn) {
+    envFileBrowseBtn.onclick = async function() {
+      try {
+        // Use file dialog API if available
+        var response = await fetch('/api/dialog/open-file', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            title: t('cli.envFile'),
+            filters: [
+              { name: 'Environment Files', extensions: ['env'] },
+              { name: 'All Files', extensions: ['*'] }
+            ],
+            defaultPath: ''
+          })
+        });
+        
+        if (response.ok) {
+          var data = await response.json();
+          if (data.filePath) {
+            var envFileInput = document.getElementById('envFileInput');
+            if (envFileInput) {
+              envFileInput.value = data.filePath;
+            }
+          }
+        } else {
+          // Fallback: prompt user to enter path manually
+          showRefreshToast('File dialog not available. Please enter path manually.', 'info');
+        }
+      } catch (err) {
+        console.error('Failed to open file dialog:', err);
+        showRefreshToast('File dialog not available. Please enter path manually.', 'info');
+      }
+    };
+  }
+
   // Initialize lucide icons in modal
   if (window.lucide) lucide.createIcons();
 }