用途:该 Skill 用于自动写入飞书文档内容,支持 Markdown 自动转换为飞书 Block,适合在需要创建或更新飞书文档时调用。
主要能力:可写入标题、文本、列表、代码块、表格、图片等 Block;支持 Markdown 语法转换,如标题、无序/有序列表、代码块、引用、分割线、粗体、斜体、行内代码、删除线、待办、标准 Markdown 表格;还支持自定义扩展语法如高亮块(:::callout ... :::)和分栏(:::grid cols=N ... :::,2-4 列)。
使用方式:脚本执行时需提供飞书应用凭证 FEISHU_APP_ID 与 FEISHU_APP_SECRET,示例:FEISHU_APP_ID=xxx FEISHU_APP_SECRET=xxx node ./scripts/write-to-feishu.js <markdown_file> --title "文档标题";写入已有文档:FEISHU_APP_ID=xxx FEISHU_APP_SECRET=xxx node ./scripts/write-to-feishu.js content.md --doc-id <document_id>。API 侧包括创建文档 POST https://open.feishu.cn/open-apis/docx/v1/documents,创建块 POST .../documents/{document_id}/blocks/{block_id}/children,嵌套块 .../descendant。
流程:检查凭证,准备 Markdown 内容,执行写入命令,返回文档链接。
限制:每次 API 调用间隔至少 200ms 避免 429;需 docx:document 权限并获取 tenant_access_token 或 user_access_token;高亮块、表格、分栏等需分步创建,推荐使用 descendant API;自定义 block_id 在文档内必须唯一;Page 块不能作为子块添加,TableCell 只能通过表格操作添加;表格单元格内不允许添加 Table、Sheet 等块,分栏列内不允许添加 Grid 块;建议使用 document_revision_id=-1 操作最新版本;需处理 400177xxx 系列常见错误码。官方未提供具体收费与价格信息。