@microi.net/cli 5.8.5 → 5.8.6

package/skills/v8-workflow/references/progressive-01-/350/212/202/347/202/271/345/274/200/345/247/213-v8-/344/272/213/344/273/266.md

@@ -1,180 +1,180 @@
-# v8-workflow 详细参考 1
-
-> 按需读取；本文件由 SKILL.md 的原章节无损拆分。
-
-<!-- microi-progressive:chunk id=v8-workflow-007 sha256=953f9a9405bc929adab9365997f917e10df0fa16bbb2cf1448806d07fdcc945a -->
-## 节点开始 V8 事件
-
-### 前端 — 指定审批人
-
-```javascript
-// V8.EventName === 'WFNodeStart'
-// 可以强制指定下一节点审批人
-if (V8.Form.DeptId === 'special-dept') {
-  V8.WF.ForceSelectUsers = ['user-id-1', 'user-id-2'];
-}
-```
-
-### 后端 — 阻止流程提交
-
-```javascript
-// V8.EventName === 'WFNodeStart'
-// 返回 Code: 0 可以阻止流程提交并回滚事务
-if (!V8.Form.ApprovalFiles) {
-  V8.Result = { Code: 0, Msg: '请先上传审批附件' };
-}
-```
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=v8-workflow-008 sha256=5849ffaac5c7ffdf3dcfbf4fe8e18951415e1843bd7e233f6a50e36673767f14 -->
-## 节点结束 V8 事件
-
-### 后端 — 流程结束后业务处理
-
-```javascript
-// V8.EventName === 'WFNodeEnd'
-var approvalType = V8.WF.ApprovalType;
-
-// 同意 — 更新业务状态
-if (approvalType === 'Agree') {
-  // 判断是否到达最终节点
-  var nextNode = V8.WF.NextNode;
-  if (!nextNode || nextNode.NodeType === 'End') {
-    // 流程结束，更新业务状态
-    V8.FormEngine.UptFormData(V8.TableModel.Name, {
-      Id: V8.Form.Id,
-      ApprovalStatus: 'Approved',
-      ApprovalTime: DateNow('yyyy-MM-dd HH:mm:ss')
-    });
-  }
-}
-
-// 拒绝 — 回退状态
-if (approvalType === 'Disagree') {
-  V8.FormEngine.UptFormData(V8.TableModel.Name, {
-    Id: V8.Form.Id,
-    ApprovalStatus: 'Rejected',
-    RejectReason: V8.WF.ApprovalIdea
-  });
-}
-
-// 撤回
-if (approvalType === 'Recall') {
-  V8.FormEngine.UptFormData(V8.TableModel.Name, {
-    Id: V8.Form.Id,
-    ApprovalStatus: 'Draft'
-  });
-}
-
-// 通知下一审批人
-if (V8.WF.NextTodoUsers && V8.WF.NextTodoUsers.length > 0) {
-  for (var i = 0; i < V8.WF.NextTodoUsers.length; i++) {
-    V8.ApiEngine.Run('send-notification', {
-      userId: V8.WF.NextTodoUsers[i].Id,
-      title: '您有新的审批任务',
-      content: V8.CurrentUser.Name + '提交了' + V8.TableModel.Name + '审批'
-    });
-  }
-}
-```
-
-### 前端 — 流程提交后提示
-
-```javascript
-// V8.EventName === 'WFNodeEnd'
-if (V8.WF.WorkResult) {
-  V8.Tips('流程已提交', true);
-}
-```
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=v8-workflow-009 sha256=301ee4a5554069c509c559377fa57340af41b5c014cfdf95be834150ab8c8899 -->
-## 前端打开流程表单
-
-```javascript
-// 发起流程
-V8.OpenFormWF(V8.Form, 'Add', {
-  WorkType: 'StartWork',
-  FlowDesignId: 'flow-design-id'
-});
-
-// 查看流程
-V8.OpenFormWF(V8.Form, 'View', {
-  WorkType: 'ViewWork',
-  FlowDesignId: 'flow-design-id'
-});
-```
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=v8-workflow-010 sha256=99dde7c6359317e8b4eb72bddfc568520506550c8381e53d3d238e716c92272c -->
-## MCP 创建/检查/测试工作流
-
-从自然语言需求创建审批流时，优先整理成完整 Manifest 的 `workflows` 配置，再走 MCP 干跑和验收流程。
-
-```json
-{
-  "workflows": [
-    {
-      "FlowDesign": { "FlowName": "请假审批", "table": "diy_leave", "IsEnable": 1 },
-      "Nodes": [
-        { "Id": "start", "NodeName": "发起人", "NodeType": "Start", "LineValueV8": "" },
-        { "Id": "leader", "NodeName": "部门负责人审批", "NodeType": "Approve", "Roles": "dept-leader" },
-        { "Id": "end", "NodeName": "结束", "NodeType": "End" }
-      ],
-      "Lines": [
-        { "Id": "line_start_leader", "FromNodeId": "start", "ToNodeId": "leader", "LineName": "发起人 到 部门负责人审批", "LineValue": "" },
-        { "Id": "line_leader_end", "FromNodeId": "leader", "ToNodeId": "end", "LineName": "部门负责人审批 到 结束", "LineValue": "" }
-      ]
-    }
-  ]
-}
-```
-
-MCP 操作顺序：
-
-1. `microi_get_db_schema`：确认业务表、已有流程、角色、字段。
-2. `microi_get_manifest_schema`：按 Manifest 协议生成 tables/modules/workflows。
-3. `microi_plan_system`：本地干跑，必须修复 workflow 拓扑错误。
-4. `microi_check_workflow_package`：单独检查某个 workflow package。
-5. `microi_test_workflow_condition`：对图形条件生成的 `LineValueV8` 传入样例 `formData`，验证会选中哪条路线。
-6. `microi_generate_system` 或 `microi_save_workflow_package`：用户明确确认后再写入。
-
-工作流建模规则：
-
-- 必须有且仅有 1 个开始节点，至少 1 个结束节点。
-- 所有 `wf_line.FromNodeId/ToNodeId` 必须指向存在的节点。
-- 线路标题 `LineName` 默认使用 `{起点节点名称} 到 {终点节点名称}`，不要把业务条件名写成线路标题。
-- 条件名称只作为图形配置/注释标记里的业务说明；修改条件名称不应改变线路标题。
-- 多出线节点必须配置条件判断 V8，优先设置 `V8.NextNodeId`，只有兼容旧条件值时才设置 `V8.LineValue`。
-- 图形条件生成的 V8 会带 `MICROI_WF_LINE_CONDITION_JSON` 标记，MCP 测试工具只解析该标记，不执行任意手写 V8。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=v8-workflow-011 sha256=70703905fd4bdbde1d645e8d1dbb77569a352da8c2014b2acd2e997464b7397a -->
-## 发起流程与表单保存
-
-新建业务数据并发起流程时，应先保存表单，再启动流程，或使用平台的合并接口 `StartWorkWithForm` 在同一事务里完成。首次发起建议以 `Add` 模式打开流程表单；如果前端提前生成了 `Id` 但业务表还没有该行，后端会使用 `_NoLineForAdd` 兜底，避免 `UptFormData` 报“数据显示不存在”。
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=v8-workflow-012 sha256=4f7575ce99688366c05f2267d8271c12215d05c89e5664f7564d5cf04a94f281 -->
-## 流程相关表
-
-| 表 | 说明 |
-|---|---|
-| `WF_FlowDesign` | 流程图设计表 |
-| `WF_Node` | 流程节点属性表 |
-| `WF_Line` | 流程条件(线)属性表 |
-| `WF_Flow` | 流程实例表 |
-| `WF_Work` | 流程工作待办表 |
-| `WF_History` | 流程轨迹表 |
-
-<!-- /microi-progressive:chunk -->
-<!-- microi-progressive:chunk id=v8-workflow-013 sha256=d6b942d331b8504cb0e59e48ecb370e88ce572d50b1e50bf367dcbc6796fed23 -->
-## 注意事项
-
-- 条件判断 V8 事件可以设置 `V8.NextNodeId` 直接指定下一节点；未设置时才按 `V8.LineValue` 匹配条件线的**条件值**
-- 配置图形化条件时，节点/路线标识来自流程拓扑，条件名称只是规则名称，不要用条件名称覆盖 `wf_line.LineName`
-- 节点开始后端事件返回 `{ Code: 0, Msg: '...' }` 或 `V8.Result = { Code: 0 }` 可阻止流程提交
-- 流程事件在事务中执行，任何节点返回失败都会回滚
-- `V8.WF.ApprovalType === 'Auto'` 表示自动节点（发起、业务节点、自动结束），无需人工审批
-- `V8.WF.ForceSelectUsers` 仅在**前端节点开始事件**中有效
-<!-- /microi-progressive:chunk -->
+# v8-workflow 详细参考 1
+
+> 按需读取；本文件由 SKILL.md 的原章节无损拆分。
+
+<!-- microi-progressive:chunk id=v8-workflow-007 sha256=953f9a9405bc929adab9365997f917e10df0fa16bbb2cf1448806d07fdcc945a -->
+## 节点开始 V8 事件
+
+### 前端 — 指定审批人
+
+```javascript
+// V8.EventName === 'WFNodeStart'
+// 可以强制指定下一节点审批人
+if (V8.Form.DeptId === 'special-dept') {
+  V8.WF.ForceSelectUsers = ['user-id-1', 'user-id-2'];
+}
+```
+
+### 后端 — 阻止流程提交
+
+```javascript
+// V8.EventName === 'WFNodeStart'
+// 返回 Code: 0 可以阻止流程提交并回滚事务
+if (!V8.Form.ApprovalFiles) {
+  V8.Result = { Code: 0, Msg: '请先上传审批附件' };
+}
+```
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=v8-workflow-008 sha256=5849ffaac5c7ffdf3dcfbf4fe8e18951415e1843bd7e233f6a50e36673767f14 -->
+## 节点结束 V8 事件
+
+### 后端 — 流程结束后业务处理
+
+```javascript
+// V8.EventName === 'WFNodeEnd'
+var approvalType = V8.WF.ApprovalType;
+
+// 同意 — 更新业务状态
+if (approvalType === 'Agree') {
+  // 判断是否到达最终节点
+  var nextNode = V8.WF.NextNode;
+  if (!nextNode || nextNode.NodeType === 'End') {
+    // 流程结束，更新业务状态
+    V8.FormEngine.UptFormData(V8.TableModel.Name, {
+      Id: V8.Form.Id,
+      ApprovalStatus: 'Approved',
+      ApprovalTime: DateNow('yyyy-MM-dd HH:mm:ss')
+    });
+  }
+}
+
+// 拒绝 — 回退状态
+if (approvalType === 'Disagree') {
+  V8.FormEngine.UptFormData(V8.TableModel.Name, {
+    Id: V8.Form.Id,
+    ApprovalStatus: 'Rejected',
+    RejectReason: V8.WF.ApprovalIdea
+  });
+}
+
+// 撤回
+if (approvalType === 'Recall') {
+  V8.FormEngine.UptFormData(V8.TableModel.Name, {
+    Id: V8.Form.Id,
+    ApprovalStatus: 'Draft'
+  });
+}
+
+// 通知下一审批人
+if (V8.WF.NextTodoUsers && V8.WF.NextTodoUsers.length > 0) {
+  for (var i = 0; i < V8.WF.NextTodoUsers.length; i++) {
+    V8.ApiEngine.Run('send-notification', {
+      userId: V8.WF.NextTodoUsers[i].Id,
+      title: '您有新的审批任务',
+      content: V8.CurrentUser.Name + '提交了' + V8.TableModel.Name + '审批'
+    });
+  }
+}
+```
+
+### 前端 — 流程提交后提示
+
+```javascript
+// V8.EventName === 'WFNodeEnd'
+if (V8.WF.WorkResult) {
+  V8.Tips('流程已提交', true);
+}
+```
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=v8-workflow-009 sha256=301ee4a5554069c509c559377fa57340af41b5c014cfdf95be834150ab8c8899 -->
+## 前端打开流程表单
+
+```javascript
+// 发起流程
+V8.OpenFormWF(V8.Form, 'Add', {
+  WorkType: 'StartWork',
+  FlowDesignId: 'flow-design-id'
+});
+
+// 查看流程
+V8.OpenFormWF(V8.Form, 'View', {
+  WorkType: 'ViewWork',
+  FlowDesignId: 'flow-design-id'
+});
+```
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=v8-workflow-010 sha256=99dde7c6359317e8b4eb72bddfc568520506550c8381e53d3d238e716c92272c -->
+## MCP 创建/检查/测试工作流
+
+从自然语言需求创建审批流时，优先整理成完整 Manifest 的 `workflows` 配置，再走 MCP 干跑和验收流程。
+
+```json
+{
+  "workflows": [
+    {
+      "FlowDesign": { "FlowName": "请假审批", "table": "diy_leave", "IsEnable": 1 },
+      "Nodes": [
+        { "Id": "start", "NodeName": "发起人", "NodeType": "Start", "LineValueV8": "" },
+        { "Id": "leader", "NodeName": "部门负责人审批", "NodeType": "Approve", "Roles": "dept-leader" },
+        { "Id": "end", "NodeName": "结束", "NodeType": "End" }
+      ],
+      "Lines": [
+        { "Id": "line_start_leader", "FromNodeId": "start", "ToNodeId": "leader", "LineName": "发起人 到 部门负责人审批", "LineValue": "" },
+        { "Id": "line_leader_end", "FromNodeId": "leader", "ToNodeId": "end", "LineName": "部门负责人审批 到 结束", "LineValue": "" }
+      ]
+    }
+  ]
+}
+```
+
+MCP 操作顺序：
+
+1. `microi_get_db_schema`：确认业务表、已有流程、角色、字段。
+2. `microi_get_manifest_schema`：按 Manifest 协议生成 tables/modules/workflows。
+3. `microi_plan_system`：本地干跑，必须修复 workflow 拓扑错误。
+4. `microi_check_workflow_package`：单独检查某个 workflow package。
+5. `microi_test_workflow_condition`：对图形条件生成的 `LineValueV8` 传入样例 `formData`，验证会选中哪条路线。
+6. `microi_generate_system` 或 `microi_save_workflow_package`：用户明确确认后再写入。
+
+工作流建模规则：
+
+- 必须有且仅有 1 个开始节点，至少 1 个结束节点。
+- 所有 `wf_line.FromNodeId/ToNodeId` 必须指向存在的节点。
+- 线路标题 `LineName` 默认使用 `{起点节点名称} 到 {终点节点名称}`，不要把业务条件名写成线路标题。
+- 条件名称只作为图形配置/注释标记里的业务说明；修改条件名称不应改变线路标题。
+- 多出线节点必须配置条件判断 V8，优先设置 `V8.NextNodeId`，只有兼容旧条件值时才设置 `V8.LineValue`。
+- 图形条件生成的 V8 会带 `MICROI_WF_LINE_CONDITION_JSON` 标记，MCP 测试工具只解析该标记，不执行任意手写 V8。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=v8-workflow-011 sha256=70703905fd4bdbde1d645e8d1dbb77569a352da8c2014b2acd2e997464b7397a -->
+## 发起流程与表单保存
+
+新建业务数据并发起流程时，应先保存表单，再启动流程，或使用平台的合并接口 `StartWorkWithForm` 在同一事务里完成。首次发起建议以 `Add` 模式打开流程表单；如果前端提前生成了 `Id` 但业务表还没有该行，后端会使用 `_NoLineForAdd` 兜底，避免 `UptFormData` 报“数据显示不存在”。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=v8-workflow-012 sha256=4f7575ce99688366c05f2267d8271c12215d05c89e5664f7564d5cf04a94f281 -->
+## 流程相关表
+
+| 表 | 说明 |
+|---|---|
+| `WF_FlowDesign` | 流程图设计表 |
+| `WF_Node` | 流程节点属性表 |
+| `WF_Line` | 流程条件(线)属性表 |
+| `WF_Flow` | 流程实例表 |
+| `WF_Work` | 流程工作待办表 |
+| `WF_History` | 流程轨迹表 |
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=v8-workflow-013 sha256=d6b942d331b8504cb0e59e48ecb370e88ce572d50b1e50bf367dcbc6796fed23 -->
+## 注意事项
+
+- 条件判断 V8 事件可以设置 `V8.NextNodeId` 直接指定下一节点；未设置时才按 `V8.LineValue` 匹配条件线的**条件值**
+- 配置图形化条件时，节点/路线标识来自流程拓扑，条件名称只是规则名称，不要用条件名称覆盖 `wf_line.LineName`
+- 节点开始后端事件返回 `{ Code: 0, Msg: '...' }` 或 `V8.Result = { Code: 0 }` 可阻止流程提交
+- 流程事件在事务中执行，任何节点返回失败都会回滚
+- `V8.WF.ApprovalType === 'Auto'` 表示自动节点（发起、业务节点、自动结束），无需人工审批
+- `V8.WF.ForceSelectUsers` 仅在**前端节点开始事件**中有效
+<!-- /microi-progressive:chunk -->

package/skills/v8-workflow/references/workflow-configuration.md

@@ -1,49 +1,49 @@
-# 工作流引擎配置清单
-
-事实源：当前租户 `microi_get_db_schema`、`Microi.Core/Param/WFParam.cs`、
-`Microi.WorkFlow` 运行时、PC `views/workflow/component`。下表只描述审批工作流。
-
-## 定义、节点、连线
-
-| 资源 | 可配置字段 | 用途与注意 |
-|---|---|---|
-| `wf_flowdesign` | `FlowName, Category, Description, Remark, Sort, Preview, JsonData` | 名称、分类、说明、排序、预览与画布数据；画布最终按 `wf_node/wf_line` 渲染。 |
-| `wf_flowdesign` | `TableId, IsEnable, Roles, StartV8, EndV8` | 关联业务 `diy_table.Id`、启用、允许发起角色、流程开始/结束事件。模块流程只选已启用项。 |
-| `wf_node` | `Id, NodeName, NodeType, Icon, Description, Remark, PositionLeft, PositionTop` | 稳定节点身份、类型和画布位置。坐标写为 CSS 像素；缺失时 MCP 自动布局。 |
-| `wf_node` | `Users, Roles, Depts, BindJobs, SameDeptApprove` | 前四者是 `[{Id,Name}]` JSON 审批人来源；`SameDeptApprove` 只进一步筛选同部门候选人，不能单独提供接收人。不能伪造跨租户 Id。 |
-| `wf_node` | `AllowSelectUsers, AllowAddUsers, AllowRecall, AllowHandOver, HideHandOverSelect, BackNodes, Timeout` | 上游手选下节点人员、加签、撤回、移交、隐藏移交选择、可退回节点、超时。`BackNodes` 保存 `[{Id,NodeName}]`；会签通常不启用手选。 |
-| `wf_node` | `CopyUsers, DisplayFields, HideFields, EditFields, FieldsConfig, FieldsConfigComponent, TableId` | 抄送 `IdName` 列表、节点表单字段权限、配置组件与业务表。字段配置应从当前表真实字段建模。 |
-| `wf_node` | `StartV8, StartV8Server, EndV8, EndV8Server, LineValueV8, AllowAddUserV8Code` | 前后端节点开始/结束事件、多出线选择与加签过滤代码。条件写在当前节点，不要误放在 `wf_line.V8Code`。 |
-| `wf_line` | `Id, FromNodeId, ToNodeId, LineName, LineValue, V8Code` | 稳定线身份、端点、展示标题、条件值与兼容线代码。标题用“起点 到 终点”；分支由源节点 `LineValueV8` 指定 `V8.NextNodeId` 或 `V8.LineValue`。 |
-
-`NodeType`：`Start` 发起；`Auto` 自动；`Business` 业务提交；
-`Approve` 审批；`Countersign` 会签；`End` 人工结束；`AutoEnd` 自动结束。
-人工节点必须有真实接收人策略，否则流程可能创建实例却无待办。
-
-## 实例与操作
-
-| 资源/动作 | 功能 |
-|---|---|
-| `wf_flow` | 流程实例、业务表/行、发起人、状态、最近表单 JSON、经办人与抄送汇总。`FormData` 会变化，不是原始快照。 |
-| `wf_work` | 每个接收人的待办/已办；按 `ReceiverId + WorkState` 确定可处理工作。 |
-| `wf_history` | 每一步的起止节点、连线、处理人、意见、表单与抄送历史。 |
-| `StartWork / StartWorkWithForm` | 发起流程；新业务行建议使用合并表单提交接口。 |
-| `SendWork / SendWorkWithForm` | 处理审批、业务节点、会签及后续自动节点。 |
-| `GetStartWFNode / GetWFNodeModel / GetNextNodeConfirmUsers` | 查询开始节点、节点属性及下一节点接收人。 |
-| `RecallWork / CancelFlow / HandOverWork` | 撤回、取消、移交。取消独立事务且可改写实例 `FormData`，须按业务终态复核。 |
-| `GetWFWork / GetWFFlow / GetWFHistory / GetWFStats / MarkCopyRead` | 待办、实例、历史、统计与抄送已读。普通用户须走身份与菜单/工作权限边界。 |
-
-## MCP 到模块的生成顺序
-
-1. 查询当前租户业务表、角色、用户、部门、岗位和现有流程；不要复制其它租户 Id。
-2. Manifest 写入 `workflows[]` 的 `FlowDesign/Nodes/Lines`；人工节点设置人员策略，
-   所有连线指向同包节点，分支节点写 `LineValueV8`。
-3. 模块设置 `openType:"WorkFlow"`、`table:"业务表名"`，同包流程传
-   `flowName:"流程名称"`；现有流程传 `flowDesignId:"真实 Id"`。
-4. 执行 `microi_plan_system`、`microi_check_workflow_package`，分支调用
-   `microi_test_workflow_condition`；写入后回读三张定义表与 `sys_menu`，
-   用实际账号发起、处理、查看历史与流程图。
-
-`microi_check_workflow_package` 是本地结构检查；MCP 保存前还会核对当前租户的
-用户、角色、部门和岗位 Id。账号是否仍有效、审批人是否有业务权限以及实际到达待办，
-仍必须通过运行时与真实业务回读。
+# 工作流引擎配置清单
+
+事实源：当前租户 `microi_get_db_schema`、`Microi.Core/Param/WFParam.cs`、
+`Microi.WorkFlow` 运行时、PC `views/workflow/component`。下表只描述审批工作流。
+
+## 定义、节点、连线
+
+| 资源 | 可配置字段 | 用途与注意 |
+|---|---|---|
+| `wf_flowdesign` | `FlowName, Category, Description, Remark, Sort, Preview, JsonData` | 名称、分类、说明、排序、预览与画布数据；画布最终按 `wf_node/wf_line` 渲染。 |
+| `wf_flowdesign` | `TableId, IsEnable, Roles, StartV8, EndV8` | 关联业务 `diy_table.Id`、启用、允许发起角色、流程开始/结束事件。模块流程只选已启用项。 |
+| `wf_node` | `Id, NodeName, NodeType, Icon, Description, Remark, PositionLeft, PositionTop` | 稳定节点身份、类型和画布位置。坐标写为 CSS 像素；缺失时 MCP 自动布局。 |
+| `wf_node` | `Users, Roles, Depts, BindJobs, SameDeptApprove` | 前四者是 `[{Id,Name}]` JSON 审批人来源；`SameDeptApprove` 只进一步筛选同部门候选人，不能单独提供接收人。不能伪造跨租户 Id。 |
+| `wf_node` | `AllowSelectUsers, AllowAddUsers, AllowRecall, AllowHandOver, HideHandOverSelect, BackNodes, Timeout` | 上游手选下节点人员、加签、撤回、移交、隐藏移交选择、可退回节点、超时。`BackNodes` 保存 `[{Id,NodeName}]`；会签通常不启用手选。 |
+| `wf_node` | `CopyUsers, DisplayFields, HideFields, EditFields, FieldsConfig, FieldsConfigComponent, TableId` | 抄送 `IdName` 列表、节点表单字段权限、配置组件与业务表。字段配置应从当前表真实字段建模。 |
+| `wf_node` | `StartV8, StartV8Server, EndV8, EndV8Server, LineValueV8, AllowAddUserV8Code` | 前后端节点开始/结束事件、多出线选择与加签过滤代码。条件写在当前节点，不要误放在 `wf_line.V8Code`。 |
+| `wf_line` | `Id, FromNodeId, ToNodeId, LineName, LineValue, V8Code` | 稳定线身份、端点、展示标题、条件值与兼容线代码。标题用“起点 到 终点”；分支由源节点 `LineValueV8` 指定 `V8.NextNodeId` 或 `V8.LineValue`。 |
+
+`NodeType`：`Start` 发起；`Auto` 自动；`Business` 业务提交；
+`Approve` 审批；`Countersign` 会签；`End` 人工结束；`AutoEnd` 自动结束。
+人工节点必须有真实接收人策略，否则流程可能创建实例却无待办。
+
+## 实例与操作
+
+| 资源/动作 | 功能 |
+|---|---|
+| `wf_flow` | 流程实例、业务表/行、发起人、状态、最近表单 JSON、经办人与抄送汇总。`FormData` 会变化，不是原始快照。 |
+| `wf_work` | 每个接收人的待办/已办；按 `ReceiverId + WorkState` 确定可处理工作。 |
+| `wf_history` | 每一步的起止节点、连线、处理人、意见、表单与抄送历史。 |
+| `StartWork / StartWorkWithForm` | 发起流程；新业务行建议使用合并表单提交接口。 |
+| `SendWork / SendWorkWithForm` | 处理审批、业务节点、会签及后续自动节点。 |
+| `GetStartWFNode / GetWFNodeModel / GetNextNodeConfirmUsers` | 查询开始节点、节点属性及下一节点接收人。 |
+| `RecallWork / CancelFlow / HandOverWork` | 撤回、取消、移交。取消独立事务且可改写实例 `FormData`，须按业务终态复核。 |
+| `GetWFWork / GetWFFlow / GetWFHistory / GetWFStats / MarkCopyRead` | 待办、实例、历史、统计与抄送已读。普通用户须走身份与菜单/工作权限边界。 |
+
+## MCP 到模块的生成顺序
+
+1. 查询当前租户业务表、角色、用户、部门、岗位和现有流程；不要复制其它租户 Id。
+2. Manifest 写入 `workflows[]` 的 `FlowDesign/Nodes/Lines`；人工节点设置人员策略，
+   所有连线指向同包节点，分支节点写 `LineValueV8`。
+3. 模块设置 `openType:"WorkFlow"`、`table:"业务表名"`，同包流程传
+   `flowName:"流程名称"`；现有流程传 `flowDesignId:"真实 Id"`。
+4. 执行 `microi_plan_system`、`microi_check_workflow_package`，分支调用
+   `microi_test_workflow_condition`；写入后回读三张定义表与 `sys_menu`，
+   用实际账号发起、处理、查看历史与流程图。
+
+`microi_check_workflow_package` 是本地结构检查；MCP 保存前还会核对当前租户的
+用户、角色、部门和岗位 Id。账号是否仍有效、审批人是否有业务权限以及实际到达待办，
+仍必须通过运行时与真实业务回读。