<< All versions
Skill v1.0.0
currentLLM-judged scan90/100opensourceagi/qwksearch-research-agent/desktop
──Details
PublishedOctober 21, 2026 at 10:27 AM
Content Hashsha256:c4f757027d23b25c...
Git SHAae4c7974c12c
──Files
Files (1 file, 2.2 KB)
SKILL.md2.2 KBactive
SKILL.md · 91 lines · 2.2 KB
version: "1.0.0" 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/
typescript
import { ControllerModule, IpcMethod } from '@/controllers';export default class NewFeatureCtr extends ControllerModule {static override readonly groupName = 'newFeature';@IpcMethod()async doSomething(params: SomeParams): Promise<SomeResult> {// Implementationreturn { success: true };}}
Register in apps/desktop/src/main/controllers/registry.ts.
2. Define IPC Types
Location: packages/electron-client-ipc/src/types.ts
typescript
export interface SomeParams {/* ... */}export interface SomeResult {success: boolean;error?: string;}
3. Create Renderer Service
Location: src/services/electron/
typescript
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: apps/desktop/src/main/controllers/__tests__/
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
Best Practices
- Security: Validate inputs, limit exposed APIs
- Performance: Use async methods, batch data transfers
- UX: Add progress indicators, provide error feedback
- Code organization: Follow existing patterns, add documentation