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