用途:在 Astro 站点中配置 MDX 集成与内容集合(collection)及 schema,并记录允许使用的组件与内容来源。输入需读取 MDX 集成、集合、schema、imports 与内容来源信息;当实际路径与示例不同时,使用 .astrofy/config/paths.json 中定义的路径。应用在线文档中的 API 前,应先确认 lockfile 与 node_modules 中已安装的版本。
能力与执行要点:需区分已安装版本的集合 API 与其它主版本示例;MDX 可执行代码,因此只编译来源经授权的内容;确认集成与 Astro 兼容;按文章类型定义必填字段与限制;记录组件 imports 与用法示例;编译一个有效内容与一个无效用例,后者应指出出错文件与字段。集合与渲染使用 Astro 现行 MDX 与 Content Layer 流程。
具体步骤:在 src/content.config.ts 中定义 loader、schema 与集合;编译一条有效条目和一条 frontmatter 无效的条目;将 MDX imports 限制为项目批准的组件;测试正文渲染与派生字段在 HTML 中的输出。若改动既有实现,需映射旧字段且不改变其含义,迁移整个内容库前先校验单条条目并登记允许的组件。验证方式:缺少必填字段时应指出无效条目,同一文件修正后应能在 HTML 中渲染 MDX 组件;schema 应拒绝无效 frontmatter,且内容来源需被记录。可使用命令 astrofy check --category mdx 检查。限制:资料未提供更详细的版本要求、组件清单或平台收费信息。