@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.
Files changed (118) hide show
  1. package/README.md +495 -115
  2. package/README_zh.md +423 -128
  3. package/dist/anti-detection/injection.js +3 -3
  4. package/dist/cdp/client.d.ts +1 -1
  5. package/dist/cdp/client.d.ts.map +1 -1
  6. package/dist/cdp/client.js +18 -7
  7. package/dist/cdp/client.js.map +1 -1
  8. package/dist/cdp/launcher.d.ts +2 -3
  9. package/dist/cdp/launcher.d.ts.map +1 -1
  10. package/dist/cdp/launcher.js +84 -24
  11. package/dist/cdp/launcher.js.map +1 -1
  12. package/dist/core/auto-wait.d.ts +3 -3
  13. package/dist/core/auto-wait.d.ts.map +1 -1
  14. package/dist/core/auto-wait.js +45 -20
  15. package/dist/core/auto-wait.js.map +1 -1
  16. package/dist/core/browser-driver.d.ts +105 -15
  17. package/dist/core/browser-driver.d.ts.map +1 -1
  18. package/dist/core/browser-driver.js.map +1 -1
  19. package/dist/core/errors.d.ts +22 -4
  20. package/dist/core/errors.d.ts.map +1 -1
  21. package/dist/core/errors.js +90 -7
  22. package/dist/core/errors.js.map +1 -1
  23. package/dist/core/locator.d.ts +7 -0
  24. package/dist/core/locator.d.ts.map +1 -1
  25. package/dist/core/locator.js +54 -29
  26. package/dist/core/locator.js.map +1 -1
  27. package/dist/core/os-mouse.d.ts +15 -2
  28. package/dist/core/os-mouse.d.ts.map +1 -1
  29. package/dist/core/os-mouse.js +52 -8
  30. package/dist/core/os-mouse.js.map +1 -1
  31. package/dist/core/session.d.ts +39 -22
  32. package/dist/core/session.d.ts.map +1 -1
  33. package/dist/core/session.js +632 -153
  34. package/dist/core/session.js.map +1 -1
  35. package/dist/core/types.d.ts +2 -0
  36. package/dist/core/types.d.ts.map +1 -1
  37. package/dist/core/types.js.map +1 -1
  38. package/dist/core/unified-session.d.ts +105 -27
  39. package/dist/core/unified-session.d.ts.map +1 -1
  40. package/dist/core/unified-session.js +554 -138
  41. package/dist/core/unified-session.js.map +1 -1
  42. package/dist/core/utils.d.ts +5 -0
  43. package/dist/core/utils.d.ts.map +1 -1
  44. package/dist/core/utils.js +475 -54
  45. package/dist/core/utils.js.map +1 -1
  46. package/dist/extension/bridge.d.ts +49 -39
  47. package/dist/extension/bridge.d.ts.map +1 -1
  48. package/dist/extension/bridge.js +318 -131
  49. package/dist/extension/bridge.js.map +1 -1
  50. package/dist/extension/http-server.d.ts +3 -0
  51. package/dist/extension/http-server.d.ts.map +1 -1
  52. package/dist/extension/http-server.js +28 -2
  53. package/dist/extension/http-server.js.map +1 -1
  54. package/dist/index.js +7 -0
  55. package/dist/index.js.map +1 -1
  56. package/dist/tools/browse.d.ts.map +1 -1
  57. package/dist/tools/browse.js +248 -172
  58. package/dist/tools/browse.js.map +1 -1
  59. package/dist/tools/challenge.d.ts +1 -1
  60. package/dist/tools/challenge.d.ts.map +1 -1
  61. package/dist/tools/challenge.js +86 -51
  62. package/dist/tools/challenge.js.map +1 -1
  63. package/dist/tools/cookies.d.ts.map +1 -1
  64. package/dist/tools/cookies.js +5 -3
  65. package/dist/tools/cookies.js.map +1 -1
  66. package/dist/tools/diagnostics.d.ts +3 -3
  67. package/dist/tools/diagnostics.d.ts.map +1 -1
  68. package/dist/tools/diagnostics.js +13 -12
  69. package/dist/tools/diagnostics.js.map +1 -1
  70. package/dist/tools/evaluate.d.ts.map +1 -1
  71. package/dist/tools/evaluate.js +67 -26
  72. package/dist/tools/evaluate.js.map +1 -1
  73. package/dist/tools/extract.d.ts.map +1 -1
  74. package/dist/tools/extract.js +137 -197
  75. package/dist/tools/extract.js.map +1 -1
  76. package/dist/tools/input.d.ts +1 -1
  77. package/dist/tools/input.d.ts.map +1 -1
  78. package/dist/tools/input.js +445 -197
  79. package/dist/tools/input.js.map +1 -1
  80. package/dist/tools/logs.d.ts.map +1 -1
  81. package/dist/tools/logs.js +5 -5
  82. package/dist/tools/logs.js.map +1 -1
  83. package/dist/tools/manage.d.ts.map +1 -1
  84. package/dist/tools/manage.js +395 -86
  85. package/dist/tools/manage.js.map +1 -1
  86. package/dist/tools/page-context.d.ts +17 -0
  87. package/dist/tools/page-context.d.ts.map +1 -0
  88. package/dist/tools/page-context.js +103 -0
  89. package/dist/tools/page-context.js.map +1 -0
  90. package/dist/tools/png.d.ts +5 -0
  91. package/dist/tools/png.d.ts.map +1 -1
  92. package/dist/tools/png.js +84 -19
  93. package/dist/tools/png.js.map +1 -1
  94. package/dist/tools/post-condition.d.ts.map +1 -1
  95. package/dist/tools/post-condition.js +24 -7
  96. package/dist/tools/post-condition.js.map +1 -1
  97. package/dist/tools/schema.d.ts +9 -0
  98. package/dist/tools/schema.d.ts.map +1 -1
  99. package/dist/tools/schema.js +15 -0
  100. package/dist/tools/schema.js.map +1 -1
  101. package/dist/tools/target-diagnostics.d.ts +9 -1
  102. package/dist/tools/target-diagnostics.d.ts.map +1 -1
  103. package/dist/tools/target-diagnostics.js +89 -33
  104. package/dist/tools/target-diagnostics.js.map +1 -1
  105. package/dist/tools/wait.d.ts.map +1 -1
  106. package/dist/tools/wait.js +38 -32
  107. package/dist/tools/wait.js.map +1 -1
  108. package/extension/dist/assets/content.ts-loader-DUWbDHRS.js +13 -0
  109. package/extension/dist/assets/content.ts-qe6IB5DK.js +13 -0
  110. package/extension/dist/assets/{index.ts-Bqcu2qiN.js → index.ts-D7_LCUoV.js} +2477 -2201
  111. package/extension/dist/assets/page-scripts-D508WLkW.js +1378 -0
  112. package/extension/dist/assets/{popup.html-B81xccfq.js → popup.html-B-eVq48O.js} +54 -5
  113. package/extension/dist/manifest.json +4 -3
  114. package/extension/dist/service-worker-loader.js +1 -1
  115. package/extension/dist/src/popup/popup.html +11 -1
  116. package/package.json +16 -8
  117. package/scripts/start-chrome.ps1 +58 -0
  118. package/extension/dist/assets/content.ts-Cj_iiU2s.js +0 -25
@@ -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.object({
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
- .string()
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('目标页面 ID(closePage/adoptPage/releasePage/movePage/reorderPage/pinPage/unpinPage/activatePage)'),
77
- windowId: z.number().int().optional().describe('窗口 ID(movePage/focusWindow/resizeWindow/closeWindow)'),
78
- index: z.number().int().nonnegative().optional().describe('tab 顺序 index(movePage/reorderPage)'),
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.boolean().optional().describe('newWindow 是否聚焦新窗口,默认 false'),
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
- return await manageHandlers[args.action]({ unifiedSession, mode }, args);
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, mode }, args) {
109
- const target = await unifiedSession.newPage(args.url);
110
- return formatResponse({ success: true, action: 'newPage', target, mode });
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 formatAffectedResponse('newWindow', mode, affected);
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(undefined, async () => {
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(undefined, async () => {
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
- if (mode === 'extension') {
254
- await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
255
- width: args.width,
256
- height: args.height,
257
- deviceScaleFactor: 1,
258
- mobile: false,
259
- });
260
- await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
261
- await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', { enabled: false });
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(undefined, async () => {
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
- return unifiedSession.withTabId(undefined, async () => {
304
- if (!args.device) {
305
- return formatResponse({ success: true, action: 'emulate', availableDevices: Object.keys(devices) });
306
- }
307
- const device = devices[args.device];
308
- if (!device) {
309
- return invalidArgument(`未知设备: ${args.device}`, `可用设备: ${Object.keys(devices).join(', ')}`);
310
- }
311
- if (mode === 'extension') {
312
- await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
313
- width: device.viewport.width,
314
- height: device.viewport.height,
315
- deviceScaleFactor: device.viewport.deviceScaleFactor || 1,
316
- mobile: device.viewport.isMobile || false,
317
- });
318
- await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
319
- await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', {
320
- enabled: device.viewport.hasTouch,
321
- maxTouchPoints: device.viewport.hasTouch ? 1 : 0,
322
- });
323
- await unifiedSession.sendCdpCommand('Emulation.setUserAgentOverride', { userAgent: device.userAgent });
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(undefined, async () => {
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(undefined, async () => {
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 errorMessage = error instanceof Error ? error.message : String(error);
357
- if (mode === 'extension' &&
358
- (errorMessage.includes('not supported') || errorMessage.includes('not found'))) {
359
- const domain = args.cdpMethod.split('.')[0];
360
- return {
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 formatErrorResponse(error);
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: '页面与环境管理:新建页面、关闭页面、受控页 adopt/release、缓存、视口、UA、设备模拟',
714
+ description: '页面、窗口与分组管理:创建、更新、移动、关闭,受控页 adopt/release,分组成员、名称、颜色和折叠;缓存、视口、UA、设备模拟',
406
715
  inputSchema: manageSchema,
407
716
  }, (args) => handleManage(args));
408
717
  }