Sources office

Sources / 企业办公

事实来源：主仓 pr-88 @ a312645。1 个内置 office 源。

---

1. 唯一源：feishu_drive

字段	值
接入	official_api
鉴权	required
凭据	feishu_app_id + feishu_app_secret
稳定性	稳定
Capability	search（搜索云文档/电子表格/知识库）

---

2. 配置

1. 在 飞书开放平台 创建自建应用。
2. 开启 "云文档" / "知识库" / "云空间" 相关权限。
3. 获取 App ID + App Secret。

feishu_app_id: cli_xxxxxxxx
feishu_app_secret: xxxxxxxxxxxxxxx

飞书与海外 Lark 共用同一套 OAuth 模型；账号区分由 App 注册区域决定。

---

3. 调用示例

souwen search web "项目计划" -e feishu_drive -n 10

from souwen.facade import search
resp = await search("Q3 OKR", domain="office", sources=["feishu_drive"])

---

4. 反模式

• app_id 配了，secret 没配：auth_requirement="required" + credential_fields=("feishu_app_id","feishu_app_secret")，两个都得有。
• App 没开权限：飞书后台没启用相应 scope，调用返 403。

---

5. 接下来

• Source-feishu_drive · Sources Index