docs: 更新 CHANGELOG 至 v1.4.0 版本说明

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）
 
 ### 🐛 修复