wps-multitool-mcp 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bridge/index.js +4 -2
- package/dist/bridge/index.js.map +1 -1
- package/dist/cli/install.d.ts +58 -0
- package/dist/cli/install.d.ts.map +1 -0
- package/dist/cli/install.js +301 -0
- package/dist/cli/install.js.map +1 -0
- package/dist/client/action-routes.generated.d.ts +1 -1
- package/dist/client/action-routes.generated.d.ts.map +1 -1
- package/dist/client/action-routes.generated.js +6 -1
- package/dist/client/action-routes.generated.js.map +1 -1
- package/dist/client/wps-client.d.ts +0 -3
- package/dist/client/wps-client.d.ts.map +1 -1
- package/dist/client/wps-client.js +61 -27
- package/dist/client/wps-client.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +56 -4
- package/dist/index.js.map +1 -1
- package/dist/server/auto-snapshot.d.ts +58 -0
- package/dist/server/auto-snapshot.d.ts.map +1 -0
- package/dist/server/auto-snapshot.js +150 -0
- package/dist/server/auto-snapshot.js.map +1 -0
- package/dist/server/mcp-server.d.ts.map +1 -1
- package/dist/server/mcp-server.js +8 -141
- package/dist/server/mcp-server.js.map +1 -1
- package/dist/server/tool-aliases.generated.d.ts +41 -0
- package/dist/server/tool-aliases.generated.d.ts.map +1 -0
- package/dist/server/tool-aliases.generated.js +88 -0
- package/dist/server/tool-aliases.generated.js.map +1 -0
- package/dist/server/tool-annotations.d.ts +3 -0
- package/dist/server/tool-annotations.d.ts.map +1 -1
- package/dist/server/tool-annotations.generated.d.ts.map +1 -1
- package/dist/server/tool-annotations.generated.js +25 -47
- package/dist/server/tool-annotations.generated.js.map +1 -1
- package/dist/server/tool-annotations.js +83 -7
- package/dist/server/tool-annotations.js.map +1 -1
- package/dist/server/tool-metadata.d.ts +25 -0
- package/dist/server/tool-metadata.d.ts.map +1 -1
- package/dist/server/tool-metadata.js +217 -40
- package/dist/server/tool-metadata.js.map +1 -1
- package/dist/server/tool-registry.d.ts +25 -3
- package/dist/server/tool-registry.d.ts.map +1 -1
- package/dist/server/tool-registry.js +204 -42
- package/dist/server/tool-registry.js.map +1 -1
- package/dist/server/tool-tiers.d.ts +27 -8
- package/dist/server/tool-tiers.d.ts.map +1 -1
- package/dist/server/tool-tiers.js +34 -8
- package/dist/server/tool-tiers.js.map +1 -1
- package/dist/server/tool-verification.d.ts +35 -0
- package/dist/server/tool-verification.d.ts.map +1 -0
- package/dist/server/tool-verification.generated.d.ts +17 -0
- package/dist/server/tool-verification.generated.d.ts.map +1 -0
- package/dist/server/tool-verification.generated.js +293 -0
- package/dist/server/tool-verification.generated.js.map +1 -0
- package/dist/server/tool-verification.js +43 -0
- package/dist/server/tool-verification.js.map +1 -0
- package/dist/tools/common/batch.d.ts.map +1 -1
- package/dist/tools/common/batch.js +92 -14
- package/dist/tools/common/batch.js.map +1 -1
- package/dist/tools/common/general.d.ts +0 -3
- package/dist/tools/common/general.d.ts.map +1 -1
- package/dist/tools/common/general.js +16 -58
- package/dist/tools/common/general.js.map +1 -1
- package/dist/tools/common/index.d.ts +4 -2
- package/dist/tools/common/index.d.ts.map +1 -1
- package/dist/tools/common/index.js +18 -4
- package/dist/tools/common/index.js.map +1 -1
- package/dist/tools/common/repair.js +18 -18
- package/dist/tools/common/snapshot.d.ts +77 -0
- package/dist/tools/common/snapshot.d.ts.map +1 -0
- package/dist/tools/common/snapshot.js +497 -0
- package/dist/tools/common/snapshot.js.map +1 -0
- package/dist/tools/common/status.js +27 -27
- package/dist/tools/common/toolgroups.d.ts.map +1 -1
- package/dist/tools/common/toolgroups.js +21 -5
- package/dist/tools/common/toolgroups.js.map +1 -1
- package/dist/tools/excel/data.d.ts +0 -5
- package/dist/tools/excel/data.d.ts.map +1 -1
- package/dist/tools/excel/data.js +19 -39
- package/dist/tools/excel/data.js.map +1 -1
- package/dist/tools/excel/format.d.ts.map +1 -1
- package/dist/tools/excel/format.js +3 -1
- package/dist/tools/excel/format.js.map +1 -1
- package/dist/tools/excel/formula.d.ts +0 -9
- package/dist/tools/excel/formula.d.ts.map +1 -1
- package/dist/tools/excel/formula.js +1 -18
- package/dist/tools/excel/formula.js.map +1 -1
- package/dist/tools/excel/index.d.ts +3 -3
- package/dist/tools/excel/index.d.ts.map +1 -1
- package/dist/tools/excel/index.js +4 -12
- package/dist/tools/excel/index.js.map +1 -1
- package/dist/tools/excel/sheet-gaps.d.ts +2 -2
- package/dist/tools/excel/sheet-gaps.js +2 -2
- package/dist/tools/excel/sheet.d.ts +0 -10
- package/dist/tools/excel/sheet.d.ts.map +1 -1
- package/dist/tools/excel/sheet.js +7 -117
- package/dist/tools/excel/sheet.js.map +1 -1
- package/dist/tools/excel/workbook.d.ts.map +1 -1
- package/dist/tools/excel/workbook.js +8 -3
- package/dist/tools/excel/workbook.js.map +1 -1
- package/dist/tools/ppt/animation.d.ts +15 -58
- package/dist/tools/ppt/animation.d.ts.map +1 -1
- package/dist/tools/ppt/animation.js +39 -568
- package/dist/tools/ppt/animation.js.map +1 -1
- package/dist/tools/ppt/background.d.ts +0 -18
- package/dist/tools/ppt/background.d.ts.map +1 -1
- package/dist/tools/ppt/background.js +43 -249
- package/dist/tools/ppt/background.js.map +1 -1
- package/dist/tools/ppt/beautify-advanced.d.ts +0 -6
- package/dist/tools/ppt/beautify-advanced.d.ts.map +1 -1
- package/dist/tools/ppt/beautify-advanced.js +13 -76
- package/dist/tools/ppt/beautify-advanced.js.map +1 -1
- package/dist/tools/ppt/data-viz.d.ts.map +1 -1
- package/dist/tools/ppt/data-viz.js +1 -1
- package/dist/tools/ppt/data-viz.js.map +1 -1
- package/dist/tools/ppt/image.d.ts.map +1 -1
- package/dist/tools/ppt/image.js +4 -9
- package/dist/tools/ppt/image.js.map +1 -1
- package/dist/tools/ppt/index.d.ts +5 -5
- package/dist/tools/ppt/index.d.ts.map +1 -1
- package/dist/tools/ppt/index.js +5 -35
- package/dist/tools/ppt/index.js.map +1 -1
- package/dist/tools/ppt/misc.d.ts +0 -6
- package/dist/tools/ppt/misc.d.ts.map +1 -1
- package/dist/tools/ppt/misc.js +14 -65
- package/dist/tools/ppt/misc.js.map +1 -1
- package/dist/tools/ppt/presentation.d.ts.map +1 -1
- package/dist/tools/ppt/presentation.js +25 -11
- package/dist/tools/ppt/presentation.js.map +1 -1
- package/dist/tools/ppt/slide-ops.d.ts +0 -6
- package/dist/tools/ppt/slide-ops.d.ts.map +1 -1
- package/dist/tools/ppt/slide-ops.js +418 -324
- package/dist/tools/ppt/slide-ops.js.map +1 -1
- package/dist/tools/ppt/slide.d.ts.map +1 -1
- package/dist/tools/ppt/slide.js +49 -35
- package/dist/tools/ppt/slide.js.map +1 -1
- package/dist/tools/ppt/table.d.ts.map +1 -1
- package/dist/tools/ppt/table.js +4 -2
- package/dist/tools/ppt/table.js.map +1 -1
- package/dist/tools/ppt/textbox.d.ts.map +1 -1
- package/dist/tools/ppt/textbox.js +4 -1
- package/dist/tools/ppt/textbox.js.map +1 -1
- package/dist/tools/word/academic.js +79 -79
- package/dist/tools/word/content.d.ts.map +1 -1
- package/dist/tools/word/content.js +9 -4
- package/dist/tools/word/content.js.map +1 -1
- package/dist/tools/word/document.d.ts +0 -5
- package/dist/tools/word/document.d.ts.map +1 -1
- package/dist/tools/word/document.js +1 -58
- package/dist/tools/word/document.js.map +1 -1
- package/dist/tools/word/gaps.d.ts +2 -2
- package/dist/tools/word/gaps.js +2 -2
- package/dist/tools/word/index.d.ts +1 -1
- package/dist/tools/word/index.d.ts.map +1 -1
- package/dist/tools/word/index.js +1 -3
- package/dist/tools/word/index.js.map +1 -1
- package/dist/types/tools.d.ts +12 -1
- package/dist/types/tools.d.ts.map +1 -1
- package/dist/types/tools.js.map +1 -1
- package/dist/utils/logger.d.ts.map +1 -1
- package/dist/utils/logger.js +17 -0
- package/dist/utils/logger.js.map +1 -1
- package/package.json +66 -59
- package/scripts/wps-com.ps1 +8255 -7260
- package/scripts/wps-comd.ps1 +123 -123
- package/skills/wps-multitool/SKILL.md +128 -110
- package/skills/wps-multitool/references/errors.md +61 -61
- package/skills/wps-multitool/references/recipes.md +82 -81
- package/skills/wps-multitool/references/routing.md +87 -87
- package/dist/client/mac-poll-server.d.ts +0 -77
- package/dist/client/mac-poll-server.d.ts.map +0 -1
- package/dist/client/mac-poll-server.js +0 -516
- package/dist/client/mac-poll-server.js.map +0 -1
package/scripts/wps-comd.ps1
CHANGED
|
@@ -1,123 +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
|
-
}
|
|
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
|
+
}
|
|
@@ -1,111 +1,129 @@
|
|
|
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
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
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 写入不是事务,没有撤销。现在有补偿手段了 ——
|
|
73
|
+
- `wps_common_snapshot_create`:存一份磁盘副本,返回路径
|
|
74
|
+
- `wps_common_batch` 检测到破坏性/非幂等步骤时会**自动**建,不用你操心
|
|
75
|
+
- 改坏了用 `wps_common_snapshot_restore`;默认写出`.restored-<时间>`副本(不覆盖),
|
|
76
|
+
要原地覆盖必须 `overwrite=true` + `confirm=true`,且**先关掉那个文档**(WPS 占着文件会 EBUSY)
|
|
77
|
+
- 两个诚实点必须转述给用户:从未保存过的文档建不了快照(会报 `[勿重试·先另存为]`);
|
|
78
|
+
有未保存改动时,快照是**磁盘版本**,不含屏幕上还没存的内容
|
|
79
|
+
|
|
80
|
+
## 三条红线
|
|
81
|
+
|
|
82
|
+
### 一、`勿重试` 的错误绝不原样重放
|
|
83
|
+
|
|
84
|
+
工具失败时返回的前缀已经写明了能不能重试:
|
|
85
|
+
|
|
86
|
+
| 前缀 | 含义 | 该做什么 |
|
|
87
|
+
|---|---|---|
|
|
88
|
+
| `[可重试·…]` | 请求**没执行** | 可以重放,退避一下 |
|
|
89
|
+
| `[勿重试·可能已执行一半]` | 可能已经改了一半 | **先查状态**(读回来看结果),不要重放 |
|
|
90
|
+
| `[勿重试·先改参数]` | 参数不对 | 改参数,不是重试 |
|
|
91
|
+
|
|
92
|
+
超时和 COM 错误都属第二类。盲目重放 = 同一段内容写两遍、样式叠三层。
|
|
93
|
+
|
|
94
|
+
### 二、破坏性工具要跟用户确认
|
|
95
|
+
|
|
96
|
+
`tools/list` 里每个工具都带 `annotations`,其中 `destructiveHint: true` 的那批
|
|
97
|
+
会删内容、丢未保存改动、或原地转换格式(删除类、另存为、格式转换、关闭文档)。
|
|
98
|
+
执行前先说一句,别默默干。
|
|
99
|
+
|
|
100
|
+
`readOnlyHint: true` 的那批不会动文档 —— 但也意味着它**根本没生效**,
|
|
101
|
+
如果结果不对,别重复调用同一条,先怀疑前置步骤(没加载组、文档没打开、路径不对)。
|
|
102
|
+
|
|
103
|
+
### 三、PPT 的结果要复核
|
|
104
|
+
|
|
105
|
+
`wps_search_tools` 的结果里有 `verified` 字段:`live` = 真机跑通过,`static` = 只有静态校验。**这个字段仍然要读**——
|
|
106
|
+
PPT 组里还有没逐条验证的,读它才知道哪个工具要额外复核。
|
|
107
|
+
|
|
108
|
+
PPT 组的真值(照 `scripts/manual/tool-verification.json` 的 `ppt` 条目,别凭印象说):
|
|
109
|
+
|
|
110
|
+
- 组级口径仍记 **`static`**:矩阵里仍有 5 条是**有据可查地跳过**的,不是漏跑;
|
|
111
|
+
- 但真机覆盖已经上量:PPT 组共 **100** 个工具,隔离验证矩阵 **103** 行(多出的行是旧名别名),
|
|
112
|
+
实际执行 **98** 条、**全部跑通**,跳过的 **5** 条各有实测原因;
|
|
113
|
+
- 另有 **18** 个 PPT 工具在台账里逐条记为 `live`。
|
|
114
|
+
|
|
115
|
+
所以**别说「PPT 没验证过」**,也**别说「PPT 全部验证过了」**——两句都不准确。
|
|
116
|
+
真话是:绝大多数 PPT 工具跑过真机并有断言,个别几条因 WPS 侧限制或需人工介入而有据跳过。
|
|
117
|
+
|
|
118
|
+
`static` 不是「不能用」,是「没人在真机上验证过这一条」。用它做完事,要如实告诉用户
|
|
119
|
+
「这个工具只做过静态校验」,别把「没报错」当成「做对了」。
|
|
120
|
+
|
|
121
|
+
## 参考文档
|
|
122
|
+
|
|
123
|
+
按需读,**不要一次全读**——它们加起来比本文还长。
|
|
124
|
+
|
|
125
|
+
| 文件 | 什么时候读 |
|
|
126
|
+
|---|---|
|
|
127
|
+
| `references/routing.md` | 意图定不准组、或两个工具不知道选哪个时 |
|
|
128
|
+
| `references/errors.md` | 调用报错、或要决定能不能重试时 |
|
|
111
129
|
| `references/recipes.md` | 任务跨多步(整篇论文排版、批量改格式、做演示)时 |
|
|
@@ -1,62 +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
|
-
|
|
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
62
|
也就是说:写入类操作发取消是无效的,别指望它能打断。
|