infometa 乐享 Block 操作
基础知识：数据模型、URL 规则、写入安全规则、Block 完整类型定义见
base/SKILL.md。 前置条件：本 skill 需要已配置乐享 MCP 连接。如未配置，请先读取setup/SKILL.md。 遇到 401 错误：不要重试，读取setup/SKILL.md引导用户续期（点击续期按钮即可恢复，无需重新配置）。 安全规则：Block 写入操作必须基于用户明确提供的目标信息，禁止 Agent 自行遍历或猜测写入目标。
工具概览
🧩 Block 操作
block_convert_content_to_blocks— Markdown/HTML 转 Block 结构block_create_block_descendant— 创建 Block 结构block_update_block— 单块更新block_update_blocks— 批量更新block_move_blocks— 移动 Blockblock_delete_block_children— 删除子节点block_delete_block— 删除指定 Block（含子孙）block_describe_block— 获取单个 Block 详情block_list_block_children— 读取 Block 内容
Block 结构核心规则
完整 Block 类型定义（含 attachment、video 等）见
base/SKILL.md或references/block-schema.md。
🍃 叶子节点（不能有 children）
标题块(h1~h5)、代码块(code)、图片块(image)、分割线(divider)、图表块(mermaid/plantuml)、附件块(attachment)、视频块(video)
📦 容器节点（必须指定 children）
提示框(callout)、表格(table/table_cell)、分栏布局(column_list/column)、折叠块(toggle)
⚠️ 核心注意事项
- Block ID 映射：
block_id为客户端临时 ID，服务端返回实际 ID 映射 - 标题与内容平级：标题块不能包含 children，通过顶层
children顺序体现文档结构 _mcp_fields优化：所有工具支持_mcp_fields参数选择返回字段，减少 token 消耗- 参数不确定时以
get_tool_schema(tool_name="xxx")返回为准
参考文档
| 文档 | 说明 |
|---|---|
references/block-schema.md |
Block 类型完整字段定义 |
references/mcp-examples.md |
复杂 Block 结构示例 |
references/markdown-to-block.md |
Markdown 转 Block 指南 |
references/block-update.md |
批量更新 Block 方法 |
references/content-reorganize.md |
文档结构重组方案 |
references/common-errors.md |
常见错误排查 |