@coding-flow/flow-design 0.0.51 → 0.0.53

package/dist/components/design-editor/node-components/action/presenter.js

@@ -42,9 +42,7 @@ class FlowActionListPresenter {
     update(action) {
         const actionId = action.id;
         const actionIdList = this.data.map((action)=>action.id);
-        console.log('actionIdList:', actionIdList);
-        console.log('action:', action);
-        if (actionIdList.indexOf(actionId) > 0) {
+        if (actionIdList.includes(actionId)) {
             const data = this.data.map((item)=>{
                 if (item.id === actionId) return {
                     ...item,

package/dist/components/design-editor/node-components/condition/index.js

@@ -7,6 +7,7 @@ import { EditOutlined } from "@ant-design/icons";
 import { ConditionConfigModal } from "../../../../script-components/modal/condition-config-modal.js";
 import { useScriptVariables } from "../../hooks/use-script-variables.js";
 import { GroovyScriptLoader } from "../../../../script-components/components/groovy-script-loader.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const ConditionConfigContent = (props)=>{
     const [visible, setVisible] = react.useState(false);
     const scriptVariables = useScriptVariables();
@@ -53,7 +54,10 @@ const ConditionScript = ()=>{
         },
         layout: "vertical",
         children: /*#__PURE__*/ jsx(Form.Item, {
-            label: "条件表达式",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "条件表达式",
+                description: "条件分支的判断脚本，返回 true 时流程走该分支。"
+            }),
             name: "script",
             children: /*#__PURE__*/ jsx(Field, {
                 name: "script",

package/dist/components/design-editor/node-components/node-order/index.js

@@ -2,6 +2,7 @@ import { jsx } from "react/jsx-runtime";
 import "react";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
 import { Form, Input } from "antd";
+import { FieldTip } from "../../../field-tip/index.js";
 const NodeOrder = ()=>{
     const [form] = Form.useForm();
     return /*#__PURE__*/ jsx(Form, {
@@ -11,9 +12,11 @@ const NodeOrder = ()=>{
         },
         layout: "vertical",
         children: /*#__PURE__*/ jsx(Form.Item, {
-            label: "优先级",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "优先级",
+                description: "数字越小优先级越高。当多个分支或节点可同时执行时，按此排序。"
+            }),
             name: "order",
-            tooltip: "数字越小优先级越高",
             children: /*#__PURE__*/ jsx(Field, {
                 name: "order",
                 render: ({ field: { value, onChange } })=>/*#__PURE__*/ jsx(Input, {

package/dist/components/design-editor/node-components/strategy/advice.js

@@ -2,6 +2,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import "react";
 import { Form, Switch } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
+import { FieldTip } from "../../../field-tip/index.js";
 const AdviceStrategy = ()=>{
     const [form] = Form.useForm();
     return /*#__PURE__*/ jsxs(Form, {
@@ -12,7 +13,10 @@ const AdviceStrategy = ()=>{
         layout: "vertical",
         children: [
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "审批意见是否必填",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "审批意见是否必填",
+                    description: "开启后，审批人提交审批时必须填写审批意见。"
+                }),
                 name: [
                     "AdviceStrategy",
                     "adviceRequired"
@@ -28,7 +32,10 @@ const AdviceStrategy = ()=>{
                 })
             }),
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "审批签名是否必填",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "审批签名是否必填",
+                    description: "开启后，审批人提交审批时必须完成签名。"
+                }),
                 name: [
                     "AdviceStrategy",
                     "signRequired"

package/dist/components/design-editor/node-components/strategy/deplay.js

@@ -2,6 +2,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import "react";
 import { Form, Input, Select } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
+import { FieldTip } from "../../../field-tip/index.js";
 const DelayStrategy = ()=>{
     const [form] = Form.useForm();
     return /*#__PURE__*/ jsxs(Form, {
@@ -12,7 +13,10 @@ const DelayStrategy = ()=>{
         layout: "vertical",
         children: [
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "延迟时间类型",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "延迟时间类型",
+                    description: "延迟时间的计量单位（秒、分、时、天）。"
+                }),
                 name: [
                     "DelayStrategy",
                     "type"
@@ -44,7 +48,10 @@ const DelayStrategy = ()=>{
                 })
             }),
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "延迟时间",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "延迟时间",
+                    description: "节点执行的延迟时长，需配合延迟时间类型一起使用。"
+                }),
                 name: [
                     "DelayStrategy",
                     "time"

package/dist/components/design-editor/node-components/strategy/error-trigger.js

@@ -6,6 +6,7 @@ import { GroovyScriptPreview } from "../../../../script-components/components/gr
 import { EditOutlined } from "@ant-design/icons";
 import { ErrorTriggerConfigModal } from "../../../../script-components/modal/error-trigger-config-modal.js";
 import { GroovyScriptLoader } from "../../../../script-components/components/groovy-script-loader.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const ErrorTriggerConfigContent = (props)=>{
     const [visible, setVisible] = react.useState(false);
     const value = props.value || '';
@@ -51,12 +52,14 @@ const ErrorTriggerStrategy = ()=>{
         },
         layout: "vertical",
         children: /*#__PURE__*/ jsx(Form.Item, {
-            label: "异常配置",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "异常配置",
+                description: "当节点未能匹配到任何操作人时触发的脚本配置，可用于兜底处理。"
+            }),
             name: [
                 "ErrorTriggerStrategy",
                 "script"
             ],
-            tooltip: "在没有匹配到操作人时触发的脚本配置",
             children: /*#__PURE__*/ jsx(Field, {
                 name: "ErrorTriggerStrategy.script",
                 render: ({ field: { value, onChange } })=>/*#__PURE__*/ jsx(GroovyScriptLoader, {

package/dist/components/design-editor/node-components/strategy/multi-operator-audit.js

@@ -2,6 +2,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import react from "react";
 import { Form, Input, Select } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
+import { FieldTip } from "../../../field-tip/index.js";
 const MultiOperatorAuditStrategy = ()=>{
     const [form] = Form.useForm();
     const [percentVisible, setPercentVisible] = react.useState(false);
@@ -13,7 +14,28 @@ const MultiOperatorAuditStrategy = ()=>{
         layout: "vertical",
         children: [
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "多人审批策略",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "多人审批策略",
+                    description: "当节点有多个审批人时，决定审批结果的判定方式。",
+                    items: [
+                        {
+                            label: "循序提交",
+                            detail: "多个审批人按顺序依次审批。"
+                        },
+                        {
+                            label: "合并审核",
+                            detail: "按会签通过百分比合并判定（需设置百分比）。"
+                        },
+                        {
+                            label: "任意审核",
+                            detail: "任意一位审批人审核后即流转。"
+                        },
+                        {
+                            label: "任意一人",
+                            detail: "随机指定一位审批人进行审核。"
+                        }
+                    ]
+                }),
                 name: [
                     "MultiOperatorAuditStrategy",
                     "type"
@@ -48,7 +70,10 @@ const MultiOperatorAuditStrategy = ()=>{
                 })
             }),
             percentVisible && /*#__PURE__*/ jsx(Form.Item, {
-                label: "会签通过百分比",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "会签通过比例",
+                    description: "合并审核时，通过人数达到该比例才视为该节点通过，取值 0~1 的小数（如 0.5 表示半数通过）。"
+                }),
                 name: [
                     "MultiOperatorAuditStrategy",
                     "percent"

package/dist/components/design-editor/node-components/strategy/node-title.js

@@ -7,6 +7,7 @@ import { GroovyScriptPreview } from "../../../../script-components/components/gr
 import { NodeTitleConfigModal } from "../../../../script-components/modal/node-title-config-modal.js";
 import { useScriptVariables } from "../../hooks/use-script-variables.js";
 import { GroovyScriptLoader } from "../../../../script-components/components/groovy-script-loader.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const NodeTitleConfigContent = (props)=>{
     const [visible, setVisible] = react.useState(false);
     const scriptVariables = useScriptVariables();
@@ -49,7 +50,10 @@ const NodeTitleStrategy = ()=>/*#__PURE__*/ jsx(Fragment, {
             },
             layout: "vertical",
             children: /*#__PURE__*/ jsx(Form.Item, {
-                label: "节点标题",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "待办标题",
+                    description: "通过脚本设置待办消息的展示标题。"
+                }),
                 children: /*#__PURE__*/ jsx(Field, {
                     name: "NodeTitleStrategy.script",
                     render: (props)=>{

package/dist/components/design-editor/node-components/strategy/operator-load.js

@@ -6,6 +6,7 @@ import { EditOutlined } from "@ant-design/icons";
 import { GroovyScriptPreview } from "../../../../script-components/components/groovy-script-preview.js";
 import { OperatorLoadConfigModal } from "../../../../script-components/modal/operator-load-config-modal.js";
 import { GroovyScriptLoader } from "../../../../script-components/components/groovy-script-loader.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const SELECT_TYPE_OPTIONS = [
     {
         label: '脚本指定',
@@ -66,12 +67,28 @@ const OperatorLoadStrategy = ()=>{
         layout: "vertical",
         children: [
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "操作人设定方式",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "操作人设定方式",
+                    description: "选择该节点操作人的指定方式。",
+                    items: [
+                        {
+                            label: "脚本指定",
+                            detail: "通过脚本计算得出操作人。"
+                        },
+                        {
+                            label: "发起人设定",
+                            detail: "由发起人在提交时选择操作人。"
+                        },
+                        {
+                            label: "审批人设定",
+                            detail: "由上一审批人在审批时选择操作人。"
+                        }
+                    ]
+                }),
                 name: [
                     "OperatorLoadStrategy",
                     "selectType"
                 ],
-                tooltip: "选择操作人的指定方式",
                 children: /*#__PURE__*/ jsx(Field, {
                     name: "OperatorLoadStrategy.selectType",
                     render: ({ field: { value, onChange } })=>/*#__PURE__*/ jsx(Select, {
@@ -86,12 +103,14 @@ const OperatorLoadStrategy = ()=>{
                 render: ({ field: { value: selectType } })=>{
                     const isRangeMode = 'INITIATOR_SELECT' === selectType || 'APPROVER_SELECT' === selectType;
                     return /*#__PURE__*/ jsx(Form.Item, {
-                        label: isRangeMode ? "设定人员范围" : "当前操作人",
+                        label: /*#__PURE__*/ jsx(FieldTip, {
+                            label: isRangeMode ? "设定人员范围" : "当前操作人",
+                            description: isRangeMode ? "设定可选人员范围，留空表示不限范围（可选任意人）。" : "通过脚本设定该节点的操作人。"
+                        }),
                         name: [
                             "OperatorLoadStrategy",
                             "script"
                         ],
-                        tooltip: isRangeMode ? "设定可选人员范围，留空表示不限范围（可选任意人）" : "设定流程的审批人",
                         children: /*#__PURE__*/ jsx(Field, {
                             name: "OperatorLoadStrategy.script",
                             render: ({ field: { value, onChange } })=>/*#__PURE__*/ jsx(GroovyScriptLoader, {

package/dist/components/design-editor/node-components/strategy/record-merge.js

@@ -2,6 +2,7 @@ import { Fragment, jsx } from "react/jsx-runtime";
 import "react";
 import { Form, Switch } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
+import { FieldTip } from "../../../field-tip/index.js";
 const RecordMergeStrategy = ()=>{
     const [form] = Form.useForm();
     return /*#__PURE__*/ jsx(Form, {
@@ -11,7 +12,10 @@ const RecordMergeStrategy = ()=>{
         },
         layout: "vertical",
         children: /*#__PURE__*/ jsx(Form.Item, {
-            label: "启用记录合并",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "启用合并审批",
+                description: "开启后，当流程流转到该节点时，同一流程下的多条审批记录将自动合并到一起进行审批。"
+            }),
             name: [
                 "RecordMergeStrategy",
                 "enable"

package/dist/components/design-editor/node-components/strategy/resubmit.js

@@ -2,6 +2,7 @@ import { jsx } from "react/jsx-runtime";
 import "react";
 import { Form, Select } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
+import { FieldTip } from "../../../field-tip/index.js";
 const ResubmitStrategy = ()=>{
     const [form] = Form.useForm();
     return /*#__PURE__*/ jsx(Form, {
@@ -11,7 +12,20 @@ const ResubmitStrategy = ()=>{
         },
         layout: "vertical",
         children: /*#__PURE__*/ jsx(Form.Item, {
-            label: "重新提交配置",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "重新提交配置",
+                description: "审批被退回后，重新提交时的流转方式。",
+                items: [
+                    {
+                        label: "跳转到撤回节点",
+                        detail: "退回后直接跳转到上次撤回的节点继续审批。"
+                    },
+                    {
+                        label: "从头逐级提交",
+                        detail: "退回后回到流程起点，逐级重新提交审批。"
+                    }
+                ]
+            }),
             name: [
                 "ResubmitStrategy",
                 "type"

package/dist/components/design-editor/node-components/strategy/revoke.js

@@ -2,6 +2,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import react from "react";
 import { Form, Select, Switch } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
+import { FieldTip } from "../../../field-tip/index.js";
 const RevokeStrategy = ()=>{
     const [form] = Form.useForm();
     const [enable, setEnable] = react.useState(false);
@@ -13,7 +14,10 @@ const RevokeStrategy = ()=>{
         layout: "vertical",
         children: [
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "启动撤回功能",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "启动撤回功能",
+                    description: "开启后，审批人在自己审批通过后可发起撤回，撤回时流程回到本节点重新审批。"
+                }),
                 name: [
                     "RevokeStrategy",
                     "enable"
@@ -30,7 +34,20 @@ const RevokeStrategy = ()=>{
                 })
             }),
             enable && /*#__PURE__*/ jsx(Form.Item, {
-                label: "撤回方式",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "撤回方式",
+                    description: "审批人在自己审批通过后可发起撤回，撤回后流程回到本节点重新审批。仅“已通过”状态且由原审批人发起时有效。",
+                    items: [
+                        {
+                            label: "撤回到当前节点",
+                            detail: "无论下级是否已审批，均可撤回，下级记录全部作废。"
+                        },
+                        {
+                            label: "撤回上级节点",
+                            detail: "仅当下级节点尚未审批时才允许撤回；下级一旦审批完成则无法撤回。"
+                        }
+                    ]
+                }),
                 name: [
                     "RevokeStrategy",
                     "type"

package/dist/components/design-editor/node-components/strategy/router.js

@@ -6,6 +6,7 @@ import { GroovyScriptPreview } from "../../../../script-components/components/gr
 import { EditOutlined } from "@ant-design/icons";
 import { RouterConfigModal } from "../../../../script-components/modal/router-config-modal.js";
 import { GroovyScriptLoader } from "../../../../script-components/components/groovy-script-loader.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const RouterConfigContent = (props)=>{
     const [visible, setVisible] = react.useState(false);
     const value = props.value || '';
@@ -50,7 +51,10 @@ const RouterStrategy = ()=>{
         },
         layout: "vertical",
         children: /*#__PURE__*/ jsx(Form.Item, {
-            label: "路由表达式",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "路由表达式",
+                description: "路由节点的判断脚本，根据返回值决定下一个流转节点。"
+            }),
             name: [
                 "RouterStrategy",
                 "script"

package/dist/components/design-editor/node-components/strategy/same-operator-audit.js

@@ -2,6 +2,7 @@ import { jsx } from "react/jsx-runtime";
 import "react";
 import { Form, Select } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
+import { FieldTip } from "../../../field-tip/index.js";
 const SameOperatorAuditStrategy = ()=>{
     const [form] = Form.useForm();
     return /*#__PURE__*/ jsx(Form, {
@@ -11,7 +12,20 @@ const SameOperatorAuditStrategy = ()=>{
         },
         layout: "vertical",
         children: /*#__PURE__*/ jsx(Form.Item, {
-            label: "相同人员提交配置",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "相同人员提交配置",
+                description: "当提交人与审批人为同一人时的处理方式。",
+                items: [
+                    {
+                        label: "自动通过",
+                        detail: "提交人与审批人为同一人时，自动通过该节点。"
+                    },
+                    {
+                        label: "手动审批",
+                        detail: "即使提交人与审批人相同，仍需手动审批。"
+                    }
+                ]
+            }),
             name: [
                 "SameOperatorAuditStrategy",
                 "type"

package/dist/components/design-editor/node-components/strategy/sub-process.js

@@ -6,6 +6,7 @@ import { GroovyScriptPreview } from "../../../../script-components/components/gr
 import { EditOutlined } from "@ant-design/icons";
 import { SubProcessConfigModal } from "../../../../script-components/modal/sub-process-config-modal.js";
 import { GroovyScriptLoader } from "../../../../script-components/components/groovy-script-loader.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const SubProcessScriptContent = (props)=>{
     const [visible, setVisible] = react.useState(false);
     const value = props.value || '';
@@ -51,7 +52,10 @@ const SubProcessStrategy = ()=>{
         layout: "vertical",
         children: [
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "子流程表达式",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "子流程表达式",
+                    description: "子流程触发的脚本，用于构造并在当前流程中发起一个子流程。"
+                }),
                 name: [
                     "SubProcessStrategy",
                     "script"
@@ -66,7 +70,10 @@ const SubProcessStrategy = ()=>{
                 })
             }),
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "创建后并提交",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "创建后并提交",
+                    description: "开启后，子流程创建完毕后自动提交；关闭则仅创建不提交。"
+                }),
                 name: [
                     "SubProcessStrategy",
                     "submit"

package/dist/components/design-editor/node-components/strategy/timeout.js

@@ -2,6 +2,7 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import "react";
 import { Form, Input, Select } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
+import { FieldTip } from "../../../field-tip/index.js";
 const TimeoutStrategy = ()=>{
     const [form] = Form.useForm();
     return /*#__PURE__*/ jsxs(Form, {
@@ -12,7 +13,24 @@ const TimeoutStrategy = ()=>{
         layout: "vertical",
         children: [
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "超时类型",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "超时类型",
+                    description: "节点超时后自动执行的动作。",
+                    items: [
+                        {
+                            label: "自动提醒",
+                            detail: "超时后发送提醒，不改变审批状态。"
+                        },
+                        {
+                            label: "自动同意",
+                            detail: "超时后自动通过该节点。"
+                        },
+                        {
+                            label: "自动拒绝",
+                            detail: "超时后自动拒绝该节点。"
+                        }
+                    ]
+                }),
                 name: [
                     "TimeoutStrategy",
                     "type"
@@ -42,7 +60,10 @@ const TimeoutStrategy = ()=>{
                 })
             }),
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "超时时间(分钟)",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "超时时间(分钟)",
+                    description: "触发超时动作的等待时长，单位为分钟。"
+                }),
                 name: [
                     "TimeoutStrategy",
                     "timeoutTime"

package/dist/components/design-editor/node-components/strategy/trigger.js

@@ -6,6 +6,7 @@ import { GroovyScriptPreview } from "../../../../script-components/components/gr
 import { EditOutlined } from "@ant-design/icons";
 import { TriggerConfigModal } from "../../../../script-components/modal/trigger-config-modal.js";
 import { GroovyScriptLoader } from "../../../../script-components/components/groovy-script-loader.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const TriggerConfigContent = (props)=>{
     const [visible, setVisible] = react.useState(false);
     const value = props.value || '';
@@ -51,7 +52,10 @@ const TriggerStrategy = ()=>{
         },
         layout: "vertical",
         children: /*#__PURE__*/ jsx(Form.Item, {
-            label: "触发表达式",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "触发表达式",
+                description: "节点触发时执行的脚本，可用于动态计算或副作用处理。"
+            }),
             name: [
                 "TriggerStrategy",
                 "script"

package/dist/components/design-editor/node-components/view/index.js

@@ -4,6 +4,7 @@ import { Button, Form, Input, Space } from "antd";
 import { Field } from "@flowgram.ai/fixed-layout-editor";
 import { BugOutlined } from "@ant-design/icons";
 import { ViewCodeDrawer } from "../../../../script-components/components/view-code-drawer.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const View = ()=>{
     const [form] = Form.useForm();
     const [visible, setVisible] = react.useState(false);
@@ -15,7 +16,10 @@ const View = ()=>{
         layout: "vertical",
         children: [
             /*#__PURE__*/ jsx(Form.Item, {
-                label: "视图名称",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "视图名称",
+                    description: "节点绑定的展示视图，用于自定义该节点的表单或界面展示。"
+                }),
                 name: [
                     "view"
                 ],

package/dist/components/design-panel/panels/workflow/interfere.js

@@ -2,6 +2,7 @@ import { jsx } from "react/jsx-runtime";
 import "react";
 import { Switch } from "antd";
 import { CardForm } from "@coding-flow/flow-pc-ui";
+import { FieldTip } from "../../../field-tip/index.js";
 const InterferePanel = (props)=>/*#__PURE__*/ jsx(CardForm, {
         form: props.form,
         title: "干预配置",
@@ -11,8 +12,10 @@ const InterferePanel = (props)=>/*#__PURE__*/ jsx(CardForm, {
                 "InterfereStrategy",
                 "enable"
             ],
-            label: "开启",
-            tooltip: "开启干预时可允许流程管理员协助用户操作流程。",
+            label: /*#__PURE__*/ jsx(FieldTip, {
+                label: "开启",
+                description: "开启后，允许流程管理员协助用户操作该流程。"
+            }),
             children: /*#__PURE__*/ jsx(Switch, {})
         })
     });

package/dist/components/design-panel/panels/workflow/urge.js

@@ -2,6 +2,7 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import "react";
 import { Input, Switch } from "antd";
 import { CardForm } from "@coding-flow/flow-pc-ui";
+import { FieldTip } from "../../../field-tip/index.js";
 const UrgePanel = (props)=>/*#__PURE__*/ jsxs(CardForm, {
         form: props.form,
         title: "催办策略",
@@ -12,8 +13,10 @@ const UrgePanel = (props)=>/*#__PURE__*/ jsxs(CardForm, {
                     "UrgeStrategy",
                     "enable"
                 ],
-                label: "开启",
-                tooltip: "开启催办允许用户点击催办当前审批人",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "开启",
+                    description: "开启后，允许用户对当前审批人发起催办。"
+                }),
                 children: /*#__PURE__*/ jsx(Switch, {})
             }),
             /*#__PURE__*/ jsx(CardForm.Item, {
@@ -22,8 +25,10 @@ const UrgePanel = (props)=>/*#__PURE__*/ jsxs(CardForm, {
                     "UrgeStrategy",
                     "interval"
                 ],
-                label: "催办间隔时间",
-                tooltip: "每次点击催办的间隔时间，该参数尽在启用时才生效",
+                label: /*#__PURE__*/ jsx(FieldTip, {
+                    label: "催办间隔时间",
+                    description: "两次催办之间的最小间隔，仅在启用催办时生效。"
+                }),
                 children: /*#__PURE__*/ jsx(Input, {
                     addonAfter: "单位:秒"
                 })

package/dist/components/design-panel/tabs/base/index.js

@@ -5,6 +5,7 @@ import { CardForm, Panel } from "@coding-flow/flow-pc-ui";
 import { useDesignContext } from "../../hooks/use-design-context.js";
 import { FlowCreateOperatorEditor } from "./operator.js";
 import { GroovyScriptLoader } from "../../../../script-components/components/groovy-script-loader.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const TabBase = ()=>{
     const [baseForm] = CardForm.useForm();
     const [operatorForm] = CardForm.useForm();
@@ -54,7 +55,10 @@ const TabBase = ()=>{
                 children: [
                     /*#__PURE__*/ jsx(CardForm.Item, {
                         name: "title",
-                        label: "流程标题",
+                        label: /*#__PURE__*/ jsx(FieldTip, {
+                            label: "流程标题",
+                            description: "流程的显示名称，便于识别与管理。"
+                        }),
                         rules: [
                             {
                                 required: true,
@@ -67,14 +71,20 @@ const TabBase = ()=>{
                     }),
                     /*#__PURE__*/ jsx(CardForm.Item, {
                         name: "description",
-                        label: "流程备注",
+                        label: /*#__PURE__*/ jsx(FieldTip, {
+                            label: "流程备注",
+                            description: "对流程用途、规则的补充说明，可选填。"
+                        }),
                         children: /*#__PURE__*/ jsx(Input.TextArea, {
                             placeholder: "请输入流程备注"
                         })
                     }),
                     /*#__PURE__*/ jsx(CardForm.Item, {
                         name: "code",
-                        label: "流程编码",
+                        label: /*#__PURE__*/ jsx(FieldTip, {
+                            label: "流程编码",
+                            description: "流程的唯一编码，用于系统识别与接口调用。"
+                        }),
                         rules: [
                             {
                                 required: true,
@@ -92,7 +102,10 @@ const TabBase = ()=>{
                 title: "发起配置",
                 children: /*#__PURE__*/ jsx(CardForm.Item, {
                     name: "operatorCreateScript",
-                    label: "发起人范围",
+                    label: /*#__PURE__*/ jsx(FieldTip, {
+                        label: "发起人范围",
+                        description: "通过脚本限定有权发起该流程的人员范围。"
+                    }),
                     rules: [
                         {
                             required: true,

package/dist/components/design-panel/tabs/form/attrubute.js

@@ -3,6 +3,7 @@ import { CloseCircleOutlined, PlusCircleOutlined } from "@ant-design/icons";
 import { Button, Col, Form, Input, Space } from "antd";
 import react from "react";
 import { IdUtils } from "../../../../utils/index.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const FieldAttributeItem = (props)=>{
     const attribute = props.value;
     const handleChangeLabel = (label)=>{
@@ -98,11 +99,11 @@ const FieldAttributeForm = ()=>{
     const actionRef = react.useRef();
     return /*#__PURE__*/ jsx(Form.Item, {
         name: "attributes",
-        help: "附加属性，主要用于一些复杂的表单控制界面",
         label: /*#__PURE__*/ jsxs(Space, {
             children: [
-                /*#__PURE__*/ jsx("span", {
-                    children: "附加属性"
+                /*#__PURE__*/ jsx(FieldTip, {
+                    label: "附加属性",
+                    description: "附加属性，主要用于一些复杂的表单控制界面。"
                 }),
                 /*#__PURE__*/ jsx(Button, {
                     type: "link",

package/dist/components/design-panel/tabs/form/form-type.js

@@ -2,6 +2,7 @@ import { jsx } from "react/jsx-runtime";
 import { Form, Select } from "antd";
 import react from "react";
 import { FormTypeContext } from "@coding-flow/flow-types";
+import { FieldTip } from "../../../field-tip/index.js";
 const FormTypeItem = (props)=>{
     const { form } = props;
     const options = react.useMemo(()=>FormTypeContext.getInstance().getOptions(), []);
@@ -16,7 +17,10 @@ const FormTypeItem = (props)=>{
     };
     return /*#__PURE__*/ jsx(Form.Item, {
         name: "type",
-        label: "字段类型",
+        label: /*#__PURE__*/ jsx(FieldTip, {
+            label: "字段类型",
+            description: "表单字段的数据类型与展示组件。"
+        }),
         labelCol: labelCol,
         rules: [
             {

package/dist/components/design-panel/tabs/form/index.js

@@ -7,6 +7,7 @@ import { IMPORT_FORM_VIEW_KEY } from "../../../../plugins/import-form-view-type.
 import { useDesignContext } from "../../hooks/use-design-context.js";
 import { FormTable } from "./table.js";
 import { ImportFormPluginView } from "./import-form-plugin-view.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const TabForm = ()=>{
     const { state, context } = useDesignContext();
     const presenter = context.getPresenter();
@@ -76,8 +77,10 @@ const TabForm = ()=>{
                             "form",
                             "name"
                         ],
-                        label: "表单名称",
-                        tooltip: "表单名称是主表的名称",
+                        label: /*#__PURE__*/ jsx(FieldTip, {
+                            label: "表单名称",
+                            description: "主表的显示名称。"
+                        }),
                         rules: [
                             {
                                 required: true,
@@ -93,8 +96,10 @@ const TabForm = ()=>{
                             "form",
                             "code"
                         ],
-                        label: "表单编码",
-                        tooltip: "表单编码是主表的编码",
+                        label: /*#__PURE__*/ jsx(FieldTip, {
+                            label: "表单编码",
+                            description: "主表的唯一编码，用于系统识别与数据存取。"
+                        }),
                         rules: [
                             {
                                 required: true,

package/dist/components/design-panel/tabs/form/model.js

@@ -3,11 +3,12 @@ import "react";
 import { Col, Form, Input, Modal, Row, Switch } from "antd";
 import { FieldAttributeForm } from "./attrubute.js";
 import { FormTypeItem } from "./form-type.js";
+import { FieldTip } from "../../../field-tip/index.js";
 const FormFieldModal = (props)=>{
     const form = props.form;
     const labelCol = {
         style: {
-            width: 100
+            width: 110
         }
     };
     return /*#__PURE__*/ jsx(Modal, {
@@ -48,7 +49,10 @@ const FormFieldModal = (props)=>{
                             span: 12,
                             children: /*#__PURE__*/ jsx(Form.Item, {
                                 name: "name",
-                                label: "字段名称",
+                                label: /*#__PURE__*/ jsx(FieldTip, {
+                                    label: "字段名称",
+                                    description: "表单字段的显示名称。"
+                                }),
                                 labelCol: labelCol,
                                 rules: [
                                     {
@@ -65,7 +69,10 @@ const FormFieldModal = (props)=>{
                             span: 12,
                             children: /*#__PURE__*/ jsx(Form.Item, {
                                 name: "code",
-                                label: "字段编码",
+                                label: /*#__PURE__*/ jsx(FieldTip, {
+                                    label: "字段编码",
+                                    description: "表单字段的唯一编码，用于数据存取，建议使用英文。"
+                                }),
                                 labelCol: labelCol,
                                 rules: [
                                     {
@@ -88,7 +95,10 @@ const FormFieldModal = (props)=>{
                             span: 6,
                             children: /*#__PURE__*/ jsx(Form.Item, {
                                 name: "required",
-                                label: "是否必填",
+                                label: /*#__PURE__*/ jsx(FieldTip, {
+                                    label: "是否必填",
+                                    description: "开启后，该字段为必填项。"
+                                }),
                                 labelCol: labelCol,
                                 children: /*#__PURE__*/ jsx(Switch, {})
                             })
@@ -97,7 +107,10 @@ const FormFieldModal = (props)=>{
                             span: 6,
                             children: /*#__PURE__*/ jsx(Form.Item, {
                                 name: "hidden",
-                                label: "是否隐藏",
+                                label: /*#__PURE__*/ jsx(FieldTip, {
+                                    label: "是否隐藏",
+                                    description: "开启后，该字段在表单中不展示（仍可参与逻辑）。"
+                                }),
                                 labelCol: labelCol,
                                 children: /*#__PURE__*/ jsx(Switch, {})
                             })
@@ -106,7 +119,10 @@ const FormFieldModal = (props)=>{
                             span: 12,
                             children: /*#__PURE__*/ jsx(Form.Item, {
                                 name: "placeholder",
-                                label: "输入提示信息",
+                                label: /*#__PURE__*/ jsx(FieldTip, {
+                                    label: "输入提示信息",
+                                    description: "字段输入框内的占位提示文字。"
+                                }),
                                 labelCol: labelCol,
                                 children: /*#__PURE__*/ jsx(Input, {
                                     placeholder: "请输入输入提示信息"
@@ -117,7 +133,10 @@ const FormFieldModal = (props)=>{
                             span: 12,
                             children: /*#__PURE__*/ jsx(Form.Item, {
                                 name: "defaultValue",
-                                label: "默认值",
+                                label: /*#__PURE__*/ jsx(FieldTip, {
+                                    label: "默认值",
+                                    description: "字段新增时的初始默认值。"
+                                }),
                                 labelCol: labelCol,
                                 children: /*#__PURE__*/ jsx(Input, {
                                     placeholder: "请输入默认值"
@@ -128,7 +147,10 @@ const FormFieldModal = (props)=>{
                             span: 12,
                             children: /*#__PURE__*/ jsx(Form.Item, {
                                 name: "tooltip",
-                                label: "提示信息",
+                                label: /*#__PURE__*/ jsx(FieldTip, {
+                                    label: "提示信息",
+                                    description: "字段标签旁的提示说明，hover 时显示。"
+                                }),
                                 labelCol: labelCol,
                                 children: /*#__PURE__*/ jsx(Input, {
                                     placeholder: "请输入提示信息"
@@ -139,7 +161,10 @@ const FormFieldModal = (props)=>{
                             span: 12,
                             children: /*#__PURE__*/ jsx(Form.Item, {
                                 name: "help",
-                                label: "帮助提示",
+                                label: /*#__PURE__*/ jsx(FieldTip, {
+                                    label: "帮助提示",
+                                    description: "字段下方的帮助说明文字。"
+                                }),
                                 labelCol: labelCol,
                                 children: /*#__PURE__*/ jsx(Input, {
                                     placeholder: "请输入帮助提示"

package/dist/components/design-panel/tabs/form/sub-form.js

@@ -1,6 +1,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import "react";
 import { Form, Input, Modal } from "antd";
+import { FieldTip } from "../../../field-tip/index.js";
 const SubFormModal = (props)=>{
     const form = props.form;
     return /*#__PURE__*/ jsx(Modal, {
@@ -21,7 +22,10 @@ const SubFormModal = (props)=>{
             children: [
                 /*#__PURE__*/ jsx(Form.Item, {
                     name: "name",
-                    label: "子表名称",
+                    label: /*#__PURE__*/ jsx(FieldTip, {
+                        label: "子表名称",
+                        description: "子表的显示名称。"
+                    }),
                     rules: [
                         {
                             required: true,
@@ -34,7 +38,10 @@ const SubFormModal = (props)=>{
                 }),
                 /*#__PURE__*/ jsx(Form.Item, {
                     name: "code",
-                    label: "子表编码",
+                    label: /*#__PURE__*/ jsx(FieldTip, {
+                        label: "子表编码",
+                        description: "子表的唯一编码，用于系统识别与数据存取。"
+                    }),
                     rules: [
                         {
                             required: true,

package/dist/components/field-tip/field-tip.module.js

@@ -0,0 +1,13 @@
+import "./field-tip_module.css";
+const field_tip_module = {
+    wrapper: "wrapper-C3BLIZ",
+    label: "label-saB3hr",
+    icon: "icon-YplXSW",
+    content: "content-YOY3Xd",
+    description: "description-DPZ36p",
+    items: "items-MbTsm4",
+    item: "item-cWrXIT",
+    itemLabel: "itemLabel-zzT07g",
+    itemDetail: "itemDetail-_c712s"
+};
+export { field_tip_module as default };

package/dist/components/field-tip/field-tip_module.css

@@ -0,0 +1,58 @@
+.wrapper-C3BLIZ {
+  white-space: nowrap;
+  align-items: center;
+  gap: 2px;
+  display: inline-flex;
+}
+
+.label-saB3hr {
+  white-space: nowrap;
+}
+
+.icon-YplXSW {
+  color: #00000073;
+  cursor: help;
+  flex-shrink: 0;
+  font-size: 12px;
+}
+
+.content-YOY3Xd {
+  max-width: 320px;
+  font-size: 13px;
+  line-height: 1.6;
+}
+
+.description-DPZ36p {
+  color: #000000a6;
+  margin: 0 0 8px;
+}
+
+.description-DPZ36p:last-child {
+  margin-bottom: 0;
+}
+
+.items-MbTsm4 {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+
+.item-cWrXIT {
+  margin-bottom: 6px;
+}
+
+.item-cWrXIT:last-child {
+  margin-bottom: 0;
+}
+
+.itemLabel-zzT07g {
+  color: #000000d9;
+  font-weight: 500;
+  display: block;
+}
+
+.itemDetail-_c712s {
+  color: #0000008c;
+  display: block;
+}
+

package/dist/components/field-tip/index.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+/**
+ * 要点项
+ */
+export interface FieldTipItem {
+    /** 要点标题 */
+    label: string;
+    /** 要点说明 */
+    detail: string;
+}
+export interface FieldTipProps {
+    /** 字段名称（显示为 label 文本，同时作为弹层标题） */
+    label: string;
+    /** 说明正文 */
+    description?: string;
+    /** 要点列表（用于枚举型字段的各选项说明） */
+    items?: FieldTipItem[];
+}
+/**
+ * 字段说明组件
+ * 在字段 label 右侧显示问号图标，hover 时弹出结构化说明（正文 + 要点列表）。
+ * 作为 Form.Item 的 label 使用，简单字段只传 description，复杂字段再传 items。
+ */
+export declare const FieldTip: React.FC<FieldTipProps>;

package/dist/components/field-tip/index.js

@@ -0,0 +1,53 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import "react";
+import { Popover } from "antd";
+import { QuestionCircleOutlined } from "@ant-design/icons";
+import field_tip_module from "./field-tip.module.js";
+const FieldTip = ({ label, description, items })=>{
+    const hasContent = Boolean(description) || items && items.length > 0;
+    const content = /*#__PURE__*/ jsxs("div", {
+        className: field_tip_module.content,
+        children: [
+            description && /*#__PURE__*/ jsx("p", {
+                className: field_tip_module.description,
+                children: description
+            }),
+            items && items.length > 0 && /*#__PURE__*/ jsx("ul", {
+                className: field_tip_module.items,
+                children: items.map((item)=>/*#__PURE__*/ jsxs("li", {
+                        className: field_tip_module.item,
+                        children: [
+                            /*#__PURE__*/ jsx("span", {
+                                className: field_tip_module.itemLabel,
+                                children: item.label
+                            }),
+                            /*#__PURE__*/ jsx("span", {
+                                className: field_tip_module.itemDetail,
+                                children: item.detail
+                            })
+                        ]
+                    }, item.label))
+            })
+        ]
+    });
+    return /*#__PURE__*/ jsxs("span", {
+        className: field_tip_module.wrapper,
+        children: [
+            /*#__PURE__*/ jsx("span", {
+                className: field_tip_module.label,
+                children: label
+            }),
+            hasContent && /*#__PURE__*/ jsx(Popover, {
+                content: content,
+                title: label,
+                trigger: "hover",
+                placement: "topLeft",
+                overlayClassName: field_tip_module.popover,
+                children: /*#__PURE__*/ jsx(QuestionCircleOutlined, {
+                    className: field_tip_module.icon
+                })
+            })
+        ]
+    });
+};
+export { FieldTip };

package/dist/script-components/components/groovy-script-loader.js

@@ -1,6 +1,8 @@
 import { jsx } from "react/jsx-runtime";
 import { getScript, save } from "../../api/script.js";
 import react from "react";
+import { EventBus } from "@coding-flow/flow-core";
+const SCRIPT_UPDATED_EVENT = "groovy-script-updated";
 const GroovyScriptLoader = (props)=>{
     const scriptKey = props.value || '';
     const [script, setScript] = react.useState('');
@@ -15,6 +17,8 @@ const GroovyScriptLoader = (props)=>{
         if (script === currentScript) return;
         console.log("script changed", currentScript);
         handlerSaveScript(currentScript);
+        EventBus.getInstance().emit(SCRIPT_UPDATED_EVENT, scriptKey, currentScript);
+        setScript(currentScript);
         props.onChange?.(scriptKey);
     };
     react.useEffect(()=>{
@@ -24,6 +28,18 @@ const GroovyScriptLoader = (props)=>{
     }, [
         scriptKey
     ]);
+    react.useEffect(()=>{
+        if (!scriptKey) return;
+        const handler = (key, content)=>{
+            if (key === scriptKey) setScript(content);
+        };
+        EventBus.getInstance().on(SCRIPT_UPDATED_EVENT, handler);
+        return ()=>{
+            EventBus.getInstance().off(SCRIPT_UPDATED_EVENT, handler);
+        };
+    }, [
+        scriptKey
+    ]);
     react.useEffect(()=>()=>{
             setScript('');
         }, []);

package/dist/script-components/components/sub-process/index.js

@@ -45,7 +45,7 @@ const SubProcessView = (props)=>{
                     label: "触发动作",
                     children: /*#__PURE__*/ jsx(Select, {
                         placeholder: "请选择触发动作",
-                        options: state.actions.map((item)=>({
+                        options: (state.actions ?? []).map((item)=>({
                                 key: item.actionId,
                                 value: item.actionId,
                                 label: item.title

package/dist/script-components/components/sub-process/models/index.d.ts

@@ -1,5 +1,9 @@
 import { SubProcessViewApi } from "../typings";
 export declare class SubProcessViewApiImpl implements SubProcessViewApi {
     options: () => Promise<any>;
-    meta: (workId: string) => Promise<any>;
+    meta: (workId: string) => Promise<{
+        workId: string;
+        actions: any;
+        form: any;
+    }>;
 }

package/dist/script-components/components/sub-process/models/index.js

@@ -7,8 +7,16 @@ class SubProcessViewApiImpl {
     };
     meta = async (workId)=>{
         const res = await meta(workId);
-        if (res.success) return res.data;
-        return null;
+        if (res.success && res.data) return {
+            workId,
+            actions: res.data.actions ?? [],
+            form: res.data.form
+        };
+        return {
+            workId,
+            actions: [],
+            form: void 0
+        };
     };
 }
 export { SubProcessViewApiImpl };

package/dist/script-components/components/sub-process/presenters/target-workflow-presenter.js

@@ -23,8 +23,8 @@ class TargetWorkflowPresenter {
             this.dispatch((prevState)=>({
                     ...prevState,
                     currentWorkId: workId,
-                    actions: meta.actions,
-                    form: meta.form
+                    actions: meta?.actions ?? [],
+                    form: meta?.form
                 }));
         });
     }

package/dist/script-components/modal/sub-process-config-modal.js

@@ -30,6 +30,6 @@ const SubProcessConfigModal = (props)=>/*#__PURE__*/ jsx(GroovyScriptModal, {
         onCancel: props.onCancel,
         title: "子流程配置",
         content: SubProcessConfigContent,
-        scriptKey: props.script
+        scriptKey: props.scriptKey
     });
 export { SubProcessConfigModal };

package/dist/script-components/modal/trigger-config-modal.js

@@ -30,6 +30,6 @@ const TriggerConfigModal = (props)=>/*#__PURE__*/ jsx(GroovyScriptModal, {
         onCancel: props.onCancel,
         title: "触发配置",
         content: TriggerConfigContent,
-        scriptKey: props.script
+        scriptKey: props.scriptKey
     });
 export { TriggerConfigModal };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coding-flow/flow-design",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "description": "flow-engine design components ",
   "type": "module",
   "keywords": [
@@ -49,16 +49,16 @@
     "nanoid": "^5.1.6",
     "react-redux": "^9.2.0",
     "styled-components": "^5.3.11",
-    "@coding-flow/flow-core": "0.0.51",
-    "@coding-flow/flow-icons": "0.0.51",
-    "@coding-flow/flow-types": "0.0.51",
-    "@coding-flow/flow-pc-ui": "0.0.51"
+    "@coding-flow/flow-icons": "0.0.53",
+    "@coding-flow/flow-core": "0.0.53",
+    "@coding-flow/flow-types": "0.0.53",
+    "@coding-flow/flow-pc-ui": "0.0.53"
   },
   "devDependencies": {
     "@types/lodash-es": "^4.17.12",
     "@types/styled-components": "^5.1.36",
-    "@coding-flow/flow-core": "0.0.51",
-    "@coding-flow/flow-types": "0.0.51"
+    "@coding-flow/flow-core": "0.0.53",
+    "@coding-flow/flow-types": "0.0.53"
   },
   "scripts": {
     "build": "rslib build",