wps-multitool-mcp 1.0.1 → 1.0.2

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 (172) hide show
  1. package/dist/bridge/index.js +4 -2
  2. package/dist/bridge/index.js.map +1 -1
  3. package/dist/cli/install.d.ts +58 -0
  4. package/dist/cli/install.d.ts.map +1 -0
  5. package/dist/cli/install.js +301 -0
  6. package/dist/cli/install.js.map +1 -0
  7. package/dist/client/action-routes.generated.d.ts +1 -1
  8. package/dist/client/action-routes.generated.d.ts.map +1 -1
  9. package/dist/client/action-routes.generated.js +6 -1
  10. package/dist/client/action-routes.generated.js.map +1 -1
  11. package/dist/client/wps-client.d.ts +0 -3
  12. package/dist/client/wps-client.d.ts.map +1 -1
  13. package/dist/client/wps-client.js +61 -27
  14. package/dist/client/wps-client.js.map +1 -1
  15. package/dist/index.d.ts.map +1 -1
  16. package/dist/index.js +56 -4
  17. package/dist/index.js.map +1 -1
  18. package/dist/server/auto-snapshot.d.ts +58 -0
  19. package/dist/server/auto-snapshot.d.ts.map +1 -0
  20. package/dist/server/auto-snapshot.js +150 -0
  21. package/dist/server/auto-snapshot.js.map +1 -0
  22. package/dist/server/mcp-server.d.ts.map +1 -1
  23. package/dist/server/mcp-server.js +8 -141
  24. package/dist/server/mcp-server.js.map +1 -1
  25. package/dist/server/tool-aliases.generated.d.ts +41 -0
  26. package/dist/server/tool-aliases.generated.d.ts.map +1 -0
  27. package/dist/server/tool-aliases.generated.js +88 -0
  28. package/dist/server/tool-aliases.generated.js.map +1 -0
  29. package/dist/server/tool-annotations.d.ts +3 -0
  30. package/dist/server/tool-annotations.d.ts.map +1 -1
  31. package/dist/server/tool-annotations.generated.d.ts.map +1 -1
  32. package/dist/server/tool-annotations.generated.js +25 -47
  33. package/dist/server/tool-annotations.generated.js.map +1 -1
  34. package/dist/server/tool-annotations.js +83 -7
  35. package/dist/server/tool-annotations.js.map +1 -1
  36. package/dist/server/tool-metadata.d.ts +25 -0
  37. package/dist/server/tool-metadata.d.ts.map +1 -1
  38. package/dist/server/tool-metadata.js +217 -40
  39. package/dist/server/tool-metadata.js.map +1 -1
  40. package/dist/server/tool-registry.d.ts +25 -3
  41. package/dist/server/tool-registry.d.ts.map +1 -1
  42. package/dist/server/tool-registry.js +204 -42
  43. package/dist/server/tool-registry.js.map +1 -1
  44. package/dist/server/tool-tiers.d.ts +27 -8
  45. package/dist/server/tool-tiers.d.ts.map +1 -1
  46. package/dist/server/tool-tiers.js +34 -8
  47. package/dist/server/tool-tiers.js.map +1 -1
  48. package/dist/server/tool-verification.d.ts +35 -0
  49. package/dist/server/tool-verification.d.ts.map +1 -0
  50. package/dist/server/tool-verification.generated.d.ts +17 -0
  51. package/dist/server/tool-verification.generated.d.ts.map +1 -0
  52. package/dist/server/tool-verification.generated.js +293 -0
  53. package/dist/server/tool-verification.generated.js.map +1 -0
  54. package/dist/server/tool-verification.js +43 -0
  55. package/dist/server/tool-verification.js.map +1 -0
  56. package/dist/tools/common/batch.d.ts.map +1 -1
  57. package/dist/tools/common/batch.js +92 -14
  58. package/dist/tools/common/batch.js.map +1 -1
  59. package/dist/tools/common/general.d.ts +0 -3
  60. package/dist/tools/common/general.d.ts.map +1 -1
  61. package/dist/tools/common/general.js +16 -58
  62. package/dist/tools/common/general.js.map +1 -1
  63. package/dist/tools/common/index.d.ts +4 -2
  64. package/dist/tools/common/index.d.ts.map +1 -1
  65. package/dist/tools/common/index.js +18 -4
  66. package/dist/tools/common/index.js.map +1 -1
  67. package/dist/tools/common/repair.js +18 -18
  68. package/dist/tools/common/snapshot.d.ts +77 -0
  69. package/dist/tools/common/snapshot.d.ts.map +1 -0
  70. package/dist/tools/common/snapshot.js +497 -0
  71. package/dist/tools/common/snapshot.js.map +1 -0
  72. package/dist/tools/common/status.js +27 -27
  73. package/dist/tools/common/toolgroups.d.ts.map +1 -1
  74. package/dist/tools/common/toolgroups.js +21 -5
  75. package/dist/tools/common/toolgroups.js.map +1 -1
  76. package/dist/tools/excel/data.d.ts +0 -5
  77. package/dist/tools/excel/data.d.ts.map +1 -1
  78. package/dist/tools/excel/data.js +19 -39
  79. package/dist/tools/excel/data.js.map +1 -1
  80. package/dist/tools/excel/format.d.ts.map +1 -1
  81. package/dist/tools/excel/format.js +3 -1
  82. package/dist/tools/excel/format.js.map +1 -1
  83. package/dist/tools/excel/formula.d.ts +0 -9
  84. package/dist/tools/excel/formula.d.ts.map +1 -1
  85. package/dist/tools/excel/formula.js +1 -18
  86. package/dist/tools/excel/formula.js.map +1 -1
  87. package/dist/tools/excel/index.d.ts +3 -3
  88. package/dist/tools/excel/index.d.ts.map +1 -1
  89. package/dist/tools/excel/index.js +4 -12
  90. package/dist/tools/excel/index.js.map +1 -1
  91. package/dist/tools/excel/sheet-gaps.d.ts +2 -2
  92. package/dist/tools/excel/sheet-gaps.js +2 -2
  93. package/dist/tools/excel/sheet.d.ts +0 -10
  94. package/dist/tools/excel/sheet.d.ts.map +1 -1
  95. package/dist/tools/excel/sheet.js +7 -117
  96. package/dist/tools/excel/sheet.js.map +1 -1
  97. package/dist/tools/excel/workbook.d.ts.map +1 -1
  98. package/dist/tools/excel/workbook.js +8 -3
  99. package/dist/tools/excel/workbook.js.map +1 -1
  100. package/dist/tools/ppt/animation.d.ts +15 -58
  101. package/dist/tools/ppt/animation.d.ts.map +1 -1
  102. package/dist/tools/ppt/animation.js +39 -568
  103. package/dist/tools/ppt/animation.js.map +1 -1
  104. package/dist/tools/ppt/background.d.ts +0 -18
  105. package/dist/tools/ppt/background.d.ts.map +1 -1
  106. package/dist/tools/ppt/background.js +43 -249
  107. package/dist/tools/ppt/background.js.map +1 -1
  108. package/dist/tools/ppt/beautify-advanced.d.ts +0 -6
  109. package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -1
  110. package/dist/tools/ppt/beautify-advanced.js +13 -76
  111. package/dist/tools/ppt/beautify-advanced.js.map +1 -1
  112. package/dist/tools/ppt/data-viz.d.ts.map +1 -1
  113. package/dist/tools/ppt/data-viz.js +1 -1
  114. package/dist/tools/ppt/data-viz.js.map +1 -1
  115. package/dist/tools/ppt/image.d.ts.map +1 -1
  116. package/dist/tools/ppt/image.js +4 -9
  117. package/dist/tools/ppt/image.js.map +1 -1
  118. package/dist/tools/ppt/index.d.ts +5 -5
  119. package/dist/tools/ppt/index.d.ts.map +1 -1
  120. package/dist/tools/ppt/index.js +5 -35
  121. package/dist/tools/ppt/index.js.map +1 -1
  122. package/dist/tools/ppt/misc.d.ts +0 -6
  123. package/dist/tools/ppt/misc.d.ts.map +1 -1
  124. package/dist/tools/ppt/misc.js +14 -65
  125. package/dist/tools/ppt/misc.js.map +1 -1
  126. package/dist/tools/ppt/presentation.d.ts.map +1 -1
  127. package/dist/tools/ppt/presentation.js +25 -11
  128. package/dist/tools/ppt/presentation.js.map +1 -1
  129. package/dist/tools/ppt/slide-ops.d.ts +0 -6
  130. package/dist/tools/ppt/slide-ops.d.ts.map +1 -1
  131. package/dist/tools/ppt/slide-ops.js +418 -324
  132. package/dist/tools/ppt/slide-ops.js.map +1 -1
  133. package/dist/tools/ppt/slide.d.ts.map +1 -1
  134. package/dist/tools/ppt/slide.js +49 -35
  135. package/dist/tools/ppt/slide.js.map +1 -1
  136. package/dist/tools/ppt/table.d.ts.map +1 -1
  137. package/dist/tools/ppt/table.js +4 -2
  138. package/dist/tools/ppt/table.js.map +1 -1
  139. package/dist/tools/ppt/textbox.d.ts.map +1 -1
  140. package/dist/tools/ppt/textbox.js +4 -1
  141. package/dist/tools/ppt/textbox.js.map +1 -1
  142. package/dist/tools/word/academic.js +79 -79
  143. package/dist/tools/word/content.d.ts.map +1 -1
  144. package/dist/tools/word/content.js +9 -4
  145. package/dist/tools/word/content.js.map +1 -1
  146. package/dist/tools/word/document.d.ts +0 -5
  147. package/dist/tools/word/document.d.ts.map +1 -1
  148. package/dist/tools/word/document.js +1 -58
  149. package/dist/tools/word/document.js.map +1 -1
  150. package/dist/tools/word/gaps.d.ts +2 -2
  151. package/dist/tools/word/gaps.js +2 -2
  152. package/dist/tools/word/index.d.ts +1 -1
  153. package/dist/tools/word/index.d.ts.map +1 -1
  154. package/dist/tools/word/index.js +1 -3
  155. package/dist/tools/word/index.js.map +1 -1
  156. package/dist/types/tools.d.ts +12 -1
  157. package/dist/types/tools.d.ts.map +1 -1
  158. package/dist/types/tools.js.map +1 -1
  159. package/dist/utils/logger.d.ts.map +1 -1
  160. package/dist/utils/logger.js +17 -0
  161. package/dist/utils/logger.js.map +1 -1
  162. package/package.json +66 -59
  163. package/scripts/wps-com.ps1 +8255 -7260
  164. package/scripts/wps-comd.ps1 +123 -123
  165. package/skills/wps-multitool/SKILL.md +128 -110
  166. package/skills/wps-multitool/references/errors.md +61 -61
  167. package/skills/wps-multitool/references/recipes.md +82 -81
  168. package/skills/wps-multitool/references/routing.md +87 -87
  169. package/dist/client/mac-poll-server.d.ts +0 -77
  170. package/dist/client/mac-poll-server.d.ts.map +0 -1
  171. package/dist/client/mac-poll-server.js +0 -516
  172. package/dist/client/mac-poll-server.js.map +0 -1
@@ -1,82 +1,83 @@
1
- # 长任务配方
2
-
3
- 跨多步的任务,先规划再动手。以下三例是本 MCP 里最常遇到的形态。
4
-
5
- ## 通则
6
-
7
- 1. **先探活**(`wps_common_status`),没有文档就先建/开
8
- 2. **先读后写**:动手之前先读一份现状(现有样式、现有目录、现有数据),
9
- 照着现状改,不要凭想象写
10
- 3. **分批**:一次改几十处容易中途失败,前功尽弃。分批做,每批做完验证
11
- 4. **做完读回来**:写完不验证等于没做。至少读一次确认落位了
12
- 5. **破坏性动作前留快照**:让用户在 WPS 面板里存一份,MCP 侧没有撤销
13
-
14
- ## 配方一:整篇文档排版
15
-
16
- 目标:把一份论文/报告排成正式版式。
17
-
18
- ```
19
- 1. status → 确认文档在、桥通
20
- 2. load_tool_group(word) → 加载文字组
21
- 3. 读现状 → 现有标题都是什么样式?有没有目录?页边距多少?
22
- 4. 套样式 → 正文套"正文"样式,标题按级别套"标题 1/2/3"
23
- 5. 插目录 → 按标题级别生成(不要用重建版,会覆盖)
24
- 6. 页眉页脚 + 页码 → 页码类工具
25
- 7. 存快照 / 存盘
26
- 8. 读回验证 → 抽查几段,确认样式落位、目录条目数对得上
27
- ```
28
-
29
- 坑:
30
- - **别用重建目录**,用户手改过的目录字段会被冲掉
31
- - 标题层级要连续。跳级(标题 1 直接到标题 3)会导致目录层级乱
32
- - 套样式**替换**直接格式会让用户的加粗/颜色丢失,动手前说一声
33
-
34
- ## 配方二:表格数据处理
35
-
36
- 目标:一份数据表要算指标、套格式、做成图。
37
-
38
- ```
39
- 1. status + 打开工作簿
40
- 2. load_tool_group(excel)
41
- 3. 读现状 → 先读表头与前几行,确认数据范围和类型
42
- 4. 写公式 / 批量写区域 → 公式优先于算好的值(用户改数据后能自动更新)
43
- 5. 格式化 → 数字格式、条件格式、列宽
44
- 6. 建图 → 图表类工具
45
- 7. 存盘
46
- 8. 读回验证 → 重读公式结果,确认没出现 #REF! / #DIV/0!
47
- ```
48
-
49
- 坑:
50
- - **批量写区域前先确认范围**。写超了会覆盖旁边的数据,且无法撤销
51
- - 公式用相对引用还是绝对引用要想清楚;整列套公式会拖慢 WPS
52
- - 表头行通常要冻结,用户没说也要做(可逆、体验提升明显)
53
-
54
- ## 配方三:做演示
55
-
56
- ```
57
- 1. status + 确认演示文稿已打开
58
- 2. load_tool_group(ppt)
59
- 3. 读现状 → 现有几张幻灯片、什么版式、有没有母版
60
- 4. 定结构 → 先说清楚要几页、每页讲什么,再动手
61
- 5. 逐页填内容 → 一次一页,每页填完读回来看
62
- 6. 统一样式 → 配色 / 母版 / 字体一次定好,不要逐页微调
63
- 7. 动画(可选)
64
- 8. 存盘
65
- ```
66
-
67
- 坑:
68
- - **PPT 的工具没有真机覆盖验证过**。每一步做完都要读回来看,
69
- 并在最后如实告诉用户"这部分未在真机验证"
70
- - 母版和单页样式冲突时,母版优先;逐页设的背景会被母版覆盖
71
- - 加动画前先想清楚会不会让阅读变慢,不是每个元素都该动
72
-
73
- ## 配方四:批量改格式
74
-
75
- ```
76
- 1. 读现状 → 搞清楚要改多少处、改完什么样
77
- 2. 先改 2~3 处 → 读回验证
78
- 3. 满意了再批量 → 前 3 处没验证就全量跑,错了要全量回滚
79
- ```
80
-
81
- 这是最危险的一类任务:范围大、影响面广、没有撤销。
1
+ # 长任务配方
2
+
3
+ 跨多步的任务,先规划再动手。以下三例是本 MCP 里最常遇到的形态。
4
+
5
+ ## 通则
6
+
7
+ 1. **先探活**(`wps_common_status`),没有文档就先建/开
8
+ 2. **先读后写**:动手之前先读一份现状(现有样式、现有目录、现有数据),
9
+ 照着现状改,不要凭想象写
10
+ 3. **分批**:一次改几十处容易中途失败,前功尽弃。分批做,每批做完验证
11
+ 4. **做完读回来**:写完不验证等于没做。至少读一次确认落位了
12
+ 5. **破坏性动作前留快照**:让用户在 WPS 面板里存一份,MCP 侧没有撤销
13
+
14
+ ## 配方一:整篇文档排版
15
+
16
+ 目标:把一份论文/报告排成正式版式。
17
+
18
+ ```
19
+ 1. status → 确认文档在、桥通
20
+ 2. load_tool_group(word) → 加载文字组
21
+ 3. 读现状 → 现有标题都是什么样式?有没有目录?页边距多少?
22
+ 4. 套样式 → 正文套"正文"样式,标题按级别套"标题 1/2/3"
23
+ 5. 插目录 → 按标题级别生成(不要用重建版,会覆盖)
24
+ 6. 页眉页脚 + 页码 → 页码类工具
25
+ 7. 存快照 / 存盘
26
+ 8. 读回验证 → 抽查几段,确认样式落位、目录条目数对得上
27
+ ```
28
+
29
+ 坑:
30
+ - **别用重建目录**,用户手改过的目录字段会被冲掉
31
+ - 标题层级要连续。跳级(标题 1 直接到标题 3)会导致目录层级乱
32
+ - 套样式**替换**直接格式会让用户的加粗/颜色丢失,动手前说一声
33
+
34
+ ## 配方二:表格数据处理
35
+
36
+ 目标:一份数据表要算指标、套格式、做成图。
37
+
38
+ ```
39
+ 1. status + 打开工作簿
40
+ 2. load_tool_group(excel)
41
+ 3. 读现状 → 先读表头与前几行,确认数据范围和类型
42
+ 4. 写公式 / 批量写区域 → 公式优先于算好的值(用户改数据后能自动更新)
43
+ 5. 格式化 → 数字格式、条件格式、列宽
44
+ 6. 建图 → 图表类工具
45
+ 7. 存盘
46
+ 8. 读回验证 → 重读公式结果,确认没出现 #REF! / #DIV/0!
47
+ ```
48
+
49
+ 坑:
50
+ - **批量写区域前先确认范围**。写超了会覆盖旁边的数据,且无法撤销
51
+ - 公式用相对引用还是绝对引用要想清楚;整列套公式会拖慢 WPS
52
+ - 表头行通常要冻结,用户没说也要做(可逆、体验提升明显)
53
+
54
+ ## 配方三:做演示
55
+
56
+ ```
57
+ 1. status + 确认演示文稿已打开
58
+ 2. load_tool_group(ppt)
59
+ 3. 读现状 → 现有几张幻灯片、什么版式、有没有母版
60
+ 4. 定结构 → 先说清楚要几页、每页讲什么,再动手
61
+ 5. 逐页填内容 → 一次一页,每页填完读回来看
62
+ 6. 统一样式 → 配色 / 母版 / 字体一次定好,不要逐页微调
63
+ 7. 动画(可选)
64
+ 8. 存盘
65
+ ```
66
+
67
+ 坑:
68
+ - **PPT 组个别工具只有静态校验**(组级台账记 `static`:矩阵里 5 条有据跳过)。
69
+ 每一步做完都要读回来看,并按 `wps_search_tools` 返回的 `verified` 字段如实告诉用户
70
+ 「这个工具只做过静态校验」——别笼统说「PPT 没验证过」,那是错的;也别因为它跑通了就当全部都验过。
71
+ - 母版和单页样式冲突时,母版优先;逐页设的背景会被母版覆盖
72
+ - 加动画前先想清楚会不会让阅读变慢,不是每个元素都该动
73
+
74
+ ## 配方四:批量改格式
75
+
76
+ ```
77
+ 1. 读现状 → 搞清楚要改多少处、改完什么样
78
+ 2. 先改 2~3 处 → 读回验证
79
+ 3. 满意了再批量 → 前 3 处没验证就全量跑,错了要全量回滚
80
+ ```
81
+
82
+ 这是最危险的一类任务:范围大、影响面广、没有撤销。
82
83
  中途失败时,已改的部分留在那里,只能靠快照恢复。
@@ -1,88 +1,88 @@
1
- # 路由与选型
2
-
3
- ## 四个组
4
-
5
- | 组 | 装什么 | 什么时候加载 |
6
- |---|---|---|
7
- | `core` | 工具组管理、搜索、意图识别 | 永远加载,不用管 |
8
- | `word` | 文字:样式、修订、表格、交叉引用、索引、页眉页脚 | 动文档时 |
9
- | `excel` | 表格:公式、图表、单元格、区域、工作表 | 动表格时 |
10
- | `ppt` | 演示:版式、动画、母版、图表、配色 | 动演示时 |
11
- | `common` | 跨应用:保存、建文档、状态、修复、格式转换 | 任何写操作前后 |
12
-
13
- 默认只列 40 个基础工具。要用别的,先 `wps_load_tool_group`。
14
-
15
- ## 什么时候别信意图识别
16
-
17
- `wps_route_intent` 是关键词打分,组间语义差别大时它很准;下面这些情况**别硬猜**,
18
- 直接 `wps_search_tools` 搜中文关键词("插入表格""改背景""做动画"都能命中):
19
-
20
- - 一句话里同时提到两个应用("把这张表的数据做成 PPT")
21
- - 诉求是排版/版式类("这篇论文排得像正式期刊")
22
- - 搜出来的结果里 `notFor` 说"这个不干 X"—— 说明还有更合适的
23
-
24
- ## 近名工具分辨表
25
-
26
- 本 MCP 里有大量近名工具。选错**不会报错**,只会把事情改到别处,用户还看不出来。
27
-
28
- ### 目录 / 索引 / 交叉引用(最常混)
29
-
30
- | 需求 | 用 | 不是什么 |
31
- |---|---|---|
32
- | 按标题级别生成目录 | `wps_word_generate_toc` | 不是重建整篇目录(会覆盖) |
33
- | 整篇重建目录 | `wps_word_generate_doc_toc` | 不是插段落 |
34
- | 插"见图 3"这类引用 | `wps_word_cross_reference` | 不是参考文献、不是索引 |
35
- | 插关键词索引表 | `wps_word_index` | 不是目录 |
36
-
37
- ### 样式:套用 vs 定义
38
-
39
- | 需求 | 用 |
40
- |---|---|
41
- | 给已有段落套"标题 1"样式 | `wps_word_apply_style` |
42
- | 新建一个自定义样式 | `wps_word_add_style` |
43
- | 改样式定义本身 | `wps_word_modify_style` |
44
- | 删样式定义 | `wps_word_delete_style` |
45
- | 插入一级标题段落 | `wps_word_add_heading` |
46
-
47
- ### 表格:插入 vs 改造
48
-
49
- | 需求 | 用 |
50
- |---|---|
51
- | 新建一张表 | `wps_word_insert_table` |
52
- | 改已有表的样式/边框 | `wps_word_format_table` / `wps_word_set_cell_borders` |
53
- | 合并单元格 | `wps_word_merge_table_cells` |
54
- | 拆单元格 | `wps_word_split_cell` |
55
-
56
- ### Excel:单条 vs 批量
57
-
58
- | 需求 | 用 |
59
- |---|---|
60
- | 写一个格子 | `wps_excel_set_cell_value` |
61
- | 写一大片区域 | `wps_excel_write_range` |
62
- | 写公式 | `wps_excel_set_formula` |
63
- | 插一行 / 多行 | `wps_excel_insert_row` / `wps_excel_insert_rows` |
64
- | 缩放(`zoom` 与 `set_zoom` 重复) | 二选一,优先 `set_zoom` |
65
-
66
- ### 修订 vs 批注
67
-
68
- | 需求 | 用 |
69
- |---|---|
70
- | 查看/接受/拒绝已有修订 | `wps_word_revisions` |
71
- | 插入一条新批注 | `wps_word_insert_comment` |
72
-
73
- ### PPT 的背景与动画
74
-
75
- `background` 有 6 个、`animation` 有 5 个,全部靠名字分不出来。
76
- **先搜再读 `notFor`**,不要凭名字挑:不同工具管的是幻灯片背景 / 母版背景 /
77
- 图表区背景,纯色 / 图片 / 渐变又是三回事;动画分普通 / 预设 / 强调 / 顺序 / 清除。
78
-
79
- ## 搜索返回什么
80
-
81
- ```
82
- name 工具名
83
- group 所属组(未加载时 listed: false)
84
- listed 当前是否已列出
85
- aliases 中文别名
86
- examples 什么诉求用它
87
- notFor 它不干什么、该用谁 ← 必读
1
+ # 路由与选型
2
+
3
+ ## 四个组
4
+
5
+ | 组 | 装什么 | 什么时候加载 |
6
+ |---|---|---|
7
+ | `core` | 工具组管理、搜索、意图识别 | 永远加载,不用管 |
8
+ | `word` | 文字:样式、修订、表格、交叉引用、索引、页眉页脚 | 动文档时 |
9
+ | `excel` | 表格:公式、图表、单元格、区域、工作表 | 动表格时 |
10
+ | `ppt` | 演示:版式、动画、母版、图表、配色 | 动演示时 |
11
+ | `common` | 跨应用:保存、建文档、状态、修复、格式转换 | 任何写操作前后 |
12
+
13
+ 默认只列 40 个基础工具。要用别的,先 `wps_load_tool_group`。
14
+
15
+ ## 什么时候别信意图识别
16
+
17
+ `wps_route_intent` 是关键词打分,组间语义差别大时它很准;下面这些情况**别硬猜**,
18
+ 直接 `wps_search_tools` 搜中文关键词("插入表格""改背景""做动画"都能命中):
19
+
20
+ - 一句话里同时提到两个应用("把这张表的数据做成 PPT")
21
+ - 诉求是排版/版式类("这篇论文排得像正式期刊")
22
+ - 搜出来的结果里 `notFor` 说"这个不干 X"—— 说明还有更合适的
23
+
24
+ ## 近名工具分辨表
25
+
26
+ 本 MCP 里有大量近名工具。选错**不会报错**,只会把事情改到别处,用户还看不出来。
27
+
28
+ ### 目录 / 索引 / 交叉引用(最常混)
29
+
30
+ | 需求 | 用 | 不是什么 |
31
+ |---|---|---|
32
+ | 按标题级别生成目录 | `wps_word_generate_toc` | 不是重建整篇目录(会覆盖) |
33
+ | 整篇重建目录 | `wps_word_generate_doc_toc` | 不是插段落 |
34
+ | 插"见图 3"这类引用 | `wps_word_cross_reference` | 不是参考文献、不是索引 |
35
+ | 插关键词索引表 | `wps_word_index` | 不是目录 |
36
+
37
+ ### 样式:套用 vs 定义
38
+
39
+ | 需求 | 用 |
40
+ |---|---|
41
+ | 给已有段落套"标题 1"样式 | `wps_word_apply_style` |
42
+ | 新建一个自定义样式 | `wps_word_add_style` |
43
+ | 改样式定义本身 | `wps_word_modify_style` |
44
+ | 删样式定义 | `wps_word_delete_style` |
45
+ | 插入一级标题段落 | `wps_word_add_heading` |
46
+
47
+ ### 表格:插入 vs 改造
48
+
49
+ | 需求 | 用 |
50
+ |---|---|
51
+ | 新建一张表 | `wps_word_insert_table` |
52
+ | 改已有表的样式/边框 | `wps_word_format_table` / `wps_word_set_cell_borders` |
53
+ | 合并单元格 | `wps_word_merge_table_cells` |
54
+ | 拆单元格 | `wps_word_split_cell` |
55
+
56
+ ### Excel:单条 vs 批量
57
+
58
+ | 需求 | 用 |
59
+ |---|---|
60
+ | 写一个格子 | `wps_excel_set_cell_value` |
61
+ | 写一大片区域 | `wps_excel_write_range` |
62
+ | 写公式 | `wps_excel_set_formula` |
63
+ | 插一行 / 多行 | `wps_excel_insert_row` / `wps_excel_insert_rows` |
64
+ | 缩放(`zoom` 与 `set_zoom` 重复) | 二选一,优先 `set_zoom` |
65
+
66
+ ### 修订 vs 批注
67
+
68
+ | 需求 | 用 |
69
+ |---|---|
70
+ | 查看/接受/拒绝已有修订 | `wps_word_revisions` |
71
+ | 插入一条新批注 | `wps_word_insert_comment` |
72
+
73
+ ### PPT 的背景与动画
74
+
75
+ `background` 有 6 个、`animation` 有 5 个,全部靠名字分不出来。
76
+ **先搜再读 `notFor`**,不要凭名字挑:不同工具管的是幻灯片背景 / 母版背景 /
77
+ 图表区背景,纯色 / 图片 / 渐变又是三回事;动画分普通 / 预设 / 强调 / 顺序 / 清除。
78
+
79
+ ## 搜索返回什么
80
+
81
+ ```
82
+ name 工具名
83
+ group 所属组(未加载时 listed: false)
84
+ listed 当前是否已列出
85
+ aliases 中文别名
86
+ examples 什么诉求用它
87
+ notFor 它不干什么、该用谁 ← 必读
88
88
  ```
@@ -1,77 +0,0 @@
1
- /**
2
- * Input: WPS 指令与HTTP请求
3
- * Output: 轮询执行结果(含 Issue #17 已连接检测,避免 pkill 杀死已运行 WPS)
4
- * Pos: macOS/Linux 轮询服务器实现,MCP Server 与 WPS 加载项之间的桥梁
5
- * 一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
6
- * Mac轮询服务器 - 老王出品
7
- *
8
- * 丢,WPS Mac加载项在沙箱里启动不了HTTP服务器,只能反过来:
9
- * - MCP Server 作为HTTP服务端(端口58891)
10
- * - WPS加载项 作为HTTP客户端轮询获取命令
11
- *
12
- * 这SB架构虽然绕,但确实能跑通!
13
- */
14
- /**
15
- * Mac轮询服务器类
16
- * 处理WPS加载项的轮询请求,实现命令的发送和结果接收
17
- */
18
- declare class MacPollServer {
19
- private server;
20
- private pendingCommand;
21
- private currentApp;
22
- private _isRunning;
23
- private port;
24
- /** Issue #17: 记录最近一次 WPS 加载项 poll 请求的时间戳,用于判断加载项是否已连接 */
25
- private lastPollTime;
26
- get isRunning(): boolean;
27
- /**
28
- * 启动轮询服务器
29
- * 丢,这个服务器要处理三种请求:
30
- * 1. GET /poll - WPS加载项来轮询获取命令
31
- * 2. POST /result - WPS加载项返回执行结果
32
- * 3. OPTIONS - 该死的CORS预检请求
33
- */
34
- start(listenPort?: number): Promise<void>;
35
- /**
36
- * 处理轮询请求
37
- * WPS加载项每500ms来问一次:有活干不?
38
- */
39
- private handlePoll;
40
- /**
41
- * 处理结果返回
42
- * WPS加载项执行完命令后把结果POST回来
43
- */
44
- private handleResult;
45
- /**
46
- * 执行WPS命令
47
- * 这是对外的主要接口,调用后会:
48
- * 1. 检查是否需要切换应用
49
- * 2. 把命令放到队列里等WPS加载项来取
50
- * 3. 等待结果返回
51
- */
52
- executeCommand(action: string, params?: Record<string, unknown>, timeout?: number): Promise<unknown>;
53
- /**
54
- * 根据命令获取需要的应用类型
55
- */
56
- private getRequiredApp;
57
- /**
58
- * 切换WPS应用
59
- * 调用wps-auto.sh脚本自动关闭当前应用并启动目标应用
60
- */
61
- private switchApp;
62
- /**
63
- * 停止服务器
64
- */
65
- stop(): void;
66
- /**
67
- * 获取当前连接的应用类型
68
- */
69
- getCurrentApp(): string;
70
- /**
71
- * 设置当前应用(用于外部更新状态)
72
- */
73
- setCurrentApp(app: string): void;
74
- }
75
- export declare const macPollServer: MacPollServer;
76
- export default MacPollServer;
77
- //# sourceMappingURL=mac-poll-server.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"mac-poll-server.d.ts","sourceRoot":"","sources":["../../src/client/mac-poll-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA+OH;;;GAGG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,IAAI,CAAiB;IAC7B,yDAAyD;IACzD,OAAO,CAAC,YAAY,CAAa;IAEjC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;;;OAMG;IACG,KAAK,CAAC,UAAU,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6DtD;;;OAGG;IACH,OAAO,CAAC,UAAU;IAkBlB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAgCpB;;;;;;OAMG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA2CrH;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;;OAGG;YACW,SAAS;IAyBvB;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAGjC;AAGD,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,eAAe,aAAa,CAAC"}