@microi.net/cli 5.8.5 → 5.8.6

package/skills/unity-integration/SKILL.md

@@ -1,171 +1,171 @@
----
-name: unity-integration
-description: Microi吾码 Unity、UPM SDK、WebGL、3D 游戏/数字孪生、DiyToken/V8 通讯、AI 应用商城交付与完整验收规范。用于评估或提取 Unity 工具箱，创建 Microi.Unity 包，开发 WebGL 场景，接入 Microi.Client 宿主与 V8 接口，引入可授权素材，发布可安装 AI 应用，或审查 Unity 代码是否错误进入 Microi.Server。
----
-
-> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
-
-# Microi Unity 完整交付
-
-目标不是“做出一个 Unity 工程”，而是交付一条可复用、可安装、可升级、可验证的 Microi 3D 应用链。
-
-## 按任务读取参考
-
-| 当前任务 | 必须读取 |
-|---|---|
-| 新建或调用 `Microi.Unity` | `references/sdk-api.md` |
-| WebGL 模板、Microi.Client/AI 应用宿主、性能与部署 | `references/webgl-hosting.md` |
-| AI 应用源码、商城包、官方发布与安装回读 | `references/ai-app-delivery.md` |
-| 从已有客户项目提取 Unity 工具箱或素材 | `references/toolbox-migration.md` |
-
-若任务横跨多项，逐个读取相应参考，不从文件名猜协议。
-
-## 先做架构裁决
-
-1. Unity 客户端 SDK 使用仓库根级 UPM 包：`Microi.Unity/package.json`。
-2. `UnityEngine`、`UnityWebRequest`、Editor API 和 `.jslib` 不进入 `Microi.Server` 的 .NET 类库。
-3. 玩家进度、设备状态、任务、积分和交互记录优先由 V8 接口引擎编排。
-4. 只有缺失的平台级可信协议、鉴权、密钥隔离或底层原子能力，才允许修改 `Microi.Server`；修改前必须说明 V8 为什么无法完成。
-5. 实时房间、租约、进度和去重事实必须按 `OsClient` 存入共享数据库、Redis 或可靠消息系统，不能用单节点内存字典当事实源。
-
-推荐目录：
-
-```text
-Microi.Unity/                         公共 UPM SDK
-├─ Runtime/Api/                       UnityWebRequest 与 DosResult
-├─ Runtime/WebGL/                     C# 浏览器桥
-│  └─ Plugins/WebGL/*.jslib
-├─ Editor/                            通用构建工具
-└─ Samples~/                          可运行最小示例
-
-AI-Project/<project>/Unity/           具体 Unity 工程与场景
-Microi-V8-Engine/.../AI应用/<appKey>/ 唯一 AI 应用源码与商城资源
-microi.doc/docs/doc/system-engine/    官方长期文档
-```
-
-## 标准工作流
-
-### 1. 发现与盘点
-
-- 读取 Unity 版本、渲染管线、`Packages/manifest.json`、场景、Editor、Runtime、WebGL Plugins 和现有构建脚本。
-- 搜索 Microi.Client 已有 Unity 宿主、现有 V8 Key、官方 AI 应用是否重名。
-- 为模型、动作、贴图、字体、音频逐项记录来源、作者、许可证、版本和是否允许再分发。
-- 在启动 Unity、Node、浏览器或构建前检查物理内存、同类进程、端口与任务归属。
-
-### 2. 分离公共能力与业务能力
-
-- API 客户端、DosResult、上下文注入、Token 轮换、浏览器事件和通用构建工具进入 UPM。
-- 相机路径、触发区、特定场景模型、关卡、客户设备协议与业务脚本留在具体项目。
-- 首次提取采用复制和重构；新包完成引用替换与回归前，不移动或删除旧项目文件。
-- 公共包必须有 `package.json`、asmdef、README、LICENSE、CHANGELOG 与 Sample。
-
-### 3. 建立 WebGL 宿主握手
-
-- Unity 就绪后由宿主用 `SendMessage` 注入 `ApiBaseUrl/OsClient/Authorization/Did`。
-- 会话只保存在运行时内存；禁止 Token 进入 URL、场景、Prefab、日志、构建产物或版本库。
-- `.jslib` 只提供稳定事件：ready、authorization rotated、business event。
-- Token 轮换回调同时携带发起请求时的旧 Token；宿主先做迟到响应保护，再更新统一会话。
-- 页面离屏暂停；组件卸载调用 Unity `Quit()`，清理 iframe/Canvas、WASM、WebGL 上下文、监听器与全局回调。
-
-### 4. 用 V8 设计服务端
-
-```text
-POST {ApiBase}/apiengine/{ApiEngineKey}
-Content-Type: application/json
-osclient: {OsClient}
-apiengine: 1
-authorization: Bearer {DiyToken}
-did: {DeviceId}
-```
-
-- 身份只取 `V8.CurrentUser`；禁止相信客户端 UserId、角色、部门或权限结论。
-- 重新校验坐标、数量、字符串长度、状态转换和资源归属。
-- 写接口使用稳定 `RequestId/EventId` + 数据库唯一索引/幂等台账；锁不能替代幂等。
-- 匿名多人由服务端签发 `SessionId + SessionSecret`；数据库只保存秘密哈希，公开快照不得返回秘密、UserId、设备指纹或内部权限字段。
-- 在线角色、房间版本和掉线到期时间进入共享数据库/Redis；客户端心跳、接口重试和节点切换都不能依赖进程内字典。
-- 位置心跳由服务端限制地图边界、最大速度和递增序列；过期查询以服务端时间为准，正常离场与租约超时都必须幂等。
-- 公屏文字限制长度、频率、表情白名单与稳定请求 ID。WebGL 使用 DOM 输入时必须在 Player 端将 `WebGLInput.captureAllKeyboardInput` 设为 `false`，并阻止输入区的键盘、`beforeinput`、组合输入与指针事件继续驱动角色；只拦截冒泡阶段不足以保证数字、标点和 Shift 符号可输入。若 Unity 6 的 Player 编译响应文件未引用 `UnityEngine.WebGLModule`，使用受 `link.xml` 显式保留的反射设置并以真实键盘 E2E 验收，不得跳过该行为。
-- 接口引擎 `Code=1` 自动提交，失败返回其它 Code 自动回滚，不手动 Commit/Rollback。
-- 表、索引、菜单、接口与权限通过应用 Manifest 安装，不为游戏资源新增 `Microi.Upgrade` 定制迁移。
-- 所有接口必须声明 `ResourcePolicies.ApiEngines`：官方核心 `Managed`；租户扩展 `CreateIfMissing`，后续升级不覆盖。
-
-### 持续权威模拟与平台宿主
-
-- 先区分接口引擎业务编排、持续固定步模拟和实时通知。SignalR版本通知不是规则执行；秒级Job只用于恢复/扫描/补偿，不能宣称20Hz连续模拟。
-- 仅在现有纯V8无法满足固定步规则时使用通用受信规则宿主。Domain与应用适配仍属于私有应用程序集，平台只提供调度/预算/作用域；禁止把整套游戏规则加入Microi.Server或新增游戏Controller。
-- 后台发行固定tenant、入口、审批摘要和实际DLL/依赖hash；主库绑定已安装与已完成发布版本，每次运行回读撤销。不得从玩家Param、可编辑V8或MCP传路径/URL/Type来装载代码。明确原生代码是受信后端代码，不是沙箱。
-- 使用 `RunPlatformApiRuntime` 之前核后端实际安装。公开入口只收意图，成员和席位由DiyToken重算；DB时钟、租约/fence、完整checkpoint与inbox在同一事务。未知提交保持原RequestId，停机停止接收并有界排空，旧owner不得续写。
-- 连续宿主唤醒需接Owned提示；当前无afterCommit回调，只能在持久写入成功后、return Code=1前发出有界提示，不能说已经提交后唤醒。pump仍须重新锁主库并核owner/fence/租约；原事务回滚不能产生合法推进。终局用DrainOwnedRoom停止后续调度，允许当前事务返回提交；StopOwnedRoom会立即取消当前请求。无外部主机不等于无需后端部署。只给本人/同队可见投影，公开频道不传全量状态。
-- 验收分离规则测试、原子编译、真实Jint/SQL、两节点/强杀恢复、HTTP与实际渲染；固定频率或协议夹具通过不能代表商业竞技品质。
-
-### 5. 构建可安装 AI 应用
-
-- `ApplicationType` 使用 `Web`；Vue 3 + Vite + TypeScript 作为页面外壳，Unity Canvas/WebGL 与普通 DOM 分层。
-- 官方租户的 `AI应用/<appKey>` 是私有源码、构建脚本、V8、Manifest 与商城合约的唯一编辑根。
-- 页面必须 poster-first：未启动时不下载大体积 WASM/Data；提供加载、错误、重试、全屏、退出和低性能提示。
-- 多人界面要显示本地及远端昵称；同模型远端角色使用快照插值，失效租约及时销毁；公屏固定在不遮挡核心操作区的位置并支持键盘与表情选择。真实键盘验收至少覆盖中文、大小写字母、数字、ASCII/中文标点、Shift 符号与输入法组合文本，禁止用直接设置 input value 的方式替代。
-- 开场语音或剧情对白需要字幕时，字幕事件以 `AudioSource.time` 或同等播放器时间轴为准，中文与英文分行显示在底部安全区；不得用页面加载后的固定定时器冒充音画同步。WebGL 可用可访问 DOM 字幕，Windows/原生端使用同一份 cue 数据。
-- 构建门禁必须拒绝缺失 Unity 产物的“空壳发布”，并校验 WASM、Data、体积、哈希、本机地址、source map 与疑似硬编码 Token。
-- Unity `Data`、WASM 或 Windows 安装包大于 128 MiB 时，MCP/CLI 必须使用协议 v3 原始字节断点续传；禁止拆分文件、转 Base64 或通过提高普通表单上限发布。失败后读取同一不可变会话只续传缺片，并在“系统引擎 → 超大文件上传记录”回读进度、心跳、错误与恢复建议。
-- 先同步私有源码，再发布不可变 Web 产物，最后生成/发布商城包；三个动作分别回读。
-
-### 6. 补齐官网与 Skill
-
-- 长期能力在中文官网“系统引擎”下建立独立页面，并加入 `mapping_zh.json`、视觉画像与文档责任映射。
-- 页面优先使用主视觉、架构卡、步骤卡和折叠技术细节；不要用连续大段文字堆满屏幕。
-- 不手工维护 `microi.doc/docs/en/`，不因普通功能文档修改 `about/update-log.md`。
-- 文档至少覆盖：架构边界、UPM 安装、宿主握手、V8 请求、安全、CORS、构建、部署、商城安装和分层验收。
-
-## 资产与视觉红线
-
-- AI 生成素材保存逐图提示词、生成时间、用途和源文件；不要只提交最终图片。
-- AI 设定图、渲染目标图与真实 Unity 运行截图必须分开标注；未通过实机近景、拓扑、材质、性能验收时禁止宣称“与设定图一模一样”或“商业 AAA 已达成”。
-- 网络素材必须允许商业使用和再分发；许可证不清晰就改用原创、程序化或明确授权素材。
-- 官方包不携带客户专属场景、品牌秘密、私有协议或无法追溯的二进制模型。
-- “超清”不能只靠大纹理：同时控制材质、光照、阴影、LOD、裁剪、像素比和下载体积。
-- 支持浅/深色外壳、键盘焦点、减少动效偏好、响应式安全区与清晰错误状态。
-
-## WebGL 质量基线
-
-- 使用仓库已验证的 Unity LTS；WebGL 采用兼容的 Built-in 或 URP，不走 HDRP。
-- 校验 WebGL 2、WASM、正确 MIME、gzip/Brotli 响应头或解压回退、高 DPI 上限、全屏、键鼠/手柄、焦点恢复和退出释放。
-- WebGL 必须经 HTTP(S) 验收，不能用 `file://`。
-- Unity 2022.3 不把移动浏览器描述为官方支持；移动端需要独立触控、内存、画质和弱网测试。
-- 程序化创建、反射或字符串类型名先用 `link.xml` 精确保留；若 WebGL 仍报告原生 `class ID` 被裁剪，可对该构建关闭 `PlayerSettings.stripEngineCode`，但必须复核包体和浏览器控制台。
-- WebGL 模板设置 `autoSyncPersistentDataPath: true`，并把弃用警告也纳入控制台验收。
-- 同一次高资源阶段只运行一个 Unity/Node/浏览器重任务，并遵守工作区 OOM 保护。
-
-## 分层验收矩阵
-
-| 证据层 | 必须断言 |
-|---|---|
-| 源码 | UPM 可解析、C# 编译、V8/Manifest/策略测试、安全扫描 |
-| Unity Editor | Play、移动、奔跑、跳跃、碰撞、交互、暂停恢复 |
-| WebGL | IL2CPP/WASM 构建成功，Loader/Data/WASM 完整 |
-| 浏览器 | HTTP 加载、全屏、输入、控制台、DPR、退出释放 |
-| Microi 租户 | 当前用户隔离、Token 轮换、保存重放、无权失败 |
-| 多人在线 | 至少两个独立会话互见唯一昵称、移动与动作；异常断线超过租约后双方快照均不再返回该角色 |
-| 实时公屏 | 两个独立会话互相收发文字与表情；非法表情、超长、超频和请求重放均被正确处理 |
-| 字幕与语音 | 开场或剧情语音逐句驱动中英字幕；暂停/恢复不漂移，字幕位于底部安全区且对比度可读 |
-| 多节点 | 重复投递、节点切换、失败恢复时副作用仅一次 |
-| 大型资产 | 断点后只补缺片、HDFS 整文件哈希一致、后台审计进度与终态可见 |
-| AI 应用 | 私有源码回读、运行版本哈希、列表/详情公开可见 |
-| 应用商城 | 包版本/策略回读，非官方租户安装与升级通过 |
-
-任何未执行层都要明确写成未验证或受阻。应用受理编号、源码测试或本地构建不能替代公开 URL、真实租户和非官方安装证据。
-
-## 停止发布的条件
-
-### 复盘：运行时特效在 WebGL 被裁剪或短到看不见
-
-- 触发场景：编辑器开炮正常，公开 WebGL 只出现命中，没有可见飞行子弹。
-- 根因：仅运行时 AddComponent 的 LineRenderer、ParticleSystem 或 Collider 未纳入引擎保留，或高速 easing/过短 lifetime 使飞行阶段几乎不可见。
-- 通用规则：真实发布构建中保留所需模块与动态 Shader；炮口取实际炮管世界变换，飞行持续时间按距离限界，弹芯/尾迹/命中分层，共享材质不可逐次克隆泄漏。
-- 自动化检查：公开 WASM 实际加载，连续至少三帧断言弹体位置变化；检验四种武器、空射、真实权威命中与资源/console 错误。单帧截图不能证明动态特效。
-
-- Unity 许可证未激活或 WebGL 模块缺失。
-- Unity 构建只有外壳，没有真实 WASM/Data。
-- 素材许可证、AI 提示词或资产来源不可追溯。
-- 正式产物出现本机地址、Token、source map 或超限单文件。
-- 官方应用重名、目标版本不明确、远端源码/运行版本基线未回读。
-- 商城包缺少 `ResourcePolicies.ApiEngines`，或把租户 Hook 错设为 `Managed`。
+---
+name: unity-integration
+description: Microi吾码 Unity、UPM SDK、WebGL、3D 游戏/数字孪生、DiyToken/V8 通讯、AI 应用商城交付与完整验收规范。用于评估或提取 Unity 工具箱，创建 Microi.Unity 包，开发 WebGL 场景，接入 Microi.Client 宿主与 V8 接口，引入可授权素材，发布可安装 AI 应用，或审查 Unity 代码是否错误进入 Microi.Server。
+---
+
+> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
+
+# Microi Unity 完整交付
+
+目标不是“做出一个 Unity 工程”，而是交付一条可复用、可安装、可升级、可验证的 Microi 3D 应用链。
+
+## 按任务读取参考
+
+| 当前任务 | 必须读取 |
+|---|---|
+| 新建或调用 `Microi.Unity` | `references/sdk-api.md` |
+| WebGL 模板、Microi.Client/AI 应用宿主、性能与部署 | `references/webgl-hosting.md` |
+| AI 应用源码、商城包、官方发布与安装回读 | `references/ai-app-delivery.md` |
+| 从已有客户项目提取 Unity 工具箱或素材 | `references/toolbox-migration.md` |
+
+若任务横跨多项，逐个读取相应参考，不从文件名猜协议。
+
+## 先做架构裁决
+
+1. Unity 客户端 SDK 使用仓库根级 UPM 包：`Microi.Unity/package.json`。
+2. `UnityEngine`、`UnityWebRequest`、Editor API 和 `.jslib` 不进入 `Microi.Server` 的 .NET 类库。
+3. 玩家进度、设备状态、任务、积分和交互记录优先由 V8 接口引擎编排。
+4. 只有缺失的平台级可信协议、鉴权、密钥隔离或底层原子能力，才允许修改 `Microi.Server`；修改前必须说明 V8 为什么无法完成。
+5. 实时房间、租约、进度和去重事实必须按 `OsClient` 存入共享数据库、Redis 或可靠消息系统，不能用单节点内存字典当事实源。
+
+推荐目录：
+
+```text
+Microi.Unity/                         公共 UPM SDK
+├─ Runtime/Api/                       UnityWebRequest 与 DosResult
+├─ Runtime/WebGL/                     C# 浏览器桥
+│  └─ Plugins/WebGL/*.jslib
+├─ Editor/                            通用构建工具
+└─ Samples~/                          可运行最小示例
+
+AI-Project/<project>/Unity/           具体 Unity 工程与场景
+Microi-V8-Engine/.../AI应用/<appKey>/ 唯一 AI 应用源码与商城资源
+microi.doc/docs/doc/system-engine/    官方长期文档
+```
+
+## 标准工作流
+
+### 1. 发现与盘点
+
+- 读取 Unity 版本、渲染管线、`Packages/manifest.json`、场景、Editor、Runtime、WebGL Plugins 和现有构建脚本。
+- 搜索 Microi.Client 已有 Unity 宿主、现有 V8 Key、官方 AI 应用是否重名。
+- 为模型、动作、贴图、字体、音频逐项记录来源、作者、许可证、版本和是否允许再分发。
+- 在启动 Unity、Node、浏览器或构建前检查物理内存、同类进程、端口与任务归属。
+
+### 2. 分离公共能力与业务能力
+
+- API 客户端、DosResult、上下文注入、Token 轮换、浏览器事件和通用构建工具进入 UPM。
+- 相机路径、触发区、特定场景模型、关卡、客户设备协议与业务脚本留在具体项目。
+- 首次提取采用复制和重构；新包完成引用替换与回归前，不移动或删除旧项目文件。
+- 公共包必须有 `package.json`、asmdef、README、LICENSE、CHANGELOG 与 Sample。
+
+### 3. 建立 WebGL 宿主握手
+
+- Unity 就绪后由宿主用 `SendMessage` 注入 `ApiBaseUrl/OsClient/Authorization/Did`。
+- 会话只保存在运行时内存；禁止 Token 进入 URL、场景、Prefab、日志、构建产物或版本库。
+- `.jslib` 只提供稳定事件：ready、authorization rotated、business event。
+- Token 轮换回调同时携带发起请求时的旧 Token；宿主先做迟到响应保护，再更新统一会话。
+- 页面离屏暂停；组件卸载调用 Unity `Quit()`，清理 iframe/Canvas、WASM、WebGL 上下文、监听器与全局回调。
+
+### 4. 用 V8 设计服务端
+
+```text
+POST {ApiBase}/apiengine/{ApiEngineKey}
+Content-Type: application/json
+osclient: {OsClient}
+apiengine: 1
+authorization: Bearer {DiyToken}
+did: {DeviceId}
+```
+
+- 身份只取 `V8.CurrentUser`；禁止相信客户端 UserId、角色、部门或权限结论。
+- 重新校验坐标、数量、字符串长度、状态转换和资源归属。
+- 写接口使用稳定 `RequestId/EventId` + 数据库唯一索引/幂等台账；锁不能替代幂等。
+- 匿名多人由服务端签发 `SessionId + SessionSecret`；数据库只保存秘密哈希，公开快照不得返回秘密、UserId、设备指纹或内部权限字段。
+- 在线角色、房间版本和掉线到期时间进入共享数据库/Redis；客户端心跳、接口重试和节点切换都不能依赖进程内字典。
+- 位置心跳由服务端限制地图边界、最大速度和递增序列；过期查询以服务端时间为准，正常离场与租约超时都必须幂等。
+- 公屏文字限制长度、频率、表情白名单与稳定请求 ID。WebGL 使用 DOM 输入时必须在 Player 端将 `WebGLInput.captureAllKeyboardInput` 设为 `false`，并阻止输入区的键盘、`beforeinput`、组合输入与指针事件继续驱动角色；只拦截冒泡阶段不足以保证数字、标点和 Shift 符号可输入。若 Unity 6 的 Player 编译响应文件未引用 `UnityEngine.WebGLModule`，使用受 `link.xml` 显式保留的反射设置并以真实键盘 E2E 验收，不得跳过该行为。
+- 接口引擎 `Code=1` 自动提交，失败返回其它 Code 自动回滚，不手动 Commit/Rollback。
+- 表、索引、菜单、接口与权限通过应用 Manifest 安装，不为游戏资源新增 `Microi.Upgrade` 定制迁移。
+- 所有接口必须声明 `ResourcePolicies.ApiEngines`：官方核心 `Managed`；租户扩展 `CreateIfMissing`，后续升级不覆盖。
+
+### 持续权威模拟与平台宿主
+
+- 先区分接口引擎业务编排、持续固定步模拟和实时通知。SignalR版本通知不是规则执行；秒级Job只用于恢复/扫描/补偿，不能宣称20Hz连续模拟。
+- 仅在现有纯V8无法满足固定步规则时使用通用受信规则宿主。Domain与应用适配仍属于私有应用程序集，平台只提供调度/预算/作用域；禁止把整套游戏规则加入Microi.Server或新增游戏Controller。
+- 后台发行固定tenant、入口、审批摘要和实际DLL/依赖hash；主库绑定已安装与已完成发布版本，每次运行回读撤销。不得从玩家Param、可编辑V8或MCP传路径/URL/Type来装载代码。明确原生代码是受信后端代码，不是沙箱。
+- 使用 `RunPlatformApiRuntime` 之前核后端实际安装。公开入口只收意图，成员和席位由DiyToken重算；DB时钟、租约/fence、完整checkpoint与inbox在同一事务。未知提交保持原RequestId，停机停止接收并有界排空，旧owner不得续写。
+- 连续宿主唤醒需接Owned提示；当前无afterCommit回调，只能在持久写入成功后、return Code=1前发出有界提示，不能说已经提交后唤醒。pump仍须重新锁主库并核owner/fence/租约；原事务回滚不能产生合法推进。终局用DrainOwnedRoom停止后续调度，允许当前事务返回提交；StopOwnedRoom会立即取消当前请求。无外部主机不等于无需后端部署。只给本人/同队可见投影，公开频道不传全量状态。
+- 验收分离规则测试、原子编译、真实Jint/SQL、两节点/强杀恢复、HTTP与实际渲染；固定频率或协议夹具通过不能代表商业竞技品质。
+
+### 5. 构建可安装 AI 应用
+
+- `ApplicationType` 使用 `Web`；Vue 3 + Vite + TypeScript 作为页面外壳，Unity Canvas/WebGL 与普通 DOM 分层。
+- 官方租户的 `AI应用/<appKey>` 是私有源码、构建脚本、V8、Manifest 与商城合约的唯一编辑根。
+- 页面必须 poster-first：未启动时不下载大体积 WASM/Data；提供加载、错误、重试、全屏、退出和低性能提示。
+- 多人界面要显示本地及远端昵称；同模型远端角色使用快照插值，失效租约及时销毁；公屏固定在不遮挡核心操作区的位置并支持键盘与表情选择。真实键盘验收至少覆盖中文、大小写字母、数字、ASCII/中文标点、Shift 符号与输入法组合文本，禁止用直接设置 input value 的方式替代。
+- 开场语音或剧情对白需要字幕时，字幕事件以 `AudioSource.time` 或同等播放器时间轴为准，中文与英文分行显示在底部安全区；不得用页面加载后的固定定时器冒充音画同步。WebGL 可用可访问 DOM 字幕，Windows/原生端使用同一份 cue 数据。
+- 构建门禁必须拒绝缺失 Unity 产物的“空壳发布”，并校验 WASM、Data、体积、哈希、本机地址、source map 与疑似硬编码 Token。
+- Unity `Data`、WASM 或 Windows 安装包大于 128 MiB 时，MCP/CLI 必须使用协议 v3 原始字节断点续传；禁止拆分文件、转 Base64 或通过提高普通表单上限发布。失败后读取同一不可变会话只续传缺片，并在“系统引擎 → 超大文件上传记录”回读进度、心跳、错误与恢复建议。
+- 先同步私有源码，再发布不可变 Web 产物，最后生成/发布商城包；三个动作分别回读。
+
+### 6. 补齐官网与 Skill
+
+- 长期能力在中文官网“系统引擎”下建立独立页面，并加入 `mapping_zh.json`、视觉画像与文档责任映射。
+- 页面优先使用主视觉、架构卡、步骤卡和折叠技术细节；不要用连续大段文字堆满屏幕。
+- 不手工维护 `microi.doc/docs/en/`，不因普通功能文档修改 `about/update-log.md`。
+- 文档至少覆盖：架构边界、UPM 安装、宿主握手、V8 请求、安全、CORS、构建、部署、商城安装和分层验收。
+
+## 资产与视觉红线
+
+- AI 生成素材保存逐图提示词、生成时间、用途和源文件；不要只提交最终图片。
+- AI 设定图、渲染目标图与真实 Unity 运行截图必须分开标注；未通过实机近景、拓扑、材质、性能验收时禁止宣称“与设定图一模一样”或“商业 AAA 已达成”。
+- 网络素材必须允许商业使用和再分发；许可证不清晰就改用原创、程序化或明确授权素材。
+- 官方包不携带客户专属场景、品牌秘密、私有协议或无法追溯的二进制模型。
+- “超清”不能只靠大纹理：同时控制材质、光照、阴影、LOD、裁剪、像素比和下载体积。
+- 支持浅/深色外壳、键盘焦点、减少动效偏好、响应式安全区与清晰错误状态。
+
+## WebGL 质量基线
+
+- 使用仓库已验证的 Unity LTS；WebGL 采用兼容的 Built-in 或 URP，不走 HDRP。
+- 校验 WebGL 2、WASM、正确 MIME、gzip/Brotli 响应头或解压回退、高 DPI 上限、全屏、键鼠/手柄、焦点恢复和退出释放。
+- WebGL 必须经 HTTP(S) 验收，不能用 `file://`。
+- Unity 2022.3 不把移动浏览器描述为官方支持；移动端需要独立触控、内存、画质和弱网测试。
+- 程序化创建、反射或字符串类型名先用 `link.xml` 精确保留；若 WebGL 仍报告原生 `class ID` 被裁剪，可对该构建关闭 `PlayerSettings.stripEngineCode`，但必须复核包体和浏览器控制台。
+- WebGL 模板设置 `autoSyncPersistentDataPath: true`，并把弃用警告也纳入控制台验收。
+- 同一次高资源阶段只运行一个 Unity/Node/浏览器重任务，并遵守工作区 OOM 保护。
+
+## 分层验收矩阵
+
+| 证据层 | 必须断言 |
+|---|---|
+| 源码 | UPM 可解析、C# 编译、V8/Manifest/策略测试、安全扫描 |
+| Unity Editor | Play、移动、奔跑、跳跃、碰撞、交互、暂停恢复 |
+| WebGL | IL2CPP/WASM 构建成功，Loader/Data/WASM 完整 |
+| 浏览器 | HTTP 加载、全屏、输入、控制台、DPR、退出释放 |
+| Microi 租户 | 当前用户隔离、Token 轮换、保存重放、无权失败 |
+| 多人在线 | 至少两个独立会话互见唯一昵称、移动与动作；异常断线超过租约后双方快照均不再返回该角色 |
+| 实时公屏 | 两个独立会话互相收发文字与表情；非法表情、超长、超频和请求重放均被正确处理 |
+| 字幕与语音 | 开场或剧情语音逐句驱动中英字幕；暂停/恢复不漂移，字幕位于底部安全区且对比度可读 |
+| 多节点 | 重复投递、节点切换、失败恢复时副作用仅一次 |
+| 大型资产 | 断点后只补缺片、HDFS 整文件哈希一致、后台审计进度与终态可见 |
+| AI 应用 | 私有源码回读、运行版本哈希、列表/详情公开可见 |
+| 应用商城 | 包版本/策略回读，非官方租户安装与升级通过 |
+
+任何未执行层都要明确写成未验证或受阻。应用受理编号、源码测试或本地构建不能替代公开 URL、真实租户和非官方安装证据。
+
+## 停止发布的条件
+
+### 复盘：运行时特效在 WebGL 被裁剪或短到看不见
+
+- 触发场景：编辑器开炮正常，公开 WebGL 只出现命中，没有可见飞行子弹。
+- 根因：仅运行时 AddComponent 的 LineRenderer、ParticleSystem 或 Collider 未纳入引擎保留，或高速 easing/过短 lifetime 使飞行阶段几乎不可见。
+- 通用规则：真实发布构建中保留所需模块与动态 Shader；炮口取实际炮管世界变换，飞行持续时间按距离限界，弹芯/尾迹/命中分层，共享材质不可逐次克隆泄漏。
+- 自动化检查：公开 WASM 实际加载，连续至少三帧断言弹体位置变化；检验四种武器、空射、真实权威命中与资源/console 错误。单帧截图不能证明动态特效。
+
+- Unity 许可证未激活或 WebGL 模块缺失。
+- Unity 构建只有外壳，没有真实 WASM/Data。
+- 素材许可证、AI 提示词或资产来源不可追溯。
+- 正式产物出现本机地址、Token、source map 或超限单文件。
+- 官方应用重名、目标版本不明确、远端源码/运行版本基线未回读。
+- 商城包缺少 `ResourcePolicies.ApiEngines`，或把租户 Hook 错设为 `Managed`。

package/skills/unity-integration/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Microi Unity 集成"
-  short_description: "交付 Unity UPM、WebGL、V8 与可安装 AI 应用"
-  default_prompt: "使用 $unity-integration 设计、实现并分层验收完整的 Microi Unity WebGL 应用。"
+interface:
+  display_name: "Microi Unity 集成"
+  short_description: "交付 Unity UPM、WebGL、V8 与可安装 AI 应用"
+  default_prompt: "使用 $unity-integration 设计、实现并分层验收完整的 Microi Unity WebGL 应用。"

package/skills/unity-integration/references/ai-app-delivery.md

@@ -1,119 +1,119 @@
-# Unity AI 应用与商城交付
-
-## 唯一源码
-
-官方 AI 应用源码放在当前官方连接对应的：
-
-```text
-Microi-V8-Engine/<connection>/<product>/AI应用/<appKey>/
-```
-
-同一应用的 Vue 外壳、Unity 构建接入、V8 源码、Manifest、资源策略、测试和发布合约都从这里生成。Unity 工程可以保留服务端镜像，但必须由唯一源码生成并做一致性检查。
-
-最小文件：
-
-```text
-.microi-micro-app.json
-app.json
-package.json
-microi.routes.json
-package-contract.json
-resource-policies.json
-system.manifest.json
-src/
-public/
-server/engines/
-scripts/
-tests/
-```
-
-## Web 外壳
-
-- Vue 3 + Vite + TypeScript。
-- 复用工作区标准 `microi.v8.js` 与 `microi-ai-app-auth.js`，不要复制改造出第二套认证协议。
-- 匿名模式可以承载公开多人玩法，但必须使用服务端签发、只存哈希、可过期的会话秘密；个人持久化接口仍要求 DiyToken。
-- `ApplicationType=Web`，独立入口为 `index.html`。
-- 构建状态明确区分 `available` 与 `publishable`；无真实 Unity WASM/Data 时禁止正式发布。
-- WebGL 公屏优先使用可访问的 DOM 输入控件，并在 Unity Player 将 `WebGLInput.captureAllKeyboardInput` 设为 `false`；输入区同时隔离键盘、`beforeinput`、组合输入与指针事件。Unity 6 若未向 Player 编译响应文件引用 `UnityEngine.WebGLModule`，可用 `link.xml` 保留类型后反射设置，并必须以真实键盘输入回归。Windows 可使用原生 UI/UIToolkit。不要在外壳和 Unity 中重复绘制同一组操作提示。
-- 语音字幕由真实播放器时间轴逐 cue 驱动，中英文分行放在底部安全区；WebGL DOM 与 Windows 原生 UI 复用同一份字幕数据。固定 `setTimeout` 只能做无音轨占位，不算同步验收。
-
-## 多人租约与公屏交付
-
-- 在线角色的事实源使用按 `OsClient` 隔离的共享数据库/Redis，不能使用 API 节点静态字典；客户端心跳周期必须短于租约超时。
-- 加入响应只向本人返回会话秘密；数据库保存 SHA-256，位置快照只公开昵称、受限坐标、朝向、动作与房间版本。
-- 正常卸载/离开主动调用 leave；浏览器崩溃、断网或 `kill -9` 依靠服务端租约自然失效，并通过两个真实客户端测量消失时间。
-- 公屏接口校验在线会话、内容长度、表情白名单、速率窗口和请求幂等；公开读取只返回有限时间窗和有限条数。浏览器验收用真实按键输入中文、字母、数字、标点、Shift 符号和输入法组合文本，并由第二个独立会话核对原文；直接调用 `fill()`/赋值只能验证服务端，不能证明键盘链路。
-- 轮询是兼容基线；接入 WebSocket/SignalR 时仍保留共享租约为事实源，并用 V8 授权接口签发短期频道权限。
-
-## WebGL 与 Windows 双端交付
-
-- WebGL 与 Windows 必须来自同一个 Unity 工程、场景和语义版本；禁止用旧本地包搭配新网页版本。
-- Windows 默认交付 x64 安装包，至少包含当前用户安装、开始菜单入口和卸载信息；没有明确需求时不申请管理员权限。
-- 外壳应给出醒目的本地版下载入口，并同时显示版本、文件大小与 SHA-256；文件名包含语义版本，旧版本 URL 不覆盖。
-- 安装包属于公开运行资产，不属于私有源码。同步 `directory` 前必须排除 `public/downloads` 等生成目录，再把完整安装包随 `dist` 走流式资产发布；禁止拆分 Base64 或伪装成源码规避单文件上限。
-- 单文件大于 128 MiB 时，MCP 与 `@microi.net/cli` 共用协议 v3：默认 16 MiB 原始字节分片、逐片 HDFS 回读、整文件 SHA-256 和确定性会话。重启后必须先查状态并只补缺片；5 GiB 文件应规划为 320 片，不得重新从 0 开始。
-- v3 不设置 Microi 产品级文件/目录字节上限；对象存储、磁盘、代理与协议技术边界仍需容量预检。发布期间在“系统引擎 → 超大文件上传记录”回读字节进度、心跳、失败原因和恢复建议，终态记录保留用于审计。
-- 发布后从公网地址重新下载完整 EXE，比较字节数和 SHA-256；本地制包成功、MCP 返回文件 Id 或 HTTP HEAD 成功都不能替代完整回读。
-- 本地验收至少覆盖静默安装、主程序存在、可启动和卸载入口；签名状态、SmartScreen 信誉和硬件帧率必须单独如实说明。
-
-## 商城资源
-
-游戏进度表使用应用前缀 `app_*`，不要占用平台保留的 `mci_*` 名称。技术幂等表可以不创建可见菜单；玩家运营表创建父菜单 + 子数据菜单，隐藏 UserId、RequestId、哈希等技术字段。
-
-接口策略示例：
-
-```json
-{
-  "SchemaVersion": 1,
-  "ApiEngines": {
-    "app_game_bootstrap": { "Ownership": "Application", "UpgradePolicy": "Managed" },
-    "app_game_save": { "Ownership": "Application", "UpgradePolicy": "Managed" },
-    "app_game_after_save": { "Ownership": "Tenant", "UpgradePolicy": "CreateIfMissing" }
-  }
-}
-```
-
-租户 Hook 使用新的稳定 Key；首次安装后归租户维护，同 Key 后续版本不能改回 `Managed`。
-
-### 仅共享编译运行产物
-
-消费者只获得运行应用、不安装业务资源时，商城发布显式传
-`RuntimeAssetsOnly=true`。只接受 `ProtocolVersion=3`、`ApplicationType=Web`、
-显式 `IncludeSource=false` 和已通过提交证明校验的 `SharedPublicRuntime`。
-源码是否在本地或私有开发端保管，与消费者包不含源码分别验收；此模式本身不要求上传本地源码。
-
-- 请求资源选择、历史 `SelectMenu/SelectTable/SelectApiEngine/SelectData` 和
-  `PreparedAssets.MenuContract` 均为空，非空时拒绝，不自动抹除；禁止混用 `DatabaseOnlyBuild`。
-- 通过既有 `microi_run_engine.params` 向 `ai_app_publish_store` 传入开关，先
-  `InspectResourceSnapshot` 再 `Publish + ExpectedResourceSnapshotHash`，两次使用同一组冻结参数。
-- 回读真实包的十一项资源数组、`SourceFiles/BuildAssets` 均为零，`SourceZip/BuildZip` 为空，
-  只保留共享运行交付。完整数组和兼容条件见 [应用商城 Skill](../../app-store/SKILL.md#仅共享编译运行产物)。
-- 此模式的目标验收检查编译入口、宿主身份和实际服务契约；没有声明的表、菜单、接口及 Hook
-  不应在消费者租户生成。需要租户业务资源时使用普通资源包流程。
-
-## 官方发布顺序
-
-只有当前 MCP 明确绑定官方 `https://api.itdos.com`、`OsClient=iTdos` 且用户已授权写入时才执行：
-
-1. `microi_list_applications` 按精确 AppKey/中文名查重。
-2. 读取远端应用上下文、源码版本、运行版本、行版本/围栏与路由快照。
-3. 本地完成类型检查、测试、真实 Unity 构建和 dist 完整性校验。
-4. 先同步私有源码；生成的 Unity、安装包与构建证据目录不得混入源码清单。任何期望版本不一致都停止重基线。
-5. 发布不可变 Web 运行版本，回读入口、文件数、哈希、状态与公开 URL。
-   - 官网、二维码、分享与商城“立即体验”必须指向不带版本号的固定当前入口，且游戏加载完成后地址栏仍保持该入口；不能把 `SharedPublicRuntime.EntryUrl`、`/releases/{Version}/requests/...` 或 `/versions/{Version}/` 当作当前体验地址，也不能用 30x、`meta refresh`、`location.replace` 伪装稳定入口。
-   - 不可变版本 URL 只写入历史版本记录、回滚和审计。固定入口可以使用同源全屏加载壳承载当前不可变产物，并必须透传 `autoplay`、`fullscreen` 与 `gamepad` 权限。
-6. 若同时交付 Windows，从稳定公网地址下载完整安装包并核对大小、SHA-256 和版本；在线入口还要加载真实 WASM/Data。
-7. 调用官方 `ai_app_publish_store` 生成并发布精确版本的应用商城包。超时属于结果不确定，必须回读包正文和 ZIP 后才能决定是否重试。
-8. 回读 `sys_microistore` 的 AppKey、版本、状态、预览图、包摘要与资源策略，断言 `AppVersion == PackageInfo.Version == PreparedAssets.PackageVersion`。
-9. 在官网 `/apps.html` 和 `/app-detail.html?app=<appKey>` 做公开页面回读。
-10. 在一个非官方测试租户安装，回读表、菜单、接口和 Hook 所有权；再验证升级不覆盖租户 Hook。
-11. 多人应用用两个独立浏览器会话互相验证昵称、位置、公屏；强制关闭一端，确认超过约定租约后另一端不再看到该角色。
-
-源码同步、运行发布、商城发布、官网可见、目标租户安装是五项独立事实。任一步只有受理 ID 或 `doing` 状态，都不能报告最终成功。
-
-## 版本与回滚
-
-- 运行产物不可变；相同版本不可覆盖为不同哈希。
-- 商城版本必须精确对应已验证运行版本与 Manifest。
-- 升级遵循先扩展、后迁移、再收缩；新旧运行版本短暂并存时协议向前/向后兼容。
-- 回滚恢复上一不可变运行版本；数据库变更需要显式兼容/补偿方案，不能用文件回滚伪装数据回滚。
+# Unity AI 应用与商城交付
+
+## 唯一源码
+
+官方 AI 应用源码放在当前官方连接对应的：
+
+```text
+Microi-V8-Engine/<connection>/<product>/AI应用/<appKey>/
+```
+
+同一应用的 Vue 外壳、Unity 构建接入、V8 源码、Manifest、资源策略、测试和发布合约都从这里生成。Unity 工程可以保留服务端镜像，但必须由唯一源码生成并做一致性检查。
+
+最小文件：
+
+```text
+.microi-micro-app.json
+app.json
+package.json
+microi.routes.json
+package-contract.json
+resource-policies.json
+system.manifest.json
+src/
+public/
+server/engines/
+scripts/
+tests/
+```
+
+## Web 外壳
+
+- Vue 3 + Vite + TypeScript。
+- 复用工作区标准 `microi.v8.js` 与 `microi-ai-app-auth.js`，不要复制改造出第二套认证协议。
+- 匿名模式可以承载公开多人玩法，但必须使用服务端签发、只存哈希、可过期的会话秘密；个人持久化接口仍要求 DiyToken。
+- `ApplicationType=Web`，独立入口为 `index.html`。
+- 构建状态明确区分 `available` 与 `publishable`；无真实 Unity WASM/Data 时禁止正式发布。
+- WebGL 公屏优先使用可访问的 DOM 输入控件，并在 Unity Player 将 `WebGLInput.captureAllKeyboardInput` 设为 `false`；输入区同时隔离键盘、`beforeinput`、组合输入与指针事件。Unity 6 若未向 Player 编译响应文件引用 `UnityEngine.WebGLModule`，可用 `link.xml` 保留类型后反射设置，并必须以真实键盘输入回归。Windows 可使用原生 UI/UIToolkit。不要在外壳和 Unity 中重复绘制同一组操作提示。
+- 语音字幕由真实播放器时间轴逐 cue 驱动，中英文分行放在底部安全区；WebGL DOM 与 Windows 原生 UI 复用同一份字幕数据。固定 `setTimeout` 只能做无音轨占位，不算同步验收。
+
+## 多人租约与公屏交付
+
+- 在线角色的事实源使用按 `OsClient` 隔离的共享数据库/Redis，不能使用 API 节点静态字典；客户端心跳周期必须短于租约超时。
+- 加入响应只向本人返回会话秘密；数据库保存 SHA-256，位置快照只公开昵称、受限坐标、朝向、动作与房间版本。
+- 正常卸载/离开主动调用 leave；浏览器崩溃、断网或 `kill -9` 依靠服务端租约自然失效，并通过两个真实客户端测量消失时间。
+- 公屏接口校验在线会话、内容长度、表情白名单、速率窗口和请求幂等；公开读取只返回有限时间窗和有限条数。浏览器验收用真实按键输入中文、字母、数字、标点、Shift 符号和输入法组合文本，并由第二个独立会话核对原文；直接调用 `fill()`/赋值只能验证服务端，不能证明键盘链路。
+- 轮询是兼容基线；接入 WebSocket/SignalR 时仍保留共享租约为事实源，并用 V8 授权接口签发短期频道权限。
+
+## WebGL 与 Windows 双端交付
+
+- WebGL 与 Windows 必须来自同一个 Unity 工程、场景和语义版本；禁止用旧本地包搭配新网页版本。
+- Windows 默认交付 x64 安装包，至少包含当前用户安装、开始菜单入口和卸载信息；没有明确需求时不申请管理员权限。
+- 外壳应给出醒目的本地版下载入口，并同时显示版本、文件大小与 SHA-256；文件名包含语义版本，旧版本 URL 不覆盖。
+- 安装包属于公开运行资产，不属于私有源码。同步 `directory` 前必须排除 `public/downloads` 等生成目录，再把完整安装包随 `dist` 走流式资产发布；禁止拆分 Base64 或伪装成源码规避单文件上限。
+- 单文件大于 128 MiB 时，MCP 与 `@microi.net/cli` 共用协议 v3：默认 16 MiB 原始字节分片、逐片 HDFS 回读、整文件 SHA-256 和确定性会话。重启后必须先查状态并只补缺片；5 GiB 文件应规划为 320 片，不得重新从 0 开始。
+- v3 不设置 Microi 产品级文件/目录字节上限；对象存储、磁盘、代理与协议技术边界仍需容量预检。发布期间在“系统引擎 → 超大文件上传记录”回读字节进度、心跳、失败原因和恢复建议，终态记录保留用于审计。
+- 发布后从公网地址重新下载完整 EXE，比较字节数和 SHA-256；本地制包成功、MCP 返回文件 Id 或 HTTP HEAD 成功都不能替代完整回读。
+- 本地验收至少覆盖静默安装、主程序存在、可启动和卸载入口；签名状态、SmartScreen 信誉和硬件帧率必须单独如实说明。
+
+## 商城资源
+
+游戏进度表使用应用前缀 `app_*`，不要占用平台保留的 `mci_*` 名称。技术幂等表可以不创建可见菜单；玩家运营表创建父菜单 + 子数据菜单，隐藏 UserId、RequestId、哈希等技术字段。
+
+接口策略示例：
+
+```json
+{
+  "SchemaVersion": 1,
+  "ApiEngines": {
+    "app_game_bootstrap": { "Ownership": "Application", "UpgradePolicy": "Managed" },
+    "app_game_save": { "Ownership": "Application", "UpgradePolicy": "Managed" },
+    "app_game_after_save": { "Ownership": "Tenant", "UpgradePolicy": "CreateIfMissing" }
+  }
+}
+```
+
+租户 Hook 使用新的稳定 Key；首次安装后归租户维护，同 Key 后续版本不能改回 `Managed`。
+
+### 仅共享编译运行产物
+
+消费者只获得运行应用、不安装业务资源时，商城发布显式传
+`RuntimeAssetsOnly=true`。只接受 `ProtocolVersion=3`、`ApplicationType=Web`、
+显式 `IncludeSource=false` 和已通过提交证明校验的 `SharedPublicRuntime`。
+源码是否在本地或私有开发端保管，与消费者包不含源码分别验收；此模式本身不要求上传本地源码。
+
+- 请求资源选择、历史 `SelectMenu/SelectTable/SelectApiEngine/SelectData` 和
+  `PreparedAssets.MenuContract` 均为空，非空时拒绝，不自动抹除；禁止混用 `DatabaseOnlyBuild`。
+- 通过既有 `microi_run_engine.params` 向 `ai_app_publish_store` 传入开关，先
+  `InspectResourceSnapshot` 再 `Publish + ExpectedResourceSnapshotHash`，两次使用同一组冻结参数。
+- 回读真实包的十一项资源数组、`SourceFiles/BuildAssets` 均为零，`SourceZip/BuildZip` 为空，
+  只保留共享运行交付。完整数组和兼容条件见 [应用商城 Skill](../../app-store/SKILL.md#仅共享编译运行产物)。
+- 此模式的目标验收检查编译入口、宿主身份和实际服务契约；没有声明的表、菜单、接口及 Hook
+  不应在消费者租户生成。需要租户业务资源时使用普通资源包流程。
+
+## 官方发布顺序
+
+只有当前 MCP 明确绑定官方 `https://api.itdos.com`、`OsClient=iTdos` 且用户已授权写入时才执行：
+
+1. `microi_list_applications` 按精确 AppKey/中文名查重。
+2. 读取远端应用上下文、源码版本、运行版本、行版本/围栏与路由快照。
+3. 本地完成类型检查、测试、真实 Unity 构建和 dist 完整性校验。
+4. 先同步私有源码；生成的 Unity、安装包与构建证据目录不得混入源码清单。任何期望版本不一致都停止重基线。
+5. 发布不可变 Web 运行版本，回读入口、文件数、哈希、状态与公开 URL。
+   - 官网、二维码、分享与商城“立即体验”必须指向不带版本号的固定当前入口，且游戏加载完成后地址栏仍保持该入口；不能把 `SharedPublicRuntime.EntryUrl`、`/releases/{Version}/requests/...` 或 `/versions/{Version}/` 当作当前体验地址，也不能用 30x、`meta refresh`、`location.replace` 伪装稳定入口。
+   - 不可变版本 URL 只写入历史版本记录、回滚和审计。固定入口可以使用同源全屏加载壳承载当前不可变产物，并必须透传 `autoplay`、`fullscreen` 与 `gamepad` 权限。
+6. 若同时交付 Windows，从稳定公网地址下载完整安装包并核对大小、SHA-256 和版本；在线入口还要加载真实 WASM/Data。
+7. 调用官方 `ai_app_publish_store` 生成并发布精确版本的应用商城包。超时属于结果不确定，必须回读包正文和 ZIP 后才能决定是否重试。
+8. 回读 `sys_microistore` 的 AppKey、版本、状态、预览图、包摘要与资源策略，断言 `AppVersion == PackageInfo.Version == PreparedAssets.PackageVersion`。
+9. 在官网 `/apps.html` 和 `/app-detail.html?app=<appKey>` 做公开页面回读。
+10. 在一个非官方测试租户安装，回读表、菜单、接口和 Hook 所有权；再验证升级不覆盖租户 Hook。
+11. 多人应用用两个独立浏览器会话互相验证昵称、位置、公屏；强制关闭一端，确认超过约定租约后另一端不再看到该角色。
+
+源码同步、运行发布、商城发布、官网可见、目标租户安装是五项独立事实。任一步只有受理 ID 或 `doing` 状态，都不能报告最终成功。
+
+## 版本与回滚
+
+- 运行产物不可变；相同版本不可覆盖为不同哈希。
+- 商城版本必须精确对应已验证运行版本与 Manifest。
+- 升级遵循先扩展、后迁移、再收缩；新旧运行版本短暂并存时协议向前/向后兼容。
+- 回滚恢复上一不可变运行版本；数据库变更需要显式兼容/补偿方案，不能用文件回滚伪装数据回滚。