AxTps/Starlight_Lancher
2
2
Fork 1
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
Files
d8a07c69c1c3d8050792b144c9a819a918a66754
Starlight_Lancher/.claude/skills/lark-slides/references/lark-slides-xml-presentations-get.md

3.9 KiB
Raw Blame History

lark-slides xml_presentations get

用途

读取飞书幻灯片（PPT）演示文稿的完整 XML 内容信息。

Shortcut

使用 slides +xml-get shortcut，可以把 XML 保存到本地文件，避免终端输出被截断。

lark-cli slides +xml-get --as user \
  --presentation "slides_example_presentation_id" \
  --output .lark-slides/plan/slides_example_presentation_id/readback.xml \
  --json

参数说明

参数 类型 必需 说明
--presentation string 是 演示文稿的唯一标识符
--revision-id integer 否 版本号，-1 表示最新版本
--output string 是 本地文件，必须使用相对路径
--remove-attr-id flag 否 移除 XML id 属性后读取
--json flag 是 必须按照 json 格式输出

基础示例

lark-cli slides +xml-get --as user \
  --presentation "slides_example_presentation_id" \
  --output .lark-slides/plan/slides_example_presentation_id/readback.xml \
  --json

指定版本读取

lark-cli slides +xml-get --as user \
  --presentation "slides_example_presentation_id" \
  --revision-id 10 \
  --output .lark-slides/plan/slides_example_presentation_id/readback-r10.xml \
  --json

移除 XML id 属性后读取

lark-cli slides +xml-get --as user \
  --presentation "slides_example_presentation_id" \
  --remove-attr-id \
  --output .lark-slides/plan/slides_example_presentation_id/readback-no-id.xml \
  --json

底层原生命令形态

lark-cli slides xml_presentations get --as user --params '<json_params>'

参数说明

参数 类型 必需 说明
--params JSON string 是 路径参数与查询参数，结构以 schema 为准

params JSON 结构

{
  "xml_presentation_id": "slides_example_presentation_id",
  "revision_id": -1
}
字段 类型 必需 说明
xml_presentation_id string 是 演示文稿的唯一标识符
revision_id integer 否 版本号，-1 表示最新版本

返回值

成功时返回演示文稿的完整信息：

{
  "ok": true,
  "identity": "user",
  "data": {
    "xml_presentation": {
      "presentation_id": "slides_example_presentation_id",
      "revision_id": 1,
      "content": "<presentation xmlns=\"http://www.larkoffice.com/sml/2.0\" height=\"540\" width=\"960\">...</presentation>"
    }
  }
}

返回字段说明

字段 类型 说明
data.xml_presentation.presentation_id string 演示文稿唯一标识
data.xml_presentation.revision_id integer 版本号
data.xml_presentation.content string XML 格式的完整内容

常见错误

错误码 含义 解决方案
404 演示文稿不存在 检查 xml_presentation_id 是否正确
403 权限不足 检查是否拥有 slides:presentation:read scope，或是否有访问权限
400 参数格式错误 确保 --params 是合法的 JSON 字符串

注意事项

  1. lark-slides 工作流默认使用 slides +xml-get；只有必须直接调底层 API 时，才使用
  2. 直接调用底层 API 前，使用 lark-cli schema slides.xml_presentations.get 查看最新的参数结构
  3. 返回的 XML 在 data.xml_presentation.content 字段中
  4. 如果只需要部分信息，可以使用 jq 等工具过滤返回结果
  5. 不要在普通工作流中把完整 XML 打到终端；用 slides +xml-get --output 保存文件

相关命令