安装

系统要求

平台	架构	安装包
macOS	Apple Silicon / Intel（通用）	gitee-monitor-darwin-universal.dmg
Windows	x64 / ARM64	gitee-monitor-windows-*-installer.exe
Linux	amd64 / arm64	.deb / .rpm

Linux 运行时依赖 GTK4 与 WebKitGTK 6.0；GNOME 桌面需启用 AppIndicator 扩展才能显示托盘。

所有安装包均从 GitHub Releases 分发， 首页下载区 的直链始终指向最新版本的同名附件。

macOS

1. 下载 gitee-monitor-darwin-universal.dmg 并打开；
2. 将 Gitee 任务监控器 拖入 Applications；
3. 首次启动：当前构建未做开发者签名与公证，Gatekeeper 会拦截—— 在 Finder 中右键点击 App → 打开 → 打开，或到 系统设置 → 隐私与安全性 里点「仍要打开」。

Windows

1. 下载对应架构的 gitee-monitor-windows-amd64-installer.exe（64 位）或 gitee-monitor-windows-arm64-installer.exe（ARM64）；
2. 双击运行 NSIS 安装程序，按向导完成安装；
3. 首次运行：安装包未做代码签名，SmartScreen 可能提示——点 更多信息 → 仍要运行。

Linux

Debian / Ubuntu（deb）：

sudo dpkg -i gitee-monitor-linux-amd64.deb
# 缺依赖时补一下：
sudo apt -f install

RHEL / Fedora / openSUSE（rpm）：

sudo rpm -i gitee-monitor-linux-amd64.rpm
# 或
sudo dnf install ./gitee-monitor-linux-amd64.rpm

从源码构建

统一入口为仓库根目录的 Makefile（make help 查看全部目标），仅支持 macOS / Linux host。

通用工具链：Go 1.25+、Node 20+，以及：

go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.16
go install github.com/go-task/task/v3/cmd/task@latest

先跑 make check 自检工具链，再按目标安装可选工具：

• Windows 安装包：brew install nsis（macOS/Linux 均可交叉出包）；
• macOS dmg：brew install create-dmg（仅 macOS host）；
• Linux 包：macOS host 上经 Docker 交叉编译（需 Docker Desktop，首次构建交叉镜像约 10–20 分钟）； Linux host 可原生编译（需 libgtk-4-dev / libwebkitgtk-6.0-dev）。

常用目标：

make windows-x64 windows-arm64    # Windows x64 / arm64 NSIS 安装程序（任意 host）
make macos-universal              # macOS 通用 .app + .dmg（仅 macOS host）
make linux-x64-deb linux-x64-rpm  # Linux x64 包（macOS 需 Docker）
make linux-arm64-deb linux-arm64-rpm
make all                          # 全量：按 host 自动选范围

make all 的范围因 host 而异

• macOS host：Windows×2 + macOS universal（不含 Linux 包，需按上面单项目标另行构建）；
• Linux host：Windows×2 + Linux deb/rpm×4（macOS dmg 无法在 Linux 上产出）。

完整发布（三平台全产物）需要在 macOS host 上跑 make all + 四个 Linux 目标。 产物统一收集在 dist/。

Windows host 上的原生打包未包含在本 Makefile（可在 desktop/ 下直接 task build / task package）。