界面与交互全面翻修(前两波):运行态有了 HUD 和时间轴,终态会收尾,全站令牌、组件、文案统一

来自 2026-09 的 UI/UX 审查(142 条)。本提交是前两波,第三波(记录页接入时间轴、跨页互链、check-ui 更新、全站扫尾)另行提交。

地基
- 设计令牌:全局规则和 .btn/.field/.chip 放进 CSS 层,Tailwind 工具类重新生效,选中态、开启态不再被吞掉;字号阶梯;
  辅助文字在所有底色上 >= 4.5:1;状态色专用,节点类型色与之拉开色相;「跟随系统」真的跟随,首帧不闪深色;新字标与 favicon
- 基础组件:confirmDialog / promptDialog 取代原生对话框;toast 出错不自动消失、可复制、读屏可播报;离线横幅与断线恢复;
  九种剪影的状态徽标;唯一一份状态文案(lib/status)、格式化(lib/format)、术语(lib/terms)、报错人话(lib/errors)
- 运行态内核:事件折成航迹(run/trace.ts),可投影到任意时刻;取消 / 失败 / 服务重启后统一收尾,不再永远转圈;
  run.status 随事件回写;token 事件不再堆进 events
- 后端:协作成员逐个完成即发事件,调度者决策有事件;时长分执行 / 墙钟 / 等人;API 时间带时区;
  中断的运行也发 stream.end;运行列表可筛选翻页;删除运行 / 工作流有保护;运行默认值接通;可测未保存的配置;
  报错说清发生了什么、为什么、怎么办

功能
- 画布:状态四重编码、固定高度遥测槽、按缩放三档、运行胶囊与 HUD、航迹时间轴与回放、执行轨迹边、
  等待闸门、跟随执行、正式运行只读、一次性时刻(开场点亮、回扫、阻断级联、出具印章)
- 编辑:撤销重做、版本历史、问题面板可定位、三栏可收起、模板与表达式字段区分、变量血缘、快捷键、带搜索的选择器
- 回答流 / 问数据:贴底才跟随滚动、工件下钻、出具横幅列出缺口、答案可复制导出、按会话的忙闲、
  答案不再在 2000 字处截断、重启后这一轮会收尾
- 记录页:待审批 / 运行中 / 失败页签、筛选翻页、实时接流、排错路径指到节点、封存凭证常驻
- 管理页:新的「数据」页、写操作失败都有反馈、弹窗里先测连接、统一持久的连接状态
- 外壳:导航改版、⌘K 命令面板、? 快捷键帮助、404、页面标题与 favicon 状态点、后台提醒

验证(沙箱):tsc 干净,pytest 579 passed,14 个检查脚本中 13 个全绿;check-ui 剩 1 项旧断言(按旧日期格式找运行行),第三波更新。
This commit is contained in:
ThearchyHelios
2026-09-26 23:11:31 +08:00
parent 95ff6470d1
commit e10c4f23fc
132 changed files with 43558 additions and 5399 deletions
+175
View File
@@ -0,0 +1,175 @@
import { useEffect, useRef } from 'react'
import { AlertTriangle, CheckCircle2, CornerDownRight, RotateCw, Trash2, Unlink, Workflow, XCircle } from 'lucide-react'
import clsx from 'clsx'
import { NODE_DEFS } from './nodeDefs'
import type { FieldRef, Problem } from './issues'
import { formatShortcut } from '../lib/keys'
import { useCatalog } from '../store/catalog'
import { useStudio } from '../store/studio'
import { Spinner } from '../components/ui'
/**
* 问题面板:图级、节点、边上的 error 和 warning,一条一行,点一下定位。
*
* 以前只有工具栏上一个点不动的「2 个错误」:图级的(找不到入口)只体现在计数里,
* 边上的根本没地方看,有 error 时 warning 的计数还被藏起来——而 warning 恰恰是
* 「取到空值」这类运行期静默出错的那一类。现在按节点分组(图级在最前),
* 点一行选中节点、镜头对过去、检查器翻到出问题的那个字段。F8 / ⇧F8 在问题之间跳。
*/
export function ProblemsPane({ problems, activeId, onLocate, onDeleteEdge }: {
problems: Problem[]
activeId: string | null
onLocate: (p: Problem) => void
onDeleteEdge: (edgeId: string) => void
}) {
const nodes = useStudio((s) => s.nodes)
const analysis = useStudio((s) => s.analysis)
const analysisError = useStudio((s) => s.analysisError)
const analyzeNow = useStudio((s) => s.analyzeNow)
const offline = useCatalog((s) => s.backend === 'down')
const list = useRef<HTMLDivElement>(null)
// F8 跳到的那一条要在视野里
useEffect(() => {
if (!activeId) return
list.current?.querySelector(`[data-problem="${CSS.escape(activeId)}"]`)
?.scrollIntoView({ block: 'nearest' })
}, [activeId])
// 只有后端整个断了,恢复连接时才会自动重跑(useOnReconnect);校验接口自己报错
// 不会有人替你再试,这时候承诺「会自动重新校验」就是在让人干等
const retryHint = offline ? '连上后端之后会自动重新校验' : '点「重试」再校验一次'
if (analysis === 'failed' && !problems.length) {
return (
<div className="flex flex-1 flex-col items-center justify-center gap-2 px-6 text-center text-2xs">
<span style={{ color: 'var(--warn)' }}>分析失败{analysisError ? `:${analysisError}` : ''}</span>
<span className="text-faint">问题清单暂时拿不到,画布照常能编辑。{retryHint}</span>
<button type="button" className="btn btn-sm" onClick={() => void analyzeNow()}>
<RotateCw size={11} /> 重试
</button>
</div>
)
}
if (!problems.length) {
return (
<div className="flex flex-1 items-center justify-center gap-1.5 text-2xs text-faint">
{analysis === 'pending'
? <><Spinner size={11} /> 正在校验…</>
: <><CheckCircle2 size={12} style={{ color: 'var(--ok)' }} /> 没有发现问题</>}
</div>
)
}
const byNode = new Map(nodes.map((n) => [n.id, n]))
const groups: { key: string; title: React.ReactNode; items: Problem[] }[] = []
for (const p of problems) {
const key = p.scope === 'node' ? `n:${p.nodeId}` : p.scope
let g = groups.find((x) => x.key === key)
if (!g) {
const node = p.nodeId ? byNode.get(p.nodeId) : undefined
const def = node ? NODE_DEFS[node.data.nodeType] : undefined
g = {
key,
title: p.scope === 'graph'
? <><Workflow size={11} className="shrink-0 text-faint" /> 整张工作流</>
: p.scope === 'edge'
? <><Unlink size={11} className="shrink-0 text-faint" /> 连线</>
: <>
{def
? <def.icon size={11} className={`nt-${node!.data.nodeType} shrink-0`} style={{ color: 'var(--nt)' }} />
: <span className="h-2.5 w-2.5 shrink-0 rounded-sm border" />}
<span className="min-w-0 truncate text-fg">{node?.data.label || p.nodeId}</span>
{def && <span className="shrink-0 text-faint">· {def.label}</span>}
</>,
items: [],
}
groups.push(g)
}
g.items.push(p)
}
return (
<>
{/* 这次没分析成:清单还是上一次校验的,照样列出来(多半仍然有效),但说清楚它可能过时 */}
{analysis === 'failed' && (
<div className="mx-2 mt-1.5 flex shrink-0 items-center gap-2 rounded-md border px-2.5 py-1.5 text-2xs"
style={{ borderColor: 'var(--warn)' }}>
<AlertTriangle size={11} className="shrink-0" style={{ color: 'var(--warn)' }} aria-hidden />
<span className="min-w-0 flex-1">
<span style={{ color: 'var(--warn)' }}>分析失败{analysisError ? `:${analysisError}` : ''}</span>
<span className="text-faint"> · 下面是上一次校验的结果,可能已经过时。{retryHint}</span>
</span>
<button type="button" className="btn btn-xs shrink-0" onClick={() => void analyzeNow()}>
<RotateCw size={10} /> 重试
</button>
</div>
)}
<div ref={list} className="min-h-0 flex-1 overflow-y-auto py-1" role="list" aria-label="问题">
{groups.map((g) => (
<div key={g.key} className="mb-1">
<div className="sticky top-0 z-[1] flex items-center gap-1.5 bg-panel px-3 py-1 text-2xs font-medium">
{g.title}
<span className="tnum ml-auto shrink-0 text-faint">{g.items.length}</span>
</div>
{g.items.map((p) => (
<ProblemRow key={p.id} problem={p} active={p.id === activeId}
onLocate={() => onLocate(p)} onDeleteEdge={onDeleteEdge} />
))}
</div>
))}
<div className="px-3 pb-1 pt-0.5 text-2xs text-faint">
{formatShortcut('F8')} 下一个 · {formatShortcut('Shift+F8')} 上一个
</div>
</div>
</>
)
}
function ProblemRow({ problem: p, active, onLocate, onDeleteEdge }: {
problem: Problem; active: boolean; onLocate: () => void; onDeleteEdge: (id: string) => void
}) {
const node = useStudio((s) => (p.nodeId ? s.nodes.find((n) => n.id === p.nodeId) : undefined))
const err = p.level === 'error'
const Icon = err ? XCircle : AlertTriangle
const where = fieldLabel(p.field, node?.data.nodeType)
const locatable = p.scope === 'node' && !!node
return (
<div role="listitem" data-problem={p.id}
className={clsx('group flex items-start gap-2 pl-6 pr-2', active && 'bg-hover')}>
<button
type="button"
disabled={!locatable}
onClick={onLocate}
title={locatable ? '选中这个节点并定位到出问题的地方' : undefined}
className={clsx('flex min-w-0 flex-1 items-start gap-2 rounded py-1 text-left text-2xs leading-snug',
locatable ? 'cursor-pointer hover:text-fg' : 'cursor-default')}
>
<Icon size={11} className="mt-px shrink-0" style={{ color: err ? 'var(--err)' : 'var(--warn)' }}
aria-label={err ? '错误' : '提示'} />
<span className={clsx('min-w-0 flex-1', err ? 'text-fg' : 'text-dim')}>{p.message}</span>
{where && (
<span className="flex shrink-0 items-center gap-0.5 text-faint">
<CornerDownRight size={9} aria-hidden />{where}
</span>
)}
</button>
{/* 悬空边(指向不存在的节点):React Flow 不画它,画布上看不见、点不到,只能在这儿删 */}
{p.scope === 'edge' && p.edgeId && (
<button type="button" className="btn btn-xs my-0.5 shrink-0" onClick={() => onDeleteEdge(p.edgeId!)}>
<Trash2 size={10} /> 删除这条悬空边
</button>
)}
</div>
)
}
function fieldLabel(field: FieldRef | null | undefined, type?: string): string {
if (!field) return ''
if (field.key === 'label') return '节点名称'
const def = type ? NODE_DEFS[type as keyof typeof NODE_DEFS] : undefined
const base = def?.fields.find((f) => f.key === field.key)?.label ?? field.key
if (field.index == null) return base
const item = ({ cases: '分支', fields: '字段', metrics: '指标', agents: '成员' } as Record<string, string>)[field.key]
const sub = field.sub === 'condition' ? '的条件' : field.sub === 'key' ? '的标识' : ''
return item ? `第 ${field.index + 1} 个${item}${sub}` : `${base} · 第 ${field.index + 1} 项`
}