@pyrokine/mcp-chrome 2.4.1 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (141) hide show
  1. package/README.md +546 -192
  2. package/README_zh.md +490 -192
  3. package/dist/anti-detection/behavior.js +1 -1
  4. package/dist/anti-detection/behavior.js.map +1 -1
  5. package/dist/anti-detection/injection.d.ts.map +1 -1
  6. package/dist/anti-detection/injection.js +5 -4
  7. package/dist/anti-detection/injection.js.map +1 -1
  8. package/dist/cdp/client.d.ts +2 -2
  9. package/dist/cdp/client.d.ts.map +1 -1
  10. package/dist/cdp/client.js +24 -10
  11. package/dist/cdp/client.js.map +1 -1
  12. package/dist/cdp/launcher.d.ts +2 -3
  13. package/dist/cdp/launcher.d.ts.map +1 -1
  14. package/dist/cdp/launcher.js +84 -24
  15. package/dist/cdp/launcher.js.map +1 -1
  16. package/dist/core/auto-wait.d.ts +3 -3
  17. package/dist/core/auto-wait.d.ts.map +1 -1
  18. package/dist/core/auto-wait.js +45 -20
  19. package/dist/core/auto-wait.js.map +1 -1
  20. package/dist/core/browser-driver.d.ts +104 -14
  21. package/dist/core/browser-driver.d.ts.map +1 -1
  22. package/dist/core/browser-driver.js +1 -0
  23. package/dist/core/browser-driver.js.map +1 -1
  24. package/dist/core/errors.d.ts +25 -0
  25. package/dist/core/errors.d.ts.map +1 -1
  26. package/dist/core/errors.js +93 -1
  27. package/dist/core/errors.js.map +1 -1
  28. package/dist/core/locator.d.ts.map +1 -1
  29. package/dist/core/locator.js +6 -4
  30. package/dist/core/locator.js.map +1 -1
  31. package/dist/core/os-mouse.d.ts +78 -0
  32. package/dist/core/os-mouse.d.ts.map +1 -0
  33. package/dist/core/os-mouse.js +378 -0
  34. package/dist/core/os-mouse.js.map +1 -0
  35. package/dist/core/session.d.ts +46 -21
  36. package/dist/core/session.d.ts.map +1 -1
  37. package/dist/core/session.js +724 -175
  38. package/dist/core/session.js.map +1 -1
  39. package/dist/core/types.d.ts +12 -0
  40. package/dist/core/types.d.ts.map +1 -1
  41. package/dist/core/types.js +2 -0
  42. package/dist/core/types.js.map +1 -1
  43. package/dist/core/unified-session.d.ts +117 -21
  44. package/dist/core/unified-session.d.ts.map +1 -1
  45. package/dist/core/unified-session.js +619 -129
  46. package/dist/core/unified-session.js.map +1 -1
  47. package/dist/core/utils.d.ts +5 -0
  48. package/dist/core/utils.d.ts.map +1 -1
  49. package/dist/core/utils.js +475 -54
  50. package/dist/core/utils.js.map +1 -1
  51. package/dist/extension/bridge.d.ts +61 -35
  52. package/dist/extension/bridge.d.ts.map +1 -1
  53. package/dist/extension/bridge.js +290 -106
  54. package/dist/extension/bridge.js.map +1 -1
  55. package/dist/extension/http-server.d.ts +3 -0
  56. package/dist/extension/http-server.d.ts.map +1 -1
  57. package/dist/extension/http-server.js +25 -3
  58. package/dist/extension/http-server.js.map +1 -1
  59. package/dist/index.js +7 -0
  60. package/dist/index.js.map +1 -1
  61. package/dist/tools/browse.d.ts +1 -1
  62. package/dist/tools/browse.d.ts.map +1 -1
  63. package/dist/tools/browse.js +291 -175
  64. package/dist/tools/browse.js.map +1 -1
  65. package/dist/tools/challenge.d.ts +153 -0
  66. package/dist/tools/challenge.d.ts.map +1 -0
  67. package/dist/tools/challenge.js +611 -0
  68. package/dist/tools/challenge.js.map +1 -0
  69. package/dist/tools/cookies.d.ts.map +1 -1
  70. package/dist/tools/cookies.js +13 -7
  71. package/dist/tools/cookies.js.map +1 -1
  72. package/dist/tools/diagnostics.d.ts +5 -5
  73. package/dist/tools/diagnostics.d.ts.map +1 -1
  74. package/dist/tools/diagnostics.js +39 -20
  75. package/dist/tools/diagnostics.js.map +1 -1
  76. package/dist/tools/evaluate.d.ts.map +1 -1
  77. package/dist/tools/evaluate.js +106 -23
  78. package/dist/tools/evaluate.js.map +1 -1
  79. package/dist/tools/extract.d.ts.map +1 -1
  80. package/dist/tools/extract.js +199 -208
  81. package/dist/tools/extract.js.map +1 -1
  82. package/dist/tools/input.d.ts +1 -1
  83. package/dist/tools/input.d.ts.map +1 -1
  84. package/dist/tools/input.js +523 -175
  85. package/dist/tools/input.js.map +1 -1
  86. package/dist/tools/logs.d.ts.map +1 -1
  87. package/dist/tools/logs.js +7 -7
  88. package/dist/tools/logs.js.map +1 -1
  89. package/dist/tools/manage.d.ts.map +1 -1
  90. package/dist/tools/manage.js +400 -64
  91. package/dist/tools/manage.js.map +1 -1
  92. package/dist/tools/network-sanitizer.d.ts.map +1 -1
  93. package/dist/tools/network-sanitizer.js +1 -0
  94. package/dist/tools/network-sanitizer.js.map +1 -1
  95. package/dist/tools/page-context.d.ts +17 -0
  96. package/dist/tools/page-context.d.ts.map +1 -0
  97. package/dist/tools/page-context.js +103 -0
  98. package/dist/tools/page-context.js.map +1 -0
  99. package/dist/tools/png.d.ts +5 -0
  100. package/dist/tools/png.d.ts.map +1 -1
  101. package/dist/tools/png.js +89 -22
  102. package/dist/tools/png.js.map +1 -1
  103. package/dist/tools/post-condition.d.ts.map +1 -1
  104. package/dist/tools/post-condition.js +17 -5
  105. package/dist/tools/post-condition.js.map +1 -1
  106. package/dist/tools/schema.d.ts +9 -0
  107. package/dist/tools/schema.d.ts.map +1 -1
  108. package/dist/tools/schema.js +15 -0
  109. package/dist/tools/schema.js.map +1 -1
  110. package/dist/tools/target-diagnostics.d.ts +7 -0
  111. package/dist/tools/target-diagnostics.d.ts.map +1 -1
  112. package/dist/tools/target-diagnostics.js +47 -17
  113. package/dist/tools/target-diagnostics.js.map +1 -1
  114. package/dist/tools/wait.d.ts.map +1 -1
  115. package/dist/tools/wait.js +52 -56
  116. package/dist/tools/wait.js.map +1 -1
  117. package/extension/dist/assets/content.ts-C4imZ6A9.js +13 -0
  118. package/extension/dist/assets/content.ts-loader-CnJuCGhl.js +13 -0
  119. package/extension/dist/assets/{index.ts-GG6dPUPX.js → index.ts-GeHNZBml.js} +2156 -1950
  120. package/extension/dist/assets/page-scripts-CMIY1zhd.js +1379 -0
  121. package/extension/dist/assets/{popup.html-B81xccfq.js → popup.html-CgtWL6Py.js} +48 -1
  122. package/extension/dist/manifest.json +4 -3
  123. package/extension/dist/service-worker-loader.js +1 -1
  124. package/extension/dist/src/popup/popup.html +54 -44
  125. package/package.json +11 -8
  126. package/scripts/start-chrome.ps1 +58 -0
  127. package/dist/extension/native-host-installer.d.ts +0 -21
  128. package/dist/extension/native-host-installer.d.ts.map +0 -1
  129. package/dist/extension/native-host-installer.js +0 -147
  130. package/dist/extension/native-host-installer.js.map +0 -1
  131. package/dist/extension/socket-server.d.ts +0 -32
  132. package/dist/extension/socket-server.d.ts.map +0 -1
  133. package/dist/extension/socket-server.js +0 -177
  134. package/dist/extension/socket-server.js.map +0 -1
  135. package/dist/extension/ws-server.d.ts +0 -40
  136. package/dist/extension/ws-server.d.ts.map +0 -1
  137. package/dist/extension/ws-server.js +0 -246
  138. package/dist/extension/ws-server.js.map +0 -1
  139. package/dist/native-host/index.js +0 -280
  140. package/dist/native-host/mcp-chrome-host +0 -2
  141. 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,16 +537,29 @@ async function handleCloseWindow({ unifiedSession, mode }, args) {
216
537
  return formatAffectedResponse('closeWindow', mode, affected);
217
538
  }
218
539
  async function handleClearCache({ unifiedSession, mode }, args) {
219
- return unifiedSession.withTabId(undefined, async () => {
540
+ return unifiedSession.withTabId(args.targetId, async () => {
220
541
  const cacheType = (args.cacheType ?? 'all');
221
542
  if (mode === 'extension') {
222
- return formatResponse({
223
- success: true,
224
- action: 'clearCache',
225
- cacheType,
226
- mode,
227
- warning: 'Extension 模式不支持 clearCache,如需清除 cookies 请使用 cookies action=clear(必须带 name/domain/url 过滤),如需清除 storage/cache 请切换到 CDP 模式',
228
- });
543
+ return {
544
+ content: [
545
+ {
546
+ type: 'text',
547
+ text: JSON.stringify({
548
+ error: {
549
+ code: 'UNSUPPORTED_MODE',
550
+ message: 'Extension 模式不支持 clearCache,未执行清除操作',
551
+ suggestion: '清除 cookies 请使用 cookies action=clear(必须带 url 或 domain 过滤),' +
552
+ '清除 storage/cache 请切换到 CDP 模式',
553
+ },
554
+ action: 'clearCache',
555
+ cacheType,
556
+ mode,
557
+ actionPerformed: false,
558
+ }),
559
+ },
560
+ ],
561
+ isError: true,
562
+ };
229
563
  }
230
564
  const session = getSession();
231
565
  await session.clearCache(cacheType);
@@ -233,30 +567,24 @@ async function handleClearCache({ unifiedSession, mode }, args) {
233
567
  });
234
568
  }
235
569
  async function handleViewport({ unifiedSession, mode }, args) {
236
- return unifiedSession.withTabId(undefined, async () => {
570
+ return unifiedSession.withTabId(args.targetId, async () => {
237
571
  if (args.width === undefined || args.height === undefined) {
238
572
  return invalidArgument('设置视口需要 width 和 height 参数');
239
573
  }
240
- if (mode === 'extension') {
241
- await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
242
- width: args.width,
243
- height: args.height,
244
- deviceScaleFactor: 1,
245
- mobile: false,
246
- });
247
- await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
248
- await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', { enabled: false });
249
- }
250
- else {
251
- const session = getSession();
252
- await session.setViewport(args.width, args.height);
253
- }
574
+ await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
575
+ width: args.width,
576
+ height: args.height,
577
+ deviceScaleFactor: 1,
578
+ mobile: false,
579
+ });
580
+ await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
581
+ await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', { enabled: false });
254
582
  await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))');
255
583
  return formatResponse({ success: true, action: 'viewport', width: args.width, height: args.height, mode });
256
584
  });
257
585
  }
258
586
  async function handleUserAgent({ unifiedSession, mode }, args) {
259
- return unifiedSession.withTabId(undefined, async () => {
587
+ return unifiedSession.withTabId(args.targetId, async () => {
260
588
  if (!args.userAgent) {
261
589
  return invalidArgument('设置 User-Agent 需要 userAgent 参数');
262
590
  }
@@ -287,7 +615,7 @@ function handleInputMode({ unifiedSession, mode }, args) {
287
615
  return formatResponse({ success: true, action: 'inputMode', inputMode: args.inputMode, mode });
288
616
  }
289
617
  async function handleEmulate({ unifiedSession, mode }, args) {
290
- return unifiedSession.withTabId(undefined, async () => {
618
+ return unifiedSession.withTabId(args.targetId, async () => {
291
619
  if (!args.device) {
292
620
  return formatResponse({ success: true, action: 'emulate', availableDevices: Object.keys(devices) });
293
621
  }
@@ -295,25 +623,18 @@ async function handleEmulate({ unifiedSession, mode }, args) {
295
623
  if (!device) {
296
624
  return invalidArgument(`未知设备: ${args.device}`, `可用设备: ${Object.keys(devices).join(', ')}`);
297
625
  }
298
- if (mode === 'extension') {
299
- await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
300
- width: device.viewport.width,
301
- height: device.viewport.height,
302
- deviceScaleFactor: device.viewport.deviceScaleFactor || 1,
303
- mobile: device.viewport.isMobile || false,
304
- });
305
- await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
306
- await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', {
307
- enabled: device.viewport.hasTouch,
308
- maxTouchPoints: device.viewport.hasTouch ? 1 : 0,
309
- });
310
- await unifiedSession.sendCdpCommand('Emulation.setUserAgentOverride', { userAgent: device.userAgent });
311
- }
312
- else {
313
- const session = getSession();
314
- await session.setViewport(device.viewport.width, device.viewport.height);
315
- await session.setUserAgent(device.userAgent);
316
- }
626
+ await unifiedSession.sendCdpCommand('Emulation.setDeviceMetricsOverride', {
627
+ width: device.viewport.width,
628
+ height: device.viewport.height,
629
+ deviceScaleFactor: device.viewport.deviceScaleFactor || 1,
630
+ mobile: device.viewport.isMobile || false,
631
+ });
632
+ await unifiedSession.sendCdpCommand('Emulation.setPageScaleFactor', { pageScaleFactor: 1 });
633
+ await unifiedSession.sendCdpCommand('Emulation.setTouchEmulationEnabled', {
634
+ enabled: device.viewport.hasTouch,
635
+ maxTouchPoints: device.viewport.hasTouch ? 1 : 0,
636
+ });
637
+ await unifiedSession.sendCdpCommand('Emulation.setUserAgentOverride', { userAgent: device.userAgent });
317
638
  await unifiedSession.evaluate('window.dispatchEvent(new Event("resize"))');
318
639
  return formatResponse({
319
640
  success: true,
@@ -324,14 +645,14 @@ async function handleEmulate({ unifiedSession, mode }, args) {
324
645
  });
325
646
  });
326
647
  }
327
- async function handleStealth({ unifiedSession, mode }) {
328
- return unifiedSession.withTabId(undefined, async () => {
648
+ async function handleStealth({ unifiedSession, mode }, args) {
649
+ return unifiedSession.withTabId(args.targetId, async () => {
329
650
  await unifiedSession.injectStealth();
330
651
  return formatResponse({ success: true, action: 'stealth', mode, note: '已注入反检测脚本' });
331
652
  });
332
653
  }
333
654
  async function handleCdp({ unifiedSession, mode }, args) {
334
- return unifiedSession.withTabId(undefined, async () => {
655
+ return unifiedSession.withTabId(args.targetId, async () => {
335
656
  if (!args.cdpMethod) {
336
657
  return invalidArgument('缺少 cdpMethod 参数', '请指定 CDP 方法名,如 Runtime.evaluate、Page.captureScreenshot');
337
658
  }
@@ -361,15 +682,25 @@ async function handleCdp({ unifiedSession, mode }, args) {
361
682
  isError: true,
362
683
  };
363
684
  }
364
- 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;
365
692
  }
366
693
  });
367
694
  }
368
695
  const manageHandlers = {
369
696
  newPage: handleNewPage,
697
+ pageMetadata: handlePageMetadata,
370
698
  closePage: handleClosePage,
371
699
  adoptPage: handleAdoptPage,
372
700
  releasePage: handleReleasePage,
701
+ grantReadAccess: handleReadAccess,
702
+ revokeReadAccess: handleReadAccess,
703
+ updatePage: handleUpdatePage,
373
704
  movePage: handleMovePage,
374
705
  reorderPage: handleReorderPage,
375
706
  pinPage: handlePinPage,
@@ -379,6 +710,11 @@ const manageHandlers = {
379
710
  resizeWindow: handleResizeWindow,
380
711
  newWindow: handleNewWindow,
381
712
  closeWindow: handleCloseWindow,
713
+ updateWindow: handleUpdateWindow,
714
+ groupPages: handleGroupPages,
715
+ ungroupPages: handleUngroupPages,
716
+ updateGroup: handleUpdateGroup,
717
+ moveGroup: handleMoveGroup,
382
718
  clearCache: handleClearCache,
383
719
  viewport: handleViewport,
384
720
  userAgent: handleUserAgent,
@@ -389,7 +725,7 @@ const manageHandlers = {
389
725
  };
390
726
  export function registerManageTool(server) {
391
727
  server.registerTool('manage', {
392
- description: '页面与环境管理:新建页面、关闭页面、受控页 adopt/release、缓存、视口、UA、设备模拟',
728
+ description: '页面、窗口与分组管理:创建、更新、移动、关闭,受控页 adopt/release,分组成员、名称、颜色和折叠;缓存、视口、UA、设备模拟',
393
729
  inputSchema: manageSchema,
394
730
  }, (args) => handleManage(args));
395
731
  }