Frpilot/docs/CHANGELOG.md

更新日志

本文件记录 FrpcPilot 各版本的更新内容。

---

v1.2.1（2026-10-16）

🔄 项目更名

• 项目正式更名为 FrpcPilot：应用名称、安装包与可执行文件名、窗口标题、系统托盘提示、GitHub 仓库地址等全部由 Frpilot 更新为 FrpcPilot。
• 构建与包标识同步调整：npm 包名改为 frpcpilot，Rust crate 改为 frpcpilot / frpcpilot_lib，Tauri identifier 改为 FrpcPilot。
• 本地标识同步调整：本地存储键前缀改为 frpcpilot:，系统托盘 id 改为 frpcpilot-tray，数据库文件改为 frpcpilot.db。
  • ⚠️ 由于 Tauri identifier 变更，应用数据目录随之变化，升级到本版本后需要重新配置服务器与隧道等本地数据。

📝 文档

• 重写 README，面向 GitHub 重新组织：新增项目徽章、项目简介、「FrpcPilot」名称由来的介绍、界面预览、下载安装、功能特性、开发指南与参与贡献等章节。
• 更新界面截图，并新增「设置 · 常规」页面预览。

🧱 工程

• 应用版本升级至 v1.2.1。

v1.2.0（2026-10-16）

✨ 新增功能

• 常规设置页面：设置页新增「常规」子页面（位于设置菜单首位），集中管理基础行为：
  • 关闭行为：新增「每次询问 / 保持以上选择」单选组（默认「每次询问」）。
    • 每次询问：每次关闭都弹出对话框，由用户现场选择处理方式；
    • 保持以上选择：记住所选关闭方式并持久生效，之后关闭不再弹窗。
  • 语言切换：可直接在设置页切换界面语言，与顶部栏的语言切换保持同步。
  • 关闭确认对话框同步新增「关闭行为」选项，与常规设置页内容一致，用户可随时再次修改。
• 磨砂玻璃透明度：外观设置新增「磨砂玻璃透明度」，可分别调节卡片透明度与弹窗透明度（0 – 100，数值越大越透明），并提供实时预览，设置持久化保存。
• 更多窗口背景：背景图片由 2 张扩充至 9 张（新增「背景三」～「背景九」），可在外观设置中自由挑选。
• Frpc 下载页缓存：下载页新增运行时缓存，应用运行期间首次进入才拉取 GitHub 版本列表，之后切换回该页面不再重复请求，避免触发接口限流；需要获取最新列表时手动点击「刷新」即可。

🎨 优化

• 新增卡片式单选组组件（CardRadioGroup），关闭弹窗与常规设置页复用，统一选项样式与交互。
• 关闭弹窗内的选项改为临时草稿状态，点击「确定」后才写回设置，避免误触单选框又取消时被改掉配置。

🐛 修复

• 修复开发模式下热更新 / 页面重载时系统托盘图标重复叠加的问题：创建托盘前按固定 id 清理残留图标，并在热更新时释放旧实例的监听。
• 修复暗色主题下普通（非组件库）文本仍显示为浏览器默认黑色的问题，文本颜色现随明暗主题正确切换。

🧱 工程

• 应用版本升级至 v1.2.0。
• 路由表新增 isCache 元信息，并补充 RouteMeta 类型声明（页面标题 title 与缓存开关 isCache），按需使用 keep-alive 缓存页面组件（仅运行时生效，不做持久化）。
• 更新开发文档相关说明。

v1.1.0（2026-10-14）

✨ 新增功能

• 系统托盘：新增常驻系统托盘图标与菜单（显示窗口 / 启动穿透 / 停止穿透 / 退出）。
  • 左键单击托盘图标直接显示并聚焦主窗口，右键单击弹出菜单；
  • 「启动穿透」「停止穿透」与仪表盘的一键启动 / 停止共用同一套逻辑，并随运行状态联动：未运行时禁用「停止穿透」；启动成功后自动禁用「启动穿透」、启用「停止穿透」，停止后恢复；
  • 「退出」会在停止正在运行的穿透后再退出整个软件；
  • 托盘菜单文案随语言切换同步更新。
• 关闭确认对话框：点击标题栏关闭按钮（Windows 关闭按钮 / macOS 红绿灯）不再直接退出，改为先弹出对话框，提供两个选项：
  • 最小化到系统托盘：隐藏窗口、保持程序后台运行，可从托盘随时恢复；
  • 直接退出：停止穿透并完全退出软件；
  • Windows 与 macOS 行为一致，同时拦截 Alt+F4 等系统原生关闭，一并走确认流程。

🎨 优化

• 更新提示：顶部栏「检查更新」按钮新增「有新版本」圆点徽标；关闭更新弹窗后保留已检测到的版本，再次点击即可重新打开，避免重复联网检查。
• 标题栏：以应用图标替换原先的文字 / 渐变方块 Logo。
• macOS 窗口：适配无边框窗口的圆角与透明背景，消除首帧方角闪烁；窗口失焦时红绿灯自动置灰。

🧱 工程

• 应用版本升级至 v1.1.0；tauri 启用 tray-icon 特性，capabilities 新增 core:app:allow-default-window-icon 权限。
• 更新端点增加 GitHub 直连作为镜像备用；修正应用名称与标识符大小写（统一为 Frpilot）。
• 重写 README，并补充仪表盘 / 服务器 / 隧道 / 下载 / 设置等页面的界面截图。

v1.0.0（2026-10-14）

🎉 首个正式版本发布！

Frpilot 迎来 1.0.0 正式版 —— 从「手写 frpc.toml」到「点几下就能跑起来」，frp 的日常管理终于有了顺手的图形界面。

✨ 新增功能

• 仪表盘：一屏总览系统信息（主机名 / 系统 / 架构 / IP）与服务器、隧道数量；选择 frpc 版本后「一键启动 / 停止」，并实时回显运行日志与进程退出信息。
• 服务器管理：frps 服务器的新增 / 编辑 / 删除，支持地址、端口、鉴权 Token、传输协议、TLS、置顶与排序；同一时间仅允许启用一台服务器。
• 隧道管理：覆盖 TCP / UDP / HTTP / HTTPS / STCP / XTCP / SUDP / TCPMUX 等代理类型，支持自定义域名、子域名、URL 前缀、密钥、加密与压缩、带宽限制、Proxy Protocol、健康检查、负载均衡等高级配置，并统一管理启用 / 置顶 / 排序。
• Frpc 下载管理：在线拉取 Frp 官方版本列表，按平台与架构筛选；支持下载（含进度与解压状态）、导入本地已下载的 frpc / frps、删除与复制下载直链。
• 一键启动与实时日志：依据所选版本、已启用的服务器与隧道自动生成 frpc.toml 并拉起独立进程，通过 frpc-log / frpc-exit 事件实时推送日志。
• 应用内自动更新：接入 Tauri updater 与 process 插件，启动时静默检查更新；支持手动检查、「忽略该版本」与下载进度展示，更新说明以 Markdown 渲染，安装完成后自动重启。
• 关于页面：集中展示项目介绍、技术栈、使用流程、开源地址与版本信息，并提供「检查更新」入口。
• 国际化：内置简体中文 / English，语言选择持久化，并与 Ant Design Vue 组件语言包联动。
• 明暗主题：基于 useDark 一键切换，Tailwind 暗色变体与 Ant Design Vue 暗色算法同步，选择持久化。
• 自定义标题栏：Windows 与 macOS 双套方案（macOS 还原原生红绿灯），支持拖拽移动窗口；顶部栏集成语言 / 主题 / 检查更新 / GitHub / 设置与窗口控制按钮。

🎨 优化

• 透明磨砂玻璃视觉：侧边栏、内容区与卡片统一为圆角 + 背景模糊的半透明面板，明暗主题下均有细腻的层次与投影表现。
• 统一弹窗布局：表单弹窗与更新弹窗统一为「标题 / 底部按钮固定、内容区滚动」的结构，内容过多时仅弹窗主体滚动，并限制最大高度。
• macOS 标题栏细节：隐藏右侧冗余的最小化 / 关闭按钮，禁用 macOS 下并不需要的最大化（绿灯）按钮。
• 下载卡片交互：状态标签、大小 / 下载次数 / 发布日期等元信息与操作按钮重新排布，下载与解压进度直观可见。

🚀 工程

• 后端采用 Rust + Tauri 2，使用 sqlx（SQLite）持久化服务器、隧道与 Frpc 下载记录，并通过 tauri-helper 统一注册命令。
• 前端技术栈：Vue 3 + TypeScript + Vite 8 + Pinia + Vue Router + Vue I18n 11，UI 使用 Ant Design Vue 4 + Tailwind CSS 4，借助 unplugin-auto-import / unplugin-vue-components 实现按需自动导入。
• 开启 createUpdaterArtifacts 并结合签名密钥生成更新产物与 latest.json，打通应用内自动更新链路。
• 新增 GitHub Actions 发布工作流，覆盖 Windows x64 / macOS Apple Silicon / Linux x64 多平台构建，并自动从本文件提取对应版本说明作为 Release 正文。
• 补充多平台应用图标，项目以 Apache License 2.0 开源。