
1. 从「写说明书」到「知识住在哪」
十年前,文档在公司里的分工几乎不用解释。
产品做完一版,找人写使用说明;客服群里同一个问题被问了二十遍,再开几篇 FAQ;招投标要附件,就从网盘里翻出上次的 PDF,改个日期发出去。写清楚、排整齐、挂上网——多数时候,这件事就算办完了。文档像说明书:产品是主机,它是附赠的纸。
问题是,纸只会待在抽屉里。现在的文档不会。
用户不一定从你们的文档站首页点进去。他可能先在站外搜了一句「某某功能怎么关」,AI 摘要给了他半截答案;也可能在 IDE 里问编码助手「这个接口超时怎么处理」,助手从公开文档里抽了一段;还可能是实施同事把帮助中心某页丢进内部群,群聊机器人又总结了一遍。同一份事实,被拆、被转述、被截断,却仍然要在关键步骤上站得住。
行业公开调研里,一千一百多人回答过同一类问题。技术作者仍是最大群体,但他们不是多数——其余是领导、工程师、客服、运营、市场。文档不再只是「写文档的人」的事,而是一群人共同依赖、又经常共同搞砸的东西。调研里还有一句很实在的判断:真正从 AI 里拿到好处的团队,往往不是用得最热闹的那些,而是把力气花在写之前、写之后的那些——信息收得拢、变更看得见、对外口径对得上。
换句话说,卡住你们的,通常不是「今天谁写得慢」。卡住你们的是更土的问题:
这份知识现在住在哪?飞书里一份、企微里一份、个人桌面一份「最终版-真的最终」?谁有权改?改完,官网、帮助中心、发给客户的方案书,谁先更新、谁还停在上个月?
把文档继续叫「说明书」,就会一直按说明书的预算去养它:能省则省,能拖则拖,出事了再补页。把它当成上下文基础设施,预算和优先级才会跟着变——你是在养一块以后搜索、助手、入门流程都要吃的料,不是在给售后打零工。
这不是换一个好听的词。是换一套问问题的方式:从「这页写完了吗」,问到「这层数据别人还能不能信」。
2. 谁在读:人、搜索、助手,以及越来越多不翻目录的家伙
人当然还在读。
售前要把能力边界讲清楚,实施要按步骤落地,客服要在三分钟内找到「重置密码」那一篇,伙伴开发者要一份不跟着营销口径飘的接口说明。这些人要的东西很朴素:路径短、说法一致、点开不是 404。
难的是,同一次「找答案」,中间往往已经多了几层转述。
一个实施顾问可能根本没打开过你们的文档站目录。他先问了内部助手,助手答了一半;半信半疑,又去站外搜,搜到的摘要和帮助中心旧文打架;最后把两段截图丢进客户群,客户再按截图操作——错一步,锅会记在你们产品头上,很少有人回头查「原文到底写在哪一版」。
公开数据里,直接从导航进站的人仍然很多;AI 搜索、编码助手、以及业界讨论越来越多的 MCP 一类通道,却已经从几乎可以忽略,长到没法假装看不见。比例年年会变,趋势不容易反转:文档站不再是唯一门口,却最好仍是门口背后那一份事实。
这里有个容易误会的点。门口可以很多。品牌官网讲故事,文档站讲规格,帮助中心讲「此刻怎么做完这件事」——穿衣风格本来就该不同,就像商场一楼和负一层办的事不一样。乱,通常不是因为门多,而是因为每扇门后面各养了一套货:市场改口号只改了官网,帮助中心还在用旧产品名;研发改了参数默认值,文档站三个月没动;客服在群里口述了正确做法,对外站上仍是错的。
人对着两套口径会吵架,会拉群,会「以谁为准」。机器对着两套口径更省事:它两边都采,总结给你一个听起来很圆的答案。你以为上了 AI,其实只是把版本冲突自动化了。
这篇不展开帮助中心怎么帮人自己买、智能体怎么当新用户接待——那些后面单独写。也不把 MCP 写成「明天 Baklib 就能当你们的 Agent 网关」;那是行业里正在出现的问法,和产品主路径上已经交付什么,要分开说。眼下只先认一件事:读者变了,入口变了,你们若还只有「挂在网上的说明书」,基础设施这一层其实还没立起来。
3. 国内现场:网盘、群文件,和写着「最终版」的 PDF
把镜头拉近一点,场景通常不戏剧,只烦人。
上午,销售把「我们已通过某某认证」写进方案书,字体加粗,客户点头。下午客户自己点开官网,安全与合规入口要么跳到两年前的草稿,要么根本没有独立入口——信任不是在谈判桌上丢的,是在浏览器地址栏里丢的。
客服下午排班,同一个「如何导出报表」又进线。帮助中心里其实有这篇,标题还起得挺正经,可惜挂在「高级功能 → 数据管理 → 其他」第三层;站内搜索打「导出」,先冒出来的是一篇 2023 年的活动说明。于是客服打开收藏夹里的飞书文档,或者翻企微「导出-新」聊天记录,把正确步骤再打一遍。人累,口径还在继续分叉。
伙伴开发者想对接接口。官网产品页很漂亮,截图是最新 UI;开发者文档里的错误码表还停在上一大版本,示例请求里的字段名和现网不一致。联调多耗两周,售前和研发一起背支持成本,事后复盘常常写成「文档要重视」——然后文档仍然没有固定主人。
市场周五改了一句产品定位。官网首页换了,公众号发了,招聘页「关于我们」和下周要投的案例 PDF 还在说上一版故事。没有人故意搞砸,只是改一处的成本,在组织里被默认成了改一处就够。
这些摩擦很少表现为「我们页面不够多」。页面往往已经很多:网盘里按项目建的文件夹、群文件里层层「请查收」、邮件附件里的
手册_v3_最终_可用_1215.pdf。真正磨人的是三种不确定叠在一起。你不确定答案对不对。群里最新一条口述、帮助中心旧文、销售方案里的截图,三套说法,开会对齐要半小时。
你不确定版本新不新。文件名写着最终,发版说明里却对不上;客户按旧步骤操作失败,你只能说「以现网为准」,现网却没有一页稳定、可分享的说明。
你不确定知识住在哪。同一个人的电脑、同一个部门的共享盘、同一个客户的专属群,各有一份「比较新」的材料。新人入职第一周不是学产品,是学「这份东西到底以哪份为准」。
若用公开站点成熟度那把尺子说人话,它其实很克制:先看帮助、文档这类触点在不在、找不找得到,不急着评价文案写得漂不漂亮、产品强不强。很多团队一上来就想做漂亮站、堆活动页,骨干入口却是空的或过期的。过期的入口比没有入口更伤——用户以为走进了正式通道,读到的却是过期事实。空着的叶子,有时候不如暂时不开。
4. Baklib:树干先立住,再点 Docs / Help 这几片叶子
Baklib 不把这件事包装成「再买一个文档门户」。我们更常跟客户说三层叠在一起的事——也就是把对外触点背后的事实,收进可协作的内容中台思路里:资源、知识、体验同源,而不是每个门口再买一套工具。
一层叫资源库:图片、视频、品牌包、对外发放过的文件,别再满天飞。一层叫知识库:口径、手册、帮助、政策,写成可协作、可审核、可发布的知识,而不是聊天记录;再细一点,是把可检索、可引用的知识片段养清楚,而不是只堆长文。一层叫体验库:按场景把知识送出去——文档站、帮助中心、品牌官网,可以用不同的门牌和模板,但吃的是同一棵树上的果子。
建设侧已经有一批场景模板可点亮叶子,Docs、Help、WWW 是软件团队起步时最常先亮的几片。门脸讲品牌,文档讲规格与概念,帮助讲任务步骤,边界事先划清,后面少很多「这篇到底算说明书还是算营销稿」的扯皮。门牌不妨多,事实源应一——改产品默认值,应能回到同一处真源,再发到该亮的门口,而不是拜托三个同事各改各的站点。
若你在软件或信息技术公司,角色落在产品、研发或 IT 知识管理,比较经得起落地的顺序通常是这样,而不是反过来先上一个很炫的对话框。
先把树干立住。公司介绍、产品规格、价格与能力边界、常见任务说明,有一份大家承认的真源;未审核的草稿就老实待在草稿里,别混进对外库。手册偏「这是什么、边界在哪」,帮助偏「此刻怎么做完」,一开始就写进约定,比上线后再拆要便宜。落点可以是 知识中台 与 企业 Wiki:先有住所,再谈分发。
再点骨干叶子。文档站和帮助中心优先有稳定入口、能被搜到、能被链到具体页。先让「有门、找得到」变成别人可以打开浏览器验证的状态,再谈花更多页、更漂亮的活动运营。知达那类尺子评的也是触点齐不齐、找不找得到,正好用来挡住「先做热闹」的冲动。
到达层放在后面。站内搜索、AI 问答可以接,但它们应只读已经发布的内容;人要点得回原文,而不是再养一份「只给机器人看的说明书」。模型会组词,组织仍要定口径——这一点后面讲治理时还会展开,这里先占个位:基础设施若立不住,对话框只会更快地传播错误。
所以你要买的、要建的,往往不是「再多一个挂文章的站」,而是一块企业知识基础设施:结构化真源住得下,对外触点找得到,同源发布发得出。Wiki、帮助中心、手册可以是同一中台里的不同门口;Docs / Help / 官网可以是不同叶子,树干仍是一棵。
文档一直都重要。到了 2026 年,只是重要的方式变了——它不再只是附在产品盒子里的那叠纸,而是搜索、助手、入门流程和你们内部协作共同踩着的那层地面。地面不牢,上面什么智能都像在装修。