/** * 术语表:界面文案里同一件事只有一种叫法。 * * 之前「正式」一个词指三件事(发布等级、运行类别、出具档位),探索态有四五种 * 叫法;「工作流 / 图 / 画布 / 流程」「审批 / 确认 / 介入 / 放行」混用,门禁报错 * 引用的词界面上从没出现过。这三层(发布等级、运行类别、出具档位)是「受限动态 * 编排」的骨架,彼此独立:一次正式运行完全可能降档出具。说法必须分开。 * * 规则: * - 「工作流」指存下来的资产,「画布」指编辑区,「图」只在技术细节里出现 * (执行图、走线)。 * - 「运行」名词动词都用它;导航里的历史页叫「记录」。 * - 人工节点叫「人工审批」,agent / tool / code 上的选项叫「审批策略」,等人 * 处理的那张卡叫「审批卡」。 * - 右栏叫「助手」;Copilot 只作为产品功能名出现在按钮提示里。 * * 枚举值(formal / degraded / withheld 等)不动,只换显示。 */ import type { NodeType } from '../types' export const TERMS = { workflow: '工作流', canvas: '画布', run: '运行', records: '记录', assistant: '助手', copilot: 'Copilot', humanNode: '人工审批', approvalPolicy: '审批策略', approvalCard: '审批卡', formalRun: '正式运行', exploratoryRun: '探索运行', } as const /** 工作流状态(发布等级) */ export const WORKFLOW_STATUS_LABEL: Record<'draft' | 'published' | 'governed', string> = { draft: '草稿', published: '已发布', governed: '受管', } /** 发布弹窗里的选项说明:和工具栏 chip「已发布 v4」说法对得上 */ export const WORKFLOW_STATUS_HINT: Record<'draft' | 'published' | 'governed', string> = { draft: '草稿 — 只能发起探索运行', published: '已发布 — 可发起正式运行', governed: '受管 — 可发起正式运行,并受治理门禁约束', } /** 运行类别 */ export const RUN_CLASS_LABEL: Record<'formal' | 'exploratory', string> = { formal: '正式运行', exploratory: '探索运行', } /** 按钮上的运行类别:「正式运行 v3」 */ export function runClassLabel(runClass: 'formal' | 'exploratory' | null | undefined, version?: number | null): string { if (runClass === 'formal') return version != null ? `正式运行 v${version}` : '正式运行' return '探索运行' } /** * 没挂在工作流上的运行:画布或问数据当场搭的,从没存成工作流。后端给它的名字老数据是 * 「临时图」、新的是「未保存的工作流」,也可能是空的;界面上一律叫「未保存的工作流」。 * 运行和审批都带 workflow_id / workflow_name,记录页、命令面板、审批卡、通知走同一处 */ export const UNSAVED_NAME = '未保存的工作流' export const UNSAVED_HINT = '这次运行跑的是画布或问数据当场搭的工作流,没有存下来,所以回不到画布里' const UNSAVED_NAMES = new Set(['临时图', UNSAVED_NAME]) type WorkflowRef = { workflow_id?: string | null; workflow_name?: string | null } export const isUnsaved = (x: WorkflowRef): boolean => !x.workflow_id && (!x.workflow_name || UNSAVED_NAMES.has(x.workflow_name)) export const runName = (x: WorkflowRef): string => isUnsaved(x) ? UNSAVED_NAME : x.workflow_name ?? '' /** 出具档位 */ export const ISSUANCE_LABEL: Record<'formal' | 'degraded' | 'withheld', string> = { formal: '完整出具', degraded: '降档出具', withheld: '不予出具', } export function issuanceLabel(tier: string | null | undefined): string { if (!tier) return '—' return (ISSUANCE_LABEL as Record)[tier] ?? tier } /** * 节点类型的中文名。画布节点库、运行流、门禁报错、GraphPeek 的 chip 都用这一张。 * * 这是短名:节点库条目上的「成果 / 出具」是在短名后面补了一句用途,那是节点库 * 自己的展示,不是另一个名字。后端 schema.py / governance.py 的报错也按这张表写。 */ export const NODE_TYPE_LABEL: Record = { input: '输入', output: '成果', llm: '模型调用', agent: 'Agent', supervisor: '多 Agent 协作', tool: '调用工具', code: '沙箱代码', branch: '条件分支', loop: '循环', subgraph: '子工作流', memory: '长期记忆', retrieve: '知识检索', transform: '数据整形', human: '人工审批', validate: '结构校验', metrics: '口径卡', } /** 与 decode.ts 里旧名字同名的出口,第二波改成从这里导入时不用改调用处 */ export const TYPE_LABEL: Record = NODE_TYPE_LABEL /** 未知类型原样返回:Copilot 可能编出不存在的类型,显示原码比显示空白好查 */ export function nodeTypeLabel(type: string | null | undefined): string { if (!type) return '—' return TYPE_LABEL[type] ?? type } /** 审批策略的选项文字:agent / tool / code 三处共用一套说法 */ export const APPROVAL_POLICY_LABEL: Record<'dangerous' | 'always' | 'never', string> = { dangerous: '仅危险工具需要审批', always: '每次调用都审批', never: '全部自动放行', }