diff --git a/.windsurf/workflows/release.md b/.windsurf/workflows/release.md index 1bf7350..1aee7a1 100644 --- 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 ``` diff --git a/CHANGELOG.md b/CHANGELOG.md index d7591e5..b7dd218 100644 --- 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) diff --git a/docs/index.html b/docs/index.html index 77b0898..1557d2d 100644 --- 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 @@
-
v0.6.0 最新版
+
v0.7.0 最新版

下载安装

选择你的操作系统，一键下载安装

@@ -982,11 +982,11 @@

macOS

支持 Apple Silicon 和 Intel 芯片

- + Apple Silicon (M1/M2/M3/M4) .dmg - + Intel 芯片 .dmg @@ -1004,11 +1004,11 @@

Windows

支持 Windows 10 及以上版本

- + 安装程序 .exe - + MSI 安装包 .msi @@ -1019,11 +1019,11 @@

Linux

支持主流 Linux 发行版

- + 通用版 .AppImage - + Debian / Ubuntu .deb diff --git a/package.json b/package.json index d37b1d5..b985efd 100644 --- 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", diff --git a/scripts/sync-version.js b/scripts/sync-version.js index 09e9c75..ecf8948 100644 --- 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 }, }, ] diff --git a/src-tauri/Cargo.lock b/src-tauri/Cargo.lock index dc85ec6..2108456 100644 --- 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", diff --git a/src-tauri/Cargo.toml b/src-tauri/Cargo.toml index d767e0d..e58869c 100644 --- 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"] diff --git a/src-tauri/tauri.conf.json b/src-tauri/tauri.conf.json index 9115425..e6ef69c 100644 --- 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",