桌面客户端开发_desktop

以下为本文档的中文说明desktop 技能是 LobeHub 开源 AI 助手平台的桌面客户端应用开发工具包。LobeHub 是一个功能丰富的开源 AI 助手平台支持多模型接入、插件扩展和个性化配置。该技能专注于平台桌面版本基于 Electron 框架的功能开发和维护。使用场景包括开发或修改 LobeHub 桌面应用的用户界面组件和布局、实现桌面平台特有的功能如系统托盘最小化、全局快捷键绑定、原生菜单栏等、优化桌面应用的启动性能、内存占用和电池续航等方面的表现。核心特点包括提供 LobeHub 桌面应用项目的完整目录结构和代码组织规范帮助新开发者快速理解项目架构详细说明 Electron 主进程Main Process和渲染进程Renderer Process之间的进程间通信IPC机制支持系统托盘Tray图标的创建、上下文菜单配置和通知消息显示实现全局快捷键Global Shortcut的注册、冲突检测和事件处理包含自动更新Auto Update机制的配置方法支持 Windows、macOS 和 Linux 三平台提供各操作系统原生集成的最佳实践指南如 macOS 的菜单栏和 Dock 图标行为、Windows 的任务栏缩略图工具栏和跳转列表。该技能帮助开发者高效地维护和增强 LobeHub 的桌面端用户体验。Desktop Development GuideArchitecture OverviewLobeHub desktop is built on Electron with main-renderer architecture:Main Process(apps/desktop/src/main): App lifecycle, system APIs, window managementRenderer Process: Reuses web code fromsrc/Preload Scripts(apps/desktop/src/preload): Securely expose main process to rendererAdding New Desktop Features1. Create ControllerLocation:apps/desktop/src/main/controllers/import{ControllerModule,IpcMethod}from/controllers;exportdefaultclassNewFeatureCtrextendsControllerModule{staticoverridereadonlygroupNamenewFeature;IpcMethod()asyncdoSomething(params:SomeParams):PromiseSomeResult{// Implementationreturn{success:true};}}Register inapps/desktop/src/main/controllers/registry.ts.2. Define IPC TypesLocation:packages/electron-client-ipc/src/types.tsexportinterfaceSomeParams{/* ... */}exportinterfaceSomeResult{success:boolean;error?:string;}3. Create Renderer ServiceLocation:src/services/electron/import{ensureElectronIpc}from/utils/electron/ipc;constipcensureElectronIpc();exportconstnewFeatureServiceasync(params:SomeParams){returnipc.newFeature.doSomething(params);};4. Implement Store ActionLocation:src/store/5. Add TestsLocation:apps/desktop/src/main/controllers/__tests__/Detailed GuidesSeereferences/for specific topics:Feature implementation:references/feature-implementation.mdLocal tools workflow:references/local-tools.mdMenu configuration:references/menu-config.mdWindow management:references/window-management.mdBest PracticesSecurity: Validate inputs, limit exposed APIsPerformance: Use async methods, batch data transfersUX: Add progress indicators, provide error feedbackCode organization: Follow existing patterns, add documentation