@pyrokine/mcp-chrome 2.4.1 → 3.0.0
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 +546 -192
- package/README_zh.md +490 -192
- package/dist/anti-detection/behavior.js +1 -1
- package/dist/anti-detection/behavior.js.map +1 -1
- package/dist/anti-detection/injection.d.ts.map +1 -1
- package/dist/anti-detection/injection.js +5 -4
- package/dist/anti-detection/injection.js.map +1 -1
- package/dist/cdp/client.d.ts +2 -2
- package/dist/cdp/client.d.ts.map +1 -1
- package/dist/cdp/client.js +24 -10
- package/dist/cdp/client.js.map +1 -1
- package/dist/cdp/launcher.d.ts +2 -3
- package/dist/cdp/launcher.d.ts.map +1 -1
- package/dist/cdp/launcher.js +84 -24
- package/dist/cdp/launcher.js.map +1 -1
- package/dist/core/auto-wait.d.ts +3 -3
- package/dist/core/auto-wait.d.ts.map +1 -1
- package/dist/core/auto-wait.js +45 -20
- package/dist/core/auto-wait.js.map +1 -1
- package/dist/core/browser-driver.d.ts +104 -14
- package/dist/core/browser-driver.d.ts.map +1 -1
- package/dist/core/browser-driver.js +1 -0
- package/dist/core/browser-driver.js.map +1 -1
- package/dist/core/errors.d.ts +25 -0
- package/dist/core/errors.d.ts.map +1 -1
- package/dist/core/errors.js +93 -1
- package/dist/core/errors.js.map +1 -1
- package/dist/core/locator.d.ts.map +1 -1
- package/dist/core/locator.js +6 -4
- package/dist/core/locator.js.map +1 -1
- package/dist/core/os-mouse.d.ts +78 -0
- package/dist/core/os-mouse.d.ts.map +1 -0
- package/dist/core/os-mouse.js +378 -0
- package/dist/core/os-mouse.js.map +1 -0
- package/dist/core/session.d.ts +46 -21
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +724 -175
- package/dist/core/session.js.map +1 -1
- package/dist/core/types.d.ts +12 -0
- package/dist/core/types.d.ts.map +1 -1
- package/dist/core/types.js +2 -0
- package/dist/core/types.js.map +1 -1
- package/dist/core/unified-session.d.ts +117 -21
- package/dist/core/unified-session.d.ts.map +1 -1
- package/dist/core/unified-session.js +619 -129
- package/dist/core/unified-session.js.map +1 -1
- package/dist/core/utils.d.ts +5 -0
- package/dist/core/utils.d.ts.map +1 -1
- package/dist/core/utils.js +475 -54
- package/dist/core/utils.js.map +1 -1
- package/dist/extension/bridge.d.ts +61 -35
- package/dist/extension/bridge.d.ts.map +1 -1
- package/dist/extension/bridge.js +290 -106
- package/dist/extension/bridge.js.map +1 -1
- package/dist/extension/http-server.d.ts +3 -0
- package/dist/extension/http-server.d.ts.map +1 -1
- package/dist/extension/http-server.js +25 -3
- package/dist/extension/http-server.js.map +1 -1
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -1
- package/dist/tools/browse.d.ts +1 -1
- package/dist/tools/browse.d.ts.map +1 -1
- package/dist/tools/browse.js +291 -175
- package/dist/tools/browse.js.map +1 -1
- package/dist/tools/challenge.d.ts +153 -0
- package/dist/tools/challenge.d.ts.map +1 -0
- package/dist/tools/challenge.js +611 -0
- package/dist/tools/challenge.js.map +1 -0
- package/dist/tools/cookies.d.ts.map +1 -1
- package/dist/tools/cookies.js +13 -7
- package/dist/tools/cookies.js.map +1 -1
- package/dist/tools/diagnostics.d.ts +5 -5
- package/dist/tools/diagnostics.d.ts.map +1 -1
- package/dist/tools/diagnostics.js +39 -20
- package/dist/tools/diagnostics.js.map +1 -1
- package/dist/tools/evaluate.d.ts.map +1 -1
- package/dist/tools/evaluate.js +106 -23
- package/dist/tools/evaluate.js.map +1 -1
- package/dist/tools/extract.d.ts.map +1 -1
- package/dist/tools/extract.js +199 -208
- package/dist/tools/extract.js.map +1 -1
- package/dist/tools/input.d.ts +1 -1
- package/dist/tools/input.d.ts.map +1 -1
- package/dist/tools/input.js +523 -175
- package/dist/tools/input.js.map +1 -1
- package/dist/tools/logs.d.ts.map +1 -1
- package/dist/tools/logs.js +7 -7
- package/dist/tools/logs.js.map +1 -1
- package/dist/tools/manage.d.ts.map +1 -1
- package/dist/tools/manage.js +400 -64
- package/dist/tools/manage.js.map +1 -1
- package/dist/tools/network-sanitizer.d.ts.map +1 -1
- package/dist/tools/network-sanitizer.js +1 -0
- package/dist/tools/network-sanitizer.js.map +1 -1
- package/dist/tools/page-context.d.ts +17 -0
- package/dist/tools/page-context.d.ts.map +1 -0
- package/dist/tools/page-context.js +103 -0
- package/dist/tools/page-context.js.map +1 -0
- package/dist/tools/png.d.ts +5 -0
- package/dist/tools/png.d.ts.map +1 -1
- package/dist/tools/png.js +89 -22
- package/dist/tools/png.js.map +1 -1
- package/dist/tools/post-condition.d.ts.map +1 -1
- package/dist/tools/post-condition.js +17 -5
- package/dist/tools/post-condition.js.map +1 -1
- package/dist/tools/schema.d.ts +9 -0
- package/dist/tools/schema.d.ts.map +1 -1
- package/dist/tools/schema.js +15 -0
- package/dist/tools/schema.js.map +1 -1
- package/dist/tools/target-diagnostics.d.ts +7 -0
- package/dist/tools/target-diagnostics.d.ts.map +1 -1
- package/dist/tools/target-diagnostics.js +47 -17
- package/dist/tools/target-diagnostics.js.map +1 -1
- package/dist/tools/wait.d.ts.map +1 -1
- package/dist/tools/wait.js +52 -56
- package/dist/tools/wait.js.map +1 -1
- package/extension/dist/assets/content.ts-C4imZ6A9.js +13 -0
- package/extension/dist/assets/content.ts-loader-CnJuCGhl.js +13 -0
- package/extension/dist/assets/{index.ts-GG6dPUPX.js → index.ts-GeHNZBml.js} +2156 -1950
- package/extension/dist/assets/page-scripts-CMIY1zhd.js +1379 -0
- package/extension/dist/assets/{popup.html-B81xccfq.js → popup.html-CgtWL6Py.js} +48 -1
- package/extension/dist/manifest.json +4 -3
- package/extension/dist/service-worker-loader.js +1 -1
- package/extension/dist/src/popup/popup.html +54 -44
- package/package.json +11 -8
- package/scripts/start-chrome.ps1 +58 -0
- package/dist/extension/native-host-installer.d.ts +0 -21
- package/dist/extension/native-host-installer.d.ts.map +0 -1
- package/dist/extension/native-host-installer.js +0 -147
- package/dist/extension/native-host-installer.js.map +0 -1
- package/dist/extension/socket-server.d.ts +0 -32
- package/dist/extension/socket-server.d.ts.map +0 -1
- package/dist/extension/socket-server.js +0 -177
- package/dist/extension/socket-server.js.map +0 -1
- package/dist/extension/ws-server.d.ts +0 -40
- package/dist/extension/ws-server.d.ts.map +0 -1
- package/dist/extension/ws-server.js +0 -246
- package/dist/extension/ws-server.js.map +0 -1
- package/dist/native-host/index.js +0 -280
- package/dist/native-host/mcp-chrome-host +0 -2
- package/extension/dist/assets/content.ts-Cj_iiU2s.js +0 -25
package/dist/tools/manage.js
CHANGED
|
@@ -13,7 +13,9 @@
|
|
|
13
13
|
* - cdp: 发送任意 CDP 命令(高级)
|
|
14
14
|
*/
|
|
15
15
|
import { z } from 'zod';
|
|
16
|
-
import { devices, formatErrorResponse, formatResponse, getSession, getUnifiedSession } from '../core/index.js';
|
|
16
|
+
import { devices, formatErrorResponse, formatResponse, getSession, getUnifiedSession, isNativeExecutionResultUnknown, } from '../core/index.js';
|
|
17
|
+
import { withPageResponse } from './page-context.js';
|
|
18
|
+
import { pageConditionSchema } from './schema.js';
|
|
17
19
|
function invalidArgument(message, suggestion) {
|
|
18
20
|
return {
|
|
19
21
|
content: [
|
|
@@ -39,13 +41,19 @@ function formatAffectedResponse(action, mode, affected) {
|
|
|
39
41
|
affected,
|
|
40
42
|
});
|
|
41
43
|
}
|
|
42
|
-
const manageSchema = z
|
|
44
|
+
const manageSchema = z
|
|
45
|
+
.object({
|
|
46
|
+
...pageConditionSchema,
|
|
43
47
|
action: z
|
|
44
48
|
.enum([
|
|
45
49
|
'newPage',
|
|
50
|
+
'pageMetadata',
|
|
46
51
|
'closePage',
|
|
47
52
|
'adoptPage',
|
|
48
53
|
'releasePage',
|
|
54
|
+
'grantReadAccess',
|
|
55
|
+
'revokeReadAccess',
|
|
56
|
+
'updatePage',
|
|
49
57
|
'movePage',
|
|
50
58
|
'reorderPage',
|
|
51
59
|
'pinPage',
|
|
@@ -55,6 +63,11 @@ const manageSchema = z.object({
|
|
|
55
63
|
'resizeWindow',
|
|
56
64
|
'newWindow',
|
|
57
65
|
'closeWindow',
|
|
66
|
+
'updateWindow',
|
|
67
|
+
'groupPages',
|
|
68
|
+
'ungroupPages',
|
|
69
|
+
'updateGroup',
|
|
70
|
+
'moveGroup',
|
|
58
71
|
'clearCache',
|
|
59
72
|
'viewport',
|
|
60
73
|
'userAgent',
|
|
@@ -70,14 +83,56 @@ const manageSchema = z.object({
|
|
|
70
83
|
.describe('输入模式(inputMode),precise=debugger API(默认,可绕过 CSP 但显示调试提示);stealth=JS 事件模拟(不触发调试提示但受 CSP 限制,适用于反检测场景)'),
|
|
71
84
|
cdpMethod: z.string().optional().describe('CDP 方法名(cdp),如 Runtime.evaluate、Page.captureScreenshot'),
|
|
72
85
|
cdpParams: z.record(z.string(), z.unknown()).optional().describe('CDP 方法参数(cdp)'),
|
|
73
|
-
targetId: z
|
|
74
|
-
|
|
86
|
+
targetId: z.string().optional().describe('目标页面 ID;newWindow 时将此受控页面移入新窗口'),
|
|
87
|
+
targetIds: z.array(z.string().min(1)).min(1).optional().describe('groupPages/ungroupPages 的受控页面 ID 列表'),
|
|
88
|
+
windowId: z
|
|
89
|
+
.number()
|
|
90
|
+
.int()
|
|
75
91
|
.optional()
|
|
76
|
-
.describe('
|
|
77
|
-
|
|
78
|
-
|
|
92
|
+
.describe('窗口 ID;newPage/groupPages 指定所属窗口,movePage/moveGroup 指定目标窗口'),
|
|
93
|
+
index: z
|
|
94
|
+
.number()
|
|
95
|
+
.int()
|
|
96
|
+
.min(-1)
|
|
97
|
+
.optional()
|
|
98
|
+
.describe('页面或分组在窗口中的位置;移动时 -1 表示末尾,newPage 必须非负'),
|
|
99
|
+
groupId: z
|
|
100
|
+
.number()
|
|
101
|
+
.int()
|
|
102
|
+
.min(-1)
|
|
103
|
+
.optional()
|
|
104
|
+
.describe('分组 ID;newPage 的 -1 表示不分组,groupPages 省略时创建新组'),
|
|
105
|
+
title: z.string().optional().describe('groupPages/updateGroup 的分组名称,可设为空字符串'),
|
|
106
|
+
color: z
|
|
107
|
+
.enum(['blue', 'cyan', 'green', 'grey', 'orange', 'pink', 'purple', 'red', 'yellow'])
|
|
108
|
+
.optional()
|
|
109
|
+
.describe('groupPages/updateGroup 的分组颜色'),
|
|
110
|
+
collapsed: z.boolean().optional().describe('groupPages/updateGroup 是否折叠分组'),
|
|
111
|
+
active: z
|
|
112
|
+
.boolean()
|
|
113
|
+
.optional()
|
|
114
|
+
.describe('newPage 是否为窗口内活动页,默认 false;updatePage 只支持 true,不聚焦窗口'),
|
|
115
|
+
pinned: z.boolean().optional().describe('newPage/updatePage 是否固定页面'),
|
|
116
|
+
highlighted: z.boolean().optional().describe('updatePage 是否选中页面'),
|
|
117
|
+
muted: z.boolean().optional().describe('updatePage 是否静音页面'),
|
|
118
|
+
autoDiscardable: z.boolean().optional().describe('updatePage 是否允许浏览器自动丢弃页面内容'),
|
|
119
|
+
openerTabId: z
|
|
120
|
+
.number()
|
|
121
|
+
.int()
|
|
122
|
+
.nonnegative()
|
|
123
|
+
.optional()
|
|
124
|
+
.describe('newPage/updatePage 的来源 tab ID,必须位于同一窗口'),
|
|
79
125
|
activate: z.boolean().optional().describe('movePage 后是否激活目标 tab'),
|
|
80
|
-
focused: z
|
|
126
|
+
focused: z
|
|
127
|
+
.boolean()
|
|
128
|
+
.optional()
|
|
129
|
+
.describe('newWindow/updateWindow/resizeWindow 是否聚焦窗口;newWindow 默认 false'),
|
|
130
|
+
drawAttention: z.boolean().optional().describe('updateWindow/resizeWindow 是否请求窗口提醒,不改变焦点'),
|
|
131
|
+
windowType: z
|
|
132
|
+
.enum(['normal', 'popup'])
|
|
133
|
+
.optional()
|
|
134
|
+
.describe('newWindow 的窗口类型,默认 normal;popup 只支持一个页面'),
|
|
135
|
+
setSelfAsOpener: z.boolean().optional().describe('newWindow 是否将窗口创建者设为 window.opener'),
|
|
81
136
|
incognito: z.boolean().optional().describe('newWindow 是否创建隐身窗口'),
|
|
82
137
|
left: z.number().int().optional().describe('窗口左上角 x 坐标(newWindow/resizeWindow)'),
|
|
83
138
|
top: z.number().int().optional().describe('窗口左上角 y 坐标(newWindow/resizeWindow)'),
|
|
@@ -85,7 +140,13 @@ const manageSchema = z.object({
|
|
|
85
140
|
.enum(['normal', 'minimized', 'maximized', 'fullscreen', 'locked-fullscreen'])
|
|
86
141
|
.optional()
|
|
87
142
|
.describe('窗口状态(newWindow/resizeWindow)'),
|
|
88
|
-
url: z.string().optional().describe('newPage/newWindow 初始 URL'),
|
|
143
|
+
url: z.string().min(1).optional().describe('newPage/newWindow 初始 URL,或 updatePage 的导航 URL'),
|
|
144
|
+
urls: z
|
|
145
|
+
.array(z.string().min(1))
|
|
146
|
+
.min(1)
|
|
147
|
+
.optional()
|
|
148
|
+
.describe('newWindow 创建多个页面的初始 URL,与 url 互斥,可与 targetId 同时使用'),
|
|
149
|
+
timeout: z.number().positive().optional().describe('newPage 的页面加载超时毫秒'),
|
|
89
150
|
cacheType: z
|
|
90
151
|
.enum(['all', 'storage', 'cache'])
|
|
91
152
|
.optional()
|
|
@@ -94,22 +155,195 @@ const manageSchema = z.object({
|
|
|
94
155
|
height: z.number().optional().describe('视口高度(viewport)'),
|
|
95
156
|
userAgent: z.string().optional().describe('User-Agent 字符串(userAgent)'),
|
|
96
157
|
device: z.string().optional().describe('设备名称(emulate),如 iPhone 13, iPad Pro'),
|
|
158
|
+
taskHint: z.string().max(120).nullable().optional().describe('pageMetadata:任务提示,null 清除'),
|
|
159
|
+
note: z.string().max(1000).nullable().optional().describe('pageMetadata:页面备注,null 清除'),
|
|
160
|
+
})
|
|
161
|
+
.strict()
|
|
162
|
+
.superRefine((args, context) => {
|
|
163
|
+
const scopes = {
|
|
164
|
+
targetIds: ['groupPages', 'ungroupPages'],
|
|
165
|
+
groupId: ['newPage', 'groupPages', 'updateGroup', 'moveGroup'],
|
|
166
|
+
title: ['groupPages', 'updateGroup'],
|
|
167
|
+
color: ['groupPages', 'updateGroup'],
|
|
168
|
+
collapsed: ['groupPages', 'updateGroup'],
|
|
169
|
+
active: ['newPage', 'updatePage'],
|
|
170
|
+
pinned: ['newPage', 'updatePage'],
|
|
171
|
+
openerTabId: ['newPage', 'updatePage'],
|
|
172
|
+
highlighted: ['updatePage'],
|
|
173
|
+
muted: ['updatePage'],
|
|
174
|
+
autoDiscardable: ['updatePage'],
|
|
175
|
+
index: ['newPage', 'movePage', 'reorderPage', 'moveGroup'],
|
|
176
|
+
windowId: [
|
|
177
|
+
'newPage',
|
|
178
|
+
'movePage',
|
|
179
|
+
'groupPages',
|
|
180
|
+
'moveGroup',
|
|
181
|
+
'focusWindow',
|
|
182
|
+
'resizeWindow',
|
|
183
|
+
'updateWindow',
|
|
184
|
+
'closeWindow',
|
|
185
|
+
],
|
|
186
|
+
focused: ['newWindow', 'updateWindow', 'resizeWindow'],
|
|
187
|
+
drawAttention: ['updateWindow', 'resizeWindow'],
|
|
188
|
+
windowType: ['newWindow'],
|
|
189
|
+
setSelfAsOpener: ['newWindow'],
|
|
190
|
+
incognito: ['newWindow'],
|
|
191
|
+
urls: ['newWindow'],
|
|
192
|
+
url: ['newPage', 'newWindow', 'updatePage'],
|
|
193
|
+
timeout: ['newPage'],
|
|
194
|
+
left: ['newWindow', 'resizeWindow', 'updateWindow'],
|
|
195
|
+
top: ['newWindow', 'resizeWindow', 'updateWindow'],
|
|
196
|
+
width: ['newWindow', 'resizeWindow', 'updateWindow', 'viewport'],
|
|
197
|
+
height: ['newWindow', 'resizeWindow', 'updateWindow', 'viewport'],
|
|
198
|
+
windowState: ['newWindow', 'resizeWindow', 'updateWindow'],
|
|
199
|
+
};
|
|
200
|
+
for (const [field, actions] of Object.entries(scopes)) {
|
|
201
|
+
if (args[field] !== undefined && !actions.includes(args.action)) {
|
|
202
|
+
context.addIssue({ code: 'custom', path: [field], message: `${args.action} 不支持 ${field},未执行` });
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
if (args.action === 'newPage') {
|
|
206
|
+
if (args.index !== undefined && args.index < 0) {
|
|
207
|
+
context.addIssue({ code: 'custom', path: ['index'], message: 'newPage 的 index 必须非负' });
|
|
208
|
+
}
|
|
209
|
+
if (args.pinned && args.groupId !== undefined && args.groupId >= 0) {
|
|
210
|
+
context.addIssue({ code: 'custom', path: ['groupId'], message: 'pinned=true 与分组不兼容' });
|
|
211
|
+
}
|
|
212
|
+
}
|
|
213
|
+
else if (args.groupId !== undefined && args.groupId < 0) {
|
|
214
|
+
context.addIssue({ code: 'custom', path: ['groupId'], message: '此操作需要现有分组 ID' });
|
|
215
|
+
}
|
|
216
|
+
if (args.action === 'groupPages' &&
|
|
217
|
+
args.groupId !== undefined &&
|
|
218
|
+
[args.title, args.color, args.collapsed, args.windowId].some((value) => value !== undefined)) {
|
|
219
|
+
context.addIssue({
|
|
220
|
+
code: 'custom',
|
|
221
|
+
path: ['groupId'],
|
|
222
|
+
message: '加入已有分组仅接受页面列表与 groupId;修改分组请用 updateGroup/moveGroup',
|
|
223
|
+
});
|
|
224
|
+
}
|
|
225
|
+
if (args.action === 'newWindow' && args.url !== undefined && args.urls !== undefined) {
|
|
226
|
+
context.addIssue({ code: 'custom', message: 'newWindow 的 url 与 urls 互斥' });
|
|
227
|
+
}
|
|
228
|
+
if (args.action === 'updatePage' && args.active === false) {
|
|
229
|
+
context.addIssue({ code: 'custom', path: ['active'], message: 'updatePage 不支持 active=false,未执行' });
|
|
230
|
+
}
|
|
231
|
+
if (args.action === 'newWindow' &&
|
|
232
|
+
args.windowType === 'popup' &&
|
|
233
|
+
(args.urls?.length ?? (args.url !== undefined ? 1 : 0)) + (args.targetId !== undefined ? 1 : 0) > 1) {
|
|
234
|
+
context.addIssue({
|
|
235
|
+
code: 'custom',
|
|
236
|
+
path: ['windowType'],
|
|
237
|
+
message: 'popup 只支持一个页面,请使用 normal 窗口',
|
|
238
|
+
});
|
|
239
|
+
}
|
|
240
|
+
if (['newWindow', 'updateWindow', 'resizeWindow'].includes(args.action)) {
|
|
241
|
+
for (const field of ['width', 'height']) {
|
|
242
|
+
const value = args[field];
|
|
243
|
+
if (value !== undefined && (!Number.isInteger(value) || value <= 0)) {
|
|
244
|
+
context.addIssue({ code: 'custom', path: [field], message: '窗口尺寸必须是正整数' });
|
|
245
|
+
}
|
|
246
|
+
}
|
|
247
|
+
if (['minimized', 'maximized', 'fullscreen', 'locked-fullscreen'].includes(args.windowState ?? '') &&
|
|
248
|
+
[args.left, args.top, args.width, args.height].some((value) => value !== undefined)) {
|
|
249
|
+
context.addIssue({
|
|
250
|
+
code: 'custom',
|
|
251
|
+
path: ['windowState'],
|
|
252
|
+
message: '非 normal 窗口状态不能与窗口位置或尺寸同时设置',
|
|
253
|
+
});
|
|
254
|
+
}
|
|
255
|
+
if (args.action !== 'newWindow' &&
|
|
256
|
+
((args.focused === true && args.windowState === 'minimized') ||
|
|
257
|
+
(args.focused === false &&
|
|
258
|
+
['maximized', 'fullscreen', 'locked-fullscreen'].includes(args.windowState ?? '')))) {
|
|
259
|
+
context.addIssue({ code: 'custom', path: ['focused'], message: 'focused 与窗口状态冲突' });
|
|
260
|
+
}
|
|
261
|
+
}
|
|
97
262
|
});
|
|
98
263
|
async function handleManage(args) {
|
|
99
264
|
try {
|
|
100
265
|
const unifiedSession = getUnifiedSession();
|
|
101
266
|
const mode = unifiedSession.getMode();
|
|
102
|
-
|
|
267
|
+
const handler = async () => manageHandlers[args.action]({ unifiedSession, mode }, args);
|
|
268
|
+
const pageActions = [
|
|
269
|
+
'pageMetadata',
|
|
270
|
+
'closePage',
|
|
271
|
+
'adoptPage',
|
|
272
|
+
'releasePage',
|
|
273
|
+
'grantReadAccess',
|
|
274
|
+
'revokeReadAccess',
|
|
275
|
+
'updatePage',
|
|
276
|
+
'movePage',
|
|
277
|
+
'reorderPage',
|
|
278
|
+
'pinPage',
|
|
279
|
+
'unpinPage',
|
|
280
|
+
'activatePage',
|
|
281
|
+
'viewport',
|
|
282
|
+
'userAgent',
|
|
283
|
+
'emulate',
|
|
284
|
+
'stealth',
|
|
285
|
+
'cdp',
|
|
286
|
+
];
|
|
287
|
+
const conditional = args.expectedUrl !== undefined || args.expectedRevision !== undefined;
|
|
288
|
+
if (args.action === 'newPage' && args.targetId) {
|
|
289
|
+
return invalidArgument('newPage 创建新页面,不接受已有 targetId');
|
|
290
|
+
}
|
|
291
|
+
if (conditional && !pageActions.includes(args.action)) {
|
|
292
|
+
return invalidArgument(`${args.action} 不支持页面条件,未执行操作`);
|
|
293
|
+
}
|
|
294
|
+
if (conditional &&
|
|
295
|
+
args.action === 'cdp' &&
|
|
296
|
+
(!args.cdpMethod || /^(Target|Browser|SystemInfo|DeviceAccess|IO)\./.test(args.cdpMethod))) {
|
|
297
|
+
return invalidArgument('browser-level CDP 命令不支持页面条件,未执行操作');
|
|
298
|
+
}
|
|
299
|
+
const targetSelectionActions = ['viewport', 'userAgent', 'emulate', 'stealth', 'cdp'];
|
|
300
|
+
const run = () => conditional
|
|
301
|
+
? targetSelectionActions.includes(args.action)
|
|
302
|
+
? unifiedSession.withTabId(args.targetId, () => unifiedSession.withPageCondition(args, handler))
|
|
303
|
+
: unifiedSession.withPageCondition(args, handler)
|
|
304
|
+
: handler();
|
|
305
|
+
if (pageActions.includes(args.action) ||
|
|
306
|
+
['newPage', 'newWindow', 'pageMetadata', 'clearCache'].includes(args.action)) {
|
|
307
|
+
return await withPageResponse(unifiedSession, args.targetId, run, args.action === 'newPage' || (args.action === 'newWindow' && args.targetId === undefined));
|
|
308
|
+
}
|
|
309
|
+
return await run();
|
|
103
310
|
}
|
|
104
311
|
catch (error) {
|
|
105
312
|
return formatErrorResponse(error);
|
|
106
313
|
}
|
|
107
314
|
}
|
|
108
|
-
async function handleNewPage({ unifiedSession
|
|
109
|
-
const target = await unifiedSession.newPage(args.url
|
|
110
|
-
|
|
315
|
+
async function handleNewPage({ unifiedSession }, args) {
|
|
316
|
+
const target = await unifiedSession.newPage(args.url, {
|
|
317
|
+
windowId: args.windowId,
|
|
318
|
+
index: args.index,
|
|
319
|
+
groupId: args.groupId,
|
|
320
|
+
active: args.active,
|
|
321
|
+
pinned: args.pinned,
|
|
322
|
+
openerTabId: args.openerTabId,
|
|
323
|
+
}, args.timeout);
|
|
324
|
+
return formatResponse({
|
|
325
|
+
success: true,
|
|
326
|
+
action: 'newPage',
|
|
327
|
+
target,
|
|
328
|
+
createdTargetId: target.targetId,
|
|
329
|
+
metadata: unifiedSession.getPageMetadata(target.targetId),
|
|
330
|
+
mode: unifiedSession.getMode(),
|
|
331
|
+
});
|
|
332
|
+
}
|
|
333
|
+
async function handlePageMetadata({ unifiedSession, mode }, args) {
|
|
334
|
+
if (!args.targetId) {
|
|
335
|
+
return invalidArgument('pageMetadata 需要 targetId 参数');
|
|
336
|
+
}
|
|
337
|
+
await unifiedSession.getPageSnapshot(args.targetId);
|
|
338
|
+
const metadata = args.taskHint !== undefined || args.note !== undefined
|
|
339
|
+
? await unifiedSession.setPageMetadata(args.targetId, { taskHint: args.taskHint, note: args.note })
|
|
340
|
+
: unifiedSession.getPageMetadata(args.targetId);
|
|
341
|
+
return formatResponse({ success: true, action: 'pageMetadata', targetId: args.targetId, mode, metadata });
|
|
111
342
|
}
|
|
112
343
|
async function handleClosePage({ unifiedSession, mode }, args) {
|
|
344
|
+
if (!args.targetId) {
|
|
345
|
+
return invalidArgument('closePage 需要 targetId 参数,未关闭页面');
|
|
346
|
+
}
|
|
113
347
|
const affected = await unifiedSession.closePage(args.targetId);
|
|
114
348
|
return formatResponse({
|
|
115
349
|
success: true,
|
|
@@ -133,6 +367,65 @@ async function handleReleasePage({ unifiedSession, mode }, args) {
|
|
|
133
367
|
const result = await unifiedSession.releasePage(args.targetId);
|
|
134
368
|
return formatResponse({ success: true, action: 'releasePage', mode, targetId: args.targetId, ...result });
|
|
135
369
|
}
|
|
370
|
+
async function handleReadAccess({ unifiedSession, mode }, args) {
|
|
371
|
+
if (!args.targetId) {
|
|
372
|
+
return invalidArgument(`${args.action} 需要 targetId,未修改权限`);
|
|
373
|
+
}
|
|
374
|
+
const result = await unifiedSession.setReadAccess(args.targetId, args.action === 'grantReadAccess');
|
|
375
|
+
return formatResponse({ ...result, action: args.action, mode });
|
|
376
|
+
}
|
|
377
|
+
async function handleUpdatePage({ unifiedSession, mode }, args) {
|
|
378
|
+
if (!args.targetId) {
|
|
379
|
+
return invalidArgument('updatePage 需要 targetId 参数,未执行');
|
|
380
|
+
}
|
|
381
|
+
const affected = await unifiedSession.updatePage(args.targetId, {
|
|
382
|
+
url: args.url,
|
|
383
|
+
active: args.active,
|
|
384
|
+
pinned: args.pinned,
|
|
385
|
+
highlighted: args.highlighted,
|
|
386
|
+
muted: args.muted,
|
|
387
|
+
autoDiscardable: args.autoDiscardable,
|
|
388
|
+
openerTabId: args.openerTabId,
|
|
389
|
+
});
|
|
390
|
+
return formatAffectedResponse('updatePage', mode, affected);
|
|
391
|
+
}
|
|
392
|
+
async function handleGroupPages({ unifiedSession, mode }, args) {
|
|
393
|
+
if (!args.targetIds) {
|
|
394
|
+
return invalidArgument('groupPages 需要 targetIds 参数,未执行');
|
|
395
|
+
}
|
|
396
|
+
const affected = await unifiedSession.groupPages(args.targetIds, {
|
|
397
|
+
groupId: args.groupId,
|
|
398
|
+
windowId: args.windowId,
|
|
399
|
+
title: args.title,
|
|
400
|
+
color: args.color,
|
|
401
|
+
collapsed: args.collapsed,
|
|
402
|
+
});
|
|
403
|
+
return formatAffectedResponse('groupPages', mode, affected);
|
|
404
|
+
}
|
|
405
|
+
async function handleUngroupPages({ unifiedSession, mode }, args) {
|
|
406
|
+
if (!args.targetIds) {
|
|
407
|
+
return invalidArgument('ungroupPages 需要 targetIds 参数,未执行');
|
|
408
|
+
}
|
|
409
|
+
return formatAffectedResponse('ungroupPages', mode, await unifiedSession.ungroupPages(args.targetIds));
|
|
410
|
+
}
|
|
411
|
+
async function handleUpdateGroup({ unifiedSession, mode }, args) {
|
|
412
|
+
if (args.groupId === undefined) {
|
|
413
|
+
return invalidArgument('updateGroup 需要 groupId 参数,未执行');
|
|
414
|
+
}
|
|
415
|
+
const affected = await unifiedSession.updateGroup(args.groupId, {
|
|
416
|
+
title: args.title,
|
|
417
|
+
color: args.color,
|
|
418
|
+
collapsed: args.collapsed,
|
|
419
|
+
});
|
|
420
|
+
return formatAffectedResponse('updateGroup', mode, affected);
|
|
421
|
+
}
|
|
422
|
+
async function handleMoveGroup({ unifiedSession, mode }, args) {
|
|
423
|
+
if (args.groupId === undefined || args.index === undefined) {
|
|
424
|
+
return invalidArgument('moveGroup 需要 groupId 和 index 参数,未执行');
|
|
425
|
+
}
|
|
426
|
+
const affected = await unifiedSession.moveGroup(args.groupId, { windowId: args.windowId, index: args.index });
|
|
427
|
+
return formatAffectedResponse('moveGroup', mode, affected);
|
|
428
|
+
}
|
|
136
429
|
async function handleMovePage({ unifiedSession, mode }, args) {
|
|
137
430
|
if (!args.targetId) {
|
|
138
431
|
return invalidArgument('movePage 需要 targetId 参数', '请先使用 browse(action="list") 获取目标 tab 的 targetId');
|
|
@@ -192,12 +485,32 @@ async function handleResizeWindow({ unifiedSession, mode }, args) {
|
|
|
192
485
|
width: args.width,
|
|
193
486
|
height: args.height,
|
|
194
487
|
state: args.windowState,
|
|
488
|
+
focused: args.focused,
|
|
489
|
+
drawAttention: args.drawAttention,
|
|
195
490
|
});
|
|
196
491
|
return formatAffectedResponse('resizeWindow', mode, affected);
|
|
197
492
|
}
|
|
493
|
+
async function handleUpdateWindow({ unifiedSession, mode }, args) {
|
|
494
|
+
if (args.windowId === undefined) {
|
|
495
|
+
return invalidArgument('updateWindow 需要 windowId 参数,未执行');
|
|
496
|
+
}
|
|
497
|
+
const affected = await unifiedSession.updateWindow(args.windowId, {
|
|
498
|
+
left: args.left,
|
|
499
|
+
top: args.top,
|
|
500
|
+
width: args.width,
|
|
501
|
+
height: args.height,
|
|
502
|
+
state: args.windowState,
|
|
503
|
+
focused: args.focused,
|
|
504
|
+
drawAttention: args.drawAttention,
|
|
505
|
+
});
|
|
506
|
+
return formatAffectedResponse('updateWindow', mode, affected);
|
|
507
|
+
}
|
|
198
508
|
async function handleNewWindow({ unifiedSession, mode }, args) {
|
|
199
509
|
const affected = await unifiedSession.newWindow({
|
|
200
|
-
url: args.url,
|
|
510
|
+
url: args.urls ?? args.url,
|
|
511
|
+
targetId: args.targetId,
|
|
512
|
+
type: args.windowType,
|
|
513
|
+
setSelfAsOpener: args.setSelfAsOpener,
|
|
201
514
|
focused: args.focused,
|
|
202
515
|
incognito: args.incognito,
|
|
203
516
|
left: args.left,
|
|
@@ -206,7 +519,15 @@ async function handleNewWindow({ unifiedSession, mode }, args) {
|
|
|
206
519
|
height: args.height,
|
|
207
520
|
state: args.windowState,
|
|
208
521
|
});
|
|
209
|
-
return
|
|
522
|
+
return formatResponse({
|
|
523
|
+
success: true,
|
|
524
|
+
action: 'newWindow',
|
|
525
|
+
mode,
|
|
526
|
+
affected,
|
|
527
|
+
...(args.targetId === undefined
|
|
528
|
+
? { createdTargetId: affected.targetId ?? null }
|
|
529
|
+
: { targetId: affected.targetId }),
|
|
530
|
+
});
|
|
210
531
|
}
|
|
211
532
|
async function handleCloseWindow({ unifiedSession, mode }, args) {
|
|
212
533
|
if (args.windowId === undefined) {
|
|
@@ -216,16 +537,29 @@ async function handleCloseWindow({ unifiedSession, mode }, args) {
|
|
|
216
537
|
return formatAffectedResponse('closeWindow', mode, affected);
|
|
217
538
|
}
|
|
218
539
|
async function handleClearCache({ unifiedSession, mode }, args) {
|
|
219
|
-
return unifiedSession.withTabId(
|
|
540
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
220
541
|
const cacheType = (args.cacheType ?? 'all');
|
|
221
542
|
if (mode === 'extension') {
|
|
222
|
-
return
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
543
|
+
return {
|
|
544
|
+
content: [
|
|
545
|
+
{
|
|
546
|
+
type: 'text',
|
|
547
|
+
text: JSON.stringify({
|
|
548
|
+
error: {
|
|
549
|
+
code: 'UNSUPPORTED_MODE',
|
|
550
|
+
message: 'Extension 模式不支持 clearCache,未执行清除操作',
|
|
551
|
+
suggestion: '清除 cookies 请使用 cookies action=clear(必须带 url 或 domain 过滤),' +
|
|
552
|
+
'清除 storage/cache 请切换到 CDP 模式',
|
|
553
|
+
},
|
|
554
|
+
action: 'clearCache',
|
|
555
|
+
cacheType,
|
|
556
|
+
mode,
|
|
557
|
+
actionPerformed: false,
|
|
558
|
+
}),
|
|
559
|
+
},
|
|
560
|
+
],
|
|
561
|
+
isError: true,
|
|
562
|
+
};
|
|
229
563
|
}
|
|
230
564
|
const session = getSession();
|
|
231
565
|
await session.clearCache(cacheType);
|
|
@@ -233,30 +567,24 @@ async function handleClearCache({ unifiedSession, mode }, args) {
|
|
|
233
567
|
});
|
|
234
568
|
}
|
|
235
569
|
async function handleViewport({ unifiedSession, mode }, args) {
|
|
236
|
-
return unifiedSession.withTabId(
|
|
570
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
237
571
|
if (args.width === undefined || args.height === undefined) {
|
|
238
572
|
return invalidArgument('设置视口需要 width 和 height 参数');
|
|
239
573
|
}
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', { enabled: false });
|
|
249
|
-
}
|
|
250
|
-
else {
|
|
251
|
-
const session = getSession();
|
|
252
|
-
await session.setViewport(args.width, args.height);
|
|
253
|
-
}
|
|
574
|
+
await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
|
|
575
|
+
width: args.width,
|
|
576
|
+
height: args.height,
|
|
577
|
+
deviceScaleFactor: 1,
|
|
578
|
+
mobile: false,
|
|
579
|
+
});
|
|
580
|
+
await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
|
|
581
|
+
await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', { enabled: false });
|
|
254
582
|
await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))');
|
|
255
583
|
return formatResponse({ success: true, action: 'viewport', width: args.width, height: args.height, mode });
|
|
256
584
|
});
|
|
257
585
|
}
|
|
258
586
|
async function handleUserAgent({ unifiedSession, mode }, args) {
|
|
259
|
-
return unifiedSession.withTabId(
|
|
587
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
260
588
|
if (!args.userAgent) {
|
|
261
589
|
return invalidArgument('设置 User-Agent 需要 userAgent 参数');
|
|
262
590
|
}
|
|
@@ -287,7 +615,7 @@ function handleInputMode({ unifiedSession, mode }, args) {
|
|
|
287
615
|
return formatResponse({ success: true, action: 'inputMode', inputMode: args.inputMode, mode });
|
|
288
616
|
}
|
|
289
617
|
async function handleEmulate({ unifiedSession, mode }, args) {
|
|
290
|
-
return unifiedSession.withTabId(
|
|
618
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
291
619
|
if (!args.device) {
|
|
292
620
|
return formatResponse({ success: true, action: 'emulate', availableDevices: Object.keys(devices) });
|
|
293
621
|
}
|
|
@@ -295,25 +623,18 @@ async function handleEmulate({ unifiedSession, mode }, args) {
|
|
|
295
623
|
if (!device) {
|
|
296
624
|
return invalidArgument(`未知设备: ${args.device}`, `可用设备: ${Object.keys(devices).join(', ')}`);
|
|
297
625
|
}
|
|
298
|
-
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
await unifiedSession.sendCdpCommand('Emulation.setUserAgentOverride', { userAgent: device.userAgent });
|
|
311
|
-
}
|
|
312
|
-
else {
|
|
313
|
-
const session = getSession();
|
|
314
|
-
await session.setViewport(device.viewport.width, device.viewport.height);
|
|
315
|
-
await session.setUserAgent(device.userAgent);
|
|
316
|
-
}
|
|
626
|
+
await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
|
|
627
|
+
width: device.viewport.width,
|
|
628
|
+
height: device.viewport.height,
|
|
629
|
+
deviceScaleFactor: device.viewport.deviceScaleFactor || 1,
|
|
630
|
+
mobile: device.viewport.isMobile || false,
|
|
631
|
+
});
|
|
632
|
+
await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
|
|
633
|
+
await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', {
|
|
634
|
+
enabled: device.viewport.hasTouch,
|
|
635
|
+
maxTouchPoints: device.viewport.hasTouch ? 1 : 0,
|
|
636
|
+
});
|
|
637
|
+
await unifiedSession.sendCdpCommand('Emulation.setUserAgentOverride', { userAgent: device.userAgent });
|
|
317
638
|
await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))');
|
|
318
639
|
return formatResponse({
|
|
319
640
|
success: true,
|
|
@@ -324,14 +645,14 @@ async function handleEmulate({ unifiedSession, mode }, args) {
|
|
|
324
645
|
});
|
|
325
646
|
});
|
|
326
647
|
}
|
|
327
|
-
async function handleStealth({ unifiedSession, mode }) {
|
|
328
|
-
return unifiedSession.withTabId(
|
|
648
|
+
async function handleStealth({ unifiedSession, mode }, args) {
|
|
649
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
329
650
|
await unifiedSession.injectStealth();
|
|
330
651
|
return formatResponse({ success: true, action: 'stealth', mode, note: '已注入反检测脚本' });
|
|
331
652
|
});
|
|
332
653
|
}
|
|
333
654
|
async function handleCdp({ unifiedSession, mode }, args) {
|
|
334
|
-
return unifiedSession.withTabId(
|
|
655
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
335
656
|
if (!args.cdpMethod) {
|
|
336
657
|
return invalidArgument('缺少 cdpMethod 参数', '请指定 CDP 方法名,如 Runtime.evaluate、Page.captureScreenshot');
|
|
337
658
|
}
|
|
@@ -361,15 +682,25 @@ async function handleCdp({ unifiedSession, mode }, args) {
|
|
|
361
682
|
isError: true,
|
|
362
683
|
};
|
|
363
684
|
}
|
|
364
|
-
|
|
685
|
+
const response = formatErrorResponse(error);
|
|
686
|
+
if (isNativeExecutionResultUnknown(error)) {
|
|
687
|
+
const payload = JSON.parse(response.content[0].text);
|
|
688
|
+
Object.assign(payload, { actionExecuted: true, actionStatus: 'unknown', retryable: false });
|
|
689
|
+
response.content[0].text = JSON.stringify(payload, null, 2);
|
|
690
|
+
}
|
|
691
|
+
return response;
|
|
365
692
|
}
|
|
366
693
|
});
|
|
367
694
|
}
|
|
368
695
|
const manageHandlers = {
|
|
369
696
|
newPage: handleNewPage,
|
|
697
|
+
pageMetadata: handlePageMetadata,
|
|
370
698
|
closePage: handleClosePage,
|
|
371
699
|
adoptPage: handleAdoptPage,
|
|
372
700
|
releasePage: handleReleasePage,
|
|
701
|
+
grantReadAccess: handleReadAccess,
|
|
702
|
+
revokeReadAccess: handleReadAccess,
|
|
703
|
+
updatePage: handleUpdatePage,
|
|
373
704
|
movePage: handleMovePage,
|
|
374
705
|
reorderPage: handleReorderPage,
|
|
375
706
|
pinPage: handlePinPage,
|
|
@@ -379,6 +710,11 @@ const manageHandlers = {
|
|
|
379
710
|
resizeWindow: handleResizeWindow,
|
|
380
711
|
newWindow: handleNewWindow,
|
|
381
712
|
closeWindow: handleCloseWindow,
|
|
713
|
+
updateWindow: handleUpdateWindow,
|
|
714
|
+
groupPages: handleGroupPages,
|
|
715
|
+
ungroupPages: handleUngroupPages,
|
|
716
|
+
updateGroup: handleUpdateGroup,
|
|
717
|
+
moveGroup: handleMoveGroup,
|
|
382
718
|
clearCache: handleClearCache,
|
|
383
719
|
viewport: handleViewport,
|
|
384
720
|
userAgent: handleUserAgent,
|
|
@@ -389,7 +725,7 @@ const manageHandlers = {
|
|
|
389
725
|
};
|
|
390
726
|
export function registerManageTool(server) {
|
|
391
727
|
server.registerTool('manage', {
|
|
392
|
-
description: '
|
|
728
|
+
description: '页面、窗口与分组管理:创建、更新、移动、关闭,受控页 adopt/release,分组成员、名称、颜色和折叠;缓存、视口、UA、设备模拟',
|
|
393
729
|
inputSchema: manageSchema,
|
|
394
730
|
}, (args) => handleManage(args));
|
|
395
731
|
}
|