@pyrokine/mcp-chrome 2.4.4 → 3.0.1
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 +495 -115
- package/README_zh.md +423 -128
- package/dist/anti-detection/injection.js +3 -3
- package/dist/cdp/client.d.ts +1 -1
- package/dist/cdp/client.d.ts.map +1 -1
- package/dist/cdp/client.js +18 -7
- 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 +105 -15
- package/dist/core/browser-driver.d.ts.map +1 -1
- package/dist/core/browser-driver.js.map +1 -1
- package/dist/core/errors.d.ts +22 -4
- package/dist/core/errors.d.ts.map +1 -1
- package/dist/core/errors.js +90 -7
- package/dist/core/errors.js.map +1 -1
- package/dist/core/locator.d.ts +7 -0
- package/dist/core/locator.d.ts.map +1 -1
- package/dist/core/locator.js +54 -29
- package/dist/core/locator.js.map +1 -1
- package/dist/core/os-mouse.d.ts +15 -2
- package/dist/core/os-mouse.d.ts.map +1 -1
- package/dist/core/os-mouse.js +52 -8
- package/dist/core/os-mouse.js.map +1 -1
- package/dist/core/session.d.ts +39 -22
- package/dist/core/session.d.ts.map +1 -1
- package/dist/core/session.js +632 -153
- package/dist/core/session.js.map +1 -1
- package/dist/core/types.d.ts +2 -0
- package/dist/core/types.d.ts.map +1 -1
- package/dist/core/types.js.map +1 -1
- package/dist/core/unified-session.d.ts +105 -27
- package/dist/core/unified-session.d.ts.map +1 -1
- package/dist/core/unified-session.js +554 -138
- 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 +49 -39
- package/dist/extension/bridge.d.ts.map +1 -1
- package/dist/extension/bridge.js +318 -131
- 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 +28 -2
- 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.map +1 -1
- package/dist/tools/browse.js +248 -172
- package/dist/tools/browse.js.map +1 -1
- package/dist/tools/challenge.d.ts +1 -1
- package/dist/tools/challenge.d.ts.map +1 -1
- package/dist/tools/challenge.js +86 -51
- package/dist/tools/challenge.js.map +1 -1
- package/dist/tools/cookies.d.ts.map +1 -1
- package/dist/tools/cookies.js +5 -3
- package/dist/tools/cookies.js.map +1 -1
- package/dist/tools/diagnostics.d.ts +3 -3
- package/dist/tools/diagnostics.d.ts.map +1 -1
- package/dist/tools/diagnostics.js +13 -12
- package/dist/tools/diagnostics.js.map +1 -1
- package/dist/tools/evaluate.d.ts.map +1 -1
- package/dist/tools/evaluate.js +67 -26
- package/dist/tools/evaluate.js.map +1 -1
- package/dist/tools/extract.d.ts.map +1 -1
- package/dist/tools/extract.js +137 -197
- 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 +445 -197
- package/dist/tools/input.js.map +1 -1
- package/dist/tools/logs.d.ts.map +1 -1
- package/dist/tools/logs.js +5 -5
- package/dist/tools/logs.js.map +1 -1
- package/dist/tools/manage.d.ts.map +1 -1
- package/dist/tools/manage.js +395 -86
- package/dist/tools/manage.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 +84 -19
- package/dist/tools/png.js.map +1 -1
- package/dist/tools/post-condition.d.ts.map +1 -1
- package/dist/tools/post-condition.js +24 -7
- 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 +9 -1
- package/dist/tools/target-diagnostics.d.ts.map +1 -1
- package/dist/tools/target-diagnostics.js +89 -33
- package/dist/tools/target-diagnostics.js.map +1 -1
- package/dist/tools/wait.d.ts.map +1 -1
- package/dist/tools/wait.js +38 -32
- package/dist/tools/wait.js.map +1 -1
- package/extension/dist/assets/content.ts-loader-DUWbDHRS.js +13 -0
- package/extension/dist/assets/content.ts-qe6IB5DK.js +13 -0
- package/extension/dist/assets/{index.ts-Bqcu2qiN.js → index.ts-D7_LCUoV.js} +2477 -2201
- package/extension/dist/assets/page-scripts-D508WLkW.js +1378 -0
- package/extension/dist/assets/{popup.html-B81xccfq.js → popup.html-B-eVq48O.js} +54 -5
- package/extension/dist/manifest.json +4 -3
- package/extension/dist/service-worker-loader.js +1 -1
- package/extension/dist/src/popup/popup.html +11 -1
- package/package.json +16 -8
- package/scripts/start-chrome.ps1 +58 -0
- 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,202 @@ 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
|
+
activate: ['movePage'],
|
|
165
|
+
targetIds: ['groupPages', 'ungroupPages'],
|
|
166
|
+
groupId: ['newPage', 'groupPages', 'updateGroup', 'moveGroup'],
|
|
167
|
+
title: ['groupPages', 'updateGroup'],
|
|
168
|
+
color: ['groupPages', 'updateGroup'],
|
|
169
|
+
collapsed: ['groupPages', 'updateGroup'],
|
|
170
|
+
active: ['newPage', 'updatePage'],
|
|
171
|
+
pinned: ['newPage', 'updatePage'],
|
|
172
|
+
openerTabId: ['newPage', 'updatePage'],
|
|
173
|
+
highlighted: ['updatePage'],
|
|
174
|
+
muted: ['updatePage'],
|
|
175
|
+
autoDiscardable: ['updatePage'],
|
|
176
|
+
index: ['newPage', 'movePage', 'reorderPage', 'moveGroup'],
|
|
177
|
+
windowId: [
|
|
178
|
+
'newPage',
|
|
179
|
+
'movePage',
|
|
180
|
+
'groupPages',
|
|
181
|
+
'moveGroup',
|
|
182
|
+
'focusWindow',
|
|
183
|
+
'resizeWindow',
|
|
184
|
+
'updateWindow',
|
|
185
|
+
'closeWindow',
|
|
186
|
+
],
|
|
187
|
+
focused: ['newWindow', 'updateWindow', 'resizeWindow'],
|
|
188
|
+
drawAttention: ['updateWindow', 'resizeWindow'],
|
|
189
|
+
windowType: ['newWindow'],
|
|
190
|
+
setSelfAsOpener: ['newWindow'],
|
|
191
|
+
incognito: ['newWindow'],
|
|
192
|
+
urls: ['newWindow'],
|
|
193
|
+
url: ['newPage', 'newWindow', 'updatePage'],
|
|
194
|
+
timeout: ['newPage'],
|
|
195
|
+
left: ['newWindow', 'resizeWindow', 'updateWindow'],
|
|
196
|
+
top: ['newWindow', 'resizeWindow', 'updateWindow'],
|
|
197
|
+
width: ['newWindow', 'resizeWindow', 'updateWindow', 'viewport'],
|
|
198
|
+
height: ['newWindow', 'resizeWindow', 'updateWindow', 'viewport'],
|
|
199
|
+
windowState: ['newWindow', 'resizeWindow', 'updateWindow'],
|
|
200
|
+
};
|
|
201
|
+
for (const [field, actions] of Object.entries(scopes)) {
|
|
202
|
+
if (args[field] !== undefined && !actions.includes(args.action)) {
|
|
203
|
+
context.addIssue({ code: 'custom', path: [field], message: `${args.action} 不支持 ${field},未执行` });
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
if (args.action === 'newPage') {
|
|
207
|
+
if (args.index !== undefined && args.index < 0) {
|
|
208
|
+
context.addIssue({ code: 'custom', path: ['index'], message: 'newPage 的 index 必须非负' });
|
|
209
|
+
}
|
|
210
|
+
if (args.pinned && args.groupId !== undefined && args.groupId >= 0) {
|
|
211
|
+
context.addIssue({ code: 'custom', path: ['groupId'], message: 'pinned=true 与分组不兼容' });
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
else if (args.groupId !== undefined && args.groupId < 0) {
|
|
215
|
+
context.addIssue({ code: 'custom', path: ['groupId'], message: '此操作需要现有分组 ID' });
|
|
216
|
+
}
|
|
217
|
+
if (args.action === 'groupPages' &&
|
|
218
|
+
args.groupId !== undefined &&
|
|
219
|
+
[args.title, args.color, args.collapsed, args.windowId].some((value) => value !== undefined)) {
|
|
220
|
+
context.addIssue({
|
|
221
|
+
code: 'custom',
|
|
222
|
+
path: ['groupId'],
|
|
223
|
+
message: '加入已有分组仅接受页面列表与 groupId;修改分组请用 updateGroup/moveGroup',
|
|
224
|
+
});
|
|
225
|
+
}
|
|
226
|
+
if (args.action === 'newWindow' && args.url !== undefined && args.urls !== undefined) {
|
|
227
|
+
context.addIssue({ code: 'custom', message: 'newWindow 的 url 与 urls 互斥' });
|
|
228
|
+
}
|
|
229
|
+
if (args.action === 'updatePage' && args.active === false) {
|
|
230
|
+
context.addIssue({ code: 'custom', path: ['active'], message: 'updatePage 不支持 active=false,未执行' });
|
|
231
|
+
}
|
|
232
|
+
if (args.action === 'newWindow' &&
|
|
233
|
+
args.windowType === 'popup' &&
|
|
234
|
+
(args.urls?.length ?? (args.url !== undefined ? 1 : 0)) + (args.targetId !== undefined ? 1 : 0) > 1) {
|
|
235
|
+
context.addIssue({
|
|
236
|
+
code: 'custom',
|
|
237
|
+
path: ['windowType'],
|
|
238
|
+
message: 'popup 只支持一个页面,请使用 normal 窗口',
|
|
239
|
+
});
|
|
240
|
+
}
|
|
241
|
+
if (['newWindow', 'updateWindow', 'resizeWindow'].includes(args.action)) {
|
|
242
|
+
for (const field of ['width', 'height']) {
|
|
243
|
+
const value = args[field];
|
|
244
|
+
if (value !== undefined && (!Number.isInteger(value) || value <= 0)) {
|
|
245
|
+
context.addIssue({ code: 'custom', path: [field], message: '窗口尺寸必须是正整数' });
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
if (['minimized', 'maximized', 'fullscreen', 'locked-fullscreen'].includes(args.windowState ?? '') &&
|
|
249
|
+
[args.left, args.top, args.width, args.height].some((value) => value !== undefined)) {
|
|
250
|
+
context.addIssue({
|
|
251
|
+
code: 'custom',
|
|
252
|
+
path: ['windowState'],
|
|
253
|
+
message: '非 normal 窗口状态不能与窗口位置或尺寸同时设置',
|
|
254
|
+
});
|
|
255
|
+
}
|
|
256
|
+
if (args.action !== 'newWindow' &&
|
|
257
|
+
((args.focused === true && args.windowState === 'minimized') ||
|
|
258
|
+
(args.focused === false &&
|
|
259
|
+
['maximized', 'fullscreen', 'locked-fullscreen'].includes(args.windowState ?? '')))) {
|
|
260
|
+
context.addIssue({ code: 'custom', path: ['focused'], message: 'focused 与窗口状态冲突' });
|
|
261
|
+
}
|
|
262
|
+
}
|
|
97
263
|
});
|
|
98
264
|
async function handleManage(args) {
|
|
99
265
|
try {
|
|
100
266
|
const unifiedSession = getUnifiedSession();
|
|
101
267
|
const mode = unifiedSession.getMode();
|
|
102
|
-
|
|
268
|
+
const handler = async () => manageHandlers[args.action]({ unifiedSession, mode }, args);
|
|
269
|
+
const pageActions = [
|
|
270
|
+
'pageMetadata',
|
|
271
|
+
'closePage',
|
|
272
|
+
'adoptPage',
|
|
273
|
+
'releasePage',
|
|
274
|
+
'grantReadAccess',
|
|
275
|
+
'revokeReadAccess',
|
|
276
|
+
'updatePage',
|
|
277
|
+
'movePage',
|
|
278
|
+
'reorderPage',
|
|
279
|
+
'pinPage',
|
|
280
|
+
'unpinPage',
|
|
281
|
+
'activatePage',
|
|
282
|
+
'viewport',
|
|
283
|
+
'userAgent',
|
|
284
|
+
'emulate',
|
|
285
|
+
'stealth',
|
|
286
|
+
'cdp',
|
|
287
|
+
];
|
|
288
|
+
const conditional = args.expectedUrl !== undefined || args.expectedRevision !== undefined;
|
|
289
|
+
if (args.action === 'emulate' && !args.device) {
|
|
290
|
+
if (conditional) {
|
|
291
|
+
return invalidArgument('设备目录查询不支持页面条件,未读取页面');
|
|
292
|
+
}
|
|
293
|
+
return await handler();
|
|
294
|
+
}
|
|
295
|
+
if (args.action === 'newPage' && args.targetId) {
|
|
296
|
+
return invalidArgument('newPage 创建新页面,不接受已有 targetId');
|
|
297
|
+
}
|
|
298
|
+
if (conditional && !pageActions.includes(args.action)) {
|
|
299
|
+
return invalidArgument(`${args.action} 不支持页面条件,未执行操作`);
|
|
300
|
+
}
|
|
301
|
+
if (conditional &&
|
|
302
|
+
args.action === 'cdp' &&
|
|
303
|
+
(!args.cdpMethod || /^(Target|Browser|SystemInfo|DeviceAccess|IO)\./.test(args.cdpMethod))) {
|
|
304
|
+
return invalidArgument('browser-level CDP 命令不支持页面条件,未执行操作');
|
|
305
|
+
}
|
|
306
|
+
const targetSelectionActions = ['viewport', 'userAgent', 'emulate', 'stealth', 'cdp'];
|
|
307
|
+
const run = () => conditional
|
|
308
|
+
? targetSelectionActions.includes(args.action)
|
|
309
|
+
? unifiedSession.withTabId(args.targetId, () => unifiedSession.withPageCondition(args, handler))
|
|
310
|
+
: unifiedSession.withPageCondition(args, handler)
|
|
311
|
+
: handler();
|
|
312
|
+
if (pageActions.includes(args.action) ||
|
|
313
|
+
['newPage', 'newWindow', 'pageMetadata', 'clearCache'].includes(args.action)) {
|
|
314
|
+
return await withPageResponse(unifiedSession, args.targetId, run, args.action === 'newPage' || (args.action === 'newWindow' && args.targetId === undefined));
|
|
315
|
+
}
|
|
316
|
+
return await run();
|
|
103
317
|
}
|
|
104
318
|
catch (error) {
|
|
105
319
|
return formatErrorResponse(error);
|
|
106
320
|
}
|
|
107
321
|
}
|
|
108
|
-
async function handleNewPage({ unifiedSession
|
|
109
|
-
const target = await unifiedSession.newPage(args.url
|
|
110
|
-
|
|
322
|
+
async function handleNewPage({ unifiedSession }, args) {
|
|
323
|
+
const target = await unifiedSession.newPage(args.url, {
|
|
324
|
+
windowId: args.windowId,
|
|
325
|
+
index: args.index,
|
|
326
|
+
groupId: args.groupId,
|
|
327
|
+
active: args.active,
|
|
328
|
+
pinned: args.pinned,
|
|
329
|
+
openerTabId: args.openerTabId,
|
|
330
|
+
}, args.timeout);
|
|
331
|
+
return formatResponse({
|
|
332
|
+
success: true,
|
|
333
|
+
action: 'newPage',
|
|
334
|
+
target,
|
|
335
|
+
createdTargetId: target.targetId,
|
|
336
|
+
metadata: unifiedSession.getPageMetadata(target.targetId),
|
|
337
|
+
mode: unifiedSession.getMode(),
|
|
338
|
+
});
|
|
339
|
+
}
|
|
340
|
+
async function handlePageMetadata({ unifiedSession, mode }, args) {
|
|
341
|
+
if (!args.targetId) {
|
|
342
|
+
return invalidArgument('pageMetadata 需要 targetId 参数');
|
|
343
|
+
}
|
|
344
|
+
await unifiedSession.getPageSnapshot(args.targetId);
|
|
345
|
+
const metadata = args.taskHint !== undefined || args.note !== undefined
|
|
346
|
+
? await unifiedSession.setPageMetadata(args.targetId, { taskHint: args.taskHint, note: args.note })
|
|
347
|
+
: unifiedSession.getPageMetadata(args.targetId);
|
|
348
|
+
return formatResponse({ success: true, action: 'pageMetadata', targetId: args.targetId, mode, metadata });
|
|
111
349
|
}
|
|
112
350
|
async function handleClosePage({ unifiedSession, mode }, args) {
|
|
351
|
+
if (!args.targetId) {
|
|
352
|
+
return invalidArgument('closePage 需要 targetId 参数,未关闭页面');
|
|
353
|
+
}
|
|
113
354
|
const affected = await unifiedSession.closePage(args.targetId);
|
|
114
355
|
return formatResponse({
|
|
115
356
|
success: true,
|
|
@@ -133,6 +374,65 @@ async function handleReleasePage({ unifiedSession, mode }, args) {
|
|
|
133
374
|
const result = await unifiedSession.releasePage(args.targetId);
|
|
134
375
|
return formatResponse({ success: true, action: 'releasePage', mode, targetId: args.targetId, ...result });
|
|
135
376
|
}
|
|
377
|
+
async function handleReadAccess({ unifiedSession, mode }, args) {
|
|
378
|
+
if (!args.targetId) {
|
|
379
|
+
return invalidArgument(`${args.action} 需要 targetId,未修改权限`);
|
|
380
|
+
}
|
|
381
|
+
const result = await unifiedSession.setReadAccess(args.targetId, args.action === 'grantReadAccess');
|
|
382
|
+
return formatResponse({ ...result, action: args.action, mode });
|
|
383
|
+
}
|
|
384
|
+
async function handleUpdatePage({ unifiedSession, mode }, args) {
|
|
385
|
+
if (!args.targetId) {
|
|
386
|
+
return invalidArgument('updatePage 需要 targetId 参数,未执行');
|
|
387
|
+
}
|
|
388
|
+
const affected = await unifiedSession.updatePage(args.targetId, {
|
|
389
|
+
url: args.url,
|
|
390
|
+
active: args.active,
|
|
391
|
+
pinned: args.pinned,
|
|
392
|
+
highlighted: args.highlighted,
|
|
393
|
+
muted: args.muted,
|
|
394
|
+
autoDiscardable: args.autoDiscardable,
|
|
395
|
+
openerTabId: args.openerTabId,
|
|
396
|
+
});
|
|
397
|
+
return formatAffectedResponse('updatePage', mode, affected);
|
|
398
|
+
}
|
|
399
|
+
async function handleGroupPages({ unifiedSession, mode }, args) {
|
|
400
|
+
if (!args.targetIds) {
|
|
401
|
+
return invalidArgument('groupPages 需要 targetIds 参数,未执行');
|
|
402
|
+
}
|
|
403
|
+
const affected = await unifiedSession.groupPages(args.targetIds, {
|
|
404
|
+
groupId: args.groupId,
|
|
405
|
+
windowId: args.windowId,
|
|
406
|
+
title: args.title,
|
|
407
|
+
color: args.color,
|
|
408
|
+
collapsed: args.collapsed,
|
|
409
|
+
});
|
|
410
|
+
return formatAffectedResponse('groupPages', mode, affected);
|
|
411
|
+
}
|
|
412
|
+
async function handleUngroupPages({ unifiedSession, mode }, args) {
|
|
413
|
+
if (!args.targetIds) {
|
|
414
|
+
return invalidArgument('ungroupPages 需要 targetIds 参数,未执行');
|
|
415
|
+
}
|
|
416
|
+
return formatAffectedResponse('ungroupPages', mode, await unifiedSession.ungroupPages(args.targetIds));
|
|
417
|
+
}
|
|
418
|
+
async function handleUpdateGroup({ unifiedSession, mode }, args) {
|
|
419
|
+
if (args.groupId === undefined) {
|
|
420
|
+
return invalidArgument('updateGroup 需要 groupId 参数,未执行');
|
|
421
|
+
}
|
|
422
|
+
const affected = await unifiedSession.updateGroup(args.groupId, {
|
|
423
|
+
title: args.title,
|
|
424
|
+
color: args.color,
|
|
425
|
+
collapsed: args.collapsed,
|
|
426
|
+
});
|
|
427
|
+
return formatAffectedResponse('updateGroup', mode, affected);
|
|
428
|
+
}
|
|
429
|
+
async function handleMoveGroup({ unifiedSession, mode }, args) {
|
|
430
|
+
if (args.groupId === undefined || args.index === undefined) {
|
|
431
|
+
return invalidArgument('moveGroup 需要 groupId 和 index 参数,未执行');
|
|
432
|
+
}
|
|
433
|
+
const affected = await unifiedSession.moveGroup(args.groupId, { windowId: args.windowId, index: args.index });
|
|
434
|
+
return formatAffectedResponse('moveGroup', mode, affected);
|
|
435
|
+
}
|
|
136
436
|
async function handleMovePage({ unifiedSession, mode }, args) {
|
|
137
437
|
if (!args.targetId) {
|
|
138
438
|
return invalidArgument('movePage 需要 targetId 参数', '请先使用 browse(action="list") 获取目标 tab 的 targetId');
|
|
@@ -192,12 +492,32 @@ async function handleResizeWindow({ unifiedSession, mode }, args) {
|
|
|
192
492
|
width: args.width,
|
|
193
493
|
height: args.height,
|
|
194
494
|
state: args.windowState,
|
|
495
|
+
focused: args.focused,
|
|
496
|
+
drawAttention: args.drawAttention,
|
|
195
497
|
});
|
|
196
498
|
return formatAffectedResponse('resizeWindow', mode, affected);
|
|
197
499
|
}
|
|
500
|
+
async function handleUpdateWindow({ unifiedSession, mode }, args) {
|
|
501
|
+
if (args.windowId === undefined) {
|
|
502
|
+
return invalidArgument('updateWindow 需要 windowId 参数,未执行');
|
|
503
|
+
}
|
|
504
|
+
const affected = await unifiedSession.updateWindow(args.windowId, {
|
|
505
|
+
left: args.left,
|
|
506
|
+
top: args.top,
|
|
507
|
+
width: args.width,
|
|
508
|
+
height: args.height,
|
|
509
|
+
state: args.windowState,
|
|
510
|
+
focused: args.focused,
|
|
511
|
+
drawAttention: args.drawAttention,
|
|
512
|
+
});
|
|
513
|
+
return formatAffectedResponse('updateWindow', mode, affected);
|
|
514
|
+
}
|
|
198
515
|
async function handleNewWindow({ unifiedSession, mode }, args) {
|
|
199
516
|
const affected = await unifiedSession.newWindow({
|
|
200
|
-
url: args.url,
|
|
517
|
+
url: args.urls ?? args.url,
|
|
518
|
+
targetId: args.targetId,
|
|
519
|
+
type: args.windowType,
|
|
520
|
+
setSelfAsOpener: args.setSelfAsOpener,
|
|
201
521
|
focused: args.focused,
|
|
202
522
|
incognito: args.incognito,
|
|
203
523
|
left: args.left,
|
|
@@ -206,7 +526,15 @@ async function handleNewWindow({ unifiedSession, mode }, args) {
|
|
|
206
526
|
height: args.height,
|
|
207
527
|
state: args.windowState,
|
|
208
528
|
});
|
|
209
|
-
return
|
|
529
|
+
return formatResponse({
|
|
530
|
+
success: true,
|
|
531
|
+
action: 'newWindow',
|
|
532
|
+
mode,
|
|
533
|
+
affected,
|
|
534
|
+
...(args.targetId === undefined
|
|
535
|
+
? { createdTargetId: affected.targetId ?? null }
|
|
536
|
+
: { targetId: affected.targetId }),
|
|
537
|
+
});
|
|
210
538
|
}
|
|
211
539
|
async function handleCloseWindow({ unifiedSession, mode }, args) {
|
|
212
540
|
if (args.windowId === undefined) {
|
|
@@ -216,7 +544,7 @@ async function handleCloseWindow({ unifiedSession, mode }, args) {
|
|
|
216
544
|
return formatAffectedResponse('closeWindow', mode, affected);
|
|
217
545
|
}
|
|
218
546
|
async function handleClearCache({ unifiedSession, mode }, args) {
|
|
219
|
-
return unifiedSession.withTabId(
|
|
547
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
220
548
|
const cacheType = (args.cacheType ?? 'all');
|
|
221
549
|
if (mode === 'extension') {
|
|
222
550
|
return {
|
|
@@ -246,30 +574,24 @@ async function handleClearCache({ unifiedSession, mode }, args) {
|
|
|
246
574
|
});
|
|
247
575
|
}
|
|
248
576
|
async function handleViewport({ unifiedSession, mode }, args) {
|
|
249
|
-
return unifiedSession.withTabId(
|
|
577
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
250
578
|
if (args.width === undefined || args.height === undefined) {
|
|
251
579
|
return invalidArgument('设置视口需要 width 和 height 参数');
|
|
252
580
|
}
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
}
|
|
263
|
-
else {
|
|
264
|
-
const session = getSession();
|
|
265
|
-
await session.setViewport(args.width, args.height);
|
|
266
|
-
}
|
|
267
|
-
await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))');
|
|
581
|
+
await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
|
|
582
|
+
width: args.width,
|
|
583
|
+
height: args.height,
|
|
584
|
+
deviceScaleFactor: 1,
|
|
585
|
+
mobile: false,
|
|
586
|
+
});
|
|
587
|
+
await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
|
|
588
|
+
await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', { enabled: false });
|
|
589
|
+
await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))', 'precise');
|
|
268
590
|
return formatResponse({ success: true, action: 'viewport', width: args.width, height: args.height, mode });
|
|
269
591
|
});
|
|
270
592
|
}
|
|
271
593
|
async function handleUserAgent({ unifiedSession, mode }, args) {
|
|
272
|
-
return unifiedSession.withTabId(
|
|
594
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
273
595
|
if (!args.userAgent) {
|
|
274
596
|
return invalidArgument('设置 User-Agent 需要 userAgent 参数');
|
|
275
597
|
}
|
|
@@ -300,34 +622,27 @@ function handleInputMode({ unifiedSession, mode }, args) {
|
|
|
300
622
|
return formatResponse({ success: true, action: 'inputMode', inputMode: args.inputMode, mode });
|
|
301
623
|
}
|
|
302
624
|
async function handleEmulate({ unifiedSession, mode }, args) {
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
}
|
|
325
|
-
else {
|
|
326
|
-
const session = getSession();
|
|
327
|
-
await session.setViewport(device.viewport.width, device.viewport.height);
|
|
328
|
-
await session.setUserAgent(device.userAgent);
|
|
329
|
-
}
|
|
330
|
-
await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))');
|
|
625
|
+
if (!args.device) {
|
|
626
|
+
return formatResponse({ success: true, action: 'emulate', availableDevices: Object.keys(devices) });
|
|
627
|
+
}
|
|
628
|
+
const device = devices[args.device];
|
|
629
|
+
if (!device) {
|
|
630
|
+
return invalidArgument(`未知设备: ${args.device}`, `可用设备: ${Object.keys(devices).join(', ')}`);
|
|
631
|
+
}
|
|
632
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
633
|
+
await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
|
|
634
|
+
width: device.viewport.width,
|
|
635
|
+
height: device.viewport.height,
|
|
636
|
+
deviceScaleFactor: device.viewport.deviceScaleFactor || 1,
|
|
637
|
+
mobile: device.viewport.isMobile || false,
|
|
638
|
+
});
|
|
639
|
+
await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
|
|
640
|
+
await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', {
|
|
641
|
+
enabled: device.viewport.hasTouch,
|
|
642
|
+
maxTouchPoints: device.viewport.hasTouch ? 1 : 0,
|
|
643
|
+
});
|
|
644
|
+
await unifiedSession.sendCdpCommand('Emulation.setUserAgentOverride', { userAgent: device.userAgent });
|
|
645
|
+
await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))', 'precise');
|
|
331
646
|
return formatResponse({
|
|
332
647
|
success: true,
|
|
333
648
|
action: 'emulate',
|
|
@@ -337,14 +652,14 @@ async function handleEmulate({ unifiedSession, mode }, args) {
|
|
|
337
652
|
});
|
|
338
653
|
});
|
|
339
654
|
}
|
|
340
|
-
async function handleStealth({ unifiedSession, mode }) {
|
|
341
|
-
return unifiedSession.withTabId(
|
|
655
|
+
async function handleStealth({ unifiedSession, mode }, args) {
|
|
656
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
342
657
|
await unifiedSession.injectStealth();
|
|
343
658
|
return formatResponse({ success: true, action: 'stealth', mode, note: '已注入反检测脚本' });
|
|
344
659
|
});
|
|
345
660
|
}
|
|
346
661
|
async function handleCdp({ unifiedSession, mode }, args) {
|
|
347
|
-
return unifiedSession.withTabId(
|
|
662
|
+
return unifiedSession.withTabId(args.targetId, async () => {
|
|
348
663
|
if (!args.cdpMethod) {
|
|
349
664
|
return invalidArgument('缺少 cdpMethod 参数', '请指定 CDP 方法名,如 Runtime.evaluate、Page.captureScreenshot');
|
|
350
665
|
}
|
|
@@ -353,36 +668,25 @@ async function handleCdp({ unifiedSession, mode }, args) {
|
|
|
353
668
|
return formatResponse({ success: true, action: 'cdp', method: args.cdpMethod, result, mode });
|
|
354
669
|
}
|
|
355
670
|
catch (error) {
|
|
356
|
-
const
|
|
357
|
-
if (
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
content: [
|
|
362
|
-
{
|
|
363
|
-
type: 'text',
|
|
364
|
-
text: JSON.stringify({
|
|
365
|
-
error: {
|
|
366
|
-
code: 'CDP_DOMAIN_NOT_SUPPORTED',
|
|
367
|
-
message: `Extension 模式不支持 ${domain} 域`,
|
|
368
|
-
suggestion: 'Extension 模式可用域:Page、Runtime、Emulation、DOM、Input、Network,' +
|
|
369
|
-
'如需完整 CDP 支持,请使用 CDP 模式(browse action="launch")',
|
|
370
|
-
},
|
|
371
|
-
}),
|
|
372
|
-
},
|
|
373
|
-
],
|
|
374
|
-
isError: true,
|
|
375
|
-
};
|
|
671
|
+
const response = formatErrorResponse(error);
|
|
672
|
+
if (isNativeExecutionResultUnknown(error)) {
|
|
673
|
+
const payload = JSON.parse(response.content[0].text);
|
|
674
|
+
Object.assign(payload, { actionExecuted: true, actionStatus: 'unknown', retryable: false });
|
|
675
|
+
response.content[0].text = JSON.stringify(payload, null, 2);
|
|
376
676
|
}
|
|
377
|
-
return
|
|
677
|
+
return response;
|
|
378
678
|
}
|
|
379
679
|
});
|
|
380
680
|
}
|
|
381
681
|
const manageHandlers = {
|
|
382
682
|
newPage: handleNewPage,
|
|
683
|
+
pageMetadata: handlePageMetadata,
|
|
383
684
|
closePage: handleClosePage,
|
|
384
685
|
adoptPage: handleAdoptPage,
|
|
385
686
|
releasePage: handleReleasePage,
|
|
687
|
+
grantReadAccess: handleReadAccess,
|
|
688
|
+
revokeReadAccess: handleReadAccess,
|
|
689
|
+
updatePage: handleUpdatePage,
|
|
386
690
|
movePage: handleMovePage,
|
|
387
691
|
reorderPage: handleReorderPage,
|
|
388
692
|
pinPage: handlePinPage,
|
|
@@ -392,6 +696,11 @@ const manageHandlers = {
|
|
|
392
696
|
resizeWindow: handleResizeWindow,
|
|
393
697
|
newWindow: handleNewWindow,
|
|
394
698
|
closeWindow: handleCloseWindow,
|
|
699
|
+
updateWindow: handleUpdateWindow,
|
|
700
|
+
groupPages: handleGroupPages,
|
|
701
|
+
ungroupPages: handleUngroupPages,
|
|
702
|
+
updateGroup: handleUpdateGroup,
|
|
703
|
+
moveGroup: handleMoveGroup,
|
|
395
704
|
clearCache: handleClearCache,
|
|
396
705
|
viewport: handleViewport,
|
|
397
706
|
userAgent: handleUserAgent,
|
|
@@ -402,7 +711,7 @@ const manageHandlers = {
|
|
|
402
711
|
};
|
|
403
712
|
export function registerManageTool(server) {
|
|
404
713
|
server.registerTool('manage', {
|
|
405
|
-
description: '
|
|
714
|
+
description: '页面、窗口与分组管理:创建、更新、移动、关闭,受控页 adopt/release,分组成员、名称、颜色和折叠;缓存、视口、UA、设备模拟',
|
|
406
715
|
inputSchema: manageSchema,
|
|
407
716
|
}, (args) => handleManage(args));
|
|
408
717
|
}
|