---
name: feishu-docx
description: 飞书云文档操作。用于创建、编辑云文档，插入内容块，会议纪要生成。当需要操作飞书云文档时使用。
---

# 飞书云文档 (Docx)

## URL 结构

```
https://xxx.feishu.cn/docx/DoxcXXXXXX
                           └── document_id
```

## 创建文档

```python
def create_document(title, folder_token=None):
    url = "https://open.feishu.cn/open-apis/docx/v1/documents"
    payload = {"title": title}
    if folder_token:
        payload["folder_token"] = folder_token
    response = requests.post(url, headers=headers, json=payload)
    doc = response.json()["data"]["document"]
    return {"document_id": doc["document_id"], "url": f"https://feishu.cn/docx/{doc['document_id']}"}
```

## 设置权限

```python
def set_permission(document_id, editable=True):
    """设置文档为组织内可编辑/只读"""
    url = f"https://open.feishu.cn/open-apis/drive/v1/permissions/{document_id}/public"
    payload = {
        "external_access_entity": "open",
        "link_share_entity": "tenant_editable" if editable else "tenant_readable"
    }
    requests.patch(url, headers=headers, params={"type": "docx"}, json=payload)
```

## 内容块类型

| 类型 | block_type | 示例 |
|------|------------|------|
| 段落 | 2 | 普通文本 |
| 一级标题 | 3 | # 标题 |
| 二级标题 | 4 | ## 标题 |
| 三级标题 | 5 | ### 标题 |
| 无序列表 | 13 | - 列表项 |
| 有序列表 | 14 | 1. 列表项 |
| 代码块 | 16 | ```code``` |
| 引用 | 18 | > 引用 |
| 分割线 | 22 | --- |
| 图片 | 27 | 需先上传 |

## 创建内容块

```python
def create_block(document_id, block_id, block_type, content):
    url = f"https://open.feishu.cn/open-apis/docx/v1/documents/{document_id}/blocks/{block_id}/children"

    if block_type in [3, 4, 5]:  # 标题
        block = {"block_type": block_type, "heading": {"elements": [{"text_run": {"content": content}}]}}
    elif block_type == 2:  # 段落
        block = {"block_type": 2, "text": {"elements": [{"text_run": {"content": content}}]}}
    elif block_type in [13, 14]:  # 列表
        block = {"block_type": block_type, "bullet/ordered": {"elements": [{"text_run": {"content": content}}]}}

    requests.post(url, headers=headers, json={"children": [block], "index": -1})
```

## 图片上传

```python
# 1. 上传图片到素材库
def upload_image(file_path, parent_node):
    url = "https://open.feishu.cn/open-apis/drive/v1/medias/upload_all"
    with open(file_path, 'rb') as f:
        files = {'file': f}
        data = {'file_name': os.path.basename(file_path), 'parent_type': 'docx_image', 'parent_node': parent_node}
        response = requests.post(url, headers={"Authorization": f"Bearer {token}"}, files=files, data=data)
    return response.json()["data"]["file_token"]

# 2. 插入图片块
def insert_image(document_id, block_id, file_token):
    block = {"block_type": 27, "image": {"token": file_token}}
    # ... 同 create_block
```

## 会议纪要模板

```python
def create_meeting_notes(title, date, attendees, agenda, decisions, action_items):
    doc = create_document(f"{title} - {date}")
    doc_id = doc["document_id"]

    # 获取根块
    root = requests.get(f".../documents/{doc_id}/blocks/{doc_id}").json()
    root_id = root["data"]["block"]["block_id"]

    # 添加内容
    create_block(doc_id, root_id, 3, f"会议纪要：{title}")
    create_block(doc_id, root_id, 2, f"日期：{date}")
    create_block(doc_id, root_id, 2, f"参会人：{', '.join(attendees)}")
    create_block(doc_id, root_id, 4, "议程")
    for item in agenda:
        create_block(doc_id, root_id, 13, item)
    create_block(doc_id, root_id, 4, "决议")
    for item in decisions:
        create_block(doc_id, root_id, 13, item)
    create_block(doc_id, root_id, 4, "待办事项")
    for item in action_items:
        create_block(doc_id, root_id, 14, item)

    return doc
```

## 完整工具类

见 `~/.claude/skills/feishu/feishu_docx.py`

## 注意事项

- 创建文档必须指定 `folder_token`，否则会出现在「与我共享」
- 默认存储到 `C80gfkRnzlonQ5d4AhOcOACDnNg`（01运营文件夹）
- 图片必须先上传到素材库，再插入文档