DocFlare AI Vibe 项目

项目简介

DocFlare AI 是一套 100% 跑在 Cloudflare 免费套餐上的开源文档站 AI 搜索与问答挂件：往文档站里插一个 `` 标签，就能得到一个带来源引用、流式输出的 RAG 聊天机器人——不需要 OpenAI Key，不需要 Pinecone，不需要自己的服务器，也不产生账单。官方对标 Chatbase、CustomGPT、Mendable 这类每月收费 20~400 美元的"文档问答"托管服务，指出它们的底层无非是爬虫、嵌入模型、向量库与 LLM 四件事，而 Cloudflare 恰好把这四件事全部免费提供。

核心功能

1. 一行标签嵌入：`` 即可接入，原生 JS + Shadow DOM，体积小于 10KB、零依赖、不污染宿主站点样式。
2. 流式回答带来源：基于 Server-Sent Events 流式输出，答案附来源卡片（source chips），并以提问者所用语言回答。
3. 站点地图爬虫：支持 sitemap 索引与 gzip 压缩 sitemap，用 Cloudflare 原生 HTMLRewriter 剥离导航、页头、页脚等样板内容。
4. 章节感知切分：标题开启新块，避免"开源"卡片被埋进定价段落；每块约 350 token、40 token 重叠，按脚本估算 token 长度，保证越南语/中日韩页面不超出嵌入模型 512 token 窗口。
5. 两阶段检索：先取 20 条向量候选，再用 bge-reranker-base 交叉编码重排，只把真正回答问题的段落交给 LLM——仅词汇相似但答非所问的页面（如法务页里的产品名）会被过滤掉。
6. 多站点多租户：单次部署可服务多个文档站，各自独立 Vectorize 命名空间并锁定自有域名。
7. 内置管理后台：/admin 页面注册 sitemap、看索引进度、跑批次、重爬、删站、复制嵌入代码、浏览用户最近提问。
8. 聊天记录落库：对话存入 D1，方便你发现"用户老问什么、文档缺什么"。

技术实现

整套系统是一个 Cloudflare Worker，用 Hono 路由、TypeScript 端到端、严格类型无 any，工具链与测试用 Bun。各组件全部落在 Cloudflare 免费额度内：Workers + Hono 承担 API 与爬虫（10 万请求/天）；Workers AI 提供嵌入与生成（bge-small-en-v1.5 嵌入、bge-reranker-base 重排、llama-3.1-8b-instruct-fp8 生成，1 万 neurons/天）；Vectorize 存 384 维余弦向量（500 万存储维、3000 万查询维/月）；D1（SQLite）存元数据与聊天记录（5GB、500 万读/天）；Cron Triggers 驱动后台索引；静态资源承载挂件。免费额度安全是设计出来的：索引以小批次可续跑方式进行（定时 + 按需），检索无相关内容时直接跳过 LLM，AI 限流时优雅降级。挂件支持深/浅/跟随主题、自定义强调色、左右位置与键盘操作。

快速上手

1. 点仓库里的 "Deploy to Cloudflare" 按钮（或 bun run deploy）把 Worker 部署到你自己的 Cloudflare 账号。
2. 首次部署后执行 bun run db:migrate 建 D1 表结构（migrations 新增文件时需重跑）。
3. 打开部署出来的 https://docflare-ai..workers.dev/admin，粘贴 admin token，用 "Register / re-index a site" 表单注册你的文档站 sitemap，点 "Index all pending" 索引到队列清空。
4. 把 <script src="https://docflare-ai..workers.dev/widget.js" data-site-id="..."> 贴进文档站页面，即可看到带来源的流式问答；进度条与最近提问都在同一后台查看。

适用场景

1. 开源项目文档站：读者直接问"怎么配置 X"，答案带原文出处。
2. SaaS 产品帮助中心：降低客服重复答疑量，后台提问日志反哺文档补缺。
3. 内部知识库：团队 Wiki 接入后用自然语言检索制度与技术文档。
4. 多产品矩阵官网：一次部署、多租户隔离，同时服务多个子产品文档。

适用人群

独立开发者与小团队（不想为文档问答付每月数十美元）、已有 Cloudflare 账号的站点运维者、重视数据主权希望自托管 RAG 的技术团队。

出品方

开源项目 p10node/docflare-ai，MIT 协议，由社区维护；构建产物与依赖全部为 Cloudflare 原生服务与开源组件（Hono、Bun 等）。

更新动态

2026-10-08 以 "Show HN: DocFlare AI – Open-source docs chatbot on Cloudflare's free tier" 登陆 Hacker News，截至发稿 10 点热度；同日 A 线监控收录，按"仅 GitHub 仓库、无独立产品官网"归入 B 线。

官方链接

• 开源仓库：https://github.com/p10node/docflare-ai