feishu

name	feishu
description	Use when the user mentions 飞书 / Feishu / Lark workspace operations: docx (云文档) read/write, bitable (多维表格) records / views / dashboards, drive (云盘) upload/download, wiki (知识库) link resolution, approval (审批) instance create/cancel/query, calendar (日历) event create/list/update + attendees, contact (联系人) user/department lookup, hire (招聘) job/talent/application listing. Trigger on phrases like 'OKR 周报', '把这份文档发到飞书云盘', '给团队拉个评审会议', '查 [姓名] 的联系方式', '撤销那条审批', '/wiki 链接', or any request that mentions a feishu / lark URL / token (doxcn.../bascn.../wikcn.../boxcn.../om_...).
paths	["**/*飞书*","**/*feishu*","**/*lark*"]
allowed-tools	["feishu_docx_create","feishu_docx_get_blocks","feishu_docx_append_block","feishu_docx_update_block_text","feishu_bitable_list_records","feishu_bitable_search_records","feishu_bitable_create_record","feishu_bitable_batch_update_records","feishu_bitable_list_views","feishu_bitable_get_view","feishu_bitable_list_dashboards","feishu_drive_list_files","feishu_drive_upload_media","feishu_drive_download_media","feishu_wiki_get_node","feishu_approval_create_instance","feishu_approval_get_instance","feishu_approval_cancel_instance","feishu_approval_list_instances","feishu_approval_subscribe","feishu_calendar_list","feishu_calendar_create_event","feishu_calendar_list_events","feishu_calendar_update_event","feishu_calendar_delete_event","feishu_calendar_attendees_create","feishu_contact_get_user","feishu_contact_batch_get_users","feishu_contact_get_department","feishu_contact_search_users_by_department","feishu_hire_list_jobs","feishu_hire_get_job","feishu_hire_list_talents","feishu_hire_get_talent","feishu_hire_list_applications","read","web_search"]

飞书 (Lark) 工作流套件

35 个 feishu_* tool 覆盖飞书除 IM 之外的核心业务面：docx / bitable / drive / wiki / approval / calendar / contact / hire。所有 tool 共享同一个账号路由——account 参数仅在配了 ≥2 个飞书账号时才必须，否则自动选唯一一个。

典型工作流剧本

1. OKR 周报：bitable → docx → drive

1. feishu_bitable_list_records({app_token, table_id, view_id?})
   → 拿到本周的 OKR 进度数据
2. feishu_docx_create({title: "OKR Weekly W#"})
   → 拿到 document_id
3. feishu_docx_append_block({document_id, parent_block_id: document_id,
     block: {block_type: 2, text: {style: {}, elements: [...]}}})
   → 写多段
4. feishu_drive_upload_media({path: "/tmp/screenshot.png",
     folder_token: "...", mime: "image/png"})
   → 把截图传上去（≤20MB，本地路径必须绝对）

2. 排会议：calendar → attendees

1. feishu_calendar_list() → 选目标 calendar_id
2. feishu_calendar_create_event({calendar_id, event: {
     summary: "OKR review", start_time: {timestamp: "1700000000",
     timezone: "Asia/Shanghai"}, end_time: {...}}})
   → 拿到 event_id
3. feishu_calendar_attendees_create({calendar_id, event_id, attendees: [
     {type: "user", user_id: "ou_xxx"},
     {type: "chat", chat_id: "oc_xxx"}]})

3. 查同事：contact

1. feishu_contact_get_user({user_id: "ou_xxx"})  // 或先 search 找 ID
   → 名字 / email / 部门 / 上级
2. feishu_contact_search_users_by_department({department_id: "..."})
   → 整个团队

⚠️ contact 系列返回员工个人信息（手机号 / 邮箱 / 部门），不要把原始 JSON 直接 echo 回 IM 群聊——总结关键字段即可。

4. 审批：approval

1. feishu_approval_create_instance({approval_code, user_id, form: "[...]"})
   → ⚠️ HIGH RISK：在调之前一定问用户「我准备发起 X 审批，form 字段是 Y/Z，确认吗？」
2. feishu_approval_get_instance({instance_code}) → 看 status / timeline
3. 撤销也是 HIGH：feishu_approval_cancel_instance({approval_code, instance_code, user_id})

5. wiki 链接：先解析再读

用户给一个形如 https://xxx.feishu.cn/wiki/wikcnXxx 的链接时：

1. feishu_wiki_get_node({token: "wikcnXxx"})
   → 拿到 obj_token / obj_type
2. obj_type == "docx" → feishu_docx_get_blocks({document_id: obj_token})
   obj_type == "bitable" → feishu_bitable_list_records({app_token: obj_token, table_id: ...})

飞书 app scope 速查

每个 tool 的 description 已写明所需 scope；汇总如下（在飞书后台「权限管理」开启）：

模块	主要 scope	备注
docx	docx:document / docx:document.readonly	写需 :document
bitable	bitable:app / bitable:app.read	写需 :app
drive	drive:drive / drive:drive.read	upload / download 都需要
wiki	wiki:wiki.readonly / wiki:wiki	get_node 一般 readonly 够
approval	approval:approval	create / cancel 都需要
calendar	calendar:calendar / calendar:calendar.readonly	写需 :calendar
contact	contact:user.id:readonly / contact:department.id:readonly	敏感数据
hire	hire:job:readonly / hire:talent:readonly / hire:application:readonly	tenant 必须开通 hire 模块

常见错误码翻译（让用户秒懂）

code	含义	给用户的提示
99991400	请求过快 / 限流	「飞书侧限流了，等几秒重试」
99991663	参数错误 / 资源不存在	「token 或 ID 不对，确认一下原始链接？」
99991672	scope 未授权	「飞书 app 缺 X scope，去飞书后台『权限管理』勾选并发版」
99991677	租户未开通	「这个能力需要租户管理员先在工作台启用」
1061004	hire 模块未开通	「招聘模块只在企业版可用，让管理员去工作台启用『飞书招聘』」
300317	cardkit sequence 错乱	内部错误，已自动降级
200750	cardkit 卡片过期	重新创建

风险等级（操作影响范围）

• HIGH：feishu_approval_create_instance / feishu_approval_cancel_instance —— 影响真实审批流，调用前必须向用户复述参数 + 等待确认
• MEDIUM：其它所有写操作（docx_create / docx_append_block / bitable_create_record / drive_upload_media / calendar_create_event 等）—— 列出 diff / 预期结果让用户认可一次即可
• MEDIUM-敏感：feishu_contact_* / feishu_hire_list_talents / feishu_hire_get_talent —— 返回员工/候选人个人信息；不要回显原始 JSON 到群聊或外部上下文

多账号

只在配了 ≥2 个飞书账号时才需要传 account: "<channel_account_id>"。GUI 设置入口：Settings → Channels → Feishu。账号信息走 cached_config() 拉取，与 IM 渠道是否运行 WebSocket 网关解耦——只想用 docx / bitable 不开 bot 的场景也支持。

不在本工具集内（v0.2.0 不含）

• docx 块类型扩展（image / table / code block） — v0.3+
• drive 大文件分片上传 v2（>20MB） — v0.3+
• bitable view 创建 / 自定义 / 公式 / 自动化 — v0.3+
• approval 模板定义 / approve / reject task — v0.3+（写要走飞书后台）
• calendar 会议室 / 资源预订 — v0.3+
• task / email — v0.3+
• 其它 channel 的 reaction / edit / recall 解析 — v0.3+ Phase B.3

碰到上述场景：明确告诉用户「这块在 v0.2.0 暂不覆盖，请去飞书后台手动操作 / 等下版」。