Cursor rule

1---
2description: Electron IPC 跨層開發順序與注意事項
3globs: electron/**/*.ts
4alwaysApply: false
5---
6 
7# Electron IPC 開發規範
8 
9## 跨層改動順序
10 
11新增或修改 IPC 功能時，**必須依照以下順序**：
12 
131. **型別定義** — `src/types/electron.d.ts`
142. **Preload 橋接** — `electron/preload/`
153. **IPC Handler** — `electron/main/ipc-handlers.ts`
164. **主程式邏輯** — `electron/main/`（新增服務檔案）
175. **UI 元件** — `src/pages/` 或 `src/components/`
18 
19## 架構分層說明
20 
21| 層 | 路徑 | 說明 |
22|----|------|------|
23| UI | `src/pages/` | React 頁面、按鈕、互動 |
24| 型別定義 | `src/types/electron.d.ts` | IPC API 型別 |
25| Preload | `electron/preload/` | 安全橋接層（Context Bridge） |
26| IPC | `electron/main/ipc-handlers.ts` | IPC 事件處理 |
27| 業務邏輯 | `electron/main/` | 主程式服務 |
28 
29## 注意事項
30 
31- Preload 只能使用 `contextBridge.exposeInMainWorld` 暴露 API
32- 主程序使用 `process.getBuiltinModule('node:...')` 取得 Node 內建模組
33- 跨平台路徑比較前須正規化分隔符：`.replace(/\\/g, '/')`
34