@microi.net/cli 5.5.9 → 5.6.1

package/skills/v8-explorer-tree/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: v8-explorer-tree
-description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎 / 字段V8事件 / 模块引擎按钮）。覆盖 diy_table V8 事件、diy_field V8 事件、sys_menu 按钮 JSON 拆分回写，含 7 条安全不变量。用于实现 VSCode V8 事件树、重构目录布局或处理 sys_menu 按钮 JSON 序列化。
+description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎 / 字段V8事件 / 模块引擎按钮）。覆盖 diy_table V8 事件、diy_field V8 事件、sys_menu 按钮 JSON 拆分回写，含 7 条安全不变量。用于实现 VSCode V8 事件树、重构目录布局或处理 sys_menu 按钮 JSON 序列化。
 ---
 
 > **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
@@ -26,16 +26,16 @@ description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎
 | 按钮显隐 | `<按钮Name>_显隐判断（<按钮Id>）` | `指派_显隐判断（01K3X...）.js` |
 | 按钮分类目录 | `<按钮类型中文>（<EnglishField>）` | `[行]更多按钮（MoreBtns）/` |
 
-### 0.1 7 类表单 V8 事件中文名（以 `diy_table` 对应 `diy_field.Label` 为准）
+### 0.1 7 类表单 V8 事件中文名（以 `diy_table` 对应 `diy_field.Label` 为准）
 
 | EventType | 中文名 |
 |-----------|--------|
 | InFormV8 | 前端表单进入V8事件 |
-| SubmitFormV8 | 前端表单提交前V8事件 |
-| SubmitBeforeServerV8 | 后端表单提交前V8事件 |
-| SubmitAfterServerV8 | 后端表单提交后V8事件 |
-| ServerDataV8 | 后端数据处理V8事件 |
-| OutFormV8 | 前端表单提交后V8事件 |
+| SubmitFormV8 | 前端表单提交前V8事件 |
+| SubmitBeforeServerV8 | 后端表单提交前V8事件 |
+| SubmitAfterServerV8 | 后端表单提交后V8事件 |
+| ServerDataV8 | 后端数据处理V8事件 |
+| OutFormV8 | 前端表单提交后V8事件 |
 | DataFilterV8 | 后端数据过滤V8事件 |
 
 > 统一用“后端”，不要再生成“服务端”或“服务器端”可见目录/文件名。
@@ -83,27 +83,27 @@ description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎
 ├── 表单引擎/
 │   └── <表Label>（<表Name>）/
 │       ├── 表单V8事件/
-│       │   ├── 前端表单进入V8事件（InFormV8）.js              // 仅远端非空代码生成文件
-│       │   ├── 前端表单提交前V8事件（SubmitFormV8）.js
-│       │   ├── 后端表单提交前V8事件（SubmitBeforeServerV8）.js
-│       │   ├── 后端表单提交后V8事件（SubmitAfterServerV8）.js
-│       │   ├── 后端数据处理V8事件（ServerDataV8）.js
-│       │   ├── 前端表单提交后V8事件（OutFormV8）.js
+│       │   ├── 前端表单进入V8事件（InFormV8）.js              // 仅远端非空代码生成文件
+│       │   ├── 前端表单提交前V8事件（SubmitFormV8）.js
+│       │   ├── 后端表单提交前V8事件（SubmitBeforeServerV8）.js
+│       │   ├── 后端表单提交后V8事件（SubmitAfterServerV8）.js
+│       │   ├── 后端数据处理V8事件（ServerDataV8）.js
+│       │   ├── 前端表单提交后V8事件（OutFormV8）.js
 │       │   └── 后端数据过滤V8事件（DataFilterV8）.js
 │       └── 字段V8事件/
 │           └── <字段Label>（<字段Name>）/
-│               ├── 值变更V8事件（V8Code）.js                   // 右键单表拉取后生成，仅远端非空代码生成文件
+│               ├── 值变更V8事件（V8Code）.js                   // 右键单表拉取后生成，仅远端非空代码生成文件
 │               ├── 键盘V8事件（KeyupV8Code）.js
 │               ├── 模板V8引擎（表格）（V8TmpEngineTable）.js
 │               └── 模板V8引擎（表单）（V8TmpEngineForm）.js
 │
 └── 模块引擎/
     └── <父菜单Name>（<ParentMenuId>）/                     // 非叶子模块只显示子模块，不生成按钮目录
-        └── <叶子菜单Name>（<LeafMenuId>）/
-            ├── Join关联（SqlJoin）.js                       // 始终生成，直接映射 sys_menu.SqlJoin
-            ├── Where条件（SqlWhere）.js                    // 始终生成，直接映射 sys_menu.SqlWhere
-            ├── 页面多Tab（PageTabs）/                     // 叶子模块固定生成全部 6 个按钮目录，即使为空
-            │   ├── <按钮Name>（<按钮Id>）.js              // V8Code，仅远端非空代码生成文件
+        └── <叶子菜单Name>（<LeafMenuId>）/
+            ├── Join关联（SqlJoin）.js                       // 始终生成，直接映射 sys_menu.SqlJoin
+            ├── Where条件（SqlWhere）.js                    // 始终生成，直接映射 sys_menu.SqlWhere
+            ├── 页面多Tab（PageTabs）/                     // 叶子模块固定生成全部 6 个按钮目录，即使为空
+            │   ├── <按钮Name>（<按钮Id>）.js              // V8Code，仅远端非空代码生成文件
             │   └── <按钮Name>_显隐判断（<按钮Id>）.js     // V8CodeShow，仅在非空时生成
             ├── [页面]更多按钮（PageBtns）/
             ├── [行]更多按钮（MoreBtns）/
@@ -112,15 +112,15 @@ description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎
             └── [导出]更多按钮（ExportMoreBtns）/
 ```
 
-### 2.1 ⚠️ 空代码不落文件规则（关键约束）
+### 2.1 ⚠️ 空代码不落文件规则（关键约束）
 
 > **前端 V8 引擎**只要事件 / 按钮代码字符串非空（哪怕只有注释、空格），就会调用 Jint 解析并执行——产生不必要的 CPU 开销。
 >
-> 因此：拉取远端资源时，空 V8 代码**不要生成本地 `.js` 文件**。若历史同步留下空 `.js` 文件，且远端代码同样为空，应删除本地空文件，避免被“查看同步状态”误判为本地未推送。
->
-> 用户需要清空远端代码时，可以把已有非空文件清空并推送；推送成功后插件应删除该本地空文件或对齐为“无本地文件”状态。
->
-> 例外：`SqlJoin`、`SqlWhere` 是模块查询配置，不是按钮 V8 事件。叶子模块必须始终生成两个平级文件，空文件表示远端字段为空，并允许通过推送空文件清空对应字段。
+> 因此：拉取远端资源时，空 V8 代码**不要生成本地 `.js` 文件**。若历史同步留下空 `.js` 文件，且远端代码同样为空，应删除本地空文件，避免被“查看同步状态”误判为本地未推送。
+>
+> 用户需要清空远端代码时，可以把已有非空文件清空并推送；推送成功后插件应删除该本地空文件或对齐为“无本地文件”状态。
+>
+> 例外：`SqlJoin`、`SqlWhere` 是模块查询配置，不是按钮 V8 事件。叶子模块必须始终生成两个平级文件，空文件表示远端字段为空，并允许通过推送空文件清空对应字段。
 
 ---
 
@@ -129,10 +129,10 @@ description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎
 ### 3.1 表单 V8 事件（✅ 已实现 2026-05）
 
 - **拉取**：复用 `GetV8EventList`。对每个返回项：
-  1. 每张表固定生成表单 V8 事件目录
-  2. 仅远端非空代码生成 `.js`；空代码不生成文件，历史空文件应删除
+  1. 每张表固定生成表单 V8 事件目录
+  2. 仅远端非空代码生成 `.js`；空代码不生成文件，历史空文件应删除
 - **保存**：`parseEventFilePath` 解析新旧两种结构，调 `UpdateV8EventCode`
-- **删除**：用户删除本地文件默认只删除本地文件，不自动清空远端；清空远端必须通过清空已有文件内容并执行推送，或使用明确的“清空远端代码”命令
+- **删除**：用户删除本地文件默认只删除本地文件，不自动清空远端；清空远端必须通过清空已有文件内容并执行推送，或使用明确的“清空远端代码”命令
 
 ### 3.2 字段 V8 事件（✅ 已实现 2026-05）
 
@@ -147,16 +147,16 @@ description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎
 
 ### 3.3 sys_menu 按钮 JSON 拆分（✅ 已实现 2026-05）
 
-**接口**：
-- `GET /api/V8Debug/GetModule?osClient&moduleId` — 返回菜单详情，包含 6 类按钮 JSON 以及 `SqlJoin/SqlWhere`
-- `POST /api/V8Debug/UpdateModule` — Body 含 `OsClient/ModuleId` 以及目标按钮字段或 `SqlJoin/SqlWhere`
+**接口**：
+- `GET /api/V8Debug/GetModule?osClient&moduleId` — 返回菜单详情，包含 6 类按钮 JSON 以及 `SqlJoin/SqlWhere`
+- `POST /api/V8Debug/UpdateModule` — Body 含 `OsClient/ModuleId` 以及目标按钮字段或 `SqlJoin/SqlWhere`
 
 **拉取**：
 1. 解析 `PageTabs/PageBtns/MoreBtns/FormBtns/BatchSelectMoreBtns/ExportMoreBtns` 6 个 JSON 数组（非法 JSON 记录错误并跳过该字段）
 2. 按 `ParentId` 生成与 `sys_menu/GetSysMenuStep` 一致的模块树；非叶子模块只生成子模块目录，不生成按钮目录
-3. 叶子模块固定生成全部 6 个按钮分类目录，并直接生成 `Join关联（SqlJoin）.js`、`Where条件（SqlWhere）.js`；两个配置文件即使远端为空也必须生成
-4. 对每个按钮：
-  - 仅在 `V8Code` 非空时生成 `<按钮Name>（<按钮Id>）.js`
+3. 叶子模块固定生成全部 6 个按钮分类目录，并直接生成 `Join关联（SqlJoin）.js`、`Where条件（SqlWhere）.js`；两个配置文件即使远端为空也必须生成
+4. 对每个按钮：
+  - 仅在 `V8Code` 非空时生成 `<按钮Name>（<按钮Id>）.js`
   - 若 `V8CodeShow` 非空 → 生成 `<按钮Name>_显隐判断（<按钮Id>）.js`
   - 在空按钮目录中新建 `<按钮Name>（<按钮Id>）.js` 并推送时，可按文件名创建远端新按钮
 5. `.microi-meta.json` 写入按钮 JSON hash；回写前写 `.backups/<moduleId>/<ButtonField>-<timestamp>.json`
@@ -167,11 +167,11 @@ description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎
 3. JSON 解析失败立即中止
 4. **Id-Diff 合并**：只修改目标按钮的 `V8Code` 或 `V8CodeShow`，远端其它按钮全部原样保留
 5. 写一份 `.backups/<moduleId>/<ButtonField>-<timestamp>.json`（变更前的远端 JSON）
-6. 调 `UpdateModule` 整段写回；任何一步失败不写库
-
-**SqlJoin/SqlWhere 保存**：从文件路径解析 `ModuleId / SqlJoin|SqlWhere`，推送前重新 `GetModule`，备份远端原字段，`UpdateModule` 只提交目标字段；成功后必须再次 `GetModule` 回读正文完全一致，才更新 meta/mtime。空正文正常保留为空文件。
-
-**修改状态**：接口引擎、表单V8事件、字段V8事件、模块按钮、模块 SqlJoin/SqlWhere 文件都必须写入 `.microi-meta.json` 的 `updateTime/filePath`；本地 `mtime > updateTime + 1s` 时树节点显示 `已修改`，推送成功后同步更新 meta 并将文件 mtime 设置为远端更新时间以清除标记。
+6. 调 `UpdateModule` 整段写回；任何一步失败不写库
+
+**SqlJoin/SqlWhere 保存**：从文件路径解析 `ModuleId / SqlJoin|SqlWhere`，推送前重新 `GetModule`，备份远端原字段，`UpdateModule` 只提交目标字段；成功后必须再次 `GetModule` 回读正文完全一致，才更新 meta/mtime。空正文正常保留为空文件。
+
+**修改状态**：接口引擎、表单V8事件、字段V8事件、模块按钮、模块 SqlJoin/SqlWhere 文件都必须写入 `.microi-meta.json` 的 `updateTime/filePath`；本地 `mtime > updateTime + 1s` 时树节点显示 `已修改`，推送成功后同步更新 meta 并将文件 mtime 设置为远端更新时间以清除标记。
 
 **Controller OsClient 规则**：`CheckPermission()` 返回的 `token` 是 `dynamic`。调用 `V8McpLogic.ResolveOsClient` 时必须传 `(object)token`，并让 `ResolveOsClient(string osClient, object currentToken)` 返回真正的 `string`；Controller 中 OsClient 空判断用 `string.IsNullOrWhiteSpace(osClient)`，不要对 `osClient` 调 `DosIsNullOrWhiteSpace()`。
 
@@ -193,34 +193,34 @@ description: Microi.VSCode 插件 V8 资源管理器目录规范（表单引擎
 
 ## 5. 实施状态（2026-05-22）
 
-- ✅ **Stage 1 表单V8事件分层 + 中文命名 + 空代码跳过文件生成** —— 已实现
-- ✅ **Stage 2 字段V8事件** —— 已实现：右键单表拉取字段 V8 事件；空代码不生成文件；推送仅更新目标字段的目标 V8 字段
-- ✅ **Stage 3 sys_menu 按钮拆分** —— 已实现：主拉取同步模块引擎；按钮 V8Code 仅在非空时生成 `.js`；推送前重拉远端 JSON、按 ButtonId 只改目标按钮并保留其它按钮，写入前自动备份
-- ✅ **Stage 4 树形模块引擎 + 全类型修改状态** —— 已实现：模块按 ParentId 树形拉取；非叶子只显示子模块；叶子固定生成 6 个按钮目录；字段/按钮文件也显示并清除 `已修改`
-- ✅ **Stage 5 sys_menu 查询脚本本地化** —— 已实现：叶子模块固定生成 `SqlJoin/SqlWhere` 两个平级 `.js` 文件，支持备份、预检、推送、远端回读和修改状态
+- ✅ **Stage 1 表单V8事件分层 + 中文命名 + 空代码跳过文件生成** —— 已实现
+- ✅ **Stage 2 字段V8事件** —— 已实现：右键单表拉取字段 V8 事件；空代码不生成文件；推送仅更新目标字段的目标 V8 字段
+- ✅ **Stage 3 sys_menu 按钮拆分** —— 已实现：主拉取同步模块引擎；按钮 V8Code 仅在非空时生成 `.js`；推送前重拉远端 JSON、按 ButtonId 只改目标按钮并保留其它按钮，写入前自动备份
+- ✅ **Stage 4 树形模块引擎 + 全类型修改状态** —— 已实现：模块按 ParentId 树形拉取；非叶子只显示子模块；叶子固定生成 6 个按钮目录；字段/按钮文件也显示并清除 `已修改`
+- ✅ **Stage 5 sys_menu 查询脚本本地化** —— 已实现：叶子模块固定生成 `SqlJoin/SqlWhere` 两个平级 `.js` 文件，支持备份、预检、推送、远端回读和修改状态
 
 ---
 
 ## 6. 实施约束总结
 
 - **不要**在没看过 §4 全部 7 条不变量就动手实现 Stage 3
-- **不要**为远端空 V8 事件/按钮代码生成 `.js` 文件；`SqlJoin/SqlWhere` 属于查询配置，必须保留空文件
-- **不要**用半角括号；统一用全角 `（）`
-- **不要**清空 V8事件/ 旧目录；保留兼容直到用户主动删除
-- 文件名中 `<英文Key>` 段必须 ASCII，避免 Windows 不可见字符
-- 远端 Key 若含 `\`、`/`、括号或 Windows 非法字符，文件名中的 Key 段必须使用可逆百分号编码；解析和推送时必须解码回原始 Key，禁止用 `_` 不可逆替换后误更新另一条远端记录。文件名还要处理控制字符、结尾空格/点和 `CON/PRN/AUX/NUL/COM1/LPT1` 等 Windows 保留名。
-- “拉取此服务器代码”必须按接口引擎、表单引擎、模块引擎、流程引擎、数据库结构分阶段执行。某一类型失败时要记录明细并继续后续类型；同一类型内单个文件写入失败也要继续下一项，禁止首个 `ENOENT` 让整个服务器只留下半套源码。
-
-## 7. AI 远端修改后的同步约束
-
-AI 使用 MCP、接口引擎、数据库脚本或平台 API 修改远端 V8 代码后，必须在任务收尾时同步本地 V8 资源树，并用“查看同步状态”或等价 dry-run 复核。
-
-- 远端写入后以远端当前生效代码为准，回写本地文件并更新/对齐 meta 与文件 mtime。
-- 覆盖范围至少包含本次 touched 的接口引擎、表单 V8 事件、字段 V8 事件、模块按钮 V8、工作流节点 V8、数据源 V8。
-- 若没有插件 API 可调用，可在 `.tmp/` 编写一次性同步脚本；脚本必须先 dry-run 输出差异数量，再 apply。
-- 收尾复核应确认 touched 范围没有 `changed/created/local-only` 差异；若存在差异，必须在最终回复中说明原因。
-- 空 V8 代码不生成本地 `.js` 文件；同步收尾时应清理历史空文件。
-- 插件“查看同步状态”不能只显示数量。若本地未推送数量大于 0，必须能列出具体资源类型、Key、名称、同步基准时间、本地修改时间和文件路径，并支持直接打开该文件。
-- 接口引擎、表单引擎、模块引擎、流程引擎四个顶层分类必须分别提供行内“查看同步状态”，分类检测只请求该类型的远端数据，禁止每次强制扫描全部引擎。表单引擎范围必须同时覆盖表单 V8 事件与字段 V8 事件，模块引擎范围必须覆盖按钮 V8 与 `SqlJoin/SqlWhere`。
-- 一次同步检测的结果必须持久保留在侧边“同步结果”树中，按双方冲突、服务器较新、本地未推送分组；用户应能连续点击不同文件查看远端/本地差异，只有主动刷新时才重新请求服务器，禁止每查看一个文件都重新执行整次检测。
-- 表单事件、字段事件、按钮事件等远端 Key 比对要做大小写兼容；当本地代码与远端代码相同但 mtime 晚于 meta 时，应自动刷新 meta/mtime，避免误报“本地未推送”。
+- **不要**为远端空 V8 事件/按钮代码生成 `.js` 文件；`SqlJoin/SqlWhere` 属于查询配置，必须保留空文件
+- **不要**用半角括号；统一用全角 `（）`
+- **不要**清空 V8事件/ 旧目录；保留兼容直到用户主动删除
+- 文件名中 `<英文Key>` 段必须 ASCII，避免 Windows 不可见字符
+- 远端 Key 若含 `\`、`/`、括号或 Windows 非法字符，文件名中的 Key 段必须使用可逆百分号编码；解析和推送时必须解码回原始 Key，禁止用 `_` 不可逆替换后误更新另一条远端记录。文件名还要处理控制字符、结尾空格/点和 `CON/PRN/AUX/NUL/COM1/LPT1` 等 Windows 保留名。
+- “拉取此服务器代码”必须按接口引擎、表单引擎、模块引擎、流程引擎、数据库结构分阶段执行。某一类型失败时要记录明细并继续后续类型；同一类型内单个文件写入失败也要继续下一项，禁止首个 `ENOENT` 让整个服务器只留下半套源码。
+
+## 7. AI 远端修改后的同步约束
+
+AI 使用 MCP、接口引擎、数据库脚本或平台 API 修改远端 V8 代码后，必须在任务收尾时同步本地 V8 资源树，并用“查看同步状态”或等价 dry-run 复核。
+
+- 远端写入后以远端当前生效代码为准，回写本地文件并更新/对齐 meta 与文件 mtime。
+- 覆盖范围至少包含本次 touched 的接口引擎、表单 V8 事件、字段 V8 事件、模块按钮 V8、工作流节点 V8、数据源 V8。
+- 若没有插件 API 可调用，可在 `.tmp/` 编写一次性同步脚本；脚本必须先 dry-run 输出差异数量，再 apply。
+- 收尾复核应确认 touched 范围没有 `changed/created/local-only` 差异；若存在差异，必须在最终回复中说明原因。
+- 空 V8 代码不生成本地 `.js` 文件；同步收尾时应清理历史空文件。
+- 插件“查看同步状态”不能只显示数量。若本地未推送数量大于 0，必须能列出具体资源类型、Key、名称、同步基准时间、本地修改时间和文件路径，并支持直接打开该文件。
+- 接口引擎、表单引擎、模块引擎、流程引擎四个顶层分类必须分别提供行内“查看同步状态”，分类检测只请求该类型的远端数据，禁止每次强制扫描全部引擎。表单引擎范围必须同时覆盖表单 V8 事件与字段 V8 事件，模块引擎范围必须覆盖按钮 V8 与 `SqlJoin/SqlWhere`。
+- 一次同步检测的结果必须持久保留在侧边“同步结果”树中，按双方冲突、服务器较新、本地未推送分组；用户应能连续点击不同文件查看远端/本地差异，只有主动刷新时才重新请求服务器，禁止每查看一个文件都重新执行整次检测。
+- 表单事件、字段事件、按钮事件等远端 Key 比对要做大小写兼容；当本地代码与远端代码相同但 mtime 晚于 meta 时，应自动刷新 meta/mtime，避免误报“本地未推送”。

package/skills/v8-export-import/references/progressive-01-excellayout-/351/253/230/347/272/247/350/207/252/347/224/261/345/270/203/345/261/200.md

@@ -3,209 +3,209 @@
 > 按需读取；本文件由 SKILL.md 的原章节无损拆分。
 
 <!-- microi-progressive:chunk id=v8-export-import-004 sha256=828669707ddc19320767ac4b787383136ec820deb6ad1dc861b42b5d39097677 -->
-## `ExcelLayout` 高级自由布局
-
-审批单、套打表、主子表、多级表头和复杂合并单元格不要硬塞入 `ExcelData + ExcelHeader`。改用 `ExcelLayout`：
-
-```javascript
-var excelResult = V8.Office.ExportExcel({
-  OsClient: V8.OsClient,
-  ExcelSheets: [{
-    SheetName: '审批单',
-    ExcelLayout: {
-      Cells: [
-        // 先给整块区域统一画细网格
-        { Range: 'A1:H10', Style: {
-          FontName: 'Microsoft YaHei', BorderStyle: 'Thin', BorderColor: '7F8C9A',
-          VerticalAlignment: 'Center', WrapText: true
-        }},
-        // 后写入的非空样式属性叠加/覆盖，可以再加标题和外框
-        { Range: 'A1:H1', Value: '盘盈亏及报废申请表', Merge: true, Style: {
-          Bold: true, FontSize: 18, HorizontalAlignment: 'Center',
-          BorderTopStyle: 'Medium', BorderTopColor: '34495E'
-        }},
-        { Range: 'A2', Value: '序号', Style: { Bold: true }},
-        { Range: 'G2', Value: '数量', Style: { Bold: true }},
-        { Range: 'H2', Value: '金额', Style: { Bold: true }},
-        { Range: 'A3', Value: 1 },
-        { Range: 'G3', Value: 2, DataType: 'Number' },
-        { Range: 'H3', Formula: 'G3*1200', Style: { NumberFormat: '#,##0.00' }},
-        { Range: 'A8:G8', Value: '合计', Merge: true, Style: { Bold: true, HorizontalAlignment: 'Right' }},
-        { Range: 'H8', Formula: 'SUM(H3:H7)', Style: { Bold: true, NumberFormat: '#,##0.00' }},
-        { Range: 'A9:D9', Value: '(1) 申请人：张三（已电子签）', Merge: true },
-        { Range: 'E9:H9', Value: '(2) 主管意见：同意（已电子签）', Merge: true }
-      ],
-      MergedRanges: [],
-      Columns: [{ Column: 'A', Width: 9 }, { Column: 'H', Width: 16 }],
-      Rows: [{ Row: 1, Height: 42 }, { Row: 2, Height: 32 }],
-      RowGroups: [{ StartRow: 3, EndRow: 7, Collapsed: false }]
-    },
-    ExcelOptions: {
-      ShowGridLines: false,
-      FreezeRows: 2,
-      FreezeColumns: 1,
-      AutoFilterRange: 'A2:H8',
-      PrintOrientation: 'Landscape',
-      PaperSize: 'A4',
-      FitToWidth: 1,
-      PrintArea: 'A1:H10',
-      ShowPageNumber: true
-    }
-  }]
-});
-```
-
-规则：
-
-- `Range` 使用 `A1` / `A1:K15`，不允许跨 Sheet 的 `Sheet1!A1`；`Value/Formula` 写入左上角，样式作用于全部单元格。
-- `Merge:true` 合并当前 `Range`；也可集中传 `MergedRanges`。不完全相同的合并区域不得重叠。
-- `DataType` 可传 `String/Number/Boolean/DateTime/Blank`，不传时按值推断；公式可带或不带 `=`。
-- `Columns` 用列字母或从 1 开始的 `Index`，支持 `Width/Hidden/AutoSize/MinWidth/MaxWidth`；`Rows.Row`、`RowGroups.StartRow/EndRow` 均从 1 开始。
-- 主表/子表使用 `RowGroups` 生成 Excel 原生展开/折叠行，不要只靠缩进文本模拟层级。
-- 先给实际数据块统一网格样式，再用小范围样式叠加标题、表头、合计和外框，可以显著减少 V8 代码重复。
-- 官方完整接口引擎 `export-excel-advanced-demo` 一次导出 5 Sheet，覆盖截图同款申请单、主子表、复杂合并表头、标准表格和边框样式库。
-- 高级布局会为覆盖区域创建真实单元格。不要对整列或百万行套样式；只配置实际使用区域，避免不必要的内存和 CPU。
-
-### 匿名下载与 OnlyOffice 在线预览配套模式
-
-响应文件接口本身可以同时作为浏览器下载地址和 OnlyOffice 文件源：
-
-- `export-excel-advanced-demo` 开启【响应文件】，返回 `FileName/ContentType/FileByteBase64`，可配置 `AllowAnonymous=1` 供客户直接下载。
-- `export-excel-advanced-demo-preview` 也开启【响应文件】和【允许匿名】，直接响应同一 `.xlsx`；它的完整 HTTP 地址可以传给 `/online-office?fileUrl=...`。V8 接口不需要先上传 HDFS，也不返回 `FileUrl/OnlineOfficePath` JSON；在线页面会调用后端安全中转，透明缓存到当前租户公有 HDFS 后再交给 OnlyOffice。
-- `fileUrl` 必须整体 URL 编码，同时传 `fileName`（或 `fileType`）让 OnlyOffice 确定类型。
-- 匿名 `fileUrl` 只能是当前平台正式 `ApiBase`，或同端口本地后端可读取的 loopback `/apiengine/...`；路径或 query 必须显式携带当前 `OsClient`，禁止接受任意外部 URL，避免 SSRF。
-- 开发环境传入 `localhost/127.0.0.1` 时，只允许当前同端口后端读取源接口。后端按 URL 与文件名的 SHA-256 使用确定性 `/{OsClient}/office-preview/...` 路径写入公有对象存储，Redis 共享缓存 10 分钟；OnlyOffice 使用公网 `FileServer` 地址。中转限制 50MB、不跟随重定向并校验 Office/PDF 文件头，禁止实现成任意 URL 代理。
-- 匿名链接只能用于可公开数据。敏感数据必须关闭匿名调用、上传私有桶，并要求登录后由 `/api/HDFS/OpenPrivateFile` 审计代理提供临时地址。
-
-配套预览接口核心写法：
-
-```javascript
-var exportResult = V8.ApiEngine.Run('export-excel-advanced-demo', {});
-if (!exportResult || exportResult.Code != 1 || !exportResult.Data || !exportResult.Data.FileByteBase64) {
-  V8.Result = exportResult && exportResult.Code != 1
-    ? exportResult
-    : { Code: 0, Msg: 'Excel 生成失败' };
-  return;
-}
-// 当前接口配置：AllowAnonymous=1、ResponseFile=1、StopHttp=0。
-V8.Result = exportResult;
-```
-
-预览 URL 形式：`/?OsClient=tenant_demo#/online-office?fileUrl=<URL编码后的接口地址>&fileName=示例.xlsx&fileType=xlsx&canEdit=0`。`canEdit` 只是编辑申请，不是授权依据；未登录时即使传 `canEdit=1` 也必须强制只读，并隐藏左侧菜单、顶部导航和页签。公网匿名文件接口应配置频率限制或让导出逻辑足够轻量，不能依赖进程内变量控制并发。
-
+## `ExcelLayout` 高级自由布局
+
+审批单、套打表、主子表、多级表头和复杂合并单元格不要硬塞入 `ExcelData + ExcelHeader`。改用 `ExcelLayout`：
+
+```javascript
+var excelResult = V8.Office.ExportExcel({
+  OsClient: V8.OsClient,
+  ExcelSheets: [{
+    SheetName: '审批单',
+    ExcelLayout: {
+      Cells: [
+        // 先给整块区域统一画细网格
+        { Range: 'A1:H10', Style: {
+          FontName: 'Microsoft YaHei', BorderStyle: 'Thin', BorderColor: '7F8C9A',
+          VerticalAlignment: 'Center', WrapText: true
+        }},
+        // 后写入的非空样式属性叠加/覆盖，可以再加标题和外框
+        { Range: 'A1:H1', Value: '盘盈亏及报废申请表', Merge: true, Style: {
+          Bold: true, FontSize: 18, HorizontalAlignment: 'Center',
+          BorderTopStyle: 'Medium', BorderTopColor: '34495E'
+        }},
+        { Range: 'A2', Value: '序号', Style: { Bold: true }},
+        { Range: 'G2', Value: '数量', Style: { Bold: true }},
+        { Range: 'H2', Value: '金额', Style: { Bold: true }},
+        { Range: 'A3', Value: 1 },
+        { Range: 'G3', Value: 2, DataType: 'Number' },
+        { Range: 'H3', Formula: 'G3*1200', Style: { NumberFormat: '#,##0.00' }},
+        { Range: 'A8:G8', Value: '合计', Merge: true, Style: { Bold: true, HorizontalAlignment: 'Right' }},
+        { Range: 'H8', Formula: 'SUM(H3:H7)', Style: { Bold: true, NumberFormat: '#,##0.00' }},
+        { Range: 'A9:D9', Value: '(1) 申请人：张三（已电子签）', Merge: true },
+        { Range: 'E9:H9', Value: '(2) 主管意见：同意（已电子签）', Merge: true }
+      ],
+      MergedRanges: [],
+      Columns: [{ Column: 'A', Width: 9 }, { Column: 'H', Width: 16 }],
+      Rows: [{ Row: 1, Height: 42 }, { Row: 2, Height: 32 }],
+      RowGroups: [{ StartRow: 3, EndRow: 7, Collapsed: false }]
+    },
+    ExcelOptions: {
+      ShowGridLines: false,
+      FreezeRows: 2,
+      FreezeColumns: 1,
+      AutoFilterRange: 'A2:H8',
+      PrintOrientation: 'Landscape',
+      PaperSize: 'A4',
+      FitToWidth: 1,
+      PrintArea: 'A1:H10',
+      ShowPageNumber: true
+    }
+  }]
+});
+```
+
+规则：
+
+- `Range` 使用 `A1` / `A1:K15`，不允许跨 Sheet 的 `Sheet1!A1`；`Value/Formula` 写入左上角，样式作用于全部单元格。
+- `Merge:true` 合并当前 `Range`；也可集中传 `MergedRanges`。不完全相同的合并区域不得重叠。
+- `DataType` 可传 `String/Number/Boolean/DateTime/Blank`，不传时按值推断；公式可带或不带 `=`。
+- `Columns` 用列字母或从 1 开始的 `Index`，支持 `Width/Hidden/AutoSize/MinWidth/MaxWidth`；`Rows.Row`、`RowGroups.StartRow/EndRow` 均从 1 开始。
+- 主表/子表使用 `RowGroups` 生成 Excel 原生展开/折叠行，不要只靠缩进文本模拟层级。
+- 先给实际数据块统一网格样式，再用小范围样式叠加标题、表头、合计和外框，可以显著减少 V8 代码重复。
+- 官方完整接口引擎 `export-excel-advanced-demo` 一次导出 5 Sheet，覆盖截图同款申请单、主子表、复杂合并表头、标准表格和边框样式库。
+- 高级布局会为覆盖区域创建真实单元格。不要对整列或百万行套样式；只配置实际使用区域，避免不必要的内存和 CPU。
+
+### 匿名下载与 OnlyOffice 在线预览配套模式
+
+响应文件接口本身可以同时作为浏览器下载地址和 OnlyOffice 文件源：
+
+- `export-excel-advanced-demo` 开启【响应文件】，返回 `FileName/ContentType/FileByteBase64`，可配置 `AllowAnonymous=1` 供客户直接下载。
+- `export-excel-advanced-demo-preview` 也开启【响应文件】和【允许匿名】，直接响应同一 `.xlsx`；它的完整 HTTP 地址可以传给 `/online-office?fileUrl=...`。V8 接口不需要先上传 HDFS，也不返回 `FileUrl/OnlineOfficePath` JSON；在线页面会调用后端安全中转，透明缓存到当前租户公有 HDFS 后再交给 OnlyOffice。
+- `fileUrl` 必须整体 URL 编码，同时传 `fileName`（或 `fileType`）让 OnlyOffice 确定类型。
+- 匿名 `fileUrl` 只能是当前平台正式 `ApiBase`，或同端口本地后端可读取的 loopback `/apiengine/...`；路径或 query 必须显式携带当前 `OsClient`，禁止接受任意外部 URL，避免 SSRF。
+- 开发环境传入 `localhost/127.0.0.1` 时，只允许当前同端口后端读取源接口。后端按 URL 与文件名的 SHA-256 使用确定性 `/{OsClient}/office-preview/...` 路径写入公有对象存储，Redis 共享缓存 10 分钟；OnlyOffice 使用公网 `FileServer` 地址。中转限制 50MB、不跟随重定向并校验 Office/PDF 文件头，禁止实现成任意 URL 代理。
+- 匿名链接只能用于可公开数据。敏感数据必须关闭匿名调用、上传私有桶，并要求登录后由 `/api/HDFS/OpenPrivateFile` 审计代理提供临时地址。
+
+配套预览接口核心写法：
+
+```javascript
+var exportResult = V8.ApiEngine.Run('export-excel-advanced-demo', {});
+if (!exportResult || exportResult.Code != 1 || !exportResult.Data || !exportResult.Data.FileByteBase64) {
+  V8.Result = exportResult && exportResult.Code != 1
+    ? exportResult
+    : { Code: 0, Msg: 'Excel 生成失败' };
+  return;
+}
+// 当前接口配置：AllowAnonymous=1、ResponseFile=1、StopHttp=0。
+V8.Result = exportResult;
+```
+
+预览 URL 形式：`/?OsClient=tenant_demo#/online-office?fileUrl=<URL编码后的接口地址>&fileName=示例.xlsx&fileType=xlsx&canEdit=0`。`canEdit` 只是编辑申请，不是授权依据；未登录时即使传 `canEdit=1` 也必须强制只读，并隐藏左侧菜单、顶部导航和页签。公网匿名文件接口应配置频率限制或让导出逻辑足够轻量，不能依赖进程内变量控制并发。
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-export-import-005 sha256=401c2cd0a4b9ea45b1709d14277cf71d74ab29dcda72d404f452a0e67b56eddc -->
-## 多 Sheet Excel 导出
-
-`ExcelSheets` 中每项是一张独立工作表，可以使用 `ExcelLayout` 高级布局，也可以传 `ExcelData + ExcelHeader` 标准表格；标准表格还可传 `FormEngineKey`、查询条件等让后端自行查询。两种模式可以在同一工作簿混用。`Sheets` 是兼容别名；新代码统一使用 `ExcelSheets`。
-
-```javascript
-var excelResult = V8.Office.ExportExcel({
-  OsClient: V8.OsClient,
-  ExcelOptions: {
-    DefaultColumnWidth: 14,
-    HeaderRowHeight: 28,
-    HeaderStyle: { Bold: true, BackgroundColor: 'D9EAF7' }
-  },
-  ExcelSheets: [
-    {
-      SheetName: '订单',
-      ExcelData: orderList,
-      ExcelHeader: [
-        { Name: 'OrderNo', Label: '订单号', Component: 'Text', Width: 22 },
-        { Name: 'Amount', Label: '金额', Component: 'NumberText', Type: 'decimal', Width: 16, NumberFormat: '#,##0.00' }
-      ],
-      ExcelOptions: { FreezeHeader: true, AutoFilter: true }
-    },
-    {
-      SheetName: '客户',
-      ExcelData: customerList,
-      ExcelHeader: [
-        { Name: 'Name', Label: '客户名称', Component: 'Text', Width: 24 },
-        { Name: 'Phone', Label: '联系电话', Component: 'Text', Width: 18 }
-      ],
-      ExcelOptions: { DataRowHeight: 22 }
-    }
-  ]
-});
-if (excelResult.Code !== 1) return excelResult;
-
-return {
-  Code: 1,
-  Data: {
-    FileName: '业务数据.xlsx',
-    ContentType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
-    FileByteBase64: System.Convert.ToBase64String(excelResult.Data)
-  }
-};
-```
-
-`SheetName` 会自动处理 Excel 非法字符、31 字符上限和重名。未传 `ExcelHeader` 时，可以在每个 Sheet 中传 `TableId`、`FormEngineKey`、`_Where`、`_OrderBy`、`_PageSize` 等查询参数，并继承外层的 `OsClient`、`TableId`、`_SysMenuId` 等默认值。外层 `ExcelOptions` 也是所有 Sheet 的默认值；Sheet 内的 `ExcelOptions` 只覆盖已传属性。
-
-图片列：`ImgUpload.Multiple=1` 会按最大图片数展开为多列并合并表头；列上的 `Width` 会应用到每个展开列，`DataRowHeight/RowHeight` 控制图片行高。自动列宽会遍历单元格，大批量导出不要对所有列盲目开启。
-
+## 多 Sheet Excel 导出
+
+`ExcelSheets` 中每项是一张独立工作表，可以使用 `ExcelLayout` 高级布局，也可以传 `ExcelData + ExcelHeader` 标准表格；标准表格还可传 `FormEngineKey`、查询条件等让后端自行查询。两种模式可以在同一工作簿混用。`Sheets` 是兼容别名；新代码统一使用 `ExcelSheets`。
+
+```javascript
+var excelResult = V8.Office.ExportExcel({
+  OsClient: V8.OsClient,
+  ExcelOptions: {
+    DefaultColumnWidth: 14,
+    HeaderRowHeight: 28,
+    HeaderStyle: { Bold: true, BackgroundColor: 'D9EAF7' }
+  },
+  ExcelSheets: [
+    {
+      SheetName: '订单',
+      ExcelData: orderList,
+      ExcelHeader: [
+        { Name: 'OrderNo', Label: '订单号', Component: 'Text', Width: 22 },
+        { Name: 'Amount', Label: '金额', Component: 'NumberText', Type: 'decimal', Width: 16, NumberFormat: '#,##0.00' }
+      ],
+      ExcelOptions: { FreezeHeader: true, AutoFilter: true }
+    },
+    {
+      SheetName: '客户',
+      ExcelData: customerList,
+      ExcelHeader: [
+        { Name: 'Name', Label: '客户名称', Component: 'Text', Width: 24 },
+        { Name: 'Phone', Label: '联系电话', Component: 'Text', Width: 18 }
+      ],
+      ExcelOptions: { DataRowHeight: 22 }
+    }
+  ]
+});
+if (excelResult.Code !== 1) return excelResult;
+
+return {
+  Code: 1,
+  Data: {
+    FileName: '业务数据.xlsx',
+    ContentType: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    FileByteBase64: System.Convert.ToBase64String(excelResult.Data)
+  }
+};
+```
+
+`SheetName` 会自动处理 Excel 非法字符、31 字符上限和重名。未传 `ExcelHeader` 时，可以在每个 Sheet 中传 `TableId`、`FormEngineKey`、`_Where`、`_OrderBy`、`_PageSize` 等查询参数，并继承外层的 `OsClient`、`TableId`、`_SysMenuId` 等默认值。外层 `ExcelOptions` 也是所有 Sheet 的默认值；Sheet 内的 `ExcelOptions` 只覆盖已传属性。
+
+图片列：`ImgUpload.Multiple=1` 会按最大图片数展开为多列并合并表头；列上的 `Width` 会应用到每个展开列，`DataRowHeight/RowHeight` 控制图片行高。自动列宽会遍历单元格，大批量导出不要对所有列盲目开启。
+
 <!-- /microi-progressive:chunk -->
 <!-- microi-progressive:chunk id=v8-export-import-006 sha256=1a74f8359e67ca4b270de414000f8416a7564c1595189c091281d0fea6dd4a45 -->
-## Word 导出
-
-新代码使用对象参数的 `ExportWord`；`ExportWordText` 继续保留，只用于兼容旧版纯文本场景。Word 的页面边距、图片宽高单位为厘米，字体大小单位为磅。
-
-```javascript
-var wordResult = V8.Office.ExportWord({
-  Title: '月度经营报告',
-  Subtitle: DateNow('yyyy年MM月'),
-  Author: V8.CurrentUser.Name,
-  Subject: '经营分析',
-  Keywords: '经营,月报',
-  PageSize: 'A4',                 // A4 | Letter
-  Orientation: 'Portrait',       // Portrait | Landscape
-  MarginTop: 2.2,
-  MarginRight: 2.0,
-  MarginBottom: 2.2,
-  MarginLeft: 2.0,
-  FontFamily: 'Microsoft YaHei',
-  FontSize: 10.5,
-  TitleFontSize: 20,
-  HeaderText: '吾码经营中心',
-  FooterText: '内部资料',
-  ShowPageNumber: true,
-  Paragraphs: [
-    { Text: '本月经营情况总体稳定。', FirstLineIndent: 0.74 },
-    { Text: '以下数据未经授权不得外传。', Bold: true, FontColor: 'C00000' }
-  ],
-  Sections: [{
-    Heading: '一、核心指标',
-    HeadingLevel: 1,
-    Content: '本节展示主要经营指标。',
-    Tables: [{
-      Title: '指标明细',
-      Headers: ['指标', '本月', '同比'],
-      Rows: [['销售额', 1280000, '12.5%'], ['订单数', 860, '8.1%']],
-      ColumnWidths: [4, 4, 4],
-      HeaderBackgroundColor: 'D9EAF7'
-    }]
-  }],
-  Images: [{
-    FileByteBase64: chartBase64,  // 支持纯 Base64 或 data URI
-    FileName: 'chart.png',
-    ContentType: 'image/png',
-    Width: 15,
-    Height: 8,
-    Alignment: 'Center',
-    Caption: '图 1：趋势分析'
-  }]
-});
-if (wordResult.Code !== 1) return wordResult;
-return {
-  Code: 1,
-  Data: {
-    FileName: '月度经营报告.docx',
-    ContentType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
-    FileByteBase64: System.Convert.ToBase64String(wordResult.Data)
-  }
-};
-```
-
-段落支持 `Text/Alignment/Bold/Italic/Underline/FontFamily/FontSize/FontColor/SpacingBefore/SpacingAfter/LineSpacing/FirstLineIndent/PageBreakBefore`。章节支持 `Heading/HeadingLevel/Content/Paragraphs/Tables/Images/PageBreakBefore`；表格支持 `Headers/Rows/ColumnWidths/Alignment/HeaderBold/HeaderBackgroundColor/HeaderFontColor/BorderColor/FontSize`。
-
+## Word 导出
+
+新代码使用对象参数的 `ExportWord`；`ExportWordText` 继续保留，只用于兼容旧版纯文本场景。Word 的页面边距、图片宽高单位为厘米，字体大小单位为磅。
+
+```javascript
+var wordResult = V8.Office.ExportWord({
+  Title: '月度经营报告',
+  Subtitle: DateNow('yyyy年MM月'),
+  Author: V8.CurrentUser.Name,
+  Subject: '经营分析',
+  Keywords: '经营,月报',
+  PageSize: 'A4',                 // A4 | Letter
+  Orientation: 'Portrait',       // Portrait | Landscape
+  MarginTop: 2.2,
+  MarginRight: 2.0,
+  MarginBottom: 2.2,
+  MarginLeft: 2.0,
+  FontFamily: 'Microsoft YaHei',
+  FontSize: 10.5,
+  TitleFontSize: 20,
+  HeaderText: '吾码经营中心',
+  FooterText: '内部资料',
+  ShowPageNumber: true,
+  Paragraphs: [
+    { Text: '本月经营情况总体稳定。', FirstLineIndent: 0.74 },
+    { Text: '以下数据未经授权不得外传。', Bold: true, FontColor: 'C00000' }
+  ],
+  Sections: [{
+    Heading: '一、核心指标',
+    HeadingLevel: 1,
+    Content: '本节展示主要经营指标。',
+    Tables: [{
+      Title: '指标明细',
+      Headers: ['指标', '本月', '同比'],
+      Rows: [['销售额', 1280000, '12.5%'], ['订单数', 860, '8.1%']],
+      ColumnWidths: [4, 4, 4],
+      HeaderBackgroundColor: 'D9EAF7'
+    }]
+  }],
+  Images: [{
+    FileByteBase64: chartBase64,  // 支持纯 Base64 或 data URI
+    FileName: 'chart.png',
+    ContentType: 'image/png',
+    Width: 15,
+    Height: 8,
+    Alignment: 'Center',
+    Caption: '图 1：趋势分析'
+  }]
+});
+if (wordResult.Code !== 1) return wordResult;
+return {
+  Code: 1,
+  Data: {
+    FileName: '月度经营报告.docx',
+    ContentType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    FileByteBase64: System.Convert.ToBase64String(wordResult.Data)
+  }
+};
+```
+
+段落支持 `Text/Alignment/Bold/Italic/Underline/FontFamily/FontSize/FontColor/SpacingBefore/SpacingAfter/LineSpacing/FirstLineIndent/PageBreakBefore`。章节支持 `Heading/HeadingLevel/Content/Paragraphs/Tables/Images/PageBreakBefore`；表格支持 `Headers/Rows/ColumnWidths/Alignment/HeaderBold/HeaderBackgroundColor/HeaderFontColor/BorderColor/FontSize`。
+
 <!-- /microi-progressive:chunk -->