metadata-admin previews 仍在读取 spec 已拒收的键(AgentPreview/SkillPreview/AppPreview/DatasourcePreview),预览会为一份存不下去的草稿画出「正常」界面

[xuyushun441-sys]

在做 objectui#3266(把 8 个 preview 样例改成能过 ObjectStackSchema.safeParse())时,发现样例改对之后画廊反而少画了东西 —— 因为几个 preview 读的是 spec 现在明确拒收的键。这与 objectui#3236 / PR #3258 修 ToolPreview 是同一件事的其余部分:预览渲染一个保存时会被拒的键,等于告诉作者「这样写是对的」,而这正是预览存在的反面。

packages/app-shell/src/views/metadata-admin/previews/ 下,#3266 逐条实测到的:

文件	读的键	spec 现状
AgentPreview.tsx	d.tools(渲染 TOOLS 芯片)、d.knowledge(渲染 KNOWLEDGE (RAG) 区块)	均为 retiredKey() 墓碑,objectstack#3894 / #3896 —— AgentSchema 按名字报错
SkillPreview.tsx	d.triggerPhrases(渲染 TRIGGER PHRASES 区块)	retiredKey() 墓碑,objectstack#3896
AppPreview.tsx	landingRoute ?? landing ?? defaultRoute;每项 it.path ?? it.href ?? it.route ?? it.url;kind 靠 it.object/it.dashboard 推断	landing 已被 objectstack#4001 移除(替代是 homePageId);navigation 是按 type 的判别联合且每支 .strict(),根本没有 path / object / dashboard 这些键
DatasourcePreview.tsx	capabilities 只认数组(Array.isArray(d.capabilities) ? … : []);driver 有 ?? d.type 回退	DatasourceSchema 是 .strict():capabilities 是对象(DatasourceCapabilities),type 直接被拒(别名提示 type → driver)

另外 SkillPreview 的 trigger-conditions 表读 cond.expression ?? cond.value,而 SkillTriggerConditionSchema 的形态是 { field, operator, value } —— 合规草稿在表里只能显示出 value 一列(实测显示成 COND | sales_order),field 和 operator 看不见。

实测到的可见后果(#3266 改样例前 → 改后,同一个画廊)

• agent:TOOLS: query_orders / lookup_company + KNOWLEDGE (RAG): sales_playbook → TOOLS 空态、KNOWLEDGE 区块消失(样例已按裁决删键,预览无处可读)
• skill:TRIGGER PHRASES (2) 区块 → 消失
• app:每项下面的 /apps/crm/accounts 路径行 → 消失;Dashboard 的 kind 徽标从 dashboard 退化成 item;Landing: /apps/crm/home → Landing: /(homePageId: 'home' 没人读)
• datasource:CAPABILITIES: read / aggregate 区块 → 消失(对象形态不被 Array.isArray 认)

也就是说:今天画廊里好看的那部分,有一截是靠不合规的样例喂出来的。

建议

按 AGENTS.md #0.1(contract-first,修生产者不修渲染器)与 #3258 的先例:

1. 删掉对已退役键的读取路径(tools/knowledge/triggerPhrases),而不是保留;
2. AppPreview 改为读 type 判别键 + objectName/pageName/dashboardName/url,landing 改读 homePageId(它是 nav item 的 id,不是路由字符串),路由由 shell 从元数据推导;
3. DatasourcePreview.capabilities 改按对象渲染(展示为 true 的能力名),去掉 driver ?? d.type 回退;
4. SkillPreview 的 trigger-conditions 表按 field / operator / value 三列渲染。

这些 ?? 回退正是 AGENTS.md #0.1 说的「宽容消费者」:它们让 AI 生成的过期元数据在设计器里看起来是对的,直到发布时才被拒。

相关

• objectui#3266(样例侧已修完,本单是渲染器侧的另一半)
• objectui#3236 / PR fix(app-shell): ToolPreview 不再渲染已退役的 ToolSchema 标记徽标 (#3236) #3258(ToolPreview 的同型修复,可直接照抄做法)
• objectstack#3894、objectstack#3896、objectstack#4001、objectstack#4158

⚠️ 未指派 —— 由 #3266 顺带发现并记录(Prime Directive #10),不在那个 PR 里修:scope fence 是 apps/console,本单全在 packages/app-shell。

[xuyushun441-sys]

认领:PM 循环第 5 轮
会话:session_01NVPjPzmmAJ2Ngtvgg5MSRa(objectui 分片 PM,账号 xuyushun441-sys)
分支:claude/issue-3275-previews-drop-retired-keys
Worktree:objectui-issue-3275

分诊:无需拍板,且前置已落地

#3266(PR #3277,已合并 03895a8f1)把样例改对了,本单是同一件事的渲染器那一半。所有键的退役裁决在上游都已完成(objectstack#3894 / #3896 / #4001 / #4158),ToolPreview 的同型修复(#3236 / PR #3258)已是现成先例 —— 照抄做法即可,没有需要维护者选的选项。

这单的价值:今天画廊里好看的那部分,有一截是靠不合规样例喂出来的

#3266 的浏览器实测已经把后果拍下来了:样例改对之后,agent 的 TOOLS / KNOWLEDGE 区块、skill 的 TRIGGER PHRASES、app 的路径行、datasource 的 CAPABILITIES 全部消失或退化。原因不是样例改坏了,而是这些预览读的键 spec 已经拒收 —— 预览与样例此前是"一起错"才看起来正常。

这正是 AGENTS.md #0.1 说的宽容消费者:?? 回退让 AI 生成的过期元数据在设计器里看起来是对的,直到发布时才被拒。预览的职责恰恰相反 —— 它应该让作者当场看见自己写错了。

派发范围(四个文件,单子已给出逐条修法)

1. 删对已退役键的读取(AgentPreview 的 tools/knowledge、SkillPreview 的 triggerPhrases)—— 删,不是保留兜底;
2. AppPreview:改读 type 判别键 + objectName/pageName/dashboardName/url;landing 改读 homePageId(⚠️ 它是 nav item 的 id,不是路由字符串,别当路径渲染);
3. DatasourcePreview:capabilities 按对象渲染(展示为 true 的能力名),去掉 driver ?? d.type 回退;
4. SkillPreview 的 trigger-conditions 表按 field / operator / value 三列渲染(现在合规草稿只能显示出 value 一列)。

验收要求

• 必须浏览器验证,并给出 before → after。本仓有 verify skill 与预览画廊(?only=<type> 可隔离单个设计器),console preview-samples: 除 tool 外还有 11 个样例过不了对应的 spec schema(其中 4 个同样带已退役的键) #3266 刚用它做过同样的事,照它的做法。修完之后,画廊应当重新显示出 console preview-samples: 除 tool 外还有 11 个样例过不了对应的 spec schema(其中 4 个同样带已退役的键) #3266 记录里"消失"的那些内容 —— 那是本单成功的判据,静态测试证明不了。
• 每个改动的预览补一条断言:喂一份合规草稿,断言对应区块渲染出来;喂一份带退役键的陈旧草稿,断言不渲染。fix(app-shell): ToolPreview 不再渲染已退役的 ToolSchema 标记徽标 (#3236) #3258 的 ToolPreview.test.tsx 是现成模板。

⚠️ scope fence:packages/app-shell/src/views/metadata-admin/previews/。本轮同批占用 apps/console(#3276)与 .github/workflows + scripts/(#3274),另有一个 agent 在 packages/components(#3263)。

---

Generated by Claude Code