@angelky7/dsh-browser-control 1.7.0 → 1.7.1

package/README.en.md

@@ -64,8 +64,8 @@ In one line: **for "use MY browser" tasks (logged-in Bilibili, Zhihu, admin pane
 
 | File | Purpose |
 |---|---|
-| [DSH-Browser-Control-v1.7.0.zip](https://github.com/angelky7/dsh-browser-control/releases/download/v1.7.0/DSH-Browser-Control-v1.7.0.zip) | Chrome extension (unzip and load; this release adds the history navigation commands — reinstall required) |
-| [dsh-browser-control-plugin-v1.7.0.zip](https://github.com/angelky7/dsh-browser-control/releases/download/v1.7.0/dsh-browser-control-plugin-v1.7.0.zip) | dsh plugin (offline fallback; online installs use Option A/B) |
+| [DSH-Browser-Control-v1.7.1.zip](https://github.com/angelky7/dsh-browser-control/releases/download/v1.7.1/DSH-Browser-Control-v1.7.1.zip) | Chrome extension (unzip and load; this release adds the metrics command and emulate throttling — reinstall required) |
+| [dsh-browser-control-plugin-v1.7.1.zip](https://github.com/angelky7/dsh-browser-control/releases/download/v1.7.1/dsh-browser-control-plugin-v1.7.1.zip) | dsh plugin (offline fallback; online installs use Option A/B) |
 
 ## Install the Chrome extension (30 seconds)
 
@@ -104,7 +104,7 @@ npm install @angelky7/dsh-browser-control
 
 ```bash
 # Straight from GitHub
-dsh plugin --profile web add "github:angelky7/dsh-browser-control#v1.7.0"
+dsh plugin --profile web add "github:angelky7/dsh-browser-control#v1.7.1"
 
 # Local checkout for debugging (note: the explicit file: prefix is required)
 dsh plugin --profile web add "file:D:\path\to\dsh-browser-control"
@@ -265,11 +265,12 @@ curl -X POST http://127.0.0.1:9777/api/command \
 | `browser_pdf` | Export the current page as PDF (v1.0.7+) |
 | `browser_archive` | Save the whole page as a single-file MHTML (text/images/styles inline; a greppable offline evidence snapshot — embedded scripts do not run, v1.5.0+) |
 | `browser_windows` | Window control: list / open / update state & geometry / close a whole window / move tabs across windows (the only tool that may touch window geometry, v1.6.0+) |
-| `browser_emulate` | Switch to a device viewport (mobile / desktop / custom, v1.0.7+) |
+| `browser_emulate` | Switch to a device viewport (mobile / desktop / custom, v1.0.7+); v1.7.1+ adds throttling: `network` slow3g/fast3g/offline/reset + `cpuThrottlingRate` (1–20), the receipt states the applied numbers, `device:"reset"` clears them too |
+| `browser_metrics` | Read performance counters (DOM nodes / JS heap / layout & script durations, Performance.getMetrics, read-only; puts numbers behind "this page is heavy", v1.7.1+) |
 | `browser_cleanup` | Clean up temp files |
 | `browser_info` | Which browser and extension build is attached (run it first when debugging, v1.0.9+) |
 
-24 tools in total. `browser_wait`, `browser_find`, `browser_dialog` and `browser_info` existed inside the extension up to v1.0.8 but were never registered as tools, so the agent could not reach them; `browser_network_clear` existed in code and was simply missing from this table. `verify/verify_surface.mjs` now reconciles the extension command table, the commands the plugin calls, this table and the built bundle, so any drift fails `npm run verify`.
+25 tools in total. `browser_wait`, `browser_find`, `browser_dialog` and `browser_info` existed inside the extension up to v1.0.8 but were never registered as tools, so the agent could not reach them; `browser_network_clear` existed in code and was simply missing from this table. `verify/verify_surface.mjs` now reconciles the extension command table, the commands the plugin calls, this table and the built bundle, so any drift fails `npm run verify`.
 
 ## Architecture
 

package/README.md

@@ -64,8 +64,8 @@ Chrome 扩展（CDP 驱动）
 
 | 文件 | 说明 |
 |---|---|
-| [DSH-Browser-Control-v1.7.0.zip](https://github.com/angelky7/dsh-browser-control/releases/download/v1.7.0/DSH-Browser-Control-v1.7.0.zip) | Chrome 扩展（解压后加载；这一版扩展新增 tabs.back/forward 历史导航命令，**必须重装**） |
-| [dsh-browser-control-plugin-v1.7.0.zip](https://github.com/angelky7/dsh-browser-control/releases/download/v1.7.0/dsh-browser-control-plugin-v1.7.0.zip) | dsh 插件（离线兜底，在线装直接用方式 A/B） |
+| [DSH-Browser-Control-v1.7.1.zip](https://github.com/angelky7/dsh-browser-control/releases/download/v1.7.1/DSH-Browser-Control-v1.7.1.zip) | Chrome 扩展（解压后加载；这一版扩展新增 metrics 命令与 emulate 节流参数，**必须重装**） |
+| [dsh-browser-control-plugin-v1.7.1.zip](https://github.com/angelky7/dsh-browser-control/releases/download/v1.7.1/dsh-browser-control-plugin-v1.7.1.zip) | dsh 插件（离线兜底，在线装直接用方式 A/B） |
 
 ## 安装 Chrome 扩展（30 秒）
 
@@ -104,7 +104,7 @@ npm install @angelky7/dsh-browser-control
 
 ```bash
 # 直接从 GitHub 安装
-dsh plugin --profile web add "github:angelky7/dsh-browser-control#v1.7.0"
+dsh plugin --profile web add "github:angelky7/dsh-browser-control#v1.7.1"
 
 # 本地目录调试（注意：必须显式 file: 前缀）
 dsh plugin --profile web add "file:D:\path\to\dsh-browser-control"
@@ -258,12 +258,13 @@ curl -X POST http://127.0.0.1:9777/api/command \
 | `browser_network_clear` | 单独清空网络日志缓冲（v1.0.7+） |
 | `browser_pdf` | 当前页导出 PDF（v1.0.7+） |
 | `browser_archive` | 整页存成单文件 MHTML（正文/图片/样式全内联，可当文本 grep 的离线证据；是快照，内嵌脚本不会跑，v1.5.0+） |
-| `browser_emulate` | 切设备视口（移动 / 桌面 / 自定义，v1.0.7+） |
+| `browser_emulate` | 切设备视口（移动 / 桌面 / 自定义，v1.0.7+）；v1.7.1 起还能限速：`network` slow3g/fast3g/offline/reset + `cpuThrottlingRate`（1–20），回执写明生效数值，`device:"reset"` 一并还原 |
+| `browser_metrics` | 读性能计数器（DOM 节点数 / JS 堆 / 布局与脚本耗时，Performance.getMetrics，只读；让「这页面很重」有数字说话，v1.7.1+） |
 | `browser_windows` | 窗口控制：清单/开窗/改状态与几何/关整窗/跨窗挪标签（唯一能碰窗口几何的工具，v1.6.0+） |
 | `browser_cleanup` | 清理临时文件 |
 | `browser_info` | 报告实际连上的浏览器与扩展版本（排障先跑它，v1.0.9+） |
 
-共 24 个工具。`browser_wait` / `browser_find` / `browser_dialog` / `browser_info` 在 v1.0.8 及以前是「扩展里已实现、但没注册成工具」，agent 调不到；`browser_network_clear` 则是代码里有、这张表漏了。这些现在由 `verify/verify_surface.mjs` 做三方对账（扩展命令表 ↔ 插件调用 ↔ 文档表 ↔ 构建产物），漂移会直接让 `npm run verify` 失败。
+共 25 个工具。`browser_wait` / `browser_find` / `browser_dialog` / `browser_info` 在 v1.0.8 及以前是「扩展里已实现、但没注册成工具」，agent 调不到；`browser_network_clear` 则是代码里有、这张表漏了。这些现在由 `verify/verify_surface.mjs` 做三方对账（扩展命令表 ↔ 插件调用 ↔ 文档表 ↔ 构建产物），漂移会直接让 `npm run verify` 失败。
 
 ## 架构
 

package/lib/index.js

@@ -878,7 +878,8 @@ const READ_ONLY_ALLOWED = /* @__PURE__ */ new Set([
 	"console.log",
 	"network.log",
 	"windows.list",
-	"cookies.get"
+	"cookies.get",
+	"metrics"
 ]);
 /**
 * 会执行**任意页面脚本**的扩展命令。这条与只读档分开管，因为用户可能想「可以读、
@@ -2853,7 +2854,7 @@ function applyBrowserTools(ctx, controller) {
 	}));
 	ctx.tools.register(defineTool({
 		name: "browser_emulate",
-		description: "Switch the tab into a device viewport (mobile / tablet / desktop) for responsive-UI testing. `device:\"reset\"` restores the user's actual viewport. Custom `width`/`height`/`deviceScaleFactor`/`isMobile`/`hasTouch` override any preset field.",
+		description: "Switch the tab into a device viewport (mobile / tablet / desktop) for responsive-UI testing, and throttle the network or CPU to test slow conditions. `device:\"reset\"` restores the user's actual viewport and clears all throttling. `network` presets (this tool's own numbers): slow3g = 400ms RTT + ~50KB/s both ways, fast3g = 150ms + ~200KB/s down / ~94KB/s up, offline, reset to clear. `cpuThrottlingRate` multiplies CPU cost (1 = off, up to 20). Throttling lives in the debugger session — it is gone when the extension detaches, and device:\"reset\" clears it too. Custom `width`/`height`/`deviceScaleFactor`/`isMobile`/`hasTouch` override any preset field.",
 		parameters: {
 			tabId: {
 				type: "number",
@@ -2863,6 +2864,14 @@ function applyBrowserTools(ctx, controller) {
 				type: "string",
 				description: "Preset: desktop | mobile-iphone-13 | mobile-pixel-7 | tablet-ipad | reset. Or pass custom width/height below."
 			},
+			network: {
+				type: "string",
+				description: "slow3g | fast3g | offline | reset. The receipt reports the applied latency/throughput in bytes per second."
+			},
+			cpuThrottlingRate: {
+				type: "number",
+				description: "CPU slowdown multiplier: 1 = none (default), 4 = mid-range phone, up to 20."
+			},
 			width: {
 				type: "number",
 				description: "Custom viewport width in CSS px."
@@ -2903,30 +2912,39 @@ function applyBrowserTools(ctx, controller) {
 					deviceScaleFactor: { type: "number" },
 					isMobile: { type: "boolean" },
 					hasTouch: { type: "boolean" },
-					userAgent: { type: "string" }
+					userAgent: { type: "string" },
+					network: { type: "string" },
+					latency: { type: "number" },
+					downloadThroughput: { type: "number" },
+					uploadThroughput: { type: "number" },
+					cpuThrottlingRate: { type: "number" }
 				}
 			},
 			render: (_args, value) => {
 				if (value.reset) return [{
 					type: "text",
-					text: `Tab ${value.tabId}: emulation reset to default`
+					text: `Tab ${value.tabId}: emulation reset to default (network unthrottled, CPU rate 1)`
 				}];
 				const ua = value.userAgent === void 0 ? "" : ` UA="${flattenOneLine(value.userAgent, 80)}"`;
+				const net = value.network === void 0 ? "" : ` network=${value.network}(${value.latency}ms↓${value.downloadThroughput}B/s↑${value.uploadThroughput}B/s)`;
+				const cpu = value.cpuThrottlingRate === void 0 ? "" : ` cpu×${value.cpuThrottlingRate}`;
 				return [{
 					type: "text",
-					text: `Tab ${value.tabId}: ${value.width || "?"}×${value.height || "?"} DPR=${value.deviceScaleFactor ?? "?"} mobile=${value.isMobile ?? false} touch=${value.hasTouch ?? false}${ua}`
+					text: `Tab ${value.tabId}: ${value.width || "?"}×${value.height || "?"} DPR=${value.deviceScaleFactor ?? "?"} mobile=${value.isMobile ?? false} touch=${value.hasTouch ?? false}${ua}${net}${cpu}`
 				}];
 			}
 		},
 		presentCall: (args) => ({
 			card: "generic",
-			title: `Emulate${args.device ? " " + args.device : " device"}`,
+			title: `Emulate${args.device ? " " + args.device : ""}${args.network ? " " + args.network : ""}${args.cpuThrottlingRate ? " cpu×" + args.cpuThrottlingRate : ""}`,
 			kind: "other"
 		}),
 		async execute(args, exec) {
 			const params = {};
 			if (args.tabId !== void 0) params.tabId = args.tabId;
 			if (typeof args.device === "string") params.device = args.device;
+			if (typeof args.network === "string") params.network = args.network;
+			if (typeof args.cpuThrottlingRate === "number") params.cpuThrottlingRate = args.cpuThrottlingRate;
 			if (typeof args.width === "number") params.width = args.width;
 			if (typeof args.height === "number") params.height = args.height;
 			if (typeof args.deviceScaleFactor === "number") params.deviceScaleFactor = args.deviceScaleFactor;
@@ -2942,10 +2960,81 @@ function applyBrowserTools(ctx, controller) {
 				...typeof raw.deviceScaleFactor === "number" ? { deviceScaleFactor: raw.deviceScaleFactor } : {},
 				...typeof raw.isMobile === "boolean" ? { isMobile: raw.isMobile } : {},
 				...typeof raw.hasTouch === "boolean" ? { hasTouch: raw.hasTouch } : {},
-				...typeof raw.userAgent === "string" && raw.userAgent.length > 0 ? { userAgent: raw.userAgent } : {}
+				...typeof raw.userAgent === "string" && raw.userAgent.length > 0 ? { userAgent: raw.userAgent } : {},
+				...typeof raw.network === "string" ? { network: raw.network } : {},
+				...typeof raw.latency === "number" ? { latency: raw.latency } : {},
+				...typeof raw.downloadThroughput === "number" ? { downloadThroughput: raw.downloadThroughput } : {},
+				...typeof raw.uploadThroughput === "number" ? { uploadThroughput: raw.uploadThroughput } : {},
+				...typeof raw.cpuThrottlingRate === "number" ? { cpuThrottlingRate: raw.cpuThrottlingRate } : {}
 			};
 		}
 	}));
+	ctx.tools.register(defineTool({
+		name: "browser_metrics",
+		description: "Read the tab's performance counters (Performance.getMetrics): DOM node count, JS heap usage, layout/style recalc counts, script/task durations. Use it to back \"this page is heavy\" with numbers, before and after an action. Read-only.",
+		parameters: { tabId: {
+			type: "number",
+			description: "Target tab; defaults to the active tab."
+		} },
+		output: {
+			schema: {
+				type: "object",
+				additionalProperties: false,
+				properties: {
+					tabId: {
+						type: "number",
+						required: true
+					},
+					metrics: {
+						type: "object",
+						required: true,
+						additionalProperties: false,
+						properties: {
+							Timestamp: { type: "number" },
+							Documents: { type: "number" },
+							Frames: { type: "number" },
+							JSEventListeners: { type: "number" },
+							Nodes: { type: "number" },
+							LayoutCount: { type: "number" },
+							RecalcStyleCount: { type: "number" },
+							LayoutDuration: { type: "number" },
+							RecalcStyleDuration: { type: "number" },
+							ScriptDuration: { type: "number" },
+							TaskDuration: { type: "number" },
+							JSHeapUsedSize: { type: "number" },
+							JSHeapTotalSize: { type: "number" }
+						}
+					}
+				}
+			},
+			render: (_args, value) => {
+				const m = value.metrics ?? {};
+				const parts = [];
+				if (m.Nodes !== void 0) parts.push(`nodes=${m.Nodes}`);
+				if (m.JSHeapUsedSize !== void 0) {
+					const total = m.JSHeapTotalSize !== void 0 ? `/${(m.JSHeapTotalSize / 1048576).toFixed(1)}MB` : "";
+					parts.push(`heap=${(m.JSHeapUsedSize / 1048576).toFixed(1)}${total}`);
+				}
+				if (m.LayoutCount !== void 0) parts.push(`layouts=${m.LayoutCount}`);
+				if (m.ScriptDuration !== void 0) parts.push(`script=${Number(m.ScriptDuration).toFixed(2)}s`);
+				if (m.TaskDuration !== void 0) parts.push(`tasks=${Number(m.TaskDuration).toFixed(2)}s`);
+				return [{
+					type: "text",
+					text: `Tab ${value.tabId}: ${parts.join(" ") || JSON.stringify(value.metrics)}`
+				}];
+			}
+		},
+		presentCall: () => ({
+			card: "generic",
+			title: "Browser metrics",
+			kind: "other"
+		}),
+		async execute(args, exec) {
+			const params = {};
+			if (args.tabId !== void 0) params.tabId = args.tabId;
+			return await controller.execute("metrics", params, exec.signal);
+		}
+	}));
 }
 /** Cordis plugin entry: wire the settings-driven lifecycle plus the model-facing tools. */
 function apply(ctx, config) {

package/lib/types/index.js

@@ -1446,10 +1446,12 @@ function applyBrowserTools(ctx, controller) {
     }));
     ctx.tools.register(defineTool({
         name: 'browser_emulate',
-        description: 'Switch the tab into a device viewport (mobile / tablet / desktop) for responsive-UI testing. `device:"reset"` restores the user\'s actual viewport. Custom `width`/`height`/`deviceScaleFactor`/`isMobile`/`hasTouch` override any preset field.',
+        description: 'Switch the tab into a device viewport (mobile / tablet / desktop) for responsive-UI testing, and throttle the network or CPU to test slow conditions. `device:"reset"` restores the user\'s actual viewport and clears all throttling. `network` presets (this tool\'s own numbers): slow3g = 400ms RTT + ~50KB/s both ways, fast3g = 150ms + ~200KB/s down / ~94KB/s up, offline, reset to clear. `cpuThrottlingRate` multiplies CPU cost (1 = off, up to 20). Throttling lives in the debugger session — it is gone when the extension detaches, and device:"reset" clears it too. Custom `width`/`height`/`deviceScaleFactor`/`isMobile`/`hasTouch` override any preset field.',
         parameters: {
             tabId: { type: 'number', description: 'Target tab; defaults to the active tab.' },
             device: { type: 'string', description: 'Preset: desktop | mobile-iphone-13 | mobile-pixel-7 | tablet-ipad | reset. Or pass custom width/height below.' },
+            network: { type: 'string', description: 'slow3g | fast3g | offline | reset. The receipt reports the applied latency/throughput in bytes per second.' },
+            cpuThrottlingRate: { type: 'number', description: 'CPU slowdown multiplier: 1 = none (default), 4 = mid-range phone, up to 20.' },
             width: { type: 'number', description: 'Custom viewport width in CSS px.' },
             height: { type: 'number', description: 'Custom viewport height in CSS px.' },
             deviceScaleFactor: { type: 'number', description: 'Custom DPR (1 = standard, 2 = retina, 3 = super-retina).' },
@@ -1470,26 +1472,37 @@ function applyBrowserTools(ctx, controller) {
                     isMobile: { type: 'boolean' },
                     hasTouch: { type: 'boolean' },
                     userAgent: { type: 'string' },
+                    network: { type: 'string' },
+                    latency: { type: 'number' },
+                    downloadThroughput: { type: 'number' },
+                    uploadThroughput: { type: 'number' },
+                    cpuThrottlingRate: { type: 'number' },
                 },
             },
             render: (_args, value) => {
                 if (value.reset)
-                    return [{ type: 'text', text: `Tab ${value.tabId}: emulation reset to default` }];
-                // 覆盖生效的是哪个 UA 必须写出来：模型只看这句，看不见 value 里的字段。
+                    return [{ type: 'text', text: `Tab ${value.tabId}: emulation reset to default (network unthrottled, CPU rate 1)` }];
+                // 覆盖生效的是哪个 UA / 哪档节流必须写出来：模型只看这句，看不见 value 里的字段。
                 const ua = value.userAgent === undefined ? '' : ` UA="${flattenOneLine(value.userAgent, 80)}"`;
+                const net = value.network === undefined ? '' : ` network=${value.network}(${value.latency}ms↓${value.downloadThroughput}B/s↑${value.uploadThroughput}B/s)`;
+                const cpu = value.cpuThrottlingRate === undefined ? '' : ` cpu×${value.cpuThrottlingRate}`;
                 return [{
                         type: 'text',
-                        text: `Tab ${value.tabId}: ${value.width || '?'}×${value.height || '?'} DPR=${value.deviceScaleFactor ?? '?'} mobile=${value.isMobile ?? false} touch=${value.hasTouch ?? false}${ua}`,
+                        text: `Tab ${value.tabId}: ${value.width || '?'}×${value.height || '?'} DPR=${value.deviceScaleFactor ?? '?'} mobile=${value.isMobile ?? false} touch=${value.hasTouch ?? false}${ua}${net}${cpu}`,
                     }];
             },
         },
-        presentCall: args => ({ card: 'generic', title: `Emulate${args.device ? ' ' + args.device : ' device'}`, kind: 'other' }),
+        presentCall: args => ({ card: 'generic', title: `Emulate${args.device ? ' ' + args.device : ''}${args.network ? ' ' + args.network : ''}${args.cpuThrottlingRate ? ' cpu×' + args.cpuThrottlingRate : ''}`, kind: 'other' }),
         async execute(args, exec) {
             const params = {};
             if (args.tabId !== undefined)
                 params.tabId = args.tabId;
             if (typeof args.device === 'string')
                 params.device = args.device;
+            if (typeof args.network === 'string')
+                params.network = args.network;
+            if (typeof args.cpuThrottlingRate === 'number')
+                params.cpuThrottlingRate = args.cpuThrottlingRate;
             if (typeof args.width === 'number')
                 params.width = args.width;
             if (typeof args.height === 'number')
@@ -1515,9 +1528,77 @@ function applyBrowserTools(ctx, controller) {
                 ...(typeof raw.isMobile === 'boolean' ? { isMobile: raw.isMobile } : {}),
                 ...(typeof raw.hasTouch === 'boolean' ? { hasTouch: raw.hasTouch } : {}),
                 ...(typeof raw.userAgent === 'string' && raw.userAgent.length > 0 ? { userAgent: raw.userAgent } : {}),
+                ...(typeof raw.network === 'string' ? { network: raw.network } : {}),
+                ...(typeof raw.latency === 'number' ? { latency: raw.latency } : {}),
+                ...(typeof raw.downloadThroughput === 'number' ? { downloadThroughput: raw.downloadThroughput } : {}),
+                ...(typeof raw.uploadThroughput === 'number' ? { uploadThroughput: raw.uploadThroughput } : {}),
+                ...(typeof raw.cpuThrottlingRate === 'number' ? { cpuThrottlingRate: raw.cpuThrottlingRate } : {}),
             };
         },
     }));
+    // Performance metrics: a pure read of CDP counters — whitelisted under
+    // readOnly, no effect on the page, and the numbers ARE the content.
+    ctx.tools.register(defineTool({
+        name: 'browser_metrics',
+        description: 'Read the tab\'s performance counters (Performance.getMetrics): DOM node count, JS heap usage, layout/style recalc counts, script/task durations. Use it to back "this page is heavy" with numbers, before and after an action. Read-only.',
+        parameters: {
+            tabId: { type: 'number', description: 'Target tab; defaults to the active tab.' },
+        },
+        output: {
+            schema: {
+                type: 'object',
+                additionalProperties: false,
+                properties: {
+                    tabId: { type: 'number', required: true },
+                    metrics: {
+                        type: 'object',
+                        required: true,
+                        additionalProperties: false,
+                        properties: {
+                            Timestamp: { type: 'number' },
+                            Documents: { type: 'number' },
+                            Frames: { type: 'number' },
+                            JSEventListeners: { type: 'number' },
+                            Nodes: { type: 'number' },
+                            LayoutCount: { type: 'number' },
+                            RecalcStyleCount: { type: 'number' },
+                            LayoutDuration: { type: 'number' },
+                            RecalcStyleDuration: { type: 'number' },
+                            ScriptDuration: { type: 'number' },
+                            TaskDuration: { type: 'number' },
+                            JSHeapUsedSize: { type: 'number' },
+                            JSHeapTotalSize: { type: 'number' },
+                        },
+                    },
+                },
+            },
+            render: (_args, value) => {
+                const m = (value.metrics ?? {});
+                // 数字本身就是产出：关键几项原样进模型可见文本，heap 顺手换算成 MB。
+                const parts = [];
+                if (m.Nodes !== undefined)
+                    parts.push(`nodes=${m.Nodes}`);
+                if (m.JSHeapUsedSize !== undefined) {
+                    const total = m.JSHeapTotalSize !== undefined ? `/${(m.JSHeapTotalSize / 1_048_576).toFixed(1)}MB` : '';
+                    parts.push(`heap=${(m.JSHeapUsedSize / 1_048_576).toFixed(1)}${total}`);
+                }
+                if (m.LayoutCount !== undefined)
+                    parts.push(`layouts=${m.LayoutCount}`);
+                if (m.ScriptDuration !== undefined)
+                    parts.push(`script=${Number(m.ScriptDuration).toFixed(2)}s`);
+                if (m.TaskDuration !== undefined)
+                    parts.push(`tasks=${Number(m.TaskDuration).toFixed(2)}s`);
+                return [{ type: 'text', text: `Tab ${value.tabId}: ${parts.join(' ') || JSON.stringify(value.metrics)}` }];
+            },
+        },
+        presentCall: () => ({ card: 'generic', title: 'Browser metrics', kind: 'other' }),
+        async execute(args, exec) {
+            const params = {};
+            if (args.tabId !== undefined)
+                params.tabId = args.tabId;
+            return await controller.execute('metrics', params, exec.signal);
+        },
+    }));
 }
 /** Cordis plugin entry: wire the settings-driven lifecycle plus the model-facing tools. */
 export function apply(ctx, config) {

package/lib/types/policy.js

@@ -28,6 +28,9 @@ export const READ_ONLY_ALLOWED = new Set([
     'windows.list',
     // 读浏览器自己的状态（cookie 是凭据，但 get 不改任何东西；set/remove 不在此列）
     'cookies.get',
+    // 读性能计数器（Performance.getMetrics）：纯粹读，重试无损害；节流（emulate
+    // 的 network/cpu 参数）改页面加载行为，emulate 整体仍是写命令，不在此列。
+    'metrics',
 ]);
 /**
  * 会执行**任意页面脚本**的扩展命令。这条与只读档分开管，因为用户可能想「可以读、

package/llms.txt

@@ -35,7 +35,7 @@ Chrome 浏览器扩展 + DeepSeek Harness 插件，让 AI Agent 通过 CDP 驱
 
 ## 关键文件
 
-- `src/index.ts` - 24 个 `browser_*` 工具注册 + settings 接线的版本兼容分支
+- `src/index.ts` - 25 个 `browser_*` 工具注册 + settings 接线的版本兼容分支
 - `src/policy.ts` - 三张互不相同的表：只读白名单、脚本命令、插件本地破坏性命令（`browser_cleanup` 不经过 `execute()`，必须自己站闸门）
 - `src/server.ts` - WebSocket 服务 + HTTP 面（鉴权、来源校验、状态页）
 - `src/ws.ts` - RFC 6455 帧编解码

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@angelky7/dsh-browser-control",
   "description": "Local WebSocket bridge between dsh and the DSH Browser Control browser extension, with model-facing browser_* tools and a Settings-managed on/off switch",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -37,7 +37,7 @@
     "build": "tsc -p tsconfig.json && tsdown",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "check": "npm run typecheck && npm run build && publint",
-    "verify": "node verify/verify_config_patch.mjs && node verify/verify_peers.mjs && node verify/verify_surface.mjs && node verify/verify_tab_groups.mjs && node verify/verify_tabs_close_many.mjs && node verify/verify_cdp_retry.mjs && node verify/verify_snapshot_ax.mjs && node verify/verify_hard_lock.mjs && node verify/verify_policy.mjs && node verify/verify_cookies.mjs && node verify/verify_extension_e2e.mjs && node verify/verify_plugin.mjs legacy && node verify/verify_plugin.mjs conflict && node verify/verify_plugin.mjs new && node verify/verify_http.mjs && node verify/verify_errors.mjs && node verify/verify_hold.mjs && node verify/verify_protocol.mjs && node verify/verify_bundle_http.mjs && node verify/verify_nav_report.mjs && node verify/verify_nav_landing.mjs && node verify/verify_render_contract.mjs && node verify/verify_press_events.mjs && node verify/verify_nav_timeout.mjs && node verify/verify_nav_waituntil.mjs && node verify/verify_archive.mjs && node verify/verify_windows.mjs && node verify/verify_history_nav.mjs"
+    "verify": "node verify/verify_config_patch.mjs && node verify/verify_peers.mjs && node verify/verify_surface.mjs && node verify/verify_tab_groups.mjs && node verify/verify_tabs_close_many.mjs && node verify/verify_cdp_retry.mjs && node verify/verify_snapshot_ax.mjs && node verify/verify_hard_lock.mjs && node verify/verify_policy.mjs && node verify/verify_cookies.mjs && node verify/verify_extension_e2e.mjs && node verify/verify_plugin.mjs legacy && node verify/verify_plugin.mjs conflict && node verify/verify_plugin.mjs new && node verify/verify_http.mjs && node verify/verify_errors.mjs && node verify/verify_hold.mjs && node verify/verify_protocol.mjs && node verify/verify_bundle_http.mjs && node verify/verify_nav_report.mjs && node verify/verify_nav_landing.mjs && node verify/verify_render_contract.mjs && node verify/verify_press_events.mjs && node verify/verify_nav_timeout.mjs && node verify/verify_nav_waituntil.mjs && node verify/verify_archive.mjs && node verify/verify_windows.mjs && node verify/verify_history_nav.mjs && node verify/verify_metrics_throttle.mjs"
   },
   "publishConfig": {
     "access": "public",