Feishu Doc

1---2name: feishu-doc3description: |4  Feishu document read/write operations + comment management. Activate when user mentions Feishu docs, cloud docs, docx links, or document comments.5---6 7# Feishu Document Tool8 9Single tool `feishu_doc` with action parameter for all document operations including comment management.10 11## Token Extraction12 13From URL `https://xxx.feishu.cn/docx/ABC123def` → `doc_token` = `ABC123def`14From URL `https://xxx.feishu.cn/docs/doccn123c` → `doc_token` = `doccn123c`15 16## Actions17 18### Read Document19 20```json21{ "action": "read", "doc_token": "ABC123def" }22```23 24Returns: title, plain text content, block statistics. Check `hint` field - if present, structured content (tables, images) exists that requires `list_blocks`.25 26### Write Document (Replace All)27 28```json29{ "action": "write", "doc_token": "ABC123def", "content": "# Title\n\nMarkdown content..." }30```31 32Replaces entire document with markdown content. Supports: headings, lists, code blocks, quotes, links, images (`![](url)` auto-uploaded), bold/italic/strikethrough.33 34**Limitation:** Markdown tables are NOT supported.35 36### Create + Write (Atomic, Recommended)37 38```json39{40  "action": "create_and_write",41  "title": "New Document",42  "content": "# Title\n\nMarkdown content..."43}44```45 46With folder:47```json48{49  "action": "create_and_write",50  "title": "New Document",51  "content": "# Title\n\nMarkdown content...",52  "folder_token": "fldcnXXX"53}54```55 56Creates the document and writes content in one call. Prefer this over separate `create` + `write`.57 58### Append Content59 60```json61{ "action": "append", "doc_token": "ABC123def", "content": "Additional content" }62```63 64Appends markdown to end of document.65 66### Create Document67 68```json69{ "action": "create", "title": "New Document" }70```71 72With folder:73```json74{ "action": "create", "title": "New Document", "folder_token": "fldcnXXX" }75```76 77Creates an empty document (title only).78 79### List Blocks80 81```json82{ "action": "list_blocks", "doc_token": "ABC123def" }83```84 85Returns full block data including tables, images. Use this to read structured content.86 87### Get Single Block88 89```json90{ "action": "get_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }91```92 93### Update Block Text94 95```json96{ "action": "update_block", "doc_token": "ABC123def", "block_id": "doxcnXXX", "content": "New text" }97```98 99### Delete Block100 101```json102{ "action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }103```104 105### List Comments106 107```json108{ "action": "list_comments", "doc_token": "ABC123def", "page_size": 50 }109```110 111Returns all comments for the document. Use `page_token` for pagination. Comments include `is_whole` field to distinguish between whole-document comments (true) and block-level comments (false).112 113### Get Single Comment114 115```json116{ "action": "get_comment", "doc_token": "ABC123def", "comment_id": "comment_xxx" }117```118 119### Create Comment120 121```json122{ "action": "create_comment", "doc_token": "ABC123def", "content": "Comment text" }123```124 125### List Comment Replies126 127```json128{ "action": "list_comment_replies", "doc_token": "ABC123def", "comment_id": "comment_xxx", "page_size": 50 }129```130 131`page_size` should be a positive integer. If omitted, tool defaults to `50`.132 133### Comment Write Scope134 135Current tool provides documented comment write action `create_comment` (global comment creation).136For replies, use `list_comment_replies` for retrieval; the reply creation endpoint is not exposed in current SDK surface.137 138## Reading Workflow139 1401. Start with `action: "read"` - get plain text + statistics1412. Check `block_types` in response for Table, Image, Code, etc.1423. If structured content exists, use `action: "list_blocks"` for full data143 144## Configuration145 146```yaml147channels:148  feishu:149    tools:150      doc: true  # default: true151```152 153**Note:** `feishu_wiki` depends on this tool - wiki page content is read/written via `feishu_doc`.154 155## Permissions156 157Required: `docx:document`, `docx:document:readonly`, `docx:document.block:convert`, `drive:drive`158 159For comment operations:160- Read comments: `docx:document.comment:read`161- Write comments: `docx:document.comment` (optional, for create_comment)