Blume
Blume(useblume.dev)是一个开源(MIT)的「面向人与智能体的文档框架」,基于 Astro,由 Hayden Bleasel 开发(GitHub 约 1743 stars,npm 包 blume)。它不只是给人看的文档站,而是从底层为编码 agent 优化:每次构建自动生成 llms.txt 与 llms-full.txt,每个页面都有 .md Markdown 孪生并支持 Accept 内容协商,并提供可选的 MCP server 让 agent 直接搜索/读取你的文档、可发布 agent skills。它被 is-agentic.com(Vercel)评为 100/100、isitagentready.com(Cloudflare)80/100,均高于 Mintlify、Fumadocs 等同类,是少见的 agent-native 文档基建。完全免费开源、可自托管。
核心功能
- ✓ RAG检索增强
- ✓ 智能体
- ✓ 知识库
- ✓ 开源
- ✓ 提供API
👍 优点
- + 真正「agent-native」的文档框架:不只给人看,还专为编码 agent 设计——可选 MCP server 让 agent 直接搜索/读取你的文档,并能把 agent skills 发布到 agent 会去查找的位置,是少见的从底层为智能体优化的文档栈
- + 开箱即有的机器可读层:每次构建自动生成 llms.txt 与 llms-full.txt 索引与全文,每个页面都有 .md Markdown 孪生并支持 Accept: text/markdown 内容协商(Vercel/Cloudflare 构建),让 LLM 取正文零额外处理
- + 被权威 agentic 扫描双重高分背书:is-agentic.com(Vercel)100/100、isitagentready.com(Cloudflare)80/100,均高于 Mintlify、Fumadocs 等同类,证明其「可被 agent 消费」的程度领先
- + 开源 + 生态成熟:MIT 许可(GitHub 1.7k+ stars),基于 Astro、有 npm 包 blume,作者 Hayden Bleasel 在 indie 工具圈有口碑;可自托管、可改、可融入现有站点
- + 面向开发者体验好:保留人类可读的优质文档体验(组件、OpenAPI 渲染、视图过渡等)同时补齐机器可读,不必在「给人」和「给 agent」之间二选一
👎 缺点
- - 定位偏开发/文档基建,非通用内容工具:主要价值在「让你的文档被 agent 读懂」,对只想写普通文档、不接 agent/MCP 的团队,额外能力用不上
- - MCP server 等 agent 能力是 opt-in:要真正让 agent 用起来需自行开启 MCP、配置 skills 与部署,开箱并不自动「被所有 agent 发现」
- - 较新、生态与案例仍在积累:相较 Docusaurus/Mintlify/Fumadocs 等成熟文档框架,Blume 的模板、插件、社区方案与大规模落地案例还少,踩坑需自解
- - 强绑定 Astro 技术栈:基于 Astro 构建,若你的站点不是 Astro 体系,接入成本与迁移成本不低
- - 价值依赖外部 agent 生态:其「agent 可读性」收益取决于下游编码 agent 是否真去调用 MCP/llms.txt,若你的用户不用这类 agent,回报有限
适合人群
最适合: 要构建「既给人看、也给 AI agent 读」文档的团队与开发者:技术文档站、API 文档、内部知识库,希望编码 agent(通过 MCP/llms.txt)能直接检索与引用你的内容;已用或愿用 Astro 体系、想用成熟开源框架(MIT、1.7k+ stars)自建文档的人;追求「agent 可读性」、想被 is-agentic/isitagentready 这类扫描高分、让产品在 agent 时代可被发现的团队;做开发者平台/SDK、需要把文档当作 agent 上下文来源的 indie 开发者与公司(如 Hayden Bleasel 生态用户)。
不适合: 只想写普通文档、完全不接 agent/MCP 的团队——Blume 的 agent-native 能力对你用不上,Docusaurus/Mintlify 等更省心;非 Astro 技术栈、不愿迁移或承担接入成本的人;要开箱即被「所有 agent 自动发现」的人——MCP server 与 skills 是 opt-in,需自己开启与部署;需要大量现成模板/插件/商业支持与大规模落地案例的成熟企业——Blume 仍较新、生态在积累;把 Blume 与同名花卉/品牌混淆、实际要别家的人。