系统架构
系统边界、SkillPack 组成与证据边界
系统边界：仓库、Host 与后置分发
仓库是审查和追踪变更的边界；运行目录是本机实例的执行与状态边界。两者通过限定文件的交付关联，不能整目录互相覆盖。图中的虚线是未验证关系，不代表现有同步接口。
已证实：文本基线位于 apps/ai-video-editor/skillpack/；P0-02 证明仓库单文件交付后，Host 从「项目」打开可见 HTML 改动，并可回退、保留已抽检数据。文件级 P0-03 已关，状态来源与证据范围见 验证记录。
未验证：宿主对清单、Jobs、skills 的显示/执行加载，客户端修改回收和云端分发。当前操作政策为仅本机、暂停 Vibe Editing；这只是最小边界拍板，不表示 P0-04/05 的完整问题已解决。
Agent App / SkillPack：源码与状态分离
| 组成 | 职责与事实边界 |
|---|---|
app.html | 已入库的界面源码；HTML 可见性实验只证明本机打开后的效果 |
skills/ | 已导入 video-editor 与 video-face-mosaic 的文本集合；入库不等于依赖完整或技能执行已验收 |
job.json | 三项 Job 原始文本保留；notify/enabled 是观察值，U07 仍待宿主核验 |
skillpack.json | 两项 source 改为相对占位；U02 未验证宿主是否接受，版本 0.4.1 仅为观察值 |
data/ | 配置、存储等运行状态；不随源码导入或代码回退覆盖，恢复需单独设计 |
导入范围为 14 个核心文本与两份配置候选；排除状态、会话、缓存、备份以及未核验的 ONNX 等资源。逐文件摘要、占位变换及 U01–U09 见 IMPORT.md。不能把文本集合描述为完整可运行发布包。
前端源码组织与交付
已拍板的 Vite + React + shadcn（Base UI）前端栈将 App 源码放在 apps/*/web，通过 packages/ui 与 packages/host-sdk 在构建期复用；脚手架尚未落地。组件与逻辑拆分维护，构建可以输出分开的 HTML/CSS/JS，按需 chunk 或懒加载；交付物为可追溯的构建产物集合与资源清单，单文件仅为可选打包策略。Host 文档描述 iframe.srcdoc 加载；iframe 通常可加载外置 link/script，srcdoc 不推出禁止，但当前 Host 的实际 sandbox/CSP、资源 URL 基址解析与静态服务兼容仍未知，需读取实现或受控验证，不能宣称已支持。原始 AGENTS 的单文件维护约定与此前全部内联的推断应和 Host 能力证据区分。共享包不成为运行依赖，SkillPack 自包含及源码 / 状态边界不变。现有图表描述的是历史手写测试基线。首轮仅做独立 host-hello；ai-video-editor 不迁移、不维护。
证据边界：文件结果不等于宿主能力
架构采用三个分离原则：源码与状态分离，文件交付与宿主加载分离，设计意图与验收证据分离。这使代码回退可独立审查，也避免把复制成功误判为功能已生效。
未知：热刷新、版本登记、安装升级的具体协议；尚不能从本机 HTML 观察推断。若未来另立宿主能力验收，应分别观察显示、执行加载及 U02/U07；这些历史缺口不转为维护 video-editor 的待办，也不扩大已关闭文件级演练的含义。流程见 交付闭环。