Skip to content

桌面端介绍 ​

HoHu 桌面端是独立的 Electron + Vue 3 客户端仓库,通过后端 API 使用业务能力。它适合需要系统托盘、全局快捷键、桌面通知和安装包分发的应用。

技术与职责 ​

部分当前实现
界面Vue 3、TypeScript、Naive UI、Pinia、Vue Router
主进程Electron,管理窗口、认证会话、网络请求与系统能力
桥接contextBridge 暴露类型化 window.api,通过受限 IPC 调用主进程
开发与构建electron-vite
打包与更新electron-builder、electron-updater

具体依赖版本以桌面仓库 package.json 与锁文件为准。当前构建脚本使用 electron-vite 和 electron-builder。

已有能力 ​

  • 登录会话由主进程管理,渲染层通过业务请求封装访问固定后端。
  • 窗口状态保存、托盘行为、全局快捷键、系统通知和原生主题同步。
  • 设置抽屉提供托盘、快捷键、通知、更新和应用信息等配置。
  • 安装包与更新流程的基础接入;发行前仍需配置更新源、签名及目标平台验证。

桌面端与 Web 是不同代码仓库。复用后端接口和业务类型时,页面、路由、权限与翻译仍需在桌面端接入,Web 新页面不会自动同步进桌面安装包。

从哪里开始 ​

  1. 按桌面端开发启动客户端并连接本地后端。
  2. 阅读桌面端架构,了解 renderer、preload 与 main 的边界。
  3. 按桌面端功能接入所需系统能力,验证实际安装包行为。

需要先准备后端时,阅读开发环境。源码入口见源码与许可。