#!/usr/bin/env bash set -euo pipefail # 本脚本位于 deploy/packaging/,故仓库根在上两级。 # # v0.7.2 的根目录清理把 package/build.sh 移到 deploy/packaging/build.sh # (深度 1 → 2 层),但这行的 ".." 没跟着改成 "../..",于是 PROJECT_ROOT # 变成了 /deploy:产物落进 deploy/build/、GUI 去找 deploy/cmd/gui。 # 跨平台构建从那次起一直是坏的(Makefile 的单平台 build 不走这里,所以没暴露)。 PROJECT_ROOT="$(cd "$(dirname "$0")/../.." && pwd)" BUILD_DIR="${PROJECT_ROOT}/build" # ★★ VERSION 必须是**语义化版本**(x.y.z),不能是 git describe 的原样输出。 # # 2026-10-17 实测事故:当前分支没有 tag,`git describe` 回退成分支名 # backup/pre-identity-rewrite-20261005-51-g03d87a4e-dirty # 它被注入 meta.Version ⇒ 插件握手的主版本判据变成 # MajorVersion("backup/pre-...") = 整个字符串(没有 '.' 可截) # 而插件端是 "4" ⇒ **所有子进程插件握手失败**: # proc: xxx.handshake: 主版本不匹配(内核 backup/pre-...,插件 SDK 1.4.0) # 内核自己是活的,但 40 个插件一个都起不来 —— 看起来像"插件全坏了"。 # # 权威来源是 internal/meta/meta.go 的 Version 常量(发版时人工确认)。 # git describe 只在**形如 vX.Y.Z-...** 时才可用(那说明确实在 tag 之后)。 _meta_version() { local mv mv="$(sed -n 's/^[[:space:]]*Version[[:space:]]*=[[:space:]]*"\([^"]*\)".*/\1/p' \ "$PROJECT_ROOT/internal/meta/meta.go" 2>/dev/null | head -1)" case "$mv" in [0-9]*.[0-9]*.[0-9]*) printf '%s' "$mv"; return 0 ;; esac return 1 } if [ -z "${VERSION:-}" ]; then _gd="$(git -C "$PROJECT_ROOT" describe --tags --dirty 2>/dev/null || true)" case "$_gd" in v[0-9]*.[0-9]*.[0-9]*) VERSION="${_gd#v}" ;; *) # ★ 不是 tag 描述 ⇒ 拒绝用它。退回 meta.Version(当前分支的权威版本)。 if VERSION="$(_meta_version)"; then [ -n "$_gd" ] && echo "[BUILD] warn: git describe 给出非版本串($_gd),改用 meta.Version=$VERSION" >&2 else echo "[BUILD] ERROR: 拿不到合法版本号(git describe=$_gd,meta.Version 也读不出)。" >&2 echo " 请显式传 VERSION=x.y.z 后重试。" >&2 exit 1 fi ;; esac fi # 最终守卫:非 x.y.z 一律拒绝构建(否则会打出一个"插件全部握手失败"的包) case "$VERSION" in [0-9]*.[0-9]*.[0-9]*) ;; *) echo "[BUILD] ERROR: VERSION='$VERSION' 不是语义化版本 x.y.z;" \ "它会被当作插件协议主版本,导致所有子进程插件握手失败。" >&2 exit 1 ;; esac 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")}" # ★★ 模块路径必须是**当前**的 github.com/...,不能是历史的 gitcode.com/... # # `-X` 的包路径写错时 Go **不报错、静默忽略** ⇒ 注入的值保持源码默认 # (Commit/BuildTime 变成字面量 "unknown",Version 变成源码里的版本号)。 # 构建日志全绿,只有 `binary --version` 才能看出来 —— 于是发行包带着 # 错的溯源信息发出去。 # # 实测(2026-10-17):用旧路径构建 waiter,`--version` 输出 # `waiter 1.4.0 (commit unknown, built unknown)` # 而正确路径得到注入的值。 LDFLAGS="-X github.com/JianFeeeee/HomeAgent/internal/meta.Version=${VERSION} -X github.com/JianFeeeee/HomeAgent/internal/meta.Commit=${COMMIT} -X github.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 # ★★ homed 必须与**它自己的**启动依赖图一起产出(2026-10-17 实测缺陷)。 # # 内核启动时比对「磁盘图 digest」vs「二进制内嵌 digest」,不一致或读不到 # ⇒ **拒绝启动**(退出码 1)。本脚本原先既不生成图也不注入 digest # ⇒ 用 `deploy/packaging/build.sh` 打出的 homed 装到机器上**起不来**: # kernelboot: 生产构建(内嵌 hash 非空)但读不到依赖图 … # # 注意这与 Makefile 是**两条独立构建路径**:只修 Makefile 不够。 # 图必须由**同一次构建**产出(digest 一一对应),不能复用别的版本的图。 local _graphgen="$BUILD_DIR/homed-depgraph${SUFFIX:+_$SUFFIX}" echo " [graph] 生成启动依赖图(编译期定序)..." CGO_ENABLED=1 CC="$_cc" "$GO" build ${_tagargs[@]+"${_tagargs[@]}"} \ -o "$_graphgen" ./cmd/homed-depgraph/ local _graph_hash _graph_hash="$("$_graphgen" -digest)" "$_graphgen" -out "$BUILD_DIR/depgraph.bin" echo " [graph] digest=$_graph_hash" CGO_ENABLED=1 CC="$_cc" "$GO" build -buildvcs=false -trimpath -installsuffix dynlink \ ${_tagargs[@]+"${_tagargs[@]}"} \ -ldflags "$LDFLAGS -X github.com/JianFeeeee/HomeAgent/internal/kernelboot.EmbeddedGraphHash=$_graph_hash" -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_DIR}/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