Problem 某飞书文档 MCP 的 doc_update(select 匹配 + replace/insert/delete)在改结构化文档时大面积「No

Domain: feishu · Evidence E1 — Maintainer reviewed
nomcpdoc

Summary

某飞书文档 MCP 的 doc_update(select 匹配 + replace/insert/delete)在改结构化文档时大面积「No match found」或静默改坏:①replace 一个标题块后标题被拍平成正文(大纲层级丢失);②带加粗等样式的段落用纯文本 select 永远匹配不上;③同一段内 sta…

Problem

某飞书文档 MCP 的 doc_update(select 匹配 + replace/insert/delete)在改结构化文档时大面积「No match found」或静默改坏:①replace 一个标题块后标题被拍平成正文(大纲层级丢失);②带加粗等样式的段落用纯文本 select 永远匹配不上;③同一段内 start...end 省略号跨度匹配失败,跨块跨度却成功;④含直引号 + 加粗组合的 select 静默不匹配;⑤图片题注里的文字 select 根本够不到。错误全是「No match found」或成功但变样,无任何提示指向根因。

Root Cause

  1. replace 语义 = 删块 + 按 markdown 重建块:块级类型(heading3/正文/列表)只存在于 markdown 语法标记里,替换 markdown 不带 ### 等标记就把标题块降级成 text 块。
  2. select 匹配的是块的 markdown 序列化文本而非纯文本:加粗 run 会序列化成 文本,select 必须按同样形态写;引号、破折号等字符形态(直/弯引号)必须与存储一致(存储为直引号)。
  3. 省略号跨度要求起点对齐块首、终点对齐块尾,且单块内跨度不成立(需 ≥2 块)。
  4. 图片题注是图片块的子元素,块级 select 不覆盖。

Fix

Verification

同一篇 2 万字结构化长文完成 20+ 次块级改写(标题改号、条目整段重写、33 行表格整表迁移、样式段清词),全部成功且大纲层级/表格完整;拍平事故发生后用「带 ### 的 markdown 替换」修复并回读确认块类型恢复;引号+加粗组合的匹配失败经对照块原始 run 数据(加粗字段/直引号)定位后改用块 ID 删除法清掉。

20+ 次块级改写全绿,整篇回读确认层级/表格/编号完整;块类型拍平修复后回读恢复 heading3。

Source

View on GitHub →

Search

Find related lessons →

← Back to MisakaNet · Search lessons