feat: 添加更好的 SQLite3 模块加载和错误处理，更新相关组件以支持项目路径

Author: catlog22

.claude/settings.json

@@ -0,0 +1,22 @@
+{
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const p=JSON.parse(process.env.HOOK_INPUT||\\\"{}\\\");const prompt=(p.user_prompt||\\\"\\\").trim();if(/^ccw\\s+session\\s+init/i.test(prompt)||/^\\/workflow:session:start/i.test(prompt)||/^\\/workflow:session\\s+init/i.test(prompt)){const cp=require(\\\"child_process\\\");const payload=JSON.stringify({type:\\\"SESSION_CREATED\\\",prompt:prompt,timestamp:Date.now(),project:process.env.CLAUDE_PROJECT_DIR||process.cwd()});cp.spawnSync(\\\"curl\\\",[\\\"-s\\\",\\\"-X\\\",\\\"POST\\\",\\\"-H\\\",\\\"Content-Type: application/json\\\",\\\"-d\\\",payload,\\\"http://localhost:3456/api/hook\\\"],{stdio:\\\"inherit\\\",shell:true})}\""
+          }
+        ]
+      },
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node -e \"const p=JSON.parse(process.env.HOOK_INPUT||\\\"{}\\\");const prompt=(p.user_prompt||\\\"\\\").toLowerCase();if(prompt===\\\"status\\\"||prompt===\\\"ccw status\\\"||prompt.startsWith(\\\"/status\\\")){const cp=require(\\\"child_process\\\");cp.spawnSync(\\\"curl\\\",[\\\"-s\\\",\\\"http://localhost:3456/api/status/all\\\"],{stdio:\\\"inherit\\\"})}\""
+          }
+        ]
+      }
+    ]
+  }
+}

FAQ.md

@@ -520,6 +520,32 @@ dist/
 
 ## 🔧 Troubleshooting
 
+### `better-sqlite3` NODE_MODULE_VERSION mismatch
+
+**Error message**:
+```
+Error: The module '.../better_sqlite3.node' was compiled against a different Node.js version
+using NODE_MODULE_VERSION XX. This version of Node.js requires NODE_MODULE_VERSION YY.
+```
+
+**Cause**: The `better-sqlite3` native module was compiled for a different Node.js version than the one you're running. This commonly happens when:
+- You installed dependencies with one Node.js version and later switched versions
+- Prebuilt binaries don't match your Node.js version
+
+**Solution**:
+```bash
+# Option 1: Rebuild the native module (recommended)
+npm rebuild better-sqlite3
+
+# Option 2: Rebuild from source
+npm install better-sqlite3 --build-from-source
+
+# Option 3: Reinstall all dependencies
+rm -rf node_modules && npm install
+```
+
+> **Note**: Building from source requires C++ build tools. On macOS run `xcode-select --install`, on Ubuntu run `sudo apt install build-essential`, on Windows install [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/).
+
 ### "No active session found" error
 
 **Cause**: No workflow session is currently active.

README.md

@@ -81,6 +81,8 @@ npm install -g claude-code-workflow
 ccw install -m Global
 ```
 
+> **Troubleshooting**: If you see `NODE_MODULE_VERSION` mismatch errors for `better-sqlite3`, run `npm rebuild better-sqlite3`. See [FAQ - Troubleshooting](FAQ.md#better-sqlite3-node_module_version-mismatch) for details.
+
 ### Choose Your Workflow Level
 
 <div align="center">

ccw/frontend/src/components/mcp/CrossCliCopyButton.tsx

@@ -17,8 +17,9 @@ import {
 import { Checkbox } from '@/components/ui/Checkbox';
 import { Badge } from '@/components/ui/Badge';
 import { useMcpServers } from '@/hooks';
-import { crossCliCopy } from '@/lib/api';
+import { crossCliCopy, fetchCodexMcpServers } from '@/lib/api';
 import { cn } from '@/lib/utils';
+import { useWorkflowStore, selectProjectPath } from '@/stores/workflowStore';
 
 // ========== Types ==========
 
@@ -69,13 +70,11 @@ export function CrossCliCopyButton({
   const [serverItems, setServerItems] = useState<ServerCheckboxItem[]>([]);
 
   const { servers } = useMcpServers();
+  const projectPath = useWorkflowStore(selectProjectPath);
   const [isCopying, setIsCopying] = useState(false);
 
-  // Initialize server items when dialog opens
-  const handleOpenChange = (open: boolean) => {
-    setIsOpen(open);
-    if (open) {
-      setDirection(currentMode === 'claude' ? 'claude-to-codex' : 'codex-to-claude');
+  const loadServerItems = async (nextDirection: CopyDirection) => {
+    if (nextDirection === 'claude-to-codex') {
       setServerItems(
         servers.map((s) => ({
           name: s.name,
@@ -84,6 +83,34 @@ export function CrossCliCopyButton({
           selected: false,
         }))
       );
+      return;
+    }
+
+    try {
+      const codex = await fetchCodexMcpServers();
+      setServerItems(
+        (codex.servers ?? []).map((s) => ({
+          name: s.name,
+          command: s.command,
+          enabled: s.enabled,
+          selected: false,
+        }))
+      );
+    } catch (error) {
+      console.error('Failed to load Codex MCP servers:', error);
+      setServerItems([]);
+    }
+  };
+
+  // Initialize server items when dialog opens
+  const handleOpenChange = (open: boolean) => {
+    setIsOpen(open);
+    if (open) {
+      const nextDirection = currentMode === 'claude' ? 'claude-to-codex' : 'codex-to-claude';
+      setDirection(nextDirection);
+      void loadServerItems(nextDirection);
+    } else {
+      setServerItems([]);
     }
   };
 
@@ -93,10 +120,9 @@ export function CrossCliCopyButton({
 
   // Toggle direction
   const handleToggleDirection = () => {
-    setDirection((prev) =>
-      prev === 'claude-to-codex' ? 'codex-to-claude' : 'claude-to-codex'
-    );
-    setServerItems((prev) => prev.map((item) => ({ ...item, selected: false })));
+    const next = direction === 'claude-to-codex' ? 'codex-to-claude' : 'claude-to-codex';
+    setDirection(next);
+    void loadServerItems(next);
   };
 
   // Toggle server selection
@@ -124,10 +150,15 @@ export function CrossCliCopyButton({
 
     setIsCopying(true);
     try {
+      if (targetCli === 'claude' && !projectPath) {
+        throw new Error('Project path is required to copy servers into Claude project');
+      }
+
       const result = await crossCliCopy({
         source: sourceCli,
         target: targetCli,
         serverNames: selectedServers,
+        projectPath: projectPath ?? undefined,
       });
 
       if (result.success) {

ccw/frontend/src/components/mcp/McpServerDialog.tsx

@@ -28,10 +28,12 @@ import {
   updateMcpServer,
   fetchMcpServers,
   type McpServer,
+  type McpProjectConfigType,
 } from '@/lib/api';
 import { mcpServersKeys, useMcpTemplates } from '@/hooks';
 import { cn } from '@/lib/utils';
 import { ConfigTypeToggle, type McpConfigType } from './ConfigTypeToggle';
+import { useWorkflowStore, selectProjectPath } from '@/stores/workflowStore';
 
 // ========== Types ==========
 
@@ -73,6 +75,7 @@ export function McpServerDialog({
 }: McpServerDialogProps) {
   const { formatMessage } = useIntl();
   const queryClient = useQueryClient();
+  const projectPath = useWorkflowStore(selectProjectPath);
 
   // Fetch templates from backend
   const { templates, isLoading: templatesLoading } = useMcpTemplates();
@@ -92,6 +95,7 @@ export function McpServerDialog({
   const [argsInput, setArgsInput] = useState('');
   const [envInput, setEnvInput] = useState('');
   const [configType, setConfigType] = useState<McpConfigType>('mcp-json');
+  const projectConfigType: McpProjectConfigType = configType === 'claude-json' ? 'claude' : 'mcp';
 
   // Initialize form from server prop (edit mode)
   useEffect(() => {
@@ -129,7 +133,8 @@ export function McpServerDialog({
 
   // Mutations
   const createMutation = useMutation({
-    mutationFn: (data: Omit<McpServer, 'name'>) => createMcpServer(data),
+    mutationFn: ({ server, configType }: { server: McpServer; configType?: McpProjectConfigType }) =>
+      createMcpServer(server, { projectPath: projectPath ?? undefined, configType }),
     onSuccess: () => {
       queryClient.invalidateQueries({ queryKey: mcpServersKeys.all });
       handleClose();
@@ -138,8 +143,8 @@ export function McpServerDialog({
   });
 
   const updateMutation = useMutation({
-    mutationFn: ({ serverName, config }: { serverName: string; config: Partial<McpServer> }) =>
-      updateMcpServer(serverName, config),
+    mutationFn: ({ serverName, config, configType }: { serverName: string; config: Partial<McpServer>; configType?: McpProjectConfigType }) =>
+      updateMcpServer(serverName, config, { projectPath: projectPath ?? undefined, configType }),
     onSuccess: () => {
       queryClient.invalidateQueries({ queryKey: mcpServersKeys.all });
       handleClose();
@@ -234,7 +239,7 @@ export function McpServerDialog({
 
   const checkNameExists = async (name: string): Promise<boolean> => {
     try {
-      const data = await fetchMcpServers();
+      const data = await fetchMcpServers(projectPath ?? undefined);
       const allServers = [...data.project, ...data.global];
       // In edit mode, exclude current server
       return allServers.some(
@@ -258,11 +263,15 @@ export function McpServerDialog({
 
     if (mode === 'add') {
       createMutation.mutate({
-        command: formData.command,
-        args: formData.args,
-        env: formData.env,
-        scope: formData.scope,
-        enabled: formData.enabled,
+        server: {
+          name: formData.name,
+          command: formData.command,
+          args: formData.args,
+          env: formData.env,
+          scope: formData.scope,
+          enabled: formData.enabled,
+        },
+        configType: formData.scope === 'project' ? projectConfigType : undefined,
       });
     } else {
       updateMutation.mutate({
@@ -274,6 +283,7 @@ export function McpServerDialog({
           scope: formData.scope,
           enabled: formData.enabled,
         },
+        configType: formData.scope === 'project' ? projectConfigType : undefined,
       });
     }
   };
@@ -441,6 +451,7 @@ export function McpServerDialog({
                   checked={formData.scope === 'project'}
                   onChange={(e) => handleFieldChange('scope', e.target.value as 'project' | 'global')}
                   className="w-4 h-4"
+                  disabled={mode === 'edit'}
                 />
                 <span className="text-sm">
                   {formatMessage({ id: 'mcp.scope.project' })}
@@ -454,6 +465,7 @@ export function McpServerDialog({
                   checked={formData.scope === 'global'}
                   onChange={(e) => handleFieldChange('scope', e.target.value as 'project' | 'global')}
                   className="w-4 h-4"
+                  disabled={mode === 'edit'}
                 />
                 <span className="text-sm">
                   {formatMessage({ id: 'mcp.scope.global' })}

ccw/frontend/src/components/mcp/OtherProjectsSection.tsx

@@ -63,9 +63,10 @@ export function OtherProjectsSection({
 
       for (const [path, serverList] of Object.entries(response.servers)) {
         const projectName = path.split(/[/\\]/).filter(Boolean).pop() || path;
-        for (const server of (serverList as McpServer[])) {
+        for (const server of (serverList as Omit<McpServer, 'scope'>[])) {
           servers.push({
             ...server,
+            scope: 'project',
             projectPath: path,
             projectName,
           });
@@ -88,6 +89,7 @@ export function OtherProjectsSection({
       const uniqueName = `${server.projectName}-${server.name}`.toLowerCase().replace(/\s+/g, '-');
 
       await createServer({
+        name: uniqueName,
         command: server.command,
         args: server.args,
         env: server.env,

ccw/frontend/src/components/mcp/RecommendedMcpWizard.tsx

@@ -25,6 +25,7 @@ import {
 import { mcpServersKeys } from '@/hooks';
 import { useNotifications } from '@/hooks/useNotifications';
 import { cn } from '@/lib/utils';
+import { useWorkflowStore, selectProjectPath } from '@/stores/workflowStore';
 
 // Icon map for MCP definitions
 const ICON_MAP: Record<string, React.ComponentType<{ className?: string }>> = {
@@ -96,6 +97,7 @@ export function RecommendedMcpWizard({
   const { formatMessage } = useIntl();
   const queryClient = useQueryClient();
   const { success: showSuccess, error: showError } = useNotifications();
+  const projectPath = useWorkflowStore(selectProjectPath);
 
   // State for field values
   const [fieldValues, setFieldValues] = useState<Record<string, any>>({});
@@ -138,7 +140,10 @@ export function RecommendedMcpWizard({
       if (selectedScope === 'global') {
         return addGlobalMcpServer(mcpDefinition.id, serverConfig);
       } else {
-        return copyMcpServerToProject(mcpDefinition.id, serverConfig);
+        if (!projectPath) {
+          throw new Error('Project path is required to install to project scope');
+        }
+        return copyMcpServerToProject(mcpDefinition.id, serverConfig, projectPath);
       }
     },
     onSuccess: (result) => {

ccw/frontend/src/hooks/useMcpServers.ts

@@ -524,8 +524,18 @@ export function useProjectOperations(): UseProjectOperationsReturn {
     isLoading: projectsQuery.isLoading,
     error: projectsQuery.error,
     refetch,
-    copyToCodex: (request) => copyMutation.mutateAsync({ ...request, source: 'claude', target: 'codex' }),
-    copyFromCodex: (request) => copyMutation.mutateAsync({ ...request, source: 'codex', target: 'claude' }),
+    copyToCodex: (request) => copyMutation.mutateAsync({
+      ...request,
+      source: 'claude',
+      target: 'codex',
+      projectPath: request.projectPath ?? projectPath ?? undefined,
+    }),
+    copyFromCodex: (request) => copyMutation.mutateAsync({
+      ...request,
+      source: 'codex',
+      target: 'claude',
+      projectPath: request.projectPath ?? projectPath ?? undefined,
+    }),
     isCopying: copyMutation.isPending,
     fetchOtherServers,
     isFetchingServers: serversQuery.isFetching,