npm - @amaster.ai/pi-lark - Versions diffs - 0.1.2-beta.44 → 0.1.2-beta.46 - Mend

@amaster.ai/pi-lark 0.1.2-beta.44 → 0.1.2-beta.46

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (130) hide show

package/skills/lark-slides/references/slides_demo.xml DELETED Viewed

@@ -1,226 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<presentation xmlns="http://www.larkoffice.com/sml/2.0" height="540" width="960">
-    <title>制造端智能升级</title>
-    <theme>
-        <textStyles>
-            <headline fontColor="rgb(255,255,255)" fontFamily="思源黑体" fontSize="36"/>
-            <sub-headline fontColor="rgb(229,231,235)" fontFamily="思源黑体" fontSize="20"/>
-            <body fontColor="rgb(229,231,235)" fontFamily="思源黑体" fontSize="16"/>
-        </textStyles>
-    </theme>
-    <slide>
-        <style>
-            <fill>
-                <fillColor color="linear-gradient(180deg, rgb(47, 79, 79) 0%, rgb(26, 26, 26) 100%)"/>
-            </fill>
-        </style>
-        <data>
-            <shape height="36" rotation="0" topLeftX="48" topLeftY="40" type="text" width="300">
-                <content>
-                    <p>
-                        <strong>
-                            <span color="rgb(255, 215, 0)" fontFamily="黑体" fontSize="28">时代背景</span>
-                        </strong>
-                    </p>
-                </content>
-            </shape>
-            <shape height="200" rotation="0" topLeftX="48" topLeftY="85" type="rect" width="864">
-                <fill>
-                    <fillColor color="rgba(0,0,0,0.2)"/>
-                </fill>
-            </shape>
-            <img alpha="0.4" alt="十月革命场景" height="180" rotation="0" src="https://example.com/images/scene-1.png" topLeftX="48" topLeftY="95" width="288">
-                <crop type="rect"/>
-            </img>
-            <img alpha="0.4" alt="列宁演讲油画" height="180" rotation="0" src="https://example.com/images/scene-2.png" topLeftX="336" topLeftY="95" width="288">
-                <crop type="rect"/>
-            </img>
-            <img alpha="0.4" alt="十月革命战斗场面" height="180" rotation="0" src="https://example.com/images/scene-3.png" topLeftX="624" topLeftY="95" width="288">
-                <crop type="rect"/>
-            </img>
-            <shape height="2" rotation="0" topLeftX="90" topLeftY="180" type="rect" width="780">
-                <fill>
-                    <fillColor color="rgba(255, 215, 0, 0.3)"/>
-                </fill>
-            </shape>
-            <shape height="10" rotation="0" topLeftX="120" topLeftY="176" type="ellipse" width="10">
-                <fill>
-                    <fillColor color="rgb(196, 30, 58)"/>
-                </fill>
-                <border color="rgb(255, 215, 0)" width="1"/>
-            </shape>
-            <shape height="24" rotation="0" topLeftX="60" topLeftY="140" type="text" width="200">
-                <content>
-                    <p textAlign="center">
-                        <strong>
-                            <span color="rgb(255, 215, 0)" fontFamily="黑体" fontSize="20">1917</span>
-                        </strong>
-                    </p>
-                </content>
-            </shape>
-            <shape height="22" rotation="0" topLeftX="60" topLeftY="200" type="text" width="200">
-                <content>
-                    <p textAlign="center">
-                        <span color="rgb(230, 230, 230)" fontFamily="宋体" fontSize="16">十月革命</span>
-                    </p>
-                </content>
-            </shape>
-            <shape height="40" rotation="0" topLeftX="60" topLeftY="225" type="text" width="200">
-                <content verticalAlign="top">
-                    <p textAlign="center">
-                        <span color="rgb(156, 163, 175)" fontSize="12">沙皇专制终结，苏维埃政权建立</span>
-                    </p>
-                </content>
-            </shape>
-            <shape height="10" rotation="0" topLeftX="475" topLeftY="176" type="ellipse" width="10">
-                <fill>
-                    <fillColor color="rgb(196, 30, 58)"/>
-                </fill>
-                <border color="rgb(255, 215, 0)" width="1"/>
-            </shape>
-            <shape height="24" rotation="0" topLeftX="380" topLeftY="140" type="text" width="200">
-                <content>
-                    <p textAlign="center">
-                        <strong>
-                            <span color="rgb(255, 215, 0)" fontFamily="黑体" fontSize="20">1920s</span>
-                        </strong>
-                    </p>
-                </content>
-            </shape>
-            <shape height="22" rotation="0" topLeftX="380" topLeftY="200" type="text" width="200">
-                <content>
-                    <p textAlign="center">
-                        <span color="rgb(230, 230, 230)" fontFamily="宋体" fontSize="16">国内战争</span>
-                    </p>
-                </content>
-            </shape>
-            <shape height="40" rotation="0" topLeftX="380" topLeftY="225" type="text" width="200">
-                <content verticalAlign="top">
-                    <p textAlign="center">
-                        <span color="rgb(156, 163, 175)" fontSize="12">革命与反革命的残酷斗争</span>
-                    </p>
-                </content>
-            </shape>
-            <shape height="10" rotation="0" topLeftX="830" topLeftY="176" type="ellipse" width="10">
-                <fill>
-                    <fillColor color="rgb(196, 30, 58)"/>
-                </fill>
-                <border color="rgb(255, 215, 0)" width="1"/>
-            </shape>
-            <shape height="24" rotation="0" topLeftX="740" topLeftY="140" type="text" width="200">
-                <content>
-                    <p textAlign="center">
-                        <strong>
-                            <span color="rgb(255, 215, 0)" fontFamily="黑体" fontSize="20">1930s</span>
-                        </strong>
-                    </p>
-                </content>
-            </shape>
-            <shape height="22" rotation="0" topLeftX="740" topLeftY="200" type="text" width="200">
-                <content>
-                    <p textAlign="center">
-                        <span color="rgb(230, 230, 230)" fontFamily="宋体" fontSize="16">社会主义建设</span>
-                    </p>
-                </content>
-            </shape>
-            <shape height="40" rotation="0" topLeftX="740" topLeftY="225" type="text" width="200">
-                <content verticalAlign="top">
-                    <p textAlign="center">
-                        <span color="rgb(156, 163, 175)" fontSize="12">新经济政策与工业化探索</span>
-                    </p>
-                </content>
-            </shape>
-            <shape height="1" rotation="0" topLeftX="48" topLeftY="300" type="rect" width="864">
-                <fill>
-                    <fillColor color="rgba(255, 215, 0, 0.2)"/>
-                </fill>
-            </shape>
-            <shape height="24" rotation="0" topLeftX="48" topLeftY="320" type="text" width="280">
-                <content>
-                    <p>
-                        <span color="rgb(230, 230, 230)" fontFamily="宋体" fontSize="18">作者：奥斯特洛夫斯基</span>
-                    </p>
-                </content>
-            </shape>
-            <icon height="16" iconType="iconpark/Peoples/user.svg" topLeftX="52" topLeftY="360" width="16">
-                <fill>
-                    <fillColor color="rgb(196, 30, 58)"/>
-                </fill>
-            </icon>
-            <shape height="20" topLeftX="76" topLeftY="358" type="text" width="260">
-                <content verticalAlign="middle">
-                    <p>
-                        <span color="rgb(209, 213, 219)" fontSize="13">工人家庭出身，投身革命浪潮</span>
-                    </p>
-                </content>
-            </shape>
-            <icon height="16" iconType="iconpark/Sports/torch.svg" topLeftX="52" topLeftY="390" width="16">
-                <fill>
-                    <fillColor color="rgb(196, 30, 58)"/>
-                </fill>
-            </icon>
-            <shape height="20" topLeftX="76" topLeftY="388" type="text" width="260">
-                <content verticalAlign="middle">
-                    <p>
-                        <span color="rgb(209, 213, 219)" fontSize="13">战场负伤致残，生命陷入黑暗</span>
-                    </p>
-                </content>
-            </shape>
-            <icon height="16" iconType="iconpark/Health/first-aid-kit.svg" topLeftX="52" topLeftY="420" width="16">
-                <fill>
-                    <fillColor color="rgb(196, 30, 58)"/>
-                </fill>
-            </icon>
-            <shape height="20" topLeftX="76" topLeftY="418" type="text" width="260">
-                <content verticalAlign="middle">
-                    <p>
-                        <span color="rgb(209, 213, 219)" fontSize="13">全身瘫痪、双目失明</span>
-                    </p>
-                </content>
-            </shape>
-            <icon height="16" iconType="iconpark/Edit/edit.svg" topLeftX="52" topLeftY="450" width="16">
-                <fill>
-                    <fillColor color="rgb(196, 30, 58)"/>
-                </fill>
-            </icon>
-            <shape height="20" topLeftX="76" topLeftY="448" type="text" width="260">
-                <content verticalAlign="middle">
-                    <p>
-                        <span color="rgb(209, 213, 219)" fontSize="13">以文学为武器，口述完成创作</span>
-                    </p>
-                </content>
-            </shape>
-            <img alt="奥斯特洛夫斯基青年时期" height="213" rotation="0" src="https://example.com/images/ostrovsky.png" topLeftX="360" topLeftY="320" width="160">
-                <border color="rgba(255, 215, 0, 0.5)" width="2"/>
-                <crop type="rect"/>
-            </img>
-            <shape height="24" rotation="0" topLeftX="552" topLeftY="320" type="text" width="360">
-                <content>
-                    <p>
-                        <span color="rgb(230, 230, 230)" fontFamily="宋体" fontSize="18">创作动机</span>
-                    </p>
-                </content>
-            </shape>
-            <shape height="16" rotation="0" topLeftX="552" topLeftY="350" type="rect" width="2">
-                <fill>
-                    <fillColor color="rgb(196, 30, 58)"/>
-                </fill>
-            </shape>
-            <shape height="120" rotation="0" topLeftX="562" topLeftY="350" type="text" width="350">
-                <content lineSpacing="multiple:1.6" verticalAlign="top">
-                    <p>
-                        <span color="rgb(209, 213, 219)" fontSize="13">在双目失明、全身瘫痪的逆境中，奥斯特洛夫斯基以自身经历为蓝本，用顽强的意志口述完成了这部不朽巨著。他将文学创作视为生命的延续和战斗的武器，旨在通过保尔·柯察金的形象，向青年一代传递坚不可摧的革命信念和超越个人痛苦的崇高人生价值观。</span>
-                    </p>
-                </content>
-            </shape>
-        </data>
-        <note>
-            <content>
-                <p>各位好，这一页将我们带回《钢铁是怎样炼成的》这部巨著诞生的波澜壮阔的时代。</p>
-                <p>上半部分展示了从1917年十月革命到1930年代苏联社会主义建设的宏大历史画卷。这是一个充满剧烈社会变革和残酷斗争的年代，也是英雄主义和理想主义精神熊熊燃烧的年代。正是这样的背景，孕育了小说的灵魂。</p>
-                <p>下半部分，我们聚焦于作者奥斯特洛夫斯基的个人经历。他的一生，本身就是一部比小说更震撼人心的传奇。从投身革命的青年，到因伤致残的战士，再到与命运抗争的文学巨匠。他的创作动机源于自身不屈的战斗精神，他希望用保尔的故事激励后人，在任何困境中都不要放弃理想，要将有限的生命投入到无限的为人类解放而斗争的事业中去。</p>
-                <p>通过了解这段历史和作者的生平，我们能更深刻地理解《钢铁是怎样炼成的》这部作品的伟大之处。</p>
-            </content>
-        </note>
-    </slide>
-</presentation>

package/skills/lark-slides/references/xml-format-guide.md DELETED Viewed

@@ -1,433 +0,0 @@
-# XML 格式指南
-本文档基于 [slides_xml_schema_definition.xml](slides_xml_schema_definition.xml) 整理，说明飞书 Slides XML Schema（SML 2.0）的核心结构和常用写法。
-## 基本结构
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<presentation xmlns="http://www.larkoffice.com/sml/2.0" width="960" height="540">
-  <title>演示文稿标题</title>
-  <slide>
-    <style>
-      <fill>
-        <fillColor color="rgb(245, 245, 245)"/>
-      </fill>
-    </style>
-    <data>
-      <shape type="text" topLeftX="80" topLeftY="80" width="800" height="120">
-        <content textType="title">
-          <p>主标题</p>
-        </content>
-      </shape>
-    </data>
-    <note>
-      <content textType="body">
-        <p>这是演讲者备注。</p>
-      </content>
-    </note>
-  </slide>
-</presentation>
-```
-## 根元素
-### `<presentation>`
-协议标准写法应带命名空间 `http://www.larkoffice.com/sml/2.0`；当前服务端实现可能兼容不带 `xmlns` 的输入，但不作为协议保证。
-**属性：**
-| 属性 | 类型 | 必需 | 说明 |
-|------|------|------|------|
-| `width` | positiveInteger | 是 | 演示文稿宽度，如 `960` |
-| `height` | positiveInteger | 是 | 演示文稿高度，如 `540` |
-| `id` | string | 否 | 演示文稿标识 |
-**子元素：**
-| 元素 | 必需 | 说明 |
-|------|------|------|
-| `<title>` | 否 | 演示文稿标题 |
-| `<theme>` | 否 | 全局主题 |
-| `<slide>` | 是 | 幻灯片页面，至少 1 页，最多 100 页 |
-## 主题
-### `<theme>`
-`<theme>` 当前包含两部分：
-- `<background>`：演示文稿级背景填充
-- `<textStyles>`：主题文本样式集合
-`<textStyles>` 下可选子元素：
-- `<title>`
-- `<headline>`
-- `<sub-headline>`
-- `<body>`
-- `<caption>`
-这些元素定义的是主题默认样式，不是页面结构。常用属性：
-| 属性 | 说明 |
-|------|------|
-| `fontFamily` | 字体 |
-| `fontSize` | 字号 |
-| `fontColor` | 字体颜色 |
-## 幻灯片元素
-### `<slide>`
-单张幻灯片的结构比较严格。
-**属性：**
-| 属性 | 类型 | 必需 | 说明 |
-|------|------|------|------|
-| `id` | string | 否 | 幻灯片标识 |
-**直接子元素只有：**
-| 元素 | 必需 | 说明 |
-|------|------|------|
-| `<style>` | 否 | 页面样式 |
-| `<data>` | 否 | 页面元素容器 |
-| `<note>` | 否 | 演讲者备注 |
-这意味着 `<title>`、`<headline>`、`<body>`、`<caption>` 不能直接放在 `<slide>` 下。
-## 文本内容模型
-### `<content>`
-实际页面文本通常通过 `<content>` 表达，常见位置有：
-- `shape` 内部
-- `table/td` 内部
-- `note` 内部
-**常用属性：**
-| 属性 | 说明 |
-|------|------|
-| `textType` | `title` / `headline` / `sub-headline` / `body` / `caption` |
-| `verticalAlign` | 垂直对齐 |
-| `textAlign` | 水平对齐 |
-| `lineSpacing` | 行间距 |
-| `fontSize` | 字号 |
-| `fontFamily` | 字体 |
-| `color` | 字体颜色 |
-| `bold` / `italic` / `underline` / `strikethrough` | 内容级样式 |
-| `wrap` | 是否自动换行 |
-**可包含的子元素：**
-- `<p>`
-- `<ul>`
-- `<ol>`
-### `<p>`
-`<p>` 是段落元素，可混排纯文本和内联标签：
-- `<br/>`
-- `<strong>`
-- `<em>`
-- `<u>`
-- `<span>`
-- `<del>`
-- `<a>`
-- `<shadow>`
-- `<outline>`
-示例：
-```xml
-<content textType="body" textAlign="left">
-  <p>普通文本 <strong>加粗</strong> <em>斜体</em> <a href="https://example.com">链接</a></p>
-  <ul>
-    <li><p>列表项 1</p></li>
-    <li><p>列表项 2</p></li>
-  </ul>
-</content>
-```
-## 常用页面元素
-所有页面元素都放在 `<data>` 中。
-### `<shape>`
-`shape` 可表示普通形状，也可表示文本框。文本框推荐使用 `type="text"`。
-```xml
-<shape type="text" topLeftX="80" topLeftY="80" width="800" height="120">
-  <content textType="title">
-    <p>主标题</p>
-  </content>
-</shape>
-```
-```xml
-<shape type="rect" topLeftX="700" topLeftY="120" width="180" height="120">
-  <fill>
-    <fillColor color="rgba(100, 149, 237, 0.25)"/>
-  </fill>
-  <border color="rgb(100, 149, 237)" width="2"/>
-</shape>
-```
-**属性：**
-| 属性 | 必需 | 说明 |
-|------|------|------|
-| `type` | 是 | 形状类型，`text` 表示文本框 |
-| `topLeftX` | 是 | 左上角 X 坐标 |
-| `topLeftY` | 是 | 左上角 Y 坐标 |
-| `width` | 是 | 宽度 |
-| `height` | 是 | 高度 |
-| `rotation` | 否 | 旋转角度 |
-| `flipX` / `flipY` | 否 | 翻转 |
-| `alpha` | 否 | 透明度 |
-**可选子元素：**
-- `<fill>`
-- `<border>`
-- `<reflection>`
-- `<shadow>`
-- `<content>`
-### `<line>`
-```xml
-<line startX="100" startY="200" endX="420" endY="200">
-  <border color="rgb(43, 47, 54)" width="2"/>
-</line>
-```
-`line` 使用的是 `startX` / `startY` / `endX` / `endY`，不是 `x1` / `y1` / `x2` / `y2`。
-### `<img>`
-```xml
-<img src="file_token_or_url" topLeftX="100" topLeftY="220" width="320" height="180"/>
-```
-`img` 使用 `topLeftX` / `topLeftY`，不是 `x` / `y`。
-`src` 只接受两种值：
-| `src` 形式 | 说明 |
-|---|---|
-| `file_token`（如 `boxcnXXXXXXXXXXXXXXXXXXXXXX`） | 通过 `slides +media-upload` 上传后返回的 token |
-| `@<本地路径>`（如 `@./assets/chart.png`） | **仅在 `slides +create --slides` 中可用**：CLI 会自动上传该文件并替换为 file_token |
-> **禁止使用 http(s) 外链 URL**：飞书 slides 渲染端不会代理外链图片，`src="https://..."` 在 PPT 里通常显示破图。要用网图必须先 `curl`/下载到 CWD 内，再走上传流程拿 `file_token`。
-本地图片的两种姿势：
-- **新建带图 PPT**：`+create --slides` 里直接写 `src="@./pic.png"`，CLI 在创空白 PPT 后、加 slides 前自动上传并替换 token
-- **给已有 PPT 加带图新页**：先 `slides +media-upload --file ./pic.png --presentation $PID` 拿 token，再用 token 写进 `xml_presentation.slide create` 的 XML
-### `<icon>`
-```xml
-<icon iconType="iconpark/Base/setting.svg" topLeftX="440" topLeftY="220" width="32" height="32"/>
-```
-### `<table>`
-表格结构为：
-- `<table>`
-- `<colgroup>` / `<tr>`
-- `<tr>` 内为 `<td>`
-- `<td>` 内可放 `<content>`
-`<table>` 可选设置 `width` 和 `height`，分别表示表格的目标总宽度和总高度：
-```xml
-<table topLeftX="80" topLeftY="120" width="800" height="300">
-  <colgroup>
-    <col width="240"/>
-    <col/>
-  </colgroup>
-  <tr height="80">
-    <td><content textType="body"><p>表头 1</p></content></td>
-    <td><content textType="body"><p>表头 2</p></content></td>
-  </tr>
-</table>
-```
-### `<chart>`
-图表元素必须至少包含：
-- `<chartPlotArea>`
-- `<chartData>`
-同时还可以包含：
-- `<chartTitle>`
-- `<chartSubTitle>`
-- `<chartStyle>`
-- `<chartLegend>`
-- `<chartTooltip>`
-完整图表类型覆盖示例见 [slides_chart_demo.xml](slides_chart_demo.xml)，其中包含柱状、条形、折线、面积、饼 / 环、雷达等原生 `<chart>` 示例，以及散点、气泡、漏斗、帕累托、瀑布等 `<whiteboard>` SVG 图表示例。
-组合图示例（来自 [slides_chart_demo.xml](slides_chart_demo.xml)）：
-```xml
-<chart width="556" height="350" topLeftX="42" topLeftY="132">
-  <chartPlotArea>
-    <chartPlot type="combo">
-      <chartExtra/>
-      <chartSeriesList>
-        <chartSeries index="1" comboType="column"/>
-        <chartSeries index="2" comboType="line" yAxisPosition="right">
-          <chartTooltip format="0%"/>
-        </chartSeries>
-      </chartSeriesList>
-    </chartPlot>
-    <chartAxes>
-      <chartAxis type="x">
-        <chartLabel fontSize="10"/>
-      </chartAxis>
-      <chartAxis type="y" position="left">
-        <chartGridLine color="rgb(226, 232, 240)"/>
-        <chartLabel fontSize="10"/>
-      </chartAxis>
-      <chartAxis type="y" position="right">
-        <chartLabel fontSize="10" format="0%"/>
-      </chartAxis>
-    </chartAxes>
-  </chartPlotArea>
-  <chartLegend position="bottom" fontSize="11"/>
-  <chartData>
-    <dim1>
-      <chartField name="季度">24Q1,24Q2,24Q3,24Q4,25Q1,25Q2,25Q3,25Q4</chartField>
-    </dim1>
-    <dim2>
-      <chartField name="营收">180,195,210,245,220,238,258,296</chartField>
-      <chartField name="增速">0.08,0.12,0.15,0.18,0.22,0.22,0.23,0.21</chartField>
-    </dim2>
-  </chartData>
-  <chartTitle fontSize="12" color="rgba(15, 30, 58, 1)" bold="true">营收（亿美元, 左轴） · 同比增速（%, 右轴）</chartTitle>
-  <chartStyle>
-    <chartBackground color="rgba(0, 0, 0, 0)"/>
-    <chartBorder color="rgb(222, 224, 227)" width="0"/>
-    <chartColorTheme>
-      <color value="rgb(28, 71, 120)"/>
-      <color value="rgb(240, 129, 54)"/>
-    </chartColorTheme>
-  </chartStyle>
-</chart>
-```
-## 样式元素
-### `<fill>`
-```xml
-<fill>
-  <fillColor color="rgb(100, 149, 237)"/>
-</fill>
-```
-### `<border>`
-```xml
-<border color="rgb(0, 0, 0)" width="2" dashArray="solid"/>
-```
-### 颜色格式
-```xml
-<fillColor color="rgb(255, 0, 0)"/>
-<fillColor color="rgba(255, 0, 0, 0.5)"/>
-<fillColor color="linear-gradient(90deg, rgb(255,0,0) 0%, rgb(0,0,255) 100%)"/>
-<fillColor color="radial-gradient(circle at 50% 50%, rgb(255,0,0) 0%, rgb(0,0,255) 100%)"/>
-```
-## 演讲者备注
-### `<note>`
-```xml
-<note>
-  <content textType="body">
-    <p>这是演讲者备注内容。</p>
-  </content>
-</note>
-```
-## 完整示例
-```xml
-<?xml version="1.0" encoding="UTF-8"?>
-<presentation xmlns="http://www.larkoffice.com/sml/2.0" width="960" height="540">
-  <title>季度报告</title>
-  <theme>
-    <textStyles>
-      <title fontFamily="思源黑体" fontSize="54" fontColor="rgba(0, 0, 0, 1)"/>
-      <body fontFamily="思源黑体" fontSize="18" fontColor="rgba(43, 47, 54, 1)"/>
-    </textStyles>
-  </theme>
-  <slide>
-    <style>
-      <fill>
-        <fillColor color="rgb(245, 245, 245)"/>
-      </fill>
-    </style>
-    <data>
-      <shape type="text" topLeftX="80" topLeftY="72" width="760" height="100">
-        <content textType="title">
-          <p>2024 年第一季度报告</p>
-        </content>
-      </shape>
-      <shape type="text" topLeftX="80" topLeftY="200" width="520" height="180">
-        <content textType="body">
-          <p>核心指标</p>
-          <ul>
-            <li><p>用户增长：+25%</p></li>
-            <li><p>收入增长：+30%</p></li>
-            <li><p>市场份额：15%</p></li>
-          </ul>
-        </content>
-      </shape>
-      <shape type="rect" topLeftX="660" topLeftY="180" width="180" height="140">
-        <fill>
-          <fillColor color="rgba(100, 149, 237, 0.25)"/>
-        </fill>
-        <border color="rgb(100, 149, 237)" width="2"/>
-      </shape>
-    </data>
-    <note>
-      <content textType="body">
-        <p>讲到增长率时补充样本范围。</p>
-      </content>
-    </note>
-  </slide>
-</presentation>
-```
-## 最佳实践
-1. 始终带上命名空间 `xmlns="http://www.larkoffice.com/sml/2.0"`
-2. 用 `shape type="text"` + `content` 表达页面文本
-3. 用 `topLeftX` / `topLeftY`、`startX` / `startY` 等 schema 中定义的属性名
-4. 优先使用 `rgb` / `rgba` 颜色格式
-5. 特殊字符按 XML 规则转义
-6. 标准 16:9 页面建议使用 `width="960"` 和 `height="540"`
-## 参考文档
-- [xml-schema-quick-ref.md](xml-schema-quick-ref.md)
-- [slides_xml_schema_definition.xml](slides_xml_schema_definition.xml)
-- [examples.md](examples.md)
-- [slides_demo.xml](slides_demo.xml)