wps-multitool-mcp 1.0.2 → 1.0.3

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 (132) hide show
  1. package/dist/bridge/cancellable.d.ts.map +1 -1
  2. package/dist/bridge/cancellable.js +4 -0
  3. package/dist/bridge/cancellable.js.map +1 -1
  4. package/dist/bridge/index.js +105 -16
  5. package/dist/bridge/index.js.map +1 -1
  6. package/dist/bridge/ps-child.d.ts +27 -1
  7. package/dist/bridge/ps-child.d.ts.map +1 -1
  8. package/dist/bridge/ps-child.js +137 -3
  9. package/dist/bridge/ps-child.js.map +1 -1
  10. package/dist/cli/install.d.ts +7 -0
  11. package/dist/cli/install.d.ts.map +1 -1
  12. package/dist/cli/install.js +98 -0
  13. package/dist/cli/install.js.map +1 -1
  14. package/dist/client/action-routes.generated.d.ts +3 -2
  15. package/dist/client/action-routes.generated.d.ts.map +1 -1
  16. package/dist/client/action-routes.generated.js +5 -12
  17. package/dist/client/action-routes.generated.js.map +1 -1
  18. package/dist/client/addon-channel.d.ts +104 -0
  19. package/dist/client/addon-channel.d.ts.map +1 -0
  20. package/dist/client/addon-channel.js +491 -0
  21. package/dist/client/addon-channel.js.map +1 -0
  22. package/dist/client/mac-poll-server.d.ts.map +1 -0
  23. package/dist/client/mac-poll-server.js.map +1 -0
  24. package/dist/client/ps-daemon.d.ts +1 -0
  25. package/dist/client/ps-daemon.d.ts.map +1 -1
  26. package/dist/client/ps-daemon.js +8 -4
  27. package/dist/client/ps-daemon.js.map +1 -1
  28. package/dist/client/wps-client.d.ts +3 -1
  29. package/dist/client/wps-client.d.ts.map +1 -1
  30. package/dist/client/wps-client.js +82 -9
  31. package/dist/client/wps-client.js.map +1 -1
  32. package/dist/index.d.ts.map +1 -1
  33. package/dist/index.js +2 -1
  34. package/dist/index.js.map +1 -1
  35. package/dist/server/backend-selector.d.ts +51 -0
  36. package/dist/server/backend-selector.d.ts.map +1 -0
  37. package/dist/server/backend-selector.js +104 -0
  38. package/dist/server/backend-selector.js.map +1 -0
  39. package/dist/server/target-context.d.ts +32 -0
  40. package/dist/server/target-context.d.ts.map +1 -0
  41. package/dist/server/target-context.js +47 -0
  42. package/dist/server/target-context.js.map +1 -0
  43. package/dist/server/tool-annotations.d.ts.map +1 -1
  44. package/dist/server/tool-annotations.generated.js +8 -8
  45. package/dist/server/tool-annotations.generated.js.map +1 -1
  46. package/dist/server/tool-annotations.js +20 -8
  47. package/dist/server/tool-annotations.js.map +1 -1
  48. package/dist/server/tool-registry.d.ts.map +1 -1
  49. package/dist/server/tool-registry.js +5 -1
  50. package/dist/server/tool-registry.js.map +1 -1
  51. package/dist/server/tool-tiers.d.ts +3 -2
  52. package/dist/server/tool-tiers.d.ts.map +1 -1
  53. package/dist/server/tool-tiers.js +3 -2
  54. package/dist/server/tool-tiers.js.map +1 -1
  55. package/dist/server/tool-verification.d.ts +3 -3
  56. package/dist/server/tool-verification.js +3 -3
  57. package/dist/tools/common/batch.js +18 -18
  58. package/dist/tools/common/general.d.ts.map +1 -1
  59. package/dist/tools/common/general.js +12 -8
  60. package/dist/tools/common/general.js.map +1 -1
  61. package/dist/tools/common/repair.js +18 -18
  62. package/dist/tools/common/snapshot.d.ts.map +1 -1
  63. package/dist/tools/common/snapshot.js +4 -1
  64. package/dist/tools/common/snapshot.js.map +1 -1
  65. package/dist/tools/common/status.js +27 -27
  66. package/dist/tools/excel/data.d.ts.map +1 -1
  67. package/dist/tools/excel/data.js +24 -7
  68. package/dist/tools/excel/data.js.map +1 -1
  69. package/dist/tools/excel/formula.d.ts +9 -0
  70. package/dist/tools/excel/formula.d.ts.map +1 -1
  71. package/dist/tools/excel/formula.js +64 -6
  72. package/dist/tools/excel/formula.js.map +1 -1
  73. package/dist/tools/excel/sheet.d.ts.map +1 -1
  74. package/dist/tools/excel/sheet.js +30 -5
  75. package/dist/tools/excel/sheet.js.map +1 -1
  76. package/dist/tools/excel/workbook.d.ts.map +1 -1
  77. package/dist/tools/excel/workbook.js +3 -1
  78. package/dist/tools/excel/workbook.js.map +1 -1
  79. package/dist/tools/ppt/beautify-advanced.js +88 -88
  80. package/dist/tools/ppt/chart-flow.d.ts.map +1 -1
  81. package/dist/tools/ppt/chart-flow.js +5 -0
  82. package/dist/tools/ppt/chart-flow.js.map +1 -1
  83. package/dist/tools/ppt/misc.d.ts.map +1 -1
  84. package/dist/tools/ppt/misc.js +96 -82
  85. package/dist/tools/ppt/misc.js.map +1 -1
  86. package/dist/tools/ppt/presentation.d.ts.map +1 -1
  87. package/dist/tools/ppt/presentation.js +5 -1
  88. package/dist/tools/ppt/presentation.js.map +1 -1
  89. package/dist/tools/ppt/shape-basic.d.ts.map +1 -1
  90. package/dist/tools/ppt/shape-basic.js +4 -0
  91. package/dist/tools/ppt/shape-basic.js.map +1 -1
  92. package/dist/tools/ppt/slide-ops.js +159 -159
  93. package/dist/tools/ppt/slide-ops.js.map +1 -1
  94. package/dist/tools/ppt/slide.js +1 -1
  95. package/dist/tools/ppt/slide.js.map +1 -1
  96. package/dist/tools/word/academic.d.ts.map +1 -1
  97. package/dist/tools/word/academic.js +93 -83
  98. package/dist/tools/word/academic.js.map +1 -1
  99. package/dist/tools/word/content.d.ts.map +1 -1
  100. package/dist/tools/word/content.js +98 -66
  101. package/dist/tools/word/content.js.map +1 -1
  102. package/dist/tools/word/document.d.ts.map +1 -1
  103. package/dist/tools/word/document.js +120 -58
  104. package/dist/tools/word/document.js.map +1 -1
  105. package/dist/tools/word/format.d.ts.map +1 -1
  106. package/dist/tools/word/format.js +41 -35
  107. package/dist/tools/word/format.js.map +1 -1
  108. package/dist/tools/word/gaps.d.ts.map +1 -1
  109. package/dist/tools/word/gaps.js +11 -5
  110. package/dist/tools/word/gaps.js.map +1 -1
  111. package/dist/tools/word/professional.d.ts.map +1 -1
  112. package/dist/tools/word/professional.js +123 -111
  113. package/dist/tools/word/professional.js.map +1 -1
  114. package/dist/tools/word/proofread.d.ts.map +1 -1
  115. package/dist/tools/word/proofread.js +42 -38
  116. package/dist/tools/word/proofread.js.map +1 -1
  117. package/dist/tools/word/target.d.ts +74 -0
  118. package/dist/tools/word/target.d.ts.map +1 -0
  119. package/dist/tools/word/target.js +130 -0
  120. package/dist/tools/word/target.js.map +1 -0
  121. package/dist/utils/logger.d.ts.map +1 -1
  122. package/dist/utils/logger.js +31 -1
  123. package/dist/utils/logger.js.map +1 -1
  124. package/dist/version.js +1 -1
  125. package/package.json +72 -66
  126. package/scripts/wps-com.ps1 +8867 -8255
  127. package/scripts/wps-comd.ps1 +40 -1
  128. package/skills/wps-multitool/SKILL.md +130 -129
  129. package/skills/wps-multitool/references/dsh.md +88 -0
  130. package/skills/wps-multitool/references/errors.md +61 -61
  131. package/skills/wps-multitool/references/recipes.md +82 -82
  132. package/skills/wps-multitool/references/routing.md +87 -87
@@ -41,11 +41,11 @@ const wps_1 = require("../../types/wps");
41
41
  // ============================================================
42
42
  exports.deleteSlideDefinition = {
43
43
  name: 'wps_ppt_delete_slide',
44
- description: `删除指定的幻灯片。
45
-
46
- 使用场景:
47
- - "删除第3页幻灯片"
48
- - "把最后一页删掉"
44
+ description: `删除指定的幻灯片。
45
+
46
+ 使用场景:
47
+ - "删除第3页幻灯片"
48
+ - "把最后一页删掉"
49
49
  - "移除多余的页面"`,
50
50
  category: tools_1.ToolCategory.PRESENTATION,
51
51
  inputSchema: {
@@ -100,11 +100,11 @@ exports.deleteSlideHandler = deleteSlideHandler;
100
100
  // ============================================================
101
101
  exports.moveSlideDefinition = {
102
102
  name: 'wps_ppt_move_slide',
103
- description: `移动幻灯片到指定位置。
104
-
105
- 使用场景:
106
- - "把第5页移到第2页"
107
- - "把最后一页移到开头"
103
+ description: `移动幻灯片到指定位置。
104
+
105
+ 使用场景:
106
+ - "把第5页移到第2页"
107
+ - "把最后一页移到开头"
108
108
  - "调整幻灯片顺序"`,
109
109
  category: tools_1.ToolCategory.PRESENTATION,
110
110
  inputSchema: {
@@ -163,11 +163,11 @@ exports.moveSlideHandler = moveSlideHandler;
163
163
  // ============================================================
164
164
  exports.getSlideCountDefinition = {
165
165
  name: 'wps_ppt_get_slide_count',
166
- description: `获取演示文稿中的幻灯片总数。
167
-
168
- 使用场景:
169
- - "一共有多少页幻灯片"
170
- - "PPT有几页"
166
+ description: `获取演示文稿中的幻灯片总数。
167
+
168
+ 使用场景:
169
+ - "一共有多少页幻灯片"
170
+ - "PPT有几页"
171
171
  - "查看幻灯片数量"`,
172
172
  category: tools_1.ToolCategory.PRESENTATION,
173
173
  inputSchema: {
@@ -216,11 +216,11 @@ exports.getSlideCountHandler = getSlideCountHandler;
216
216
  // ============================================================
217
217
  exports.getSlideInfoDefinition = {
218
218
  name: 'wps_ppt_get_slide_info',
219
- description: `获取指定幻灯片的详细信息,包括布局、元素列表等。
220
-
221
- 使用场景:
222
- - "查看第3页的信息"
223
- - "这页有什么内容"
219
+ description: `获取指定幻灯片的详细信息,包括布局、元素列表等。
220
+
221
+ 使用场景:
222
+ - "查看第3页的信息"
223
+ - "这页有什么内容"
224
224
  - "获取幻灯片详情"`,
225
225
  category: tools_1.ToolCategory.PRESENTATION,
226
226
  inputSchema: {
@@ -284,11 +284,11 @@ exports.getSlideInfoHandler = getSlideInfoHandler;
284
284
  // ============================================================
285
285
  exports.switchSlideDefinition = {
286
286
  name: 'wps_ppt_switch_slide',
287
- description: `切换到指定的幻灯片页面。
288
-
289
- 使用场景:
290
- - "切换到第5页"
291
- - "跳到最后一页"
287
+ description: `切换到指定的幻灯片页面。
288
+
289
+ 使用场景:
290
+ - "切换到第5页"
291
+ - "跳到最后一页"
292
292
  - "显示第1页"`,
293
293
  category: tools_1.ToolCategory.PRESENTATION,
294
294
  inputSchema: {
@@ -343,20 +343,20 @@ exports.switchSlideHandler = switchSlideHandler;
343
343
  // ============================================================
344
344
  exports.setSlideLayoutDefinition = {
345
345
  name: 'wps_ppt_set_slide_layout',
346
- description: `设置幻灯片的版式布局。
347
-
348
- 支持的布局类型:
349
- - title: 标题页
350
- - title_content: 标题+内容
351
- - blank: 空白页
352
- - two_column: 两栏内容
353
- - comparison: 对比布局
354
- - section_header: 节标题
355
- - title_only: 仅标题
356
-
357
- 使用场景:
358
- - "把这页改成空白布局"
359
- - "设置为两栏内容"
346
+ description: `设置幻灯片的版式布局。
347
+
348
+ 支持的布局类型:
349
+ - title: 标题页
350
+ - title_content: 标题+内容
351
+ - blank: 空白页
352
+ - two_column: 两栏内容
353
+ - comparison: 对比布局
354
+ - section_header: 节标题
355
+ - title_only: 仅标题
356
+
357
+ 使用场景:
358
+ - "把这页改成空白布局"
359
+ - "设置为两栏内容"
360
360
  - "改成标题页版式"`,
361
361
  category: tools_1.ToolCategory.PRESENTATION,
362
362
  inputSchema: {
@@ -424,11 +424,11 @@ exports.setSlideLayoutHandler = setSlideLayoutHandler;
424
424
  // ============================================================
425
425
  exports.getSlideNotesDefinition = {
426
426
  name: 'wps_ppt_get_slide_notes',
427
- description: `获取指定幻灯片的备注内容。
428
-
429
- 使用场景:
430
- - "查看第3页的备注"
431
- - "读取演讲备注"
427
+ description: `获取指定幻灯片的备注内容。
428
+
429
+ 使用场景:
430
+ - "查看第3页的备注"
431
+ - "读取演讲备注"
432
432
  - "这页有什么备注"`,
433
433
  category: tools_1.ToolCategory.PRESENTATION,
434
434
  inputSchema: {
@@ -486,23 +486,23 @@ exports.getSlideNotesHandler = getSlideNotesHandler;
486
486
  // ============================================================
487
487
  exports.addShapeDefinition = {
488
488
  name: 'wps_ppt_add_shape',
489
- description: `在幻灯片中添加形状。
490
-
491
- 支持的形状类型:
492
- - rectangle: 矩形
493
- - oval: 椭圆
494
- - triangle: 三角形
495
- - diamond: 菱形
496
- - pentagon: 五边形
497
- - hexagon: 六边形
498
- - arrow: 箭头
499
- - star: 星形
500
- - heart: 心形
501
- - cloud: 云形
502
-
503
- 使用场景:
504
- - "在第1页添加一个矩形"
505
- - "插入一个蓝色的圆形"
489
+ description: `在幻灯片中添加形状。
490
+
491
+ 支持的形状类型:
492
+ - rectangle: 矩形
493
+ - oval: 椭圆
494
+ - triangle: 三角形
495
+ - diamond: 菱形
496
+ - pentagon: 五边形
497
+ - hexagon: 六边形
498
+ - arrow: 箭头
499
+ - star: 星形
500
+ - heart: 心形
501
+ - cloud: 云形
502
+
503
+ 使用场景:
504
+ - "在第1页添加一个矩形"
505
+ - "插入一个蓝色的圆形"
506
506
  - "添加一个带文字的箭头"`,
507
507
  category: tools_1.ToolCategory.PRESENTATION,
508
508
  inputSchema: {
@@ -601,11 +601,11 @@ exports.addShapeHandler = addShapeHandler;
601
601
  // ============================================================
602
602
  exports.setShapeStyleDefinition = {
603
603
  name: 'wps_ppt_set_shape_style',
604
- description: `设置幻灯片中形状的样式,包括填充颜色、边框颜色和边框粗细。
605
-
606
- 使用场景:
607
- - "把矩形改成红色"
608
- - "设置形状的边框为蓝色"
604
+ description: `设置幻灯片中形状的样式,包括填充颜色、边框颜色和边框粗细。
605
+
606
+ 使用场景:
607
+ - "把矩形改成红色"
608
+ - "设置形状的边框为蓝色"
609
609
  - "修改形状样式"`,
610
610
  category: tools_1.ToolCategory.PRESENTATION,
611
611
  inputSchema: {
@@ -689,11 +689,11 @@ exports.setShapeStyleHandler = setShapeStyleHandler;
689
689
  // ============================================================
690
690
  exports.addTextboxDefinition = {
691
691
  name: 'wps_ppt_add_textbox',
692
- description: `在幻灯片中添加文本框。
693
-
694
- 使用场景:
695
- - "在第1页添加一个文本框"
696
- - "插入一个写着标题的文本框"
692
+ description: `在幻灯片中添加文本框。
693
+
694
+ 使用场景:
695
+ - "在第1页添加一个文本框"
696
+ - "插入一个写着标题的文本框"
697
697
  - "添加文本框并设置字号"`,
698
698
  category: tools_1.ToolCategory.PRESENTATION,
699
699
  inputSchema: {
@@ -785,11 +785,11 @@ exports.addTextboxHandler = addTextboxHandler;
785
785
  // ============================================================
786
786
  exports.setSlideTitleDefinition = {
787
787
  name: 'wps_ppt_set_slide_title',
788
- description: `设置幻灯片的标题文本。
789
-
790
- 使用场景:
791
- - "把第1页标题改成'年度总结'"
792
- - "设置标题为'项目进展'"
788
+ description: `设置幻灯片的标题文本。
789
+
790
+ 使用场景:
791
+ - "把第1页标题改成'年度总结'"
792
+ - "设置标题为'项目进展'"
793
793
  - "修改幻灯片标题"`,
794
794
  category: tools_1.ToolCategory.PRESENTATION,
795
795
  inputSchema: {
@@ -851,11 +851,11 @@ exports.setSlideTitleHandler = setSlideTitleHandler;
851
851
  // ============================================================
852
852
  exports.insertImageDefinition = {
853
853
  name: 'wps_ppt_insert_image',
854
- description: `在幻灯片中插入图片。
855
-
856
- 使用场景:
857
- - "在第1页插入一张图片"
858
- - "添加图片到幻灯片"
854
+ description: `在幻灯片中插入图片。
855
+
856
+ 使用场景:
857
+ - "在第1页插入一张图片"
858
+ - "添加图片到幻灯片"
859
859
  - "把这个图片放到PPT里"`,
860
860
  category: tools_1.ToolCategory.PRESENTATION,
861
861
  inputSchema: {
@@ -937,10 +937,10 @@ exports.insertImageHandler = insertImageHandler;
937
937
  // ============================================================
938
938
  exports.setShapeTextDefinition = {
939
939
  name: 'wps_ppt_set_shape_text',
940
- description: `设置幻灯片中指定形状的文字内容。
941
-
942
- 使用场景:
943
- - "把第1页的第2个形状文字改成'销售额'"
940
+ description: `设置幻灯片中指定形状的文字内容。
941
+
942
+ 使用场景:
943
+ - "把第1页的第2个形状文字改成'销售额'"
944
944
  - "修改形状里的文字"`,
945
945
  category: tools_1.ToolCategory.PRESENTATION,
946
946
  inputSchema: {
@@ -989,23 +989,23 @@ exports.setShapeTextHandler = setShapeTextHandler;
989
989
  // ============================================================
990
990
  exports.setAnimationDefinition = {
991
991
  name: 'wps_ppt_set_animation',
992
- description: `给形状加动画,或调整已有动画的播放顺序(第 8 轮合并了动画族 5 个工具)。
993
-
994
- **两个分支用 \`op\` 选**:
995
- - \`op:'add'\`(默认):给形状加动画,要 \`shapeIndex\` + \`category\` + \`effect\`
996
- - \`op:'reorder'\`:把已有动画挪位置,要 \`animationIndex\` + \`order\`
997
-
998
- \`category\` 决定动作落在哪个动画窗格:
999
- - entrance 入场(appear / fadeIn / flyIn / wipeIn / zoomIn / bounceIn / spinIn)
1000
- - emphasis 强调(pulse / grow / teeter / colorPulse)
1001
- - exit 退场(fadeOut / flyOut / wipeOut / zoomOut / disappear)
1002
-
1003
- 什么时候用:
1004
- - "给第1页第2个形状加个淡入" → { op:'add', slideIndex:1, shapeIndex:2, category:'entrance', effect:'fadeIn' }
1005
- - "让这个元素闪一下强调" → { op:'add', slideIndex:1, shapeIndex:2, category:'emphasis', effect:'pulse' }
1006
- - "把第3个动画移到最前面" → { op:'reorder', slideIndex:1, animationIndex:3, order:1 }
1007
-
1008
- 限制:\`.add\` 是【累加】的 —— 同一形状重复加会叠出多条动画,不会替换。
992
+ description: `给形状加动画,或调整已有动画的播放顺序(第 8 轮合并了动画族 5 个工具)。
993
+
994
+ **两个分支用 \`op\` 选**:
995
+ - \`op:'add'\`(默认):给形状加动画,要 \`shapeIndex\` + \`category\` + \`effect\`
996
+ - \`op:'reorder'\`:把已有动画挪位置,要 \`animationIndex\` + \`order\`
997
+
998
+ \`category\` 决定动作落在哪个动画窗格:
999
+ - entrance 入场(appear / fadeIn / flyIn / wipeIn / zoomIn / bounceIn / spinIn)
1000
+ - emphasis 强调(pulse / grow / teeter / colorPulse)
1001
+ - exit 退场(fadeOut / flyOut / wipeOut / zoomOut / disappear)
1002
+
1003
+ 什么时候用:
1004
+ - "给第1页第2个形状加个淡入" → { op:'add', slideIndex:1, shapeIndex:2, category:'entrance', effect:'fadeIn' }
1005
+ - "让这个元素闪一下强调" → { op:'add', slideIndex:1, shapeIndex:2, category:'emphasis', effect:'pulse' }
1006
+ - "把第3个动画移到最前面" → { op:'reorder', slideIndex:1, animationIndex:3, order:1 }
1007
+
1008
+ 限制:\`.add\` 是【累加】的 —— 同一形状重复加会叠出多条动画,不会替换。
1009
1009
  想看现在有哪些动画用 wps_ppt_get_animations,删掉某一条用 wps_ppt_remove_animation。`,
1010
1010
  category: tools_1.ToolCategory.PRESENTATION,
1011
1011
  inputSchema: {
@@ -1201,23 +1201,23 @@ exports.setAnimationHandler = setAnimationHandler;
1201
1201
  // ============================================================
1202
1202
  exports.setBackgroundDefinition = {
1203
1203
  name: 'wps_ppt_set_background',
1204
- description: `设置背景:某一页、整份文稿、或幻灯片母版。
1205
-
1206
- **三个维度一次说清**(合并了原来 6 个背景工具,别再找 set_background_color / _image / _gradient / set_slide_background / set_master_background):
1207
- - \`target\`: slide(默认,单页)/ all(整份文稿)/ master(母版)
1208
- - \`type\`: solid(纯色)/ image(图片)/ gradient(渐变)/ pattern
1209
- - 具体的填充物:\`color\` / \`imagePath\` / \`gradient\`
1210
-
1211
- 什么时候用:
1212
- - "把这页背景改成深蓝" → { target:'slide', slideIndex:2, type:'solid', color:'#003366' }
1213
- - "整份文稿统一白底" → { target:'all', type:'solid', color:'#FFFFFF' }
1214
- - "用这张图做背景" → { target:'slide', slideIndex:1, type:'image', imagePath:'C:\\\\pics\\\\bg.png' }
1215
- - "母版加渐变" → { target:'master', type:'gradient', gradient:{ type:'linear', colors:['#FF0000','#00FF00'] } }
1216
-
1217
- 不填 \`type\` 也能用:按你给的 color / imagePath / gradient 自动推断(老名字走别名过来时就是这条路)。
1218
-
1219
- 限制(真限制,不是没实现):
1220
- - \`target:'master'\` 只支持纯色与渐变 —— 母版背景换图片 WPS 不认,会明确报错而不是假装成功。
1204
+ description: `设置背景:某一页、整份文稿、或幻灯片母版。
1205
+
1206
+ **三个维度一次说清**(合并了原来 6 个背景工具,别再找 set_background_color / _image / _gradient / set_slide_background / set_master_background):
1207
+ - \`target\`: slide(默认,单页)/ all(整份文稿)/ master(母版)
1208
+ - \`type\`: solid(纯色)/ image(图片)/ gradient(渐变)/ pattern
1209
+ - 具体的填充物:\`color\` / \`imagePath\` / \`gradient\`
1210
+
1211
+ 什么时候用:
1212
+ - "把这页背景改成深蓝" → { target:'slide', slideIndex:2, type:'solid', color:'#003366' }
1213
+ - "整份文稿统一白底" → { target:'all', type:'solid', color:'#FFFFFF' }
1214
+ - "用这张图做背景" → { target:'slide', slideIndex:1, type:'image', imagePath:'C:\\\\pics\\\\bg.png' }
1215
+ - "母版加渐变" → { target:'master', type:'gradient', gradient:{ type:'linear', colors:['#FF0000','#00FF00'] } }
1216
+
1217
+ 不填 \`type\` 也能用:按你给的 color / imagePath / gradient 自动推断(老名字走别名过来时就是这条路)。
1218
+
1219
+ 限制(真限制,不是没实现):
1220
+ - \`target:'master'\` 只支持纯色与渐变 —— 母版背景换图片 WPS 不认,会明确报错而不是假装成功。
1221
1221
  - \`type:'pattern'\`(图案填充)WPS COM 没有对应接口,明确报错。`,
1222
1222
  category: tools_1.ToolCategory.PRESENTATION,
1223
1223
  inputSchema: {
@@ -1417,20 +1417,20 @@ exports.setBackgroundHandler = setBackgroundHandler;
1417
1417
  // ============================================================
1418
1418
  exports.setSlideSizeDefinition = {
1419
1419
  name: 'wps_ppt_set_slide_size',
1420
- description: `设置演示文稿的幻灯片尺寸(按像素给,内部换算成 WPS 的磅)。
1421
-
1422
- 常用尺寸:
1423
- - 标准(4:3): 宽960, 高720
1424
- - 宽屏(16:9): 宽960, 高540
1425
- - 宽屏(16:10): 宽960, 高600
1426
- - A4横版: 宽1123, 高794
1427
- - A4竖版: 宽794, 高1123
1428
-
1429
- 注意:改尺寸会重排整份文稿,元素可能溢出页面。改完建议 wps_ppt_export_slide_as_image 看一眼。
1430
-
1431
- 使用场景:
1432
- - "把PPT改成16:9宽屏"
1433
- - "设置幻灯片为A4尺寸"
1420
+ description: `设置演示文稿的幻灯片尺寸(按像素给,内部换算成 WPS 的磅)。
1421
+
1422
+ 常用尺寸:
1423
+ - 标准(4:3): 宽960, 高720
1424
+ - 宽屏(16:9): 宽960, 高540
1425
+ - 宽屏(16:10): 宽960, 高600
1426
+ - A4横版: 宽1123, 高794
1427
+ - A4竖版: 宽794, 高1123
1428
+
1429
+ 注意:改尺寸会重排整份文稿,元素可能溢出页面。改完建议 wps_ppt_export_slide_as_image 看一眼。
1430
+
1431
+ 使用场景:
1432
+ - "把PPT改成16:9宽屏"
1433
+ - "设置幻灯片为A4尺寸"
1434
1434
  - "修改幻灯片大小"`,
1435
1435
  category: tools_1.ToolCategory.PRESENTATION,
1436
1436
  inputSchema: {
@@ -1451,7 +1451,7 @@ exports.setSlideSizeDefinition = {
1451
1451
  const setSlideSizeHandler = async (args) => {
1452
1452
  const { width, height } = args;
1453
1453
  try {
1454
- const response = await wps_client_1.wpsClient.executeMethod('setSlideSize', // NOTE: 仅Windows支持
1454
+ const response = await wps_client_1.wpsClient.executeMethod('setSlideSize', // 第 1 期第 2 章第 2 轮:这句原为「仅Windows支持」,是假注释 —— 该动作曾长期不存在于 ps1。第 6 轮已补 case,现在 Windows 上真能用。
1455
1455
  { width, height }, wps_1.WpsAppType.PRESENTATION);
1456
1456
  if (response.success) {
1457
1457
  return {
@@ -1490,20 +1490,20 @@ exports.setSlideSizeHandler = setSlideSizeHandler;
1490
1490
  // ============================================================
1491
1491
  exports.setTransitionDefinition = {
1492
1492
  name: 'wps_ppt_set_transition',
1493
- description: `设置幻灯片切换效果:单页 or 整份文稿(第 8 轮合并了切换族 3 个工具)。
1494
-
1495
- - \`target\`: slide(默认,只改 \`slideIndex\` 那一页)/ all(整份文稿统一)
1496
- - \`effect\`(**必填**): fade 淡出 / push 推入 / wipe 擦除 / split 拆分 / reveal 揭开 / cover 覆盖 / dissolve 溶解 / curtains 帷幕 / **none 取消切换**
1497
-
1498
- 什么时候用:
1499
- - "给第1页加个淡出切换" → { target:'slide', slideIndex:1, effect:'fade', duration:1 }
1500
- - "所有页统一用推入" → { target:'all', effect:'push' }
1501
- - "第2页不要切换效果" → { target:'slide', slideIndex:2, effect:'none' }
1502
-
1503
- 取消切换用 \`effect:'none'\`,不要去找"删除切换"的工具 —— 切换本来就是"切走时播放的东西",
1504
- 把它设成没有就等价于删掉,而且这样不会因为名字里有"删/删掉"而弹破坏性确认框。
1505
-
1506
- 真限制:没有"切换音效"参数。WPS 的 COM 接口里没有"切走时播一段音频"这个能力
1493
+ description: `设置幻灯片切换效果:单页 or 整份文稿(第 8 轮合并了切换族 3 个工具)。
1494
+
1495
+ - \`target\`: slide(默认,只改 \`slideIndex\` 那一页)/ all(整份文稿统一)
1496
+ - \`effect\`(**必填**): fade 淡出 / push 推入 / wipe 擦除 / split 拆分 / reveal 揭开 / cover 覆盖 / dissolve 溶解 / curtains 帷幕 / **none 取消切换**
1497
+
1498
+ 什么时候用:
1499
+ - "给第1页加个淡出切换" → { target:'slide', slideIndex:1, effect:'fade', duration:1 }
1500
+ - "所有页统一用推入" → { target:'all', effect:'push' }
1501
+ - "第2页不要切换效果" → { target:'slide', slideIndex:2, effect:'none' }
1502
+
1503
+ 取消切换用 \`effect:'none'\`,不要去找"删除切换"的工具 —— 切换本来就是"切走时播放的东西",
1504
+ 把它设成没有就等价于删掉,而且这样不会因为名字里有"删/删掉"而弹破坏性确认框。
1505
+
1506
+ 真限制:没有"切换音效"参数。WPS 的 COM 接口里没有"切走时播一段音频"这个能力
1507
1507
  (那是 PowerPoint 的 AddMediaObject2),所以本工具不提供该参数 —— 要音效得先在 WPS 里录进切换设置。`,
1508
1508
  category: tools_1.ToolCategory.PRESENTATION,
1509
1509
  inputSchema: {
@@ -1601,11 +1601,11 @@ exports.setTransitionHandler = setTransitionHandler;
1601
1601
  // ============================================================
1602
1602
  exports.setShapeFillDefinition = {
1603
1603
  name: 'wps_ppt_set_shape_fill',
1604
- description: `设置幻灯片中指定形状的填充颜色。
1605
-
1606
- 使用场景:
1607
- - "把第1页的第2个形状填充为红色"
1608
- - "修改形状背景色为#00FF00"
1604
+ description: `设置幻灯片中指定形状的填充颜色。
1605
+
1606
+ 使用场景:
1607
+ - "把第1页的第2个形状填充为红色"
1608
+ - "修改形状背景色为#00FF00"
1609
1609
  - "设置形状的填充颜色"`,
1610
1610
  category: tools_1.ToolCategory.PRESENTATION,
1611
1611
  inputSchema: {
@@ -1621,7 +1621,7 @@ exports.setShapeFillDefinition = {
1621
1621
  const setShapeFillHandler = async (args) => {
1622
1622
  const { slideIndex, shapeIndex, color } = args;
1623
1623
  try {
1624
- const response = await wps_client_1.wpsClient.executeMethod('setShapeFill', // NOTE: 仅Windows支持
1624
+ const response = await wps_client_1.wpsClient.executeMethod('setShapeFill', // 第 1 期第 2 章第 2 轮:这句原为「仅Windows支持」,是假注释 —— 该动作曾长期不存在于 ps1。第 6 轮已补 case,现在 Windows 上真能用。
1625
1625
  { slideIndex, shapeIndex, color }, wps_1.WpsAppType.PRESENTATION);
1626
1626
  if (response.success) {
1627
1627
  return {
@@ -1660,11 +1660,11 @@ exports.setShapeFillHandler = setShapeFillHandler;
1660
1660
  // ============================================================
1661
1661
  exports.addSpeakerNotesDefinition = {
1662
1662
  name: 'wps_ppt_add_speaker_notes',
1663
- description: `添加或追加演讲者备注到指定幻灯片。
1664
-
1665
- 使用场景:
1666
- - "给第1页添加演讲者备注"
1667
- - "在备注中写上提示词"
1663
+ description: `添加或追加演讲者备注到指定幻灯片。
1664
+
1665
+ 使用场景:
1666
+ - "给第1页添加演讲者备注"
1667
+ - "在备注中写上提示词"
1668
1668
  - "追加演讲提示到第3页"`,
1669
1669
  category: tools_1.ToolCategory.PRESENTATION,
1670
1670
  inputSchema: {