Repository navigation
docs(protocol): widget-contract.mdx 仍在教 PerformanceConfig —— 该 schema 已被 #3896 删除 #4996
Description
路过发现,不在 #4876 范围内,按 Prime Directive #10 立案不指派、不顺车修。
现象
content/docs/protocol/objectui/widget-contract.mdx:309(「Performance」小节)逐字写着:
Performance tuning is supplied through the shared
PerformanceConfigschema (packages/spec/src/ui/responsive.zod.ts) on the manifest'sperformancefield. Use it for options such as virtualization and lazy rendering for widgets that handle large datasets.
而它指向的那个 schema 已经不存在了。packages/spec/src/ui/responsive.zod.ts:110 现在是一条墓碑注释:
REMOVED — `PerformanceConfigSchema` / `PerformanceConfig` (#3896 audit …
packages/spec/src/ui/responsive.test.ts:90 同样记着「PerformanceConfigSchema tests removed with the schema (#3896 close-out)」。#3896 那次 sweep 一并退役了 view.performance / dashboard.performance / dashboard.widgets[].performance。
该文件不是生成物(packages/spec/scripts/ 里没有任何生成器写它),所以没有闸门会自动纠正它 —— 这也是它能活下来的原因。
为什么值得修
这段话把一个已删除的 schema 描述成「共享的、可用的」,还给出了它当年所在的确切文件路径。照着读的作者(很可能是 AI,ADR-0033)会去 import 一个 v17 里 TS2305 的名字,或者在 manifest 上写一个没有任何东西会读的 performance 字段 —— 正是 ADR-0049 想消灭的「声明 ≠ 兑现」。
需要决定的地方(所以没有直接改)
「manifest 的 performance 字段」说的是 objectui 的 widget manifest 契约,不一定等同于被 #3896 退役的那三个 spec 键。所以正确处置有两种,取决于 objectui 侧那个 manifest 字段今天是否还活着:
- 若已随 spec 一起消失 → 整节删除(与
POST /data/sharing/rules绕过SharingRuleSchema:criteria缺失或拼错静默变成"共享该对象全部记录",与 ADR-0049 "never seeded as a permissive match-all" 直接冲突 #3896 删掉dashboards.mdx里performance行的做法一致); - 若 objectui manifest 仍有自己的
performance→ 保留本节,但改成指向 objectui 自己的类型,并明确它不是 spec 的共享 schema。
需要 objectui 分片确认一句再动笔,不宜由本仓单方面猜。
复现
grep -n 'PerformanceConfig' content/docs/protocol/objectui/widget-contract.mdx
grep -n 'PerformanceConfigSchema' packages/spec/src/ui/responsive.zod.ts发现于 #4876(退役 dashboard.widgets[].responsive)的文档面清扫;基线 objectstack@c5adfe15a6。
Generated by Claude Code
Activity
xuyushun441-sys commentedon Aug 4, 2026
认领(PM 分派)
session_018iARDqtrhQgz6fVHDeDkbQclaude/issue-4996-widget-contract-performanceconfigdomain:devx(落点content/docs/protocol/objectui/widget-contract.mdx)与在飞 #5017(packages/lint)落点互斥。参照今日 #4832 的先例:先核实前提是否仍成立(该页可能已被别的 PR 顺手改过),已解决就报告建议关单,不硬造 PR。
Generated by Claude Code
xuyushun441-sys commentedon Aug 4, 2026
审核通过 — PR #5023 已取消草稿并挂上 auto-merge(SQUASH)
处置是议题没列的第三选项 rewrite,且议题的阻塞问题当场消解:议题把选择框成"删除段落 vs 指向 objectui 的类型、待 objectui 分片确认",实测
WidgetManifestSchema就在本仓packages/spec/src/ui/widget.zod.ts:273—— 两个选项都不适用,也无需跨仓确认。证据比"已删"更强:
widget.performance是retiredKey(z.never()+ 报错文案)—— 手写文档此前不是在提一个死名字,是在教作者写一个会硬失败校验的键。生成参考页(references/ui/widget.mdx:113)早写着[REMOVED] ... Delete the key.,与手写页对同一键指令相反 —— #4914 形态,已收敛,生成页是对的那侧。改写保留了段落位置(virtualization 的真实需求活在 view 级virtualScroll),加 warn callout 与生成页措辞呼应,防迁移作者回填。关联引用(layout-dsl.mdx 的过时描述)一并修;历史记述按 #4832 标准全部保留(tombstone/CHANGELOG/changeset/ADR/audits/skill 共 11 处逐一核过)。七道文档门禁绿。
dev 顺带核出一个当前无实例的门禁盲区(spec 的 tsconfig 排除 test 文件,test-only 的悬空 type import 不会被 typecheck 抓,esbuild 会擦除),无现行受害者故未立单 —— 记录在此,若将来撞见实例,这里有出处。
Generated by Claude Code
docs(protocol/objectui): widget-contract 不再教已删除的 PerformanceConfig (o…