@microi.net/cli 6.0.9 → 6.1.1

package/skills/ocr-engine/SKILL.md

@@ -1,113 +1,113 @@
----
-name: ocr-engine
-description: 为 Microi 吾码集成、配置、调用和验收通用 OCR 能力。处理 V8.OCR、/apiengine/platform-ocr-recognize、PaddleX/PaddleOCR 服务、SaaS 租户 OCR 配置、图片或 PDF 文字识别、OCR 安全边界、Docker 部署和多节点交付时使用。
----
-
-> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
-
-# Microi OCR 引擎
-
-## 先读取相关规范
-
-- 涉及租户配置时，读取 `../v8-saas-multi-tenant/SKILL.md`。
-- 涉及外部 OCR 服务时，读取 `../v8-http-integration/SKILL.md`。
-- 涉及 Base64、上传文件或私有文件时，读取 `../v8-file-upload/SKILL.md`。
-- 涉及权限、密钥、日志或匿名接口时，读取 `../v8-security/SKILL.md`。
-- 涉及数据库字段和表单 Tab 时，读取 `../microi-db-schema/SKILL.md`。
-
-## 固定架构
-
-Microi 后端只实现统一 OCR 网关、租户隔离、协议适配和安全治理，不在 .NET 进程内训练或维护 OCR 模型。默认提供方为独立部署的 PaddleX OCR 服务；业务代码只能调用 `IMicroiOcr`、`V8.OCR` 或官方 Managed 接口 `/apiengine/platform-ocr-recognize`，不得直接读取 SaaS 密钥并自行拼接 HTTP 请求。
-
-同步识别必须绑定当前请求和当前租户。批量、超大文件或长耗时 OCR 应进入共享数据库/MQ/outbox，以全局任务 Id 做幂等；不得把任务状态、队列或锁只放在单机内存中。
-
-## SaaS 配置
-
-配置位于 `sys_osclients` 的独立“OCR识别”Tab：
-
-| 字段 | 用途 | 默认值 |
-|---|---|---|
-| `OcrEnabled` | 租户总开关，默认关闭 | `0` |
-| `OcrProvider` | `PaddleX` 或 `PaddleXHighStability` | `PaddleX` |
-| `OcrEndpoint` | OCR 服务完整接口地址 | 空 |
-| `OcrApiKey` | 可选 Bearer 密钥，只允许后端使用 | 空 |
-| `OcrHeadersJson` | 可选服务端固定请求头 JSON | 空 |
-| `OcrTimeoutSeconds` | 单次超时秒数 | `60` |
-| `OcrMaxFileMB` | 单文件大小上限 | `20` |
-| `OcrMaxPages` | PDF 页数上限 | `10` |
-| `OcrMinConfidence` | 返回文本最低置信度 | `0` |
-
-这些配置不得投影到 `V8.OsClientModel`，不得由前端请求覆盖，不得写入普通日志。没有启用、没有 endpoint 或配置无效时必须失败关闭。
-
-## 调用
-
-接口引擎或后端表单事件中：
-
-```js
-var result = await V8.OCR.Recognize({
-  FileByteBase64: V8.FilesByteBase64.invoice,
-  FileName: 'invoice.png',
-  UseDocOrientationClassify: true,
-  UseDocUnwarping: true,
-  UseTextlineOrientation: true,
-  TextRecScoreThresh: 0.5,
-  ReturnWordBox: false
-});
-
-if (result.Code !== 1) {
-  return result;
-}
-
-return {
-  Code: 1,
-  Data: {
-    Text: result.Data.Text,
-    Pages: result.Data.Pages,
-    Provider: result.Data.Provider
-  }
-};
-```
-
-已登录客户端调用 `POST /apiengine/platform-ocr-recognize`，请求体与 `V8.OCR.Recognize` 一致，并携带正常登录 Token。`OsClient` 以 Token 解析结果为准。该接口由官方应用以 `Managed` 策略恢复；个性化逻辑只能写入租户 `platform-runtime-custom-hook`，且官方接口不会把文件 Base64、识别原文或密钥传给 Hook。
-
-标准成功结果包含 `Provider`、`Text`、`Pages`、`ElapsedMilliseconds`。每页包含 `PageIndex`、`Text`、`Regions`，每个区域包含 `Text`、`Confidence` 和归一化后的 `Polygon`。
-
-## 协议与输入边界
-
-- `PaddleX` 使用基础服务协议 `POST /ocr`。
-- `PaddleXHighStability` 使用 KServe 协议 `POST /v2/models/ocr/infer`。
-- 接受 PDF、PNG、JPEG、BMP、GIF、TIFF、WebP；同时检查文件扩展名、Base64 和文件魔数。
-- 固定 `visualize=false`，避免服务返回大体积可视化图片。
-- 由服务端限制文件大小、超时、PDF 页数、响应体大小和最低置信度。
-- 禁止接受调用方传入 endpoint、API key、任意请求头、代理地址或本地文件路径，防止 SSRF 和密钥绕过。
-- 日志只记录租户、提供方、状态码、耗时和安全裁剪后的错误，不记录文件 Base64、识别原文、API key 或完整响应。
-
-## Docker 与多节点
-
-- OCR 模型服务独立部署，固定 PaddleX/PaddlePaddle/模型版本；不要使用浮动 `latest` 直接上线。
-- CPU 基线位于 `../../Microi.Server/Microi.OCR/deploy/paddlex/`，固定 PaddleX 3.6.1 与 PaddlePaddle 3.2.2；公开镜像固定为 `registry.cn-hangzhou.aliyuncs.com/microios/paddlex-ocr:3.6.1-paddle3.2.2-cpu`，当前只交付 `linux/amd64`。PaddlePaddle 3.3.0 存在 CPU oneDNN PIR 推理兼容问题，在完成真实图片回归前不得升级。
-- 发布镜像使用同目录 `publish-image.ps1`：它从根目录发布配置读取凭据，通过隔离 Docker 配置和 `--password-stdin` 登录，推送后退出并匿名回读公开摘要。不得在命令行、日志或文档中展开用户名/密码，也不得只凭 `docker push` 返回成功就宣布国内镜像可用。
-- 发布镜像时执行 `create_pipeline("OCR")` 预置默认产线模型。运行时使用 named volume 挂载 `/home/microi/.paddlex`，让 Docker 首次创建卷时从镜像复制模型；不要改成空宿主机 bind mount，否则会遮住镜像内的预置模型并触发重新下载。
-- OCR 宿主机端口只绑定 `127.0.0.1`；Docker 化 API 与 OCR 同时加入 external bridge 网络 `microi-ocr`，一键安装的内部 endpoint 固定为 `http://microi-install-ocr:8080/ocr`。不得通过公网/LAN 回环调用同机 OCR。
-- `install-microi.sh` 默认尝试安装 OCR，但先部署 API/Web 并通过 liveness、完整 `ServerVersion` 升级链和 readiness。随后必须依次满足“固定镜像拉取并回读为 amd64 → OCR healthy → Upgrade29 的 9 个物理字段数据库回读 → 唯一活动主租户 → 配置写入后回读 → API 重启 readiness”才设置 `OcrEnabled=1`；任一步失败都保持 OCR 能力关闭并记录警告，但不得中断已经可用的核心平台。字段每秒回读一次且最多 15 秒；正常升级应首轮命中，镜像过旧或迁移失败应快速关闭 OCR，禁止无意义等待 5 分钟。不要用安装脚本直接伪造 `diy_field` 元数据绕过 Upgrade29。
-- API/Web 官方浮动 `latest` 必须在 Compose 启动时强制回源拉取，避免旧本机镜像缺少 Upgrade29。核心门禁失败时输出“安装未完成”恢复汇总并保留非零退出码；OCR 字段、服务或配置门禁失败时，成功汇总明确显示“OCR SaaS 未启用”和附加能力警告。两种汇总都不是启用 OCR 的依据。
-- OCR 使用固定不可变版本，不加入只跟踪 API/Web 浮动标签的 Watchtower 自动更新列表；升级镜像时先发布新 tag、匿名回读 digest/架构，再修改 Compose 与安装器。
-- 登录国内镜像源必须从本机发布配置读取凭据并走 `docker login --password-stdin`，不得输出密码。推送成功不是发布验收，必须使用隔离的匿名 Docker config 回读 manifest/digest，必要时再做匿名拉取。
-- 不要在内存不足的共享开发机上直接构建模型镜像。构建前检查物理内存、Docker 占用与同类进程；保留至少 `max(6 GB, 物理内存 20%)`，不足时延后构建而不是停止他人服务。
-- API 多节点共享同一个或同一组 OCR endpoint；每节点仅保留无状态 `HttpClient`。
-- OCR 服务至少配置 readiness、并发上限、CPU/GPU 资源上限、请求体上限和访问控制。
-- GPU 推理采用独立 Worker/服务池，避免 OCR 模型抢占 Microi API 内存。
-- 滚动升级时保持旧新 OCR 响应协议兼容；协议变更先扩展解析器，再升级服务。
-
-## 验收门禁
-
-交付时分别报告：
-
-1. 源码：网关、V8、REST、SaaS 字段、密钥投影隔离是否齐全。
-2. 定向测试：基础协议、高稳定协议、低置信度过滤、错误响应、配置隔离。
-3. 数据库：目标 `OsClient` 的 Tab、字段和物理列经 MCP 写后回读。
-4. 服务：真实 PNG/JPEG/PDF 至少各一例，包含中英文、旋转和多页场景。
-5. 多节点：两个 API 节点同时调用，同租户限制一致，服务故障时均能超时/降级且不泄漏密钥。
-6. UI：SaaS 配置表单能查看独立 Tab、保存配置，密码字段不出现在普通前端上下文。
-
-没有真实 OCR endpoint、服务版本和样例识别结果时，只能声明“平台接入完成、运行验收待配置”，不能声明生产 OCR 已可用。
+---
+name: ocr-engine
+description: 为 Microi 吾码集成、配置、调用和验收通用 OCR 能力。处理 V8.OCR、/apiengine/platform-ocr-recognize、PaddleX/PaddleOCR 服务、SaaS 租户 OCR 配置、图片或 PDF 文字识别、OCR 安全边界、Docker 部署和多节点交付时使用。
+---
+
+> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
+
+# Microi OCR 引擎
+
+## 先读取相关规范
+
+- 涉及租户配置时，读取 `../v8-saas-multi-tenant/SKILL.md`。
+- 涉及外部 OCR 服务时，读取 `../v8-http-integration/SKILL.md`。
+- 涉及 Base64、上传文件或私有文件时，读取 `../v8-file-upload/SKILL.md`。
+- 涉及权限、密钥、日志或匿名接口时，读取 `../v8-security/SKILL.md`。
+- 涉及数据库字段和表单 Tab 时，读取 `../microi-db-schema/SKILL.md`。
+
+## 固定架构
+
+Microi 后端只实现统一 OCR 网关、租户隔离、协议适配和安全治理，不在 .NET 进程内训练或维护 OCR 模型。默认提供方为独立部署的 PaddleX OCR 服务；业务代码只能调用 `IMicroiOcr`、`V8.OCR` 或官方 Managed 接口 `/apiengine/platform-ocr-recognize`，不得直接读取 SaaS 密钥并自行拼接 HTTP 请求。
+
+同步识别必须绑定当前请求和当前租户。批量、超大文件或长耗时 OCR 应进入共享数据库/MQ/outbox，以全局任务 Id 做幂等；不得把任务状态、队列或锁只放在单机内存中。
+
+## SaaS 配置
+
+配置位于 `sys_osclients` 的独立“OCR识别”Tab：
+
+| 字段 | 用途 | 默认值 |
+|---|---|---|
+| `OcrEnabled` | 租户总开关，默认关闭 | `0` |
+| `OcrProvider` | `PaddleX` 或 `PaddleXHighStability` | `PaddleX` |
+| `OcrEndpoint` | OCR 服务完整接口地址 | 空 |
+| `OcrApiKey` | 可选 Bearer 密钥，只允许后端使用 | 空 |
+| `OcrHeadersJson` | 可选服务端固定请求头 JSON | 空 |
+| `OcrTimeoutSeconds` | 单次超时秒数 | `60` |
+| `OcrMaxFileMB` | 单文件大小上限 | `20` |
+| `OcrMaxPages` | PDF 页数上限 | `10` |
+| `OcrMinConfidence` | 返回文本最低置信度 | `0` |
+
+这些配置不得投影到 `V8.OsClientModel`，不得由前端请求覆盖，不得写入普通日志。没有启用、没有 endpoint 或配置无效时必须失败关闭。
+
+## 调用
+
+接口引擎或后端表单事件中：
+
+```js
+var result = await V8.OCR.Recognize({
+  FileByteBase64: V8.FilesByteBase64.invoice,
+  FileName: 'invoice.png',
+  UseDocOrientationClassify: true,
+  UseDocUnwarping: true,
+  UseTextlineOrientation: true,
+  TextRecScoreThresh: 0.5,
+  ReturnWordBox: false
+});
+
+if (result.Code !== 1) {
+  return result;
+}
+
+return {
+  Code: 1,
+  Data: {
+    Text: result.Data.Text,
+    Pages: result.Data.Pages,
+    Provider: result.Data.Provider
+  }
+};
+```
+
+已登录客户端调用 `POST /apiengine/platform-ocr-recognize`，请求体与 `V8.OCR.Recognize` 一致，并携带正常登录 Token。`OsClient` 以 Token 解析结果为准。该接口由官方应用以 `Managed` 策略恢复；个性化逻辑只能写入租户 `platform-runtime-custom-hook`，且官方接口不会把文件 Base64、识别原文或密钥传给 Hook。
+
+标准成功结果包含 `Provider`、`Text`、`Pages`、`ElapsedMilliseconds`。每页包含 `PageIndex`、`Text`、`Regions`，每个区域包含 `Text`、`Confidence` 和归一化后的 `Polygon`。
+
+## 协议与输入边界
+
+- `PaddleX` 使用基础服务协议 `POST /ocr`。
+- `PaddleXHighStability` 使用 KServe 协议 `POST /v2/models/ocr/infer`。
+- 接受 PDF、PNG、JPEG、BMP、GIF、TIFF、WebP；同时检查文件扩展名、Base64 和文件魔数。
+- 固定 `visualize=false`，避免服务返回大体积可视化图片。
+- 由服务端限制文件大小、超时、PDF 页数、响应体大小和最低置信度。
+- 禁止接受调用方传入 endpoint、API key、任意请求头、代理地址或本地文件路径，防止 SSRF 和密钥绕过。
+- 日志只记录租户、提供方、状态码、耗时和安全裁剪后的错误，不记录文件 Base64、识别原文、API key 或完整响应。
+
+## Docker 与多节点
+
+- OCR 模型服务独立部署，固定 PaddleX/PaddlePaddle/模型版本；不要使用浮动 `latest` 直接上线。
+- CPU 基线位于 `../../Microi.Server/Microi.OCR/deploy/paddlex/`，固定 PaddleX 3.6.1 与 PaddlePaddle 3.2.2；公开镜像固定为 `registry.cn-hangzhou.aliyuncs.com/microios/paddlex-ocr:3.6.1-paddle3.2.2-cpu`，当前只交付 `linux/amd64`。PaddlePaddle 3.3.0 存在 CPU oneDNN PIR 推理兼容问题，在完成真实图片回归前不得升级。
+- 发布镜像使用同目录 `publish-image.ps1`：它从根目录发布配置读取凭据，通过隔离 Docker 配置和 `--password-stdin` 登录，推送后退出并匿名回读公开摘要。不得在命令行、日志或文档中展开用户名/密码，也不得只凭 `docker push` 返回成功就宣布国内镜像可用。
+- 发布镜像时执行 `create_pipeline("OCR")` 预置默认产线模型。运行时使用 named volume 挂载 `/home/microi/.paddlex`，让 Docker 首次创建卷时从镜像复制模型；不要改成空宿主机 bind mount，否则会遮住镜像内的预置模型并触发重新下载。
+- OCR 宿主机端口只绑定 `127.0.0.1`；Docker 化 API 与 OCR 同时加入 external bridge 网络 `microi-ocr`，一键安装的内部 endpoint 固定为 `http://microi-install-ocr:8080/ocr`。不得通过公网/LAN 回环调用同机 OCR。
+- `install-microi.sh` 默认尝试安装 OCR，但先部署 API/Web 并通过 liveness、完整 `ServerVersion` 升级链和 readiness。随后必须依次满足“固定镜像拉取并回读为 amd64 → OCR healthy → Upgrade29 的 9 个物理字段数据库回读 → 唯一活动主租户 → 配置写入后回读 → API 重启 readiness”才设置 `OcrEnabled=1`；任一步失败都保持 OCR 能力关闭并记录警告，但不得中断已经可用的核心平台。字段每秒回读一次且最多 15 秒；正常升级应首轮命中，镜像过旧或迁移失败应快速关闭 OCR，禁止无意义等待 5 分钟。不要用安装脚本直接伪造 `diy_field` 元数据绕过 Upgrade29。
+- API/Web 官方浮动 `latest` 必须在 Compose 启动时强制回源拉取，避免旧本机镜像缺少 Upgrade29。核心门禁失败时输出“安装未完成”恢复汇总并保留非零退出码；OCR 字段、服务或配置门禁失败时，成功汇总明确显示“OCR SaaS 未启用”和附加能力警告。两种汇总都不是启用 OCR 的依据。
+- OCR 使用固定不可变版本，不加入只跟踪 API/Web 浮动标签的 Watchtower 自动更新列表；升级镜像时先发布新 tag、匿名回读 digest/架构，再修改 Compose 与安装器。
+- 登录国内镜像源必须从本机发布配置读取凭据并走 `docker login --password-stdin`，不得输出密码。推送成功不是发布验收，必须使用隔离的匿名 Docker config 回读 manifest/digest，必要时再做匿名拉取。
+- 不要在内存不足的共享开发机上直接构建模型镜像。构建前检查物理内存、Docker 占用与同类进程；保留至少 `max(6 GB, 物理内存 20%)`，不足时延后构建而不是停止他人服务。
+- API 多节点共享同一个或同一组 OCR endpoint；每节点仅保留无状态 `HttpClient`。
+- OCR 服务至少配置 readiness、并发上限、CPU/GPU 资源上限、请求体上限和访问控制。
+- GPU 推理采用独立 Worker/服务池，避免 OCR 模型抢占 Microi API 内存。
+- 滚动升级时保持旧新 OCR 响应协议兼容；协议变更先扩展解析器，再升级服务。
+
+## 验收门禁
+
+交付时分别报告：
+
+1. 源码：网关、V8、REST、SaaS 字段、密钥投影隔离是否齐全。
+2. 定向测试：基础协议、高稳定协议、低置信度过滤、错误响应、配置隔离。
+3. 数据库：目标 `OsClient` 的 Tab、字段和物理列经 MCP 写后回读。
+4. 服务：真实 PNG/JPEG/PDF 至少各一例，包含中英文、旋转和多页场景。
+5. 多节点：两个 API 节点同时调用，同租户限制一致，服务故障时均能超时/降级且不泄漏密钥。
+6. UI：SaaS 配置表单能查看独立 Tab、保存配置，密码字段不出现在普通前端上下文。
+
+没有真实 OCR endpoint、服务版本和样例识别结果时，只能声明“平台接入完成、运行验收待配置”，不能声明生产 OCR 已可用。

package/skills/page-engine/references/progressive-01-/346/211/200/346/234/211/347/273/204/344/273/266/347/261/273/345/236/213.md

@@ -1,8 +1,8 @@
-# page-engine 详细参考 1
-
-> 按需读取；本文件由 SKILL.md 的原章节无损拆分。
-
-<!-- microi-progressive:chunk id=page-engine-008 sha256=d3bd322f076bb16a6575e9d9a5b487a9b4fcf98189b163b6608937f4f7615beb -->
+# page-engine 详细参考 1
+
+> 按需读取；本文件由 SKILL.md 的原章节无损拆分。
+
+<!-- microi-progressive:chunk id=page-engine-008 sha256=d3bd322f076bb16a6575e9d9a5b487a9b4fcf98189b163b6608937f4f7615beb -->
 ## 所有组件类型
 
 ### statistic — 统计面板
@@ -123,8 +123,8 @@
 
 首页编排可以组合 `aiengine`、`workcenter`、`diycalendar`、`diytable` 和一个占大区域的 `pageengine`。公告应优先通过绑定 `diy_notice` 的 `diytable` 渲染，使增删改权限继续由 `sys_menu + _RoleLimits` 控制；统计子页面由客户独立替换时，只需修改被嵌入的 `mic_page`，无需重做首页布局。
 
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=page-engine-009 sha256=81364ae7567d4eeb5a2543d8e3f89ef752e34dfa829a6a53625486cd6458ffdb -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=page-engine-009 sha256=81364ae7567d4eeb5a2543d8e3f89ef752e34dfa829a6a53625486cd6458ffdb -->
 ## Office/PDF 在线预览自然语言生成规则
 
 当用户用自然语言要求“界面引擎预览 PDF/Word/Excel/PPT”“接口引擎返回 PDF 文件”“打开时跳到第 N 页”“按角色显示不同页码”“每 5 秒/10 秒轮询，但只有文件变化才刷新”时，优先生成 `office` 组件，而不是 `iframe/html/browser` 拼接。
@@ -195,8 +195,8 @@ return { Code: 1, Data: { NotModified: true, FileKey: currentFileKey } };
 
 生成示例接口时必须写清楚中文注释：每个参数的含义、Redis/缓存 Key 的作用、什么情况下返回 `NeedRefresh:false`、什么情况下返回新的 `FileByteBase64/FileUrl` 和 `PageNumber`。
 
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=page-engine-010 sha256=98256e1f8068f29e3e7cb2096fb8290966a58d47390371bec965001a9e706ddd -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=page-engine-010 sha256=98256e1f8068f29e3e7cb2096fb8290966a58d47390371bec965001a9e706ddd -->
 ## searchData 查询条件通用结构
 
 ```json
@@ -231,4 +231,4 @@ return { Code: 1, Data: { NotModified: true, FileKey: currentFileKey } };
 - 交付类首页如果使用一个远程 `html` 组件承载整页驾驶舱，运行态应由外层框架滚动，不要给容器和组件写死 1000px 这类固定高度。页面 JSON 可将 `wrapperOption.height` 与 `widgetOption.height` 设为 `0`（或运行态支持的 `auto`），前端运行态必须按内容自适应高度；设计器模式再使用可编辑的默认高度。
 - 首页写入口径说明时，必须区分“用户口头期望数量”“原始资料条目数量”“按业务主体合并后的数量”“后台项目/规则/别名数量”。不要只显示一个“未交付 N 个”，应同时列出部分交付、待执行、阻塞/需业务人员配合的清单和原因。
 
-<!-- /microi-progressive:chunk -->
+<!-- /microi-progressive:chunk -->

package/skills/page-engine/references/progressive-02-/347/211/210/346/234/254/345/216/206/345/217/262-/345/271/266/345/217/221/344/277/235/345/255/230/344/270/216/345/233/236/346/273/232.md

@@ -1,8 +1,8 @@
-# page-engine 详细参考 2
-
-> 按需读取；本文件由 SKILL.md 的原章节无损拆分。
-
-<!-- microi-progressive:chunk id=page-engine-011 sha256=44c991a664b2379ed0d88b8f307e8cfbff27e4c349270cd9872f856f0d0b570b -->
+# page-engine 详细参考 2
+
+> 按需读取；本文件由 SKILL.md 的原章节无损拆分。
+
+<!-- microi-progressive:chunk id=page-engine-011 sha256=44c991a664b2379ed0d88b8f307e8cfbff27e4c349270cd9872f856f0d0b570b -->
 ## 版本历史、并发保存与回滚
 
 修改现有页面时必须先读取页面详情中的 `CurrentHash`，保存时把它作为 `expectedHash` 传入，并填写简短 `changeSummary`。不要仅凭本地旧 JSON 覆盖远端页面。
@@ -21,8 +21,8 @@
 - 写后必须再次读取页面详情和历史，确认 `CurrentHash`、版本号、变更摘要和 JSON 一致。
 - 页面历史属于当前租户数据库；不要假定业务表有物理 `OsClient` 列。
 
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=page-engine-012 sha256=61a83f536eede477a85d7d49cadf516e705d7d67510c189f9fb6ab0e72ba63db -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=page-engine-012 sha256=61a83f536eede477a85d7d49cadf516e705d7d67510c189f9fb6ab0e72ba63db -->
 ## 本地撤销、Vue 源码桥与资产包
 
 - 设计器本地历史最多 50 步、总计最多 20MB；连续编辑允许合并，但保存前必须刷新当前 `CurrentHash`。
@@ -35,8 +35,8 @@
 - 资产依赖必须检查缺失、语义版本范围、循环和最大深度；运行时使用 `mci-asset-resolve` 返回的 `LoadOrder`。
 - 复杂页面需要完整工程能力时提升为前端微服务；不要承诺任意 Vue 源码无损反编译回界面引擎。
 
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=page-engine-013 sha256=b7b520f7d38872b7c5f3972548eb87586798bbc6dba11c6035a6d512c85be22f -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=page-engine-013 sha256=b7b520f7d38872b7c5f3972548eb87586798bbc6dba11c6035a6d512c85be22f -->
 ## 生成 JSON 注意事项
 
 1. **编号唯一**：`wrapperOption.number` 和 `widgetOption.number` 页面内唯一（随机5位整数）
@@ -47,8 +47,8 @@
 6. **数据来源**：接口引擎 value 使用稳定路径 `$ApiBase$/apiengine/{Key}`，由运行时通过 `osclient` Header 传入 `$OsClient$`；只有无法设置 Header/Form/Query 的 GET/HEAD 或第三方回调才使用特殊租户路径
 7. **formConfig 完整**：所有字段都应包含，不能省略
 8. **选项卡容器**：组件放在 `tabWidgetMap[tabKey][]` 中，不放在 `widgetList` 中
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=page-engine-014 sha256=18fecb3e402daeb1f95e8f501c4456455a4c1a3b9de83208d03676f5cbf1cf84 -->
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=page-engine-014 sha256=18fecb3e402daeb1f95e8f501c4456455a4c1a3b9de83208d03676f5cbf1cf84 -->
 ## 经营看板周期筛选与布局规则
 
 - 老板驾驶舱、经营看板、CRM/订单/售后统计页面，所有统计类组件默认都要提供统一周期筛选：本日、本周、本月、本季、本年、去年，以及“更多”里的自定义时间范围和业务条件。
@@ -57,4 +57,4 @@
 - 有远程数据源的图表/表格/统计组件，点击周期按钮必须真实触发接口请求，并把 `period`、`_period`、`startDate`、`endDate` 等查询条件传给接口。接口返回数据时不要清空组件已有的 `searchData`，除非明确返回新的完整筛选配置。
 - 接口返回的指标名、图例名、表格列名禁止固定写成“月新增客户、月订单金额”等，必须根据最终生效周期输出“本日/本周/本月/本季/本年/去年/自定义”或保持中性名称；否则切换周期后文案会和数据口径冲突。
 - `/mic/autopage/:Id` 面向最终用户运行态展示，应渲染 `formRenderer`；设计器入口才渲染 `formDesigner`，避免导航、组件面板、引导遮罩干扰看板访问和自动化截图。
-<!-- /microi-progressive:chunk -->
+<!-- /microi-progressive:chunk -->