@gadmin2n/schematics 0.0.143 → 0.0.145

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/routes/workflow/hooks/useWorkflowAgent.ts

@@ -1,10 +1,17 @@
 import { useState, useCallback, useRef } from 'react';
 import type {
+  CallableWorkflowOption,
   WorkflowDSL,
   AgentOutput,
   WorkflowNodeType,
   NodeInstanceAgentOutput,
 } from '../types';
+import {
+  buildWorkflowHandlePrompt,
+  buildWorkflowSkillPrompt,
+  selectWorkflowPromptNodeTypes,
+} from '../utils/workflowSkillPrompt';
+import { validateWorkflowDsl } from '../utils/validateWorkflowDsl';
 
 function extractJson(text: string): string | null {
   const match = text.match(/```json\s*([\s\S]*?)```/);
@@ -103,73 +110,77 @@ function sendPromptAndWait<T>(
 
 interface UseWorkflowAgentOptions {
   nodeTypes: WorkflowNodeType[];
+  referencedConfigs?: Record<string, Record<string, any>>;
+  callableWorkflows?: CallableWorkflowOption[];
 }
 
-export function useWorkflowAgent({ nodeTypes }: UseWorkflowAgentOptions) {
+export function useWorkflowAgent({
+  nodeTypes,
+  referencedConfigs = {},
+  callableWorkflows,
+}: UseWorkflowAgentOptions) {
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState<string | null>(null);
   const abortControllerRef = useRef<AbortController | null>(null);
 
-  const buildSystemContext = useCallback(() => {
-    const nodeTypeSummary = nodeTypes
-      .map(
-        (nt) =>
-          `- ${nt.type} (${nt.category}): ${nt.description}. Config: ${JSON.stringify(nt.configSchema)}`,
+  const buildSystemContext = useCallback(
+    (contextNodeTypes: WorkflowNodeType[] = nodeTypes) => {
+      const nodeTypeSummary = contextNodeTypes
+        .map(
+          (nt) =>
+            `- ${nt.type}（${nt.category}）：${nt.description}。配置 Schema：${JSON.stringify(nt.configSchema)}。输入 Schema：${JSON.stringify(nt.inputSchema)}。输出 Schema：${JSON.stringify(nt.outputSchema)}`,
+        )
+        .join('\n');
+
+      const handleSection = buildWorkflowHandlePrompt(contextNodeTypes);
+      const callableSection = contextNodeTypes.some(
+        (nodeType) => nodeType.type === 'sub_workflow',
       )
-      .join('\n');
-
-    const enumeratedHandleRules = nodeTypes
-      .filter((nt) => Array.isArray(nt.outputs) && nt.outputs.length > 0)
-      .map(
-        (nt) =>
-          `  - ${nt.type}: sourceHandle MUST be one of [${nt
-            .outputs!.map((o) => `'${o}'`)
-            .join(', ')}]`,
-      )
-      .join('\n');
-
-    const dynamicHandleRules = nodeTypes
-      .filter((nt) => nt.outputs === null)
-      .map(
-        (nt) =>
-          `  - ${nt.type}: sourceHandle MUST match a value listed in this node's config.cases[].value`,
-      )
-      .join('\n');
-
-    const noHandleTypes = nodeTypes
-      .filter((nt) => Array.isArray(nt.outputs) && nt.outputs.length === 0)
-      .map((nt) => nt.type)
-      .join(', ');
+        ? `\n\n可调用 Workflow 目录（调用节点只能使用这里列出的 workflowId 和对应 workflowVersionId，不得编造 ID）：\n${
+            callableWorkflows && callableWorkflows.length > 0
+              ? JSON.stringify(callableWorkflows, null, 2)
+              : '当前没有可调用 Workflow；不要生成 sub_workflow 节点。'
+          }`
+        : '';
 
-    const handleSection = `
-Source handle rules (each edge's sourceHandle MUST match the source node's outputs):
-${enumeratedHandleRules}
-${dynamicHandleRules}
-For ALL OTHER node types (${noHandleTypes}), edges MUST NOT include the sourceHandle field — omit it entirely.`;
+      return `你是 Workflow DSL 生成助手。最终结果只能返回一个由 \`\`\`json 代码块包裹的 JSON 对象。
 
-    return `You are a workflow DSL generator. Output ONLY a JSON object wrapped in \`\`\`json code block.
-
-Available node types:
+本次相关节点类型：
 ${nodeTypeSummary}
+${callableSection}
 
-DSL format:
+返回格式：
 {
   "dsl": { "nodes": [...], "edges": [...] },
-  "changeSummary": "brief description of changes"
+  "changeSummary": "简要说明本次修改"
 }
 
-Each node: { "id": "uuid", "type": "node_type", "label": "Display Name", "position": {"x": number, "y": number}, "config": {...} }
-Each edge: { "id": "uuid", "source": "nodeId", "target": "nodeId", "sourceHandle?": "string", "label?": "string" }
+节点结构：{ "id": "uuid", "type": "node_type", "label": "显示名称", "position": {"x": number, "y": number}, "config": {...} }
+边结构：{ "id": "uuid", "source": "nodeId", "target": "nodeId", "sourceHandle?": "string", "targetHandle?": "string", "kind?": "FLOW" | "CALL" | "RETURN", "pairId?": "string", "valueType?": "JSON" | "USER_IDS" | "USER_GROUP_IDS", "label?": "string" }
 ${handleSection}
 
-Data rules:
-- "input" always means the value returned by the immediately previous FLOW node.
-- "workflow" always means the original data received when the Workflow started.
-- A callable parameter binding must be structured as {"source":"INPUT"|"WORKFLOW","path":"relative.path"} or {"source":"FIXED","valueType":"STRING"|"NUMBER"|"BOOLEAN"|"JSON","value":"..."}.
-- Never generate context, inputMapping, node UUID paths, nodes.xxx, PREVIOUS, or CONTEXT_PATH as data references.
-
-Position nodes using: x = vertical order (increment by 250 for each sequential step), y = horizontal lane (0 for single-path flows; use different y values spaced by 200 only for parallel branches).`;
-  }, [nodeTypes]);
+数据规则：
+- "input" 表示紧邻的上一个 FLOW 节点返回的值。
+- "workflow" 表示 Workflow 启动时收到的原始数据。
+- 普通参数绑定使用 {"source":"INPUT"|"WORKFLOW","path":"relative.path"} 或 {"source":"FIXED","valueType":"STRING"|"NUMBER"|"BOOLEAN"|"JSON","value":"..."}。
+- 复合节点内部产生的数据使用节点专属域，不能改变 input 的含义。人工审批外部派单使用 "approval"；内嵌 Code 的 HTTP 响应使用 "response"，外部回调使用 "callback"。
+- 只有人工审批的 external.request 允许 {"source":"APPROVAL","path":"relative.path"} 或 {{approval.relative.path}}；其他节点不得使用 APPROVAL。
+- 禁止使用 context、inputMapping、节点 UUID 路径、nodes.xxx、PREVIOUS 或 CONTEXT_PATH 引用数据。
+
+画布规则：
+- 每个节点和每条边都必须有唯一、非空的 id。
+- 恰好包含一个 *_trigger 节点，所有节点都必须连接到该入口图。
+- FLOW 边必须构成 DAG，不能把后续节点连回前序节点。
+- pairId 只用于 for_each 或 parallel 的完整 START → CALL → FLOW → RETURN → END 私有处理链，普通 FLOW 不得携带 pairId。
+- 每个非触发节点最多一条主流程入边，分支不能合流到同一节点。
+- 普通节点最多一条主流程出边，每个命名分支出口最多连接一次。
+- for_each 必须从 START 连接处理链并返回 END；parallel 配置的每个分支也必须各自形成完整 START / END 处理链。两种节点都只从唯一主流程 OUT 继续。
+- Workflow 自然结束时，终点节点产生的结果就是整个 Workflow 的 output。
+
+节点位置：按执行顺序横向排列，x 每步增加约 250；单路径 y 为 0，只有真实分支才使用间隔约 200 的不同纵向泳道。`;
+    },
+    [callableWorkflows, nodeTypes],
+  );
 
   const abort = useCallback(() => {
     abortControllerRef.current?.abort();
@@ -197,32 +208,55 @@ Position nodes using: x = vertical order (increment by 250 for each sequential s
 
       try {
         let userPrompt = '';
-        const systemContext = buildSystemContext();
+        const callableCatalogReady = callableWorkflows !== undefined;
+        const targetNodeType =
+          params.action === 'edit_node'
+            ? params.currentDsl?.nodes.find(
+                (node) => node.id === params.targetNodeId,
+              )?.type
+            : params.action === 'create_node_instance'
+              ? params.nodeType?.type
+              : undefined;
+        if (targetNodeType === 'sub_workflow' && !callableCatalogReady) {
+          throw new Error(
+            '可调用 Workflow 目录不可用，暂时不能生成或修改调用 Workflow 节点。',
+          );
+        }
+        const promptNodeTypes = callableCatalogReady
+          ? nodeTypes
+          : nodeTypes.filter((nodeType) => nodeType.type !== 'sub_workflow');
+        const skillNodeTypes = targetNodeType
+          ? [targetNodeType]
+          : promptNodeTypes.map((nodeType) => nodeType.type);
+        const skillContext = buildWorkflowSkillPrompt(skillNodeTypes);
+        const systemContext = `${skillContext}\n\n${buildSystemContext([
+          ...selectWorkflowPromptNodeTypes(promptNodeTypes, targetNodeType),
+        ])}`;
 
         if (params.action === 'create') {
-          userPrompt = `${systemContext}\n\nCreate a workflow: ${params.prompt}`;
+          userPrompt = `${systemContext}\n\n请创建一个 Workflow：${params.prompt}`;
         } else if (params.action === 'edit_workflow') {
-          userPrompt = `${systemContext}\n\nCurrent DSL:\n\`\`\`json\n${JSON.stringify(params.currentDsl, null, 2)}\n\`\`\`\n\nModify the workflow: ${params.prompt}\n\nReturn the COMPLETE updated DSL.`;
+          userPrompt = `${systemContext}\n\n当前 DSL：\n\`\`\`json\n${JSON.stringify(params.currentDsl, null, 2)}\n\`\`\`\n\n请修改这个 Workflow：${params.prompt}\n\n返回修改后的完整 DSL。`;
         } else if (params.action === 'edit_node') {
-          userPrompt = `${systemContext}\n\nCurrent DSL:\n\`\`\`json\n${JSON.stringify(params.currentDsl, null, 2)}\n\`\`\`\n\nModify ONLY the node with id "${params.targetNodeId}": ${params.prompt}\n\nReturn the COMPLETE updated DSL with only that node changed.`;
+          userPrompt = `${systemContext}\n\n当前 DSL：\n\`\`\`json\n${JSON.stringify(params.currentDsl, null, 2)}\n\`\`\`\n\n只修改 ID 为 "${params.targetNodeId}" 的节点：${params.prompt}\n\n返回修改后的完整 DSL，并确保只有这个节点发生变化。`;
         } else if (params.action === 'create_node_instance') {
           const nt = params.nodeType!;
-          const nodeInstanceContext = `You are a node instance config generator. Output ONLY a JSON object wrapped in \`\`\`json code block.
+          const nodeInstanceContext = `你是 Workflow 节点模板配置助手。最终结果只能返回一个由 \`\`\`json 代码块包裹的 JSON 对象。
 
-Node type: ${nt.type} (${nt.category}) - ${nt.description}
+节点类型：${nt.type}（${nt.category}）— ${nt.description}
 
-configSchema (your output "config" must conform to this):
+配置 Schema（输出的 "config" 必须符合该 Schema）：
 ${JSON.stringify(nt.configSchema, null, 2)}
 
-Business scenario: ${params.scenarioHint || 'Generate appropriate configuration for this node type.'}
+业务场景：${params.scenarioHint || '为该节点类型生成合适的配置。'}
 
-Output format (strict):
+严格输出以下格式：
 {
-  "name": "A descriptive instance name",
-  "description": "What this instance does",
-  "config": { ... fields matching configSchema ... }
+  "name": "有业务含义的模板名称",
+  "description": "这个模板的用途",
+  "config": { ...符合配置 Schema 的字段... }
 }`;
-          userPrompt = `${nodeInstanceContext}\n\nUser request: ${params.prompt}`;
+          userPrompt = `${skillContext}\n\n${nodeInstanceContext}\n\n用户需求：${params.prompt}`;
         }
 
         if (params.action === 'create_node_instance') {
@@ -234,12 +268,26 @@ Output format (strict):
           );
           return result as any;
         } else {
-          userPrompt = `${userPrompt} \n\n你先理解下这个需求，然后找我澄清需求（非技术方案），每个node的参数可以不用在这个阶段来确认，每次问我一个问题（如果有多个问题请分多次询问），我全部确认后再行动。切记：仅最终结果以json形式返回，其他非结果数据不以json形式返回。`;
+          userPrompt = `${userPrompt} \n\n你先理解这个需求，然后找我澄清业务需求（非技术方案）。节点参数可以不在这个阶段确认。每次只问一个问题；如果有多个问题，请分多次询问。我全部确认后再行动。切记：仅最终结果以 JSON 形式返回，其他内容不要使用 JSON。`;
           const result = await sendPromptAndWait<AgentOutput>(
             userPrompt,
             validateAgentOutput,
             controller.signal,
           );
+          const validation = validateWorkflowDsl(result.dsl, {
+            nodeTypes,
+            referencedConfigs,
+            callableWorkflows,
+          });
+          if (!validation.ok)
+            throw new Error(`AI 返回的 Workflow 无效：${validation.error}`);
+          if (
+            !callableCatalogReady &&
+            subWorkflowNodesChanged(params.currentDsl, result.dsl)
+          )
+            throw new Error(
+              '可调用 Workflow 目录不可用，AI 不能新增或修改调用 Workflow 节点。',
+            );
           return result;
         }
       } catch (e: any) {
@@ -253,8 +301,30 @@ Output format (strict):
         setLoading(false);
       }
     },
-    [buildSystemContext],
+    [buildSystemContext, callableWorkflows, nodeTypes, referencedConfigs],
   );
 
   return { generate, abort, loading, error };
 }
+
+function subWorkflowNodesChanged(
+  currentDsl: WorkflowDSL | undefined,
+  nextDsl: WorkflowDSL,
+): boolean {
+  return (
+    JSON.stringify(subWorkflowNodes(currentDsl)) !==
+    JSON.stringify(subWorkflowNodes(nextDsl))
+  );
+}
+
+function subWorkflowNodes(dsl: WorkflowDSL | undefined) {
+  return (dsl?.nodes ?? [])
+    .filter((node) => node.type === 'sub_workflow')
+    .map((node) => ({
+      id: node.id,
+      config: node.config,
+      configOverride: node.configOverride,
+      instanceRef: node.instanceRef,
+    }))
+    .sort((left, right) => left.id.localeCompare(right.id));
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/web/src/routes/workflow/index.tsx

@@ -14,7 +14,6 @@ import {
   message,
 } from 'antd';
 import {
-  DatabaseOutlined,
   DeleteOutlined,
   EditOutlined,
   ExportOutlined,
@@ -31,9 +30,15 @@ import { StatusCards } from './components/StatusCards';
 import { ExportModal } from './components/ExportModal';
 import { ImportModal } from './components/ImportModal';
 import type { Workflow, WorkflowOverview } from './types';
+import { workflowPublishErrorMessage } from './utils/workflowPublishError';
 import { useTranslation } from 'react-i18next';
 import { PageHeader } from 'components';
 import { PAGE_WRAPPER_STYLE, SEARCH_CARD_PROPS } from 'constants/layout';
+import {
+  formatWorkflowUtcDate,
+  formatWorkflowUtcDateTime,
+} from './utils/workflowDateTime';
+import './workflow-ui.css';
 
 const PAGE_SIZE = 20;
 
@@ -78,11 +83,11 @@ function RunDot({
 const STATUS_COLOR: Record<string, string> = {
   DRAFT: 'default',
   PUBLISHED: 'success',
+  DELETING: 'warning',
 };
 
 export default function WorkflowListPage() {
   const { t } = useTranslation('workflow');
-  console.log('[WorkflowList] MOUNTED, pathname:', window.location.pathname);
   const navigate = useNavigate();
   const [workflows, setWorkflows] = useState<Workflow[]>([]);
   const [overview, setOverview] = useState<WorkflowOverview | null>(null);
@@ -168,7 +173,7 @@ export default function WorkflowListPage() {
     } finally {
       setLoading(false);
     }
-  }, [page, filterStatus, filterInstanceStatus, filterName]);
+  }, [page, filterStatus, filterInstanceStatus, filterName, t]);
 
   useEffect(() => {
     fetchData();
@@ -197,7 +202,10 @@ export default function WorkflowListPage() {
       setPublishSummary('');
       fetchData();
     } catch (e: any) {
-      message.error(e?.message ?? t('list.publishFailed'));
+      message.error(
+        workflowPublishErrorMessage(e, t('list.publishFailedHint')),
+        8,
+      );
     } finally {
       setPublishLoading(false);
     }
@@ -208,7 +216,9 @@ export default function WorkflowListPage() {
       await customRequest(`workflow/${id}/toggle`, 'PATCH', {
         enabled: !currentValue,
       });
-      message.success(`Workflow ${currentValue ? '禁用' : '启用'}成功`);
+      message.success(
+        currentValue ? t('list.disabledSuccess') : t('list.enabledSuccess'),
+      );
       fetchData();
     } catch (e: any) {
       message.error(e?.message ?? 'Toggle failed');
@@ -228,12 +238,16 @@ export default function WorkflowListPage() {
           cancelText="取消"
           onConfirm={() => handleToggleEnabled(record.id, isEnabled)}
         >
-          <Switch checked={isEnabled} size="small" />
+          <Switch
+            checked={isEnabled}
+            size="small"
+            disabled={record.status === 'DELETING'}
+          />
         </Popconfirm>
       ),
     },
     {
-      title: 'Name',
+      title: t('common.name'),
       dataIndex: 'name',
       key: 'name',
       render: (name: string, record: Workflow) => (
@@ -243,16 +257,20 @@ export default function WorkflowListPage() {
       ),
     },
     {
-      title: 'Status',
+      title: t('list.status'),
       dataIndex: 'status',
       key: 'status',
       width: 100,
       render: (status: string) => (
-        <Tag color={STATUS_COLOR[status]}>{status}</Tag>
+        <Tag color={STATUS_COLOR[status]}>
+          {t(`workflowStatus.${status.toLowerCase()}`, {
+            defaultValue: status,
+          })}
+        </Tag>
       ),
     },
     {
-      title: 'Version',
+      title: t('list.version'),
       key: 'version',
       width: 200,
       render: (_: any, record: Workflow) => {
@@ -263,7 +281,7 @@ export default function WorkflowListPage() {
       },
     },
     {
-      title: 'Runs',
+      title: t('list.runs'),
       key: 'runs',
       width: 160,
       render: (_: any, record: Workflow) => {
@@ -308,31 +326,31 @@ export default function WorkflowListPage() {
       },
     },
     {
-      title: 'Last Run',
+      title: t('list.lastRun'),
       key: 'lastRun',
       width: 150,
       render: (_: any, record: Workflow) => {
         if (!record.lastRun) return <span style={{ color: '#d9d9d9' }}>—</span>;
         return (
-          <Tooltip title={new Date(record.lastRun).toLocaleString()}>
-            <span>{new Date(record.lastRun).toLocaleDateString()}</span>
+          <Tooltip title={formatWorkflowUtcDateTime(record.lastRun)}>
+            <span>{formatWorkflowUtcDate(record.lastRun)}</span>
           </Tooltip>
         );
       },
     },
     {
-      title: 'Updated',
+      title: t('list.updatedAt'),
       dataIndex: 'updatedAt',
       key: 'updatedAt',
       width: 150,
       render: (v: string) => (
-        <Tooltip title={new Date(v).toLocaleString()}>
-          <span>{new Date(v).toLocaleDateString()}</span>
+        <Tooltip title={formatWorkflowUtcDateTime(v)}>
+          <span>{formatWorkflowUtcDate(v)}</span>
         </Tooltip>
       ),
     },
     {
-      title: 'Actions',
+      title: t('list.actions'),
       key: 'actions',
       width: 180,
       render: (_: any, record: Workflow) => (
@@ -348,6 +366,7 @@ export default function WorkflowListPage() {
             <Button
               size="small"
               icon={<EditOutlined />}
+              disabled={record.status === 'DELETING'}
               onClick={() => navigate(`/admin/workflow/edit/${record.id}`)}
             />
           </Tooltip>
@@ -370,7 +389,7 @@ export default function WorkflowListPage() {
               }}
             />
           </Tooltip>
-          {record.status === 'DRAFT' && (
+          {record.hasUnpublishedChanges && record.status !== 'DELETING' && (
             <Tooltip title={t('list.publish')}>
               <Button
                 size="small"
@@ -386,13 +405,13 @@ export default function WorkflowListPage() {
           )}
           <Popconfirm
             title={t('list.deleteConfirm')}
-            description="All versions and instances will be deleted."
-            okText="Delete"
-            cancelText="Cancel"
+            description={t('list.deleteDescription')}
+            okText={t('common.delete')}
+            cancelText={t('common.cancel')}
             okButtonProps={{ danger: true }}
             onConfirm={() => handleDelete(record.id)}
           >
-            <Tooltip title="Delete">
+            <Tooltip title={t('common.delete')}>
               <Button size="small" danger icon={<DeleteOutlined />} />
             </Tooltip>
           </Popconfirm>
@@ -402,26 +421,17 @@ export default function WorkflowListPage() {
   ];
 
   return (
-    <div style={PAGE_WRAPPER_STYLE}>
+    <div className="workflow-page-stack" style={PAGE_WRAPPER_STYLE}>
       <PageHeader
         title={t('list.title')}
+        subtitle={t('list.subtitle')}
         extra={
           <Space>
-            <Tooltip title="查看 WorkflowEventOutbox 表原始数据">
-              <Button
-                icon={<DatabaseOutlined />}
-                onClick={() =>
-                  navigate('/admin/data-mngt/workflow-event-outbox')
-                }
-              >
-                PG表事件队列
-              </Button>
-            </Tooltip>
             <Button
               icon={<ImportOutlined />}
               onClick={() => setImportModalOpen(true)}
             >
-              Import
+              {t('list.import')}
             </Button>
             <Button
               type="primary"
@@ -444,18 +454,19 @@ export default function WorkflowListPage() {
       <Card {...SEARCH_CARD_PROPS}>
         <Space wrap>
           <Select
-            placeholder="Status"
+            placeholder={t('list.status')}
             allowClear
             value={filterStatus}
             onChange={(v) => setFilterStatus(v)}
             style={{ width: 120 }}
             options={[
-              { value: 'draft', label: 'Draft' },
+              { value: 'draft', label: t('workflowStatus.draft') },
               { value: 'published', label: t('list.publishedStatus') },
+              { value: 'deleting', label: t('workflowStatus.deleting') },
             ]}
           />
           <Input
-            placeholder="Search by name"
+            placeholder={t('list.searchPlaceholder')}
             allowClear
             defaultValue={filterName}
             onChange={(e) => {
@@ -483,7 +494,7 @@ export default function WorkflowListPage() {
             pageSize: PAGE_SIZE,
             total,
             onChange: (p) => setPage(p),
-            showTotal: (t) => `Total ${t}`,
+            showTotal: (totalCount) => t('list.total', { count: totalCount }),
           }}
           size="small"
         />
@@ -499,13 +510,13 @@ export default function WorkflowListPage() {
           setPublishSummary('');
         }}
         okText={t('list.publish')}
-        cancelText="Cancel"
+        cancelText={t('common.cancel')}
         confirmLoading={publishLoading}
       >
-        <p>Please enter a version description:</p>
+        <p>{t('list.publishDescription')}</p>
         <Input.TextArea
           rows={3}
-          placeholder="Describe what changed in this version..."
+          placeholder={t('list.publishPlaceholder')}
           value={publishSummary}
           onChange={(e) => setPublishSummary(e.target.value)}
         />