bookstack

BookStack API Skill 為您的 BookStack 文件系統提供了一個強大的介面。該工具專為技術作者、知識管理員與開發人員設計，連接了本地開發環境與集中式維基系統。它能實現文檔工作流的自動化，確保知識庫能隨著程式碼變更、部署記錄或專案更新而同步，無需手動操作瀏覽器。使用者可程式化地創建、讀取、更新與刪除 (CRUD) 書籍、章節與頁面，非常適合高效維護技術文件、內部維基或專案知識庫。

• 完整支援 REST API 互動，包括頁面提取、HTML/Markdown 內容更新，以及架子與書籍的組織管理。

• 內建全文檢索功能，可快速在大型執行個體中定位文檔。

• 支援 HTML 與 Markdown 內容格式，提供彈性的內容創作與更新方式。

• 支援自動化流程，可將外部文件工作流與知識庫同步，或進行大量內容匯入。

• 採用安全設計，透過本地設定檔儲存 API 憑證，確保敏感 Token 不會洩露在原始程式碼中。

• 在進行驗證前，請確保 BookStack 設定中已為您的使用者角色啟用「Access System API」權限。

• 在發送請求時務必包含正確的 User-Agent 標頭，特別是在 Cloudflare 保護下的站點，以避免發生 403 Forbidden 錯誤。

• 對於大規模內容更新，建議將內容存放在暫存檔中並傳遞給腳本，以避免命令列參數限制或跳脫字元問題。

• 腳本會自動處理內容格式轉換，必要時請使用 --markdown 旗標來進行輸入或讀取。

• 憑證應安全地儲存在 ~/.clawdbot/clawdbot.json 設定檔中，以確保在不同環境間的可攜性與安全性。