Skip to content

FrpcPilot v1.4.0

Choose a tag to compare

@github-actions github-actions released this 26 Oct 06:37

⚠️ 升级提示

  • 数据保存位置变更:本版本不自动迁移旧版数据。升级后需重新配置服务器与隧道,并重新下载或导入 frpc;原系统默认数据目录中的文件保留不动,原有界面设置也不会自动继承。
  • 安装位置要求:请将软件安装在当前用户可写的专用目录。目录不可写时会提示错误并停止启动,不回退到系统默认数据目录。移动安装位置后,如已保存的 frp 路径失效,需重新下载或导入。

✨ 新增功能

  • 新手引导:首次启动时,通过四步引导依次介绍新增服务器、新增隧道、下载 Frp 和一键启动穿透;支持跳过,关闭后不再自动弹出,可在「设置 - 常规 - 新手引导」中重新查看。同步支持简体中文与英文。
  • 侧边栏折叠:支持在完整菜单与图标模式之间切换,并记住折叠状态,为主内容区留出更多空间;折叠后仍可导航、进入设置,并通过悬浮提示查看运行状态与 CPU、内存信息。
  • 按安装目录隔离数据:不同安装目录分别保存各自的数据库与设置,可独立运行;同一数据目录通过文件锁防止多个进程同时使用。开发构建使用独立的 FrpcPilot-dev 目录,避免与正式版配置混用。

📁 数据存储

  • 分类保存运行数据:数据库与界面设置保存在 data,下载、解压和导入的 frp 保存在 frp/versions,启动穿透时生成的 frpc.toml 保存在 run;浏览器数据、缓存和临时文件分别使用 webview、cache、tmp 等目录。
  • 适配不同平台的安装位置:Windows 使用可执行文件所在目录,Linux AppImage 使用实际 AppImage 文件所在目录,普通 Linux 二进制使用可执行文件所在目录;macOS 使用 .app 同级的 FrpcPilot-data,避免影响应用签名与更新。macOS 系统管理的 WebView 缓存仍可能保存在用户 Library 中。
  • 设置随安装目录保存:语言、外观、关闭行为、侧边栏状态、新手引导状态及忽略的更新版本等统一保存在 data/preferences.json,启动时读取,并在退出、更新或重启前完成待保存的设置写入。

🎨 优化

  • Frp 平台筛选:下载页更名为「Frp下载」,用平台与架构下拉框替代原有的 Frpc / Frps 架构开关;首次加载默认选择当前平台,也可查看全部平台,刷新时尽量保留当前选择。
  • 版本列表排序与展示:按版本号数值降序排列,避免字符串排序造成新旧版本顺序错误;查看全部平台时按版本分组,下载卡片统一标明包含 frpc 与 frps。
  • 本地导入更独立:导入的 frpc / frps 会复制到安装目录内统一管理,原文件保持不变,后续使用不再依赖原始文件的位置。
  • 启动加载反馈:新增应用启动加载动画与提示,等待页面就绪并完成首帧渲染后再显示主界面,减少启动白屏与闪烁;加载动画与侧边栏过渡适配减少动态效果的系统偏好。
  • 更新提示时机:启动时的静默更新检查延后至新手引导结束或关闭后执行,避免引导与更新弹窗同时出现。

📝 文档

  • 新增《数据目录说明》,说明目录分类、各平台保存位置、写入权限、备份及安装位置变更注意事项;README 补充文档入口。

🧱 工程

  • Tauri 最低依赖版本调整为 2.12.3,支持应用数据目录覆盖;新增存储目录初始化与独占锁测试。
  • 应用版本升级至 v1.4.0。