@microi.net/cli 5.8.5 → 5.8.6

package/skills/ai-engine/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "AI 引擎"
-  short_description: "配置模型、知识库、提示词、密钥边界、内容安全、配额与应用验收"
-  default_prompt: "使用 $ai-engine 设计并验收当前 Microi AI 能力。"
+interface:
+  display_name: "AI 引擎"
+  short_description: "配置模型、知识库、提示词、密钥边界、内容安全、配额与应用验收"
+  default_prompt: "使用 $ai-engine 设计并验收当前 Microi AI 能力。"

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、真实设备、内存/显存峰值、生成帧率、等待时间和媒体摘要，不能只写“接口成功”。