一名开发者在 V2EX 分享了其为公司自建的离线知识库系统，整套实现仅用 380 行 Python 代码，单文件运行，零第三方依赖。该项目源于企业文档管理的现实痛点：公司制度文档散落在网盘、群聊和个人电脑中，新人提问依赖老员工口口相传，回答往往并非现行版本；而商用 SaaS 知识库则卡在数据必须出内网和按人头收费两道门槛上。这套系统只做一件事：将 Markdown 文档放入 docs 目录即可提问，回答附带《文档》/章节出处，可点开核对原文；文档带可见范围设置，普通员工查不到财务制度，财务角色则可访问，全程不联网。技术上，作者按标题栈加段落将文档分块，约 420 字一块，每块自带文档路径便于直接引用；中文分词采用二元组切分，不依赖分词库，英文数字按词切分；召回环节采用 BM25 与 TF-IDF 双路加权，并引入查询词覆盖率加权，解决了近似提问命中偏差的问题。回答默认抽取式而非生成式，直接返回原文片段，规避制度类场景下的内容编造风险。部署仅需两条命令：ingest 建索引、serve 起服务，目录拷贝到内网机器即可使用。作者已将代码开源在 GitHub，并附 89 秒演示视频与实现细节长文，同时征集检索排序与文档权限方面的改进建议。
事件分析
该项目最值得关注的是其反潮流的技术取舍：在 RAG 普遍依赖向量数据库与大语言模型生成答案的背景下，作者回归 BM25 与 TF-IDF 等经典检索方法，并以抽取式输出替代生成式回答。这一设计直击企业制度类场景的核心风险——幻觉与版本漂移，返回原文让使用者自行核对，实质上把可信性置于智能性之前。零依赖单文件的设计也大幅降低了内网部署与安全审计成本，对数据合规要求严格的中小企业具有实际参考价值。分块携带标题路径、查询词覆盖率加权等细节，也证明关键词检索在中文场景下经调优仍具实用性。可能的后续走向包括：引入本地化嵌入模型增强语义召回、细化权限粒度并补充审计日志、扩展更多文档格式解析。该分享同时折射出一条务实路线：并非所有企业知识管理都需要大模型，轻量确定性方案在特定场景下反而更易落地、更易维护。
核心观点：当行业一窝蜂用大模型做RAG时，380行纯检索代码证明：企业知识库场景里，确定性与可追溯比智能生成更值钱。
原文链接：V2EX 分享发现
