wps-multitool-mcp 1.0.1 → 1.0.3
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/cancellable.d.ts.map +1 -1
- package/dist/bridge/cancellable.js +4 -0
- package/dist/bridge/cancellable.js.map +1 -1
- package/dist/bridge/index.js +109 -18
- 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 +65 -0
- package/dist/cli/install.d.ts.map +1 -0
- package/dist/cli/install.js +399 -0
- package/dist/cli/install.js.map +1 -0
- 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 +10 -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 -4
- package/dist/client/wps-client.d.ts.map +1 -1
- package/dist/client/wps-client.js +139 -32
- package/dist/client/wps-client.js.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +57 -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/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.map +1 -1
- package/dist/server/mcp-server.js +8 -141
- package/dist/server/mcp-server.js.map +1 -1
- 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 +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 +31 -53
- package/dist/server/tool-annotations.generated.js.map +1 -1
- package/dist/server/tool-annotations.js +95 -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 +208 -42
- package/dist/server/tool-registry.js.map +1 -1
- package/dist/server/tool-tiers.d.ts +28 -8
- package/dist/server/tool-tiers.d.ts.map +1 -1
- package/dist/server/tool-tiers.js +35 -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 +79 -1
- 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 +28 -66
- 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/snapshot.d.ts +77 -0
- package/dist/tools/common/snapshot.d.ts.map +1 -0
- package/dist/tools/common/snapshot.js +500 -0
- package/dist/tools/common/snapshot.js.map +1 -0
- 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 +43 -46
- 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 +5 -5
- package/dist/tools/excel/formula.d.ts.map +1 -1
- package/dist/tools/excel/formula.js +65 -24
- 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 +37 -122
- 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 +11 -4
- 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 +101 -164
- package/dist/tools/ppt/beautify-advanced.js.map +1 -1
- package/dist/tools/ppt/chart-flow.d.ts.map +1 -1
- package/dist/tools/ppt/chart-flow.js +5 -0
- package/dist/tools/ppt/chart-flow.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 +110 -147
- 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 +30 -12
- 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 +4 -0
- package/dist/tools/ppt/shape-basic.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 +531 -437
- 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 +50 -36
- 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.d.ts.map +1 -1
- package/dist/tools/word/academic.js +14 -4
- 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 +107 -70
- 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 +121 -116
- 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 +2 -2
- package/dist/tools/word/gaps.d.ts.map +1 -1
- package/dist/tools/word/gaps.js +13 -7
- package/dist/tools/word/gaps.js.map +1 -1
- 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/tools/word/professional.d.ts.map +1 -1
- package/dist/tools/word/professional.js +123 -111
- 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/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 +48 -1
- package/dist/utils/logger.js.map +1 -1
- package/dist/version.js +1 -1
- package/package.json +23 -10
- package/scripts/wps-com.ps1 +1944 -337
- package/scripts/wps-comd.ps1 +162 -123
- package/skills/wps-multitool/SKILL.md +25 -6
- package/skills/wps-multitool/references/dsh.md +88 -0
- package/skills/wps-multitool/references/recipes.md +3 -2
- package/dist/client/mac-poll-server.d.ts +0 -77
- package/dist/client/mac-poll-server.js +0 -516
package/scripts/wps-comd.ps1
CHANGED
|
@@ -1,123 +1,162 @@
|
|
|
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
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
$
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
{
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
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
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
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
|
+
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
|
+
|
|
43
|
+
$ErrorActionPreference = 'Continue'
|
|
44
|
+
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
|
|
45
|
+
[Console]::InputEncoding = [System.Text.Encoding]::UTF8
|
|
46
|
+
|
|
47
|
+
$script:WpsReqId = $null
|
|
48
|
+
$parentPid = $null
|
|
49
|
+
|
|
50
|
+
# ==================== 父进程看门狗 ====================
|
|
51
|
+
# Add-Type 首次编译约 0.5~1 秒,相对 5 秒冷启动可以接受
|
|
52
|
+
try {
|
|
53
|
+
if (-not ([System.Management.Automation.PSTypeName]'WpsParentWatchdog').Type) {
|
|
54
|
+
Add-Type -TypeDefinition @'
|
|
55
|
+
using System;
|
|
56
|
+
using System.Diagnostics;
|
|
57
|
+
using System.Threading;
|
|
58
|
+
|
|
59
|
+
public static class WpsParentWatchdog
|
|
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
|
+
|
|
82
|
+
public static void Start(int parentPid)
|
|
83
|
+
{
|
|
84
|
+
var t = new Thread(() =>
|
|
85
|
+
{
|
|
86
|
+
while (true)
|
|
87
|
+
{
|
|
88
|
+
try
|
|
89
|
+
{
|
|
90
|
+
var p = Process.GetProcessById(parentPid);
|
|
91
|
+
if (p.HasExited) { break; }
|
|
92
|
+
}
|
|
93
|
+
catch
|
|
94
|
+
{
|
|
95
|
+
// 父进程没了(或 PID 已失效)—— 我们也该走
|
|
96
|
+
KillTracked();
|
|
97
|
+
Environment.Exit(0);
|
|
98
|
+
}
|
|
99
|
+
Thread.Sleep(2000);
|
|
100
|
+
}
|
|
101
|
+
KillTracked();
|
|
102
|
+
Environment.Exit(0);
|
|
103
|
+
});
|
|
104
|
+
t.IsBackground = true;
|
|
105
|
+
t.Name = "wps-parent-watchdog";
|
|
106
|
+
t.Start();
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
'@ -ErrorAction Stop
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
$parentPid = (Get-CimInstance Win32_Process -Filter "ProcessId=$PID" -ErrorAction SilentlyContinue).ParentProcessId
|
|
113
|
+
if ($parentPid) {
|
|
114
|
+
[WpsParentWatchdog]::Start([int]$parentPid)
|
|
115
|
+
}
|
|
116
|
+
} catch {
|
|
117
|
+
# 看门狗起不来不能拖垮主流程:只是失去一层保护,照常工作
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
# ==================== 加载动作库 ====================
|
|
121
|
+
# 置位后再 dot-source,让 wps-com.ps1 只定义函数、不执行动作
|
|
122
|
+
$env:WPS_COM_DAEMON = '1'
|
|
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
|
|
127
|
+
|
|
128
|
+
# 就绪握手:Node 侧据此确认守护进程起来了(而不是白等到超时)
|
|
129
|
+
Output-Json @{ success = $true; data = @{ ready = $true; pid = $PID; daemon = 'wps-comd'; parent = $parentPid } }
|
|
130
|
+
|
|
131
|
+
while ($true) {
|
|
132
|
+
$line = [Console]::In.ReadLine()
|
|
133
|
+
if ($null -eq $line) { break } # stdin 关闭 → 退出
|
|
134
|
+
$line = $line.Trim()
|
|
135
|
+
if (-not $line) { continue }
|
|
136
|
+
|
|
137
|
+
$id = $null
|
|
138
|
+
try {
|
|
139
|
+
$req = $line | ConvertFrom-Json
|
|
140
|
+
if ($req.id) { $id = [string]$req.id }
|
|
141
|
+
$script:WpsReqId = $id
|
|
142
|
+
|
|
143
|
+
$act = [string]$req.action
|
|
144
|
+
if (-not $act) { throw '请求缺少 action' }
|
|
145
|
+
|
|
146
|
+
# $req.params 为 $null 时给空表;动作内部统一按 $p.xxx 取值
|
|
147
|
+
$par = if ($null -ne $req.params) { $req.params } else { @{} }
|
|
148
|
+
|
|
149
|
+
Invoke-WpsAction -Action $act -p $par
|
|
150
|
+
} catch {
|
|
151
|
+
# 分发层异常兜底:绝不能把异常抛给宿主,否则整个守护进程会随之下线
|
|
152
|
+
$script:WpsReqId = $id
|
|
153
|
+
Output-Json @{ success = $false; error = "daemon: $($_.Exception.Message)" }
|
|
154
|
+
} finally {
|
|
155
|
+
$script:WpsReqId = $null
|
|
156
|
+
}
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
# stdin EOF(桥正常收摊):回收本进程自己创建过的 WPS 实例(含沙箱)。
|
|
160
|
+
# 只动自己的记账 PID,绝不碰用户 ROT 附着的实例。
|
|
161
|
+
try { Remove-OwnCreatedProcs | Out-Null } catch {}
|
|
162
|
+
try { Remove-OwnSandboxProcs | Out-Null } catch {}
|
|
@@ -5,7 +5,7 @@ license: MIT
|
|
|
5
5
|
compatibility: Windows + WPS Office 12.x;需要 wps-multitool MCP 的常驻桥进程在运行
|
|
6
6
|
metadata:
|
|
7
7
|
author: 赢容
|
|
8
|
-
version: "1.0.
|
|
8
|
+
version: "1.0.3"
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
# 操作 WPS 的正确链路
|
|
@@ -69,8 +69,13 @@ MCP 提供了近 300 个工具(以 `tools/list` 与 `wps_search_tools` 为准
|
|
|
69
69
|
|
|
70
70
|
1. **锁定目标**:用户可能开着多个文档。用切换文档类工具把目标钉死,
|
|
71
71
|
否则切一次窗口就写到别的文件里去了。
|
|
72
|
-
2. **建快照**:COM
|
|
73
|
-
|
|
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
|
+
有未保存改动时,快照是**磁盘版本**,不含屏幕上还没存的内容
|
|
74
79
|
|
|
75
80
|
## 三条红线
|
|
76
81
|
|
|
@@ -97,8 +102,21 @@ MCP 提供了近 300 个工具(以 `tools/list` 与 `wps_search_tools` 为准
|
|
|
97
102
|
|
|
98
103
|
### 三、PPT 的结果要复核
|
|
99
104
|
|
|
100
|
-
|
|
101
|
-
|
|
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
|
+
「这个工具只做过静态校验」,别把「没报错」当成「做对了」。
|
|
102
120
|
|
|
103
121
|
## 参考文档
|
|
104
122
|
|
|
@@ -108,4 +126,5 @@ PPT 相关的工具没有真机覆盖验证过。改完之后如实告诉用户"
|
|
|
108
126
|
|---|---|
|
|
109
127
|
| `references/routing.md` | 意图定不准组、或两个工具不知道选哪个时 |
|
|
110
128
|
| `references/errors.md` | 调用报错、或要决定能不能重试时 |
|
|
111
|
-
| `references/recipes.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 会把工具定义塞进**每一次请求**,全量 284 个很贵。保持默认档,别在 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 秒上限;看是不是发了个导出类大动作 |
|
|
@@ -65,8 +65,9 @@
|
|
|
65
65
|
```
|
|
66
66
|
|
|
67
67
|
坑:
|
|
68
|
-
- **PPT
|
|
69
|
-
|
|
68
|
+
- **PPT 组个别工具只有静态校验**(组级台账记 `static`:矩阵里 5 条有据跳过)。
|
|
69
|
+
每一步做完都要读回来看,并按 `wps_search_tools` 返回的 `verified` 字段如实告诉用户
|
|
70
|
+
「这个工具只做过静态校验」——别笼统说「PPT 没验证过」,那是错的;也别因为它跑通了就当全部都验过。
|
|
70
71
|
- 母版和单页样式冲突时,母版优先;逐页设的背景会被母版覆盖
|
|
71
72
|
- 加动画前先想清楚会不会让阅读变慢,不是每个元素都该动
|
|
72
73
|
|
|
@@ -1,77 +0,0 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* Input: WPS 指令与HTTP请求
|
|
3
|
-
* Output: 轮询执行结果(含 Issue #17 已连接检测,避免 pkill 杀死已运行 WPS)
|
|
4
|
-
* Pos: macOS/Linux 轮询服务器实现,MCP Server 与 WPS 加载项之间的桥梁
|
|
5
|
-
* 一旦我被修改,请更新我的头部注释,以及所属文件夹的md。
|
|
6
|
-
* Mac轮询服务器 - 老王出品
|
|
7
|
-
*
|
|
8
|
-
* 丢,WPS Mac加载项在沙箱里启动不了HTTP服务器,只能反过来:
|
|
9
|
-
* - MCP Server 作为HTTP服务端(端口58891)
|
|
10
|
-
* - WPS加载项 作为HTTP客户端轮询获取命令
|
|
11
|
-
*
|
|
12
|
-
* 这SB架构虽然绕,但确实能跑通!
|
|
13
|
-
*/
|
|
14
|
-
/**
|
|
15
|
-
* Mac轮询服务器类
|
|
16
|
-
* 处理WPS加载项的轮询请求,实现命令的发送和结果接收
|
|
17
|
-
*/
|
|
18
|
-
declare class MacPollServer {
|
|
19
|
-
private server;
|
|
20
|
-
private pendingCommand;
|
|
21
|
-
private currentApp;
|
|
22
|
-
private _isRunning;
|
|
23
|
-
private port;
|
|
24
|
-
/** Issue #17: 记录最近一次 WPS 加载项 poll 请求的时间戳,用于判断加载项是否已连接 */
|
|
25
|
-
private lastPollTime;
|
|
26
|
-
get isRunning(): boolean;
|
|
27
|
-
/**
|
|
28
|
-
* 启动轮询服务器
|
|
29
|
-
* 丢,这个服务器要处理三种请求:
|
|
30
|
-
* 1. GET /poll - WPS加载项来轮询获取命令
|
|
31
|
-
* 2. POST /result - WPS加载项返回执行结果
|
|
32
|
-
* 3. OPTIONS - 该死的CORS预检请求
|
|
33
|
-
*/
|
|
34
|
-
start(listenPort?: number): Promise<void>;
|
|
35
|
-
/**
|
|
36
|
-
* 处理轮询请求
|
|
37
|
-
* WPS加载项每500ms来问一次:有活干不?
|
|
38
|
-
*/
|
|
39
|
-
private handlePoll;
|
|
40
|
-
/**
|
|
41
|
-
* 处理结果返回
|
|
42
|
-
* WPS加载项执行完命令后把结果POST回来
|
|
43
|
-
*/
|
|
44
|
-
private handleResult;
|
|
45
|
-
/**
|
|
46
|
-
* 执行WPS命令
|
|
47
|
-
* 这是对外的主要接口,调用后会:
|
|
48
|
-
* 1. 检查是否需要切换应用
|
|
49
|
-
* 2. 把命令放到队列里等WPS加载项来取
|
|
50
|
-
* 3. 等待结果返回
|
|
51
|
-
*/
|
|
52
|
-
executeCommand(action: string, params?: Record<string, unknown>, timeout?: number): Promise<unknown>;
|
|
53
|
-
/**
|
|
54
|
-
* 根据命令获取需要的应用类型
|
|
55
|
-
*/
|
|
56
|
-
private getRequiredApp;
|
|
57
|
-
/**
|
|
58
|
-
* 切换WPS应用
|
|
59
|
-
* 调用wps-auto.sh脚本自动关闭当前应用并启动目标应用
|
|
60
|
-
*/
|
|
61
|
-
private switchApp;
|
|
62
|
-
/**
|
|
63
|
-
* 停止服务器
|
|
64
|
-
*/
|
|
65
|
-
stop(): void;
|
|
66
|
-
/**
|
|
67
|
-
* 获取当前连接的应用类型
|
|
68
|
-
*/
|
|
69
|
-
getCurrentApp(): string;
|
|
70
|
-
/**
|
|
71
|
-
* 设置当前应用(用于外部更新状态)
|
|
72
|
-
*/
|
|
73
|
-
setCurrentApp(app: string): void;
|
|
74
|
-
}
|
|
75
|
-
export declare const macPollServer: MacPollServer;
|
|
76
|
-
export default MacPollServer;
|
|
77
|
-
//# sourceMappingURL=mac-poll-server.d.ts.map
|