Lark Doc

docs

认证由 MCP server 自动处理，无需手动配置。

# 常用示例
lark_docs_fetch(doc="文档URL或token")
lark_docs_create(content='标题内容')
lark_docs_update(doc="文档URL或token", command="append", content='内容')

前置条件 — 执行操作前必读

CRITICAL — 执行对应操作前，MUST 先调用以下技能参考，缺一不可：

1. 读取文档（lark_docs_fetch） → 必读 lark_get_skill(domain="doc", section="fetch")（scope / detail 选择、局部读取策略、` / ` 输出结构）
2. 创建或编辑文档内容 → 必读 lark_get_skill(domain="doc", section="xml")（XML 语法规则，仅当用户明确要求 Markdown 时改读 lark_get_skill(domain="doc", section="md")）和必读 lark_get_skill(domain="doc", section="style/lark-doc-style")（写作原则：默认段落、按体裁、组件克制）；从零创建时加读 lark_get_skill(domain="doc", section="style/lark-doc-create-workflow")；编辑已有文档时加读 lark_get_skill(domain="doc", section="update") 和 lark_get_skill(domain="doc", section="style/lark-doc-update-workflow")

未读完以上参考就执行相应操作会导致参数选择错误或格式错误。

> 格式选择规则（全局）： > - 创建 / 导入场景（lark_docs_create，或 lark_docs_update 的 command="append"/"overwrite" 整段写入）：XML 和 Markdown 都可以。用户提供 .md 本地文件、或明确说"导入 Markdown"时，直接用 Markdown；否则默认 XML。 > - 精准编辑场景（lark_docs_update 的 str_replace / block_insert_after / block_replace / block_delete / block_move_after 等局部精修指令）：优先使用 XML（doc_format="xml"，即默认值）。XML 能稳定表达 block 结构和样式，局部精修更可控；不要因为 Markdown 更简单就自行切换。

快速决策

• 用户要复制文档 / 创建文档副本 / 另存为副本时，切到 lark_get_skill(domain="drive")，按其中的复制指引通过 lark_invoke(tool_name="lark_drive_files_copy", ...) 完成；不要用 lark_docs_fetch + lark_docs_create 重建正文，也不要走 lark_drive_export / lark_drive_import。
• 先判定任务路径：找文档 / 导入导出走 lark_get_skill(domain="drive")；只读 / 摘要用 lark_docs_fetch 默认 simple；明确旧文本 → 新文本直接 str_replace；只有 block 链接、评论锚点、插入 / 替换 / 删除 / 移动才局部 fetch with-ids；保真改写已有内容才读 full
• block 直达链接格式：文档基础 URL#block_id；没有 block_id 时局部 fetch with-ids
• 连续执行多个文档写操作时，必须按 lark_get_skill(domain="doc", section="update") 的「Block ID 生命周期」判断旧 block ID 是否还能复用；overwrite / block_replace / block_delete 后不要复用受影响的旧 ID，插入 / 复制后要重新 fetch 才能拿到新 block ID
• 用户需要在文档内创建、复制或移动资源块（画板、电子表格、多维表格等）时，必须先读取 lark_get_skill(domain="doc", section="xml") 的「三、资源块」章节
• 写文档时，由内容和用户意图决定表达形式；流程、架构、路线图、关键指标等信息可以使用画板，但不要默认把重要信息都画板化
• 新增或更新画板时，按 lark_get_skill(domain="doc", section="whiteboard") 选型；Mermaid 可由主 Agent 直接插入，SVG / 复杂图 / 已有画板更新按其中流程隔离到 SubAgent
• 用户说"看一下文档里的图片/附件/素材""预览素材" → 用 lark_docs_media_preview
• 用户明确说"下载素材" → 用 lark_docs_media_download
• 用户想把文档回滚到某个 revision_id 或某一时刻 → 先读 lark_get_skill(domain="doc", section="history")，按其中流程操作
• 用户明确说"下载/更新/删除文档封面图" → 用 lark_docs_resource_download / lark_docs_resource_update / lark_docs_resource_delete（type="cover"），详见 lark_get_skill(domain="doc", section="resource-cover")
• lark_docs_resource_* 目前仅支持 Docx 封面资源；其他图片、附件或素材请走 lark_docs_media_*
• 如果目标是画板/whiteboard/画板缩略图 → 只能用 lark_docs_media_download(type="whiteboard")（不要用 lark_docs_media_preview）
• 用户明确要操作思维笔记时；已有思维笔记，走思维笔记链路 lark_get_skill(domain="doc", section="mindnote")；新建思维笔记，走 lark_get_skill(domain="doc", section="whiteboard")
• 拿到 spreadsheet URL/token 后 → 切到 lark-sheets 做对象内部操作
• 用户需要统计文档的总字数 / 总字符数（word count / character count）时，先读取 lark_get_skill(domain="doc", section="word-stat")，并按其中流程调用 lark_exec_script(script="lark-doc/scripts/doc_word_stat.py", ...)；统计口径以该脚本为准，不要改用其他方式自行计算。
• 用户说"给文档加评论""查看评论""回复评论""给评论加/删除表情 reaction" → 切到 lark-drive 处理
• 文档内容中出现嵌入的 `、 或 ` 标签时 → 必须主动提取 token 并切到对应技能下钻读取内部数据，不能只呈现标签本身

| 标签 / 属性 | 提取字段 | 切到技能 | |-|-|-| | ` | token -> spreadsheet_token, sheet-id | lark-sheets | | | token -> app_token, table-id | lark-base | | | 同 | lark-sheets | | | 同 | lark-base | | | vc-node-id -> note_id | lark-note：先 larknotedetail(noteid="") | | | src-token -> doc_token, src-block-id -> block_id | 用 larkdocs_fetch` 读取 src-token 文档，定位 block |

Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装。有 Shortcut 的操作优先使用。

| Shortcut | 说明 | |----------|------| | lark_docs_create | Create a Lark document (XML / Markdown) | | lark_docs_fetch | Fetch Lark document content (XML / Markdown / im-markdown; im-markdown only after fetch for lark-im) | | lark_docs_update | Update a Lark document (strreplace / blockinsertafter / blockreplace / ...) | | lark_docs_history_list / lark_docs_history_revert / lark_docs_history_revert_status | List document history, revert to a history_version_id, and query revert task status；详见 lark_get_skill(domain="doc", section="history") | | lark_docs_media_insert | Insert a local image or file at the end of a Lark document (4-step orchestration + auto-rollback). Prefer from_clipboard=true when the image is already on the system clipboard (screenshots, copy from Feishu/browser); use file only for on-disk sources. | | lark_docs_media_download | Download document media or whiteboard thumbnail (auto-detects extension) | | lark_docs_media_preview | Preview document media file (auto-detects extension) | | lark_docs_resource_download / lark_docs_resource_update / lark_docs_resource_delete | Download, update, or delete a Docx cover image resource with type="cover"；详见 lark_get_skill(domain="doc", section="resource-cover") | | lark_docs_whiteboard_update | Alias of lark_whiteboard_update. Update an existing whiteboard with DSL, Mermaid or PlantUML. Prefer lark_whiteboard_update; refer to lark-whiteboard skill for details. |

不在本 Skill 范围

• 文档评论管理 → larkgetskill(domain="drive")
• 电子表格或 Base 的数据操作 → larkgetskill(domain="sheets") / larkgetskill(domain="base")
• 云空间文件上传、下载、权限管理 → larkgetskill(domain="drive")

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: ddpie
• Source: ddpie/lark-mcp-on-agentcore
• License: MIT

Install and usage instructions live in the source repository linked above.