openyida 2026.5.21 → 2026.5.25

package/yida-skills/skills/yida-process-rule/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: yida-process-rule
-description: 宜搭流程规则配置技能，通过调用流程设计器 API 实现流程的创建、配置（条件分支、嵌套分支、审批节点、字段权限、抄送节点、跳转规则）、保存和发布。不适用于：从零创建流程表单（应使用 yida-create-process），或配置集成自动化逻辑流（应使用 yida-integration）。
+description: 宜搭流程规则配置技能，通过调用流程设计器 API 实现流程的创建、配置（审批/办理/抄送、条件分支、并行分支、字段权限、跳转规则，以及连接器、数据、消息、邮件、代码、子流程、卡片、循环、AI 等官方组件节点配置透传和 processJson 适配）、保存和发布。不适用于：从零创建流程表单（应使用 yida-create-process），或从零设计集成自动化逻辑流（应使用 yida-integration）。
 ---
 
 # 宜搭流程规则配置技能
@@ -43,7 +43,7 @@ description: 宜搭流程规则配置技能，通过调用流程设计器 API
 
 ## 概述
 
-本技能描述如何通过流程设计器 API 为宜搭流程表单配置审批流程。支持审批节点、条件分支、嵌套分支、字段权限、抄送节点、跳转规则等完整的流程配置能力。
+本技能描述如何通过流程设计器 API 为宜搭流程表单配置审批流程。支持审批节点、办理节点、条件分支、并行分支、嵌套分支、字段权限、抄送节点、跳转规则；同时支持宜搭 `yida-simple-flow` 官方组件节点的配置透传和 `processJson` 适配，用于连接器、数据、消息、邮件、Groovy/JavaScript、子流程、卡片、循环、AI 等高级节点。
 
 ## 何时使用
 
@@ -105,8 +105,24 @@ openyida configure-process "APP_XXX" "FORM-YYY" .cache/openyida/order/process-de
 | 类型 | 说明 | 必填属性 |
 | --- | --- | --- |
 | `approval` | 审批节点 | `name`, `approver` |
+| `operator` | 办理 / 填写节点，审批人 DSL 相同，可用 `executor` 代替 `approver` | `name`, `executor` 或 `approver` |
 | `route` | 条件分支路由 | `conditions` |
+| `parallel` | 并行分支，满足条件的分支都会执行 | `branches` |
 | `carbon` | 抄送节点 | `name`, `approver` |
+| 官方组件节点 | 连接器、数据、消息、邮件、代码、子流程、卡片、循环、AI 等 | `type` 或 `componentName`，以及对应真实 props |
+
+### 节点别名
+
+OpenYida 会自动兼容常见别名：
+
+| 写法 | 归一化类型 |
+| --- | --- |
+| `approval`, `ApprovalNode` | `approval` |
+| `operator`, `executor`, `OperatorNode` | `operator` |
+| `multiApproval`, `MultiApprovalNode` | `approval` 类型的多人审批组件 |
+| `carbon`, `cc`, `CarbonNode` | `carbon` |
+| `route`, `branch`, `ConditionContainer` | `route` |
+| `parallel`, `parallelBranch` | `parallel` |
 
 ### 审批节点属性
 
@@ -119,6 +135,29 @@ openyida configure-process "APP_XXX" "FORM-YYY" .cache/openyida/order/process-de
 | `formConfig` | Object | 否 | 字段权限配置 |
 | `routeRules` | Array | 否 | 跳转规则 |
 
+### 办理 / 填写节点（operator）
+
+办理节点底层仍是宜搭流程的 `approval` 类型，但 `viewJson` 使用 `OperatorNode`，适合“资料补充”“填写处理结果”“业务办理”等非审批动作。
+
+```json
+{
+  "type": "operator",
+  "name": "资料补充",
+  "executor": {
+    "type": "user",
+    "users": [
+      { "id": "operator001", "name": "运营同学" }
+    ]
+  },
+  "formConfig": {
+    "behaviorList": [
+      { "fieldId": "textareaField_material", "fieldBehavior": "NORMAL" },
+      { "fieldId": "numberField_amount", "fieldBehavior": "READONLY" }
+    ]
+  }
+}
+```
+
 ### 条件分支属性
 
 | 属性 | 类型 | 必填 | 说明 |
@@ -126,6 +165,46 @@ openyida configure-process "APP_XXX" "FORM-YYY" .cache/openyida/order/process-de
 | `type` | String | 是 | 固定 `"route"` |
 | `conditions` | Array | 是 | 条件列表 |
 
+### 并行分支属性
+
+```json
+{
+  "type": "parallel",
+  "name": "并行会审",
+  "branches": [
+    {
+      "name": "法务会审",
+      "childNodes": [
+        { "type": "approval", "name": "法务审批", "approver": "originator" }
+      ]
+    },
+    {
+      "name": "财务会审",
+      "rules": [
+        {
+          "fieldId": "numberField_amount",
+          "fieldName": "金额",
+          "componentType": "NumberField",
+          "op": "GreaterThan",
+          "value": 10000
+        }
+      ],
+      "childNodes": [
+        { "type": "approval", "name": "财务审批", "approver": "originator" }
+      ]
+    }
+  ]
+}
+```
+
+| 属性 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `branches` | Array | 是 | 并行分支列表，也兼容 `conditions` / `parallelBranches` |
+| `branches[].name` | String | 否 | 分支名称 |
+| `branches[].rules` | Array | 否 | 分支条件；不配置时表示所有数据进入该分支 |
+| `branches[].logic` | String | 否 | `"AND"`（默认）或 `"OR"` |
+| `branches[].childNodes` | Array | 否 | 分支内节点 |
+
 ### 条件定义
 
 | 属性 | 类型 | 必填 | 说明 |
@@ -284,6 +363,17 @@ openyida configure-process "APP_XXX" "FORM-YYY" .cache/openyida/order/process-de
 
 说明：不同租户/版本下某些高级规则（接口人、第三方服务、连接器、权限矩阵等）的 `approverRules` 结构可能不同。遇到 DSL 暂未覆盖的类型时，先在宜搭流程设计器中配置一个样例并导出/抓取对应结构，再用该对象固化到流程定义中。
 
+## 官方组件节点（高级透传）
+
+完整支持清单、连接器示例、数据 / 消息 / 代码节点示例和透传规则详见 [references/official-component-nodes.md](references/official-component-nodes.md)。
+
+关键边界：
+
+- 常规审批/办理/抄送、条件/并行分支优先用本文件中的简化 DSL。
+- 连接器、数据、消息、邮件、Groovy/JavaScript、子流程、卡片、循环、AI 等节点使用真实组件 props 透传，并按线上设计器规则转换 `processJson.props`。
+- 不认识的节点类型会直接报错，不会静默跳过，避免生成断链流程。
+- 从零创建复杂集成自动化时优先使用 `yida-integration`；本技能用于流程表单规则里需要高级组件节点、或已有真实节点配置需要固化的场景。
+
 ## AI 自动生成流程特性（必须遵守）
 
 > 📖 AI 生成流程定义的完整规范（字段权限自动生成、回退规则识别、检查清单）详见 [references/process-ai-rules.md](references/process-ai-rules.md)。
@@ -313,7 +403,7 @@ openyida configure-process "APP_XXX" "FORM-YYY" .cache/openyida/order/process-de
 ## 注意事项
 
 - 所有 `fieldId` 必须通过 `openyida get-schema` 获取，不能手写猜测
-- 条件分支的 `conditionNodes` 最后一个节点必须是 `else`（`conditionType: "else"`）
+- 条件分支会自动补一个“其他情况”默认分支；不要手写猜测低层 `conditionNode` 结构
 - 嵌套分支不超过 3 层
 - 流程发布前必须先保存
 - **本技能不读写 memory**：流程定义通过 CLI 命令写入宜搭平台，processCode 等信息输出到 stdout，不依赖跨会话的 memory 状态

package/yida-skills/skills/yida-process-rule/references/official-component-nodes.md

@@ -0,0 +1,93 @@
+# 官方组件节点高级透传
+
+宜搭真实流程设计器还支持自动动作节点。OpenYida 对这些节点采用“真实组件 props 透传 + processJson 适配”模式：节点顺序、连线和 `processJson.type` 自动生成，`viewJson.props` 保留真实组件配置，`processJson.props` 按线上 `yida-simple-flow` 的转换规则生成。每个节点的业务配置必须来自真实配置（例如在设计器中配置一次后复制 props，或从已有流程版本中读取）。
+
+## 支持清单
+
+| `componentName` / `type` | `processJson.type` | 典型配置字段 |
+| --- | --- | --- |
+| `ConnectorNode` / `connector` | `innerConnector` / `thirdConnector` / `httpConnector` / `faasConnector` | `connectorRules` |
+| `GroovyNode` / `groovy` | `CodeExecutor` | `groovy` |
+| `JavaScriptNode` / `javascript` | `CodeExecutor` | `JavaScript` |
+| `GetSingleDataNode` / `getSingleData` | `dataRetrieve` | `getData` |
+| `GetBatchDataNode` / `getBatchData` | `dataRetrieve` | `getData` |
+| `AddDataNode` / `addData` | `dataCreate` | `addDataRules` |
+| `UpdateDataNode` / `updateData` | `dataUpdate` | `updateDataRules` |
+| `DeleteDataNode` / `deleteData` | `dataDelete` | `deleteData` |
+| `SendMessageNode` / `sendMessage` | `sendMessage` | `sendMessageRules` |
+| `SendEmailNode` / `sendEmail` | `sendEmail` | `sendEmailRules` |
+| `InitiateApprovalNode` / `subProcess` | `initiateApproval` | `initiateApprovalRules` |
+| `SendCardNode` / `CardNode` | `sendCard` | `sendCardRules` / `cardRules` |
+| `UpdateCardNode` / `CardUpdateNode` | `updateCard` | `updateCardRules` / `cardUpdateRules` |
+| `CycleContainer` / `foreach` | `foreach` | `cycleContainerRules`，也兼容 `cycleRules` / `foreachRules` 别名；`children` |
+| `AINode` / `ai` | `AIExecutor` | `workFlowRules` |
+
+## 连接器节点示例
+
+```json
+{
+  "type": "connector",
+  "name": "创建钉钉待办",
+  "connectorRules": {
+    "connectorId": "G-CONN-xxx",
+    "actionId": "G-ACT-xxx",
+    "connector": { "mode": 1 },
+    "inputs": {
+      "assignments": [
+        { "column": "subject", "valueType": "literal", "value": "审批待办", "assignments": [] },
+        { "column": "creatorId", "valueType": "processVar", "value": "form_inst_modifier", "assignments": [] }
+      ]
+    }
+  }
+}
+```
+
+`connector.mode` 映射：`1 -> innerConnector`，`3 -> thirdConnector`，`5 -> httpConnector`，`9 -> faasConnector`。保存时 `connectorRules` 会按真实设计器规则转换为 `processJson.props.inputs`；如果租户返回了不同类型，可显式传入 `processType` 覆盖。
+
+## 数据 / 消息 / 代码节点示例
+
+```json
+{
+  "nodes": [
+    {
+      "componentName": "GetSingleDataNode",
+      "name": "查询客户",
+      "getData": {
+        "sourceId": "FORM-CUSTOMER",
+        "assignments": []
+      }
+    },
+    {
+      "componentName": "JavaScriptNode",
+      "name": "计算评级",
+      "JavaScript": {
+        "action": { "code": "return inputs;" },
+        "outputs": []
+      }
+    },
+    {
+      "componentName": "SendMessageNode",
+      "name": "通知负责人",
+      "sendMessageRules": {
+        "messageType": "workNotice",
+        "messageInfo": {
+          "title": "流程通知",
+          "content": "请及时处理"
+        },
+        "toUsers": [
+          { "userId": "manager001", "userName": "负责人" }
+        ]
+      }
+    }
+  ]
+}
+```
+
+## 透传规则
+
+- `props` 会进入 `viewJson`，其中 `name` / `nodeName` / `description` 自动补齐。
+- `processJson.props` 会移除 `name` / `nodeName` / `description` / `title` 等视图字段，并按真实设计器规则转换连接器、代码、取数、新增数据、AI 等节点；如需覆盖可传 `processProps`。
+- 官方组件节点可用 `children` / `childNodes` 嵌套子节点，常用于 `CycleContainer`。
+- 线上设计器里的“分支节点”不是独立的 `BranchNode` 序列化组件，实际由 `ConditionContainer` + `ConditionNode` / `ParallelNode` 表达；普通条件/并行优先使用主文档中的 `route` / `parallel` DSL。
+- 不认识的节点类型会直接报错，不会静默跳过，避免生成断链流程。
+- 从零创建复杂集成自动化时优先使用 `yida-integration`；本参考用于流程表单规则里需要高级组件节点、或已有真实节点配置需要固化的场景。

package/yida-skills/skills/yida-publish-page/SKILL.md

@@ -78,10 +78,12 @@ openyida list-forms <appType> --keyword <页面名>
 发布脚本在 `publish` 前会按以下顺序处理源码：
 
 1. `.oyd.jsx` / `.openyida.jsx` 或显式 `--compat`：先运行 OpenYida compatibility compiler。
-2. 如果源码已有 `export function renderJsx()`：视为宜搭原生源码，只做机械修复（例如事件绑定、数组回调）。
-3. 如果源码是 `export default function Page()`：支持有限 authoring 模式，当前可降级 `useState` 和 `useEffect(..., [])`。
-4. 兼容构建会自动补齐 `renderJsx` return 分支中的隐藏 timestamp 节点，并将直接事件绑定 / `.bind(this)` 机械改成箭头函数包裹。
-5. 对构建后的 `.yida.jsx` 执行 `check-page` 规则、Babel 转 ES5、UglifyJS 压缩，再构建 Schema 发布。
+2. 如果普通 `.jsx` 源码没有 `export function renderJsx()` 但存在 `export default function Page()`：自动尝试有限 authoring 降级，不再要求 Agent 手动补 `--compat`。
+3. 如果源码已有 `export function renderJsx()`：视为宜搭原生源码，机械修复事件绑定、数组回调，并补齐缺失的基础运行时导出。
+4. 如果源码是 `export default function Page()`：支持有限 authoring 模式，当前可降级 `useState` 和 `useEffect(..., [])`；`useEffect` 内引用组件局部 helper/state 会被阻塞，避免发布后 `didMount` 运行时报 `undefined`。
+5. 兼容构建会自动补齐 `renderJsx` return 分支中的隐藏 timestamp 节点，并将直接事件绑定 / `.bind(this)` 机械改成箭头函数包裹。
+6. `check-page` 会硬拦截生命周期大小写错误、小写 `onclick`、渲染时执行事件函数、箭头函数只引用不调用方法、可见 `<button>` 没有事件等按钮不可点击问题。
+7. 对构建后的 `.yida.jsx` 执行 `check-page` 规则、Babel 转 ES5、UglifyJS 压缩，再构建 Schema 发布。
 
 这一步是脚本级确定性处理，优先让 lint/fix/build 解决语法和运行时兼容问题，不应把简单机械修改交给 AI 反复重写。