feishu

飞书 (Feishu/Lark)

通过 lark-oapi SDK 操作飞书全生态：消息、文档、日历、任务、审批、妙记。中国团队的核心协作工具。

使用场景

消息

• 用户说「在飞书上给 xxx 发个消息」「在 xxx 群里发个通知」
• 用户说「飞书上有没有新消息？」「看看飞书群里最新的讨论」

文档

• 用户说「帮我在飞书文档里创建一个周报」「搜索飞书里那个技术方案文档」
• 用户说「把这段内容追加到飞书文档末尾」「读一下飞书知识库里的 XX」

日历

• 用户说「帮我在飞书日历上建个会议」「看看我飞书日历上今天的安排」
• 用户说「把会议改到周五」「取消明天的周会」

任务

• 用户说「看看我飞书上有什么待办」「帮我加个飞书任务：周五前交报告」
• 用户说「把飞书上那个任务标记为完成」

审批

• 用户说「查看待我审批的流程」「我的请假申请审批到哪了？」

妙记（会议纪要）

• 用户说「帮我看看上次周会的会议纪要」「把昨天的会议纪要总结一下」
• 用户说「提取会议的行动项」

前置条件

1. 在飞书开放平台（https://open.feishu.cn/）创建应用
2. 获取 App ID 和 App Secret（如已配置飞书 Gateway 通道则可复用）
3. 设置环境变量：

   export FEISHU_APP_ID="cli_xxxx"
   export FEISHU_APP_SECRET="xxxx"
   

4. 在飞书管理后台为应用授权对应权限

执行方式

项目已安装 lark-oapi SDK，优先使用 SDK 而非原始 HTTP 调用。

初始化客户端

import lark_oapi as lark
import os

client = lark.Client.builder() \
    .app_id(os.environ["FEISHU_APP_ID"]) \
    .app_secret(os.environ["FEISHU_APP_SECRET"]) \
    .build()

发送消息

from lark_oapi.api.im.v1 import *
import json

request = CreateMessageRequest.builder() \
    .receive_id_type("chat_id") \
    .request_body(CreateMessageRequestBody.builder()
        .receive_id("目标群聊或用户ID")
        .msg_type("text")
        .content(json.dumps({"text": "消息内容"}))
        .build()) \
    .build()

response = client.im.v1.message.create(request)

富文本消息：

content = {
    "zh_cn": {
        "title": "周报通知",
        "content": [
            [{"tag": "text", "text": "请各位提交本周周报"}],
            [{"tag": "a", "text": "点击填写", "href": "https://..."}],
        ]
    }
}
# msg_type = "post"

获取群聊列表：

request = ListChatRequest.builder().build()
response = client.im.v1.chat.list(request)

文档操作

from lark_oapi.api.docx.v1 import *

# 读取文档内容
request = RawContentDocumentRequest.builder() \
    .document_id("文档ID") \
    .build()
response = client.docx.v1.document.raw_content(request)

# 创建文档
request = CreateDocumentRequest.builder() \
    .request_body(CreateDocumentRequestBody.builder()
        .title("文档标题")
        .folder_token("目标文件夹token")
        .build()) \
    .build()
response = client.docx.v1.document.create(request)