mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-24 02:48:04 +00:00
README/架构文档仍在描述 C ABI 动态库加载,与 v1.0.0 实际实现不符。
新用户按文档走会去做 -buildmode=c-shared,产物新内核根本不加载。
README.md / README_EN.md:
- 设计要点补子进程架构段(三面通信、崩溃自愈、真热重载)
- 代码结构 plugin/ 描述:.so 动态加载器 → 子进程加载器
- 项目状态补 v1.0.0 条目(6 类缺陷 + 实测数字),v0.9.0 标注 ABI 已退场
- 新增「下载」章节:三变体对照 + 各平台包格式 + macOS 限制
assets/docs/{zh,en}/ARCHITECTURE.md:
- 四种加载方式表:外部 .so/C ABI → 外部子进程/握手+stdio JSON-RPC
- 加载流程改写为 exec.Command → 继承 fd → 握手 → init → start
- 内置 vs 外部对照表 7 行更新
- 新增「子进程插件的三个通信面」小节,含每个面的选择理由
assets/docs/{zh,en}/OVERVIEW.md:插件系统段落改写
deploy/ 发布脚本三处回归(v0.7.2 的 2c5f9ff 把 package/ 移到
deploy/packaging/ 使目录深度 1→2,但没改相对路径,此后两个版本
的发布都没有二进制资产):
- build.sh:.syso 按目标平台 hide/restore(trap 兜底),恢复
windows 目标的 CXX,arm64 刻意不带 CXX
- installer.nsi:5 处 ..\build → ..\..\build,PRODUCT_VERSION 可注入
(原先硬编码 0.8.0)
- homeagent.spec:server 变体补装 waiter(control-server 声明了 CLI 却没装)
deploy/scripts/upload_assets.py:release 资产上传(两步签名 URL → OBS
PUT)。放 deploy/scripts/ 而非 scripts/,因为后者在 .gitignore 里。
支持 GITCODE_REPO/ASSET_DIR 环境变量以复用于 SDK 仓。
183 lines
6.9 KiB
Bash
183 lines
6.9 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}"
|
||
|
||
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:设了会让 Go 用 aarch64 的 g++ 去链接,
|
||
# 而它对 host 产生的 .o 报 "file format not recognized"。
|
||
# gojieba 的 C++ 源仍由 CC 对应的 gcc 驱动编译(gcc 能编 C++)。
|
||
linux/arm64) GOOS=linux GOARCH=arm64 CC="${CC:-aarch64-linux-gnu-gcc}" ;;
|
||
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]"
|
||
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)。
|
||
local _cc="${CC:-cc}"
|
||
CGO_ENABLED=1 CC="$_cc" "$GO" build -trimpath -installsuffix dynlink \
|
||
-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 -trimpath -installsuffix dynlink \
|
||
-ldflags "$LDFLAGS" -o "$out" ./cmd/waiter/
|
||
echo " OK ($(du -h "$out" | cut -f1))"
|
||
}
|
||
|
||
# ---- initconfig (CGO-free 配置初始化器) ----
|
||
#
|
||
# NSIS 安装包(installer.nsi:220 File "..\build\initconfig.exe")与
|
||
# 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=0 "$GO" build -trimpath -installsuffix dynlink \
|
||
-ldflags "$LDFLAGS" -o "$out" ./cmd/initconfig/
|
||
echo " OK ($(du -h "$out" | cut -f1))"
|
||
}
|
||
|
||
# ---- gui (Electron) ----
|
||
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" 而失败。
|
||
(cd "$gui_dir" && npx electron-builder \
|
||
--linux --win --mac \
|
||
--x64 --arm64 \
|
||
-p never \
|
||
-o "$BUILD_DIR")
|
||
echo " OK"
|
||
}
|
||
|
||
# ---- dispatch ----
|
||
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
|