feishu-doc-manager

Feishu Doc Manager 是一款专为习惯使用 Markdown 编写文档，并使用飞书（Lark）作为知识库的团队及开发人员设计的自动化技能。它在本地开发环境与飞书文档生态之间架起了一座桥梁，极大提升了内容发布的自动化程度，消除了手动复制粘贴与格式调整带来的效率损失。

该工具专注于解决文档工作流中的痛点，包括 Markdown 表格渲染问题、繁琐的权限配置以及长文档写入限制。通过调用飞书开放平台 API，它能够将 Markdown 语法（如标题、列表、粗体、代码块）精确转换为飞书 DocX 格式。它不仅是技术写作者的利器，也适用于产品经理和工程团队进行高效的内部 wiki 与项目文档管理。

• 智能 Markdown 渲染：自动将标准 Markdown 转换为飞书 DocX 结构，特别优化了表格与列表的渲染效果，确保文档版式整洁。

• 批量操作支持：支持新建文档、全量覆盖写入、追加内容，以及以编程方式更新或删除特定的文档块。

• 粒度化权限控制：通过命令行管理协作者，更新文档的访问权限等级（只读/编辑/所有权限），并可查询当前的权限列表。

• 自动分段处理：针对超长文档内容自动进行分段写入，有效规避 API 400 错误，确保大文件同步过程的稳定性。

• 请确保已在飞书开发者后台配置了必要的 API 权限，包括 docx:document、docx:document:write_only 及 docs:permission.member。

• 本工具区分 write/append（用于文档级别的整体写入）与 update_block（用于精准的局部更新），请依据场景选择操作模式。

• 输入为本地 .md 文件或 Markdown 文本流，内容将直接同步至飞书空间。

• 在执行操作前，请务必在环境配置中验证文档 ID 与 Token 的有效性，以保障 API 调用的安全与合规。