[AIW-08] 完成 AI 原生工作区跨平台与故障恢复总验收

[TablewareBox]

Parent

Part of #215.

What to build

对 AIW 的全部公开控制面做端到端产品验收：同一工作区可由 Workbench、CLI 和 MCP 并发观察；Local Backend、Workspace Host、Edge、网络与 renderer 分别故障时能恢复；macOS、Windows、Linux 均使用同一合同并明确验证状态。验收产物固定各仓库 SHA、命令输出、日志、截图和回滚组合。

Acceptance criteria

• AIW-01 至 AIW-07 的公开验收项全部通过，未通过项不得用“平台差异”或宽松 fallback 隐藏。
• Local Backend crash 后 Workspace Host 恢复 last-valid Authoring、Local Domain 数据与 source identity，且不重复设备动作。
• Workspace Host crash/restart 可从 manifest、lock 和持久 store 重新发现组件，不猜测物理动作成功。
• Browser/Electron reload 与 Agent 断连不停止活动工作流，重连后 cursor/generation 收敛。
• 同一 source 的两个 UI/Agent 观察到一致 snapshot、revision、Task 和节点终态。
• macOS、Windows、Linux 覆盖动态端口、绝对 Python 环境发现、路径/大小写、文件锁、token ACL 和进程树停止。
• Local Backend 与 Go Backend 合同矩阵全部通过，OS-only extension allowlist 无未审核重叠路由。
• PLC-Sim 最长带料工作流在 local Authority 通过；同一 Edge Runtime 在 backend Authority 的调度链路通过。
• Material attached/headless captures、布局 CAS、CLI JSONL 与故障注入产物可从验收报告直接打开。
• 固定 OS/FE/Workspace full SHA、版本、安装包身份、已验证平台和未验证限制，形成可回滚发布组合。

Blocked by

• [AIW-03] 重启 OS Edge Runtime 时保持 Backend 与任务事实连续 #218
• [AIW-04] 原子切换 Local 与 Backend Domain Authority #219
• [AIW-05] 通过 unilab CLI 与 MCP 运行和观察工作流 #220
• [AIW-07] 通过布局 CAS 与 Headless Renderer 闭环模板优化 #222

[github-actions]

GitHub → Feishu OKF synchronization

Feishu snapshot: Uni-Lab-Core #223
Knowledge stage: testing
Issue updated: 2026-08-13T12:02:58Z

[TablewareBox]

2026-08-13 macOS acceptance checkpoint

已锁定并在 Codex 内置浏览器验证 Authority 编辑边界：

• domainMode=local：Workspace Python 为 authoring source，代码与画布保持双向投影。
• domainMode=backend：Go Backend 工作流图/revision 为唯一 Canvas Definition source；画布允许编辑并通过 revision CAS 保存；代码模式禁用，本地 Python 变更不会覆盖当前 Backend 图；不做隐式 publish/双写。
• 浏览器实际删除 Backend 演示图一个节点并保存：revision 4 -> 5、节点 2 -> 1；保存前后工作区全部 Python 内容指纹均为 976ebdd37129ac1e660c7678879b76b968105a4200e7e97b0152c2e2c7e819e2。
• 反向隔离探针：临时修改工作区最长工作流源码并等待监控处理，Backend 图仍为 revision 5 / 1 node；探针随后恢复，源码文件 clean 且 Python 指纹恢复。

故障恢复与回归：

• Local Backend crash 由 Workspace Host 自动恢复到新 PID/动态端口，稳定 Local Domain DB、工作流/task/source identity 保留；Edge 随 Backend 动态端口重新连接，PLC-Sim 不受影响。
• Workspace Host restart 可接管仍存活的 Backend/Edge/PLC/renderer；Workbench adapter 现以 Host endpoint + PID + revision 判断快照身份，避免新 Host revision 撞号时保留旧 PID/端口。
• Backend Authority 首次因 Go Scheduler proxy 未配置而 fail-closed 回滚 local；补齐正式 scheduler endpoint 后切换成功，无静默 fallback。
• OS focused suite：43 passed，Ruff 与 git diff --check 通过。
• FE Workbench session：49 passed，typecheck、完整 Theia Workbench build 与 git diff --check 通过。首次与 OS suite 并行时有两个既有 readiness 时序用例超时，隔离复跑全部通过。

已推送可回滚提交：

• Uni-Lab-OS codex/ai-native-workspace-backend@9dfe0b08
• uni-lab-fe codex/ai-native-workspace-backend@ff4a06f

仍未把 AIW-08 标为完成：Windows/Linux、安装包身份、local PLC-Sim 最长带料工作流和 backend Authority 同 Edge 调度链路仍需最终验收。

[TablewareBox]

AIW-08 update (2026-08-13): clarified and implemented the Local/Backend authoring boundary.

• Backend Authority remains an editable, revision-CAS-saved canvas. Workspace Python is intentionally not authoritative and does not hot-apply to that graph.
• Managed OS/Edge readiness now gates only task creation; it no longer gates Local or Backend graph editing/saving.
• When OS is idle/starting/stopping/failed, the run action is disabled with an actionable Environment Manager reason.
• Backend-only node disable editing is now visible even when start-node/breakpoint controls are unavailable.
• Browser proof: with OS stopped, AIW-05 Backend graph changed to pending-save, saved revision 4→5, restored and saved revision 6; run remained blocked. Starting OS restored the run action automatically.
• Frontend commit: Uni-Lab-OS/uni-lab-fe@c542be5.
• Verification: workflow-editor 349 tests, workbench-theia 71 tests, both typechecks, full Workbench build.

[TablewareBox]

2026-08-14 AIW-08 checkpoint — CLI/MCP managed lifecycle

已将 Agent 生命周期控制收敛到与 CLI 相同的 Workspace Host Python SDK：

• WorkspaceHostClient.execute() 统一 submit/wait、operationId、超时与失败码归一化；CLI 不再自行解释 operation document。
• WorkspaceHostClient.status() 为 CLI/MCP 提供相同在线/离线快照，读取状态不会隐式启动 Host。
• MCP 新增 workspace_status、start/stop/restart_workspace_component、read_workspace_logs、switch_workspace_authority；不直接杀进程，不经过 Node RPC。
• 真实 Managed Local 验证：通过 Agent SDK 执行 os.restart，operation aiw08-mcp-os-restart-20260814 succeeded；Edge PID 77206 -> 81525、generation 更新，Backend PID 68338 与 PLC PID 63199 均保持不变。
• 同一 live session 中，真实 unilab workspace status --json 与 Agent workspace_status() 返回 revision 119 且 components 完全一致。
• Codex 内置浏览器验证 Backend 工作流画布与 3D 物料画布；Backend/Scheduler 已连接，物料目录 183 项，2D/2.5D/3D 控件存在。
• 回归：Workspace Host / Agent / runtime / networking 相关测试 51 passed；Ruff、git diff --check 通过。

已推送 Uni-Lab-OS codex/ai-native-workspace-backend@cb870d4e4674e3825be828f3317e6a6717b5b628。

AIW-08 仍保持 open；下一步继续最长带料工作流与故障恢复总验收。

[TablewareBox]

2026-08-14 AIW-08 checkpoint — Backend Canvas 与 Edge outcome 合同

Authority 语义进一步锁定并完成浏览器验收：

• backend Authority 的画布仍可编辑，并通过 revision CAS 直接保存 Go Backend 工作流定义；工作区 Python 继续可编辑，但不会刷新、覆盖或发布到 Backend 画布。切回 local 后才恢复代码—画布双向同步。
• Workbench 已将状态明确显示为 Backend 定义 · 已同步/待保存；仅活动 Task 期间显示运行锁定，不再把 Backend 编辑能力误报为 authoring 不可用。
• 浏览器往返保存 Backend 演示图 revision 5 -> 6 -> 7 并恢复原图；Backend compute Task b988f58e-f47c-4877-a36a-dfd32d69ba0f 成功。

本轮同时修复两条真实跨进程合同缺陷：

• Edge HTTP outcome 不再向 Go Backend 严格 DTO 发送仅 Local Authority 使用的 unknown_command_ids；此前该额外字段会触发 Invalid request parameter，令已执行动作的 Task 卡在 running。
• Workspace Host 启动 managed renderer 时继承当前 backendUrl 到 Backend proxy，避免 headless/新 renderer 静默回落默认 8080 并展示过期设备状态。
• 设备面板的“刷新”现在同时补读目录、动作 Catalog 与可见 active Task；浏览器实测 Task ac6ae177-2425-4fdc-85ea-9b85038cb134 从等待设备收敛为 succeeded，Edge 显示在线并恢复再次运行。
• 第一个 pending outcome 在 Managed OS 重启后由持久 outbox 自动重放并成功收敛，未直接杀设备进程。

回归与可回滚提交：

• Uni-Lab-OS codex/ai-native-workspace-backend@ca15cf0f：39 tests，Ruff 通过。
• uni-lab-fe codex/ai-native-workspace-backend@544d06f：device-management 44 tests、workflow-editor 352 tests、两包 typecheck 通过。
• Local PLC-Sim 最长带料工作流既有验收保持 47/47 succeeded（Task 554e86a8-014c-4efb-8ec5-d9834d23e2f9）。

AIW-08 继续保持 open；下一步继续独立故障恢复、合同矩阵与发布组合审计。

[TablewareBox]

2026-08-14 AIW-08 checkpoint — Authority 动态代理与 Backend 画布保存

再次按产品语义完成真实 UI 验证：

• backend Authority 不是只读模式：画布可直接编辑，并以 revision CAS 保存到 Go Backend；工作区 Python 文件仍可编辑，但不会刷新、覆盖或发布到该画布。切回 local 才恢复代码—画布同步。
• Codex 内置浏览器实测 Backend 演示工作流：禁用节点并保存 revision 7 → 8，重新启用并保存 revision 8 → 9，最终恢复原定义；UI 明确显示 Backend 定义 · 已同步 与“本地 Python 代码不会作用于本图”。
• 修复 Workbench 同源代理在 Authority 切换后仍绑定旧端口的问题：每次请求从 Workspace Host snapshot 解析 Local 动态 Backend 或配置的 Go Backend，renderer 无需重启即可切换数据源。
• 修复大型工作流 PUT 被 Theia 全局默认 100 KiB JSON parser 拦截为 413 Payload Too Large：代理改在 early middleware 阶段接管原始请求流，仍由 Local/Go Backend 的公开预算做权威校验。浏览器实测 Local 76 节点图进入画布模式成功，显示 已应用版本 · 可编辑。
• Local 设备目录补充稳定 materialUuid，设备动作不再把实例名误当运行物料身份。
• Backend Authority 下物料画布已在同一 renderer 成功加载（183 项），工作流与物料并排展示正常。

验证与提交：

• uni-lab-fe codex/ai-native-workspace-backend@1e5f969：workbench-theia 73 tests、typecheck、完整 Workbench build 通过。
• Uni-Lab-OS codex/ai-native-workspace-backend@db520bb5：device catalog tests、Ruff 通过。
• 两个分支均已推送，工作区仅保留未跟踪 .artifacts/，未纳入提交。

AIW-08 保持 open；继续执行 Local/Go Backend 合同矩阵与故障恢复、发布组合审计。

[TablewareBox]

AIW contract checkpoint (2026-08-14):

• Locked Backend Authority semantics: the frontend canvas remains editable and saves the Backend workflow graph through revision CAS; workspace Python remains editable but does not refresh, overwrite, or publish into the Backend canvas. Switching back to local restores code/canvas round-trip.
• Browser proof: Backend graph revision 9 -> 10 -> 11 via disable/save/restore/save; UI explicitly says 画布可编辑并直接保存；本地 Python 代码修改不生效.
• Aligned Local shared catalog routes with Go Backend numbered envelopes: /workflows, /workflow-node-templates, and /resource-templates now return only items/has_more/page/page_size; Local-only generation/source fields were removed from shared list/detail payloads.
• Frontend and readiness probes now initiate canonical page/page_size requests; legacy cursor responses remain read-compatible only.
• Live Local verification: 63-node/51-edge workflow canvas loaded, 47/47 historical jobs visible, and 132-item material canvas loaded.
• Validation: OS 53 focused tests + Ruff; services 192 tests + typecheck; workbench-session 49 tests + typecheck; Workbench dev build.

Pushed SHAs: Uni-Lab-OS 5090c262 (plus domain clarification 4d3f3405), uni-lab-fe 5b3f4ca (plus Backend UI clarification acb4a93).

[TablewareBox]

AIW-08 补充：接口 1 已锁定并实现（2026-08-14）

已确认并实现以下边界：

• Local Backend 与中心化 Go Backend 的 GET /api/v1/devices 均返回 DeviceOverview[]。
• 正常“仪器设备”界面按 resource_template_uuid + action name + action type 唯一关联 WorkflowNodeTemplate，由后者提供动作输入/输出 Schema 与默认值；缺失或冲突不猜测。
• Local 富设备目录迁移至 /api/v1/authoring/device-catalog，仅用于 Driver/Registry 安装、激活、验收与诊断，不作为正常产品回退。
• 本补充未修改公共 /api/v1/materials 合同；Material 为待单独确认的接口 2。
• Backend Authority 可为实验室中心化 Docker 部署，不属于 Workspace Host 生命周期。

实现提交：

• Uni-Lab-OS f9e700ed
• uni-lab-fe 3a48b52

验证：OS/Workspace Host 相关 33 tests；services 191 tests；device-management 44 tests；desktop 10 tests；前端全仓 typecheck；Codex 浏览器 Managed Local 实测 8 台仪器，S04 动作参数与默认值成功由 WorkflowNodeTemplate 呈现。

[TablewareBox]

2026-08-14 AIW-08 checkpoint — reset safety 与 Host 恢复

已完成 AIW-08 的本地状态重建安全纵切片：

• local.reset-state 在活动 WorkflowTask、Local/Edge job、pending outcome、未 ACK outbox 或 UNKNOWN 物理结果存在时 fail-closed；检查失败也不会猜测为安全。
• 操作在停止 Backend/Edge 前预检，并在停止后再次检查；竞态出现 blocker 时恢复原组件状态。
• Workbench 环境管理器不再吞掉 Host operation rejection，显示错误码、blocker source/kind/identity、状态和未确认 command。
• 修复 Node 25 首次启动时异步 WriteStream 不能作为 spawn stdio 的问题，改用预先打开的数值日志 fd。
• 修复 stale session.json 指向已崩溃 Host 时 Workbench 不会拉起替代 Host 的恢复路径。

验证：

• OS reset/Host + 远端新增 Site 回归：40 passed；Ruff、diff check 通过。
• Frontend Workbench session：51 passed；Theia：74 passed；两包 typecheck 与完整 Workbench build 通过。
• Codex 浏览器真实 Managed Local：注入 UNKNOWN job 后点击“重建本地数据”，UI 显示 local_reset_state_blocked 和 aiw-reset-fixture-command；Backend PID 42147、generation f92a604e-9f2a-430c-9910-73acf8be7890、地址 62370 均保持。

已推送：

• Uni-Lab-OS codex/ai-native-workspace-backend@a3b85714
• uni-lab-fe codex/ai-native-workspace-backend@ecfa7bb