@amaster.ai/pi-lark 0.1.2-beta.47 → 0.1.2-beta.49

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 (63) hide show
  1. package/README.md +5 -1
  2. package/dist/config.d.ts +1 -1
  3. package/dist/config.d.ts.map +1 -1
  4. package/dist/config.js +2 -2
  5. package/dist/config.js.map +1 -1
  6. package/dist/index.d.ts.map +1 -1
  7. package/dist/index.js +2 -1
  8. package/dist/index.js.map +1 -1
  9. package/package.json +3 -3
  10. package/skills/lark-apps/SKILL.md +1 -0
  11. package/skills/lark-apps/references/lark-apps-cache.md +61 -0
  12. package/skills/lark-base/SKILL.md +16 -7
  13. package/skills/lark-base/references/lark-base-data-query.md +11 -4
  14. package/skills/lark-base/references/lark-base-filter-condition.md +179 -0
  15. package/skills/lark-base/references/lark-base-form-questions-create.md +40 -7
  16. package/skills/lark-base/references/lark-base-form-questions-update.md +73 -20
  17. package/skills/lark-base/references/lark-base-role-guide.md +11 -0
  18. package/skills/lark-base/references/lark-base-view-set-filter.md +11 -137
  19. package/skills/lark-base/references/role-config.md +31 -5
  20. package/skills/lark-calendar/SKILL.md +14 -8
  21. package/skills/lark-calendar/references/lark-calendar-create.md +6 -6
  22. package/skills/lark-calendar/references/lark-calendar-recurring.md +1 -0
  23. package/skills/lark-calendar/references/lark-calendar-room-find.md +2 -1
  24. package/skills/lark-calendar/references/lark-calendar-schedule-clear-time.md +1 -0
  25. package/skills/lark-calendar/references/lark-calendar-suggestion.md +1 -1
  26. package/skills/lark-calendar/references/lark-calendar-update.md +7 -4
  27. package/skills/lark-contact/SKILL.md +19 -3
  28. package/skills/lark-contact/references/lark-contact-search-bot.md +60 -0
  29. package/skills/lark-drive/SKILL.md +21 -44
  30. package/skills/lark-drive/references/lark-drive-add-comment.md +2 -4
  31. package/skills/lark-drive/references/lark-drive-add-reply.md +47 -0
  32. package/skills/lark-drive/references/lark-drive-apply-permission.md +2 -2
  33. package/skills/lark-drive/references/lark-drive-batch-query-comments.md +46 -0
  34. package/skills/lark-drive/references/lark-drive-comment-content.md +50 -0
  35. package/skills/lark-drive/references/lark-drive-comment-location.md +7 -13
  36. package/skills/lark-drive/references/lark-drive-delete-reply.md +48 -0
  37. package/skills/lark-drive/references/lark-drive-download.md +5 -1
  38. package/skills/lark-drive/references/lark-drive-list-comments.md +25 -68
  39. package/skills/lark-drive/references/lark-drive-list-replies.md +54 -0
  40. package/skills/lark-drive/references/lark-drive-member-add.md +2 -2
  41. package/skills/lark-drive/references/lark-drive-member-list.md +65 -0
  42. package/skills/lark-drive/references/lark-drive-permission-get-setting.md +48 -0
  43. package/skills/lark-drive/references/lark-drive-preview.md +11 -1
  44. package/skills/lark-drive/references/lark-drive-react-reply.md +51 -0
  45. package/skills/lark-drive/references/lark-drive-reactions.md +27 -25
  46. package/skills/lark-drive/references/lark-drive-resolve-comment.md +45 -0
  47. package/skills/lark-drive/references/lark-drive-restore-comment.md +46 -0
  48. package/skills/lark-drive/references/lark-drive-search.md +6 -1
  49. package/skills/lark-drive/references/lark-drive-secure-label.md +1 -1
  50. package/skills/lark-drive/references/lark-drive-update-reply.md +46 -0
  51. package/skills/lark-drive/references/lark-drive-workflow-permission-governance-commands.md +38 -8
  52. package/skills/lark-drive/references/lark-drive-workflow-permission-governance-outputs.md +10 -10
  53. package/skills/lark-drive/references/lark-drive-workflow-permission-governance.md +22 -20
  54. package/skills/lark-slides/SKILL.md +16 -26
  55. package/skills/lark-slides/references/lark-slides-create.md +14 -5
  56. package/skills/lark-slides/references/lark-slides-media-upload.md +1 -1
  57. package/skills/lark-slides/references/slides_xml_schema_definition.xml +491 -31
  58. package/skills/lark-slides/references/xml-schema-quick-ref.md +39 -0
  59. package/skills/lark-slides/scripts/sxsd_validator.py +908 -0
  60. package/skills/lark-slides/scripts/xml_text_overlap_lint.py +633 -124
  61. package/skills/lark-slides/scripts/xml_text_overlap_lint_test.py +2038 -219
  62. package/skills/lark-task/references/lark-task-create.md +9 -0
  63. package/skills/lark-drive/references/lark-drive-comments-guide.md +0 -80
@@ -194,14 +194,13 @@
194
194
  <xs:simpleType name="FontSizeType">
195
195
  <xs:annotation>
196
196
  <xs:documentation>
197
- 字体大小, 使用正整数, 单位px
198
- 示例:12, 14, 16, 18, 20, 24, 28, 32 等
197
+ 字体大小, 浮点数, 范围 [1, 4000], 单位px
198
+ 示例:10, 10.5, 12, 14, 16, 18, 20, 24, 28, 32 等
199
199
  </xs:documentation>
200
200
  </xs:annotation>
201
- <xs:restriction base="xs:positiveInteger">
202
- <xs:minInclusive value="6"/>
203
- <xs:maxInclusive value="400"/>
204
- <xs:pattern value="[0-9]+"/>
201
+ <xs:restriction base="xs:double">
202
+ <xs:minInclusive value="1"/>
203
+ <xs:maxInclusive value="4000"/>
205
204
  </xs:restriction>
206
205
  </xs:simpleType>
207
206
 
@@ -211,6 +210,52 @@
211
210
  </xs:restriction>
212
211
  </xs:simpleType>
213
212
 
213
+ <xs:simpleType name="AutoStartAtType">
214
+ <xs:annotation>
215
+ <xs:documentation>
216
+ 有序列表起始编号, 取值范围 [1, 32767]
217
+ </xs:documentation>
218
+ </xs:annotation>
219
+ <xs:restriction base="xs:positiveInteger">
220
+ <xs:minInclusive value="1"/>
221
+ <xs:maxInclusive value="32767"/>
222
+ </xs:restriction>
223
+ </xs:simpleType>
224
+
225
+ <xs:simpleType name="BulletSizeType">
226
+ <xs:annotation>
227
+ <xs:documentation>
228
+ 列表符号大小, 二选一:
229
+ - 百分比字符串(相对于文本字号), 取值范围 25%-400%, 如 "100%"
230
+ - 绝对像素值, 取值范围 6-400, 如 "14"
231
+ </xs:documentation>
232
+ </xs:annotation>
233
+ <xs:union>
234
+ <xs:simpleType>
235
+ <xs:restriction base="xs:string">
236
+ <xs:pattern value="(2[5-9]|[3-9][0-9]|[1-3][0-9]{2}|400)%"/>
237
+ </xs:restriction>
238
+ </xs:simpleType>
239
+ <xs:simpleType>
240
+ <xs:restriction base="xs:string">
241
+ <xs:pattern value="[6-9]|[1-9][0-9]|[1-3][0-9]{2}|400"/>
242
+ </xs:restriction>
243
+ </xs:simpleType>
244
+ </xs:union>
245
+ </xs:simpleType>
246
+
247
+ <xs:simpleType name="BulletCharType">
248
+ <xs:annotation>
249
+ <xs:documentation>
250
+ 自定义列表符号, 如 "★", "→", "✓", "◆", 也支持 emoji
251
+ </xs:documentation>
252
+ </xs:annotation>
253
+ <xs:restriction base="xs:string">
254
+ <xs:minLength value="1"/>
255
+ <xs:maxLength value="8"/>
256
+ </xs:restriction>
257
+ </xs:simpleType>
258
+
214
259
  <!-- 文本类型枚举 -->
215
260
  <xs:simpleType name="TextType">
216
261
  <xs:annotation>
@@ -232,6 +277,35 @@
232
277
  </xs:restriction>
233
278
  </xs:simpleType>
234
279
 
280
+ <!-- 动态文本字段类型枚举 -->
281
+ <xs:simpleType name="FieldType">
282
+ <xs:annotation>
283
+ <xs:documentation>
284
+ 动态文本字段类型:
285
+ - slidenum: 当前幻灯片页码
286
+ - datetime: 默认日期时间格式
287
+ - datetime1-datetime13: 预定义日期时间格式
288
+ </xs:documentation>
289
+ </xs:annotation>
290
+ <xs:restriction base="xs:string">
291
+ <xs:enumeration value="slidenum"><xs:annotation><xs:documentation>当前幻灯片页码</xs:documentation></xs:annotation></xs:enumeration>
292
+ <xs:enumeration value="datetime"><xs:annotation><xs:documentation>浏览器默认日期格式, 例如 2026/7/14</xs:documentation></xs:annotation></xs:enumeration>
293
+ <xs:enumeration value="datetime1"><xs:annotation><xs:documentation>日期格式 M/D/YYYY, 例如 10/12/2007</xs:documentation></xs:annotation></xs:enumeration>
294
+ <xs:enumeration value="datetime2"><xs:annotation><xs:documentation>日期格式 dddd, MMMM D, YYYY, 例如 Friday, October 12, 2007</xs:documentation></xs:annotation></xs:enumeration>
295
+ <xs:enumeration value="datetime3"><xs:annotation><xs:documentation>日期格式 D MMMM YYYY, 例如 12 October 2007</xs:documentation></xs:annotation></xs:enumeration>
296
+ <xs:enumeration value="datetime4"><xs:annotation><xs:documentation>日期格式 MMMM D, YYYY, 例如 October 12, 2007</xs:documentation></xs:annotation></xs:enumeration>
297
+ <xs:enumeration value="datetime5"><xs:annotation><xs:documentation>日期格式 D-MMM-YY, 例如 12-Oct-07</xs:documentation></xs:annotation></xs:enumeration>
298
+ <xs:enumeration value="datetime6"><xs:annotation><xs:documentation>日期格式 MMMM YY, 例如 October 07</xs:documentation></xs:annotation></xs:enumeration>
299
+ <xs:enumeration value="datetime7"><xs:annotation><xs:documentation>日期格式 MMM-YY, 例如 Oct-07</xs:documentation></xs:annotation></xs:enumeration>
300
+ <xs:enumeration value="datetime8"><xs:annotation><xs:documentation>日期时间格式 M/D/YYYY h:mm A, 例如 10/12/2007 4:28 PM</xs:documentation></xs:annotation></xs:enumeration>
301
+ <xs:enumeration value="datetime9"><xs:annotation><xs:documentation>日期时间格式 M/D/YYYY h:mm:ss A, 例如 10/12/2007 4:28:34 PM</xs:documentation></xs:annotation></xs:enumeration>
302
+ <xs:enumeration value="datetime10"><xs:annotation><xs:documentation>时间格式 HH:mm, 例如 16:28</xs:documentation></xs:annotation></xs:enumeration>
303
+ <xs:enumeration value="datetime11"><xs:annotation><xs:documentation>时间格式 HH:mm:ss, 例如 16:28:34</xs:documentation></xs:annotation></xs:enumeration>
304
+ <xs:enumeration value="datetime12"><xs:annotation><xs:documentation>时间格式 h:mm A, 例如 4:28 PM</xs:documentation></xs:annotation></xs:enumeration>
305
+ <xs:enumeration value="datetime13"><xs:annotation><xs:documentation>时间格式 h:mm:ss A, 例如 4:28:34 PM</xs:documentation></xs:annotation></xs:enumeration>
306
+ </xs:restriction>
307
+ </xs:simpleType>
308
+
235
309
  <!-- 文本对齐 -->
236
310
  <xs:simpleType name="TextAlignType">
237
311
  <xs:restriction base="xs:string">
@@ -781,21 +855,64 @@
781
855
  <xs:attribute name="heightScale" type="sml:ArrowScaleType" use="optional"/>
782
856
  </xs:complexType>
783
857
 
858
+ <!-- 裁剪方位枚举类型 -->
859
+ <xs:simpleType name="CropAnchorType">
860
+ <xs:annotation>
861
+ <xs:documentation>
862
+ 裁剪方位枚举, 用于指定保留原图的哪个区域
863
+
864
+ - top: 保留顶部, 裁掉底部多余部分
865
+ - bottom: 保留底部, 裁掉顶部多余部分
866
+ - left: 保留左侧, 裁掉右侧多余部分
867
+ - right: 保留右侧, 裁掉左侧多余部分
868
+
869
+ 居中场景不需要设置 anchor, 不设置 offset 即为默认居中裁剪
870
+ </xs:documentation>
871
+ </xs:annotation>
872
+ <xs:restriction base="xs:string">
873
+ <xs:enumeration value="top"><xs:annotation><xs:documentation>保留顶部, 裁掉底部多余部分</xs:documentation></xs:annotation></xs:enumeration>
874
+ <xs:enumeration value="bottom"><xs:annotation><xs:documentation>保留底部, 裁掉顶部多余部分</xs:documentation></xs:annotation></xs:enumeration>
875
+ <xs:enumeration value="left"><xs:annotation><xs:documentation>保留左侧, 裁掉右侧多余部分</xs:documentation></xs:annotation></xs:enumeration>
876
+ <xs:enumeration value="right"><xs:annotation><xs:documentation>保留右侧, 裁掉左侧多余部分</xs:documentation></xs:annotation></xs:enumeration>
877
+ </xs:restriction>
878
+ </xs:simpleType>
879
+
784
880
  <!-- 裁剪类型定义 -->
785
881
  <xs:complexType name="CropType">
786
882
  <xs:annotation>
787
883
  <xs:documentation>
788
- 裁剪配置: 原图填充到预裁剪区域,再根据offset裁出最终尺寸
884
+ 裁剪配置: 将原图裁剪到目标尺寸 (img 元素的 width × height)
789
885
 
790
886
  可选属性:
791
- type: 裁剪形状,默认rect
792
- leftOffset, rightOffset, topOffset, bottomOffset: 边缘偏移量(px)。正值向内裁剪,负值向外扩展留白,0值对齐边缘
793
- presetHandlers: 控制点配置,对应ECMA预设形状的控制点。单个或多个数字,多个用逗号分隔。示例: type="rect"且presetHandlers="60"时为圆角矩形,圆角半径60px
887
+ type: 裁剪形状, 默认 rect
888
+ anchor: 裁剪方位 (top/bottom/left/right), 参见 CropAnchorType
889
+ leftOffset / rightOffset / topOffset / bottomOffset: 四向偏移量 (px), 正值向内裁剪、负值向外扩展留白、0对齐边缘
890
+ presetHandlers: 控制点配置, 对应 ECMA 预设形状的控制点。单个或多个数字, 多个用逗号分隔。
891
+ 示例: type="rect" 且 presetHandlers="60" 时为圆角矩形, 圆角半径 60px
892
+
893
+ 【推荐用法】使用 anchor 指定裁剪方位:
894
+ - 不设置 anchor 时: 默认按图片居中裁剪
895
+ - 设置 anchor 时: 按指定方位裁剪, 例如 anchor="top" 表示保留顶部、裁掉底部多余部分
896
+ - 使用 anchor 后, 不需要再设置 offset
897
+ - anchor 模式下原图按等比缩放后裁剪, 不会发生拉伸或压缩
898
+
899
+ 【进阶用法】使用 offset 精细控制裁剪边界:
900
+ - 适用于用户在编辑器中手动调整裁剪、或从外部协议导入的场景
901
+ - 原图先填充到预裁剪区域, 再根据 offset 从四边裁出最终尺寸
902
+ - 注意: 若预裁剪尺寸与原图比例不一致会产生拉伸变形; 无法确定原图比例时, 不要指定 offset
794
903
 
795
- 说明: 指定offset时,若预裁剪尺寸与原图比例不一致会产生拉伸变形。无法确定原图比例时,不要指定offset
904
+ 【优先级】
905
+ 如果同时设置了 anchor 和 offset, 以 anchor 为准, offset 被忽略
906
+
907
+ 典型用法:
908
+ <crop/> 居中裁剪 (默认行为)
909
+ <crop anchor="top"/> 保留顶部
910
+ <crop anchor="left"/> 保留左侧
911
+ <crop type="rect" presetHandlers="60"/> 圆角矩形裁剪, 默认居中
796
912
  </xs:documentation>
797
913
  </xs:annotation>
798
914
  <xs:attribute name="type" type="sml:ShapeType" use="optional" default="rect"/>
915
+ <xs:attribute name="anchor" type="sml:CropAnchorType" use="optional"/>
799
916
  <xs:attribute name="leftOffset" type="xs:double" use="optional"/>
800
917
  <xs:attribute name="rightOffset" type="xs:double" use="optional"/>
801
918
  <xs:attribute name="topOffset" type="xs:double" use="optional"/>
@@ -1042,6 +1159,10 @@
1042
1159
  - underline: content 级别是否下划线
1043
1160
  - list: content 级别列表类型 bullet/number
1044
1161
  - listStyle: content 级别列表样式
1162
+ - bulletColor: 列表符号颜色(纯色), 可选
1163
+ - bulletSize: 列表符号大小, 可选, 百分比字符串(相对于文本字号, 取值范围 25%-400%)如 "100%", 或绝对像素值(取值范围 6-400)如 "14"
1164
+ - autoStartAt: 有序列表起始编号, 可选, 取值范围 [1, 32767]; 作为后代段落的初始计数器, 子元素 &lt;p&gt;/&lt;ol&gt; 可通过自身 autoStartAt 重置
1165
+ - bulletChar: 自定义列表符号字符, 可选, 如 "★", "→" 等, 设置后覆盖 listStyle 的符号
1045
1166
  - anchorCenter: 控制文本对齐方式, 优先级高于 textAlign
1046
1167
  - autoFit: 控制文本编辑溢出时处理策略
1047
1168
  - baseline: 上标/下标, 相较于文本基线的偏移量
@@ -1049,6 +1170,13 @@
1049
1170
 
1050
1171
  注意:如果content子元素不指定属性, 默认继承content的属性值, 如果局部子元素指定了属性, 则使用局部属性值
1051
1172
 
1173
+ autoStartAt 运行计数器示例(显式指定重置, 未指定沿用前序计数器):
1174
+ &lt;content autoStartAt="5"&gt;
1175
+ &lt;p list="number"&gt;A&lt;/p&gt; &lt;!-- A=5, 继承 content 初始值 --&gt;
1176
+ &lt;p list="number" autoStartAt="10"&gt;B&lt;/p&gt; &lt;!-- B=10, 本段显式重置 --&gt;
1177
+ &lt;p list="number"&gt;C&lt;/p&gt; &lt;!-- C=11, 沿用前序计数器递增 --&gt;
1178
+ &lt;/content&gt;
1179
+
1052
1180
  子元素:
1053
1181
  - p: 段落元素
1054
1182
  - ul: 无序列表元素
@@ -1085,6 +1213,10 @@
1085
1213
  <xs:attribute name="underline" type="xs:boolean" />
1086
1214
  <xs:attribute name="list" type="sml:ListType" default="none"/>
1087
1215
  <xs:attribute name="listStyle" type="sml:ListStyleType" />
1216
+ <xs:attribute name="bulletColor" type="sml:SolidColor" use="optional"/>
1217
+ <xs:attribute name="bulletSize" type="sml:BulletSizeType" use="optional"/>
1218
+ <xs:attribute name="autoStartAt" type="sml:AutoStartAtType" use="optional"/>
1219
+ <xs:attribute name="bulletChar" type="sml:BulletCharType" use="optional"/>
1088
1220
  <xs:attribute name="anchorCenter" type="xs:boolean" default="false" /> <!-- 控制竖排文字是否在垂直方向保持居中 -->
1089
1221
  <xs:attribute name="autoFit" type="sml:AutoFitType" default="no-auto-fit" />
1090
1222
  <xs:attribute name="wrap" type="xs:boolean" default="true" />
@@ -1096,9 +1228,9 @@
1096
1228
  <xs:annotation>
1097
1229
  <xs:documentation>
1098
1230
  段落容器, 支持富文本内容
1099
- 可包含纯文本和内联格式元素(br/strong/em/u/span/del/a/shadow/outline)
1231
+ 可包含纯文本和内联格式元素(br/strong/em/u/span/del/a/shadow/outline/formula/field)
1100
1232
  内联元素嵌套:所有内联元素均可包含纯文本或其他内联元素,以实现复杂的格式组合
1101
- 元素自嵌套:除a元素外,其余内联元素支持自身嵌套,当shadow和outline自嵌套时,渲染效果遵循就近原则,以内层定义的样式为准
1233
+ 元素自嵌套:除a/formula元素外,其余内联元素支持自身嵌套,当shadow和outline自嵌套时,渲染效果遵循就近原则,以内层定义的样式为准
1102
1234
 
1103
1235
  空格处理规则:
1104
1236
  - 文本内的连续空格会被合并为单个空格
@@ -1119,6 +1251,8 @@
1119
1251
  - a: 超链接
1120
1252
  - shadow: 文本阴影
1121
1253
  - outline: 文本轮廓
1254
+ - formula: 科学公式(支持数学、物理等)
1255
+ - field: 动态文本字段,元素内容作为不支持动态字段时的降级文本
1122
1256
  属性说明:
1123
1257
  - textAlign: 文本对齐方式
1124
1258
  - lineSpacing: 行间距
@@ -1127,6 +1261,10 @@
1127
1261
  - level: 段落级别, 取值范围 [1,10]
1128
1262
  - list: 列表类型(bullet/number)
1129
1263
  - listStyle: 列表样式
1264
+ - bulletColor: 列表符号颜色(纯色), 可选
1265
+ - bulletSize: 列表符号大小, 可选, 百分比字符串(相对于文本字号, 取值范围 25%-400%)或绝对像素值(取值范围 6-400)
1266
+ - autoStartAt: 有序列表起始编号, 可选, 取值范围 [1, 32767]; 显式指定时从当前段落起重置计数器, 未指定时沿用同一 content 内的前序计数器
1267
+ - bulletChar: 自定义列表符号字符, 可选
1130
1268
  - marginLeft: 段落左侧缩进宽度
1131
1269
  - indent: 首行缩进宽度
1132
1270
  </xs:documentation>
@@ -1134,6 +1272,7 @@
1134
1272
  <xs:complexType mixed="true">
1135
1273
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1136
1274
  <xs:element ref="sml:br"/>
1275
+ <xs:element ref="sml:formula"/>
1137
1276
  <xs:element ref="sml:strong"/>
1138
1277
  <xs:element ref="sml:em"/>
1139
1278
  <xs:element ref="sml:u"/>
@@ -1142,6 +1281,7 @@
1142
1281
  <xs:element ref="sml:a"/>
1143
1282
  <xs:element ref="sml:shadow"/>
1144
1283
  <xs:element ref="sml:outline"/>
1284
+ <xs:element ref="sml:field"/>
1145
1285
  </xs:choice>
1146
1286
  <xs:attribute name="textAlign" type="sml:TextAlignType" />
1147
1287
  <xs:attribute name="lineSpacing" type="sml:LineSpacingType" default="multiple:1.5"/>
@@ -1151,6 +1291,10 @@
1151
1291
  <xs:attribute name="level" type="sml:LevelType" default="1"/>
1152
1292
  <xs:attribute name="list" type="sml:ListType" default="none"/>
1153
1293
  <xs:attribute name="listStyle" type="sml:ListStyleType"/>
1294
+ <xs:attribute name="bulletColor" type="sml:SolidColor" use="optional"/>
1295
+ <xs:attribute name="bulletSize" type="sml:BulletSizeType" use="optional"/>
1296
+ <xs:attribute name="autoStartAt" type="sml:AutoStartAtType" use="optional"/>
1297
+ <xs:attribute name="bulletChar" type="sml:BulletCharType" use="optional"/>
1154
1298
  <xs:attribute name="marginLeft" type="xs:double" use="optional" />
1155
1299
  <xs:attribute name="indent" type="sml:NonNegativeDouble" use="optional"/>
1156
1300
  </xs:complexType>
@@ -1160,7 +1304,14 @@
1160
1304
  <!-- 无序列表 -->
1161
1305
  <xs:element name="ul">
1162
1306
  <xs:annotation>
1163
- <xs:documentation>无序列表</xs:documentation>
1307
+ <xs:documentation>
1308
+ 无序列表
1309
+ 属性说明:
1310
+ - listStyle: 列表样式
1311
+ - bulletColor: 列表符号颜色(纯色), 可选
1312
+ - bulletSize: 列表符号大小, 可选, 百分比字符串(相对于文本字号, 取值范围 25%-400%)或绝对像素值(取值范围 6-400)
1313
+ - bulletChar: 自定义列表符号字符, 可选, 设置后覆盖 listStyle 的符号
1314
+ </xs:documentation>
1164
1315
  </xs:annotation>
1165
1316
  <xs:complexType>
1166
1317
  <xs:sequence>
@@ -1173,13 +1324,23 @@
1173
1324
  </xs:element>
1174
1325
  </xs:sequence>
1175
1326
  <xs:attribute name="listStyle" type="sml:UnorderedListStyle" default="circle-hollow-square"/>
1327
+ <xs:attribute name="bulletColor" type="sml:SolidColor" use="optional"/>
1328
+ <xs:attribute name="bulletSize" type="sml:BulletSizeType" use="optional"/>
1329
+ <xs:attribute name="bulletChar" type="sml:BulletCharType" use="optional"/>
1176
1330
  </xs:complexType>
1177
1331
  </xs:element>
1178
1332
 
1179
1333
  <!-- 有序列表 -->
1180
1334
  <xs:element name="ol">
1181
1335
  <xs:annotation>
1182
- <xs:documentation>有序列表, 可指定序号</xs:documentation>
1336
+ <xs:documentation>
1337
+ 有序列表, 可指定序号
1338
+ 属性说明:
1339
+ - listStyle: 列表样式
1340
+ - bulletColor: 列表符号颜色(纯色), 可选
1341
+ - bulletSize: 列表符号大小, 可选, 百分比字符串(相对于文本字号, 取值范围 25%-400%)或绝对像素值(取值范围 6-400)
1342
+ - autoStartAt: 有序列表起始编号, 可选, 取值范围 [1, 32767]; 作用于本列表组的计数器初始值, 子元素 &lt;li@index&gt; 可覆盖单项编号
1343
+ </xs:documentation>
1183
1344
  </xs:annotation>
1184
1345
  <xs:complexType>
1185
1346
  <xs:sequence>
@@ -1193,6 +1354,9 @@
1193
1354
  </xs:element>
1194
1355
  </xs:sequence>
1195
1356
  <xs:attribute name="listStyle" type="sml:OrderedListStyle" default="number-lower-alpha-lower-roman"/>
1357
+ <xs:attribute name="bulletColor" type="sml:SolidColor" use="optional"/>
1358
+ <xs:attribute name="bulletSize" type="sml:BulletSizeType" use="optional"/>
1359
+ <xs:attribute name="autoStartAt" type="sml:AutoStartAtType" use="optional"/>
1196
1360
  </xs:complexType>
1197
1361
  </xs:element>
1198
1362
 
@@ -1383,7 +1547,7 @@
1383
1547
  alpha: 不透明度[0, 1]
1384
1548
 
1385
1549
  可选子元素:
1386
- crop: 裁剪。无标签或所有offset未设置时从左上角自适应裁到width×height
1550
+ crop: 裁剪。无标签 / 空标签 / 仅设 anchor 时按等比缩放后裁剪到 width×height; anchor 指定保留方位 (top/bottom/left/right), 不设 anchor 即居中裁剪; offset 用于精细控制
1387
1551
  reflection: 倒影。无标签代表无倒影,空标签代表使用默认样式
1388
1552
  shadow: 阴影。无标签代表无阴影,空标签代表使用默认样式
1389
1553
  border: 边框。无标签代表无边框,空标签代表使用默认样式(颜色: rgba(43, 47, 54, 1), 宽度: 2)
@@ -1500,7 +1664,7 @@
1500
1664
  td 子元素:
1501
1665
  - borderTop/borderRight/borderBottom/borderLeft: 单元格边框样式, 无border标签代表无边框, 空border标签代表使用默认样式(实线边框, 颜色为rgba(221, 222, 223, 1), 宽度为1)
1502
1666
  - fill: 单元格填充样式, 无fill标签代表不填充, 空fill标签代表使用默认样式(默认颜色填充, 颜色为rgba(255, 255, 255, 1))
1503
- - content: 单元格内容
1667
+ - content: 单元格内容。内容默认不反向修改表格几何尺寸; 当内容高度大于当前行高时, 需要手动修改行高
1504
1668
  </xs:documentation>
1505
1669
  </xs:annotation>
1506
1670
  <xs:complexType>
@@ -1558,6 +1722,70 @@
1558
1722
  <xs:complexType/>
1559
1723
  </xs:element>
1560
1724
 
1725
+ <xs:element name="field">
1726
+ <xs:annotation>
1727
+ <xs:documentation>
1728
+ 动态文本字段。
1729
+ type 属性描述动态语义,元素内容是静态降级文本,可包含行内样式元素。
1730
+ </xs:documentation>
1731
+ </xs:annotation>
1732
+ <xs:complexType mixed="true">
1733
+ <xs:choice minOccurs="0" maxOccurs="unbounded">
1734
+ <xs:element ref="sml:strong"/>
1735
+ <xs:element ref="sml:em"/>
1736
+ <xs:element ref="sml:u"/>
1737
+ <xs:element ref="sml:span"/>
1738
+ <xs:element ref="sml:del"/>
1739
+ <xs:element ref="sml:a"/>
1740
+ <xs:element ref="sml:shadow"/>
1741
+ <xs:element ref="sml:outline"/>
1742
+ </xs:choice>
1743
+ <xs:attribute name="type" type="sml:FieldType" use="required"/>
1744
+ </xs:complexType>
1745
+ </xs:element>
1746
+
1747
+
1748
+
1749
+ <xs:element name="formula">
1750
+ <xs:annotation>
1751
+ <xs:documentation>
1752
+ 通用公式元素。
1753
+ 用于展示各类科学公式。
1754
+
1755
+ 结构说明:
1756
+ - 必须从支持的公式格式中选择且仅选择一种作为子元素。
1757
+ - 当前版本支持格式:&lt;latex&gt;
1758
+
1759
+ 示例:
1760
+ - 基础公式:
1761
+ &lt;formula&gt;
1762
+ &lt;latex&gt;&lt;![CDATA[ E = mc^2 ]]&gt;&lt;/latex&gt;
1763
+ &lt;/formula&gt;
1764
+ </xs:documentation>
1765
+ </xs:annotation>
1766
+ <xs:complexType>
1767
+ <xs:choice minOccurs="1" maxOccurs="1">
1768
+ <xs:element name="latex">
1769
+ <xs:annotation>
1770
+ <xs:documentation>
1771
+ LaTeX 格式的公式内容。
1772
+ 本元素包含的 LaTeX 字符串必须严格符合附件中定义的宏集范围。
1773
+
1774
+ 内容语法:
1775
+ - 语法范围:仅使用附件白名单中明确支持的宏。
1776
+ - 表达建议:优先使用基础运算符、分式(\frac)、根号(\sqrt)、矩阵(matrix)等标准数学环境。
1777
+ - 格式要求:必须使用 CDATA 包裹内容,且 CDATA 内部严禁进行 XML 转义(如 &amp;lt;, &amp;amp;)。
1778
+ - 空白处理:解析器将保留 CDATA 内的所有换行和缩进,建议利用此特性保持 LaTeX 源码的结构化和可读性。
1779
+ </xs:documentation>
1780
+ </xs:annotation>
1781
+ <xs:simpleType>
1782
+ <xs:restriction base="xs:string"/>
1783
+ </xs:simpleType>
1784
+ </xs:element>
1785
+ </xs:choice>
1786
+ </xs:complexType>
1787
+ </xs:element>
1788
+
1561
1789
  <xs:element name="strong">
1562
1790
  <xs:annotation>
1563
1791
  <xs:documentation>粗体/加重文本</xs:documentation>
@@ -1565,6 +1793,7 @@
1565
1793
  <xs:complexType mixed="true">
1566
1794
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1567
1795
  <xs:element ref="sml:br"/>
1796
+ <xs:element ref="sml:formula"/>
1568
1797
  <xs:element ref="sml:strong"/>
1569
1798
  <xs:element ref="sml:em"/>
1570
1799
  <xs:element ref="sml:u"/>
@@ -1573,6 +1802,7 @@
1573
1802
  <xs:element ref="sml:a"/>
1574
1803
  <xs:element ref="sml:shadow"/>
1575
1804
  <xs:element ref="sml:outline"/>
1805
+ <xs:element ref="sml:field"/>
1576
1806
  </xs:choice>
1577
1807
  </xs:complexType>
1578
1808
  </xs:element>
@@ -1590,6 +1820,7 @@
1590
1820
  <xs:extension base="sml:ShadowType">
1591
1821
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1592
1822
  <xs:element ref="sml:br"/>
1823
+ <xs:element ref="sml:formula"/>
1593
1824
  <xs:element ref="sml:strong"/>
1594
1825
  <xs:element ref="sml:em"/>
1595
1826
  <xs:element ref="sml:u"/>
@@ -1598,6 +1829,7 @@
1598
1829
  <xs:element ref="sml:a"/>
1599
1830
  <xs:element ref="sml:shadow"/>
1600
1831
  <xs:element ref="sml:outline"/>
1832
+ <xs:element ref="sml:field"/>
1601
1833
  </xs:choice>
1602
1834
  </xs:extension>
1603
1835
  </xs:complexContent>
@@ -1617,6 +1849,7 @@
1617
1849
  <xs:extension base="sml:OutlineType">
1618
1850
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1619
1851
  <xs:element ref="sml:br"/>
1852
+ <xs:element ref="sml:formula"/>
1620
1853
  <xs:element ref="sml:strong"/>
1621
1854
  <xs:element ref="sml:em"/>
1622
1855
  <xs:element ref="sml:u"/>
@@ -1625,6 +1858,7 @@
1625
1858
  <xs:element ref="sml:a"/>
1626
1859
  <xs:element ref="sml:shadow"/>
1627
1860
  <xs:element ref="sml:outline"/>
1861
+ <xs:element ref="sml:field"/>
1628
1862
  </xs:choice>
1629
1863
  </xs:extension>
1630
1864
  </xs:complexContent>
@@ -1638,6 +1872,7 @@
1638
1872
  <xs:complexType mixed="true">
1639
1873
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1640
1874
  <xs:element ref="sml:br"/>
1875
+ <xs:element ref="sml:formula"/>
1641
1876
  <xs:element ref="sml:strong"/>
1642
1877
  <xs:element ref="sml:em"/>
1643
1878
  <xs:element ref="sml:u"/>
@@ -1646,6 +1881,7 @@
1646
1881
  <xs:element ref="sml:a"/>
1647
1882
  <xs:element ref="sml:shadow"/>
1648
1883
  <xs:element ref="sml:outline"/>
1884
+ <xs:element ref="sml:field"/>
1649
1885
  </xs:choice>
1650
1886
  </xs:complexType>
1651
1887
  </xs:element>
@@ -1657,6 +1893,7 @@
1657
1893
  <xs:complexType mixed="true">
1658
1894
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1659
1895
  <xs:element ref="sml:br"/>
1896
+ <xs:element ref="sml:formula"/>
1660
1897
  <xs:element ref="sml:strong"/>
1661
1898
  <xs:element ref="sml:em"/>
1662
1899
  <xs:element ref="sml:u"/>
@@ -1665,6 +1902,7 @@
1665
1902
  <xs:element ref="sml:a"/>
1666
1903
  <xs:element ref="sml:shadow"/>
1667
1904
  <xs:element ref="sml:outline"/>
1905
+ <xs:element ref="sml:field"/>
1668
1906
  </xs:choice>
1669
1907
  </xs:complexType>
1670
1908
  </xs:element>
@@ -1676,6 +1914,7 @@
1676
1914
  <xs:complexType mixed="true">
1677
1915
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1678
1916
  <xs:element ref="sml:br"/>
1917
+ <xs:element ref="sml:formula"/>
1679
1918
  <xs:element ref="sml:strong"/>
1680
1919
  <xs:element ref="sml:em"/>
1681
1920
  <xs:element ref="sml:u"/>
@@ -1684,6 +1923,7 @@
1684
1923
  <xs:element ref="sml:a"/>
1685
1924
  <xs:element ref="sml:shadow"/>
1686
1925
  <xs:element ref="sml:outline"/>
1926
+ <xs:element ref="sml:field"/>
1687
1927
  </xs:choice>
1688
1928
  </xs:complexType>
1689
1929
  </xs:element>
@@ -1698,6 +1938,7 @@
1698
1938
  <xs:complexType mixed="true">
1699
1939
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1700
1940
  <xs:element ref="sml:br"/>
1941
+ <xs:element ref="sml:formula"/>
1701
1942
  <xs:element ref="sml:strong"/>
1702
1943
  <xs:element ref="sml:em"/>
1703
1944
  <xs:element ref="sml:u"/>
@@ -1706,6 +1947,7 @@
1706
1947
  <xs:element ref="sml:a"/>
1707
1948
  <xs:element ref="sml:shadow"/>
1708
1949
  <xs:element ref="sml:outline"/>
1950
+ <xs:element ref="sml:field"/>
1709
1951
  </xs:choice>
1710
1952
  <xs:attribute name="color" type="sml:Color" use="optional"/>
1711
1953
  <xs:attribute name="backgroundColor" type="sml:Color" use="optional"/>
@@ -1729,6 +1971,7 @@
1729
1971
  <xs:complexType mixed="true">
1730
1972
  <xs:choice minOccurs="0" maxOccurs="unbounded">
1731
1973
  <xs:element ref="sml:br"/>
1974
+ <xs:element ref="sml:formula"/>
1732
1975
  <xs:element ref="sml:strong"/>
1733
1976
  <xs:element ref="sml:em"/>
1734
1977
  <xs:element ref="sml:u"/>
@@ -1736,6 +1979,7 @@
1736
1979
  <xs:element ref="sml:del"/>
1737
1980
  <xs:element ref="sml:shadow"/>
1738
1981
  <xs:element ref="sml:outline"/>
1982
+ <xs:element ref="sml:field"/>
1739
1983
  </xs:choice>
1740
1984
  <xs:attribute name="href" use="required">
1741
1985
  <xs:simpleType>
@@ -1823,36 +2067,116 @@
1823
2067
  <!-- 有序列表样式枚举 -->
1824
2068
  <xs:simpleType name="OrderedListStyle">
1825
2069
  <xs:annotation>
1826
- <xs:documentation>有序列表样式</xs:documentation>
2070
+ <xs:documentation>
2071
+ 有序列表样式
2072
+
2073
+ 分为两类:
2074
+ 1. 复合样式(按层级循环不同格式):如 number-lower-alpha-lower-roman 表示第1级用数字、第2级用小写字母、第3级用小写罗马,超过层级数后循环
2075
+ 2. 单一样式(所有层级使用同一格式,不循环):以 PPTX 标准 scheme 命名,如 alpha-lc-paren-both 表示所有层级都用 (a)(b)(c) 格式
2076
+ </xs:documentation>
1827
2077
  </xs:annotation>
1828
2078
  <xs:restriction base="xs:string">
2079
+ <!-- 复合样式(按层级循环) -->
1829
2080
  <xs:enumeration value="number-lower-alpha-lower-roman"><xs:annotation><xs:documentation>1. a. i. - 数字/小写字母/小写罗马</xs:documentation></xs:annotation></xs:enumeration>
1830
2081
  <xs:enumeration value="number-lower-alpha-lower-roman-paren"><xs:annotation><xs:documentation>1) a) i) - 带括号版本</xs:documentation></xs:annotation></xs:enumeration>
1831
2082
  <xs:enumeration value="hierarchical-number"><xs:annotation><xs:documentation>1. 1.1. 1.1.1. - 多级数字</xs:documentation></xs:annotation></xs:enumeration>
1832
2083
  <xs:enumeration value="upper-alpha-lower-alpha-lower-roman"><xs:annotation><xs:documentation>A. a. i. - 大写字母/小写字母/小写罗马</xs:documentation></xs:annotation></xs:enumeration>
1833
2084
  <xs:enumeration value="upper-roman-upper-alpha-number"><xs:annotation><xs:documentation>I. A. 1. - 大写罗马/大写字母/数字</xs:documentation></xs:annotation></xs:enumeration>
1834
2085
  <xs:enumeration value="zero-padded-lower-alpha-lower-roman"><xs:annotation><xs:documentation>01. a. i. - 补零数字/小写字母/小写罗马</xs:documentation></xs:annotation></xs:enumeration>
1835
- <xs:enumeration value="circle-number"><xs:annotation><xs:documentation> 圆圈数字</xs:documentation></xs:annotation></xs:enumeration>
2086
+ <xs:enumeration value="circle-number"><xs:annotation><xs:documentation>圆圈数字</xs:documentation></xs:annotation></xs:enumeration>
1836
2087
  <xs:enumeration value="lower-alpha-paren"><xs:annotation><xs:documentation>a) b) c) - 小写字母带括号</xs:documentation></xs:annotation></xs:enumeration>
1837
2088
  <xs:enumeration value="lower-alpha-dot"><xs:annotation><xs:documentation>a. b. c. - 小写字母带点</xs:documentation></xs:annotation></xs:enumeration>
1838
2089
  <xs:enumeration value="chinese-formal"><xs:annotation><xs:documentation>一、二、三、 - 中文数字</xs:documentation></xs:annotation></xs:enumeration>
2090
+
2091
+ <!-- 单一样式(所有层级使用同一格式,不随层级循环) -->
2092
+ <!-- 拉丁字母 Latin -->
2093
+ <xs:enumeration value="alpha-lc-paren-both"><xs:annotation><xs:documentation>(a) (b) (c) - 小写字母带双括号</xs:documentation></xs:annotation></xs:enumeration>
2094
+ <xs:enumeration value="alpha-uc-paren-both"><xs:annotation><xs:documentation>(A) (B) (C) - 大写字母带双括号</xs:documentation></xs:annotation></xs:enumeration>
2095
+ <xs:enumeration value="alpha-lc-paren-r"><xs:annotation><xs:documentation>a) b) c) - 小写字母带右括号</xs:documentation></xs:annotation></xs:enumeration>
2096
+ <xs:enumeration value="alpha-uc-paren-r"><xs:annotation><xs:documentation>A) B) C) - 大写字母带右括号</xs:documentation></xs:annotation></xs:enumeration>
2097
+ <xs:enumeration value="alpha-lc-period"><xs:annotation><xs:documentation>a. b. c. - 小写字母带点</xs:documentation></xs:annotation></xs:enumeration>
2098
+ <xs:enumeration value="alpha-uc-period"><xs:annotation><xs:documentation>A. B. C. - 大写字母带点</xs:documentation></xs:annotation></xs:enumeration>
2099
+ <!-- 阿拉伯数字 Arabic Numeral -->
2100
+ <xs:enumeration value="arabic-paren-both"><xs:annotation><xs:documentation>(1) (2) (3) - 数字带双括号</xs:documentation></xs:annotation></xs:enumeration>
2101
+ <xs:enumeration value="arabic-paren-r"><xs:annotation><xs:documentation>1) 2) 3) - 数字带右括号</xs:documentation></xs:annotation></xs:enumeration>
2102
+ <xs:enumeration value="arabic-period"><xs:annotation><xs:documentation>1. 2. 3. - 数字带点</xs:documentation></xs:annotation></xs:enumeration>
2103
+ <xs:enumeration value="arabic-plain"><xs:annotation><xs:documentation>1 2 3 - 纯数字</xs:documentation></xs:annotation></xs:enumeration>
2104
+ <xs:enumeration value="arabic-db-period"><xs:annotation><xs:documentation>1.2.3.- 全角数字带点</xs:documentation></xs:annotation></xs:enumeration>
2105
+ <xs:enumeration value="arabic-db-plain"><xs:annotation><xs:documentation>1 2 3 - 全角纯数字</xs:documentation></xs:annotation></xs:enumeration>
2106
+ <xs:enumeration value="arabic1-minus"><xs:annotation><xs:documentation>أ- ب- ت- - 阿拉伯语字母(现代序)带后横线</xs:documentation></xs:annotation></xs:enumeration>
2107
+ <xs:enumeration value="arabic2-minus"><xs:annotation><xs:documentation>-أ- -ب- -ج- - 阿拉伯语字母(Abjadi序)带双横线</xs:documentation></xs:annotation></xs:enumeration>
2108
+ <!-- 罗马数字 Roman -->
2109
+ <xs:enumeration value="roman-lc-paren-both"><xs:annotation><xs:documentation>(i) (ii) (iii) - 小写罗马带双括号</xs:documentation></xs:annotation></xs:enumeration>
2110
+ <xs:enumeration value="roman-uc-paren-both"><xs:annotation><xs:documentation>(I) (II) (III) - 大写罗马带双括号</xs:documentation></xs:annotation></xs:enumeration>
2111
+ <xs:enumeration value="roman-lc-paren-r"><xs:annotation><xs:documentation>i) ii) iii) - 小写罗马带右括号</xs:documentation></xs:annotation></xs:enumeration>
2112
+ <xs:enumeration value="roman-uc-paren-r"><xs:annotation><xs:documentation>I) II) III) - 大写罗马带右括号</xs:documentation></xs:annotation></xs:enumeration>
2113
+ <xs:enumeration value="roman-lc-period"><xs:annotation><xs:documentation>i. ii. iii. - 小写罗马带点</xs:documentation></xs:annotation></xs:enumeration>
2114
+ <xs:enumeration value="roman-uc-period"><xs:annotation><xs:documentation>I. II. III. - 大写罗马带点</xs:documentation></xs:annotation></xs:enumeration>
2115
+ <!-- 圆圈数字 Circle -->
2116
+ <xs:enumeration value="circle-num-db-plain"><xs:annotation><xs:documentation>① ② ③ - 圆圈数字</xs:documentation></xs:annotation></xs:enumeration>
2117
+ <xs:enumeration value="circle-num-wd-black-plain"><xs:annotation><xs:documentation>❶ ❷ ❸ - 实心圆圈数字</xs:documentation></xs:annotation></xs:enumeration>
2118
+ <xs:enumeration value="circle-num-wd-white-plain"><xs:annotation><xs:documentation>① ② ③ - 圆圈数字(1-10 循环, 字形与 circle-num-db-plain 相同但超过 10 后不降级为纯数字)</xs:documentation></xs:annotation></xs:enumeration>
2119
+ <!-- 东亚 East Asian -->
2120
+ <xs:enumeration value="ea1-chs-period"><xs:annotation><xs:documentation>一. 二. 三. - 简体中文带点</xs:documentation></xs:annotation></xs:enumeration>
2121
+ <xs:enumeration value="ea1-chs-plain"><xs:annotation><xs:documentation>一 二 三 - 简体中文</xs:documentation></xs:annotation></xs:enumeration>
2122
+ <xs:enumeration value="ea1-cht-period"><xs:annotation><xs:documentation>一. 二. 三. - 繁体中文带点</xs:documentation></xs:annotation></xs:enumeration>
2123
+ <xs:enumeration value="ea1-cht-plain"><xs:annotation><xs:documentation>一 二 三 - 繁体中文</xs:documentation></xs:annotation></xs:enumeration>
2124
+ <xs:enumeration value="ea1-jpn-chs-db-period"><xs:annotation><xs:documentation>一.二.三.- CJK汉字数字带全角点</xs:documentation></xs:annotation></xs:enumeration>
2125
+ <xs:enumeration value="ea1-jpn-kor-plain"><xs:annotation><xs:documentation>一 二 三 - CJK汉字数字</xs:documentation></xs:annotation></xs:enumeration>
2126
+ <xs:enumeration value="ea1-jpn-kor-period"><xs:annotation><xs:documentation>一. 二. 三. - CJK汉字数字带半角点</xs:documentation></xs:annotation></xs:enumeration>
2127
+ <!-- 希伯来语 Hebrew -->
2128
+ <xs:enumeration value="hebrew2-minus"><xs:annotation><xs:documentation>א- ב- ג- - 希伯来字母带横线</xs:documentation></xs:annotation></xs:enumeration>
2129
+ <!-- 泰语 Thai -->
2130
+ <xs:enumeration value="thai-alpha-period"><xs:annotation><xs:documentation>ก. ข. ค. - 泰语字母带点(跳过 ฃ/ฅ/ฆ)</xs:documentation></xs:annotation></xs:enumeration>
2131
+ <xs:enumeration value="thai-alpha-paren-r"><xs:annotation><xs:documentation>ก) ข) ค) - 泰语字母带右括号(跳过 ฃ/ฅ/ฆ)</xs:documentation></xs:annotation></xs:enumeration>
2132
+ <xs:enumeration value="thai-alpha-paren-both"><xs:annotation><xs:documentation>(ก) (ข) (ค) - 泰语字母带双括号(跳过 ฃ/ฅ/ฆ)</xs:documentation></xs:annotation></xs:enumeration>
2133
+ <xs:enumeration value="thai-num-period"><xs:annotation><xs:documentation>๑. ๒. ๓. - 泰语数字带点</xs:documentation></xs:annotation></xs:enumeration>
2134
+ <xs:enumeration value="thai-num-paren-r"><xs:annotation><xs:documentation>๑) ๒) ๓) - 泰语数字带右括号</xs:documentation></xs:annotation></xs:enumeration>
2135
+ <xs:enumeration value="thai-num-paren-both"><xs:annotation><xs:documentation>(๑) (๒) (๓) - 泰语数字带双括号</xs:documentation></xs:annotation></xs:enumeration>
2136
+ <!-- 印地语 Hindi -->
2137
+ <xs:enumeration value="hindi-alpha-period"><xs:annotation><xs:documentation>अ. आ. इ. - 印地语元音字母带点</xs:documentation></xs:annotation></xs:enumeration>
2138
+ <xs:enumeration value="hindi-num-period"><xs:annotation><xs:documentation>१. २. ३. - 印地语数字带点</xs:documentation></xs:annotation></xs:enumeration>
2139
+ <xs:enumeration value="hindi-num-paren-r"><xs:annotation><xs:documentation>१) २) ३) - 印地语数字带右括号</xs:documentation></xs:annotation></xs:enumeration>
2140
+ <xs:enumeration value="hindi-alpha1-period"><xs:annotation><xs:documentation>क. ख. ग. - 印地语辅音字母带点</xs:documentation></xs:annotation></xs:enumeration>
1839
2141
  </xs:restriction>
1840
2142
  </xs:simpleType>
1841
2143
  <!-- 无序列表样式枚举 -->
1842
2144
  <xs:simpleType name="UnorderedListStyle">
1843
2145
  <xs:annotation>
1844
- <xs:documentation>无序列表样式</xs:documentation>
2146
+ <xs:documentation>
2147
+ 无序列表样式
2148
+
2149
+ 分为两类:
2150
+ 1. 复合样式(按层级循环不同图标):如 circle-hollow-square 表示第1级实心圆、第2级空心圆、第3级实心方形,超过层级数后循环
2151
+ 2. 单一样式(所有层级使用同一图标,不循环):以 pptx- 前缀命名,如 pptx-circle 表示所有层级都用 ● 实心圆
2152
+ </xs:documentation>
1845
2153
  </xs:annotation>
1846
2154
  <xs:restriction base="xs:string">
2155
+ <!-- 复合样式(按层级循环) -->
1847
2156
  <xs:enumeration value="circle-hollow-square"><xs:annotation><xs:documentation>实心圆 空心圆 实心方形</xs:documentation></xs:annotation></xs:enumeration>
1848
- <xs:enumeration value="diamond-triangle-square"><xs:annotation><xs:documentation>棱形 三角形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
2157
+ <xs:enumeration value="diamond-triangle-square"><xs:annotation><xs:documentation>菱形 三角形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
1849
2158
  <xs:enumeration value="hollow-square-all"><xs:annotation><xs:documentation>空心方形 空心方形 空心方形</xs:documentation></xs:annotation></xs:enumeration>
1850
- <xs:enumeration value="arrow-diamond-circle"><xs:annotation><xs:documentation>右箭头 实心棱形 实心圆形</xs:documentation></xs:annotation></xs:enumeration>
2159
+ <xs:enumeration value="arrow-diamond-circle"><xs:annotation><xs:documentation>右箭头 实心菱形 实心圆形</xs:documentation></xs:annotation></xs:enumeration>
1851
2160
  <xs:enumeration value="star-hollow-circle-square"><xs:annotation><xs:documentation>实心五角星 空心圆形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
1852
2161
  <xs:enumeration value="triangle-hollow-circle-square"><xs:annotation><xs:documentation>三角形 空心圆形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
1853
2162
  <xs:enumeration value="solid-square-all"><xs:annotation><xs:documentation>实心方形 实心方形 实心方形</xs:documentation></xs:annotation></xs:enumeration>
1854
2163
  <xs:enumeration value="solid-diamond-all"><xs:annotation><xs:documentation>实心菱形 实心菱形 实心菱形</xs:documentation></xs:annotation></xs:enumeration>
1855
2164
  <xs:enumeration value="check-all"><xs:annotation><xs:documentation>对勾 对勾 对勾</xs:documentation></xs:annotation></xs:enumeration>
2165
+
2166
+ <!-- 单一样式(所有层级使用同一图标,不随层级循环) -->
2167
+ <xs:enumeration value="pptx-circle"><xs:annotation><xs:documentation>● 实心圆(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2168
+ <xs:enumeration value="pptx-square"><xs:annotation><xs:documentation>■ 方块(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2169
+ <xs:enumeration value="pptx-diamond"><xs:annotation><xs:documentation>◆ 菱形(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2170
+ <xs:enumeration value="pptx-square-empty"><xs:annotation><xs:documentation>□ 空心方框(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2171
+ <xs:enumeration value="pptx-check"><xs:annotation><xs:documentation>✓ 对勾(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2172
+ <xs:enumeration value="pptx-triangle"><xs:annotation><xs:documentation>► 右三角(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2173
+ <xs:enumeration value="pptx-bullet"><xs:annotation><xs:documentation>• 小圆点(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2174
+
2175
+ <xs:enumeration value="pptx-circle-empty"><xs:annotation><xs:documentation>○ 空心圆(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2176
+ <xs:enumeration value="pptx-diamond-empty"><xs:annotation><xs:documentation>◇ 空心菱形(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2177
+ <xs:enumeration value="pptx-arrow-right"><xs:annotation><xs:documentation>➔ 右箭头(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2178
+ <xs:enumeration value="pptx-star"><xs:annotation><xs:documentation>★ 星形(所有层级)</xs:documentation></xs:annotation></xs:enumeration>
2179
+ <xs:enumeration value="pptx-square-shadow"><xs:annotation><xs:documentation>❑ 带右下阴影的 3D 方框(所有层级,对应 PPTX Wingdings 'q')</xs:documentation></xs:annotation></xs:enumeration>
1856
2180
  </xs:restriction>
1857
2181
  </xs:simpleType>
1858
2182
 
@@ -2096,6 +2420,19 @@
2096
2420
  </xs:restriction>
2097
2421
  </xs:simpleType>
2098
2422
 
2423
+ <xs:simpleType name="ChartGradientKindType">
2424
+ <xs:annotation>
2425
+ <xs:documentation>
2426
+ 图表渐变类型
2427
+ 可选值: linear(线性渐变) | radial(径向渐变)
2428
+ </xs:documentation>
2429
+ </xs:annotation>
2430
+ <xs:restriction base="xs:string">
2431
+ <xs:enumeration value="linear"/>
2432
+ <xs:enumeration value="radial"/>
2433
+ </xs:restriction>
2434
+ </xs:simpleType>
2435
+
2099
2436
  <xs:simpleType name="ChartRadarShapeType">
2100
2437
  <xs:annotation>
2101
2438
  <xs:documentation>
@@ -2217,6 +2554,7 @@
2217
2554
 
2218
2555
  属性:
2219
2556
  - textAlign: 文本对齐方式(left|center|right), 默认left
2557
+ - fontFamily: 字体族名称,仅图表根级主标题/副标题支持;坐标轴标题不支持
2220
2558
  - fontSize: 字号大小
2221
2559
  - bold: 是否加粗
2222
2560
  - italic: 是否斜体, 默认false
@@ -2230,6 +2568,7 @@
2230
2568
  <xs:complexContent>
2231
2569
  <xs:extension base="sml:ChartFontStyleType">
2232
2570
  <xs:attribute name="textAlign" type="sml:ChartTextAlignType" use="optional" default="left"/>
2571
+ <xs:attribute name="fontFamily" type="sml:FontFamilyType" use="optional"/>
2233
2572
  </xs:extension>
2234
2573
  </xs:complexContent>
2235
2574
  </xs:complexType>
@@ -2298,10 +2637,10 @@
2298
2637
  图表背景配置
2299
2638
 
2300
2639
  属性:
2301
- - color: 背景颜色, 默认透明 rgba(0,0,0,0)
2640
+ - color: 背景颜色,省略时使用图表默认背景;无填充可使用透明色 rgba(0,0,0,0)
2302
2641
  </xs:documentation>
2303
2642
  </xs:annotation>
2304
- <xs:attribute name="color" type="sml:SolidColor" use="optional" default="rgb(255, 255, 255)"/>
2643
+ <xs:attribute name="color" type="sml:SolidColor" use="optional"/>
2305
2644
  </xs:complexType>
2306
2645
 
2307
2646
  <xs:complexType name="ChartBorderType">
@@ -2311,7 +2650,7 @@
2311
2650
 
2312
2651
  属性:
2313
2652
  - color: 边框颜色,默认 rgb(222, 224, 227)
2314
- - width: 边框宽度(像素), 默认 1
2653
+ - width: 边框宽度(像素), 默认 1;无边框可设置为0,或不设置chartBorder
2315
2654
  - style: 边框样式(solid|dashed|dotted), 默认 solid
2316
2655
  - radius: 圆角半径(像素), 默认 6
2317
2656
  </xs:documentation>
@@ -2322,6 +2661,61 @@
2322
2661
  <xs:attribute name="radius" type="xs:nonNegativeInteger" use="optional" />
2323
2662
  </xs:complexType>
2324
2663
 
2664
+ <xs:complexType name="ChartGradientStopType">
2665
+ <xs:annotation>
2666
+ <xs:documentation>
2667
+ 图表渐变色标
2668
+
2669
+ 属性:
2670
+ - offset: 色标位置比例[0,1]
2671
+ - color: 色标颜色
2672
+ - opacity: 色标透明度[0,1]
2673
+ </xs:documentation>
2674
+ </xs:annotation>
2675
+ <xs:attribute name="offset" type="sml:RatioType" use="required"/>
2676
+ <xs:attribute name="color" type="sml:SolidColor" use="required"/>
2677
+ <xs:attribute name="opacity" type="sml:RatioType" use="optional"/>
2678
+ </xs:complexType>
2679
+
2680
+ <xs:complexType name="ChartGradientStopsType">
2681
+ <xs:annotation>
2682
+ <xs:documentation>
2683
+ 图表渐变色标列表,至少需要2个色标
2684
+ </xs:documentation>
2685
+ </xs:annotation>
2686
+ <xs:sequence>
2687
+ <xs:element name="stop" type="sml:ChartGradientStopType" minOccurs="2" maxOccurs="unbounded"/>
2688
+ </xs:sequence>
2689
+ </xs:complexType>
2690
+
2691
+ <xs:complexType name="ChartGradientType">
2692
+ <xs:annotation>
2693
+ <xs:documentation>
2694
+ 图表渐变配置
2695
+
2696
+ 属性:
2697
+ - type: 渐变类型(linear|radial)
2698
+ - x0/y0/x1/y1: 线性渐变起止点坐标
2699
+ - r0/r1: 径向渐变半径
2700
+ - gradientMethod: 渐变算法/插值方式
2701
+
2702
+ 子元素:
2703
+ - stops: 渐变色标列表
2704
+ </xs:documentation>
2705
+ </xs:annotation>
2706
+ <xs:sequence>
2707
+ <xs:element name="stops" type="sml:ChartGradientStopsType" minOccurs="1"/>
2708
+ </xs:sequence>
2709
+ <xs:attribute name="type" type="sml:ChartGradientKindType" use="required"/>
2710
+ <xs:attribute name="x0" type="xs:double" use="optional"/>
2711
+ <xs:attribute name="y0" type="xs:double" use="optional"/>
2712
+ <xs:attribute name="x1" type="xs:double" use="optional"/>
2713
+ <xs:attribute name="y1" type="xs:double" use="optional"/>
2714
+ <xs:attribute name="r0" type="xs:double" use="optional"/>
2715
+ <xs:attribute name="r1" type="xs:double" use="optional"/>
2716
+ <xs:attribute name="gradientMethod" type="xs:string" use="optional"/>
2717
+ </xs:complexType>
2718
+
2325
2719
  <xs:complexType name="ChartColorThemeType">
2326
2720
  <xs:annotation>
2327
2721
  <xs:documentation>
@@ -2431,12 +2825,16 @@
2431
2825
  - size: 该系列所有点的大小
2432
2826
 
2433
2827
  子元素:
2828
+ - fillGradient: 该系列所有点的填充渐变(可选)
2829
+ - strokeGradient: 该系列所有点的边框/描边渐变(可选)
2434
2830
  - chartPoint: 单个数据点配置(可选, 多个), 用于覆盖特定点的样式
2435
2831
  </xs:documentation>
2436
2832
  </xs:annotation>
2437
2833
  <xs:complexContent>
2438
2834
  <xs:extension base="sml:ChartGlobalPointsType">
2439
2835
  <xs:sequence>
2836
+ <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
2837
+ <xs:element name="strokeGradient" type="sml:ChartGradientType" minOccurs="0"/>
2440
2838
  <xs:element name="chartPoint" minOccurs="0" maxOccurs="unbounded">
2441
2839
  <xs:complexType>
2442
2840
  <xs:annotation>
@@ -2448,8 +2846,14 @@
2448
2846
  - color: 该点的颜色
2449
2847
  - shape: 该点的形状(circle|square|triangle|diamond|rect)
2450
2848
  - size: 该点的大小(像素)
2849
+
2850
+ 子元素:
2851
+ - fillGradient: 该点填充渐变(可选)
2451
2852
  </xs:documentation>
2452
2853
  </xs:annotation>
2854
+ <xs:sequence>
2855
+ <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
2856
+ </xs:sequence>
2453
2857
  <xs:attribute name="index" type="xs:positiveInteger" use="required"/>
2454
2858
  <xs:attribute name="color" type="sml:SolidColor" use="optional"/>
2455
2859
  <xs:attribute name="shape" type="sml:ChartPointShapeType" use="optional"/>
@@ -2462,7 +2866,7 @@
2462
2866
  </xs:complexType>
2463
2867
 
2464
2868
  <!-- 线条配置 -->
2465
- <xs:complexType name="ChartLineType">
2869
+ <xs:complexType name="ChartGlobalLineType">
2466
2870
  <xs:annotation>
2467
2871
  <xs:documentation>
2468
2872
  图表全局线条配置(第一层:所有系列的默认样式)
@@ -2479,8 +2883,27 @@
2479
2883
  <xs:attribute name="style" type="sml:ChartLineStyleType" use="optional" default="solid"/>
2480
2884
  </xs:complexType>
2481
2885
 
2886
+ <xs:complexType name="ChartSeriesLineType">
2887
+ <xs:annotation>
2888
+ <xs:documentation>
2889
+ 图表系列线条配置(第二层:单系列统一配置)
2890
+ 继承ChartGlobalLineType的所有属性
2891
+
2892
+ 子元素:
2893
+ - strokeGradient: 该系列线条渐变(可选)
2894
+ </xs:documentation>
2895
+ </xs:annotation>
2896
+ <xs:complexContent>
2897
+ <xs:extension base="sml:ChartGlobalLineType">
2898
+ <xs:sequence>
2899
+ <xs:element name="strokeGradient" type="sml:ChartGradientType" minOccurs="0"/>
2900
+ </xs:sequence>
2901
+ </xs:extension>
2902
+ </xs:complexContent>
2903
+ </xs:complexType>
2904
+
2482
2905
  <!-- 面积配置 -->
2483
- <xs:complexType name="ChartAreaType">
2906
+ <xs:complexType name="ChartGlobalAreaType">
2484
2907
  <xs:annotation>
2485
2908
  <xs:documentation>
2486
2909
  图表全局面积配置(第一层:所有系列的默认填充样式)
@@ -2493,6 +2916,25 @@
2493
2916
  <xs:attribute name="color" type="sml:SolidColor" use="optional"/>
2494
2917
  </xs:complexType>
2495
2918
 
2919
+ <xs:complexType name="ChartSeriesAreaType">
2920
+ <xs:annotation>
2921
+ <xs:documentation>
2922
+ 图表系列面积配置(第二层:单系列统一配置)
2923
+ 继承ChartGlobalAreaType的所有属性
2924
+
2925
+ 子元素:
2926
+ - fillGradient: 该系列面积填充渐变(可选)
2927
+ </xs:documentation>
2928
+ </xs:annotation>
2929
+ <xs:complexContent>
2930
+ <xs:extension base="sml:ChartGlobalAreaType">
2931
+ <xs:sequence>
2932
+ <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
2933
+ </xs:sequence>
2934
+ </xs:extension>
2935
+ </xs:complexContent>
2936
+ </xs:complexType>
2937
+
2496
2938
  <!-- 柱子配置 -->
2497
2939
  <xs:complexType name="ChartGlobalBarsType">
2498
2940
  <xs:annotation>
@@ -2533,12 +2975,16 @@
2533
2975
  - borderStyle: 该系列所有柱子的边框样式
2534
2976
 
2535
2977
  子元素:
2978
+ - fillGradient: 该系列所有柱子的填充渐变(可选)
2979
+ - strokeGradient: 该系列所有柱子的边框渐变(可选)
2536
2980
  - chartBar: 单个柱子配置(可选, 多个), 用于覆盖特定柱子的样式
2537
2981
  </xs:documentation>
2538
2982
  </xs:annotation>
2539
2983
  <xs:complexContent>
2540
2984
  <xs:extension base="sml:ChartGlobalBarsType">
2541
2985
  <xs:sequence>
2986
+ <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
2987
+ <xs:element name="strokeGradient" type="sml:ChartGradientType" minOccurs="0"/>
2542
2988
  <xs:element name="chartBar" minOccurs="0" maxOccurs="unbounded">
2543
2989
  <xs:complexType>
2544
2990
  <xs:annotation>
@@ -2551,8 +2997,14 @@
2551
2997
  - borderColor: 该柱子的边框颜色
2552
2998
  - borderWidth: 该柱子的边框宽度(像素)
2553
2999
  - borderStyle: 该柱子的边框样式(solid|dashed|dotted)
3000
+
3001
+ 子元素:
3002
+ - fillGradient: 该柱子的填充渐变(可选)
2554
3003
  </xs:documentation>
2555
3004
  </xs:annotation>
3005
+ <xs:sequence>
3006
+ <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
3007
+ </xs:sequence>
2556
3008
  <xs:attribute name="index" type="xs:positiveInteger" use="required"/>
2557
3009
  <xs:attribute name="color" type="sml:SolidColor" use="optional"/>
2558
3010
  <xs:attribute name="borderColor" type="sml:SolidColor" use="optional"/>
@@ -2577,8 +3029,14 @@
2577
3029
  - offsetRadius: 扇区径向偏移比例[0,1], 用于突出显示
2578
3030
  - borderColor: 扇区边框颜色
2579
3031
  - color: 扇区填充颜色
3032
+
3033
+ 子元素:
3034
+ - fillGradient: 扇区填充渐变(可选)
2580
3035
  </xs:documentation>
2581
3036
  </xs:annotation>
3037
+ <xs:sequence>
3038
+ <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
3039
+ </xs:sequence>
2582
3040
  <xs:attribute name="index" type="xs:positiveInteger" use="required"/>
2583
3041
  <xs:attribute name="offsetRadius" type="sml:RatioType" use="optional"/>
2584
3042
  <xs:attribute name="borderColor" type="sml:SolidColor" use="optional"/>
@@ -2598,10 +3056,12 @@
2598
3056
  - startAngle: 起始角度[0,360), 控制第一个扇区的起始位置, 默认0
2599
3057
 
2600
3058
  子元素:
3059
+ - fillGradient: 所有扇区的统一填充渐变(可选)
2601
3060
  - chartSector: 单个扇区配置(可选, 多个), 用于定制特定扇区
2602
3061
  </xs:documentation>
2603
3062
  </xs:annotation>
2604
3063
  <xs:sequence>
3064
+ <xs:element name="fillGradient" type="sml:ChartGradientType" minOccurs="0"/>
2605
3065
  <xs:element name="chartSector" type="sml:ChartSectorType" minOccurs="0" maxOccurs="unbounded"/>
2606
3066
  </xs:sequence>
2607
3067
  <xs:attribute name="borderColor" type="sml:SolidColor" use="optional"/>
@@ -2648,8 +3108,8 @@
2648
3108
  </xs:annotation>
2649
3109
  <xs:sequence>
2650
3110
  <xs:element name="chartPoints" type="sml:ChartSeriesPointsType" minOccurs="0"/>
2651
- <xs:element name="chartLine" type="sml:ChartLineType" minOccurs="0"/>
2652
- <xs:element name="chartArea" type="sml:ChartAreaType" minOccurs="0"/>
3111
+ <xs:element name="chartLine" type="sml:ChartSeriesLineType" minOccurs="0"/>
3112
+ <xs:element name="chartArea" type="sml:ChartSeriesAreaType" minOccurs="0"/>
2653
3113
  <xs:element name="chartBars" type="sml:ChartSeriesBarsType" minOccurs="0"/>
2654
3114
  <xs:element name="chartSectors" type="sml:ChartSectorsType" minOccurs="0"/>
2655
3115
  <xs:element name="chartLabels" type="sml:ChartDataLabelsType" minOccurs="0"/>
@@ -2850,8 +3310,8 @@
2850
3310
  </xs:annotation>
2851
3311
  <xs:all>
2852
3312
  <xs:element name="chartPoints" type="sml:ChartGlobalPointsType" minOccurs="0"/>
2853
- <xs:element name="chartLines" type="sml:ChartLineType" minOccurs="0"/>
2854
- <xs:element name="chartAreas" type="sml:ChartAreaType" minOccurs="0"/>
3313
+ <xs:element name="chartLines" type="sml:ChartGlobalLineType" minOccurs="0"/>
3314
+ <xs:element name="chartAreas" type="sml:ChartGlobalAreaType" minOccurs="0"/>
2855
3315
  <xs:element name="chartBars" type="sml:ChartGlobalBarsType" minOccurs="0"/>
2856
3316
  <xs:element name="chartLabels" type="sml:ChartDataLabelsType" minOccurs="0"/>
2857
3317
  <xs:element name="chartSeriesList" type="sml:ChartSeriesListType" minOccurs="0"/>