import { useEffect, useMemo, useRef, useState } from 'react' import { Link, useNavigate } from 'react-router-dom' import { ChevronDown, Play } from 'lucide-react' import clsx from 'clsx' import { api } from '../api/client' import { NODE_DEFS } from '../canvas/nodeDefs' import { hintOf } from '../canvas/shortcuts' import { Kbd, Skeleton, Spinner, toast } from '../components/ui' import { SchemaForm } from '../components/SchemaForm' import { errorMessage } from '../lib/errors' import { explainStartError } from '../lib/explain' import { SIGNER_TEXT, runClassLabel } from '../lib/terms' import { useSigner } from '../store/auth' import { useStudio, type FlowNode } from '../store/studio' import type { ValidationIssue, WorkflowVersion } from '../types' import type { FormSchema } from '../typesApp' import { inputPayload, inputSchemaOf, type InputField } from './inputSchema' import { ClassDot, escapeRun, RunCapsule } from './RunHud' import { isActivePhase } from './trace' /** * 发起就被拒。绑定的工具在本机不存在(run_tool_missing)时给直达入口:数据源工具去数据页接入, * 自定义、MCP 工具去工具页——这次运行还没开始,没有「接着跑」可给。别的照通用的出错提示 */ function startFailed(e: unknown, navigate: (to: string) => void) { const x = explainStartError(e) if (!x?.fixTo) { toast.error(e) return } const to = x.fixTo toast.error(`${x.title}:${x.reason ?? ''}${x.action ?? ''}`, { detail: x.raw, key: 'studio:run-tool-missing', action: { label: x.fixLabel ?? '去接入', onClick: () => navigate(to) }, }) } /** * 工具栏上的运行控件。 * * 从右栏顶部搬上来的。原先它和 Copilot 输入框一起常驻在助手栏里,两个都是 * "主要动作",互相压着——而它们其实是两种不同的意图(改这张图 / 跑这张图), * 不该争同一块地方。运行是对整个文档的动作,和保存、发布是一类,属于工具栏。 * * 有了运行之后,这里多一枚运行胶囊(run/RunHud.tsx):跑的时候它就是全部—— * 计时、进度、用量、停止都在里面;结束了它收成结果,旁边再露出发起按钮。 * 相位一律读 store 的 runPhase(由事件推出),不再读启动时那份 run 快照: * 那份快照的 status 永远是 queued,失败后「接着跑」出不来、续跑完「停止」卡死。 * * 两个入口互不牵连: * - 「运行」用画布当前内容发起探索运行,画布有错误时不能点; * - 「正式运行 vN」跑已发布的不可变版本,只看 published_version,和画布上的 * 错误、未保存改动都无关(改了只提示「不含画布改动」),表单字段取那一版的。 */ function fieldsOfGraph(graph: WorkflowVersion['graph']): InputField[] { const entry = graph?.nodes?.find((n) => n.type === 'input') return ((entry?.data?.config?.fields ?? []) as InputField[]).filter((f) => f?.name) } /** 已发布版本的发起表单,按 (工作流, 版本) 缓存:发布之后那一版就不会再变 */ const versionForms = new Map() /** * 发起表单。X2:发起表单、人工节点、待办、应用入口共用一个表单渲染器(SchemaForm)——以前这里每个字段都是一个 * 文本框,入口字段声明了类型、可选值也看不出来。Mod+Enter 直接发起 */ function LaunchForm({ schema, values, onChange, onSubmit, idPrefix }: { schema: FormSchema values: Record onChange: (v: Record) => void onSubmit: () => void idPrefix: string }) { if (!Object.keys(schema.properties).length) return null return (
) } /** * 运行被拦时按钮上的说明:点出是哪个节点。后端的原话只说节点类型(「调用工具」节点还没选工具), * 图里有两个工具节点就分不清是哪一个;全部问题在问题面板里,点一条能定位过去 */ function blockedTitle(errors: ValidationIssue[], nodes: FlowNode[]): string { const first = errors[0] const node = first.node_id ? nodes.find((n) => n.id === first.node_id) : undefined const name = node ? node.data.label || NODE_DEFS[node.data.nodeType]?.label || node.id : '' const text = name && !first.message.includes(`「${name}」`) ? `「${name}」· ${first.message}` : first.message const head = errors.length > 1 ? `${errors.length} 个问题会阻止运行,第一个:` : '此问题会阻止运行:' return `${head}${text}。${hintOf('所有问题均列在问题面板中,点击可定位到节点', 'problems')}` } /** 点外面、按 Esc 关掉浮层。浮层不能只靠再点一次按钮关——那是很容易漏掉的死路 */ function useDismiss(open: boolean, close: () => void, wrap: React.RefObject) { useEffect(() => { if (!open) return const onDown = (e: MouseEvent) => { if (!wrap.current?.contains(e.target as Node)) close() } const onKey = (e: KeyboardEvent) => { if (e.key !== 'Escape' || e.isComposing) return e.preventDefault() close() } window.addEventListener('mousedown', onDown) window.addEventListener('keydown', onKey) return () => { window.removeEventListener('mousedown', onDown) window.removeEventListener('keydown', onKey) } }, [open, close, wrap]) } /** 探索运行:画布当前这张图。tight:旁边有运行胶囊,窄屏上只留图标 */ function ExploreLauncher({ tight }: { tight: boolean }) { const nodes = useStudio((s) => s.nodes) const issues = useStudio((s) => s.issues) const startRun = useStudio((s) => s.startRun) const [open, setOpen] = useState(false) const [values, setValues] = useState>({}) const [busy, setBusy] = useState(false) const wrap = useRef(null) useDismiss(open, () => setOpen(false), wrap) // 画布上的入口字段按和服务端同一套规则转成表单(run/inputSchema):试运行的是画布,不是已发布版本 const entryFields = useMemo(() => { const entry = nodes.find((n) => n.data.nodeType === 'input') return ((entry?.data.config?.fields ?? []) as InputField[]).filter((f) => f?.name) }, [nodes]) const schema = useMemo(() => inputSchemaOf(entryFields), [entryFields]) const fields = entryFields const errors = issues.filter((i) => i.level === 'error') const blocked = !!errors.length || !nodes.length const navigate = useNavigate() const launch = async () => { setBusy(true) try { await startRun(inputPayload(schema, values)) setOpen(false) } catch (e) { startFailed(e, navigate) } finally { setBusy(false) } } return (
{open && (
{runClassLabel('exploratory')} · 使用画布当前内容,结果不归档
void launch()} idPrefix="run-explore" />
在输入框中直接发起{runClassLabel('exploratory')}
)}
) } /** * 正式运行:已发布的不可变版本。 * * 以前它要求工作流状态是已发布 / 受管——可保存一次就退回草稿,入口跟着消失, * 而后端只看 published_version。它也不受画布上的错误和未保存改动影响:跑的 * 根本不是画布。表单字段必须取那一版的入口:画布改过字段名时照画布填, * 传过去的就是错的参数。 */ function FormalLauncher({ workflowId, version }: { workflowId: string; version: number }) { const dirty = useStudio((s) => s.dirty) const canvasVersion = useStudio((s) => s.workflow?.version) const startFormalRun = useStudio((s) => s.startFormalRun) // 正式运行记在谁的名下:开了登录是登录的人(服务端不看署名),关登录是本机署名(请求头 X-Actor)。和发布、审批一样写明 const signer = useSigner() const key = `${workflowId}@${version}` const [open, setOpen] = useState(false) const [schema, setSchema] = useState(versionForms.get(key) ?? null) const [loadError, setLoadError] = useState(null) const [values, setValues] = useState>({}) const [busy, setBusy] = useState(false) const wrap = useRef(null) useDismiss(open, () => setOpen(false), wrap) useEffect(() => { setSchema(versionForms.get(key) ?? null) setValues({}) }, [key]) useEffect(() => { if (!open || versionForms.has(key)) return let alive = true setLoadError(null) api.workflows.version(workflowId, version) .then((v) => { // 服务端按版本快照转好的表单(input_schema)为准;老服务端没有,按这一版的入口字段同规则转 const form = v.input_schema ?? inputSchemaOf((v.input_fields?.length ? v.input_fields : fieldsOfGraph(v.graph)) as InputField[]) versionForms.set(key, form) if (alive) setSchema(form) }) .catch((e) => { if (alive) setLoadError(e) }) return () => { alive = false } }, [open, key, workflowId, version]) const fields = schema ? Object.keys(schema.properties) : null // 画布和已发布版本不是同一份:有未保存的改动,或者保存过但没重新发布 const ahead = dirty || (canvasVersion != null && canvasVersion !== version) const label = runClassLabel('formal', version) const navigate = useNavigate() const launch = async () => { setBusy(true) try { await startFormalRun(schema ? inputPayload(schema, values) : {}) setOpen(false) } catch (e) { startFailed(e, navigate) } finally { setBusy(false) } } return (
{open && (
{label} · 已发布的不可变版本,结果归档
{ahead && (
不含画布改动:{dirty ? '画布上有未保存的改动' : `画布为 v${canvasVersion},尚未发布`},本次运行使用 v{version}。
)} {fields == null && !loadError && } {loadError != null && (
无法获取 v{version} 的输入字段:{errorMessage(loadError)}。
)} {fields && !fields.length && (
v{version} 没有输入字段,将直接运行
)} {schema && ( void launch()} idPrefix="run-formal" /> )} {signer.verified ? (
{SIGNER_TEXT.launchAs(signer.name)}
) : signer.name ? (
将以「{signer.name}」的名义发起,并记入运行记录
) : (
未署名:本次运行不会记录发起人 · 去设置署名
)} {!!fields?.length && (
在输入框中直接发起{runClassLabel('formal')}
)}
)}
) } export function RunControl() { const phase = useStudio((s) => s.runPhase) const workflowId = useStudio((s) => s.workflow?.id) const published = useStudio((s) => s.workflow?.published_version) const active = isActivePhase(phase) // Esc:回放中先回到实时,运行结束后清掉画布上的结果。别的层(输入框、弹窗、 // 属性面板、发起浮层)先处理 Esc 时这里让路 useEffect(() => { const onKey = (e: KeyboardEvent) => { if (escapeRun(e)) e.preventDefault() } window.addEventListener('keydown', onKey) return () => window.removeEventListener('keydown', onKey) }, []) return (
{phase !== 'idle' && } {/* 运行中只留胶囊:同一张画布同一时刻只跟一次运行 */} {!active && ( <> {workflowId && published ? : null} )}
) }