核心功能
bo-faq-bot 是一款面向飞书（Feishu）生态的 FAQ 知识库构建工具，通过命令行即可快速初始化、导入、查询和维护问答数据。其核心能力包括：
- 多格式支持：原生支持 Markdown 导入（H2 标题为问题，正文为答案），同时可导出为 Markdown 或 JSON，便于版本管理和二次开发
- 模糊智能检索：采用 TF-IDF 风格的文本匹配算法，返回 0.0-1.0 区间的置信度分数，支持阈值与返回数量自定义
- 完整 CRUD 能力：涵盖初始化、单条添加、批量导入、搜索、列表展示、删除、统计等全生命周期管理
- 飞书场景优化：设计初衷即为对接飞书机器人，可作为自动客服系统的后端知识引擎
显著优点
1. 零依赖轻量架构：纯 Python 脚本实现，无需重型数据库或向量检索服务，部署成本极低
2. 内容即代码：Markdown 格式的存储方式天然适配 Git 版本控制，便于团队协作和审计追溯
3. 交互式 CLI：add 命令支持交互式输入，降低非技术用户的使用门槛
4. 灵活阈值控制：搜索置信度可调，兼顾精准匹配与容错召回的平衡
潜在局限
- 算法天花板：TF-IDF 类匹配对语义理解能力有限，同义词、口语化表达、跨语言查询效果可能不如现代 Embedding 模型
- 无持久化服务：默认基于文件存储，高并发场景下存在 IO 瓶颈，不适合大规模实时服务
- 功能边界清晰：专注 FAQ 场景，不支持多轮对话、上下文继承或复杂任务流
- 飞书生态绑定：设计初衷紧密围绕 Feishu，其他 IM 平台需额外适配
适合人群
- 需要快速上线、轻量运维的中小企业客服团队
- 技术储备有限、偏好 Markdown 内容管理的开发者
- 已在飞书生态内运营，希望低成本增强自动回复能力的业务方
- 将 FAQ 作为 MVP 验证、后续可能迁移至 LLM 方案的过渡阶段项目
常规风险提示
- 数据安全：FAQ 内容以明文 Markdown/JSON 存储，敏感信息需额外加密或权限管控
- 匹配误判：低阈值搜索可能返回不相关答案，建议生产环境配合人工兜底机制
- 版本兼容性：Markdown 解析规则与特定格式强绑定（H2=问题），源文件格式变更需谨慎迁移
- 规模瓶颈：建议单知识库条目控制在数千级以内，超大规模需考虑迁移至专业向量数据库