wps-multitool-mcp 0.0.0-stage → 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 (300) 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 +383 -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/cli/install.d.ts +58 -0
  15. package/dist/cli/install.d.ts.map +1 -0
  16. package/dist/cli/install.js +301 -0
  17. package/dist/cli/install.js.map +1 -0
  18. package/dist/client/action-routes.d.ts +32 -0
  19. package/dist/client/action-routes.d.ts.map +1 -0
  20. package/dist/client/action-routes.generated.d.ts +10 -0
  21. package/dist/client/action-routes.generated.d.ts.map +1 -0
  22. package/dist/client/action-routes.generated.js +327 -0
  23. package/dist/client/action-routes.generated.js.map +1 -0
  24. package/dist/client/action-routes.js +57 -0
  25. package/dist/client/action-routes.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 +69 -0
  31. package/dist/client/wps-client.d.ts.map +1 -0
  32. package/dist/client/wps-client.js +442 -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 +173 -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/auto-snapshot.d.ts +58 -0
  43. package/dist/server/auto-snapshot.d.ts.map +1 -0
  44. package/dist/server/auto-snapshot.js +150 -0
  45. package/dist/server/auto-snapshot.js.map +1 -0
  46. package/dist/server/cancel-context.d.ts +30 -0
  47. package/dist/server/cancel-context.d.ts.map +1 -0
  48. package/dist/server/cancel-context.js +38 -0
  49. package/dist/server/cancel-context.js.map +1 -0
  50. package/dist/server/mcp-server.d.ts +74 -0
  51. package/dist/server/mcp-server.d.ts.map +1 -0
  52. package/dist/server/mcp-server.js +592 -0
  53. package/dist/server/mcp-server.js.map +1 -0
  54. package/dist/server/server-info.d.ts +21 -0
  55. package/dist/server/server-info.d.ts.map +1 -0
  56. package/dist/server/server-info.js +56 -0
  57. package/dist/server/server-info.js.map +1 -0
  58. package/dist/server/tool-aliases.generated.d.ts +41 -0
  59. package/dist/server/tool-aliases.generated.d.ts.map +1 -0
  60. package/dist/server/tool-aliases.generated.js +88 -0
  61. package/dist/server/tool-aliases.generated.js.map +1 -0
  62. package/dist/server/tool-annotations.d.ts +55 -0
  63. package/dist/server/tool-annotations.d.ts.map +1 -0
  64. package/dist/server/tool-annotations.generated.d.ts +14 -0
  65. package/dist/server/tool-annotations.generated.d.ts.map +1 -0
  66. package/dist/server/tool-annotations.generated.js +302 -0
  67. package/dist/server/tool-annotations.generated.js.map +1 -0
  68. package/dist/server/tool-annotations.js +192 -0
  69. package/dist/server/tool-annotations.js.map +1 -0
  70. package/dist/server/tool-group-events.d.ts +23 -0
  71. package/dist/server/tool-group-events.d.ts.map +1 -0
  72. package/dist/server/tool-group-events.js +44 -0
  73. package/dist/server/tool-group-events.js.map +1 -0
  74. package/dist/server/tool-metadata.d.ts +68 -0
  75. package/dist/server/tool-metadata.d.ts.map +1 -0
  76. package/dist/server/tool-metadata.js +834 -0
  77. package/dist/server/tool-metadata.js.map +1 -0
  78. package/dist/server/tool-registry.d.ts +186 -0
  79. package/dist/server/tool-registry.d.ts.map +1 -0
  80. package/dist/server/tool-registry.js +615 -0
  81. package/dist/server/tool-registry.js.map +1 -0
  82. package/dist/server/tool-tiers.d.ts +58 -0
  83. package/dist/server/tool-tiers.d.ts.map +1 -0
  84. package/dist/server/tool-tiers.js +128 -0
  85. package/dist/server/tool-tiers.js.map +1 -0
  86. package/dist/server/tool-verification.d.ts +35 -0
  87. package/dist/server/tool-verification.d.ts.map +1 -0
  88. package/dist/server/tool-verification.generated.d.ts +17 -0
  89. package/dist/server/tool-verification.generated.d.ts.map +1 -0
  90. package/dist/server/tool-verification.generated.js +293 -0
  91. package/dist/server/tool-verification.generated.js.map +1 -0
  92. package/dist/server/tool-verification.js +43 -0
  93. package/dist/server/tool-verification.js.map +1 -0
  94. package/dist/tools/common/batch.d.ts +33 -0
  95. package/dist/tools/common/batch.d.ts.map +1 -0
  96. package/dist/tools/common/batch.js +273 -0
  97. package/dist/tools/common/batch.js.map +1 -0
  98. package/dist/tools/common/convert.d.ts +41 -0
  99. package/dist/tools/common/convert.d.ts.map +1 -0
  100. package/dist/tools/common/convert.js +299 -0
  101. package/dist/tools/common/convert.js.map +1 -0
  102. package/dist/tools/common/general.d.ts +36 -0
  103. package/dist/tools/common/general.d.ts.map +1 -0
  104. package/dist/tools/common/general.js +582 -0
  105. package/dist/tools/common/general.js.map +1 -0
  106. package/dist/tools/common/index.d.ts +38 -0
  107. package/dist/tools/common/index.d.ts.map +1 -0
  108. package/dist/tools/common/index.js +116 -0
  109. package/dist/tools/common/index.js.map +1 -0
  110. package/dist/tools/common/intent.d.ts +48 -0
  111. package/dist/tools/common/intent.d.ts.map +1 -0
  112. package/dist/tools/common/intent.js +221 -0
  113. package/dist/tools/common/intent.js.map +1 -0
  114. package/dist/tools/common/repair.d.ts +29 -0
  115. package/dist/tools/common/repair.d.ts.map +1 -0
  116. package/dist/tools/common/repair.js +140 -0
  117. package/dist/tools/common/repair.js.map +1 -0
  118. package/dist/tools/common/snapshot.d.ts +77 -0
  119. package/dist/tools/common/snapshot.d.ts.map +1 -0
  120. package/dist/tools/common/snapshot.js +497 -0
  121. package/dist/tools/common/snapshot.js.map +1 -0
  122. package/dist/tools/common/status.d.ts +27 -0
  123. package/dist/tools/common/status.d.ts.map +1 -0
  124. package/dist/tools/common/status.js +139 -0
  125. package/dist/tools/common/status.js.map +1 -0
  126. package/dist/tools/common/toolgroups.d.ts +38 -0
  127. package/dist/tools/common/toolgroups.d.ts.map +1 -0
  128. package/dist/tools/common/toolgroups.js +254 -0
  129. package/dist/tools/common/toolgroups.js.map +1 -0
  130. package/dist/tools/excel/chart.d.ts +86 -0
  131. package/dist/tools/excel/chart.d.ts.map +1 -0
  132. package/dist/tools/excel/chart.js +659 -0
  133. package/dist/tools/excel/chart.js.map +1 -0
  134. package/dist/tools/excel/comment-protect.d.ts +58 -0
  135. package/dist/tools/excel/comment-protect.d.ts.map +1 -0
  136. package/dist/tools/excel/comment-protect.js +274 -0
  137. package/dist/tools/excel/comment-protect.js.map +1 -0
  138. package/dist/tools/excel/data-advanced.d.ts +47 -0
  139. package/dist/tools/excel/data-advanced.d.ts.map +1 -0
  140. package/dist/tools/excel/data-advanced.js +263 -0
  141. package/dist/tools/excel/data-advanced.js.map +1 -0
  142. package/dist/tools/excel/data.d.ts +86 -0
  143. package/dist/tools/excel/data.d.ts.map +1 -0
  144. package/dist/tools/excel/data.js +606 -0
  145. package/dist/tools/excel/data.js.map +1 -0
  146. package/dist/tools/excel/format.d.ts +42 -0
  147. package/dist/tools/excel/format.d.ts.map +1 -0
  148. package/dist/tools/excel/format.js +717 -0
  149. package/dist/tools/excel/format.js.map +1 -0
  150. package/dist/tools/excel/formula.d.ts +55 -0
  151. package/dist/tools/excel/formula.d.ts.map +1 -0
  152. package/dist/tools/excel/formula.js +316 -0
  153. package/dist/tools/excel/formula.js.map +1 -0
  154. package/dist/tools/excel/index.d.ts +44 -0
  155. package/dist/tools/excel/index.d.ts.map +1 -0
  156. package/dist/tools/excel/index.js +241 -0
  157. package/dist/tools/excel/index.js.map +1 -0
  158. package/dist/tools/excel/pivot.d.ts +39 -0
  159. package/dist/tools/excel/pivot.d.ts.map +1 -0
  160. package/dist/tools/excel/pivot.js +455 -0
  161. package/dist/tools/excel/pivot.js.map +1 -0
  162. package/dist/tools/excel/row-column.d.ts +64 -0
  163. package/dist/tools/excel/row-column.d.ts.map +1 -0
  164. package/dist/tools/excel/row-column.js +299 -0
  165. package/dist/tools/excel/row-column.js.map +1 -0
  166. package/dist/tools/excel/sheet-gaps.d.ts +50 -0
  167. package/dist/tools/excel/sheet-gaps.d.ts.map +1 -0
  168. package/dist/tools/excel/sheet-gaps.js +373 -0
  169. package/dist/tools/excel/sheet-gaps.js.map +1 -0
  170. package/dist/tools/excel/sheet.d.ts +102 -0
  171. package/dist/tools/excel/sheet.d.ts.map +1 -0
  172. package/dist/tools/excel/sheet.js +827 -0
  173. package/dist/tools/excel/sheet.js.map +1 -0
  174. package/dist/tools/excel/workbook.d.ts +62 -0
  175. package/dist/tools/excel/workbook.d.ts.map +1 -0
  176. package/dist/tools/excel/workbook.js +371 -0
  177. package/dist/tools/excel/workbook.js.map +1 -0
  178. package/dist/tools/index.d.ts +48 -0
  179. package/dist/tools/index.d.ts.map +1 -0
  180. package/dist/tools/index.js +113 -0
  181. package/dist/tools/index.js.map +1 -0
  182. package/dist/tools/ppt/animation.d.ts +36 -0
  183. package/dist/tools/ppt/animation.d.ts.map +1 -0
  184. package/dist/tools/ppt/animation.js +190 -0
  185. package/dist/tools/ppt/animation.js.map +1 -0
  186. package/dist/tools/ppt/background.d.ts +54 -0
  187. package/dist/tools/ppt/background.d.ts.map +1 -0
  188. package/dist/tools/ppt/background.js +389 -0
  189. package/dist/tools/ppt/background.js.map +1 -0
  190. package/dist/tools/ppt/beautify-advanced.d.ts +66 -0
  191. package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -0
  192. package/dist/tools/ppt/beautify-advanced.js +600 -0
  193. package/dist/tools/ppt/beautify-advanced.js.map +1 -0
  194. package/dist/tools/ppt/chart-flow.d.ts +58 -0
  195. package/dist/tools/ppt/chart-flow.d.ts.map +1 -0
  196. package/dist/tools/ppt/chart-flow.js +523 -0
  197. package/dist/tools/ppt/chart-flow.js.map +1 -0
  198. package/dist/tools/ppt/data-viz.d.ts +64 -0
  199. package/dist/tools/ppt/data-viz.d.ts.map +1 -0
  200. package/dist/tools/ppt/data-viz.js +514 -0
  201. package/dist/tools/ppt/data-viz.js.map +1 -0
  202. package/dist/tools/ppt/image.d.ts +30 -0
  203. package/dist/tools/ppt/image.d.ts.map +1 -0
  204. package/dist/tools/ppt/image.js +447 -0
  205. package/dist/tools/ppt/image.js.map +1 -0
  206. package/dist/tools/ppt/index.d.ts +72 -0
  207. package/dist/tools/ppt/index.d.ts.map +1 -0
  208. package/dist/tools/ppt/index.js +320 -0
  209. package/dist/tools/ppt/index.js.map +1 -0
  210. package/dist/tools/ppt/misc.d.ts +93 -0
  211. package/dist/tools/ppt/misc.d.ts.map +1 -0
  212. package/dist/tools/ppt/misc.js +817 -0
  213. package/dist/tools/ppt/misc.js.map +1 -0
  214. package/dist/tools/ppt/presentation.d.ts +72 -0
  215. package/dist/tools/ppt/presentation.d.ts.map +1 -0
  216. package/dist/tools/ppt/presentation.js +694 -0
  217. package/dist/tools/ppt/presentation.js.map +1 -0
  218. package/dist/tools/ppt/shape-basic.d.ts +46 -0
  219. package/dist/tools/ppt/shape-basic.d.ts.map +1 -0
  220. package/dist/tools/ppt/shape-basic.js +756 -0
  221. package/dist/tools/ppt/shape-basic.js.map +1 -0
  222. package/dist/tools/ppt/slide-ops.d.ts +73 -0
  223. package/dist/tools/ppt/slide-ops.d.ts.map +1 -0
  224. package/dist/tools/ppt/slide-ops.js +1740 -0
  225. package/dist/tools/ppt/slide-ops.js.map +1 -0
  226. package/dist/tools/ppt/slide.d.ts +51 -0
  227. package/dist/tools/ppt/slide.d.ts.map +1 -0
  228. package/dist/tools/ppt/slide.js +484 -0
  229. package/dist/tools/ppt/slide.js.map +1 -0
  230. package/dist/tools/ppt/table.d.ts +58 -0
  231. package/dist/tools/ppt/table.d.ts.map +1 -0
  232. package/dist/tools/ppt/table.js +514 -0
  233. package/dist/tools/ppt/table.js.map +1 -0
  234. package/dist/tools/ppt/textbox.d.ts +47 -0
  235. package/dist/tools/ppt/textbox.d.ts.map +1 -0
  236. package/dist/tools/ppt/textbox.js +249 -0
  237. package/dist/tools/ppt/textbox.js.map +1 -0
  238. package/dist/tools/word/academic.d.ts +50 -0
  239. package/dist/tools/word/academic.d.ts.map +1 -0
  240. package/dist/tools/word/academic.js +500 -0
  241. package/dist/tools/word/academic.js.map +1 -0
  242. package/dist/tools/word/content.d.ts +97 -0
  243. package/dist/tools/word/content.d.ts.map +1 -0
  244. package/dist/tools/word/content.js +843 -0
  245. package/dist/tools/word/content.js.map +1 -0
  246. package/dist/tools/word/document.d.ts +65 -0
  247. package/dist/tools/word/document.d.ts.map +1 -0
  248. package/dist/tools/word/document.js +576 -0
  249. package/dist/tools/word/document.js.map +1 -0
  250. package/dist/tools/word/format.d.ts +50 -0
  251. package/dist/tools/word/format.d.ts.map +1 -0
  252. package/dist/tools/word/format.js +462 -0
  253. package/dist/tools/word/format.js.map +1 -0
  254. package/dist/tools/word/gaps.d.ts +58 -0
  255. package/dist/tools/word/gaps.d.ts.map +1 -0
  256. package/dist/tools/word/gaps.js +431 -0
  257. package/dist/tools/word/gaps.js.map +1 -0
  258. package/dist/tools/word/index.d.ts +34 -0
  259. package/dist/tools/word/index.d.ts.map +1 -0
  260. package/dist/tools/word/index.js +122 -0
  261. package/dist/tools/word/index.js.map +1 -0
  262. package/dist/tools/word/professional.d.ts +48 -0
  263. package/dist/tools/word/professional.d.ts.map +1 -0
  264. package/dist/tools/word/professional.js +657 -0
  265. package/dist/tools/word/professional.js.map +1 -0
  266. package/dist/tools/word/proofread.d.ts +25 -0
  267. package/dist/tools/word/proofread.d.ts.map +1 -0
  268. package/dist/tools/word/proofread.js +718 -0
  269. package/dist/tools/word/proofread.js.map +1 -0
  270. package/dist/types/index.d.ts +9 -0
  271. package/dist/types/index.d.ts.map +1 -0
  272. package/dist/types/index.js +25 -0
  273. package/dist/types/index.js.map +1 -0
  274. package/dist/types/tools.d.ts +174 -0
  275. package/dist/types/tools.d.ts.map +1 -0
  276. package/dist/types/tools.js +45 -0
  277. package/dist/types/tools.js.map +1 -0
  278. package/dist/types/wps.d.ts +190 -0
  279. package/dist/types/wps.d.ts.map +1 -0
  280. package/dist/types/wps.js +23 -0
  281. package/dist/types/wps.js.map +1 -0
  282. package/dist/utils/error.d.ts +147 -0
  283. package/dist/utils/error.d.ts.map +1 -0
  284. package/dist/utils/error.js +417 -0
  285. package/dist/utils/error.js.map +1 -0
  286. package/dist/utils/logger.d.ts +56 -0
  287. package/dist/utils/logger.d.ts.map +1 -0
  288. package/dist/utils/logger.js +155 -0
  289. package/dist/utils/logger.js.map +1 -0
  290. package/dist/version.d.ts +22 -0
  291. package/dist/version.d.ts.map +1 -0
  292. package/dist/version.js +101 -0
  293. package/dist/version.js.map +1 -0
  294. package/package.json +66 -6
  295. package/scripts/wps-com.ps1 +8255 -0
  296. package/scripts/wps-comd.ps1 +123 -0
  297. package/skills/wps-multitool/SKILL.md +129 -0
  298. package/skills/wps-multitool/references/errors.md +62 -0
  299. package/skills/wps-multitool/references/recipes.md +83 -0
  300. package/skills/wps-multitool/references/routing.md +88 -0
@@ -0,0 +1,192 @@
1
+ "use strict";
2
+ /**
3
+ * Input: MCP 工具名
4
+ * Output: MCP 标准工具注解(readOnlyHint / destructiveHint / idempotentHint / openWorldHint)
5
+ * Pos: 让客户端【从 tools/list 直接读到】每个工具的读写属性,而不是让模型靠描述去猜。
6
+ * 一旦我被修改,请更新我的头部注释,以及所属目录的md。
7
+ *
8
+ * 为什么必须是注解,不能靠文档教
9
+ * ------------------------------
10
+ * 实测:几百个工具里,靠名字能一眼确认只读的只有一小部分(见 cancellable.ts 的判定逻辑),
11
+ * 其余是写入或判不出。指望模型读描述去判断"这个能不能动我的文档",
12
+ * 就是让它在大量模糊项里赌。注解是机器可读的,客户端可以据此决定要不要弹确认、
13
+ * 要不要允许自动执行 —— 这比在 skill 里写一句"注意只读"可靠得多。
14
+ *
15
+ * 数据来源
16
+ * --------
17
+ * 动作名映射由 scripts/manual/gen-tool-annotations.js 运行时观测生成:
18
+ * 把 wpsClient 的出口换成假实现,逐个跑 handler 记下它发出的动作名。
19
+ * 注解本身在这里【运行时算】,不写死进生成文件 —— 判定规则改了不必重新生成。
20
+ */
21
+ Object.defineProperty(exports, "__esModule", { value: true });
22
+ exports.getToolAnnotations = getToolAnnotations;
23
+ exports.annotationCoverage = annotationCoverage;
24
+ exports.annotationSummary = annotationSummary;
25
+ const cancellable_1 = require("../bridge/cancellable");
26
+ const tool_annotations_generated_1 = require("./tool-annotations.generated");
27
+ const tool_aliases_generated_1 = require("./tool-aliases.generated");
28
+ const cache = new Map();
29
+ /**
30
+ * 自动生成覆盖不到的工具 —— 手写在这里,并说明为什么。
31
+ *
32
+ * 有两类,覆盖不到的原因完全不同:
33
+ *
34
+ * 【一】动作名是运行期参数,静态推不出来。
35
+ * wps_execute_method 在 mcp-server.ts 里直接 this.registry.register(),
36
+ * 不走 allTools,所以 gen 脚本观测不到它;它的动作名还是调用时传进来的字符串。
37
+ * 它能执行【任意】WPS 动作(删东西、关文档、原地转格式),破坏性按 true 给。
38
+ *
39
+ * 【二】它本身不是"一个动作",而是"编排别人的容器"。
40
+ * wps_common_batch 是批量执行器:它的 handler 不直接调 executeAction,
41
+ * 而是转手调注册表里的其它工具,所以观测不到任何动作名,
42
+ * 落到"按工具名推断"会推出 'batch' 这种毫无意义的名字 → 判成非破坏性、幂等。
43
+ * 但它能装下任意写入型工具(含删除、另存为、关闭),这三项都必须按最坏情况给:
44
+ * 非只读、破坏性、非幂等。名字推断在这里不是"保守",是"猜错了"。
45
+ */
46
+ const EXTRA_ANNOTATIONS = {
47
+ wps_execute_method: {
48
+ readOnlyHint: false,
49
+ destructiveHint: true,
50
+ idempotentHint: false,
51
+ openWorldHint: false,
52
+ },
53
+ wps_common_batch: {
54
+ readOnlyHint: false,
55
+ destructiveHint: true,
56
+ idempotentHint: false,
57
+ openWorldHint: false,
58
+ },
59
+ /**
60
+ * 【三】观测到的动作名骗人:它只发了 getActiveDocumentState(只读),
61
+ * 真正的副作用是 Node 侧写文件(建快照 / 覆盖原文件)。按动作名推断会得出
62
+ * "只读"或"非破坏性",而客户端可能拿它决定要不要弹确认 —— 这里必须手写。
63
+ */
64
+ wps_common_snapshot_create: {
65
+ readOnlyHint: false,
66
+ destructiveHint: false,
67
+ idempotentHint: false,
68
+ openWorldHint: false,
69
+ },
70
+ wps_common_snapshot_restore: {
71
+ // 默认写副本、不覆盖;但 overwrite=true 时会原地盖掉原文件 —— 按最坏情况给
72
+ readOnlyHint: false,
73
+ destructiveHint: true,
74
+ idempotentHint: false,
75
+ openWorldHint: false,
76
+ },
77
+ // list 压根不发动作(只读 oplog),名字推断会推成 snapshotList → 判成非只读,必须手写
78
+ wps_common_snapshot_list: {
79
+ readOnlyHint: true,
80
+ destructiveHint: false,
81
+ idempotentHint: true,
82
+ openWorldHint: false,
83
+ },
84
+ /**
85
+ * 【四】动作名带点,观测器按"合法标识符"判定把它归成 unresolved,推不出来。
86
+ * wps_ppt_unify_font 调的是 slide.unifyFont(带点的动作名),注解生成器的
87
+ * /^[A-Za-z_][A-Za-z0-9_]*$/ 不收它 → 只能手写。
88
+ * 值是人工判定的:它把一页/整份文稿里所有文本框的字体名改掉 —— 写入、原地改格式,
89
+ * 但不改内容、不删东西(非破坏),重复执行结果一致(幂等),只碰本机(openWorld=false)。
90
+ */
91
+ wps_ppt_unify_font: {
92
+ readOnlyHint: false,
93
+ destructiveHint: false,
94
+ idempotentHint: true,
95
+ openWorldHint: false,
96
+ },
97
+ /**
98
+ * 【五】压根不发 COM 动作的工具(10 个)—— 副作用不在 WPS 里。
99
+ * cache 系列写在 Node 侧内存;工具组三个改的是本进程的注册表;
100
+ * wps_search_tools / wps_route_intent 只做字符串匹配;
101
+ * wps_word_proofread_basic 是纯本地正则(描述里就写着"无需 API 调用")。
102
+ * 按工具名推断会推出 cacheData / searchTools / proofreadBasic 这类名字,
103
+ * 而它们在 wps-com.ps1 里一个 case 都没有 —— 那不是"保守",是拿假输入做安全判定。
104
+ */
105
+ wps_cache_data: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
106
+ wps_get_cached_data: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
107
+ wps_list_cache: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
108
+ // 清的是自己建的缓存,但按"会丢数据"给 destructive —— 客户端该弹确认
109
+ wps_clear_cache: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
110
+ wps_word_proofread_basic: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
111
+ wps_list_tool_groups: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
112
+ wps_load_tool_group: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
113
+ wps_unload_tool_group: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
114
+ wps_search_tools: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
115
+ wps_route_intent: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
116
+ /**
117
+ * 【六】动作名【查不到】但工具确实要改文档(2 个)+ 1 个改的是服务器状态。
118
+ *
119
+ * wps_word_set_text_color / wps_word_set_line_spacing 调的是 'setTextColor' /
120
+ * 'setLineSpacing',而 wps-com.ps1 里根本没有这两个 case(实测:全文零命中)。
121
+ * 动作缺失是【另一条 bug】,已单列待修;但注解不能因为它就空着 ——
122
+ * 这两件事都是改用户文档的工具,AI 必须知道它们不是只读的。
123
+ *
124
+ * wps_ppt_set_active_target 会锁定后续所有 PPT 操作的目标文稿:它不改文档,
125
+ * 但决定了后面每一次写入落在哪份文件上。判成只读会让客户端跳过确认。
126
+ */
127
+ wps_word_set_text_color: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
128
+ wps_word_set_line_spacing: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
129
+ wps_ppt_set_active_target: { readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false },
130
+ };
131
+ /**
132
+ * 算一个工具的注解。
133
+ * 拿不到动作名(工具没在映射表里、也不在 EXTRA 里)就返回 undefined ——
134
+ * 宁可没有注解,也不要给一个猜出来的错注解(客户端可能拿它做安全决策)。
135
+ *
136
+ * 旧名(别名)先解析成规范名:注解挂在规范名上,旧名必须拿到同一份 ——
137
+ * 否则会出现"旧名没有破坏性提示"这种安全缺口,而客户端正是拿这个决定要不要弹确认。
138
+ */
139
+ function getToolAnnotations(toolName) {
140
+ const name = (0, tool_aliases_generated_1.resolveToolAlias)(toolName);
141
+ if (cache.has(name))
142
+ return cache.get(name);
143
+ const extra = EXTRA_ANNOTATIONS[name];
144
+ if (extra) {
145
+ cache.set(name, extra);
146
+ return extra;
147
+ }
148
+ const actions = tool_annotations_generated_1.TOOL_ACTIONS[name];
149
+ if (!actions || !actions.length) {
150
+ cache.set(name, undefined);
151
+ return undefined;
152
+ }
153
+ // 一个工具可能发多条命令,只要有一条会写,它就不能算只读
154
+ const readOnly = actions.every(cancellable_1.isReadOnlyAction);
155
+ const destructive = actions.some(cancellable_1.isDestructiveAction);
156
+ const ann = {
157
+ readOnlyHint: readOnly,
158
+ // 只读的按定义不破坏;写入里只有删/丢数据/原地转换那批算破坏
159
+ destructiveHint: readOnly ? false : destructive,
160
+ idempotentHint: actions.every(cancellable_1.isIdempotentAction),
161
+ // 本 MCP 的全部副作用都在本机 WPS,不访问外部系统
162
+ openWorldHint: false,
163
+ };
164
+ cache.set(name, ann);
165
+ return ann;
166
+ }
167
+ /** 注解覆盖了多少工具(诊断用) */
168
+ function annotationCoverage(toolNames) {
169
+ const annotated = toolNames.filter((n) => getToolAnnotations(n) !== undefined).length;
170
+ return { total: toolNames.length, annotated };
171
+ }
172
+ /** 汇总分布(诊断/文档用,数字必须实测别手写) */
173
+ function annotationSummary(toolNames) {
174
+ let readOnly = 0;
175
+ let destructive = 0;
176
+ let nonIdempotent = 0;
177
+ let annotated = 0;
178
+ for (const n of toolNames) {
179
+ const a = getToolAnnotations(n);
180
+ if (!a)
181
+ continue;
182
+ annotated++;
183
+ if (a.readOnlyHint)
184
+ readOnly++;
185
+ if (a.destructiveHint)
186
+ destructive++;
187
+ if (a.idempotentHint === false)
188
+ nonIdempotent++;
189
+ }
190
+ return { total: toolNames.length, annotated, readOnly, destructive, nonIdempotent };
191
+ }
192
+ //# sourceMappingURL=tool-annotations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-annotations.js","sourceRoot":"","sources":["../../src/server/tool-annotations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ /**
2
+ * Input: 无
3
+ * Output: "工具组已变化"的订阅/触发
4
+ * Pos: 工具组变更事件(避免工具模块与注册表互相依赖)。一旦我被修改,请更新我的头部注释,以及所属目录的md。
5
+ *
6
+ * 为什么要单独一个模块
7
+ * --------------------
8
+ * 事件必须在【注册表】里触发(loadGroup/unloadGroup 才是唯一真相),
9
+ * 而订阅方是 mcp-server(要发 notifications/tools/list_changed)。
10
+ * 如果事件表写在 tools/common/toolgroups.ts 里,就会变成
11
+ * tool-registry → toolgroups → tool-registry 的循环依赖。
12
+ * 所以抽成这个零依赖的小模块,两边都只依赖它。
13
+ */
14
+ export type ToolGroupsChangedListener = () => void;
15
+ /** 订阅"工具组变了"。mcp-server 用它来发 notifications/tools/list_changed */
16
+ export declare function onToolGroupsChanged(fn: ToolGroupsChangedListener): void;
17
+ /** 取消订阅(测试用) */
18
+ export declare function offToolGroupsChanged(fn: ToolGroupsChangedListener): void;
19
+ /** 触发"工具组变了"。由 ToolRegistry.loadGroup/unloadGroup 在真的发生变化后调用 */
20
+ export declare function emitToolGroupsChanged(): void;
21
+ /** 当前订阅者数量(诊断用) */
22
+ export declare function listenerCount(): number;
23
+ //# sourceMappingURL=tool-group-events.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-group-events.d.ts","sourceRoot":"","sources":["../../src/server/tool-group-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,yBAAyB,GAAG,MAAM,IAAI,CAAC;AAInD,iEAAiE;AACjE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,yBAAyB,GAAG,IAAI,CAEvE;AAED,gBAAgB;AAChB,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,yBAAyB,GAAG,IAAI,CAExE;AAED,gEAAgE;AAChE,wBAAgB,qBAAqB,IAAI,IAAI,CAQ5C;AAED,mBAAmB;AACnB,wBAAgB,aAAa,IAAI,MAAM,CAEtC"}
@@ -0,0 +1,44 @@
1
+ "use strict";
2
+ /**
3
+ * Input: 无
4
+ * Output: "工具组已变化"的订阅/触发
5
+ * Pos: 工具组变更事件(避免工具模块与注册表互相依赖)。一旦我被修改,请更新我的头部注释,以及所属目录的md。
6
+ *
7
+ * 为什么要单独一个模块
8
+ * --------------------
9
+ * 事件必须在【注册表】里触发(loadGroup/unloadGroup 才是唯一真相),
10
+ * 而订阅方是 mcp-server(要发 notifications/tools/list_changed)。
11
+ * 如果事件表写在 tools/common/toolgroups.ts 里,就会变成
12
+ * tool-registry → toolgroups → tool-registry 的循环依赖。
13
+ * 所以抽成这个零依赖的小模块,两边都只依赖它。
14
+ */
15
+ Object.defineProperty(exports, "__esModule", { value: true });
16
+ exports.onToolGroupsChanged = onToolGroupsChanged;
17
+ exports.offToolGroupsChanged = offToolGroupsChanged;
18
+ exports.emitToolGroupsChanged = emitToolGroupsChanged;
19
+ exports.listenerCount = listenerCount;
20
+ const listeners = new Set();
21
+ /** 订阅"工具组变了"。mcp-server 用它来发 notifications/tools/list_changed */
22
+ function onToolGroupsChanged(fn) {
23
+ listeners.add(fn);
24
+ }
25
+ /** 取消订阅(测试用) */
26
+ function offToolGroupsChanged(fn) {
27
+ listeners.delete(fn);
28
+ }
29
+ /** 触发"工具组变了"。由 ToolRegistry.loadGroup/unloadGroup 在真的发生变化后调用 */
30
+ function emitToolGroupsChanged() {
31
+ for (const fn of listeners) {
32
+ try {
33
+ fn();
34
+ }
35
+ catch {
36
+ /* 订阅方出错不该影响工具本身的结果 */
37
+ }
38
+ }
39
+ }
40
+ /** 当前订阅者数量(诊断用) */
41
+ function listenerCount() {
42
+ return listeners.size;
43
+ }
44
+ //# sourceMappingURL=tool-group-events.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-group-events.js","sourceRoot":"","sources":["../../src/server/tool-group-events.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAOH,kDAEC;AAGD,oDAEC;AAGD,sDAQC;AAGD,sCAEC;AA1BD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEvD,iEAAiE;AACjE,SAAgB,mBAAmB,CAAC,EAA6B;IAC/D,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACpB,CAAC;AAED,gBAAgB;AAChB,SAAgB,oBAAoB,CAAC,EAA6B;IAChE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED,gEAAgE;AAChE,SAAgB,qBAAqB;IACnC,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,EAAE,EAAE,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAED,mBAAmB;AACnB,SAAgB,aAAa;IAC3B,OAAO,SAAS,CAAC,IAAI,CAAC;AACxB,CAAC"}
@@ -0,0 +1,68 @@
1
+ /**
2
+ * Input: 工具定义(名字 / 描述)
3
+ * Output: 该工具的中文别名、正例、反例(给 wps_search_tools 用)
4
+ * Pos: 工具检索元数据。一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
5
+ *
6
+ * 为什么要有这一层
7
+ * ----------------
8
+ * 先说清楚它【不是】在补什么:工具描述本身就是中文,所以中文关键词原本就能搜到
9
+ * (实测 66 个常见中文关键词,去掉别名后仍有绝大多数命中)。别名不是救命稻草。
10
+ *
11
+ * 真正的问题在别处——【近名工具分不出来】。本仓有 6 个 background、5 个 animation、
12
+ * 4 个 transition、3 个 image 插入、2 个 toc、2 个 zoom,名字和描述高度重合,
13
+ * 模型搜出来一堆同名候选只能乱猜。所以这一层主要补两样:
14
+ * 1) 反例 notFor:显式写"这个不干 X,要干 X 用 Y" —— 这是主力价值
15
+ * 2) 别名:按英文词根表自动拼中文说法(285 个工具全覆盖,不用逐个手写),
16
+ * 实测能给 66 个关键词里的 17 个多捞到命中(共 +34 对),是锦上添花
17
+ *
18
+ * 打分为什么别名最低
19
+ * ------------------
20
+ * 别名是机器按词根拼的,会串味(搜"域"会命中"区域",搜"组合"会命中 load_tool_group)。
21
+ * 所以 searchTools 里 name(100) > description(40) > alias(25),别让派生词压过人写的描述。
22
+ *
23
+ * 查询侧扩展(第 9 轮补的,也是本文件最容易被忽略的一半)
24
+ * -------------------------------------------------------
25
+ * 上面这张词表一直是【单向】的:英文词根 → 中文。它只用来拼别名,**从不参与查询**,
26
+ * 于是搜"排版""格式设置"这类用户最常用的说法一个都搜不到 —— 工具名是英文、描述里
27
+ * 也不一定有"排版"两个字。词表明明在,却没接到查询上,这是最大的浪费。
28
+ * 现在补了两条通路(expandQuery):
29
+ * 中文说法 → 反查英文词根("背景色"→background/color)
30
+ * 英文词根 → 正查中文说法("layout"→版式/布局)
31
+ * 扩展命中在 searchTools 里单列一档 matchedBy='synonym',分比 alias 还低(20/18/12),
32
+ * 且只在原词【没命中】时才上场。理由:扩展是猜的,绝不能挤掉人写的描述与别名。
33
+ * QUERY_SYNONYMS 只收真同义不收上下位("排版→格式化"收,"排版→美化"不收),
34
+ * 噪声的代价是把正确结果挤出 limit,那比搜不到更糟。
35
+ *
36
+ * 设计取舍
37
+ * --------
38
+ * 不搞 embedding / 向量检索:近名工具的区别是"哪个管哪一页/哪种背景"这种事实差异,
39
+ * 靠相似度算不出来,只能显式写;引入模型预分类属于过度设计。
40
+ * 中文纠偏(suggestSimilar)也只做字符 bigram 覆盖率,不做向量:错名多是错一两个字,
41
+ * bigram 足够,且不需要任何模型依赖。
42
+ */
43
+ import { ToolDefinition } from '../types/tools';
44
+ export interface ToolMeta {
45
+ /** 中文别名(自动拼 + 手工补) */
46
+ aliases: string[];
47
+ /** 正例:什么样的诉求该用它 */
48
+ examples?: string[];
49
+ /** 反例:它【不】干什么,以及该用谁 */
50
+ notFor?: string[];
51
+ /** 检索用的大杂烩(名字 + 描述 + 别名,全小写) */
52
+ haystack: string;
53
+ }
54
+ /** 取(并缓存)某个工具的检索元数据 */
55
+ export declare function getToolMeta(def: ToolDefinition): ToolMeta;
56
+ /** 清空缓存(测试用;生产里工具在启动时注册完就不再变) */
57
+ export declare function __clearToolMetaCache(): void;
58
+ /**
59
+ * 把用户查询扩展成一组等价查询词(含原词)。
60
+ *
61
+ * 三条来源,都很便宜:
62
+ * 1) 命中 QUERY_SYNONYMS → 人工审过的同义词
63
+ * 2) 该词是 TOKEN_ZH 里的中文说法 → 反查英文词根("背景色"→color/style)
64
+ * 3) 该词本身是英文词根 → 展开成它的中文说法("layout"→排版/布局)
65
+ * 上限 6 个词:再多就是噪声而不是帮助。
66
+ */
67
+ export declare function expandQuery(keyword: string): string[];
68
+ //# sourceMappingURL=tool-metadata.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-metadata.d.ts","sourceRoot":"","sources":["../../src/server/tool-metadata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA2rBhD,MAAM,WAAW,QAAQ;IACvB,sBAAsB;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,uBAAuB;AACvB,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,QAAQ,CAiBzD;AAED,iCAAiC;AACjC,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AA+DD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQrD"}