weaver-e10-builder 1.2.3 → 1.5.1

package/skill-docs/references/workflow/guide-workflow-odoc.md

@@ -2,9 +2,9 @@
 
 ## 定位
 
-公文流程是原生工作流程的特殊类型，由 `bridgeService=odoc` 标识。固定/自由通过 `--is-free 0|1` 设置。需求明确出现公文流程、公文审批、收文、发文、公文设置或正文设置时读取本指南；基础节点、出口、操作者、条件和布局规则同时读取 [流程表单指南](guide-workflow.md)。
+公文流程是原生工作流程的特殊类型，由 `bridgeService=odoc` 标识。固定/自由通过 `--is-free 0|1` 设置。需求明确出现公文流程、公文审批、收文、发文、公文设置或正文设置时读取本指南；节点、出口、操作者、条件和布局规则同时读取 [流程表单指南](guide-workflow.md)，公文专属设置读取 [公文设置指南](guide-workflow-odoc-setting.md)。
 
-## 创建
+## 创建方式
 
 ### 随流程自建原生流程表单
 
@@ -12,7 +12,7 @@
 e10-cli workflow create-workflow "公文审批流程" --odoc --layout FLOW
 ```
 
-自建模式沿用原生工作流程路径，提交 `relateForm=0`、`formId=0` 和 `bridgeService=odoc`。表格式布局使用 `--layout EXCEL`。
+自建模式提交 `relateForm=0`、`formId=0` 和 `bridgeService=odoc`。表格式布局使用 `--layout EXCEL`。
 
 ### 绑定已有原生流程表单
 
@@ -20,37 +20,36 @@ e10-cli workflow create-workflow "公文审批流程" --odoc --layout FLOW
 e10-cli workflow create-workflow "公文审批流程" --odoc --form-id <formId>
 ```
 
-绑定模式提交 `relateForm=1`、`formId=<已有原生流程表单ID>` 和 `bridgeService=odoc`。后续字段与布局继续使用 `wf-form` 和原生流程表单 `formId`。
+绑定模式提交 `relateForm=1`、`formId=<已有原生流程表单ID>` 和 `bridgeService=odoc`。后续字段与布局继续使用 `wf-form` 和返回的原生流程表单 `formId`。
 
-团队流程默认使用当前创建者机构；多机构场景再显式传 `--sub-company <机构ID>`。其他通用参数如 `--workflow-type`、`--desc`、`--is-free` 与普通原生工作流程一致。
+团队流程默认使用当前创建者机构；多机构场景显式传 `--sub-company <机构ID>`。`--workflow-type`、`--desc`、`--is-free` 等参数与普通原生工作流程一致。
 
-## 创建结果与后续配置
+## 完整搭建顺序
 
-命令返回 `workflowId` 和 `formId`，JSON 结果以 `flowKind:"odoc"`、`bridgeService:"odoc"` 标识公文流程。创建后的列表回读同样带 `bridgeService=odoc`，并核对返回记录的 `bridgeService`。
+1. 使用 `workflow create-workflow --odoc` 创建流程并取得 `workflowId`、`formId`。
+2. 使用 `wf-form` 创建主表字段、明细表及布局，先准备公文设置要引用的标题、正文、文号、目录区分等字段。
+3. 使用通用 `workflow` 命令配置节点、操作者、出口、条件、会签、退回、超时、消息、编号及动作流。
+4. 使用 `workflow odoc setting get <workflowId>` 读取当前环境提供的公文设置分组、字段候选项、节点候选项及默认值。
+5. 按需求使用 `workflow odoc setting set` 配置公文专属内容；字段选择使用字段 ID，节点选择可使用名称或 ID。
+6. 读取流程、公文设置和相关表单配置，核对已配置项目。
 
-取得 `workflowId` 后，节点、出口、操作者、出口条件、会签、退回、超时、消息、编号和动作流继续使用通用 `workflow` 命令。
+创建结果以 `flowKind:"odoc"`、`bridgeService:"odoc"` 标识公文流程。每完成一个计划项即在计划中销号。
 
-## 公文专属配置
-
-### 查询
+## 查询与配置入口
 
 ```bash
 e10-cli workflow odoc list [--name <关键词>] [--sub-company <机构ID>]
 e10-cli workflow odoc read <workflowId>
-```
-
-`list` 使用 `bridgeService=odoc` 查询公文流程；`read` 返回流程名称、绑定表单 `formId` 和公文设置摘要。
-
-### 读取与保存公文设置
-
-```bash
 e10-cli workflow odoc setting get <workflowId>
 e10-cli workflow odoc setting set <workflowId> --config @odoc-setting.json
 ```
 
-`setting set` 读取当前配置、合并指定内容、保存并回读。配置 JSON 可直接使用平台字段，也可按 `basic`、`text`、`files`、`nodes`、`signature`、`archive`、`ai` 分组；`number` 映射为 `odocNumber`，`attachmentArea` 映射为 `odocAttachArea`。
+- `list` 查询公文流程。
+- `read` 返回流程名称、绑定表单 `formId` 和公文设置摘要。
+- `setting get` 返回完整设置分组、当前值及候选项。
+- `setting set` 读取当前配置、合并指定内容、保存并回读。
 
-常用配置也可直接使用参数：
+常用参数示例：
 
 ```bash
 e10-cli workflow odoc setting set <workflowId> \
@@ -58,19 +57,12 @@ e10-cli workflow odoc setting set <workflowId> \
   --request-title-field "公文标题" \
   --upload-word 1 --upload-pdf 1 --upload-ofd 1 \
   --text-in-form 1 --column-position 1 \
-  --attach-area 1 --archive-node "归档"
+  --open-text-select 2 --open-text-node "发起节点" \
+  --edit-text-node "发起节点" \
+  --attach-area 1 --archive-node "归档节点" \
+  --ai-odoc 1 --ai-abstract 1 --ai-format 1
 ```
 
-字段参数支持字段名称或字段 ID，节点参数支持节点名称或节点 ID。平台开关值使用 `0` 和 `1`。
-
-### 配置结构
-
-- 基础正文：`officialType`、`requestTitleField`、`flowDocField`、`documentTitleField`、`defaultCat`、`flowDocCatField`、`docPropSettings`。
-- 正文展示：`openTextDefaultNode`、`editTextNode`、`previewDefault`、`isTextInForm`、`columnPosition`、`textColumnSize`。
-- 文件与签章：`uploadWORD`、`uploadPDF`、`uploadOFD`、`signGroupMould`、`signNodeList`、`openSignatureSeal`。
-- 公文编号：`odocNumber`。
-- 附件区域：`odocAttachArea`，包含启用状态、打开节点、展示位置及正文/附件比例。
-- 归档：`archivesForm`、`archivesNodeOpen`、`archivesNode`、`archivesAuth` 和字段映射设置。
-- AI 与格式：`openAiAbstract`、`openAiFormat`、`defaultFormatTemplate`、`showAiAssistant`、`showOfficialDoc`。
+字段参数支持字段名称或字段 ID；节点参数支持节点名称或节点 ID。节点名称重复时使用节点 ID。平台开关值使用 `0` 和 `1`。
 
-保存请求携带完整公文设置，其中字段选择值为字段 ID、节点选择值为节点 ID，`signNodeList` 保存节点及其启用、必填状态。
+公文设置的十九个配置分组、字段码表、依赖关系、JSON 写法和支持状态统一见 [公文设置指南](guide-workflow-odoc-setting.md)。

package/skill-docs/references/workflow/guide-workflow.md

@@ -297,13 +297,28 @@ e10-cli workflow add-link <workflowId> <fromNodeId> <toNodeId> "退回" --reject
 e10-cli workflow add-link <workflowId> <fromNodeId> <toNodeId> "主线路" --default
 ```
 
-批量添加连线：
+批量添加连线（出口表混着退回线和默认出口时用这个）：
 ```bash
 e10-cli workflow add-links <workflowId> @links.json
-# links.json: [{"from":"nodeId","to":"nodeId","label":"发起→审批","reject":true,"default":false}]
+# links.json:
+# [
+#   {"from":"拟稿","to":"套红",       "label":"拟稿 至 套红",       "default":true},
+#   {"from":"部门经理审稿","to":"拟稿", "label":"部门经理审稿 退回 拟稿","reject":true}
+# ]
 ```
 
-> **多条连线用 `add-links`**：`add-link` 内部 fetch→修改→save，并行的会覆盖。`add-links` 按顺序逐条执行，每条都从服务端拉最新 XML 再改，不会丢数据。不要用 `&` 或 `parallel` 并跑 add-link。
+> **退回 / 默认出口逐条给**：`reject` / `default` 写在每条连线上；命令行上的 `--reject` / `--default`
+> 是给整批兜底的默认值，逐条给的值优先于它。
+>
+> **默认出口会自动让位**：指定某条为默认出口时，同一源节点上原有的默认出口会被自动取消，
+> 保证一个源节点只有一条默认出口。同一批里给同一源节点指定了两条默认出口会直接报错，
+> 不会静默留下两条。
+>
+> **多条连线用 `add-links`**：`add-link` 内部 read→改→save，并行的会互相覆盖。`add-links` 一次把整批
+> 拼好、一次保存，不会丢数据。不要用 `&` 或 `parallel` 并跑 add-link。
+>
+> 保存后 CLI 会**回读比对**：新连线的退回/默认标志与让位结果都对得上才算成功，
+> 对不上会直接报错退出，不会因为服务端回了「保存成功」就放过。
 
 ### 删除连线