版本预览
v1.7.0 版本更新说明
发布日期：2026年04月07日 版本类型：重大功能更新 主题：飞书文档+知识库支持
📋 版本概述
小遥搜索 v1.7.0 正式支持 飞书文档数据源，配合小遥搜索飞书导出工具（https://github.com/dtsola/xiaoyaosearch-feishu-export-md），让您能够搜索从飞书导出的本地 Markdown 文档，在搜索结果中清晰标识飞书文档来源，并支持一键跳转到飞书原文。
核心亮点
📄 飞书文档识别：自动识别从飞书导出的 Markdown 文档
🔗 原文链接跳转：搜索结果支持直接跳转到飞书原文
🎨 飞书标识展示：搜索结果中使用紫色"飞书"标识区分数据来源
🔌 插件化架构：基于插件化框架，扩展数据源更灵活
🛠️ 配套导出工具：独立的飞书导出 CLI 工具，支持批量导出
✨ 新增功能
飞书文档数据源支持
功能定位：
为小遥搜索添加飞书文档数据源识别能力，让用户能够搜索从飞书导出的本地 Markdown 文档。
使用流程：
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ 飞书文档/知识库 │ ───▶ │ 飞书导出工具 │ ───▶ │ 本地MD文件 │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐
│ 小遥搜索 │
│ 自动识别 │
└─────────────────┘
│
▼
┌─────────────────┐
│ 搜索+跳转原文 │
└─────────────────┘使用场景：
使用场景
描述
价值
产品经理
搜索本地产品文档 + 飞书需求文档
统一搜索入口，提升效率
开发者
搜索本地代码 + 飞书技术文档
快速定位技术资料
团队协作
将飞书团队知识库导出后本地搜索
知识沉淀与备份
飞书导出工具（配套）
小遥搜索飞书导出工具是独立的 CLI 工具，支持将飞书文档/知识库导出为 Markdown 格式。
工具特性：
✅ 支持单个文档导出
✅ 支持知识库文档导出
✅ 支持批量文档导出
✅ 支持文件夹递归导出
✅ 支持完整知识库导出
✅ 自动下载图片和附件
✅ 增量导出（仅导出有更新的文档）
✅ 并发控制（可配置 API 并发数）
安装方式：
# 全局安装
npm install -g xiaoyaosearch-feishu-export
# 验证安装
feishu-export --version快速开始：
# 1. 初始化配置
feishu-export init
# 2. 导出单个文档
feishu-export export -d doxcnXXXXXXXX
# 3. 导出知识库
feishu-export export -w wiki_node_token
# 4. 批量导出
feishu-export docs --file docs.txt导出格式示例：
导出的 Markdown 文件末尾包含元数据：
---
> 更新: 2026-03-30 02:52:46
> 来源类型: feishu
> 原文: <https://feishu.cn/wiki/XXXXXXXXXXXXXXXXXXXX>
---小遥搜索会自动识别这些元数据，并将文档标记为"飞书"数据源。
项目地址：https://github.com/dtsola/xiaoyaosearch-feishu-export-md
搜索结果飞书标识
标识样式：
图标：云朵图标（CloudOutlined）
颜色：紫色（#722ed1）
文本：显示"飞书"来源标识
搜索结果展示：
┌────────────────────────────────────────────────────┐
│ 🔍 搜索结果 │
├────────────────────────────────────────────────────┤
│ 📄 产品需求文档_v1.2.md │
│ ...摘要内容... │
│ 💾 本地文件 │ 🕒 2026-03-15 │
├────────────────────────────────────────────────────┤
│ 📄 飞书技术方案.md │
│ ...摘要内容... │
│ 🟣 飞书 │ 🔗 原文链接 │ 🕒 2026-03-20 │
└────────────────────────────────────────────────────┘原文链接跳转
跳转功能：
搜索结果中的飞书文档显示"原文链接"按钮
点击按钮在新标签页打开飞书原文
自动填充文档的完整 URL
适用条件：
文档包含飞书元数据
用户有飞书文档访问权限
飞书原文链接有效
📚 技术实现
插件化架构
技术栈：
Python ABC - 插件接口定义
正则表达式 - 元数据解析
importlib - 插件动态加载
插件实现：
class FeishuDataSource(DataSourcePlugin):
"""飞书数据源插件"""
def get_file_source_info(self, file_path: str, content: str) -> Dict[str, Any]:
"""从飞书导出的文档中提取元数据"""
# 1. 检测文件末尾的飞书元数据格式
# 2. 解析来源类型（feishu）
# 3. 提取原文链接
# 4. 返回标准化的数据源信息
pass元数据解析流程：
读取文件内容
↓
提取最后 500 字符
↓
正则匹配飞书元数据
↓
解析原文链接
↓
返回 source_type=feishu, source_url=xxx数据库变更
说明：数据库表结构已在 v1.2.0 插件化架构版本中完成
已有字段：
source_type TEXT DEFAULT 'filesystem' - 数据源类型（filesystem/yuque/feishu）
source_url TEXT - 原文链接
无需修改：本特性直接复用现有字段，无需数据库迁移。
前端支持
说明：前端已在 v1.2.0 插件化架构版本中支持
已有支持：
数据源类型映射：feishu: t('searchResult.sourceFeishu')
图标映射：feishu: CloudOutlined
样式定义：.source-type.source-feishu 紫色样式
无需修改：本特性无需前端代码修改。
🔄 升级指南
从 v1.6.0 升级到 v1.7.0
https://www.dtsola.com/archives/a685353b-7e61-4e02-b24c-620f9e65f621
📦 下载地址
小遥搜索 v1.7.0：
百度网盘：https://pan.baidu.com/s/1lDaWjMCRXIT-Sqx9UFjerg?pwd=37ed
GitHub：https://github.com/dtsola/xiaoyaosearch/releases/tag/v1.7.0
飞书导出工具：
npm：npm install -g xiaoyaosearch-feishu-export
GitHub：https://github.com/xiaoyaosearch/xiaoyaosearch-feishu-export-md
📖 使用示例
场景一：产品经理搜索需求文档
背景：产品经理将需求文档写在飞书中，同时本地有产品设计的 Markdown 文档。
操作步骤：
使用飞书导出工具导出飞书需求文档：
feishu-export export -w doxcnReqDocId -o D:\docs\feishu在小遥搜索中添加扫描路径：D:\docs\feishu
搜索关键词"用户登录"
搜索结果同时显示：
本地产品设计文档（来源：本地文件）
飞书需求文档（来源：飞书）
点击飞书需求文档的"原文链接"，跳转到飞书原文查看最新版本
场景二：开发者搜索技术文档
背景：开发团队在飞书中维护技术规范文档，需要与本地代码一起搜索。
操作步骤：
批量导出飞书技术文档：
# 创建文档ID列表文件
echo "doxcnDoc1" > tech-docs.txt
echo "doxcnDoc2" >> tech-docs.txt
# 批量导出
feishu-export docs --file tech-docs.txt -o D:\docs\tech在小遥搜索中添加扫描路径：D:\docs\tech
搜索技术关键词"API设计"
快速定位到飞书中的技术规范文档
场景三：知识库定期备份
背景：企业知识库需要定期备份到本地，防止数据丢失。
操作步骤：
设置定时任务（Windows 计划任务）：
# 每周日凌晨 2 点执行
feishu-export wiki wiki_token -o D:\backup\feishu --incremental小遥搜索自动索引新增/更新的文档
随时搜索备份的知识库内容
❓ 常见问题
Q1: 如何使用飞书文档搜索？
A: 将飞书文档导出为 Markdown 格式，放到小遥搜索的扫描目录即可，系统会自动识别。
导出方式：
安装飞书导出工具：npm install -g xiaoyaosearch-feishu-export
初始化配置：feishu-export init
导出文档：feishu-export export -d <doc_id> -o <输出目录>
Q2: 飞书导出格式是什么？
A: 飞书导出的 Markdown 文件末尾包含元数据块，标明来源类型和原文链接。
示例格式：
---
> 更新: 2026-03-30 02:52:46
> 来源类型: feishu
> 原文: <https://feishu.cn/wiki/MZKMwqpljiod1ak38Cscnr8hnkh>
---Q3: 可以搜索飞书文档中的图片吗？
A: 目前支持文本搜索，图片搜索需要飞书文档导出时包含图片。
飞书导出工具支持自动下载图片：
feishu-export export -d <doc_id> --imagesQ4: 飞书原文链接会过期吗？
A: 如果您有飞书文档的访问权限，原文链接可以正常打开。
权限要求：
文档对您可见（公开或您有访问权限）
飞书账号正常登录
Q5: 如何批量导出飞书知识库？
A: 使用飞书导出工具的知识库导出功能：
# 导出完整知识库
feishu-export export -w <wiki_id> -o <输出目录>
# 仅生成索引文件（不下载文档）
feishu-export export -w <wiki_id> --index-onlyQ6: 搜索不到飞书文档怎么办？
A: 请检查以下几点：
确认文档已导出到小遥搜索的扫描目录
确认文档末尾包含飞书元数据
确认索引已构建完成（查看索引管理页面）
尝试重新索引该目录
🙏 致谢
感谢以下开源项目的支持：
Python ABC - 抽象基类
飞书开放平台 - API 支持
Node.js - 飞书导出工具运行环境
特别感谢所有贡献者和用户的支持！
让我们一起打造更好的本地搜索体验！ 🚀
加入用户交流 ↓
#独立开发者 #知识工作者 #知识库 #AI工具 #内容创作者 #一人公司 #ai搜索 #dify #ragflow #vibecoding
