# 更新日志

本文件记录 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** 开源。