feishu-docx

feishu-docx 是一款專為連接飛書 (Lark) 雲端工作空間與 AI Agent 工作流而設計的專業級 CLI 與 SDK 工具。它能夠無縫檢索並修改飛書文檔 (Docx)、試算表 (Sheets)、多維表格 (Bitable) 與知識庫 (Wiki) 的內容，是開發者與重度用戶進行知識管理與 AI 輔助分析的強大助手。透過將結構化的雲端文檔轉換為整潔的 Markdown 格式，該工具讓 AI 代理能夠讀取整個知識庫、總結會議記錄，或編寫程式來維護文檔內容。

• 完整支援飛書/Lark 文檔格式，包括 docx、sheets、bitable 以及複雜的 Wiki 層級結構。

• 進階導出功能，包含針對公開文檔的瀏覽器渲染模式、Wiki 空間批次處理，以及圖片與附件的本地下載。

• 完整的寫入回傳功能，支援從 Markdown 創建新文檔、追加內容到現有文件，或透過區塊 ID 精確更新特定段落。

• 整合雲空間管理功能，可透過 CLI 或內建的 Textual TUI 列出檔案、管理權限與進行安全行政操作。

• 整合微信公眾號文章，允許使用者將外部內容匯入飛書生態，或直接將文章導出為 Markdown。

• 設定與驗證：首次使用需設定應用憑證或執行 OAuth 2.0 授權，工具會自動刷新 Token 以確保 Agent 運行不中斷。

• 輸入與輸出：接受標準飛書/Lark URL 作為輸入，輸出高品質 Markdown，並支援 stdout 模式以供 AI Agent 直接呼叫。

• 瀏覽器導出：可選擇性使用 Playwright 捕獲需要瀏覽器會話才能顯示的內容 (如動態元素或私人連結)。

• 限制：需要 Python 3.11+ 環境，若需使用進階瀏覽器渲染則建議安裝 Playwright。針對熟悉命令行環境的開發者進行了高度優化。