需要读写飞书云文档或管理文档评论时，用…

通过飞书文档 URL 提取 doc_token 后，用 feishu_doc 对飞书 docx 做读写、结构化块操作和评论管理。

适用场景

解决思路

1. 所有文档操作统一调用单一工具 `feishu_doc`，通过 `action` 参数选择具体动作，包括评论管理。
2. 从飞书文档 URL 提取 `doc_token`：`https://xxx.feishu.cn/docx/ABC123def` → `ABC123def`；`https://xxx.feishu.cn/docs/doccn123c` → `doccn123c`。
3. 读取文档：调用 `action: read` 并传 `doc_token: ABC123def`，获取 title、纯文本内容和 block 统计；检查返回的 `hint` 字段，若存在则说明有表格、图片等结构化内容，需要改用 `list_blocks`。
4. 替换写入文档：调用 `action: write`，传 `doc_token` 和 `content`，用 markdown 内容替换整个文档；支持 headings、lists、code blocks、quotes、links、images（`` 自动上传）、bold/italic/strikethrough；不支持 Markdown 表格。
5. 原子创建并写入（推荐）：调用 `action: create_and_write`，传 `title` 和 `content`；如需指定文件夹，加 `folder_token: fldcnXXX`；优先使用它而不是分开 `create` + `write`。
6. 追加内容：调用 `action: append`，传 `doc_token` 和 `content`，将 markdown 追加到文档末尾。
7. 创建空文档：调用 `action: create`，传 `title`；如需指定文件夹，加 `folder_token: fldcnXXX`；只创建带标题的空文档。
8. 列出块：调用 `action: list_blocks`，传 `doc_token`，返回完整 block 数据，包括表格、图片；用于读取结构化内容。
9. 获取单个块：调用 `action: get_block`，传 `doc_token` 和 `block_id: doxcnXXX`。
10. 更新块文本：调用 `action: update_block`，传 `doc_token`、`block_id: doxcnXXX` 和 `content: New text`。
11. 删除块：调用 `action: delete_block`，传 `doc_token` 和 `block_id: doxcnXXX`。
12. 列出评论：调用 `action: list_comments`，传 `doc_token` 和 `page_size: 50`；用 `page_token` 分页；评论中的 `is_whole` 区分整篇文档评论（true）和块级评论（false）。
13. 获取单条评论：调用 `action: get_comment`，传 `doc_token` 和 `comment_id: comment_xxx`。
14. 创建评论：调用 `action: create_comment`，传 `doc_token` 和 `content: Comment text`。
15. 列出评论回复：调用 `action: list_comment_replies`，传 `doc_token`、`comment_id: comment_xxx`、`page_size: 50`；`page_size` 应为正整数，省略时工具默认 50。
16. 评论写入范围：当前工具提供文档化的评论写入动作 `create_comment`（全局评论创建）；回复只能用 `list_comment_replies` 检索，创建回复的 endpoint 未在当前 SDK surface 暴露。
17. 读取工作流：先 `action: read` 获取纯文本和统计；检查响应中的 `block_types` 是否有 Table、Image、Code 等；若存在结构化内容，再用 `action: list_blocks` 获取完整数据。
18. 配置启用：在配置中设置 `channels.feishu.tools.doc: true`（默认 true）；`feishu_wiki` 依赖此工具，wiki 页面内容通过 `feishu_doc` 读写。
19. 权限：需要 `docx:document`、`docx:document:readonly`、`docx:document.block:convert`、`drive:drive`；评论操作另需读取评论 `docx:document.comment:read`，写评论 `docx:document.comment`（可选，用于 `create_comment`）。

适用边界 · 注意事项

• Markdown 表格不支持，`write`/`create_and_write` 不能用于写入 Markdown 表格，需改用块级操作或避免表格。
• 当前 SDK surface 未暴露创建评论回复的 endpoint，只能通过 `list_comment_replies` 检索回复，不能创建回复。
• 非飞书文档、未启用 `feishu_doc` 或缺少 `docx:document`、`drive:drive` 等权限时不适用。