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,116 @@
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 cache = new Map();
28
+ /**
29
+ * 自动生成覆盖不到的工具 —— 手写在这里,并说明为什么。
30
+ *
31
+ * 有两类,覆盖不到的原因完全不同:
32
+ *
33
+ * 【一】动作名是运行期参数,静态推不出来。
34
+ * wps_execute_method 在 mcp-server.ts 里直接 this.registry.register(),
35
+ * 不走 allTools,所以 gen 脚本观测不到它;它的动作名还是调用时传进来的字符串。
36
+ * 它能执行【任意】WPS 动作(删东西、关文档、原地转格式),破坏性按 true 给。
37
+ *
38
+ * 【二】它本身不是"一个动作",而是"编排别人的容器"。
39
+ * wps_common_batch 是批量执行器:它的 handler 不直接调 executeAction,
40
+ * 而是转手调注册表里的其它工具,所以观测不到任何动作名,
41
+ * 落到"按工具名推断"会推出 'batch' 这种毫无意义的名字 → 判成非破坏性、幂等。
42
+ * 但它能装下任意写入型工具(含删除、另存为、关闭),这三项都必须按最坏情况给:
43
+ * 非只读、破坏性、非幂等。名字推断在这里不是"保守",是"猜错了"。
44
+ */
45
+ const EXTRA_ANNOTATIONS = {
46
+ wps_execute_method: {
47
+ readOnlyHint: false,
48
+ destructiveHint: true,
49
+ idempotentHint: false,
50
+ openWorldHint: false,
51
+ },
52
+ wps_common_batch: {
53
+ readOnlyHint: false,
54
+ destructiveHint: true,
55
+ idempotentHint: false,
56
+ openWorldHint: false,
57
+ },
58
+ };
59
+ /**
60
+ * 算一个工具的注解。
61
+ * 拿不到动作名(工具没在映射表里、也不在 EXTRA 里)就返回 undefined ——
62
+ * 宁可没有注解,也不要给一个猜出来的错注解(客户端可能拿它做安全决策)。
63
+ */
64
+ function getToolAnnotations(toolName) {
65
+ if (cache.has(toolName))
66
+ return cache.get(toolName);
67
+ const extra = EXTRA_ANNOTATIONS[toolName];
68
+ if (extra) {
69
+ cache.set(toolName, extra);
70
+ return extra;
71
+ }
72
+ const actions = tool_annotations_generated_1.TOOL_ACTIONS[toolName];
73
+ if (!actions || !actions.length) {
74
+ cache.set(toolName, undefined);
75
+ return undefined;
76
+ }
77
+ // 一个工具可能发多条命令,只要有一条会写,它就不能算只读
78
+ const readOnly = actions.every(cancellable_1.isReadOnlyAction);
79
+ const destructive = actions.some(cancellable_1.isDestructiveAction);
80
+ const ann = {
81
+ readOnlyHint: readOnly,
82
+ // 只读的按定义不破坏;写入里只有删/丢数据/原地转换那批算破坏
83
+ destructiveHint: readOnly ? false : destructive,
84
+ idempotentHint: actions.every(cancellable_1.isIdempotentAction),
85
+ // 本 MCP 的全部副作用都在本机 WPS,不访问外部系统
86
+ openWorldHint: false,
87
+ };
88
+ cache.set(toolName, ann);
89
+ return ann;
90
+ }
91
+ /** 注解覆盖了多少工具(诊断用) */
92
+ function annotationCoverage(toolNames) {
93
+ const annotated = toolNames.filter((n) => getToolAnnotations(n) !== undefined).length;
94
+ return { total: toolNames.length, annotated };
95
+ }
96
+ /** 汇总分布(诊断/文档用,数字必须实测别手写) */
97
+ function annotationSummary(toolNames) {
98
+ let readOnly = 0;
99
+ let destructive = 0;
100
+ let nonIdempotent = 0;
101
+ let annotated = 0;
102
+ for (const n of toolNames) {
103
+ const a = getToolAnnotations(n);
104
+ if (!a)
105
+ continue;
106
+ annotated++;
107
+ if (a.readOnlyHint)
108
+ readOnly++;
109
+ if (a.destructiveHint)
110
+ destructive++;
111
+ if (a.idempotentHint === false)
112
+ nonIdempotent++;
113
+ }
114
+ return { total: toolNames.length, annotated, readOnly, destructive, nonIdempotent };
115
+ }
116
+ //# 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,43 @@
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
+ * 设计取舍
24
+ * --------
25
+ * 不搞 embedding / 向量检索:近名工具的区别是"哪个管哪一页/哪种背景"这种事实差异,
26
+ * 靠相似度算不出来,只能显式写;引入模型预分类属于过度设计。
27
+ */
28
+ import { ToolDefinition } from '../types/tools';
29
+ export interface ToolMeta {
30
+ /** 中文别名(自动拼 + 手工补) */
31
+ aliases: string[];
32
+ /** 正例:什么样的诉求该用它 */
33
+ examples?: string[];
34
+ /** 反例:它【不】干什么,以及该用谁 */
35
+ notFor?: string[];
36
+ /** 检索用的大杂烩(名字 + 描述 + 别名,全小写) */
37
+ haystack: string;
38
+ }
39
+ /** 取(并缓存)某个工具的检索元数据 */
40
+ export declare function getToolMeta(def: ToolDefinition): ToolMeta;
41
+ /** 清空缓存(测试用;生产里工具在启动时注册完就不再变) */
42
+ export declare function __clearToolMetaCache(): void;
43
+ //# 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;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA6mBhD,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"}