SuperAPI AI 工具集

feishu-update-doc

办公与效率

查看项目

更新于 10-16 02:39

技能介绍

用途:更新飞书云文档内容,支持 7 种更新模式:append(追加)、overwrite(覆盖)、replace_range(定位替换)、replace_all(全文替换)、insert_before(前插入)、insert_after(后插入)、delete_range(删除)。优先使用局部更新,慎用 overwrite,因为覆盖会清空文档重写,可能丢失图片、评论等。

定位方式:定位类模式支持两种方式,二选一。selection_with_ellipsis 为内容定位,范围匹配用“开头内容...结尾内容”,精确匹配写完整内容;若内容本身含三个点,用 ... 转义。selection_by_title 为标题定位,格式如“## 章节标题”,自动定位整个章节。

可选参数:new_title 可在更新内容后同步更新文档标题,仅支持纯文本,长度 1-800 字符,可与任何 mode 配合。

返回值:成功返回 success、doc_id、mode、message、warnings、log_id;大文档超时进入异步模式,返回 task_id,再次调用 update-doc 仅传 task_id 查询状态;错误返回 error 与 log_id。replace_all 额外返回 replace_count。

用法示例:append 传 doc_id、mode、markdown;replace_range 传 selection_with_ellipsis 或 selection_by_title 加 markdown;delete_range 不需要 markdown。

最佳实践:小粒度精确替换,避开图片、画板、电子表格、多维表格、任务等以 token 存储、无法原样写回的内容;分步更新优于整体覆盖;insert 模式扩大定位范围时注意插入位置基于匹配范围边界;画板写入失败时按 warning 中的 whiteboard 标签用 replace_range 修正。

限制:Markdown 支持飞书扩展语法,详见 create-doc 工具文档;overwrite 可能丢失不可重建内容;replace_range 要求匹配唯一,replace_all 允许多处匹配但无匹配会报错。