SuperAPI AI 工具集

architecture

通用与其它

查看项目

更新于 10-15 22:38

技能介绍

用途:为 Electron 多进程项目确定正确的文件放置位置与目录结构,适用于新建文件或模块、决定代码归属、以及维护项目架构一致性。

主要能力:提供决策树,按代码类型指向对应目录,例如 UI(React 组件、hooks、页面)放入 packages/desktop/src/renderer/;响应渲染进程调用的 IPC 处理器放入 packages/desktop/src/process/bridge/;主进程业务逻辑放入 packages/desktop/src/process/services/;AI 平台连接放入 packages/desktop/src/process/agent/;后台任务放入 packages/desktop/src/process/worker/;主进程与渲染进程共用代码放入 packages/desktop/src/common/;HTTP/WebSocket 端点放入 packages/desktop/src/process/webserver/;插件解析或加载放入 packages/desktop/src/process/extensions/;消息渠道(Lark、DingTalk、Telegram)放入 packages/desktop/src/process/channels/。

进程边界规则:主进程可用 Node.js、Electron 主进程 API、fs、path、child_process,不可用 DOM API;渲染进程可用 DOM、React、浏览器 API,不可用 Node.js API 与 Electron 主进程 API;Worker 可用 Node.js API,不可用 DOM 与 Electron API;预加载可用 contextBridge、ipcRenderer,不可做 DOM 操作或使用 Node.js fs。跨进程通信:主进程与渲染进程通过预加载与 bridge 走 IPC;主进程与 Worker 通过 WorkerProtocol.ts 的 fork 协议。

命名与结构:渲染进程组件或模块目录用 PascalCase,其余目录用小写;分类目录(components、hooks、utils、services)与平台目录(acp、codex、gemini)统一小写。React 组件与类用 PascalCase,hooks 用 camelCase 且带 use 前缀,工具函数用 camelCase,入口用 index.ts/index.tsx,样式用 kebab-case 或 Name.module.css。目录直接子项不超过 10 个,禁止单文件目录,页面私有代码先放 pages/<PageName>/,测试镜像源码放在 tests/ 子目录。

限制:资料未提供安装命令、版本要求或具体配置示例;违反进程边界规则会导致运行时崩溃。