用途:让 Fumadocs UI 的两个变体 packages/radix-ui(fumadocs-ui)与 packages/base-ui(@fumadocs/base-ui)保持一致。两者共享相同的布局结构、组件与公共 API,仅底层 primitives 不同,因此改动其中一个包时应同步考虑另一个。
包身份:radix-ui 包名为 fumadocs-ui,使用 @radix-ui/* primitives,配置键为 uiLibrary: 'radix-ui';base-ui 包名为 @fumadocs/base-ui,使用 @base-ui/react primitives,配置键为 uiLibrary: 'base-ui'。
需要同步的内容:布局 layouts/docs、layouts/flux、layouts/home、layouts/notebook、layouts/shared,结构和 props 应一致,仅 primitive 用法不同;组件 components/ 下的公共 API 与行为应一致,例如 toc、steps、sidebar/page-tree、dialog/search 行为,而 components/ui/ 中的 UI primitives 按设计允许不同;provider/base.tsx 的 props 相同,仅 DirectionProvider 及 search/dialog primitives 不同;contexts、utils、i18n、mdx、og 应保持相同或近乎相同;package.json 的 exports 结构与版本相同,依赖不同(Radix 与 Base UI)。
适用场景:编辑上述任一包、增加特性或修复缺陷时,用于检查另一变体是否需要相应改动。限制:资料未提供具体安装命令、运行步骤或验证方式。