feat: v0.9.1 — 面板设置页、网络代理、后台安装、模型服务商扩展、多项修复

新功能: - 新增独立面板设置页面（网络代理 + 代理测试 + 模型代理开关 + npm源） - 网络代理支持：下载类操作走代理，自动绕过内网地址 - 安装/升级/卸载改为后台执行，不再阻塞界面 - 全局任务状态栏：关闭弹窗后顶部显示进度，可重新查看日志 - 安装/卸载完成后自动刷新界面状态 - 新增多个模型服务商快捷配置（硅基流动、火山引擎、阿里云百炼、智谱AI、MiniMax、NVIDIA NIM、胜算云） - AI助手浮动按钮恢复，首次提示可拖动，实时聊天页隐藏修复: - 修复版本更新误判（本地版本高于远端不再误弹更新） - 修复Windows下nvm/自定义Node路径CLI检测 - 修复npm EEXIST文件冲突（--force + 安装前自动清理） - 修复汉化版-zh.x后缀版本比较错误 - 修复模型URL自动拼接/v1问题 - 修复切换版本后Gateway重装失败（PATH缓存刷新） - 修复切换助手服务商时旧模型名残留优化: - macOS图标改用docs/logo.png统一生成 - 内置推荐版本号更新到OpenClaw 2026.3.13 - 错误诊断增强（EEXIST识别） - 弹窗标题根据操作类型显示 - 新增版本维护文档
2026-08-07 22:53:58 +08:00 · 2026-03-14 19:57:22 +08:00
parent c8ccb5dd4b
commit 394813a96c
88 changed files with 1807 additions and 513 deletions
--- a/docs/index.html
+++ b/docs/index.html
@@ -34,7 +34,7 @@
    "description": "OpenClaw AI Agent 可视化管理面板，基于 Tauri v2 的跨平台桌面应用。支持仪表盘监控、多模型配置、消息渠道管理、内置 QQ 机器人、实时 AI 聊天、记忆管理、Agent 管理、网关配置、内网穿透等功能。",
    "url": "https://claw.qt.cool/",
    "downloadUrl": "https://github.com/qingchencloud/clawpanel/releases/latest",
-    "softwareVersion": "0.8.6",
+    "softwareVersion": "0.9.1",
    "author": {
      "@type": "Organization",
      "name": "晴辰云 QingchenCloud",
@@ -1133,7 +1133,7 @@
    <div class="orb orb-2" style="top:auto;bottom:-100px"></div>
    <div class="container-sm" style="position:relative;z-index:10">
      <div class="section-header">
-        <div class="reveal download-version"><span class="pulse"></span> v0.8.6 最新版</div>
+        <div class="reveal download-version"><span class="pulse"></span> v0.9.1 最新版</div>
        <h2 class="reveal section-title"><span class="gradient-text">下载安装</span></h2>
        <p class="reveal section-desc">选择你的操作系统，一键下载安装</p>
      </div>
@@ -1143,11 +1143,11 @@
          <h3>macOS</h3>
          <p class="dl-desc">支持 Apple Silicon 和 Intel 芯片</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.8.6_aarch64.dmg" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.9.1_aarch64.dmg" target="_blank" rel="noopener">
              Apple Silicon (M1/M2/M3/M4)
              <span class="dl-format">.dmg</span>
            </a>
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.8.6_x64.dmg" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.9.1_x64.dmg" target="_blank" rel="noopener">
              Intel 芯片
              <span class="dl-format">.dmg</span>
            </a>
@@ -1165,11 +1165,11 @@
          <h3>Windows</h3>
          <p class="dl-desc">支持 Windows 10 及以上版本</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.8.6_x64-setup.exe" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.9.1_x64-setup.exe" target="_blank" rel="noopener">
              安装程序
              <span class="dl-format">.exe</span>
            </a>
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.8.6_x64_en-US.msi" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.9.1_x64_en-US.msi" target="_blank" rel="noopener">
              MSI 安装包
              <span class="dl-format">.msi</span>
            </a>
@@ -1180,11 +1180,11 @@
          <h3>Linux</h3>
          <p class="dl-desc">支持主流 Linux 发行版</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.8.6_amd64.AppImage" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.9.1_amd64.AppImage" target="_blank" rel="noopener">
              通用版
              <span class="dl-format">.AppImage</span>
            </a>
-            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.8.6_amd64.deb" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://claw.qt.cool/proxy/dl/github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.9.1_amd64.deb" target="_blank" rel="noopener">
              Debian / Ubuntu
              <span class="dl-format">.deb</span>
            </a>
--- a/docs/linux-deploy.md
+++ b/docs/linux-deploy.md
@@ -332,24 +332,31 @@ sudo systemctl restart clawpanel  # 或 pm2 restart clawpanel

 **方式一：在 ClawPanel 面板中操作**（推荐）

-打开「关于」页面 → 点击「检查更新」→ 按提示升级。面板会自动处理 sudo 权限和镜像源。
+打开「关于」页面 → 点击版本管理，优先切换到当前面板绑定的推荐稳定版。面板会自动处理 sudo 权限、镜像源与 Git HTTPS 兼容。
+
+> **版本策略说明**：ClawPanel 会按面板版本绑定一组 OpenClaw 推荐稳定版，避免老面板直接管理最新版带来的兼容性风险。如需尝试最新版，请在「关于」页手动切换版本，并自行验证兼容性。

 **方式二：命令行手动升级**

 ```bash
-# 非 root 用户需要 sudo
-sudo npm install -g @qingchencloud/openclaw-zh@latest --registry https://registry.npmmirror.com
+# 汉化优化版（示例：ClawPanel 0.9.0 推荐版）
+sudo npm install -g @qingchencloud/openclaw-zh@2026.3.7-zh.2 --registry https://registry.npmmirror.com

-# 淘宝源安装失败？换官方源重试（可能需要翻墙或代理）
-sudo npm install -g @qingchencloud/openclaw-zh@latest --registry https://registry.npmjs.org
+# 官方原版（示例：ClawPanel 0.9.0 推荐版）
+sudo npm install -g openclaw@2026.3.11 --registry https://registry.npmjs.org
+
+# 国内镜像失败时，再切 npm 官方源重试
+sudo npm install -g @qingchencloud/openclaw-zh@2026.3.7-zh.2 --registry https://registry.npmjs.org
 ```

-> **权限说明**：Linux 全局 npm 包安装需要 root 权限。ClawPanel v0.8.1+ 已自动检测非 root 用户并加 sudo。如仍遇权限问题，手动加 `sudo` 即可。
+> **维护说明**：如果你是 ClawPanel 维护者，后续只需要更新仓库根目录的 `openclaw-version-policy.json`，即可统一调整不同面板版本对应的推荐 OpenClaw 版本。程序版本号、热更新清单、桌面图标的维护方式见 `docs/version-maintenance.md`。
+
+> **权限说明**：Linux 全局 npm 包安装需要 root 权限。ClawPanel 现已自动检测非 root 用户并加 sudo，同时会自动补 GitHub HTTPS rewrite 规则；如仍遇权限问题，手动加 `sudo` 即可。

 ### 更新频率

 - **ClawPanel**：`git pull` 获取最新代码，无需重新安装依赖（除非 package.json 变了）
- **OpenClaw**：通过 npm 全局升级，面板会自动检测新版本并提示
+- **OpenClaw**：优先通过面板切换到推荐稳定版；如需尝试其它版本，请在「关于」页手动切换
 - **前端热更新**：面板支持前端热更新（不需要 git pull），在「关于」页面点击「热更新」按钮即可

 ---
--- a/docs/update/latest.json
+++ b/docs/update/latest.json
@@ -1,9 +1,9 @@
 {
-  "version": "0.8.6",
-  "minAppVersion": "0.8.6",
-  "hash": "sha256:a6c28d0607c4226ccffa8199c4aa21f1bd7075ed7b85e24be1fb31f105ae983d",
-  "url": "https://github.com/qingchencloud/clawpanel/releases/download/v0.8.6/web-0.8.6.zip",
-  "size": 1967473,
-  "changelog": "",
-  "releasedAt": "2026-03-13T09:29:07Z"
+  "version": "0.9.1",
+  "minAppVersion": "0.9.0",
+  "hash": "",
+  "url": "https://github.com/qingchencloud/clawpanel/releases/download/v0.9.1/web-0.9.1.zip",
+  "size": 0,
+  "changelog": "新增面板设置页、网络代理、后台安装、模型服务商扩展等",
+  "releasedAt": "2026-03-14T18:00:00Z"
 }
--- a/docs/version-maintenance.md
+++ b/docs/version-maintenance.md
@@ -0,0 +1,134 @@
+# ClawPanel 版本维护说明
+
+这份文档面向 ClawPanel 维护者，说明后续如何维护：
+
+- ClawPanel 自身版本号
+- OpenClaw 推荐稳定版映射
+- 热更新清单 `latest.json`
+- 桌面端图标资源
+- 本地回归检查
+
+## 一、维护入口速查
+
+- **改 OpenClaw 推荐稳定版**：编辑仓库根目录 `openclaw-version-policy.json`
+- **改 ClawPanel 程序版本号**：执行 `npm run version:set 0.x.y`
+- **改前端热更新清单**：编辑 `docs/update/latest.json`
+- **重生成桌面图标**：执行 `npm run icon:regen`
+- **本地回归**：执行 `npm run build`、`cargo check --manifest-path src-tauri/Cargo.toml`
+
+## 二、如何调整 OpenClaw 推荐稳定版
+
+ClawPanel 现在使用仓库根目录的 `openclaw-version-policy.json` 作为统一版本策略文件。
+
+当前结构示例：
+
+```json
+{
+  "default": {
+    "official": { "recommended": "2026.3.11" },
+    "chinese": { "recommended": "2026.3.7-zh.2" }
+  },
+  "panels": {
+    "0.9.0": {
+      "official": { "recommended": "2026.3.11" },
+      "chinese": { "recommended": "2026.3.7-zh.2" }
+    }
+  }
+}
+```
+
+维护建议：
+
+1. **默认推荐版**：改 `default`
+2. **某个面板版本的推荐版**：改 `panels.<panel_version>`
+3. 如果新面板版本需要绑定独立推荐版，新增一个新的 `panels.<new_version>` 节点
+4. 如果没有单独配置某个面板版本，会回退到 `default`
+
+改完这个文件后，Rust 后端和 Web dev 后端都会读取同一份策略，前端各页面也会自动显示新的推荐版本和风险提示。
+
+## 三、如何调整 ClawPanel 程序版本号
+
+ClawPanel 现在以 `package.json` 作为主版本源，并通过脚本同步到其他文件。
+
+推荐用法：
+
+```bash
+npm run version:set 0.9.1
+```
+
+这条命令会同步以下文件：
+
+- `package.json`
+- `src-tauri/tauri.conf.json`
+- `src-tauri/Cargo.toml`
+- `docs/index.html`
+
+如果你只是想重新同步，不改版本号，也可以执行：
+
+```bash
+npm run version:sync
+```
+
+## 四、什么时候需要更新 `docs/update/latest.json`
+
+`docs/update/latest.json` 用于桌面端前端热更新提示。
+
+常见维护规则：
+
+1. 发布了新的前端热更新包后，需要同步更新：
+   - `version`
+   - `minAppVersion`
+   - `url`
+   - `hash`
+   - `releasedAt`
+2. 如果 `latest.json` 落后于当前程序版本，ClawPanel 现在**不会再误报有更新**，但用户也看不到最新发布提示，所以仍然建议及时维护
+3. 如果热更新资源还没准备好，不要提前把 `latest.json.version` 指到新版本
+
+## 五、如何重生成桌面图标
+
+ClawPanel 桌面端图标源现在使用 `docs/logo.png`。
+
+重生成命令：
+
+```bash
+npm run icon:regen
+```
+
+它会重生成 `src-tauri/icons` 下的一整套图标资源，包括：
+
+- `icon.icns`
+- `icon.ico`
+- `32x32.png`
+- `128x128.png`
+- 其他平台尺寸图标
+
+如果后续只更新 Logo，重新执行一次即可，不需要手动逐个改图标文件。
+
+## 六、本地回归检查建议
+
+每次维护版本策略、程序版本号、热更新清单或桌面图标后，至少执行：
+
+```bash
+npm run build
+cargo check --manifest-path src-tauri/Cargo.toml
+```
+
+如果本次改动涉及安装/检测链路，建议额外确认：
+
+- Windows 下自定义 Node 路径后，CLI 状态能立即刷新
+- “关于”页 / “服务管理”页能正确显示推荐稳定版
+- 本地版本高于推荐版时，风险提示仍然正确
+- 当 `docs/update/latest.json` 版本低于本地版本时，不会再误弹更新提示
+
+## 七、推荐维护顺序
+
+推荐按下面顺序维护：
+
+1. 确认本次要发布的 ClawPanel 版本
+2. 执行 `npm run version:set x.y.z`
+3. 如有必要，更新 `openclaw-version-policy.json`
+4. 重新构建前端 / 检查 Rust 编译
+5. 如桌面图标有调整，执行 `npm run icon:regen`
+6. 如有前端热更新包，最后再更新 `docs/update/latest.json`
+
+这样可以最大限度避免版本号、推荐版映射和更新清单不一致。