常见问题

我的令牌安全吗？

令牌（PAT）只保存在本机：macOS/Linux 在 ~/.config/gitee-monitor/credentials.yml， Windows 在 %AppData%\gitee-monitor\，文件权限 0600，仅用于本机直连 Gitee 接口， 不经过任何第三方服务器。授权时也只需勾选 user_info 与 projects 两个权限。

托盘图标颜色分别是什么意思？

绿=最新构建成功、红=失败、黄=运行中、灰=无构建记录、橙=错误（如接口异常）。

为什么新创建的流水线 / 分支没有出现在面板里？

监控列表（正则命中仓库、各仓库的流水线文件 × 分支）缓存在 matched_repos.yml， 仅在应用启动与保存配置时重新探测。新增/删除流水线文件或分支、新建符合 pattern 的仓库后，重启应用或改一次配置即可。「立即刷新」只刷新现有监控项的构建状态。

支持私有仓库、企业空间吗？

支持 PAT 权限范围内可见的所有仓库；owner 自动探测组织、个人空间、企业空间三种类型 （企业仓库按 URL 路径名匹配，中文显示名不参与匹配）。

Gitee 官方没有流水线 API，数据从哪来？

Gitee 公有云 v5 开放 API 目前没有任何流水线端点（官方 issue IHWZMT）。本应用复用官方 gitee-cli 在用的 go-api.gitee.com 网关。 该接口无稳定性承诺，若官方变更可在设置「高级」里改网关地址，或等官方 API 开放后迁移。

Linux 下托盘图标不显示？

GNOME 默认未启用 AppIndicator 扩展，需先安装启用（如 Ubuntu 的 AppIndicator 支持、 GNOME 的 AppIndicator Extension）。托盘功能依赖桌面环境，纯服务器环境建议用 --check 自检。

面板窗口出现在了任务栏 / 重复启动没反应？

• Windows/Linux 的 frameless 面板窗口可能仍出现在任务栏（Wails 暂未暴露 skip-taskbar）；
• 应用为单实例运行（通过本机回环端口 42771 检测），重复启动会自动退出。

依赖框架有风险吗？

基于 Wails v3 构建，当前为 beta（API 已稳定），已锁定 v3.0.0-beta.16。