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 配置文件中，以确保在不同环境间的可移植性与安全性。