- 新增 desktop 应用入口,将后端与前端打包为单一可执行文件 - 集成系统托盘功能(getlantern/systray) - 支持单实例锁和端口冲突检测 - 启动时自动打开浏览器显示管理界面 - 新增 embedfs 模块嵌入静态资源 - 新增跨平台构建脚本(macOS/Windows/Linux) - 新增 macOS .app 打包脚本 - 统一 Makefile,移除 backend/Makefile - 更新 README 添加桌面应用使用说明
Assets
应用资源文件目录。
文件说明
| 文件 | 用途 | 尺寸 | 格式 |
|---|---|---|---|
icon.svg |
源图标 | 64x64 | SVG |
icon.png |
托盘图标 | 64x64 | PNG |
AppIcon.icns |
macOS 应用图标 | 多尺寸 | ICNS |
icon.ico |
Windows 应用图标 | 256x256 | ICO |
替换图标
1. 准备图标
推荐使用 SVG 格式的源图标,尺寸至少 256x256。
2. 生成各平台图标
托盘图标 (PNG):
magick your-icon.svg -resize 64x64 icon.png
macOS 应用图标 (ICNS):
mkdir icon.iconset
magick your-icon.svg -resize 16x16 icon.iconset/icon_16x16.png
magick your-icon.svg -resize 32x32 icon.iconset/icon_16x16@2x.png
magick your-icon.svg -resize 32x32 icon.iconset/icon_32x32.png
magick your-icon.svg -resize 64x64 icon.iconset/icon_32x32@2x.png
magick your-icon.svg -resize 128x128 icon.iconset/icon_128x128.png
magick your-icon.svg -resize 256x256 icon.iconset/icon_128x128@2x.png
iconutil -c icns icon.iconset -o AppIcon.icns
rm -rf icon.iconset
Windows 应用图标 (ICO):
magick your-icon.svg -resize 256x256 icon.ico
3. 替换文件
将生成的文件放入此目录,然后重新构建桌面应用:
./scripts/build/build-darwin-arm64.sh
macOS Template 图标
macOS 支持 Template 图标,自动适配深浅色模式:
- 使用黑色 + 透明设计
- 文件名以
Template结尾(如iconTemplate.png) - 黑色在深色模式下自动变为白色
设计建议
- 托盘图标应简洁,在小尺寸下清晰可辨
- 避免过多细节和文字
- 使用高对比度颜色
- macOS 建议使用 Template 图标风格