用途
本技能用于乐享文档的块编辑，面向需要对知识库页面进行结构化编辑的场景，包括增删改查文档块、表格操作、章节替换、内容导入导出。当用户提出编辑某页面、修改某章节、改表格、在文档中插入或追加内容、替换某个标题下的内容、导入 markdown 到文档，或 Agent 需要对文档进行多次修改时使用。
前置条件
需要 lx CLI 已配置并登录。
适用场景
进入场景包括：用户说"编辑某个页面"/"修改某个章节"/"改表格"；用户说"在文档里插入内容"/"追加内容"；用户说"替换某个标题下的内容"/"导入 markdown 到文档"；Agent 需要对文档进行多次修改。
边界（禁止在本技能中执行）
不要创建新页面：用户说"创建一个新页面"应切换到 lx-entry skill。 不要推送修改到远程：用户说"推送"/"commit"/"push"应切换到 lx-git skill。 不要浏览目录结构：用户说"浏览知识库"/"看看目录"应切换到 lx-sh skill。
主要能力
查询
lx block find 支持按文本/标题/类型搜索块，三种搜索模式：文本子串搜索（不区分大小写）；标题精确匹配（需完整标题文本）；按类型过滤（如 h2、table、code）。输出格式为可读摘要加 JSON（便于程序化消费）。
核心 CRUD 命令：lx block ls 列出子块（支持 -r 递归）；lx block get 获取块详情（支持 --format mdx 导出为 MDX）；lx block create 创建子块（支持 MDX 自动转换）；lx block update 更新块（支持 MDX 自动转换）；lx block delete 删除块及其子孙；lx block move 移动块到新位置。
高级命令（默认优先使用）：lx block table-get 读取表格结构；lx block table-set 修改单元格；lx block table-add-row 追加行；lx block table-del-row 删除行；lx block replace-section 按标题替换章节；lx block insert-after 在指定块后插入；lx block append 追加到末尾；lx block export 导出为 markdown/json；lx block tree 显示块树结构；lx block import 导入 markdown（自动分批）。
转换相关：lx block convert 进行 MDX ↔ Block JSON 本地转换（不经过服务端）；lx block export --format mdx 导出页面为 MDX 格式；lx block import 从 Markdown/MDX 文件导入（自动分批）。
使用方式
标准编辑循环
- 定位页面 → lx entry list-children / search_kb_search。
- 获取 entry_id 和 page block 信息。
- 查找目标块 → lx block find -q "关键词" -e <entry_id>。
- 执行编辑 → lx block update / insert-after / replace-section / table-set 等。
- 验证结果 → lx block get -b <block_id> -e <entry_id> --format mdx。
多次修改同一文档
先用 find 定位所有需要修改的块，一次性获取所有 block_id，再用获取到的 block_id 逐一修改。关键规则：不要让 agent 读完整 MDX 来找内容，用 lx block find 做索引式定位。例如按特定标题用 find -m heading -q "完整标题文本"，找包含某词的块用 find -q "关键词"，找所有表格用 find -m type -q "table"，找特定层级的标题用 find -m type -q "h2" 再筛选。
参数传递约定
所有 block 操作都需要 --entry-id / -e <entry_id>，这是 MCP 服务端的必填参数。例如：lx block ls -e <entry_id>；lx block find -q "关键词" -e <entry_id>；lx block update -b <block_id> -e <entry_id> --text "新内容"。
命令选择（决策树）
需要查找/定位块：按文本搜索用 lx block find -q "关键词" [-m text]；按标题精确匹配用 lx block find -q "标题文本" [-m heading]；按类型过滤用 lx block find -q "h2/table/code" [-m type]；看树形结构用 lx block tree。 修改表格：读取表格用 lx block table-get；改单元格用 lx block table-set；加一行用 lx block table-add-row；删一行用 lx block table-del-row。 替换某个章节用 lx block replace-section；在某处插入内容用 lx block insert-after；在页面末尾追加用 lx block append；导入整个 markdown 文件用 lx block import；导出文档内容用 lx block export。 精细控制单个块：读取块用 lx block get；创建块用 lx block create；更新块用 lx block update；删除块用 lx block delete；移动块用 lx block move；转换内容用 lx block convert。
高风险操作与默认优先路径
高级命令优先，原子命令兜底：能用高级命令（table-* / replace-section / import 等）就不要读原子命令；原子命令只在高级命令无法表达时使用；查询优先用 find，不要 ls 加人肉筛选。默认优先路径：先查再改（find 定位目标块后执行修改）；表格操作使用 table-* 高级命令；章节替换使用 replace-section；批量导入使用 import --chunk-size 20 自动分批；精细控制单个块才回退到原子命令。大文档必须分批：大文档导入使用 lx block import --chunk-size 20 自动分批，避免单次请求过大。
典型组合流程
Agent 编辑文档的标准流程
确认目标页面（从上下文或搜索获得 entry_id），查找需要修改的块，执行修改（用上一步获得的 block_id），验证修改结果。
修改多个不相关的块
一次搜索找到所有目标（find 带 --limit），逐个修改。
修改表格单元格
先 table-get 查看，再 table-set 修改。
替换文档中的某个章节
使用 replace-section 配合 --heading 和 --file。
使用原子命令精细编辑
创建块（MDX 自动转换），批量更新（--descendant）。
AI 生成 MDX 结构化内容导入
方式 1：直接导入 .mdx 文件（import --file，带 --chunk-size）。 方式 2：导出页面为 MDX 格式（export --format mdx --output）。 方式 3：转换预览（不写入，只看结果）使用 lx block convert --from mdx --to blocks。
限制
需 lx CLI 已配置并登录；所有 block 操作必须提供 --entry-id；大文档需用 import --chunk-size 分批以避免单次请求过大。MDX 格式参考详见 mdx-reference.md，高级命令参考详见 block-advanced.md。