@microi.net/cli 6.0.9 → 6.1.0

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/references/progressive-01-/345/212/237/350/203/275/345/274/200/345/205/263.md

@@ -161,10 +161,10 @@ microi_rollback_page_design
 蓝图提供对应的历史、读取、比较、导出和回滚工具。修改前读取 CurrentHash，保存传 ExpectedHash，写后回读新 Hash 与不可变历史。回滚创建新版本，不删除旧历史。
 
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=ai-platform-governance-015 sha256=6fafd84efd63a1607c4c98c4a173d755b2ba22fb7a251a21ed4d4699556656a7 -->
+<!-- microi-progressive:chunk id=ai-platform-governance-015 sha256=a5f52c0d6b583b07586cbbc1dbb3657aba4670389a9d878313fd6653ea19f2e8 -->
 ## 应用商城发布
 
-- 官方发布使用绑定 `https://api.itdos.com`、`OsClient=iTdos` 的 `microi_itdos`。
+- 官方发布使用绑定 `https://api.microi.net`、`OsClient=iTdos` 的 `microi_itdos`。
 - 先构建 Manifest、22 项应用契约、微服务类型检查/契约/生产构建。
 - 发布请求版本、资产准备版本和包内 `PackageInfo.Version` 必须精确相同；42 个菜单、40 张治理表和 64 个接口引擎的选择必须来自当前包正文。
 - 包内 `ResourcePolicies.ApiEngines` 必须精确为 57 个 Managed + 7 个 CreateIfMissing。

package/skills/app-store/SKILL.md

@@ -24,7 +24,7 @@ description: Microi 应用商城开发、打包、安装和升级规范。用于
 - 启动投影只压缩已确认无关的控件配置，保留物理兼容列、值转换、安全属性、共享／未知配置和原有租户值。SaaS 物理配置由可信运行时直接读取，完整编辑字段由 SaaS 应用交付；缩小投影不得生成字段退役、DROP 或卸载操作。容量预算与生成一致性测试应阻止后续可选功能默默进入启动包。
 
 - 表、字段、Tab、菜单、权限、接口引擎、事件、数据源、页面、打印、工作流、任务和可幂等种子数据都应通过应用包升级；不得为这些资源在 `Microi.Server/Microi.Upgrade/` 新增租户定制 .NET 代码。
-- 有官方 MCP 权限时，固定使用 `microi_itdos`（`https://api.itdos.com`、`OsClient=iTdos`）更新官方母版、制作并发布对应应用，按内容哈希/包版本回读后，再由目标租户 MCP 安装或更新。无官方权限时只通过当前用户自己的 MCP/Manifest 更新其数据库并回读，不得假借通用升级器越权发布官方应用。
+- 有官方 MCP 权限时，固定使用 `microi_itdos`（`https://api.microi.net`、`OsClient=iTdos`）更新官方母版、制作并发布对应应用，按内容哈希/包版本回读后，再由目标租户 MCP 安装或更新。无官方权限时只通过当前用户自己的 MCP/Manifest 更新其数据库并回读，不得假借通用升级器越权发布官方应用。
 - `Microi.Upgrade` 只保留应用商城/安装器启动前必需的核心物理兼容或协议迁移，并要求持久化版本门、共享租约、幂等、失败不推进版本。禁止每次启动对每个租户重跑不断增长的历史迁移清单。
 - 新增升级点前必须完成“商城不可表达性”证明：逐项说明为什么 `DiyTables/DiyFields/DDLStatements/PhysicalColumns/DataSets`、菜单、接口引擎、工作流或 AI 应用包无法交付，以及为什么该结构在登录/商城恢复入口可用前就必须存在。不能证明时一律升级对应官方应用包；客户租户缺少某张业务表不得写成全平台 `.NET` 启动迁移。
 - 历史升级点不能因为今天可由商城表达就直接删除：若后续步骤依赖其物理结果，须保留为冻结兼容链，或把必要前置检查显式并入后续步骤。新增步骤必须使用高于当前目标的唯一四段版本并追加到链末尾，不得抬高旧步骤版本造成非单调执行顺序。
@@ -39,7 +39,7 @@ description: Microi 应用商城开发、打包、安装和升级规范。用于
 - 每项平台功能先执行 [工作区基础规范](../workspace-conventions/SKILL.md) 的“平台功能四项同步检查”，不能把商城包发布当成官方文档、Skills、MCP 同步的替代。本节细化其中需要发布应用包时的流程；没有可打包资源变化时记录依据，不为凑检查项空升版。
 - 每次任务先检查工作区根的 `Microi.Server/Microi.net/`。只有目录存在且 `rg --files Microi.Server/Microi.net` 能找到至少一个真实源码文件时，才确认当前是吾码创建人在官方完整源码工作区开发；空目录不算，且不要求本次修改位于该目录。确认后，对任意目录中的平台基础能力执行修改、构建或交付时，官方应用数据包都不是“以后再补”的附加产物，而是本次实现的组成部分。目录缺失或为空时按普通用户工作区处理；纯审查、解释或诊断仍保持只读。
 - 触发资源包括系统设置、表、字段、Tab、菜单、权限、接口引擎、事件、数据源、页面、打印、工作流、任务、平台内置微服务和可幂等种子数据。开始修改时就确定资源归属：租户开通、启动投影与基础空库归 `app.microi.saas-engine`；用户偏好、个人资料及其租户 Hook 归 `app.microi.sys_user`；租户系统设置编排及其 Hook 归 `app.microi.sys-config`；表单引擎归 `app.microi.form-engine`；模块引擎归 `app.microi.module-engine`；应用商城归 `app.microi.store`。同一能力跨多个包时逐包更新，但同一 Managed ApiEngineKey 仍须单一归属。
-- 强制闭环依次包含：①源码和定向测试；②通过绑定 `https://api.itdos.com + OsClient=iTdos` 的 `microi_itdos` 更新并回读官方母版资源；③从母版导出或按受审计发布契约生成本地应用包，单调提升包版本并核对资源数量、版本和 SHA-256；④发布对应官方 Platform 应用；⑤重新读取商城行的小型 HDFS 指针，用公有下载或受权私有下载取得原始 JSON，核对 `Published/IsApprove`、`AppVersion`、`PackageInfo.Version`、UTF-8 字节数、SHA-256 和资源正文；⑥立即做一次同输入幂等重跑，确认无重复升版或漂移。任务还指定目标租户时，再安装/更新并等待后台任务 `Succeeded` 后回读真实资源。
+- 强制闭环依次包含：①源码和定向测试；②通过绑定 `https://api.microi.net + OsClient=iTdos` 的 `microi_itdos` 更新并回读官方母版资源；③从母版导出或按受审计发布契约生成本地应用包，单调提升包版本并核对资源数量、版本和 SHA-256；④发布对应官方 Platform 应用；⑤重新读取商城行的小型 HDFS 指针，用公有下载或受权私有下载取得原始 JSON，核对 `Published/IsApprove`、`AppVersion`、`PackageInfo.Version`、UTF-8 字节数、SHA-256 和资源正文；⑥立即做一次同输入幂等重跑，确认无重复升版或漂移。任务还指定目标租户时，再安装/更新并等待后台任务 `Succeeded` 后回读真实资源。
 - 本地包文件、生成器成功、单元测试通过、返回 TaskId 或 HTTP 200 都不能代替官方主数据库与商城回读。`.resource-sync-base` 只能在官网发布后逐项哈希一致时由同步器推进，不得与本地候选一起手工修改。若官方身份、MCP 登录或发布门禁失效，必须保留准确的未发布边界并修复链路；不得把本地 JSON 宣称为“其它吾码用户已经可以安装”。
 - 应用包不得携带真实地图 Key、Token、连接串或其它租户秘密。浏览器供应商 Key 等配置只交付字段/设置模板和安全读取能力，实际值由每个目标租户在安装后自行填写。
 
@@ -392,7 +392,7 @@ staged 行、请求参数、`StableFilePathName` 或外部 CDN URL 推断版本
 - 官网当前资源只是三方合并的一侧，允许暂时落后于本地发布候选。下载阶段只校验固定白名单、稳定资源身份、JSON 可解析性及服务端返回 SHA-256；不能用“必须已包含本地最新功能标记”的规则提前拒绝旧官网，否则会形成“官网不够新所以永远无法发布新版”的循环依赖。
 - 本地输入和三方合并后的最终候选必须继续执行最低版本、功能标记、内嵌逻辑副本一致性等严格校验；发布成功并按内容哈希回读一致后才能推进 `.resource-sync-base`，不能把放宽读取门误做成放宽发布门。
 - 应用包版本与平台发布版本分别单调递增。包正文需要写回而本地包版本、平台版本均未高于官网时，应基于官网包版本自动递增补丁号；内容无变化时不得递增，必须用连续两次同步验证第二次为零变更。
-- MCP 配置中的官方 API、`OsClient` 与 Token 文件是鉴权事实源，但编辑器可执行文件、插件版本目录和 `cwd` 都是易漂移的启动信息。发布器应保留鉴权配置、固定校验 `https://api.itdos.com + itdos`，并支持插件生成的稳定 `microi-cli-mcp.js` 或标准 `mcp-server.js` 入口；旧扩展配置再从同级最新已安装插件或当前工作区发现可信入口，统一使用正在运行发布脚本的 Node 启动。插件升级、Codex 插件化或旧目录清理不能再次阻塞后端发布。
+- MCP 配置中的官方 API、`OsClient` 与 Token 文件是鉴权事实源，但编辑器可执行文件、插件版本目录和 `cwd` 都是易漂移的启动信息。发布器应保留鉴权配置、固定校验 `https://api.microi.net + itdos`，并支持插件生成的稳定 `microi-cli-mcp.js` 或标准 `mcp-server.js` 入口；旧扩展配置再从同级最新已安装插件或当前工作区发现可信入口，统一使用正在运行发布脚本的 Node 启动。插件升级、Codex 插件化或旧目录清理不能再次阻塞后端发布。
 - Token 文件的新键固定为 `ApiBase|OsClient|OsClientType|OsClientNetwork` 四段身份；Type/Network 为空时仍保留空段。读取和回写必须先用四段精确键，再兼容旧版紧凑键；旧键在多环境配置下可能被有意保留且已经失效，禁止优先读取。自动化测试要覆盖“精确键已刷新、旧键仍过期”以及 type-only/network-only 不碰撞。
 - VS Code 的 SecretStorage 恢复 broker 必须使用确定性激活事件启动；不得只依赖大型工作区可能超时的递归 `workspaceContains`。签名密钥变化时旧 Token 本身不能以旧换新，必须由已激活 broker 使用本机 SecretStorage 静默重登并回写精确身份键。
 - 本地资源同步的官网读取、发布和发布后回读应使用同一个已校验的 `microi_itdos` MCP 链路；CI 无 MCP 时才允许凭显式 Token 使用 HTTP。V8 独立文件与应用包内嵌副本合并时，先把文件头说明和 `Version` 与可执行正文分离：两端独立升版不能算代码冲突，不同正文安全合成后应基于两端最高版本再升一版；只有同一段可执行逻辑出现不同实现才失败关闭。