Feishu Search Doc

飞书文档与 Wiki 搜索

Standalone Wrapper

• 共享环境变量：FEISHU_APP_ID、FEISHU_APP_SECRET，可选 FEISHU_BASE_URL、FEISHU_OAUTH_STORE_DIR
• feishu_search_doc_wiki -> node scripts/search-doc.js '<json>'

执行前必读

• 本 skill 只返回搜索结果摘要，不返回完整正文内容
• query 可以为空；空字符串代表“空搜”，常用于按最近打开或最近编辑排序
• filter 会同时作用于文档和 Wiki；如果不传，工具仍会给两个空过滤器以满足飞书 API 要求
• 返回结果里的时间字段会被标准化成 +08:00 的 ISO 8601 字符串

快速索引：意图 → 工具 → 必填参数

核心约束（Schema 未透露的知识）

1. query 为空不是错误，而是一种能力

• 不传 query 或传空字符串时，等价于空搜
• 空搜最适合配合 sort_type 使用，例如按最近编辑时间取回最近文档
• 这和传统“必须有关键词”的搜索工具不一样

2. filter 会镜像到 doc 和 wiki 两边

底层请求会同时构造：

• doc_filter
• wiki_filter

两边内容一致。也就是说，筛选条件不是只对 doc 生效，而是对文档和 Wiki 一起生效。

3. 搜索结果不是正文全文

返回结果通常包含：

• 标题
• 摘要
• 命中高亮
• 文档元数据

如果用户需要“把文档完整拉下来”，下一步应切到 feishu-fetch-doc 或相关内容 skill。

4. 时间和排序最容易被误用

搜索结果中的 *_time 字段会被转成可读的 ISO 8601 时间。

使用场景示例

场景 1：普通关键词搜索

{
  "action": "search",
  "query": "周报",
  "page_size": 10
}

场景 2：只搜标题，限定文档类型

{
  "action": "search",
  "query": "OKR",
  "filter": {
    "doc_types": ["DOCX", "WIKI"],
    "only_title": true
  }
}

场景 3：空搜最近编辑的文档

{
  "action": "search",
  "filter": {
    "sort_type": "EDIT_TIME"
  },
  "page_size": 10
}

常见错误与排查

官方文档参考

• 搜索能力总览: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2
• 搜索文档与 Wiki: https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/search-v2/doc_wiki/search