@pyrokine/mcp-chrome 2.4.4 → 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.
Files changed (116) hide show
  1. package/README.md +401 -102
  2. package/README_zh.md +319 -79
  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 +101 -12
  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 +16 -0
  20. package/dist/core/errors.d.ts.map +1 -1
  21. package/dist/core/errors.js +77 -0
  22. package/dist/core/errors.js.map +1 -1
  23. package/dist/core/locator.d.ts.map +1 -1
  24. package/dist/core/locator.js +6 -4
  25. package/dist/core/locator.js.map +1 -1
  26. package/dist/core/os-mouse.d.ts +15 -2
  27. package/dist/core/os-mouse.d.ts.map +1 -1
  28. package/dist/core/os-mouse.js +52 -8
  29. package/dist/core/os-mouse.js.map +1 -1
  30. package/dist/core/session.d.ts +34 -19
  31. package/dist/core/session.d.ts.map +1 -1
  32. package/dist/core/session.js +574 -130
  33. package/dist/core/session.js.map +1 -1
  34. package/dist/core/types.d.ts +2 -0
  35. package/dist/core/types.d.ts.map +1 -1
  36. package/dist/core/types.js.map +1 -1
  37. package/dist/core/unified-session.d.ts +95 -20
  38. package/dist/core/unified-session.d.ts.map +1 -1
  39. package/dist/core/unified-session.js +489 -117
  40. package/dist/core/unified-session.js.map +1 -1
  41. package/dist/core/utils.d.ts +5 -0
  42. package/dist/core/utils.d.ts.map +1 -1
  43. package/dist/core/utils.js +475 -54
  44. package/dist/core/utils.js.map +1 -1
  45. package/dist/extension/bridge.d.ts +46 -36
  46. package/dist/extension/bridge.d.ts.map +1 -1
  47. package/dist/extension/bridge.js +269 -112
  48. package/dist/extension/bridge.js.map +1 -1
  49. package/dist/extension/http-server.d.ts +3 -0
  50. package/dist/extension/http-server.d.ts.map +1 -1
  51. package/dist/extension/http-server.js +19 -2
  52. package/dist/extension/http-server.js.map +1 -1
  53. package/dist/index.js +7 -0
  54. package/dist/index.js.map +1 -1
  55. package/dist/tools/browse.d.ts.map +1 -1
  56. package/dist/tools/browse.js +241 -171
  57. package/dist/tools/browse.js.map +1 -1
  58. package/dist/tools/challenge.d.ts +1 -1
  59. package/dist/tools/challenge.d.ts.map +1 -1
  60. package/dist/tools/challenge.js +75 -37
  61. package/dist/tools/challenge.js.map +1 -1
  62. package/dist/tools/cookies.d.ts.map +1 -1
  63. package/dist/tools/cookies.js +5 -3
  64. package/dist/tools/cookies.js.map +1 -1
  65. package/dist/tools/diagnostics.d.ts +3 -3
  66. package/dist/tools/diagnostics.d.ts.map +1 -1
  67. package/dist/tools/diagnostics.js +13 -12
  68. package/dist/tools/diagnostics.js.map +1 -1
  69. package/dist/tools/evaluate.d.ts.map +1 -1
  70. package/dist/tools/evaluate.js +57 -26
  71. package/dist/tools/evaluate.js.map +1 -1
  72. package/dist/tools/extract.d.ts.map +1 -1
  73. package/dist/tools/extract.js +107 -175
  74. package/dist/tools/extract.js.map +1 -1
  75. package/dist/tools/input.d.ts +1 -1
  76. package/dist/tools/input.d.ts.map +1 -1
  77. package/dist/tools/input.js +380 -158
  78. package/dist/tools/input.js.map +1 -1
  79. package/dist/tools/logs.d.ts.map +1 -1
  80. package/dist/tools/logs.js +5 -5
  81. package/dist/tools/logs.js.map +1 -1
  82. package/dist/tools/manage.d.ts.map +1 -1
  83. package/dist/tools/manage.js +380 -57
  84. package/dist/tools/manage.js.map +1 -1
  85. package/dist/tools/page-context.d.ts +17 -0
  86. package/dist/tools/page-context.d.ts.map +1 -0
  87. package/dist/tools/page-context.js +103 -0
  88. package/dist/tools/page-context.js.map +1 -0
  89. package/dist/tools/png.d.ts +5 -0
  90. package/dist/tools/png.d.ts.map +1 -1
  91. package/dist/tools/png.js +84 -19
  92. package/dist/tools/png.js.map +1 -1
  93. package/dist/tools/post-condition.d.ts.map +1 -1
  94. package/dist/tools/post-condition.js +5 -2
  95. package/dist/tools/post-condition.js.map +1 -1
  96. package/dist/tools/schema.d.ts +9 -0
  97. package/dist/tools/schema.d.ts.map +1 -1
  98. package/dist/tools/schema.js +15 -0
  99. package/dist/tools/schema.js.map +1 -1
  100. package/dist/tools/target-diagnostics.d.ts.map +1 -1
  101. package/dist/tools/target-diagnostics.js +32 -19
  102. package/dist/tools/target-diagnostics.js.map +1 -1
  103. package/dist/tools/wait.d.ts.map +1 -1
  104. package/dist/tools/wait.js +19 -25
  105. package/dist/tools/wait.js.map +1 -1
  106. package/extension/dist/assets/content.ts-C4imZ6A9.js +13 -0
  107. package/extension/dist/assets/content.ts-loader-CnJuCGhl.js +13 -0
  108. package/extension/dist/assets/{index.ts-Bqcu2qiN.js → index.ts-GeHNZBml.js} +2040 -2111
  109. package/extension/dist/assets/page-scripts-CMIY1zhd.js +1379 -0
  110. package/extension/dist/assets/{popup.html-B81xccfq.js → popup.html-CgtWL6Py.js} +48 -1
  111. package/extension/dist/manifest.json +4 -3
  112. package/extension/dist/service-worker-loader.js +1 -1
  113. package/extension/dist/src/popup/popup.html +11 -1
  114. package/package.json +9 -7
  115. package/scripts/start-chrome.ps1 +58 -0
  116. 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,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
- return await manageHandlers[args.action]({ unifiedSession, mode }, args);
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, mode }, args) {
109
- const target = await unifiedSession.newPage(args.url);
110
- return formatResponse({ success: true, action: 'newPage', target, mode });
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 formatAffectedResponse('newWindow', mode, affected);
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,7 +537,7 @@ 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(undefined, async () => {
540
+ return unifiedSession.withTabId(args.targetId, async () => {
220
541
  const cacheType = (args.cacheType ?? 'all');
221
542
  if (mode === 'extension') {
222
543
  return {
@@ -246,30 +567,24 @@ async function handleClearCache({ unifiedSession, mode }, args) {
246
567
  });
247
568
  }
248
569
  async function handleViewport({ unifiedSession, mode }, args) {
249
- return unifiedSession.withTabId(undefined, async () => {
570
+ return unifiedSession.withTabId(args.targetId, async () => {
250
571
  if (args.width === undefined || args.height === undefined) {
251
572
  return invalidArgument('设置视口需要 width 和 height 参数');
252
573
  }
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
- }
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 });
267
582
  await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))');
268
583
  return formatResponse({ success: true, action: 'viewport', width: args.width, height: args.height, mode });
269
584
  });
270
585
  }
271
586
  async function handleUserAgent({ unifiedSession, mode }, args) {
272
- return unifiedSession.withTabId(undefined, async () => {
587
+ return unifiedSession.withTabId(args.targetId, async () => {
273
588
  if (!args.userAgent) {
274
589
  return invalidArgument('设置 User-Agent 需要 userAgent 参数');
275
590
  }
@@ -300,7 +615,7 @@ function handleInputMode({ unifiedSession, mode }, args) {
300
615
  return formatResponse({ success: true, action: 'inputMode', inputMode: args.inputMode, mode });
301
616
  }
302
617
  async function handleEmulate({ unifiedSession, mode }, args) {
303
- return unifiedSession.withTabId(undefined, async () => {
618
+ return unifiedSession.withTabId(args.targetId, async () => {
304
619
  if (!args.device) {
305
620
  return formatResponse({ success: true, action: 'emulate', availableDevices: Object.keys(devices) });
306
621
  }
@@ -308,25 +623,18 @@ async function handleEmulate({ unifiedSession, mode }, args) {
308
623
  if (!device) {
309
624
  return invalidArgument(`未知设备: ${args.device}`, `可用设备: ${Object.keys(devices).join(', ')}`);
310
625
  }
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
- }
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 });
330
638
  await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))');
331
639
  return formatResponse({
332
640
  success: true,
@@ -337,14 +645,14 @@ async function handleEmulate({ unifiedSession, mode }, args) {
337
645
  });
338
646
  });
339
647
  }
340
- async function handleStealth({ unifiedSession, mode }) {
341
- return unifiedSession.withTabId(undefined, async () => {
648
+ async function handleStealth({ unifiedSession, mode }, args) {
649
+ return unifiedSession.withTabId(args.targetId, async () => {
342
650
  await unifiedSession.injectStealth();
343
651
  return formatResponse({ success: true, action: 'stealth', mode, note: '已注入反检测脚本' });
344
652
  });
345
653
  }
346
654
  async function handleCdp({ unifiedSession, mode }, args) {
347
- return unifiedSession.withTabId(undefined, async () => {
655
+ return unifiedSession.withTabId(args.targetId, async () => {
348
656
  if (!args.cdpMethod) {
349
657
  return invalidArgument('缺少 cdpMethod 参数', '请指定 CDP 方法名,如 Runtime.evaluate、Page.captureScreenshot');
350
658
  }
@@ -374,15 +682,25 @@ async function handleCdp({ unifiedSession, mode }, args) {
374
682
  isError: true,
375
683
  };
376
684
  }
377
- return formatErrorResponse(error);
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;
378
692
  }
379
693
  });
380
694
  }
381
695
  const manageHandlers = {
382
696
  newPage: handleNewPage,
697
+ pageMetadata: handlePageMetadata,
383
698
  closePage: handleClosePage,
384
699
  adoptPage: handleAdoptPage,
385
700
  releasePage: handleReleasePage,
701
+ grantReadAccess: handleReadAccess,
702
+ revokeReadAccess: handleReadAccess,
703
+ updatePage: handleUpdatePage,
386
704
  movePage: handleMovePage,
387
705
  reorderPage: handleReorderPage,
388
706
  pinPage: handlePinPage,
@@ -392,6 +710,11 @@ const manageHandlers = {
392
710
  resizeWindow: handleResizeWindow,
393
711
  newWindow: handleNewWindow,
394
712
  closeWindow: handleCloseWindow,
713
+ updateWindow: handleUpdateWindow,
714
+ groupPages: handleGroupPages,
715
+ ungroupPages: handleUngroupPages,
716
+ updateGroup: handleUpdateGroup,
717
+ moveGroup: handleMoveGroup,
395
718
  clearCache: handleClearCache,
396
719
  viewport: handleViewport,
397
720
  userAgent: handleUserAgent,
@@ -402,7 +725,7 @@ const manageHandlers = {
402
725
  };
403
726
  export function registerManageTool(server) {
404
727
  server.registerTool('manage', {
405
- description: '页面与环境管理:新建页面、关闭页面、受控页 adopt/release、缓存、视口、UA、设备模拟',
728
+ description: '页面、窗口与分组管理:创建、更新、移动、关闭,受控页 adopt/release,分组成员、名称、颜色和折叠;缓存、视口、UA、设备模拟',
406
729
  inputSchema: manageSchema,
407
730
  }, (args) => handleManage(args));
408
731
  }