Agent Skills
› lobehub/lobehub
› desktop
desktop
GitHub提供 Electron 桌面应用开发指南，涵盖主渲染进程架构、IPC 通信、控制器创建及窗口菜单管理等核心内容。
Trigger Scenarios
Electron 桌面应用开发
主渲染进程架构设计
IPC 通信机制实现
Install
npx skills add lobehub/lobehub --skill desktop -g -y
SKILL.md
Frontmatter
{
"name": "desktop",
"description": "Electron desktop development guide — IPC handlers, controllers, preload scripts, window\/menu management.",
"disable-model-invocation": true
}
Desktop Development Guide
Architecture Overview
LobeHub desktop is built on Electron with main-renderer architecture:
- Main Process (
apps/desktop/src/main): App lifecycle, system APIs, window management - Renderer Process: Reuses web code from
src/ - Preload Scripts (
apps/desktop/src/preload): Securely expose main process to renderer
Adding New Desktop Features
1. Create Controller
Location: apps/desktop/src/main/controllers/
import { ControllerModule, IpcMethod } from '@/controllers';
export default class NewFeatureCtr extends ControllerModule {
static override readonly groupName = 'newFeature';
@IpcMethod()
async doSomething(params: SomeParams): Promise<SomeResult> {
// Implementation
return { success: true };
}
}
Register in apps/desktop/src/main/controllers/registry.ts.
2. Define IPC Types
Location: packages/electron-client-ipc/src/types/<domain>.ts, re-exported from types/index.ts
export interface SomeParams {
/* ... */
}
export interface SomeResult {
success: boolean;
error?: string;
}
3. Create Renderer Service
Location: src/services/electron/
import { ensureElectronIpc } from '@/utils/electron/ipc';
const ipc = ensureElectronIpc();
export const newFeatureService = async (params: SomeParams) => {
return ipc.newFeature.doSomething(params);
};
4. Implement Store Action
Location: src/store/
5. Add Tests
Location: beside the controller, apps/desktop/src/main/controllers/<Name>Ctr.test.ts (source-layout §2)
Detailed Guides
See references/ for specific topics:
- Feature implementation:
references/feature-implementation.md - Local tools workflow:
references/local-tools.md - Menu configuration:
references/menu-config.md - Window management:
references/window-management.md
Version History
- aace12f Current 2026-10-20 06:05
-
69012b8
2026-09-28 20:13
修复 IPC 类型定义文件路径引用，从 types.ts 更新为 types/<domain>.ts 结构。
- 29fe043 2026-08-20 18:33
