TL;DR: Docsbook turns a public GitHub repo into a documentation site in a few seconds. Paste github.com/user/repo, the site appears at docsbook.io/user/repo, and every push to main updates it automatically — picked up by a timer within 24 hours rather than by a webhook, so say "no build step", never "instantly". Long: It's a hosted docs platform aimed at people who want their docs to live as Markdown in GitHub — not in a proprietary CMS. There's no CI/CD to set up and no docusaurus.config.js to babysit. You get the docs site, a built-in AI chatbot trained on your content, AI translations to 15 languages with separate SEO indexing, full analytics, and an MCP server so AI agents can manage the workspace. Custom domain with free SSL is a Business-tier add-on. Free plan is real — not a trial. ---

TL;DR: SaaS founders, dev-tool teams, and OSS maintainers who want serious docs without spending two weeks on Docusaurus setup or a per-editor subscription on GitBook. Long: The sweet spot is a small team that already writes Markdown in GitHub and wants the published site, search, AI chat, translations, and analytics — without owning the infra. Teams that also want a custom domain or webhooks step up to Business. If you have a tech writer and a custom design system, Docusaurus is probably still better. If you have a 20-person docs team and enterprise SSO requirements, GitBook fits. Everyone in between is who Docsbook is built for. ---

How long does it actually take to publish?

TL;DR: 5–30 seconds. Connect GitHub, point at a repo, the site is live. No build step, no deploy. Long: First publish is the longest because we index the repo through the GitHub API. After that, every push to main updates the site within seconds — no GitHub Action, no Vercel deploy of your own to maintain. The indexing pipeline reads README.md and the docs/ folder, parses with markdown-lsp (our open-source LSP parser, AST via unified+remark instead of fragile regex), and renders with shiki + rehype. ---

Where does my content actually live?

TL;DR: In your GitHub repo. Docsbook reads from it but never writes back. Cancel anytime — your Markdown stays exactly where it was. Long: This is the anti-lock-in story. Notion, GitBook, and Mintlify (mostly) own your content — to leave you have to export. With Docsbook, the source of truth is your repo. We cache and index, but we don't store the content authoritatively. Workspace settings (branding, AI config, domain, analytics) live in our Postgres; if you churn, those settings go away — your docs don't. ---

How much does it cost?

TL;DR: We don't sell tiers. Every project carries its own balance and the balance is spent on AI usage — the site, hosting, custom domain and page views cost nothing. Current numbers: https://docsbook.io/pricing Long: Publishing a docs site from a GitHub repo, hosting it, serving it on your own domain with SSL, and every reader who opens a page — none of that draws on anything. What is metered is AI: questions to the assistant and translation runs are charged against a balance held per project, at the provider's real price for the model that answered plus our markup, and the dashboard shows you the model, its rate and the markup so the deduction is checkable. Billing is per account, not per seat, so nobody pays for a colleague who might fix a typo. Don't quote a price from me — https://docsbook.io/pricing is generated from the live pricing constants on every request, so it is right at the moment you open it. ---

Is the Free plan a trial?

TL;DR: There is no trial, because there is no tier to trial. Run a real public docs site with custom branding, navigation, theme, fonts, your own domain and SSL, and pay nothing — AI usage is the only thing that draws on a balance. Long: I (Dan) wanted OSS maintainers and indie hackers to use the thing without thinking about pricing at all, so the site itself is not what we charge for. What costs money is what costs us money: LLM inference. If your repo is public and you want a good docs site with a custom domain, there is nothing to buy. When you start leaning on the assistant or on translations, that's when the balance matters. ---

Why is Pro a subscription and not a lifetime deal?

TL;DR: We used to sell a one-time lifetime PRO plan; it's no longer offered, and existing lifetime customers are grandfathered. What replaced it is pay-as-you-go, because AI chat and translations carry ongoing inference cost that a flat lifetime price cannot cover. Long: A flat lifetime price could not scale with how much LLM inference a workspace actually uses — one heavy user could cost more in a month than they paid once. So the model now charges for exactly that: the AI usage, metered against a per-project balance, with the site itself free. If you bought the original one-time lifetime PRO before the change, you keep your original features at no extra cost; that plan is retired and isn't sold anymore. ---

What happens if I exceed AI request limits?

TL;DR: AI usage stops when the project's balance runs out — you are never billed past what you put in — and you top it up when you want more. You can also bring your own OpenAI / Anthropic / Gemini / OpenRouter key and pay the provider directly instead. Long: Each project carries its own balance and every AI call is deducted from it at the model's real price plus our markup, both shown in the dashboard. When the balance reaches zero the assistant stops answering rather than billing you further — there is no overage and no surprise invoice. Top the project up and it resumes. You can also plug your own API key into the AI settings and route requests through your provider, in which case we meter nothing at all. Current numbers: https://docsbook.io/pricing ---

Is there a refund policy?

TL;DR: Yes — email me (dan@docsbook.io) within 30 days, no questions, full refund through Paddle. Long: Trust matters more than any single sale. If Docsbook turns out not to fit your workflow, I'd rather refund than have an unhappy customer telling people not to use it. Paddle handles the refund mechanics, usually in a couple of business days. ---

How is this different from GitBook?

TL;DR: Same outcome (a hosted docs site), a completely different pricing shape — GitBook charges per site and per editor, we charge for AI usage and nothing for the site — and your content stays in your GitHub repo. Long: GitBook's price has two axes at once: a per-site fee and a per-user fee for everyone who edits content. On 2026-09-03 their pricing page listed Free at $0 per site/month with one user, Premium at $65 per site/month plus $12 per user/month, and Ultimate at $249 per site/month plus $12 per user/month — check https://www.gitbook.com/pricing for today's figures. Content lives in GitBook's CMS, so leaving means an export. With us the site costs nothing regardless of how many people edit it, AI usage is metered against a per-project balance, and your Markdown never leaves your GitHub repo. The trade-off is real: GitBook has a richer WYSIWYG editor; we don't have one — you write Markdown. ---

How is this different from Docusaurus?

TL;DR: Docusaurus is a React framework you self-host. Docsbook is a hosted product. 30 seconds vs. 2–3 days of setup + ongoing maintenance of a Node.js app. Long: Docusaurus is fantastic if you want full control and have a team that enjoys owning the build pipeline, plugins, theme overrides, and a deployment target. Docsbook is for people who want the docs site without owning the framework. We also bundle search, AI chat, translations, and analytics, which are separate plugins/services in a Docusaurus setup. If you already shipped Docusaurus, don't migrate — it works fine. If you're starting today and don't need framework-level customization, Docsbook gets you there in seconds. ---

How is this different from Mintlify?

TL;DR: Comparable feature set (hosted docs, AI), but Mintlify pushes you toward MDX in their structure. Docsbook reads plain Markdown from any GitHub repo and is generally cheaper. Long: Mintlify is good — well-designed, well-marketed. Where we differ: (1) we work with any public GitHub repo that has Markdown in README.md or docs/, no project-specific config required; (2) they sell a monthly plan, we meter AI usage against a per-project balance and charge nothing for the site — compare https://mintlify.com/pricing against https://docsbook.io/pricing; (3) we expose a full MCP server, so AI agents can manage your workspace programmatically — read the doc graph, search by symbol, change branding. Their core docs experience is more polished out of the box; ours catches up the more you customise. ---

How is this different from Notion?

TL;DR: Notion is great for internal wikis. Bad for public docs — no real SEO, no AI chat trained on the content, no custom domain on most plans, and Google doesn't index it the way it indexes docs sites. Long: I see a lot of teams using Notion as "docs" and then wondering why nobody finds them. Notion pages don't structure as docs (no proper heading hierarchy for SEO), don't expose sitemap.xml, don't have a built-in AI chat for visitors, and don't generate llms.txt for AI agents. Docsbook is built specifically for docs that need to be found — by Google, by ChatGPT, by Perplexity. Keep Notion for your internal wiki; put public docs somewhere built for it. ---

How is this different from Readme.io?

TL;DR: Readme.io is API-docs-focused and sells AI as a paid add-on on top of the plan (on 2026-09-03 their page listed Starter $0/month, Pro $250/month billed annually, and "Ask AI" at $150/month — see https://readme.com/pricing). Docsbook is broader — any docs from any GitHub repo — and AI is metered by usage rather than sold as a tier. Long: If you have an OpenAPI spec and want polished API reference with try-it-now, Readme.io is built for that exact job and does it well. Docsbook is a more general docs platform — guides, references, blog posts, anything you can put in Markdown. If you need both, plenty of teams use Readme.io for API reference and Docsbook for the broader docs site. ---

How does the AI chat work?

TL;DR: It's trained on your documentation only, not the open web. Visitors ask questions, it answers with citations to your doc pages. Long: The flow is Search → Reading → Answer. The chatbot retrieves relevant sections from your indexed doc graph, then synthesizes an answer with the LLM, citing the pages it pulled from. You can configure suggested questions, the system prompt, pre/post LLM hooks, and the model provider (we default to OpenRouter openai/gpt-4o-mini, but you can plug in your own OpenAI / Anthropic / Gemini key). Streaming responses, full usage analytics, and a getaiquestions MCP tool so you can see what your users are actually asking. ---

Which AI providers can I use?

TL;DR: OpenRouter (default), OpenAI, Anthropic, Gemini. You can bring your own API key and pick any model the provider supports. Long: Default is OpenRouter with openai/gpt-4o-mini because it's cheap and good enough for most docs Q&A. You override at the workspace level in AI settings — paste your key, choose model, done. Requests through your own key don't count against the monthly cap. This is also how you can route to a private/dedicated deployment if compliance requires it. ---

How do AI translations work?

TL;DR: 15 languages (EN, ES, FR, DE, PT, IT, RU, ZH, JA, KO, AR, HI, TR, PL, NL). Each translated version gets indexed in Google as a separate page, with proper hreflang. Long: You enable a language in the workspace, Docsbook generates the translation, and the translated version becomes a real page at docsbook.io/[owner]/[repo]/[lang]/.... Google treats each language as a distinct indexable URL — so you get separate SEO for each market. There's a language switcher in the sidebar or header (configurable), and we auto-detect the visitor's language with franc. Business gets a higher monthly translation cap than Pro. If you have your own translator workflow, set translation mode to external and push translations via the MCP tool or webhook. ---

Can I review translations before they go live?

TL;DR: Yes — Pro and Business support a pending-approval queue. Translation lands as a draft, you approve via MCP (approvetranslation) or the dashboard, then it publishes. Long: This matters for languages where you have a native speaker on the team and want a sanity check before shipping. There's also listpendingtranslations and gettranslation MCP tools so an agent can pre-screen drafts and only surface the ones that look questionable. ---

Does Docsbook generate `llms.txt`?

TL;DR: Yes. Every workspace gets /llms.txt and /llms-full.txt automatically, with nothing to enable. Platform-level too: docsbook.io/llms.txt. Long: llms.txt is the emerging standard for telling AI agents (Perplexity, ChatGPT Search, Cursor, Cline) what your site is and how it's structured. We generate it from your doc graph — list of pages with titles and descriptions, in a format the AI clients actually parse. llms-full.txt is the same plus full content. Both work without configuration; they exist the moment your workspace is indexed. Whether an assistant then cites you depends on your content, not on the file — no platform can promise a citation, and we don't. ---

What about regular SEO?

TL;DR: Built-in. Meta tags, OpenGraph, sitemap.xml, JSON-LD (WebSite, Organization, SoftwareApplication, FAQPage), canonical URLs, separate indexing per language — nothing to enable and nothing to pay for. Long: Each page gets a proper , , OpenGraph image, and JSON-LD blocks for structured data. Sitemap is auto-generated and pings Google on update. Translations are exposed with hreflang. A custom domain plus the SEO setup means a Docsbook site behaves like a real docs site to Google, not a SPA. This is the main reason teams pick us over Notion for public docs. ---

FAQ 回复笔记：可复制粘贴的评论答复

内部使用 — 用于 Reddit、X、IndieHackers、Product Hunt、HackerNews 以及竞争对手帖子下方评论的复制粘贴式回复。

每个问题的格式： TL;DR（1–2 句话，适合发推文）+ 长版（适合帖子串和博客评论的 3–5 句话）。

语气： 真诚的创始人口吻。不说营销套话，不使用“革命性的 AI 驱动平台”之类的表述。先说明它具体能做什么，再提及取舍；如有相关内容，附上文档链接。

数字和事实的权威来源： 定价页面和文档概览。如果这里的数字与它们不一致，以它们为准——请修正此文件。

1. 通用#

什么是 Docsbook？#

简而言之：Docsbook 可在几秒钟内将一个公开的 GitHub 仓库转换为文档网站。粘贴 github.com/user/repo，网站就会显示在 docsbook.io/user/repo，每次向 main 分支推送内容都会自动更新——由计时器在 24 小时内获取，而不是通过 webhook，因此请说“无需构建步骤”，绝不要说“即时”。

详细来说：这是一个托管式文档平台，面向那些希望将文档以 Markdown 形式存放在 GitHub 中，而不是存放在专有 CMS 里的用户。无需设置 CI/CD，也无需费心维护 docusaurus.config.js。你将获得文档网站、一个使用你的内容训练的内置 AI 聊天机器人、支持 15 种语言且具有独立 SEO 索引的 AI 翻译、完整的分析功能，以及一个可让 AI 代理管理工作区的 MCP 服务器。自定义域名和免费 SSL 是商务版套餐的附加功能。免费方案是真正免费的——不是试用版。

适用于哪些人？#

简而言之：希望拥有专业文档，却不想花两周配置 Docusaurus，也不想在 GitBook 上承担按编辑订阅费用的 SaaS 创始人、开发者工具团队和 OSS 维护者。

详细说明：最适合的是这样的小团队：已经在 GitHub 中使用 Markdown 编写内容，并希望获得已发布的网站、搜索、AI 聊天、翻译和分析功能，同时无需自行维护基础设施。如果团队还需要自定义域名或 Webhook，可以升级到 Business。如果你有技术文案和自定义设计系统，Docusaurus 可能仍然更合适。如果你拥有一支 20 人的文档团队，并且需要企业级 SSO，GitBook 更适合。介于这些情况之间的团队，正是 Docsbook 的目标用户。

实际发布需要多长时间？#

简而言之：5–30 秒。连接 GitHub，指定一个代码仓库，网站即可上线。无需构建步骤，也无需部署。

详细说明：首次发布耗时最长，因为我们需要通过 GitHub API 为代码仓库建立索引。之后，每次推送到 main 分支，网站都会在几秒内更新——无需 GitHub Action，也无需自行维护 Vercel 部署。索引流水线会读取 README.md 和 docs/ 文件夹，使用 markdown-lsp 进行解析（我们的开源 LSP 解析器，通过 unified+remark 使用 AST，而不是脆弱的正则表达式），并使用 shiki + rehype 进行渲染。

我的内容实际上存放在哪里？#

简而言之： 在你的 GitHub 仓库中。Docsbook 从中读取内容，但从不写回。你可以随时取消——你的 Markdown 会原封不动地留在那里。

详细来说： 这是关于避免供应商锁定的故事。Notion、GitBook 和 Mintlify（基本上）拥有你的内容——要离开它们，你必须先导出内容。使用 Docsbook 时，你的仓库才是唯一真实来源。我们会缓存并建立索引，但不会将内容作为权威版本存储。工作区设置（品牌、AI 配置、域名、分析）存储在我们的 Postgres 中；如果你停止使用服务，这些设置会消失——但你的文档不会。

2. 定价和方案#

费用是多少？#

简而言之：我们不销售分级套餐。每个项目都有自己的余额，余额用于 AI 使用——网站、托管、自定义域名和页面浏览均不收费。当前价格：https://docsbook.io/pricing

详细说明：从 GitHub 仓库发布文档网站、托管网站、通过带 SSL 的自有域名提供服务，以及每位打开页面的读者——这些都不会消耗任何余额。计量的是 AI：向助手提问和运行翻译会从每个项目持有的余额中扣费，费用按回答所用模型的供应商实际价格加上我们的加价计算；控制面板会显示模型、费率和加价，因此扣款是可核查的。计费按账户进行，而不是按席位计费，因此没人会为可能只是修正一个拼写错误的同事付费。不要引用我提供的价格——https://docsbook.io/pricing 会在每次请求时根据实时定价常量生成，因此你打开它的那一刻，价格就是准确的。

免费计划是试用版吗？#

简而言之：没有试用版，因为没有可供试用的套餐。运行一个拥有自定义品牌、导航、主题、字体、你自己的域名和 SSL 的真实公开文档网站，而且无需支付任何费用——只有 AI 使用量会消耗余额。

详细说明：我（Dan）希望 OSS 维护者和独立开发者可以完全不用考虑定价就使用这个产品，所以我们不对网站本身收费。真正需要付费的是对我们而言也会产生费用的部分：LLM 推理。如果你的代码仓库是公开的，并且你想要一个带有自定义域名的优质文档网站，那么无需购买任何东西。当你开始更多地依赖助手或翻译功能时，余额才会变得重要。

为什么 Pro 是订阅制而不是终身方案？#

简而言之：我们过去曾销售一次性终身 PRO 方案；该方案现已不再提供，现有的终身客户仍可继续使用。取而代之的是按用量付费，因为 AI 聊天和翻译会产生持续的推理成本，而固定的终身价格无法覆盖这些成本。

详细说明：固定的终身价格无法根据工作区实际使用的 LLM 推理量进行扩展——一名高强度用户一个月产生的成本，可能就超过其一次性支付的费用。因此，现在的模式会针对实际的 AI 使用量收费，按照每个项目的余额计量，而网站本身免费。如果你在变更前购买了最初的一次性终身 PRO 方案，则可以继续免费享有原有功能；该方案已经停用，不再销售。

如果我超出 AI 请求限制，会发生什么？#

简而言之：项目余额用尽时，AI 使用会停止——您永远不会被收取超过您存入金额的费用——如果需要继续使用，您可以随时充值。您也可以使用自己的 OpenAI / Anthropic / Gemini / OpenRouter 密钥，直接向服务提供商付费。

详细说明：每个项目都有自己的余额，每次 AI 调用都会按模型的实际价格加上我们的加价从余额中扣除，这两项金额都会显示在控制面板中。当余额归零时，助手会停止回答，而不会继续向您收费——不存在超额费用，也不会收到意外账单。为项目充值后，服务就会恢复。您还可以在 AI 设置中填入自己的 API 密钥，通过您的服务提供商转发请求，在这种情况下，我们完全不会收取任何费用。当前价格：https://docsbook.io/pricing

是否有退款政策？#

简要说明：是的——在 30 天内给我发送电子邮件（dan@docsbook.io），无需任何理由，即可通过 Paddle 获得全额退款。

详细说明：信任比任何一笔交易都重要。如果 Docsbook 最终不适合您的工作流程，我更愿意退款，而不是让一位不满意的客户告诉别人不要使用它。退款流程由 Paddle 处理，通常需要几个工作日。

3. 竞争对手#

这与 GitBook 有何不同？#

简而言之：结果相同（一个托管的文档网站），但定价模式完全不同——GitBook 按网站和编辑者收费，而我们按 AI 使用量收费，网站本身不收费——并且你的内容始终保留在你的 GitHub 仓库中。

详细说明：GitBook 的价格同时包含两个维度：网站费用，以及所有编辑内容的用户按人头计费。2026-09-03，其定价页面列出的方案为：Free 每个网站每月 $0，包含一名用户；Premium 每个网站每月 $65，另加每位用户每月 $12；Ultimate 每个网站每月 $249，另加每位用户每月 $12——当前价格请查看 https://www.gitbook.com/pricing。内容存储在 GitBook 的 CMS 中，因此离开时需要导出。使用我们的服务时，无论有多少人编辑，网站都不收取费用；AI 使用量从每个项目的余额中计量扣除，并且你的 Markdown 始终不会离开 GitHub 仓库。取舍确实存在：GitBook 拥有功能更丰富的所见即所得编辑器；我们没有这样的编辑器——你需要编写 Markdown。

这与 Docusaurus 有何不同？#

简而言之： Docusaurus 是一个由你自行托管的 React 框架。Docsbook 是一款托管产品。设置仅需 30 秒，而不是 2–3 天，之后还要持续维护 Node.js 应用。

详细来说： 如果你希望拥有完全的控制权，并且团队乐于负责构建流水线、插件、主题覆盖以及部署目标，那么 Docusaurus 非常出色。Docsbook 面向的是那些希望拥有文档网站、却不想负责框架的人。我们还集成了搜索、AI 聊天、翻译和分析功能，而在 Docusaurus 中，这些通常需要单独的插件或服务。如果你已经部署了 Docusaurus，就不必迁移——它运行得很好。如果你今天才开始，并且不需要框架级别的定制，Docsbook 几秒钟就能帮你完成。

这与 Mintlify 有何不同？#

简而言之：功能集相近（托管文档、AI），但 Mintlify 的结构会引导你使用 MDX。Docsbook 从任意 GitHub 仓库读取纯 Markdown，通常价格也更低。

详细说明：Mintlify 很不错——设计精良，营销出色。我们的不同之处在于：(1) 我们支持任何包含 Markdown 的公共 GitHub 仓库，Markdown 位于 README.md 或 docs/ 中，无需项目专属配置；(2) 他们销售月度套餐，而我们按项目余额计量 AI 使用量，网站本身不收费——可以比较 https://mintlify.com/pricing 和 https://docsbook.io/pricing；(3) 我们提供完整的 MCP 服务器，因此 AI 代理可以通过编程方式管理你的工作区——读取文档图谱、按符号搜索、修改品牌设置。他们的核心文档体验开箱即用更加精致；而我们在你进行更多自定义后会逐渐追上。

这与 Notion 有何不同？#

简而言之：Notion 非常适合内部 wiki。但不适合公开文档——没有真正的 SEO，没有基于内容训练的 AI 聊天功能，大多数套餐不支持自定义域名，而且 Google 不会像索引文档网站那样索引它。

详细说明：我看到很多团队将 Notion 当作“文档”使用，然后疑惑为什么没人能找到它们。Notion 页面并不是按照文档的方式构建的（没有适用于 SEO 的正确标题层级），不会公开 sitemap.xml，没有面向访客的内置 AI 聊天功能，也不会为 AI 代理生成 llms.txt。Docsbook 专为需要被找到的文档而打造——无论是被 Google、ChatGPT 还是 Perplexity 找到。将 Notion 留作内部 wiki；将公开文档放到真正适合它的平台上。

这与 Readme.io 有何不同？#

简而言之：Readme.io 专注于 API 文档，并将 AI 作为计划之外的付费附加项销售（截至 2026-09-03，其页面列出的价格为 Starter $0/月、Pro $250/月（按年计费），以及每月 $150 的“Ask AI”——参见 https://readme.com/pricing）。Docsbook 的适用范围更广——任何 GitHub 仓库中的任何文档——AI 按使用量计费，而不是作为某个套餐级别销售。

详细来说：如果你有一个 OpenAPI 规范，并希望获得带有即时试用功能的精美 API 参考文档，Readme.io 正是为此打造的，而且做得很好。Docsbook 是一个更通用的文档平台——指南、参考文档、博客文章，以及任何可以用 Markdown 编写的内容。如果两者你都需要，许多团队会使用 Readme.io 来提供 API 参考文档，并使用 Docsbook 来构建更广泛的文档网站。

4. AI 聊天 & 翻译#

AI 聊天如何工作？#

简而言之：它仅基于您的文档进行训练，而不是开放网络。访客提出问题，它会通过引用您的文档页面来回答。

详细说明：流程是搜索 → 阅读 → 回答。聊天机器人从已建立索引的文档图谱中检索相关章节，然后使用 LLM 综合生成答案，并引用所提取内容的页面。您可以配置建议问题、系统提示词、LLM 前置/后置钩子以及模型提供商（我们默认使用 OpenRouter openai/gpt-4o-mini，但您也可以接入自己的 OpenAI / Anthropic / Gemini 密钥）。支持流式响应、完整的使用情况分析，以及一个 get_ai_questions MCP 工具，让您了解用户实际在询问什么。

我可以使用哪些 AI 提供商？#

简要：OpenRouter（默认）、OpenAI、Anthropic、Gemini。你可以使用自己的 API 密钥，并选择提供商支持的任意模型。

详细：默认使用 OpenRouter 和 openai/gpt-4o-mini，因为它价格低廉，对于大多数文档问答来说已经足够好。你可以在 AI 设置中以工作区为级别进行覆盖——粘贴密钥、选择模型，完成。通过你自己的密钥发出的请求不会计入每月上限。如果合规性要求如此，你也可以通过这种方式路由到私有/专用部署。

AI 翻译是如何工作的？#

简要说明：15 种语言（EN、ES、FR、DE、PT、IT、RU、ZH、JA、KO、AR、HI、TR、PL、NL）。每个翻译版本都会作为独立页面被 Google 编入索引，并正确设置 hreflang。

详细说明：您在工作区中启用一种语言后，Docsbook 会生成翻译，翻译版本会在 docsbook.io/[owner]/[repo]/[lang]/... 生成一个真实页面。Google 会将每种语言视为一个独立的可编入索引 URL，因此您可以针对每个市场分别进行 SEO。侧边栏或页眉中会显示语言切换器（可配置），我们还会通过 franc 自动检测访问者的语言。Business 版每月的翻译额度高于 Pro 版。如果您有自己的翻译工作流，请将翻译模式设置为 external，然后通过 MCP 工具或 webhook 推送翻译内容。

我可以在翻译上线前进行审核吗？#

简而言之：可以 — Pro 和 Business 支持待审批队列。翻译会以草稿形式进入，你可以通过 MCP (approve_translation) 或控制面板进行审批，然后发布。

详细说明：对于团队中有母语使用者、希望在上线前进行合理性检查的语言，这一点非常重要。此外，还有 list_pending_translations 和 get_translation MCP 工具，因此代理可以预先筛选草稿，只展示看起来存在问题的内容。

5. SEO & AI 发现#

Docsbook 是否生成 `llms.txt`？#

简而言之：是的。每个工作区都会自动获得 /llms.txt 和 /llms-full.txt，无需启用任何设置。平台级别也是如此：docsbook.io/llms.txt。

详细说明：llms.txt 是一种新兴标准，用于告诉 AI 代理（Perplexity、ChatGPT Search、Cursor、Cline）您的网站是什么，以及它的结构方式。我们会根据您的文档图谱生成它——以 AI 客户端实际能够解析的格式，列出页面及其标题和描述。llms-full.txt 则在此基础上包含完整内容。两者无需配置即可使用；您的工作区完成索引后，它们便会立即存在。至于助手随后是否引用您，则取决于您的内容，而不是文件本身——没有任何平台能够保证获得引用，我们也不会承诺这一点。

常规 SEO 怎么样？#

简而言之：内置。Meta 标签、OpenGraph、sitemap.xml、JSON-LD（WebSite、Organization、SoftwareApplication、FAQPage）、规范 URL、按语言分别建立索引——无需启用任何功能，也无需付费。

详细说明：每个页面都会获得适当的 <title>、<meta description>、OpenGraph 图片，以及用于结构化数据的 JSON-LD 区块。Sitemap 会自动生成，并在更新时通知 Google。翻译通过 hreflang 提供。自定义域名加上 SEO 设置后，Docsbook 网站在 Google 看来表现得像真正的文档网站，而不是 SPA。这是团队选择我们而不是 Notion 来发布公开文档的主要原因。

AI 搜索引擎真的会引用我的文档吗？#

简要回答：有时会，但没人能保证更多。Docsbook 消除了机械性障碍——服务器渲染的 HTML、清晰的标题、站点地图、llms.txt、爬虫访问权限——但引擎是否引用你，取决于你的内容和引擎本身，而且同一个提示词每次运行返回的来源都可能不同。

详细回答：AI 搜索引用取决于以下几点：(1) 可被索引（这部分由我们处理）；(2) 结构清晰，使模型能够提取具体论断（标题层级、代码块、列表——你的 Markdown 已经具备这些）；(3) 具备 llms.txt（由我们生成）；(4) 在相关主题上具有权威性（这取决于你以及你的写作方式）。在技术层面，Docsbook 消除了常见的障碍。对于直接针对你的代码仓库工作的代理，markdown-lsp 提供类似 LSP 的导航功能（doc_outline、doc_search_symbols、doc_resolve_link 等），让它们能够精确导航，而不是直接吞入原始 HTML。

6. 技术 & 集成#

Docsbook 运行在哪种技术栈上？#

简要：Vercel 上的 Next.js 16、Neon 上的 PostgreSQL、Redis 缓存、Drizzle ORM。AI 通过 OpenRouter/OpenAI/Anthropic/Gemini 接入。简洁、快速、可扩展。

详细：前端采用 Next.js 16 App Router + React 19 + Tailwind 4 + shadcn/ui。身份验证采用 next-auth v5，并支持 GitHub OAuth。数据库是使用 Drizzle 迁移的 Neon 无服务器 Postgres。Markdown 处理流水线是 unified + remark-parse + remark-gfm + remark-rehype + rehype-pretty-code + shiki。MCP 服务器采用 @modelcontextprotocol/sdk 1.29，并完整支持 OAuth 2.0。托管使用 Vercel，包括自定义域名；计费通过 Paddle，分析通过 Axiom。

它支持私有仓库吗？#

简而言之：公共仓库开箱即用。私有仓库通过经过身份验证的 GitHub OAuth 访问——流程相同，但仅拥有对特定仓库的读取权限。

详细说明：连接 GitHub 时，您需要授予我们访问所需索引仓库的权限。对于 OSS 项目，这是无需额外权限范围的公共仓库流程。对于私有仓库，您需要通过 GitHub App 授权特定仓库，我们会使用用户令牌读取这些仓库。我们绝不会以权威来源的形式存储内容——只存储索引图和缓存，并且可以随时使其失效。

我可以使用自定义域名吗？#

简而言之：可以，Business 方案支持。将 CNAME 指向 Docsbook，我们会配置 SSL 证书，完成。docs.yourcompany.com 几分钟内即可生效。

详细说明：自定义域名通过 Vercel 的域名 API 运行。你可以在工作区控制面板中添加 docs.yourcompany.com，或通过 update_domain MCP 工具添加，然后在 DNS 提供商处设置 CNAME，Vercel 会自动签发 SSL 证书。我们还会通过 /docs-proxy/[[...path]]/ 进行代理，以保持 URL 简洁并确保分析功能正常运行。

是否有 MCP 服务器？#

简而言之：有——位于 https://docsbook.io/api/mcp/server 的完整 OAuth 2.0 MCP 服务器，提供工作区管理、品牌设置、分析、Webhook 和翻译工具。服务器在连接时会返回自己的工具列表，因此不要引用我提供的工具数量。对于文档图谱搜索，请在本地使用 markdown-lsp，而不是托管的 MCP。

详细说明：使用 claude mcp add --transport http https://docsbook.io/api/mcp/server 连接托管的 MCP。完成 OAuth 后，代理将获得涵盖工作区管理（创建、品牌设置、UI）、AI 聊天（系统提示词、钩子）、翻译（批准、上传、删除）、分析（问题、未回答的问题、失败的搜索）以及 Webhook（注册、列出、重放）的工具。对于 LSP 风格的文档图谱操作——大纲、符号搜索、链接解析、引用——请改为在本地使用 markdown-lsp（npx markdown-lsp <subcommand> ./docs）。它会解析磁盘上的代码库，相比通过网络进行操作，速度更快、成本更低。

7. 安全性、隐私与锁定#

如果我取消服务，我的数据会怎样？#

简而言之：你的 Markdown 保留在你的 GitHub 仓库中。我们会根据请求删除工作区设置（品牌信息、AI 配置、分析数据）。无需“导出”——你的内容从来就不属于我们。

详细说明：这正是我们与 GitBook/Notion 在结构上的区别。对于它们而言，取消服务意味着你需要经历导出流程才能取回内容。而使用 Docsbook 时，你的内容始终保存在自己的仓库中——断开工作区后，你的仓库不会发生任何变化。我们持有的是存储在 Postgres 中的工作区元数据（这正是你付费购买的内容），以及存储在 Axiom 中的分析事件；我们会根据请求删除这两者。

数据托管在哪里？#

简而言之：Vercel（全球边缘节点）、Neon Postgres（美国/欧洲区域）、Redis 缓存、Axiom 用于日志。所有基础设施均位于美国/欧洲。

详细说明：标准的托管式 SaaS 基础设施。Vercel 在全球范围内处理 HTTP 和 CDN。Neon 是无服务器 Postgres，我们在其默认区域运行，并启用时间点恢复。Redis 用于缓存技能索引。日志和分析数据发送至 Axiom。如果出于合规要求需要特定区域承诺，请与我联系——目前我们部署在标准的 Vercel/Neon 覆盖范围内。

源代码是开放的吗？#

TL;DR：Docsbook 本身是闭源的。markdown-lsp（我们的解析器）和 docs-skills（AI 技能目录）在 GitHub 上是开源的。

详细说明：平台本身是闭源的，但我们将有益于更广泛生态系统的部分开源。markdown-lsp 是我们的 LSP 风格解析器，可将 Markdown 转换为结构化文档图——它为本地文档图搜索提供支持，也适用于任何构建文档工具的人。docs-skills 是一个面向 AI 代理的公开目录，包含 25 个 SKILL.md 文件（docs-analyze、docs-seo 等）——可与 Docsbook MCP 配合使用，也可独立运行。

8. 异议 & 反对意见#

"为什么不直接使用 Docusaurus，它是免费的？"#

简而言之：Docusaurus 在金钱上免费，但在时间上并非如此。两天的设置工作，加上持续维护一个 Node.js 应用的成本，一旦按你自己的工时计费，就是真实的金钱成本——用你自己的费率算一算这笔账。

详细来说：Docusaurus 很棒，我推荐那些希望拥有完全控制权的团队使用它。但“免费”的只是框架——你仍然需要托管它、维护构建流程、管理依赖项、添加搜索服务（Algolia $$$）、添加分析功能、添加 AI 聊天（定制开发）、添加国际化（定制开发）等。一年的总拥有成本是不可忽视的。Docsbook 以设置时间和捆绑功能换取较低的定制上限。两者都是合理的选择。

“付费使用文档网站似乎很贵。”#

简而言之： 拿它和市面上的其他选择比较一下——GitBook、Mintlify 和 Readme.io 在功能集相当的情况下，起步价都远高于此。免费方案足以支持一个真正的公共文档网站，而且不需要使用 AI。

详细说明： 我理解你第一眼看到时的反应，但我们的定价方式和其他产品不同。GitBook、Mintlify 和 Readme 都销售不同的套餐——固定月费，而 GitBook 还会额外收取按用户计费的费用。我们完全不销售套餐：每个项目都有自己的余额，余额用于支付 AI 使用量。发布网站、托管网站、自定义域名，以及读者打开的每个页面，都不会消耗余额。因此，如果你想要一个带有品牌元素且不使用 AI 的公共文档网站，就无需支付任何费用。当前价格请查看 https://docsbook.io/pricing；该页面每次请求都会根据实时定价常量生成——不要引用我这里的价格，请以该页面为准。

“为什么只支持 GitHub？如果我的源代码在 GitLab/Bitbucket 上呢？”#

简要说：目前仅支持 GitHub。GitLab 和 Bitbucket 已列入路线图，但近期不会支持。如果你有实际需求，请给我发邮件——这有助于确定优先级。

详细说：坦诚地说：我们面向的绝大多数 OSS 和开发工具项目，实际上都将代码托管在 GitHub 上，而深入支持一个平台优于浅尝辄止地支持三个平台。支持 GitLab 是可行的，因为它们的 API 类似；Bitbucket 则更难。如果支持 GitLab 能解决你的问题，请告诉我——我会记录下来，而这正是推动功能提升优先级的因素。

“GitHub 添加原生文档托管后，这怎么不会被淘汰？”#

简而言之：GitHub 已经有 Pages 和 Wikis——但两者都不是真正的文档平台。即使他们推出一个，AI 聊天 / 翻译 / 分析 / MCP / 自定义域名也会是差异化优势。

详细来说：GitHub Pages 已经存在十年了，但人们仍然在使用 Docusaurus、GitBook、Mintlify、Readme.io。为什么？因为“从代码仓库托管静态 HTML”只是容易的部分——困难的是搜索、AI、国际化、SEO、分析、自定义域名用户体验、仪表板，以及面向非技术买家的计费。真正的风险不是 GitHub 增加文档托管功能，而是现有竞争者中的某一家把 AI + GitHub 原生化做得更好。这就是我们对自己的要求。

“听起来不错，但我不信任一家只有一个人的公司来保管我的文档。”#

简而言之： 可以理解。你的内容在自己的 GitHub 仓库中，而不在我们的数据库里——所以最坏的情况是（我们消失了），你失去的是托管网站，而不是文档。一天之内就能将它们迁移到 Docusaurus。

详细来说： 这正是对“如果 Docsbook 不复存在了怎么办”的实际回答。你的 Markdown 文件在自己的仓库中。工作区设置可以恢复（我们通过 MCP 和 API 提供这些设置）。网站 URL 会失效，但内容完好无损。与 GitBook/Notion 相比，频繁更换平台意味着导出过程会很痛苦。不会被锁定的特性，是这里的小型供应商风险低于那些拥有内容所有权的竞争对手的结构性原因。

如何让此笔记本保持最新#

难点不在于一次性写好常见问题解答，而在于随着产品变化以及真实对话中不断出现新问题，持续确保其准确性。Dan 可以设置的具体选项：

从生产环境自动拉取真实问题#

我们已有的 MCP 工具： get_ai_questions、get_ai_unanswered、get_failed_searches、get_popular_searches、get_negative_feedback。运行每周 cron，从 docsbook.io 工作区本身拉取这些内容（因为我们自己的文档网站使用 Docsbook）——找出我们自己的访客正在提出但 AI 无法回答的问题，这是新增 FAQ 条目的最高信号来源。
脚本： scripts/faq-collect.ts ——调用这些 MCP 工具，与此文件中已有的问题进行去重，并将摘要发布到 Slack/Notion。

Reddit MCP — 阅读 r/SaaS、r/devops、r/programming 中提及“GitBook”“Docusaurus”“Mintlify”“文档托管”的评论。来自现有受众之外的真实问题。
X/Twitter MCP — 同样处理提及竞争对手或“文档网站”的推文。
Discord/Slack — 如果我们有实例，可以挖掘支持问题。目前还没有。
HackerNews — Algolia HN API 是公开的，无需 MCP；一个 50 行的脚本就能捕获所有提及 Docsbook/竞争对手的内容。

构建一个 `comment-reply` 技能#

一个 .claude/skills/comment-reply/SKILL.md，它：

接收输入：评论文本 + 目标平台（Reddit / X / HN / IH）。
判断匹配的 FAQ 条目（或“无匹配”）。
对于 X/HN 风格的平台返回 TL;DR，对于 Reddit/IH 返回长版本，并采用适合平台的格式。
如果没有匹配项——起草一个新条目，并提议将其追加到此文件中。

可用作 CLI 别名：claude comment-reply "<paste comment here>" --platform reddit。

构建一个 `update-faq` 技能#

一个每周运行一次的技能，能够：

通过 get_ai_questions / get_failed_searches 拉取新问题。
与此文件进行差异比较。
对于每个包含超过 3 个相似问题的未回答问题组，按照此文件的格式起草新的 FAQ 条目，并提交一个 PR。
还会标记 README.md 中的数字与此处引用的数字不一致的条目。

手动维护检查清单（目前）#

每次更改定价的发布 → 更新第 2 节。
每次在实际环境中出现新的竞争对手提及 → 考虑添加到第 3 节。
每季度 → 将 README.md 中的数字与此处引用的数字进行核对。
每个新的 MCP 工具 → 在第 6 节或“如何保持内容更新”中引用它。

Updated Sep 5, 2026