@amaster.ai/pi-lark 0.1.7 → 0.1.9

package/skills/lark-slides/references/lark-slides-pptx-template-workflows.md

@@ -1,85 +1,5 @@
-# PPT Template Rewrite Principles
+# PPT Template Rewrite Principles（兼容入口）
 
-核心原则：模板不是风格参考，而是必须沿用的编辑底稿。
+本文档已迁移至 [`workflow/template-editing.md`](workflow/template-editing.md)。
 
-## Import First
-
-如果用户提供的模板是 PPTX 格式，先把模板导入成 Lark Slides。后续写入目标是导入后的 Slides，不是新建一个脱离模板的 deck，也不是先在本地重画 PPTX 再导入。
-
-直接使用以下命令，不需要先加载 `lark-drive` Skill：
-
-```bash
-lark-cli drive +import --as user --file "<template.pptx>" --type slides --json
-```
-
-可选参数：用 `--name "<title>"` 指定导入后的 Slides 标题；用 `--folder-token <FOLDER_TOKEN>` 指定目标文件夹。若返回 `ready=false` / `timed_out=true`，直接执行返回值里的 `next_command`；等价形式是：
-
-```bash
-lark-cli drive +task_result --scenario import --ticket <TICKET>
-```
-
-## Read Before Editing
-
-导入后必须阅读 Slides 内容，理解每页的真实版式、字体、层级、图片、图表、shape、表格和文本容器。阅读结果是后续编辑的事实来源。
-
-阅读页面时至少判断：
-
-- 该页原本承担的角色，例如封面、章节页、目录、流程、对比、数据、总结。
-- 该页的主要版式结构，例如图文关系、箭头、时间线、节点、表格、图表、左右对照、背景图或产品图。
-- 哪些文本框、shape 标签、表格单元格或图表标签承载内容。
-- 原页面的字体、字号、颜色、对齐、层级和留白关系。
-
-## Edit The Imported Slides Directly
-
-理解页面后，直接在导入后的 Slides 上编辑。允许的操作包括：
-
-- 填写、替换、凝练或删除文字。
-- 替换或补充图片。
-- 更新图表、表格、数字标签或节点标签里的内容。
-- 按需复制、删除或重排模板页。
-- 在源页面没有合适承载位置时，做局部、小范围新增元素。
-
-新增元素只能补足内容缺口，不能成为新的主版式。页面主体仍应由模板原有版式承载。
-
-## Preserve Design
-
-编辑必须严格沿用原版式和字体，只改内容，不做设计。
-
-默认保留：
-
-- 页面布局、视觉层级、留白和对齐关系。
-- 原字体、字号体系、颜色、文本框位置和 shape 顺序。
-- 背景图、图片、logo、图表、表格、装饰形状、线条、图标和页面结构。
-- 模板中不同页型之间的差异。
-
-不要把模板页改造成统一的通用卡片、空白板式布局、标题栏、三栏、2x2 卡片或大面积遮罩。不要把模板当作背景图后另起一套设计系统。
-
-## Content Only
-
-内容必须优先进入原页面已有的文本框、shape 标签、节点、表格单元格、图表标签或注释容器。
-
-如果原容器空间不足，优先：
-
-- 凝练文字。
-- 降低字号但保持原字体体系。
-- 拆分到页面已有的邻近容器。
-- 使用模板已有的注释、标签或补充说明区域。
-- 复制同页或同模板中的原生容器样式做局部补充。
-
-不要为了容纳长文案而重画页面主体结构。不要用新增大卡片遮住原图表、箭头、图片、背景或关键 shape。
-
-## Readback And Tune
-
-完成编辑后必须回读结果，并逐页微调。
-
-回读时重点检查：
-
-- 文字是否溢出、截断、压线或超出容器。
-- 文本是否遮挡图片、图表、shape、箭头、节点或其他文字。
-- shape 顺序是否导致内容被覆盖或遮住。
-- 新内容是否仍然落在模板原有版式中，而不是覆盖模板结构。
-- 字体、字号、颜色、对齐和层级是否仍贴近原页。
-
-发现文字溢出时，优先凝练文字或缩减字号。发现遮挡时，调整 shape 顺序、局部位置或复用原有空白区域解决。只有在这些方法都不能满足内容表达时，才做局部新增或删除。
-
-完成标准是“原模板的版式、字体和视觉结构仍清晰存在，内容已经被准确替换，并且回读后没有溢出和遮挡”。
+此文件仅保留旧路径兼容性；后续引用请使用新路径。

package/skills/lark-slides/references/lark-slides-replace-slide.md

@@ -1,237 +1,5 @@
-# slides +replace-slide（块级替换 / 插入）
+# slides +replace-slide（兼容入口）
 
-对指定 slide 做块级替换或插入。编辑已有 PPT 的主路径——`slide_id` 不变、页序不动、只影响被指定的块。
+本文档已迁移至 [`cli/lark-slides-replace-slide.md`](cli/lark-slides-replace-slide.md)。
 
-相比直接调 `xml_presentation.slide.replace`，这个 shortcut 的四个额外价值：
-
-1. `--presentation` 接受 `xml_presentation_id` / `/slides/` URL / `/wiki/` URL（wiki 自动解析）；
-2. `block_replace` 的 `replacement` 根元素 `id="<block_id>"` 由 CLI 自动注入——底层 API 的硬约束（不注入返回 3350001）；直接调原生 API 需自己加，用 Shortcut 则自动注入；
-3. `<shape>` 元素缺少 `<content/>` 子元素时由 CLI 自动注入——SML 2.0 schema 要求每个 `<shape>` 必须有 `<content/>` 子元素，缺失同样触发 3350001；自闭合的 `<shape .../>` 也会被自动展开为 `<shape ...><content/></shape>`；
-4. 3350001 错误时提供上下文感知的 hint，帮助 AI agent 和用户快速定位原因。
-
-## 命令
-
-```bash
-# block_insert：在页末追加一个新元素
-lark-cli slides +replace-slide --as user \
-  --presentation slidesXXXXXXXXXXXXXXXXXXXXXX \
-  --slide-id pfG \
-  --parts '[{"action":"block_insert","insertion":"<shape type=\"rect\" topLeftX=\"500\" topLeftY=\"100\" width=\"200\" height=\"100\"/>"}]'
-
-# block_replace：已知某块 id，整块替换（replacement 根 id 自动注入为 bUn）
-lark-cli slides +replace-slide --as user \
-  --presentation slidesXXXXXXXXXXXXXXXXXXXXXX \
-  --slide-id pfG \
-  --parts '[{"action":"block_replace","block_id":"bUn","replacement":"<shape type=\"text\" topLeftX=\"80\" topLeftY=\"80\" width=\"800\" height=\"120\"><content textType=\"title\"><p>新标题</p></content></shape>"}]'
-
-# 大 --parts 走文件或 stdin（auto-gen 命令不支持 @file，但 shortcut 支持）
-lark-cli slides +replace-slide --as user \
-  --presentation $PID --slide-id $SID --parts @parts.json
-cat parts.json | lark-cli slides +replace-slide --as user \
-  --presentation $PID --slide-id $SID --parts -
-
-# wiki URL 直接传（CLI 自动 get_node → 拿真实 xml_presentation_id）
-lark-cli slides +replace-slide --as user \
-  --presentation "https://xxx.feishu.cn/wiki/wikcnXXXXXX" --slide-id pfG \
-  --parts '[{"action":"block_insert","insertion":"<shape type=\"rect\" width=\"100\" height=\"100\"/>"}]'
-
-# 预览（不实际调用）
-lark-cli slides +replace-slide --as user \
-  --presentation $PID --slide-id $SID --parts "$PARTS" --dry-run
-```
-
-## 参数
-
-| 参数 | 必填 | 说明 |
-|------|------|------|
-| `--presentation` | 是 | `xml_presentation_id`、`/slides/<token>` URL，或 `/wiki/<token>` URL |
-| `--slide-id` | 是 | 页面 ID（`xml_presentation.slide.get` / `slides +xml-get` 都能拿到） |
-| `--parts` | 是 | JSON 数组（`[{...}, ...]`），单次最多 200 条。支持 `@<file>` 和 `-`（stdin）读取 |
-| `--revision-id` | 否 | 基础版本号；默认 `-1` 表示基于最新版执行；传具体版本号时，服务端以该版本为 base 执行；**传不存在的版本号（超过当前 revision）返回 3350002** |
-| `--tid` | 否 | 并发事务 ID；多人协作长事务才用，单次单人调用留空 |
-
-## parts 元素结构
-
-> **限制**：最多 200 条；`block_replace` 和 `block_insert` 可以在同一批次混用。**其他 action（含 `str_replace`）CLI 会直接报错拒绝**。
-
-每条 part 按 `action` 取不同字段：
-
-### action = `block_replace`
-
-| 字段 | 必填 | 说明 |
-|------|------|------|
-| `action` | 是 | `"block_replace"` |
-| `block_id` | 是 | 目标块的 3 位 short element ID（从 `slide.get` 返回 XML 里读） |
-| `replacement` | 是 | 新 XML 片段；**根元素 `id` 会被 CLI 自动注入为 `block_id`**，用户不用自己加（如果已经加了且不一致会被覆盖为正确值） |
-
-### action = `block_insert`
-
-| 字段 | 必填 | 说明 |
-|------|------|------|
-| `action` | 是 | `"block_insert"` |
-| `insertion` | 是 | 要插入的 XML 片段 |
-| `insert_before_block_id` | 否 | 插到这个块之前；省略（不提供此字段）则追加到页末 |
-
-## 合法根元素速查
-
-`block_replace.replacement` 和 `block_insert.insertion` 必须以 SML 2.0 定义的合法元素为根。完整权威定义看 [`slides_xml_schema_definition.xml`](slides_xml_schema_definition.xml)；这里只列能作为**根**的类型 + 每种类型的最小可工作片段。
-
-| 元素 | 用途 | 关键点 |
-|---|---|---|
-| `<shape>` | 矩形/椭圆/三角/文本框等所有形状 | `type` 必填；`<content/>` 缺失时 CLI 会自动注入 |
-| `<line>` | 直线 | 需 `startX/startY/endX/endY` |
-| `<polyline>` | 折线 | `points` 读回时被服务端规整丢弃（几何已入库） |
-| `<img>` | 图片 | `src` 必须是 [`+media-upload`](lark-slides-media-upload.md) 返回的 `file_token`，不能是 URL |
-| `<icon>` | 图标 | `iconType` 取自 iconpark 资源；语义图标先用 `scripts/iconpark_tool.py search` 检索 |
-| `<table>` | 表格 | 整表替换会**重建内部 td id**，旧 td block_id 立即失效 |
-| `<td>` | 单元格局部替换 | 只能 `block_replace`，不能 `block_insert`；`block_id` 必须是最新 `slide.get` 拿到的 td id |
-| `<chart>` | 图表（line/bar/column/pie/area/radar/combo） | 必须嵌 `<chartPlotArea>` + `<chartData>` + `<dim1>/<dim2>/<chartField>` |
-
-**不可作为根元素**：
-
-- `<video>` / `<audio>` —— SML 2.0 没有这两个原生元素；`<undefined type="video|audio">` 是**导出时**的占位符（服务端遇到不支持的类型时用它代替），**不能写入**。尝试 insert/replace 都会返回 3350001。
-
-### 最小 XML 片段（JSON 嵌入时记得把 `"` 转义成 `\"`）
-
-`<shape>`（文本框；`type` 还可选 `rect`/`ellipse`/`triangle`/`custom` 等）：
-```xml
-<shape type="text" topLeftX="80" topLeftY="80" width="800" height="120">
-  <content textType="title"><p>标题</p></content>
-</shape>
-```
-
-`<img>`：
-```xml
-<img src="{file_token}" topLeftX="600" topLeftY="20" width="80" height="80"/>
-```
-
-`<polyline>`：
-```xml
-<polyline topLeftX="10" topLeftY="10" width="100" height="50" points="0,0 50,50 100,0"/>
-```
-
-`<table>`（2×2）：
-```xml
-<table topLeftX="30" topLeftY="80">
-  <colgroup><col span="2" width="110"/></colgroup>
-  <tr><td><content><p>A</p></content></td><td><content><p>B</p></content></td></tr>
-  <tr><td><content><p>C</p></content></td><td><content><p>D</p></content></td></tr>
-</table>
-```
-
-`<td>`（`block_replace` 单元格；`block_id` 必须是最新 `slide.get` 拿到的 td id）：
-```xml
-<td><content><p>新内容</p></content></td>
-```
-
-`<chart>`（`type` 改成 `bar`/`column`/`pie`/`area`/`radar`/`combo` 切换图型）：
-```xml
-<chart topLeftX="30" topLeftY="300" width="300" height="200">
-  <chartPlotArea><chartPlot type="line"/></chartPlotArea>
-  <chartData>
-    <dim1><chartField name="x" valueType="string">Q1,Q2,Q3,Q4</chartField></dim1>
-    <dim2><chartField name="Sales" valueType="number">10,20,15,30</chartField></dim2>
-  </chartData>
-</chart>
-```
-
-## 返回值
-
-```json
-{
-  "xml_presentation_id": "slidesXXXXXXXXXXXXXXXXXXXXXX",
-  "slide_id": "pfG",
-  "parts_count": 1,
-  "revision_id": 102
-}
-```
-
-| 字段 | 说明 |
-|------|------|
-| `xml_presentation_id` | 解析后的真实 token（wiki URL 解析后会变化） |
-| `slide_id` | 与入参一致 |
-| `parts_count` | 本次提交的 parts 条数 |
-| `revision_id` | 成功后的新版本号，下次做乐观锁时用 |
-| `failed_part_index` | 有部分失败时存在，指向第几条 part 失败 |
-| `failed_reason` | 失败原因文字描述 |
-
-整批作为原子事务：任一 part 失败则整批不生效，服务端通过 `failed_part_index` / `failed_reason` 告诉你是哪条；按此定位修正后重发。
-
-## 使用流程
-
-### 给已有页加图（典型场景）
-
-```bash
-PID=xxx
-SID=yyy
-
-# 1) 上传图片
-TOKEN=$(lark-cli slides +media-upload --as user \
-  --file ./pic.png --presentation "$PID" | jq -r '.data.file_token')
-
-# 2) block_insert 到页末
-lark-cli slides +replace-slide --as user \
-  --presentation "$PID" --slide-id "$SID" \
-  --parts "$(jq -n --arg token "$TOKEN" \
-    '[{action:"block_insert",insertion:("<img src=\""+$token+"\" topLeftX=\"500\" topLeftY=\"100\" width=\"200\" height=\"150\"/>")}]')"
-```
-
-### 改标题（block_replace）
-
-```bash
-# 先拿原页 XML，从里面找到标题块的 3 位 short id（如 bUn）
-lark-cli slides xml_presentation.slide get --as user \
-  --params "{\"xml_presentation_id\":\"$PID\",\"slide_id\":\"$SID\"}"
-
-# block_replace 换掉整个标题块（id 自动注入）
-lark-cli slides +replace-slide --as user \
-  --presentation "$PID" --slide-id "$SID" \
-  --parts '[{"action":"block_replace","block_id":"bUn","replacement":"<shape type=\"text\" topLeftX=\"80\" topLeftY=\"80\" width=\"800\" height=\"120\"><content textType=\"title\"><p>新标题</p></content></shape>"}]'
-```
-
-### 批量：一次换标题 + 追加装饰图
-
-`block_replace` 和 `block_insert` 可以在同一个 `--parts` 里混用，整批原子执行。
-
-```bash
-lark-cli slides +replace-slide --as user \
-  --presentation "$PID" --slide-id "$SID" \
-  --parts '[
-    {"action":"block_replace","block_id":"bab","replacement":"<shape type=\"text\" topLeftX=\"80\" topLeftY=\"80\" width=\"800\" height=\"120\"><content textType=\"title\"><p>新标题</p></content></shape>"},
-    {"action":"block_insert","insertion":"<img src=\"<file_token>\" topLeftX=\"700\" topLeftY=\"400\" width=\"180\" height=\"100\"/>"}
-  ]'
-```
-
-### 乐观锁
-
-```bash
-# 读时记录 revision_id
-REV=$(lark-cli slides xml_presentation.slide get --as user \
-  --params "{\"xml_presentation_id\":\"$PID\",\"slide_id\":\"$SID\"}" \
-  | jq '.data.revision_id')
-
-# 写时传 --revision-id；传不存在的版本号（超过当前 revision）返回 3350002
-lark-cli slides +replace-slide --as user \
-  --presentation "$PID" --slide-id "$SID" --revision-id "$REV" \
-  --parts "$PARTS"
-```
-
-## 常见错误
-
-| 现象 | 原因 | 对策 |
-|------|------|------|
-| 3350001 + hint "block_id not found" | `parts[i].block_id` 在当前页不存在 | 重新 `slide.get` 拿最新 XML，按里面的 short ID 再填 |
-| 3350002 not found | `--revision-id` 传了不存在的版本号（超过当前 revision） | 用 `-1` 或用 `slide.get` 拿到的有效 `revision_id` |
-| `--parts[i] action "str_replace" is not supported` | CLI 不暴露 `str_replace` | 把替换需求改写成 `block_replace` / `block_insert` |
-| `--parts contains N items, exceeds maximum of 200` | 一次提交 parts 太多 | 拆多次调用 |
-| `--parts[i] (block_replace) requires non-empty block_id` / `replacement` | 字段缺失 | 按 parts 元素结构补齐 |
-| `<img>` 不显示 / 显示破图 | `src` 写了外链 URL | 换成通过 [`+media-upload`](lark-slides-media-upload.md) 拿到的 `file_token` |
-| 3350001 | `replacement` 不是合法单根 XML 片段，或 `block_id` 不存在 | CLI 已自动注入 `id` 和 `<content/>`；如果仍报错，重新 `slide.get` 拿最新 XML 确认 `block_id` 存在；检查 XML 结构是否合法；坐标是否超出 960×540 |
-| 403 | 权限不足 | 需要 `slides:presentation:update` 或 `slides:presentation:write_only`；wiki URL 还需要 `wiki:node:read` |
-
-## 相关命令
-
-- [xml_presentation.slide get](lark-slides-xml-presentation-slide-get.md) — 读原页拿 `block_id` / `revision_id`
-- [xml_presentation.slide replace](lark-slides-xml-presentation-slide-replace.md) — 底层 replace API 参考
-- [+media-upload](lark-slides-media-upload.md) — 上传图片拿 `file_token`
-- [lark-slides-edit-workflows.md](lark-slides-edit-workflows.md) — 读-改-写闭环 + 决策树
+此文件仅保留旧路径兼容性；后续引用请使用新路径。

package/skills/lark-slides/references/lark-slides-screenshot.md

@@ -1,97 +1,5 @@
-# slides +screenshot
+# slides +screenshot（兼容入口）
 
-## 用途
+本文档已迁移至 [`cli/lark-slides-screenshot.md`](cli/lark-slides-screenshot.md)。
 
-获取幻灯片页面截图并保存为本地图片文件。默认用于已存在 PPT 页面截图；传入 `--content` 时用于直接渲染单个 `<slide>` XML 片段预览。本 shortcut 会在 CLI 进程内解码并写入文件，stdout 只返回文件路径、大小、页面 ID 等元信息，避免把图片 Base64 输出给模型。
-
-截图失败则降级到 XML 读回、结构 lint等非截图检查路径。
-
-## 命令
-
-```bash
-lark-cli slides +screenshot --as user \
-  --presentation '<xml_presentation_id 或 slides/wiki URL>' \
-  --slide-number 1
-```
-
-渲染本地 XML 内容：
-
-```bash
-lark-cli slides +screenshot --as user \
-  --content @slide.xml
-```
-
-## 参数
-
-| 参数 | 必需 | 说明 |
-|------|------|------|
-| `--presentation` | list 模式必需 | `xml_presentation_id`、`/slides/` URL，或解析后为 slides 的 `/wiki/` URL。传 `--content` 时不能使用 |
-| `--slide-id` | list 模式至少提供 `--slide-id` / `--slide-number` 之一 | 页面 short ID；多页截图时重复传入，或用逗号分隔一次传多个（如 `--slide-id slide_1,slide_2`）；一次最多 10 页（`--slide-id` + `--slide-number` 合计小于等于 10） |
-| `--slide-number` | list 模式至少提供 `--slide-id` / `--slide-number` 之一 | 页面页号；多页截图时重复传入，或用逗号分隔一次传多个（如 `--slide-number 1,2,3`）；一次最多 10 页（`--slide-id` + `--slide-number` 合计小于等于 10） |
-| `--content` | render 模式必需 | 要直接渲染的 `<slide>` XML 片段；支持直接传值、`@file`、`-` stdin。传入后不能同时传 `--slide-id` / `--slide-number` |
-| `--output-dir` | 否 | 输出目录，默认 `.lark-slides/screenshots`；必须是当前目录内的相对路径 |
-| `--output-name` | 否 | render 模式的输出文件名 stem；未指定时优先用返回的 `slide_id`，否则用 `rendered-slide`。若目标文件已存在，会自动追加递增后缀避免覆盖 |
-
-## 示例
-
-### 单页截图
-
-```bash
-lark-cli slides +screenshot --as user \
-  --presentation slides_example_presentation_id \
-  --slide-number 1
-```
-
-### 多页截图
-
-一次不要超过 10 页；如需更多页面，分批调用。可以重复传参，也可以用逗号分隔一次传多个：
-
-```bash
-lark-cli slides +screenshot --as user \
-  --presentation slides_example_presentation_id \
-  --slide-number 1 \
-  --slide-number 2 \
-  --output-dir .lark-slides/screenshots/demo
-```
-
-### 渲染 XML 预览
-
-```bash
-lark-cli slides +screenshot --as user \
-  --content @.lark-slides/out/demo/slide.xml \
-  --output-name preview
-```
-
-## 返回值
-
-返回 JSON 不包含 Base64 图片内容：
-
-```json
-{
-  "ok": true,
-  "identity": "user",
-  "data": {
-    "xml_presentation_id": "slides_example_presentation_id",
-    "output_dir": ".lark-slides/screenshots",
-    "screenshots": [
-      {
-        "slide_id": "slide_example_id",
-        "slide_number": 1,
-        "format": "png",
-        "path": "/abs/path/.lark-slides/screenshots/slides_example_presentation_id_p001_slide_example_id.png",
-        "size": 12345
-      }
-    ]
-  }
-}
-```
-
-## 注意事项
-
-1. 优先使用 `slides +screenshot` 保存本地图片，不要把图片 Base64 打到 stdout。
-2. 已存在 PPT 页面截图时，不传 `--content`，用 `--presentation` + `--slide-id` 或 `--slide-number`。
-3. 本地 XML 预览时，传 `--content @file` 或 `--content -`，内容应为单个 `<slide>` XML 片段；此时不要传 `--presentation` / `--slide-id` / `--slide-number`。
-4. `slide_id` 是页面 short ID，页码请用 `--slide-number`。
-5. list 模式一次最多传 10 页（`--slide-id` + `--slide-number` 合计小于等于 10）；更多页面请分批截图。
-6. list 模式默认文件名包含 presentation ID、页码和/或 slide ID；文件已存在时自动追加 `_2`、`_3` 等后缀，避免覆盖旧截图。
-7. 截图来自服务端渲染结果，适合创建/替换后验证页面是否为空白、破图或布局明显异常。
+此文件仅保留旧路径兼容性；后续引用请使用新路径。

package/skills/lark-slides/references/lark-slides-xml-presentation-slide-get.md

@@ -1,110 +1,5 @@
-# lark-slides xml_presentation.slide get
+# lark-slides xml_presentation.slide get（兼容入口）
 
-## 用途
+本文档已迁移至 [`cli/lark-slides-xml-presentation-slide-get.md`](cli/lark-slides-xml-presentation-slide-get.md)。
 
-按 `slide_id` 拉取指定演示文稿单页的 XML 内容（可指定历史版本）。常用于"读-改-写"编辑闭环的第一步。
-
-## 命令
-
-```bash
-lark-cli slides xml_presentation.slide get --as user --params '<json_params>'
-```
-
-## 参数说明
-
-| 参数 | 类型 | 必需 | 说明 |
-|------|------|------|------|
-| `--params` | JSON string | 是 | 路径参数与查询参数 |
-
-### params JSON 结构
-
-```json
-{
-  "xml_presentation_id": "slides_example_presentation_id",
-  "slide_id": "slide_example_id",
-  "revision_id": -1
-}
-```
-
-| 字段 | 类型 | 必需 | 说明 |
-|------|------|------|------|
-| `xml_presentation_id` | string | 是 | 目标演示文稿唯一标识 |
-| `slide_id` | string | 是 | 目标页面唯一标识 |
-| `revision_id` | integer | 否 | 版本号，`-1` 表示最新版（默认）|
-
-## 使用示例
-
-### 读最新版本
-
-```bash
-lark-cli slides xml_presentation.slide get --as user --params '{
-  "xml_presentation_id": "slides_example_presentation_id",
-  "slide_id": "slide_example_id"
-}'
-```
-
-### 只提取 XML 内容
-
-```bash
-lark-cli slides xml_presentation.slide get --as user \
-  --params '{"xml_presentation_id":"slides_example_presentation_id","slide_id":"slide_example_id"}' \
-  | jq -r '.data.slide.content'
-```
-
-### 读指定历史版本
-
-```bash
-lark-cli slides xml_presentation.slide get --as user --params '{
-  "xml_presentation_id": "slides_example_presentation_id",
-  "slide_id": "slide_example_id",
-  "revision_id": 42
-}'
-```
-
-## 返回值
-
-```json
-{
-  "ok": true,
-  "identity": "user",
-  "data": {
-    "slide": {
-      "slide_id": "slide_example_id",
-      "content": "<slide id=\"slide_example_id\"><style/><data>...</data></slide>"
-    },
-    "revision_id": 100
-  }
-}
-```
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `data.slide.slide_id` | string | 页面唯一标识 |
-| `data.slide.content` | string | 页面完整 XML（`<slide>` 根节点，不含 xmlns）|
-| `data.revision_id` | integer | 此次读到的版本号，可用于后续 replace 的乐观锁 |
-
-## 常见错误
-
-| 错误码 | 含义 | 解决方案 |
-|--------|------|----------|
-| 404 | 演示文稿或页面不存在 | 检查 `xml_presentation_id` / `slide_id` |
-| 403 | 权限不足 | 需要 `slides:presentation:read` scope，并对该 PPT 有访问权限 |
-| 400 | `revision_id` 不存在 | 传了无效版本号，用 `-1` 或真实存在的版本号 |
-
-## 注意事项
-
-1. **执行前必做**：`lark-cli schema slides.xml_presentation.slide.get` 查看最新参数结构
-2. **block_id 提取**：返回 XML 里每个顶层块（shape、img、table、chart 等）的 `id` 属性即为 `block_id`，通常是 3 字符短码，例如 `<shape id="bUn" ...>`。用以下命令列出当前页所有 block_id：
-
-   ```bash
-   lark-cli slides xml_presentation.slide get --as user \
-     --params "{\"xml_presentation_id\":\"$PID\",\"slide_id\":\"$SID\"}" \
-     | jq -r '.data.slide.content' | grep -oE 'id="[^"]+"' | sed 's/id="//;s/"//'
-   ```
-
-## 相关命令
-
-- [slides +replace-slide](lark-slides-replace-slide.md) — 块级替换 shortcut（推荐）
-- [xml_presentation.slide replace](lark-slides-xml-presentation-slide-replace.md) — 底层 replace API 参考
-- [slides +xml-get](lark-slides-xml-presentations-get.md) — 读整个 PPT 并保存到本地文件
-- [lark-slides-edit-workflows.md](lark-slides-edit-workflows.md) — 读-改-写闭环
+此文件仅保留旧路径兼容性；后续引用请使用新路径。