VR-B02 · RELEASE NOTES

VR-B02 · 对照仓库 clash-verge-rev/releases

Clash Verge Rev v2.0发布说明 | 逐版变更 · Breaking Changes · 升级回滚

本说明为 v2.0.x 主线的官方编撰 Release 摘要，供变更管理与升级审批使用。逐条 commit 以 GitHub 发布页为准。

Release 说明

1. 当前推荐版本

客户端内置 mihomo标签 URL建议
v2.0.2v1.18.10v2.0.2新部署首选
v1.7.7v1.18.8Releases 历史页仅兼容回退

2. v2.0.2 变更条目

  • Tauri 2 构建链稳定，修复 Win10 21H2 托盘右键偶发无响应
  • sidecar 就绪等待上限调整为 15s（HDD 环境）
  • 内置 mihomo 升至 v1.18.10，支持当前主线出站协议集
  • Profile 合并失败时回滚至上一快照（延续 v1.7 能力）

2.1 升级后验证（必做）

# 1. 查看内核版本（应用内 或 API）
curl -s -H "Authorization: Bearer $SECRET" http://127.0.0.1:9097/version

# 2. Windows 校验安装包（升级前）
Get-FileHash -Algorithm SHA256 .\Clash.Verge_*-setup.exe
预期 /version：{"meta":true,"version":"v1.18.10"}
预期哈希：与 Release 页同资产 sha256 字段一致（区分大小写）

3. v2.0.0 — Tauri 2 迁移里程碑

v2.0.0 标志着主构建系统从 Tauri 1 迁至 Tauri 2，属于主版本升级，需纳入变更窗口而非静默推送。

3.1 Breaking Changes 清单

项影响缓解
最低 Windows需 Win10 1809+ 与 WebView2提前部署 WebView2 Runtime
Tauri 插件 API第三方插件不兼容不使用非官方插件
配置目录与 v1.x 兼容升级前仍建议备份 profiles
sidecar 接口内部实现变更用户无感；自定义脚本勿依赖进程名硬编码

4. 推荐升级路径（生产）

  1. 变更单审批，锁定目标版本 SHA256
  2. 备份 ~/.config/clash-verge 整目录
  3. 在非业务高峰安装 v2.0.2
  4. 执行 VR-B03 或 SC-01 验收四项
  5. 观察 24h 日志，无异常后关闭变更单
Windows 排障不在本文wintun、Defender → rev-clash Windows 安装专题

5. 回滚策略

若升级后内核无法启动或 Profile 合并持续失败：

  1. 卸载 v2.0.2，安装已校验的 v1.7.7 包
  2. 还原备份的 profiles 目录
  3. Windows TUN 异常时重启 OS 清除 wintun 状态
  4. 记录故障日志，参考 SC-04

回滚不得跳过 SHA256 校验，即使使用历史版本。

6. 已知问题与规避（v2.0.x）

现象环境规避
启动白屏Windows 缺 WebView2安装 Runtime
Linux 无托盘Wayland 无 indicator见 SC-02
macOS TUN 失败未授权系统扩展见 rev-clash macOS 权限

7. 相关文档索引