lexiang-blocks

name	lexiang-blocks
description	乐享知识库已有页面的内容编辑与排版操作。【核心特征：用户提供了 lexiangla.com/pages/ 链接，并要求对该页面进行修改/编辑/追加/删除/移动操作】。当用户提到「乐享」「知识库」「lexiang」并明确指向已有页面做内容变更时使用。典型触发：「修改这个页面」「编辑一下这篇文档」「在页面里加个标题」「更新一下内容」「调整排版」「追加一段内容」「帮我改一下这个表格」「在这个页面后面插入…」「把这段移到前面」「删掉这个段落」「给这个页面加一段总结」「在 /pages/xxx 里创建标题」。【注意】：仅当操作目标是「已有页面」时才触发本 skill；创建全新文档请使用 writer/SKILL.md；仅浏览/搜索/阅读请使用 search/SKILL.md。支持 Block 级别的创建、更新、删除、移动、批量编辑，Markdown/HTML 转 Block 结构插入。

乐享 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 — 移动 Block
• block_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)

---

⚠️ 核心注意事项

1. Block ID 映射：block_id 为客户端临时 ID，服务端返回实际 ID 映射
2. 标题与内容平级：标题块不能包含 children，通过顶层 children 顺序体现文档结构
3. _mcp_fields 优化：所有工具支持 _mcp_fields 参数选择返回字段，减少 token 消耗
4. 参数不确定时以 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	常见错误排查