SuperAPI AI 工具集

electron-best-practices

编程与开发

查看项目

更新于 10-16 02:31

技能介绍

用途:指导 AI 智能体用 React 开发安全、可上线的 Electron 应用,适用于编写主进程/preload/渲染进程代码、配置 electron-vite 或 Electron Forge、搭建 IPC、实现 contextBridge/sandbox/CSP 安全、签名公证,以及用 Playwright 测试。不适用于 Tauri、纯 Web 应用、Electron 20 以下版本或非 React 渲染框架。

主要能力:以安全为先,默认启用 contextIsolation、sandbox,关闭 nodeIntegration,主渲染通信全走 contextBridge;推荐 invoke/handle 做请求响应,用映射类型或 electron-trpc 实现类型安全 IPC,跨边界用 {success,data,error} 结果类型保留错误上下文;提供 React 集成(useEffect 清理 IPC 监听、Strict Mode)、多窗口以主进程为状态源、electron-store 持久化、electron-updater 更新、CI 集成签名等模式。

使用方式:按 references/ 取模式,assets/templates/ 与 assets/configs/ 提供模板与配置示例。脚本需 Deno:deno run --allow-read scripts/analyze-security.ts <path> [--strict --json];deno run --allow-read --allow-write scripts/scaffold-electron-app.ts --name <name> [--with-react --with-trpc --with-tests];deno run --allow-read --allow-write scripts/generate-ipc-types.ts --handlers <path> --output <path> [--validate]。

限制:模式与文档在本包内可离线使用;GitHub Actions 矩阵构建与 deno 脚本需外部环境,缺失时按可观察出口处理并说明未跑步骤。未提供收费、价格与平台信息。