This repository was archived by the owner on Nov 4, 2026. It is now read-only.
Repository navigation
This repository was archived by the owner on Nov 4, 2026. It is now read-only.
content/docs/plugins/plugin-view.mdx 整片示例的 object / viewMode / fields 键面在 ObjectViewSchema 上一个都不成立(#5077 的文档站镜像) #5088
Description
发现于 #5076 的实施(PR #5085)。Filed unassigned, not claiming。
读数取自 origin/main @ 03e5f972a160998a694742bd7c72149ae2fa3d8e。
现象
content/docs/plugins/plugin-view.mdx 的 Schema API 一节与其后每一个 object-view 示例(Grid View / Form View / Detail View、CRUD 四段、Field Configuration、Nested Objects、Tabs View、ObjectQL Integration、TypeScript Support)都建立在同一套非声明键上:
| 页面教的键 | ObjectViewSchema(packages/types/src/objectql.ts:1387)里的实情 |
|---|---|
object: 'users' |
无此键;必填的是 objectName(:1392) |
viewMode: 'grid' | 'form' | 'detail' |
无此键;视图类型是 defaultViewType |
fields: ['name', ...] |
无此键;列是网格配置,走 table.columns |
mode / recordId / fieldConfig / nestedFields / tabs / enableDelete / filters / searchable |
均非 ObjectViewSchema 声明成员 |
type: 'object-view' 本身是对的(packages/plugin-view/src/index.tsx:66 注册),所以渲染器会被解析到 —— 但它拿不到 objectName,读者照抄得到的是一个空视图,而不是一个报错。这比红框更难诊断。
为什么这是一张独立卡
- README 侧的同一条已在 plugin-view README 整片 schema 键面渲染器一个都不读 —— object / viewMode / fields / mode / recordId / fieldConfig 全非声明成员,照抄即空视图 #5077(
plugin-view README 整片 schema 键面渲染器一个都不读),但那单的完成范围是packages/plugin-view/README.md,不覆盖content/docs/**。与 plugin-form README 教三个不存在的导入:formComponents手动注册、FormSchema/FormField从本包导入 #5011 修 README 却没碰到 文档站上还有一份未修的 #5002 家族镜像:content/docs/plugins/plugin-{form,grid,view}.mdx 复制了同一段不存在的*Components手动注册 #5076 的文档站复制品是同一种边界,故独立立卡而非挂子 issue。 - 与 文档站上还有一份未修的 #5002 家族镜像:content/docs/plugins/plugin-{form,grid,view}.mdx 复制了同一段不存在的
*Components手动注册 #5076 / PR docs(plugins): 三个插件文档页按真实 register 键表重写虚构的*Components手动注册 #5085 不重叠:那单只动viewComponents注册段,本页示例键面一行未碰。 - PR docs(plugin-view): README 按真实导出面重写虚构的 viewComponents 手动注册,ObjectViewSchema 改从 @object-ui/types 导入 #5078(plugin-view README 教的
viewComponents手动注册不存在,ObjectViewSchema也不从本包导出 #5014)已把 README 的 TypeScript Support 一节改成真键面(objectName必填 /defaultViewType/table.columns),可直接作为本卡的键面基准。
复核方式
git grep -n "interface ObjectViewSchema" -- packages/types/src # objectql.ts:1387,紧接着 objectName: string(必填)
git grep -nw "viewMode" -- packages/plugin-view/src # 渲染路径零命中
门禁为什么没抓到
check-doc-component-types 只核 type 值是否被注册,object-view 注册了,故整页绿;该脚本头部明确把「snippet 的其它键是否被渲染器读」列为 objectui#4823 的第二维度、不在自己范围内。本卡是那第二维度。
分级
未打 finding 标签:照抄即空视图,是读者今天就撞得上的具体缺陷。交 PM 分诊。
Activity
yinlianghui commentedon Aug 17, 2026
立卡人补记(正文末尾 footer 被 issues 端点剥掉,改用评论补):本卡由 #5076 的 os-dev 席在实施 PR #5085 时扫出。该单派发边界是「只动三处
*Components注册段」,content/docs/plugins/plugin-view.mdx的示例键面一行未碰,故分离立卡。与 README 侧的 #5077 完成范围不覆盖。未认领。Generated by Claude Code
yinlianghui commentedon Aug 18, 2026
认领(PM 派发,objectui 分片):session_01GTRjn8xBqp75dk7kFupVRt,分支
claude/issue-5088-view-mdx-keys,os-dev 席即将开工。范围与合单声明:
content/docs/plugins/plugin-view.mdx+ changeset。import type从错误的包导入真实类型 —— 照抄即 TS2305(#5011/#5013/#5014 第二条的文档站镜像) #5086 的 view 三分之一:本页:263(行号有漂移)的import type { ObjectViewSchema } from '@object-ui/plugin-view'在 TypeScript Support 块内,与本卡键面重写同块 —— 按 content/docs/plugins/plugin-{form,grid,view}.mdx 三处import type从错误的包导入真实类型 —— 照抄即 TS2305(#5011/#5013/#5014 第二条的文档站镜像) #5086 口径(import 改指@object-ui/types真身,⛔ 不加 re-export)一并修,PR 用Fixes #5088+Part of #5086。content/docs/plugins/plugin-{form,grid,view}.mdx 三处import type从错误的包导入真实类型 —— 照抄即 TS2305(#5011/#5013/#5014 第二条的文档站镜像) #5086 至此仅余 form 处(plugin-form.mdx)。pagination同格同理 ——table.pagination不被 ObjectView 读,唯一分页读点是table.pageSize(ObjectView.tsx:846),接手席位直接复用该证据,勿再教table.pagination(见 plugin-view README 整片 schema 键面渲染器一个都不读 —— object / viewMode / fields / mode / recordId / fieldConfig 全非声明成员,照抄即空视图 #5077 的 PM 更正评论 5321781891 与ObjectViewSchema的table/form子配置类型零声明成员(Omit 被索引签名塌掉),且 ObjectView 的转发白名单钉在 ObjectGridSchema 的 legacy 键上 —— 规范键 pagination/selection/filter/sort 全部不读 #5102)。与在飞席位(plugin-grid.mdx、plugin-grid src、SchemaForm、plugin-dashboard.mdx)文件不相交。
Generated by Claude Code
docs(plugin-view): 文档站页面整片示例按 ObjectView 真读的键面重写 (objectstack-ai#5109)
docs(plugin-view): make the three Interactive Examples real object-vi…
docs(plugin-view): make the three Interactive Examples real object-vi…