From dad406b4cd998864d289223c38c83108fd2a4b62 Mon Sep 17 00:00:00 2001 From: Yuhang Wu Date: Mon, 26 Oct 2026 14:23:12 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20CHANGELOG=20?= =?UTF-8?q?=E8=87=B3=20v1.4.0=20=E7=89=88=E6=9C=AC=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/CHANGELOG.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 1875e31..d3a8088 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -4,6 +4,42 @@ --- +## v1.4.0（2026-10-26） + +### ⚠️ 升级提示 + +- **数据保存位置变更**：本版本不自动迁移旧版数据。升级后需重新配置服务器与隧道，并重新下载或导入 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 会复制到安装目录内统一管理，原文件保持不变，后续使用不再依赖原始文件的位置。 +- **启动加载反馈**：新增应用启动加载动画与提示，等待页面就绪并完成首帧渲染后再显示主界面，减少启动白屏与闪烁；加载动画与侧边栏过渡适配减少动态效果的系统偏好。 +- **更新提示时机**：启动时的静默更新检查延后至新手引导结束或关闭后执行，避免引导与更新弹窗同时出现。 + +### 📝 文档 + +- 新增[《数据目录说明》](./数据目录说明.md)，说明目录分类、各平台保存位置、写入权限、备份及安装位置变更注意事项；README 补充文档入口。 + +### 🧱 工程 + +- Tauri 最低依赖版本调整为 `2.12.3`，支持应用数据目录覆盖；新增存储目录初始化与独占锁测试。 +- 应用版本升级至 **v1.4.0**。 + ## v1.3.2（2026-10-22） ### 🐛 修复