Cursor rule

1---
2description: Qclaw 專案概述：技術棧、目錄結構與開發指令
3alwaysApply: true
4---
5 
6# Qclaw 專案規範
7 
8## 技術棧
9 
10- 桌面框架：Electron
11- 前端：React + TypeScript + Vite
12- UI：Mantine 8 + Tailwind CSS 3
13- 打包：electron-builder
14- 測試：Vitest
15- 授權：Apache-2.0
16 
17## 目錄結構
18 
19```
20electron/
21  main/         主程序（窗口管理、CLI 調用、IPC 處理）
22  preload/      預加載腳本（安全橋接）
23src/
24  pages/        頁面元件（嚮導步驟、Dashboard、聊天等）
25  components/   UI 元件
26  lib/          業務邏輯
27  shared/       共享模組
28  types/        TypeScript 型別定義（含 IPC API 介面）
29```
30 
31## 開發指令
32 
33| 指令 | 用途 |
34|------|------|
35| `npm run dev` | 啟動開發伺服器 |
36| `npm run typecheck` | TypeScript 型別檢查 |
37| `npm test` | 執行測試套件（Vitest） |
38| `npm run build:app` | 前端 + 主程式編譯 |
39 
40> `npm run build` 因 `forceCodeSigning: true` 在無憑證環境會失敗，屬預期行為。
41 
42## 提交前必跑
43 
44```powershell
45npm run typecheck
46npm test
47npm run build:app
48```
49