weaver-e10-builder 1.5.13 → 1.5.14

package/skill-docs/references/form/guide-form-layout-incremental.md

@@ -63,6 +63,34 @@ FLOW 布局**没有** `config.workbook`（它靠 `config.flow.parent` / `nodes`
 1. 先在设计器里手工加一个同类型字段（它就成了可参照的样板），再重跑命令；
 2. 确认这张表是自己建的、不在乎版式被重排 → 显式加 `--reinit`。
 
+## 追加明细表：默认增量放进布局
+
+给已有表单加明细子表用 `e10-cli form add-detail-table`。**默认会把这明细表放进现有布局**，和加字段一样不重建：
+
+```bash
+e10-cli form add-detail-table <objId> <appId> "费用明细" "费用类型"
+```
+
+- 子表必须是**有字段**的（命令会顺带建首字段）；空子表平台不返回，放不进布局。
+- 只想建表、布局自己排：加 `--no-place`。
+- `--init` 是另一条路：整表重建（换样式模板、重排位置），只在布局本来就是自己建的、不在乎版式时用。
+
+实现上不碰原布局的 initLayout：复制一套临时布局 → 在副本上让平台生成明细容器与子字段组件 → 摘出这一块 → 删除副本 → 合并进原布局。原布局里已有的行列、合并格、样式都保留，明细表落在主表字段下方。
+
+放好之后，往这张明细里加字段照常用：
+
+```bash
+e10-cli form add-field <objId> <appId> "金额" Number --sub-form-id <subFormId>
+```
+
+已经建好、但还没进布局的明细表（例如当时用了 `--no-place`），单独放进去：
+
+```bash
+e10-cli form layout add-detail-table <objId> <appId> <subFormId|明细表名>
+```
+
+命令幂等：已经在布局里时直接提示，不重复添加。FLOW 布局也支持（明细字段挂在容器内的 `InternalContainer` 画布下）。
+
 ## 哪些 id 可以自己生成，哪些必须由平台发号
 
 这一条最容易踩：**编一个 id 不会报错**，而是在之后某个看不出来的环节静默失效。

package/skill-docs/references/form/guide-form-layout-planning.md

@@ -67,6 +67,17 @@ e10-cli form layout read <objId>
 
 创建后需要调整局部位置或显示属性时，使用 `form layout` 下的移动、只读和必填设置命令；具体参数通过 `form layout --help` 查询。
 
+## 将已有布局另存为模板
+
+需要复用一套实际 **PC 流式布局**的样式时，先确定其布局 ID，再执行：
+
+```bash
+e10-cli form layout save-as-template <objId> --view-id <布局ID> --name <模板名>
+e10-cli form layout save-as-template <流程表单formId> --module workflow --view-id <布局ID> --name <模板名>
+```
+
+此操作从指定布局读取 `formStyle` 并创建流式样式模板，默认禁用；需要立即可选用时加 `--enabled`。业务字段和布局组件不会一起保存。表格式布局不能用这条命令直接另存；模板的其他操作见[布局样式模板总览](form-template/style-templates.md)。
+
 ## 图片与 Excel 源样式还原
 
 明确要求保留原样表的合并、留白、尺寸、静态文字和样式时，使用[源样式还原指南](guide-form-layout-source.md)。字段解析、创建及业务配置仍由 CLI 完成；布局模块在全部字段补写和归组结束后，将源网格绑定到已存在的字段与组件，编译 pageLayouts，再单次保存并独立回读。

package/skill-docs/references/form/guide-form-layout-source.md

@@ -199,6 +199,10 @@ LayoutSpec 可增加 details，必须使用真实 subFormId。anchor 是主表
 
 保留明细系统配置、按钮和结构行。只把源字段标题和值样式投影到既有明细列，并按源尺寸调整业务列及相关行；字段 ID、dataKey 和业务选项等保持原样。
 
+明细的 `columnCount` 表示逻辑列容量，`columns` 表示显式列配置，平台可能省略尾部默认列，因此两者不必相等。例如 6 个业务字段加 2 个系统列，允许 `columnCount=10`、`columns.length=8`；原生容量与默认列表示原样保留，不增加业务字段凑数，也不擅自填充无引用的列配置。数字字符串容量可兼容读取；单元格和合并范围必须位于容量内，实际承载业务字段的列必须有可用的列配置。缺系统控件、越界、业务列配置缺失仍会阻断，不能简单放开校验或缩小容量绕过。
+
+“八类标准系统控件”指按钮、勾选、序号等不同系统控件类型，不是要求 8 个业务字段。明细值区域是可重复展示数据的模板，不限制运行态只能一条记录。截图中的多条示例数据需与字段/布局分开确认；未绑定静态内容的保护继续保留，真实业务记录应另外处理数据，不能直接删除或新增字段冒充。
+
 ## 与创建命令衔接
 
 独立建好字段后执行还原，是推荐的可审阅路径。需要串联时，form create 支持：