feishu-doc-manager

Feishu Doc Manager 是一款專為習慣使用 Markdown 進行編寫，並以飛書（Lark）作為知識庫的團隊與開發者所設計的自動化工具。它有效消弭了本地 Markdown 編輯環境與飛書文檔之間的鴻溝，解決了手動複製貼上與格式調整的繁瑣過程。

本工具專門處理文檔工作流程中的核心痛點，包括 Markdown 表格渲染失敗、複雜的協作者權限設定以及長文檔寫入限制。透過整合飛書開放平台 API，該工具能確保您的結構化 Markdown 內容（如標題、清單、粗體與程式碼區塊）能精準轉換為飛書 DocX 格式，非常適合技術寫作、產品經理及工程團隊維護內部 Wiki 與專案規範。

• 智慧 Markdown 渲染：自動將標準 Markdown 語法轉換為飛書 DocX 區塊，特別優化了表格與清單處理，確保文檔格式美觀。

• 批量操作能力：支援新建文檔、全量寫入、追加內容以及程式化更新或刪除指定區塊。

• 細緻權限管理：直接透過命令行管理協作者，更新文檔存取層級（檢視/編輯/完整存取），並查詢現有文檔權限。

• 內容處理機制：針對長內容自動進行分段處理，有效避免 API 400 錯誤，確保技術規範與日誌能穩定同步。

• 請確保已取得飛書應用程式的必要權限，包括 docx:document、docx:document:write_only 與 docs:permission.member。

• 本工具區分 write/append（文檔級操作）與 update_block（區塊級操作），請依據需求選擇。

• 輸入為本地 .md 檔案或 Markdown 字串，輸出則直接同步至飛書雲端工作區。

• 請確保在環境配置中正確設定 Document ID 與工作區權限 Token，以確保 API 通訊安全。