# 本版验证记录 ## 2026-10-14:VPC 退出清理与后台回执读取 - 现场退出任务在私网网卡已移除后停留于 `vpc_remote_command_failed`: Debian ifupdown 文件由 apply 写入完整 VPC/revision/digest 头,但 remove 两处错误要求整行等于不含 revision/digest 的短头,导致合法自有文件被拒绝。 两处统一提取精确 owner 前缀后的身份,并保留既有 VPC、版本、摘要、权限、 非符号链接及拓扑校验;不放宽跨 VPC 或未来版本的删除条件。 - 修复独立租户 worker 的单目标 VPC GET 被管理员门槛拒绝的问题。PHP 仍负责 租户归属校验并签名内部请求;全量 VPC 列表及宿主/Fabric 管理仍仅管理员可读。 - 页面优先显示当前工作流已暂停及其原因,避免底层等待回读掩盖手动接管状态。 - Python 3.12:dataplane 文件 **67 passed**;边界文件 **187 passed、1 failed**。 唯一失败是既有 Fabric `vpc_ready` 断言,已在修改前 HEAD 的同环境复现。 新增回归直接执行真实 apply 生成的文件头和 remove 两阶段代码;旧实现四项 均以 71 失败,新实现通过。签名租户单目标 GET 在旧实现返回 403,新实现通过, 并验证无签名及管理员资源仍拒绝访问。 - Node 页面行为、成员选择及语法检查通过;PHP 8.5 WASM 页面契约通过。 - 现场已快进部署 `1d858ff`,源码权限限定为本次受版本管理的普通文件 `0644`; 引擎、PHP-FPM 和常驻 worker 按顺序恢复,签名健康检查通过。部署前没有进行中 的普通任务,原退出操作为 paused。 - 按用户确认,通过面板正常关机(任务 20 succeeded),再对原退出操作 `15de1269a559c1078ea86c111baa0cf1` 点击一次“核对 / 重试”。该操作保持 revision 3 并完成,`config_confirmed=true`、`resume_cancelled=true`; 面板目标/观测均为 3、sync=`applied`、错误为空,VPC 保留为待添加实例。 MariaDB 只读核对确认成员与私网 IP 行均为 0,没有直接写库或新建退出任务。 - Debian 宿主实测:目标实例 `virsh domstate` 为 `shut off`;持久 XML 仅保留 公网 `br0` 网卡;VPC 私网桥、ifupdown/nft/sysctl/owner/state/proxy 文件及 事务目录均不存在,路由表 11069 为空,规则 29748/29749 和该 VPC nft 表 已清除,WireGuard AllowedIPs 与 proxy ARP 均无原私网地址 `10.0.0.1`。 - 本次完成了既有单成员退出的真实宿主验收;未重新开机、创建新成员或进行 跨宿主流量测试。最初自动关机没有留下引擎子操作回执的原因仍缺少现场日志, 不将它归因于本次已证实的 ifupdown 清理缺陷;正常关机任务的现场路径已成功。 ## 2026-10-14:VPC 加入暂停后的回执恢复 - 修复运行中的成员已在引擎完成配置,但 PHP `applying`/暂停步骤在读取回执前 要求再次停机的问题。仅对已进入 apply 的工作流先 GET 原 VPC 回执;严格匹配 operation、revision、digest,并复用完整宿主/成员证据校验。404 或合法旧版本 才回到原停机门;不完整证明不完成流程,错误目标/摘要/新版本不重新派发。 - 回执恢复保留 root、operation、instance 身份与租约保护,以及后续手动电源意图。 读回执失败时保留原 `paused_from`,避免重复暂停产生非法步骤。配置证明确认后 才进入既有开机恢复逻辑;原本停机或已手动接管的实例不发送电源命令。 - 宿主完整配置已验证但来宾停止时,Python 继续输出已验证的 `acl_revision`; 运行可用性仍等待来宾证据。旧 revision、错误 digest、缺少 nft 证明仍拒绝确认。 - 在线更新器纳入 `virt-cloud-vpc-worker.service`,随已安装且正在运行的服务停止, 引擎健康后恢复,避免源码更新后独立 PHP daemon 继续运行旧类。 - Python 3.12:`test_vpc.py`、`test_vpc_dataplane.py`、`test_update_worker.py`、 `test_update_preflight_coordination.py`、`test_updater.py` 合计 **192 passed、 20 subtests passed**,24 条已有警告。新增 ACL/更新服务测试已在旧实现复现失败。 - PHP 8.5 WASM/SQLite:`CloudVpcPowerWorkflowTest`、`CloudVpcFailedReconcileTest`、 `CloudVpcRootDeletionTest`、`CloudVpcTombstoneConvergenceTest`、 `CloudVpcMutationAdmissionTest`、`CloudPowerReceiptWorkflowTest`、 `CloudVpcControlPlaneContractTest`、`CloudVpcMemberCandidateRecoveryTest` **8 项脚本通过**。新增暂停回执测试在 `d8debc5` 的独立源码快照失败。 覆盖无额外 apply/电源调用、证据缺失、读失败、租约/版本/实例变化和手动接管。 - 现场已将 `48ecd03` 快进部署至面板 `venix`,重启引擎及 PHP 常驻服务, 签名健康检查通过。首次手动部署因新 checkout 文件为 `0600` 导致 apache 无法加载 PHP 类;已仅将本提交的源码/文档文件恢复到既有 `0644` 并以 apache 验证可读。手动部署不可遗漏正式 updater 的 `_normalize_checkout_permissions` 步骤;不能把 runtime/凭据文件一起放宽。 - 原 VPC `cs` 的 revision 2 加入任务经页面“核对 / 重试”恢复:成员 `vm-s6x9eb`/`10.0.0.1` 显示已生效,自动流程已完成,目标与观测 revision 均为 2,sync=`applied`,错误为空;刷新后仍保持完成。宿主只读 `virsh domstate` 确认实例仍为 running。没有新建加入任务、直接改写成功状态或发送 VM 电源命令。 - 本地测试不替代 MariaDB 并发、真实宿主新增/退出或跨宿主流量验收。本次现场 验收覆盖既有单成员的精确回执恢复,不包含新增第二成员或双向跨宿主流量测试。 ## 2026-10-14:VPC 自动加入/退出及默认组内 ACL - 新版页面确认短暂中断后提交 `auto_power: true`。VPC 操作独立保存电源进度: 正常关机回执、确认停止、既有严格配置/清理证明、恢复原运行状态。 原本停止或已经在关机的实例不会被自动启动;120 秒关机等待超时暂停, 不自动强制断电,不把 QGA 私网核验加入普通电源任务完成条件。 - `cloud_vpc_operations.power_workflow_json` 和带索引的 `power_instance_id` 是可空增量字段。按实例索引定位待核对任务,避免加锁查询扫描全部操作;不改变 VPC immutable payload/digest。旧任务、缺省 `auto_power` 的 API 请求保持原行为; 未升级字段时普通电源任务仍可入队,新自动流程拒绝接纳。 - 子电源操作先保存固定 ID 再派发,恢复时查询原回执。后续手动电源意图取消 自动开机,也禁止旧流程补发尚未执行的关机。最后成员的 NIC/IP 已清理、 但电源恢复未结束时,禁止该实例被另一 VPC 工作流接纳。 - 新 VPC 在同一创建事务中保存自身 `/24` 的两条全协议 allow ACL,分别为 ingress 32760、egress 32761。现有规则不回填,创建请求重放不恢复用户删除的 默认规则。空 VPC 仅完成地址/规则预留,不伪造宿主已安装 ACL 的证据。 - Python 3.12:`test_vpc.py`、`test_vpc_dataplane.py` **137 passed**;保留 19 条既有 ElementTree truth-value 弃用警告。额外将 PHP 实际生成的默认 ACL DTO 交给 Python 解析和 coordinator,验证摘要一致、空 VPC 预留,以及同宿主/ 跨宿主 nft 输出仍先执行身份、防伪与跨 VPC 隔离检查。 - PHP 8.5 WASM/SQLite:自动电源完整 worker 流程、普通电源回执、创建策略、 根 VPC 删除、tombstone 收敛、失败重试、实例任务准入、页面契约、控制面契约、 快照、未派发创建失败共 **11 项脚本通过**。自动流程测试复用成员/私网 IP 复用测试;覆盖开机回执丢失、旧版本任务、超时手动 force-off、初始 shutdown、 持久进度损坏、跨 VPC 竞争和旧数据库结构。准入测试对 MariaDB NOWAIT 错误 作注入验证;SQLite 不能证明真实 MariaDB 并发行为。 - Node 页面行为和成员选择 **2 项脚本通过**,包含确认取消不发送请求、显式 auto_power、当前操作进度、最后成员退出后的重试入口和错误提示。 - 扩展财务工作流在旧创建核对断言处失败;防火墙工作流因既有 `GuzzleHttp\\Handler\\HandlerStack` 导入失败。两项均在修改前 `387237a` 的 独立源码快照、相同运行时复现,未为本次功能放宽断言。 - 未操作生产、未做真实 MariaDB/libvirt/QGA/转发验收。部署需通过 `php xcat cloudInit` 应用增量字段,再加载新版 PHP/worker;在线更新器已有 该步骤。使用和验收边界见 [VPC 自动成员流程](VPC_AUTOMATIC_MEMBERSHIP.md)。 ## 2026-10-13:按镜像配置首次启动脚本 - 管理员镜像目录新增启动脚本对话框和独立接口;超级管理员可写、普通管理员 只读、租户不可访问或通过创建请求覆盖。脚本存入加密镜像记录,使用 revision 与镜像 created_at 防止过期页面覆盖;公开目录和任务 DTO 不返回脚本正文。 - 仅初次创建时封存所选镜像脚本到 NoCloud seed;重装、ISO 和现有实例不注入。 guest 内 root/Bash 在 final 阶段执行,系统盘原子标记阻止密码/主机名变更带来的 instance-id 轮换重新执行;成功、失败及中断均不自动重试,不依赖 QGA 或电源锁。 - Python 3.12 定向回归:`test_startup_script_seed.py`、`test_cloud_init.py`、 `test_libvirt_service.py` 合计 **325 passed、81 subtests passed**; `test_cloud_template_startup.py` 与 `test_cloud_template_runtime.py` 合计 **56 passed**;`test_startup_script_dispatch.py` **5 passed**。 - 扩展既有 `test_engine_boundary.py`、`test_app.py`、`test_cloud_templates.py` 回归 **296 passed、3 failed**。三个失败已在修改前 `699e0d6` 的独立源码快照、 相同依赖下逐项复现:Fabric `vpc_ready` 断言、旧创建测试缺少平台策略预期字段、 旧重装测试读取不存在的 `detail`。未修改或放宽这些断言。 - Node 对话框行为测试、PHP 8.5 WASM 控制器权限/转发测试及镜像错误合同测试通过。 覆盖 CAS、读取失败禁止保存、关闭/切换后的旧响应、重复提交、UTF-8 字节上限及 文本转义;PHP 测试不等于 MariaDB/线上会话验收。 - 使用真实 Chrome、本地模拟 API 和项目 CSS/JS 验证 1440 px 桌面及 390 px 手机对话框的打开、编辑、保存和 Escape 关闭,无 JS 错误或水平溢出。 完整 Smarty 编译测试因本机测试依赖缺少 Smarty 未执行成功,未记作通过。 - 无新数据库表;未部署生产,未执行真实来宾 cloud-init 首次启动验收。 配置与运行日志说明见 [镜像首次启动脚本](IMAGE_STARTUP_SCRIPTS.md)。 ## 2026-10-13:在线更新预检失败不再遗留全局维护占用 - Git/令牌/版本只读预检先于全局维护接纳,且不持有 `active_job()` 使用的本地 更新器锁;远端查询缓慢或初次返回 502 时,无关宿主 VM 仍可写入。 维护 claim 初始即绑定随机任务 ID,创建任务时再次核对本地与远端版本。 - 新任务首次保存之前的明确失败返回 `UpdateNotQueued`,释放本次占用;进入任务 发布后的数据库回执丢失、取消等待但线程仍可能发布等情况继续保留保护。 即使发布后返回 HTTP 409,也不误用 4xx 作为“没有执行”的证明。 不改变独立更新服务 fetch 后的版本核验、终态释放及旧未知记录恢复边界。 - 新增 12 项真实 Updater、签名 ASGI、持久协调回归:初次 502、慢预检期间其他 宿主写入、最终版本变化/502/普通异常释放、job 与 active pointer 落库后丢回执、 两次 apply 竞争只发布一个任务,以及取消后线程继续发布仍受保护。 两项核心复现测试在修改前 `3ca8cfa1316e8b53bb5d93f3130c4c25139bfdce` 独立源码快照中均失败,分别观察到无任务却返回 `coordination_uncertain`、 预检未结束便返回 `coordination_busy`;新代码全部通过。 - 9 个相关文件统一回归:**308 passed、18 subtests passed、1 failed**,21.84 秒。 范围包含更新器、更新 worker、维护协调、引擎并发/HTTP 边界、持久协调、停机和 旧面板数据库 HTTP 接口。唯一失败为 `test_fabric_is_engine_global_and_super_admin_write_only` 的 `vpc_ready` 断言; 已在上述修改前源码快照、相同 Python 3.12 依赖中复现,未修改或放宽该断言。 - `git diff --check` 与独立复核通过。无 schema 变更,未部署生产、未核查或清除 线上旧维护占用/更新任务;未执行真实 Gitea/systemd/MariaDB 更新验收。 状态发布边界与记录位置见 [更新维护协议](ENGINE_COORDINATION.md#在线更新预检与任务发布2026-10-13)。 ## 2026-10-13:成功写入后的查询与连接关闭不再封锁宿主机 - libvirt RPC 改为逐次持久化待确认写入和对应成功回执;正常回执确认后,后续 `info()` 超时只报告观察失败,`close()` 超时记录独立清理错误,不再因历史写入 留下宿主级阻断。VMService 保留已确认的电源命令结果,清理错误写入脱敏日志。 工作流累计写入证据不清零,多步骤任务仍需各自完成与清理证明。 - 真正丢失回执、响应格式错误、回执持久化失败及停机竞态仍保留保护;后续成功 不覆盖前一次未知写入。原生 libvirt 错误保留独立记录,允许原有存储池 `build()` 失败后 `create()` 的回退核验;后续连接失败不会将它误确认为成功。 快照冻结/解冻凭据独立保留,流 `finish()` / `abort()` 纳入写入回执边界。 - Python 21 个相关测试文件统一执行:**764 passed、81 subtests passed、3 failed**, 耗时 65.65 秒。新增两套真实 spawn/socket 故障注入回归,覆盖 domain/QGA 写后 读取及关闭超时、同宿主其他 VM 继续写入、重启后行为、第二次写回执丢失、 unlink/fsync 失败、并发 ACK 串行化、已关闭句柄、原生错误回退与旧记录保护。 同时覆盖 VMService 持久锁释放、快照恢复、未派发证明、资源锁及停机回归。 - 三项失败在修改前 `e55b26f1fd31fc2304c56d8a8f7841cffdf1f871` 的独立 源码快照及相同 Python 3.12 依赖中再次复现,失败位置一致: `test_cloud_template_import_job_and_create_dispatch`(策略快照旧断言)、 `test_reinstall_cleanup_pending_is_not_reported_success`(错误字段旧断言)、 `test_fabric_is_engine_global_and_super_admin_write_only`(Fabric readiness)。 未修改或放宽这些断言,不宣称整个测试集通过。 - `git diff --check` 通过,独立复核未发现阻断项。无 schema 变更,不迁移或 自动清理旧任务、协调锁及版本 1 RPC 文件。未部署生产,未执行真实 Linux libvirt/SSH/QGA/systemd/MariaDB 验收或大镜像上传性能测试。 协议与恢复边界见 [libvirt 执行说明](LIBVIRT_EXECUTION.md#写入结果未知与恢复)。 ## 2026-10-13:未派发失败不再留下或扩散 VM 持久锁 - 状态/XML/创建前检查失败、RPC 排队超时以及被其他 VM 的存储占用拒绝, 仅在当前执行具备完整无写入证明时保存 `failed`、`mutation_started=false`、 `execution_outcome=not_dispatched` 并释放本次占用。旧阻塞执行保持原样。 写入、取消、数据库/CAS 提交不明和未完成的后台交接继续保留保护。 - 重装、快照、救援的后台未派发失败须成功处理本地目录与任务记录;公网 IP 变更须先回滚新 IP 预留。创建退款仍单独核对不存在与清理证明。 PHP 只对精确绑定的未派发删除失败恢复用户操作准入,不恢复到期删除实例。 - Python 19 套相关回归统一执行:**738 passed、81 subtests passed、3 failed**。 覆盖四个新增 prewrite 测试文件,以及 RPC、libvirt 服务、资源锁、持久协调、 后台交接、停机、宿主范围、连接准入、应用并发与签名引擎边界。 新增负向用例包括写后失败、伪造/缺少证明、旧锁不变、丢失 CAS 回执、 先被拒绝后发生未知结果、后台交接竞态、数据库错误经 HTTP 序列化、 IP 与快照目录回滚失败、救援 force/exit 恢复原任务归属。 - 三项 Python 失败均在修改前 `2b87fe89f2fb570be9a3a1f10e952a9fa36efda8` 的独立源码快照、相同 Python 3.12 依赖中复现: `test_cloud_template_import_job_and_create_dispatch`、 `test_reinstall_cleanup_pending_is_not_reported_success`、 `test_fabric_is_engine_global_and_super_admin_write_only`。 本次仅为跳过 RPC 的已有模拟创建/删除服务补上写入标记,未放宽上述失败断言。 - PHP 8.5 WASM + SQLite/Eloquent:扩展的 `CloudPowerReceiptWorkflowTest.php`、 新增 `CloudPrewriteFailureWorkflowTest.php`、`CloudSnapshotWorkflowTest.php`、 `CloudOperationErrorCatalogTest.php` 均通过。使用真实客户端/worker 验证 503 明确失败只退款释放一次、缺少清理证明不退款、后续强制断电、删除准入恢复 及到期策略保持。额外执行 `CloudFirewallWorkflowTest.php` 遇到第 517 行既有 `GuzzleHttp\Handler\HandlerStack` 导入错误;同样在上述修改前源码快照复现。 - `git diff --check` 通过,独立复核未发现剩余阻断问题。本次无数据库 schema 变更、历史任务迁移或自动解锁;未部署生产、未执行真实 libvirt/MariaDB 验收。 执行协议见 [引擎协调说明](ENGINE_COORDINATION.md#执行前失败与准入拒绝2026-10-13)。 ## 2026-10-13:普通电源命令回执与状态观察分离 - `start/shutdown/reboot/poweroff/reset` 的 libvirt 调用成功后返回 `{uuid, action, command_accepted: true}`,不再等待最终电源状态或读取展示数据。 来宾忽略正常关机时任务仍完成,后续强制断电可接纳;真实回执丢失仍为未知结果, 不从瞬时状态推断成功,也不自动重放。 - PHP 仅对绑定原 POST actions 路径、UUID、action 和操作编号的确认回执,跳过 私网协调及 VPC expectation 完成门禁;不伪造 VPC 可用性、不改变到期/流量策略。 VPC 仍由独立周期协调核验。删除、重装、网络及服务策略的证明要求不变。 - 页面确认任务后释放按钮,实际状态独立刷新;移除专用 60 秒关机等待,新命令使 旧状态请求失效。救援预挂载后的开机回执也不承担救援启动证明,由救援 GET 回读。 静态资源版本为 `2026101301`。本次没有旧任务、协调锁或 RPC 标记的迁移/自动解锁。 - Python 相关回归合计 **571 passed、81 subtests passed、3 failed**: `test_libvirt_service.py`、`test_resource_locks.py` 为 256 passed / 81 subtests; `test_app.py`、`test_engine_boundary.py`、`test_engine_coordination.py`、 `test_app_vm_concurrency.py` 为 265 passed / 3 failed; `test_libvirt_service_rpc.py`、`test_durable_coordination.py`、 `test_libvirt_rpc_failures.py` 为 50 passed。 三项失败已在修改前 `c9f2fdb9` 独立源码快照以相同依赖逐项复现: `test_cloud_template_import_job_and_create_dispatch`(策略快照旧断言)、 `test_reinstall_cleanup_pending_is_not_reported_success`(错误字段旧断言)、 `test_fabric_is_engine_global_and_super_admin_write_only`(Fabric readiness)。 本次未放宽或修改这些断言。强化后的救援 HTTP 用例另行通过,不重复计数。 - 新增 `CloudPowerReceiptWorkflowTest.php` 使用 PHP 8.5 WASM、SQLite/Eloquent 与真实 worker/任务准入服务,覆盖五种电源回执、失效 QGA/私网、revision 变化、 后续强制断电、未知回执仍阻断、错误身份不豁免和其他生命周期门禁。 `CloudPowerActionBehaviorTest.mjs` 执行真实前端函数,覆盖按钮立即释放、 慢查询、失败查询、迟到响应隔离与未知任务提示;上述两项及 `CloudInstanceReadPerformanceTest.php` 均通过。 - 其余 PHP 回归 `CloudOperationErrorCatalogTest.php`、`CloudInstanceMetadataTest.php`、 `CloudVpcTombstoneConvergenceTest.php`、`CloudVpcControlPlaneContractTest.php` 通过。 扩展检查另有三项既有失败,已用 `c9f2fdb9` 源码及相同依赖复现相同失败点: `CloudFinancialWorkflowTest.php:504`(reconciliation/email 断言)、 `CloudBillingLifecycleTest.php:838`(未知删除与策略串行断言)、 `CloudProtocolTest.php:60`(缺少 `CloudOperationErrorCatalog` 导入)。 本次未修复这些无关失败,未宣称完整 PHP 测试集通过。 - 验证使用模拟 libvirt、内存/SQLite 数据库,没有连接生产宿主、部署或重启服务。 不代表真实 libvirt、QGA、MariaDB 并发或浏览器端到端验收。 API 依据与契约详见 [执行协调说明](ENGINE_COORDINATION.md)。 ## 2026-10-12:VPC 添加实例候选归属修复 - 根因是用户页面仅排除当前 VPC 的成员,实例列表未携带其他 VPC 的归属。 后端原有全局成员唯一约束与加入校验仍会拒绝重复加入;本次修复可选列表, 没有开放一台实例同时加入多个 VPC。 - bootstrap 批量核对成员、私网租约及用户自己的 VPC:已占用、清理中及 归属无法核实的实例均禁用,并说明原因;查询失败不沿用旧的可加入结果, 不泄露其他用户的 VPC 名称。切换、创建、成员修改和轮询会刷新候选, 10 秒读取超时释放页面等待状态,过期响应不能覆盖新状态或清除未保存草稿。 - 兼容旧版本已完成删除却残留成员/租约的记录:在原 VPC 显示“核对 / 重试”, 仅显式核对且没有待处理操作时,复用原有严格删除凭据校验释放残留。 普通 GET 不清理记录;无凭据、有路由引用或存在未决操作时仍拒绝释放。 - 两套 Node 行为回归 `CloudVpcUserPageBehaviorTest.mjs`、 `CloudVpcMemberChoicesTest.mjs` 通过;PHP 8.5 WASM + SQLite/Eloquent 环境中 `CloudVpcPageMembershipTest.php`、`CloudVpcMemberCandidateRecoveryTest.php`、 `CloudVpcMutationAdmissionTest.php`、`CloudVpcFailedReconcileTest.php` 和 `CloudVpcUserPageContractTest.php` 通过。复用测试夹具执行的成员/私网 IP 回收合同也通过,不将重复执行统计为新增用例。 - 本次未更改数据库结构、Engine、宿主网络或 ACL 策略;前端资源版本提升为 `2026101203`。验证范围为源码回归,未部署线上面板,也未执行真实浏览器或 MariaDB 验收;此前双宿主通信验收记录不等同于本次页面变更的线上验收。 ## 2026-10-12:VPC 邻居持久化与双宿主互通 - 真机根因:无 IPv4 地址的私网 bridge 发出的 ARP 使用宿主公网源地址, 来宾私网接口的严格 `rp_filter=1` 与该源地址的公网反向路由不一致,导致 邻居解析失败。手工 PERMANENT 邻居能恢复通信,但旧周期 apply 会重新 down/up bridge 并清掉邻居,不能作为持久修复。 - 本次将本地成员的精确私网 IP/MAC 纳入受管 `local_neighbor` 状态、事务 回滚、Fabric 恢复与回读;升级 helper 契约检查在网络写入前拒绝旧实现。 成功应用凭据及新鲜状态核对避免健康周期重复修改网络,XML、seed、QGA 核验仍照常执行。机制与旧环境迁移步骤见 [VPC 数据平面验收](VPC_DATAPLANE_ACCEPTANCE.md)。 - 本地受影响的 12 套 VPC/Fabric 回归 **917 passed / 19 warnings**,耗时 295.50 秒;warnings 为现有 Element truthiness 弃用提示。覆盖邻居 apply/restore/rollback、未知或冲突条目拒绝、旧 helper 门禁、重复协调、 回执失效与完整状态漂移。Python AST、12 个渲染脚本的 shell 语法及 `git diff --check` 通过,独立复核未发现阻断问题。 - 真机范围为 Debian/ifupdown 与 AlmaLinux/NetworkManager 两台宿主, 每台各一台 VM。经用户确认,仅对 `10.0.0.1/32` 与 `10.0.0.2/32` 配置双向 ingress/egress 全协议允许,面板及两台宿主均核实 revision 4。 两台 VM 的 QGA 仅增加 `virt_qemu_ga_t` 执行 `ifconfig_exec_t` 文件所需 权限,保持 SELinux Enforcing、`virt_qemu_ga_run_unconfined=off` 及 私网接口 `rp_filter=1`;该 SELinux 权限按文件类型生效,不限制命令参数。 两台宿主调用固定 QGA 路由探针均退出 0,读到真实私网路由。 - 线上已有其他热修,先备份并核对源文件哈希,只部署本次三个 Engine 文件; 未 reset/pull 覆盖原有改动。两台宿主在 Fabric 锁下完成受控 helper-only 升级并保留旧文件;恢复 timer、Engine 与 VPC worker 后,正常后台协调 自动迁移两台旧 state,无需改数据库或重存 ACL。未修改 libvirt 启动依赖。 - 2026-10-12 06:20–06:29 UTC 实测:两侧 state 均含准确的本地邻居记录, 内核均为 PERMANENT,无活动事务 journal;各 190 秒 `ip monitor link` 均无事件,跨多个正常协调周期未再出现 bridge 重置。Fabric timer 均 active。 Engine 只读状态中 Fabric、VPC、两台 host 均 active,私网/配置/传输核验 成功且无错误;用户页面两个成员均为“已生效”。 - 双向各 **180/180 ICMP**,丢包率 0%;同步就绪后双向各 **120/120 TCP** 和 **120/120 UDP** 成功。首轮一侧先于对端监听开始统计,出现 10 次启动 阶段失败,延长就绪等待后完整重测通过;两个临时监听均已自动退出。 - 本次未进行宿主重启、同宿主双 VM、拒绝规则或跨租户负向包测试;这些仍需 独立真机验收,不能由上述允许通信及本地回归推定通过。 ## 2026-10-10:firewalld 支持退役 - 当前 Fabric/VPC 宿主机只支持 `native_nftables`。能力探测只在 `nft` 命令可用、 规则集可读、firewalld 无法接管,并且 `firewall_manager=nftables`、`firewall_mode=native_nftables` 时允许 readiness。 stock `nftables.service` 的 active/enabled/load 状态仅作诊断,不再作为 nft 能力或平台受管规则恢复的门禁;运行时 guard 同样直接只读核验 nft API。 旧 `firewalld_nft` 输入、manifest、journal、zone/rich-rule 所有权或实时 `inet firewalld` table 必须 fail-closed,不得在普通 apply/reconcile 中静默 映射、接管或删除。 - PHP readiness 边界会再次核验原生 nftables 模式;即使旧 Engine 将 `firewalld_nft` 回报为 ready,页面也必须关闭写入并显示维护迁移阻断。 - 本次本地已通过受影响的 Engine 完整回归 **536 passed**、Python 编译检查、 `admin-fabric.js` 语法检查、`AdminFabricWizardBehaviorTest.mjs` 前端行为回归 及 `git diff --check`。 当前工作区没有 PHP CLI 且没有 `web/vendor/autoload.php`,因此本地未能 执行 PHP lint 和 PHP 合同/readiness 测试;发布前必须在完整 PHP 依赖环境补跑。 - 本节之后仍出现的 firewalld 段落只是 2026-10-08/09 的历史实测与旧实现 记录,不表示当前仍支持该模式,也不能作为新部署验收依据。 - 仍需在 AlmaLinux 10 和 Debian 13 验证 native nftables apply/readback、 panel-owned service/timer 修复、宿主重启、WireGuard 握手、VPC 允许/拒绝流量 及失败回滚;本地静态回归不代替这些真机证据。 ## 2026-10-09:严格 NM shadow 恢复与丢失回执只读查询 - Fabric 的共享 NM 归属检查只新增对固定 runtime shadow 的支持:持久/临时 文件均须 regular、无 symlink、root:root 600,runtime 父目录安全;UUID/name 唯一,来源 metadata 精确,所有网络及私钥字段在内部比较一致。仅 runtime `zone` 与精确 shadow 元数据可不同;前后内容 hash 和 FILENAME 再读须一致。 外部 underlay profile 的通用查询规则不变,不因路径在 `/run` 就接管。 - 首次部署已发布 helper 后失败时,只有 journal 的 absent baseline、当前计划 digest、已发布文件与 desired post-image 完全一致,才允许用当前实现的临时 helper 恢复;不覆盖旧文件来绕过归属检查,不清空 nft 或删除 journal。 - BOOT/helper 在失败时新增固定 `helper_phase` 与退出码日志,正常成功和正常 `--needs-repair` 探测保持静默,原退出码保留。新增结构化记录不输出配置、 私钥或命令;这不等于已有外部工具的所有 stderr 都已净化。 - 前端丢失 POST 回执后最多 180 秒/36 次 GET 查询,连续失败上限 12 次, 期间所有写操作关闭;用请求前 operation identity 排除历史终态,只跟踪 本轮新任务或明确恢复的同一未结任务,不自动重放 POST。 - 稳定源码分组回归:既有 Fabric 六套 **530 passed**、proc **90 passed / 9 skipped**, route/Engine boundary/VPC/dataplane/firewalld 五套 **498 passed / 23 warnings**; 完整首次部署/helper phase/NM shadow 三套 **117 passed**,完整外层 recovery dispatcher 四个同计划/外部替换/错误 digest/runtime 密钥漂移用例通过。 前端行为、三个 PHP 合同、JavaScript/Python 语法与 diff 检查通过。 - 本段是源码交付边界。此前真机失败见下节;新的在线更新、双机 overlay、 租户 VPC 和重启恢复结果必须另行记录,不能由本地测试推定。 ## 2026-10-09:26351f8 真机更新与 NetworkManager runtime shadow - 后台在线更新成功,面板 SSH 确认 HEAD 为 `26351f8b3bb2c7782bf2fb3bdaf11a6d4690b972`,Engine 已在源码更新后重启。 fresh 检测 2/2 能力就绪;仅对现有固定计划提交一次重新核对。 - POST 返回 502,但刷新只读页面及两台宿主 journal 均证实新 operation 已接纳。 不能将响应丢失当作没有执行,也不能自动重放 POST。接纳前同步 probe 与 per-Fabric 锁等待仍可能超过网关超时;此前前端需手动刷新才能发现新 operation。 - Alma 的新失败在 `identity/ownership_conflict`。通过实际生成脚本中的只读函数 证明 emergency owner/inet/bridge shape 均成功,固定 KEY/OWNER 权限和公钥正常; `vc_fabric_nm_profile_owned` 失败,因为 NM 活动连接的 FILENAME 指向 `/run` shadow, 而当前代码仅允许 `/etc` 持久文件。临时副本 root:600、同 UUID/接口/网络字段、 `zone=trusted`,且 `.nmmeta` 精确指向平台持久文件并标为 shadowed-owned。 - [NetworkManager 官方 IN_MEMORY 契约](https://github.com/NetworkManager/NetworkManager/blob/main/src/libnm-core-public/nm-dbus-interface.h#L1135-L1145) 说明 IN_MEMORY 使用 runtime keyfile 覆盖并保留持久来源;这是平台的 `connection modify --temporary` 正常行为,不是系统升级、chmod 或缺少 iproute2。 [官方 keyfile writer](https://github.com/NetworkManager/NetworkManager/blob/main/src/core/settings/plugins/keyfile/nms-keyfile-writer.c#L252-L262) 写入 `shadowed-storage` 与 `shadowed-owned` 来源元数据。 修复必须核验精确 runtime 路径、权限、来源和完整网络/密钥语义;不得泛化接管 任意 `/run` profile,也不得用 connection delete 清除 shadow。 - Debian 同轮推进至最终回读,主 Fabric 恢复服务退出 71、repair 退出 79,随后回滚。 尚无 helper 内部阶段证据指认具体失败条件;正在增加仅固定阶段/退出码的安全日志。 双宿主 active、双向 overlay、租户 VPC 与重启恢复仍未通过。 ## 2026-10-09:真实过滤路由输出省略设备字段 - 后台在线更新与面板 SSH 均确认 `b11856d` 已部署且 Engine 已重启;fresh 检测通过后只对固定现有方案执行一轮重新核对。Debian 13 与 AlmaLinux 10 都推进到 `final_readback` 后失败,不能将能力检测通过等同 Fabric 可用。 - Alma 实际 `ip -o -4 route show table all dev wg-fabric0` 返回 peer host route 和自身 local route,但省略每行的 `dev` 字段。只读复现确认原解析把 device 置空并拒绝合法路由。这是查询/输出契约缺陷,不是缺少 chmod 执行位。 - [iproute2 官方源码](https://github.com/iproute2/iproute2/blob/v6.17.0/ip/iproute.c) 中接口过滤设置 `oifmask=-1`,序列化时故意省略 device。因此只有对应的 `dev` 过滤查询允许从其固定查询范围补回设备;无过滤查询仍要求显式设备, 显式错误/重复/畸形设备和无 OIF 的非普通路由不能被推定为受管接口。 - 当前现场保留事务及紧急隔离,不清空 nft、删除 journal 或关闭防火墙。 本段记录定位证据;修复后的真实双向 overlay 和重启验收仍须单独完成。 - 稳定源码分组回归:Fabric/proc/nft/NM/systemd 七套 **620 passed、9 skipped**; route/Engine boundary/VPC/dataplane 四套 **454 passed、23 warnings**。 新 route 用例覆盖无设备字段、显式设备漂移、无 OIF 特殊路由、精确 local 形状,以及未过滤查询不推断设备。渲染 shell、独立交叉审查、py_compile 与 diff 检查通过;Darwin 的 Linux proc 跳过边界不变。 - 完整首次部署 helper 入口 **33 passed**,新增 12 项覆盖 `ready/refreshed`、 临时/持久 helper、已创建 UP/trusted 接口和已发布 NM/ifupdown profile 的 精确恢复;错误快照权限/digest 与同 marker 篡改 verdict 保留隔离并拒绝。 - 独立静态审查发现 VPC bridge 重复 apply 与 QGA guest JSON route 探测中还有 同类依赖过滤输出 `dev` 的问题。本次只修 Fabric apply/BOOT/observe,另两项 尚未修复,不能据此宣称租户 VPC 的完整接入、重试与 guest 验收已通过。 ## 2026-10-09:越过 nft 安装后发现的目录与回读兼容问题 - `6a99181` 已通过后台在线更新部署,SSH 确认 Engine 为新进程;新一轮真实 operation 中 Alma 的 nft journal 已到 `refreshed`,两份 root-only snapshot 已发布,证明原 nft 归属误拒绝已越过。Alma 随后的 profile 发布遇到现有 NetworkManager 目录 `root:755`,原代码只允许 `700`;现只接受 root 自有、 无符号链接的 `700/750/755`,不 chmod 管理员已有目录,新目录仍建为 700, 含私钥的 keyfile 和事务快照仍为 600,其他用户/不安全权限继续拒绝。 - Debian 本轮推进至 `final_readback`。实际渲染路由校验可复现合法裸 IPv4 host prefix 被 `/32` 字符串误拒绝;apply、boot 与 observe 统一只归一化 canonical IPv4 host 地址,不改 `/24` 等更宽前缀、table/device、VPC proto 186/完整 tuple 或重复路由门禁。boot 也精确排除自身 kernel local route。 - boot nft 校验不再要求 8 个 ASCII 空格缩进,完整有序语义与 8 条精确 digest 仍保留;observe 的错误嵌套 AWK `BEGIN` 改为顶层。NetworkManager profile 以 metric 50 创建 peer route,apply/boot 的 replace 现在使用同一 metric, 避免创建另一个 metric 0 的路由;ifupdown 行为不变,不清除未知旧路由。 - 依据:[NetworkManager keyfile 安全规则](https://networkmanager.dev/docs/api/latest/nm-settings-keyfile.html)、 [IPv4 route metric](https://networkmanager.dev/docs/api/latest/settings-ipv4.html)、 [iproute2 host-prefix 输出](https://github.com/iproute2/iproute2/blob/main/ip/iproute.c) 与 [Linux FIB replace 的 priority 匹配](https://github.com/torvalds/linux/blob/master/net/ipv4/fib_trie.c)。 - 新增 NM 目录 26 项与 route/boot nft/observe/metric 67 项独立回归通过;只读 交叉审查执行全部渲染 apply/BOOT/observe 的 shell 检查及 166/67/59 个 AWK 程序语法检查,无错误。最终稳定源码分组回归:Fabric/proc/helper/nft/NM 八套联合 **641 passed、9 skipped**;route/Engine boundary/VPC/dataplane 四套联合 **345 passed、23 warnings**。py_compile 与 diff 检查通过。 - 最新修复完成后电脑锁屏,浏览器与 SSH 控制明确阻断,故未执行这一版在线更新 或新 operation。需解锁后继续;上方真实推进结果属于此前 `6a99181`,不得 把当前回归通过误写成宿主已部署或组网成功。 - 本轮未手动清空规则、删除事务、停用 firewalld/SELinux 或改公网接口策略。 两台真实宿主尚未最终 active,双向 overlay、租户 VPC 与重启验收仍未通过。 ## 2026-10-09:真实 nft 安装后归属校验修复 - 接管两台 electerm SSH 会话后,Debian 13 与 AlmaLinux 10 均确认 journal 为 `nft.phase=installing`;`nft -c -f nft_rules.desired` 返回 0,主 Fabric table 已存在。 在宿主机仅提取并执行本轮 apply 的只读校验函数,Debian 得到完整语义检查成功, 而附加计数为 `8:0:0`,归属判断失败;这不是宿主机 nft 安装失败。 - 根因是原始 Python 模板中的二次转义被原样插入 shell:链正则中的两个反斜杠 无法匹配真实 `{`,导致合法表的两项链计数均为 0。修复只恢复正则/换行的实际 shell 表达;完整表语义、8 条 owner/digest、3 条精确 chain 与回滚快照门禁保留。 - 新回归直接从完整生成 apply 提取实际事务函数执行,不用单独常量或 mock 归属 函数替代,覆盖正常规则、canonical output priority 和外部/篡改规则拒绝。 - 同时发现首次 Debian 激活会在 generator 发布前执行 ifupdown hook。现将已有、 journal 覆盖的 generator 发布提前至 network_activate;hook 与普通启动的所有 权限/digest 门禁仍无条件执行,daemon-reload 与 libvirt 激活门禁仍在最终持久化阶段。 - 分批验证:Fabric 既有四套与 proc 套件 538 passed、9 skipped;实际 nft 事务 56 passed;完整首次部署/helper 入口 21 passed(包括 11 个新增 hook/顺序用例)。 修改后 nft/systemd/ifupdown 联合复跑 80 passed;Engine boundary/VPC/dataplane 278 passed、23 warnings。py_compile、diff 检查与独立安全审查通过;Linux proc 本地跳过边界不变,上述测试不替代真实流量或重启验收。 - 真实部署与下一轮状态以后台在线更新、同轮 operation 日志和双向 overlay 流量为准; 本段定位证据本身不代表 Fabric 或租户 VPC 已可用。 ## 2026-10-09:接管真实 SSH 后的 proc 读取与首次部署入口修复 - 在用户指定的 electerm Debian 13 会话真实复现:`cat /proc/sys/net/ipv4/ip_forward` 为 1,而 dash 的逐字节 `IFS= read -r` 返回 1 且变量已是 `1`。整数 proc sysctl 在非零读取偏移直接 EOF;原脚本把这误判为 sysctl 不兼容。apply、boot、observe 和 rp_filter 写后回读改用缓冲读取并保留末尾换行,仅接受精确单行 0/1/2;I/O 失败、 空值、额外换行、多行及畸形值继续拒绝,ip_forward 必须等于 1 的门禁保留。 - AlmaLinux 10 真实会话确认 SELinux Disabled、脚本所在文件系统无 noexec,旧 journal 为 ready/installing,generator 与 timer 的基线为 absent。完整渲染 helper 测试进一步 发现入口提前展开未定义 config_fabric/network、过早要求未发布的 gate generator、 timer.absent 分支缺少 TIMER_UNIT 声明。现用已绑定的 plan 常量初始化 loader,常规 manifest 精确匹配;恢复-only 完整 journal/plan/nft 证明后可退出,正常启动仍校验 gate。 恢复全程保留 emergency 隔离,不会提前启动 libvirt。 - 分批回归:Fabric 既有四套用例 448 项通过,新增 proc 读取与完整 helper 入口 100 项 通过;9 项真实 Linux /proc 用例在本地 Darwin 跳过,由上方 SSH 复现补充现场证据。 联合首轮中的两个尚在编辑的新 manifest 测试已由稳定文件完整重跑(10/10)通过。 Engine boundary/VPC/dataplane 278 passed、23 warnings;py_compile、diff 检查与独立 安全审查通过。成功/外部 gate/错 plan/普通启动/manifest 偏移均走完整 helper 控制流, 不注入 TIMER_UNIT/config_fabric/network 来掩盖入口缺陷。 - 代码回归后通过管理员在线更新部署,再由同一地区的新 operation 验证旧事务收敛和 WireGuard 回读;组网验收以实际页面、宿主 journal 和双向 overlay 流量为准。 ## 2026-10-09:Debian 13 / AlmaLinux 10 Fabric 启动与恢复核对 - 按 Debian 13 的 systemd/ifupdown 文档与源码、RHEL 10 的 systemd 文档核对生成脚本。 runner 与临时 helper 本就有 `chmod 700`;剩余临时/固定恢复 helper、持久 unit 和 ifupdown hook 的直接执行入口现统一改为绝对 `/bin/sh`,仍保留 root 所有权、模式、 plan digest、journal 镜像和精确 nft 回读检查。执行位不能覆盖 `noexec`。 - 经典 ifupdown 会过滤普通 `VC_*` 调用环境。父 apply/recovery/service 现在通过其保留的 `IFUPDOWN_*` 前缀传递锁与事务上下文;helper 只在 ifupdown hook 入口导入合法值,冲突 一律拒绝。ifupdown2 同时收到原有变量;命令级赋值不遗留父进程过渡标志。主 service 在 ifup 后继续完整配置和运行态回读。 - libvirt 启动门禁只覆盖实际 daemon services 和 libvirt-guests;socket activation 仍触发同一受门禁 daemon。去掉 socket 与 Fabric 之间的晚期依赖,消除默认 socket → sockets.target → basic.target → Fabric → socket 启动循环。 - repair 不再查询不存在的 service `Result=dependency`。只有当前 boot PID 1 最新的 unit 记录自身为本轮 Fabric 失败之后的 start/dependency、当前 inactive/无 job、 有效门禁匹配时才消费一次性证据;每 daemon 每 boot 最多一次。Fabric 恢复后再次 回读并以 `--no-block --job-mode=fail start` 排队,不重置非 Fabric 服务。 - 安全日志增加 `journal_dispatch` 与八类 `preflight_*` 检查点,PHP/UI 严格白名单同步。 旧 preflight 未知命令错误不再误标为资源归属冲突;共享资产版本为 `2026100906`。 - Python 3.12 最终回归:Fabric 主套件、systemd 顺序、job 证据与 ifupdown 环境过滤 联合 **448 passed**;Engine boundary/VPC/dataplane **278 passed、23 warnings**。 四项 PHP/WASM 合同、PHP/JS 语法、Node Fabric 向导行为、py_compile、diff 检查及 独立交叉审查通过。测试包含直接执行被拒而 interpreter 可读、经典环境过滤、旧 socket 循环反例、手动 stop/后续 job/普通服务失败/伪造与漂移 job 证据不重试。 - 本轮用户提供的真实日志证明 runner 已启动,Alma 停在 journal_recovery,Debian 停在 preflight;这些阶段不足以证明具体冲突对象或 SELinux/noexec 根因。代码缺陷已修复, 下一轮同 ID 状态、journal/guard 收敛、双宿主握手、跨宿主允许/拒绝流量与重启恢复 仍须在真实宿主验收;上述模拟与本地回归不代表组网已成功。 ## 2026-10-09:Fabric 宿主 systemd 异步 operation 与安全回读 - Fabric apply/reconcile 不再让 HTTP/SSH 长连接等待完整宿主配置。Engine 先持久化同一轮 32 位小写十六进制 `operation_id`,HTTP 以 `202 Accepted` 返回;每台宿主把不可变脚本、 manifest 和固定枚举 status 放入 root-only 的 `/run/virt-cloud/fabric-operations/`,再由有运行上限的 transient systemd oneshot 独立执行。原始 stdout/stderr、命令、路径、私钥和 peer 全量配置不会进入 API 或 安全阶段日志。 - transient oneshot 固定以绝对路径 `/bin/sh /runner` 启动,runner、update 及 apply 内的状态更新也全部显式交给 `/bin/sh`,因此 Debian 将 `/run` 挂载为 `noexec` 时不会再以 `203/EXEC` 失败。oneshot 使用有效的 `TimeoutStartSec=840s` 约束整个启动任务, 不再使用 systemd 明确会忽略的 `RuntimeMaxSec=` 组合。 - 页面只通过 Fabric GET 轮询原 ID,replacement、缺失地区、连续读取失败或 CDN 超时均停止 自动跟踪并进入结果未知,绝不 POST 重放。PHP 写边界强制 operation ID、kind 和 status; 首次 apply 只返回回执且不发布地区映射,只有后续显式“重新核对”完成平台代次、宿主闭集、 VPC pin、active 与 `next_stage_allowed` 权威回读后才能激活映射。 - 周期 reconcile 与页面 GET 始终只读。只有显式 POST 能在严格 immutable hash、systemd unit 和逐节点 dispatch fence 证据下继续原 ID:恢复 publish-before-systemd 的 queued runner, 或在已接纳节点精确收敛后续派确定未接纳节点;不得重派已接纳节点或生成替代 ID。 - 版本升级若改变 immutable runner/apply/update 哈希,绝不覆盖或执行旧 spool。只有旧任务仍 精确为 `queued/dispatch/none`、从未开始/结束,且 transient unit 已证明为 `not-found`,或 精确为 `loaded/failed + exit-code/exited/203`,一次显式“重新核对”才会把该旧任务原子关闭为 `failed/dispatch/systemd_failed`;下一次显式“重新核对”再创建使用当前脚本的新 operation ID。 运行中阶段因此只开放“重新核对”,检测与再次自动配置仍保持禁用。 - journal 恢复安全日志新增 `journal_artifact_restore`、`journal_nft_restore`、 `journal_runtime_restore`、`journal_finalize` 四个固定子检查点。更新日志本身是 best-effort, 只有 root-owned `0700` operation 目录与 update 文件同时通过无符号链接校验才写入;写入失败 不改变恢复与 fail-closed 语义。宿主已确定失败时,尚未越过 dispatch fence 的节点关闭为 `skipped`,地区 operation 收敛为终态,后续显式 reconcile 才允许新建 ID。 - 最终 Python 3.12 聚焦回归:`engine/tests/test_fabric.py` **384 passed**; `test_engine_boundary.py + test_vpc.py + test_vpc_dataplane.py` **278 passed、23 warnings**。 后一组与 Fabric 全测并行时曾触发一个既有云模板后台 GC 计时断言,取消并行后完整重跑通过。 `py_compile` 与 `git diff --check` 通过。 - PHP 8.5/WASM 下 6 个修改/相关 PHP 文件语法、Fabric 静态合同、operation 严格投影、宿主 网络池/调度、资源调度、多公网池、资产和防火墙 UI 合同通过;Node JavaScript 语法及 Fabric 向导行为测试通过。当前隔离 vendor 缺少 `Illuminate\\Database\\Capsule\\Manager` 实体文件, 因而 `AdminFabricReadinessWorkflowTest.php` 仅完成语法检查,未执行数据库流程;该测试必须在 部署端完整 Composer dev 依赖与 PDO SQLite 环境复跑。 - 尚未连接真实 Debian 13 / AlmaLinux 10 宿主机验证 SSH 断线、transient unit、journal、重启、 NetworkManager/ifupdown 及 native nftables。部署后必须用页面显示的同一 ID 查询 `journalctl --utc -u virt-cloud-fabric-apply-.service --no-pager -o short-iso-precise`, 并完成双宿主 WireGuard 握手、跨宿主 VPC 流量和重启恢复后,才能认定生产组网验收完成。 ## 2026-10-09:真实宿主探针兼容修复 - AlmaLinux 10 现场证明配置的 endpoint 唯一属于 `br0`,firewalld 使用 nft backend 且 `br0` 的持久 NetworkManager profile 存在;误报来自探针调用了不受 支持的 detail 字段 `GENERAL.FILENAME`。readiness、Fabric/VPC apply/remove/observe 与开机恢复现统一读取有界的 `UUID,FILENAME` 列表,按 UUID 精确唯一匹配,并继续要求 endpoint profile 位于 `/etc/NetworkManager/system-connections`、非符号链接、root 所有且 模式为 `0600`。 - 运行中 VM 的 `vnet1`、`vnet3`、`vnet10` 等 tap 可能对应 NetworkManager 在 `/run` 下生成的临时 profile。它们会逐接口标为不可持久验证,但只要不是 endpoint,就不会再 连带阻断 `br0`;若 endpoint 自身只有临时、重复或不可验证 profile,仍然 fail-closed。 - Debian 13 现场的 iproute2 6.15 在 WireGuard 模块未加载时会让 `ip -j -d link show type wireguard` 返回成功且包含逐 link 的 `{}` 占位。解析器只在 模块状态精确为 `not_loaded` 时允许 WireGuard typed 段中的精确空对象;模块已加载、 其他 link/address/bridge 段或任意非空畸形记录继续拒绝。页面同时区分 `ip` 命令与发行版 包名:Debian 安装包为 `iproute2`,AlmaLinux/RHEL 安装包为 `iproute`。 - `ip`、`nft` 与 `modinfo` 均改为执行能力探针实际发现的绝对路径,覆盖 `/usr/sbin`、 `/usr/bin`、`/sbin` 和 `/bin`,避免非 merged-/usr 布局出现“已发现但执行阶段假缺失”。 - 直接相关三组 Engine 回归为 **295 passed**;Python `compileall`、生成 shell 的 POSIX 语法、管理员 Fabric Node 行为、JavaScript 语法、PHP 静态合同和 `git diff --check` 通过。完整 Engine 回归为 **1312 passed、10 skipped、5 failed、80 subtests passed**; 5 个失败仍是既有 cloud-template spec、reinstall cleanup envelope 与 3 个公网池 fixture, 不涉及本次探针代码。 - 上述现场输出是修复输入,不代表新版本已经在宿主机验收。部署本提交后仍须重新点击 “检测宿主机”,确认两个旧阻断消失;随后执行地区自动配置、WireGuard 握手、跨宿主流量、 native nftables/NetworkManager reload 与重启恢复验收,才能认定生产组网完成。 ## 2026-10-09:Fabric canonical nft 回读与首装事务恢复 - AlmaLinux 现场的 nftables 1.1.x 会把 inet `output` hook 的数值优先级 `-100` 回读为标准名 `dstnat`。Fabric 严格 grammar 现在只在该精确 hook/priority 组合接受 `dstnat`,`input`/`forward` 或其他命名优先级仍拒绝;owner、plan digest、三条 chain、 八条规则、空 tenant set 和完整二次回读要求不变。 - 旧版本可能已原子安装主 Fabric table,却在写入 `nft.installed` 快照前因上述误判退出, 从而留下 `state=ready`、`nft.phase=installing`、emergency guard 仍生效的安全隔离态。 新 apply 只在当前计划与 journal 的 digest、UUID、部署/防火墙模式及 underlay 参数全部 一致时使用临时 helper;缺失快照还必须证明首次部署空基线、desired 规则哈希与完整 live table 一致且连续两次回读不变,才会原子补写快照并进入既有回滚状态机。 - 首次部署尚未发布固定 helper 时,`before_mutation`、`installing`、`installed`、 `refreshing` 与 `refreshed` 均由当前计划绑定的临时 helper 恢复;固定 helper 已存在时仍 必须与 journal baseline 或 desired 镜像逐字一致。`firewalld_nft` 的 manifest 基线必须 absent;`native_nftables` 的主配置基线必须 present,live 文件只能逐字匹配 baseline 或 安全 desired,并包含受支持的唯一/通配 include。符号链接、权限漂移、内容漂移、非空 tenant set、额外 nft 对象或任一次 TOCTOU 回读变化均保留隔离与 journal,不执行删除。 - 远端 `identity`/`observe` 仍使用 35 秒读超时;仅 `apply` 扩展为 300 秒,避免完整 隔离、恢复、回读流程被旧的短 SSH 超时中断。浏览器/CDN 的请求窗口可能仍早于后台 mutation 完成,因此 502 只表示 HTTP 结果未知,不能重复自动配置;应等待当前宿主命令 结束后使用“重新核对”。 - 本节最终本地验证:`engine/tests/test_fabric.py` 为 `302 passed`;远端宿主与 Engine 边界为 `296 passed, 4 warnings`;VPC/Fabric 数据面为 `153 passed, 19 warnings`;完整 Engine 为 `1496 passed, 10 skipped, 5 failed, 80 subtests passed, 24 warnings`。5 个失败 与本轮前一致,分别是 cloud-template spec 新字段、reinstall cleanup detail envelope 和 3 个公网池 fixture,均不在本次 Fabric 改动范围。`git diff --check`、生产/测试 Python `py_compile` 与最终只读源码审计通过。上述静态与本地回归不替代真实宿主机验收;部署后 仍须证明 journal/emergency guard 收敛、两台主机 WireGuard 握手、跨宿主 VPC 流量 以及 native nftables reload 与重启恢复。 ## 2026-10-08:公网优先 underlay 与已退役 firewalld+nft 实验 - 当时的 Fabric/VPC 实验曾接受两个互斥模式:native nftables 要求 `nftables.service` active/enabled 且 firewalld 不存在或 inactive+masked; firewalld 模式要求 active/enabled、nft backend、`NftablesTableOwner=yes`,native nftables unit 则只能不存在或 inactive+disabled/masked。能力探针不会查询 inactive firewalld 的 D-Bus API,避免为了检测而把仅 disabled 的服务重新激活。 - firewalld 继续管理 endpoint 所在 zone 及精确 UDP rich rule;平台受管 Fabric/VPC table 仍由 nft 原子加载并用 owner/revision/digest/完整语义快照回读。公网物理接口永不 trusted,只有已验证 profile/fragment 的 overlay/VPC 接口在 ACL 完整回读后临时进入 runtime trusted。失败、回滚和开机恢复均先隔离而不拆除 bridge/tap 拓扑。 - firewalld 事务会先安装带随机 token 的独立 emergency nft guard,并把 token 写入 root-only owner intent;删除前必须再次证明 token、完整 table 形状和 stateless snapshot 均未变化。仅没有 VPC state、manifest 或未完成 journal 的空宿主,才允许在失败的 firewalld 前置尝试纠正为 native 后接管并清理这份 guard;已有 VPC 时必须保留 guard 并 报告维护迁移,不会以 owner comment 数量代替三族 ACL 的完整语义证明。缺少 owner intent 的同名外部 table 始终不触碰。nft journal 区分 mutation/install/refresh 的提交阶段, 崩溃恢复不能把“命令已返回”误当成持久规则已完成回读。 - underlay 普通路由和显式 `from endpoint` 路由必须选择同一接口及配置的源地址;多地址 同接口不能再靠 `dev` 相同误通过。fresh readiness 还拒绝 endpoint 落入实际全局租户 VPC CIDR 池;Engine 在 Fabric 变更与 VPC apply 两端拒绝 endpoint 与既有 VPC CIDR 重叠,避免目的策略路由把 WireGuard 外层 UDP 重新导向租户表。 - Fabric apply/reconcile 与 VPC apply/delete/reconcile/lifecycle reconcile/observe 现在由 `EngineApplication` 显式注入同一个 lazy catalog mutation lock,锁序固定为每资源锁、 catalog 锁、排序后的 VM 锁。VPC 从读取 Fabric gate 到完整远端 mutation 和根/子记录 提交都保持共享锁;Fabric reconcile 先在锁内持久化关闭 gate,SSH 只读观测期间释放, 发布前重新取锁并复核资源互斥。并发回归覆盖 Fabric-first、VPC-first、删除、普通收敛、 lifecycle 收敛和外部观测发布,阻止旧 active gate 或变化后的 endpoint/CIDR 被继续使用。 该保证以部署的单 Uvicorn worker 为边界;多 worker 必须先增加跨进程 durable reservation/CAS,不能依靠 asyncio 锁。 - VPC 准入会扫描全部持久化 `fabric_desired` endpoint,不仅检查当前 VPC 固定的 Fabric;每条记录都必须能重建计划且已存 `plan_digest` 与重建 digest 一致, 损坏或 stale 记录 fail-closed。根删除不能改变已有 region/Fabric identity/revision/CIDR; 无历史记录但需清理宿主的删除目标同样先执行全局 endpoint/digest 准入。取消回归证明 caller cancellation 不会让 catalog 锁越过尚未返回的 `asyncio.to_thread` mutation 提前释放;引擎在持锁期间 drain 底层任务、完成 desired state/receipt 提交后才传播 `CancelledError`。 - 每个 VPC 数据面计划携带权威 `fabric_plan_digest`;apply、remove 与 observe 均重建并 严格校验 Fabric nft grammar、owner/digest、精确 tenant set 和完整最终 snapshot。 因此即使 VPC 自身三张表看似正确,Fabric revision 漂移或租户集合不一致也不能发布 active。 - repair timer 不会 restart 主 service:主 service failed 时,它只排队一次主 service 和此前确因 dependency 失败的 libvirt 单元;主 service active 且精确核验到 firewalld runtime trusted 漂移时,reconcile service 直接执行同一份带 flock 的完整 ACL-first helper,不重启主 Fabric unit 或 libvirt。健康状态不会进入 helper。 NetworkManager 的合法无持久 keyfile/运行期 profile 只把对应接口标成不可验证,不再 连坐无关 endpoint;被选中的 endpoint 接口仍必须具有持久、root-only 的可验证 profile。 - 首次 apply 只有在事务目录持久写入 `committed` 后才释放 Fabric flock,并同步启动独立 reconcile dispatcher;主 oneshot 已 active 时直接执行同一份完整 helper,inactive/failed 时则等待 systemd start 完成。apply 随后重新取得 flock,复核当前 CONF digest、防火墙模式、 Fabric/VPC nft、WireGuard、主 service/timer active,以及 emergency owner 和 inet+bridge 两张 guard table 均已消失,才返回成功。`RemainAfterExit=yes` 为首启后的 repair timer 提供 稳定 active 语义;提交后的旧进程无权删除共享 journal,dispatcher 失败时由 timer/helper 或下一次持锁 apply 消费。boot quarantine 使用有界、逐步校验的 bridge 端口快照并在每次 `link down` 后明确回读无 `UP`,命令失败、畸形/重复/超量输出、端口变化或 NetworkManager 重新拉起接口均 fail-closed。 - Python 3.12 全量 Engine 回归为 **1302 passed、10 skipped、5 failed、80 subtests passed**。5 个失败仍是本轮前已存在的 cloud-template spec snapshot、reinstall cleanup detail envelope 和 3 个公网池 fixture;Fabric、VPC、firewalld、endpoint 与 repair 新增 用例全部通过;Fabric 单文件最终为 **148 passed**,聚焦组合为 **650 passed、2 个上述 已知失败、5 subtests passed**。PHP/WASM 下 14 个相关管理/资源/资产合同与流程测试、 VPC 创建和 CIDR allocator 回归、Fabric Node 行为测试、两份 JavaScript 语法检查及 `git diff --check` 通过。 - 这些结果没有替代真实宿主机验收。AlmaLinux 10、Debian 13、native nftables reload、 NetworkManager/ifupdown 重启、libvirt socket activation、宿主重启、跨宿主 WireGuard 握手、MTU、SELinux、外部 NAT/安全组和允许/拒绝流量仍须按验收矩阵执行。 - nft CLI 不提供跨进程 CAS。本轮以完整 stateless snapshot、`nft -c` 后的最后 precommit 回读、原子 batch 和提交后回读关闭已知检查窗口;同机 root/CAP_NET_ADMIN 或其他 out-of-band nft 管理器仍须遵守维护互斥,不在事务中并发替换同名 table。 ## 2026-10-08:Fabric underlay 地址与 SSH 管理地址解耦 - Engine 宿主机配置增加可选 `fabric_endpoint_ip`;空值仅在 SSH `host` 为安全的字面 IPv4 时回退,当前公网组网无需重复填写。未来同地区宿主机已有互通内网时,可以逐台填写 本机内网 IPv4,而无需改变 Fabric/VPC overlay 架构。 - endpoint 仍由 Engine HostProfile 单点持久化,面板 `cloud_hosts` 不复制该运行配置。 管理员宿主机表单安全透传可选 IPv4;fresh probe 验证显式地址属于对应宿主机。 - Fabric readiness 只展示生效的 endpoint 和受限来源(专用配置或 SSH IPv4 回退),未知 来源会被折叠,不会增加 SSH 地址、凭据或原始输出字段。每台宿主机仍只公布一个 endpoint, 因此所选公网或内网地址必须能被同地区所有成员直接访问。 - PHP/WASM 下 endpoint、宿主地区、宿主错误、Fabric 静态契约和动态 readiness、公网池、 共享资产/抽屉回归通过;管理员 Fabric Node 行为测试和两份修改 JavaScript 的语法检查 通过。真实公网/内网 endpoint 可达性仍须按宿主机验收矩阵确认。 ## 2026-10-08:宿主机显示位置与 Fabric 地区解耦 - 宿主机编辑页把 `CloudHost.region` 明确标为“位置标签(仅展示)”;该字段仍按引擎边界 要求为 1 至 64 字符,但不再代表销售地区、Fabric identity 或 VPC 归属。权威归属由 active/draining 宿主机成员关系沿资源池、线路到 `CloudRegion` 唯一解析。 - Fabric readiness、fresh probe 和 VPC 成员门禁不再比较宿主显示标签或探针回传标签与 `fabric_region`。成员关系缺失、重复、断裂或跨地区仍 fail-closed,Fabric/VPC 固定的 identity、region、revision 回读仍要求精确一致。 - 引擎中存在但没有平台映射的自定义 Fabric 不会被自动认领或改写,继续进入 `migration_required`。没有增加旧配置兼容;仅保留本地区确定性 Fabric 在下发结果未知或 部分成功后的原有“重新核对”恢复路径。 - 静态宿主位置契约覆盖了表单与校验文案,Fabric/VPC 回归覆盖“显示标签不同但权威成员 关系相同”的正常路径,并覆盖实例 pool pin 不一致、多条 live membership、 pool/line/region 断链与跨地区拒绝。本轮 Engine Fabric/VPC/边界回归 `268 passed`, 21 个聚焦 PHP 测试脚本、7 个变更 PHP 文件语法检查和管理员 Fabric Node.js 行为测试 通过。开发环境仍未替代真实多宿主 WireGuard、native nftables、libvirt 和重启恢复验收。 - 扩大探测仍命中未修改的既有测试问题:`SourceSyntaxTest` 被 `AdminSystemLogsContractTest.php` 的双引号插值语法错误阻断; `CloudEngineReadinessTest` 保留了已过时的静态次数断言;`CloudProtocolTest` 未导入 `CloudOperationErrorCatalog`。三个文件均未在本轮修改。 ## 2026-10-08:raw JSON 部署收口为地区级向导 - 管理员“地区私网”页面改为四阶段内联向导:选择地区、检测宿主机、自动配置、重新 核对;全页仍只有对应后三步的三个操作按钮。浏览器只消费服务端 `workflow` 门禁和 `plan_preview` 只读摘要,不生成、编辑或提交节点/endpoint/raw JSON 计划。 - 公开管理 API 已移除 raw plan apply、按 Fabric ID 直接 reconcile 和地区映射 PUT/PATCH;只保留 Fabric/映射只读回读和三个按地区执行的空 body 动作。PHP 仍在服务端 生成并校验固定 DTO,再调用不对浏览器公开的 Engine 内部 apply/reconcile。 - 服务端按权威库存、映射与引擎回读投影引擎不可用、无宿主机、待检测、阻断、可配置、 待核对、active、需要迁移和需要恢复阶段。只在 fresh probe 完整通过后开放自动配置; 固定 desired state 不一致或缺失时不会在原 revision 下重建。 - “自动配置”仅接受无映射且无 desired state 的全新地区;活动/disabled 映射和未映射的 确定性部分成功只能走“重新核对”。所有 reconcile 都在宿主写入前重新校验平台拓扑、 fresh probe、详情/目录、冲突与精确计划;disabled 映射可在同 identity/region/revision 的 active 回读后安全激活,但每个未删除 VPC 也必须精确固定到同一三元组;旧空 pin 或 任一漂移都会进入迁移门禁,不会在宿主写入后才失败。 - 前端不会把非 `active` 的成功 HTTP 响应显示为配置成功;地区切换、重复点击、引擎不可用、 请求超时、网络中断和 HTTP 5xx 均有独立门禁。写操作结果未知按地区隔离,禁止重放 自动配置,只开放服务端 reconcile 恢复路径;其他地区成功不会解除该保护。 - 列表和地区动作响应不再携带冗余的完整 `fabrics`/`region.fabric` 节点计划;向导只收到 readiness 宿主行、标量回读和有界方案摘要。管理员按 Fabric ID 的显式 GET 详情仍保留 为只读诊断入口。 - PHP 8.5/WASM + SQLite 下 Fabric readiness、Fabric/VPC 控制面、VPC 创建/复用/CIDR/ 删除/tombstone、管理员资源调度、路由、模板、资产和防火墙相关回归通过;路由目标为 273 项、Smarty/email 模板 105 个、前端模块 52 个。新增 Node 向导行为测试、JS 语法、 修改 PHP 语法和 `git diff --check` 通过;未改 Engine 的 Fabric/boundary 定向回归为 **210 passed**。 - 扩大检查中的 `SourceSyntaxTest` 仍被既有 `AdminSystemLogsContractTest.php` 双引号插值 语法错误阻断,`CloudEngineReadinessTest` 仍保留与当前源码次数不符的旧静态断言;两处 文件均不在本次 diff。本节所列相关回归全部通过,但没有宣称这两个既有测试已修复。 - 结果未知集合当前属于页面内保护;彻底覆盖刷新或第二管理员需要服务端持久 operation ID/lease/phase。映射提交前已在长网络操作后重读拓扑,并在事务中锁地区、映射和 live VPC;跨全部库存写路径的 topology generation/CAS 仍是后续并发强化项。 - 开发环境没有连接真实多宿主 SSH、 WireGuard、native nftables 或 libvirt,生产部署仍须执行 Fabric 宿主机验收矩阵。 ## 2026-10-08:管理员地区宿主机 readiness 与自动组网 - 管理员“地区私网”页面现在以地区为唯一操作入口,正常操作严格只保留“检测宿主机”、 “自动配置地区私网”和“重新核对”三个按钮。页面新增地区 readiness 汇总、逐宿主机 清单与 Fabric 只读回读,不再让浏览器编辑 Fabric ID、overlay、revision、端口、节点 JSON 或地区映射;普通管理员只读,三个动作仍要求具有管理权限的超级管理员与 CSRF。 - 地区必须宿主机集合由 active/draining 资源池成员、非删除实例、非删除 VPC deployment 以及当前/冲突 Fabric 节点合并。缺失宿主机、资源池、线路、地区或 VPC 根,同一宿主机 存在多个 live membership,工作负载归属漂移、未映射自定义/跨地区 Fabric 占用和 重复/不可用 endpoint 均 fail-closed,不会因内连接缩小清单后继续写宿主机。宿主机 显示位置标签不参与地区归属判断。 - “检测宿主机”调用新的只读引擎探针;未知宿主机不会构造运行时或数据目录,每台失败独立 返回白名单状态。一次引擎请求最多 64 台、固定 16 路并发,同一进程不排队执行重叠 探针而返回稳定 409;PHP 可把最多 128 台 readiness 清单拆成两个批次。真正自动配置的 Fabric 仍限制为 2 至 64 台,并在写入前重新探测,不能复用浏览器里的旧检测结果。 - 自动 Fabric ID、地区、CGNAT `/24`、revision、UDP 端口、排序后的节点与 overlay `/32` 全部由服务端确定生成。既有映射要求 desired state 精确一致;映射缺失时只允许恢复形状 完全一致的确定性 partial success,不会用变化后的 inventory 在同 revision 重建。写入后 通过引擎精确回读、平台拓扑复读及数据库映射 CAS 才发布 active/ready,HTTP 超时则要求 使用“重新核对”读取固定 desired state。其他未绑定的自定义 Fabric 保持 `migration_required`,不作为旧配置自动兼容或认领。 - PHP 8.5.10/WASM + SQLite 下 `AdminFabricReadinessWorkflowTest`、 `AdminFabricContractTest`、`DrawerMotionAssetsTest` 及 7 个 VPC 策略/收敛契约测试通过; 275 条路由目标、105 个 Smarty/email 模板、52 个前端模块和 schema 契约通过。 `admin-fabric.js`、`vpc.js`、`drawer-motion.js` Node 语法、修改 PHP 语法、Python `py_compile` 与 `git diff --check` 通过。Engine Fabric/boundary 定向回归为 **210 passed**。 - Python 3.12.14 全量 Engine 回归为 **1097 passed、10 skipped、5 failed**。5 个失败 与本轮前的基线类别一致,分别属于既有 cloud-template spec snapshot、reinstall cleanup detail envelope 和 3 个公网池 fixture;本轮 Fabric/readiness 与 Engine boundary 没有 新增失败。 - 当前未连接真实 PHP-FPM、MariaDB、浏览器或 SSH/libvirt 多宿主机。生产验收仍须覆盖 WireGuard 握手、UDP/51820 underlay、MTU、SELinux、native nftables 持久化、 网络/防火墙重启修复和跨宿主机租户流量。不受支持或所有权不明确的组合 继续 fail-closed,不能直接清空生产防火墙。 反代与 PHP-FPM 请求终止/读超时建议至少 270 秒。 ## 2026-10-08:租户单自动子网与创建页简化 - 租户创建页只保留 VPC 名称和地区;CIDR、前缀、唯一子网、成员容量与成员私网 IP 均由平台管理。详情页不再显示子网管理卡片,成员加入也不再选择子网或手填地址;共享 前端资产版本已提升,避免部署后继续使用旧表单缓存。 - 删除租户 `POST/DELETE /vpcs/{vpc_key}/subnets...` 路由、Controller 入口和 Service mutator。新成员加入意图严格只有 `instance_id` 与 `request_key`,先锁 VPC 根及其全部 子网,确认恰好一个非删除、非清理中的有效子网,再从成员租约与 route `/32` 保留地址 之后自动选择最低可用 IP。仅为滚动升级重放已存在的同 key operation 才读取旧版 `subnet_key/private_ip`;这些字段不能创建新成员,新请求携带时返回 422,且不产生 member、lease、operation 或 revision 副作用。 - 自动子网缺失或正在清理时返回 409;历史数据若存在多个活动子网或无效子网账本则 fail-closed 为 503,不静默选择任一行。数据库表、引擎多子网 DTO 读取能力、根删除和 历史 `subnet_remove` tombstone 收敛逻辑继续保留;本轮没有增加会阻断历史升级的 `UNIQUE(vpc_id)`,也没有自动合并或删除历史数据。 - 成员加入继续把服务端选出的 `subnet_key` 与 `private_ip=null` 写入旧版 request hash, 保持旧自动分配请求可重放。重放检查先于当前子网和实例状态,并从不可变 operation payload 验证旧自动分配或旧显式 IP hash;因此丢失响应后,即使子网随后进入清理,刷新 到新版页面可用原 `request_key + instance_id` 安全读取结果,未刷新的旧页面也只能在 `subnet_key/private_ip` 与原 hash 精确一致时重放,参数变化返回 409。 - PHP 8.5/WASM + SQLite 下 `CloudVpcCreatePolicyTest`、 `CloudVpcMemberReuseTest`、`CloudPrivateCidrAllocatorTest`、 `CloudVpcRootDeletionTest` 和 `CloudVpcTombstoneConvergenceTest` 通过;源码契约 `CloudVpcControlPlaneContractTest`、`CloudVpcUserPageContractTest`、 `VirtualizationConfigTest`、272 条路由目标、105 个 Smarty/email 模板、52 个前端资产 模块及 schema 契约通过。修改 PHP 语法、`vpc.js` Node 语法和 `git diff --check` 通过。 - SQLite 不实现 MariaDB 的 `SELECT ... FOR UPDATE` 竞争语义,当前也未连接真实 MariaDB、PHP-FPM、浏览器或宿主机。上线前先只读审计所有非删除 VPC;下列查询必须 没有结果,再在隔离 MariaDB 中并发加入同一 VPC、并发重放同一 key,并确认只有一个 member、lease 和 operation: ```sql SELECT v.id, v.vpc_key, SUM(CASE WHEN s.state IN ('applying', 'active', 'degraded', 'uncertain') THEN 1 ELSE 0 END) AS live_subnets, SUM(CASE WHEN s.state = 'deleting' THEN 1 ELSE 0 END) AS deleting_subnets FROM cloud_vpcs AS v LEFT JOIN cloud_vpc_subnets AS s ON s.vpc_id = v.id AND s.state <> 'deleted' WHERE v.state <> 'deleted' GROUP BY v.id, v.vpc_key HAVING live_subnets <> 1 OR deleting_subnets <> 0; ``` ## 2026-10-08:租户 VPC 创建策略、账户配额与幂等加固 - 租户创建 API 现在只接收 `name`、`region_id` 和 `request_key`;CIDR、前缀、首个 子网、成员容量和 Fabric 身份全部改为平台策略。新 VPC 固定自动分配独立 `/24`,首个 子网覆盖该 `/24`,成员上限为 200;历史大 VPC 的 4096 协议/观测上界不变。 - 默认每账户最多保留 5 个非 `deleted` VPC,可用 `cloud_max_vpcs_per_account` 在 1 至 100 内调整。创建事务先锁账户行,再核对根、配额、 Region/Fabric 和 CIDR 分配;`deleting` 根仍占账户配额,`deleting` 成员仍占成员容量, 只有精确收敛为 `deleted` 才释放。 - 同一创建键的回放先于当前配额、Region/Fabric 状态和分配器策略;请求摘要只包含稳定的 名称与地区。历史创建摘要继续按确定性 root、owner/name/region、operation 和 allocator 链接兼容,但缺 operation、network/subnet 或精确 CIDR claim 闭集时 fail-closed。已删除 root 只返回原 tombstone,不复活 CIDR;released allocation 出现残留 claim 同样拒绝回放。 - CIDR 分配、root、首个 subnet 和 operation 位于同一默认数据库事务。删除了失败后的 二次 `release()` 补偿,避免事务回滚后与同 request key 重试竞态、误释放胜者 CIDR。 租户创建表单同步移除高级网络字段并提升资产版本,旧缓存不会继续提交已禁字段。 - PHP 8.5/WASM + SQLite 下 `CloudVpcCreatePolicyTest`、 `CloudVpcControlPlaneContractTest`、`CloudPrivateCidrAllocatorTest`、 `CloudVpcMemberReuseTest`、`CloudVpcRootDeletionTest`、 `CloudVpcTombstoneConvergenceTest`、`CloudVpcUserPageContractTest` 和 `VirtualizationConfigTest` 通过;覆盖强制 post-allocation 失败零泄漏、满配额回放、历史 hash、平台状态变化、deleted tombstone、live/released claim 损坏和 deleting 容量。 另通过 105 个 Smarty 模板编译、274 条路由目标、52 个前端资产契约、schema 契约、 修改 PHP 语法、`vpc.js` Node 语法和 `git diff --check`。 - SQLite 不实现 MariaDB 的 `SELECT ... FOR UPDATE` 并发语义;上线前仍须在隔离 MariaDB 上并发争抢账户最后一个名额、并发同 key 丢响应重试,并核对最终仅有一条 root、network、 claim 和 create operation。当前未连接真实数据库、PHP-FPM、浏览器或宿主机,也未改变 WireGuard/libvirt 宿主数据面。额外全仓 `SourceSyntaxTest` 仍被未修改的 `AdminSystemLogsContractTest.php:108` 既有解析错误阻断,不归因于本轮 VPC 修改。 ## 2026-10-08:VPC 来宾网络启动代次门禁 - 私网 MAC、`/32` 地址和唯一的 VPC CIDR scope-link 路由共同生成独立 guest-network generation;成员、自定义 route、ACL/Fabric 等纯宿主变化不改变该 generation。 - 运行中 VM 的新来宾网络不改写 NoCloud seed、inactive XML 或 live device;完全停机 后由 reconcile 写入 seed 与持久 XML,再启动消费。在完成 stop/reconcile/start 且 live metadata 匹配之前,宿主保持 `applying/pending_restart`,PHP 拒绝将缺失 `restart_required=false` 的证据视为 active/usable。 - 相同私网目标重试返回原 seed 字节,不重复轮换 NoCloud `instance-id`;写入 后会在 libvirt define 前重新下载 seed 并核对 MAC/IP/routes;缺少安全 boot 网络策略 的旧 seed 明确要求迁移,不通过新 instance-id 重放 credentials。 - current generation 还要通过 QGA 地址、link 与 route 的精确回读;保留地址/路由但 `NO-CARRIER`/`linkdown` 的接口不能通过。显式 link-down suspension 单独由 XML/config 证明隔离,恢复 link-up 后才重新要求 QGA usable 证据。 - `evidence_version=2` 使历史 XML-only succeeded 证据失效;宿主 config proof、每成员 guest readiness 与 VPC 聚合健康分别收敛,tombstone 不再被无关成员的 QGA 状态阻塞。 - 本地验证:Python compileall 通过;cloud-init、VPC 数据面、libvirt、协调器及删除回执 的定向回归 **394 passed**。完整 engine 回归为 **1071 passed、10 skipped、8 failed**;8 个失败已在本轮修改前的 `6dc0d21` 干净快照复现,属于既有云模板 spec、 重装错误 envelope、Python 3.9 upload timeout/event-loop 与退役宿主盘点式公网池 fixture。 - 隔离 PHP 8.5.10/WASM 下 5 个 VPC 契约/收敛测试全部通过,10 个修改 PHP 文件语法、 `vpc.js` Node 语法和 `git diff --check` 通过。当前宿主没有原生 PHP CLI;真实 libvirt/cloud-init 验收仍需在测试 VM 内核对地址、唯一 VPC CIDR scope-link 路由与跨 VM 连通性。宿主策略路由、代理 ARP 和 WireGuard AllowedIPs 仍必须保持精确 `/32`。 ## 2026-10-08:根 VPC 可恢复删除状态机 - 租户 API 新增根 VPC 删除:精确名称确认后,PHP 在事务中把根和子资源固定为 `deleting`,签署空 desired target、待清宿主机闭集及 `retiring_members` 身份清单。 普通变更不能覆盖该 revision;失败或响应丢失只能用原 operation/revision/digest 显式核对。 - 引擎在任何 SSH/libvirt 变更前持久化删除 marker,逐成员核对并移除持久化 `private0`、私网 metadata 与 cloud-init seed,再清理宿主机 VPC 数据面。部分宿主机 已确认时,重试只联系尚无精确不存在性证明的宿主机;完整 receipt 必须先持久化, 随后才能清理引擎 desired 记录。终态 receipt 只保留重放所需的操作身份、摘要、 宿主机闭集和时间戳,不永久保存成员 UUID、私网 IP 或 MAC;旧格式会自动压缩。 - PHP finalizer 严格核对 payload、receipt、历史/待清宿主机集合和子账本,然后验证 CIDR interval 与全部 /24 claim,最后用 revision CAS 释放地址。live allocation 的 幂等重放也会重新证明 claim 闭集;畸形 VPC 核心/子表、残留 claim 或未完成根删除 均会阻止账户删除。只有完成删除的子账本会被清理,以释放全局 member 唯一键;根、 宿主机和 operation 保留为审计 tombstone。 - 前端只有详情接口明确返回 `state=deleted` 才结束删除提示;分页列表缺失或 404 不会被 当作成功。`deleting` 期间锁定所有普通编辑,仅保留“核对 / 重试”。 - 直接相关 Python 模块回归:**429 passed、56 subtests passed**;覆盖 VPC 协调器、 数据面脚本、内部 API 和 libvirt 持久 XML/metadata/seed 清理。完整 engine 回归为 **1007 passed、10 skipped、80 subtests passed、5 failed**;5 个失败在未修改的 `7f9fb9c` 干净快照逐项复现,分别属于既有云模板 spec、重装错误结构和公网 IP 池 fixture,不是本次删除状态机引入。 - 隔离 PHP 8.5/WASM 下 `CloudVpcRootDeletionTest`、 `CloudPrivateCidrAllocatorTest`、`CloudVpcControlPlaneContractTest`、 `CloudVpcUserPageContractTest`、`ManualAccountDeletionSqliteTest` 和 `ManualAccountDeletionTest` 全部通过;本轮 11 个 PHP 文件语法、274 条路由目标、 `vpc.js` Node 语法、Python `compileall` 与 `git diff --check` 通过。 - 当前没有连接真实 MariaDB、SSH/libvirt、nft、NetworkManager 或 ifupdown 宿主机。 生产验收必须覆盖多宿主机部分失败/重启续跑、HTTP 回执丢失、真实 seed 重写和数据面 移除回读。含私网成员的根删除要求相关 VM 已停机;managed-save 或原生快照存在时会 保留 tombstone 并拒绝继续,处理阻断后再显式 reconcile。 ## 2026-10-07:在线更新后部署页 SQL 回归修复 - 在线更新到 `521d40a` 后,`/user/cloud/deploy` 在读取销售目录时会因 `cloud_hosts` 不存在 `host` 列而返回 500;同一错误也影响管理员资源汇总。根因已在 `e7230ff` 修复,应用查询现在只使用面板资源策略、reservation 和已物化的公网 IP ledger。 - 管理 IPv4、网关和 DNS 必须在地址池 `reserved_ips` 中显式保留;代码不再从宿主机模型读取 SSH/管理地址,也不通过宿主机盘点补全地址。 - saleCatalog SQLite/WASM 首屏 smoke 通过;部署 SSR、资源调度、IP ledger、宿主机网络池/调度、模板编译、虚拟化资产和 Node JS 语法检查通过。完整财务流程继续执行到既有 reconciliation 场景后失败,不能把该失败归因于本次缺失列修复。 - 代码修复提交为 `e7230ff`,随后补充部署 smoke 与验证记录文档;提交链已推送到远端 `venix`。真实 PHP-FPM、MariaDB、浏览器和宿主机仍需部署验收;上线后应同时检查 `/user/cloud/deploy`、`/api/v1/catalog` 和 PHP-FPM 错误日志。 ## 2026-10-07:移除账户实例数量上限 - 删除账户实例数量配置、购买事务中的账户级 409 检查,以及金融测试中依赖该限制的场景;账户实例数量现在只受销售库存、宿主机面板容量、reservation 和具体公网 IP 账本约束。 - 全仓精确搜索未发现该配置键或账户上限错误文案的 CSS、JS、SQL 残留;`cloud_host_capacity_policies.max_instances` 保留为单宿主机调度容量,分页大小和快照/防火墙等其他实例上限也未误删。 - 账户上限相关的财务流程已越过,完整金融测试仍在既有 reconciliation fixture 处失败;具体契约、模板、JS 语法和 `git diff --check` 通过。真实 PHP-FPM、MariaDB 和并发购买仍需部署环境验收。 ## 2026-10-07:面板资源账本取代宿主机盘点 - 调度、创建放置和网络选项现在只读取面板配置的容量策略、活动资源池、reservation 账本和 `cloud_public_ips`;不再要求容量快照、盘点新鲜度、宿主机 `host/network-options` 或 VM discovery 结果。 - 创建和换 IP 的引擎路径只读取面板传入的具体地址池参数与持久 claim,并用原子 claim 防并发重复;不会为每个请求枚举宿主机全部虚拟机。 - 宿主机保存/连接测试只验证 SSH、存储池和网络资源,不调用 `list_vms()`;用户 VM 列表和指定 UUID 的状态读取仍保留为用户操作及结果核对路径,不参与容量或 IP 调度。 - 用户列表、实时状态和生命周期状态同步只向引擎发送面板已知的 UUID(每批最多 100 个);旧的无参数全量状态接口仅为未接入面板的私有兼容 UI 保留。 - 引擎本机兼容 UI 仍保留全量 `/api/v1/vms`、无参数 `/api/v1/vm-states` 和资源目录接口;它们不进入 PHP 调度链,部署只允许 `127.0.0.1:8000`,不能作为公网管理入口。`inventory-panel` 是旧 UI 的通用卡片类,不代表已保留宿主机容量盘点功能。 - 旧 `cloud_instances.spec_json` 的可验证资源与公网地址会在地址池物化时迁移到面板账本;缺失、损坏或重复数据会阻止该宿主机调度。管理宿主机 IPv4 需在 `reserved_ips` 中显式保留。 - 私有引擎仍负责最终宿主机操作和具体 IP claim。网络超时或响应不确定时保留 `operation_id` 与 reservation,先核对再决定补偿;同一 client token 重试不得重复创建。 - 最终隔离回归:`engine.tests.test_libvirt_service` **183 passed、10 skipped**;`test_app.py` 与 `test_engine_boundary.py` **205 passed、4 failed**。4 个失败均为既有的云模板平台策略断言和 Python 3.9 上传超时/事件循环兼容问题,不涉及面板调度、IP 账本或盘点删除路径。 - PHP/WASM 契约测试通过:`CloudInstanceReadPerformanceTest`、`CloudInstancePageSsrContractTest`、`AdminHostNetworkPoolsContractTest`、`AdminResourceSchedulingContractTest`、`CloudNetworkIpLedgerContractTest`、`AdminHostSchedulingContractTest`、`CloudMultiHostSchemaDefinitionTest`、`VirtualizationAssetsTest`。 - `python -m compileall` 与 `git diff --check` 已通过。当前 macOS 工作区没有 PHP CLI、Composer 依赖、真实 MariaDB、systemd journal 或 libvirt 宿主机;PHP 契约测试使用隔离 WASM 运行时,真实引擎/数据库验收仍需在部署环境复跑。 ## 2026-10-06:系统日志异步读取与详情 - 系统日志首屏改为只渲染页面框架,列表 API 增加浏览器截止时间、显式停止读取、旧响应隔离和 `journalctl` 子进程的有界回收;分页游标使用 `--cursor` + `--reverse`,按 systemd 的实际 seek 语义从边界向更早记录读取,并防御性移除意外返回的边界记录。 - 新增管理员只读详情接口,按列表携带的 UTC 微秒时间戳和服务窗口重新读取单条记录,再校验 journal cursor;返回受限的完整诊断字段和完整消息。日志轮转、字段上限和敏感字段省略均有明确状态。 - 使用工作区捆绑 Node 运行并通过 `AdminSystemLogsBehaviorTest.mjs`、`AdminOperationsCancelBehaviorTest.mjs`、日志页 JavaScript 语法检查和 `git diff --check`。 - 当前 macOS 工作区没有 PHP CLI、Composer 依赖或 systemd journal,因此 PHP 契约测试、真实 PHP-FPM 子进程超时回收和远程宿主机日志读取仍需在部署环境复跑。 ## 2026-10-06:修复系统日志详情抽屉不可见 - 现场复现确认:日志行的鼠标点击和键盘事件已经执行,详情请求也可发出;页面没有视觉反馈是因为日志页直接调用 `showModal()`,绕过了共享抽屉的 `is-drawer-visible` 动画类,抽屉因此保持在屏幕右侧的初始变换位置。 - 日志页现在统一使用 `VenixDrawerMotion` 打开和关闭详情,缺少共享脚本时仍有可见的降级路径,同时锁定页面滚动、恢复触发行焦点,并拦截原生 `cancel` 事件以完成动画关闭。 - 详情对话框位于日志 `
` 外,详情消息和字段样式已改为直接以 `#system-logs-detail` 作用域,避免样式选择器永远不匹配。 - `AdminSystemLogsBehaviorTest.mjs` 现通过嵌套消息元素模拟真实冒泡点击,并验证鼠标、Enter、空格、共享 motion、可见类和滚动锁;资产版本更新为 `2026100602` 以避免部署端继续使用旧脚本。 ## 2026-10-04:盘点只读并发与删除驱动清理(历史记录,盘点方案已退役) - `host/capacity`、`host/network-options` 与诊断查询已从引擎全局写锁、在线更新修复及 ISO/云镜像惰性清理中拆出;删除后的宿主缓存回收只由持久 tombstone 监督器重试。诊断专项回归:**33 passed**,覆盖慢盘、取消/晚完成、满接纳窗口终态、淘汰失败上界、异常引用释放及 daemon writer 退出边界。 - Python 3.12 全量隔离回归:**762 passed、10 skipped、68 subtests passed、1 failed**。唯一失败仍为 `test_app.py::test_native_public_pool_blocks_silent_default_network_change` 的既有 409“公网地址池目录存储不可用”;该失败在本轮修改前已有独立复现记录。 - 本轮没有修改 PHP 或前端源码;当前工作区没有 PHP/Node 可执行文件,因此未重复运行上一节的 PHP/WASM 与页面行为测试。 - 未连接真实 MariaDB、systemd 或 SSH/libvirt 宿主机。该轮并发盘点验证属于历史实现;当前上线验收应改为并发创建、IP reservation、相同 client token 重试及 `operation_id` 对账,并验证显式删除模板后的离线宿主重试与代际保护。 ## 2026-10-04:宿主机盘点诊断(历史记录,相关页面和服务已删除) 本轮只增加过渡期诊断历史、管理员页面和跨 PHP/引擎阶段证据;每请求 8 秒预算、容量/IP 提交代际和调度判定不变。该页面和服务不再属于当前部署路径,以下结果仅用于解释迁移前的基线。 - Python 3.12 全量隔离回归:**747 passed、10 skipped、68 subtests passed、1 failed**。新增诊断用例覆盖签名/权限、锁等待、存储失败降级、嵌套阶段、取消请求与 worker 晚完成、重启和保留上限。 - 唯一 Python 失败为 `test_app.py::test_native_public_pool_blocks_silent_default_network_change`:测试创建公网池返回 409“公网地址池目录存储不可用”,预期 200。在修改前的 `fad3b4e` 独立源码快照中复现同一失败;未在本轮扩大范围修改。 - 隔离 PHP 8.5.10/WASM、精确 `composer.lock` 依赖与 SQLite 测试曾覆盖盘点客户端、诊断、同步服务和关系边界;这些盘点专项名称和结果仅保留作迁移前记录,对应页面、同步服务和诊断服务当前已删除,不再列入本版执行集。 - 扩展 PHP 检查另发现两项既有失败,均在 `fad3b4e` 快照复现:`CloudProtocolTest.php:85` 的源码断言插值 `$actor`;`CloudAdminOperationsServiceTest.php:245` 的查询字段断言与原服务选择 `payload_cipher` 不一致。本轮未修改这两个测试或其既有服务。 - 过渡期盘点页面行为测试、相关 PHP 语法、两份 JS 语法及 `git diff --check` 曾通过。该页面和测试已删除;当前前端验收应覆盖宿主机调度抽屉、面板容量计算、IP 账本筛选和操作核对。 - 未连接真实 MariaDB 或远程宿主机,没有验证生产 PHP-FPM/systemd、cURL 传输、SSH/libvirt 延迟或诊断持久化的实际 I/O 开销;不能据此声称用户当前 `unavailable` 的根因已确定。真实环境启用后,应依据新增记录验证失败层和最后确认阶段。 ## 2026-09-27:集成基线 2026-09-27,集成代码的隔离验证,不代表生产验收。 - 当前 macOS 工作区 Python 3.12 回归:515 passed、10 skipped、55 subtests passed。覆盖原虚拟化逻辑及私有 API、签名/重放、多宿主机归属、持久幂等、一次性 VNC、退出后断权、带宽 XML、救援上传摘要,以及到期断网/恢复、同实例变更串行、多网卡 live+config 断网/恢复、退出救援保持计费断网、流量累计检查点和破坏性操作结果核对。生产仍按部署文档使用 Python 3.12 或更新的受支持版本复测。 - 隔离 PHP 8.5.10 验证源码语法、Smarty 模板、路由目标、精确金额/HMAC、SQLite 购买开通/退款/超时核对、宿主机面板容量/IP 账本、租户隔离、Cookie/Redis 会话撤销及内省、统一用户资源和 noVNC 模块;账户固定实例数量上限已删除。本次账期与生命周期用例应覆盖提前续费、精确扣款幂等、RX+TX 额度、断网不关机、下期恢复、到期仅断网、3 天宽限期内续费恢复,以及宽限期结束后的实例与受管磁盘删除;当前 macOS 工作区没有 PHP 可执行文件时,需在下方 PHP 8.5 环境命令中复跑。 - Chrome 使用模拟 API 检查套餐购买、VM 详情/指标/凭据、公钥、重装/救援、后台宿主机/镜像操作与 CSRF;用户账户及登录等页面进行桌面/手机布局检查。不连接真实数据库或宿主机。 - PHP 隔离环境不提供 sodium:`CloudSecretsTest` 明确跳过,原 Paytaro/易支付密钥加密测试因同一缺失无法运行;财务/会话测试的加密存储仅用明确标注的测试替身,不作为实际加密验证。生产必须安装 sodium,没有弱加密回退。 - Python 的跳过项需要真实 libvirt/网络环境。没有验证真实 MariaDB 并发、AlmaLinux systemd、宿主机 VM 操作、SMTP、支付和大文件上传。 ## 2026-10-12:libvirt 超时隔离与统一关闭期限 - 修复可靠性审查的第 3、4 项。生产 libvirt 连接/RPC 使用真实 spawn 子进程隔离、连接总预算和单次 RPC 预算;关闭 socket 后回收 worker 及 SSH 进程组。写入结果未知时保留 fsync 意图文件、宿主写入保护、原任务与 `safe_to_refund=false`,不把本地取消当成远端回滚。 - 六个宿主任务池、共享导入池、指标线程、Fabric/VPC 维护、各宿主生命周期及默认 asyncio 执行器共用 20 秒关闭预算。Uvicorn 请求排空 10 秒,unit 的 systemd 最终停止期限为 45 秒、`KillMode=control-group`。配置及维护恢复流程见 [执行期限与停机说明](LIBVIRT_EXECUTION.md)。 - 最新专项回归 **61 passed**,覆盖真实子进程卡死/回收/进程组、native 错误字段与句柄、VMService 吞异常、重启后持久写入保护、关机竞态、unlink/fsync/信号失败、默认执行器与后台线程无法返回时的 Python 进程退出、总关闭 deadline。测试使用假 libvirt 后端,不连接真实宿主。 - 最终 Python 3.12 全量引擎回归:**2178 passed、19 skipped、10 failed、80 subtests passed**(`PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=engine python -m pytest -q -p no:cacheprovider engine/tests`)。10 个失败均为下一项已在修改前源码复现的既有失败,本轮未发现新增失败。 - 使用修改前 `cda57ce93e6206f30612aab30ef85843713b3065` 的独立源码快照核对既有失败:`test_app.py` 两项旧契约期望;Fabric helper 两文件共五项 phase/owner/function 失败;`test_registration_http.py` 三项公网地址排除/池耗尽期望失败。这些不属于本轮超时/停机改动,未修改相应业务逻辑或放宽其断言。注册测试仅更新指标替身接口,并让多个会话共享一个应用生命周期。 - Python 源码语法解析与 `git diff --check` 通过。当前 macOS 未执行真实 Linux systemd、SSH/libvirt、QGA、大镜像或长快照验收;没有部署或重启服务。AnyIO 等外部框架同步线程、文件系统或操作系统异常仍可能需要 systemd 的最终强制终止,不能据此宣称任意阻塞均可优雅取消。 ## 2026-10-12:资源隔离与持久执行协调 - 修复可靠性审查第 1、8 项。删除全进程 `_CREATE_LOCK` 和整请求更新协调锁,改为按 VM、宿主分配/存储、救援模板区分资源;宿主应用的状态锁不再覆盖普通 VM 的远程调用。历史 VM 的本地锁可回收,宿主身份更换仍受维护准入保护。 - 使用现有加密 `engine_records` 与数据库 CAS 持久化执行身份、资源和维护占用。HTTP 取消不释放仍在执行的请求;后台线程池、Fabric 异步任务及缓存维护在交接前持久占用,VPC 成员线程继承执行上下文。未知结果跨重启保留,不按 TTL 接管、不自动重放或据瞬时不存在退款。协议、旧任务升级与人工核验流程见 [执行协调说明](ENGINE_COORDINATION.md)。 - 新增专项回归 **110 passed**:覆盖真实 spawn 进程争抢同一加密数据库记录、资源/操作/维护排他、CAS 提交回执丢失、取消及重启保留、不同宿主与同宿主不同 VM 并行、后台交接、排队快照取消、Fabric 完整执行收据、VPC 线程上下文、本地锁回收、救援模板互斥和明确执行前失败释放。 - 最终 Python 3.12 全量引擎回归:**2286 passed、19 skipped、10 failed、80 subtests passed**(`PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=engine python -m pytest -q -p no:cacheprovider engine/tests`)。10 个失败与上一节修复前基线逐项一致:`test_app.py` 两项、Fabric helper 五项、`test_registration_http.py` 三项;未扩大范围修复或放宽这些断言。全量后补充的本地模板锁超时用例已包含在上述 110 项专项结果中。 - 现有维护准入测试调整为活动 VM 请求期间返回 409、结束后重试成功;未知写入测试改为保留原 operation、凭据和 IP,且不触发缺失性核对。停机测试仅补齐新状态字段,原期限断言保留。源码语法解析与 `git diff --check` 通过。 - 多进程测试使用真实加密 `DatabaseStore`,以 SQLite `BEGIN IMMEDIATE` 适配 MariaDB 行锁语法;不能代替真实 MariaDB 事务、故障和吞吐验收。未运行真实 Linux systemd、SSH/libvirt、QGA 或宿主机测试,没有部署。未修改 PHP 源码,未运行 PHP 测试。本次仍保留单 worker 部署;未来多 worker/Go 写入者必须遵循同一协议,其他目录及运行时状态仍需单独验收。 ## 2026-10-12:VPC 应用与 libvirt 启动隔离 - 新组网不再为宿主 libvirt 安装 generator/drop-in、添加启动依赖或自动启动 daemon。 旧版平台 generator 仅在精确模板、归属与摘要匹配后,通过带快照的事务移除;未知 文件保持原样。新增 helper/unit 版本标记,使同 revision/digest 的旧成功计划也会 在管理员“重新核对”时真实更新。升级动作和映射恢复分支见 [Fabric 验收说明](FABRIC_HOST_ACCEPTANCE.md#保持-libvirt-原有启动配置)。 - 实际执行生成的宿主程序,复现并修复 VPC observe 的嵌套 AWK 语法错误、裸 IPv4 与 `/32` 差异、按设备过滤时省略 `dev`,以及协议 186 被显示为 `bgp` 的误判。 宿主使用数字路由输出,QGA 只补回固定查询已确定的设备,仍拒绝漂移和未知记录。 - 尚未写入私网的运行中 VM,可通过重复核对 live/inactive XML、受管 seed 和空 QGA 账本确认已不存在;真实私网残留仍要求停机。未决 QGA 记录、成员和 IP 只能在精确 清理证明后释放。页面补齐停机、原操作核对、启动验证的步骤及受控错误原因。 - 明确失败的创建/加入/移除操作允许用户显式核对,固定原 operation/revision/digest; worker 无权自动重试 failed。原 running/uncertain/waiting_observed 操作再次收到 4xx 仍保留未知结果。普通 VPC 修改在成员有未完成实例任务时回滚;任务锁使用 NOWAIT 当前读,避免与任务完成流程互相等待,缺少支持时拒绝变更,不回退到快照读。 - 专项回归通过:宿主路由与 VPC 数据面 **119 passed**;libvirt/VPC 协调与执行账本 **110 passed**;Fabric 版本迁移、路由与真实 artifact 观察 **205 passed**。 测试覆盖已发布旧模板的事务迁移/回滚、篡改文件保留、同计划升级及升级后二次跳过。 - 最终 Python 3.12 全量引擎回归:**2380 passed、19 skipped、10 failed、80 subtests passed**(`PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=engine python -m pytest -q -p no:cacheprovider engine/tests`)。 10 个失败 ID 与 `9f3a090` 基线逐项一致:`test_app.py` 两项、Fabric helper 五项、 `test_registration_http.py` 三项,没有新增失败。旧测试中要求重启 libvirt、必须存在 generator、使用旧路由命令格式的契约已按本轮行为更新,最终全量包含这些回归。 - 隔离 PHP/WASM 最终 **12 个 PHP 测试文件、1 个页面行为测试**通过,JavaScript 及 5 个 PHP 文件语法检查通过。SQLite 实际事务覆盖任务冲突回滚、原操作显式重试、 清理证据不足不释放、受控停机原因透传,以及 worker 候选切换后不自动重试新 failed。 NOWAIT 查询另覆盖 SQL 编译、锁冲突和数据库故障注入。扩展检查中的 `CloudEngineReadinessTest.php` 仍有既有静态断言失败:它要求两处观察跳过判断, `9f3a090` 与当前相关生命周期源码均只有一处;这些文件本轮未修改。 - 未连接真实宿主、SSH/libvirt、QGA、systemd 或 MariaDB;没有部署或重启服务。 PHP 使用隔离 WASM 与实际 SQLite 事务,SQL 编译和异常注入不能替代 MariaDB 并发 验收。真实 stop/reconcile/start、旧宿主升级、重启后 ACL 和跨 VM 连通性仍按 [VPC 验收步骤](VPC_DATAPLANE_ACCEPTANCE.md) 执行。旧未知电源任务未自动终结。 ## 2026-10-12:用户 VPC 页面排版与全新安装命令 - 收紧 VPC 列表宽度,扩大详情工作区;统一说明、成员 IP 和状态的字号与间距。 路由和 ACL 改为随宽度分行的表单,修复桌面展开高级策略后字段和保存按钮被裁切。 窄屏列表限制高度并可滚动,成员、诊断和创建弹窗按移动端排布。资产版本更新为 `2026101202`;不改变 API、任务状态或清理证明。 - Node 页面行为及 JavaScript 语法检查通过;隔离 PHP/WASM 的 `CloudVpcUserPageContractTest`、`CloudFirewallUiContractTest` 和 `CloudHostFabricEndpointContractTest` 通过。浏览器使用真实模板/JS/CSS、模拟 用户壳与本地 API 数据,覆盖 1440、1280、1024、768、390、320 像素,包含已生效、 待添加成员、部分失败、展开策略、空列表和创建弹窗。48 个常规场景和 16 个长名称、 最大端口等边界场景通过,无横向溢出、控件裁切或脚本错误;列表按钮均可滚动到达。 没有连接真实账户或宿主。 - 新增 [已有运行环境的全新安装命令](FRESH_INSTALL_COMMANDS.md),覆盖 `venix` 拉取、Python 虚拟环境、配置/空库导入、密钥及 FPM 权限、所有必需 systemd 服务 和签名健康检查。命令已对照当前代码与 unit,Bash/Python 语法检查通过;未在本机 执行安装、导库或服务启动,真实服务器安装仍需按实际目录、PHP 路径和 FPM 用户配置。 ## 2026-10-12:宿主连接测试和保存的执行身份 - 修复 `b3ea192` 引入的暂存连接构造回归:`new_service` 开始使用执行身份后, 注册路径仍传入只有 URI 和资源设置的临时配置,导致 `host_scope` 读取不存在的 `host` 字段并报 503。该临时配置自最初实现就未含 `host_id`,问题不来自套餐或 用户接口移除宿主字段。 - 私有引擎从可信 `StableHostManager.host_id` 显式传入执行身份;首次注册、编辑、 连接测试及保存后的 VM 操作继续共享同一宿主预算、存储锁和未决写保护。 身份异常在 libvirt 写入前返回 409;独立模式仅使用已验证的地址、端口、指纹。 不改变数据库结构、指标哈希、VM 归属键或用户 API。详见 [宿主注册与执行身份](ENGINE_COORDINATION.md#宿主注册与执行身份)。 - 新增宿主作用域回归 **25 passed**,保留真实 `VMService` 构造、资源查询、存储 准备和连接适配逻辑;SSH、RPC 运行时及远端对象使用替身,资源锁入口记录实际键。 覆盖首次添加/编辑、测试/保存、变化的暂存 URI、非法内部身份、请求体注入、独立 模式和存储失败回滚,并校验读写预算及 `storage:7`。隔离加载修复前 HEAD 的 `app.py` 运行其中 7 个正常场景,全部复现 `KeyError: 'host'`。额外通过真实签名 请求和 `EngineApplication` 协调器验证非法身份:请求期间存在活动占用,409 后 暂存连接清理且占用释放,未启动 libvirt 操作。 - libvirt RPC、持久协调及资源锁回归 **67 passed**。扩展应用、私有边界、引擎协调、 数据库 HTTP 和指标回归 **293 passed、2 failed**;两项失败在修复前 HEAD 同样复现:模板创建期望缺少 `platform_network_policy_snapshot`,重装未决错误 用例仍读取 `detail` 而实际返回 `error`。未放宽断言或修改这些无关业务逻辑。 三个既有测试替身仅补齐生产已有的暂存 metadata 和可信 manager 身份契约。 - 使用 Python 3.12.14 与真实 pytest 9.1.1。本轮修复验证没有连接生产 SSH/libvirt、 部署或重启服务;真实新增宿主流程仍需更新引擎后验收。旧未决协调记录保持原样, 不因修复自动清空或重放。 ## 2026-10-12:连接失败占用、快照解冻和停机 VPC 路由回归 - 连接建立失败现在使用 `libvirt_connection_failed`,明确尚无远端写入时释放本次 请求和资源占用;恢复连接后可重新保存宿主或提交新的 VM 操作。同执行的嵌套 资源和线程池任务共享写入证据,不能用后一次连接失败掩盖前一次写入。VPC/Fabric 混合 SSH 流程不放宽。宿主指纹扫描、暂存准备和只读 SSH 探测失败还须持久化未开始 凭据,全局/指定宿主入口一致;凭据保存失败则保留保护。旧 uncertain 占用不会自动解除。 - 新文件系统快照在冻结前绑定原任务、VM、实时运行代令牌和备份目标,并持久记录 冻结/启动/解冻边界。原 RPC 超时回收后立即尝试受限解冻;启动核对复用该入口。 解冻前的身份/备份核对与解冻后的异常分开,避免将已发送但结果未知的解冻当成 未执行而重放。解冻确认后原 libvirt 意图、协调占用和备份 uncertain 状态保持; 旧记录或证据不足时显示立即人工核对提示。恢复步骤见 [快照冻结后的限定解冻](LIBVIRT_EXECUTION.md#快照冻结后的限定解冻)。 - 受管私网 bridge 的单个 `linkdown` 保留在路由回读中,可证明停机时配置存在, 但不能证明 host 或对应成员 active/usable。WireGuard、guest 路由、未知/重复 flags 继续拒绝。覆盖停机首次加入、开机、停止最后成员、停机修改重试和再次启动。 原始路由生成脚本的两个新增关键场景在修复前 `b82f3b8` 副本失败,修复后通过。 - 新增签名请求/真实 VMService 协调回归 24 项;宿主身份相关 25 项继续通过。 VPC 相关 7 个测试文件 252 项通过。快照恢复通过真实 spawn 子进程和持久模拟远端 覆盖冻结后超时、精确备份目标、错误任务/VM/运行代、旧 worker 存活、阶段落盘失败、 响应未知不可重放、解冻后异常及普通写仍被阻挡;另通过 HTTP 后台入口验证无轮询 即发起恢复,以及 `safe_to_refund=false` 和原占用仍保留。快照恢复专项组合 82 项通过,其中包含 24 项新增 RPC 恢复和 2 项新增 HTTP 后台入口测试。 - 最终全量引擎回归:**2471 passed、19 skipped、10 failed、80 subtests passed**, 本轮共增加 66 个测试场景。10 项失败与修复前 `cda57ce` 隔离基线逐项一致: `test_app.py` 两项既有契约期望、Fabric helper 五项、`test_registration_http.py` 三项公网地址池期望;没有新增失败,未修改这些业务逻辑或放宽断言。快照测试替身 补齐新增恢复任务参数,原运行中快照阻止断网的断言继续通过。 - Node `CloudVpcUserPageBehaviorTest` 通过;隔离 PHP/WASM 的 `CloudVpcUserPageContractTest`、`CloudVpcFailedReconcileTest` 和 `CloudVpcMutationAdmissionTest` 通过。Python 修改文件 AST 与 `git diff --check` 通过。此轮没有修改宿主机 libvirt 启动项、启动依赖或执行生产部署。 - 使用 Python 3.12.14 和 pytest 9.1.1;没有连接真实 SSH/libvirt/QGA 宿主, 未执行真实 Linux bridge/WireGuard 或 MariaDB 验收。部署后仍需在专用测试宿主验收 丢失 libvirt 响应、来宾解冻、停机 VPC 修改与再次启动;隔离测试不能代替这些检查。 ## 2026-10-12:VPC 真实回读和活动网桥重复核对 - 修复 nft ARP 规则的 Ethernet/ARP 元组、数字 hook priority 回读、WireGuard AllowedIPs 完整字段读取、overlay 地址范围和 `ip -j` 空对象解析。所有观察仍校验 owner、revision、digest、成员集合及完整规则,不用省略检查换取 active。 - 统一严格 bridge-port 解析;apply 在 DOWN 前保存路由、proxy 与 sysctl,早期失败 不删除尚未修改的原路由。回滚恢复运行态并证明桥身份;后续提交失败重新隔离, 不能留下已开放但归属写入失败的网桥。已有 tap 的 NetworkManager 网桥保留 原连接 UUID、ifindex 和端口集合,不再通过 managed no 或 connection up 拆除端口。 - 修复 Fabric 本地 catalog 事务取消边界,以及尚未进入宿主操作的 VPC 锁冲突被 错误保留成新的未知执行占用。已有远程写入证据、存储故障及操作中取消仍保持未知。 - 回归分别通过:VPC/Fabric 活动桥与回滚组合 **876 passed**,冻结后的 Fabric 保桥专项 **35 passed**;补充既有协调、探针、libvirt 接入等范围 **780 passed、 14 skipped**(缺少 Linux proc/netns 条件)。三处历史 helper 测试替身已按当前 native nftables 事务契约适配,所在日志模块 **41 passed**。这些范围部分重叠, 不能相加作为唯一用例数,也不代表全量引擎测试。 - 用户 VPC Node 行为、JavaScript 语法、修改 Python AST 与 `git diff --check` 通过。真实 nft 内核隔离矩阵、系统重启和完整故障注入仍需 Linux 验收环境。 - QGA 固定路由探针的权限拒绝返回单独原因,保持未核验;严格拒绝畸形 exitcode、 截断或非预期 stderr。最终 libvirt 服务模块 **246 passed、73 subtests passed**; PHP/WASM 8.5 的 VPC 收敛回归与修改 PHP 语法检查通过。该模块与上述范围重叠。 - 现场进一步修复 observer 的三个 Shell 兼容问题:无可选 `nmcli`、空 proxy 集合不再触发 `set -e` 提前退出;NetworkManager/ifupdown 持久化分支显式分组, 避免 `&&`/`||` 同优先级导致合法 NM 配置被判失败。两个新增真实 Shell 回归模块 **56 passed**,覆盖缺失、外来、重复与双重归属的拒绝边界;与既有 dataplane 模块的组合 **82 passed**,范围重叠。 - 现场两台宿主机核对证明:私网 tap、精确 `/32` 路由、proxy ARP、WireGuard AllowedIPs 及三类 nft 规则均可恢复并回读。未改动 libvirt unit、启动依赖或 enable/mask 状态。成员间 ping 命中未配置允许规则的默认拒绝;来宾 SELinux 另行拒绝 QGA 的路由查询。两者都不能通过修改数据库成功标记或放宽证据门槛处理。 默认 ACL、来宾权限和恢复验收步骤见 [VPC 验收说明](VPC_DATAPLANE_ACCEPTANCE.md)。 ## 在具备依赖的环境复测 不要使用生产数据库/宿主机运行额外真实集成测试;以下默认单元/隔离测试: ```bash cd /home/virt-cloud/web for test_file in tests/*Test.php; do php "$test_file" || exit $?; done cd /home/virt-cloud/engine .venv/bin/python -m pip install -r requirements-dev.txt PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -m pytest -q -p no:cacheprovider ``` PHP 测试需 Composer 开发可用依赖和测试所用 PDO SQLite。测试中的模拟凭据、地址与密钥不是部署配置。 上线前按 [部署说明](DEPLOYMENT.md) 完成测试用户的实际购买、首次 SSH 登录、重装、救援、VNC 撤销、故障清理退款与无人登录时持续采样。另须使用短测试账期实际验证:到期只断网、宽限期续费恢复网络、宽限期结束后 VM 定义/系统盘/cloud-init 盘均被删除,以及删除失败或响应丢失时不会错误标记成功。共享公网网桥的 IP/MAC 防欺骗及宿主容量调度尚未提供,不能只凭单元测试开放不受信任客户的资源销售。