feat(feishu): support Docx table create/write + image/file upload actions in feishu_doc (#20304)

Co-authored-by: Tak Hoffman <781889+Takhoffman@users.noreply.github.com>
This commit is contained in:
XuHao
2026-02-28 08:00:56 +08:00
committed by GitHub
parent 1725839720
commit 56fa05838a
5 changed files with 726 additions and 9 deletions

View File

@@ -6,7 +6,7 @@ description: |
# Feishu Document Tool
Single tool `feishu_doc` with action parameter for all document operations.
Single tool `feishu_doc` with action parameter for all document operations, including table creation for Docx.
## Token Extraction
@@ -43,15 +43,22 @@ Appends markdown to end of document.
### Create Document
```json
{ "action": "create", "title": "New Document" }
{ "action": "create", "title": "New Document", "owner_open_id": "ou_xxx" }
```
With folder:
```json
{ "action": "create", "title": "New Document", "folder_token": "fldcnXXX" }
{
"action": "create",
"title": "New Document",
"folder_token": "fldcnXXX",
"owner_open_id": "ou_xxx"
}
```
**Important:** Always pass `owner_open_id` with the requesting user's `open_id` (from inbound metadata `sender_id`) so the user automatically gets `full_access` permission on the created document. Without this, only the bot app has access.
### List Blocks
```json
@@ -83,6 +90,105 @@ Returns full block data including tables, images. Use this to read structured co
{ "action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }
```
### Create Table (Docx Table Block)
```json
{
"action": "create_table",
"doc_token": "ABC123def",
"row_size": 2,
"column_size": 2,
"column_width": [200, 200]
}
```
Optional: `parent_block_id` to insert under a specific block.
### Write Table Cells
```json
{
"action": "write_table_cells",
"doc_token": "ABC123def",
"table_block_id": "doxcnTABLE",
"values": [
["A1", "B1"],
["A2", "B2"]
]
}
```
### Create Table With Values (One-step)
```json
{
"action": "create_table_with_values",
"doc_token": "ABC123def",
"row_size": 2,
"column_size": 2,
"column_width": [200, 200],
"values": [
["A1", "B1"],
["A2", "B2"]
]
}
```
Optional: `parent_block_id` to insert under a specific block.
### Upload Image to Docx (from URL or local file)
```json
{
"action": "upload_image",
"doc_token": "ABC123def",
"url": "https://example.com/image.png"
}
```
Or local path with position control:
```json
{
"action": "upload_image",
"doc_token": "ABC123def",
"file_path": "/tmp/image.png",
"parent_block_id": "doxcnParent",
"index": 5
}
```
Optional `index` (0-based) inserts the image at a specific position among sibling blocks. Omit to append at end.
**Note:** Image display size is determined by the uploaded image's pixel dimensions. For small images (e.g. 480x270 GIFs), scale to 800px+ width before uploading to ensure proper display.
### Upload File Attachment to Docx (from URL or local file)
```json
{
"action": "upload_file",
"doc_token": "ABC123def",
"url": "https://example.com/report.pdf"
}
```
Or local path:
```json
{
"action": "upload_file",
"doc_token": "ABC123def",
"file_path": "/tmp/report.pdf",
"filename": "Q1-report.pdf"
}
```
Rules:
- exactly one of `url` / `file_path`
- optional `filename` override
- optional `parent_block_id`
## Reading Workflow
1. Start with `action: "read"` - get plain text + statistics