weaver-e10-builder 1.7.0 → 1.7.1

package/skill-docs/SKILL.md

@@ -1,188 +1,192 @@
----
-name: weaver-e10-builder
-display_name: 泛微E10智能搭建Skill
-display_name_en: E10 Builder
-description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.7.0
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.7.0。
-description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.7.0.
-category: coding
-version: 1.7.0
-author: 泛微网络科技股份有限公司
-auto: true
----
-
-# Ebuilder 智能搭建 Skill
-
-## 使用前提
-
-- **版本必须匹配**：`e10-cli --version` 应与 frontmatter 的 `version` 一致；不一致时命令/选项/文档可能对不上。
-- **鉴权**：仅在即将远程查询或写入前运行 `e10-cli auth status`；同一连续阶段不重复检查，切换系统地址、profile 或凭证后必须重新确认。
-- **文档随 CLI 分发**：读 `references/...` 提示文件不存在时，跑 `e10-cli skill sync` 或重跑 `e10-cli auth status`。
-- 安装/升级、skill 重装、WorkBuddy 注意事项 → `references/common/guide-install.md`。
-
-## 核心理念
-
-> **默认一份完整业务方案落在一个主应用。** 需求明确指定已有应用、跨应用资源或独立业务边界时，按实际范围处理，并在 `plan.md` 中标明每项资源的所属应用和跨应用关系。
-
-```
-一份完整业务方案 → 一个主应用（默认）
- └→ 应用下的资源: 表单 → 流程 → 菜单 → 页面
-跨应用/已有应用增强 → 按实际边界规划并明确资源归属
-```
-
-接到需求不要一上来就写页面代码。先想清楚这一个应用下需要哪些表单、字段怎么设计、流程怎么走。
-
-**能力范围**：应用与资源、表单与字段、视图与按钮、流程与动作流、设计器报表、权限、页面、数据操作，以及从接口文档批量创建 ESB 系统接口。具体能力、命令与限制以本页决策树路由到的 `_catalog.md` 和 `references/` 为准；规划时应一次覆盖需求中已明确的配置项，不因主文档未枚举某条命令而遗漏。
-
----
-
-## 流程类型与默认路径
-
-默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow`；不确定且选择会改变资源归属时，先向用户确认。EB 流程与原生工作流程的表单、资源 ID、接口不可混用；公文流程是原生工作流程的特殊类型。详见 `references/workflow/guide-workflow.md`。
-
----
-
-## 执行流程
-
-面向非编程用户：主动把模糊需求翻译成精确的资源设计。
-
-0. **环境**：仅在即将远程查询/写入前跑 `e10-cli auth status`；切已有环境用 `auth profile use <name>`，新环境用 `auth set --eteamsid "<ETEAMSID>" --base-url <url>`（ETEAMSID 从浏览器 Cookies 复制，不走 `auth login`）。
-1. **判断复杂度**：涉及 2+ 模块（应用/表单/流程/页面）→ 进入规划；单步改字段、查数据 → 直接执行。
-2. **规划**（复杂需求必经）：
-   - 先写 **0.1 方案澄清与可行性预检**：需求理解、待确认项（问题/选项/建议/影响/决策）、可做/部分可做/做不到及证据等级、验收判据；按 `references/common/capability-boundaries.md` 判定，不得把「CLI 没暴露」写成「平台不支持」。
-   - 每张表单建表前确认初始布局类型 **FLOW / EXCEL**（该初始类型建后不可切换；已有表单可另建不同类型的视图布局）；出现布局样表时按 `references/form/layout/planning.md` 解析。
-   - 按 `references/common/map.md` 识别资源与依赖，按 `references/common/guide-plan-template.md` 写 `plan.md`；每条要求有归属和来源，布局样表逐行保留，禁止预勾。
-   - 写完打开 `plan.md` 与用户**一次集中确认**（此时所有 `[ ]` 保持未勾；只有新的实质业务选择才再次询问）。
-3. **执行**：最多三段，每段结束停下确认。
-   - 段① 应用、角色、表单与视图；段② 流程与自动化；段③ 报表、菜单与页面。
-   - 以 plan 为唯一清单，按功能批次执行，逐项销号并回填真实 ID；无法完成的保留 `[ ]` 并注明原因。
-   - 0.1 中 P0/阻断项未解决、或用户未确认前不进入写入；执行中出现新的实质业务选择才再次确认。
-   - 布局样表：仍由 CLI 创建字段与初始布局；明确要求还原图片/XLSX 样式时读 `references/form/layout/source-restoration.md`（先实际观察、经用户确认样式，再 compile/apply）。
-
-**关键约束**
-- 配置必须通过当前 `e10-cli` 支持的命令完成；没有对应命令就如实告知，不得写临时 `.mjs` 脚本或让用户操作浏览器代做。能力边界见 `references/common/capability-boundaries.md`；结论必须带证据等级（实测/回读字段/命令表/未证实）。
-- Windows 环境，注意命令行兼容性；少说废话，直接干活。
-- 写代码按模板直接出完整代码，写完用 `e10-cli check` 验证。
-- 解析 Word 用 `e10-cli docx read`，禁止自写 python-docx；必须逐张 Read `_images/` 图片并写回 md，布局表格保留空白、同排与合并关系。
-
----
-
-## 决策树
-
-> **根据用户需求自动加载对应子文档，不要一次性读取全部 reference。**
->
-> **动作流两种用法**：动作流「生成」一律走 native `e10-cli actionflow generate`（语义 plan → 编译 → preflight → 保存并启用 → 正式回读，event 节点自带流程节点触发绑定，**推荐**）；`e10-cli workflow action` 仅作动作流管理（`list-node`/`clear-node` 查清节点绑定、`delete`/`disable`/`batch-delete` 禁用删除动作流 app）。本表字段赋值/节点附加操作（actionType=0）用 `e10-cli workflow save-action`。
-> ```bash
-> e10-cli actionflow component-list                          # 列已登记组件
-> e10-cli actionflow component-describe <type>               # 读组件契约
-> e10-cli actionflow generate '{"planFile":"@plan.json","appName":"AI-名称"}'  # 生成+保存并启用+正式回读；planFile 必须以 @ 引用文件（@plan.json 或 @绝对路径），CLI 强制要求 @ 前缀
-> e10-cli workflow action list-node <wf> <node>             # 查节点绑定；clear-node 清；delete/disable 删动作流
-> ```
-
-| 用户关键词 | 加载文档 |
-|-----------|---------|
-| 表单布局源码、表单级 ecode、表单 JS 代码块、JSSDK、代码校验、明细代码汇总、字段事件脚本、表单组件复写 | 先读 `references/form/layout/code-block/code-block-guide.md` 选代码层级和 CLI 写入命令，再按效果读取该目录对应 JSSDK 专题；**布局源码 ecode 由 CLI 编码，不要手改 `sourceCode.ecode`；手工调接口必须用 `encodeURI`，不能用 `encodeURIComponent`（设计器用 `decodeURI` 读取）** |
-| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、**方案澄清、可行性预检、哪些做不到**、平台架构、Ecode、Ebuilder应用、默认台账与菜单 | 先读 `references/common/map.md` 识别资源、配置与依赖；做 0.1 方案澄清与可行性预检时同时读 `references/common/capability-boundaries.md`；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
-| 安装、升级、装不上、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
-| 支不支持、能不能做、能力边界、不支持的能力、**证据等级、CLI 没暴露** | `references/common/capability-boundaries.md`（结论必须带证据等级，命令表不能当平台不支持） |
-| 建应用、创建应用、app、应用列表、应用详情、应用目录、app read/list/folder/edit/delete | `references/common/ref-cli-commands.md` |
-| 启用应用、停用应用、发布到前台、发布应用、取消发布、应用发布信息、前台入口、应用名多语言、应用英文名、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md`（启用→发布→改发布信息→取消发布的先后关系 + 停用会收回发布态 + 多语言整份写回） |
-| 字段联动、字段值带出、HRM 属性带出、relateFrom、form relate、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（按来源选择直接带出、HRM 带出或跨表查询赋值；含单跳/多跳与 --hops 格式） |
-| 函数联动、本表字段间公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、触发事件、模块字段不能作目标 | `references/form/guide-formula-linkage.md`（四套联动对比 + 赋值式语法 + 触发事件表 + 模块字段 + 流程表单那条路由 + 常见报错） |
-| 鉴权、登录、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
-| 表单数据读写、formClient、list/get/save/update/remove、values/display/items、options、optionId、optionIds、optionMap、detailRows、subFormId、回读校验、字段类型 | `references/coding/guide-form-crud.md`（前端代码；一个表单一个 client） |
-| form data add、form data list、form data delete、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
-| 编辑回显、handleEdit、row.values、row.display、row.items、Browser/Upload 回填、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
-| 显示属性联动、显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
-| 新建表单、form create、EB表单创建流程、fields.json | `references/form/guide-create-form.md`；确定具体字段参数时再读 `references/form/ref-form-fields.md` |
-| 虚拟表、虚拟表单、绑定数据源、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md`；字段类型按来源映射，不按普通字段重新猜测 |
-| 表单布局、布局管理、初始化、编辑、模板、布局代码块、图片或 Excel 还原 | `references/form/layout/layout-overview.md`（先按任务选择独立能力） |
-| 明细表整体读写、明细必填行数、允许新增／复制／修改／删除明细、根据操作者过滤 | `references/form/layout/detail-settings.md`（布局容器设置，区别于子字段属性与 JSSDK） |
-| 明细合计、过滤已选数据、批量添加、合并字段、分组、操作按钮、排序、快捷搜索 | `references/form/layout/detail-advanced.md`（字段候选、码表、增量修改与关闭方式） |
-| 流程表单多套布局、节点独立布局、布局绑定和回落默认 | `references/form/layout/workflow-layout.md`（表单布局与节点引用的关系；具体节点操作继续读流程指南） |
-| Excel样式、表格式布局、布局样表、布局蓝图、标签字段交替、合并单元格 | `references/form/layout/planning.md` |
-| 完整布局 JSON、布局文档导出、整体编辑差异预览、formLayout 大范围调整 | `references/form/layout/document.md`（导出底稿、预览完整差异、单次应用并回读） |
-| 还原图片样式、还原Excel样式、XLSX布局、源网格、pageLayouts、layout extract/compile/apply/verify/style-audit、已有字段位置匹配 | `references/form/layout/source-restoration.md`（图片 imageStyles 三层投影与样式诊断；已有字段复用，纯布局编译、单次保存和独立回读） |
-| 流程、审批、workflow、提交流程、预填 | `references/workflow/guide-workflow.md` |
-| 流程绑了哪张表、流程对应表单、workflow info、从流程找表单 | 命令速查 `references/common/ref-cli-commands.md` 的 `workflow info` 一行（**流程列表接口不含这个信息**；拿到的是 formId，不是 objId） |
-| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md`（操作者和条件同时遵循流程基础指南） |
-| 公文流程、公文审批、收文、发文 | `references/workflow/guide-workflow-odoc.md`（基础节点/出口/操作者同时遵循 `guide-workflow.md`） |
-| 公文设置、正文设置、痕迹、套红、排版、文号、附件区、归档、智能助手 | `references/workflow/guide-workflow-odoc-setting.md` |
-| 流程节点、操作者、审批人、连线、添加节点、删除连线、删除节点、delete-node、节点操作者、set-operator、出口名称、link-rename、节点字段权限、field-permission、节点批量设置、批量字段权限、多节点配置、workflow node batch | `references/workflow/guide-workflow.md` |
-| 节点独立布局、节点换布局、node layout、节点用哪套布局、流程布局、流式/表格式布局、引用节点、updateQuoteNode | `references/workflow/guide-workflow-node-layout.md` |
-| 分支条件、出口条件、条件JSON、save-condition、连线条件 | `references/workflow/guide-workflow-condition.md` |
-| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、数据来源、requestId、按流程定位、回写数据ID、HTTP/HTTPS、DML/数仓、自定义事件、内置 MQ | `references/workflow/guide-workflow-action.md`（动作流生成走 `e10-cli actionflow generate`；`workflow action` 仅查/清/删/禁用；本表字段赋值走 `save-action`；复杂组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/`） |
-| 菜单、导航、左侧菜单、系统页面、待办、已办、流程监控、菜单改名、重命名菜单、菜单排序、菜单顺序、放第一个、menu order、showOrder、--first | `references/menu/system-menus.md` |
-| 新页面、导出、路由、entry.js、asyncImport、${appId} 固定写法、appId 填数字 | `references/coding/guide-page-export.md`（前端代码） |
-| 写页面、页面代码、React编码、组件、entry.js模板、formClient、字段常量 | `references/coding/guide-page-code.md`（前端代码） |
-| HTML 原型还原、HTML 转 React、原型 CSS、复用样式、不写 CSS、class/className、内联 style、浮层、Portal、CSS 作用域 | `references/coding/guide-html-to-react.md`（前端代码） |
-| CLI命令、打包、build、import、创建应用/表单/菜单 | `references/common/ref-cli-commands.md` |
-| 编译报错、语法不支持、babel | `references/coding/ref-compile-rules.md`（前端代码） |
-| Word文档、docx、需求文档、解析文档 | `e10-cli docx read` 一键转换，禁止自己写脚本 |
-| 接口文档、Postman、系统接口、批量导入接口、创建连接器接口 | `references/esb-interface/guide-import.md`；使用 `e10-cli interface import` |
-| 新建视图、表格视图、看板、日历、思维导图、form view、台账显示列、显示列、list-columns、搜索条件、排序、list-sort、上下级、父级、树形展示、上级类型、list-hierarchy、视图数据条件、list-filter、日期占位符、{date}、{curryear}、动态日期 | `references/form/guide-form-view.md` |
-| 视图权限、查看布局、修改共享权限、view permission | `references/form/guide-form-view-permission.md` |
-| EBuilder关联、关联表单、数据过滤设置、ebuilder-filter、EBuilder显示列、ebuilder-columns、去掉系统字段、只留业务字段 | `references/form/guide-ebuilder-filter.md` |
-| 浏览数据定义、浏览弹窗高级搜索、浏览 Tab、可配置浏览字段 | 先读 `references/form/guide-browser-definition.md` 确认表单级／流程级配置归属；高级搜索和 Tab 也在此说明 |
-| 浏览数据范围、人员／部门／分部可选范围、关联 EBuilder 条件、自定义浏览框条件 | 先按上条确认配置归属，再读 `references/form/guide-browser-scope.md` 的来源适配、码表与读写方式 |
-| 字段分组、分组容器、字段分段、基本信息/合同信息分段、Collapse、Fold、字段归组 | `references/form/layout/planning.md`（**按需**：用户明确要求字段分组才在 fields.json 写 `group`，默认不加分组） |
-| 独占一行、整行显示、字段换行、singleRow、--single-row | `references/form/layout/planning.md`（fields.json 字段写 `"singleRow":true`；add-field 用 `--single-row`） |
-| 布局样式模板分类、公共规则、layout init、style-template | `references/form/layout/template/template-guide.md`（简易、高级、流式分别链接） |
-| 给已有表单加字段、改必填/只读、表单不是自己建的、--reinit、布局被重建、字段在布局里对不上、字段标题显示不出来 | `references/form/layout/incremental.md`（**⚠ 不是自己建的表不要用 `--reinit`**；设必填是改布局组件，字段定义里没有 `required`） |
-| 字段类型、字段码表、日期区间、关联浏览、关联订单、关联合同、Order、Contract、字段多选、multiple、--multiple | `references/form/ref-form-fields.md` |
-| 表单复杂编号、serial-mark、流水号、年份编号、代字 | `references/form/guide-form-serial-mark.md` |
-| 函数公式、字段公式、formula、DAYS、日期差、expressId、公式绑定 | `references/form/guide-form-formula-functions.md`（219 个函数速查矩阵，写 `fields.json` 的 `formula` 或 `form formula set --expression` 时查函数格式/示例；**日期差用 `DAYS(开始,结束)`**） |
-| 显示列批量设置、批量加列、列宽、列顺序、list-columns --set | `references/form/guide-list-columns.md` |
-| 顶部统计、明细统计、付款记录数、list-stats、子表计数 | `references/form/guide-list-stats.md` |
-| 关联页签、关联视图、association、页签显示布局、关联数据筛选、set-filter | `references/form/guide-form-association.md` |
-| 表单按钮、button、自定义按钮、视图按钮、行上、行末下拉、右上、打开视图、打开布局、发起流程、按钮预填、按钮字段映射、action-set | `references/form/guide-form-button.md`；`references/common/ref-cli-commands.md` |
-| 表单消息提醒、消息提醒、表单数据提醒、数据变动提醒、新增数据提醒、form message、提醒对象、推送渠道、IM提醒、云桥、短信提醒 | `references/form/guide-form-message.md`（表单数据新建/修改/删除时提醒人；列表是应用级、`--obj-id` 本地收口；提醒对象四类写法与同名歧义处理） |
-| 角色设置、角色功能权限、角色成员、分权范围、成员有效期 | `references/hrm/guide-role.md` |
-| 流程消息、编号规则、超时处理、退回设置、指定流转、投票、机器人节点、公用流转片段、子流程、人员范围、节点菜单、流程设置、流程存档、节点校验、提交校验 | `references/common/ref-cli-commands.md` |
-| 签署顺序、会签、非会签、竞签、或签、依次处理、抄送、operator-sign | `references/workflow/guide-workflow.md`；命令速查 `references/common/ref-cli-commands.md` |
-| 分类搜索、表单权限、编译/build/compile/check、skill 文档/skill sync/copy/root、CLI 命令速查 | `references/common/ref-cli-commands.md`（分类搜索四类字段：选项 / 浏览框 / 日期 / 系统字段） |
-| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、**自定义CSS、组件样式、改样式、选择器、DOM结构、样式不生效、designer css、designer dom** | `references/ebuilder-designer/guide-designer.md`（布局层）；组件配置见 `guide-designer-components.md`，**自定义 CSS 与 DOM 结构索引见 `guide-designer-css.md`**，工厂模板见 `guide-designer-factory.md`，版本见 `guide-designer-version.md`，命令速查见 `references/common/ref-cli-commands.md`「页面 & 设计器」节 |
-| HRM、矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId | `references/hrm/guide-matrix.md` |
-| 报表、设计器报表、EDC 报表、report build、新建报表、数据集、报表列、报表查询条件、报表权限、报表快照、report | `references/report/guide-report-build.md`（建表主干）；改已有报表见 `guide-report-modify.md`，查询条件见 `guide-report-query.md`，命令速查见 `ref-report-commands.md`；踩坑先扫 `ref-report-pitfalls.md` |
-| 报表多数据源、跨数据集、跨表关联、主从报表、两个表单合成一张报表、父格筛选、subordination、leftFilterField、render 渲染回读 | `references/report/guide-report-multisource.md`（spec 写法 + 区域/入口格 + 双保存与关预聚合 + 验证） |
-| 报表单元格、父格、扩展方向、合并、冻结、隐藏行、条件格式、数据条、图标集、tableName、字段三件套 | `references/report/ref-report-pitfalls.md` + `report-data-model.md`（枚举）· `layout-showlocation-freeze-guide.md`（冻结/居左）· `hidden-row-and-header-merge-guide.md`（空白行与表头合并） |
-
-> 组件文档（Button/Table/Input/Upload 等）在 `references/` 中按文件名查找。完整索引见 `_catalog.md`。
-
-> **表单自带默认台账** — 普通列表需求先查询并复用已有默认台账，记录实际名称/listId；“客户信息表／客户信息”这类简称差异不构成新建理由，默认保留原名，不统一去掉“表”字。仅名称需对齐时应改名而非另建。用户明确要求额外表格视图时，用 `form table-view create` 原子完成 `nListView` 创建、显示列配置和回读；禁止用 `form view create --type tableView` 创建空壳。`formView` 使用 `form view create` 后必须执行 `form view populate`。
-
----
-
-## 能力边界
-
-> 不支持的能力、以及「CLI 没有命令时怎么办」的判定方式 → `references/common/capability-boundaries.md`。预检结论写进 `plan.md` 0.1，证据不足时标「待环境核查/未证实」；不得把「CLI 没暴露」写成「平台不支持」。禁止声称平台/CLI 支持实际不支持的能力，禁止用临时脚本或浏览器操作绕行。
-
----
-
-## 页面编码
-
-页面是搭建的最后一步，动手前确保应用、表单、流程已建好。默认情况优先用设计器配置式页面（`page create` → `designer comp-add --template` → 绑数据 → `designer save` → `page publish-menu`），详见 `references/ebuilder-designer/guide-designer.md`；只有设计器无法满足的深度定制才用 Ecode React。
-
-**用户明确要求 Ecode、还原 HTML 原型，或说明不要设计器时，直接走 Ecode，不要再建议改用设计器。** 编码主路径见 `references/coding/guide-page-code.md`，完整样例在 `assets/sample/`；HTML 原型还原另读 `references/coding/guide-html-to-react.md`。注意 `entry.js` 里 `asyncImport('${appId}', ...)` 的第一个参数是固定字符串，不是 Ebuilder 应用 ID 或任何数字。
-
-`page permission`：页面使用范围、禁用范围、矩阵相关权限及码表见 [页面权限指南](references/ebuilder-designer/guide-page-permission.md)。
-
-组合页面及页签目标、参数、可见/禁用范围、复制：阅读 [组合页面指南](references/ebuilder-designer/guide-page-combination.md)。
-
-普通页面设计器源码 JS/CSS、页面 SDK、页面/组件加载事件、组件实例、列表勾选和插件、图表 option、页面内表单组件：阅读 [页面源码指南](references/ebuilder-designer/page-source/page-source-guide.md)，按 [SDK 索引](references/ebuilder-designer/page-source/sdk-index.md) 查接口。使用 `designer source read/check/set/sdk`；与表单 JSSDK、组件自由 CSS、独立 ecode 工程分开。
-
-页面/组件的单击与加载完成动作配置：阅读 [事件指南](references/ebuilder-designer/events/guide-events.md)，使用 `designer event get/set/enable/remove/schema/lookup`。同一触发支持有序多动作和递归 IF/ELSEIF/ELSE 分支，使用 action/branch 按 ID 编辑；set {actions:[...]} 明确整体替换。 页面跳转、条件、组件显隐、菜单、刷新和集成动作按该入口自己的参数与码表配置。
-
-页面内单个组件的使用范围、禁用范围、矩阵或EB表单相关人员授权：阅读 [组件权限指南](references/ebuilder-designer/component-permission.md)，使用 `designer permission`。与页面整体权限、列表数据权限分别配置。
-
-移动端标签栏、TabBar、首页、默认菜单、记忆菜单、最多显示数量、菜单排序与菜单事件：阅读 [标签栏指南](references/ebuilder-designer/guide-tabbar.md)，使用 `designer tabbar` 和 `designer event --collection items`。
-
-列表显示、查询分组统计、聚合、自定义计算、数据扩展和 CLICKDATA：阅读 [列表高级配置](references/ebuilder-designer/guide-list.md)，使用 `designer list advanced`。
-
-列表固定过滤、多字段排序、普通/快捷/分类搜索、系统与自定义操作按钮：阅读 [列表搜索与按钮指南](references/ebuilder-designer/guide-list.md)，使用 `designer list controls`；按钮动作使用 `designer event --collection listButtons`。
-
-列表表头快捷操作、隐藏表头、勾选框禁用、展示分组与上下级：阅读 [列表展示指南](references/ebuilder-designer/guide-list.md)，使用 `designer list advanced presentation`。
-
-自定义页面组件、嵌入页面/链接、条件切换内容、组件显示条件、标题与刷新/全屏/帮助按钮：阅读 [自定义页面组件指南](references/ebuilder-designer/guide-custom-page.md)，使用 `designer custom-page`；帮助动作使用 `designer event --collection customPageButtons`。
-
-普通页面重命名、复制、转移、删除、页面分组及可转移应用查询：阅读 [普通页面管理](references/ebuilder-designer/guide-page-management.md)，使用 `page rename/copy/transfer/groups/transfer-targets/delete`。
+---
+name: weaver-e10-builder
+display_name: 泛微E10智能搭建Skill
+display_name_en: E10 Builder
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.7.1
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.7.1。
+description_en: E10 Ebuilder low-code app builder skill v2 (general) — helps build Weaver E10 custom apps (forms/workflows/lists/actionflows/permissions/groups/numbering) via e10-cli, currently paired with CLI 1.7.1.
+category: coding
+version: 1.7.1
+author: 泛微网络科技股份有限公司
+auto: true
+---
+
+# Ebuilder 智能搭建 Skill
+
+## 使用前提
+
+- **版本必须匹配**：`e10-cli --version` 应与 frontmatter 的 `version` 一致；不一致时命令/选项/文档可能对不上。
+- **鉴权**：仅在即将远程查询或写入前运行 `e10-cli auth status`；同一连续阶段不重复检查，切换系统地址、profile 或凭证后必须重新确认。
+- **文档随 CLI 分发**：读 `references/...` 提示文件不存在时，跑 `e10-cli skill sync` 或重跑 `e10-cli auth status`。
+- 安装/升级、skill 重装、WorkBuddy 注意事项 → `references/common/guide-install.md`。
+
+## 核心理念
+
+> **默认一份完整业务方案落在一个主应用。** 需求明确指定已有应用、跨应用资源或独立业务边界时，按实际范围处理，并在 `plan.md` 中标明每项资源的所属应用和跨应用关系。
+
+```
+一份完整业务方案 → 一个主应用（默认）
+ └→ 应用下的资源: 表单 → 流程 → 菜单 → 页面
+跨应用/已有应用增强 → 按实际边界规划并明确资源归属
+```
+
+接到需求不要一上来就写页面代码。先想清楚这一个应用下需要哪些表单、字段怎么设计、流程怎么走。
+
+**能力范围**：应用与资源、表单与字段、视图与按钮、流程与动作流、设计器报表、权限、页面、数据操作，以及从接口文档批量创建 ESB 系统接口。具体能力、命令与限制以本页决策树路由到的 `_catalog.md` 和 `references/` 为准；规划时应一次覆盖需求中已明确的配置项，不因主文档未枚举某条命令而遗漏。
+
+---
+
+## 流程类型与默认路径
+
+默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow`；不确定且选择会改变资源归属时，先向用户确认。EB 流程与原生工作流程的表单、资源 ID、接口不可混用；公文流程是原生工作流程的特殊类型。详见 `references/workflow/guide-workflow.md`。
+
+---
+
+## 执行流程
+
+面向非编程用户：主动把模糊需求翻译成精确的资源设计。
+
+0. **环境**：仅在即将远程查询/写入前跑 `e10-cli auth status`；切已有环境用 `auth profile use <name>`，新环境用 `auth set --eteamsid "<ETEAMSID>" --base-url <url>`（ETEAMSID 从浏览器 Cookies 复制，不走 `auth login`）。
+1. **判断复杂度**：涉及 2+ 模块（应用/表单/流程/页面）→ 进入规划；单步改字段、查数据 → 直接执行。
+2. **规划**（复杂需求必经）：
+   - 先写 **0.1 方案澄清与可行性预检**：需求理解、待确认项（问题/选项/建议/影响/决策）、可做/部分可做/做不到及证据等级、验收判据；按 `references/common/capability-boundaries.md` 判定，不得把「CLI 没暴露」写成「平台不支持」。
+   - 每张表单建表前确认初始布局类型 **FLOW / EXCEL**（该初始类型建后不可切换；已有表单可另建不同类型的视图布局）；出现布局样表时按 `references/form/layout/planning.md` 解析。
+   - 按 `references/common/map.md` 识别资源与依赖，按 `references/common/guide-plan-template.md` 写 `plan.md`；每条要求有归属和来源，布局样表逐行保留，禁止预勾。
+   - 写完打开 `plan.md` 与用户**一次集中确认**（此时所有 `[ ]` 保持未勾；只有新的实质业务选择才再次询问）。
+3. **执行**：最多三段，每段结束停下确认。
+   - 段① 应用、角色、表单与视图；段② 流程与自动化；段③ 报表、菜单与页面。
+   - 以 plan 为唯一清单，按功能批次执行，逐项销号并回填真实 ID；无法完成的保留 `[ ]` 并注明原因。
+   - 0.1 中 P0/阻断项未解决、或用户未确认前不进入写入；执行中出现新的实质业务选择才再次确认。
+   - 布局样表：仍由 CLI 创建字段与初始布局；明确要求还原图片/XLSX 样式时读 `references/form/layout/source-restoration.md`（先实际观察、经用户确认样式，再 compile/apply）。
+
+**关键约束**
+- 配置必须通过当前 `e10-cli` 支持的命令完成；没有对应命令就如实告知，不得写临时 `.mjs` 脚本或让用户操作浏览器代做。能力边界见 `references/common/capability-boundaries.md`；结论必须带证据等级（实测/回读字段/命令表/未证实）。
+- Windows 环境，注意命令行兼容性；少说废话，直接干活。
+- 写代码按模板直接出完整代码，写完用 `e10-cli check` 验证。
+- 解析 Word 用 `e10-cli docx read`，禁止自写 python-docx；必须逐张 Read `_images/` 图片并写回 md，布局表格保留空白、同排与合并关系。
+
+---
+
+## 决策树
+
+> **根据用户需求自动加载对应子文档，不要一次性读取全部 reference。**
+>
+> **动作流两种用法**：动作流「生成」一律走 native `e10-cli actionflow generate`（语义 plan → 编译 → preflight → 保存并启用 → 正式回读，event 节点自带流程节点触发绑定，**推荐**）；`e10-cli workflow action` 仅作动作流管理（`list-node`/`clear-node` 查清节点绑定、`delete`/`disable`/`batch-delete` 禁用删除动作流 app）。本表字段赋值/节点附加操作（actionType=0）用 `e10-cli workflow save-action`。
+> ```bash
+> e10-cli actionflow component-list                          # 列已登记组件
+> e10-cli actionflow component-describe <type>               # 读组件契约
+> e10-cli actionflow generate '{"planFile":"@plan.json","appName":"AI-名称"}'  # 生成+保存并启用+正式回读；planFile 必须以 @ 引用文件（@plan.json 或 @绝对路径），CLI 强制要求 @ 前缀
+> e10-cli workflow action list-node <wf> <node>             # 查节点绑定；clear-node 清；delete/disable 删动作流
+> ```
+
+| 用户关键词 | 加载文档 |
+|-----------|---------|
+| 表单布局源码、表单级 ecode、表单 JS 代码块、JSSDK、代码校验、明细代码汇总、字段事件脚本、表单组件复写 | 先读 `references/form/layout/code-block/code-block-guide.md` 选代码层级和 CLI 写入命令，再按效果读取该目录对应 JSSDK 专题；**布局源码 ecode 由 CLI 编码，不要手改 `sourceCode.ecode`；手工调接口必须用 `encodeURI`，不能用 `encodeURIComponent`（设计器用 `decodeURI` 读取）** |
+| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、**方案澄清、可行性预检、哪些做不到**、平台架构、Ecode、Ebuilder应用、默认台账与菜单 | 先读 `references/common/map.md` 识别资源、配置与依赖；做 0.1 方案澄清与可行性预检时同时读 `references/common/capability-boundaries.md`；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
+| 安装、升级、装不上、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
+| 支不支持、能不能做、能力边界、不支持的能力、**证据等级、CLI 没暴露** | `references/common/capability-boundaries.md`（结论必须带证据等级，命令表不能当平台不支持） |
+| 建应用、创建应用、app、应用列表、应用详情、应用目录、app read/list/folder/edit/delete | `references/common/ref-cli-commands.md` |
+| 启用应用、停用应用、发布到前台、发布应用、取消发布、应用发布信息、前台入口、应用名多语言、应用英文名、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md`（启用→发布→改发布信息→取消发布的先后关系 + 停用会收回发布态 + 多语言整份写回） |
+| 应用设置、菜单设置、电脑端显示/隐藏/不显示、多级菜单全部收起/展开、移动端显示、默认首页、字段权限启用/禁用、app setting get/set | `references/app/guide-app-settings.md`（publishInfo 层；与前台发布配置 / app range 区分） |
+| 应用管理权限、管理对象、应用管理员、添加/移除管理权限、内联权限分组、权限分组、分组成员、app manager、app manager group | `references/app/guide-app-manager.md`（管理对象 + publishInfo.rightGroupList；区别于独立「权限组」页） |
+| 字段联动、字段值带出、HRM 属性带出、relateFrom、form relate、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（按来源选择直接带出、HRM 带出或跨表查询赋值；含单跳/多跳与 --hops 格式） |
+| 函数联动、本表字段间公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、触发事件、模块字段不能作目标 | `references/form/guide-formula-linkage.md`（四套联动对比 + 赋值式语法 + 触发事件表 + 模块字段 + 流程表单那条路由 + 常见报错） |
+| 鉴权、登录、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
+| 表单数据读写、formClient、list/get/save/update/remove、values/display/items、options、optionId、optionIds、optionMap、detailRows、subFormId、回读校验、字段类型 | `references/coding/guide-form-crud.md`（前端代码；一个表单一个 client） |
+| form data add、form data list、form data delete、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
+| 编辑回显、handleEdit、row.values、row.display、row.items、Browser/Upload 回填、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
+| 显示属性联动、显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
+| 新建表单、form create、EB表单创建流程、fields.json | `references/form/guide-create-form.md`；确定具体字段参数时再读 `references/form/ref-form-fields.md` |
+| 虚拟表、虚拟表单、绑定数据源、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md`；字段类型按来源映射，不按普通字段重新猜测 |
+| 表单布局、布局管理、初始化、编辑、模板、布局代码块、图片或 Excel 还原 | `references/form/layout/layout-overview.md`（先按任务选择独立能力） |
+| 明细表整体读写、明细必填行数、允许新增／复制／修改／删除明细、根据操作者过滤 | `references/form/layout/detail-settings.md`（布局容器设置，区别于子字段属性与 JSSDK） |
+| 明细合计、过滤已选数据、批量添加、合并字段、分组、操作按钮、排序、快捷搜索 | `references/form/layout/detail-advanced.md`（字段候选、码表、增量修改与关闭方式） |
+| 流程表单多套布局、节点独立布局、布局绑定和回落默认 | `references/form/layout/workflow-layout.md`（表单布局与节点引用的关系；具体节点操作继续读流程指南） |
+| Excel样式、表格式布局、布局样表、布局蓝图、标签字段交替、合并单元格 | `references/form/layout/planning.md` |
+| 完整布局 JSON、布局文档导出、整体编辑差异预览、formLayout 大范围调整 | `references/form/layout/document.md`（导出底稿、预览完整差异、单次应用并回读） |
+| 还原图片样式、还原Excel样式、XLSX布局、源网格、pageLayouts、layout extract/compile/apply/verify/style-audit、已有字段位置匹配 | `references/form/layout/source-restoration.md`（图片 imageStyles 三层投影与样式诊断；已有字段复用，纯布局编译、单次保存和独立回读） |
+| 流程、审批、workflow、提交流程、预填 | `references/workflow/guide-workflow.md` |
+| 流程绑了哪张表、流程对应表单、workflow info、从流程找表单 | 命令速查 `references/common/ref-cli-commands.md` 的 `workflow info` 一行（**流程列表接口不含这个信息**；拿到的是 formId，不是 objId） |
+| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md`（操作者和条件同时遵循流程基础指南） |
+| 公文流程、公文审批、收文、发文 | `references/workflow/guide-workflow-odoc.md`（基础节点/出口/操作者同时遵循 `guide-workflow.md`） |
+| 公文设置、正文设置、痕迹、套红、排版、文号、附件区、归档、智能助手 | `references/workflow/guide-workflow-odoc-setting.md` |
+| 流程节点、操作者、审批人、连线、添加节点、删除连线、删除节点、delete-node、节点操作者、set-operator、出口名称、link-rename、节点字段权限、field-permission、节点批量设置、批量字段权限、多节点配置、workflow node batch | `references/workflow/guide-workflow.md` |
+| 节点独立布局、节点换布局、node layout、节点用哪套布局、流程布局、流式/表格式布局、引用节点、updateQuoteNode | `references/workflow/guide-workflow-node-layout.md` |
+| 分支条件、出口条件、条件JSON、save-condition、连线条件 | `references/workflow/guide-workflow-condition.md` |
+| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、数据来源、requestId、按流程定位、回写数据ID、HTTP/HTTPS、DML/数仓、自定义事件、内置 MQ | `references/workflow/guide-workflow-action.md`（动作流生成走 `e10-cli actionflow generate`；`workflow action` 仅查/清/删/禁用；本表字段赋值走 `save-action`；复杂组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/`） |
+| 菜单、导航、左侧菜单、系统页面、待办、已办、流程监控、菜单改名、重命名菜单、菜单排序、菜单顺序、放第一个、menu order、showOrder、--first | `references/menu/system-menus.md` |
+| 菜单链接、目录转换、显隐、默认启用、默认选中、图标、功能描述、显示条件、menu configure | `references/menu/guide-menu-config.md` |
+| 菜单可见范围、范围内禁用、职级/分部/角色/岗位/群组/外部联系人权限、menu permission | `references/menu/guide-menu-permission.md` |
+| 新页面、导出、路由、entry.js、asyncImport、${appId} 固定写法、appId 填数字 | `references/coding/guide-page-export.md`（前端代码） |
+| 写页面、页面代码、React编码、组件、entry.js模板、formClient、字段常量 | `references/coding/guide-page-code.md`（前端代码） |
+| HTML 原型还原、HTML 转 React、原型 CSS、复用样式、不写 CSS、class/className、内联 style、浮层、Portal、CSS 作用域 | `references/coding/guide-html-to-react.md`（前端代码） |
+| CLI命令、打包、build、import、创建应用/表单/菜单 | `references/common/ref-cli-commands.md` |
+| 编译报错、语法不支持、babel | `references/coding/ref-compile-rules.md`（前端代码） |
+| Word文档、docx、需求文档、解析文档 | `e10-cli docx read` 一键转换，禁止自己写脚本 |
+| 接口文档、Postman、系统接口、批量导入接口、创建连接器接口 | `references/esb-interface/guide-import.md`；使用 `e10-cli interface import` |
+| 新建视图、表格视图、看板、日历、思维导图、form view、台账显示列、显示列、list-columns、搜索条件、排序、list-sort、上下级、父级、树形展示、上级类型、list-hierarchy、视图数据条件、list-filter、日期占位符、{date}、{curryear}、动态日期 | `references/form/guide-form-view.md` |
+| 视图权限、查看布局、修改共享权限、view permission | `references/form/guide-form-view-permission.md` |
+| EBuilder关联、关联表单、数据过滤设置、ebuilder-filter、EBuilder显示列、ebuilder-columns、去掉系统字段、只留业务字段 | `references/form/guide-ebuilder-filter.md` |
+| 浏览数据定义、浏览弹窗高级搜索、浏览 Tab、可配置浏览字段 | 先读 `references/form/guide-browser-definition.md` 确认表单级／流程级配置归属；高级搜索和 Tab 也在此说明 |
+| 浏览数据范围、人员／部门／分部可选范围、关联 EBuilder 条件、自定义浏览框条件 | 先按上条确认配置归属，再读 `references/form/guide-browser-scope.md` 的来源适配、码表与读写方式 |
+| 字段分组、分组容器、字段分段、基本信息/合同信息分段、Collapse、Fold、字段归组 | `references/form/layout/planning.md`（**按需**：用户明确要求字段分组才在 fields.json 写 `group`，默认不加分组） |
+| 独占一行、整行显示、字段换行、singleRow、--single-row | `references/form/layout/planning.md`（fields.json 字段写 `"singleRow":true`；add-field 用 `--single-row`） |
+| 布局样式模板分类、公共规则、layout init、style-template | `references/form/layout/template/template-guide.md`（简易、高级、流式分别链接） |
+| 给已有表单加字段、改必填/只读、表单不是自己建的、--reinit、布局被重建、字段在布局里对不上、字段标题显示不出来 | `references/form/layout/incremental.md`（**⚠ 不是自己建的表不要用 `--reinit`**；设必填是改布局组件，字段定义里没有 `required`） |
+| 字段类型、字段码表、日期区间、关联浏览、关联订单、关联合同、Order、Contract、字段多选、multiple、--multiple | `references/form/ref-form-fields.md` |
+| 表单复杂编号、serial-mark、流水号、年份编号、代字 | `references/form/guide-form-serial-mark.md` |
+| 函数公式、字段公式、formula、DAYS、日期差、expressId、公式绑定 | `references/form/guide-form-formula-functions.md`（219 个函数速查矩阵，写 `fields.json` 的 `formula` 或 `form formula set --expression` 时查函数格式/示例；**日期差用 `DAYS(开始,结束)`**） |
+| 显示列批量设置、批量加列、列宽、列顺序、list-columns --set | `references/form/guide-list-columns.md` |
+| 顶部统计、明细统计、付款记录数、list-stats、子表计数 | `references/form/guide-list-stats.md` |
+| 关联页签、关联视图、association、页签显示布局、关联数据筛选、set-filter | `references/form/guide-form-association.md` |
+| 表单按钮、button、自定义按钮、视图按钮、行上、行末下拉、右上、打开视图、打开布局、发起流程、按钮预填、按钮字段映射、action-set | `references/form/guide-form-button.md`；`references/common/ref-cli-commands.md` |
+| 表单消息提醒、消息提醒、表单数据提醒、数据变动提醒、新增数据提醒、form message、提醒对象、推送渠道、IM提醒、云桥、短信提醒 | `references/form/guide-form-message.md`（表单数据新建/修改/删除时提醒人；列表是应用级、`--obj-id` 本地收口；提醒对象四类写法与同名歧义处理） |
+| 角色设置、角色功能权限、角色成员、分权范围、成员有效期 | `references/hrm/guide-role.md` |
+| 流程消息、编号规则、超时处理、退回设置、指定流转、投票、机器人节点、公用流转片段、子流程、人员范围、节点菜单、流程设置、流程存档、节点校验、提交校验 | `references/common/ref-cli-commands.md` |
+| 签署顺序、会签、非会签、竞签、或签、依次处理、抄送、operator-sign | `references/workflow/guide-workflow.md`；命令速查 `references/common/ref-cli-commands.md` |
+| 分类搜索、表单权限、编译/build/compile/check、skill 文档/skill sync/copy/root、CLI 命令速查 | `references/common/ref-cli-commands.md`（分类搜索四类字段：选项 / 浏览框 / 日期 / 系统字段） |
+| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、**自定义CSS、组件样式、改样式、选择器、DOM结构、样式不生效、designer css、designer dom** | `references/ebuilder-designer/guide-designer.md`（布局层）；组件配置见 `guide-designer-components.md`，**自定义 CSS 与 DOM 结构索引见 `guide-designer-css.md`**，工厂模板见 `guide-designer-factory.md`，版本见 `guide-designer-version.md`，命令速查见 `references/common/ref-cli-commands.md`「页面 & 设计器」节 |
+| HRM、矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId | `references/hrm/guide-matrix.md` |
+| 报表、设计器报表、EDC 报表、report build、新建报表、数据集、报表列、报表查询条件、报表权限、报表快照、report | `references/report/guide-report-build.md`（建表主干）；改已有报表见 `guide-report-modify.md`，查询条件见 `guide-report-query.md`，命令速查见 `ref-report-commands.md`；踩坑先扫 `ref-report-pitfalls.md` |
+| 报表多数据源、跨数据集、跨表关联、主从报表、两个表单合成一张报表、父格筛选、subordination、leftFilterField、render 渲染回读 | `references/report/guide-report-multisource.md`（spec 写法 + 区域/入口格 + 双保存与关预聚合 + 验证） |
+| 报表单元格、父格、扩展方向、合并、冻结、隐藏行、条件格式、数据条、图标集、tableName、字段三件套 | `references/report/ref-report-pitfalls.md` + `report-data-model.md`（枚举）· `layout-showlocation-freeze-guide.md`（冻结/居左）· `hidden-row-and-header-merge-guide.md`（空白行与表头合并） |
+
+> 组件文档（Button/Table/Input/Upload 等）在 `references/` 中按文件名查找。完整索引见 `_catalog.md`。
+
+> **表单自带默认台账** — 普通列表需求先查询并复用已有默认台账，记录实际名称/listId；“客户信息表／客户信息”这类简称差异不构成新建理由，默认保留原名，不统一去掉“表”字。仅名称需对齐时应改名而非另建。用户明确要求额外表格视图时，用 `form table-view create` 原子完成 `nListView` 创建、显示列配置和回读；禁止用 `form view create --type tableView` 创建空壳。`formView` 使用 `form view create` 后必须执行 `form view populate`。
+
+---
+
+## 能力边界
+
+> 不支持的能力、以及「CLI 没有命令时怎么办」的判定方式 → `references/common/capability-boundaries.md`。预检结论写进 `plan.md` 0.1，证据不足时标「待环境核查/未证实」；不得把「CLI 没暴露」写成「平台不支持」。禁止声称平台/CLI 支持实际不支持的能力，禁止用临时脚本或浏览器操作绕行。
+
+---
+
+## 页面编码
+
+页面是搭建的最后一步，动手前确保应用、表单、流程已建好。默认情况优先用设计器配置式页面（`page create` → `designer comp-add --template` → 绑数据 → `designer save` → `page publish-menu`），详见 `references/ebuilder-designer/guide-designer.md`；只有设计器无法满足的深度定制才用 Ecode React。
+
+**用户明确要求 Ecode、还原 HTML 原型，或说明不要设计器时，直接走 Ecode，不要再建议改用设计器。** 编码主路径见 `references/coding/guide-page-code.md`，完整样例在 `assets/sample/`；HTML 原型还原另读 `references/coding/guide-html-to-react.md`。注意 `entry.js` 里 `asyncImport('${appId}', ...)` 的第一个参数是固定字符串，不是 Ebuilder 应用 ID 或任何数字。
+
+`page permission`：页面使用范围、禁用范围、矩阵相关权限及码表见 [页面权限指南](references/ebuilder-designer/guide-page-permission.md)。
+
+组合页面及页签目标、参数、可见/禁用范围、复制：阅读 [组合页面指南](references/ebuilder-designer/guide-page-combination.md)。
+
+普通页面设计器源码 JS/CSS、页面 SDK、页面/组件加载事件、组件实例、列表勾选和插件、图表 option、页面内表单组件：阅读 [页面源码指南](references/ebuilder-designer/page-source/page-source-guide.md)，按 [SDK 索引](references/ebuilder-designer/page-source/sdk-index.md) 查接口。使用 `designer source read/check/set/sdk`；与表单 JSSDK、组件自由 CSS、独立 ecode 工程分开。
+
+页面/组件的单击与加载完成动作配置：阅读 [事件指南](references/ebuilder-designer/events/guide-events.md)，使用 `designer event get/set/enable/remove/schema/lookup`。同一触发支持有序多动作和递归 IF/ELSEIF/ELSE 分支，使用 action/branch 按 ID 编辑；set {actions:[...]} 明确整体替换。 页面跳转、条件、组件显隐、菜单、刷新和集成动作按该入口自己的参数与码表配置。
+
+页面内单个组件的使用范围、禁用范围、矩阵或EB表单相关人员授权：阅读 [组件权限指南](references/ebuilder-designer/component-permission.md)，使用 `designer permission`。与页面整体权限、列表数据权限分别配置。
+
+移动端标签栏、TabBar、首页、默认菜单、记忆菜单、最多显示数量、菜单排序与菜单事件：阅读 [标签栏指南](references/ebuilder-designer/guide-tabbar.md)，使用 `designer tabbar` 和 `designer event --collection items`。
+
+列表显示、查询分组统计、聚合、自定义计算、数据扩展和 CLICKDATA：阅读 [列表高级配置](references/ebuilder-designer/guide-list.md)，使用 `designer list advanced`。
+
+列表固定过滤、多字段排序、普通/快捷/分类搜索、系统与自定义操作按钮：阅读 [列表搜索与按钮指南](references/ebuilder-designer/guide-list.md)，使用 `designer list controls`；按钮动作使用 `designer event --collection listButtons`。
+
+列表表头快捷操作、隐藏表头、勾选框禁用、展示分组与上下级：阅读 [列表展示指南](references/ebuilder-designer/guide-list.md)，使用 `designer list advanced presentation`。
+
+自定义页面组件、嵌入页面/链接、条件切换内容、组件显示条件、标题与刷新/全屏/帮助按钮：阅读 [自定义页面组件指南](references/ebuilder-designer/guide-custom-page.md)，使用 `designer custom-page`；帮助动作使用 `designer event --collection customPageButtons`。
+
+普通页面重命名、复制、转移、删除、页面分组及可转移应用查询：阅读 [普通页面管理](references/ebuilder-designer/guide-page-management.md)，使用 `page rename/copy/transfer/groups/transfer-targets/delete`。

package/skill-docs/_catalog.md

@@ -82,11 +82,15 @@
 |---------------|---------|
 | CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
 | 应用发布、启用应用、停用应用、发布到前台、取消发布、应用发布信息、前台入口、应用名多语言、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md` |
+| 应用设置、菜单设置、电脑端显示/隐藏/不显示、多级菜单全部收起/展开、移动端显示、默认首页、字段权限启用/禁用、app setting get/set | `references/app/guide-app-settings.md`（publishInfo 层；与前台发布配置 / app range 区分） |
+| 应用管理权限、管理对象、应用管理员、添加/移除管理权限、内联权限分组、权限分组、分组成员、app manager、app manager group | `references/app/guide-app-manager.md`（管理对象 + publishInfo.rightGroupList；区别于独立「权限组」页） |
 | 完整实施方案、规划能力地图、资源依赖、需求映射、plan 前预检、**方案澄清、可行性预检、哪些做不到**、平台架构、Ecode、默认台账与菜单 | `references/common/map.md`，随后使用 `references/common/guide-plan-template.md`（0.1 节）与 `references/common/capability-boundaries.md` |
 | 安装、升级、装不上、skill 重装、skill remove、skill sync、references 文档缺失、WorkBuddy | `references/common/guide-install.md` |
 | 能力边界、支不支持、能不能做、不支持的能力、**证据等级、CLI 没暴露** | `references/common/capability-boundaries.md`（命令表只能证明 CLI 没暴露，不能当平台不支持） |
 | 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
 | 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单、二级菜单、子菜单、父菜单、菜单层级、menu add-table --parent、menu add-start --parent、菜单排序、菜单顺序、放第一个、menu order、showOrder、--first、菜单打开方式、新窗口、openMode、menu open-mode、移动端菜单、H5 菜单、--terminal、PC 菜单同步到移动端、菜单同步、同步 PC 菜单、menu sync、菜单可见范围、可见范围内禁用、--scope disabled、menu permission | `references/menu/system-menus.md` + `references/common/ref-cli-commands.md` |
+| 菜单链接、目录转换、菜单显隐、默认启用、默认选中、图标、功能描述、显示条件、menu configure、menu get/targets/link/icons/condition-candidates | `references/menu/guide-menu-config.md` |
+| 菜单权限、可见范围、范围内禁用、职级/分部/角色/岗位/群组/外部联系人授权、menu permission schema/get/browse/entry | `references/menu/guide-menu-permission.md` |
 | 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
 
 ## Components（组件文档）

package/skill-docs/actionflows/SKILL.md

@@ -40,6 +40,7 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 - 其他组件动态字段：`e10-cli actionflow component-context-fields '{"componentType":"<组件类型>","currentApplication":"<当前动作流ID；新建传0>","eventNodeId":"<上游节点ID>","params":{...},"query":"<字段名或关键词>"}'`。该命令会先解析数据源 Browser，再查询 `showDataSourceFields` 匹配实际可选输出字段，随后编译组件上下文并调用 `getComponentContext`。`EnquiryForm`、`TimeBatchTrigger`、`DateTrigger` 都适用。**必须在写入任何动态赋值前查询来源组件**；只允许从本次 `getComponentContext` 结果选择 `fields[].paramKey`，接口未返回的字段必须先查明该组件是否有受支持的依据值语义，否则停止该映射，不得凭字段名、约定根节点或历史经验补造。
 - 数据源名称通过 Browser 模糊搜索：只有一个候选时使用该候选；多个候选时展示名称、所属应用和 ID，让用户选择。拿到选择的 ID 后重新解析；数据源 ID 和 `type/sourceType` 均使用接口返回值。
 - 计划按执行顺序构造时，先查询触发器，再逐个查询会提供动态数据的上游动作；每一步都用该组件本次真实参数（尤其数据源、目标表和选中的字段）查询。下游映射只能选择已查询来源返回的字段。`generate` 的预检是最后一道校验，不可代替生成前的字段发现。
+- 动态字段的来源可能是触发器或当前节点之前可见的上游组件。使用各组件接口返回的完整上下文，在本地按名称或完整路径匹配：用户已明确指定来源时使用该来源；没有指定但仅有一个可靠候选时直接使用。若存在多个符合条件的来源，必须使用 `AskUserQuestion` 工具向用户确认；当前环境没有该工具时，使用该环境提供的用户提问工具。选项应列出真实组件名称、字段名称及区分所需的完整 `paramKey`，并在必要时列出节点 `ref` 或字段 ID；等待用户选择后才生成对应动态赋值。字段来源为流程触发器时使用 `source:"event"`，来源为其他组件时使用其真实语义 `ref`，字段路径和 ID 以本次接口返回为准。找不到候选时说明已查询的来源并向用户澄清，不得猜测。已指定来源却在预检或编译中丢失时，应排查 CLI 的来源传递逻辑，不要让用户重复选择。
 - e-builder（**已知表名时首选**）：`e10-cli actionflow form-search '{"keyword":"<表名>"}'` 一次拿到表单 `objId` 与它所属的业务应用 `appId`。服务端是**子串模糊匹配**，同名表跨多个应用很常见（返回体里的 `完全同名` 即同名条数）—— **多于一条时必须按 `appName` 收窄再取**，不得自行挑一个：`'{"keyword":"<表名>","appName":"<应用名>"}'`。`keyword` 传 `objId` 则是精确命中，可用来由 id 反查所属应用。
   - **`appName` 走服务端过滤**（不是本地二次筛）：应用名精确唯一才用；**同名多命中或查无此名会直接报错并列出候选**，此时改用 `appId` 指定，不要换个近似名重试。
   - **返回体 `total` 是服务端在该筛选下的命中总数，`hits` 可能只是其中一部分。** 默认最多返回 100 条，超出时 `truncated: true` 并给出 `omitted`（未返回条数）。**`truncated` 为真时绝不能判定「表单不存在」** —— 先按 `appName` 收窄，确需全部再传 `{"max":0}`（条数大时用 `--out <file>` 落盘）。判断是否唯一命中以 `唯一命中` 字段为准，不要自己数 `hits` 长度。
@@ -62,6 +63,7 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 6. 定时组件优先使用平台原生频率：`rate=1` 一次、`2` 按小时、`3` 按日、`4` 按周、`5` 按月，并按需提供 `cycle`、`hour`、`day`、`week`、`atWeek`、`atWeekDetail` 或 `lastWeek`；只有明确选择 `rate=6` 时才传 `cornString`。图形化频率必须提供 `startTime`。
 7. `EnquiryForm`、`TimeBatchTrigger`、`DateTrigger` 的 `queryFields` 会裁剪 `getComponentContext` 返回的动态上下文。字段必须来自当前租户的 `showDataSourceFields` 完整字段对象；若后续动态赋值引用了其中字段，预检会按真实字段 ID 匹配并把它并入 `queryFields`，匹配不到就报错，不能按名称或路径尾段造字段。未明确限制输出字段时不传 `queryFields`（或传空数组），CLI 默认全选。查询节点还必须使用自身真实节点 ID 作为 `dataSource.enquiryId`，否则平台可能静默丢弃业务字段。正式回读必须确认每个声明的 `queryFields` 仍存在；缺失即生成失败，不能仅凭接口 `code=200`、`saved=true` 判定成功。e-builder 数据触发后发送消息且未显式给链接时，CLI 自动补 PC/移动端当前记录详情链接；不手写 `{formId}` / `{dataId}` 的 FormulaBean。查询结果字段动态赋值必须使用 `getComponentContext` 返回的真实 `paramKey` 和字段实例 ID；字段名称缺失或匹配不唯一时停止，不按数字 ID 拼接前缀。禁止使用 `FormData.<表单ID>[临时位置]...`，也禁止把临时公式 ID 当作 `frontId`。
 8. `ActionEbAdd` 批量新增以 `basisValue` 为明细行上下文：来源于该行的字段都用 `mapping`，编译为“依据值下级”（`switchType:"sub"`），下拉字段也同样处理。只有已核实来源/目标选项 ID 不同且语义需要转换时，才使用 `SWITCH`。关联 e-builder 字段应引用查询结果的 `数据ID`，固定格式为 `{target,kind:"query_result",source:"<EnquiryForm ref>",formId,fieldId:"id",index:0}`；`kind:"enquiry"`、`sourceId` 等旧写法会直接报错，绝不降级为空固定值。
+8.1. 批量新增配置明细表时，优先用目标明细表名称匹配主表依据值下的同名来源明细。依据值和字段必须来自实时上下文；明确指定特殊来源时保留用户选择，匹配缺失或重名时停止并提示。
 9. 动态赋值可使用或新建动作流变量、租户常量：已有资源必须用真实 ID；计划新建变量写顶层 `variables[]`，新建常量写 `constantDefinitions[]`，常量分组可传 `groupPk` 或 `groupName`。变量按当前 `applicationId + sceneId` 隔离，常量按分组跨动作流复用。生成时先调用真实接口创建/解析资源，再编译为变量 `type:"7"` 或常量 `type:"5"` FormulaBean；详细格式见 `references/dynamic_resources.md`。消息 `SendMessage.msgTitlev/msgContentv/picLink/msgPcLink/msgMobileLink` 的 `parts` 支持 `variable`/`constant` 动态片段，并统一保存为 `ContestSettingDTO`。
 9.1. 每个参数先分为“动态公式属性”“动态人员属性”“固定平台资源属性”三类：上下文、系统变量、变量、常量、函数/公式必须保留为 FormulaBean；动态人员必须使用真实人员字段上下文或系统变量，不得把引用里的 `id` 当人员 Browser ID 查询；工作流、文档目录、按钮、规则等平台资源只有在其组件契约明确提供动态引用时才允许动态化。生成前必须记录本次组件/属性的判定，生成后按属性检查回读结果；具体映射和验证状态见 `references/dynamic_capability_matrix.md`。
 10. 自定义事件和内置 MQ 的参数必须按对应平台组件说明提供原生参数对象；`CustomTrigger.customData`、`InnerMQListener.receiveParams`、`InnerMQSend.sendParams` 不能用猜测的字段替代。若验证要求“输入参数里有字段”，必须在生成前提供至少一行真实原生参数；`tables:[]`、`tableList:[]` 或省略 `receiveParams` 只能表示无输入参数，不能作为有参数的占位。`InnerMQListener` 与 `InnerMQSend` 是动作流级互斥组件，同一计划（包括条件嵌套）同时出现时，CLI 在任何平台写接口前直接报错。

package/skill-docs/actionflows/references/components/calendar/MeetingCreate.md

@@ -12,6 +12,8 @@
 
 会议标题、密级等普通字段支持固定值和动态赋值；创建人、召集人、联系人支持固定人员对象和动态人员公式。会议类型、会议室、附件、关联流程等设计期资源仍必须使用当前租户真实选择器对象，不能把上下文强行当作资源 ID。
 
+会议密级固定值可填写选项名称或 ID；预检会从会议字段接口 `getMeetingField` 查询并匹配真实选项 ID。无匹配、匹配不唯一或接口不可用时停止生成；动态赋值沿用真实上下文，不会填入其他组件的密级默认值。
+
 也可以直接传入前端 `MeetingPendingCreateEntity` 结构：使用 `type`、`setting` 和 `formSetting`。`setting` 的字段名应来自 `getMeetingField`；其中原生 FormulaBean 会原样保留，语义动态值会编译为 FormulaBean。
 
 ## 最小计划

package/skill-docs/actionflows/references/components/ebuilder/ActionEbAdd.md

@@ -76,11 +76,15 @@
 
 `opType:"batchInsert"` 时，`basisValue` 与 `mapping` 都是必填：前者指定要逐行遍历的上游明细，后者指定每行写入哪些目标字段。两者任一缺失，CLI 会在创建动作流前停止，绝不保存空壳批量节点。
 
+Webhook 和自定义触发的数组也可作为批量依据值；数组及其下级字段必须取自来源组件实时上下文。新建时依据值公式 ID 由后端保存后返回，下级字段的嵌套依据配置使用所选父数组路径。暂存不等于正式保存通过。
+
+批量新增时，明细表依据值如果选择的是主表依据值下的数组，使用表单设置的 `mainBasis` 依据值下级公式（`type: "10"`）；字段路径和行 ID 取自同一来源组件的实时上下文。循环内还要保留主依据值的循环来源及组件信息。
+
 若流程触发器上下文中存在 `requestId`，而目标表恰有唯一一个未赋值的流程关联 Browser 字段（如“来源流程”或“关联流程”），CLI 会把它自动映射为当前流程实例 ID，并在结果的 `autoMappings` 中列出。显式映射、固定值、公式和旧 `setting` 始终优先，不会被覆盖；字段不唯一或类型不是流程关联字段时不猜测。
 
 ### 明细表规则
 
-新增明细时，前端 `DetailForm` 以 `basisValue` 决定新增行数；没有依据值时会清空动态赋值。因此只要 `detail` 中配置了 `mapping`、`constants` 或 `formula`，就必须同时提供真实的 `basisValue`，通常写成上游明细列表字段并带 `[]`。CLI 不接受没有依据值的明细字段映射。
+新增明细时，前端 `DetailForm` 以 `basisValue` 决定新增行数；没有依据值时会清空动态赋值。配置了 `mapping`、`constants` 或 `formula` 的明细必须有真实的 `basisValue`。批量新增时，未显式指定明细依据值的情况下，CLI 根据目标表单实时明细名称，在主依据值下的 `getComponentContext` 数组中唯一匹配同名明细，并编译为动态依据值；没有匹配项或存在歧义时预检失败，并列出主依据值下接口返回的可选数组名称及 paramKey；让用户选择后，在该明细的 `basisValue` 中显式传入来源组件 `source` 和选中的 `paramKey`。业务指定特殊来源时，可显式提供真实的明细 `basisValue`。
 
 `ActionEbAdd` 的 `ActionEbDlg` 未开启明细操作策略选择器，明细策略固定为新增。`detail` 不接受 `operateType`、`updateType`、`updateFieldCondition`、`updatePolicy` 或 `rowId`；这些字段会被 CLI 拒绝，明细更新/删除应改用 `ActionEbUpdate`（删除全部等特殊场景也不要伪造为新增）。编译结果不会写入前端不存在的 `operateType:"insert"`，只保存 `detailTableId`、`basisValue`、`data` 和 `deleteFields`。
 

package/skill-docs/actionflows/references/components/ebuilder/DateTrigger.md

@@ -8,6 +8,8 @@
 
 查询数据源、日期字段、可输出字段和操作人。
 
+`dateField` 必须从当前数据源的 `/api/ebuilder/common/ds/fields` 日期字段中选择。可提供该字段真实 `id` 或 `name`，预检会使用接口返回的 `name`、`objId` 等信息生成设计器字段；不要自行添加或删除 `field_` 前缀。数据源类型以 Browser 实际返回值为准，和计划显式填写的类型不同时会提示。
+
 ## 不可猜测
 
 日期字段必须属于当前数据源；操作人必须是当前租户真实人员对象。

package/skill-docs/actionflows/references/components/trigger/WebHookTrigger.md

@@ -110,4 +110,6 @@ Webhook 触发的终止节点使用 `finalOutput.params.webhookCustomParamSettin
 
 ## 新建参数的 ID
 
+Webhook 响应参数中的上下文公式必须使用来源组件 `getComponentContext` 返回的真实 `paramKey` 和字段行 `id`（作为 `frontId`）；不同组件的“数据ID”路径可能不同，不按 `.id` 或 `.5` 猜测。CLI 会为响应参数的动态公式写入 `config.esbAssign`，其 `wId` 指向当前终止节点。
+
 新建参数设置或映射 DTO 时，在对应参数对象根部指定 `idPolicy: "new"`，CLI 会分配雪花 ID 并同步父子行和依据参数引用。需要引用父行时可用唯一临时 ID 关联；接口返回的已有参数应保留原 ID，不设置此标记。该标记仅供 CLI 使用，不传给后端。