From 38f12ab1d8f96c790b8e791afa926c1551983114 Mon Sep 17 00:00:00 2001 From: thzxx Date: Wed, 8 Apr 2026 12:11:50 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=E6=9E=84=E5=BB=BA?= =?UTF-8?q?=E6=8C=87=E5=8D=97=EF=BC=8C=E8=A1=A5=E5=85=85=20v3.2.2=20?= =?UTF-8?q?=E6=9E=84=E5=BB=BA=E9=97=AE=E9=A2=98=E6=8E=92=E6=9F=A5=E4=B8=8E?= =?UTF-8?q?=E6=89=8B=E5=8A=A8=E7=BC=93=E5=AD=98=E6=96=B9=E6=A1=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/BUILD.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/docs/BUILD.md b/docs/BUILD.md index 596b949..264c999 100644 --- a/docs/BUILD.md +++ b/docs/BUILD.md @@ -126,8 +126,43 @@ curl -X POST "https://gitee.com/api/v5/repos/thzxx/metona-ollama/releases/$RELEA | apt 源 i386 架构下载失败 | 先确保主源可用（切 archive.ubuntu.com），再 `apt-get update`，最后装 wine | | Electron 下载超时 | 设 `ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/` 或直接用 `npm run dist`（electron-builder 自动处理） | | NSIS/winCodeSign 下载超时 | `GITHUB_PROXY=https://gh-proxy.com/ bash restore-build-cache.sh` | +| winCodeSign 下载 EOF 错误（github.com 连接中断） | 手动下载并缓存（见下方） | +| npm install 时 Electron "socket hang up" | 设置 `ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/` 后重试 | +| restore-build-cache.sh 因 Electron 失败导致后续缓存全部跳过 | 跳过脚本，手动下载缺失资源（见下方） | | "symbol already declared" | 检查 TS 文件中的重复 `const`/`let` 声明 | +### 手动下载构建缓存（逐项修复） + +当 `restore-build-cache.sh` 部分失败时，可手动下载缺失资源： + +```bash +GITHUB_PROXY="https://ghfast.top/" +GITHUB_ORIG="https://github.com/electron-userland/electron-builder-binaries/releases/download" +CACHE="$HOME/.cache/electron-builder" + +# winCodeSign（构建签名步骤硬依赖） +mkdir -p "$CACHE/winCodeSign" +wget -O "/tmp/winCodeSign-2.6.0.7z" \ + "${GITHUB_PROXY}${GITHUB_ORIG}/winCodeSign-2.6.0/winCodeSign-2.6.0.7z" +cd "$CACHE/winCodeSign" && 7z x -y "/tmp/winCodeSign-2.6.0.7z" -o"winCodeSign-2.6.0" + +# NSIS +mkdir -p "$CACHE/nsis" +wget -O "/tmp/nsis-3.0.4.1.7z" \ + "${GITHUB_PROXY}${GITHUB_ORIG}/nsis-3.0.4.1/nsis-3.0.4.1.7z" +cd "$CACHE/nsis" && 7z x -y "/tmp/nsis-3.0.4.1.7z" -o"nsis-3.0.4.1" + +# NSIS Resources +wget -O "/tmp/nsis-resources-3.4.1.7z" \ + "${GITHUB_PROXY}${GITHUB_ORIG}/nsis-resources-3.4.1/nsis-resources-3.4.1.7z" +cd "$CACHE/nsis" && 7z x -y "/tmp/nsis-resources-3.4.1.7z" -o"nsis-resources-3.4.1" + +# 清理临时文件 +rm -f /tmp/winCodeSign-2.6.0.7z /tmp/nsis-3.0.4.1.7z /tmp/nsis-resources-3.4.1.7z +``` + +> Electron 无需手动下载——设置 `ELECTRON_MIRROR` 后 electron-builder 会自动处理。 + ### ⚠️ 已知问题：npmmirror 与 restore-build-cache.sh 兼容性 `restore-build-cache.sh` 第一步从 npmmirror 下载 Electron zip 时可能遇到 **NoSuchKey** 错误，因为 npmmirror 未同步该版本。此时脚本会因 `set -e` 直接退出，后续 NSIS/winCodeSign 缓存也不会恢复。 @@ -140,6 +175,18 @@ electron-builder 会自动处理所有依赖下载（Electron、NSIS、winCodeSi ## 构建日志 +### v3.2.2（2026-04-08） — metona-ollama-desktop 仓库 + +- ✅ `Metona Ollama Setup 3.2.2.exe`（78MB） +- ✅ Gitee Release v3.2.2-desktop（ID: 600992，仓库 thzxx/metona-ollama-desktop） +- ✅ 分支 `metona-ollama-desktop-v3.2.2` 已创建并推送 +- ⚠️ 构建问题及处理： + 1. apt 源 `mirrors.cloud.aliyuncs.com` 不可达 → 切换 `archive.ubuntu.com` + 2. npm install 时 Electron socket hang up → 设 `ELECTRON_MIRROR` 重试成功 + 3. restore-build-cache.sh 第一步失败（npmmirror NoSuchKey）→ 跳过脚本 + 4. electron-builder 直接构建时 winCodeSign 从 GitHub 下载 EOF → 使用 ghfast.top 代理手动下载缓存 + 5. 手动缓存 NSIS 和 NSIS Resources 后重新构建成功 + ### v3.2.1（2026-04-07） — metona-ollama-desktop 仓库 - ✅ `Metona Ollama Setup 3.2.1.exe`（78MB）