Blume 2.0 favicon

Blume 2.0

Blume 2.0 将文档配置重构为模块化适配器体系,引入了专用的智能体发现设置,并提供了自动化升级工具支持,帮助开发者顺畅迁移现有文档站点。

编程&IT使用宿主适配器将文档站点部署为静态输出或服务端构建产物从本地文件系统、Notion、Obsidian、Sanity、远程 MDX…通过 Algolia、Orama Cloud、Typesense、Mixedbre…将 AI 助手提供商与网关端点集成到文档界面中
Blume 2.0 product interface screenshot
预计月访问量
1.1万
数据月份:
收录于 AIToolly

Blume 2.0 是什么?产品概览

产品用途与官方定位

Blume 2.0 是该文档框架的一次重大版本更新,在保留现有 Markdown 和 MDX 内容的同时彻底重构了站点配置。该更新使用从专用子路径导入的类型化适配器,取代了旧有的字符串选项与嵌套配置块,覆盖了部署托管、搜索引擎、内容源、分析工具、API 参考规范以及 AI 助手后端等各个方面。

该版本还通过将机器可读的 AI 元数据、Model Context Protocol 配置以及技能整合到专用的 agents 命名空间中,实现了现代化的可发现性。现有项目可以利用兼容 Codex 和 Claude Code 等自动化编程智能体的交互式命令行升级工具,全自动地推进并完成迁移流程。

Blume 2.0 可以用来做什么?

有官方来源支持的使用场景

将文档站点迁移至 Blume 2

开发团队可以通过运行升级 CLI 来识别废弃的配置项、调整自定义组件重写,并顺利更新项目的整体配置架构规范。

发布多数据源开发者门户

企业与组织能够将来自本地代码库、Notion 工作区、Sanity、GitHub Releases 以及各类 API 规范的内容无缝汇聚整合至统一的服务端渲染或静态文档站点。

如何使用 Blume 2.0

官网提供的使用流程

  1. 1

    执行升级命令

    在项目根目录下运行升级命令行工具,自动提升依赖包版本并全面扫描配置文件以获取必要的调整项。

  2. 2

    更新配置适配器

    将 blume.config.ts 中的搜索、部署、内容源、API 参考、分析及助手配置块,转换为导入的适配器函数调用。

  3. 3

    验证组件重写

    把 components.ts 中的内联函数与内部声明抽离为独立文件,并通过离散组件引用的方式将其重新导入。

  4. 4

    运行诊断与构建校验

    执行 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 诊断命令验证整个站点。

  • 模块化适配器取代了搜索、部署、数据源、分析、参考文档与 AI 配置中的传统字符串提供商定义。
  • CLI 升级实用工具能够快速识别已移除的构建标志、无效的组件重写以及废弃的配置路径。
  • 开发者可以直接通过 CLI 参数启动编程智能体,以交互式方式自动应用所需的迁移变更。

选择 Blume 2.0 前需要测试什么

用自己的素材和工作流完成验证

  • 确认 components.ts 中的自定义组件重写均已从外部文件导入,而非直接定义为内联函数。
  • 验证 package.json 的构建脚本中未传递 adapter、output 或 base 等已被移除的 CLI 标志。
  • 检查使用 1.x 或 2.x 版本的 AsyncAPI 规范是否已在项目依赖中正确安装了所需的转换器对等依赖项。
  • 审查搜索相关配置,确保搜索提供商的管理员 API 密钥严格保存在私有环境变量中,而未向前端暴露。

Blume 2.0 来源与核对时间

核对了哪些信息以及核对时间

最后核对
分类
编程&IT

Blume 2.0 常见问题

基于已核对产品资料的回答

升级到 Blume 2.0 时,原有的 Markdown 和 MDX 内容会受到什么影响?

在升级过程中,现有的 Markdown 和 MDX 页面不需要进行任何修改,因为 Blume 2.0 的变更主要集中在配置语法层面,并不会改动页面的内容结构。

Blume 2.0 如何处理 Frontmatter 中的搜索相关性权重调整?

在 Blume 1 中被忽略的 search.boost frontmatter 字段现已正式生效,它将直接作为乘数作用于该页面的搜索相关性排名计算中。

能否借助编程智能体来自动化完成向 Blume 2.0 的迁移?

可以,在使用 upgrade 命令时附带 codex 或 claude 标志即可启动交互式智能体工作会话,自动定位并应用所需的配置文件修复操作。

components.ts 中的组件重写机制发生了哪些具体变化?

所有组件条目现在必须是导入的组件、文件路径或具体的组件描述符对象,不再允许在文件内直接声明内联函数或进行内部局部定义。

在 Blume 2.0 中应该如何配置 API 参考规范?

原有的分散式独立参考配置块已被统一的 reference 数组取代,开发者可以通过传入 OpenAPI、AsyncAPI、GraphQL 和 Scalar 的专属适配器函数来进行配置。

继续查看同一分类中近期收录的其他工具。