feishu

Files (1)

• SKILL.md

SKILL.md (first lines)

# 飞书 (Feishu/Lark)

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

## 使用场景

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

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

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

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

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

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

## 前置条件

1. 在飞书开放平台（https://open.feishu.cn/）创建应用
2. 获取 App ID 和 App Secret（如已配置飞书 Gateway 通道则可复用）
3. 设置环境变量：
   ```bash
   export FEISHU_APP_ID="cli_xxxx"
   export FEISHU_APP_SECRET="xxxx"
   ```
4. 在飞书管理后台为应用授权对应权限

## 执行方式

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

### 初始化客户端

```python
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()
```

### 发送消息

```python
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)
```

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

获取群聊列表：
```python
request = ListChatRequest.builder().build()
response = client.im.v1.chat.list(request)
```

### 文档操作

```python
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)
```

搜索文档（REST API）：
```python
import httpx

From malue-ai/dazee-small, MIT.

More from malue-ai/dazee-small