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

两个问题都源于同一件事——一栏 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
+21 -6
View File
@@ -315,24 +315,34 @@ export function decodeRun(events: RunEvent[]): Step[] {
return true
}
/** 上一条就是恢复事件——用来认出紧随其后的那条重复的"继续执行" */
let justResumed = false
for (const event of events) {
const type = String(event.type)
if (EPHEMERAL.has(type) || SILENT.has(type)) continue
const d: any = event.data ?? {}
const seq = event.seq ?? 0
const nodeId = event.node_id ?? undefined
// 每条事件都会把"刚恢复过"清掉;只有恢复分支会重新点亮它,
// 所以这个标记只在紧挨着的下一条上为真
const wasJustResumed = justResumed
justResumed = false
switch (type) {
case 'run.started':
case 'run.resumed': {
const resumed = type === 'run.resumed' || !!d.resumed
// 恢复一次会同时来 run.resumed 和 run.started(resumed=true),
// 说两遍"继续执行"只会让人以为恢复了两次
if (resumed && out.some((s) => s.kind === 'lifecycle' && s.title === '继续执行')
&& !out.some((s) => s.status === 'waiting')) {
break
}
// 恢复一次会紧挨着发两条:run.resumed 和 run.started(resumed=true)。
// 说两遍"继续执行"会让人以为恢复了两次。
//
// 判据是"这两条是不是紧挨着的",不是"界面上还有没有待办"——后者
// 曾经能用,但只要多一处会产生 waiting 状态的地方(比如把被中断的
// 节点也标成等待),它就失效了。相邻性是这两条事件的固有性质,
// 不会因为别处改了展示而变。
if (resumed && wasJustResumed) break
if (resumed) {
justResumed = true
// 人已经答过了,那条不该再是橙色的"等你确认"。但配对关系要留着:
// 紧接着 LangGraph 会重放该节点,又发一条一模一样的
// human.requested,配对还开着才能认出那是重放而不是新一轮。
@@ -349,6 +359,7 @@ export function decodeRun(events: RunEvent[]): Step[] {
}
case 'node.started': {
// 恢复后节点重放,它从"等你"回到"在跑"(下面会复用同一条 Step)
// data.label 是节点标题**随事件传递的唯一来源**。靠画布 nodes 反查的话,
// 助手栏和运行页没加载画布,标题会退化成裸 node_id。
// label 是节点标题随事件传递的唯一来源,但没起过名字的节点它等于
@@ -537,6 +548,10 @@ export function decodeRun(events: RunEvent[]): Step[] {
}
openInterrupts.set(key, step)
push(step, nodeId)
// 承载它的那个节点也不是"在跑"——它停下来等人了。转着蓝圈说的是
// "在忙,你等着",而实际情况正相反:它在等你
const host = nodeId ? nodeSteps.get(nodeId) : undefined
if (host && host.status === 'running') host.status = 'waiting'
break
}