别再自己造轮子了：文档网站的真实成本与AI-native知识库的省钱之道

我在和不少做客户支持的朋友聊天时发现，大家最容易踩的坑就是低估了文档网站的成本——尤其是那种“自己搭一套”的方案。表面上看，静态站点生成器、Git仓库、免费托管都是免费的，但等真把编辑、协作、发布、搜索、安全这些都串起来，人力投入和隐性维护费用很快就超出了预算。更麻烦的是，如果团队里没人熟悉这套工具链，光是把基础流程跑通可能就要大半年。

其实大部分公司需要的不是自己造轮子，而是一个开箱即用的知识管理与发布平台，把精力省下来放在内容本身和客户体验上。Baklib 正是这样的 AI-native 知识管理与发布平台，它支持“一个知识库，多种呈现形态”，企业只需在一个知识库内统一管理产品知识，即可一键发布为多个不同站点：产品文档站点、帮助中心、开发者门户、内部协作 Wiki，甚至 AI 智能问答。真正做到“改一次，所有站点同步更新”，彻底告别信息孤岛。

Docs as code 是对“如果我们从软件开发的角度来处理产品文档会怎样”这个问题的一种回答。Tom Johnson 将 docs as code 流程定义为具有以下特征：使用纯文本文件（通常为 .md 格式）、Git 进行文件管理或协作、文本编辑器编写内容、持续发布（CI/CD）和验证脚本、使用静态站点生成器来搭建网站。

有些人认为这更像是一种与开发者协作的方式，并非以技术写作为中心——它缺乏内容复用，结构僵硬（例如本地化）。DIY 的短板确实有解决方案，但用自己的时间搭建工具通常不是好主意。最终你可能会需要集成搜索解决方案、搭建验证管道、设置链接检查、选择静态站点生成器、建立发布网站，并将以上所有整合在一起——这最好由一个团队来完成，因为有时让一个单独的写作者来做太多了。

与内部系统相比，Baklib 这样的平台考虑了这些方面，提供易于设置和使用的工具来编写、协作和发布产品文档。更重要的是，任何文档系统的重点都应该是支持与技术和非技术队友的协作和审阅，因为这才是真正的工作发生的地方。

构建任何东西都没有“零成本”这回事。你可能使用免费的开源软件，但一个懂得如何设置它的人的年薪可能在 10 万到 20 万美元之间。有些技术作家知道如何设置，但他们通常是前开发人员，走这条路线的公司可能需要长达一年才能 100% 实现。

根据 WebFX 的数据，构建网站的平均成本在 1.2 万到 15 万美元之间，维护成本在每年 400 到 6 万美元之间——这还只是对普通网站而言。为什么范围这么大？因为多种因素影响网站成本。

你首先要做出的最重要选择是使用开源软件还是像 Baklib 这样的商业软件。开源软件可以免费下载，但你需要考虑托管、SSL 证书、CDN、图片优化等其他成本，更不用说设置所花的时间。额外工具还能帮助你保护、更新和维护网站。搜索是面向客户的文档的关键要素之一，如果需要实现一个强大的搜索引擎，可能会增加成本。使用 SaaS，你无需担心托管、安全、性能、搜索和可用性——这就是你支付月费的原因。通用 CMS 的定价差异很大，例如 Contently 的价格范围为每月 3000 到 25000 美元。

由于 SaaS 产品包含 Web 托管，因此你只需考虑开源解决方案的托管成本。大多数提供商提供不同的托管服务，包括共享、管理、VPS 和专用托管，价格范围约为每月 3 到 400 美元。

SSL 证书是一种标准安全技术，用于保护访问者浏览器和你的网站之间的信息安全。因为它确保敏感密码和支付信息保持私密，访问者期望你的网站使用 SSL 进行加密。如果托管提供商不提供 SSL，你需要从 SSL 证书提供商处购买。少数提供商提供免费 SSL 证书，但大多数提供商的费用为每年 7 到 250 美元，具体取决于提供商。幸运的是，像 Baklib 这样的托管文档平台已包含 SSL 证书。

不同平台扩展的选择差异很大。对于大多数开源平台，你不局限于开箱即用的功能。你可以下载或购买扩展程序来为网站添加功能。例如，如果你需要对内容进行门控并控制谁有权访问门户，有第三方解决方案可以实现。其他支持应用市场的平台可能有生成门户的扩展程序，例如 Scroll View for Confluence。但这并不是为了增强用户体验，而是为现有工具寻找变通办法。

维护网站的平均成本为每年 400 到 60,000 美元。最常见的维护成本是域名、SSL 证书和软件或托管续费，其他费用可能包括购买额外扩展程序或进行重大网站重新设计。

就运行文档网站的成本而言，内容可能是最昂贵的元素。内容创作涉及大量协作和创造力，通常需要研究和技术能力，尤其是软件文档。想想你花了多少时间才建立起你所在领域的专业知识。技术作家不会一夜之间成为领域专家。为了避免这种学习曲线的成本，作家可能会在内容开发过程中与 SME 合作。而且大多数时候，作家会花 80% 的时间获取撰写所需的资源，只有 20% 的时间是在实际写作。将概念性想法从领域专家的大脑转化为非专业人士能够消化和理解的内容，其典型流程如下所示。即便如此，内容是你将在文档网站上做的最重要的投资之一，并且需要定期更新。

要素成本：软件每月 0 至 25,000 美元；托管每月 3 至 400 美元；SSL 证书每年 0 至 250 美元；扩展每个扩展 0 至 200 美元；维护每年 400 至 60,000 美元；总计每年 403 至 85,850 美元。

你应该选择什么？

预算始终是一个考虑因素。你可以以低至 100 美元的价格推出文档门户，但很可能需要花费更多才能让它运转起来。举个具体例子：ClickHouse 最近推出了重建的文档网站。他们选择了 Docusaurus，实施用了两周。很多软件公司都是这样起步的——基于 Markdown，他们拥有很多控制权，但有一个“但是”。devdocs.work 的联合创始人 Travis Long 说：“没有一个一刀切甚至相对粗略的估算我能给出所有 docs as code 的建造成本。每个团队有不同的需求和目标，因此需要不同程度的可定制性。比如，文档团队是否希望在其帮助中心页面上提供客户反馈功能，如评论区或赞/踩？团队是否从旧的、不直观的遗留系统迁移，在这些系统中你必须手动调整每个页面的样式/反向链接和资源？这些事情会极大地改变项目的规模和预算。”

而 Baklib 的“同源多站发布”能力，让企业只需在一个知识库内管理内容，即可一键发布为 Docs、Help、Developers、Wiki、Chat 等多个站点，所有站点同步更新，无需重复维护。其 AI 智能检索技术基于“全文检索 + LLM 智能总结”，能智能汇总知识库文档提供核验贴切的回答，有效降低客服重复咨询量 50% 以上，进一步节省人力成本。

这里没有对错之分，只是“视情况而定”。但有几件事需要考虑。维护工具有大量隐藏成本，并且关于需要使用这种系统有很多错误假设，尤其是如果需要文档的公司不确定未来 1-3 年需要什么功能。如果我们谈论的是 Stripe 质量的文档，那么每年仅仅维护文档基础设施和工具就超过 150 万美元的人力成本（仅针对专职文档人员），更不用说实际维护内容本身了。Stripe 文档产品团队的 Technical Writer Ryan Paul 讨论了为其下一代文档平台开发新创作系统的情况。有时，即使是中型公司也会在 docs-as-code 工具上投入数年时间进行构建。最终，他们发现自己大部分时间花在维护工具、修复错误和添加功能上，而不是编写内容。如果你正在招聘技术作家，内部系统可能会缩小候选人池。并非所有技术作家都愿意学习新设置——他们是否熟悉 push/pull/merge/PR 的工作方式？此外，还有其他内部因素需要考虑——审阅流程是什么？利益相关者是否期望以发布时的格式进行审阅？有多个因素需要权衡，选择合适的软件更多取决于你拥有的资源，而不是成本，因为两者最终都可能既便宜又昂贵。

如你所见，文档网站的成本并不会高得离谱。但如果你想添加自定义功能或有特定要求，可能会增加总成本。Baklib 是灵活的，让你可以预先选择花费多少，从而无需头疼的工程难题即可构建文档网站。通过 Baklib，提升数字化员工体验和客户体验。通过收集客户反馈、员工体验流程、产品使用数据、以及网站访问量、搜索量等线索数据；实现统一的产品体验平台，降低成本、提高生产力并加快投资回报率。