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

两个问题都源于同一件事——一栏 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 -32
View File
@@ -6,12 +6,13 @@ import {
import clsx from 'clsx'
import { api } from '../api/client'
import { FlowCanvas } from '../canvas/FlowCanvas'
import { Inspector } from '../canvas/Inspector'
import { Palette } from '../canvas/Palette'
import { InspectorSheet } from '../canvas/InspectorSheet'
import { AssistantPanel } from '../run/AssistantPanel'
import { RunControl } from '../run/RunControl'
import { useStudio, toGraph } from '../store/studio'
import { useCatalog } from '../store/catalog'
import { Empty, Modal, Spinner, Tabs, useToast } from '../components/ui'
import { Empty, Modal, Spinner, useToast } from '../components/ui'
import type { Workflow } from '../types'
export function StudioPage() {
@@ -20,11 +21,9 @@ export function StudioPage() {
const workflow = useStudio((s) => s.workflow)
const dirty = useStudio((s) => s.dirty)
const issues = useStudio((s) => s.issues)
const selectedId = useStudio((s) => s.selectedId)
const streaming = useStudio((s) => s.streaming)
const { load, save, setGraph } = useStudio()
const { load, save, setGraph, select } = useStudio()
const [tab, setTab] = useState<'inspect' | 'run'>('run')
const [picker, setPicker] = useState(false)
const [saving, setSaving] = useState(false)
const [publishing, setPublishing] = useState(false)
@@ -35,14 +34,11 @@ export function StudioPage() {
if (!workflow && workflows.length) load(workflows[0])
}, [workflows, workflow, load])
// 选中节点时自动切到属性页,省一次点击
// 开始跑图或生成时,属性面板让开——不然进展发生在一块被盖住的地方。
// (选中节点即滑出属性面板,取消选中即收起,不再需要手动切 tab)
useEffect(() => {
if (selectedId) setTab('inspect')
}, [selectedId])
// 开始跑图或开始生成时切回助手栏,否则进展发生在一个看不见的 tab 里
useEffect(() => {
if (streaming || copilotActive) setTab('run')
}, [streaming, copilotActive])
if (streaming || copilotActive) select(null)
}, [streaming, copilotActive, select])
const doSave = useCallback(async () => {
if (!workflow) return
@@ -137,14 +133,13 @@ export function StudioPage() {
<div className="flex-1" />
{/* Copilot 不再是弹窗:它就在右栏里,这个按钮只负责把人送过去。
弹窗的问题是每改一次图都要重开一次,而且关掉之后需求文本就没了 */}
{/* Copilot 不再是弹窗:它就在右栏里,这个按钮只负责把焦点送过去。
弹窗的问题是每改一次图都要重开一次,关掉之后需求文本就没了 */}
<button
className="btn"
title="用自然语言生成或修改工作流"
onClick={() => {
setTab('run')
// 等这一帧渲染完输入框才在 DOM 里
select(null) // 属性面板盖着的话先让开
requestAnimationFrame(() =>
window.dispatchEvent(new Event('agentlab:focus-copilot')))
}}
@@ -156,9 +151,12 @@ export function StudioPage() {
title={dirty ? '先保存再发布' : '把当前版本立为正式版本,正式运行只认它'}>
<ShieldCheck size={12} /> 发布
</button>
<button className="btn btn-primary" onClick={doSave} disabled={saving || !dirty}>
<button className="btn" onClick={doSave} disabled={saving || !dirty}>
{saving ? <Spinner /> : <Save size={12} />} 保存
</button>
{/* 运行是对整张图的动作,和保存、发布同类,属于工具栏。放在助手栏里
会和 Copilot 输入框两个"主要动作"互相压着 */}
<RunControl />
</div>
{/* 三栏 */}
@@ -169,21 +167,12 @@ export function StudioPage() {
<main className="relative min-w-0 flex-1">
<FlowCanvas />
</main>
<aside className="flex w-[360px] shrink-0 flex-col border-l bg-panel">
<Tabs
tabs={[{ key: 'run', label: '助手' }, { key: 'inspect', label: '属性' }]}
active={tab}
onChange={(k) => setTab(k as any)}
/>
{/* 两个都挂着、用 hidden 切换,而不是三元卸载其中一个。
助手栏里有输入框草稿、展开状态、滚动位置——点一下"属性"看个
节点再切回来全没了,等于逼人别用属性页 */}
<div className={clsx('min-h-0 flex-1', tab !== 'run' && 'hidden')}>
<AssistantPanel />
</div>
<div className={clsx('min-h-0 flex-1 overflow-y-auto', tab !== 'inspect' && 'hidden')}>
<Inspector />
</div>
{/* 助手常驻,属性是盖在它上面的一层。做成两个 tab 的话它们就互斥了,
而这两件事在时间上并不互斥——跑图跑到一半点开节点看配置,整条
执行过程会从眼前消失,切回来滚动位置和输入草稿也没了 */}
<aside className="relative flex w-[360px] shrink-0 flex-col border-l bg-panel">
<AssistantPanel />
<InspectorSheet />
</aside>
</div>