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。针对熟悉命令行环境的开发者进行了高度优化。