wps-multitool-mcp 1.0.2 → 1.0.4
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/README.md +2 -2
- package/dist/bridge/cancellable.d.ts.map +1 -1
- package/dist/bridge/cancellable.js +6 -0
- package/dist/bridge/cancellable.js.map +1 -1
- package/dist/bridge/index.js +105 -16
- package/dist/bridge/index.js.map +1 -1
- package/dist/bridge/ps-child.d.ts +27 -1
- package/dist/bridge/ps-child.d.ts.map +1 -1
- package/dist/bridge/ps-child.js +137 -3
- package/dist/bridge/ps-child.js.map +1 -1
- package/dist/cli/install.d.ts +7 -0
- package/dist/cli/install.d.ts.map +1 -1
- package/dist/cli/install.js +98 -0
- package/dist/cli/install.js.map +1 -1
- package/dist/client/action-routes.generated.d.ts +3 -2
- package/dist/client/action-routes.generated.d.ts.map +1 -1
- package/dist/client/action-routes.generated.js +11 -12
- package/dist/client/action-routes.generated.js.map +1 -1
- package/dist/client/addon-channel.d.ts +104 -0
- package/dist/client/addon-channel.d.ts.map +1 -0
- package/dist/client/addon-channel.js +491 -0
- package/dist/client/addon-channel.js.map +1 -0
- package/dist/client/ps-daemon.d.ts +1 -0
- package/dist/client/ps-daemon.d.ts.map +1 -1
- package/dist/client/ps-daemon.js +8 -4
- package/dist/client/ps-daemon.js.map +1 -1
- package/dist/client/wps-client.d.ts +3 -1
- package/dist/client/wps-client.d.ts.map +1 -1
- package/dist/client/wps-client.js +82 -9
- package/dist/client/wps-client.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/server/auto-snapshot.d.ts.map +1 -1
- package/dist/server/auto-snapshot.js +8 -1
- package/dist/server/auto-snapshot.js.map +1 -1
- package/dist/server/backend-selector.d.ts +51 -0
- package/dist/server/backend-selector.d.ts.map +1 -0
- package/dist/server/backend-selector.js +104 -0
- package/dist/server/backend-selector.js.map +1 -0
- package/dist/server/mcp-server.d.ts +9 -0
- package/dist/server/mcp-server.d.ts.map +1 -1
- package/dist/server/mcp-server.js +152 -1
- package/dist/server/mcp-server.js.map +1 -1
- package/dist/server/progress-context.d.ts +6 -0
- package/dist/server/progress-context.d.ts.map +1 -0
- package/dist/server/progress-context.js +35 -0
- package/dist/server/progress-context.js.map +1 -0
- package/dist/server/target-context.d.ts +32 -0
- package/dist/server/target-context.d.ts.map +1 -0
- package/dist/server/target-context.js +47 -0
- package/dist/server/target-context.js.map +1 -0
- package/dist/server/tool-aliases.generated.d.ts +1 -1
- package/dist/server/tool-aliases.generated.d.ts.map +1 -1
- package/dist/server/tool-aliases.generated.js +2 -1
- package/dist/server/tool-aliases.generated.js.map +1 -1
- 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 +13 -9
- package/dist/server/tool-annotations.generated.js.map +1 -1
- package/dist/server/tool-annotations.js +29 -8
- package/dist/server/tool-annotations.js.map +1 -1
- package/dist/server/tool-metadata.d.ts.map +1 -1
- package/dist/server/tool-metadata.js +8 -0
- package/dist/server/tool-metadata.js.map +1 -1
- package/dist/server/tool-registry.d.ts.map +1 -1
- package/dist/server/tool-registry.js +5 -1
- package/dist/server/tool-registry.js.map +1 -1
- package/dist/server/tool-tiers.d.ts +4 -3
- package/dist/server/tool-tiers.d.ts.map +1 -1
- package/dist/server/tool-tiers.js +4 -3
- package/dist/server/tool-tiers.js.map +1 -1
- package/dist/server/tool-verification.d.ts +6 -6
- package/dist/server/tool-verification.generated.d.ts +4 -4
- package/dist/server/tool-verification.generated.d.ts.map +1 -1
- package/dist/server/tool-verification.generated.js +81 -77
- package/dist/server/tool-verification.generated.js.map +1 -1
- package/dist/server/tool-verification.js +3 -3
- package/dist/tools/common/batch.d.ts.map +1 -1
- package/dist/tools/common/batch.js +23 -18
- package/dist/tools/common/batch.js.map +1 -1
- package/dist/tools/common/convert.js +34 -34
- package/dist/tools/common/general.d.ts.map +1 -1
- package/dist/tools/common/general.js +89 -83
- package/dist/tools/common/general.js.map +1 -1
- package/dist/tools/common/intent.d.ts +34 -0
- package/dist/tools/common/intent.d.ts.map +1 -1
- package/dist/tools/common/intent.js +199 -19
- package/dist/tools/common/intent.js.map +1 -1
- package/dist/tools/common/repair.js +18 -18
- package/dist/tools/common/snapshot.d.ts.map +1 -1
- package/dist/tools/common/snapshot.js +22 -19
- package/dist/tools/common/snapshot.js.map +1 -1
- package/dist/tools/common/status.js +27 -27
- package/dist/tools/common/toolgroups.js +36 -36
- package/dist/tools/excel/chart.d.ts.map +1 -1
- package/dist/tools/excel/chart.js +87 -80
- package/dist/tools/excel/chart.js.map +1 -1
- package/dist/tools/excel/data.d.ts.map +1 -1
- package/dist/tools/excel/data.js +38 -21
- package/dist/tools/excel/data.js.map +1 -1
- package/dist/tools/excel/format.js +9 -9
- package/dist/tools/excel/formula.d.ts +9 -0
- package/dist/tools/excel/formula.d.ts.map +1 -1
- package/dist/tools/excel/formula.js +110 -52
- package/dist/tools/excel/formula.js.map +1 -1
- package/dist/tools/excel/pivot.js +34 -34
- package/dist/tools/excel/sheet.d.ts +4 -0
- package/dist/tools/excel/sheet.d.ts.map +1 -1
- package/dist/tools/excel/sheet.js +133 -6
- 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 +3 -1
- package/dist/tools/excel/workbook.js.map +1 -1
- package/dist/tools/ppt/animation.js +11 -11
- package/dist/tools/ppt/background.d.ts.map +1 -1
- package/dist/tools/ppt/background.js.map +1 -1
- package/dist/tools/ppt/beautify-advanced.js +88 -88
- package/dist/tools/ppt/chart-flow.d.ts.map +1 -1
- package/dist/tools/ppt/chart-flow.js +72 -67
- package/dist/tools/ppt/chart-flow.js.map +1 -1
- package/dist/tools/ppt/data-viz.js +49 -49
- package/dist/tools/ppt/deckkit.d.ts +150 -0
- package/dist/tools/ppt/deckkit.d.ts.map +1 -0
- package/dist/tools/ppt/deckkit.js +396 -0
- package/dist/tools/ppt/deckkit.js.map +1 -0
- package/dist/tools/ppt/image.d.ts.map +1 -1
- package/dist/tools/ppt/image.js +50 -46
- package/dist/tools/ppt/image.js.map +1 -1
- package/dist/tools/ppt/index.d.ts +2 -0
- package/dist/tools/ppt/index.d.ts.map +1 -1
- package/dist/tools/ppt/index.js +10 -5
- package/dist/tools/ppt/index.js.map +1 -1
- package/dist/tools/ppt/misc.d.ts.map +1 -1
- package/dist/tools/ppt/misc.js +96 -82
- 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 +70 -66
- package/dist/tools/ppt/presentation.js.map +1 -1
- package/dist/tools/ppt/shape-basic.d.ts.map +1 -1
- package/dist/tools/ppt/shape-basic.js +78 -74
- package/dist/tools/ppt/shape-basic.js.map +1 -1
- package/dist/tools/ppt/slide-ops.js +159 -159
- package/dist/tools/ppt/slide-ops.js.map +1 -1
- package/dist/tools/ppt/slide.js +47 -47
- package/dist/tools/ppt/slide.js.map +1 -1
- package/dist/tools/ppt/table.js +64 -64
- package/dist/tools/word/academic.d.ts.map +1 -1
- package/dist/tools/word/academic.js +93 -83
- package/dist/tools/word/academic.js.map +1 -1
- package/dist/tools/word/content.d.ts.map +1 -1
- package/dist/tools/word/content.js +98 -66
- package/dist/tools/word/content.js.map +1 -1
- package/dist/tools/word/document.d.ts.map +1 -1
- package/dist/tools/word/document.js +120 -58
- package/dist/tools/word/document.js.map +1 -1
- package/dist/tools/word/format.d.ts.map +1 -1
- package/dist/tools/word/format.js +41 -35
- package/dist/tools/word/format.js.map +1 -1
- package/dist/tools/word/gaps.d.ts.map +1 -1
- package/dist/tools/word/gaps.js +11 -5
- package/dist/tools/word/gaps.js.map +1 -1
- package/dist/tools/word/professional.d.ts +4 -0
- package/dist/tools/word/professional.d.ts.map +1 -1
- package/dist/tools/word/professional.js +198 -112
- package/dist/tools/word/professional.js.map +1 -1
- package/dist/tools/word/proofread.d.ts.map +1 -1
- package/dist/tools/word/proofread.js +42 -38
- package/dist/tools/word/proofread.js.map +1 -1
- package/dist/tools/word/target.d.ts +74 -0
- package/dist/tools/word/target.d.ts.map +1 -0
- package/dist/tools/word/target.js +130 -0
- package/dist/tools/word/target.js.map +1 -0
- package/dist/utils/image-inline.d.ts +3 -0
- package/dist/utils/image-inline.d.ts.map +1 -0
- package/dist/utils/image-inline.js +61 -0
- package/dist/utils/image-inline.js.map +1 -0
- package/dist/utils/logger.d.ts.map +1 -1
- package/dist/utils/logger.js +31 -1
- package/dist/utils/logger.js.map +1 -1
- package/dist/version.js +1 -1
- package/package.json +72 -66
- package/scripts/wps-com.ps1 +9260 -8255
- package/scripts/wps-comd.ps1 +40 -1
- package/skills/wps-multitool/SKILL.md +130 -129
- package/skills/wps-multitool/references/dsh.md +88 -0
- package/skills/wps-multitool/references/errors.md +61 -61
- package/skills/wps-multitool/references/recipes.md +82 -82
- package/skills/wps-multitool/references/routing.md +87 -87
package/scripts/wps-comd.ps1
CHANGED
|
@@ -32,6 +32,14 @@
|
|
|
32
32
|
# PowerShell 的 Register-ObjectEvent / 定时器事件根本不会被泵到。
|
|
33
33
|
# 看门狗只做一件事:父进程没了就 Environment.Exit(0)。
|
|
34
34
|
|
|
35
|
+
param(
|
|
36
|
+
# 第 1 期第 3 章轮 1:实例标识。user = 用户的 WPS;sandbox-N = 本进程自己开的隔离实例。
|
|
37
|
+
# 这不是"每次请求"的参数,是【进程级】的:一个守护进程只服务一个实例。
|
|
38
|
+
[string]$Instance = 'user',
|
|
39
|
+
# 本进程负责哪个应用(word / excel / ppt / common),供 wps-com.ps1 判"要不要做文档寻址前置检查"
|
|
40
|
+
[string]$App = ''
|
|
41
|
+
)
|
|
42
|
+
|
|
35
43
|
$ErrorActionPreference = 'Continue'
|
|
36
44
|
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
37
45
|
[Console]::InputEncoding = [System.Text.Encoding]::UTF8
|
|
@@ -50,6 +58,27 @@ using System.Threading;
|
|
|
50
58
|
|
|
51
59
|
public static class WpsParentWatchdog
|
|
52
60
|
{
|
|
61
|
+
// 本守护进程自己创建过的 WPS 实例 PID(PS 侧经 Track 记账)。
|
|
62
|
+
// 进程退出前按 PID 收掉 —— 任务结束或异常终止都不留自建的 WPS 残留。
|
|
63
|
+
static readonly System.Collections.Generic.List<int> Tracked = new System.Collections.Generic.List<int>();
|
|
64
|
+
|
|
65
|
+
public static void Track(int pid)
|
|
66
|
+
{
|
|
67
|
+
lock (Tracked) { if (!Tracked.Contains(pid)) { Tracked.Add(pid); } }
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
static void KillTracked()
|
|
71
|
+
{
|
|
72
|
+
lock (Tracked)
|
|
73
|
+
{
|
|
74
|
+
foreach (int pid in Tracked)
|
|
75
|
+
{
|
|
76
|
+
try { Process.GetProcessById(pid).Kill(); } catch { }
|
|
77
|
+
}
|
|
78
|
+
Tracked.Clear();
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
|
|
53
82
|
public static void Start(int parentPid)
|
|
54
83
|
{
|
|
55
84
|
var t = new Thread(() =>
|
|
@@ -64,10 +93,12 @@ public static class WpsParentWatchdog
|
|
|
64
93
|
catch
|
|
65
94
|
{
|
|
66
95
|
// 父进程没了(或 PID 已失效)—— 我们也该走
|
|
96
|
+
KillTracked();
|
|
67
97
|
Environment.Exit(0);
|
|
68
98
|
}
|
|
69
99
|
Thread.Sleep(2000);
|
|
70
100
|
}
|
|
101
|
+
KillTracked();
|
|
71
102
|
Environment.Exit(0);
|
|
72
103
|
});
|
|
73
104
|
t.IsBackground = true;
|
|
@@ -89,7 +120,10 @@ public static class WpsParentWatchdog
|
|
|
89
120
|
# ==================== 加载动作库 ====================
|
|
90
121
|
# 置位后再 dot-source,让 wps-com.ps1 只定义函数、不执行动作
|
|
91
122
|
$env:WPS_COM_DAEMON = '1'
|
|
92
|
-
|
|
123
|
+
# 必须【带参数】dot-source:wps-com.ps1 自己也有 param 块,
|
|
124
|
+
# 裸 dot-source 会把它的默认值(user / 空 App)覆盖进来,于是沙箱进程被当成 user,
|
|
125
|
+
# 第一个动作就落到用户的文档上 —— 而且不报错,极难发现。
|
|
126
|
+
. (Join-Path $PSScriptRoot 'wps-com.ps1') -Instance $Instance -App $App
|
|
93
127
|
|
|
94
128
|
# 就绪握手:Node 侧据此确认守护进程起来了(而不是白等到超时)
|
|
95
129
|
Output-Json @{ success = $true; data = @{ ready = $true; pid = $PID; daemon = 'wps-comd'; parent = $parentPid } }
|
|
@@ -121,3 +155,8 @@ while ($true) {
|
|
|
121
155
|
$script:WpsReqId = $null
|
|
122
156
|
}
|
|
123
157
|
}
|
|
158
|
+
|
|
159
|
+
# stdin EOF(桥正常收摊):回收本进程自己创建过的 WPS 实例(含沙箱)。
|
|
160
|
+
# 只动自己的记账 PID,绝不碰用户 ROT 附着的实例。
|
|
161
|
+
try { Remove-OwnCreatedProcs | Out-Null } catch {}
|
|
162
|
+
try { Remove-OwnSandboxProcs | Out-Null } catch {}
|
|
@@ -1,129 +1,130 @@
|
|
|
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.
|
|
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 组共 **
|
|
112
|
-
实际执行 **98** 条、**全部跑通**,跳过的 **5** 条各有实测原因;
|
|
113
|
-
- 另有 **
|
|
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` | 调用报错、或要决定能不能重试时 |
|
|
129
|
-
| `references/recipes.md` | 任务跨多步(整篇论文排版、批量改格式、做演示)时 |
|
|
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.4"
|
|
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 组共 **101** 个工具(含 1 个内置),隔离验证矩阵 **103** 行(多出的行是旧名别名),
|
|
112
|
+
实际执行 **98** 条、**全部跑通**,跳过的 **5** 条各有实测原因;
|
|
113
|
+
- 另有 **91** 个 PPT 工具在台账里逐条记为 `live`(2026-10-27 live 还债轮:隔离矩阵执行通过名单 ∩ 现注册表 + 4 个新工具真机证据)。
|
|
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` | 调用报错、或要决定能不能重试时 |
|
|
129
|
+
| `references/recipes.md` | 任务跨多步(整篇论文排版、批量改格式、做演示)时 |
|
|
130
|
+
| `references/dsh.md` | **在 DeepSeek Harness 里跑的时候**(挂载写法、DSH 特有的坑、平台限制) |
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
# 在 DeepSeek Harness(DSH)里用本 MCP
|
|
2
|
+
|
|
3
|
+
> 什么时候读:**你正在 DSH 里跑**,或者用户说"用 DSH / Harness 调 WPS"。
|
|
4
|
+
> 在别的客户端(Claude Code / Cursor / CodeBuddy / WorkBuddy / Codex)里**不用读这篇**。
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 1. 怎么挂上去
|
|
9
|
+
|
|
10
|
+
**挂官方插件,不要挂我们的 bundle。**
|
|
11
|
+
|
|
12
|
+
bundle(`dsh-bundle/`)那份代码在真宿主里必然失败:它要 `import('@deepseek-ai/dsh-mcp-client')`,
|
|
13
|
+
而那个包只在 DSH 自己的 `app.asar` 内部、只对 DSH 的代码可见。
|
|
14
|
+
**从 bundle 目录永远解析不到它** —— 这不是路径没配对,是解析边界。
|
|
15
|
+
|
|
16
|
+
正确做法是在 patch 层直接挂官方插件:
|
|
17
|
+
|
|
18
|
+
```yaml
|
|
19
|
+
- insert:
|
|
20
|
+
- id: mcp-wps
|
|
21
|
+
name: '@deepseek-ai/dsh-mcp-client'
|
|
22
|
+
config:
|
|
23
|
+
serverName: wps
|
|
24
|
+
transport: stdio
|
|
25
|
+
command: node
|
|
26
|
+
args:
|
|
27
|
+
- C:\绝对路径\wps-multitool-mcp\dist\index.js
|
|
28
|
+
toolCallTimeoutMs: 130000
|
|
29
|
+
failOnStartupError: true
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
生成这段配置:`node dist/index.js install --client dsh`(会写 `~/.dsh/wps.cordis.yml`)。
|
|
33
|
+
|
|
34
|
+
**三个字段每一个都有理由,别随手改**:
|
|
35
|
+
|
|
36
|
+
| 字段 | 为什么必须是它 |
|
|
37
|
+
|---|---|
|
|
38
|
+
| `command: node` + **绝对路径** | DSH 的 args 直接透传、不过 shell。Windows 上 `npx` 实际是 `npx.cmd`,按 `npx` 去 spawn 会 ENOENT |
|
|
39
|
+
| `toolCallTimeoutMs: 130000` | 必须 **≥ 桥的 `WPS_DAEMON_TIMEOUT`(默认 120000)**。DSH 默认 60000 会先掐断 —— 而 WPS 那边动作**已经改完了**,症状是"客户端报失败、文档其实改了" |
|
|
40
|
+
| `failOnStartupError: true` | 默认 `false` 会在连不上时**静默降级成"零工具"**,用户只会觉得"AI 不会用 WPS" |
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## 2. DSH 特有的两个坑
|
|
45
|
+
|
|
46
|
+
### 2.1 `desktop` profile 被 Electron 独占
|
|
47
|
+
|
|
48
|
+
CLI 只能用 `--profile web`,或者自己新建一个 profile。
|
|
49
|
+
用 `desktop` 跑 CLI 会起不来(Electron 已经占着它)。
|
|
50
|
+
|
|
51
|
+
### 2.2 装完必须清干净
|
|
52
|
+
|
|
53
|
+
测完记得 `dsh plugin --profile web remove dsh-wps`,
|
|
54
|
+
并确认 `dsh --profile web --dump-config` 里已经没有 `dsh-wps` 那一层。
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 3. 平台限制(这几条对 DSH 用户同样成立)
|
|
59
|
+
|
|
60
|
+
| 限制 | 说明 |
|
|
61
|
+
|---|---|
|
|
62
|
+
| **Windows only** | WPS 的 COM 自动化只在 Windows 可用。DSH 跑在别的系统上就没有这条通道 |
|
|
63
|
+
| **默认档 40 个工具** | DSH 会把工具定义塞进**每一次请求**,全量工具很贵。保持默认档,别在 DSH 里改成全量 |
|
|
64
|
+
| **超时上限 120 秒** | 那是**单次动作的上限**,不是常态耗时。正常一次调用 2~3 毫秒 |
|
|
65
|
+
| **Linux 通道还没有** | 本项目的跨平台路线尚未落地,DSH 在 Linux 上同样没有 |
|
|
66
|
+
|
|
67
|
+
---
|
|
68
|
+
|
|
69
|
+
## 4. 一条要提醒的读回限制
|
|
70
|
+
|
|
71
|
+
`wps_word_get_open_documents` / `wps_excel_get_open_workbooks` 在
|
|
72
|
+
**刚执行过 `quit` / `close` 之后**可能短暂读到 0 份 —— 那是 WPS 重新注册到 ROT 的那几秒窗口,
|
|
73
|
+
**文档其实还在**。所以:
|
|
74
|
+
|
|
75
|
+
- 读到 0 份时,**别据此告诉用户"文档没了"**;
|
|
76
|
+
- 隔一会儿再读一次,或**按文档名直接读内容**核实(那个更硬);
|
|
77
|
+
- 工具返回里带 warnings 时,**把 warnings 念给用户听**。
|
|
78
|
+
|
|
79
|
+
---
|
|
80
|
+
|
|
81
|
+
## 5. 出问题先看哪
|
|
82
|
+
|
|
83
|
+
| 症状 | 先查 |
|
|
84
|
+
|---|---|
|
|
85
|
+
| DSH 里一个 WPS 工具都没有 | `--dump-config` 里有没有 `dsh-wps` 那层;`failOnStartupError` 是不是 true |
|
|
86
|
+
| 报"文档其实改了但客户端说失败" | `toolCallTimeoutMs` 是不是小于 130000 |
|
|
87
|
+
| 工具列表为空但 CLI 手动跑正常 | 是不是在 `desktop` profile 上跑的 CLI |
|
|
88
|
+
| 桥进程正常但调用超时 | 单次动作 120 秒上限;看是不是发了个导出类大动作 |
|
|
@@ -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
|
也就是说:写入类操作发取消是无效的,别指望它能打断。
|