200份技术文档,我花半天建了个知识库
Lv.1 新人创作者
【我用的功能】WPS 灵犀 + 技术文档知识库(tech-knowledge-base)【我的场景】做运维最痛苦的事不是修故障,是找文档。服务器配置参数在哪个文档里?上次 Keepalived 切换的操作步骤谁写的?OGG 同步延迟的处理方案存哪了?我们团队有个共享盘,里面按项目、按系统分了 20 多个文件夹,文档总量大概 200 多份。每次找文档,路径大概是:打开共享盘 → 猜文件夹 → 打开 5 个 docx → 都不是 → 问同事 → 同事说"在另一个文件夹里"。最夸张的一次,RAC 节点 2 宕机,我要找去年的集群重建方案,翻了 15 分钟没找到,最后是靠着微信聊天记录里的截图恢复了操作步骤。【操作过程】灵犀的 tech-knowledge-base 技能,底层是 SQLite + FTS5 全文索引。操作流程:1) 把 200 多份 docx/doc 文档放到一个目录;2) 灵犀逐份解析,用 python-docx 提取正文,按内容自动分类(13 个分类:数据库、中间件、网络、存储、安全、操作系统、虚拟化、监控、备份、灾备、变更、巡检、应急预案);3) 写入 SQLite 数据库,建立 FTS5 全文索引;4) 入库完成后,用自然语言检索。入库花了大约 2 小时。然后试了检索:"RAC 节点 2 的 tnsnames.ora 配置"→秒出,定位到《生产环境数据库配置参数表 v2.3.docx》;"Keepalived 切换方案"→秒出,定位到《Nginx+Keepalived 高可用部署方案.docx》和《2025 年 3 月 VIP 切换演练报告.docx》;"OGG 同步延迟"→秒出,定位到 3 份相关文档。【使用感受】FTS5 全文检索的响应速度比我想象的快——200 多份文档,关键词检索不到 1 秒。而且它支持中文分词,搜"心跳"能匹配到"心跳网络"、"心跳延迟"、"心跳检测"。跟企业级方案(Confluence + Elasticsearch)比,这个方案的优点是零部署成本——不需要服务器,不需要装 ES,灵犀本地就跑起来了。缺点是并发检索能力有限,但对于个人或小团队运维完全够用。【一句话总结】让运维知识从"存在某处"变成"3 秒能找到"。