mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-22 09:58:06 +00:00
9d45cd0277
三件事，前两件是上一轮热部署暴露/遗留的真缺陷。
1) 热部署差点静默降级（已修）
`make build` 之前**不带任何 tags**，而发行构建（deploy/packaging/build.sh）
默认 HOMED_TAGS=onnxruntime，package-linux.sh 还会直接拒收非 onnxruntime 二进制。
实测差异：33MB vs 84MB；启动日志里
「multimodal space active: provider=chineseclip dim=512」整行消失、
少加载一个插件（chinese-clip/qwen3vl provider 降级）、
静态词向量退回 fallback。即「随手 make build」与「发行构建」不是同一个东西，
而部署时无从察觉。
修：Makefile 的 build 默认 HOMED_TAGS ?= onnxruntime（与打包脚本一致），
构建后自动校验二进制里有没有 onnxruntime，缺了就打 WARN。
生产已按此重新构建部署（v1.4.0+hotfix.d98bf51，已核实 provider 行回归）。
2) memory_edit 每跑一次就静默降级一次（新）
memory_edit 是「按包含匹配 Purge + 写新三元组」，中间那一步把旧关系的
置信度、原句、**场景引用**全丢了：置信度被重置成默认 1.0，场景钉死的记忆
被打散成无场景。而关系复审心跳（reviewLoop）走的正是这条路——每轮复审都
在无声地削记忆质量。
修：编辑前用 FindRelations 精确取回旧关系，把置信度/原句/场景带到新三元组；
新增 ScenesOfRelation。Purge（hard/soft）与 PurgeNoise/PurgeOrphans 之后
统一清理悬空 scene_refs，SceneStats 不再说谎。
3) 场景贯穿流水线到块层（按「rel 应贯穿整条流水线」的设计）
此前场景只到 relation/entity：块（L0/L3 一等记忆块）没有场景，于是
「那场 QQ 对话里发过来的那张图」在场面重现时永远取不回来。
- MemoryBlock.Scene + memory_blocks.scene 列（幂等 ALTER 迁移）。
- scene_refs 增加 ref_text 承载字符串主键（块/文档 id 不是数值）。
**不能只 ALTER ADD COLUMN**：唯一约束要从 (scene_id,kind,ref_id) 变成
含 ref_text 的四元组，而 ALTER 改不了约束——旧约束会让「同场景第 2 个块」
直接冲突（只在多块场景暴露）。改为按列探测后整表重建并搬运旧数据。
- PutMemoryBlocks 同事务挂 scene_refs(kind='block')；无场景重写不覆盖已有场景
（否则一次无场景重写就静默抹掉挂载）。
- RecallByScene 返回块；FormatContext 增「场景素材」段（模态 + 文本/短 digest），
上限 3 条。
- 生产者接线：attachBlocksToSentence 让块继承承载它的三元组的场景；
linkBlocksToDocument 让文档的块继承文档来源场景（QQ 归档的图挂 chan:qq）。
验证：go build/vet 干净，go test -count=1 ./... 全绿。
新增用例：场景块（取回/同场景多块/无场景重写不抹场景/悬空引用清理）、
**旧表结构迁移**（降级成旧 scene_refs 后重开，旧数据保留且多块可写）、
场景素材注入、FindRelations+ScenesOfRelation 编辑搬运闭环。
生产：已重建（-tags onnxruntime）并原子替换 /usr/local/bin/homed + 重启，
35 插件全加载、panic/fatal=0、chineseclip 空间 active。
90 lines
3.6 KiB
Makefile
90 lines
3.6 KiB
Makefile
.PHONY: all build build-plain build-cli build-gui clean install test run build-static build-linux-arm64 lint fmt
|
||
|
||
# HOMED_TAGS 默认带 onnxruntime：发行版**默认启用**本地向量空间（与
|
||
# deploy/packaging/build.sh 保持一致）。
|
||
#
|
||
# 曾经这里是空 tags，实测的后果（2026-09-15 热部署）：`make build` 产出的
|
||
# homed 只有 33MB，而 onnxruntime 版是 84MB；启动日志里
|
||
# 「multimodal space active: provider=chineseclip」整行消失，少加载一个插件，
|
||
# 静态词向量也退化成 fallback——而打包脚本会直接**拒收**这种二进制
|
||
# （package-linux.sh 检查 `-tags=.*onnxruntime`）。即「本地随手 make build」
|
||
# 与「发行构建」不是同一个东西，部署时无从察觉。
|
||
# 需要极简构建时显式 HOMED_TAGS= 关掉。
|
||
HOMED_TAGS ?= onnxruntime
|
||
TAG_ARGS = $(if $(HOMED_TAGS),-tags $(HOMED_TAGS),)
|
||
|
||
BINARY=homed
|
||
CLI_BINARY=waiter
|
||
GUI_BINARY=homeagent-gui
|
||
GO=go
|
||
GOCACHE=/tmp/gocache
|
||
export GOPATH=/tmp/gopath
|
||
BUILD_DIR=build
|
||
PROJECT_ROOT := $(CURDIR)
|
||
VERSION ?= $(shell git describe --tags --dirty 2>/dev/null || echo "0.8.0")
|
||
COMMIT ?= $(shell git rev-parse --short HEAD 2>/dev/null || echo "unknown")
|
||
BUILD_TIME ?= $(shell date -u '+%Y-%m-%dT%H:%M:%SZ')
|
||
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)
|
||
|
||
all: build build-cli
|
||
|
||
build:
|
||
@mkdir -p $(BUILD_DIR)
|
||
CGO_ENABLED=1 $(GO) build $(TAG_ARGS) -trimpath -installsuffix dynlink -ldflags '$(LDFLAGS)' -o $(BUILD_DIR)/$(BINARY) ./cmd/homed/
|
||
@echo "Built: $(BUILD_DIR)/$(BINARY) ($(VERSION), tags='$(HOMED_TAGS)')"
|
||
@go version -m $(BUILD_DIR)/$(BINARY) | grep -q 'onnxruntime' \
|
||
|| echo "WARN: 本次构建不含 onnxruntime，本地向量空间不可用（HOMED_TAGS= 显式关掉时才符合预期）"
|
||
|
||
build-cli:
|
||
@mkdir -p $(BUILD_DIR)
|
||
CGO_ENABLED=0 $(GO) build -installsuffix dynlink -o $(BUILD_DIR)/$(CLI_BINARY) ./cmd/waiter/
|
||
@echo "Built: $(BUILD_DIR)/$(CLI_BINARY)"
|
||
|
||
build-gui:
|
||
@cd cmd/gui && npm install --production && npx electron-packager . $(GUI_BINARY) --out=../../$(BUILD_DIR) --overwrite --no-sandbox
|
||
@echo "Built: $(BUILD_DIR)/$(GUI_BINARY)"
|
||
|
||
build-static:
|
||
@mkdir -p $(BUILD_DIR)
|
||
CGO_ENABLED=1 $(GO) build -tags netgo -installsuffix dynlink -ldflags '-extldflags "-static" $(LDFLAGS)' -o $(BUILD_DIR)/$(BINARY)-static ./cmd/homed/
|
||
@echo "Built (static): $(BUILD_DIR)/$(BINARY)-static"
|
||
|
||
build-linux-arm64:
|
||
@mkdir -p $(BUILD_DIR)
|
||
GOOS=linux GOARCH=arm64 CGO_ENABLED=1 $(GO) build -installsuffix dynlink -ldflags '$(LDFLAGS)' -o $(BUILD_DIR)/$(BINARY)-arm64 ./cmd/homed/
|
||
@echo "Built (arm64): $(BUILD_DIR)/$(BINARY)-arm64"
|
||
|
||
clean:
|
||
rm -rf $(BUILD_DIR) $(BINARY)
|
||
|
||
install: build
|
||
-systemctl stop homeagent 2>/dev/null
|
||
cp $(BUILD_DIR)/$(BINARY) /usr/local/bin/$(BINARY)
|
||
mkdir -p /etc/homeagent /var/lib/homeagent
|
||
cp deploy/homeagent.service /etc/systemd/system/
|
||
systemctl daemon-reload
|
||
@echo "Installed. Run: systemctl enable --now homeagent"
|
||
|
||
test:
|
||
$(GO) test ./...
|
||
|
||
run: build
|
||
./$(BUILD_DIR)/$(BINARY) -data /tmp/homeagent
|
||
|
||
fmt:
|
||
$(GO) fmt ./...
|
||
|
||
lint:
|
||
$(GO) vet ./...
|
||
|
||
# lint-full：在 vet 之外跑 golangci-lint（阈值见 .golangci.yml，起步 warn-only）。
|
||
# 未安装时给出可执行的安装提示与跳过原因，而不是静默成功。
|
||
.PHONY: lint-full
|
||
lint-full:
|
||
@if command -v golangci-lint >/dev/null 2>&1; then \
|
||
golangci-lint run; \
|
||
else \
|
||
echo "golangci-lint 未安装，跳过（阈值见 .golangci.yml）"; \
|
||
echo " go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest"; \
|
||
fi
|