Blume 2.0
Blume 2.0 将文档配置重构为模块化适配器体系,引入了专用的智能体发现设置,并提供了自动化升级工具支持,帮助开发者顺畅迁移现有文档站点。
Blume 2.0 将文档配置重构为模块化适配器体系,引入了专用的智能体发现设置,并提供了自动化升级工具支持,帮助开发者顺畅迁移现有文档站点。
产品用途与官方定位
Blume 2.0 是该文档框架的一次重大版本更新,在保留现有 Markdown 和 MDX 内容的同时彻底重构了站点配置。该更新使用从专用子路径导入的类型化适配器,取代了旧有的字符串选项与嵌套配置块,覆盖了部署托管、搜索引擎、内容源、分析工具、API 参考规范以及 AI 助手后端等各个方面。
该版本还通过将机器可读的 AI 元数据、Model Context Protocol 配置以及技能整合到专用的 agents 命名空间中,实现了现代化的可发现性。现有项目可以利用兼容 Codex 和 Claude Code 等自动化编程智能体的交互式命令行升级工具,全自动地推进并完成迁移流程。
有官方来源支持的使用场景
开发团队可以通过运行升级 CLI 来识别废弃的配置项、调整自定义组件重写,并顺利更新项目的整体配置架构规范。
企业与组织能够将来自本地代码库、Notion 工作区、Sanity、GitHub Releases 以及各类 API 规范的内容无缝汇聚整合至统一的服务端渲染或静态文档站点。
官网提供的使用流程
在项目根目录下运行升级命令行工具,自动提升依赖包版本并全面扫描配置文件以获取必要的调整项。
将 blume.config.ts 中的搜索、部署、内容源、API 参考、分析及助手配置块,转换为导入的适配器函数调用。
把 components.ts 中的内联函数与内部声明抽离为独立文件,并通过离散组件引用的方式将其重新导入。
执行 doctor 与 build 命令行指令,确保所有配置选项与组件绑定均能顺利通过各项验证且未出现错误。
Blume 2.0 在所有功能集成点上全面转向模块化适配器架构。开发者无需在 blume.config.ts 内部硬编码提供商字符串与凭据块,而是可以直接从 blume/search、blume/deploy、blume/sources、blume/reference、blume/analytics 和 blume/ai 等专用子路径导入对应的适配器函数。这种架构使面向 Vercel、Netlify、Cloudflare 和 Node.js 等平台的特定宿主输出得以显式声明,彻底移除了隐式的运行时服务端检测以及废弃的命令行构建标志。
为了简化升级与采纳流程,Blume 2.0 提供了基于 CLI 的自动化升级工作流。运行升级工具将深度检查 blume.config.ts、components.ts 以及 package 脚本,准确定位过时配置所在的文件位置并给出替换方案。该工具还可以调用 Codex 或 Claude Code 等编程智能体以交互方式自动修复迁移问题,最后通过内置的 doctor 与 build 诊断命令验证整个站点。
用自己的素材和工作流完成验证
核对了哪些信息以及核对时间
基于已核对产品资料的回答
在升级过程中,现有的 Markdown 和 MDX 页面不需要进行任何修改,因为 Blume 2.0 的变更主要集中在配置语法层面,并不会改动页面的内容结构。
在 Blume 1 中被忽略的 search.boost frontmatter 字段现已正式生效,它将直接作为乘数作用于该页面的搜索相关性排名计算中。
可以,在使用 upgrade 命令时附带 codex 或 claude 标志即可启动交互式智能体工作会话,自动定位并应用所需的配置文件修复操作。
所有组件条目现在必须是导入的组件、文件路径或具体的组件描述符对象,不再允许在文件内直接声明内联函数或进行内部局部定义。
原有的分散式独立参考配置块已被统一的 reference 数组取代,开发者可以通过传入 OpenAPI、AsyncAPI、GraphQL 和 Scalar 的专属适配器函数来进行配置。