feishu-docx

開源飛書文件匯出工具，支援將飛書雲文件匯出為Markdown格式

GitHub專案文件處理

https://github.com/leemysw/feishu-docx

前往官網

深度報告

feishu-docx 是一個開源的飛書/Lark 雲文件匯出工具，由開發者 leemysw 建立並維護。該工具支援將飛書文件、表格、多維表格匯出為 Markdown 格式，同時提供文件寫入能力。核心定位是讓 AI Agent 能夠直接讀寫飛書知識庫內容，解決手動複製貼上格式丟失的痛點。專案目前獲得 191 個 Star，採用 MIT 許可證開源。
feishu-docx 由個人開發者 leemysw 於 2026 年 1 月建立，在 GitHub 進行開源託管。專案最新版本為 v0.2.5，更新於 2026 年 4 月 11 日。該工具主要面向需要將飛書文件與外部系統整合的技術使用者，特別是使用 AI Agent 進行文件處理的開發者群體。隨著飛書在企業辦公場景的普及，越來越多的團隊選擇將文件儲存在飛書知識庫中。然而，無論是人工手動複製文件內容到其他平臺，還是讓 Claude、Cursor 等 AI Agent 操作飛書內容，都面臨格式丟失和效率低下的問題。feishu-docx 正是為了解決這一痛點而誕生的工具型產品。
feishu-docx 提供豐富的文件匯出和寫入功能，支援多種飛書文件型別的處理。文件匯出功能可以將 DocX 文件轉換為 Markdown 格式，保留文件的基本結構和格式資訊。表格匯出功能支援將飛書表格轉換為 Markdown 表格，適用於資料分析場景。Bitable（多維表格）匯出功能可以將複雜的飛書多維表格匯出為結構化的 Markdown 格式。知識庫匯出功能支援批次匯出整個飛書知識庫的文件，並保持原有的目錄層級結構。文件寫入功能允許將 Markdown 內容反向寫入飛書文件，實現雙向同步。此外還支援微信文章匯入匯出、瀏覽器匯出、雲空間管理、本地資源下載等輔助功能。從使用方式來看，使用者可以透過 Python 包方式安裝使用，需要 Python 3.11 以上版本。配置時需要提供飛書應用憑證（App ID 和 App Secret），透過飛書開放平臺建立企業自建應用並獲取相應許可權。支援的 AI Agent 平臺包括 Claude Code、Cursor、Trae 等主流工具，並提供了專門的 Claude Skill 配置。專案還提供 TUI 終端介面，方便使用者互動式操作。與同類工具相比，feishu-docx 的突出優勢在於對 AI Agent 的原生支援。專案內建了 Claude Skill，可以直接安裝在 Claude Code 或 Cursor 中使用，實現無縫的文件處理流程。同時支援雙向匯出寫入，不僅僅是匯出，還能夠將外部內容寫入飛書文件。
feishu-docx 採用開源免費模式，專案託管在 GitHub 上供免費使用，採用 MIT 許可證。這意味著個人使用者和企業使用者都可以免費使用該專案，無需支付任何費用。作為工具型開源產品，feishu-docx 目前沒有明確的商業變現計劃。其價值主要體現在技術便利性和社群貢獻上。對於企業使用者而言，雖然工具本身免費，但使用時需要具備一定的技術能力來配置飛書應用憑證，企業可能需要投入開發資源進行整合和維護。
從 V2EX 社群的討論來看，開發者對 feishu-docx 這類工具的需求明確存在。使用者在 V2EX 發帖表示，現在很多團隊的文件都在飛書裡，但不管是自己寫指令碼還是給 Claude、Cursor 這類 AI Agent 用，飛書內容都不太好讀取，feishu-docx 恰好解決了這個問題。技術使用者對飛書文件匯出工具的典型需求包括：備份知識庫文件以防資料丟失、將飛書文件遷移到其他平臺、讓 AI Agent 能夠分析飛書內容進行知識管理等。飛書文件格式轉換的難點主要在於飛書文件的複雜格式（包括嵌入的表格、圖片、程式碼塊等）在匯出時容易丟失，feishu-docx 透過針對飛書 API 的專門處理能夠在一定程度上保留文件格式。
飛書文件匯出需求在技術社群中具有一定的普遍性。隨著飛書、Notion、Notion API 等雲文件工具的普及，文件匯出和遷移成為常見的工具類需求。目前市場上存在多種飛書文件匯出方案，包括 feishu-docx、feishu-doc-export、feishu2md 等開源工具，以及 Cloud Document Converter 等瀏覽器外掛方案。各類方案在功能定位上有所差異：feishu-docx 強調 AI Agent 整合，適合開發工作流自動化；feishu-doc-export 提供更多格式支援（包括 DOCX 和 PDF）；瀏覽器外掛方案則面向技術能力較弱的普通使用者。飛書官方也提供了飛書 CLI 開源工具，支援 AI 操作飛書，但更側重於訊息、日曆、郵件等場景，文件匯出能力不如 feishu-docx 專注。
使用 feishu-docx 需要注意以下風險點：首先，需要在飛書開放平臺建立應用並獲取憑證，涉及飛書賬號許可權的授權，使用者需要自行評估安全風險；其次，匯出文件的格式保留程度受限於飛書 API 的能力，複雜的文件格式可能在匯出時有所丟失；此外，作為個人維護的開源專案，未來的功能更新和維護持續性取決於開發者的投入。
feishu-docx 適合以下使用者群體：技術開發者需要將飛書文件整合到自動化工作流中；AI Agent 使用者需要讓 Claude、Cursor 等工具能夠讀取飛書內容；需要備份飛書知識庫的管理員；需要進行文件遷移的使用者。對於不需要 AI Agent 整合的普通使用者，可以考慮使用 Cloud Document Converter 等瀏覽器外掛方案，操作更簡單。對於企業使用者，建議評估開源方案的安全性後再決定是否使用，必要時可以聯絡飛書官方獲取企業級的文件整合方案。
feishu-docx 是一款專注于飛書文件匯出的開源工具，核心價值在於讓 AI Agent 能夠直接讀寫飛書知識庫內容，適合技術開發者和工作流自動化場景。免費開源易用是它的主要優勢，但複雜的格式保留和長期維護方面需要使用者自行評估。對於有飛書文件匯出需求的開發者來說，這是一個值得嘗試的工具選擇。

使用者評論

Laura_Flores_202015

—

剛用 feishu-docx 把公司知識庫全部匯出到本地，格式保留得七七八八，比之前手動複製強太多了。支援 Claude Code 整合確實香。

KimberlyRichardson

—

救命稻草！離職被卡的時候靠它匯出了 500+ 文件，救了我的命。

墨染476_1

—

感謝作者，做了個小工具把飛書知識庫變成 AI 更容易讀寫的格式。現在給 Claude 下指令讓它讀飛書文件方便多了。

CJackson_996

—

比飛書官方 CLI 專注多了，那玩意兒側重訊息和日曆，文件匯出還是得用 feishu-docx。

暖陽_6

—

yyds！批次匯出技能庫太方便了，省了我一晚上加班。

PenguinPoolScott

—

裝了 Claude Skill 後直接讓 AI 幫我寫文件，爽飛。

Nicole313

—

用了一段時間，基本能滿足需求，就是圖片有時會丟希望能出影片教程。

CFlores_66

—

飛書文件轉 Markdown 這個需求太小眾了，感謝開發者填補空白。

68i7wk

—

免費的開源工具能做到這個程度已經很不錯了，要啥腳踏車。

MarkColeman

—

匯出速度感人，700多個文件 25 分鐘搞定。

JudithReed_20228

—

搭配 TUI 介面用，比純命令列友好太多了。

BPerezSr899

—

支援文件寫入，這點很實用，不僅僅是匯出，還能把外部內容寫回飛書。

Natalie_Hughes_2021

—

團隊文件全部遷移到本地存檔的需求完美解決。

夏軒

—

有技術問題作者回復挺快的，贊一個。

ANguyen_Pro

—

適合需要自動化工作流的團隊，個人開發者狂喜。

NoahVeum

—

給作者提了個 issue，沒幾天就修了，開源精神值得學習。

EagleEdge411

—

配置比想象的簡單，按照文件一步步來就行。

biggoose131

—

v0.2.5 更新後 Bitable 匯出更穩了。

Jack_AlvarezQ

—

格式保留程度和在飛書裡看差不多，滿足我的需求。

RPatelK

—

需要先飛書開放平臺建立應用獲取憑證這一步稍微有點門檻。建議出影片教程。

Virginia.Roberts_Max

—

企業微信文件也能用，意外驚喜。

PhilipSanders_2021

—

支援 Cursor 整合太香了，程式碼和文件一起管理。

GMurray_2021

—

備份和遷移用這個工具效率提升明顯，推薦。

月光635

—

MIT 協議商用無憂，白票黨狂喜。

JEdwards_2021

—

文件寫入功能太香了！把本地 md 檔案同步到飛書知識庫，整個流程自動化。

LI0QS

—

複雜表格格式有時會丟失，建議匯出後再手動檢查一遍。

eyritb1rsb007

—

適合 DevOps 和知識管理場景，已經安利給團隊了。

DorothyReed_2020

—

感謝作者開源，比收費的還好用。

Bobby_Vasquez2

—

多維表格匯出後格式居然保留了，感動！

NFTCollector357

—

個人維護的專案，能感覺到在認真做，期待更多功能。

feishu-docx

深度報告

使用者評論

相關連結

同類產品