feat: release v0.88.0 with automation and browser runtime upgrades

2026-09-24 23:10:56 +08:00 · 2026-03-16 15:28:21 +08:00
parent 88c3bf93e7
commit 723fafe621
271 changed files with 47044 additions and 19216 deletions
@@ -16,16 +16,17 @@ navigation:

 ## 下载

-从 GitHub Releases/Tags 下载最新版本安装包：
+从 GitHub Releases 下载最新版本安装包：

-[下载 ProxyCast](https://github.com/aiclientproxy/proxycast/tags)
+[下载 ProxyCast](https://github.com/aiclientproxy/proxycast/releases)

 ### 安装包

 | 平台 | 文件名 | 说明 |
 |------|--------|------|
 | macOS | `ProxyCast_x.x.x_aarch64.dmg` | Apple Silicon Mac |
-| Windows | `ProxyCast_x.x.x_x64-setup.exe` | Windows 64位 |
+| Windows | `ProxyCast_x.x.x_x64-online-setup.exe` | 默认推荐，体积更小，安装时按需下载 WebView2 |
+| Windows | `ProxyCast_x.x.x_x64-offline-setup.exe` | 离线、内网或受限网络环境使用 |

 ## macOS 安装

@@ -40,11 +41,15 @@ navigation:

 ## Windows 安装

-1. 下载 `.exe` 安装程序
+1. 优先下载 `ProxyCast_x.x.x_x64-online-setup.exe`
 2. 双击运行安装程序
 3. 按照安装向导完成安装
 4. 从开始菜单启动 ProxyCast

+::alert{type="info"}
+如果设备处于离线、内网或受限网络环境，请改用 `ProxyCast_x.x.x_x64-offline-setup.exe`。
+::
+
 ## 验证安装

 启动 ProxyCast 后，你应该看到：
@@ -107,10 +107,11 @@ navigation:

 ### 处理建议

-1. 优先重新下载安装 `ProxyCast_*_x64-setup.exe`
+1. 优先重新下载安装 `ProxyCast_*_x64-online-setup.exe`
 2. 确认 `%APPDATA%\proxycast\` 与 `%USERPROFILE%\.proxycast\` 可写
 3. 如被 SmartScreen 拦截，确认来源可信后再继续
-4. 如有条件，运行一键收集脚本后再反馈
+4. 如果处于离线、内网或受限网络环境，改用 `ProxyCast_*_x64-offline-setup.exe`
+5. 如有条件，运行一键收集脚本后再反馈

 详见 [Windows 启动与安装问题](/troubleshooting/windows-startup-issues)。

@@ -20,7 +20,7 @@ navigation:

 推荐优先使用：

- `ProxyCast_*_x64-setup.exe`
+- `ProxyCast_*_x64-online-setup.exe`

 不建议优先分发：

@@ -29,8 +29,8 @@ navigation:

 原因：

- `setup.exe` 会一并处理 WebView2 Offline Installer
- 在弱网、离线或新系统环境下成功率更高
+- 在线安装包体积更小，适合大多数 Windows 10/11 用户
+- 如果处于离线、内网或受限网络环境，请改用 `ProxyCast_*_x64-offline-setup.exe`

 ## 常见症状与处理

@@ -40,14 +40,14 @@ navigation:

 1. 确认下载来源可信
 2. 如果被 SmartScreen 拦截，点击“更多信息”后再确认是否继续
-3. 重新运行 `setup.exe` 覆盖安装
+3. 重新运行 Windows setup 安装包覆盖安装
 4. 安装后从开始菜单再次启动

 ### 启动后白屏

 处理建议：

-1. 优先重装 `setup.exe`，补齐 WebView2 Runtime
+1. 优先重装 Windows setup 安装包，补齐 WebView2 Runtime
 2. 检查系统是否禁用了 Edge WebView2 Runtime
 3. 再确认本地目录是否可写

@@ -56,7 +56,7 @@ navigation:
 处理建议：

 1. 不要先手动找旧版运行时
-2. 先重新运行 `setup.exe`
+2. 先重新运行 Windows setup 安装包
 3. 如仍失败，再单独检查 WebView2 Runtime 是否安装完整

 ## 目录权限检查
@@ -50,7 +50,7 @@ xcode-select --install
 **Windows:**

 - 安装 Visual Studio Build Tools
- 安装 WebView2（开发模式必需；对外分发时建议使用带离线 WebView2 的 NSIS 安装器）
+- 安装 WebView2（开发模式必需；对外分发时默认推荐在线小包，离线或受限网络环境再提供离线大包）

 **Linux:**

@@ -141,11 +141,14 @@ pnpm tauri build --target universal-apple-darwin
 #### Windows 构建

 ```bash
-# 构建 64 位 Windows 安装包（NSIS setup.exe，内置离线 WebView2 安装器）
+# 构建 64 位 Windows 在线安装包（推荐，体积更小，安装时按需下载 WebView2）
+pnpm tauri build --target x86_64-pc-windows-msvc --config src-tauri/tauri.windows.online.conf.json
+
+# 构建 64 位 Windows 离线安装包（体积更大，内置离线 WebView2 安装器）
 pnpm tauri build --target x86_64-pc-windows-msvc --config src-tauri/tauri.windows.conf.json
 ```

-> 建议对外分发 `-setup.exe`，不要把默认 `.msi` 作为首选下载项。
+> 建议默认对外分发在线小包；只有内网、离线或受限网络环境，再提供离线大包。

 #### Linux 构建

@@ -42,8 +42,8 @@ navigation:

 ## Windows 启动失败排查

- 优先确认用户安装的是 `ProxyCast_*_x64-setup.exe`，不要默认分发便携包或旧的 `.msi`
- 首次启动若提示缺少运行时，优先重新运行 `setup.exe`，它会一并安装 WebView2 Offline Installer
+- 优先确认用户安装的是 `ProxyCast_*_x64-online-setup.exe`；离线、内网或受限网络环境再提供 `ProxyCast_*_x64-offline-setup.exe`
+- 首次启动若提示缺少运行时，优先重新运行 Windows setup 安装包；如果在线安装失败，再切换到 offline 安装包
 - 检查 `%APPDATA%\proxycast\` 与 `%USERPROFILE%\.proxycast\` 是否可写；数据库、日志与部分运行时状态依赖这两个目录
 - 收集 `%USERPROFILE%\.proxycast\logs\` 与 `%USERPROFILE%\.proxycast\request_logs\` 作为一线排障材料
 - 若前端出现 Windows 启动自检提示，按提示项优先检查目录权限、数据库可访问性、WebView2 与 Shell 可用性