speccrew 0.7.9 → 0.7.11

package/.speccrew/skills/speccrew-knowledge-bizs-init-features/scripts/generate-inventory.js

@@ -63,13 +63,25 @@ function toRelativePath(absolutePath, projectRoot) {
   return normalizedAbs;
 }
 
+// Generate unique feature ID from source path
+// Converts path separators to hyphens, removes extension
+// e.g., 'src/views/bpm/form/data.ts' -> 'src-views-bpm-form-data'
+// e.g., 'ruoyi-fastapi-app/src/pages/common/agreement/index.vue' -> 'ruoyi-fastapi-app-src-pages-common-agreement-index'
+function generateFeatureId(relativeSourcePath) {
+  // Remove file extension
+  const pathWithoutExt = relativeSourcePath.replace(/\.[^.]+$/, '');
+  
+  // Replace path separators with hyphens
+  const id = pathWithoutExt.replace(/\//g, '-').replace(/\\/g, '-');
+  
+  return id;
+}
+
 // Generate document path for a feature
-// Format: speccrew-workspace/knowledges/bizs/{platformId}/{module}/{subpath}/{filename}.md
+// Format: speccrew-workspace/knowledges/bizs/{platformId}/{module}/{subpath}/{uniqueName}.md
+// The documentPath must be unique to avoid overwriting
 function generateDocumentPath(platformId, module, sourcePath, projectRoot) {
-  // Extract filename without extension
-  const basename = path.basename(sourcePath, path.extname(sourcePath));
-  
-  // Get directory relative to module root
+  // Get the relative path from project root
   const relativePath = toRelativePath(sourcePath, projectRoot);
   
   // Parse the source path to extract module and subpath
@@ -92,6 +104,22 @@ function generateDocumentPath(platformId, module, sourcePath, projectRoot) {
     subpath = pathParts.slice(moduleIndex + 1, pathParts.length - 1).join('/');
   }
   
+  // Extract filename without extension
+  const basename = path.basename(sourcePath, path.extname(sourcePath));
+  
+  // Generate unique document name to avoid collisions
+  // Use the path after module to create a unique name
+  let uniqueDocName;
+  if (moduleIndex >= 0 && moduleIndex < pathParts.length - 1) {
+    // Get all path parts after module (excluding extension)
+    const pathAfterModule = pathParts.slice(moduleIndex + 1);
+    // Join with hyphens to create unique name
+    uniqueDocName = pathAfterModule.join('-').replace(/\.[^.]+$/, '');
+  } else {
+    // Fallback: use basename
+    uniqueDocName = basename;
+  }
+  
   // Construct document path using platformId (which follows {platformType}-{techStack} format)
   // e.g., backend-fastapi, web-vue3, mobile-uniapp
   const docPathParts = ['speccrew-workspace', 'knowledges', 'bizs', platformId, module];
@@ -100,7 +128,7 @@ function generateDocumentPath(platformId, module, sourcePath, projectRoot) {
     docPathParts.push(subpath);
   }
   
-  docPathParts.push(`${basename}.md`);
+  docPathParts.push(`${uniqueDocName}.md`);
   
   return docPathParts.join('/');
 }
@@ -203,10 +231,14 @@ function main() {
         const relativeSourcePath = toRelativePath(sourceFile, projectRoot);
         const fileName = path.basename(sourceFile, path.extname(sourceFile));
         
-        // Generate document path using platformId
+        // Generate unique feature ID based on full relative path
+        const featureId = generateFeatureId(relativeSourcePath);
+        
+        // Generate document path using platformId (now with unique filename)
         const documentPath = generateDocumentPath(platformId, moduleName, sourceFile, projectRoot);
         
         features.push({
+          id: featureId,
           fileName: fileName,
           sourcePath: relativeSourcePath,
           documentPath: documentPath,
@@ -227,6 +259,9 @@ function main() {
     });
   }
   
+  // Determine analysis method based on platform type
+  const analysisMethod = platformType === 'backend' ? 'api-based' : 'ui-based';
+  
   // Build output JSON
   const outputData = {
     platformName: platformName,
@@ -235,6 +270,7 @@ function main() {
     platformId: platformId,
     sourcePath: sourceRoot,
     techStack: techStack,
+    analysisMethod: analysisMethod,
     modules: modules,
     totalFiles: features.length,
     analyzedCount: 0,

package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-DESKTOP.md

@@ -78,21 +78,21 @@ source-path: {sourcePath}
 
 | Area | Element | Control | Description | Interaction | Source Link |
 |------|---------|---------|-------------|-------------|-------------|
-| Menu | File Menu | MenuStrip | {Application menu} | Click | [Source](../../{sourcePath}) |
-| Toolbar | New Button | ToolStripButton | {Create new} | Click | [Source](../../{sourcePath}) |
-| Tree | Navigation | TreeView | {Navigate sections} | NodeClick | [Source](../../{sourcePath}) |
-| Grid | Data Grid | DataGridView | {Display data} | CellClick/DoubleClick | [Source](../../{sourcePath}) |
-| Status | Status Label | StatusStrip | {Show status} | - | [Source](../../{sourcePath}) |
+| Menu | File Menu | MenuStrip | {Application menu} | Click | [Source](../../../../../../{sourcePath}) |
+| Toolbar | New Button | ToolStripButton | {Create new} | Click | [Source](../../../../../../{sourcePath}) |
+| Tree | Navigation | TreeView | {Navigate sections} | NodeClick | [Source](../../../../../../{sourcePath}) |
+| Grid | Data Grid | DataGridView | {Display data} | CellClick/DoubleClick | [Source](../../../../../../{sourcePath}) |
+| Status | Status Label | StatusStrip | {Show status} | - | [Source](../../../../../../{sourcePath}) |
 
 **Desktop-Specific Interactions:**
 
 | Interaction | Action | Description | Source |
 |-------------|--------|-------------|--------|
-| Click | Select/Activate | Mouse click | [Source](../../{sourcePath}) |
-| DoubleClick | Open/Edit | Double click row | [Source](../../{sourcePath}) |
-| RightClick | Context Menu | Show context menu | [Source](../../{sourcePath}) |
-| DragDrop | Reorder | Drag and drop items | [Source](../../{sourcePath}) |
-| Keyboard | Shortcut | Ctrl+S, Ctrl+N, etc. | [Source](../../{sourcePath}) |
+| Click | Select/Activate | Mouse click | [Source](../../../../../../{sourcePath}) |
+| DoubleClick | Open/Edit | Double click row | [Source](../../../../../../{sourcePath}) |
+| RightClick | Context Menu | Show context menu | [Source](../../../../../../{sourcePath}) |
+| DragDrop | Reorder | Drag and drop items | [Source](../../../../../../{sourcePath}) |
+| Keyboard | Shortcut | Ctrl+S, Ctrl+N, etc. | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -121,11 +121,11 @@ graph TB
 
 | Step | Business Operation | Event | Source |
 |------|-------------------|-------|--------|
-| 1 | Initialize UI components | Form_Load/OnInitialized | [Source](../../{sourcePath}) |
-| 2 | Load app configuration | After init | [Source](../../{sourcePath}) |
-| 3 | Check authentication | After config load | [Source](../../{sourcePath}) |
-| 4 | Load data from service | Auth passed | [Source](../../{sourcePath}) |
-| 5 | Bind data to controls | Data loaded | [Source](../../{sourcePath}) |
+| 1 | Initialize UI components | Form_Load/OnInitialized | [Source](../../../../../../{sourcePath}) |
+| 2 | Load app configuration | After init | [Source](../../../../../../{sourcePath}) |
+| 3 | Check authentication | After config load | [Source](../../../../../../{sourcePath}) |
+| 4 | Load data from service | Auth passed | [Source](../../../../../../{sourcePath}) |
+| 5 | Bind data to controls | Data loaded | [Source](../../../../../../{sourcePath}) |
 
 ### 3.2 User Interaction Flows
 
@@ -151,11 +151,11 @@ graph TB
 
 | Step | Business Operation | Event | Source |
 |------|-------------------|-------|--------|
-| 1 | Get selected row | DoubleClick | [Source](../../{sourcePath}) |
-| 2 | Validate selection | After get | [Source](../../{sourcePath}) |
-| 3 | Open edit dialog | Validation passed | [Source](../../{sourcePath}) |
-| 4 | Load detail data | Dialog opened | [Source](../../{sourcePath}) |
-| 5 | Handle save/cancel | Dialog closed | [Source](../../{sourcePath}) |
+| 1 | Get selected row | DoubleClick | [Source](../../../../../../{sourcePath}) |
+| 2 | Validate selection | After get | [Source](../../../../../../{sourcePath}) |
+| 3 | Open edit dialog | Validation passed | [Source](../../../../../../{sourcePath}) |
+| 4 | Load detail data | Dialog opened | [Source](../../../../../../{sourcePath}) |
+| 5 | Handle save/cancel | Dialog closed | [Source](../../../../../../{sourcePath}) |
 
 #### 3.2.2 {Event Name: e.g., Toolbar Button Click}
 
@@ -190,12 +190,12 @@ graph TB
 
 | Event | WPF | WinForms | Purpose | Source |
 |-------|-----|----------|---------|--------|
-| Initialized | ✅ | - | Component init | [Source](../../{sourcePath}) |
-| Loaded | ✅ | Load | Window loaded | [Source](../../{sourcePath}) |
-| Shown | - | Shown | Window visible | [Source](../../{sourcePath}) |
-| Activated | ✅ | Activated | Window focused | [Source](../../{sourcePath}) |
-| Closing | ✅ | FormClosing | About to close | [Source](../../{sourcePath}) |
-| Closed | ✅ | FormClosed | Window closed | [Source](../../{sourcePath}) |
+| Initialized | ✅ | - | Component init | [Source](../../../../../../{sourcePath}) |
+| Loaded | ✅ | Load | Window loaded | [Source](../../../../../../{sourcePath}) |
+| Shown | - | Shown | Window visible | [Source](../../../../../../{sourcePath}) |
+| Activated | ✅ | Activated | Window focused | [Source](../../../../../../{sourcePath}) |
+| Closing | ✅ | FormClosing | About to close | [Source](../../../../../../{sourcePath}) |
+| Closed | ✅ | FormClosed | Window closed | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -205,18 +205,18 @@ graph TB
 
 | Field Name | Type | Description | Binding | Source |
 |------------|------|-------------|---------|--------|
-| {Field 1} | string/int/bool | {Description} | {OneWay/TwoWay} | [Source](../../{sourcePath}) |
-| {SelectedItem} | Object | {Current selection} | {OneWayToSource} | [Source](../../{sourcePath}) |
-| {DataSource} | Collection | {List data} | {OneWay} | [Source](../../{sourcePath}) |
-| {IsBusy} | bool | {Loading state} | {OneWay} | [Source](../../{sourcePath}) |
+| {Field 1} | string/int/bool | {Description} | {OneWay/TwoWay} | [Source](../../../../../../{sourcePath}) |
+| {SelectedItem} | Object | {Current selection} | {OneWayToSource} | [Source](../../../../../../{sourcePath}) |
+| {DataSource} | Collection | {List data} | {OneWay} | [Source](../../../../../../{sourcePath}) |
+| {IsBusy} | bool | {Loading state} | {OneWay} | [Source](../../../../../../{sourcePath}) |
 
 ### 4.2 Form Fields (if applicable)
 
 | Field Name | Type | Validation | Control | Source |
 |------------|------|------------|---------|--------|
-| {Field 1} | string | {Required} | TextBox | [Source](../../{sourcePath}) |
-| {Field 2} | int | {Range} | NumericUpDown | [Source](../../{sourcePath}) |
-| {Field 3} | DateTime | {Not null} | DateTimePicker | [Source](../../{sourcePath}) |
+| {Field 1} | string | {Required} | TextBox | [Source](../../../../../../{sourcePath}) |
+| {Field 2} | int | {Range} | NumericUpDown | [Source](../../../../../../{sourcePath}) |
+| {Field 3} | DateTime | {Not null} | DateTimePicker | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -226,25 +226,25 @@ graph TB
 
 | Service | Type | Main Function | Source | Document Path |
 |---------|------|---------------|--------|---------------|
-| {Service Name} | Business | {Description} | [Source](../../{serviceSourcePath}) | [Service Doc](../../services/{service-name}.md) |
+| {Service Name} | Business | {Description} | [Source](../../../../../../{serviceSourcePath}) | [Service Doc](../../../../../../services/{service-name}.md) |
 
 ### 5.2 UI Components
 
 | Component | Framework | Type | Main Function | Source | Document Path |
 |-----------|-----------|------|---------------|--------|---------------|
-| {UserControl} | WPF/WinForms | Custom | {Reusable UI} | [Source](../../{componentSourcePath}) | [Component Doc](../../components/{component-name}.md) |
+| {UserControl} | WPF/WinForms | Custom | {Reusable UI} | [Source](../../../../../../{componentSourcePath}) | [Component Doc](../../../../../../components/{component-name}.md) |
 
 ### 5.3 Other Windows
 
 | Window Name | Relation Type | Description | Source | Document Path |
 |-------------|---------------|-------------|--------|---------------|
-| {Window Name} | Dialog/Child | {Relation description} | [Source](../../{windowSourcePath}) | [Window Doc](../{window-path}.md) |
+| {Window Name} | Dialog/Child | {Relation description} | [Source](../../../../../../{windowSourcePath}) | [Window Doc](../{window-path}.md) |
 
 ### 5.4 Referenced By
 
 | Window Name | Function Description | Source Path | Document Path |
 |-------------|---------------------|-------------|---------------|
-| {Referencing Window} | {e.g., "Open this window from main menu"} | {source-path} | [Window Doc](../{window-path}.md) |
+| {Referencing Window} | {e.g., "Open this window from main menu"} | {source-path} | [Window Doc](../../../../../../{window-path}.md) |
 
 ---
 
@@ -254,21 +254,21 @@ graph TB
 
 | Operation | Permission Requirement | No Permission Handling | Source |
 |-----------|----------------------|----------------------|--------|
-| View window | {Role required} | Hide menu item / Show message | [Source](../../{sourcePath}) |
-| Edit data | {Permission required} | Disable edit button | [Source](../../{sourcePath}) |
-| Delete record | {Admin role} | Disable delete button | [Source](../../{sourcePath}) |
+| View window | {Role required} | Hide menu item / Show message | [Source](../../../../../../{sourcePath}) |
+| Edit data | {Permission required} | Disable edit button | [Source](../../../../../../{sourcePath}) |
+| Delete record | {Admin role} | Disable delete button | [Source](../../../../../../{sourcePath}) |
 
 ### 6.2 Desktop-Specific Rules
 
-1. **Auto-save**: {e.g., Auto-save draft every 5 minutes} | [Source](../../{sourcePath})
-2. **Keyboard Shortcuts**: {e.g., Ctrl+S save, Ctrl+F find} | [Source](../../{sourcePath})
-3. **Window State**: {e.g., Remember window size and position} | [Source](../../{sourcePath})
+1. **Auto-save**: {e.g., Auto-save draft every 5 minutes} | [Source](../../../../../../{sourcePath})
+2. **Keyboard Shortcuts**: {e.g., Ctrl+S save, Ctrl+F find} | [Source](../../../../../../{sourcePath})
+3. **Window State**: {e.g., Remember window size and position} | [Source](../../../../../../{sourcePath})
 
 ### 6.3 Validation Rules
 
 | Scenario | Rule | Error Handling | Source |
 |----------|------|----------------|--------|
-| Form submit | {Validation rule} | Show error provider / MessageBox | [Source](../../{sourcePath}) |
+| Form submit | {Validation rule} | Show error provider / MessageBox | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -299,5 +299,5 @@ graph TB
 **Related Module Document:** [Module Overview Document](../{{module-name}}-overview.md)
 
 **Section Source**
-- [{Window}.xaml.cs/{Form}.cs](../../{sourcePath})
-- [{ViewModel}.cs](../../{viewModelPath})
+- [{Window}.xaml.cs/{Form}.cs](../../../../../../{sourcePath})
+- [{ViewModel}.cs](../../../../../../{viewModelPath})

package/.speccrew/skills/speccrew-knowledge-bizs-ui-analyze/templates/FEATURE-DETAIL-TEMPLATE-UI-ELECTRON.md

@@ -72,22 +72,22 @@ source-path: {sourcePath}
 
 | Area | Element | Type | Description | Interaction | Source Link |
 |------|---------|------|-------------|-------------|-------------|
-| Title Bar | Window Controls | Button | {Minimize/Maximize/Close} | Click | [Source](../../{sourcePath}) |
-| Menu | App Menu | Menu | {Application menu} | Click | [Source](../../{sourcePath}) |
-| Toolbar | Action Buttons | Button | {Primary actions} | Click | [Source](../../{sourcePath}) |
-| Sidebar | Navigation | Nav | {Section navigation} | Click | [Source](../../{sourcePath}) |
-| Content | Cards/Tables | Component | {Display content} | Click/Right-click | [Source](../../{sourcePath}) |
-| Status Bar | Status Info | Status | {App status} | - | [Source](../../{sourcePath}) |
+| Title Bar | Window Controls | Button | {Minimize/Maximize/Close} | Click | [Source](../../../../../../{sourcePath}) |
+| Menu | App Menu | Menu | {Application menu} | Click | [Source](../../../../../../{sourcePath}) |
+| Toolbar | Action Buttons | Button | {Primary actions} | Click | [Source](../../../../../../{sourcePath}) |
+| Sidebar | Navigation | Nav | {Section navigation} | Click | [Source](../../../../../../{sourcePath}) |
+| Content | Cards/Tables | Component | {Display content} | Click/Right-click | [Source](../../../../../../{sourcePath}) |
+| Status Bar | Status Info | Status | {App status} | - | [Source](../../../../../../{sourcePath}) |
 
 **Electron-Specific Interactions:**
 
 | Interaction | Action | Description | Source |
 |-------------|--------|-------------|--------|
-| Click | Select/Activate | Mouse click | [Source](../../{sourcePath}) |
-| RightClick | Context Menu | Show native/context menu | [Source](../../{sourcePath}) |
-| Drag | File Drop | Drag files into window | [Source](../../{sourcePath}) |
-| Keyboard | Shortcut | Cmd/Ctrl+ shortcuts | [Source](../../{sourcePath}) |
-| IPC | Main ↔ Renderer | Communication between processes | [Source](../../{sourcePath}) |
+| Click | Select/Activate | Mouse click | [Source](../../../../../../{sourcePath}) |
+| RightClick | Context Menu | Show native/context menu | [Source](../../../../../../{sourcePath}) |
+| Drag | File Drop | Drag files into window | [Source](../../../../../../{sourcePath}) |
+| Keyboard | Shortcut | Cmd/Ctrl+ shortcuts | [Source](../../../../../../{sourcePath}) |
+| IPC | Main ↔ Renderer | Communication between processes | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -121,12 +121,12 @@ graph TB
 
 | Step | Business Operation | Process | Source |
 |------|-------------------|---------|--------|
-| 1 | Main process starts | Main | [Source](../../{mainSourcePath}) |
-| 2 | Create browser window | Main | [Source](../../{mainSourcePath}) |
-| 3 | Renderer process loads | Renderer | [Source](../../{sourcePath}) |
-| 4 | Initialize frontend framework | Renderer | [Source](../../{sourcePath}) |
-| 5 | Check for updates | Main → Renderer | [Source](../../{sourcePath}) |
-| 6 | Load user data via IPC | Renderer → Main | [Source](../../{sourcePath}) |
+| 1 | Main process starts | Main | [Source](../../../../../../{mainSourcePath}) |
+| 2 | Create browser window | Main | [Source](../../../../../../{mainSourcePath}) |
+| 3 | Renderer process loads | Renderer | [Source](../../../../../../{sourcePath}) |
+| 4 | Initialize frontend framework | Renderer | [Source](../../../../../../{sourcePath}) |
+| 5 | Check for updates | Main → Renderer | [Source](../../../../../../{sourcePath}) |
+| 6 | Load user data via IPC | Renderer → Main | [Source](../../../../../../{sourcePath}) |
 
 ### 3.2 User Interaction Flows
 
@@ -152,12 +152,12 @@ graph TB
 
 | Step | Business Operation | Process | Source |
 |------|-------------------|---------|--------|
-| 1 | Validate form data | Renderer | [Source](../../{sourcePath}) |
-| 2 | Send IPC message | Renderer | [Source](../../{sourcePath}) |
-| 3 | Handle IPC call | Main | [Source](../../{mainSourcePath}) |
-| 4 | Show native dialog | Main | [Source](../../{mainSourcePath}) |
-| 5 | Write file | Main | [Source](../../{mainSourcePath}) |
-| 6 | Return result | Main → Renderer | [Source](../../{sourcePath}) |
+| 1 | Validate form data | Renderer | [Source](../../../../../../{sourcePath}) |
+| 2 | Send IPC message | Renderer | [Source](../../../../../../{sourcePath}) |
+| 3 | Handle IPC call | Main | [Source](../../../../../../{mainSourcePath}) |
+| 4 | Show native dialog | Main | [Source](../../../../../../{mainSourcePath}) |
+| 5 | Write file | Main | [Source](../../../../../../{mainSourcePath}) |
+| 6 | Return result | Main → Renderer | [Source](../../../../../../{sourcePath}) |
 
 #### 3.2.2 {Event Name: e.g., File Drop}
 
@@ -200,9 +200,9 @@ graph TB
 
 | Direction | Method | Use Case | Source |
 |-----------|--------|----------|--------|
-| Renderer → Main | ipcRenderer.send | Fire-and-forget | [Source](../../{sourcePath}) |
-| Renderer → Main | ipcRenderer.invoke | Request/Response | [Source](../../{sourcePath}) |
-| Main → Renderer | webContents.send | Push notification | [Source](../../{mainSourcePath}) |
+| Renderer → Main | ipcRenderer.send | Fire-and-forget | [Source](../../../../../../{sourcePath}) |
+| Renderer → Main | ipcRenderer.invoke | Request/Response | [Source](../../../../../../{sourcePath}) |
+| Main → Renderer | webContents.send | Push notification | [Source](../../../../../../{mainSourcePath}) |
 
 ---
 
@@ -212,17 +212,17 @@ graph TB
 
 | Field Name | Type | Description | Framework | Source |
 |------------|------|-------------|-----------|--------|
-| {Field 1} | string/number/boolean | {Description} | React/Vue/Angular | [Source](../../{sourcePath}) |
-| {files} | Array | {Dropped files} | React/Vue/Angular | [Source](../../{sourcePath}) |
-| {isProcessing} | boolean | {Processing state} | React/Vue/Angular | [Source](../../{sourcePath}) |
-| {settings} | Object | {App settings} | React/Vue/Angular | [Source](../../{sourcePath}) |
+| {Field 1} | string/number/boolean | {Description} | React/Vue/Angular | [Source](../../../../../../{sourcePath}) |
+| {files} | Array | {Dropped files} | React/Vue/Angular | [Source](../../../../../../{sourcePath}) |
+| {isProcessing} | boolean | {Processing state} | React/Vue/Angular | [Source](../../../../../../{sourcePath}) |
+| {settings} | Object | {App settings} | React/Vue/Angular | [Source](../../../../../../{sourcePath}) |
 
 ### 4.2 Form Fields (if applicable)
 
 | Field Name | Type | Validation | Component | Source |
 |------------|------|------------|-----------|--------|
-| {Field 1} | string | {Required} | Input | [Source](../../{sourcePath}) |
-| {Field 2} | string | {File path} | Input + File picker | [Source](../../{sourcePath}) |
+| {Field 1} | string | {Required} | Input | [Source](../../../../../../{sourcePath}) |
+| {Field 2} | string | {File path} | Input + File picker | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -232,36 +232,36 @@ graph TB
 
 | API | Module | Purpose | Source | Document Path |
 |-----|--------|---------|--------|---------------|
-| {Handler Name} | ipcMain | {IPC handler description} | [Source](../../{mainSourcePath}) | [Main Doc](../../main/{handler-name}.md) |
+| {Handler Name} | ipcMain | {IPC handler description} | [Source](../../../../../../{mainSourcePath}) | [Main Doc](../../../../../../main/{handler-name}.md) |
 
 ### 5.2 Electron APIs
 
 | API | Process | Purpose | Usage | Source |
 |-----|---------|---------|-------|--------|
-| dialog | Main | Native dialogs | Open/Save dialogs | [Source](../../{mainSourcePath}) |
-| shell | Both | Open external | Open file manager/browser | [Source](../../{sourcePath}) |
-| clipboard | Renderer | Clipboard ops | Copy/paste | [Source](../../{sourcePath}) |
-| notification | Renderer | Native notifications | Show notification | [Source](../../{sourcePath}) |
+| dialog | Main | Native dialogs | Open/Save dialogs | [Source](../../../../../../{mainSourcePath}) |
+| shell | Both | Open external | Open file manager/browser | [Source](../../../../../../{sourcePath}) |
+| clipboard | Renderer | Clipboard ops | Copy/paste | [Source](../../../../../../{sourcePath}) |
+| notification | Renderer | Native notifications | Show notification | [Source](../../../../../../{sourcePath}) |
 
 ### 5.3 Node.js Modules
 
 | Module | Purpose | Usage | Source |
 |--------|---------|-------|--------|
-| fs | File system | Read/write files | [Source](../../{mainSourcePath}) |
-| path | Path operations | Handle file paths | [Source](../../{mainSourcePath}) |
-| os | System info | Get platform info | [Source](../../{mainSourcePath}) |
+| fs | File system | Read/write files | [Source](../../../../../../{mainSourcePath}) |
+| path | Path operations | Handle file paths | [Source](../../../../../../{mainSourcePath}) |
+| os | System info | Get platform info | [Source](../../../../../../{mainSourcePath}) |
 
 ### 5.4 Other Windows
 
 | Window Name | Relation Type | Description | Source | Document Path |
 |-------------|---------------|-------------|--------|---------------|
-| {Window Name} | Modal/Child | {Relation description} | [Source](../../{windowSourcePath}) | [Window Doc](../{window-path}.md) |
+| {Window Name} | Modal/Child | {Relation description} | [Source](../../../../../../{windowSourcePath}) | [Window Doc](../{window-path}.md) |
 
 ### 5.5 Referenced By
 
 | Window Name | Function Description | Source Path | Document Path |
 |-------------|---------------------|-------------|---------------|
-| {Referencing Window} | {e.g., "Open from main menu"} | {source-path} | [Window Doc](../{window-path}.md) |
+| {Referencing Window} | {e.g., "Open from main menu"} | {source-path} | [Window Doc](../../../../../../{window-path}.md) |
 
 ---
 
@@ -271,20 +271,20 @@ graph TB
 
 | Operation | Permission | No Permission Handling | Source |
 |-----------|------------|----------------------|--------|
-| File system access | {User consent} | Show permission dialog | [Source](../../{sourcePath}) |
-| External links | {N/A} | Open in system browser | [Source](../../{sourcePath}) |
+| File system access | {User consent} | Show permission dialog | [Source](../../../../../../{sourcePath}) |
+| External links | {N/A} | Open in system browser | [Source](../../../../../../{sourcePath}) |
 
 ### 6.2 Electron-Specific Rules
 
-1. **Security**: {e.g., Enable contextIsolation, use IPC not remote} | [Source](../../{sourcePath})
-2. **Auto-update**: {e.g., Check updates on startup} | [Source](../../{sourcePath})
-3. **Window State**: {e.g., Restore window position/size} | [Source](../../{sourcePath})
+1. **Security**: {e.g., Enable contextIsolation, use IPC not remote} | [Source](../../../../../../{sourcePath})
+2. **Auto-update**: {e.g., Check updates on startup} | [Source](../../../../../../{sourcePath})
+3. **Window State**: {e.g., Restore window position/size} | [Source](../../../../../../{sourcePath})
 
 ### 6.3 Validation Rules
 
 | Scenario | Rule | Error Handling | Source |
 |----------|------|----------------|--------|
-| File type | {Allowed extensions} | Show error dialog | [Source](../../{sourcePath}) |
+| File type | {Allowed extensions} | Show error dialog | [Source](../../../../../../{sourcePath}) |
 
 ---
 
@@ -322,6 +322,6 @@ graph TB
 **Related Module Document:** [Module Overview Document](../{{module-name}}-overview.md)
 
 **Section Source**
-- [{Component}.jsx/.vue](../../{sourcePath})
-- [main.js/main.ts](../../{mainSourcePath})
-- [preload.js](../../{preloadSourcePath})
+- [{Component}.jsx/.vue](../../../../../../{sourcePath})
+- [main.js/main.ts](../../../../../../{mainSourcePath})
+- [preload.js](../../../../../../{preloadSourcePath})