@lobehub/lobehub 2.0.0-next.291 → 2.0.0-next.292

package/apps/desktop/scripts/update-test/README.md

@@ -0,0 +1,222 @@
+# 本地更新测试指南
+
+本目录包含用于在本地测试 Desktop 应用更新功能的工具和脚本。
+
+## 目录结构
+
+```
+scripts/update-test/
+├── README.md                    # 本文档
+├── setup.sh                     # 一键设置脚本
+├── start-server.sh              # 启动本地更新服务器
+├── stop-server.sh               # 停止本地更新服务器
+├── generate-manifest.sh         # 生成 manifest 和目录结构
+├── dev-app-update.local.yml     # 本地测试用的更新配置模板
+└── server/                      # 本地服务器文件目录 (自动生成)
+    ├── stable/                  # stable 渠道
+    │   ├── latest-mac.yml
+    │   └── {version}/
+    │       ├── xxx.dmg
+    │       └── xxx.zip
+    ├── beta/                    # beta 渠道
+    │   └── ...
+    └── nightly/                 # nightly 渠道
+        └── ...
+```
+
+## 快速开始
+
+### 1. 首次设置
+
+```bash
+cd apps/desktop/scripts/update-test
+chmod +x *.sh
+./setup.sh
+```
+
+### 2. 构建测试包
+
+```bash
+# 回到 desktop 目录
+cd ../..
+
+# 构建未签名的本地测试包
+bun run build
+bun run build-local
+```
+
+### 3. 生成更新文件
+
+```bash
+cd scripts/update-test
+
+# 从 release 目录自动检测并生成 (默认 stable 渠道)
+./generate-manifest.sh --from-release
+
+# 指定版本号 (用于模拟更新)
+./generate-manifest.sh --from-release -v 0.0.1
+
+# 指定渠道
+./generate-manifest.sh --from-release -c beta -v 2.1.0-beta.1
+```
+
+### 4. 启动本地服务器
+
+```bash
+./start-server.sh
+# 服务器默认在 http://localhost:8787 启动
+```
+
+### 5. 配置应用使用本地服务器
+
+```bash
+# 复制本地测试配置到 desktop 根目录
+cp dev-app-update.local.yml ../../dev-app-update.yml
+
+# 或者直接编辑 dev-app-update.yml，确保 URL 指向正确的渠道:
+# url: http://localhost:8787/stable
+```
+
+### 6. 运行应用测试
+
+```bash
+cd ../..
+bun run dev
+```
+
+### 7. 测试完成后
+
+```bash
+cd scripts/update-test
+./stop-server.sh
+
+# 恢复默认的 dev-app-update.yml（可选）
+cd ../..
+git checkout dev-app-update.yml
+```
+
+---
+
+## generate-manifest.sh 用法
+
+```bash
+用法: ./generate-manifest.sh [选项]
+
+选项:
+  -v, --version VERSION    指定版本号 (例如: 2.0.1)
+  -c, --channel CHANNEL    指定渠道 (stable|beta|nightly, 默认: stable)
+  -d, --dmg FILE           指定 DMG 文件名
+  -z, --zip FILE           指定 ZIP 文件名
+  -n, --notes TEXT         指定 release notes
+  -f, --from-release       从 release 目录自动复制文件
+  -h, --help               显示帮助信息
+
+示例:
+  ./generate-manifest.sh --from-release
+  ./generate-manifest.sh -v 2.0.1 -c stable --from-release
+  ./generate-manifest.sh -v 2.1.0-beta.1 -c beta --from-release
+```
+
+---
+
+## 详细说明
+
+### 关于 macOS 签名验证
+
+本地测试的包未经签名和公证，macOS 会阻止运行。解决方法：
+
+#### 方法 1：临时禁用 Gatekeeper（推荐）
+
+```bash
+# 禁用
+sudo spctl --master-disable
+
+# 测试完成后务必重新启用！
+sudo spctl --master-enable
+```
+
+#### 方法 2：手动移除隔离属性
+
+```bash
+# 对下载的 DMG 或解压后的 .app 执行
+xattr -cr /path/to/YourApp.app
+```
+
+#### 方法 3：系统偏好设置
+
+1. 打开「系统偏好设置」→「安全性与隐私」→「通用」
+2. 点击「仍要打开」允许未签名的应用
+
+### 自定义 Release Notes
+
+编辑 `server/{channel}/latest-mac.yml` 中的 `releaseNotes` 字段：
+
+```yaml
+releaseNotes: |
+  ## 🎉 v2.0.1 测试版本
+
+  ### ✨ 新功能
+  - 功能 A
+  - 功能 B
+
+  ### 🐛 修复
+  - 修复问题 X
+```
+
+### 测试不同场景
+
+| 场景         | 操作                                                  |
+| ------------ | ----------------------------------------------------- |
+| 有新版本可用 | 设置 manifest 中的 `version` 大于当前应用版本 (0.0.0) |
+| 无新版本     | 设置 `version` 小于或等于当前版本                     |
+| 下载失败     | 删除 server/{channel}/{version}/ 中的 DMG 文件        |
+| 网络错误     | 停止本地服务器                                        |
+| 测试不同渠道 | 修改 dev-app-update.yml 中的 URL 指向不同渠道         |
+
+### 环境变量
+
+也可以通过环境变量指定更新服务器：
+
+```bash
+UPDATE_SERVER_URL=http://localhost:8787/stable bun run dev
+```
+
+---
+
+## 故障排除
+
+### 1. 服务器启动失败
+
+```bash
+# 检查端口是否被占用
+lsof -i :8787
+
+# 使用其他端口
+PORT=9000 ./start-server.sh
+```
+
+### 2. 更新检测不到
+
+- 确认 `dev-app-update.yml` 中的 URL 包含渠道路径 (如 `/stable`)
+- 确认 manifest 中的版本号大于当前版本 (0.0.0)
+- 查看日志：`tail -f ~/Library/Logs/lobehub-desktop-dev/main.log`
+
+### 3. 请求了错误的 yml 文件
+
+- 如果请求的是 `stable-mac.yml` 而不是 `latest-mac.yml`，说明代码中设置了 channel
+- 确保在 dev 模式下运行，代码不会设置 `autoUpdater.channel`
+
+### 4. 下载后无法安装
+
+- 确认已禁用 Gatekeeper 或移除隔离属性
+- 确认 DMG 文件完整
+
+---
+
+## 注意事项
+
+⚠️ **安全提醒**：
+
+1. 测试完成后务必重新启用 Gatekeeper
+2. 这些脚本仅用于本地开发测试
+3. 不要将未签名的包分发给其他用户

package/apps/desktop/scripts/update-test/dev-app-update.local.yml

@@ -0,0 +1,18 @@
+# 本地更新测试配置
+# 将此文件复制到 apps/desktop/dev-app-update.yml 以使用本地服务器测试
+#
+# 使用方法:
+#   cp scripts/update-test/dev-app-update.local.yml dev-app-update.yml
+#
+# 恢复默认配置:
+#   git checkout dev-app-update.yml
+
+provider: generic
+# URL 格式: http://localhost:8787/{channel}
+# 可选渠道: stable, beta, nightly
+url: http://localhost:8787/stable
+updaterCacheDirName: lobehub-desktop-local-test
+
+# 设置 channel 为 stable 以匹配生产环境行为
+# stable channel 会找 stable-mac.yml
+channel: stable

package/apps/desktop/scripts/update-test/generate-manifest.sh

@@ -0,0 +1,277 @@
+#!/bin/bash
+
+# ============================================
+# 生成更新 manifest 文件 ({channel}-mac.yml)
+#
+# 目录结构:
+#   server/
+#     {channel}/
+#       {channel}-mac.yml  (e.g., stable-mac.yml)
+#       {version}/
+#         xxx.dmg
+#         xxx.zip
+# ============================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SERVER_DIR="$SCRIPT_DIR/server"
+DESKTOP_DIR="$(dirname "$(dirname "$SCRIPT_DIR")")"
+RELEASE_DIR="$DESKTOP_DIR/release"
+
+# 默认值
+VERSION=""
+CHANNEL="stable"
+DMG_FILE=""
+ZIP_FILE=""
+RELEASE_NOTES=""
+FROM_RELEASE=false
+
+# 帮助信息
+show_help() {
+    echo "用法: $0 [选项]"
+    echo ""
+    echo "选项:"
+    echo "  -v, --version VERSION    指定版本号 (例如: 2.0.1)"
+    echo "  -c, --channel CHANNEL    指定渠道 (stable|beta|nightly, 默认: stable)"
+    echo "  -d, --dmg FILE           指定 DMG 文件名"
+    echo "  -z, --zip FILE           指定 ZIP 文件名"
+    echo "  -n, --notes TEXT         指定 release notes"
+    echo "  -f, --from-release       从 release 目录自动复制文件"
+    echo "  -h, --help               显示帮助信息"
+    echo ""
+    echo "示例:"
+    echo "  $0 --from-release"
+    echo "  $0 -v 2.0.1 -c stable -d LobeHub-2.0.1-arm64.dmg"
+    echo "  $0 -v 2.1.0-beta.1 -c beta --from-release"
+    echo ""
+    echo "生成的目录结构:"
+    echo "  server/"
+    echo "    {channel}/"
+    echo "      {channel}-mac.yml  (e.g., stable-mac.yml)"
+    echo "      {version}/"
+    echo "        xxx.dmg"
+    echo "        xxx.zip"
+    echo ""
+}
+
+# 计算 SHA512
+calc_sha512() {
+    local file="$1"
+    if [ -f "$file" ]; then
+        shasum -a 512 "$file" | awk '{print $1}' | xxd -r -p | base64
+    else
+        echo "placeholder-sha512-file-not-found"
+    fi
+}
+
+# 获取文件大小
+get_file_size() {
+    local file="$1"
+    if [ -f "$file" ]; then
+        stat -f%z "$file" 2>/dev/null || stat --printf="%s" "$file" 2>/dev/null || echo "0"
+    else
+        echo "0"
+    fi
+}
+
+# 解析参数
+FROM_RELEASE=false
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -v|--version)
+            VERSION="$2"
+            shift 2
+            ;;
+        -c|--channel)
+            CHANNEL="$2"
+            shift 2
+            ;;
+        -d|--dmg)
+            DMG_FILE="$2"
+            shift 2
+            ;;
+        -z|--zip)
+            ZIP_FILE="$2"
+            shift 2
+            ;;
+        -n|--notes)
+            RELEASE_NOTES="$2"
+            shift 2
+            ;;
+        -f|--from-release)
+            FROM_RELEASE=true
+            shift
+            ;;
+        -h|--help)
+            show_help
+            exit 0
+            ;;
+        *)
+            echo "未知参数: $1"
+            show_help
+            exit 1
+            ;;
+    esac
+done
+
+echo "🔧 生成更新 manifest 文件..."
+echo "   渠道: $CHANNEL"
+echo ""
+
+# 渠道目录
+CHANNEL_DIR="$SERVER_DIR/$CHANNEL"
+
+# 自动从 release 目录检测和复制
+if [ "$FROM_RELEASE" = true ]; then
+    echo "📂 从 release 目录检测文件..."
+
+    if [ ! -d "$RELEASE_DIR" ]; then
+        echo "❌ release 目录不存在: $RELEASE_DIR"
+        echo "   请先运行构建命令"
+        exit 1
+    fi
+
+    # 查找 DMG 文件
+    DMG_PATH=$(find "$RELEASE_DIR" -maxdepth 1 -name "*.dmg" -type f | head -1)
+    if [ -n "$DMG_PATH" ]; then
+        DMG_FILE=$(basename "$DMG_PATH")
+        echo "   找到 DMG: $DMG_FILE"
+    fi
+
+    # 查找 ZIP 文件
+    ZIP_PATH=$(find "$RELEASE_DIR" -maxdepth 1 -name "*-mac.zip" -type f | head -1)
+    if [ -n "$ZIP_PATH" ]; then
+        ZIP_FILE=$(basename "$ZIP_PATH")
+        echo "   找到 ZIP: $ZIP_FILE"
+    fi
+
+    # 从文件名提取版本号
+    # 文件名格式: lobehub-desktop-dev-0.0.0-arm64.dmg
+    # 版本号格式: x.y.z 或 x.y.z-beta.1 等
+    if [ -z "$VERSION" ] && [ -n "$DMG_FILE" ]; then
+        # 先尝试匹配带预发布标签的版本 (如 2.0.0-beta.1)
+        VERSION=$(echo "$DMG_FILE" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+-(alpha|beta|rc|nightly)\.[0-9]+' | head -1)
+        # 如果没有预发布标签，只匹配基本版本号 (如 2.0.0)
+        if [ -z "$VERSION" ]; then
+            VERSION=$(echo "$DMG_FILE" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
+        fi
+    fi
+fi
+
+# 设置默认版本号
+if [ -z "$VERSION" ]; then
+    VERSION="0.0.1"
+    echo "⚠️  未指定版本号，使用默认值: $VERSION"
+fi
+
+# 版本目录
+VERSION_DIR="$CHANNEL_DIR/$VERSION"
+
+# 创建目录结构
+echo ""
+echo "📁 创建目录结构..."
+mkdir -p "$VERSION_DIR"
+echo "   $CHANNEL_DIR/"
+echo "     $VERSION/"
+
+# 复制文件到版本目录
+if [ "$FROM_RELEASE" = true ]; then
+    if [ -n "$DMG_PATH" ] && [ -f "$DMG_PATH" ]; then
+        echo "   复制 $DMG_FILE -> $VERSION/"
+        cp "$DMG_PATH" "$VERSION_DIR/"
+    fi
+
+    if [ -n "$ZIP_PATH" ] && [ -f "$ZIP_PATH" ]; then
+        echo "   复制 $ZIP_FILE -> $VERSION/"
+        cp "$ZIP_PATH" "$VERSION_DIR/"
+    fi
+fi
+
+# 设置默认 release notes
+if [ -z "$RELEASE_NOTES" ]; then
+    RELEASE_NOTES="## 🎉 v$VERSION 本地测试版本
+
+这是一个用于本地测试更新功能的模拟版本。
+
+### ✨ 新功能
+- 测试自动更新功能
+- 验证更新流程
+
+### 🐛 修复
+- 本地测试环境配置"
+fi
+
+# 生成 {channel}-mac.yml (e.g., stable-mac.yml)
+MANIFEST_FILE="$CHANNEL-mac.yml"
+echo ""
+echo "📝 生成 $CHANNEL/$MANIFEST_FILE..."
+
+DMG_SHA512=""
+DMG_SIZE="0"
+ZIP_SHA512=""
+ZIP_SIZE="0"
+
+if [ -n "$DMG_FILE" ] && [ -f "$VERSION_DIR/$DMG_FILE" ]; then
+    echo "   计算 DMG SHA512..."
+    DMG_SHA512=$(calc_sha512 "$VERSION_DIR/$DMG_FILE")
+    DMG_SIZE=$(get_file_size "$VERSION_DIR/$DMG_FILE")
+fi
+
+if [ -n "$ZIP_FILE" ] && [ -f "$VERSION_DIR/$ZIP_FILE" ]; then
+    echo "   计算 ZIP SHA512..."
+    ZIP_SHA512=$(calc_sha512 "$VERSION_DIR/$ZIP_FILE")
+    ZIP_SIZE=$(get_file_size "$VERSION_DIR/$ZIP_FILE")
+fi
+
+# 写入 manifest 文件 (放在渠道目录下)
+cat > "$CHANNEL_DIR/$MANIFEST_FILE" << EOF
+version: $VERSION
+files:
+EOF
+
+if [ -n "$DMG_FILE" ]; then
+cat >> "$CHANNEL_DIR/$MANIFEST_FILE" << EOF
+  - url: $VERSION/$DMG_FILE
+    sha512: ${DMG_SHA512:-placeholder}
+    size: $DMG_SIZE
+EOF
+fi
+
+if [ -n "$ZIP_FILE" ]; then
+cat >> "$CHANNEL_DIR/$MANIFEST_FILE" << EOF
+  - url: $VERSION/$ZIP_FILE
+    sha512: ${ZIP_SHA512:-placeholder}
+    size: $ZIP_SIZE
+EOF
+fi
+
+cat >> "$CHANNEL_DIR/$MANIFEST_FILE" << EOF
+path: $VERSION/${DMG_FILE:-LobeHub-$VERSION-arm64.dmg}
+sha512: ${DMG_SHA512:-placeholder}
+releaseDate: '$(date -u +"%Y-%m-%dT%H:%M:%S.000Z")'
+releaseNotes: |
+$(echo "$RELEASE_NOTES" | sed 's/^/  /')
+EOF
+
+echo "✅ 已生成 $CHANNEL_DIR/$MANIFEST_FILE"
+
+# 显示生成的文件内容
+echo ""
+echo "📋 文件内容:"
+echo "----------------------------------------"
+cat "$CHANNEL_DIR/$MANIFEST_FILE"
+echo "----------------------------------------"
+
+# 显示目录结构
+echo ""
+echo "📁 目录结构:"
+find "$CHANNEL_DIR" -type f | sed "s|$SERVER_DIR/||" | sort
+
+echo ""
+echo "✅ 完成！"
+echo ""
+echo "下一步:"
+echo "  1. 启动服务器: ./start-server.sh"
+echo "  2. 确认 dev-app-update.yml 的 URL 为: http://localhost:8787/$CHANNEL"
+echo "  3. 运行应用:   cd ../.. && bun run dev"

package/apps/desktop/scripts/update-test/run-test.sh

@@ -0,0 +1,105 @@
+#!/bin/bash
+
+# ============================================
+# 一键启动本地更新测试
+# ============================================
+#
+# 此脚本会:
+# 1. 设置测试环境
+# 2. 从 release 目录复制文件
+# 3. 生成 manifest
+# 4. 启动本地服务器
+# 5. 配置应用使用本地服务器
+# 6. 启动应用
+#
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+DESKTOP_DIR="$(dirname "$(dirname "$SCRIPT_DIR")")"
+
+echo "============================================"
+echo "🧪 本地更新测试 - 一键启动"
+echo "============================================"
+echo ""
+
+# 检查 macOS Gatekeeper 状态
+check_gatekeeper() {
+    if command -v spctl &> /dev/null; then
+        STATUS=$(spctl --status 2>&1 || true)
+        if [[ "$STATUS" == *"enabled"* ]]; then
+            echo "⚠️  警告: macOS Gatekeeper 已启用"
+            echo ""
+            echo "   未签名的应用可能无法安装。你可以:"
+            echo "   1. 临时禁用: sudo spctl --master-disable"
+            echo "   2. 或者在安装后手动允许应用"
+            echo ""
+            read -p "是否继续？[y/N] " -n 1 -r
+            echo ""
+            if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+                exit 1
+            fi
+        else
+            echo "✅ Gatekeeper 已禁用，可以安装未签名应用"
+        fi
+    fi
+}
+
+# 步骤 1: 设置
+echo "📦 步骤 1/5: 设置测试环境..."
+cd "$SCRIPT_DIR"
+chmod +x *.sh
+mkdir -p server
+
+# 步骤 2: 检查 release 目录
+echo ""
+echo "📂 步骤 2/5: 检查构建产物..."
+if [ ! -d "$DESKTOP_DIR/release" ] || [ -z "$(ls -A "$DESKTOP_DIR/release"/*.dmg 2>/dev/null)" ]; then
+    echo "❌ 未找到构建产物"
+    echo ""
+    echo "请先构建应用:"
+    echo "  cd $DESKTOP_DIR"
+    echo "  npm run build-local"
+    echo ""
+    exit 1
+fi
+
+# 步骤 3: 生成 manifest
+echo ""
+echo "📝 步骤 3/5: 生成 manifest 文件..."
+./generate-manifest.sh --from-release
+
+# 步骤 4: 启动服务器
+echo ""
+echo "🚀 步骤 4/5: 启动本地服务器..."
+./start-server.sh
+
+# 步骤 5: 配置并启动应用
+echo ""
+echo "⚙️  步骤 5/5: 配置应用..."
+cp "$SCRIPT_DIR/dev-app-update.local.yml" "$DESKTOP_DIR/dev-app-update.yml"
+echo "✅ 已更新 dev-app-update.yml"
+
+# 检查 Gatekeeper
+echo ""
+check_gatekeeper
+
+echo ""
+echo "============================================"
+echo "✅ 准备完成！"
+echo "============================================"
+echo ""
+echo "现在可以运行应用进行测试:"
+echo ""
+echo "  cd $DESKTOP_DIR"
+echo "  npm run dev"
+echo ""
+echo "或者直接运行:"
+read -p "是否现在启动应用？[Y/n] " -n 1 -r
+echo ""
+if [[ ! $REPLY =~ ^[Nn]$ ]]; then
+    echo ""
+    echo "🚀 启动应用..."
+    cd "$DESKTOP_DIR"
+    npm run dev
+fi