chore: release v0.7.0

2026-06-25 17:54:10 +08:00 · 2026-03-08 02:02:01 +08:00
parent af6a447cf1
commit 6bd7526348
8 changed files with 104 additions and 29 deletions
--- a/.windsurf/workflows/release.md
+++ b/.windsurf/workflows/release.md
@@ -2,40 +2,83 @@
 description: 发布新版本（打 tag + 推送，触发跨平台构建）
 ---

+## 版本号约定
+
+- 格式: `x.y.z`（如 `0.7.0`）
+- tag 格式: `v0.7.0`（带 `v` 前缀）
+
 ## 发布前检查

-1. 确认所有改动已提交，工作区干净：
+1. 确认所有功能改动已提交并推送，CI 全部通过（main 分支绿灯）
+
+2. 确认工作区干净：
+// turbo
 ```bash
 git status
 ```

-2. 确认 CI 全部通过（main 分支绿灯）
+## 更新版本号
+
+`version:set` 会自动同步以下文件，不需要手动改：
+- `package.json` — npm 版本
+- `src-tauri/tauri.conf.json` — Tauri 版本
+- `src-tauri/Cargo.toml` → `Cargo.lock` — Rust 版本
+- `docs/index.html` — JSON-LD `softwareVersion`、下载链接文件名（`ClawPanel_x.y.z_xxx`）、版本徽标（`vx.y.z 最新版`）

-3. 更新版本号（一条命令自动同步 package.json → tauri.conf.json → Cargo.toml → docs/index.html）：
 // turbo
 ```bash
-npm run version:set 1.2.3
+npm run version:set 0.7.0
 ```

-4. 更新 `CHANGELOG.md`，在顶部加入本次版本的变更记录
+运行后检查输出，确认 4 个文件都标记了 ✅。
+
+## 更新 CHANGELOG
+
+在 `CHANGELOG.md` 顶部（`## [上一版本]` 之前）加入新版本记录，格式：
+
+```markdown
+## [0.7.0] - 2026-03-08
+
+### 新功能 (Features)
+
+- **功能名** — 一句话描述
+
+### 改进 (Improvements)
+
+- **改进名** — 一句话描述
+```
+
+内容要覆盖本次版本的所有变更，包括新功能、改进、修复、安全更新等。
+
+## 提交并推送

-5. 提交版本更新：
 ```bash
 git add -A
-git commit -m "chore: release v1.2.3"
+git commit -m "chore: release v0.7.0"
+```
+
+### ⚠️ 推送注意事项
+
+如果本次提交包含 `.github/workflows/` 文件的改动，IDE 内置的 OAuth token 没有 `workflow` scope，会被 GitHub 拒绝。需要在**系统终端**（非 IDE 终端）用自己的 git 凭据推送：
+
+```bash
 git push origin main
 ```

+如果不含 workflow 文件改动，IDE 内 push 即可。
+
 ## 打 tag 并触发发布

 ```bash
-git tag v1.2.3
-git push origin v1.2.3
+git tag v0.7.0
+git push origin v0.7.0
 ```

 推送 tag 后，GitHub Actions 会自动：
 - 并行构建 macOS ARM64 / macOS Intel / Linux / Windows 四个平台
 - 创建 GitHub Release 并上传安装包
+- 构建前端 web 包并上传为 Release Asset
+- 更新 `docs/update/latest.json`（前端热更新清单）
 - 所有平台构建完成后统一写入 Release Notes

 ## 查看构建进度
@@ -44,22 +87,30 @@ git push origin v1.2.3

 ## 手动触发（不打 tag）

-在 GitHub Actions 页面手动触发 `Release` 工作流，输入版本号（如 `v1.2.3`）。
+在 GitHub Actions 页面手动触发 `Release` 工作流，输入版本号（如 `v0.7.0`）。

 ## 发布后验证

- [ ] Release 页面出现四个平台的安装包
+- [ ] Release 页面出现四个平台的安装包（.dmg ×2, .exe, .msi, .AppImage, .deb）
 - [ ] Release Notes 内容正确（有下载表格 + changelog）
- [ ] 下载 Windows EXE 安装验证可用
 - [ ] `latest` 标签指向新 Release
+- [ ] 官网 https://claw.qt.cool 下载链接指向新版本
+- [ ] `docs/update/latest.json` 已被 CI 自动更新
+
+## 发布后同步
+
+Mac 堡垒机上的 ClawPanel 项目需要手动同步（如有需要）：
+```bash
+ssh mac "cd /Users/admin/Desktop/clawpanel && export https_proxy=http://127.0.0.1:7897 && git pull"
+```

 ## 回滚

 如果发布有问题，在 GitHub Releases 页面将该 Release 设为 Draft 或删除，然后修复后重新打 tag：
 ```bash
-git tag -d v1.2.3
-git push origin :refs/tags/v1.2.3
+git tag -d v0.7.0
+git push origin :refs/tags/v0.7.0
 # 修复问题后
-git tag v1.2.3
-git push origin v1.2.3
+git tag v0.7.0
+git push origin v0.7.0
 ```
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,24 @@
 格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

+## [0.7.0] - 2026-03-08
+
+### 新功能 (Features)
+
+- **OpenClaw 版本管理** — 支持安装/升级/降级/切换版本，汉化版与原版自由选择，版本号从 npm registry 实时拉取
+- **版本选择器弹窗** — 可视化选择目标版本，自动判断操作类型（安装/升级/降级/切换/重新安装）
+- **Headless Web 服务器** — 新增 `npm run serve` 独立 Node.js 静态服务器，替代 `npx vite`，用于 Linux 无桌面部署
+- **扩展工具管理** — Skills 页面全新设计，支持浏览、安装、卸载 MCP 工具
+- **前端热更新基础设施** — Release 自动构建 web 包，支持 OTA 检查与回退
+
+### 改进 (Improvements)
+
+- **macOS Gatekeeper 提示优化** — 官网 + README 强调「先拖入应用程序」，新增 `~/Downloads` 路径备选命令
+- **部署文档统一** — `linux-deploy.sh/md`、`docker-deploy.md`、`README.md` 全部改为 `npm run serve`
+- **弹窗标题动态化** — 安装/升级/降级/卸载操作各自显示准确标题，关闭弹窗后自动刷新页面
+- **跨平台兼容** — `serve.js` 路径分隔符使用 `path.sep`，确保 Windows/Linux/macOS 通用
+- **AI 助手危险工具确认** — 执行系统命令等高风险操作前弹出二次确认
+
 ## [0.6.0] - 2026-03-07

 ### 新功能 (Features)
--- a/docs/index.html
+++ b/docs/index.html
@@ -34,7 +34,7 @@
    "description": "OpenClaw AI Agent 可视化管理面板，基于 Tauri v2 的跨平台桌面应用。支持仪表盘监控、多模型配置、实时 AI 聊天、记忆管理、Agent 管理、网关配置、内网穿透等功能。",
    "url": "https://claw.qt.cool/",
    "downloadUrl": "https://github.com/qingchencloud/clawpanel/releases/latest",
-    "softwareVersion": "0.6.0",
+    "softwareVersion": "0.7.0",
    "author": {
      "@type": "Organization",
      "name": "晴辰云 QingchenCloud",
@@ -972,7 +972,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.6.0 最新版</div>
+        <div class="reveal download-version"><span class="pulse"></span> v0.7.0 最新版</div>
        <h2 class="reveal section-title"><span class="gradient-text">下载安装</span></h2>
        <p class="reveal section-desc">选择你的操作系统，一键下载安装</p>
      </div>
@@ -982,11 +982,11 @@
          <h3>macOS</h3>
          <p class="dl-desc">支持 Apple Silicon 和 Intel 芯片</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.6.0_aarch64.dmg" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.7.0_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://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.6.0_x64.dmg" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.7.0_x64.dmg" target="_blank" rel="noopener">
              Intel 芯片
              <span class="dl-format">.dmg</span>
            </a>
@@ -1004,11 +1004,11 @@
          <h3>Windows</h3>
          <p class="dl-desc">支持 Windows 10 及以上版本</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.6.0_x64-setup.exe" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.7.0_x64-setup.exe" target="_blank" rel="noopener">
              安装程序
              <span class="dl-format">.exe</span>
            </a>
-            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.6.0_x64_en-US.msi" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.7.0_x64_en-US.msi" target="_blank" rel="noopener">
              MSI 安装包
              <span class="dl-format">.msi</span>
            </a>
@@ -1019,11 +1019,11 @@
          <h3>Linux</h3>
          <p class="dl-desc">支持主流 Linux 发行版</p>
          <div class="dl-links">
-            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.6.0_amd64.AppImage" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.7.0_amd64.AppImage" target="_blank" rel="noopener">
              通用版
              <span class="dl-format">.AppImage</span>
            </a>
-            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.6.0_amd64.deb" target="_blank" rel="noopener">
+            <a class="dl-link" href="https://github.com/qingchencloud/clawpanel/releases/latest/download/ClawPanel_0.7.0_amd64.deb" target="_blank" rel="noopener">
              Debian / Ubuntu
              <span class="dl-format">.deb</span>
            </a>
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "clawpanel",
-  "version": "0.6.0",
+  "version": "0.7.0",
  "private": true,
  "description": "ClawPanel - OpenClaw 可视化管理面板，基于 Tauri v2 的跨平台桌面应用",
  "type": "module",
--- a/scripts/sync-version.js
+++ b/scripts/sync-version.js
@@ -51,7 +51,13 @@ const targets = [
  {
    file: 'docs/index.html',
    update(content) {
-      return content.replace(/"softwareVersion":\s*"[^"]*"/, `"softwareVersion": "${version}"`)
+      // JSON-LD softwareVersion
+      let result = content.replace(/"softwareVersion":\s*"[^"]*"/, `"softwareVersion": "${version}"`)
+      // 下载链接中的版本号: ClawPanel_x.y.z_xxx
+      result = result.replace(/ClawPanel_\d+\.\d+\.\d+_/g, `ClawPanel_${version}_`)
+      // 版本徽标: v0.x.x 最新版
+      result = result.replace(/v\d+\.\d+\.\d+\s*最新版/, `v${version} 最新版`)
+      return result
    },
  },
 ]
--- a/src-tauri/Cargo.lock
+++ b/src-tauri/Cargo.lock
@@ -328,7 +328,7 @@ dependencies = [

 [[package]]
 name = "clawpanel"
-version = "0.6.0"
+version = "0.7.0"
 dependencies = [
 "base64 0.22.1",
 "chrono",
--- a/src-tauri/Cargo.toml
+++ b/src-tauri/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "clawpanel"
-version = "0.6.0"
+version = "0.7.0"
 edition = "2021"
 description = "ClawPanel - OpenClaw 可视化管理面板"
 authors = ["qingchencloud"]
--- a/src-tauri/tauri.conf.json
+++ b/src-tauri/tauri.conf.json
@@ -1,7 +1,7 @@
 {
  "$schema": "https://raw.githubusercontent.com/tauri-apps/tauri/dev/crates/tauri-config-schema/schema.json",
  "productName": "ClawPanel",
-  "version": "0.6.0",
+  "version": "0.7.0",
  "identifier": "ai.openclaw.clawpanel",
  "build": {
    "frontendDist": "../dist",