用途:围绕共享字段元数据,构建 Docyrus 记录的创建、编辑与详情体验,覆盖标准表单页、手动布局、行内编辑等场景。
主要能力与构建模式:标准创建/编辑/查看记录页使用 useDocyrusFormView,它处理元数据加载、条目加载、选项水合、字段渲染与提交行为;自定义手动表单或详情布局使用 DynamicFormField、DynamicValue 或 useDocyrusFieldComponent;行内编辑、点击编辑详情行或逐字段编辑使用 EditableRecordDetail 与 EditableValue。复杂查询、schema 或 API 工作需同时加载 docyrus-api-dev 或 docyrus-app-dev-react;字段类型映射或不支持字段的决策参考 field-type-mapping-and-fallbacks。
默认工作流:确认 appSlug、dataSourceSlug、mode,以及记录已存在时的 itemId;决定页面采用 hook 优先还是完全手动;让可编辑字段与只读渲染器共用同一字段类型注册表;在页面完成前水合枚举、用户与关系选项;验证创建、编辑、查看、重置与保存行为;若支持行内编辑,验证 money、phone、status 等复合类型的伴随字段保存。
限制与要求:标准创建/编辑/查看页优先用 useDocyrusFormView;手动可编辑布局应使用 DynamicFormField、特定表单字段组件或 useDocyrusFieldComponent(..., 'form-field');手动只读布局应使用 DynamicValue、特定值渲染器或 useDocyrusFieldComponent(..., 'value-renderer');不要另写逐字段 switch 语句。手动获取 Docyrus 条目必须传 columns,useDocyrusFormView 会自动派生含伴随列。复合字段读写可能需伴随键,手动保存流程须保持完整。字段无可编辑组件时,创建模式通常跳过,编辑/查看模式通常回退到值渲染器。具体安装命令与代码示例暂未提供。