Changelog

## 🎉 新增
- 默认开启「启动时恢复代理状态」，重启后自动重连，无需手动操作
- 未配置订阅或节点时不会触发恢复，避免多余报错

## ✨ 功能更新
- 内置 sing-box 内核，安装后开箱即用，无需手动下载内核
- 流量图表改为折线图，更直观
- 设置页面的更新说明支持 Markdown 格式渲染
- 首次启动自动跟随系统语言（中文 / 英文）
- 支持为 GitHub 更新检查配置鉴权 Token，解决 API 限速问题

## 🐛 问题修复
- 修复升级恢复 TUN 后应用偶发闪退
- 修复自动恢复 TUN 后「显示已连接但无流量」
- 修复升级、重启、开机自启后代理状态不自动恢复
- 修复 TUN 模式下升级后不弹出安装器
- 修复升级后重新开启 TUN 出现网络断流（黑洞）
- 修复版本更新误报「有新版本」
- macOS：修复内核启动崩溃；TUN 模式只需首次授权，之后免密

## 本次更新

### 🐛 修复
- **修复「记住代理状态」失效**:此前即使开启了「记住代理状态」,在 **应用升级、重启
  电脑、开机自启** 之后,系统代理 / TUN 都不会自动恢复,需要手动重新打开。现已修复——
  会按上次的开启状态自动恢复。
- **修复升级后偶发闪退**:在自动恢复 TUN 的过程中应用可能闪退。现已修复,升级重启
  不再闪退。
- **提升开机自启 + TUN 的恢复成功率**:开机时网络尚未就绪导致的失败会自动重试。

### 已知情况
- 个别情况下,**应用内升级**后 TUN 虽自动恢复并显示「已连接」,但可能暂时没有流量。
  此时在仪表盘把 **TUN 关一下再打开** 即可恢复正常(正常重启 / 开机自启不受影响)。
  后续版本会做成一键自动修复。

### 升级建议
建议所有使用「记住代理状态」的用户更新。

## 本次更新

### 🐛 修复
- **修复「记住代理状态」失效**:此前即使开启了「记住代理状态」,在 **应用升级、
  重启电脑、开机自启** 之后,系统代理 / TUN 都不会自动恢复,需要手动重新打开。
  现已修复——会按上次的开启状态自动恢复。
- **修复 TUN 自动恢复后「显示已连接却无法上网」**:重启 / 开机后 TUN 虽然自动恢复
  并显示「已连接」,但实际 0 流量、需手动关一次再开才通。现在恢复时会自动完成这一步,
  恢复后即可直接使用,无需任何手动操作。
- **提升开机自启 + TUN 的恢复成功率**:开机时网络尚未就绪导致的失败会自动重试。

### 升级建议
建议所有使用「记住代理状态」(尤其是 TUN 模式)的用户更新。更新后该功能即可正常、
开箱即用。

## 本次更新

### 🐛 修复
- **修复「记住代理状态」失效**:此前即使在设置里开启了「记住代理状态」,
  在 **应用升级、重启电脑、开机自启** 之后,系统代理 / TUN 模式都不会自动恢复,
  需要手动重新打开。现已修复——会按你上次的开启状态自动恢复。
- **提升开机自启 + TUN 的恢复成功率**:开机时网络尚未就绪导致 TUN 启动失败的情况,
  现在会自动重试,不再需要手动「关一下再开」。

### 升级建议
建议所有使用「记住代理状态」的用户更新。更新后该功能即可正常生效。

本次更新修复了应用内自动升级的关键问题。

### 🐛 问题修复
- 修复在 **开启 TUN 模式** 时，应用内更新「下载完成后应用闪退、安装程序始终不弹出」的问题。现在升级会正常停止代理、弹出安装器并完成安装与重启。

### 升级建议
强烈建议所有用户更新到本版本，否则后续的应用内自动升级可能无法正常完成。
（若当前版本无法自动升级，请到 Releases 页面手动下载安装包覆盖安装。）

### ✨ 体验优化
- 「应用更新」与「内核更新」里的更新说明现在支持 **Markdown 渲染**：标题、加粗、列表、链接、代码等都会正常排版显示，不再是一堆原始符号，升级日志更清晰易读。

本次更新修复了一个影响自动升级的问题。

### 🐛 问题修复
- 修复在 **开启 TUN 模式** 时，应用内更新「下载完成后应用自动退出、但安装程序不弹出」的问题。现在更新会正常弹出安装器并完成升级与重启。

### 升级建议
建议所有用户更新到本版本，以保证后续的应用内自动更新能够顺利进行。

## ✨ 新功能
- **首次启动自动选择界面语言**：全新安装时，应用会根据系统语言自动选择中文或英文界面，无需再手动切换。（已安装用户的语言设置保持不变）

## 🐞 问题修复
- **修复升级后开启 TUN 却没有网络的问题**：通过应用内更新后，自动恢复 TUN 模式有时会"显示已连接但实际没有流量"，需要手动关一次再开。现在升级后会自动重试，无需再手动切换。

---

### 下载安装包

| 平台 | 文件 |
|------|------|
| Windows x64 | `*-x64-setup.exe` |
| macOS Apple Silicon | `*_aarch64.dmg` |
| macOS Intel | `*_x64.dmg` |
| Linux (AppImage) | `*.AppImage` |
| Linux (Debian/Ubuntu) | `*.deb` |

> 安装包已内置 sing-box 内核，开箱即用，无需手动下载。

## ✨ 新功能与优化

- **设置页「检查更新」更准确**：修正版本号比较逻辑，测试版通道下不再把更旧的发布误报为「有新版本」。
- **进入设置自动检测更新**：每次进入设置页都会重新检测；切换稳定版 / 测试版通道时也会自动重新检测，不再残留上一次结果。
- **流量统计改为折线图**：「每日流量」由柱状图改为更直观的折线（面积）图，上传 / 下载分开展示。
- **刷新按钮动效**：连接、节点、流量统计三页的刷新按钮增加旋转反馈。

## 🔧 维护性改进

- 版本号统一以 `package.json` 为唯一来源，发版只需改一处。
- 应用内更新检查支持鉴权，缓解 GitHub API 频率限制。

## 🐛 问题修复

### 1. 修复应用内升级后 TUN 模式「已开启但无网络」

**现象**：通过应用内升级更新后，首次启动自动恢复 TUN 模式时，开关显示已开启，但实际无法上网——「连接」页 0 个连接、流量 0 B，需要手动把 TUN 关闭再打开才能恢复。

**原因**：升级时安装器会强制结束旧内核，跳过了正常的路由清理，导致新内核恢复 TUN 时叠加在残留路由上，流量被「黑洞」。代理内核本身工作正常，仅是升级路径下的时序问题。

**修复**：在检测到「刚完成升级」的启动时，自动重放一次「关闭 → 开启」TUN 的过程（等同于此前需要手动做的操作），自动清理残留路由并在干净的路由表上重建隧道。整个过程用户无感，正常重启不受影响、不会有网络闪断。

### 2. 修复 TUN 开启时升级「下载完成但不弹出安装器」

**现象**：在 TUN 模式开启的状态下检查更新，点击下载，下载完成后安装程序没有自动弹出。

**原因**：更新在启动安装器前会优雅停止内核，该过程会临时切断程序的控制台；之后用于拉起安装器的方式依赖控制台，导致安装器未能启动。

**修复**：改用系统标准方式（ShellExecuteW）直接启动安装器，不再依赖控制台，下载完成后可稳定弹出，并正常触发 UAC 授权。

---

> 说明：TUN 自愈仅在「从旧版本升级到 0.3.5」的那一次启动触发；已经在 0.3.5 上的正常重启保持原有即时恢复行为。

**完整变更**：https://github.com/radiumCN/skylark/compare/v0.3.3...v0.3.5

## 🐛 问题修复

### 修复应用内升级后 TUN 模式「已开启但无网络」

**现象**：通过应用内升级更新后，首次启动自动恢复 TUN 模式时，开关显示已开启，但实际无法上网——「连接」页 0 个连接、流量 0 B，需要手动把 TUN 关闭再打开才能恢复。

**原因**：升级时安装器会强制结束旧内核，跳过了正常的路由清理，导致新内核恢复 TUN 时叠加在残留路由上，流量被「黑洞」。代理内核本身工作正常，仅是升级路径下的时序问题。

**修复**：在检测到「刚完成升级」的启动时，自动重放一次「关闭 → 开启」TUN 的过程（等同于此前需要手动做的操作），自动清理残留路由并在干净的路由表上重建隧道。整个过程用户无感，正常重启不受影响、不会有网络闪断。

> 说明：自愈仅在「从旧版本升级到 0.3.4」的那一次启动触发。已经在 0.3.4 上的正常重启保持原有即时恢复行为。

---

**完整变更**：https://github.com/radiumCN/skylark/compare/v0.3.3...v0.3.4

## ✨ 新特性

- **内置 sing-box 内核，开箱即用**：安装包现已在编译时打包对应平台的 sing-box 内核（Tauri sidecar / externalBin），首次运行无需手动下载内核，彻底解决「没有代理就下载不了内核、没有内核又开不了代理」的死循环。

## 🔧 改进

- 内核路径统一解析：**用户自行下载的版本优先于内置版本**，保留在「设置」中单独升级内核的能力。
- macOS TUN 服务安装、Windows WinTun 目录均改用解析后的内核路径。
- 新增 `npm run fetch-kernel` 脚本，方便本地构建拉取内核。

## 📦 下载安装包

| 平台 | 文件 |
|------|------|
| Windows x64 | `*-x64-setup.exe` |
| macOS Apple Silicon | `*_aarch64.dmg` |
| macOS Intel | `*_x64.dmg` |
| Linux (AppImage) | `*.AppImage` |
| Linux (Debian/Ubuntu) | `*.deb` |

> 本版本起安装包已内置 sing-box 内核（v1.13.14），开箱即用，无需手动下载。

## 本次更新

### 🐛 修复 macOS 安装版无法启动（sing-box 启动失败：控制端口未就绪）
内核日志为 `FATAL: open cache.db: read-only file system`。从 `/Applications`
启动时进程工作目录是只读的 `/`，而内核的 `cache_file` 用相对路径写到该目录导致
启动即崩溃、控制端口无法就绪。现已将 `cache_file` 固定到可写的应用数据目录，并为
内核进程显式设置工作目录。

### ✨ macOS TUN 模式「一次授权，之后免密」
不再每次开 TUN 都把整个程序以管理员重启、反复输密码。改为在「设置 → TUN 模式」
点一次「安装 TUN 服务」完成一次授权后：
- 内核被安装到 root 拥有的固定路径，并写入一条经校验的免密 sudo 规则（仅放行该内核
  及对它的结束操作）；
- 之后启用 TUN 全程无需再次输入密码，且程序界面始终以普通用户运行，更安全。
> 提示：之后如在设置里更新了 sing-box 内核，请重新点一次「安装 TUN 服务」以刷新
> root 副本。

### 🔧 其他
- CI：升级 `actions/checkout`、`actions/setup-node` 到 v5，消除 Node 20 弃用告警。

---

## 下载安装包

| 平台 | 文件 |
|------|------|
| Windows x64 | `*-x64-setup.exe` |
| macOS Apple Silicon | `*_aarch64.dmg` |
| macOS Intel | `*_x64.dmg` |
| Linux (AppImage) | `*.AppImage` |
| Linux (Debian/Ubuntu) | `*.deb` |

> **首次运行**需自行下载 [sing-box 内核](https://github.com/SagerNet/sing-box/releases/latest)（设置页一键下载）。
> **macOS** 若提示「无法打开/已损坏」，因安装包未签名，可在「系统设置 → 隐私与安全性」点「仍要打开」，或终端执行 `xattr -dr com.apple.quarantine /Applications/Skylark.app`。

首个面向「功能完整」的版本：补齐多语言、流量统计、订阅增强、WireGuard、诊断、快捷键、多配置等一批能力。

## ✨ 新功能
- 🌐 **多语言界面**（简体中文 / English）——设置内一键切换，即时生效
- 📊 **流量统计页**——每日上下行历史持久化 + 堆叠柱状图，支持 7 / 30 / 90 天
- 🧰 **订阅节点过滤 / 地区分组**——按关键字或正则保留/排除节点，自动按地区分组（非法正则不会清空节点）
- 🔌 **WireGuard 协议**——支持 `wireguard://` 链接与 Clash wireguard 配置（sing-box ≥1.12 endpoint 模型）
- 🩺 **网络诊断面板**——经代理检测出口 IP / 地区 / ISP，并探测常用站点连通性
- ⌨️ **全局快捷键**——`Ctrl/Cmd+Shift+P` 系统代理 · `+Shift+T` TUN · `+Shift+R` 切换模式
- 🗂️ **多配置 Profile**——保存多套设置（订阅 / 规则 / 模式），一键切换
- 🟢 **节点健康度**——节点名前延迟色点，状态一眼可读

## 🛡️ 安全与稳定
- 内核与应用安装包下载均做 **SHA-256 完整性校验**，不匹配则丢弃/中止
- **单实例运行**——二次启动自动唤起已有窗口，避免端口 / TUN 冲突

## 🖥️ 体验与平台
- **连接页**：列排序、上下行实时总计、按主机聚合 + 一键关闭
- **分流规则**：拖拽调整优先级
- **Linux**：支持 GNOME 系统代理（提供 `.deb` / `.AppImage`）

## ⚠️ 已知限制
- 首次运行需自行下载 [sing-box 内核](https://github.com/SagerNet/sing-box/releases/latest)（应用内「内核更新」可一键下载）
- Linux 系统代理当前覆盖 GNOME 系，KDE 暂未支持
- WireGuard / endpoint 配置需 sing-box ≥1.12

## 📦 下载

| 平台 | 文件 |
|------|------|
| Windows x64 | `*-x64-setup.exe` |
| macOS Apple Silicon | `*_aarch64.dmg` |
| macOS Intel | `*_x64.dmg` |
| Linux (AppImage) | `*.AppImage` |
| Linux (Debian/Ubuntu) | `*.deb` |

## 更新内容

### 修复

- **修复更新内核时"拒绝访问"错误（Windows）**
  更新 sing-box 内核时，若内核进程正在运行，直接覆盖可执行文件会导致 `os error 5`（Access Denied）。现改为先将旧文件重命名为 `.old`（Windows 允许对运行中文件重命名），再写入新文件，最后清理旧文件；更新失败时自动回滚，确保内核文件不丢失。

- **修复 macOS Intel 版本无法打包的问题**
  GitHub Actions 的 `macos-13`（Intel 物理机）Runner 已被弃用，导致 CI 无法构建 macOS Intel 版本。现改为在 Apple Silicon Runner 上通过 Rust 交叉编译生成 `x86_64-apple-darwin` 产物，产出文件不变（`*_x64.dmg`）。

## 下载安装包

| 平台 | 文件 |
|------|------|
| Windows x64 | `*-x64-setup.exe` |
| macOS Apple Silicon | `*_aarch64.dmg` |
| macOS Intel | `*_x64.dmg` |
| Linux (AppImage) | `*.AppImage` |
| Linux (Debian/Ubuntu) | `*.deb` |

> **注意**：首次运行需要自行下载 [sing-box 内核](https://github.com/SagerNet/sing-box/releases/latest)。