@ -546,3 +546,25 @@ build path / key marker scan: 未发现本机用户路径、临时构建目录
validation: 源码测试见上方同一源码提交记录;构建后再次核对 file、go version -m、ELF dynamic section、GLIBC version references、SHA-256 和敏感字符串
live deployment: 未执行;产物尚未在真实 Linux/libvirt 宿主机运行,未替换线上 Agent 或重启服务
```
### 2026-10-18 VM 删除分阶段恢复与 Linux AMD64 构建验收
```text
source commit: 2d0305d5dd82b904581f6c66393cc53e0381d9b6
delete stages: 普通删除只执行 graceful_shutdown; 确认等待结束仍活动才返回 force_required; force_delete 使用独立 operation ID 和 ack_data_loss=true; inactive 后才进入 cleanup; 自动核对永不把 graceful 或 uncertain force 升级为 Destroy
delete evidence: 删除前失败关闭地核对 managed-save、原生 snapshot/checkpoint、外部 snapshot/revertDisks/snapshotDeleteInProgress、实际 NVRAM、卷与过滤器的当前及历史引用; 首次删除与 reconcile 共用 Domain、卷、Seed、过滤器、NVRAM 和流量状态的最终 absence 检查
recovery bounds: Agent 自动核对默认最多 24 次或 6 小时,面板最多 12 次或 6 小时;到限进入 needs_attention 并退出普通 worker, 但 resource blocker 继续阻止同 VM、卷、过滤器和目录资源的冲突操作
crash recovery: ShutdownFlags 派发边界崩溃后, fresh admission-bound inspection 将仍活动的旧 graceful operation 结案为 graceful_shutdown_unconfirmed, 只允许新 operation 重新正常关机;已授权 force 的结果丢失且 Domain 仍活动时,只能由超级管理员 token 二次核对确认旧 force 失败,随后再次 ack_data_loss 并创建新的 force operation; dispatching 和晚到结果不能被旧 token 覆盖
administrator semantics: 立即核对保持只读; 停止自动核对不表示底层调用停止; AbortJob 只用于匹配的在线 push backup; 清理残留需要 token/plan 二次确认;网页仅显示白名单错误码的固定中文提示和 operation ID
Go validation: go mod verify、go mod tidy -diff、gofmt、git diff --check 通过; 默认、libvirt、libvirt+libvirt_dlopen 三套 go test -count=1 ./... 与 go vet ./... 通过; libvirt+libvirt_dlopen 的 hypervisor/operation/api race 通过; macOS 链接器仅报告重复 libvirt/dl 库 warning
PHP validation: tests/*Test.php 125/125 通过; app/config/public/tests 下 405 个 PHP 文件逐一 php -l 通过;覆盖正常关机崩溃重试、强制删除二次授权、账本保留、管理员 token 核对、needs_attention 与错误白名单
Node validation: 5/5 个 mjs 行为测试通过; public/resources 下 89 个 JavaScript 文件 node --check 通过
review: 两轮独立终审均未发现剩余 HIGH/MEDIUM; 已知低风险为 CloudWorkerService 终态事务与部分管理员事务的 job/instance 行锁顺序不同,极端同任务并发可能触发数据库可重试死锁,但事务回滚、租约和 blocker 会保留一致状态,不会重复 Destroy 或释放账本
upgrade: 无面板数据库迁移; Agent bbolt journal 从 schema v2/v3 自动事务升级到 v4 并回填 recovery/resource-blocker 索引;部署需同步面板 PHP、静态资源与本次 Agent
toolchain: Go 1.27.1 / Zig 0.17.0; macOS arm64 交叉编译 linux/amd64, GOAMD64=v1; CGO_ENABLED=1; tags=libvirt,libvirt_dlopen; target=x86_64-linux-gnu.2.14; trimpath; ldflags='-s -w -linkmode external -extldflags=-s'
Agent artifact: release/virt-agent-linux-amd64 (10885744 bytes)
Agent SHA-256: 816fc90ca85bb2efef0bcabcab1049fc3160175b771a26fe5c7f93c67d186636
artifact inspection: stripped ELF 64-bit x86-64; revision=2d0305d5dd82b904581f6c66393cc53e0381d9b6; vcs.modified=false; 最高 GLIBC 符号版本 2.14;动态依赖 libc/libresolv/libpthread/libdl, 运行时通过 dlopen 需要 libvirt.so.0
build path / key marker scan: 未发现本机用户路径、临时构建目录、私钥标记或项目 Git 远端;临时目录产物与 release 文件逐字节一致
live deployment: 未执行;未替换线上 Agent、重启服务、修改宿主机配置、操作真实 VM 或修改生产数据库
```