claude-code-workflow 6.3.24 → 6.3.26

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();
 }

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

@@ -72,6 +72,10 @@ function invalidateCache(key) {
     Object.values(CACHE_KEY_MAP).forEach(function(k) {
       window.cacheManager.invalidate(k);
     });
+    // 重要：同时清理包含 CodexLens 状态的全局缓存
+    // 这些缓存在 cli-status.js 中使用，包含 codexLens.ready 状态
+    window.cacheManager.invalidate('all-status');
+    window.cacheManager.invalidate('dashboard-init');
   }
 }
 
@@ -788,6 +792,12 @@ function initCodexLensConfigEvents(currentConfig) {
 
         if (result.success) {
           showRefreshToast(t('codexlens.configSaved'), 'success');
+
+          // Invalidate config cache to ensure fresh data on next load
+          if (window.cacheManager) {
+            window.cacheManager.invalidate('codexlens-config');
+          }
+
           closeModal();
 
           // Refresh CodexLens status
@@ -5385,7 +5395,7 @@ function initCodexLensManagerPageEvents(currentConfig) {
       try {
         var response = await csrfFetch('/api/codexlens/config', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ index_dir: newIndexDir }) });
         var result = await response.json();
-        if (result.success) { showRefreshToast(t('codexlens.configSaved'), 'success'); renderCodexLensManager(); }
+        if (result.success) { if (window.cacheManager) { window.cacheManager.invalidate('codexlens-config'); } showRefreshToast(t('codexlens.configSaved'), 'success'); renderCodexLensManager(); }
         else { showRefreshToast(t('common.saveFailed') + ': ' + result.error, 'error'); }
       } catch (err) { showRefreshToast(t('common.error') + ': ' + err.message, 'error'); }
       saveBtn.disabled = false;

package/ccw/src/tools/claude-cli-tools.ts

@@ -34,6 +34,11 @@ export interface ClaudeCliTool {
    * Used to lookup endpoint configuration in litellm-api-config.json
    */
   id?: string;
+  /**
+   * Path to .env file for loading environment variables before CLI execution
+   * Supports both absolute paths and paths relative to home directory (e.g., ~/.my-env)
+   */
+  envFile?: string;
 }
 
 export type CliToolName = 'gemini' | 'qwen' | 'codex' | 'claude' | 'opencode' | string;
@@ -808,6 +813,7 @@ export function getToolConfig(projectDir: string, tool: string): {
   primaryModel: string;
   secondaryModel: string;
   tags?: string[];
+  envFile?: string;
 } {
   const config = loadClaudeCliTools(projectDir);
   const toolConfig = config.tools[tool];
@@ -826,7 +832,8 @@ export function getToolConfig(projectDir: string, tool: string): {
     enabled: toolConfig.enabled,
     primaryModel: toolConfig.primaryModel ?? '',
     secondaryModel: toolConfig.secondaryModel ?? '',
-    tags: toolConfig.tags
+    tags: toolConfig.tags,
+    envFile: toolConfig.envFile
   };
 }
 
@@ -841,6 +848,7 @@ export function updateToolConfig(
     primaryModel: string;
     secondaryModel: string;
     tags: string[];
+    envFile: string | null;
   }>
 ): ClaudeCliToolsConfig {
   const config = loadClaudeCliTools(projectDir);
@@ -858,6 +866,14 @@ export function updateToolConfig(
     if (updates.tags !== undefined) {
       config.tools[tool].tags = updates.tags;
     }
+    // Handle envFile: set to undefined if null/empty, otherwise set value
+    if (updates.envFile !== undefined) {
+      if (updates.envFile === null || updates.envFile === '') {
+        delete config.tools[tool].envFile;
+      } else {
+        config.tools[tool].envFile = updates.envFile;
+      }
+    }
     saveClaudeCliTools(projectDir, config);
   }