From 1444c774cfbe88acd4d2897222d8f965f923f03a Mon Sep 17 00:00:00 2001 From: ThearchyHelios Date: Fri, 18 Sep 2026 10:55:56 +0800 Subject: [PATCH] =?UTF-8?q?=E6=A8=A1=E6=9D=BF=E5=AD=97=E6=AE=B5=E5=8A=A0?= =?UTF-8?q?=20{{=20}}=20=E8=A1=A5=E5=85=A8=EF=BC=9A=E4=BB=8E=E6=BA=90?= =?UTF-8?q?=E5=A4=B4=E6=B6=88=E7=81=AD=E9=82=A3=E7=B1=BB=E9=9D=99=E9=BB=98?= =?UTF-8?q?=E5=A4=B1=E8=B4=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 模板取不到值时渲染成空字符串、不报错,所以拼错一个变量名在运行时完全静默。 上一个 commit 是事后校验(标红+建议),这个是事前:打 {{ 就弹出这张图里 实际有的变量,每条带说明和产出它的节点。 **只挂在真正过模板渲染的字段上。** 这一条是整件事最容易做错的地方: 这套里有五个字段长得像但走的是表达式求值——skip_if、loop.condition、 cases[].condition、transform.expression、metrics[].expression——那里要写 `vars.count == 0` 这样的裸路径,不带大括号。在那些字段上挂 {{ 触发器等于 手把手教用户写错。同理 supervisor 的 agents[].system 长得和 llm.system 一模一样,但后端是 cfg.get("system") 直接取值、根本不渲染,那里弹补全会 是个谎;它走的是 AgentList 里的裸 textarea,天然不受影响。 几个不写就会坏的细节: - 这是完全受控组件。插入后 onChange 会一路走到 store 再把 value 灌回来, DOM 光标会跳到末尾——必须等那一帧过去再自己 setSelectionRange 放回去。 测试里专门验了"插入后继续打字,字落在后面而不是中间"。 - 候选框用文档流里的块,不是绝对定位浮层:属性面板是 overflow-y-auto、 外层 InspectorSheet 是 overflow-hidden,浮层到边缘直接被切掉。 - 用 onMouseDown 不是 onClick——onClick 在 blur 之后才触发,那时候弹层 已经关了。 - Escape 要 stopPropagation:外面 InspectorSheet 也在听 Escape,不拦的话 按一下会连整个属性面板一起关掉。 - 光标前已经打了 | 或 [ 就不再弹——那时候是在写过滤器或下标,不是在选变量。 check-ui 补一组:变量表列得出来、抽屉挤压后画布没被压没(React Flow 容器 高度归零会直接报 error 004)、打 {{ 弹候选、插入成完整写法、光标位置正确。 --- frontend/src/canvas/Inspector.tsx | 17 +-- frontend/src/canvas/TemplateText.tsx | 149 +++++++++++++++++++++++++++ scripts/check-ui.mjs | 45 ++++++++ 3 files changed, 205 insertions(+), 6 deletions(-) create mode 100644 frontend/src/canvas/TemplateText.tsx diff --git a/frontend/src/canvas/Inspector.tsx b/frontend/src/canvas/Inspector.tsx index 26e4d7ee..a2917d17 100644 --- a/frontend/src/canvas/Inspector.tsx +++ b/frontend/src/canvas/Inspector.tsx @@ -5,6 +5,7 @@ import { NODE_DEFS, type FieldDef } from './nodeDefs' import { useStudio } from '../store/studio' import { useCatalog, modelOptions } from '../store/catalog' import { JsonInput } from '../components/ui' +import { TemplateText } from './TemplateText' /** 属性面板。所有字段都由 nodeDefs 的声明驱动渲染,加节点类型不用改这里。 */ export function Inspector() { @@ -165,23 +166,27 @@ function FieldInput({ field, value, onChange }: { /> ) + // 这三种默认都过模板渲染,所以带 {{ }} 补全。 + // 注意 field.template === false 是显式关闭——supervisor 的 agents[].system + // 长得和 llm.system 一模一样,但后端是 cfg.get("system") 直接取值,不渲染, + // 在那儿弹补全会是个谎 case 'textarea': case 'prompt': return ( -