dsh-browser-view 0.3.1 → 0.3.3

package/lib/index.js

@@ -2035,9 +2035,28 @@ async function selectTool(config, args) {
 		...await pageIdentity(page)
 	};
 }
+/**
+* 防御性解码 eval 脚本:模型/人工偶发把脚本 JSON.stringify 一次再传
+* (脚本以 \" 开头、换行变字面 \\n),回放/录制链路不纠错会导致语法错误。
+* 识别条件:字符串以引号包裹且含反斜杠转义,且 JSON.parse 结果仍是字符串。
+* 无法解析或语义不变场景原样返回(裸字符串字面量如 "hello" 不含转义,不受影响)。
+*/
+function unwrapDoubleEncodedScript(script) {
+	if (script.length >= 2 && script.startsWith("\"") && script.endsWith("\"") && script.includes("\\")) try {
+		const parsed = JSON.parse(script);
+		if (typeof parsed === "string" && parsed !== script) return {
+			script: parsed,
+			unwrapped: true
+		};
+	} catch {}
+	return {
+		script,
+		unwrapped: false
+	};
+}
 async function evalTool(config, args) {
 	const page = await getPage(config);
-	const script = String(args.script ?? "");
+	const { script, unwrapped } = unwrapDoubleEncodedScript(String(args.script ?? ""));
 	const wrapped = /[\n;]|^\s*return\b/.test(script) ? `(async () => {\n${script}\n})()` : `(${script})`;
 	const raw = await page.evaluate(wrapped);
 	let result;
@@ -2046,7 +2065,10 @@ async function evalTool(config, args) {
 	} catch {
 		result = raw === void 0 ? null : String(raw);
 	}
-	return { result };
+	return {
+		result,
+		...unwrapped ? { scriptUnwrapped: true } : {}
+	};
 }
 async function screenshotTool(config, args, exec) {
 	const page = await getPage(config);
@@ -3342,15 +3364,27 @@ async function recordTool(args) {
 		if (!name) throw new Error("save 需要 name");
 		const recorded = lastRecordingOf();
 		const source = recorded !== null ? "recording" : "recent-log";
-		const rawSteps = recorded !== null ? recorded.map((c) => ({
-			tool: c.tool,
-			args: c.args ?? {},
-			...c.meta !== void 0 ? { meta: c.meta } : {}
-		})) : testLogOf().reverse().slice(-100).map((c) => ({
-			tool: c.tool,
-			args: c.args ?? {},
-			...c.meta !== void 0 ? { meta: c.meta } : {}
-		}));
+		const calls = recorded !== null ? recorded : testLogOf().reverse().slice(-100);
+		const includeFailed = args.includeFailed === true;
+		const failedCount = includeFailed ? 0 : calls.filter((c) => c.ok === false).length;
+		const rawSteps = (includeFailed ? calls : calls.filter((c) => c.ok !== false)).map((c) => {
+			if (c.tool === "browser_eval" && typeof c.args?.script === "string") {
+				const { script } = unwrapDoubleEncodedScript(c.args.script);
+				if (script !== c.args.script) return {
+					tool: c.tool,
+					args: {
+						...c.args,
+						script
+					},
+					...c.meta !== void 0 ? { meta: c.meta } : {}
+				};
+			}
+			return {
+				tool: c.tool,
+				args: c.args ?? {},
+				...c.meta !== void 0 ? { meta: c.meta } : {}
+			};
+		});
 		const steps = args.stripReads === true ? rawSteps.filter((s) => !isReadonlyStep(s)) : rawSteps;
 		const stripped = rawSteps.length - steps.length;
 		let varsApplied = 0;
@@ -3379,6 +3413,7 @@ async function recordTool(args) {
 			source,
 			file,
 			...stripped > 0 ? { stripped } : {},
+			...failedCount > 0 ? { skippedFailed: failedCount } : {},
 			...varsApplied > 0 ? { varsApplied } : {},
 			...warnings.length > 0 ? { warnings } : {},
 			hint: "已持久化到磁盘,重启 DSH 后仍可回放"
@@ -4304,7 +4339,13 @@ function registerTools(ctx, config) {
 		outputSchema: {
 			type: "object",
 			additionalProperties: false,
-			properties: { result: {} },
+			properties: {
+				result: {},
+				scriptUnwrapped: {
+					type: "boolean",
+					description: "入参 script 疑似被 JSON 双重序列化(以引号包裹且含 \\n 字面量),已自动解码一层。"
+				}
+			},
 			required: ["result"]
 		},
 		render: (_args, value) => `Result: ${JSON.stringify(value.result)}`,
@@ -5409,6 +5450,10 @@ function registerTools(ctx, config) {
 					type: "boolean",
 					description: "save 时剔除只读步骤(snapshot/elements/eval/network/status/cookies list),默认 false。"
 				},
+				includeFailed: {
+					type: "boolean",
+					description: "save 时保留失败的实验步骤(默认剔除:超时/无效 selector 的步骤回放必然再次失败并卡住回放)。"
+				},
 				vars: {
 					type: "object",
 					description: "save 时参数化:{ 变量名: \"#步骤号.args.字段\" }(步骤号 1 起),该字段值替换为 {{变量名}} 占位符;replay 时用 vars 传入真实值。"
@@ -5423,6 +5468,10 @@ function registerTools(ctx, config) {
 				recording: { type: "boolean" },
 				steps: { type: "integer" },
 				stripped: { type: "integer" },
+				skippedFailed: {
+					type: "integer",
+					description: "save 时默认剔除的失败实验步骤数。"
+				},
 				varsApplied: { type: "integer" },
 				saved: { type: "string" },
 				source: { type: "string" },

package/lib/types/browser/tools.d.ts

@@ -155,7 +155,18 @@ export declare function selectTool(config: BrowserConfig, args: Record<string, a
     selected: string;
     selector: string;
 }>;
+/**
+ * 防御性解码 eval 脚本:模型/人工偶发把脚本 JSON.stringify 一次再传
+ * (脚本以 \" 开头、换行变字面 \\n),回放/录制链路不纠错会导致语法错误。
+ * 识别条件:字符串以引号包裹且含反斜杠转义,且 JSON.parse 结果仍是字符串。
+ * 无法解析或语义不变场景原样返回(裸字符串字面量如 "hello" 不含转义,不受影响)。
+ */
+export declare function unwrapDoubleEncodedScript(script: string): {
+    script: string;
+    unwrapped: boolean;
+};
 export declare function evalTool(config: BrowserConfig, args: Record<string, any>): Promise<{
+    scriptUnwrapped?: boolean | undefined;
     result: unknown;
 }>;
 export declare function screenshotTool(config: BrowserConfig, args: Record<string, any>, exec?: ToolRunContext): Promise<{
@@ -566,6 +577,7 @@ export declare function recordTool(args: Record<string, any>): Promise<{
     hint: string;
     warnings?: string[] | undefined;
     varsApplied?: number | undefined;
+    skippedFailed?: number | undefined;
     stripped?: number | undefined;
     saved: string;
     steps: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-browser-view",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "DSH 插件:共享 Playwright 浏览器自动化(36 个 browser_* 工具,含语义元素查找、批处理、视觉回归、选择器自愈、参数化回放、结构化抽取、回归报告与隔离 context)+ 人机协作(人工接管等待、敏感操作审批、人机混合录制、面板双向化:操作预告高亮/内嵌报告)+ 实时画面面板与录制管理。仅依赖 playwright-core,不依赖任何 @deepseek-ai 运行时包。",
   "type": "module",
   "main": "./lib/index.js",