@microi.net/cli 5.3.7 → 5.3.9

package/skills/.progressive-disclosure-manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-08-24T23:28:15.830Z",
+  "generatedAt": "2026-08-26T19:09:39.599Z",
   "policy": {
     "maxEntryLines": 285,
     "referenceBudgetLines": 245,
@@ -407,11 +407,11 @@
       ]
     },
     "microi-frontend-sdk": {
-      "originalSha256": "7d244b24626787ccc88be38f5088ffcd6dbb736a8155a1ab7ae71ce134284644",
-      "originalLines": 317,
+      "originalSha256": "27802e252aa4c9d85e4e10c70baa9d05c7207dcf943c5305c24a586b17e0fac7",
+      "originalLines": 318,
       "prefixSha256": "5ee94a9174a22577011c64f29a93f6983c8450d471d26f12fa884d7c4b3a879a",
       "prefixBytes": 895,
-      "entryLines": 190,
+      "entryLines": 191,
       "chunks": [
         {
           "id": "microi-frontend-sdk-000",
@@ -433,7 +433,7 @@
           "id": "microi-frontend-sdk-002",
           "ordinal": 2,
           "destination": "microi-frontend-sdk/SKILL.md",
-          "sha256": "54b302bfe2a8830a3043ae7804ca775d6159453bea0cfdeac61c3b97d36466ed",
+          "sha256": "b71205548e4701f8bf53e2bed3da914da4ca0f49e0cce952a1c938fc77218ed8",
           "lines": 48,
           "heading": "登录与验证码封装"
         },
@@ -449,8 +449,8 @@
           "id": "microi-frontend-sdk-004",
           "ordinal": 5,
           "destination": "microi-frontend-sdk/SKILL.md",
-          "sha256": "f5644fc45280e53988d1eed432e57afc2c56fc58b1232505950359219b5220d2",
-          "lines": 17,
+          "sha256": "1ecb73f5b1246c7157d782b62cba59850389858baeefdc5351a255d4d04b11b6",
+          "lines": 18,
           "heading": "上传规则"
         },
         {
@@ -942,11 +942,11 @@
       ]
     },
     "microi-uniapp-frontend": {
-      "originalSha256": "3727756264593f239e06109dbd5d11c1f53eb576484e445f4d664303b38260c8",
-      "originalLines": 499,
-      "prefixSha256": "6b843b9a940cd2a4019b3873d72a9d346b0e6ab872afb0966f093b76dcc27131",
-      "prefixBytes": 2486,
-      "entryLines": 190,
+      "originalSha256": "a9e7ebb927e8be11a7d4d273f83b3a6f200835c2361daa944ec200d0580c3e2b",
+      "originalLines": 501,
+      "prefixSha256": "05053116f81ef9286c72590cd6c5670e3b38c594bf76fc5d41a32675f391d9a5",
+      "prefixBytes": 2988,
+      "entryLines": 192,
       "chunks": [
         {
           "id": "microi-uniapp-frontend-000",
@@ -976,7 +976,7 @@
           "id": "microi-uniapp-frontend-003",
           "ordinal": 3,
           "destination": "microi-uniapp-frontend/SKILL.md",
-          "sha256": "6ecff0f73715fd0b1e39ca8d3107582928db9cf2a20e54a2ae285983e97411fe",
+          "sha256": "5cedd05cb29746019a92db56a21123718fde23d5d9df4b8064dfc260bc89ee05",
           "lines": 17,
           "heading": "登录页与手机号快捷登录"
         },
@@ -2221,11 +2221,11 @@
       ]
     },
     "v8-file-upload": {
-      "originalSha256": "c6a1d4ed64cc2abbd9c3bc42c4d9473535564b45277f4a563e1452006325eaeb",
-      "originalLines": 557,
-      "prefixSha256": "dd9e661499692931e0da053fdb6060a3ff2827eb5862d1a820f05159038ead5d",
-      "prefixBytes": 7475,
-      "entryLines": 219,
+      "originalSha256": "69f7195bfeb618f0020da92535f47c8eb183d431cf16492a12f6f61dbcc7a851",
+      "originalLines": 571,
+      "prefixSha256": "796e8308ae21c36dde1b9268ae71ccb8c2afe9f393d7f9865b6648d2f7f0f22e",
+      "prefixBytes": 8923,
+      "entryLines": 226,
       "chunks": [
         {
           "id": "v8-file-upload-000",
@@ -2247,7 +2247,7 @@
           "id": "v8-file-upload-002",
           "ordinal": 2,
           "destination": "v8-file-upload/SKILL.md",
-          "sha256": "c20863b68d13b3bd41caee90a5e12878501a35b3d9f8d40a80efe3f6b46125a9",
+          "sha256": "ed7e727c51bd2416ae1f38cf3c4bd09491e616df08473a610372e0ca648e1298",
           "lines": 101,
           "heading": "接收前端上传的文件"
         },
@@ -2271,8 +2271,8 @@
           "id": "v8-file-upload-005",
           "ordinal": 3,
           "destination": "v8-file-upload/references/progressive-01-公有桶-vs-私有桶.md",
-          "sha256": "6136a38af209aad174ca1cacd61fcfc66e3428e1e8bf75be8a2490bcb094b71e",
-          "lines": 143,
+          "sha256": "b09a96f25aef20eb8cbb204bd785cce370dcd2c9a28563c6f6d720fbdaa5218f",
+          "lines": 150,
           "heading": "公有桶 vs 私有桶"
         },
         {
@@ -2295,7 +2295,7 @@
           "id": "v8-file-upload-008",
           "ordinal": 8,
           "destination": "v8-file-upload/references/progressive-02-office-文件在线编辑版本号规则.md",
-          "sha256": "73506d076e7917db846f615cd9c0d899bb8b58a3917f375bce9eff6ea903e8a0",
+          "sha256": "5e3b59486745d3c54bd8ad25c43cbe2396e6d614394340b93d93794b6df56292",
           "lines": 36,
           "heading": "Office 文件在线编辑版本号规则"
         },
@@ -2786,11 +2786,11 @@
       ]
     },
     "v8-security": {
-      "originalSha256": "47f1d4392b637af2b25a658e475bdcf8ee888b6e51098b888e477ce1aa1c9985",
-      "originalLines": 497,
+      "originalSha256": "f3624718dfa642f4c3ab5d48a33022014aa467af1be756fdbc78c4bae2231d1c",
+      "originalLines": 503,
       "prefixSha256": "c3b2ae10a39461ee69fda3c7e994d072ca6d8c9dc6f2338742bc8f07e0dcffd0",
       "prefixBytes": 1648,
-      "entryLines": 184,
+      "entryLines": 190,
       "chunks": [
         {
           "id": "v8-security-000",
@@ -2804,8 +2804,8 @@
           "id": "v8-security-001",
           "ordinal": 1,
           "destination": "v8-security/SKILL.md",
-          "sha256": "9e477268919238bb6a2525116de3c8386aa439d8e93c5d66f3893cb07740b374",
-          "lines": 13,
+          "sha256": "aad35b2c3e1876d98ead7e604307bcb7d39fe8c480d72f102ae956972580a35b",
+          "lines": 19,
           "heading": "0.5 接口引擎配置安全"
         },
         {
@@ -2860,7 +2860,7 @@
           "id": "v8-security-008",
           "ordinal": 8,
           "destination": "v8-security/references/progressive-02-7-日志记录.md",
-          "sha256": "dfd8dabfc7d1ecdd99283c0dd5e1d5499d76f8337eff0d9cd9b0cfcac0a9dddc",
+          "sha256": "6e0b7de3cd72cc030c93566c03ddf2191af6163d378e5ec8a40828eee9873477",
           "lines": 40,
           "heading": "7. 日志记录"
         },
@@ -2868,7 +2868,7 @@
           "id": "v8-security-009",
           "ordinal": 9,
           "destination": "v8-security/references/progressive-02-7-日志记录.md",
-          "sha256": "c3618f2fae953f2951195d0669f51963f5dfbc96f43b4262e4234f556935e1f7",
+          "sha256": "b7a65ce2785a6a3d02dc1bc08c16c5ae03e38aa199d4bc204abe5978057f1ea1",
           "lines": 20,
           "heading": "8. 错误处理"
         },
@@ -2876,7 +2876,7 @@
           "id": "v8-security-010",
           "ordinal": 10,
           "destination": "v8-security/references/progressive-02-7-日志记录.md",
-          "sha256": "9d8e9186a7fa3a6c85e2df8cf0d6776ca05c3eff1c97dd36424722b5880c2812",
+          "sha256": "4b68e2730cc6ac2ba8eeb4458c71e9ee157b9ac8054dcab364f364b2e0bd1c05",
           "lines": 25,
           "heading": "9. Token、终端会话与租户隔离"
         },
@@ -2884,7 +2884,7 @@
           "id": "v8-security-011",
           "ordinal": 11,
           "destination": "v8-security/references/progressive-02-7-日志记录.md",
-          "sha256": "aaf4ca37e6a03ddd3520d32559e322d0d7bbba60be8aceef03d200138df77a98",
+          "sha256": "78053ef853bdffb4eaad90354204555d836d67b9a18f2a6c0ac74a0142df2794",
           "lines": 11,
           "heading": "10. Jint 运行时升级边界"
         },
@@ -2892,7 +2892,7 @@
           "id": "v8-security-012",
           "ordinal": 12,
           "destination": "v8-security/references/progressive-02-7-日志记录.md",
-          "sha256": "782777ed84d4030038999d74be896385365f7f3a005332558b7f5e46b17b351b",
+          "sha256": "f7ac9ee1702759fbf5b256ef7b7069ebce75cb845b59786d4eab928335001bf6",
           "lines": 30,
           "heading": "安全检查清单"
         },
@@ -2900,7 +2900,7 @@
           "id": "v8-security-013",
           "ordinal": 13,
           "destination": "v8-security/references/progressive-02-7-日志记录.md",
-          "sha256": "d87a3b8c82d4eb9c88ee5214711672f9e0684895dc3f4eca32b0278587f68426",
+          "sha256": "809cd12c1b5fbba76a0b09ebbddf5d2e34189d26ee510c285389294c35b91176",
           "lines": 22,
           "heading": "浏览器访问密钥"
         }

package/skills/microi-deployment/SKILL.md

@@ -74,14 +74,21 @@ Microi API 安装时，`AppSettings` 与同名容器环境变量只允许以下
 - 每次修改 `数据库、案例、文档、资料/install-microi.sh`，必须同时更新文件头版本和 `SCRIPT_VERSION`，两处完全一致。
 - 固定格式为 `vYYYY-MM-DD HH:mm:ss`，使用 `Asia/Shanghai` 时间并精确到秒；禁止只写日期或沿用上一次修改时间。
 - 验收同时断言两处版本一致、格式正确，并以脚本实际启动输出为准；官网静态地址尚未发布新文件时，不能把本地版本误报为客户已经可下载。
-- 恢复旧数据库时，OCR、翻译等启动不变量字段先出现不代表完整升级链已经成功。安装器必须在重启 API 和输出“安装完成”之前回读 `sys_config.ServerVersion` 达到本脚本最低版本；中间迁移失败或超时应失败关闭，禁止用部分字段就绪冒充整个平台升级成功，也禁止在升级事务仍执行时主动重启 API。
+- 恢复旧数据库时，OCR、翻译等附加字段先出现不代表完整升级链已经成功。安装器必须先回读 `sys_config.ServerVersion` 达到本脚本最低版本并通过 API liveness/readiness，才能部署和配置附加能力；核心中间迁移失败或超时应失败关闭，禁止用部分字段就绪冒充整个平台升级成功，也禁止在升级事务仍执行时主动重启 API。
 - Compose v2 生成文件不再写顶层 `version`；所有模板直接以 `services:` 开始，避免 `the attribute version is obsolete` 告警。
 - LibreTranslate 属于一键安装默认组件：安装选择空输入按 `1` 处理，语言套餐空输入按基础套餐 `1` 处理；因此用户一路按 Enter 使用官方推荐组合。只有明确输入 `0` 才跳过，提示、端口预算、官网文档和静态回归测试必须一致。
-- OCR 的 Upgrade29 与 LibreTranslate 的 Upgrade31 字段门禁都在 API liveness 后立即回读，每秒一次、最多 15 秒；首轮成功就继续，超时快速失败并提示镜像/迁移版本，不得退回 5 分钟空等，也不得直接创建字段绕过平台升级。
+- OCR 的 Upgrade29 与 LibreTranslate 的 Upgrade31 字段门禁只在对应附加服务部署检查通过后回读，每秒一次、最多 15 秒；首轮成功就继续，超时快速关闭对应能力并提示镜像/迁移版本，不得退回 5 分钟空等，也不得直接创建字段绕过平台升级。附加能力门禁失败不得中断已通过完整升级链和 readiness 的核心平台。
 - 官方 API/Web 使用浮动 `latest` 时，生成的 Compose 必须设置 `pull_policy: always` 或在启动前显式拉取并核对，不能因宿主机已有同名镜像就复用旧版本；测试专用本机镜像覆盖必须明确使用 `never`，避免误访问或覆盖远端镜像。
-- 端口、密码和数据目录全部生成后，安装器必须注册统一的失败收尾：任何后段错误继续保留原始非零退出码，并在终端输出标题为“安装未完成”的恢复汇总，列出已生成端口、凭据、目录、迁移门禁和容器状态。失败汇总不得使用“安装完成”文案、不得把 `Running` 当 readiness，也不得因此绕过 OCR/翻译/完整升级链门禁。
+- 端口、密码和数据目录全部生成后，安装器必须注册统一的失败收尾：数据库、缓存、存储、API/Web、完整升级链或 API liveness/readiness 等核心后段错误保留原始非零退出码，并输出标题为“安装未完成”的恢复汇总，列出已生成端口、凭据、目录、失败阶段和全部容器状态。OCR/LibreTranslate 的网络、镜像、容器或 SaaS 配置失败只记录附加能力警告、保持对应能力未启用并继续核心安装。两种结果都不得把 `Running` 当 readiness，也不得绕过 Upgrade29/Upgrade31 或完整升级链门禁。
 - 从客户/旧库恢复安装时，安装器只按 `OsClient + OsClientType + OsClientNetwork + IsEnable + IsDeleted` 处理目标主租户：0 条时幂等创建最小可运行记录，1 条时原位复用，超过 1 条失败关闭。禁止把所有活动 `sys_osclients` 批量改成输入的 OsClient；新记录不得落库 `DbConn/DbReadConn/DbMongoConnection` 或 Redis 主机、端口、密码，这些继续由十项编排启动配置提供。MinIO、OCR 等安装值随后只更新这个精确三元组并回读唯一性。
 
+### 复盘：普通帐号运行安装器直到步骤 5 才因 `/microi/compose` 权限失败
+
+- 触发场景：普通帐号已经加入 Docker 组，前四步的探测和交互看似正常；脚本在开放防火墙后直接执行 `mkdir -p /microi/compose`，才报 `Permission denied`。命令替换中的数据目录创建错误还可能被旧 Bash 的 `set -e` 语义掩盖，使成功提示先于真实失败出现。
+- 根因：安装器把 `sudo` 零散放在软件包、防火墙和 systemd 命令前，却没有在真实安装或修复入口统一取得 root 身份；同时假设精简系统一定安装 `sudo`，普通用户与“root 但无 sudo”两种环境都没有明确的早期门禁。
+- 通用规则：会写 `/microi`、`/home`、防火墙、systemd/cgroup 或 Docker 宿主状态的一键安装/修复，必须在步骤 1 和任何交互、凭据生成、宿主机写入前完成一次 root 门禁。普通帐号有 `sudo` 时重新执行同一绝对脚本并保留参数；无 `sudo` 或验证失败时零副作用停止并给出 `su -` 恢复指引。已经是 root 时不得要求系统额外安装 `sudo`；目录创建仍要显式检查只读文件系统、空间和权限错误。
+- 自动化检查：提供只执行权限门禁的无副作用入口；在本地 Linux 容器分别覆盖 root 且无 sudo、普通帐号且无 sudo、普通帐号通过 sudo 提权三种场景，断言成功路径最终 `uid=0`、失败路径发生在步骤 1 之前且不创建 `/microi`。源码契约同时锁定正常安装与 `--repair-app` 均调用同一门禁，并执行 `bash -n`。
+
 ## 多节点与滚动发布
 
 后端默认按多个 API/Worker 节点设计：
@@ -153,6 +160,13 @@ Microi API 安装时，`AppSettings` 与同名容器环境变量只允许以下
 - 通用规则：发布冒烟必须启动最终混淆/签名后的产物，确认本次进程仍存活，再以 `/api/Diagnostics/liveness` HTTP 200 判定启动成功；使用专用空闲端口，成功、超时、异常和中断路径都要在有限时间内结束本次进程并清理 publish 内的临时 logs/PDB。版本号已经更新但尚未提交时，重跑默认继续工作区当前版本，不能再次自动递增；当前版本进入 Git HEAD 后才计算下一版本。
 - 自动化检查：构造不再输出旧中文文案但 liveness 返回 200 的版本，断言冒烟成功；另覆盖端口占用、进程提前退出和 liveness 超时，断言脚本失败原因准确、进程无残留、`publish/logs` 不存在。再把工作区版本设为高于 HEAD，验证重跑默认版本保持不变。
 
+### 复盘：旧租户启动闭包把应用包展示字段当成物理列并反复重启
+
+- 触发场景：升级后的节点发现平台运行时接口缺失，准备从内置官方应用包自愈；旧包把接口名称导出为 `Name`，目标 `sys_apiengine` 的真实字段却是 `ApiName`，直接拼接包对象后出现 `Unknown column 'Name' in 'field list'`。修完别名后，另一批旧库又因 `UserId NOT NULL` 且无默认值、而少数新接口包漏出审计字段，出现 `Field 'UserId' doesn't have a default value`。启动门禁失败会使 Docker 的 restart policy 不断重启同一进程。
+- 根因：启动自愈把“应用包传输对象”误当成“数据库物理行”，既没有规范化历史别名，也没有按目标租户的真实表结构过滤；同时只检查“列是否存在”，却没有覆盖旧结构中仍为必填且无默认值的审计列。不同年代租户会依次暴露 unknown-column 或 required-column 错误。
+- 通用规则：任何在 FormEngine 可用前直接写核心物理表的可信自愈，都必须先规范化已知历史别名，再应用固定实体字段白名单，并与目标租户实时回读的物理列取交集；SQL 只使用经过双重筛选的固定标识符和参数值。官方包本身必须携带完整审计字段；无登录上下文的启动门禁还必须为历史必填审计列提供稳定的系统身份兜底，并为 `IsDeleted/IsEnable/Lock` 等开关及 `ApiRole/Files` 等集合字段补齐语义明确的插入默认值，这些默认值不得参与授权。必需业务列缺失时给出明确物理升级错误，写入后按稳定 Key 强回读，禁止把包级元数据直接转换成列名。
+- 自动化检查：使用包含旧 `Name`、未来包级字段、新版本可选列及缺失 `UserId/UserName/Lock` 的官方包样例，分别对完整结构与精简旧结构断言 `Name -> ApiName`、未知字段被丢弃、必需字段保留、审计字段和传统必填列获得稳定非空值；同时扫描全部启动闭包包，保证 `SysApiEngines` 只输出 `ApiName` 且审计字段及传统必填开关完整，并锁定新增接口生成器输出的集合字段，最后执行真实启动日志门禁回归。
+
 ## 禁止事项
 
 - 不把数据库/Redis/MinIO 密码写入仓库、日志、命令回显或最终答复。

package/skills/microi-form-engine/SKILL.md

@@ -57,8 +57,11 @@ Config/Data、菜单查询列与缓存保持一致。
   图片默认压缩到约 500 KB、最长边 1920 px。
 - 私有富文本只能持久化稳定对象标识，禁止把 HDFS 签名 URL、审计代理 Ticket 或 DiyToken 写入
   HTML。每次查看/编辑按当前菜单、表、记录和字段权限换取新短效地址；外部匿名页面没有此权限
-  上下文，因此不能把私有 RichText 当作公开正文。普通交互式帐号也不能用 `Limit=false` 绕过
-  后端强制私有策略。
+  上下文，因此不能把私有 RichText 当作公开正文。普通用户通过当前表单新增/编辑授权后，后端
+  必须回读 `diy_field.Config.RichText.Limit` 决定公私桶；只改请求 `Limit=false` 不能绕过字段配置。
+- 图片、文件和富文本上传必须携带 `FormEngineKey + FieldId + SysMenuId`，编辑记录再带
+  `FormDataId`，TableChild 再带父子授权上下文。后端不得按用户等级统一覆盖字段的“禁止匿名访问”；
+  无法回查字段与动作权限的普通上传才安全降级为私有桶。
 
 新建表/模块时，除非用户显式指定或表单达到极重阈值（约 36+ 业务字段、2+ 子表或同等
 重型控件密度），默认保存 `diy_table.FormOpenType=Dialog` 与 `FormOpenWidth=80%`。

package/skills/microi-form-engine/references/component-catalog.md

@@ -178,7 +178,7 @@ if (V8.LoadMode !== 'Design') {
 }
 ```
 
-- `Limit=true` 表示字段配置为私有桶，`false` 表示配置为公有桶；最终访问仍服从后端租户权限和上传安全策略。
+- `Limit=true` 表示字段配置为私有桶，`false` 表示配置为公有桶。普通用户有当前表单新增/编辑权限时也按此权威配置执行；运行时提交表、字段、菜单、记录上下文，后端回读 `diy_field.Config`，不得信任客户端 `Limit/Path`，也不得按用户等级统一强制私有。
 - `Multiple=true` 时 `MaxCount` 必须是正整数；`MaxSize` 单位为 MB。`Preview` 未配置时按 `true` 压缩，普通列表、卡片、商品图不要关闭。
 - `Crop.Enabled` 只决定运行时裁剪开关的初始状态；`false` 或缺失时用户仍可在紧凑上传面板主动开启。裁剪前原图始终进入 HDFS 私有桶，业务字段只保存展示图元数据。
 - 图片和文件都把拖放提示、存储范围、单/多文件、最大数量、处理方式和最大体积合并到同一个紧凑面板；不要在字段外再生成重复说明卡片。
@@ -205,6 +205,7 @@ if (V8.LoadMode !== 'Design') {
 ```
 
 - 公开公告、商品详情等匿名网页内容显式用 `Limit=false`；内部公告、合同说明等用 `true`。旧字段缺失时默认私有，不能由 AI 猜成公有。
+- 普通用户经当前表单新增/编辑授权后可以发布公有 RichText；后端按字段权威配置选择桶。缺少 `FormEngineKey/FieldId` 等可验证上下文的普通上传仍保持私有，不能用裸 `Limit=false` 代替授权。
 - `MaxSize` 单位 MB，`CompressMaxSize` 单位 KB。图片压缩开启时原图仍先进入 HDFS 私有桶，正文只引用展示图。
 - 私有正文只保存 `/__microi_richtext_private__/...` 稳定标识；运行时携带当前菜单、表、记录和字段上下文换取短效代理 URL，禁止把临时 Token/Ticket 回写字段。
 - 普通文件通过富文本工具栏附件入口插入 `a.href`；私有授权只接受真实 `img/video/source.src` 与 `a.href` 的精确路径，不接受正文文字、`data-*` 或脚本标签。

package/skills/microi-form-engine/references/data-source-events.md

@@ -87,6 +87,13 @@ if (!V8.Form.Name) return { Code: 0, Msg: '名称不能为空' };
 - 修改防抖编辑器/代码字段前必须刷新待保存值，避免最后一次输入未入库。
 - `Data/Config` 修改后回读并刷新 schema 缓存。
 
+### 历史字段 V8 双存储兼容
+
+- `diy_field.V8Code` 是历史租户和官方应用包实际使用的物理列，按钮点击/字段值变更代码可能只存在于该列；`Config.V8Code` 是部分新版前端使用的镜像，不能假定它是唯一事实源。
+- 后端 `DiyField` 实体、字段查询投影和 `DiyFieldParam` 必须保留 `V8Code`，否则数据库代码虽然仍在，设计器列表和单字段回读都会表现成“0 字”。
+- 前端回读顺序固定为：先安全解码历史 Base64，再取“非空物理 `V8Code` 优先、否则 `Config.V8Code`”，最后同步两处。禁止用空镜像覆盖非空物理代码；保存和显式清空时则必须同步写入两处。
+- 回归至少包含一个 `Component=Button`、根级 `V8Code` 非空而 `Config.V8Code` 为空的官方包字段，并验证列表回读、选中编辑、保存、刷新后代码仍完整。
+
 ## DevComponent 定制组件
 
 定制组件至少处理：

package/skills/microi-frontend-sdk/SKILL.md

@@ -71,7 +71,7 @@ export function createApp() {
 `Microi.Client` 主后台运行时已内置前后端同构的 `V8.Http.Get/Post/Patch` 及对应 Response 方法；表单事件、按钮 V8 等宿主前端新代码必须优先使用 `V8.Http`，旧 `V8.Post/Get` 仅作兼容保留，其参数和兼容规则以 `v8-http-integration/SKILL.md` 为准。独立项目使用本 SDK、且不在主后台 V8 宿主中时，才使用 SDK 自身的小写 `V8.get/post`、`ApiEngine`、`FormEngine`；不要把它们与宿主旧版大写 `V8.Post/Get` 混为一谈，也不要假设浏览器可以绕过第三方接口的 CORS。
 
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=microi-frontend-sdk-002 sha256=54b302bfe2a8830a3043ae7804ca775d6159453bea0cfdeac61c3b97d36466ed -->
+<!-- microi-progressive:chunk id=microi-frontend-sdk-002 sha256=b71205548e4701f8bf53e2bed3da914da4ca0f49e0cce952a1c938fc77218ed8 -->
 ## 登录与验证码封装
 
 SDK 或项目请求模块必须提供登录所需的系统配置和验证码薄封装，不要让页面散落手写。
@@ -132,15 +132,16 @@ SDK 的 `buildHeaders` 必须集中处理所有请求头，不能让页面、业
 - 验收时检查真实网络请求：不得出现 `osclient: demo, demo`、`Authorization: Bearer xxx, Bearer xxx` 这类逗号合并值。
 
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=microi-frontend-sdk-004 sha256=f5644fc45280e53988d1eed432e57afc2c56fc58b1232505950359219b5220d2 -->
+<!-- microi-progressive:chunk id=microi-frontend-sdk-004 sha256=1ecb73f5b1246c7157d782b62cba59850389858baeefdc5351a255d4d04b11b6 -->
 ## 上传规则
 
 `V8.uploadFile` 是 Microi 前端唯一允许的上传入口。SDK 实现必须：
 
 - 使用 multipart 上传头。`uni.uploadFile` 或 `fetch(FormData)` 不得发送 `Content-Type: application/json`。
 - 租户请求头只发送一个键：`osclient`。添加配置租户前，先移除传入的 `osclient` / `OsClient` 重复键。
-- `formData` 中发送 `OsClient`；开启 `appendOsClientQuery` 时保留接口查询参数 `?OsClient=tenant`。
-- 上传 `Path` 统一从 `options.path`、`formData.Path` 或 `formData.path` 归一化。
+- `formData` 中发送 `OsClient`；开启 `appendOsClientQuery` 时保留接口查询参数 `?OsClient=tenant`。
+- 标准表单的 `ImgUpload`、`FileUpload`、`RichText` 必须通过 `formFieldContext`（或等价 `formData`）发送 `FormEngineKey + FieldId + SysMenuId`；编辑已有记录再传 `FormDataId`，TableChild 再传 JSON 化的 `_TableChildAuth`。服务端以当前租户字段配置和 FormEngine 动作授权决定实际 `Limit/Path`，SDK 不能按帐号等级强制私有，也不能信任页面传入的 `Limit=false`。
+- 上传 `Path` 统一从 `options.path`、`formData.Path` 或 `formData.path` 归一化。
 - 移动端上传路径必须是安全相对路径，例如 `mall/pay-proof` 或 `mall/member/avatar`。不要使用 `/mall/pay-proof`、完整 URL、磁盘路径、`..`、`:`、`//` 或 `~`。
 - 项目薄封装要通过 `{ ...options, path: options.path || defaultPath }` 透传全部选项，避免丢失页面级 `headers`、`action`、`anonymous`、`file`、`formData` 和 `silentError`。
 - H5 页面要保留 `uni.chooseImage` 返回的真实 `File` 对象（可用时为 `tempFiles[0].file`）。如果 H5 只返回 `tempFiles[0]` 或 `blob:` / `data:` 临时路径，也要继续传入，不要丢弃。调用 `V8.uploadFile(..., { file, preferFetch:true })`。SDK 必须识别 `File` / `Blob`、`file` / `raw` / `blob` / `originFileObj` 等常见嵌套字段，以及 `blob:` / `data:` 路径，然后优先使用 `fetch + FormData`，必要时在 `uni.uploadFile` 与 fetch 之间回退。

package/skills/microi-uniapp-frontend/SKILL.md

@@ -13,6 +13,8 @@ description: Microi 吾码 UniApp/H5 前端通用规范。用于构建或修复
 
 UniApp/H5/小程序必须通过项目统一 `microi.v8.js` 的 `V8.uploadFile` / `V8.uploadFiles` 上传图片。调用方省略 `options.preview` 时，SDK 必须发送 `Preview=true` 并默认使用 `img` 路径；只有显式 `preview:false` 才允许关闭。服务端仍是最终事实源：即使旧客户端完全不传该字段，也要默认压缩到约 `500 KB`、最长边约 `1920 px`，并在 HDFS 私有桶保留一份 `_origin` 原图。页面不得为了“上传成功”自行改成 `preview:false`，也不得把私有原图或临时签名地址保存进业务字段。
 
+动态表单上传还必须把控件已有的文件访问上下文透传为 `formFieldContext`：至少包含 `FormEngineKey + FieldId + SysMenuId`，编辑时再带 `FormDataId`，TableChild 再带 `_TableChildAuth`。后端回读 `diy_field.Config` 后决定“禁止匿名访问”与真实桶；普通用户不能被一刀切为私有桶，客户端自己传 `Limit=false` 也不能放宽私有字段。没有字段上下文的聊天、打卡、临时业务上传仍按普通私有上传处理。
+
 ## 平台方通用 App 登录连接器（明确例外）
 
 登录页默认不得展示 ApiBase、OsClient 或调试配置；但用户明确要求、且安装包由 Microi 平台方作为多租户聚合客户端发布时，允许仅在 `APP-PLUS` 登录页提供通用连接器。协议必须使用固定 `https://` / `http://` 下拉框，地址框禁止重复输入协议，HTTPS 默认，HTTP 显示明文风险并二次确认；H5、小程序和客户专属包不得因此自动开放。候选地址先匿名读取 `GetSysConfig`，验证成功后再持久化。真正切换时必须清除旧 DiyToken、用户、SignalR、菜单/元数据/页面缓存，按 `ApiBase + OsClient` 隔离记住的账号及 RSA 密文，并用端点代次拒绝切换前的迟到响应。支持任意 HTTP 时，最终 IPA 必须显式包含 ATS 例外，Android 安装包必须显式包含 cleartext 例外；不需要任意 HTTP 的正式包应保持平台默认安全策略，iOS ATS 例外还必须在 App Store 审核中说明。
@@ -55,7 +57,7 @@ Microi 标准小程序必须采用“平台内核 + 版本化元数据 + Profile
 - 自动化验收必须同时使用桌面视口与移动视口截图：桌面端断言手机壳存在，移动端断言 `.phone-status` 隐藏且 `.phone` 无圆角、无边框、宽高铺满；每个底部菜单的图标元素和文字都必须可见、可点击。
 
 <!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=microi-uniapp-frontend-003 sha256=6ecff0f73715fd0b1e39ca8d3107582928db9cf2a20e54a2ae285983e97411fe -->
+<!-- microi-progressive:chunk id=microi-uniapp-frontend-003 sha256=5cedd05cb29746019a92db56a21123718fde23d5d9df4b8064dfc260bc89ee05 -->
 ## 登录页与手机号快捷登录
 
 - 登录页必须是直接登录面，不要默认做“员工登录 / 客户登录”身份 Tab 切换，除非用户明确要求。默认展示系统账号密码登录，同时提供客户手机号快捷登录入口。

package/skills/microi.v8.js

@@ -188,14 +188,14 @@ function normalizeUploadValue(value) {
   return [text];
 }
 
-function normalizeUploadData(body) {
-  const raw = Array.isArray(body && body.Data) ? (body.Data[0] || {}) : ((body && body.Data) || {});
-  const path = raw.Path || raw.FilePathName || raw.FilePath || raw.FullPath || raw.Url || raw.FileUrl || '';
-  const url = raw.Url || raw.FileUrl || raw.FileURL || raw.PreviewUrl || raw.PreviewURL || '';
-  return { ...raw, Path: path, Url: url };
-}
-
-function normalizeClientUploadPath(value) {
+function normalizeUploadData(body) {
+  const raw = Array.isArray(body && body.Data) ? (body.Data[0] || {}) : ((body && body.Data) || {});
+  const path = raw.Path || raw.FilePathName || raw.FilePath || raw.FullPath || raw.Url || raw.FileUrl || '';
+  const url = raw.Url || raw.FileUrl || raw.FileURL || raw.PreviewUrl || raw.PreviewURL || '';
+  return { ...raw, Path: path, Url: url };
+}
+
+function normalizeClientUploadPath(value) {
   let path = String(value || 'upload').trim().replace(/\\/g, '/');
   if (/^(https?:|data:|blob:|file:)/i.test(path)) throw new Error('上传路径不合法。');
   path = path.replace(/^\/+/, '').replace(/\/+$/, '').replace(/\/{2,}/g, '/');
@@ -209,30 +209,30 @@ function normalizeClientUploadPath(value) {
   return parts.join('/');
 }
 
-function normalizeFileUrlData(data, assetUrl, fallback = '') {
+function normalizeFileUrlData(data, assetUrl, fallback = '') {
   const raw = Array.isArray(data) ? (data[0] || '') : (data || '');
   if (typeof raw === 'string') return assetUrl(raw || fallback);
   const url = raw.Url || raw.FileUrl || raw.FileURL || raw.PreviewUrl || raw.PreviewURL || raw.FullUrl || '';
   const path = raw.Path || raw.FilePathName || raw.FilePath || raw.FullPath || '';
   return assetUrl(url || path || fallback);
-}
-
-function isLocalPackagedAsset(path) {
-  return /^(?:\.\/)?\/?static\//i.test(String(path || ''));
-}
-
-function hasPublicUploadFlag(value) {
-  if (!value || typeof value !== 'object') return false;
-  const raw = Array.isArray(value) ? (value[0] || {}) : value;
-  return raw.Limit === false || raw.Limit === 0 || String(raw.Limit).toLowerCase() === 'false' ||
-    raw.IsPrivate === false || raw.Private === false || raw.Public === true;
-}
-
+}
+
+function isLocalPackagedAsset(path) {
+  return /^(?:\.\/)?\/?static\//i.test(String(path || ''));
+}
+
+function hasPublicUploadFlag(value) {
+  if (!value || typeof value !== 'object') return false;
+  const raw = Array.isArray(value) ? (value[0] || {}) : value;
+  return raw.Limit === false || raw.Limit === 0 || String(raw.Limit).toLowerCase() === 'false' ||
+    raw.IsPrivate === false || raw.Private === false || raw.Public === true;
+}
+
 function isKnownPublicUploadPath(path) {
   // Ordinary form uploads such as /xjy/img and /xjy/file are private by default.
   // They must use the Managed signer instead of being mistaken for CDN assets.
-  return /^\/?(?:public|mci-public|xjy\/xjy\/miniapp-assets|xjy\/miniapp\/share)\//i.test(String(path || ''));
-}
+  return /^\/?(?:public|mci-public|xjy\/xjy\/miniapp-assets|xjy\/miniapp\/share)\//i.test(String(path || ''));
+}
 
 function getHeaderValue(headers, key) {
   if (!headers) return '';
@@ -935,12 +935,12 @@ export function createMicroiV8(options = {}) {
   }
 
   // 资源地址统一过滤占位图，并兼容 HDFS 私有文件、FileServer 和绝对地址。
-  function assetUrl(value) {
+  function assetUrl(value) {
     const picked = extractUploadPath(value);
     if (!picked || isBlockedAsset(picked)) return '';
     if (/^(https?:|data:|blob:|file:)/i.test(picked)) return picked;
-    if (isLocalPackagedAsset(picked)) return picked;
-    if (/^\/?file\//i.test(picked)) return joinUrl(config.apiBase, picked);
+    if (isLocalPackagedAsset(picked)) return picked;
+    if (/^\/?file\//i.test(picked)) return joinUrl(config.apiBase, picked);
     if (/^\//.test(picked) || /^[a-z0-9_-]+\//i.test(picked)) return joinUrl(config.fileServer || config.apiBase, picked);
     return picked;
   }
@@ -949,59 +949,59 @@ export function createMicroiV8(options = {}) {
     return config.blockedAssetPattern ? config.blockedAssetPattern.test(String(value || '')) : false;
   }
 
-  function hasPrivateFileAccessContext(options = {}) {
-    const resourceKind = String(options.resourceKind || options.ResourceKind || 'FormField').trim();
-    const resourceId = String(options.resourceId || options.ResourceId || '').trim();
-    const formEngineKey = String(options.formEngineKey || options.FormEngineKey || '').trim();
-    const formDataId = String(options.formDataId || options.FormDataId || '').trim();
-    const fieldId = String(options.fieldId || options.FieldId || '').trim();
-    const sysMenuId = String(options.sysMenuId || options.SysMenuId || options.menuId || options.MenuId || '').trim();
-    const formFieldReady = Boolean(formEngineKey && formDataId && fieldId && sysMenuId);
-
-    if (resourceKind === 'UserAvatar' || resourceKind === 'MenuImportTemplate' || resourceKind === 'DeptImportTemplate') {
-      return Boolean(resourceId);
-    }
-    if (resourceKind === 'FileManagerObject') return Boolean(resourceId && sysMenuId);
-    if (resourceKind === 'FormFieldDerivedPreview') {
-      return formFieldReady && Boolean(options.originalFilePathName || options.OriginalFilePathName);
-    }
-    return resourceKind === 'FormField' && formFieldReady;
-  }
-
-  async function resolveFileUrl(filePathName, options = {}) {
-    const path = extractUploadPath(filePathName);
-    if (!path || isBlockedAsset(path)) return '';
-    if (/^(https?:|blob:|data:|file:)/i.test(path)) return assetUrl(path);
-    if (isLocalPackagedAsset(path) || options.private === false || hasPublicUploadFlag(filePathName) || isKnownPublicUploadPath(path)) {
-      return assetUrl(path);
-    }
-    // 私有对象没有权威资源上下文时直接失败关闭，禁止以裸路径换取签名。
-    if (!hasPrivateFileAccessContext(options)) return '';
-
-    async function requestPrivateFileUrl() {
-      try {
-        const body = await apiEngineRun('platform-private-file-url', {
-          OsClient: config.osClient,
-          FilePathName: path,
-          FormEngineKey: options.formEngineKey || options.FormEngineKey,
-          FormDataId: options.formDataId || options.FormDataId,
-          FieldId: options.fieldId || options.FieldId,
-          SysMenuId: options.sysMenuId || options.SysMenuId || options.menuId || options.MenuId,
-          ResourceKind: options.resourceKind || options.ResourceKind,
-          ResourceId: options.resourceId || options.ResourceId,
-          OriginalFilePathName: options.originalFilePathName || options.OriginalFilePathName,
-          _TableChildAuth: options.tableChildAuth || options._TableChildAuth,
-          HDFS: options.hdfs || options.HDFS
-        }, {
-          checkCode: false,
-          silentError: true
-        });
-        if (body && body.Code === 1 && body.Data) return normalizeFileUrlData(body.Data, assetUrl, path);
+  function hasPrivateFileAccessContext(options = {}) {
+    const resourceKind = String(options.resourceKind || options.ResourceKind || 'FormField').trim();
+    const resourceId = String(options.resourceId || options.ResourceId || '').trim();
+    const formEngineKey = String(options.formEngineKey || options.FormEngineKey || '').trim();
+    const formDataId = String(options.formDataId || options.FormDataId || '').trim();
+    const fieldId = String(options.fieldId || options.FieldId || '').trim();
+    const sysMenuId = String(options.sysMenuId || options.SysMenuId || options.menuId || options.MenuId || '').trim();
+    const formFieldReady = Boolean(formEngineKey && formDataId && fieldId && sysMenuId);
+
+    if (resourceKind === 'UserAvatar' || resourceKind === 'MenuImportTemplate' || resourceKind === 'DeptImportTemplate') {
+      return Boolean(resourceId);
+    }
+    if (resourceKind === 'FileManagerObject') return Boolean(resourceId && sysMenuId);
+    if (resourceKind === 'FormFieldDerivedPreview') {
+      return formFieldReady && Boolean(options.originalFilePathName || options.OriginalFilePathName);
+    }
+    return resourceKind === 'FormField' && formFieldReady;
+  }
+
+  async function resolveFileUrl(filePathName, options = {}) {
+    const path = extractUploadPath(filePathName);
+    if (!path || isBlockedAsset(path)) return '';
+    if (/^(https?:|blob:|data:|file:)/i.test(path)) return assetUrl(path);
+    if (isLocalPackagedAsset(path) || options.private === false || hasPublicUploadFlag(filePathName) || isKnownPublicUploadPath(path)) {
+      return assetUrl(path);
+    }
+    // 私有对象没有权威资源上下文时直接失败关闭，禁止以裸路径换取签名。
+    if (!hasPrivateFileAccessContext(options)) return '';
+
+    async function requestPrivateFileUrl() {
+      try {
+        const body = await apiEngineRun('platform-private-file-url', {
+          OsClient: config.osClient,
+          FilePathName: path,
+          FormEngineKey: options.formEngineKey || options.FormEngineKey,
+          FormDataId: options.formDataId || options.FormDataId,
+          FieldId: options.fieldId || options.FieldId,
+          SysMenuId: options.sysMenuId || options.SysMenuId || options.menuId || options.MenuId,
+          ResourceKind: options.resourceKind || options.ResourceKind,
+          ResourceId: options.resourceId || options.ResourceId,
+          OriginalFilePathName: options.originalFilePathName || options.OriginalFilePathName,
+          _TableChildAuth: options.tableChildAuth || options._TableChildAuth,
+          HDFS: options.hdfs || options.HDFS
+        }, {
+          checkCode: false,
+          silentError: true
+        });
+        if (body && body.Code === 1 && body.Data) return normalizeFileUrlData(body.Data, assetUrl, path);
       } catch (e) {}
       return '';
     }
 
-    return (await requestPrivateFileUrl()) || '';
+    return (await requestPrivateFileUrl()) || '';
   }
 
   // 文件上传同时支持 uni.uploadFile 与浏览器 fetch/FormData。
@@ -1009,9 +1009,9 @@ export function createMicroiV8(options = {}) {
     const runtimeUni = getUni();
     const action = options.action || (options.anonymous ? 'UniappUploadAnonymous' : 'UniappUpload');
     const rawFormData = options.formData || {};
-    const uploadData = {
-      ...rawFormData,
-      OsClient: config.osClient,
+    const uploadData = {
+      ...rawFormData,
+      OsClient: config.osClient,
       Limit: options.limit === false ? 'false' : 'true',
       Preview: options.preview === false ? 'false' : 'true',
       Multiple: options.multiple ? 'true' : 'false'
@@ -1291,7 +1291,7 @@ export function createMicroiV8(options = {}) {
 
   function legacyGetCurrentUser(refresh, callback) {
     if (refresh) {
-      legacyPost('/apiengine/platform-current-user', {}, (result) => {
+      legacyPost('/apiengine/platform-current-user', {}, (result) => {
         if (result && result.Code) legacySetCurrentUser(result.Data || {});
         if (typeof callback === 'function') callback(result);
       });
@@ -1538,7 +1538,7 @@ export function createMicroiV8(options = {}) {
   // 旧版前端 V8 依赖的后端接口路径，保留原名称以减少迁移成本。
   const legacyApi = {
     MicroiInit: '/apiengine/microi-init',
-    GetSysConfig: '/apiengine/platform-sys-config',
+    GetSysConfig: '/apiengine/platform-sys-config',
     Login: '/api/SysUser/login',
     AddFormData: '/api/FormEngine/addFormData',
     AddFormDataBatch: '/api/FormEngine/addFormDataBatch',
@@ -1555,17 +1555,17 @@ export function createMicroiV8(options = {}) {
     GetTableDataTree: '/api/FormEngine/getTableDataTree',
     GetTableDataTreeAnonymous: '/api/FormEngine/getTableDataTreeAnonymous',
     ApiEngineRun: '/api/ApiEngine/run',
-    ModuleEngineRun: '/apiengine/platform-module-data',
+    ModuleEngineRun: '/apiengine/platform-module-data',
     RefreshToken: '/api/SysUser/refreshToken',
     RefreshLoginUser: '/api/SysUser/refreshLoginUser',
     Upload: '/api/HDFS/Upload',
     UploadAnonymous: '/api/HDFS/uploadAnonymous',
     UniappUpload: '/api/HDFS/UniappUpload',
     UniappUploadAnonymous: '/api/HDFS/uniappUploadAnonymous',
-    GetCurrentUser: '/apiengine/platform-current-user',
+    GetCurrentUser: '/apiengine/platform-current-user',
     GetDateTimeNow: '/api/os/getDateTimeNow',
-    AddSysLog: '/apiengine/platform-client-log',
-    GetOsClientByDomain: '/apiengine/platform-os-client-by-domain',
+    AddSysLog: '/apiengine/platform-client-log',
+    GetOsClientByDomain: '/apiengine/platform-os-client-by-domain',
     ApiEngine: {}
   };
 
@@ -1816,7 +1816,7 @@ export function createMicroiV8(options = {}) {
         ? { ModuleEngineKey: moduleKeyOrParam, ...(dataOrCallback || {}) }
         : (moduleKeyOrParam || {});
       const cb = typeof dataOrCallback === 'function' ? dataOrCallback : callback;
-      return withCallback(legacyPost(legacyApi.ModuleEngineRun, { Action: 'GetTableData', ...data }), cb);
+      return withCallback(legacyPost(legacyApi.ModuleEngineRun, { Action: 'GetTableData', ...data }), cb);
     }
   };