wps-multitool-mcp 1.0.4 → 1.0.5

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 +36 -1
  2. package/dist/bridge/index.js.map +1 -1
  3. package/dist/server/auto-snapshot.d.ts.map +1 -1
  4. package/dist/server/auto-snapshot.js +4 -0
  5. package/dist/server/auto-snapshot.js.map +1 -1
  6. package/dist/server/collab-guard.d.ts +13 -0
  7. package/dist/server/collab-guard.d.ts.map +1 -0
  8. package/dist/server/collab-guard.js +112 -0
  9. package/dist/server/collab-guard.js.map +1 -0
  10. package/dist/server/intent-miss-log.d.ts +28 -0
  11. package/dist/server/intent-miss-log.d.ts.map +1 -0
  12. package/dist/server/intent-miss-log.js +143 -0
  13. package/dist/server/intent-miss-log.js.map +1 -0
  14. package/dist/server/mcp-server.d.ts.map +1 -1
  15. package/dist/server/mcp-server.js +16 -3
  16. package/dist/server/mcp-server.js.map +1 -1
  17. package/dist/server/progress-context.js +1 -1
  18. package/dist/server/task-engine.d.ts +112 -0
  19. package/dist/server/task-engine.d.ts.map +1 -0
  20. package/dist/server/task-engine.js +305 -0
  21. package/dist/server/task-engine.js.map +1 -0
  22. package/dist/server/tool-aliases.generated.d.ts +1 -1
  23. package/dist/server/tool-aliases.generated.d.ts.map +1 -1
  24. package/dist/server/tool-aliases.generated.js +14 -2
  25. package/dist/server/tool-aliases.generated.js.map +1 -1
  26. package/dist/server/tool-annotations.d.ts.map +1 -1
  27. package/dist/server/tool-annotations.generated.d.ts.map +1 -1
  28. package/dist/server/tool-annotations.generated.js +2 -7
  29. package/dist/server/tool-annotations.generated.js.map +1 -1
  30. package/dist/server/tool-annotations.js +9 -0
  31. package/dist/server/tool-annotations.js.map +1 -1
  32. package/dist/server/tool-metadata.d.ts.map +1 -1
  33. package/dist/server/tool-metadata.js +13 -9
  34. package/dist/server/tool-metadata.js.map +1 -1
  35. package/dist/server/tool-registry.d.ts.map +1 -1
  36. package/dist/server/tool-registry.js +26 -1
  37. package/dist/server/tool-registry.js.map +1 -1
  38. package/dist/server/tool-tiers.d.ts +1 -1
  39. package/dist/server/tool-tiers.js +1 -1
  40. package/dist/server/tool-verification.d.ts +5 -5
  41. package/dist/server/tool-verification.generated.d.ts +4 -4
  42. package/dist/server/tool-verification.generated.d.ts.map +1 -1
  43. package/dist/server/tool-verification.generated.js +5 -10
  44. package/dist/server/tool-verification.generated.js.map +1 -1
  45. package/dist/server/tool-verification.js +2 -2
  46. package/dist/tools/common/index.d.ts +1 -0
  47. package/dist/tools/common/index.d.ts.map +1 -1
  48. package/dist/tools/common/index.js +3 -0
  49. package/dist/tools/common/index.js.map +1 -1
  50. package/dist/tools/common/intent.d.ts +10 -2
  51. package/dist/tools/common/intent.d.ts.map +1 -1
  52. package/dist/tools/common/intent.js +144 -36
  53. package/dist/tools/common/intent.js.map +1 -1
  54. package/dist/tools/common/snapshot.d.ts.map +1 -1
  55. package/dist/tools/common/snapshot.js +9 -1
  56. package/dist/tools/common/snapshot.js.map +1 -1
  57. package/dist/tools/common/taskrunner.d.ts +25 -0
  58. package/dist/tools/common/taskrunner.d.ts.map +1 -0
  59. package/dist/tools/common/taskrunner.js +100 -0
  60. package/dist/tools/common/taskrunner.js.map +1 -0
  61. package/dist/tools/excel/chart.d.ts.map +1 -1
  62. package/dist/tools/excel/chart.js +28 -12
  63. package/dist/tools/excel/chart.js.map +1 -1
  64. package/dist/tools/excel/comment-protect.js +2 -2
  65. package/dist/tools/excel/comment-protect.js.map +1 -1
  66. package/dist/tools/excel/data.d.ts.map +1 -1
  67. package/dist/tools/excel/data.js +18 -7
  68. package/dist/tools/excel/data.js.map +1 -1
  69. package/dist/tools/ppt/animation.d.ts +2 -2
  70. package/dist/tools/ppt/animation.d.ts.map +1 -1
  71. package/dist/tools/ppt/animation.js +24 -86
  72. package/dist/tools/ppt/animation.js.map +1 -1
  73. package/dist/tools/ppt/beautify-advanced.d.ts +3 -16
  74. package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -1
  75. package/dist/tools/ppt/beautify-advanced.js +65 -355
  76. package/dist/tools/ppt/beautify-advanced.js.map +1 -1
  77. package/dist/tools/ppt/chart-flow.d.ts.map +1 -1
  78. package/dist/tools/ppt/chart-flow.js +41 -206
  79. package/dist/tools/ppt/chart-flow.js.map +1 -1
  80. package/dist/tools/ppt/data-viz.d.ts.map +1 -1
  81. package/dist/tools/ppt/data-viz.js +29 -227
  82. package/dist/tools/ppt/data-viz.js.map +1 -1
  83. package/dist/tools/ppt/deckkit.d.ts +75 -16
  84. package/dist/tools/ppt/deckkit.d.ts.map +1 -1
  85. package/dist/tools/ppt/deckkit.js +271 -32
  86. package/dist/tools/ppt/deckkit.js.map +1 -1
  87. package/dist/tools/ppt/helpers.d.ts +38 -0
  88. package/dist/tools/ppt/helpers.d.ts.map +1 -0
  89. package/dist/tools/ppt/helpers.js +60 -0
  90. package/dist/tools/ppt/helpers.js.map +1 -0
  91. package/dist/tools/ppt/image.d.ts +6 -4
  92. package/dist/tools/ppt/image.d.ts.map +1 -1
  93. package/dist/tools/ppt/image.js +102 -202
  94. package/dist/tools/ppt/image.js.map +1 -1
  95. package/dist/tools/ppt/index.d.ts +42 -30
  96. package/dist/tools/ppt/index.d.ts.map +1 -1
  97. package/dist/tools/ppt/index.js +102 -96
  98. package/dist/tools/ppt/index.js.map +1 -1
  99. package/dist/tools/ppt/misc.d.ts +1 -2
  100. package/dist/tools/ppt/misc.d.ts.map +1 -1
  101. package/dist/tools/ppt/misc.js +70 -385
  102. package/dist/tools/ppt/misc.js.map +1 -1
  103. package/dist/tools/ppt/page-effects.d.ts +28 -0
  104. package/dist/tools/ppt/page-effects.d.ts.map +1 -0
  105. package/dist/tools/ppt/page-effects.js +505 -0
  106. package/dist/tools/ppt/page-effects.js.map +1 -0
  107. package/dist/tools/ppt/{background.d.ts → page-info.d.ts} +11 -13
  108. package/dist/tools/ppt/page-info.d.ts.map +1 -0
  109. package/dist/tools/ppt/page-info.js +258 -0
  110. package/dist/tools/ppt/page-info.js.map +1 -0
  111. package/dist/tools/ppt/presentation.d.ts +3 -6
  112. package/dist/tools/ppt/presentation.d.ts.map +1 -1
  113. package/dist/tools/ppt/presentation.js +72 -373
  114. package/dist/tools/ppt/presentation.js.map +1 -1
  115. package/dist/tools/ppt/shape-basic.d.ts +22 -3
  116. package/dist/tools/ppt/shape-basic.d.ts.map +1 -1
  117. package/dist/tools/ppt/shape-basic.js +441 -344
  118. package/dist/tools/ppt/shape-basic.js.map +1 -1
  119. package/dist/tools/ppt/slide-ops.d.ts +6 -42
  120. package/dist/tools/ppt/slide-ops.d.ts.map +1 -1
  121. package/dist/tools/ppt/slide-ops.js +93 -1485
  122. package/dist/tools/ppt/slide-ops.js.map +1 -1
  123. package/dist/tools/ppt/slide.d.ts +1 -7
  124. package/dist/tools/ppt/slide.d.ts.map +1 -1
  125. package/dist/tools/ppt/slide.js +157 -289
  126. package/dist/tools/ppt/slide.js.map +1 -1
  127. package/dist/tools/ppt/table.d.ts.map +1 -1
  128. package/dist/tools/ppt/table.js +30 -200
  129. package/dist/tools/ppt/table.js.map +1 -1
  130. package/dist/tools/ppt/textbox.d.ts +1 -22
  131. package/dist/tools/ppt/textbox.d.ts.map +1 -1
  132. package/dist/tools/ppt/textbox.js +87 -107
  133. package/dist/tools/ppt/textbox.js.map +1 -1
  134. package/dist/tools/word/academic.d.ts +2 -0
  135. package/dist/tools/word/academic.d.ts.map +1 -1
  136. package/dist/tools/word/academic.js +77 -111
  137. package/dist/tools/word/academic.js.map +1 -1
  138. package/dist/tools/word/content.d.ts +7 -12
  139. package/dist/tools/word/content.d.ts.map +1 -1
  140. package/dist/tools/word/content.js +134 -452
  141. package/dist/tools/word/content.js.map +1 -1
  142. package/dist/tools/word/document.d.ts +1 -3
  143. package/dist/tools/word/document.d.ts.map +1 -1
  144. package/dist/tools/word/document.js +71 -328
  145. package/dist/tools/word/document.js.map +1 -1
  146. package/dist/tools/word/format.d.ts.map +1 -1
  147. package/dist/tools/word/format.js +59 -211
  148. package/dist/tools/word/format.js.map +1 -1
  149. package/dist/tools/word/helpers.d.ts +33 -0
  150. package/dist/tools/word/helpers.d.ts.map +1 -0
  151. package/dist/tools/word/helpers.js +50 -0
  152. package/dist/tools/word/helpers.js.map +1 -0
  153. package/dist/tools/word/index.d.ts +1 -1
  154. package/dist/tools/word/index.d.ts.map +1 -1
  155. package/dist/tools/word/index.js +2 -6
  156. package/dist/tools/word/index.js.map +1 -1
  157. package/dist/tools/word/professional.d.ts.map +1 -1
  158. package/dist/tools/word/professional.js +5 -3
  159. package/dist/tools/word/professional.js.map +1 -1
  160. package/dist/tools/word/proofread.d.ts.map +1 -1
  161. package/dist/tools/word/proofread.js +44 -184
  162. package/dist/tools/word/proofread.js.map +1 -1
  163. package/dist/types/tools.d.ts +6 -0
  164. package/dist/types/tools.d.ts.map +1 -1
  165. package/package.json +1 -1
  166. package/scripts/wps-com.ps1 +109 -21
  167. package/skills/wps-multitool/SKILL.md +16 -3
  168. package/skills/wps-multitool/references/recipes.md +20 -4
  169. package/skills/wps-multitool/references/routing.md +13 -0
  170. package/dist/tools/ppt/background.d.ts.map +0 -1
  171. package/dist/tools/ppt/background.js +0 -389
  172. package/dist/tools/ppt/background.js.map +0 -1
@@ -326,14 +326,69 @@ function Get-WpsExePath {
326
326
  return $null
327
327
  }
328
328
 
329
+ # 演示文稿健康检查(微轮 · PPT 定位去 Active 化 2026-11-05):Name 非空 且 Slides.Count 可读。
330
+ # 对应 word 侧的 Test-DocHealthy——Active* 是弱引用(依赖 UI 焦点,自动化场景不可靠),
331
+ # 冷启动/焦点落在首页时会给出 null/空壳,必须过健康检查才能当"解析成功"。
332
+ function Test-PresHealthy($pres) {
333
+ if ($null -eq $pres) { return $false }
334
+ try {
335
+ $n = [string]$pres.Name
336
+ if ([string]::IsNullOrWhiteSpace($n)) { return $false }
337
+ } catch { return $false }
338
+ try { $null = $pres.Slides.Count } catch { return $false }
339
+ return $true
340
+ }
341
+
342
+ # 按名字找演示文稿:先按 FullName 全等,再按 Name 全等,最后按"文件名(无扩展名)"全等。
343
+ function Find-PresByName($ppt, [string]$want) {
344
+ if ($null -eq $ppt -or [string]::IsNullOrWhiteSpace($want)) { return $null }
345
+ $items = @()
346
+ try { $items = @($ppt.Presentations) } catch { return $null }
347
+ foreach ($c in $items) {
348
+ try { if ([string]$c.FullName -eq $want) { return $c } } catch {}
349
+ }
350
+ foreach ($c in $items) {
351
+ try { if ([string]$c.Name -eq $want) { return $c } } catch {}
352
+ }
353
+ $stem = [System.IO.Path]::GetFileNameWithoutExtension($want)
354
+ if (-not [string]::IsNullOrWhiteSpace($stem)) {
355
+ foreach ($c in $items) {
356
+ try { if ([string]$c.Name -eq $stem) { return $c } } catch {}
357
+ try { if ([System.IO.Path]::GetFileNameWithoutExtension([string]$c.Name) -eq $stem) { return $c } } catch {}
358
+ }
359
+ }
360
+ return $null
361
+ }
362
+
363
+ # 解析目标演示文稿(微轮 · PPT 定位去 Active 化,照 Resolve-Doc 形制):
364
+ # 1) presentationName 精确定位(找不到返回 $null,不静默回退——否则用户以为在改 A 结果改的是 B);
365
+ # 2) ActivePresentation 必须过 Test-PresHealthy(弱引用/幽灵窗口在恶劣状态下给出 null/空壳);
366
+ # 3) 空壳 → 遍历 Presentations 取第一个健康的;
367
+ # 4) 全空返回 $null,由调用方报明确错误。
368
+ function Resolve-Pres($ppt, $p) {
369
+ if ($null -eq $ppt) { return $null }
370
+ if ($p -and $p.presentationName) {
371
+ $d = Find-PresByName $ppt ([string]$p.presentationName)
372
+ if ($d) { return $d }
373
+ return $null
374
+ }
375
+ try { $act = $ppt.ActivePresentation } catch { $act = $null }
376
+ if (Test-PresHealthy $act) { return $act }
377
+ try {
378
+ foreach ($c in @($ppt.Presentations)) {
379
+ if (Test-PresHealthy $c) { return $c }
380
+ }
381
+ } catch {}
382
+ return $null
383
+ }
384
+
329
385
  # 解析目标演示文稿:优先按 presentationName 精确定位(避免多文稿打开时 ActivePresentation 漂移),
330
386
  # 未提供则回退到当前活动文稿;提供了但找不到则返回 $null(让调用方报明确错误,而不是误改其它文稿)。
387
+ # 微轮(2026-11-05):实现体收敛到 Resolve-Pres(Active 过健康检查 + 空壳遍历)——
388
+ # 全组用 Get-TargetPres 的 PPT 工具自动获得去 Active 化后的解析。
331
389
  function Get-TargetPres($ppt, $p) {
332
390
  if ($null -eq $ppt) { return $null }
333
- if ($p.presentationName) {
334
- try { return $ppt.Presentations.Item([string]$p.presentationName) } catch { return $null }
335
- }
336
- return $ppt.ActivePresentation
391
+ return Resolve-Pres $ppt $p
337
392
  }
338
393
 
339
394
  # 取整型参数并带默认值。写成函数而不是内联 $(if ...):内联 if 在 [int] 转换里
@@ -1070,7 +1125,12 @@ switch ($Action) {
1070
1125
  $dir = ""; try { $dir = [string]$book.Path } catch {}
1071
1126
  $saved = $true; try { $saved = [bool]$book.Saved } catch {}
1072
1127
  $ro = $false; try { $ro = [bool]$book.ReadOnly } catch {}
1073
- $cand += @{ app = "excel"; name = [string]$book.Name; fullName = $full; dir = $dir; saved = $saved; readOnly = $ro; hasPath = (-not [string]::IsNullOrEmpty($dir)) }
1128
+ # editProbe:协作安全网的文档指纹(2026-10-29)。excel 用 UsedRange 的
1129
+ # 地址+行列数 —— 只有结构性增删会动它,改单元格值不会(诚实局限:
1130
+ # 值级人工编辑在此探测不到)。取不到就 $null,守卫侧按降级处理。
1131
+ $probe = $null
1132
+ try { $ur = $book.ActiveSheet.UsedRange; $probe = "$($ur.Address)|$($ur.Rows.Count)x$($ur.Columns.Count)" } catch {}
1133
+ $cand += @{ app = "excel"; name = [string]$book.Name; fullName = $full; dir = $dir; saved = $saved; readOnly = $ro; hasPath = (-not [string]::IsNullOrEmpty($dir)); editProbe = $probe }
1074
1134
  }
1075
1135
  } catch {}
1076
1136
  }
@@ -1086,7 +1146,11 @@ switch ($Action) {
1086
1146
  $dir = ""; try { $dir = [string]$doc.Path } catch {}
1087
1147
  $saved = $true; try { $saved = [bool]$doc.Saved } catch {}
1088
1148
  $ro = $false; try { $ro = [bool]$doc.ReadOnly } catch {}
1089
- $cand += @{ app = "word"; name = [string]$doc.Name; fullName = $full; dir = $dir; saved = $saved; readOnly = $ro; hasPath = (-not [string]::IsNullOrEmpty($dir)) }
1149
+ # editProbe:word 用正文流末位(Content.End,O(1))——插入/删除会移动它,
1150
+ # 纯格式调整不会(诚实局限:排版级人工编辑探测不到)。
1151
+ $probe = $null
1152
+ try { $probe = [string]$doc.Content.End } catch {}
1153
+ $cand += @{ app = "word"; name = [string]$doc.Name; fullName = $full; dir = $dir; saved = $saved; readOnly = $ro; hasPath = (-not [string]::IsNullOrEmpty($dir)); editProbe = $probe }
1090
1154
  }
1091
1155
  } catch {}
1092
1156
  }
@@ -1102,7 +1166,10 @@ switch ($Action) {
1102
1166
  $dir = ""; try { $dir = [string]$pres.Path } catch {}
1103
1167
  $saved = $true; try { $saved = [bool]$pres.Saved } catch {}
1104
1168
  $ro = $false; try { $ro = [bool]$pres.ReadOnly } catch {}
1105
- $cand += @{ app = "ppt"; name = [string]$pres.Name; fullName = $full; dir = $dir; saved = $saved; readOnly = $ro; hasPath = (-not [string]::IsNullOrEmpty($dir)) }
1169
+ # editProbe:ppt 用页数 —— 增删页会动它,改页内文字不会(诚实局限)。
1170
+ $probe = $null
1171
+ try { $probe = [string]$pres.Slides.Count } catch {}
1172
+ $cand += @{ app = "ppt"; name = [string]$pres.Name; fullName = $full; dir = $dir; saved = $saved; readOnly = $ro; hasPath = (-not [string]::IsNullOrEmpty($dir)); editProbe = $probe }
1106
1173
  }
1107
1174
  } catch {}
1108
1175
  }
@@ -1852,11 +1919,20 @@ switch ($Action) {
1852
1919
  $ppt = Get-WpsPpt
1853
1920
  if ($null -eq $ppt) { Output-Json @{ success = $false; error = "WPS PPT not running" }; return }
1854
1921
  $pres = $ppt.Presentations.Add()
1922
+ # 微轮 · PPT 定位去 Active 化(2026-11-05):Add() 不带窗口不物化——0 页幽灵演示文稿
1923
+ # 会毒化 ActivePresentation 焦点(后续 Slides.Add 报"对 Null 调方法")。Add 后立即
1924
+ # Activate 物化窗口,从源头杀幽灵;Activate 失败进 warnings 不阻断。
1925
+ $actWarn = $null
1926
+ try { $pres.Activate() } catch { $actWarn = "新演示文稿窗口物化失败(Activate):" + $_.Exception.Message }
1855
1927
  # 必须回 data:Node 侧的 handler 判的是 success && data,
1856
1928
  # 只回 success 会被当成失败("新建演示文稿失败: undefined" —— 实测踩过)
1857
1929
  $nm = ""
1858
1930
  try { $nm = [string]$pres.Name } catch {}
1859
- Output-Json @{ success = $true; data = @{ name = $nm; count = $ppt.Presentations.Count } }
1931
+ if ($actWarn) {
1932
+ Output-Json @{ success = $true; data = @{ name = $nm; count = $ppt.Presentations.Count }; warnings = @(@{ step = 'createPresentation'; message = $actWarn }) }
1933
+ } else {
1934
+ Output-Json @{ success = $true; data = @{ name = $nm; count = $ppt.Presentations.Count } }
1935
+ }
1860
1936
  }
1861
1937
 
1862
1938
  "convertToPDF" {
@@ -5191,14 +5267,12 @@ switch ($Action) {
5191
5267
  Output-Json @{ success = $false; error = "[勿重试·先改参数] 宽高必须是正数(收到 width=$($p.width) height=$($p.height))" }
5192
5268
  return
5193
5269
  }
5194
- # 单位换算:TS 的 schema 承诺的是【像素】,而 WPS 的 PageSetup 要的是【磅】。
5195
- # 1 px = 0.75 pt(96 DPI)。不换算的话 960×720 会被当成 960×720 磅 = 13.3×10 英寸,
5196
- # 页面上所有元素都跑到角落里去 —— 用户看到的是"设完尺寸版面全乱了"。
5197
- $wPt = $w * 0.75
5198
- $hPt = $h * 0.75
5199
- $pres.PageSetup.SlideWidth = $wPt
5200
- $pres.PageSetup.SlideHeight = $hPt
5201
- Output-Json @{ success = $true; data = @{ width = $w; height = $h; widthPt = $wPt; heightPt = $hPt; slideCount = $pres.Slides.Count } }
5270
+ # 单位裁定(2026-11-03 所有者授权决策者定):全组统一【磅】——COM/VBA/Office JS 原生单位,
5271
+ # 一套闭环最广。v1.0.5 起本动作收到的 width/height 直接就是磅,不再做 px→pt 的 ×0.75 换算
5272
+ # (旧口径曾按 96 DPI 折算:960×720"像素"进来变 720×540 磅出去;迁移提示写在 TS schema 里)。
5273
+ $pres.PageSetup.SlideWidth = $w
5274
+ $pres.PageSetup.SlideHeight = $h
5275
+ Output-Json @{ success = $true; data = @{ width = $w; height = $h; widthPt = $w; heightPt = $h; slideCount = $pres.Slides.Count } }
5202
5276
  }
5203
5277
 
5204
5278
  "setSlideTheme" {
@@ -5337,7 +5411,14 @@ switch ($Action) {
5337
5411
  if ($shape.HasTextFrame) {
5338
5412
  $text = ""
5339
5413
  try { $text = $shape.TextFrame.TextRange.Text } catch {}
5340
- $textBoxes += @{ name = $shape.Name; index = $i; text = $text; left = $shape.Left; top = $shape.Top; width = $shape.Width; height = $shape.Height }
5414
+ # E3 增补(deckkit 生成后溢出检查的读回依据,引擎探针 seg2 证过 BoundHeight 可判溢出):
5415
+ # boundWidth/boundHeight = 文字实际包围盒(超框判据),fontSize = 当前字号(缩字档位基准)。
5416
+ # 取不到时回 null——调用方按字段缺失降级,勿当硬失败。老桥没有这几行。
5417
+ $bw = $null; $bh = $null; $fs = $null
5418
+ try { $bw = [math]::Round($shape.BoundWidth, 2) } catch {}
5419
+ try { $bh = [math]::Round($shape.BoundHeight, 2) } catch {}
5420
+ try { $fs = $shape.TextFrame.TextRange.Font.Size } catch {}
5421
+ $textBoxes += @{ name = $shape.Name; index = $i; text = $text; left = $shape.Left; top = $shape.Top; width = $shape.Width; height = $shape.Height; boundWidth = $bw; boundHeight = $bh; fontSize = $fs }
5341
5422
  }
5342
5423
  }
5343
5424
  Output-Json @{ success = $true; data = @{ slideIndex = $slideIndex; textBoxes = $textBoxes; count = $textBoxes.Count } }
@@ -6144,10 +6225,11 @@ switch ($Action) {
6144
6225
  $pres = Get-TargetPres $ppt $p
6145
6226
  $slideIndex = if ($p.slideIndex) { $p.slideIndex } else { 1 }
6146
6227
  $slide = $pres.Slides.Item($slideIndex)
6147
- $left = if ($p.left) { $p.left } else { 100 }
6148
- $top = if ($p.top) { $p.top } else { 100 }
6149
- $width = if ($p.width) { $p.width } else { 400 }
6150
- $height = if ($p.height) { $p.height } else { 300 }
6228
+ # 坐标/尺寸用 $null -ne 判断,不用真值判断:0 是合法坐标(与 TS 侧 add_shape 的 ?? 修复同批,审计三.1)
6229
+ $left = if ($null -ne $p.left) { $p.left } else { 100 }
6230
+ $top = if ($null -ne $p.top) { $p.top } else { 100 }
6231
+ $width = if ($null -ne $p.width) { $p.width } else { 400 }
6232
+ $height = if ($null -ne $p.height) { $p.height } else { 300 }
6151
6233
  # AddChart 的第一个参数是 xlChartType 枚举(数字),不是类型名字符串。
6152
6234
  # 之前这里直接把 $p.type 丢进去:TS 传 chartType 时它是 $null(靠 COM 兜默认值蒙混过去),
6153
6235
  # 入口归一化把 chartType 映射成 type 之后,"bar" 这个字符串就撞上来了 ——
@@ -9092,6 +9174,12 @@ switch ($Action) {
9092
9174
  try {
9093
9175
  $marked = 0
9094
9176
  try { $marked = [int]$doc.Indexes.MarkEntries.Count } catch {}
9177
+ # countOnly:只读计数,不插入(2026-10-30 word-audit:TS 的 op=count 查个数
9178
+ # 此前会真的在光标处插一个空索引——查询带副作用的副作用 bug)
9179
+ if ($p.countOnly) {
9180
+ Output-Json @{ success = $true; data = @{ markedEntries = $marked } }
9181
+ return
9182
+ }
9095
9183
  $rng = $word.Selection.Range
9096
9184
  $rng.Collapse(0)
9097
9185
  $ix = $doc.Indexes.Add($rng)
@@ -69,7 +69,9 @@ MCP 提供了近 300 个工具(以 `tools/list` 与 `wps_search_tools` 为准
69
69
 
70
70
  1. **锁定目标**:用户可能开着多个文档。用切换文档类工具把目标钉死,
71
71
  否则切一次窗口就写到别的文件里去了。
72
- 2. **建快照**:COM 写入不是事务,没有撤销。现在有补偿手段了 ——
72
+ 2. **留后手**:COM 写入不是事务。补偿手段有两层,轻的在前 ——
73
+ - `wps_word_undo`:**撤销上一步**(文字组)。撤销前会**自动建快照**——改错一步先用它,
74
+ 比"事后整份恢复"轻得多;多步或跨应用的破坏,才轮到下面的快照恢复
73
75
  - `wps_common_snapshot_create`:存一份磁盘副本,返回路径
74
76
  - `wps_common_batch` 检测到破坏性/非幂等步骤时会**自动**建,不用你操心
75
77
  - 改坏了用 `wps_common_snapshot_restore`;默认写出`.restored-<时间>`副本(不覆盖),
@@ -108,9 +110,9 @@ PPT 组里还有没逐条验证的,读它才知道哪个工具要额外复核
108
110
  PPT 组的真值(照 `scripts/manual/tool-verification.json` 的 `ppt` 条目,别凭印象说):
109
111
 
110
112
  - 组级口径仍记 **`static`**:矩阵里仍有 5 条是**有据可查地跳过**的,不是漏跑;
111
- - 但真机覆盖已经上量:PPT 组共 **101** 个工具(含 1 个内置),隔离验证矩阵 **103** 行(多出的行是旧名别名),
113
+ - 但真机覆盖已经上量:PPT 组共 **98** 个工具(含 1 个内置),隔离验证矩阵 **103** 行(多出的行是旧名别名),
112
114
  实际执行 **98** 条、**全部跑通**,跳过的 **5** 条各有实测原因;
113
- - 另有 **91** 个 PPT 工具在台账里逐条记为 `live`(2026-10-27 live 还债轮:隔离矩阵执行通过名单 ∩ 现注册表 + 4 个新工具真机证据)。
115
+ - 另有 **85** 个 PPT 工具在台账里逐条记为 `live`(2026-10-27 live 还债轮:隔离矩阵执行通过名单 ∩ 现注册表;2026-11-03 set_slide_size 单位改磅降回组级、11-04 五个旧工具转别名或下线移出逐条表)。
114
116
 
115
117
  所以**别说「PPT 没验证过」**,也**别说「PPT 全部验证过了」**——两句都不准确。
116
118
  真话是:绝大多数 PPT 工具跑过真机并有断言,个别几条因 WPS 侧限制或需人工介入而有据跳过。
@@ -118,6 +120,17 @@ PPT 组的真值(照 `scripts/manual/tool-verification.json` 的 `ppt` 条目
118
120
  `static` 不是「不能用」,是「没人在真机上验证过这一条」。用它做完事,要如实告诉用户
119
121
  「这个工具只做过静态校验」,别把「没报错」当成「做对了」。
120
122
 
123
+ ## 1.0.4 的三个新能力(知道有就行,细节搜了再用)
124
+
125
+ - **意图三层**:`wps_route_intent` 现在按"直答 → 任务包 → 定组"三层走——
126
+ 高频单动作(保存/转 PDF/冻结首行/加页码…)直接回工具名和已提取的参数;
127
+ 高频整活(周报/论文排版/答辩演示…17 个任务包)直接回步骤序列;都不中才落到原来的组识别。
128
+ 话术命中不了别硬猜,照旧走第 4 步搜索。
129
+ - **进度通知**:批处理类工具会逐步回报进度(每步一个回调),长任务不再一屏空白等结果。
130
+ - **build_ppt_deck**:按 JSON 页面描述一次生成整套演示文稿(10 种页型,主题可选学术蓝/政务红/商务灰,
131
+ 生成完自动量文字溢出、超框缩字一次)。骨架类需求先用它;要逐页抠版式/动画再回到 PPT 组原工具精调。
132
+ 用前搜 "build deck" 读 notFor(它是新建语义,不负责改已有文稿的单页)。
133
+
121
134
  ## 参考文档
122
135
 
123
136
  按需读,**不要一次全读**——它们加起来比本文还长。
@@ -9,7 +9,8 @@
9
9
  照着现状改,不要凭想象写
10
10
  3. **分批**:一次改几十处容易中途失败,前功尽弃。分批做,每批做完验证
11
11
  4. **做完读回来**:写完不验证等于没做。至少读一次确认落位了
12
- 5. **破坏性动作前留快照**:让用户在 WPS 面板里存一份,MCP 侧没有撤销
12
+ 5. **破坏性动作前留后手**:单步改错用 `wps_word_undo` 撤销(撤销前自动建快照);
13
+ 批量改动前仍先留快照——批量没有"撤一步"的说法,只能整份恢复
13
14
 
14
15
  ## 配方一:整篇文档排版
15
16
 
@@ -53,6 +54,19 @@
53
54
 
54
55
  ## 配方三:做演示
55
56
 
57
+ **路径 A:整套生成(1.0.4 起,骨架类需求先走这条)**
58
+
59
+ ```
60
+ 1. status + load_tool_group(ppt)
61
+ 2. 定结构 → 几页、每页讲什么(标题/章节/要点/对比/图文/表格/图表/时间轴/结尾/引文 10 种页型)
62
+ 3. wps_ppt_build_deck → 把每页意图写成 JSON 一次生成整套(theme 可选学术蓝/政务红/商务灰;
63
+ 生成完自动量文字溢出,超框缩字一次,warnings 如实带回)
64
+ 4. 逐页出图复核 → wps_ppt_export_slide_as_image
65
+ 5. 存盘
66
+ ```
67
+
68
+ **路径 B:手排精调(已有骨架要抠细节,或从零逐页搭)**
69
+
56
70
  ```
57
71
  1. status + 确认演示文稿已打开
58
72
  2. load_tool_group(ppt)
@@ -65,9 +79,11 @@
65
79
  ```
66
80
 
67
81
  坑:
68
- - **PPT 组个别工具只有静态校验**(组级台账记 `static`:矩阵里 5 条有据跳过)。
69
- 每一步做完都要读回来看,并按 `wps_search_tools` 返回的 `verified` 字段如实告诉用户
70
- 「这个工具只做过静态校验」——别笼统说「PPT 没验证过」,那是错的;也别因为它跑通了就当全部都验过。
82
+ - **PPT 组组级台账仍记 `static`(保守口径)**:矩阵里 5 条各有实测原因跳过,不是漏跑。
83
+ 真机覆盖已上量:隔离矩阵 103 行、执行 98 条逐条跑通,91 个工具在台账里逐条记 `live`——
84
+ 所以**别说「PPT 没验证过」**,也**别说「全部验过」**。每一步做完都要读回来看,
85
+ 并按 `wps_search_tools` 返回的 `verified` 字段如实告诉用户哪条只做过静态校验
86
+ - build_ppt_deck 是**新建语义**(不改已有文稿的单页);要精调先出骨架再走路径 B,别拿它反复重生成
71
87
  - 母版和单页样式冲突时,母版优先;逐页设的背景会被母版覆盖
72
88
  - 加动画前先想清楚会不会让阅读变慢,不是每个元素都该动
73
89
 
@@ -76,6 +76,19 @@
76
76
  **先搜再读 `notFor`**,不要凭名字挑:不同工具管的是幻灯片背景 / 母版背景 /
77
77
  图表区背景,纯色 / 图片 / 渐变又是三回事;动画分普通 / 预设 / 强调 / 顺序 / 清除。
78
78
 
79
+ ## 1.0.4 新工具的入口(检索词为实测结果)
80
+
81
+ | 需求 | 用 | 怎么命中 |
82
+ |---|---|---|
83
+ | 撤销上一步 | `wps_word_undo`(撤销前自动建快照) | 搜「撤销」目前命中的是快照恢复类——**按完整工具名调用**最稳 |
84
+ | 开/关修订模式 | `wps_word_enable_track_changes` / 查状态 `wps_word_get_track_changes_status` | 搜「修订模式」 |
85
+ | 看/接受/拒绝已有修订 | `wps_word_revisions` | 搜「修订」「审阅」 |
86
+ | 建 Excel 表(套表格样式/筛选) | `wps_excel_create_table` | 搜「建表」——**与 Word 的 `wps_word_insert_table` 近名**,两个都会出,读 notFor 分清 |
87
+ | 加切片器 | `wps_excel_add_slicer` | 搜「切片器」 |
88
+ | 生成整套演示 | `wps_ppt_build_deck`(10 种页型/三主题/生成后溢出检查) | 搜「生成整套PPT」「一键做PPT」 |
89
+
90
+ 这些工具**不在直答层**(`wps_route_intent` 的高频单动作表里还没有它们),走搜索或直接按工具名调。
91
+
79
92
  ## 搜索返回什么
80
93
 
81
94
  ```
@@ -1 +0,0 @@
1
- {"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../../src/tools/ppt/background.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,cAAc,EACd,WAAW,EAGX,cAAc,EACf,MAAM,mBAAmB,CAAC;AAU3B;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAuBtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WA8CnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAuBpC,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,WA8CjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAiCtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WAkDnC,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAuBtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WA+CnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAkCtC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,WAsDnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,EAO3C,CAAC;AAEF,eAAe,eAAe,CAAC"}