weaver-e10-builder 1.5.6 → 1.5.9

package/skill-docs/SKILL.md

@@ -2,11 +2,11 @@
 name: weaver-e10-builder
 display_name: 泛微E10智能搭建Skill
 display_name_en: E10 Builder
-description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.5.6
-description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.5.6。
-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.5.6.
+description: 泛微E10智能搭建skill v2（通用版），辅助编写泛微Ebuilder自定义应用，对应CLI版本1.5.9
+description_zh: 泛微Ebuilder低代码应用智能搭建工具 v2（通用版），辅助编写自定义应用（表单/流程/列表/动作流/权限/分组/编号等），与 e10-cli 配套使用，当前对应 CLI 版本 1.5.9。
+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.5.9.
 category: coding
-version: 1.5.6
+version: 1.5.9
 author: 泛微网络科技股份有限公司
 auto: true
 ---
@@ -15,7 +15,7 @@ auto: true
 
 ## 安装与升级
 
-本 skill 需与 CLI **版本匹配**（当前对应 CLI `1.5.6`）。版本不一致时命令/文档/选项可能对不上——升级前先对齐：
+本 skill 需与 CLI **版本匹配**（当前对应 CLI `1.5.9`）。版本不一致时命令/文档/选项可能对不上——升级前先对齐：
 
 ```shell
 e10-cli --version          # 查 CLI 版本，应与上方 description 标注一致
@@ -71,20 +71,16 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 
 ---
 
-## 关于「流程表单 / 工作流程」（非默认路径）
+## 流程类型与默认路径
+
+默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow` 路径。不确定且选择会改变资源归属时，再向用户确认。具体规则读取 `references/workflow/guide-workflow.md`；公文流程创建读取 `references/workflow/guide-workflow-odoc.md`，公文专属设置读取 `references/workflow/guide-workflow-odoc-setting.md`。
 
 流程体系分为 **EB 流程**和**原生工作流程**，两者的表单、资源 ID 与接口不可混用；公文流程是原生工作流程的特殊类型。固定/自由是各类流程的流转模式。
 
-默认使用 **EB 表单**及应用内流程。只有需求明确要求原生流程表单、工作流程或流程中心建流程时，才切换到 `wf-form` / `workflow create-workflow` 路径。不确定且选择会改变资源归属时，再向用户确认。具体规则读取 `references/workflow/guide-workflow.md`；公文流程创建读取 `references/workflow/guide-workflow-odoc.md`，公文专属设置读取 `references/workflow/guide-workflow-odoc-setting.md`。
 ---
 
 ## 面向人群
 
-
-
-
-
-
 - 本 skill 面向非编程人员。用户不懂技术，不会描述字段类型、数据关系。
 - 你要主动引导，把模糊需求翻译成精确的平台资源设计。
 
@@ -107,21 +103,21 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 2. 全局资源设计（复杂需求必经）
    a. 理解需求，不够清楚的地方反问用户
    b. 写 plan 前扫描需求中的布局章节和表格。**每张表单建表前先向用户确认布局类型：流式(FLOW)还是表格式(EXCEL)**——平台建表后不可切换，需求没明说就不要默认。出现“表格式布局/Excel样式/按照如下布局”、`[字段名]`、标签与字段交替、分组标题或有意义的空白单元格时，按“布局样表”解析；识别方法读取 `references/form/guide-form-layout-planning.md`
-   c. 在本地写 `plan.md`：**认真阅读用户提供的实施方案/需求文档** **严格按照 `references/common/guide-plan-template.md` 的模板格式，梳理所有需要搭建的资源和配置项**（应用/表单/字段/布局蓝图/流程/出口条件/联动/权限/编号/台账配置等编写`plan.md`，需求里提到的每项都要在 plan 中体现，不能凭记忆遗漏），禁止自创格式、禁止预勾。布局样表必须逐行写入对应表单的“表单布局蓝图”，不得仅压缩成 `group`、`singleRow` 或字段顺序
+   c. 在本地写 `plan.md`：**认真阅读用户提供的实施方案/需求文档**，先参考 `references/common/map.md` 逐项识别资源、配置和依赖；遇到具体配置规则或能力边界需要明确时，再读取对应的细节文档；最后按照 `references/common/guide-plan-template.md` 写资源清单、逐表字段与布局蓝图、按功能归类的配置条目和分段销号清单。每条要求须有明确归属与来源，禁止预勾。布局样表必须逐行保存，不得仅压缩成 `group`、`singleRow` 或字段顺序
    d. **编写完成后打开 `plan.md` 和用户确认**（此阶段 plan 里所有 `[ ]` 保持未勾——是待办清单，不是完成清单）
-   e. 用户确认后按大纲**逐项执行、逐项打勾**：每做完一项、验证通过，才把 `[ ]` 改 `[x]` 并填入实际 ID。**完成一条打勾一条**，禁止预勾。
+   e. 用户确认后按资源依赖和功能批次**逐项执行、逐项打勾**：同类配置可连续处理多张表单或视图；每做完并核验一项，才把所属条目 `[ ]` 改 `[x]` 并填入实际 ID 或结果。**完成一条打勾一条**，禁止预勾或合并销号。
 
 3. 执行搭建（**最多分三段，每段完成停下来让用户确认，确认后才进下一段**）
-   - 以用户确认的 `plan.md` 作为唯一执行清单，按照资源依赖顺序逐项读取对应指南并完成全部配置。每完成并核验一项，立即将对应 `[ ]` 更新为 `[x]`，同时回填实际资源 ID 或配置结果；未完成的项目不得预勾、合并销号或遗漏。进入下一执行段前，确认本段所有应完成项均已销号；依赖后续资源的项目继续保留 `[ ]` 并注明依赖。
-   - **段①：应用、角色、表单与视图。** 完成应用、角色、全部表单和表单布局，并配齐字段属性、关联、公式、联动、校验、权限、默认台账、新增视图、显示列、搜索排序、筛选统计、分组、上下级、按钮和关联页签等表单及视图相关配置。依赖流程 ID 的配置在 plan 中列明，待段②创建流程后回填。
-   - **段②：流程与自动化。** 完成流程创建、节点连线、操作者、出口条件、节点配置、流程级设置、矩阵和动作流，并回填段①中依赖流程 ID 的表单字段、表单按钮和视图按钮。完成后确认流程结构及关键条件。
-   - **段③：菜单与页面。** 完成台账、流程发起和自定义菜单，配置菜单权限，并按需求创建配置式页面或定制页面，绑定真实资源 ID 后完成保存、发布和整体收尾。分段细节见 `references/common/guide-plan-template.md`「执行分段」。
+   - 以用户确认的 `plan.md` 作为唯一执行清单。资源清单保存归属与依赖；表单级、视图级配置以**功能项为外层批次、所有涉及的表单或视图为内层对象**：同一功能在全部适用对象上逐项完成后，再进入下一功能批次。按依赖解锁；每进入一个功能项，先按决策树阅读对应指南，确认方法、参数和边界，同一连续批次已读过的无需重复读取。每项完成并核对后立即回填实际 ID 或结果、销号；暂时无法完成的保留 `[ ]`，注明原因、已完成部分和所需条件，继续处理不受影响的项目。不得因操作繁琐、命令不熟悉或已有近似效果而省略配置、预勾或合并销号；每段结束前核对全部条目的处理状态。
+   - **段①：应用、角色、表单与视图。** 先建立应用和角色；按依赖完成全部表单的字段、明细与布局，读回资源及字段 ID；再按功能批次处理各表单的关联与范围、带出、公式、联动、校验、编号和权限；随后建立全部视图，按功能批次配置显示列、搜索排序、筛选统计、分组、上下级、权限、按钮和关联页签。建表时已完成的字段显示属性不重复写入。依赖流程 ID 的配置先列待办，段②回填。
+   - **段②：流程与自动化。** 按依赖准备矩阵或权责表；每个流程建立后，依次完成该流程的节点、连线、出口条件、操作者及结构排版，核对核心流转后再处理下一流程。其余节点与流程级设置、动作流可按功能批次完成，并回填段①中依赖流程 ID 的表单字段和按钮。
+   - **段③：报表、菜单与页面。** 按需求完成报表与数据集；将台账、流程发起和页面绑定到菜单并配置权限；创建配置式页面或定制页面，使用真实资源 ID 保存、发布并完成整体收尾。分批细节见 `references/common/guide-plan-template.md`。
    - 布局样表已进入 plan 时，据蓝图组织 `fields.json`，用现有 `form create --layout EXCEL` 创建并初始化；CLI 不消费蓝图本身。创建后仅在实际需要时读取当前布局并逐项调整，不生成额外布局 JSON、不改初始化逻辑。
    - 简单单步需求（改字段、查数据）不分段，直接执行。
 ```
 
 **关键约束**：
-- plan.md 强制按 `references/common/guide-plan-template.md` 格式写；规划阶段不调写命令、逐项销号、分段确认、字段一次性建好等规则见模板「规则备忘」
+- plan.md 按 `references/common/guide-plan-template.md` 组织；规划阶段不调写命令，按资源依赖与功能批次执行并逐项销号；每段结束让用户确认。
 - 本服务运行于 Windows 环境，注意命令行兼容性
 - 不要多说废话，直接干活。用户等的是结果。
 - **写代码不要犹豫**，按模板直接出完整代码，写完用 `e10-cli check` 验证。错了报错再改。
@@ -143,8 +139,9 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 
 | 用户关键词 | 加载文档 |
 |-----------|---------|
-| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单 | `references/common/guide-plan-template.md` |
+| 写plan、搭建计划、plan.md、资源梳理、搭建模板、必做项清单、完整实施方案、需求映射、能力地图、跨资源依赖、规划预检 | 先读 `references/common/map.md` 识别资源、配置与依赖；必要时读对应细节文档；再按 `references/common/guide-plan-template.md` 写资源清单与功能批次 plan |
 | 建应用、创建应用、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`（启用→发布→改发布信息→取消发布的先后关系 + 停用会收回发布态 + 多语言整份写回） |
 | 字段联动、跨表带出赋值、FormDataLinkage、多跳带出、关联客户带出客户类型、field-linkage、Text字段赋值名称 | `references/form/guide-field-linkage.md`（三种联动对比 + 单跳/多跳 + --hops 格式 + Text 字段必须多跳取名称） |
 | 函数联动、本表字段间公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、触发事件、模块字段不能作目标 | `references/form/guide-formula-linkage.md`（四套联动对比 + 赋值式语法 + 触发事件表 + 模块字段 + 流程表单那条路由 + 常见报错） |
 | 鉴权、登录、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
@@ -186,10 +183,12 @@ npx -y skills add ./weaver-e10-builder.zip --skill -y
 | 函数公式、字段公式、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` |
+| 分类搜索、分类筛选、按字段分类、list-search-group、选项配置、日期粒度、选项排序、统计数字 | `references/common/ref-cli-commands.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` |
 | 表单权限、permission、数据权限 | `references/common/ref-cli-commands.md` |
-| 消息提醒、消息动作流、workflow message、IM提醒 | `references/common/ref-cli-commands.md` |
+| 表单消息提醒、消息提醒、表单数据提醒、数据变动提醒、新增数据提醒、form message、提醒对象、推送渠道、IM提醒、云桥、短信提醒 | `references/form/guide-form-message.md`（表单数据新建/修改/删除时提醒人；列表是应用级、`--obj-id` 本地收口；提醒对象四类写法与同名歧义处理） |
+| 流程消息、节点消息、workflow message、消息动作流 | `references/common/ref-cli-commands.md` |
 | 编号规则、serial-mark、自动编号、流水号、年份编号、流程编号、numbering、停用编号、禁用编号、启用编号、解除编号 | `references/common/ref-cli-commands.md` |
 | 超时处理、节点超时、超时提醒、node-overtime、node timeout | `references/common/ref-cli-commands.md` |
 | 退回设置、退回方式、退回范围、node-reject、node reject | `references/common/ref-cli-commands.md` |

package/skill-docs/_catalog.md

@@ -1,86 +1,90 @@
-# Skill Ebcoder 目录索引
-
-> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
->
-> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
-
-## Guides（编码指南）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
-| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
-| 显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
-| 函数联动、本表字段公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、值改变时、载入时触发、当前工作流生效 | `references/form/guide-formula-linkage.md` |
-| 字段联动、跨表带出、field-linkage、多跳带出、带出字段赋值、Text 字段取名称 | `references/form/guide-field-linkage.md` |
-| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
-| 二级明细、子明细、父级行标识、子级行标识、多级明细 | `references/form/guide-form-sub-detail.md` |
-| 物理表、多物理表、附属物理表、saveFormTable、getFormAGroupList、字段管理其他页签、字段超过100、add-physical-table、add-physical-field | `references/form/guide-form-physical-table.md` |
-| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
-| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
-| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
-| 布局样式模板、换配色、form layout init | `references/form/style-templates.md`（流式/表格式两套，同名不同 id） |
-| 已有表单加字段、改必填/只读、布局被重建、add-field --reinit、别动别人的表、布局组件、associatedId、字段标题取不到 | `references/form/guide-form-layout-incremental.md` |
-| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
-| 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
-| 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
-| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
-| 流程绑的表、流程关联表单、workflow info、workflowId 查表单、formId 不是 objId | `references/common/ref-cli-commands.md`（`workflow info` 一行） |
-| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
-| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
-| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
-| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
-| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
-| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
-| HRM矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId、syncType | `references/hrm/guide-matrix.md` |
-| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
-| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
-| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
-| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
-| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
-| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
-| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
-| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
-| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
-| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
-| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、自定义CSS、组件样式、选择器、DOM结构、样式不生效 | `references/ebuilder-designer/guide-designer.md`（布局层主干）· `guide-designer-components.md`（组件 config）· `guide-designer-factory.md`（工厂模板）· `guide-designer-version.md`（版本）· `guide-designer-css.md`（自定义 CSS 与 DOM 结构索引） |
-
-## Reference（参考手册）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
-| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
-| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单 | `references/menu/system-menus.md` |
-| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
-
-## Components（组件文档）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| Button、按钮 | `references/components/@weapp-Button.md` |
-| Table、表格 | `references/components/display-Table.md` |
-| List、列表 | `references/components/display-List.md` |
-| Pagination、分页 | `references/components/display-Pagination.md` |
-| Icon、图标 | `references/components/display-Icon.md` |
-| Avatar、头像 | `references/components/display-Avatar.md` |
-| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
-| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
-| Input、输入框、文本框 | `references/components/form-Input.md` |
-| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
-| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
-| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
-| Badge、徽标 | `references/components/base-Badge.md` |
-| Tag、标签 | `references/components/base-Tag.md` |
-
-## 组合场景
-
-| 场景 | 需加载的文档 |
-|------|-------------|
-| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
-| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
-| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
-| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
-| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
-| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
-| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
+# Skill Ebcoder 目录索引
+
+> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
+>
+> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
+
+## Guides（编码指南）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
+| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
+| 显隐联动、条件显示、form linkage、为空/不为空条件、NULL 算子 | `references/form/guide-form-linkage.md` |
+| 函数联动、本表字段公式赋值、赋值式公式、EXCEL 公式联动、字段自动计算、form formula-linkage、wf-form formula-linkage、流程表单函数联动、值改变时、载入时触发、当前工作流生效 | `references/form/guide-formula-linkage.md` |
+| 字段联动、跨表带出、field-linkage、多跳带出、带出字段赋值、Text 字段取名称 | `references/form/guide-field-linkage.md` |
+| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
+| 二级明细、子明细、父级行标识、子级行标识、多级明细 | `references/form/guide-form-sub-detail.md` |
+| 物理表、多物理表、附属物理表、saveFormTable、getFormAGroupList、字段管理其他页签、字段超过100、add-physical-table、add-physical-field | `references/form/guide-form-physical-table.md` |
+| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
+| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
+| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
+| 布局样式模板、换配色、form layout init | `references/form/style-templates.md`（流式/表格式两套，同名不同 id） |
+| 已有表单加字段、改必填/只读、布局被重建、add-field --reinit、别动别人的表、布局组件、associatedId、字段标题取不到 | `references/form/guide-form-layout-incremental.md` |
+| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
+| 分类搜索、分类筛选、list-search-group、选项配置、日期粒度、选项排序 | `references/common/ref-cli-commands.md` |
+| 表单消息提醒、数据变动提醒、form message、提醒对象、推送渠道、IM提醒 | `references/form/guide-form-message.md` |
+| 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
+| 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
+| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
+| 流程绑的表、流程关联表单、workflow info、workflowId 查表单、formId 不是 objId | `references/common/ref-cli-commands.md`（`workflow info` 一行） |
+| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
+| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
+| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
+| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
+| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
+| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
+| HRM矩阵、条件矩阵、部门矩阵、分部矩阵、matrix、映射表、行 id、rowId、syncType | `references/hrm/guide-matrix.md` |
+| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
+| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
+| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
+| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
+| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
+| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
+| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
+| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
+| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
+| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
+| 页面设计器、配置式页面、仪表盘、看板页、designer、page create、comp-add、工厂模板、factory、组件模板、页面布局、designer layout/save、页面版本、version revert、发布页面菜单、publish-menu、自定义CSS、组件样式、选择器、DOM结构、样式不生效 | `references/ebuilder-designer/guide-designer.md`（布局层主干）· `guide-designer-components.md`（组件 config）· `guide-designer-factory.md`（工厂模板）· `guide-designer-version.md`（版本）· `guide-designer-css.md`（自定义 CSS 与 DOM 结构索引） |
+
+## Reference（参考手册）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| 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` |
+| 完整实施方案、规划能力地图、资源依赖、需求映射、plan 前预检 | `references/common/map.md`，随后使用 `references/common/guide-plan-template.md` |
+| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
+| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单 | `references/menu/system-menus.md` |
+| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
+
+## Components（组件文档）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| Button、按钮 | `references/components/@weapp-Button.md` |
+| Table、表格 | `references/components/display-Table.md` |
+| List、列表 | `references/components/display-List.md` |
+| Pagination、分页 | `references/components/display-Pagination.md` |
+| Icon、图标 | `references/components/display-Icon.md` |
+| Avatar、头像 | `references/components/display-Avatar.md` |
+| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
+| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
+| Input、输入框、文本框 | `references/components/form-Input.md` |
+| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
+| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
+| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
+| Badge、徽标 | `references/components/base-Badge.md` |
+| Tag、标签 | `references/components/base-Tag.md` |
+
+## 组合场景
+
+| 场景 | 需加载的文档 |
+|------|-------------|
+| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
+| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
+| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
+| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
+| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
+| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
+| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |

package/skill-docs/actionflows/SKILL.md

@@ -58,7 +58,8 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 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 在任何平台写接口前直接报错。
 11. 根触发节点的 `event.attr.icon` 必须使用平台真实图标：`CustomTrigger` 为 `Icon-N-Triggerrul`，`InnerMQListener` 为 `Icon-built-in-mq-listening-mcolor`；组件目录里的动作图标不能覆盖根触发器图标。保存后回读必须同时检查触发器图标、已声明输入参数的数量和查询字段，不能仅凭 `valid=true` / `saved=true` 判定配置正确。
-12. `InnerMQSend.sendParams.tableData` 必须遵循“参数类型决定数据类型候选”的平台规则：普通非数组标量通常只有“属性”一个选项，不应伪造可下拉状态；数组或 `json/xml/xml_string` 结构化参数才按真实候选设置 `dataType`，结构化参数的下级用 `parentId` 表达，并保留父子约束。具体规则见 `references/components/message/InnerMQSend.md`。
+12. 仅在生成 `ParamMappingBean`、`ParamSettingBean`（及其同形态的参数分组 DTO）的 `tableData[].paramType` 时，按后端 `com.weaver.esb.base.enums.ParamType` 归一化：无法匹配枚举值回退为文本 `string`；数字类型统一为整数 `int`；长整型统一为文本 `string`。这条规则不适用于普通 `FormulaBean`、表单字段上下文、循环上下文或 `CustSetFormDto`。`paramType=json` 或 `arrs=true` 时 `dataType` 强制为节点 `node`，不能保留/生成属性 `attribute`；其他普通标量默认使用属性，结构化参数的下级用 `parentId` 表达，并保留父子约束。具体规则见 `references/components/message/InnerMQSend.md`。
+12.1. 所有组件的动态字段最终都必须生成合法的 `FormulaBean`，统一按以下五类来源处理：①普通组件上下文只能使用该组件 `getComponentContext` 返回的字段元数据；②循环体字段使用前端循环上下文拼出的 `CycleParams`，并保留循环数据源的真实来源；③`EsbFormDataDto` 的依据值下级按表单设置组件的 `basisValue`、`parentName`、`paramName` 和数组层级规则生成；④`ParamMappingBean`/`ParamSettingBean` 的依据值下级按参数设置组件的相对 `paramKey` 和 `basisParamKey` 规则生成；⑤`CustSetFormDto` 的依据值下级沿用表单设置组件规则。不能按字段名、paramKey 尾段、组件默认根或临时 ID 凭空补造 `frontId`、`parentName`、`paramKey`、`newParentName`；缺少真实上下文时应在预检阶段报错。
 
 ### 4. 生成与逐场景反馈
 

package/skill-docs/actionflows/references/components/message/InnerMQSend.md

@@ -32,6 +32,8 @@
 
 ### 参数类型与数据类型联动
 
+CLI 生成 `ParamMappingBean`、`ParamSettingBean` 及其分组 DTO 的 `tableData` 时才归一化参数类型：依据后端 `ParamType` 枚举匹配；数字类型统一写 `int`，长整型写 `string`，无法匹配写 `string`。普通 `FormulaBean`、表单字段上下文、循环上下文和 `CustSetFormDto` 不使用这套归一化。如果 `paramType` 为 `json` 或字段开启 `arrs`，`dataType` 强制写为 `node`；普通非数组标量默认写为 `attribute`。
+
 `tableData` 中每一行的 `paramType` 决定 `dataType` 的合法候选和是否允许继续加下级，不能只把 `dataType` 当成一个任意字符串填写：
 
 - 普通标量（如 `string`、`int`、`boolean` 等）且 `arrs:false` 时，合法数据类型只有“属性”；平台因此不会显示数据类型下拉，这是正常行为。
@@ -41,4 +43,8 @@
 
 因此，需求只要求一个数据类型时不要伪造下拉；需求需要多种数据类型或下级节点时，必须按真实参数类型构造 `tableData` 层级。
 
+### FormulaBean 动态来源的统一规则
+
+上述参数类型规则只作用于参数 DTO；所有组件的动态字段生成 `FormulaBean` 时，还必须统一遵循五类来源：普通组件上下文取对应 `getComponentContext` 的真实字段；循环体取前端拼出的 `CycleParams` 并保留列表来源；`EsbFormDataDto`、`ParamMappingBean`/`ParamSettingBean`、`CustSetFormDto` 的依据值下级分别使用各自前端的 basisValue/相对 paramKey/parentName 规则。真实字段的 `frontId`、`paramKey`、`parentName`、`newParentName` 不可由字段名或路径尾段猜测，预检无法取得时直接失败。
+
 `InnerMQSend` 与触发器 `InnerMQListener` 不能同时出现在一个动作流中，包括条件和循环内部；CLI 会在创建或更新前拒绝该计划。

package/skill-docs/actionflows/references/components/personnel/HrmEmployeeUpdate.md

@@ -14,9 +14,11 @@
 ## 业务边界
 
 - `operators`、`person` 支持固定人员 Browser 原对象、当前用户、上游人员上下文以及已解析的变量/常量/函数公式。固定人员仍必须是真实 Browser 对象，动态引用不能手输人员 ID。
-- plan 只传 `fieldAssignments`，CLI 基于实时定义生成平台 `setting`；不允许手写 DTO。
+- plan 只传 `fieldAssignments`，CLI 交给通用 `EsbFormDataDto` 生成器，基于实时定义和更新模式生成平台 `setting`；不允许手写 DTO。
 - Browser 字段必须匹配字段的真实选择器对象；字段名重名时必须传字段 ID。
 - 至少提供一个待更新字段；字段、对象或必填约束无法解析时，停止生成。
+- 生成的 `setting` 统一使用通用 `EsbFormDataDto` 生成逻辑，并使用 `update_original` 模式：主表、明细表都会按实时字段定义生成完整骨架，未修改主表字段为 `{"formFieldKey":"","value":{"original":true}}`，未修改明细字段为 `{"formFieldKey":"","value":{"original":true,"assign":null}}`。
+- `setting` 统一补充 `dataDrWithCalc=false`、`deleteMainFields=[]`，每张输出的明细表带 `deleteFields=[]`；动态赋值字段、原值占位字段和 DTO 外壳都由公共生成器处理。
 
 ## 语义计划形状
 

package/skill-docs/actionflows/references/components/personnel/PersonnelAlterType.md

@@ -0,0 +1,38 @@
+# 人员状态变更
+
+组件类型：`PersonnelAlterType`。先运行 `component-describe PersonnelAlterType`。
+
+## 何时使用
+
+用于提交试用、入职、续签、调动、解雇、退休、离职和返聘等人员状态变更表单。只修改简单的在职/离职账号状态时，使用 `AlterPersonStatus`。
+
+## 生成前查询
+
+1. 使用 `recipient-search` 取得操作人的当前租户 Browser 原对象；也可以使用当前用户或上游人员上下文。
+2. 使用 `hrm-alter-type-fields {"personnelType":"redeploy"}` 按目标状态读取当前租户实时字段。不同 `personnelType` 的字段不能混用。
+
+## 业务边界
+
+- `personnelType` 是后端实体中的普通字符串，只支持 `trial`、`hire`、`extend`、`redeploy`、`dismiss`、`retire`、`quit`、`rehire`。
+- plan 只传 `fieldAssignments`，格式为 `{ "字段ID或唯一字段名": 值 }`；不要手写后端 `setting` 或 `FormulaBean` DTO。
+- 字段定义来自 `/api/bs/esb/setting/component/getHrmTypeField`，生成器会按实时 `items` 校验字段并使用真实字段 ID。字段名重名时必须传字段 ID。
+- 文本字段生成前端 `textarea#...#` 容器，多选字段生成 `multipleSelect#...#` 的 JSON 容器，Browser 字段保留真实选择对象的 ID、名称和原始值。
+- 后端 `save` 将 `operators` 保存为操作人公式，将 `setting` 保存为 CommonForm；因此本组件的 `setting` 是 `Map<String, FormulaBean>`，不属于 `EsbFormDataDto`，不会生成新增/更新表单的 `main/detail` 骨架。
+- 至少提供一个字段赋值；字段定义或动态引用无法解析时停止生成。
+
+## 语义计划形状
+
+```json
+{
+  "type": "PersonnelAlterType",
+  "params": {
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "personnelType": "redeploy",
+    "fieldAssignments": {
+      "switchDate": "1",
+      "newDepartment": {"id": "<部门ID>", "name": "<部门名称>"},
+      "notice": ["同步薪资", "通知直属上级"]
+    }
+  }
+}
+```

package/skill-docs/actionflows/references/components/personnel/PersonnelOnboarding.md

@@ -1,34 +1,36 @@
-# 人员入职
-
-组件类型：`PersonnelOnboarding`。先运行 `component-describe PersonnelOnboarding`。
-
-## 何时使用
-
-用于新增人员到系统。它没有“目标人员”参数：人员由入职字段创建。若人员已经存在并只需改资料，改用 `HrmEmployeeUpdate`。
-
-## 生成前查询
-
-1. 使用 `recipient-search` 取得操作人的当前租户 Browser 原对象。
-2. 使用 `hrm-onboarding-fields '{}'` 取得当前租户人员主表、明细、字段类型和必填项。
-
-## 业务边界
-
-- plan 传 `fieldAssignments`，CLI 根据实时字段定义生成平台 `setting`；不允许手写 `setting` / `EsbFormDataDto`。
-- 字段可用显示名或字段 ID。当前租户出现同名字段时必须使用字段 ID。
-- Browser 字段（部门、岗位、上级等）只接受其对应选择器返回的真实对象，不能把名称或 ID 当文本填入。
-- 未提供当前租户必填字段、或字段/取值无法解析时，停止生成并报告缺项。
-
-## 语义计划形状
-
-```json
-{
-  "type": "PersonnelOnboarding",
-  "params": {
-    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
-    "fieldAssignments": {
-      "main": {"姓名": "张三", "部门": {"id": "<真实部门ID>", "name": "研发部"}},
-      "detail": [{"table": "教育经历", "fields": {"学校名称": "某大学"}}]
-    }
-  }
-}
-```
+# 人员入职
+
+组件类型：`PersonnelOnboarding`。先运行 `component-describe PersonnelOnboarding`。
+
+## 何时使用
+
+用于新增人员到系统。它没有“目标人员”参数：人员由入职字段创建。若人员已经存在并只需改资料，改用 `HrmEmployeeUpdate`。
+
+## 生成前查询
+
+1. 使用 `recipient-search` 取得操作人的当前租户 Browser 原对象。
+2. 使用 `hrm-onboarding-fields '{}'` 取得当前租户人员主表、明细、字段类型和必填项。
+
+## 业务边界
+
+- plan 传 `fieldAssignments`，CLI 交给通用 `EsbFormDataDto` 生成器，根据实时字段定义生成平台 `setting`；不允许手写 `setting` / `EsbFormDataDto`。
+- 编译后的 `setting` 统一使用通用 `EsbFormDataDto` 生成逻辑，并使用 `create` 模式：主表、明细表都会按实时字段定义生成完整骨架，未赋值主表字段为 `{"formFieldKey":""}`，未赋值明细字段为 `{"formFieldKey":"","value":{"assign":null}}`。
+- `setting` 统一补充 `dataDrWithCalc=false`、`deleteMainFields:[]`；每张输出的明细表带 `deleteFields:[]`。动态赋值字段和空字段都由公共生成器处理，入职组件不重复实现 DTO 保存逻辑。
+- 字段可用显示名或字段 ID。当前租户出现同名字段时必须使用字段 ID。
+- Browser 字段（部门、岗位、上级等）只接受其对应选择器返回的真实对象，不能把名称或 ID 当文本填入。
+- 未提供当前租户必填字段、或字段/取值无法解析时，停止生成并报告缺项。
+
+## 语义计划形状
+
+```json
+{
+  "type": "PersonnelOnboarding",
+  "params": {
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "fieldAssignments": {
+      "main": {"姓名": "张三", "部门": {"id": "<真实部门ID>", "name": "研发部"}},
+      "detail": [{"table": "教育经历", "fields": {"学校名称": "某大学"}}]
+    }
+  }
+}
+```

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

@@ -44,7 +44,9 @@
           }
         ]
       },
-      "authAppIds": []
+      "authAppIds": [
+        { "id": "app-1", "content": "普通应用-wull" }
+      ]
     }
   }
 }
@@ -58,7 +60,7 @@
 
 Webhook 请求运行时由平台解析为三个上下文分组：`Params`、`Header`、`Body`。动作参数中的上下文引用使用完整路径，例如 `Params.orderId`、`Header.Authorization`、`Body.customer.name`；不要把它们写成 `FormData.*`。
 
-生成前 CLI 会使用当前会话调用 `openApplicationBrowser` 完成接口，并把返回的应用归一化为 `{ "id": <应用ID>, "content": "<应用名称>" }` 写入 `authAppIds`。默认使用接口返回的全部应用；如需限定范围，可在语义计划中传 `authAppNames: ["普通应用-wull"]`。认证应用为空时 Java 组件仍可保存，但请求可能无法通过开放平台认证。
+`authAppIds` 是 WebHook 触发器的必填认证应用列表，元素必须是 `{ "id": <应用ID>, "content": "<应用名称>" }`。生成前 CLI 会使用当前会话调用 `openApplicationBrowser` 并自动回填；默认使用接口返回的全部应用。如需限定范围，可在语义计划中传 `authAppNames: ["普通应用-wull"]`，CLI 会将筛选结果写入 `authAppIds`。没有认证应用时，CLI 不应生成 WebHook 触发器。
 
 ## 终止节点响应
 

package/skill-docs/references/app/guide-app-publish.md

@@ -0,0 +1,92 @@
+# 应用发布：启用 → 发布到前台 → 改发布信息 → 取消发布
+
+应用建出来只是「壳」。要让成员真正在前台用上，还要走**启用**和**发布到前台**两步；
+应用名还可以按语言给不同显示。
+
+## 一、四个动作与先后关系
+
+| 命令 | 作用 | 前置 |
+|---|---|---|
+| `app enable <appId>` | 启用应用 | — |
+| `app publish <appId>` | 发布到前台（应用中心里出现入口） | 先 `enable` |
+| `app publish-info <appId>` | 改前台的显示名 / 简介 / 分类 | 先 `publish` |
+| `app unpublish <appId>` | 取消发布（收回前台入口） | 先 `publish` |
+
+`app read <appId>` 里的 `publishEnabled`：`1` 已启用、`2` 已停用、`0` 从未启用。
+
+> ⚠️ **停用会连带收回已发布状态。** 前台那句「应用暂未启用，启用后才可以发布给成员使用」
+> 说的就是这个 —— 别把 `app disable` 当成「临时关一下、发布态还在」。
+
+## 二、发布
+
+```bash
+e10-cli app enable <appId>
+e10-cli app publish <appId> --name "会议室管理" --description "预约与审批" --category 综合办公
+```
+
+- `--name` 不给就用应用名；`--description` 不给就用应用描述。
+- `--category` 是**应用中心里的分类**：汇报 / 协作 / HRM / 审批 / 数据协作 / 综合办公 / CRM / 自定义。
+  不指定则落**自定义**。
+- 发布后前台入口的地址形如 `/ebdapp/view/<appId>`。
+
+> ⚠️ **每次发布都会生成一个新的前台 id**，取消后重新发布**不会**沿用旧号。
+> 别把这个 id 当稳定标识存下来，要用的时候现查（`app publish-info` 会报出来）。
+
+## 三、改发布信息
+
+`app publish-info` 改的是**前台那份配置**（显示名 / 简介 / 分类），
+**不动应用本身的名称与描述** —— 后者用 `app edit`。
+
+```bash
+e10-cli app publish-info <appId> --name "新的前台名"
+e10-cli app publish-info <appId> --description "改后的简介"
+e10-cli app publish-info <appId> --category CRM
+```
+
+三个参数至少给一个；不给分类就**沿用现有的**，不会被打回「自定义」。
+
+## 四、取消发布
+
+```bash
+e10-cli app unpublish <appId>
+```
+
+> ⚠️ **不可逆**，也没有回收站。移除后前台入口消失，成员看不到；
+> 重新发布会是一个**新入口**。命令会回读确认入口确实没了才报成功，
+> 重复执行只会提示「未发布到前台，无需取消」。
+
+## 五、应用名多语言
+
+应用名可以按语言给不同显示。
+
+```bash
+e10-cli app lang get <appId>              # 看各语言当前值
+e10-cli app lang set <appId> --en "Meeting Room"
+e10-cli app lang set <appId> --zh "会议室管理" --en "Meeting Room"
+```
+
+- **简体中文那档就是应用名本身。** 只给 `--en` 时，命令会先把现有各语言读回来再整份写回，
+  **不会**出现「只改英文、中文被清空」。
+- 简体中文缺省沿用应用当前名称，可以用 `--zh` 显式覆盖。
+- 已经建过多语言标签时是**原地更新**，不会堆积一堆标签。
+- 单独改应用名（`app edit --name`）**不动**多语言配置，两者互不干扰。
+
+## 六、命令一览
+
+| 命令 | 说明 |
+|---|---|
+| `e10-cli app enable <appId>` | 启用应用 |
+| `e10-cli app disable <appId>` | 停用应用（**会收回已发布状态**） |
+| `e10-cli app publish <appId> [--name] [--description] [--category]` | 发布到前台 |
+| `e10-cli app publish-info <appId> [--name] [--description] [--category]` | 改发布信息 |
+| `e10-cli app unpublish <appId>` | 取消发布 |
+| `e10-cli app lang get <appId>` | 查看应用名多语言 |
+| `e10-cli app lang set <appId> [--zh] [--en]` | 设置应用名多语言 |
+
+以上命令都支持全局 `--json`。
+
+## 关联
+
+- 应用本身的增删改查（`create` / `list` / `folder` / `read` / `edit` / `delete`）：
+  [`ref-cli-commands.md`](../common/ref-cli-commands.md) 的 app 段
+- 前台入口的可见范围（谁能看到这个应用）：`menu` / `menu-permission` 那套