右栏重构:助手常驻,属性改为盖上去的一层

两个问题都源于同一件事——一栏 360px 被要求同时干两件活。

**没地方引导写问题。** Copilot 输入框是个 38px 高的框,挤在一条长长的流
底下,比它上面任何一块都不起眼;例句被截断成 16 个字的 chip,示范"该说到
什么颗粒度"这个作用就没了,只剩装饰。改成一个组件两种体量:没说过话时它
就是这一栏的主体(竖直居中、三行高、自动聚焦、完整句子的例句),并且告诉
用户它能够到什么(N 个数据源 / M 个工具)——不然"查销售库"这种话有没有意义
只能靠猜。有了对话之后它退到底部两行。不做成两个组件:那就是两个实例,
切换时会卸载其中一个,草稿、光标、输入法候选词全没。

**Copilot 和属性挤在一起。** 它们原是 [助手|属性] 两个 tab,而 tab 是互斥的
——跑图跑到一半点开节点看配置,整条执行过程就从眼前消失,切回来滚动位置和
输入草稿也没了(切 tab 会卸载组件)。改成属性滑出来盖在助手上:助手一直在
下面活着,属性是临时造访者。头部给一个明确的"‹ 助手",Esc 关得掉;盖住
期间底部留一条执行进度,点一下回去——不能因为换了实现就把原来最难受的
那个场景原样留着。

运行控件搬去工具栏。它原先和 Copilot 输入框一起常驻助手栏,两个都是"主要
动作"互相压着;而它们是两种意图(跑这张图 / 改这张图)。运行是对整张图的
动作,和保存、发布同类。有输入字段就弹表单,没有就一键直接跑。

顺带修了两处状态说反的地方:
- 停在人工介入时,承载的节点还在转蓝圈。转圈说的是"它在忙,你等着",而
  实际正相反——它在等你。改成待办色 + 手势图标。
- "继续执行"的去重原先靠"界面上还有没有 waiting 步骤",上一条改动多了一处
  产生 waiting 的地方就失效了。改用事件相邻性判断——那是这两条事件的固有
  性质,不会因为别处改了展示而变。

动效:面板滑入、例句依次入场、正在出字的那一步有一道光扫过(比转圈多说
一件事:它在产出,不只是在等)、空态标记轻微呼吸。全部 240ms 以内,缓动
统一 cubic-bezier(.32,.72,0,1)。另外补上了此前完全没有的
prefers-reduced-motion——这套界面里动的东西不少(边在流动、节点在脉冲、
面板在滑),系统里关了还照播,对前庭敏感的人是实打实的难受。

验证:check-ui 重写了助手栏那一节,核心断言是"选中节点再回来,输入的字
还在"——那正是 tab 方案做不到的。新增一条用 emulateMedia 验证关掉动效后
动画确实停了。真跑了一次带人工审批的图,期间打开属性面板确认进度条还在。
四套检查 + 82 个后端测试全过,生产构建通过。
This commit is contained in:
ThearchyHelios
2026-09-18 00:05:22 +08:00
parent 3ff6840b99
commit 3de7567377
12 changed files with 877 additions and 457 deletions
+172
View File
@@ -0,0 +1,172 @@
import { useEffect, useMemo, useRef, useState } from 'react'
import { ChevronDown, Play, ShieldCheck, Square } from 'lucide-react'
import { useStudio } from '../store/studio'
import { Spinner, useToast } from '../components/ui'
/**
* 工具栏上的运行控件。
*
* 从右栏顶部搬上来的。原先它和 Copilot 输入框一起常驻在助手栏里,两个都是
* "主要动作",互相压着——而它们其实是两种不同的意图(改这张图 / 跑这张图),
* 不该争同一块地方。运行是对整个文档的动作,和保存、发布是一类,属于工具栏。
*
* 有输入字段就弹出表单填了再跑;没有字段就一键直接跑,不为了统一而多一次点击。
*/
export function RunControl() {
const nodes = useStudio((s) => s.nodes)
const run = useStudio((s) => s.run)
const streaming = useStudio((s) => s.streaming)
const issues = useStudio((s) => s.issues)
const workflow = useStudio((s) => s.workflow)
const dirty = useStudio((s) => s.dirty)
const { startRun, startFormalRun, stopRun } = useStudio()
const toast = useToast()
const [open, setOpen] = useState(false)
const [values, setValues] = useState<Record<string, string>>({})
const [busy, setBusy] = useState(false)
const wrap = useRef<HTMLDivElement>(null)
const inputFields = useMemo(() => {
const entry = nodes.find((n) => n.data.nodeType === 'input')
return (entry?.data.config?.fields ?? []) as any[]
}, [nodes])
const errors = issues.filter((i) => i.level === 'error')
const canFormal = !!workflow
&& (workflow.status === 'published' || workflow.status === 'governed')
&& !!workflow.published_version
const running = streaming || run?.status === 'running'
// 点外面关掉。浮层不能只靠再点一次按钮关——那是很容易漏掉的死路
useEffect(() => {
if (!open) return
const onDown = (e: MouseEvent) => {
if (!wrap.current?.contains(e.target as Node)) setOpen(false)
}
const onKey = (e: KeyboardEvent) => { if (e.key === 'Escape') setOpen(false) }
window.addEventListener('mousedown', onDown)
window.addEventListener('keydown', onKey)
return () => {
window.removeEventListener('mousedown', onDown)
window.removeEventListener('keydown', onKey)
}
}, [open])
const launch = async (formal = false) => {
setBusy(true)
try {
const payload: Record<string, any> = {}
for (const field of inputFields) {
if (!field.name) continue
const raw = values[field.name] ?? field.default ?? ''
// 看起来像 JSON 就按 JSON 传,让数组/对象类型的输入能用
if (typeof raw === 'string' && /^\s*[[{]/.test(raw)) {
try { payload[field.name] = JSON.parse(raw) } catch { payload[field.name] = raw }
} else {
payload[field.name] = raw
}
}
if (formal) await startFormalRun(payload)
else await startRun(payload)
setOpen(false)
} catch (e: any) {
toast(e.message ?? '启动失败', 'error')
} finally {
setBusy(false)
}
}
if (running) {
return (
<button className="btn btn-danger" onClick={stopRun}>
<Square size={11} fill="currentColor" /> 停止
</button>
)
}
const blocked = !!errors.length || !nodes.length
return (
<div className="relative" ref={wrap}>
<button
className="btn btn-primary gap-1.5"
disabled={busy || blocked}
title={blocked
? (errors.length ? `${errors.length} 个问题会阻止运行:${errors[0].message}` : '画布是空的')
: '用画布当前内容跑一次,结果标探索性'}
onClick={() => {
// 没有输入字段就没什么可填的,多弹一层只是多一次点击
if (!inputFields.length && !canFormal) void launch(false)
else setOpen((v) => !v)
}}
>
{busy ? <Spinner size={11} /> : <Play size={11} fill="currentColor" />}
运行
{(inputFields.length > 0 || canFormal) && (
<ChevronDown size={10} className="opacity-60 transition-transform"
style={{ transform: open ? 'rotate(180deg)' : 'none' }} />
)}
</button>
{open && (
<div className="sheet-in absolute right-0 top-full z-50 mt-1.5 w-[340px] rounded-xl border bg-panel p-3 shadow-xl">
{inputFields.map((field) => (
<div key={field.name} className="mb-2.5">
<label className="label">
{field.name}
{field.required && <span className="ml-1 text-[var(--err)]">*</span>}
{field.description && (
<span className="ml-1.5 font-normal text-faint">{field.description}</span>
)}
</label>
<textarea
className="field"
rows={2}
autoFocus={field === inputFields[0]}
value={values[field.name] ?? (typeof field.default === 'string'
? field.default
: field.default ? JSON.stringify(field.default) : '')}
placeholder={field.required ? '必填' : '可留空'}
onChange={(e) => setValues({ ...values, [field.name]: e.target.value })}
onKeyDown={(e) => {
if ((e.metaKey || e.ctrlKey) && e.key === 'Enter') void launch(false)
}}
/>
</div>
))}
{!inputFields.length && (
<div className="mb-2.5 text-[11px] text-faint">这张图没有输入节点,将直接运行</div>
)}
<div className="flex gap-2">
<button className="btn btn-primary flex-1 justify-center" disabled={busy}
onClick={() => launch(false)}>
<Play size={11} fill="currentColor" /> 试运行
</button>
{canFormal && (
<button
className="btn flex-1 justify-center"
style={{ borderColor: 'var(--ok)', color: 'var(--ok)' }}
disabled={busy || dirty}
title={dirty
? '有未保存改动,正式运行只跑已发布版本'
: `从已发布的 v${workflow?.published_version} 不可变版本发起`}
onClick={() => launch(true)}
>
<ShieldCheck size={11} /> 正式 v{workflow?.published_version}
</button>
)}
</div>
{canFormal && dirty && (
<div className="mt-1.5 text-[10px] leading-relaxed text-faint">
画布有未保存改动;正式运行永远执行已发布的不可变版本
</div>
)}
{!!inputFields.length && (
<div className="mt-1.5 text-[10px] text-faint">⌘⏎ 直接运行</div>
)}
</div>
)}
</div>
)
}