FAQ

常见问题

安装与启动

Q: Windows 报 SmartScreen 警告怎么办？

这是未签名应用的正常提示。点击「更多信息」→「仍要运行」即可。

Q: macOS 提示"无法验证开发者"？

前往 系统偏好设置 → 安全性与隐私 → 点击锁图标 → 仍要打开。

Q: Linux AppImage 无法运行？

chmod +x Zephyr_x.x.x_amd64-full.AppImage
./Zephyr_x.x.x_amd64-full.AppImage

如果仍无法运行，可能缺少依赖：

# Ubuntu/Debian
sudo apt install libwebkit2gtk-4.1-0 libappindicator3-1 librsvg2-2

# Fedora
sudo dnf install webkit2gtk4.1 libappindicator-gtk3 librsvg2

Q: 完整版和精简版有什么区别？

• 完整版 (Full) — 内置 Mihomo 内核 + GeoIP/GeoSite 数据，首次安装推荐
• 精简版 (Lite) — 不含内核文件，体积更小，适合已单独安装内核的用户

使用问题

Q: 订阅更新失败？

1. 检查网络连接
2. 确认订阅 URL 正确
3. 尝试开启「客户端伪装」设置
4. 查看应用日志排查具体错误

Q: 节点延迟测试全部超时？

1. 确认系统代理或 TUN 已开启
2. 检查节点是否可用
3. 尝试切换其他节点

Q: TUN 模式无法启用？

• macOS — 会弹出管理员权限请求，需要输入密码授权
• Windows / Linux — 确保没有其他 VPN/TUN 软件冲突
• Linux — 可能需要 pkexec 权限

Q: Windows UWP 应用无法走代理？

前往 设置 → 系统工具集 → UWP 环回免除，点击按钮并确认。此操作有 5 分钟冷却时间。

Q: 拖拽导入配置文件没反应？

确保拖入的是 .yaml 或 .yml 文件。导入成功后会在订阅页面显示新配置。

配置相关

Q: 修改设置后需要重启吗？

大部分设置修改后即时生效。以下操作需要重启核心：

• 自定义启动参数
• DNS 覆写配置

Q: 高级设置中修改的配置会保存吗？

是的，通过动态配置引擎修改的值会同时：

1. PATCH 到 Mihomo 核心（即时生效）
2. 持久化到 run_config.yaml（重启后保留）

Q: 如何备份配置？

配置文件存储在应用数据目录：

• Windows: %APPDATA%/Zephyr/profiles/
• macOS: ~/Library/Application Support/Zephyr/profiles/
• Linux: ~/.config/Zephyr/profiles/

复制整个 profiles 目录即可备份。

Q: 如何重置所有设置？

前往 设置 → 常规 → 恢复默认设置。

开发相关

Q: 如何启用 DevTools？

开发模式（npm run tauri dev）自动启用 DevTools。生产构建不包含 DevTools。

Q: 如何添加新的翻译？

编辑 src/i18n.js，在 translations.en 和 translations.zh 中添加对应的键值对，并在 HTML 元素上添加 data-i18n="your-key" 属性。

Q: CI/CD 如何触发发布？

推送 v* 格式的 Git tag：

git tag v1.0.0
git push origin v1.0.0

Release 会以 Draft 模式创建，需要手动发布。