mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-21 09:28:14 +00:00
7a418346a4
发布分支的产物上出现了 `vcs.revision=1715b5c`——一个本机任何仓库都不存在的提交。 原因：VCS 信息**不进 build cache key**（Go 文档明确说明 VCS 变化不会触发重建）， 命中缓存时会把上一次的 revision 一并带回来。 而 build.sh 本来就用 ldflags 注入 meta.Version / meta.Commit（权威来源）， 所以这个额外信号既不可靠又会误导溯源：拿 `go version -m` 去查源码提交，会指向 一个幽灵提交——正是本项目一直在治的「静默不一致」。 处置：三处 go build 统一 `-buildvcs=false`，并在 LDFLAGS 旁写明溯源方法 （`strings homed | grep -x '<短 hash>'`，meta.Commit 是字符串常量）。 验证：重新构建 homed linux/amd64 → · `go version -m` 中 vcs.revision 0 处（此前 1 处且是错误值） · strings 中恰好 1 处等于当前 HEAD 短 hash · `-tags=onnxruntime` 仍在
288 lines
12 KiB
Bash
288 lines
12 KiB
Bash
#!/usr/bin/env bash
|
||
set -euo pipefail
|
||
|
||
# 本脚本位于 deploy/packaging/，故仓库根在上两级。
|
||
#
|
||
# v0.7.2 的根目录清理把 package/build.sh 移到 deploy/packaging/build.sh
|
||
# （深度 1 → 2 层），但这行的 ".." 没跟着改成 "../.."，于是 PROJECT_ROOT
|
||
# 变成了 <repo>/deploy：产物落进 deploy/build/、GUI 去找 deploy/cmd/gui。
|
||
# 跨平台构建从那次起一直是坏的（Makefile 的单平台 build 不走这里，所以没暴露）。
|
||
PROJECT_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
|
||
BUILD_DIR="${PROJECT_ROOT}/build"
|
||
VERSION="${VERSION:-$(git -C "$PROJECT_ROOT" describe --tags --dirty 2>/dev/null || echo "0.8.0")}"
|
||
COMMIT="${COMMIT:-$(git -C "$PROJECT_ROOT" rev-parse --short HEAD 2>/dev/null || echo "unknown")}"
|
||
BUILD_TIME="${BUILD_TIME:-$(date -u '+%Y-%m-%dT%H:%M:%SZ')}"
|
||
GO="${GO:-$(command -v go 2>/dev/null || echo "go")}"
|
||
LDFLAGS="-X gitcode.com/JianFeeeee/HomeAgent/internal/meta.Version=${VERSION} -X gitcode.com/JianFeeeee/HomeAgent/internal/meta.Commit=${COMMIT} -X gitcode.com/JianFeeeee/HomeAgent/internal/meta.BuildTime=${BUILD_TIME}"
|
||
|
||
# 版本与提交的**权威来源**是上面注入的 meta.Version / meta.Commit，不是 Go 自带的
|
||
# VCS 戳。后者不进 build cache key（Go 文档明确说明 VCS 变化不会触发重建），
|
||
# 命中缓存时会把上一次的 revision 一并带回来——实测发布分支的产物上就出现了
|
||
# 1715b5c（本机任何仓库都不存在的提交），用 `go version -m` 溯源会指向幽灵提交。
|
||
# 统一 -buildvcs=false：宁可没有这个信号，也不要一个错的。
|
||
# 溯源请用：`strings homed | grep -m1 '^<短 hash>$'`（meta.Commit 是字符串常量）。
|
||
|
||
TARGET="${1:-native}"
|
||
COMPONENT="${2:-all}"
|
||
|
||
# ---- platform matrix ----
|
||
# homed: linux/amd64 + linux/arm64 (CGO), macOS native-only (no osxcross),
|
||
# windows/amd64 (MinGW)
|
||
# waiter: all platforms (CGO-free, raw terminal mode is a no-op on non-Linux)
|
||
# gui: electron-builder handles cross-platform natively
|
||
|
||
case "$TARGET" in
|
||
native) GOOS="" GOARCH="" ;;
|
||
linux/amd64) GOOS=linux GOARCH=amd64 CC="${CC:-}" ;;
|
||
# arm64 必须同时给 CXX：gojieba 是 C++，缺 CXX 时 cgo 用宿主 g++ 编出
|
||
# x86-64 的 .o，链接时报 "Relocations in generic ELF (EM: 183)"（183 = aarch64）。
|
||
#
|
||
# 此处曾有一条注释写着「arm64 刻意不设 CXX」，理由是设了会报
|
||
# "file format not recognized"。那个判断是错的：那个报错的真因是
|
||
# cmd/{homed,waiter}/*.syso（x86-64 COFF Windows 资源对象）被链进了目标，
|
||
# 与 CXX 无关。四组对照：
|
||
# syso 在 + 无 CXX → Relocations in generic ELF (EM: 183)
|
||
# syso 在 + 有 CXX → 000000.o: file format not recognized
|
||
# syso 隐藏 + 无 CXX → Relocations in generic ELF (EM: 183)
|
||
# syso 隐藏 + 有 CXX → 成功，ELF aarch64
|
||
# 本脚本的 hide_syso_for_target 已处理前一个条件，这里补上后一个。
|
||
linux/arm64) GOOS=linux GOARCH=arm64 CC="${CC:-aarch64-linux-gnu-gcc}" CXX="${CXX:-aarch64-linux-gnu-g++}" ;;
|
||
darwin/amd64) GOOS=darwin GOARCH=amd64 CC="${CC:-}" ;;
|
||
darwin/arm64) GOOS=darwin GOARCH=arm64 CC="${CC:-}" ;;
|
||
# Windows 必须同时给 CXX：gojieba 是 C++，缺 CXX 时 cgo 回退到宿主 g++，
|
||
# 而宿主 g++ 不认 mingw 的 -mthreads，报 unrecognized command-line option。
|
||
windows/amd64) GOOS=windows GOARCH=amd64 CC="${CC:-x86_64-w64-mingw32-gcc}" CXX="${CXX:-x86_64-w64-mingw32-g++}" ;;
|
||
all)
|
||
"$0" linux/amd64 "$COMPONENT"
|
||
"$0" linux/arm64 "$COMPONENT"
|
||
"$0" darwin/amd64 "$COMPONENT"
|
||
"$0" darwin/arm64 "$COMPONENT"
|
||
"$0" windows/amd64 "$COMPONENT"
|
||
exit 0
|
||
;;
|
||
*)
|
||
echo "Unknown target: $TARGET"
|
||
echo "Usage: $0 [native|linux/amd64|linux/arm64|darwin/amd64|darwin/arm64|windows/amd64|all] [all|homed|waiter|initconfig|gui|payload]"
|
||
echo " [all|homed|waiter|initconfig|gui]"
|
||
exit 1
|
||
esac
|
||
|
||
if [ -n "${GOOS:-}" ]; then
|
||
SUFFIX="${GOOS}_${GOARCH}"
|
||
export GOOS GOARCH
|
||
fi
|
||
if [ -n "${CC:-}" ]; then
|
||
export CC
|
||
fi
|
||
if [ -n "${CXX:-}" ]; then
|
||
export CXX
|
||
fi
|
||
export CGO_ENABLED="${CGO_ENABLED:-1}"
|
||
|
||
mkdir -p "$BUILD_DIR"
|
||
|
||
# ---- .syso 隔离 ----
|
||
#
|
||
# cmd/{homed,waiter}/*.syso 是 Windows 资源对象（COFF，含图标/版本信息）。
|
||
# Go 会把同目录的 .syso 无条件链进任何目标，于是交叉编译到非 Windows 平台时：
|
||
# - linux/arm64、darwin/arm64 报 "unknown ARM64 relocation type 3"
|
||
# - 其他架构报 "file format not recognized"
|
||
# package-linux.sh 有 hide_syso()，但直接调本脚本时没有那层保护——
|
||
# 这正是 arm64 产物长期缺失的原因（曾被误判为缺 g++ 交叉编译器）。
|
||
SYSO_HIDDEN=()
|
||
hide_syso_for_target() {
|
||
[ "${GOOS:-}" = "windows" ] && return 0
|
||
local f
|
||
for f in "$PROJECT_ROOT"/cmd/homed/*.syso "$PROJECT_ROOT"/cmd/waiter/*.syso; do
|
||
[ -f "$f" ] || continue
|
||
mv "$f" "$f.hidden"
|
||
SYSO_HIDDEN+=("$f")
|
||
done
|
||
}
|
||
restore_syso_for_target() {
|
||
local f
|
||
for f in "${SYSO_HIDDEN[@]:-}"; do
|
||
[ -n "$f" ] && [ -f "$f.hidden" ] && mv "$f.hidden" "$f"
|
||
done
|
||
SYSO_HIDDEN=()
|
||
}
|
||
trap restore_syso_for_target EXIT
|
||
hide_syso_for_target
|
||
|
||
# ---- homed (CGO, sqlite3) ----
|
||
build_homed() {
|
||
local out="$BUILD_DIR/homed${SUFFIX:+_$SUFFIX}"
|
||
local plat="${GOOS:-linux}/${GOARCH:-amd64}"
|
||
|
||
if [ "$GOOS" = "darwin" ] && [ "${CC:-}" = "" ] && [ "$(uname)" != "Darwin" ]; then
|
||
echo "[SKIP] homed ${plat} — requires native macOS build (CGO + sqlite3, no osxcross)"
|
||
return
|
||
fi
|
||
if [ "$GOOS" = "windows" ]; then
|
||
out="${out}.exe"
|
||
fi
|
||
echo "[BUILD] homed ${plat} → $out"
|
||
# Go 用 CC 驱动 CGO 编译与链接，用 CC 指定的交叉工具链来决定目标架构。
|
||
# 必须同时 export CC 给 Go 的 CGO 代码生成器，否则 CGO_ENABLED=1 下的
|
||
# 目标文件与 host 的 ld 不兼容（如 arm64 的 .o 给了 x86_64 的 ld）。
|
||
#
|
||
# HOMED_TAGS 默认带 onnxruntime：发行版**默认启用**本地向量空间。
|
||
# 不带这个标签时 providers/chineseclip 与 providers/qwen3vl 仍会注册，
|
||
# 但打开时报「requires build tag」并优雅降级（不静默假装成功）。
|
||
# 需要极简构建时可显式 HOMED_TAGS= 关掉。
|
||
#
|
||
# 运行期还需要 libonnxruntime.so（provider 按 /opt/onnxruntime、
|
||
# /usr/local/lib、/usr/lib 顺序查找）；缺失时同样是「日志里的明确错误 +
|
||
# 降级」，不会假装启用。
|
||
local _cc="${CC:-cc}"
|
||
local _tags="${HOMED_TAGS-onnxruntime}"
|
||
local -a _tagargs=()
|
||
if [ -n "$_tags" ]; then _tagargs=(-tags "$_tags"); fi
|
||
CGO_ENABLED=1 CC="$_cc" "$GO" build -buildvcs=false -trimpath -installsuffix dynlink \
|
||
${_tagargs[@]+"${_tagargs[@]}"} \
|
||
-ldflags "$LDFLAGS" -o "$out" ./cmd/homed/
|
||
echo " OK ($(file "$out" | sed 's/.*: //') | $(du -h "$out" | cut -f1))"
|
||
}
|
||
|
||
# ---- waiter (cross-platform, CGO-free) ----
|
||
build_waiter() {
|
||
local plat="${GOOS:-linux}/${GOARCH:-amd64}"
|
||
local out="$BUILD_DIR/waiter${SUFFIX:+_$SUFFIX}"
|
||
if [ "$GOOS" = "windows" ]; then out="${out}.exe"; fi
|
||
|
||
echo "[BUILD] waiter ${plat} → $out"
|
||
CGO_ENABLED=0 "$GO" build -buildvcs=false -trimpath -installsuffix dynlink \
|
||
-ldflags "$LDFLAGS" -o "$out" ./cmd/waiter/
|
||
echo " OK ($(du -h "$out" | cut -f1))"
|
||
}
|
||
|
||
# ---- initconfig（必须 cgo：写 config.db 用的是 go-sqlite3）----
|
||
#
|
||
# 这里**必须** CGO_ENABLED=1。此前写的是 CGO_ENABLED=0，而 cmd/initconfig 通过
|
||
# database/sql 使用 mattn/go-sqlite3：CGO_ENABLED=0 时该库退化成 static_mock.go
|
||
# 里的桩，sql.Open 是懒的所以不报错、第一次 Exec 才失败；而 main.go 当时忽略
|
||
# 了所有错误——于是 initconfig 打印凭据、退出码 0、一个字节都没写进 config.db。
|
||
# 安装脚本把这份凭据写进 credentials.txt，用户照它登录必然失败，全程无报错。
|
||
#
|
||
# NSIS 安装包（installer.nsi）与 package-linux.sh 的 stage_variant 都引用它，
|
||
# 但此前 build.sh 从不构建它——Windows 安装包构建会直接失败在缺文件上。
|
||
build_initconfig() {
|
||
local plat="${GOOS:-linux}/${GOARCH:-amd64}"
|
||
local out="$BUILD_DIR/initconfig${SUFFIX:+_$SUFFIX}"
|
||
if [ "$GOOS" = "windows" ]; then out="${out}.exe"; fi
|
||
|
||
echo "[BUILD] initconfig ${plat} → $out"
|
||
CGO_ENABLED=1 "$GO" build -buildvcs=false -trimpath -installsuffix dynlink \
|
||
-ldflags "$LDFLAGS" -o "$out" ./cmd/initconfig/
|
||
echo " OK ($(du -h "$out" | cut -f1))"
|
||
}
|
||
|
||
# ---- linux-payload（给 Windows 安装器用的 Linux 包）----
|
||
#
|
||
# Windows 不再安装 homed.exe：homed 依赖 fd 继承 + 统一共享内存区的段内偏移
|
||
# 解引用，Windows 句柄模型无法表达（见 cmd/homed/platform_windows.go）。
|
||
# Windows 安装器改为引导到 WSL2，并把 **Linux 包**送进发行版里安装。
|
||
# 因此 Windows 安装包必须带上 Linux 产物——这一段就是把它暂存到
|
||
# build/linux-payload/（installer.nsi 从这里 File /r 打进安装包）。
|
||
#
|
||
# 复用 package-linux.sh 的产物，而不是在这里另行编译：WSL 里跑的就是普通
|
||
# linux/amd64，安装内容必须与 Linux 原生安装**完全一致**，否则又变成两个平台。
|
||
stage_linux_payload() {
|
||
local src="$PROJECT_ROOT/dist/linux"
|
||
local out="$BUILD_DIR/linux-payload"
|
||
|
||
rm -rf "$out"
|
||
mkdir -p "$out"
|
||
|
||
local found=0
|
||
for f in "$src"/*.deb "$src"/*.tar.gz; do
|
||
[ -f "$f" ] || continue
|
||
cp "$f" "$out/"
|
||
found=$((found + 1))
|
||
done
|
||
|
||
if [ "$found" -eq 0 ]; then
|
||
echo "[FAIL] build/linux-payload 为空：先运行 package-linux.sh 产出 dist/linux/*.deb|*.tar.gz" >&2
|
||
echo " （Windows 安装器会把这里的包送进 WSL 安装；空包等于装不上）" >&2
|
||
return 1
|
||
fi
|
||
echo "[BUILD] linux-payload ← $found 个包"
|
||
ls -1 "$out" | sed 's/^/ /'
|
||
}
|
||
|
||
# ---- gui (Electron) ----
|
||
#
|
||
# 输出目录必须用 --config.directories.output，**不能用 -o**：
|
||
# electron-builder 的 `-o` 是 `--mac`/`--macos` 的短别名（见 --help 的 Building 段），
|
||
# 不是 output。此前 `-o "$BUILD_DIR"` 被当成 macOS 的 target 列表，报
|
||
# ⨯ Unknown target: /home/program/trueagent/build
|
||
# （路径被 lowercase 后去匹配 target 名表，所以错误信息里的路径是全小写的，
|
||
# 这也是它看起来像「路径错」而实际是「参数位置错」的原因）。
|
||
# v1.0.1 与 v1.0.3 两次发布都因此手工组装过 GUI。
|
||
build_gui() {
|
||
if [ -n "${GOOS:-}" ] && [ "$GOOS" != "$("$GO" env GOOS)" ]; then
|
||
echo "[SKIP] gui ${GOOS}/${GOARCH} — electron-builder handles cross-platform natively; run 'all' on CI host"
|
||
return
|
||
fi
|
||
|
||
local gui_dir="$PROJECT_ROOT/cmd/gui"
|
||
echo "[BUILD] gui → $BUILD_DIR/"
|
||
|
||
if [ ! -d "$gui_dir/node_modules" ]; then
|
||
echo " npm install..."
|
||
(cd "$gui_dir" && npm install --production)
|
||
fi
|
||
|
||
# 不传 --config：electron-builder 默认从 package.json 的 "build" 键读配置。
|
||
# 传 --config package.json 会让它把**整个** package.json 当配置校验，
|
||
# 于是 devDependencies / build / scripts 全被判为 "unknown property" 而失败。
|
||
#
|
||
# GUI 失败不中断整体构建：homed/waiter/initconfig 是发布的主体，
|
||
# 而 GUI 依赖 electron 运行时下载（离线机器、arm64 缺缓存都会失败）。
|
||
# set -e 下若不接住，一个可选组件会让整轮跨平台构建全废。
|
||
if (cd "$gui_dir" && npx electron-builder \
|
||
--linux --win --mac \
|
||
--x64 --arm64 \
|
||
-p never \
|
||
--config.directories.output="$BUILD_DIR"); then
|
||
echo " OK"
|
||
else
|
||
echo " WARN: gui 构建失败（可选组件，不影响 homed/waiter/initconfig）"
|
||
echo " Linux 包可用 deploy/packaging/package-linux.sh 内置的手工组装路径"
|
||
return 0
|
||
fi
|
||
}
|
||
|
||
# ---- dispatch ----
|
||
if [ "${GOOS:-}" = "windows" ]; then
|
||
# Windows 目标：构建的**不是** homed——它已放弃 Windows 原生支持。
|
||
# 需要的是：Linux 包（送进 WSL 安装）+ Windows 侧客户端（waiter CLI / GUI）。
|
||
case "$COMPONENT" in
|
||
all) build_waiter; stage_linux_payload; build_gui ;;
|
||
waiter) build_waiter ;;
|
||
payload) stage_linux_payload ;;
|
||
gui) build_gui ;;
|
||
homed|initconfig)
|
||
echo "homed/initconfig 不再提供 Windows 原生构建：请用 WSL2（或用 linux/amd64 目标）。" >&2
|
||
echo "原因见 cmd/homed/platform_windows.go。" >&2
|
||
exit 1
|
||
;;
|
||
*)
|
||
echo "Unknown component: $COMPONENT"
|
||
exit 1
|
||
;;
|
||
esac
|
||
else
|
||
case "$COMPONENT" in
|
||
all) build_homed; build_waiter; build_initconfig; build_gui ;;
|
||
homed) build_homed ;;
|
||
waiter) build_waiter ;;
|
||
initconfig) build_initconfig ;;
|
||
gui) build_gui ;;
|
||
*)
|
||
echo "Unknown component: $COMPONENT"
|
||
exit 1
|
||
;;
|
||
esac
|
||
fi
|