ARTICLE · 1305346

文档不只给人看了:Cloudflare 开源了一个同时服务读者和 AI 的工具

发布时间：2026-11-04 11:15:58 最近访问：2026-11-04 11:16:00

很多产品都有一个尴尬问题：功能更新得很快，使用文档却总慢半拍。

现在有了 AI，写初稿似乎容易了。但新的麻烦也跟着出现：AI 会写错链接、乱用组件、漏掉必要说明，还可能把一篇“看起来完整”的草稿直接推到线上。

Cloudflare 开源的 Nimbus，盯上的就是这件事。它不是一个替你生成几段文字的聊天工具，而是一套用来搭建和维护文档网站的系统。人可以写，AI 编程助手也可以写，但两者都要遵守同一套规则。

项目地址：https://github.com/cloudflare/nimbus

官网：https://nimbus-docs.com

一份内容，给两类读者

Nimbus 基于 Astro 构建。作者用 Markdown 或 MDX 写页面，发布时会生成普通读者看到的网页，同时为每个页面生成干净的 Markdown 版本，并提供 llms.txt 和 llms-full.txt。

这意味着，同一份文档不必再准备“网页版本”和“喂给 AI 的版本”。人可以照常点击目录、搜索和阅读代码示例；AI 工具则可以直接抓取结构更清楚的文本，不必从复杂网页里猜正文在哪里。

如果开启可选的远程 MCP 服务，Agent 还可以调用 list_pages 和 get_page 查询文档。Nimbus 也支持给浏览器 Agent 暴露搜索工具。不过，远程 MCP 需要服务器适配器和额外的 MCP SDK，不是创建项目后自动拥有的云服务。

Nimbus 为页面生成 Markdown、llms.txt 和 MCP 入口的说明

AI 可以写，但不能跳过检查

Nimbus 真正有意思的部分，不是“AI 也能读”，而是它把文档当成代码来管理。

nimbus-docs check 会检查项目配置、页面结构、组件和待处理升级；nimbus-docs lint 则可以按团队设定的规则检查标题、裸链接、内部链接等写作问题，并输出适合 Agent 读取的 JSON。部分能够安全修改的问题还能自动修正。

换句话说，团队可以先告诉 AI：文档放在哪里、页面怎么组织、哪些规则必须遵守。AI 生成草稿后，再跑一遍检查，最后仍由人审核。Nimbus 官网强调“没有人工确认就不发布”，核心思路很朴素：让 AI 加快写作，而不是替人承担发布责任。

这对维护帮助中心、开发者文档或内部知识库的团队，比单纯增加一个 AI 写作按钮更实用。人和机器写出来的页面，至少要过同一把尺子。

网站代码归你，不被模板锁住

Nimbus 创建项目时，会把布局、组件、样式、路由和内容文件都放进你的仓库。你可以直接修改它们，而不是只能在某个托管平台提供的后台里选主题。

它还提供组件 Registry。需要步骤条、标签页、文件树等界面时，可以把组件源码复制进项目；更复杂的功能，则可能以普通 Markdown“配方”交给编码 Agent 执行。项目仍然保留在自己的仓库里。

除了常规文档，Nimbus 还能根据 OpenAPI 3.x 生成 API 参考页面，也能从其他 Git 仓库或 Notion 读取内容。默认构建结果是静态网站，可以放到任何支持静态文件的托管服务上；需要按请求渲染或远程 MCP 时，才要配置 Cloudflare、Netlify、Vercel 或 Node 等服务器适配器。