weaver-e10-builder 1.1.9 → 1.2.3

package/skill-docs/references/common/ref-cli-commands.md

@@ -46,18 +46,27 @@
 | `e10-cli form read <objId> --app-id <appId> --out fields.json` | 读取字段含选项（Select/RadioBox/CheckBox 自动带 options）。**含明细表字段**，配动作流/联动拿明细 fieldId 用这个 |
 | `e10-cli form list <appId>` | 列出应用下的所有表单 |
 | `e10-cli form create <appId> <name> <dir> --fields @<json文件>` | 创建表单。`--fields` **必填**。支持 DetailTable(嵌套formFields)、EBuilder(sformId+dataTitle)、relateFrom(联动)。fields.json 字段可带 `"required":true`/`"readOnly":true` 直标（写进布局 comps）。**字段名与平台系统字段重名（标题/创建者/创建时间/数据ID/最后更新人/数据状态）→ 不新建物理字段、复用系统字段**，并把该字段在**布局置为可见**（platform 系统字段默认隐藏；可写 `"singleRow":true` 独占一行、`"hidden":true` 保持隐藏）。`--json` 返回 `skippedSys`。**默认不加菜单**，要入口传 `--menu`（台账菜单 VIEWPORT）；漏加 `e10-cli menu add-table <appId> <objId>` 补 |
+| `e10-cli form virtual source-groups` / `sources <groupId>` | 查询 EB 表单和系统业务数据源分组、数据源列表 |
+| `e10-cli form virtual dataset-groups` / `datasets <groupId>` / `dataset-info <id>` | 查询数据加工分组、数据集和数据集定义 |
+| `e10-cli form virtual fields <appId> --source-id ... --source-group ...` | 校验数据源 ID 字段并读取可映射字段 |
+| `e10-cli form virtual create <appId> <name> --source-id ... --source-group ... --fields @json` | 创建虚拟表；`--source-type LOGIC|ETEAMS`，支持 `--layout FLOW|EXCEL`。字段默认沿用来源类型，只允许兼容的同族展示类型 |
+| `e10-cli form virtual read <objId> <appId>` | 读取虚拟表来源、字段映射和默认视图信息 |
+| `e10-cli form virtual add-fields <objId> <appId> <formId> --source-id ... --source-group ... --fields @json` | 从原数据源向虚拟表增加字段 |
 | `e10-cli form add-field <objId> <appId> <name> <type> [title]` | 添加字段。`<type>`=componentKey（Text/Select/Employee/Money/DetailTable 等同 form create）；`[title]` 字段显示名，不传同 name。Select 类型需单独 `field-options` 配选项。**`--sub-form-id <明细表subFormId>` 在明细表里加字段**（自动重新布局）。Number 类型：**`--percent` 百分比显示**（numberType=percentage，缺省 1 位小数）、**`--default <值>` 默认值**（如 `--default 1000` 工时单价默认 1000）、`--precision <n>` 精度。**EBuilder/Flow 类型**：`--sform-id <目标表单objId>`（EBuilder 表关联 / Flow 浏览-流程字段，数据来源=浏览流程）。EBuilder 字段**自动配关联浏览弹窗显示列**（=目标表全部业务字段，去系统字段）。**`--multiple` 多选**（人员/部门/EBuilder/Browser 默认单选；**下拉 Select --multiple → SelectMultiple 类型**）。**`--max-len <n>` 文本最大长度**（Text 缺省 100、TextArea 缺省 4000）。**`--single-row` 独占一行显示**。**`--option-template <模板ID或名>` Select 绑定选项预设模板**（选项来自模板，与 `field-options` 二选一） |
 | `e10-cli form detail-table list/read <objId> <appId> [...]` | 列出明细表，或读取指定明细表的二级明细开关与配置 |
-| `e10-cli form detail-table sub-detail set <objId> <appId> <父明细表> --target <子明细表> --target-field <子字段> [--default-expand]` | 开启并设置二级明细。表和字段可写名称或 ID；默认采用平台实测的 `rowId/inside/single`，保存后自动回读。另有 `enable`、`disable`（保留配置）、`clear`（清空配置） |
-| `e10-cli form edit-field <objId> <appId> <fieldId>` | 编辑字段属性。`--title`/`--required`/`--no-required`/`--sform-id`(改EBuilder关联)/`--relate-from`(值带出)/**`--multiple`/`--no-multiple`**（人员/部门/EBuilder/Browser 多选切换） |
+| `e10-cli form detail-table sub-detail candidates <objId> <appId> <父明细表>` | 查询当前父明细可选择的子明细；列表排除自身、直属父级和祖先。反转父子方向时，先 `remove` 原关系，再查询新父级候选并 `add` 反向关系 |
+| `e10-cli form detail-table sub-detail add <objId> <appId> <父明细表> --target <子明细表> --target-field <子级文本标识> [--parent-field <父级标识>] [--default-expand]` | 保留已有关系并增加或更新一条二级明细关系。父级标识缺省 `rowId`，也支持 Text/RadioBox/Select；子级标识必须是 Text。表和字段可写名称或 ID，保存后自动回读 |
+| `e10-cli form detail-table sub-detail set <objId> <appId> <父明细表> --target <子明细表> --target-field <子级文本标识> [--parent-field <父级标识>] [--default-expand]` | 完整替换父明细的子明细配置。另有 `remove --target <子明细表>` 删除指定关系，`enable`、`disable`（保留配置）、`clear`（清空配置）；完整规则见 `references/form/guide-form-sub-detail.md` |
+| `e10-cli form edit-field <objId> <appId> <fieldId> [选项]` | 编辑字段属性。`--title` 显示名、**`--type <类型>` 改字段类型**（取值同 `add-field`，如 `Text`/`Number`/`Date`/`Select`/`Department`；走读-改-写，**不用删字段重建**，显示名/列名/位置都保留；改成 `EBuilder`/`Flow` 必须同时给 `--sform-id`）、`--required`/`--no-required`、`--sform-id`（改EBuilder关联）、`--relate-from`（值带出）、**`--multiple`/`--no-multiple`**（人员/部门/EBuilder/Browser 多选切换）、**`--data-title`**（关联字段的标题栏，写 `dataTitle`）。改成 `EBuilder` 或换关联表时，**浏览显示列按新目标表自动补齐**（只在没配过、或旧列不属于新目标表时才写，不冲掉手工配的）。**⚠ 字段已有数据时平台拒绝改动结构**（显示名例外）——报「此列已存在数据不可修改数据库字段名称」，该文案与实际情况不符，它拦的不止字段名 |
 | `e10-cli form field-lang get <objId> <appId> <fieldId>` | 查看字段名称的中英文多语言配置；未配置时返回当前中文名称和 `configured:false` |
 | `e10-cli form field-lang set <objId> <appId> <fieldId> --zh <中文> --en <English>` | 设置字段名称多语言。先保存多语言标签，再读取完整字段并回写 `labelObj.title`，不会覆盖字段其他属性 |
-| `e10-cli form serial-mark set <objId> <appId> <fieldId> --segments @<json>` | **表单编号**（纯建模表）：用 JSON 数组组合任意编号规则，数组顺序即拼接顺序。段类型 `fixed`/`year`/`serial`/`field`/`system`/`date`；field 段可 inline `shortName` 代字映射。子命令组：`set`(配置,--segments) / `add-segment`(增量追加段) / `short-name`(代字 list/set) / `read`(查看) / `fields`(查可绑定字段) / `clear`(解除)。被编码字段平台自动只读。**⚠ 仅对未绑流程的纯建模表有效——eb表单绑流程后表单编号字段在流程提交时不生效，编号改走流程编号（`workflow numbering`，落到 REQUEST_NO 系统字段）** |
+| `e10-cli form serial-mark set <objId> <appId> <fieldId> --segments @<json>` | **表单编号**（纯建模表）：用 JSON 数组组合任意编号规则，数组顺序即拼接顺序。段类型 `fixed`/`year`/`serial`/`field`/`system`/`date`；field 段可 inline `shortName` 代字映射。子命令组：`set`(配置,--segments) / `add-segment`(增量追加段) / `short-name`(代字 list/set) / `read`(查看) / `fields`(查可绑定字段) / `enable`(启用) / `disable`(停用，可加 `--field <fieldId>` 只停某一个字段的编号) / `clear`(解除绑定)。**`disable` 停用 ≠ `clear` 解除**：停用只关开关（`isUse=0`），绑定记录与组成段原样保留、可 `enable` 恢复；解除走删除接口，绑定不可逆。要「暂时不生成编号」一律用 `disable`。被编码字段平台自动只读。**⚠ 仅对未绑流程的纯建模表有效——eb表单绑流程后表单编号字段在流程提交时不生效，编号改走流程编号（`workflow numbering`，落到 REQUEST_NO 系统字段）** |
 | `e10-cli form field-options <objId> <appId> <fieldId> --options @<json> [--default <key>]` | 设选项/默认值。options.json: `[{"name":"选项名","valueKey":"可选"}]`；`--default` 用平台生成的长 valueKey（`form read --app-id` 获取），不是 name |
 | `e10-cli form option-template <list\|read\|create\|copy\|delete>` | **Select 选项预设模板管理**（下拉选项复用：多个表单共享一套选项，模板改了各表单跟着变）。`list [--system]` 列模板（默认自定义模板，--system 看系统内置）；`read <模板ID> [--flat]` 看选项树；`create <名称> --options @<json> [--level 1] [--describe 文本]` 建模板（options.json: `[{"name":"低","valueKey":"10","children":[]}]`，**valueKey 必须数字**，children 嵌套=多级）；`copy <模板ID>` 复制（系统 default 模板不可复制）；`delete <模板ID>` 删模板（被引用时平台拒绝）。**字段引用模板**：`form add-field --option-template <模板ID或名>` 或 fields.json 写 `"optionTemplate":"模板名"`（Select 专有，选项不内联） |
 | `e10-cli form linkage add <appId> <objId> <name> --config @<json>` | 添加字段显隐联动规则 |
 | `e10-cli form relate <appId> <objId> <目标字段> --from <源字段>` | **HRM 值带出联动**：源字段为表内 Employee（人员）或 Department（部门）类型，换源自动填目标字段（换申请人→填邮箱/工号/部门；换所属部门→填部门编号/上级部门）。`--key` 从平台清单校验（默认 Employee=department、Department=name），`--title` 指定显示名（默认属性中文名）。详见 `form/guide-form-linkage.md` |
-| `e10-cli form delete <objId> <appId>` | 删除表单 |
+| `e10-cli form delete-field <objId> <appId> <fieldId...>` | **删除字段**（可一次多个，批量）。**仍被布局引用的字段平台不允许删除**（报「当前字段已被布局引用，不允许删除」）；加 `--force` 时 CLI 先从布局移除再重试——会**连字段的标题组件一起摘**（一个字段在布局里是「字段本体 + 标题标签」两个组件），否则表单上会留下孤儿标签。字段**有数据**时同样删不掉 |
+| `e10-cli form delete <objId> <appId>` | 删除**整个表单**（不是字段；删字段用上面的 delete-field） |
 | `e10-cli form permission data add <objId> <appId> --org-type <类型> [--org-id <id>] --rights <view/edit/delete...> [--file-rights <view/download...>]` | **表单数据权限**，`1/view=查看`、`2/edit=编辑`、`3/delete=删除`，可任意组合；附件 `401/view=查看`、`402/download=下载`。固定写入 `obj_data_admin` 并按新增权限 ID 回读。授权对象支持 all/role/department/company/employee/group/post；all 的 orgId 自动为 0 |
 | `e10-cli form permission imp-exp <list\|add> <objId> <appId> ...` | **导入导出权限**（独立分类 `data_imp_exp`，⚠ 勿用 `data add` 加——共享权限只有 查看/编辑/删除 三种，导出/导入不在其中）。`list` 查看；`add --org-type <类型> [--org-id] --rights <export/import/delete-import...> [--update-import] [--export-details] [--export-attachment] [--export-field-range listShowField|all]`。`export=8`、`import=9`、`delete-import=93`（93 须与 import 同选，自动带更新导入）；添加后按权限 ID 回读 `impRightList` 校验。删除同 `permission remove --right-id` |
 | `e10-cli form permission <list\|add\|remove\|rebuild> <objId> <appId>` | 权限通用管理及兼容入口。新建权限与数据权限分开；旧 `add --right-type` 保留兼容。`list` 查看全部分类；`remove --right-id <id[,id...]>` 删除一条或多条权限；添加后提示 `isShowRebuild=2` 时执行 `rebuild` |
@@ -69,6 +78,8 @@
 | `e10-cli form ebuilder-columns <objId> <appId> <fieldId> [字段名/ID...] [--clear]` | 设置 EBuilder 关联字段的**浏览显示列**（存在字段配置 `ffDisplayColumns:{id,name}[]`）。**缺省查看**：列出当前显示列 + 目标表单全部**业务字段候选**（系统字段已自动过滤，不设显示列时浏览走平台默认列会带系统字段）；**传目标表业务字段名/ID 设置**，系统字段会被拦截提示"系统字段不能设为显示列"；`--clear` 清空。关联浏览显示哪些字段（只留业务字段） |
 | `e10-cli form ebuilder-scope <get\|set\|clear> <objId> <appId> <fieldId>` | **浏览数据定义 → 数据范围设置**（关联浏览字段，限定被关联数据须满足条件才可选，如关联客户只选"客户状态=启用"的）。走 `browserDataScope` 接口（独立于字段布局）。`set --rules '[{"field":"客户状态","operator":"eq","value":"启用"}]'`（选项类 value 用选项名，CLI 自动解析 valueKey）；`--logic and/or` 多规则关系；`--fill-null` 关联字段为空时填充；`get` 读已设条件；`clear` 清空。**这是关联浏览筛选的正解**，旧 `ebuilder-filter` 走 layout/save 不被设计器识别 |
 | `e10-cli form validate list <objId> <appId>` | 查看表单**查重规则**（字段重复校验，多字段 AND）。`add <objId> <appId> <字段名...> [--help 提示] [--remind]` 新增（缺省禁止提交 NOSUBMISSION，`--remind` 仅提醒）；`delete <objId> <appId> <ruleId>` 删除。项目名称重名/工时日期重复不允许 |
+| `e10-cli form add-detail-table <objId> <appId> <明细表名> [首字段名] [--init]` | 给**已存在的主表**加明细子表（saveSubForm 建子表 + 加首字段使其可见）。`--data-key <物理表名>`、`--first-field-type <类型>`（默认 Text）。⚠ **空子表平台会过滤掉、布局里看不见**，首字段名强烈建议传；`--init` 建完把 DetailTable 组件放进布局。后续往明细里加字段用 `form add-field --sub-form-id <subFormId>`：建表时一次性带明细用 `form create` 的 fields.json `DetailTable`+`formFields` |
+| `e10-cli form delete-detail-table <objId> <appId> <subFormId\|明细表名>` | **删除明细表**（连带表里的字段）。平台不允许删**仍被布局引用**的明细表（报「当前【X】明细表已被布局引用，不允许删除」）—— 明细表只要在表单上就必然被引用，所以多数情况要加 `--force`：先把这张表的组件（本体 + 每列的「字段本体 + 标题标签」）从布局摘掉、清掉 workbook 里的残留，再删。删除是**软删**，记录仍在但不再算数 |
 | `e10-cli form list-search <objId> <appId> <listId> [--add <fieldId...>] [--quick <fieldId...>] [--remove <fieldId>] [--pc-only]` | 查看/配置台账**搜索条件**。`--add` 进搜索面板、`--quick` 加顶部快捷筛选（均支持多字段）、`--remove` 移除。主表字段直取 ds/fields；明细子字段自动 fallback `getFormField` 单取元数据。**自动保留移动端配置** |
 | `e10-cli form list-sort <objId> <appId> <listId> [--field <fieldId...>] [--order ASC\|DESC] [--clear] [--pc-only]` | 查看/配置台账**排序**。`--field` 支持多个（按传入顺序多级排序，`--order` 对所有字段生效）、`--clear` 清除。**自动保留移动端配置** |
 | `e10-cli form list-stats <objId> <appId> <listId> [--add <json或@文件>] [--remove <statId>] [--pc-only]` | 主表/明细顶部统计，sum/count/avg/max/min、条件及格式；明细 count 支持 `{ "type":"count", "subFormId":"..." }`。保存后回读、保护移动端；平台可能共享两端统计，输出 mobileStatistics。详见 `references/form/guide-list-stats.md` |
@@ -79,11 +90,13 @@
 | `e10-cli form list-hierarchy <objId> <appId> <listId> [--enable --parent-field <名称或fieldId> [--expand-level N]] [--disable] [--pc-only]` | 查看/配置**上下级树形展示**。上级字段必须是主表中单选、关联当前表单自身的 EBuilder 字段（常见名称“上级类型”）；与普通 `list-group` 分组聚合不是同一能力。走 `saveNListConfig config.superiorField`，保存后独立回读并自动保留移动端配置 |
 | `e10-cli form list-permission <objId> <appId> <listId> [--add-all] [--add-user <userId> --name <name>] [--add-role <roleId> [--name <name>]] [--add-matrix <矩阵id> --name <name>] [--share-level <n>] [--seclevel <min>-<max>] [--add-raw '<json>'] [--remove <id>] [--remove-all] [--clear]` | 查看/配置**台账视图权限**（谁能查看这个台账）。`--add-all` 所有人（自动把空 dataid 与 0 视为同一主体，避免重复）、`--add-user` 人员、`--add-role` 角色、`--add-matrix` 矩阵。`--remove <id>` 删除指定权限；`--remove-all` 删除全部“所有人”，与 `--add-all` 同用可清理重复后只保留一条；`--clear` 清空全部。保存走 `list/permission/save` 全量覆盖并回读。另支持共享级别和安全级别范围 |
 | `e10-cli form list-search-group <objId> <appId> <listId> [--add <fieldId>] [--remove <fieldId>] [--clear] [--pc-only]` | 查看/配置**分类搜索**（按选项字段分类筛选）。`--add <选项字段fieldId>`（须已在显示列）、`--remove <fieldId>`、`--clear`。走 saveNListConfig config.searchConditions.groupFilters（视图级明文）。**仅主表选项类字段 Select/RadioBox/CheckBox，不支持明细字段（产品边界，传明细报错）**。listGroupSets 留空由平台运行时生成 |
+| `e10-cli form nlist apply <objId> <appId> <listId> <template>` | 配置**列表式视图**（台账）的显示列：模板是二维数组（行 → 列），列项可绑表单字段（`fieldId`）或做**自定义文本**列（不给 `fieldId`、给 `html`，里面用 `{{字段名}}` 插入表单字段）。自动读移动端槽位一并写入。`show` 查看当前配置。⚠ 仅对列表式(NList)生效，表格式用 `form table-view`。详见 `form/guide-list-custom-text.md` |
 | `e10-cli form view list <objId> <appId> [--with-comps]` | 列出表单全部视图。`--with-comps` 额外拉每个视图布局 comps 数、标出空视图（NList 数据视图会显示「读取失败」，正常） |
 | `e10-cli form view rename <objId> <appId> <viewId> <新名称>` | 修改已有默认台账（nListView）的名称，保留原视图 ID 和配置，并在保存后回读确认。需求名称与默认名称不一致时统一用此命令，不新建重复视图 |
 | `e10-cli form view create <objId> <appId> <视图名> [--type formView\|kanbanView\|calendarView\|mindMapView\|multiView] [--terminal PC\|MOBILE] [--layout-type FLOW\|EXCEL] [--detail <明细名>] [--sub-form-id <明细subFormId>]` | 给**已有表单**添加视图。`formView` 创建后是空布局，需续跑 `form view populate` 填字段；`kanbanView`/`calendarView`/`mindMapView`/`multiView` 建视图实体。**multiView 数据维度**：缺省主表；明细表维度用 `--detail <明细名>`（按名解析）或 `--sub-form-id <明细subFormId>`（直传），传值即明细维度（`subFormMain:true`）。**台账(NList)视图**用 `form table-view create`，不在此命令 |
 | `e10-cli form view populate <objId> <appId> <viewId>` | 把已有字段按布局类型填入新增的 formView（视图为空时用这个填充） |
 | `e10-cli form layout read <objId> <appId> [--view-id <id>]` | 读表单布局结构（comps 坐标/只读）。不传 `--view-id` 读默认布局，传则读指定视图 |
+| `e10-cli form layout init <objId> <appId> [--style-template <名\|id>] [--view-id <id>] [--read-only] [--required] [--disable-edit] [--single-row]` | 初始化/重建表单布局（initLayout）：**换样式模板** + 覆盖字段 readOnly/required/disableEdit/singleRow（不传这些开关则**保留字段已有设置**）。**⚠ 样式模板流式与表格式是两套**，同名不同 id，按表单实际布局类型实时查（传错套会直接报错并列出可用项；**平台对跨套 id 不报错、只会静默忽略，表现为"命令成功但样式没变"**）。缺省：流式=标准版、表格式=表格版。完整模板表见 `form/style-templates.md`。**建表时不能指定样式，只能建完再用本命令换** |
 | `e10-cli form group <objId> <appId> --groups '{"基本信息":["字段名/fieldId",...]}'` | 给**已建好的 eb 表**加字段分组（折叠容器）。建组 saveFieldGroup → 分配 updateFormFieldGroup → initLayout generateCollapse 渲染。`--groups` 可 `@文件`；`--required` 同时设分组内字段必填；同名分组复用不重复建（去重）。建表时一次性带分组用 `form create` 的 fields.json `group` 属性 |
 | `e10-cli form data add <objId> <appId> <json>` | 写入表单数据（`@` 开头为 JSON 文件路径）。JSON key 可用 fieldId 或字段名；Select/RadioBox 值填选项名（自动解析 valueKey）或 valueKey、CheckBox/SelectMultiple 用数组、TextArea 直接值、Employee/Department 用 ID。详见 `form/guide-form-data.md` |
 | `e10-cli form data list <objId> [--page <n>] [--size <n>]` | 查询表单数据。`--page` 页码（缺省1）、`--size` 每页条数（缺省1000；不传 pageInfo 平台默认卡 10） |
@@ -144,11 +157,21 @@
 |------|------|
 | `e10-cli workflow create <appId> <formObjId> <name> [desc]` | 创建 EB 流程，当前命令按固定模式创建并自动设置所有人可发起。**默认不加菜单**，要入口传 `--menu`（发起菜单 LAYOUT，指向表单新建页 `/sp/ebdfpage/card/1/<formObjId>/0`，点开即触发流程）；漏加 `e10-cli menu add-start <appId> <formObjId>` 补 |
 | `e10-cli workflow create-workflow <name>` | **非默认路径**。仅当用户明确强调「用流程表单 / 工作流程 / 流程中心建流程、不在应用下」时才用；默认走上一条 `workflow create`（eb 应用内）。关联流程表单：不传 `--form-id` 自建（`relateForm=0`，服务端建表回吐 `data.formId`）/ `--form-id <已有>` 绑定（`relateForm=1`）。`--odoc` 创建公文流程（两种表单方式均支持，增加 `bridgeService=odoc`）；`--workflow-type`（默认 -1=其它）、`--sub-company <机构>`、`--belong-type <0个人/1团队>`（默认 1）、`--table-name`、`--desc`、`--is-free`、`--layout <FLOW流式(默认)/EXCEL表格式>`（自建模式下 EXCEL 走 formmanage/saveForm 建表后绑定；建表后不可切换）。不带 source/messageParams |
+| `e10-cli workflow auth-resp <list\|create\|update\|read\|configure\|save-design>` | 独立权责表管理。`configure <id> --config @json` 从零创建变量、开始/结束节点、中间节点及操作者、分支条件和路径并保存回读；`save-design` 用于完整设计结构的保留式保存 |
+| `e10-cli workflow auth-resp variable <list\|add>` | 独立管理权责表变量，变量先创建后供权责表条件引用。支持字符串、数值、选项、浏览和关联浏览变量 |
+| `e10-cli workflow auth-resp reference <list\|add\|remove>` | 管理权责表路径中的嵌套权责表。`list <宿主baseId>` 仅返回首尾为中间节点且不会形成循环引用的权责表；`add` 按分支与顺序写入 `addMethod=2` 的引用；`remove` 删除引用列及对应路径。 |
+| `e10-cli workflow auth-resp-flow create <name> --base @json (--new-table <name>\|--reuse-table <id>)` | 按权责表方式创建流程。新建模式直接使用表单字段；复用模式可加 `--mappings @json` 保存权责表变量到当前表单字段的映射 |
+| `e10-cli workflow auth-resp-flow <bind\|design-read\|design-apply\|mapping-read\|mapping-save>` | 对已有权责表流程维护绑定关系、权责表流转设计及变量映射。节点、分支条件和路径通过权责表设计维护。详细顺序见 `workflow/guide-workflow-auth-resp.md` |
 | `e10-cli workflow odoc <list\|read>` | 查询公文流程列表，或读取单个公文流程及公文设置摘要。`list` 支持 `--name`、`--sub-company`、`--belong-type`、分页参数 |
 | `e10-cli workflow odoc setting <get\|set> <workflowId>` | 读取或修改公文设置。`set --config @json` 读取当前配置后合并保存并回读；常用参数含 `--official-type`、`--request-title-field`、`--upload-word/pdf/ofd`、`--text-in-form`、`--column-position`、`--attach-area`、`--archive-node` |
 | `e10-cli wf-form read <formId>` | **流程表单管理（非默认路径）**。读流程表单字段（getConfig）。`<formId>` 由 `workflow create-workflow` 回吐。与 eb 表 `form read` 对齐，走 `/api/workflow/core/form/...`（module=workflow、customParam={}、无 apid） |
-| `e10-cli wf-form add-field <formId> <字段名> <类型> [标题]` | 给流程表单加字段。类型：Text/TextArea/Number/Money/Date/DateTime/Select/Employee/Department/Browser。`--sub-form-id <明细subFormId>` 明细字段；`--multiple` 多选；`--precision`/`--percent`/`--default`（Number/Money）；`--format`（日期精度）。formTableId 省略 |
+| `e10-cli wf-form add-field <formId> <字段名> <类型> [标题]` | 给流程表单加字段。类型：Text/TextArea/Number/Money/Date/DateTime/Select/Employee/Department/Browser（浏览按钮），**以及全部富组件类型**（Time/Score/Signature/Project/Location/Order/Contract 等，走与 eb 表同一张映射表）。`--sub-form-id <明细subFormId>` 明细字段；`--multiple` 多选；`--precision`/`--percent`/`--default`（Number/Money）；`--format`（日期精度）。formTableId 省略 |
+| `e10-cli wf-form add-field <formId> <名> Browser <标题> --browser-type <源>` | **浏览按钮必须指定浏览数据源**，否则平台报「程序异常」。源可选 `workflow`(缺省=工作流) / `hrcontract` / `role` / `archive` / `form`；用 `form` 时再配 `--browser-form-source business\|ebuilder`。落到平台是 `type=RelateBrowser` + `browserType:{module,name,id,type}` |
+| `e10-cli wf-form add-field <formId> <名> Browser <标题> --browser-name "CLM-合同类型"` | **按名字指定浏览数据源**，含自定义浏览框（`customBrowser_xxx`，没有固定 id 必须现查）。名字**精确匹配**，查不到会停下并列候选，不用近似项顶替。优先于 `--browser-type`。批量 `add-fields` 直接在 JSON 里写 `browserType:{...}` 对象 |
+| `e10-cli wf-form add-fields <formId> @fields.json [--no-init]` | **批量加字段**：JSON 数组每项 `{name,type,title?,subFormId?,multiple?,precision?,percent?,default?,format?,singleRow?,defaultCurrent?}`；加完**自动跑一次 layout init 重新布局**（`--no-init` 跳过）。字段多时比逐条 `add-field` 省事 |
+| `e10-cli wf-form ebuilder-scope <formId> <ebuilder字段Id> --rule "目标表字段:操作:值" [--sform-id <objId>] [--workflow-id <wfId>]` | 给流程表单的**关联浏览字段**设数据范围（如关联客户只选「客户状态=启用」的）。操作用 `eq`/`neq`/`like`/`isnull`/`notnull`；Select 值填**选项名**。对应 eb 表的 `form ebuilder-scope` |
 | `e10-cli wf-form edit-field <formId> <fieldId> [--title <标题>] [--multiple|--single]` | 编辑已有字段（read-modify-write）。`--multiple`/`--single`：Employee/Department/Browser 切 isSingle，Select↔SelectMultiple。必填为布局级用 `wf-form layout init --required` |
+| `e10-cli wf-form delete-field <formId> <fieldId...> [--force]` | 删除流程表单字段（可批量）。**仍被布局引用的字段平台拒删**；`--force` 让 CLI 先从布局摘掉这些字段的组件（含它的标题标签）再删。eb 表侧对应 `form delete-field` |
 | `e10-cli wf-form formula set <formId> --expression "DAYS({主表.开始时间},{主表.结束时间})" --target <fieldId>` | 给流程表单字段绑定计算公式。`{主表.字段}`/`{明细表名.字段}` 引用（getConfig 解析）→ `/api/excel/formula/save`(module=workflow) → ffExpress 绑字段 + saveSourceForm。`--name`/`--return-type`。另：`formula get <id>` / `list <formId>` / `functions` |
 | `e10-cli wf-form linkage <formId> <联动名> --config '{"conditions":[{"field":"请假天数","operator":"EQUAL","value":"3"}],"actions":[{"prop":"hide","fields":["请假事由"]}]}'` | 显隐联动。`--config` 写字段名（自动 getConfig 解析 fieldId/dataKey）。prop: hide/show/edit/readonly/required/hideLine；operator: EQUAL/NOT_EQUAL/GREATER/LESS/EMPTY 等 |
 | `e10-cli wf-form validate add <formId> <字段名...> [--remind] [--help <提示>]` | 字段查重规则（多字段 AND，重复禁止提交/提醒）。`list`/`delete <ruleId>`。字段名自动 getConfig 解析 |
@@ -165,7 +188,7 @@
 | `e10-cli workflow search` | 通用搜索流程（不依赖 appId）。`--name`/`--id`/`--type`/`--belong` |
 | `e10-cli workflow nodes <workflowId>` | 查看流程节点详情（名称、类型、操作者、连线含 linkId） |
 | `e10-cli workflow nodes <wf> --mode list` | 列表视图：展示全节点含 nodeAttr、合流方式（比 chart XML 更全） |
-| `e10-cli workflow set-operator <wf> <node> [keyword]` | 设置节点操作者。`--type user`(指定人) / `role`(指定角色) / `dept`(指定部门) / `position`(指定岗位) / `all`(所有人) / `free`(自由选择) / `superior`(发起人上级) / `initiator`(流程发起人本人) / `prev-node`(上一节点) / `form`(表单相关人员) / `matrix`(矩阵对应,需 `--matrix-id` `--value-config-id` `--matrix-rule`)。`--sign-order` 会签/非会签/竞签/依次处理/抄送/抄送需批注（form 类型也支持，概念见 guide-workflow）。**依次处理倒序**用 `--execute-order 2-2`(默认)/`2-1`正序/`1-1,2-2`安全级别正序+倒序。**`--dept-scope 本部门`**=单个部门内会签/`本及下级`默认。**一个节点多人用逗号分隔 keyword**（如 `"区域经理,部门领导"`，user/dept 都支持）；默认每次全量重建操作者组（先清空再新建），重复设置不堆积。**多操作者组叠加（如「部门领导矩阵 + 门店经理矩阵」双组会签）：先用 set-operator 配第一组，再用 `--append` 配第二组**，`--append` 不清空已有组，两组合起来就是双矩阵会签 |
+| `e10-cli workflow set-operator <wf> <node> [keyword]` | 设置节点操作者。`--type user`(指定人) / `role`(指定角色) / `dept`(指定部门) / `position`(指定岗位) / `all`(所有人) / `free`(自由选择) / `superior`(发起人上级) / `initiator`(流程发起人本人) / `prev-node`(上一节点) / `form`(表单相关人员) / `matrix`(矩阵对应,需 `--matrix-id` `--value-config-id` `--matrix-rule`)。`--sign-order` 会签/非会签/竞签/依次处理/抄送/抄送需批注（概念见 guide-workflow）；**`--type form` 另支持「或签」**，等价于竞签（表单字段里多人任一人签，语义一致），已登记的签署顺序里没有单独一档。**依次处理倒序**用 `--execute-order 2-2`(默认)/`2-1`正序/`1-1,2-2`安全级别正序+倒序。**`--dept-scope 本部门`**=单个部门内会签/`本及下级`默认。**一个节点多人用逗号分隔 keyword**（如 `"区域经理,部门领导"`，user/dept 都支持）；默认每次全量重建操作者组（先清空再新建），重复设置不堆积。**多操作者组叠加（如「部门领导矩阵 + 门店经理矩阵」双组会签）：先用 set-operator 配第一组，再用 `--append` 配第二组**，`--append` 不清空已有组，两组合起来就是双矩阵会签 |
 | `e10-cli workflow generate-link-id <wf>` | 生成新连线 ID |
 | `e10-cli workflow add-node <wf> <type> <name>` | 添加节点（列表 API）。`<type>`: 0=发起 1=审批 2=确认 3=归档 5=投递 7=自动处理 8=等待 / forkstart/forkend/forkmiddle。**结束节点=归档节点（type=3）**。`--node-attr` 节点属性；合流点支持 `--merge-type`（0=全部/1=指定/2=数量/3=比例）、`--merge-num`、`--branch-nodes` |
 | `e10-cli workflow rename-node <wf> <nodeId> <name>` | 重命名节点（saveNodeSetForm API） |
@@ -179,10 +202,32 @@
 | `e10-cli workflow numbering set <wf> [--prefix <前缀>] [--separator <ch>] [--serial <n>] [--no-year] [--dry-run]` | **配置流程编号规则**（一次设全组成）：前缀 + 流水号位数（默认4）+ 可选年份段。**`--separator <ch>` 段间分隔符**（如 `-` `~`）：在相邻段（前缀-年、年-流水）间自动插独立固定段 → `--prefix QXBK --separator ~ --serial 4` = `QXBK~2026~0001`；平台分隔符就是独立 FIX_CONTEXT 段、可多个固定段共存。`--dry-run` 只打印将产出的段序列（复用/新建/删除）不落库。旧版曾按类型只留一段会删掉已有分隔符段。`--prefix LC --serial 4 --no-year` → `LC0001`。比 `add-component` 逐个加更省事，常用这条 |
 | `e10-cli workflow numbering add-component <wf> --type fixed\|date\|field --value <text> --format <yyyyMMdd> --field-id <id>` | 添加编号组成项：fixed=固定内容 / date=日期 / field=表单字段 |
 | `e10-cli workflow numbering reserve <wf> <count> [--prefix]` | 预留编号。**流程编号=REQUEST_NO 系统字段**：eb表单绑流程后编号走本命令（不要用 `form serial-mark` 表单编号，那对流程表无效） |
-| `e10-cli workflow node validate <wf> <nodeId> --rule "主题字段 操作 值字段或字面值"` | 节点提交校验（智能审批规则，提交时拦截）。值可以是**字段**（字段 vs 字段）或**字面值**（字段 vs 常量）；主题字段支持**跨表**——用「明细表名.字段名」定位明细字段做主子表校验：`"请假时长 小于 4"`、`"行程明细.行程开始时间 等于 出差开始日期"`（明细字段=主表字段）。`--name` 规则名；`--disable` 关闭；`--view` 查看 |
+| `e10-cli workflow node validate <wf> <nodeId> --rule "主题字段 操作 值字段或字面值"` | 节点提交校验（智能审批规则，提交时拦截）。值可以是**字段**（字段 vs 字段）或**字面值**（字段 vs 常量）；主题字段支持**跨表**——用「明细表名.字段名」定位明细字段做主子表校验：`"请假时长 小于 4"`、`"行程明细.行程开始时间 等于 出差开始日期"`（明细字段=主表字段）。**操作符**：大于 / 大于等于 / 小于 / 小于等于 / 等于 / 不等于 / **为空 / 不为空**（后两个无需值，如 `"备注 不为空"`）。**明细量词**：明细字段的主题末尾可写 `:任一`（任一行，缺省）或 `:所有`（所有行），如 `"货品明细.货品名称:所有 不为空"`；主表字段写量词会报错。`--name` 规则名；`--disable` 关闭；`--view` 查看 |
 | `e10-cli workflow node menu <wf> <nodeId>` | 查看/切换节点操作菜单。`--toggle <menuId>` 切换启用状态 |
-| `e10-cli workflow node reject <wf> <nodeId>` | 配置节点退回设置。`--remind`/`--type`/`--checked-node`/`--submit-type` |
-| `e10-cli workflow node timeout <wf> <nodeId>` | 配置节点超时处理。`--time-type`/`--time-value`/`--flow-type`/`--remind-type` |
+| `e10-cli workflow node layout list <wf> [--terminal PC\|MOBILE]` | 列出该工作流表单的布局，以及每套被哪些节点引用 |
+| `e10-cli workflow node layout get <wf> <nodeId>` | 查看某节点挂的是哪套布局（空 = 跟随表单默认） |
+| `e10-cli workflow node layout bind <wf> <nodeId> --layout-id <id>` | 把节点挂到某套布局。**自动从原来那套摘掉**（一个节点同时只属于一套布局）；幂等 |
+| `e10-cli workflow node layout unbind <wf> <nodeId>` | 摘下独立布局，回落表单默认布局；幂等 |
+| `e10-cli workflow node layout create <wf> --name [--layout-type FLOW\|EXCEL] [--nodes <id...>] [--from <布局ID>\|--empty]` | 新建布局。**默认复制表单默认布局**（`--from` 换来源）；`--empty` 才是空白布局。类型不写则跟随来源，**建后不可切换**。删布局用 `wf-form layout delete` |
+| `e10-cli workflow node layout init <wf> <布局ID> [--fields <名...>] [--list-fields] [--style-template] [--required\|--readonly\|--single-row]` | 重建某套布局的排版（**只动这一套**）。`--fields` = 只摆这些字段（不传=全摆，没摆的字段在表单上仍在）；`--list-fields` 看可摆清单。`create --init [--fields …]` 可建完直接排 |
+| `e10-cli workflow node-reject get <wf> <nodeId>` | 查看节点退回设置（退回提醒 / 退回方式 / 默认选中 / 退回后提交） |
+| `e10-cli workflow node-reject set <wf> <nodeId> [选项]` | 设置节点退回规则。`--reject-type free\|step\|range\|byLink\|preApprover`（自由/逐级/指定范围/按出口/上一审批人）、`--submit-type step\|direct\|fork\|operator`、`--reject-remind none\|all\|nodes\|user`、`--default-node prev\|start\|custom`、`--remind-node-ids`（提醒节点）、`--range-node-ids`（退回范围节点）、`--default-node-id`、`--to-create-node`（出口未配时退发起节点）；`--custom` / `--no-custom` 显式指定是否启用自定义退回设置，**缺省保留节点当前值**。⚠ `--no-custom` 时平台会忽略全部节点级退回值，读回看到的是全局默认回显——不是没保存 |
+| `e10-cli workflow node-overtime list <wf> <nodeId>` | 查看节点超时规则（含启用状态与规则描述）。新规则平台默认「未启用」，需跑一遍 `set` 才会启用 |
+| `e10-cli workflow node-overtime set <wf> <nodeId> [选项]` | 设置节点超时规则，**建好后自动启用并回读核对**（回读不符即报错）。`--duration <天:时:分>`（如 `0:2:0`）、`--flow-type next\|reject\|submit\|intervene\|operator`（下一操作者/退回节点/提交节点/干预对象/指定操作者）、`--flow-delay <天:时:分>`、`--flow-node <节点ID>`（reject\|submit 的目标节点）、`--intervene-ids <用户ID>`（intervene 的干预对象）、`--operator-group <操作组ID>`（operator 的操作组）、`--disabled`（关闭超时处理且不启用）、`--skip-required`（有必填项也继续自动处理） |
+| `e10-cli workflow node-overtime remind <wf> <nodeId> [选项]` | 设置超时提醒。`--name <提醒名>`、`--type 0\|1`（超时前/超时后）、`--offset <天:时:分>`、`--mode 0\|1`（仅提醒本人/逐级提醒）、`--remind-group-id`、`--msg`/`--no-msg`、`--mail`/`--no-mail`、`--sms`/`--no-sms`。`--overtime-id` **可省略**：该节点只有一条超时规则时自动使用，多条时列出候选要求显式指定 |
+| `e10-cli workflow node menu <wf> <nodeId> [选项]` | 查看/配置节点操作菜单。菜单分**快捷菜单**（批准/保存/退回/强制收回/加签…）与**更多菜单**（转办/转发/传阅/意见征询/催办/打印…）两组。`--quick <names...>` 快捷菜单**只启用这些**（其余快捷菜单关闭，不在该组的会移进来）、`--more` 同理、`--enable`/`--disable` 单独开关（不动分组）、`--rename 批准=发送` 改显示名（可重复，值留空恢复默认名）、`--sign 批准=同意` 设默认签字意见、`--toggle <菜单>` 切换单个。菜单可用**名称 / 类型码(AGREE) / ID** 指定；名字拼错会直接报错并列出候选 |
+| `e10-cli workflow node-assign-flow get <wf> <nodeId>` | 查看节点指定流转（工作流界面上的「开一窗流转」）设置：启用、目标节点选择范围、自动流转、操作者/抄送 |
+| `e10-cli workflow node-assign-flow set <wf> [nodeId] [选项] [--all-nodes]` | 设置节点指定流转。只改显式给出的项，其余沿用当前值。`--enable`/`--disable`、`--range out\|free\|nodes`（按出口/自由/指定节点范围）、`--nodes <节点ID...>`（`--range nodes` 时必填）、`--node-range all\|condition`（按出口时的可选出口）、`--auto-flow none\|must\|first`、`--must-nodes <节点ID...>`（`--auto-flow must` 时必填）、`--auto-first-node`/`--no-auto-first-node`、`--open-dialog`/`--no-open-dialog`、`--forbid-modify-node`、`--node-alone`（目标节点单选）、`--common-destination`（允许使用常用去向）、`--single-operator`、`--comments`、`--sign-relation user\|countersign\|non\|order\|node\|parallel`、`--cc`/`--no-cc`、`--cc-type user\|off\|submit\|auto`、`--cc-required 0\|1`。**`--all-nodes` 对全流程所有可配置节点统一执行**（跳过结束节点与分流/合流点），用于「全流程统一、节点上不单独配」的场景 |
+| `e10-cli workflow node-assign-flow targets <wf> <nodeId>` | 列出该节点已单独设置的目标节点（含稳定独立设置 ID 与接收范围键） |
+| `e10-cli workflow node-assign-flow add-target <wf> <nodeId> <目标节点ID...>` | 新增指定流转目标节点。已存在的自动跳过，不重复新增 |
+| `e10-cli workflow node-assign-flow range <wf> <nodeId> [--open\|--no-open] [--mode normal\|advanced] [--limit-operator]` | 查看/设置指定流转的接收人可选范围（`scene=7`）。保存后自动回读比对，**没落库会直接报错而不是假装成功** |
+| `e10-cli workflow node vote <wf> <nodeId> --type count\|rate --num <n>` | 配置投票节点规则（**自动把节点置为投票类型** nodeType=5）。`--type count` 通过人数 / `rate` 通过率（`--num 100` = 100%）；`--min-num` 最少通过人数、`--show-results` 投票后显示结果、`--veto` 一票否决 |
+| `e10-cli workflow node-robot get <wf> <nodeId>` | 查看机器人节点（等待节点 type 8）配置：等待时长 / 处理间隔 / 操作 / 异常干预 / 动作 |
+| `e10-cli workflow node-robot set <wf> <nodeId> [选项]` | 更新机器人节点配置（读-改-写，**未传的字段保留原值**）。`--wait-value <分钟>`、`--processing-interval`、`--operator-name`、`--operate-type-name`、`--remark`、`--intervene-type`、`--enable-remark-custom` |
+| `e10-cli workflow node-robot set-remark <wf> <nodeId> --zh <中文> --en <English>` | 设置机器人节点备注的多语言 |
+| `e10-cli workflow operator-sign <wf> <nodeId> --sign-order <order>` | 修改节点操作者的签署顺序（会签/非会签/竞签/依次处理/抄送/抄送需批注）。**以「更新旧组」方式改，不删组重建**——只想换签署方式时用它；要重建整组用 `set-operator`。`--group <组名>` 只改指定组。⚠ 平台更新路径会**清空原有的「依次逐个处理-处理顺序」**（命令会显式告警）；需要配处理顺序请用 `set-operator ... --sign-order 依次处理 --execute-order <码>`（走重建） |
+| `e10-cli workflow node reject <wf> <nodeId>` | ⚠ **已弃用**，请改用 `workflow node-reject`（get / set）。旧命令只有 4 个数值开关，配不了退回范围/提醒节点、也控制不了「自定义 / 全局」 |
+| `e10-cli workflow node timeout <wf> <nodeId>` | ⚠ **已弃用**，请改用 `workflow node-overtime`。旧命令的超时时长与提醒字段名平台不认（时长恒为 0、提醒直接报错），且配不了退回/提交目标节点 |
 | `e10-cli workflow node field-permission get <wf> <nodeId>` | 查看节点字段权限（各字段 显示/隐藏）。表单字段在节点上可见与否 |
 | `e10-cli workflow node field-permission set <wf> <nodeId> --hide <字段...>` | 设置节点字段显示/隐藏。`--hide 字段名/ID` 隐藏、`--show` 显示；可多个，已设权限则更新、未设则新建 |
 | `e10-cli workflow node sign <wf> <nodeId>` | 节点签字意见必填（退回时必填意见等）。缺省查看；`--all-required` 全部必填、`--none-required` 全部不必填、`--select "退回,加签"` 指定操作类型必填（按 mustInputDto=2 + 选中操作类型 id）。`getSignConfigForm` 枚举操作类型 |
@@ -196,8 +241,11 @@
 | `e10-cli workflow setting auto <wf>` | 自动处理设置。`--enable`/`--way`/`--follow-type` |
 | `e10-cli workflow setting other <wf>` | 其他设置。`--message-op`/`--auto-save`/`--switch-identity` |
 | `e10-cli workflow advanced doc <wf>` | 流程存档设置。`--enable`/`--dir-select`/`--doc-types` |
-| `e10-cli workflow advanced schedule <wf>` | 定时触发审批。`--enable`/`--frequency`/`--begin-date`/`--time`/`--weekday-only`/`--sms`/`--email`/`--message`/`--limit-creator` |
-| `e10-cli workflow advanced schedule-range <wf>` | 定时触发人员范围。`--list`/`--add`/`--delete` |
+| `e10-cli workflow advanced schedule <wf> [选项]` | 定时触发审批。**没有参数=查看**；配置分两次保存：详细配置（`--frequency` 频率 / `--begin-date` 开始日期 / `--weekday-only` / `--sms` / `--email` / `--message`）与开关（`--enable` 总开关 / `--limit-creator` 限制发起人范围）。`--frequency` 只需写要改的档位（如 `{"item1":"1","item2":"3"}`=按日每 3 天），缺的档位自动补全；item1: 1=日/2=周/3=月/4=季/5=年，item2=每几个周期。**⚠ 触发时间由平台固定，不可配置**（平台上该项为只读，帮助文案「固定晚上触发，不支持修改触发时间」）——没有 `--time` 选项。配完范围用 `workflow plan-range` |
+| `e10-cli workflow plan-range list <planId> [--page-size <n>]` | 查看定时计划的人员范围。`<planId>` 是定时计划 ID（`workflow advanced schedule` 输出里的「计划ID」） |
+| `e10-cli workflow plan-range add <planId> --obj-type department\|employee --target-id <id> [--target-name <名>]` | 添加定时触发人员范围（多个目标 ID 用逗号分隔） |
+| `e10-cli workflow plan-range delete <planId> --id <记录ID[,记录ID]>` | 删除定时触发人员范围（**多条逗号分隔**） |
+| `e10-cli workflow advanced schedule-range <wf>` | ⚠ **已弃用**，请改用 `workflow plan-range`。旧命令列表恒显示 0 条、删除恒报「入参不全」 |
 | `e10-cli workflow delete <workflowId>` | 删除流程。`--with-form` 同时删除关联表单 |
 | `e10-cli workflow delete-link <wf> <linkIds...>` | 删除连线（列表 API，可多个）。自动清理关联节点 |
 | `e10-cli workflow delete-node <wf> <nodeId>` | 删除节点（自动清理关联出口）。`--bridge` 桥接上下游 |
@@ -220,6 +268,24 @@
 | `e10-cli workflow action delete <appId> <name>` | 删除动作流（自动先禁用再 batchAddRecycle 删实体）。**平台无"按动作流反查绑定节点"接口**：删实体后，绑定了此动作流的节点会残留**悬空引用**（前端显示「被删除」）。CLI 删完会提示，需逐个用 `action clear-node <wf> <node>` 清理节点绑定 |
 | `e10-cli workflow action batch-delete @list.json` | 批量删除动作流（每项 `{id,name}`，自动先禁用再 batchAddRecycle） |
 
+### 公用流转片段 & 子流程 & 消息
+
+| 命令 | 说明 |
+|------|------|
+| `e10-cli workflow segment create <name> [--desc <text>]` | 新建**公用流转片段**并自动启用，返回 segmentId |
+| `e10-cli workflow segment list [--type 1\|2] [--sub-company-id <id>]` | 列出公用流转片段。`--type 1`=流转片段（默认）/ `2`=权责表片段 |
+| `e10-cli workflow segment enable <segmentId>` / `disable <segmentId>` | 启用 / 停用片段 |
+| `e10-cli workflow segment add-link <segmentId> <源节点> <目标节点> [连线名]` | 片段内加连线（读片段图重编号 cell id 后追加） |
+| `e10-cli workflow segment embed <wf> <segmentId> [--x <n>] [--y <n>]` | 在主流程里插入**公用流转节点**（引用指定片段，自动拼 group + 子节点 XML 并入主流程图）。`--sub-company-id` 用于查片段名 |
+| `e10-cli workflow sub-process list <wf> <nodeId>` | 列出节点上全部子流程配置 |
+| `e10-cli workflow sub-process get <wf> <nodeId> <subSetId>` | 查看子流程配置详情（主配置 + detailSet + 触发条件） |
+| `e10-cli workflow sub-process set <wf> <nodeId> --sub-wf <子流程ID> [--name <配置名>] [--id <subSetId>]` | 新建/更新子流程主配置（**不传 `--id` 新建，传了则读-改-写**）。`--enable`/`--disable`（默认停用）、`--tri-once` 只触发一次、`--tri-source <主表objId>`、`--time-day`/`--time-hour`/`--time-minute` 延时 |
+| `e10-cli workflow sub-process set-condition <wf> <nodeId> <subSetId> --rule "..." [--relation AND\|OR]` | 设置子流程触发条件（复用条件构建器，`--rule` 语法同 `workflow condition add`），并回填到主配置 |
+| `e10-cli workflow sub-process set-mapping <wf> --sub-wf <子流程ID> --map 源字段:目标字段[:名] [--field-mapping-id <id>]` | 设置主→子字段映射（`--map` 可多个；不传 `--field-mapping-id` 则新建） |
+| `e10-cli workflow sub-process set-detail <wf> <nodeId> <subSetId> [选项]` | 更新明细设置（创建人 / 读意见等，读-改-写）。`--creator <类型:字段ID>`、`--del-old-sub-request 0\|1`、`--read-main`/`--read-paralle`/`--read-sub`、`--auto-show 0\|1`、`--init-default-val` |
+| `e10-cli workflow sub-process delete <wf> <subSetId>` | 删除子流程配置（连同 detailSet 一并删） |
+| `e10-cli workflow message create <wf> <nodeId> <名称> [选项]` | 创建**消息提醒动作流**并绑定到流程节点。`--title`、`--content`、`--recipients <用户ID>`（缺省流程发起人）、`--channel im\|yunqiao\|email\|sms`、`--event arrive\|leave\|delete\|save\|revert\|pause\|cancel`（触发时机）、`--node-name` |
+
 > **加节点**: add-node 直接操作节点列表 API (getNodeEditTable → saveNodeEditTable)
 > **加连线**: add-link/add-links 直接操作出口列表 API (getWfpNodeLinkTable → saveNodeLinkEditTable)
 > **删连线**: delete-link 直接操作出口列表 API (getWfpNodeLinkTable → saveNodeLinkEditTable, deleteRows)
@@ -283,6 +349,56 @@
 
 ---
 
+## 报表（设计器报表）
+
+```bash
+# 建表（首选）：声明式一步落库，不留空壳
+e10-cli report build --spec spec.json                    # 正式
+e10-cli report build --spec spec.json --dry-run          # 只定源+字段预检
+e10-cli report build --spec spec.json --form-confirmed --source-id <id>   # 用户已确认表
+e10-cli report build --spec spec.json --field-confirmed "列A,列B"          # 确认文案≠显示名
+# 退出码 3=需选表(未建) 4=需选字段(未建) 2=成功但有警告
+e10-cli report find <appId> [表名] | --list | --suggest "关键词"   # 应用内定源
+e10-cli report create blank|template|quick --app-id <id> --name "名" [--model-id <id>]
+e10-cli report create models                             # 模板列表
+
+# 读 / 改
+e10-cli report read <reportId> [--fields]
+e10-cli report list --app-id <id>
+e10-cli report delete <reportId> --app-id <id>           # 进回收站，可还原
+e10-cli report dataset list|rename|preview|check-used|delete|replace ...   # 数据集侧栏
+e10-cli report dataset agg|sort get|save|clear --dataset-id <id>
+
+# 查询条件
+e10-cli report query list|save|type|check-echo|fix-echo <reportId> --app-id <id>
+e10-cli report query verify <reportId> --app-id <id> [--fix]     # Q1~Q10 体检
+e10-cli report fix query-default <reportId> --app-id <id> [--set ...] [--apply]
+e10-cli report fix query-style   <reportId> --app-id <id> [--delete-id ...] [--apply]
+
+# 权限 / 分组 / 生命周期 / 版本
+e10-cli report scope list|set|matrix ... --report-id <id> --app-id <id>
+e10-cli report group list|add|delete --app-id <id>
+e10-cli report lifecycle copy-and-menu|add-menu|move|transfer ...
+e10-cli report lifecycle recycle list|restore|purge ...
+e10-cli report version save|list <reportId>
+e10-cli report snapshot set|list <reportId> [--cron "0 0 0 * * ?"]
+e10-cli report restore <reportId> --version <versionId>
+e10-cli report cleanup --app-id <id> [--prefix __build_] [--apply]
+
+# 校验 / 体检 / 修复（fix 默认只预演，--apply 才落库）
+e10-cli report validate base|condition|format|transform|href|gridline|blank|style ...
+e10-cli report verify bind|all|meta|condition|format|blank|gridline|contract|limit <reportId> [--app-id <id>]
+e10-cli report fix table-name <reportId> [--apply]       # 补 tableName
+e10-cli report fix freeze <reportId> [--anchor x,y] [--apply]
+e10-cli report fix echo <reportId> --app-id <id>
+
+# 分析
+e10-cli report join-suggest --app-id <id> (--parent-form 主表 --child-form 子表)
+e10-cli report py preagg --report-id <id> [--app-id <id>]
+```
+
+> 建表 / 改表 / 查询条件怎么用、踩坑在哪：`references/report/guide-report-build.md`、`guide-report-modify.md`、`guide-report-query.md`、`ref-report-pitfalls.md`。
+
 ## 人员 & 图标
 
 | 命令 | 说明 |
@@ -292,6 +408,46 @@
 
 ---
 
+## 认证 & 多环境
+
+| 命令 | 说明 |
+|------|------|
+| `e10-cli auth status` | 查看当前登录状态（cookie 过期会提示）。**认全局 `--profile`**——多环境切换后用它确认登的是哪个环境；该 profile 未登录时直接报错，不会回落到别的环境 |
+| `e10-cli auth login` | 浏览器 OIDC SSO 授权 → 本地回调 → 自动保存。**需要用户亲自点**，自动化跑不了 |
+| `e10-cli auth set --base-url <url> --eteamsid <值>` | 直接写入认证（**非交互**）。SSO 回调不到 localhost 时用这条：让用户从浏览器 DevTools → Application → Cookies 复制 `ETEAMSID` 值即可 |
+| `e10-cli auth profile list\|use <name>\|current` | 多环境 Profile 管理。也可以不切激活项，直接在任意命令前加全局 `--profile <名>` |
+| `e10-cli auth export-weaver-env` | 导出当前鉴权为 `WEAVER_*` 环境变量（供外部脚本复用）：`eval "$(e10-cli auth export-weaver-env)"` |
+
+> ⚠ `ETEAMSID` 是会话凭据——只在命令行里传，**不要写进任何项目文件**。
+
+---
+
+## 矩阵
+
+| 命令 | 说明 |
+|------|------|
+| `e10-cli matrix list [--name <关键词>] [--enable-status 0\|1] [--org-id <id>]` | 查询矩阵列表（**含停用矩阵**，带状态；`--out` 写 JSON 文件） |
+| `e10-cli matrix create <name> [选项]` | 新建矩阵（**新建即为启用**，要停用再跑 `matrix disable`）。所属机构的字段名由**分权状态**决定，CLI 自动判断并在缺省时用当前机构兜底，分权租户无需手写机构 |
+| `e10-cli matrix config <id>` / `config-edit <id>` | 查看 / 编辑矩阵配置（条件字段 + 值字段） |
+| `e10-cli matrix enable <id>` / `disable <id>` | 启用 / 停用（停用后数据只读） |
+| `e10-cli matrix update <id>` / `delete <ids...>` | 更新基本信息（名称/描述/同步方式）/ 删除（级联删配置、数据、维护者） |
+| `e10-cli matrix data` | 矩阵数据维护（映射行） |
+
+> 系统矩阵与自定义矩阵的区别、以及「条件列 → 人员列 → 数据映射 → 运行时读回」的完整步骤见 `references/hrm/guide-matrix.md`。
+
+---
+
+## 编译 & Skill 文档
+
+| 命令 | 说明 |
+|------|------|
+| `e10-cli compile <项目目录> [--strict]` | 编译前端项目（`--strict` 把警告也当错误）。代码质量自检用 `e10-cli check <项目目录>` |
+| `e10-cli skill root` | 打印 skill 文档根目录绝对路径（文档版本与 CLI 版本一致） |
+| `e10-cli skill copy [目标目录]` | 全量拷贝文档 + 模板到本地（默认当前目录），放出 `references/` `actionflows/` `assets/` `SKILL.md` |
+| `e10-cli skill sync [--target <目录>]` | 探测已安装的 skill（`~/.claude/skills`、`~/.workbuddy/skills`、`~/.codex/skills` 等），把文档树 + 薄层指令文件自动拷进对应目录；`--target` 可重复指定额外的安装根目录 |
+
+---
+
 ## 版本更新（只提醒，升级需确认）
 
 | 命令 | 说明 |

package/skill-docs/references/ebuilder-designer/guide-designer-components.md

@@ -86,7 +86,7 @@ e10-cli designer save <pageId> --layouts @layouts.json
 >
 > 组件 `type`/`package`/`category`/`applyStyle`/`styleCategoryCompKey`/`styleCategoryPackage` 同样从真实 comp 复制真实值，不编造、不赋空。
 >
-> **机器随机 id 硬规则**：页面/组件配置里**所有由工具生成的随机 hex 机器 id 首位都不能是数字**（后端校验，浏览器抓包样本首位恒为 a-f 字母）：`comp.id`(32 位)、图表 `axisId`(32 位)/`shortKey`(7 位，平台数据行/分组键)、NavPanel 菜单项/事件组/事件 id、DigitalPanel panel id 等。CLI `designer chart`/`digital-panel`/`nav-panel` 已统一用 `genLetterHex()`（首位强制 a-f）自动生成；agent 手工改 config 时须遵守同规则。真实数字标识（objId/pageId/formId/字段 id）照常可数字开头，勿动。
+> **机器随机 id 硬规则**：页面/组件配置里**所有由工具生成的随机 hex 机器 id 首位都不能是数字**（后端校验，浏览器样本首位恒为 a-f 字母）：`comp.id`(32 位)、图表 `axisId`(32 位)/`shortKey`(7 位，平台数据行/分组键)、NavPanel 菜单项/事件组/事件 id、DigitalPanel panel id 等。CLI `designer chart`/`digital-panel`/`nav-panel` 已统一用 `genLetterHex()`（首位强制 a-f）自动生成；agent 手工改 config 时须遵守同规则。真实数字标识（objId/pageId/formId/字段 id）照常可数字开头，勿动。
 
 ---