wps-multitool-mcp 0.0.0-stage → 1.0.1

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 (280) hide show
  1. package/README.md +3 -3
  2. package/dist/bridge/cancellable.d.ts +36 -0
  3. package/dist/bridge/cancellable.d.ts.map +1 -0
  4. package/dist/bridge/cancellable.js +155 -0
  5. package/dist/bridge/cancellable.js.map +1 -0
  6. package/dist/bridge/index.d.ts +37 -0
  7. package/dist/bridge/index.d.ts.map +1 -0
  8. package/dist/bridge/index.js +381 -0
  9. package/dist/bridge/index.js.map +1 -0
  10. package/dist/bridge/ps-child.d.ts +155 -0
  11. package/dist/bridge/ps-child.d.ts.map +1 -0
  12. package/dist/bridge/ps-child.js +578 -0
  13. package/dist/bridge/ps-child.js.map +1 -0
  14. package/dist/client/action-routes.d.ts +32 -0
  15. package/dist/client/action-routes.d.ts.map +1 -0
  16. package/dist/client/action-routes.generated.d.ts +10 -0
  17. package/dist/client/action-routes.generated.d.ts.map +1 -0
  18. package/dist/client/action-routes.generated.js +322 -0
  19. package/dist/client/action-routes.generated.js.map +1 -0
  20. package/dist/client/action-routes.js +57 -0
  21. package/dist/client/action-routes.js.map +1 -0
  22. package/dist/client/mac-poll-server.d.ts +77 -0
  23. package/dist/client/mac-poll-server.d.ts.map +1 -0
  24. package/dist/client/mac-poll-server.js +516 -0
  25. package/dist/client/mac-poll-server.js.map +1 -0
  26. package/dist/client/ps-daemon.d.ts +95 -0
  27. package/dist/client/ps-daemon.d.ts.map +1 -0
  28. package/dist/client/ps-daemon.js +424 -0
  29. package/dist/client/ps-daemon.js.map +1 -0
  30. package/dist/client/wps-client.d.ts +72 -0
  31. package/dist/client/wps-client.d.ts.map +1 -0
  32. package/dist/client/wps-client.js +408 -0
  33. package/dist/client/wps-client.js.map +1 -0
  34. package/dist/index.d.ts +29 -0
  35. package/dist/index.d.ts.map +1 -0
  36. package/dist/index.js +121 -0
  37. package/dist/index.js.map +1 -0
  38. package/dist/runtime-identity.d.ts +23 -0
  39. package/dist/runtime-identity.d.ts.map +1 -0
  40. package/dist/runtime-identity.js +26 -0
  41. package/dist/runtime-identity.js.map +1 -0
  42. package/dist/server/cancel-context.d.ts +30 -0
  43. package/dist/server/cancel-context.d.ts.map +1 -0
  44. package/dist/server/cancel-context.js +38 -0
  45. package/dist/server/cancel-context.js.map +1 -0
  46. package/dist/server/mcp-server.d.ts +74 -0
  47. package/dist/server/mcp-server.d.ts.map +1 -0
  48. package/dist/server/mcp-server.js +725 -0
  49. package/dist/server/mcp-server.js.map +1 -0
  50. package/dist/server/server-info.d.ts +21 -0
  51. package/dist/server/server-info.d.ts.map +1 -0
  52. package/dist/server/server-info.js +56 -0
  53. package/dist/server/server-info.js.map +1 -0
  54. package/dist/server/tool-annotations.d.ts +52 -0
  55. package/dist/server/tool-annotations.d.ts.map +1 -0
  56. package/dist/server/tool-annotations.generated.d.ts +14 -0
  57. package/dist/server/tool-annotations.generated.d.ts.map +1 -0
  58. package/dist/server/tool-annotations.generated.js +324 -0
  59. package/dist/server/tool-annotations.generated.js.map +1 -0
  60. package/dist/server/tool-annotations.js +116 -0
  61. package/dist/server/tool-annotations.js.map +1 -0
  62. package/dist/server/tool-group-events.d.ts +23 -0
  63. package/dist/server/tool-group-events.d.ts.map +1 -0
  64. package/dist/server/tool-group-events.js +44 -0
  65. package/dist/server/tool-group-events.js.map +1 -0
  66. package/dist/server/tool-metadata.d.ts +43 -0
  67. package/dist/server/tool-metadata.d.ts.map +1 -0
  68. package/dist/server/tool-metadata.js +657 -0
  69. package/dist/server/tool-metadata.js.map +1 -0
  70. package/dist/server/tool-registry.d.ts +164 -0
  71. package/dist/server/tool-registry.d.ts.map +1 -0
  72. package/dist/server/tool-registry.js +453 -0
  73. package/dist/server/tool-registry.js.map +1 -0
  74. package/dist/server/tool-tiers.d.ts +39 -0
  75. package/dist/server/tool-tiers.d.ts.map +1 -0
  76. package/dist/server/tool-tiers.js +102 -0
  77. package/dist/server/tool-tiers.js.map +1 -0
  78. package/dist/tools/common/batch.d.ts +33 -0
  79. package/dist/tools/common/batch.d.ts.map +1 -0
  80. package/dist/tools/common/batch.js +195 -0
  81. package/dist/tools/common/batch.js.map +1 -0
  82. package/dist/tools/common/convert.d.ts +41 -0
  83. package/dist/tools/common/convert.d.ts.map +1 -0
  84. package/dist/tools/common/convert.js +299 -0
  85. package/dist/tools/common/convert.js.map +1 -0
  86. package/dist/tools/common/general.d.ts +39 -0
  87. package/dist/tools/common/general.d.ts.map +1 -0
  88. package/dist/tools/common/general.js +624 -0
  89. package/dist/tools/common/general.js.map +1 -0
  90. package/dist/tools/common/index.d.ts +36 -0
  91. package/dist/tools/common/index.d.ts.map +1 -0
  92. package/dist/tools/common/index.js +102 -0
  93. package/dist/tools/common/index.js.map +1 -0
  94. package/dist/tools/common/intent.d.ts +48 -0
  95. package/dist/tools/common/intent.d.ts.map +1 -0
  96. package/dist/tools/common/intent.js +221 -0
  97. package/dist/tools/common/intent.js.map +1 -0
  98. package/dist/tools/common/repair.d.ts +29 -0
  99. package/dist/tools/common/repair.d.ts.map +1 -0
  100. package/dist/tools/common/repair.js +140 -0
  101. package/dist/tools/common/repair.js.map +1 -0
  102. package/dist/tools/common/status.d.ts +27 -0
  103. package/dist/tools/common/status.d.ts.map +1 -0
  104. package/dist/tools/common/status.js +139 -0
  105. package/dist/tools/common/status.js.map +1 -0
  106. package/dist/tools/common/toolgroups.d.ts +38 -0
  107. package/dist/tools/common/toolgroups.d.ts.map +1 -0
  108. package/dist/tools/common/toolgroups.js +238 -0
  109. package/dist/tools/common/toolgroups.js.map +1 -0
  110. package/dist/tools/excel/chart.d.ts +86 -0
  111. package/dist/tools/excel/chart.d.ts.map +1 -0
  112. package/dist/tools/excel/chart.js +659 -0
  113. package/dist/tools/excel/chart.js.map +1 -0
  114. package/dist/tools/excel/comment-protect.d.ts +58 -0
  115. package/dist/tools/excel/comment-protect.d.ts.map +1 -0
  116. package/dist/tools/excel/comment-protect.js +274 -0
  117. package/dist/tools/excel/comment-protect.js.map +1 -0
  118. package/dist/tools/excel/data-advanced.d.ts +47 -0
  119. package/dist/tools/excel/data-advanced.d.ts.map +1 -0
  120. package/dist/tools/excel/data-advanced.js +263 -0
  121. package/dist/tools/excel/data-advanced.js.map +1 -0
  122. package/dist/tools/excel/data.d.ts +91 -0
  123. package/dist/tools/excel/data.d.ts.map +1 -0
  124. package/dist/tools/excel/data.js +626 -0
  125. package/dist/tools/excel/data.js.map +1 -0
  126. package/dist/tools/excel/format.d.ts +42 -0
  127. package/dist/tools/excel/format.d.ts.map +1 -0
  128. package/dist/tools/excel/format.js +715 -0
  129. package/dist/tools/excel/format.js.map +1 -0
  130. package/dist/tools/excel/formula.d.ts +64 -0
  131. package/dist/tools/excel/formula.d.ts.map +1 -0
  132. package/dist/tools/excel/formula.js +333 -0
  133. package/dist/tools/excel/formula.js.map +1 -0
  134. package/dist/tools/excel/index.d.ts +44 -0
  135. package/dist/tools/excel/index.d.ts.map +1 -0
  136. package/dist/tools/excel/index.js +249 -0
  137. package/dist/tools/excel/index.js.map +1 -0
  138. package/dist/tools/excel/pivot.d.ts +39 -0
  139. package/dist/tools/excel/pivot.d.ts.map +1 -0
  140. package/dist/tools/excel/pivot.js +455 -0
  141. package/dist/tools/excel/pivot.js.map +1 -0
  142. package/dist/tools/excel/row-column.d.ts +64 -0
  143. package/dist/tools/excel/row-column.d.ts.map +1 -0
  144. package/dist/tools/excel/row-column.js +299 -0
  145. package/dist/tools/excel/row-column.js.map +1 -0
  146. package/dist/tools/excel/sheet-gaps.d.ts +50 -0
  147. package/dist/tools/excel/sheet-gaps.d.ts.map +1 -0
  148. package/dist/tools/excel/sheet-gaps.js +373 -0
  149. package/dist/tools/excel/sheet-gaps.js.map +1 -0
  150. package/dist/tools/excel/sheet.d.ts +112 -0
  151. package/dist/tools/excel/sheet.d.ts.map +1 -0
  152. package/dist/tools/excel/sheet.js +937 -0
  153. package/dist/tools/excel/sheet.js.map +1 -0
  154. package/dist/tools/excel/workbook.d.ts +62 -0
  155. package/dist/tools/excel/workbook.d.ts.map +1 -0
  156. package/dist/tools/excel/workbook.js +366 -0
  157. package/dist/tools/excel/workbook.js.map +1 -0
  158. package/dist/tools/index.d.ts +48 -0
  159. package/dist/tools/index.d.ts.map +1 -0
  160. package/dist/tools/index.js +113 -0
  161. package/dist/tools/index.js.map +1 -0
  162. package/dist/tools/ppt/animation.d.ts +79 -0
  163. package/dist/tools/ppt/animation.d.ts.map +1 -0
  164. package/dist/tools/ppt/animation.js +719 -0
  165. package/dist/tools/ppt/animation.js.map +1 -0
  166. package/dist/tools/ppt/background.d.ts +72 -0
  167. package/dist/tools/ppt/background.d.ts.map +1 -0
  168. package/dist/tools/ppt/background.js +595 -0
  169. package/dist/tools/ppt/background.js.map +1 -0
  170. package/dist/tools/ppt/beautify-advanced.d.ts +72 -0
  171. package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -0
  172. package/dist/tools/ppt/beautify-advanced.js +663 -0
  173. package/dist/tools/ppt/beautify-advanced.js.map +1 -0
  174. package/dist/tools/ppt/chart-flow.d.ts +58 -0
  175. package/dist/tools/ppt/chart-flow.d.ts.map +1 -0
  176. package/dist/tools/ppt/chart-flow.js +523 -0
  177. package/dist/tools/ppt/chart-flow.js.map +1 -0
  178. package/dist/tools/ppt/data-viz.d.ts +64 -0
  179. package/dist/tools/ppt/data-viz.d.ts.map +1 -0
  180. package/dist/tools/ppt/data-viz.js +514 -0
  181. package/dist/tools/ppt/data-viz.js.map +1 -0
  182. package/dist/tools/ppt/image.d.ts +30 -0
  183. package/dist/tools/ppt/image.d.ts.map +1 -0
  184. package/dist/tools/ppt/image.js +452 -0
  185. package/dist/tools/ppt/image.js.map +1 -0
  186. package/dist/tools/ppt/index.d.ts +72 -0
  187. package/dist/tools/ppt/index.d.ts.map +1 -0
  188. package/dist/tools/ppt/index.js +350 -0
  189. package/dist/tools/ppt/index.js.map +1 -0
  190. package/dist/tools/ppt/misc.d.ts +99 -0
  191. package/dist/tools/ppt/misc.d.ts.map +1 -0
  192. package/dist/tools/ppt/misc.js +868 -0
  193. package/dist/tools/ppt/misc.js.map +1 -0
  194. package/dist/tools/ppt/presentation.d.ts +72 -0
  195. package/dist/tools/ppt/presentation.d.ts.map +1 -0
  196. package/dist/tools/ppt/presentation.js +680 -0
  197. package/dist/tools/ppt/presentation.js.map +1 -0
  198. package/dist/tools/ppt/shape-basic.d.ts +46 -0
  199. package/dist/tools/ppt/shape-basic.d.ts.map +1 -0
  200. package/dist/tools/ppt/shape-basic.js +756 -0
  201. package/dist/tools/ppt/shape-basic.js.map +1 -0
  202. package/dist/tools/ppt/slide-ops.d.ts +79 -0
  203. package/dist/tools/ppt/slide-ops.d.ts.map +1 -0
  204. package/dist/tools/ppt/slide-ops.js +1646 -0
  205. package/dist/tools/ppt/slide-ops.js.map +1 -0
  206. package/dist/tools/ppt/slide.d.ts +51 -0
  207. package/dist/tools/ppt/slide.d.ts.map +1 -0
  208. package/dist/tools/ppt/slide.js +470 -0
  209. package/dist/tools/ppt/slide.js.map +1 -0
  210. package/dist/tools/ppt/table.d.ts +58 -0
  211. package/dist/tools/ppt/table.d.ts.map +1 -0
  212. package/dist/tools/ppt/table.js +512 -0
  213. package/dist/tools/ppt/table.js.map +1 -0
  214. package/dist/tools/ppt/textbox.d.ts +47 -0
  215. package/dist/tools/ppt/textbox.d.ts.map +1 -0
  216. package/dist/tools/ppt/textbox.js +246 -0
  217. package/dist/tools/ppt/textbox.js.map +1 -0
  218. package/dist/tools/word/academic.d.ts +50 -0
  219. package/dist/tools/word/academic.d.ts.map +1 -0
  220. package/dist/tools/word/academic.js +500 -0
  221. package/dist/tools/word/academic.js.map +1 -0
  222. package/dist/tools/word/content.d.ts +97 -0
  223. package/dist/tools/word/content.d.ts.map +1 -0
  224. package/dist/tools/word/content.js +838 -0
  225. package/dist/tools/word/content.js.map +1 -0
  226. package/dist/tools/word/document.d.ts +70 -0
  227. package/dist/tools/word/document.d.ts.map +1 -0
  228. package/dist/tools/word/document.js +633 -0
  229. package/dist/tools/word/document.js.map +1 -0
  230. package/dist/tools/word/format.d.ts +50 -0
  231. package/dist/tools/word/format.d.ts.map +1 -0
  232. package/dist/tools/word/format.js +462 -0
  233. package/dist/tools/word/format.js.map +1 -0
  234. package/dist/tools/word/gaps.d.ts +58 -0
  235. package/dist/tools/word/gaps.d.ts.map +1 -0
  236. package/dist/tools/word/gaps.js +431 -0
  237. package/dist/tools/word/gaps.js.map +1 -0
  238. package/dist/tools/word/index.d.ts +34 -0
  239. package/dist/tools/word/index.d.ts.map +1 -0
  240. package/dist/tools/word/index.js +124 -0
  241. package/dist/tools/word/index.js.map +1 -0
  242. package/dist/tools/word/professional.d.ts +48 -0
  243. package/dist/tools/word/professional.d.ts.map +1 -0
  244. package/dist/tools/word/professional.js +657 -0
  245. package/dist/tools/word/professional.js.map +1 -0
  246. package/dist/tools/word/proofread.d.ts +25 -0
  247. package/dist/tools/word/proofread.d.ts.map +1 -0
  248. package/dist/tools/word/proofread.js +718 -0
  249. package/dist/tools/word/proofread.js.map +1 -0
  250. package/dist/types/index.d.ts +9 -0
  251. package/dist/types/index.d.ts.map +1 -0
  252. package/dist/types/index.js +25 -0
  253. package/dist/types/index.js.map +1 -0
  254. package/dist/types/tools.d.ts +163 -0
  255. package/dist/types/tools.d.ts.map +1 -0
  256. package/dist/types/tools.js +45 -0
  257. package/dist/types/tools.js.map +1 -0
  258. package/dist/types/wps.d.ts +190 -0
  259. package/dist/types/wps.d.ts.map +1 -0
  260. package/dist/types/wps.js +23 -0
  261. package/dist/types/wps.js.map +1 -0
  262. package/dist/utils/error.d.ts +147 -0
  263. package/dist/utils/error.d.ts.map +1 -0
  264. package/dist/utils/error.js +417 -0
  265. package/dist/utils/error.js.map +1 -0
  266. package/dist/utils/logger.d.ts +56 -0
  267. package/dist/utils/logger.d.ts.map +1 -0
  268. package/dist/utils/logger.js +138 -0
  269. package/dist/utils/logger.js.map +1 -0
  270. package/dist/version.d.ts +22 -0
  271. package/dist/version.d.ts.map +1 -0
  272. package/dist/version.js +101 -0
  273. package/dist/version.js.map +1 -0
  274. package/package.json +57 -4
  275. package/scripts/wps-com.ps1 +7260 -0
  276. package/scripts/wps-comd.ps1 +123 -0
  277. package/skills/wps-multitool/SKILL.md +111 -0
  278. package/skills/wps-multitool/references/errors.md +62 -0
  279. package/skills/wps-multitool/references/recipes.md +82 -0
  280. package/skills/wps-multitool/references/routing.md +88 -0
@@ -0,0 +1,123 @@
1
+ # Input: stdin 每行一个 JSON 请求 {"id":"...","action":"...","params":{...}}
2
+ # Output: stdout 每行一个 JSON 响应(原动作输出 + id)
3
+ # Pos: WPS COM 常驻守护进程。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
4
+ #
5
+ # 为什么要常驻
6
+ # ------------
7
+ # 改造前 MCP 每调一次工具就 spawn 一个 powershell.exe,解析 5000 行脚本再连一次 COM,
8
+ # 单次白花 0.3~0.6 秒。守护进程只启动一次、只解析一次,之后的请求在同一个进程里派发,
9
+ # COM 附着关系也留在同一个 STA 线程上。实测冷启动 5.1 秒,之后每次 3 毫秒。
10
+ #
11
+ # 与 wps-com.ps1 的关系
12
+ # --------------------
13
+ # 本文件设 $env:WPS_COM_DAEMON=1 后 dot-source wps-com.ps1。
14
+ # wps-com.ps1 末尾的入口段见到该变量就【只定义函数、不执行动作】,
15
+ # 于是 Invoke-WpsAction 成了可反复调用的分发入口。
16
+ # 直跑用法(-File wps-com.ps1 -Action X)完全不受影响。
17
+ #
18
+ # 编码:本文件【必须存成 UTF-8 with BOM】。
19
+ # PowerShell 5.1 对无 BOM 文件按 ANSI(GBK) 解码,头部中文注释会变乱码,
20
+ # 而且会静默吃掉紧随其后的第一条输出(已实测踩过,握手行就是这么丢的)。
21
+ #
22
+ # 协议:一行一个 JSON,请求/响应都带 id;除动作输出外本进程不往 stdout 写任何东西。
23
+ # (已核验:wps-com.ps1 内没有 Write-Host / Write-Output / echo。)
24
+ #
25
+ # 生命周期(两条同时生效,缺一不可)
26
+ # --------------------------------
27
+ # 1) stdin 读到 EOF → 退出(父进程正常收管道时会走这条)
28
+ # 2) 父进程看门狗 → 退出
29
+ # 第 2 条是必须的:实测【父进程被强杀、甚至正常 exit 之后】stdin 都不一定立刻 EOF,
30
+ # 只靠第 1 条会留下一个抓着 COM 的孤儿 powershell。
31
+ # 看门狗必须跑在【独立 .NET 线程】上 —— 主线程阻塞在 ReadLine 里时,
32
+ # PowerShell 的 Register-ObjectEvent / 定时器事件根本不会被泵到。
33
+ # 看门狗只做一件事:父进程没了就 Environment.Exit(0)。
34
+
35
+ $ErrorActionPreference = 'Continue'
36
+ [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
37
+ [Console]::InputEncoding = [System.Text.Encoding]::UTF8
38
+
39
+ $script:WpsReqId = $null
40
+ $parentPid = $null
41
+
42
+ # ==================== 父进程看门狗 ====================
43
+ # Add-Type 首次编译约 0.5~1 秒,相对 5 秒冷启动可以接受
44
+ try {
45
+ if (-not ([System.Management.Automation.PSTypeName]'WpsParentWatchdog').Type) {
46
+ Add-Type -TypeDefinition @'
47
+ using System;
48
+ using System.Diagnostics;
49
+ using System.Threading;
50
+
51
+ public static class WpsParentWatchdog
52
+ {
53
+ public static void Start(int parentPid)
54
+ {
55
+ var t = new Thread(() =>
56
+ {
57
+ while (true)
58
+ {
59
+ try
60
+ {
61
+ var p = Process.GetProcessById(parentPid);
62
+ if (p.HasExited) { break; }
63
+ }
64
+ catch
65
+ {
66
+ // 父进程没了(或 PID 已失效)—— 我们也该走
67
+ Environment.Exit(0);
68
+ }
69
+ Thread.Sleep(2000);
70
+ }
71
+ Environment.Exit(0);
72
+ });
73
+ t.IsBackground = true;
74
+ t.Name = "wps-parent-watchdog";
75
+ t.Start();
76
+ }
77
+ }
78
+ '@ -ErrorAction Stop
79
+ }
80
+
81
+ $parentPid = (Get-CimInstance Win32_Process -Filter "ProcessId=$PID" -ErrorAction SilentlyContinue).ParentProcessId
82
+ if ($parentPid) {
83
+ [WpsParentWatchdog]::Start([int]$parentPid)
84
+ }
85
+ } catch {
86
+ # 看门狗起不来不能拖垮主流程:只是失去一层保护,照常工作
87
+ }
88
+
89
+ # ==================== 加载动作库 ====================
90
+ # 置位后再 dot-source,让 wps-com.ps1 只定义函数、不执行动作
91
+ $env:WPS_COM_DAEMON = '1'
92
+ . (Join-Path $PSScriptRoot 'wps-com.ps1')
93
+
94
+ # 就绪握手:Node 侧据此确认守护进程起来了(而不是白等到超时)
95
+ Output-Json @{ success = $true; data = @{ ready = $true; pid = $PID; daemon = 'wps-comd'; parent = $parentPid } }
96
+
97
+ while ($true) {
98
+ $line = [Console]::In.ReadLine()
99
+ if ($null -eq $line) { break } # stdin 关闭 → 退出
100
+ $line = $line.Trim()
101
+ if (-not $line) { continue }
102
+
103
+ $id = $null
104
+ try {
105
+ $req = $line | ConvertFrom-Json
106
+ if ($req.id) { $id = [string]$req.id }
107
+ $script:WpsReqId = $id
108
+
109
+ $act = [string]$req.action
110
+ if (-not $act) { throw '请求缺少 action' }
111
+
112
+ # $req.params 为 $null 时给空表;动作内部统一按 $p.xxx 取值
113
+ $par = if ($null -ne $req.params) { $req.params } else { @{} }
114
+
115
+ Invoke-WpsAction -Action $act -p $par
116
+ } catch {
117
+ # 分发层异常兜底:绝不能把异常抛给宿主,否则整个守护进程会随之下线
118
+ $script:WpsReqId = $id
119
+ Output-Json @{ success = $false; error = "daemon: $($_.Exception.Message)" }
120
+ } finally {
121
+ $script:WpsReqId = $null
122
+ }
123
+ }
@@ -0,0 +1,111 @@
1
+ ---
2
+ name: wps-multitool
3
+ description: 通过 wps-multitool MCP 操作本机 WPS Office 的工具链,涵盖文字、表格、演示的读取、写入与排版。当用户要求读写 WPS 文档、做表格公式/图表/样式/修订/索引/交叉引用/页眉页脚,或做 PPT 版式/动画/母版/配色时使用。强制走「探活 → 定组 → 加载组 → 选型读反例 → 写前确认」五步,避免选错近名工具、写失败后盲目重放、文档被误改。仅限 Windows + WPS Office;通用 Office 问答、代码任务、以及非 WPS 的文档格式问题不要使用本技能。
4
+ license: MIT
5
+ compatibility: Windows + WPS Office 12.x;需要 wps-multitool MCP 的常驻桥进程在运行
6
+ metadata:
7
+ author: 赢容
8
+ version: "1.0.1"
9
+ ---
10
+
11
+ # 操作 WPS 的正确链路
12
+
13
+ MCP 提供了近 300 个工具(以 `tools/list` 与 `wps_search_tools` 为准),能力不缺;
14
+ 缺的是**按什么顺序用**。本技能只管顺序和判断,
15
+ 不重复工具清单(清单会过期,清单请走 `wps_search_tools`)。
16
+
17
+ ## 什么时候用 / 不用
18
+
19
+ **用**:用户要动 WPS 里的文字、表格、演示 —— 读内容、改格式、加公式、套样式、
20
+ 处理修订、插索引与交叉引用、调页眉页脚、做 PPT 版式与动画。
21
+
22
+ **不用**:
23
+ - 通用 Office 问答("Word 怎么插入页码"这种知识性问题,不需要碰 WPS)
24
+ - 代码任务、Excel 公式语法解释
25
+ - 非 WPS 的格式问题(pdf、md、docx 用别的工具)
26
+
27
+ ## 五步主链路
28
+
29
+ 按顺序走,不要跳步。跳步是本 MCP 最常见的失败原因。
30
+
31
+ ### 1. 探活
32
+
33
+ 先 `wps_common_status`。它会告诉你桥进程通不通、WPS 在不在、有没有活动文档。
34
+
35
+ 三态分别对应三种处理,不要混:
36
+
37
+ | 状态 | 下一步 |
38
+ |---|---|
39
+ | 桥不通 | `wps_common_repair`,修完再探一次 |
40
+ | WPS 没开 | 让用户先打开 WPS,或你用建文档类工具打开 |
41
+ | 没有活动文档 | 必须先建/开文档,否则后续全部失败 |
42
+
43
+ ### 2. 定组
44
+
45
+ `wps_route_intent` 把用户诉求映射到组:`word` / `excel` / `ppt` / `common`。
46
+ 它用的是关键词打分,组间语义差别大时准确;表述含糊时**别硬猜**——去第 4 步搜。
47
+
48
+ ### 3. 加载组
49
+
50
+ 默认只列出 40 个基础工具,其余组要显式加载:`wps_load_tool_group`。
51
+
52
+ **"工具不存在"通常不是没有这个能力,是组没加载。** 先搜再加载,别直接告诉用户做不到。
53
+
54
+ ### 4. 选型(必读反例)
55
+
56
+ `wps_search_tools` 可以直接用中文关键词("插入表格""批注""改背景")。
57
+
58
+ 返回结果里的 **`notFor` 必须读**。本 MCP 有一批近名工具,光看名字分不出来:
59
+
60
+ - 6 个 `background`(纯色 / 图片 / 渐变 / 母版 / 图表区 / 全局)
61
+ - 5 个 `animation`(普通动画 / 预设 / 强调 / 顺序 / 清除)
62
+ - 2 个目录(页目录 vs 文档目录)、2 个缩放
63
+
64
+ 选错不会报错,只会把事情改到别的地方去,用户还看不出来。
65
+
66
+ ### 5. 写前确认
67
+
68
+ 动文档之前做两件事:
69
+
70
+ 1. **锁定目标**:用户可能开着多个文档。用切换文档类工具把目标钉死,
71
+ 否则切一次窗口就写到别的文件里去了。
72
+ 2. **建快照**:COM 写入不是事务,没有撤销。MCP 侧没有回滚能力,
73
+ 唯一的保命办法是先让用户在 WPS 面板里存一份快照(另存副本已移除)。
74
+
75
+ ## 三条红线
76
+
77
+ ### 一、`勿重试` 的错误绝不原样重放
78
+
79
+ 工具失败时返回的前缀已经写明了能不能重试:
80
+
81
+ | 前缀 | 含义 | 该做什么 |
82
+ |---|---|---|
83
+ | `[可重试·…]` | 请求**没执行** | 可以重放,退避一下 |
84
+ | `[勿重试·可能已执行一半]` | 可能已经改了一半 | **先查状态**(读回来看结果),不要重放 |
85
+ | `[勿重试·先改参数]` | 参数不对 | 改参数,不是重试 |
86
+
87
+ 超时和 COM 错误都属第二类。盲目重放 = 同一段内容写两遍、样式叠三层。
88
+
89
+ ### 二、破坏性工具要跟用户确认
90
+
91
+ `tools/list` 里每个工具都带 `annotations`,其中 `destructiveHint: true` 的那批
92
+ 会删内容、丢未保存改动、或原地转换格式(删除类、另存为、格式转换、关闭文档)。
93
+ 执行前先说一句,别默默干。
94
+
95
+ `readOnlyHint: true` 的那批不会动文档 —— 但也意味着它**根本没生效**,
96
+ 如果结果不对,别重复调用同一条,先怀疑前置步骤(没加载组、文档没打开、路径不对)。
97
+
98
+ ### 三、PPT 的结果要复核
99
+
100
+ PPT 相关的工具没有真机覆盖验证过。改完之后如实告诉用户"这部分未在真机验证",
101
+ 别把"没报错"当成"做对了"。
102
+
103
+ ## 参考文档
104
+
105
+ 按需读,**不要一次全读**——它们加起来比本文还长。
106
+
107
+ | 文件 | 什么时候读 |
108
+ |---|---|
109
+ | `references/routing.md` | 意图定不准组、或两个工具不知道选哪个时 |
110
+ | `references/errors.md` | 调用报错、或要决定能不能重试时 |
111
+ | `references/recipes.md` | 任务跨多步(整篇论文排版、批量改格式、做演示)时 |
@@ -0,0 +1,62 @@
1
+ # 错误前缀与应对
2
+
3
+ 工具失败时返回的文本以一个方括号前缀开头。**先读前缀,再读正文** ——
4
+ 前缀决定了能不能重试,重放错了会写两遍。
5
+
6
+ ## 能重试的(请求根本没执行)
7
+
8
+ | 前缀 | 典型正文 | 怎么办 |
9
+ |---|---|---|
10
+ | `[busy\|可重试·稍后退避]` | WPS 正忙(COM 拒绝调用) | 等一下再发,不要连发 |
11
+ | `[bridge_unavailable\|可重试·需先拉起桥]` | 桥进程没起来 | 先 `wps_common_status`,必要时 `wps_common_repair` |
12
+ | `[daemon_unavailable\|可重试·需先拉起桥]` | 桥客户端已关闭 | 同上 |
13
+ | `[app_not_running\|可重试·需先启动WPS]` | WPS 没开 | 让用户打开 WPS |
14
+ | `[cancelled\|可重试·排队中被取消]` | 请求还在排队就被撤了 | 可以直接重发 |
15
+
16
+ 排队被取消的那类**一定是安全的**——请求从未写进 WPS。
17
+
18
+ ## 不能重试的(可能已经执行了一半)
19
+
20
+ | 前缀 | 典型正文 | 怎么办 |
21
+ |---|---|---|
22
+ | `[timeout\|勿重试·可能已执行一半]` | 超过调用时限 | **先读回来看结果**(用读取类工具确认),确认没生效再重做 |
23
+ | `[com_error\|勿重试·可能已执行一半]` | COM 调用失败 / `RPC_E_CALL_REJECTED` | 同上;连续出现说明 WPS 弹了模态框 |
24
+ | `[invalid_params\|勿重试·先改参数]` | 参数不对 | 改参数,不是重试 |
25
+ | `[document_not_found\|勿重试·先打开文档]` | 没有活动文档 | 先建/开文档 |
26
+ | `[unsupported_operation\|勿重试·本机不支持该接口]` | WPS 版本没这个能力 | 换条路,别重试 |
27
+ | `[unknown\|勿重试·…]` | 没归类成功 | 按前缀给的原因处理;没有就当"可能已执行" |
28
+
29
+ **判据很简单**:请求有没有送到 WPS。送不到的可以重放,送到的先查状态。
30
+
31
+ ## 三个反复出现的坑
32
+
33
+ ### "没有活动文档",但用户明明开着文件
34
+
35
+ WPS 里存在"空壳文档":`Documents.Add()` 立刻返回,但文档还没真正建好,
36
+ 此时取它会报没有活动文档。遇到这个:
37
+
38
+ 1. 先 `wps_common_status` 看文档数是不是 0
39
+ 2. 是 0 就新建;不是 0 却取不到,说明是空壳 → `wps_common_repair`
40
+
41
+ ### 一串 `RPC_E_CALL_REJECTED`
42
+
43
+ 这是 WPS 弹了对话框(有模态框在等)。COM 是单线程的,对话框不关,
44
+ 后面所有调用都会被拒。
45
+
46
+ 处理:告诉用户"请检查 WPS 窗口有没有对话框没关",然后按 `[busy]` 的方式退避重试。
47
+
48
+ ### 一直报桥不通,但 WPS 是开着的
49
+
50
+ 桥和 WPS 是两回事。桥不通不代表 WPS 坏了。顺序:
51
+
52
+ 1. `wps_common_status` — 看桥状态与端口
53
+ 2. 桥起不来 → `wps_common_repair`
54
+ 3. 端口被占 → 换 `WPS_BRIDGE_HTTP_PORT` 再试
55
+
56
+ ## 取消
57
+
58
+ 客户端发取消通知时:
59
+ - 请求还在**排队** → 直接撤,安全,可以重发
60
+ - 已经**在途**(写进 WPS 了)→ 只读动作允许"不等了",写入动作**拒绝取消**
61
+
62
+ 也就是说:写入类操作发取消是无效的,别指望它能打断。
@@ -0,0 +1,82 @@
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
+ 这是最危险的一类任务:范围大、影响面广、没有撤销。
82
+ 中途失败时,已改的部分留在那里,只能靠快照恢复。
@@ -0,0 +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 它不干什么、该用谁 ← 必读
88
+ ```