feishu-docs

name	feishu-docs
description	读取和搜索飞书文档。当用户分享了 feishu.cn 或 larkoffice.com 的链接、 要求查看飞书文档/Wiki 内容、或需要搜索飞书中的文档时触发。 需要用户已在 Web 设置页完成飞书 OAuth 授权。
allowed-tools	Bash(*)
user-invocable	true
argument-hint	<飞书文档链接或搜索关键词>

飞书文档读取与搜索

通过后端内部 API 读取和搜索飞书文档。所有请求使用环境变量中的凭据。

前置检查

执行前先确认环境变量存在：

[ -z "$HAPPYCLAW_USER_ID" ] && echo "错误: 未设置 HAPPYCLAW_USER_ID，无法访问飞书文档" && exit 1

操作 1: 读取飞书文档

支持 feishu.cn 和 larkoffice.com 的 wiki/docx 链接。

curl -s --max-time 30 -X POST "$HAPPYCLAW_API_URL/api/internal/feishu/read-document" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HAPPYCLAW_INTERNAL_TOKEN" \
  -d "{\"userId\": \"$HAPPYCLAW_USER_ID\", \"url\": \"<替换为飞书文档URL>\"}"

成功响应：{"title": "文档标题", "content": "文档内容..."}

• 将 title 作为标题、content 作为正文展示给用户

错误响应：

• {"code": "OAUTH_REQUIRED"} → 告知用户需要在 Web 设置页面完成「飞书文档授权」
• 其他错误 → 展示 error 字段内容

操作 2: 搜索飞书文档

根据关键词搜索云文档和 Wiki 页面。

curl -s --max-time 30 -X POST "$HAPPYCLAW_API_URL/api/internal/feishu/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $HAPPYCLAW_INTERNAL_TOKEN" \
  -d "{\"userId\": \"$HAPPYCLAW_USER_ID\", \"query\": \"<搜索关键词>\", \"count\": 20, \"searchWiki\": true}"

可选参数（加在 JSON body 中）：

• count: 返回数量（默认 20，最大 50）
• searchWiki: 是否搜索 Wiki（默认 true）
• docTypes: 文档类型数组，如 ["docx", "sheet", "wiki"]

成功响应：{"results": [...], "hasMore": false, "total": 5}

• 每个 result 包含：title, url, docType, owner, preview, updateTime
• 格式化为编号列表展示给用户
• 搜索结果中的文档链接可以用操作 1 进一步读取完整内容

错误处理同操作 1。