@microi.net/cli 5.9.2 → 5.9.4

package/skills/ai-engine/references/ai-employees.md

@@ -1,48 +1,48 @@
-# AI 员工与执行节点
-
-用于将岗位、任务、执行、成果和验收组织成可交付应用。优先使用低代码表与受管接口引擎；缺少可信运行时原子时才扩展后端。
-
-## 组织与任务
-
-- 员工有职责、交付标准、模型、能力和状态；创建岗位不等于创建管理员帐号。
-- 任务明确目标、输入、验收标准、前置依赖、负责人和执行方式。人工指定的强依赖只读取已验收成果；同一自治目标下的岗位可以读取明确标记为“未验收草稿”的同伴成果，不得把它当成真实完成证据。
-- 自治目标由负责人创建并启用；项目经理每日最多生成一次有界规划，服务端仅接受固定十岗、最多十项、只生成草稿的 JSON 任务。目标暂停、预算耗尽或节点离线时不得继续领取。
-- 数据库保存任务、执行批次、成果哈希和审计。本地 JSON、聊天记录和内存定时器不能作为跨节点任务事实源。
-- 当前 DiyToken 决定租户和负责人，忽略客户端身份字段。列表、详情、依赖、写入、报告均校验同一数据范围；前端隐藏字段不是授权。
-- 原生 CRUD 不得绕过任务状态机或伪造审批。执行者只能报告有效尝试，不能替负责人验收。
-
-## 模型与持久执行
-
-后端 `V8.AI.Chat` 的 `AiModel` 不能假定可留空。先从当前用户获授权的目录选择 `AiModel / AiModelId`；显式模型不可用时失败，不能静默切换账号。Key 与 Endpoint 保留在可信后端。
-
-长调用通过平台持久后台任务执行。领取先提交，再调用外部模型；组合稳定幂等键、数据库条件写入、租约和旧执行者拒绝。调用无法回滚时，独立保存开始标记；重启后结果未知就核对，不盲目重发。等待模型时不能持有业务行锁。
-
-远端通过 `microi_run_engine_background` 入队，使用 `microi_list_background_tasks` 看运行状态，同时回读任务与成果。TaskId、后台 Succeeded、生成成功、业务验收通过是不同证据。
-
-每位负责人有可动态配置的日 Token 上限，默认 1,000,000。每次领取在同一事务内预留保守额度，模型回报后用供应商实际 usage 结算；未知用量按全额预留计入预算并在界面标明，不得按字符数伪造实际用量。已发出的外部请求可能超出预留，因此这是接单闸门而非供应商侧绝对封顶；需要硬封顶时还必须给模型设置输出上限并在供应商侧核验。尝试次数不是 Token 或金额预算。
-
-## OpenClaw 适配
-
-先核对安装版本和官方协议。旧版使用 `agents.list`，其他版本可能使用 `agents.entries`；两者并存或格式未知时报错，不能猜测迁移。
-
-- 显式指定 Agent，并按租户、负责人、任务、尝试建立会话键；不回退 `main`。
-- 每个负责人/岗位使用独立 workspace 与 agentDir，拒绝路径越界与符号链接，不共享不同身份的凭据目录。
-- Gateway HTTP 凭据具有管理范围权限，只留在本机服务端。目录隔离不等于系统隔离，不可信租户应使用独立 Gateway、系统用户或容器。
-- 草稿型员工可要求真实 `tools.deny` 包含 `*`。扩大为工具执行时，逐项增加授权、能力白名单、目录/网络边界、审批和副作用回读。提示词过滤不是沙箱。
-- 手工 OpenClaw 任务仍需逐次批准；负责人开启自治后，节点可在指定目标内自行规划、创建和领取草稿任务。续租失败或取消时停止后续工作。报告超时重放同一报告，不重新生成；未知结果不自动重试。
-- 24 小时模式以节点进程、Gateway、网络和有效 DiyToken 持续可用为前提。Electron 下仅在系统安全存储可用时加密保存会话与待报告成果，重启后须重新验证 DiyToken；普通 Node 运行不落盘凭据。Windows/macOS 打包版可注册登录启动，Mac 未签名版本须独立验证启动项。不可把计时器测试写成连续 24 小时实测。
-- Gateway 使用当前版本 OpenClaw 所要求的 Node.js 运行时；例如 `2026.3.11` 要求 Node.js `>=22.12.0`。管理页面可访问不证明 Gateway 已启动。
-- MiniMax 等模型可能在 `message.content` 中混入推理或写作计划。用按任务、尝试生成的唯一终稿标记限定可回传正文；标记缺失、重复、错序或正文为空时失败关闭并人工核对，不按英文前缀、Markdown 标题或关键词猜测截断位置。
-- 准备配置只新增声明资源，保存前复核原配置，保留默认 Agent、密钥和并行修改。重启 Gateway 与发布新版客户端是独立动作。
-
-## 验收与边界
-
-桌面工作台未登录时只显示连接引导，不调用员工业务接口、不暴露原始 IPC 堆栈。已登录连接只读取当前租户/负责人的团队；切换连接时丢弃旧请求的迟到响应。任务需填写成果目标、验收标准和执行方式，依赖只可选择已验收任务；重复提交沿用请求标识，发生不确定结果时先回读。
-
-节点停止接单时不能在迟到的队列查询后继续领取，也不能丢弃正在生成或待回传成果。成果先持久化、后报告；云端接收后本地清理失败仍重放相同报告，不重新调用模型。测试必须分别覆盖真实云端模型、跨岗验收接力、真实本机 HTTP 协议和界面操作；界面夹具不代表真实 Gateway 已联调。
-
-覆盖幂等去重与内容冲突、负责人隔离、依赖未验收、同员工并发、旧租约报告、取消后迟到结果、退回后的独立成果、尝试上限、报告网络失败、预算并发、每日规划幂等、跨岗位草稿协作和进程重启。完整 24 小时验收还需真实节点与模型连续运行和跨日预算回读。
-
-财务、招聘、合同、营销和客服草稿不代表已付款、录用、签署或发送。测试计划与代码草稿不代表测试通过；实际完成需要执行日志、产物与独立回读。
-
-分别报告云端应用、桌面源码/构建、安装包发行、真实 Gateway 联调以及官网源码/部署；任一项通过不能替代其他层。
+# AI 员工与执行节点
+
+用于将岗位、任务、执行、成果和验收组织成可交付应用。优先使用低代码表与受管接口引擎；缺少可信运行时原子时才扩展后端。
+
+## 组织与任务
+
+- 员工有职责、交付标准、模型、能力和状态；创建岗位不等于创建管理员帐号。
+- 任务明确目标、输入、验收标准、前置依赖、负责人和执行方式。人工指定的强依赖只读取已验收成果；同一自治目标下的岗位可以读取明确标记为“未验收草稿”的同伴成果，不得把它当成真实完成证据。
+- 自治目标由负责人创建并启用；项目经理每日最多生成一次有界规划，服务端仅接受固定十岗、最多十项、只生成草稿的 JSON 任务。目标暂停、预算耗尽或节点离线时不得继续领取。
+- 数据库保存任务、执行批次、成果哈希和审计。本地 JSON、聊天记录和内存定时器不能作为跨节点任务事实源。
+- 当前 DiyToken 决定租户和负责人，忽略客户端身份字段。列表、详情、依赖、写入、报告均校验同一数据范围；前端隐藏字段不是授权。
+- 原生 CRUD 不得绕过任务状态机或伪造审批。执行者只能报告有效尝试，不能替负责人验收。
+
+## 模型与持久执行
+
+后端 `V8.AI.Chat` 的 `AiModel` 不能假定可留空。先从当前用户获授权的目录选择 `AiModel / AiModelId`；显式模型不可用时失败，不能静默切换账号。Key 与 Endpoint 保留在可信后端。
+
+长调用通过平台持久后台任务执行。领取先提交，再调用外部模型；组合稳定幂等键、数据库条件写入、租约和旧执行者拒绝。调用无法回滚时，独立保存开始标记；重启后结果未知就核对，不盲目重发。等待模型时不能持有业务行锁。
+
+远端通过 `microi_run_engine_background` 入队，使用 `microi_list_background_tasks` 看运行状态，同时回读任务与成果。TaskId、后台 Succeeded、生成成功、业务验收通过是不同证据。
+
+每位负责人有可动态配置的日 Token 上限，默认 1,000,000。每次领取在同一事务内预留保守额度，模型回报后用供应商实际 usage 结算；未知用量按全额预留计入预算并在界面标明，不得按字符数伪造实际用量。已发出的外部请求可能超出预留，因此这是接单闸门而非供应商侧绝对封顶；需要硬封顶时还必须给模型设置输出上限并在供应商侧核验。尝试次数不是 Token 或金额预算。
+
+## OpenClaw 适配
+
+先核对安装版本和官方协议。旧版使用 `agents.list`，其他版本可能使用 `agents.entries`；两者并存或格式未知时报错，不能猜测迁移。
+
+- 显式指定 Agent，并按租户、负责人、任务、尝试建立会话键；不回退 `main`。
+- 每个负责人/岗位使用独立 workspace 与 agentDir，拒绝路径越界与符号链接，不共享不同身份的凭据目录。
+- Gateway HTTP 凭据具有管理范围权限，只留在本机服务端。目录隔离不等于系统隔离，不可信租户应使用独立 Gateway、系统用户或容器。
+- 草稿型员工可要求真实 `tools.deny` 包含 `*`。扩大为工具执行时，逐项增加授权、能力白名单、目录/网络边界、审批和副作用回读。提示词过滤不是沙箱。
+- 手工 OpenClaw 任务仍需逐次批准；负责人开启自治后，节点可在指定目标内自行规划、创建和领取草稿任务。续租失败或取消时停止后续工作。报告超时重放同一报告，不重新生成；未知结果不自动重试。
+- 24 小时模式以节点进程、Gateway、网络和有效 DiyToken 持续可用为前提。Electron 下仅在系统安全存储可用时加密保存会话与待报告成果，重启后须重新验证 DiyToken；普通 Node 运行不落盘凭据。Windows/macOS 打包版可注册登录启动，Mac 未签名版本须独立验证启动项。不可把计时器测试写成连续 24 小时实测。
+- Gateway 使用当前版本 OpenClaw 所要求的 Node.js 运行时；例如 `2026.3.11` 要求 Node.js `>=22.12.0`。管理页面可访问不证明 Gateway 已启动。
+- MiniMax 等模型可能在 `message.content` 中混入推理或写作计划。用按任务、尝试生成的唯一终稿标记限定可回传正文；标记缺失、重复、错序或正文为空时失败关闭并人工核对，不按英文前缀、Markdown 标题或关键词猜测截断位置。
+- 准备配置只新增声明资源，保存前复核原配置，保留默认 Agent、密钥和并行修改。重启 Gateway 与发布新版客户端是独立动作。
+
+## 验收与边界
+
+桌面工作台未登录时只显示连接引导，不调用员工业务接口、不暴露原始 IPC 堆栈。已登录连接只读取当前租户/负责人的团队；切换连接时丢弃旧请求的迟到响应。任务需填写成果目标、验收标准和执行方式，依赖只可选择已验收任务；重复提交沿用请求标识，发生不确定结果时先回读。
+
+节点停止接单时不能在迟到的队列查询后继续领取，也不能丢弃正在生成或待回传成果。成果先持久化、后报告；云端接收后本地清理失败仍重放相同报告，不重新调用模型。测试必须分别覆盖真实云端模型、跨岗验收接力、真实本机 HTTP 协议和界面操作；界面夹具不代表真实 Gateway 已联调。
+
+覆盖幂等去重与内容冲突、负责人隔离、依赖未验收、同员工并发、旧租约报告、取消后迟到结果、退回后的独立成果、尝试上限、报告网络失败、预算并发、每日规划幂等、跨岗位草稿协作和进程重启。完整 24 小时验收还需真实节点与模型连续运行和跨日预算回读。
+
+财务、招聘、合同、营销和客服草稿不代表已付款、录用、签署或发送。测试计划与代码草稿不代表测试通过；实际完成需要执行日志、产物与独立回读。
+
+分别报告云端应用、桌面源码/构建、安装包发行、真实 Gateway 联调以及官网源码/部署；任一项通过不能替代其他层。

package/skills/ai-engine/references/self-hosted-digital-human.md

@@ -1,59 +1,59 @@
-# 自建数字人直播交付规范
-
-## 先确定运行边界
-
-用户要求免费、自建、不扣 token 时，默认采用用户自己的推理设备。模型仍处理 token，但本机计算没有供应商按次账单；硬件、电费、存储和吾码自身部署成本不能省略。禁止静默使用 MiniMax、吾码中转、Edge TTS、ZeroGPU 或在线试用作为本地推理成功的证据。
-
-先盘点当前 MCP 的在线应用和实时 Schema，再读取目标应用源码。吾码负责话术、知识、角色、任务和记录，媒体运行时负责模型与音画。已有适合应用时扩展其页面，没有才创建 MicroService。业务表、字段、菜单和权限由 Manifest/应用包交付，不为数字人业务新增平台 Controller。
-
-Windows 本机参考方案可采用 CPU 运行轻量 Qwen 与中文 TTS、CUDA 运行口型模型，并通过 WebRTC 向浏览器或 OBS 输出。若实现先生成片段再播报，应如实标注缓冲策略，不应描述成低延迟全双工数字人。输出帧率、模型生成帧率、首音延迟和总等待时间必须分开报告。
-
-照片驱动或视频换脸须先区分目标：只换脸保留驱动视频的身体和衣服；照片人物连同衣服动作需把源照片的人像区域随视频姿态形变。轻量关键点/二维形变不能凭空生成照片未拍到的部位，也不能保证大转身、遮挡或手部交叉的真实感。8 GB 显存设备不能因某模型的单个模块可运行，就推断完整生成链能实时运行；先核对权重许可与实测峰值，再承诺交互帧率。
-
-商业交付若要求零模型授权费，分别核查代码、检测器、关键点模型、生成权重和样例素材。InsightFace 代码许可与其预训练模型许可不同，不能因某个项目整体标记 MIT 就直接打包非商用检测权重。LivePortrait 可评估以 MediaPipe 替代 InsightFace 检测，但还须固定官方权重 revision 与 SHA-256，实测输出并保留其 MIT 声明。部分 FasterLivePortrait ONNX 权重能加载，却在普通 ONNX Runtime 的 5D `GridSample` 实际推理时报错；“加载成功”不是模型可运行的证据，需验证完整生成帧。
-
-换脸模型选型要追踪身份向量的来源：FaceFusion 官方清单标记 GHOST 为 Apache-2.0、CrossFace 为 OpenRAIL-M，但其当前人脸识别代码仍由标记非商用的 ArcFace 产生身份向量；INSwapper 本身也标记非商用。不能只检查最后一段 GHOST 权重就宣称整条链可零授权费商用。参见 https://docs.facefusion.io/introduction/licenses 与 https://github.com/facefusion/facefusion/blob/master/facefusion/face_recognizer.py 。本机曾试用神经头像输出做只换脸合成，24 帧约 6.66 fps，但胡须、头发和下颌接缝使身份不一致；该原型未发布，不计入交付。
-
-当前 `digital-human-live` v0.4.2 本机路线使用 FasterLivePortrait 的 ONNX 预处理、MediaPipe 检测和 LivePortrait 官方 PyTorch 生成模块，避开 InsightFace 检测权重与 ONNX 5D `GridSample` 限制。源码保留两方 MIT 文本，权重由 `runtime/portrait-model-lock.json` 固定 revision、大小和 SHA-256，下载后仅放入 `.local/portrait`。RTX 2080 SUPER 上的 W/G 生成模块用 CUDA 半精度自动混合精度后，24 帧完整 HTTP 任务实测 6.85 fps、480 × 640；UI 和文档应写成“神经网络头像预览/短片生成”，不得仅凭输出 MP4 的 12 fps 编码帧率承诺流畅实时直播。它保留源照片的衣服和背景，但不做全身服饰动作；原二维换脸与服饰形变应标为实验性。
-
-## 资源与模型
-
-- 检查当前显卡、可用显存、内存、磁盘、已有进程和端口。不得为了腾显存结束未知进程。使用应用自己的 Python 环境，不修改共享环境。
-- Windows 中文工作区中，部分原生 TTS / OpenCV 文件接口无法打开包含中文的绝对路径；优先在确定的运行目录中使用相对路径，并真实测试人像检测、语音生成与启动脚本，不能只测 Python 文件读取。
-- 大文件固定官方仓库 revision、预期大小和 SHA-256；分段下载校验 Content-Range，支持原任务续传，下载完成后再加载。不把失败下载或仅安装依赖计为推理通过。
-- 模型运行使用 `local_files_only` 和离线模式，无付费回退。运行时清除本进程继承的 HTTP/HTTPS/ALL proxy，避免本地代理成为外网旁路；随后限制外连。安装下载是独立过程，不全局修改用户代理。
-- 权重许可、代码许可、人像/声音的使用权分别核对。研究测试素材仅用于本地研究验证，不放进公开应用包或默认当商业主播素材。
-- 源人像与驱动视频需获得相应使用权，输出应标记为 AI 合成。官网截图若使用合成人像与虚拟摄像头，应写清素材来源和实测边界；不得暗示真实人物已授权或外部平台已开播。
-- 低端设备可以先合成片段、缓冲后播放；必须把该策略写入 UI 和文档。不能用静态图循环、音量驱动嘴型或测试桩冒充神经网络口型模型已经运行。
-
-## 本机配对与吾码会话
-
-- DiyToken 仍是吾码身份与权限入口。数据请求使用平台 SDK、当前租户和真实模块权限；不要把 DiyToken 发往本机模型或其它第三方。
-- 若旧节点的 MCP 模块更新白名单不支持 ModuleEngineKey，不能以接口成功代替字段回读。可通过已有平台授权菜单接口的窄字段投影解析当前租户真实菜单 Id，携带 `_SysMenuId` 调用 FormEngine；不能写死发行租户 Id、放宽表权限或绕过标准 MCP 写入。
-- 本机运行时只监听回环地址，另用随机配对码换取有期限、绑定 Origin 的本机会话。配对码、内部模型密钥和访问会话不出现在 URL、云端业务列或日志中。
-- 同源浏览器的 JSON 配对 POST 可以带 `Origin`，后续同源 GET 可能省略该头；网关校验缺失头时应以已验证的回环 Host 和 scheme 还原同源，显式跨域 `Origin` 仍须与配对来源完全一致。OBS 浏览器来源应回读 `peers>0` 和有画面、有音轨的实际录像，不能只看配对按钮被点击。
-- CORS 使用精确 Origin 列表，同时校验 Host；需要浏览器本地网络权限时明确给出诊断，不以通配 CORS 或绑定公网地址规避限制。
-- 前端不开放任意 Endpoint、文件路径、命令、RTMP shell 参数或 Python 代码。模型输出只是待播报文本，不能执行 V8、SQL 或操作业务数据。
-- 本机媒体任务可由当前租户 Managed 接口引擎先验证 DiyToken、菜单/表读取权限、模式与稳定 requestId；接口仅返回本机执行契约，媒体字节只送往已配对的回环服务。租户 Hook 用 CreateIfMissing 保留扩展点。不能把远端接口返回成功当作本机视频已生成。
-- 手机摄像头接入优先让手机 HTTPS 页面与电脑浏览器在同一局域网经 WebRTC 直传媒体，再由电脑浏览器访问回环服务；不要把回环地址绑定公网，也不要把摄像头字节送到 V8。MCP 接口引擎可以用同一登录用户、租户和真实菜单权限交换短期 SDP，房间码绑定用户且限时，单条 SDP 长度受限，相同 SDP 重试幂等、不同 SDP 拒绝接管。SDP 控制信息经过吾码服务器，应如实披露；无 TURN/STUN 版本只承诺局域网可达，不能承诺跨网或被客户端隔离的 Wi-Fi 可用。
-- 请求使用稳定 requestId；相同请求返回原任务，参数改变则拒绝。队列有界、停止可见、失败可诊断；状态与文件回读一致后才标为完成。
-
-## 源码交付
-
-- `.gitignore` 不等于 MCP 源码同步排除。必须在 `.microi-micro-app.json` 显式声明 `SourceExcludes`，排除虚拟环境、模型、凭据、人像、生成媒体、缓存和本机运行日志。
-- 运行时源码、固定依赖、模型 lock、安装/启动/停止脚本和测试进入私有源码；编译产物进入公有运行目录。应用包不得带发布者的配对码或设备配置。
-- 官网完整交付文档维护在独立菜单 `microi.doc/docs/doc/system-engine/digital-human-live.md`；`ai-engine.md` 的 `self-hosted-digital-human-live` 锚点保留入口链接。功能截图从真实页面组件采集并检查原始像素；使用隔离示例数据时必须在图内和文案中明确标注，不能把它称作线上租户数据或真实开播效果。
-- MCP 已有应用发现、Manifest、元数据、源码同步和 v3 发布能力时直接复用，不为重复流程新增工具。交付记录明确四项状态：应用包、官网源码、Skills、MCP 复用/变更。
-
-## 验收
-
-1. 用 MCP 计划、dry-run、写入、结构回读，并验证业务新增/读取/修改/删除及权限拒绝。
-2. 真模型生成中文音频，检测非静音、采样率与时长；真实口型模型生成帧，检查嘴部变化和图像输出。
-3. 音频与视频探针校验时长、帧率、画面尺寸；WebRTC 接收者实际收到音视频，并检查浏览器播放。
-4. 测试错误配对码、未授权请求、非白名单 Origin、请求重放冲突、队列上限、停止、模型缺失与外网拒绝。安全测试桩与真实模型验收分别记录。
-5. 桌面/窄屏/深色界面、空态、失败态、素材 CRUD、菜单生命周期与输出页实际操作通过。
-6. OBS 捕获和外部平台开播独立验收。OBS“媒体来源”循环播放已生成 MP4，只证明片段可被 OBS 录制；浏览器来源需要确认配对面板消失、服务端 WebRTC `peers` 大于 0，且 OBS 录制回读有真实音画，才能判为实时接入。未提供直播账号、推流地址或密钥时完成本机输出，明确外部直播未验证，不请求无关账号，不伪造“已开播”。
-7. 换脸/照片动作另外验收：实际输入照片和视频，核对生成视频帧数、时长、人物和服装区域变化；分别验证神经网络头像、实验性二维只换脸和实验性二维服饰动作的实际模型路径与质量。浏览器摄像头或虚拟摄像头需检查帧回传和所选模式确实传入本机运行时，不把 4K 页面截图或视频编码帧率说成 4K 实时推理。
-8. 手机链路先在两个独立浏览器会话检查信令与 WebRTC `inbound-rtp` 的解码帧，再检查电脑回环推理画布与停止释放；进一步用实体手机同网实测摄像头授权、屏幕锁定、断线重连、长时帧率和 OBS 捕获。浏览器模拟的窄屏截图不能替代实体手机验收。
-
-验收报告保留应用版本、模型 revision、真实设备、内存/显存峰值、生成帧率、等待时间和媒体摘要，不能只写“接口成功”。
+# 自建数字人直播交付规范
+
+## 先确定运行边界
+
+用户要求免费、自建、不扣 token 时，默认采用用户自己的推理设备。模型仍处理 token，但本机计算没有供应商按次账单；硬件、电费、存储和吾码自身部署成本不能省略。禁止静默使用 MiniMax、吾码中转、Edge TTS、ZeroGPU 或在线试用作为本地推理成功的证据。
+
+先盘点当前 MCP 的在线应用和实时 Schema，再读取目标应用源码。吾码负责话术、知识、角色、任务和记录，媒体运行时负责模型与音画。已有适合应用时扩展其页面，没有才创建 MicroService。业务表、字段、菜单和权限由 Manifest/应用包交付，不为数字人业务新增平台 Controller。
+
+Windows 本机参考方案可采用 CPU 运行轻量 Qwen 与中文 TTS、CUDA 运行口型模型，并通过 WebRTC 向浏览器或 OBS 输出。若实现先生成片段再播报，应如实标注缓冲策略，不应描述成低延迟全双工数字人。输出帧率、模型生成帧率、首音延迟和总等待时间必须分开报告。
+
+照片驱动或视频换脸须先区分目标：只换脸保留驱动视频的身体和衣服；照片人物连同衣服动作需把源照片的人像区域随视频姿态形变。轻量关键点/二维形变不能凭空生成照片未拍到的部位，也不能保证大转身、遮挡或手部交叉的真实感。8 GB 显存设备不能因某模型的单个模块可运行，就推断完整生成链能实时运行；先核对权重许可与实测峰值，再承诺交互帧率。
+
+商业交付若要求零模型授权费，分别核查代码、检测器、关键点模型、生成权重和样例素材。InsightFace 代码许可与其预训练模型许可不同，不能因某个项目整体标记 MIT 就直接打包非商用检测权重。LivePortrait 可评估以 MediaPipe 替代 InsightFace 检测，但还须固定官方权重 revision 与 SHA-256，实测输出并保留其 MIT 声明。部分 FasterLivePortrait ONNX 权重能加载，却在普通 ONNX Runtime 的 5D `GridSample` 实际推理时报错；“加载成功”不是模型可运行的证据，需验证完整生成帧。
+
+换脸模型选型要追踪身份向量的来源：FaceFusion 官方清单标记 GHOST 为 Apache-2.0、CrossFace 为 OpenRAIL-M，但其当前人脸识别代码仍由标记非商用的 ArcFace 产生身份向量；INSwapper 本身也标记非商用。不能只检查最后一段 GHOST 权重就宣称整条链可零授权费商用。参见 https://docs.facefusion.io/introduction/licenses 与 https://github.com/facefusion/facefusion/blob/master/facefusion/face_recognizer.py 。本机曾试用神经头像输出做只换脸合成，24 帧约 6.66 fps，但胡须、头发和下颌接缝使身份不一致；该原型未发布，不计入交付。
+
+当前 `digital-human-live` v0.4.2 本机路线使用 FasterLivePortrait 的 ONNX 预处理、MediaPipe 检测和 LivePortrait 官方 PyTorch 生成模块，避开 InsightFace 检测权重与 ONNX 5D `GridSample` 限制。源码保留两方 MIT 文本，权重由 `runtime/portrait-model-lock.json` 固定 revision、大小和 SHA-256，下载后仅放入 `.local/portrait`。RTX 2080 SUPER 上的 W/G 生成模块用 CUDA 半精度自动混合精度后，24 帧完整 HTTP 任务实测 6.85 fps、480 × 640；UI 和文档应写成“神经网络头像预览/短片生成”，不得仅凭输出 MP4 的 12 fps 编码帧率承诺流畅实时直播。它保留源照片的衣服和背景，但不做全身服饰动作；原二维换脸与服饰形变应标为实验性。
+
+## 资源与模型
+
+- 检查当前显卡、可用显存、内存、磁盘、已有进程和端口。不得为了腾显存结束未知进程。使用应用自己的 Python 环境，不修改共享环境。
+- Windows 中文工作区中，部分原生 TTS / OpenCV 文件接口无法打开包含中文的绝对路径；优先在确定的运行目录中使用相对路径，并真实测试人像检测、语音生成与启动脚本，不能只测 Python 文件读取。
+- 大文件固定官方仓库 revision、预期大小和 SHA-256；分段下载校验 Content-Range，支持原任务续传，下载完成后再加载。不把失败下载或仅安装依赖计为推理通过。
+- 模型运行使用 `local_files_only` 和离线模式，无付费回退。运行时清除本进程继承的 HTTP/HTTPS/ALL proxy，避免本地代理成为外网旁路；随后限制外连。安装下载是独立过程，不全局修改用户代理。
+- 权重许可、代码许可、人像/声音的使用权分别核对。研究测试素材仅用于本地研究验证，不放进公开应用包或默认当商业主播素材。
+- 源人像与驱动视频需获得相应使用权，输出应标记为 AI 合成。官网截图若使用合成人像与虚拟摄像头，应写清素材来源和实测边界；不得暗示真实人物已授权或外部平台已开播。
+- 低端设备可以先合成片段、缓冲后播放；必须把该策略写入 UI 和文档。不能用静态图循环、音量驱动嘴型或测试桩冒充神经网络口型模型已经运行。
+
+## 本机配对与吾码会话
+
+- DiyToken 仍是吾码身份与权限入口。数据请求使用平台 SDK、当前租户和真实模块权限；不要把 DiyToken 发往本机模型或其它第三方。
+- 若旧节点的 MCP 模块更新白名单不支持 ModuleEngineKey，不能以接口成功代替字段回读。可通过已有平台授权菜单接口的窄字段投影解析当前租户真实菜单 Id，携带 `_SysMenuId` 调用 FormEngine；不能写死发行租户 Id、放宽表权限或绕过标准 MCP 写入。
+- 本机运行时只监听回环地址，另用随机配对码换取有期限、绑定 Origin 的本机会话。配对码、内部模型密钥和访问会话不出现在 URL、云端业务列或日志中。
+- 同源浏览器的 JSON 配对 POST 可以带 `Origin`，后续同源 GET 可能省略该头；网关校验缺失头时应以已验证的回环 Host 和 scheme 还原同源，显式跨域 `Origin` 仍须与配对来源完全一致。OBS 浏览器来源应回读 `peers>0` 和有画面、有音轨的实际录像，不能只看配对按钮被点击。
+- CORS 使用精确 Origin 列表，同时校验 Host；需要浏览器本地网络权限时明确给出诊断，不以通配 CORS 或绑定公网地址规避限制。
+- 前端不开放任意 Endpoint、文件路径、命令、RTMP shell 参数或 Python 代码。模型输出只是待播报文本，不能执行 V8、SQL 或操作业务数据。
+- 本机媒体任务可由当前租户 Managed 接口引擎先验证 DiyToken、菜单/表读取权限、模式与稳定 requestId；接口仅返回本机执行契约，媒体字节只送往已配对的回环服务。租户 Hook 用 CreateIfMissing 保留扩展点。不能把远端接口返回成功当作本机视频已生成。
+- 手机摄像头接入优先让手机 HTTPS 页面与电脑浏览器在同一局域网经 WebRTC 直传媒体，再由电脑浏览器访问回环服务；不要把回环地址绑定公网，也不要把摄像头字节送到 V8。MCP 接口引擎可以用同一登录用户、租户和真实菜单权限交换短期 SDP，房间码绑定用户且限时，单条 SDP 长度受限，相同 SDP 重试幂等、不同 SDP 拒绝接管。SDP 控制信息经过吾码服务器，应如实披露；无 TURN/STUN 版本只承诺局域网可达，不能承诺跨网或被客户端隔离的 Wi-Fi 可用。
+- 请求使用稳定 requestId；相同请求返回原任务，参数改变则拒绝。队列有界、停止可见、失败可诊断；状态与文件回读一致后才标为完成。
+
+## 源码交付
+
+- `.gitignore` 不等于 MCP 源码同步排除。必须在 `.microi-micro-app.json` 显式声明 `SourceExcludes`，排除虚拟环境、模型、凭据、人像、生成媒体、缓存和本机运行日志。
+- 运行时源码、固定依赖、模型 lock、安装/启动/停止脚本和测试进入私有源码；编译产物进入公有运行目录。应用包不得带发布者的配对码或设备配置。
+- 官网完整交付文档维护在独立菜单 `microi.doc/docs/doc/system-engine/digital-human-live.md`；`ai-engine.md` 的 `self-hosted-digital-human-live` 锚点保留入口链接。功能截图从真实页面组件采集并检查原始像素；使用隔离示例数据时必须在图内和文案中明确标注，不能把它称作线上租户数据或真实开播效果。
+- MCP 已有应用发现、Manifest、元数据、源码同步和 v3 发布能力时直接复用，不为重复流程新增工具。交付记录明确四项状态：应用包、官网源码、Skills、MCP 复用/变更。
+
+## 验收
+
+1. 用 MCP 计划、dry-run、写入、结构回读，并验证业务新增/读取/修改/删除及权限拒绝。
+2. 真模型生成中文音频，检测非静音、采样率与时长；真实口型模型生成帧，检查嘴部变化和图像输出。
+3. 音频与视频探针校验时长、帧率、画面尺寸；WebRTC 接收者实际收到音视频，并检查浏览器播放。
+4. 测试错误配对码、未授权请求、非白名单 Origin、请求重放冲突、队列上限、停止、模型缺失与外网拒绝。安全测试桩与真实模型验收分别记录。
+5. 桌面/窄屏/深色界面、空态、失败态、素材 CRUD、菜单生命周期与输出页实际操作通过。
+6. OBS 捕获和外部平台开播独立验收。OBS“媒体来源”循环播放已生成 MP4，只证明片段可被 OBS 录制；浏览器来源需要确认配对面板消失、服务端 WebRTC `peers` 大于 0，且 OBS 录制回读有真实音画，才能判为实时接入。未提供直播账号、推流地址或密钥时完成本机输出，明确外部直播未验证，不请求无关账号，不伪造“已开播”。
+7. 换脸/照片动作另外验收：实际输入照片和视频，核对生成视频帧数、时长、人物和服装区域变化；分别验证神经网络头像、实验性二维只换脸和实验性二维服饰动作的实际模型路径与质量。浏览器摄像头或虚拟摄像头需检查帧回传和所选模式确实传入本机运行时，不把 4K 页面截图或视频编码帧率说成 4K 实时推理。
+8. 手机链路先在两个独立浏览器会话检查信令与 WebRTC `inbound-rtp` 的解码帧，再检查电脑回环推理画布与停止释放；进一步用实体手机同网实测摄像头授权、屏幕锁定、断线重连、长时帧率和 OBS 捕获。浏览器模拟的窄屏截图不能替代实体手机验收。
+
+验收报告保留应用版本、模型 revision、真实设备、内存/显存峰值、生成帧率、等待时间和媒体摘要，不能只写“接口成功”。

package/skills/ai-platform-governance/SKILL.md

@@ -1,177 +1,177 @@
----
-name: ai-platform-governance
-description: Microi吾码 AI 平台治理中心设计、调用、扩展、应用商城升级与验收规范。用于门户与资源版本、身份目录/用户组/权限解释、配置模板与漂移、功能开关、发布审批/门禁/断点回滚、服务注册路由与韧性、Trace/告警/日志生命周期、资产物料、协作租约和可恢复导入。
----
-
-> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
-
-# Microi吾码 AI 平台治理中心
-
-<!-- microi-progressive:begin -->
-<!-- microi-progressive:chunk id=ai-platform-governance-000 sha256=48b82af9f11388d6872cf90aa2c74a1d35c1db948483f30615ce054989ef0d77 -->
-## 何时使用
-
-以下任一需求都应使用本 Skill：
-
-- 门户项目、插槽、资产、版本发布、Diff 或回滚；
-- 身份目录同步、动态用户组、标签、人群圈选、批量授权、访问申请、临时权限或权限解释；
-- 配置模板/继承/Secret 引用、配置漂移或功能开关；
-- 发布计划、多人审批、职责分离、自动门禁、断点续发或回滚；
-- 服务注册、实例心跳/排空、版本/区域/标签/权重路由、限流、熔断、重试、降级或服务拓扑；
-- W3C Trace、告警规则、值班升级、可靠通知或日志热温冷生命周期；
-- 可复用组件/区块资产、依赖解析、协作租约或跨资源变更集；
-- JSON/CSV/Excel 可恢复导入；
-- 发布或安装官方应用 `ai-platform-studio`。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=ai-platform-governance-001 sha256=47197af80919be7e08ef051884e70900714bdf53f551fad16e119a86d6efb63c -->
-## 不可破坏的边界
-
-- DiyToken 是唯一会话入口；继续复用现有用户、角色、部门、菜单、表权限和数据范围，禁止建立第二套 Token/RBAC。
-- 所有治理事实写入当前 `OsClient` 数据库或租户隔离 Redis；禁止把 `static`、单例字典、本机定时器或浏览器存储作为平台完成事实。
-- 普通业务编排优先接口引擎。C# 只提供目录协议/Secret 隔离、真实 FormEngine 权限解释、Trace/日志物理访问和 Redis 原子缓存等底层可信原子能力。
-- 核心资源由应用商城交付，不为表、字段、菜单、接口、任务或种子数据添加定制 `Microi.Upgrade` 迁移。
-- 所有危险动作必须是 Plan/DryRun → Hash/CAS → 幂等执行 → 回读 → 条件回滚。
-- 锁只解决并发，不代替稳定幂等键、唯一约束、状态机、outbox/inbox 或条件写入。
-- Secret 只保存引用；列表、Diff、错误、日志、截图、导出和运行台账不得出现密码、Token、私钥或连接串原文。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=ai-platform-governance-002 sha256=527f1cda978f88d0d1507d90aac71089f7585699f0ad7d5266dc7e40ba026b7c -->
-## 官方应用事实
-
-应用 Key：`ai-platform-studio`，当前资源合同版本：`v2.0.9`。
-
-- 40 张 `mci_` 治理表和 5 张运行基础表，应用包共 45 张表、873 个字段；
-- 42 条后台菜单兼容记录：仅 `AI平台治理` 作为可见 MicroService 入口；历史工作台和 40 个数据菜单保留原 Id、权限与升级身份，但统一隐藏；
-- 64 个接口引擎：57 个 `Managed`，7 个 `CreateIfMissing`；
-- 1 个 `MciAiPlatformMinuteSweep` 维护任务；
-- 10 个微服务路由：`overview`、`portal`、`identity`、`access`、`configuration`、`release`、`services`、`observability`、`assets`、`import`。
-- v2.0.9 保持表、接口、任务和菜单 Id 合同不变；10 个业务域页面及 40 类治理资源全部由工作台内部路由、操作面板和台账入口承载。隐藏的历史工作台菜单必须使用独立兼容 URL，不能与新的唯一入口争用 `sys_menu.Url`。发行版本、Manifest 版本与 `.microi-micro-app.json` 运行时版本必须同时提升并保持一致。内部切换只更新异步内容区并显示局部骨架屏，主题/reset/装饰样式限定在 `[data-mci-ui-root="ai-platform-studio"]`，不得重挂宿主 Tab 或污染吾码 Logo 与主菜单。
-
-租户 Hook：
-
-```text
-mci-portal-publish-extension
-mci-identity-source-extension
-mci-release-gate-extension
-mci-alert-notify-extension
-mci-asset-validate-extension
-mci-log-archive-extension
-mci-release-execute-extension
-```
-
-Hook 首次创建后归租户维护，升级永不覆盖，也不得把同 Key 改回 `Managed`。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=ai-platform-governance-003 sha256=3d43295846e19e8b5cb526442ff8aff8f0317db88f5be803b5798e63118546e2 -->
-## 菜单层级与语义
-
-应用安装或升级后只保留一个可见入口，禁止把历史工作台或 40 个数据菜单继续暴露到导航：
-
-```text
-系统引擎 (cdc0844b-7249-4d64-a9c3-563a15c9cd20)
-└─ AI平台治理 (MicroService: /micro-app/ai-platform-studio/overview)
-```
-
-`AI平台治理` 是 10 个治理页面的唯一可见操作入口，必须同时绑定 `MicroServiceId`、`MicroServicePageId`、`MicroServiceRoutePath=/overview` 和 `MicroServiceKey=ai-platform-studio`；不得只创建普通 URL 菜单。历史菜单记录必须保持稳定 Id 并设置 `Display=0`、`AppDisplay=0`，避免删除后破坏旧角色权限、收藏与升级定位。`system.manifest.json.menuCatalog` 是 40 类治理资源用途与工作台内部分组的事实源，它们按以下 9 个业务域组织：
-
-| 业务域 | 数据菜单 | 主要作用 |
-|---|---|---|
-| 门户装配 | 门户项目、门户插槽、门户资源、资源版本 | 组合门户并维护不可变发布版本 |
-| 身份目录 | 身份连接器、身份同步、身份冲突、组织快照 | 同步外部身份并处理冲突 |
-| 人群与授权 | 动态用户组、用户组成员、用户标签、标签分配、授权变更集、授权变更明细、访问申请、临时授权 | 按人群申请、授予、到期回收并保留证据 |
-| 配置与灰度 | 配置模板、配置漂移、功能开关 | 管理配置基线、环境偏差和灰度开关 |
-| 发布治理 | 发布计划、发布审批、发布运行、变更台账 | 计划、审批、门禁、执行、恢复和审计发布 |
-| 服务治理 | 服务目录、服务实例、流量策略、调用结果、服务拓扑 | 管理实例租约、路由韧性和调用事实 |
-| 可观测与日志 | 可观测策略、规则评估台账、告警事件、告警路由、告警送达、日志策略、日志生命周期 | 监控、告警、可靠通知和日志归档闭环 |
-| 资产与协作 | 资产包、资产版本、协作租约 | 交付可复用资产并避免并发覆盖 |
-| 数据迁移 | 导入批次、导入暂存行 | 预检、分片执行、恢复和回滚大批量导入 |
-
-向用户解释时必须区分页面类型：`配置` 是日常维护入口，`审批/处置` 在有待办或异常时使用，`运行` 用于观察和恢复任务，`台账` 主要供审计与排错。不得把台账页描述成需要人工逐项维护的业务模块。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=ai-platform-governance-004 sha256=f4fbda7d2522d95e4aaa6f010637b6dfe652a7871614177ce489df7830b9c911 -->
-## 通用调用规则
-
-1. 通过 MCP 回读当前表结构、菜单、接口、应用和微服务事实。
-2. 调用 `*-plan`、`*-publish` 的 `DryRun=true` 或专用预检接口。
-3. 保存返回的 `PlanHash/ContentHash/RowVersion`，展示影响和阻断项。
-4. 只有用户授权后执行写操作；服务端从 DiyToken 重算身份与租户。
-5. 写后回读主记录、不可变版本、运行台账和实际页面。
-6. 分开报告源码/测试、远端写入、浏览器、应用商城和生产部署证据。
-
-旧 Hash、旧 RowVersion、旧 fencing token、未知状态、未知步骤或未知字段一律失败关闭。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=ai-platform-governance-005 sha256=6298a32cb0b0c2f226485697bba306936265dab62248bb48a1709e36f73241e9 -->
-## 门户与资源版本
-
-调用顺序：
-
-```text
-mci-portal-publish-plan
-  → mci-portal-publish(ExpectedSnapshotHash)
-  → mci-portal-resolve
-```
-
-- `ProjectKey/SlotKey/AssetKey` 稳定且项目内唯一。
-- 发布先写 `mci_resource_version`，再 CAS 切换活动版本指针。
-- 相同 Hash 幂等复用；旧 Hash 冲突后必须重新计划。
-- `mci-resource-compare` 做语义比较。
-- `mci-resource-rollback` 校验 `ExpectedCurrentHash` 并创建新回滚版本，不能删除历史。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=ai-platform-governance-006 sha256=ec5c949ac0615c9917ce1910a397f5ab1e7878fb56a35cb761cd5ebbdf96c714 -->
-## 身份与访问治理
-
-### 身份同步
-
-```text
-mci-identity-sync-plan → 人工处置冲突 → mci-identity-sync-apply
-```
-
-- 可信 SCIM 适配器为 `V8.Method.ReadIdentityDirectoryPage`；只允许 HTTPS、受控 DNS、非私网目标、有界页数和 Secret 引用。
-- 新账号默认停用。邮箱、手机号或账号多重命中时进入 `mci_identity_sync_conflict`，禁止猜测合并。
-- 增量游标、计划 Hash 和 IdempotencyKey 必须一致。
-- 非 SCIM 目录通过 `mci-identity-source-extension` 接入；Hook 也不能返回 Secret 原文。
-
-### 用户组、标签和授权
-
-- `mci-identity-group-preview`：静态成员或标签集合预览；空规则失败关闭。
-- `mci-identity-group-refresh`：写入带 SnapshotId 的共享成员快照。
-- `mci-identity-tag-assign`：分配/撤销标签，记录有效期和 `EvidenceHash`。
-- `mci-access-change-plan/apply/rollback`：批量授权计划、逐项执行和条件回滚。
-- `mci-access-request`：`Submit/Approve/Reject/Cancel/Revoke` 与临时授权。
-- `mci-access-entitlement-expire`：维护任务回收过期授权。
-- `mci-org-snapshot`：不可变组织树快照与结构差异。
-
-`mci-permission-explain` 必须调用 `V8.Method.ExplainAuthorizationDecision` 复用真实 FormEngine 授权逻辑；禁止从菜单/角色表重新拼近似结论。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=ai-platform-governance-007 sha256=64f2699d58860ed29782136673b51bdb1488b87cd17b24b761e9d22479902ae5 -->
-## 配置模板与漂移
-
-`mci-configuration-publish` 输入要点：
-
-```js
-{
-  ProfileKey, Name, Category, Environment, ParentProfileId, VersionNo,
-  Schema, Values, SecretReferences, Owner, Enabled,
-  ExpectedContentHash, ChangeSummary, DryRun
-}
-```
-
-- `Values` 只能放非敏感值；敏感路径映射到 `SecretReferences`。
-- 继承最多 10 层，检测循环。
-- 稳定规范化、SHA-256、DryRun、CAS 和 `ConfigurationProfile` 不可变版本必须同时存在。
-- `mci-configuration-resolve` 返回 `EffectiveHash`，并保持 `SecretValuesResolved=false`。
-- `mci-configuration-drift-scan` 生成有界语义差异。
-- `mci-configuration-drift-transition` 使用 `ExpectedRowVersion` 完成 Ignore/Reopen/Resolve；摘要仍不一致时不能 Resolve。
-
-<!-- /microi-progressive:chunk -->
-## 详细参考路由（渐进披露）
-
-仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。
-
-- [references/progressive-01-功能开关.md](references/progressive-01-功能开关.md)：功能开关；发布状态机；服务治理；Trace、告警与日志；资产、协作和变更集；可恢复导入；页面与蓝图版本；应用商城发布；双节点与浏览器验收
-<!-- microi-progressive:end -->
+---
+name: ai-platform-governance
+description: Microi吾码 AI 平台治理中心设计、调用、扩展、应用商城升级与验收规范。用于门户与资源版本、身份目录/用户组/权限解释、配置模板与漂移、功能开关、发布审批/门禁/断点回滚、服务注册路由与韧性、Trace/告警/日志生命周期、资产物料、协作租约和可恢复导入。
+---
+
+> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
+
+# Microi吾码 AI 平台治理中心
+
+<!-- microi-progressive:begin -->
+<!-- microi-progressive:chunk id=ai-platform-governance-000 sha256=48b82af9f11388d6872cf90aa2c74a1d35c1db948483f30615ce054989ef0d77 -->
+## 何时使用
+
+以下任一需求都应使用本 Skill：
+
+- 门户项目、插槽、资产、版本发布、Diff 或回滚；
+- 身份目录同步、动态用户组、标签、人群圈选、批量授权、访问申请、临时权限或权限解释；
+- 配置模板/继承/Secret 引用、配置漂移或功能开关；
+- 发布计划、多人审批、职责分离、自动门禁、断点续发或回滚；
+- 服务注册、实例心跳/排空、版本/区域/标签/权重路由、限流、熔断、重试、降级或服务拓扑；
+- W3C Trace、告警规则、值班升级、可靠通知或日志热温冷生命周期；
+- 可复用组件/区块资产、依赖解析、协作租约或跨资源变更集；
+- JSON/CSV/Excel 可恢复导入；
+- 发布或安装官方应用 `ai-platform-studio`。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=ai-platform-governance-001 sha256=47197af80919be7e08ef051884e70900714bdf53f551fad16e119a86d6efb63c -->
+## 不可破坏的边界
+
+- DiyToken 是唯一会话入口；继续复用现有用户、角色、部门、菜单、表权限和数据范围，禁止建立第二套 Token/RBAC。
+- 所有治理事实写入当前 `OsClient` 数据库或租户隔离 Redis；禁止把 `static`、单例字典、本机定时器或浏览器存储作为平台完成事实。
+- 普通业务编排优先接口引擎。C# 只提供目录协议/Secret 隔离、真实 FormEngine 权限解释、Trace/日志物理访问和 Redis 原子缓存等底层可信原子能力。
+- 核心资源由应用商城交付，不为表、字段、菜单、接口、任务或种子数据添加定制 `Microi.Upgrade` 迁移。
+- 所有危险动作必须是 Plan/DryRun → Hash/CAS → 幂等执行 → 回读 → 条件回滚。
+- 锁只解决并发，不代替稳定幂等键、唯一约束、状态机、outbox/inbox 或条件写入。
+- Secret 只保存引用；列表、Diff、错误、日志、截图、导出和运行台账不得出现密码、Token、私钥或连接串原文。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=ai-platform-governance-002 sha256=527f1cda978f88d0d1507d90aac71089f7585699f0ad7d5266dc7e40ba026b7c -->
+## 官方应用事实
+
+应用 Key：`ai-platform-studio`，当前资源合同版本：`v2.0.9`。
+
+- 40 张 `mci_` 治理表和 5 张运行基础表，应用包共 45 张表、873 个字段；
+- 42 条后台菜单兼容记录：仅 `AI平台治理` 作为可见 MicroService 入口；历史工作台和 40 个数据菜单保留原 Id、权限与升级身份，但统一隐藏；
+- 64 个接口引擎：57 个 `Managed`，7 个 `CreateIfMissing`；
+- 1 个 `MciAiPlatformMinuteSweep` 维护任务；
+- 10 个微服务路由：`overview`、`portal`、`identity`、`access`、`configuration`、`release`、`services`、`observability`、`assets`、`import`。
+- v2.0.9 保持表、接口、任务和菜单 Id 合同不变；10 个业务域页面及 40 类治理资源全部由工作台内部路由、操作面板和台账入口承载。隐藏的历史工作台菜单必须使用独立兼容 URL，不能与新的唯一入口争用 `sys_menu.Url`。发行版本、Manifest 版本与 `.microi-micro-app.json` 运行时版本必须同时提升并保持一致。内部切换只更新异步内容区并显示局部骨架屏，主题/reset/装饰样式限定在 `[data-mci-ui-root="ai-platform-studio"]`，不得重挂宿主 Tab 或污染吾码 Logo 与主菜单。
+
+租户 Hook：
+
+```text
+mci-portal-publish-extension
+mci-identity-source-extension
+mci-release-gate-extension
+mci-alert-notify-extension
+mci-asset-validate-extension
+mci-log-archive-extension
+mci-release-execute-extension
+```
+
+Hook 首次创建后归租户维护，升级永不覆盖，也不得把同 Key 改回 `Managed`。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=ai-platform-governance-003 sha256=3d43295846e19e8b5cb526442ff8aff8f0317db88f5be803b5798e63118546e2 -->
+## 菜单层级与语义
+
+应用安装或升级后只保留一个可见入口，禁止把历史工作台或 40 个数据菜单继续暴露到导航：
+
+```text
+系统引擎 (cdc0844b-7249-4d64-a9c3-563a15c9cd20)
+└─ AI平台治理 (MicroService: /micro-app/ai-platform-studio/overview)
+```
+
+`AI平台治理` 是 10 个治理页面的唯一可见操作入口，必须同时绑定 `MicroServiceId`、`MicroServicePageId`、`MicroServiceRoutePath=/overview` 和 `MicroServiceKey=ai-platform-studio`；不得只创建普通 URL 菜单。历史菜单记录必须保持稳定 Id 并设置 `Display=0`、`AppDisplay=0`，避免删除后破坏旧角色权限、收藏与升级定位。`system.manifest.json.menuCatalog` 是 40 类治理资源用途与工作台内部分组的事实源，它们按以下 9 个业务域组织：
+
+| 业务域 | 数据菜单 | 主要作用 |
+|---|---|---|
+| 门户装配 | 门户项目、门户插槽、门户资源、资源版本 | 组合门户并维护不可变发布版本 |
+| 身份目录 | 身份连接器、身份同步、身份冲突、组织快照 | 同步外部身份并处理冲突 |
+| 人群与授权 | 动态用户组、用户组成员、用户标签、标签分配、授权变更集、授权变更明细、访问申请、临时授权 | 按人群申请、授予、到期回收并保留证据 |
+| 配置与灰度 | 配置模板、配置漂移、功能开关 | 管理配置基线、环境偏差和灰度开关 |
+| 发布治理 | 发布计划、发布审批、发布运行、变更台账 | 计划、审批、门禁、执行、恢复和审计发布 |
+| 服务治理 | 服务目录、服务实例、流量策略、调用结果、服务拓扑 | 管理实例租约、路由韧性和调用事实 |
+| 可观测与日志 | 可观测策略、规则评估台账、告警事件、告警路由、告警送达、日志策略、日志生命周期 | 监控、告警、可靠通知和日志归档闭环 |
+| 资产与协作 | 资产包、资产版本、协作租约 | 交付可复用资产并避免并发覆盖 |
+| 数据迁移 | 导入批次、导入暂存行 | 预检、分片执行、恢复和回滚大批量导入 |
+
+向用户解释时必须区分页面类型：`配置` 是日常维护入口，`审批/处置` 在有待办或异常时使用，`运行` 用于观察和恢复任务，`台账` 主要供审计与排错。不得把台账页描述成需要人工逐项维护的业务模块。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=ai-platform-governance-004 sha256=f4fbda7d2522d95e4aaa6f010637b6dfe652a7871614177ce489df7830b9c911 -->
+## 通用调用规则
+
+1. 通过 MCP 回读当前表结构、菜单、接口、应用和微服务事实。
+2. 调用 `*-plan`、`*-publish` 的 `DryRun=true` 或专用预检接口。
+3. 保存返回的 `PlanHash/ContentHash/RowVersion`，展示影响和阻断项。
+4. 只有用户授权后执行写操作；服务端从 DiyToken 重算身份与租户。
+5. 写后回读主记录、不可变版本、运行台账和实际页面。
+6. 分开报告源码/测试、远端写入、浏览器、应用商城和生产部署证据。
+
+旧 Hash、旧 RowVersion、旧 fencing token、未知状态、未知步骤或未知字段一律失败关闭。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=ai-platform-governance-005 sha256=6298a32cb0b0c2f226485697bba306936265dab62248bb48a1709e36f73241e9 -->
+## 门户与资源版本
+
+调用顺序：
+
+```text
+mci-portal-publish-plan
+  → mci-portal-publish(ExpectedSnapshotHash)
+  → mci-portal-resolve
+```
+
+- `ProjectKey/SlotKey/AssetKey` 稳定且项目内唯一。
+- 发布先写 `mci_resource_version`，再 CAS 切换活动版本指针。
+- 相同 Hash 幂等复用；旧 Hash 冲突后必须重新计划。
+- `mci-resource-compare` 做语义比较。
+- `mci-resource-rollback` 校验 `ExpectedCurrentHash` 并创建新回滚版本，不能删除历史。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=ai-platform-governance-006 sha256=ec5c949ac0615c9917ce1910a397f5ab1e7878fb56a35cb761cd5ebbdf96c714 -->
+## 身份与访问治理
+
+### 身份同步
+
+```text
+mci-identity-sync-plan → 人工处置冲突 → mci-identity-sync-apply
+```
+
+- 可信 SCIM 适配器为 `V8.Method.ReadIdentityDirectoryPage`；只允许 HTTPS、受控 DNS、非私网目标、有界页数和 Secret 引用。
+- 新账号默认停用。邮箱、手机号或账号多重命中时进入 `mci_identity_sync_conflict`，禁止猜测合并。
+- 增量游标、计划 Hash 和 IdempotencyKey 必须一致。
+- 非 SCIM 目录通过 `mci-identity-source-extension` 接入；Hook 也不能返回 Secret 原文。
+
+### 用户组、标签和授权
+
+- `mci-identity-group-preview`：静态成员或标签集合预览；空规则失败关闭。
+- `mci-identity-group-refresh`：写入带 SnapshotId 的共享成员快照。
+- `mci-identity-tag-assign`：分配/撤销标签，记录有效期和 `EvidenceHash`。
+- `mci-access-change-plan/apply/rollback`：批量授权计划、逐项执行和条件回滚。
+- `mci-access-request`：`Submit/Approve/Reject/Cancel/Revoke` 与临时授权。
+- `mci-access-entitlement-expire`：维护任务回收过期授权。
+- `mci-org-snapshot`：不可变组织树快照与结构差异。
+
+`mci-permission-explain` 必须调用 `V8.Method.ExplainAuthorizationDecision` 复用真实 FormEngine 授权逻辑；禁止从菜单/角色表重新拼近似结论。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=ai-platform-governance-007 sha256=64f2699d58860ed29782136673b51bdb1488b87cd17b24b761e9d22479902ae5 -->
+## 配置模板与漂移
+
+`mci-configuration-publish` 输入要点：
+
+```js
+{
+  ProfileKey, Name, Category, Environment, ParentProfileId, VersionNo,
+  Schema, Values, SecretReferences, Owner, Enabled,
+  ExpectedContentHash, ChangeSummary, DryRun
+}
+```
+
+- `Values` 只能放非敏感值；敏感路径映射到 `SecretReferences`。
+- 继承最多 10 层，检测循环。
+- 稳定规范化、SHA-256、DryRun、CAS 和 `ConfigurationProfile` 不可变版本必须同时存在。
+- `mci-configuration-resolve` 返回 `EffectiveHash`，并保持 `SecretValuesResolved=false`。
+- `mci-configuration-drift-scan` 生成有界语义差异。
+- `mci-configuration-drift-transition` 使用 `ExpectedRowVersion` 完成 Ignore/Reopen/Resolve；摘要仍不一致时不能 Resolve。
+
+<!-- /microi-progressive:chunk -->
+## 详细参考路由（渐进披露）
+
+仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。
+
+- [references/progressive-01-功能开关.md](references/progressive-01-功能开关.md)：功能开关；发布状态机；服务治理；Trace、告警与日志；资产、协作和变更集；可恢复导入；页面与蓝图版本；应用商城发布；双节点与浏览器验收
+<!-- microi-progressive:end -->