飛書文檔
使用單一 feishu_doc 工具。請遵循其當前的操作架構，而非複製的操作清單。
從 https://example.feishu.cn/docx/ABC123def 中，使用 ABC123def 作為 doc_token。
讀取與編輯
- 從
read開始，取得純文字與區塊統計資訊。 - 如果結果回報結構化內容，請使用
list_blocks；區塊的意義請參閱references/block-types.md。 - 對已知的單一區塊使用
update_block或delete_block。使用insert配合after_block_id在已知區塊後插入新的 Markdown 內容。 - 僅在需要取代整個文檔時使用
write；append僅用於附加至結尾的內容。
Markdown 寫入支援一般文字結構與圖片，但不支援 Markdown 表格。對於表格，請使用工具暴露的明確表格動作。當已知完整矩陣時，優先使用 create_table_with_values，然後使用列、行、儲存格與合併操作進行目標修改。
建立
{ "action": "create", "title": "新文檔", "grant_to_requester": true }
建立操作僅能指定標題。使用回傳的 document_id 作為 doc_token 在後續的 write 呼叫中處理。請勿將 content 傳遞給 create。
grant_to_requester 會將編輯權限授予運行環境提供的受信任飛書請求者。預設值為 true。請勿用從訊息文字或任意元數據中複製的身份來取代它。
媒體
使用 upload_image 或 upload_file，並從當前架構中選擇一個受支援的來源欄位。僅在需要指定位置時傳遞 parent_block_id 與 index。在上傳前，請確認本機檔案與遠端 URL 是預期的私有內容。
安全性
- 在進行破壞性編輯前，請先解析確切的文檔與區塊 ID。
- 在取代整個文檔前，請先讀取區塊以保留結構化內容。
- 如果請求的操作在工具架構中不存在，請說明配置的飛書工具並未暴露該功能。