page-agent-sdk 4.26.1 → 4.26.2

package/README.md

@@ -8,7 +8,7 @@
 
 [![npm](https://img.shields.io/npm/v/page-agent-sdk.svg)](https://www.npmjs.com/package/page-agent-sdk)
 [![license](https://img.shields.io/badge/license-ISC-blue.svg)](https://github.com/whyymj/page-agent-sdk/blob/master/LICENSE)
-[![tests](https://img.shields.io/badge/self%20tests-3856%20asserts-brightgreen.svg)](#self-tests)
+[![tests](https://img.shields.io/badge/self%20tests-3861%20asserts-brightgreen.svg)](#self-tests)
 
 ---
 

package/README.zh-CN.md

@@ -8,7 +8,7 @@
 
 [![npm](https://img.shields.io/npm/v/page-agent-sdk.svg)](https://www.npmjs.com/package/page-agent-sdk)
 [![license](https://img.shields.io/badge/license-ISC-blue.svg)](https://github.com/whyymj/page-agent-sdk/blob/master/LICENSE)
-[![tests](https://img.shields.io/badge/self%20tests-3856%20asserts-brightgreen.svg)](#自测)
+[![tests](https://img.shields.io/badge/self%20tests-3861%20asserts-brightgreen.svg)](#自测)
 
 ---
 

package/dist/page-agent-sdk.headless.js

@@ -14962,35 +14962,42 @@ function E_(e, t, n) {
 //#endregion
 //#region src/core/sdk/actions.ts
 var D_ = /^[a-zA-Z][a-zA-Z0-9_]*$/;
-function O_(e) {
-	let n = [];
-	for (let [r, i] of Object.entries(e)) {
-		if (!D_.test(r)) {
-			console.warn(`[page-agent-sdk][actions] 动作名 "${r}" 非法(须匹配 ${D_}),已跳过`);
+function O_(e, n = {}) {
+	let r = [];
+	for (let [i, a] of Object.entries(e)) {
+		if (!D_.test(i)) {
+			console.warn(`[page-agent-sdk][actions] 动作名 "${i}" 非法(须匹配 ${D_}),已跳过`);
 			continue;
 		}
-		let e = i.description || `宿主动作 ${r}`;
-		n.push(s(async (e) => {
+		let e = a.description || `宿主动作 ${i}`;
+		r.push(s(async (e) => {
 			try {
-				let t = await i.run(e || {});
-				return t === void 0 ? `动作 ${r} 执行完成。` : typeof t == "string" ? t : JSON.stringify(t);
+				let t = await a.run(e || {});
+				return t === void 0 ? `动作 ${i} 执行完成。` : typeof t == "string" ? t : JSON.stringify(t);
 			} catch (e) {
 				let t = e?.message || String(e);
-				return `动作 ${r} 执行失败:${t}`;
+				return n.onError?.({
+					name: i,
+					message: t
+				}), Z({
+					code: "ACTION_FAILED",
+					message: `动作 ${i} 执行失败:${t}`,
+					hint: "检查参数与宿主状态后修正重试;连续失败时换思路或如实告知用户,不要原样重发相同调用。"
+				});
 			}
 		}, {
-			name: r,
+			name: i,
 			description: e,
-			schema: i.params ?? t.object({})
+			schema: a.params ?? a.schema ?? t.object({})
 		}));
 	}
-	return n;
+	return r;
 }
 function k_(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) D_.test(n) && (t[n] = {
 		description: r.description,
-		hasParams: !!r.params,
+		hasParams: !!(r.params || r.schema),
 		readsHostState: r.readsHostState === !0,
 		deferredWrite: r.deferredWrite === !0
 	});
@@ -15466,7 +15473,17 @@ function rv(e, n, r) {
 		}
 	}) : null, Ie = [...e.tools || [], ...Fe?.tools ?? []];
 	Ie.forEach((e) => K.set(e.name, "user"));
-	let Le = O_(e.actions ?? {});
+	let Le = O_(e.actions ?? {}, { onError: ({ name: e, message: t }) => {
+		X.agent?.debugLogs?.value?.push({
+			timestamp: Date.now(),
+			type: "middleware",
+			data: {
+				stage: "action_failed",
+				name: e,
+				message: t.slice(0, 300)
+			}
+		});
+	} });
 	Le.forEach((e) => K.set(e.name, "action"));
 	let Re = Fe ? e.proposals?.readToolName || "read_content" : null, ze = Fe ? e.proposals?.toolName || "propose_content" : null, Be = /* @__PURE__ */ new Set([...Object.entries(e.actions ?? {}).filter(([, e]) => e?.readsHostState === !0).map(([e]) => e), ...Re ? [Re] : []]), Ve = /* @__PURE__ */ new Set([...Object.entries(e.actions ?? {}).filter(([, e]) => e?.deferredWrite === !0).map(([e]) => e), ...ze ? [ze] : []]), He = [], Ue = !1, We = e.humanConfirm !== !1 && (!e.approval || e.approval.humanConfirmTool !== !1), Ge = We ? ku() : null;
 	Ge && K.set(Du, "builtin");

package/dist/page-agent-sdk.iife.js

@@ -3144,7 +3144,7 @@ ${`- 输出形态:完整、自包含的 HTML 页面(.${r},可独立成页)`}
 
 `).trim()}function Cge(e){try{return e.querySelector?.(bge)!=null||e.querySelector?.(`.chat-dialog, .chat-mask, .debug-drawer, .skill-mask, .skill-panel, .chat-selection-menu`)!=null}catch{return!0}}function V4(e,t){return t===`invalid`?`ERROR: selector 非法 "${e}"。不要手编复杂选择器 —— 先 dom_search 关键词定位,复用命中结果的 selector 原文。`:`未找到匹配元素:selector="${e}"(若不确定元素定位,先 dom_search 关键词取其 selector 再复用)`}var H4=[B4,IF(({selector:e,offset:t,limit:n})=>{if(typeof document>`u`)return`ERROR: read_page 仅在浏览器环境可用(当前运行在 node/服务端,无 DOM)。请基于用户消息中的引用原文回答。`;let r,i;if(e){try{r=document.querySelector(e)}catch{return V4(e,`invalid`)}if(!r)return V4(e,`miss`);i=e}else r=xge(document),i=r?r.tagName.toLowerCase():`body`;let a=Sge(r,aH,Cge),o=t??0,s=n??4e3;if(o>a.length)return`offset=${o} 超出正文长度 ${a.length}(先从 offset=0 读,按 hasMore 续读)`;let c=a.slice(o,o+s);return JSON.stringify({text:c,totalChars:a.length,offset:o,limit:s,hasMore:o+c.length<a.length,container:i})},{name:`read_page`,description:`读当前页面正文纯文本(自动定位 article/main 等文章容器;排除 SDK 对话框自身与脚本样式)。回答「这个页面讲了什么/某段内容在哪」类问题用;长文按 hasMore=true 时 offset+=本次返回长度 续读。只读,大结果自动外存 vfs。`,schema:B({selector:R().optional().describe(`CSS 选择器(默认智能定位 article/main/[role=main]/.content,兜底 body)`),offset:ed().int().min(0).optional().describe(`起始字符偏移(默认 0;续读传上次 offset + 返回 text 长度)`),limit:ed().int().min(200).max(2e4).optional().describe(`本次返回字符上限(默认 4000,上限 20000)`)})})],U4=`display.position.visibility.opacity.color.background-color.background-image.font-size.font-weight.line-height.text-align.z-index.overflow.width.height.margin.padding.border.border-radius.box-shadow.transform.transition.animation.cursor.pointer-events.flex-direction.gap.max-width.min-height`.split(`.`),W4=new WeakMap,G4=!1;function K4(){if(G4)return;let e=globalThis.EventTarget;if(!e?.prototype?.addEventListener)return;G4=!0;let t=e.prototype.addEventListener,n=e.prototype.removeEventListener;e.prototype.addEventListener=function(e,...n){try{let t=W4.get(this);t||(t=new Map,W4.set(this,t)),t.set(String(e),(t.get(String(e))??0)+1)}catch{}return t.call(this,e,...n)},e.prototype.removeEventListener=function(e,...t){try{let t=W4.get(this);if(t){let n=(t.get(String(e))??1)-1;n<=0?t.delete(String(e)):t.set(String(e),n)}}catch{}return n.call(this,e,...t)}}function q4(e){return[...W4.get(e)?.entries()??[]].filter(([,e])=>e>0).map(([e])=>e)}function J4(e,t=12){let n=[],r=e,i=0;for(;r&&r.tagName&&i<t;){let e=r.tagName.toLowerCase(),t=r.id;if(t){n.unshift(`${e}#${t}`);break}if(typeof r.getAttribute==`function`){let t=(r.getAttribute(`class`)||``).split(/\s+/).filter(Boolean)[0];t&&/^[A-Za-z][\w-]*$/.test(t)&&(e+=`.${t}`)}let a=r.parentElement;if(a){let t=Array.from(a.children).filter(e=>e.tagName===r.tagName);t.length>1&&(e+=`:nth-of-type(${t.indexOf(r)+1})`)}n.unshift(e),r=a,i++}return n.join(` > `)}function Y4(e,t,n={}){if(!e)return{hits:[],total:0,truncated:!1};let r=Math.max(1,Math.min(n.limit??10,20)),i=n.mode??`selector`,a=[];if(i===`selector`)try{a=Array.from(e.querySelectorAll(t))}catch{return{hits:[],total:0,truncated:!1}}else{a=Array.from(e.querySelectorAll(`*`)).filter(e=>{let n=e.tagName.toLowerCase();if(n===`script`||n===`style`||n===`noscript`)return!1;let r=(e.textContent||``).trim();return r.length>0&&r.includes(t)});let n=a.slice(0,100),r=new Set(n);a=n.filter(e=>{for(let t of r)if(t!==e&&e.contains(t))return!1;return!0})}a=a.filter(e=>!aH(e));let o=Math.min(a.length,r);return{hits:a.slice(0,o).map(e=>{let n=(typeof e.textContent==`string`&&e.textContent?e.textContent:Array.from(e.childNodes??[]).filter(e=>e.nodeType===3).map(e=>e.textContent||``).join(``)).replace(/\s+/g,` `).trim(),r=n.slice(0,120);if(i!==`selector`&&t){let e=n.indexOf(String(t));e>=0&&(r=(e>100?`…`:``)+n.slice(Math.max(0,e-100),e+120)+(e+120<n.length?`…`:``))}return{selector:J4(e),tag:e.tagName.toLowerCase(),text:r}}),total:a.length,truncated:a.length>o}}var wge=[`content`,`display`,`width`,`height`,`background-color`,`position`];function X4(e,t={}){if(!e)return null;let n={selector:J4(e),tag:e.tagName.toLowerCase(),attrs:{}};for(let t of Array.from(e.attributes))!(I4.includes(t.name)||t.name.startsWith(`data-`))||L4.test(t.name)||R4.test(t.name)||(n.attrs[t.name]=t.value);let r=Array.from(e.childNodes).filter(e=>e.nodeType===3).map(e=>e.textContent||``).join(``).trim();r&&(n.text=r.slice(0,400));let i=String(e.innerText??e.textContent??``).trim();if(i&&(n.textAll=i.slice(0,1e3)),(t.includeRect??!0)&&typeof e.getBoundingClientRect==`function`){let t=e.getBoundingClientRect();n.rect={x:Math.round(t.x),y:Math.round(t.y),width:Math.round(t.width),height:Math.round(t.height)}}if(t.includeHtml){let r=Math.min(t.htmlLimit??1500,4e3),i=e.outerHTML??``;n.html=i.length>r?i.slice(0,r)+`…(截断 ${i.length-r} 字符)`:i}let a=t.getComputedStyle??globalThis.window?.getComputedStyle?.bind(globalThis.window),o=n=>{let r={};if(typeof a!=`function`)return r;try{let i=a(e,n??null);for(let e of n?wge:t.styles??U4){let t=typeof i.getPropertyValue==`function`?i.getPropertyValue(e):i[e];t&&(r[e]=String(t).slice(0,200))}}catch{}return r};if((t.styles===void 0||t.styles.length>0)&&(n.styles=o()),t.pseudo&&(n.pseudoStyles={before:o(`::before`),after:o(`::after`)}),t.includeEvents!==!1){let t=Array.from(e.attributes).filter(e=>/^on\w+$/i.test(e.name)).map(e=>({type:e.name.toLowerCase().slice(2),snippet:e.value.slice(0,100)})),r=e.__vueParentComponent?.vnode?.props;n.events={inline:t,vue:r?Object.keys(r).filter(e=>/^on[A-Z]/.test(e)).map(e=>e.slice(2).toLowerCase()):[],captured:q4(e)}}return n}var Z4=IF(({query:e,mode:t,limit:n,root:r})=>{K4();let i=r?document.querySelector(r):document;if(r&&!i)return`未找到 root 元素:selector="${r}"`;let a=Y4(i,e,{mode:t,limit:n});return a.total?JSON.stringify({...a,note:a.truncated?`共 ${a.total} 处命中,仅返回前 ${a.hits.length} 处`:void 0},null,2):t===`text`?`未找到包含文本「${e}」的元素`:`selector "${e}" 未匹配到元素`},{name:`dom_search`,description:`搜索页面元素:CSS 选择器或可见文本两种模式,返回命中元素的 CSS 路径 + 文本片段(≤20 处)。定位元素/查渲染结果用;找到 selector 后可用 dom_info 看详情或 get_dom 看结构。`,schema:B({query:R().describe(`selector 模式 = CSS 选择器(如 ".banner .title");text 模式 = 文本关键词`),mode:jd([`selector`,`text`]).optional().describe(`搜索模式(默认 selector;text = 文本包含匹配)`),limit:ed().int().min(1).max(20).optional().describe(`返回上限(默认 10)`),root:R().optional().describe(`限定搜索范围的容器选择器(默认整页)`)})}),Q4=IF(({selector:e,styles:t,includeHtml:n,htmlLimit:r,includeEvents:i,includeRect:a,pseudo:o})=>{K4();let s=document.querySelector(e);if(!s)return`未找到匹配元素:selector="${e}"(可先用 dom_search 定位)`;if(aH(s))return`ERROR: 该 selector 命中 SDK 对话框自身(排障应读宿主页面元素)。`;let c=X4(s,{styles:t,includeHtml:n,htmlLimit:r,includeEvents:i,includeRect:a,pseudo:o});return c?JSON.stringify(c,null,2):`selector="${e}" 读取失败`},{name:`dom_info`,description:`读单个元素完整信息:内容(直接文本/全文本/HTML 片段)+ 计算样式(默认排障高频预设,可指定属性列表)+ 几何位置 + 事件绑定(inline on*/Vue props/addEventListener 记录;记录器仅覆盖 SDK 加载后注册的监听)。验证样式落地/排查交互绑定用。`,schema:B({selector:R().describe(`CSS 选择器(取首个匹配;可先用 dom_search 定位)`),styles:z(R()).optional().describe(`计算样式属性列表(不传 = 常用预设 ~30 项)`),includeHtml:od().optional().describe(`是否含 outerHTML 片段(默认 false,大 HTML 省 token)`),htmlLimit:ed().int().min(100).max(4e3).optional().describe(`HTML 片段上限字符(默认 1500)`),includeEvents:od().optional().describe(`是否含事件绑定(默认 true)`),includeRect:od().optional().describe(`是否含几何位置(默认 true)`),pseudo:od().optional().describe(`是否含 ::before/::after 伪元素摘要(默认 false)`)})}),Tge=`dom-inspect`;function $4(e={}){return{name:Tge,description:`页面 DOM 深度检视工具(dom_search 搜索元素 / dom_info 读内容·计算样式·事件绑定·几何)。定位元素、验证样式落地、排查交互绑定时加载`,getContent:()=>[`# DOM 检视工具用法`,`## read_page({ selector?, offset?, limit? })—— 读正文首选`,`- 返回页面正文纯文本(JSON:text/totalChars/offset/hasMore/container),自动定位 article/main/[role=main]/.content 容器并排除本对话框自身与 script/style`,`- 长文分页:默认每次 4000 字符;hasMore=true 时下一次调用传 offset=上次 offset+本次 text 长度 续读`,`- 回答「这个页面讲了什么/某段在哪」类问题用 read_page,不要用 get_dom 逐层翻结构(爆 token)`,`## dom_search({ query, mode?, limit?, root? })`,`- mode="selector"(默认):query 为 CSS 选择器;mode="text":文本关键词包含匹配(跳过 script/style)`,`- 返回命中列表:CSS 路径(selector)+ 文本片段;超 limit 标注总数`,`## dom_info({ selector, styles?, includeHtml?, pseudo?, ... })`,`- selector 取首个匹配(先用 dom_search 定位更稳)`,`- styles 不传 = 排障高频预设(display/position/color/background/font/z-index/transform 等约 30 项);传数组 = 只取指定属性`,`- includeHtml: true 附 outerHTML 片段(默认省);pseudo: true 附 ::before/::after 摘要`,`- events 三源:inline on* 属性 / Vue vnode props(onXxx)/ addEventListener 记录器(⚠ 仅记录本 SDK 加载之后注册的监听,更早的挂载捕不到)`,`- rect:视口坐标 + 宽高(验证可见性/布局)`,...e.withScreenshot?[`## take_screenshot({ selector?, fullPage? })—— 视觉验证`,`- 截图「看」页面:selector 截指定元素区域 / fullPage 截整页 / 都不传截当前视口;截图经压缩投递(多模态直看图,纯文本模型自动走识图转述)`,`- 布局/样式/渲染效果类问题优先截图(视觉真值),结构/属性类用 dom_info;截图失败(CSP/跨域图)会回灌原因与替代建议`]:[],...e.withDomEdit?[`## dom_edit({ patches, dryRun? })—— 修改页面元素(宿主开启才有)`,`- patches 批量原子(任一失败整批拒绝):set_text/set_html(内容)、set_attr/remove_attr、add_class/remove_class、set_style、insert(新建元素 anchor+position: before/after/prepend/append/replace)、remove、move(层级调整)、highlight(高亮+滚动)`,`- 写纪律:selector 必须唯一命中(多匹配被拒,用 dom_search 拿精确路径);先读后写(get_dom/dom_info 看现状);拿不准先 dryRun 预检`,`- 改前自动快照:dom_restore 回滚最近一批(可连续回退);改动为会话临时态(刷新即失);数据驱动页面改数据(write)不要改 DOM`]:[],`## 排障套路`,...e.withScreenshot?[`1. dom_search(mode:"text", query:按钮文案) 定位 → 2. 视觉验证 take_screenshot / 结构验证 dom_info(styles) → 3. `+(e.withDataOps?`不符则改数据(write 修正后再验证)`:`不符则如实报告差异(页面为真值;本页面无数据写通道,调整预期或告知用户)`)]:[`1. dom_search(mode:"text", query:按钮文案) 定位 → 2. dom_info(styles:["display","background-color","pointer-events"]) 验证样式/点击性 → 3. `+(e.withDataOps?`不符则改数据(write 修正后再验证)`:`不符则如实报告差异(页面为真值;本页面无数据写通道,调整预期或告知用户)`)]].join(`
 `),tools:[()=>[Z4,Q4]]}}var Ege=`page-analysis`;function Dge(e={}){return{name:Ege,description:`页面内容分析策略:按问题类型选工具(引用原文/整页理解/定位/结构/视觉/页面操作),含分页探索纪律与基于页面实料的回答纪律。回答用户关于当前页面的问题时加载`,getContent:()=>[`# 页面内容分析策略`,`## 第一步:问题分型(按类型选主力工具,不要一上来读整页)`,`- **引用原文类**(用户消息带引用块):优先围绕引用原文作答;需要上下文再向外探索(所在小节 → 整页)`,`- **整页理解类**(「这页讲了什么/总结要点」):read_page 读正文,长文按 hasMore 翻页,边读边归纳不要一次读爆`,`- **定位类**(「某概念在本页哪里/那个按钮在哪」):dom_search mode:"text" 按关键词定位 → 需要细节再 read_page 带 selector 读该区域`,`- **结构/属性类**(「这个区块是什么组件/有哪些属性」):dom_info(selector) 读单元素;层级关系用 get_dom`,...e.withScreenshot?[`- **视觉类**(「看起来对不对/布局乱不乱/渲染效果」):take_screenshot 截图看视觉真值;selector 截局部、fullPage 截整页;截图是唯一能看到实际渲染效果的手段,结构推断不能代替`]:[],...e.withDomEdit?[`- **操作类**(「把这段高亮/隐藏广告/调大字体/把这个块挪过去」):dom_edit patches 批量操作;纪律 = 先 get_dom/dom_search 定位唯一 selector → 拿不准先 dryRun → 改后 dom_info/截图验证 → 不满意 dom_restore 回滚;页面是临时态,持久修改要走宿主自己的机制`]:[],`## 探索纪律`,`1. **先窄后宽**:引用/焦点 → 所在小节 → 整页;每一步只取够回答当前问题的量`,`2. **翻页不重复**:read_page 续读传 offset = 上次 offset + 返回 text 长度;不要回头重读已读区`,`3. **定位失败换路**:selector 不命中 → dom_search text 模式换关键词;还不中 → read_page 扫小节标题再回来`,...e.withVfs?[`4. **大结果在外存**:超大结果被移入 vfs 后用 vfs_read/vfs_grep 按需取,不要盲目重调`]:[],`## 回答纪律(页面问答的底线)`,`- **基于页面实料**:答案须来自你读到的页面内容(引用原文/read_page/dom 工具结果),并在回答中点明出处小节/位置`,`- **页面 ≠ 训练数据**:页面内容可能与你的先验知识不同,冲突时以页面为准;页面没写的不要编造`,`- **不确定就说不确定**:找不到的内容如实说「本页未找到」,给出已探索的范围,勿凭印象补全`,`## 输出纪律(直接说内容,不写过程)`,`- 禁**过程叙述**:「我先读一下页面」「让我确认一下」—— 工具调用用户看得见,不需要旁白`,`- 禁**元话术**:「先给结论」「依据是」「简言之」—— 第一句直接就是答案本身,不要先宣布你要说什么`,`- 禁**方法论自述**:不要解释结论是怎么来的(「这些不是页面写明的,而是从正文用词反推的」)—— 那是你的内部过程`,`- 禁**预告与套话**:「下面分三点」「综上」—— 该分点就直接分点,说完就停`,`- 出处仍要标,但用最简形式:句末括注(如「(§小节名)」「(原文)」);引原文时直接引,不写「依据是…原文两行:」这样的引导句`].join(`
-`)}}var Oge=$4();Lp();function kge(e){let t=e;return typeof t.tagName==`string`||typeof t.nodeType==`number`&&typeof t.nodeName==`string`}function e3(e,t=3,n=2e3,r,i){if(e==null)return e;if(typeof e==`string`)return e.length>n?e.slice(0,n)+`…(已截断)`:e;if(typeof e==`number`||typeof e==`boolean`)return e;if(typeof e==`function`)return`[Function: ${e.name||`anonymous`}]`;if(typeof e==`symbol`)return e.toString();if(typeof e==`bigint`)return`${e.toString()}n`;if(typeof e!=`object`)return String(e);let a=e;if(kge(a)){let e=a;return e.tagName?`[Element: <${e.tagName.toLowerCase()}>]`:`[Node: ${e.nodeName}]`}if(r?.has(a))return`[Circular]`;let o=r??new WeakSet;if(o.add(a),Array.isArray(e)){let r=e.slice(0,100).map(e=>e3(e,t-1,n,o,i));return e.length>100&&r.push(`…(共 ${e.length} 项,已截断)`),r}if(t<0)return`(对象,已截断)`;let s={},c=Object.keys(a);for(let e=0;e<c.length;e++){let r=c[e];if(e>=50){s[`…`]=`(共 ${c.length} 键,已截断)`;break}try{let e=a[r];i?.test(r)?s[r]=`[REDACTED]`:s[r]=e3(e,t-1,n,o,i)}catch{s[r]=`(getter 抛错)`}}return s}function t3(e){let t=e??(typeof window<`u`?window:{}),n=t.navigator,r=t.location,i=t.document;return{location:{href:r?.href,origin:r?.origin,protocol:r?.protocol,host:r?.host,hostname:r?.hostname,pathname:r?.pathname,search:r?.search},navigator:{userAgent:n?.userAgent,language:n?.language,languages:n?.languages,platform:n?.platform,onLine:n?.onLine},viewport:{innerWidth:t.innerWidth,innerHeight:t.innerHeight,devicePixelRatio:t.devicePixelRatio,scrollX:t.scrollX,scrollY:t.scrollY},document:i?{title:i.title,readyState:i.readyState,characterSet:i.characterSet}:`(无 document)`}}var Age=/^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/,n3=/token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i,r3=IF(({key:e})=>{if(e){if(Age.test(e)||n3.test(e))return JSON.stringify({key:e,denied:!0,reason:`安全:该 key 在 denylist(localStorage/sessionStorage/cookie/document 或敏感命名 token/secret/key/auth),不读取防泄漏`},null,2);let t=(typeof window<`u`?window:{})[e];return JSON.stringify({key:e,exists:t!==void 0,type:typeof t,value:e3(t,3,2e3,void 0,n3)},null,2)}return JSON.stringify(t3(),null,2)},{name:`inspect_env`,description:`读宿主页面环境信息(排查调试)。不传参返回摘要(URL/origin、浏览器/语言、viewport、title/readyState);传 key 读指定 window 属性值(如 key:"appConfig")。只读,大结果自动外存 vfs。`,schema:B({key:R().optional().describe(`要读取的 window 属性名(如 "appConfig"/"__DEBUG__");不传 = 返回环境摘要`)})}),i3=[r3];function jge(e,t,n){let r=0;return{name:`budget`,beforeAgent:()=>{r=Date.now()},wrapModelCall:async(i,a)=>{let{tokenBudget:o,timeBudgetMs:s}=t,c=o!=null&&(e.total_tokens??0)>o,l=s!=null&&Date.now()-r>s;return c||l?(n({type:`error`,severity:`observable`,code:`BUDGET_EXCEEDED`,message:`资源预算超限:${c?`token 超限(累计 ${e.total_tokens??0} > 上限 ${o})`:`时间超限(${Date.now()-r}ms > 上限 ${s}ms)`},agent 已停止(未完成部分可用 restoreLastCheckpoint 回退)。`}),{message:new $x({content:``}),content:``,toolCalls:[],aborted:!0}):a(i)}}}Lp();var a3=/^[a-zA-Z][a-zA-Z0-9_]*$/;function o3(e){let t=[];for(let[n,r]of Object.entries(e)){if(!a3.test(n)){console.warn(`[page-agent-sdk][actions] 动作名 "${n}" 非法(须匹配 ${a3}),已跳过`);continue}let e=r.description||`宿主动作 ${n}`;t.push(IF(async e=>{try{let t=await r.run(e||{});return t===void 0?`动作 ${n} 执行完成。`:typeof t==`string`?t:JSON.stringify(t)}catch(e){let t=e?.message||String(e);return`动作 ${n} 执行失败:${t}`}},{name:n,description:e,schema:r.params??B({})}))}return t}function s3(e){let t={};for(let[n,r]of Object.entries(e))a3.test(n)&&(t[n]={description:r.description,hasParams:!!r.params,readsHostState:r.readsHostState===!0,deferredWrite:r.deferredWrite===!0});return t}var Mge=F4,Nge=H4;function Pge(e,t){return O0(e,t)}function c3(e,t,n,r,i){let a=H2(e);return[...a.dataOps?t:[],...a.fetch?n:[],...a.domInspect&&r?r:[],...a.inspectEnv&&i?i:[]]}var l3=.7,Fge=.5,u3=.85;function Ige(e,t){if(!Number.isFinite(t)||t<=0||e<=0||e<t*Fge)return``;let n=Math.max(1,Math.round(e/1e3));return e>=t*u3?`⏳ 预算告急:本任务累计约 ${n}K prompt tokens(已达 softCap 上限的 ${Math.round(u3*100)}%)。立即停止扩展性操作(新查询/重读/优化),完成手头最关键一步后基于已有工具结果给出结论,并如实汇报剩余未完成项。轮次预算吃紧时系统会另行注入轮次提示段。`:`⏳ 预算提示:本任务累计约 ${n}K prompt tokens(已过 softCap 半程)。若已接近目标请收敛并给出总结;尚未接近请向用户汇报进度与剩余计划,勿默默继续。轮次预算吃紧时系统会另行注入轮次提示段。`}function d3(e,t,n){let r=H2(e);return{name:`usageHints`,augmentPrompt:i=>{let a=[];if(r.planning&&(a.push(`【自适应规划】按任务复杂度决定是否先规划,不要对简单任务过度编排:`),a.push(`  · 简单/明确任务(改单字段、调样式、查值)→ 直接 read/write 执行,不必 write_todos。`),a.push(`  · 复杂任务(多步、大改、有歧义、不可逆)→ 先 write_todos 拆解,首个任务标 in_progress,逐项推进。`),a.push(`  · 执行中发现步骤要改/补/细分 → 用 update_todo({id, content?, status?}) 按 id 增量改单项,不必重传整个清单。`),a.push(`  · update_todo 标 completed 时附 evidence: 本次实际写入的 jsonPath(如 "components.2"),供收口对账;工作经委派子 agent 完成等无主写路径时,如实写明完成方式(勿编造路径)。`),e?.humanConfirm?a.push(`  · 规划出多步方案若需用户拍板 → 先 request_human_confirmation 给方案选项,确认后再执行。`):a.push(`  · 规划出多步方案若需用户拍板 → 以文字列出方案选项等用户回复,勿自行拍板。`),a.push(`  · 计划修订有次数上限(maxPlanRevisions,默认 5,只计 write_todos 调用、调研轮不计):勿反复改计划而不执行,规划充分后即开始 write 落地。`)),t&&(a.push(`改主数据前先 read({jsonPath}) 读其当前真实值(返回末尾 hash=xxx 为乐观锁标识),基于真实值改,不要凭记忆。写入是否被自动校验由集成方 conflictWatchFields 声明决定:若已声明且主数据在你 read 之后被外部改过,会触发冲突——集成方若开启人工介入,工具会挂起等用户决定(保留外部/强制覆盖/回退),你应等待工具返回后按结果继续(保留外部→重新 read 再改;强制覆盖→已写入,继续;回退→已回退到历史快照,基于回退值重写);未开启人工介入时返回 VERSION_CONFLICT 不写入,重新 read 拿最新值再改。`),a.push(`读类分流:取值/结构 → read(多路径用 jsonPaths);字段约束 → schema_data;条件筛选定位 → query_data(多条一次用 queries);名字模糊找 → search_data;整体说明 → read 不传路径。`),a.push(`修改大对象/数组优先用 write 增量改({patch:{op,jsonPath,value}} 只发改动部分),避免 write({value}) 整体重传被 max_tokens 截断导致 JSON 不完整、校验失败。`),a.push(`修改主数据出错时可用 restore_data 回退最近一次。`),a.push(`在大数组里按条件筛选元素用 query_data(JSONPath,如 $.components[?(@.type=="card" && @.price<100)]),返回匹配元素的 path/index;定位后再 write({patch}) 改。`),a.push(`找名字记不清的元素用 search_data(支持 substring/regex/fuzzy 模糊搜索)。`),a.push(`需要过滤/映射/聚合/批量重写大数组时用 eval_script(沙箱脚本,入参 data);只读探查用 mode=query,批量重写用 mode=transform(返回值经校验后落地)。`),a.push(`读大数组用 read({jsonPath,offset,limit}) 分页(返回 hasMore=true 时 offset+=limit 续读);一次读多个不相关子路径用 read({jsonPaths});复杂改动先 write({...,dryRun:true}) 预检不落盘。`),a.push(`【省轮次·批量】≥2 个路径一律 read({jsonPaths:[...]}) 一次取回(路径互不相关也合批,禁止连续单路径 read);多条件筛选用 query_data({queries:[expr1,expr2,…]}) 一次取回(2-10 条);改多处用 write({patches:[{op:"set",jsonPath,value},...]}) 一次提交多改动(原子任一失败回滚),勿逐个 write 烧轮次预算。`),a.push(`读到 <subtree Nkb keys:[…] #指纹> 或 <code Nkb> 占位 = 该子树键名/体积可见但内容未见:写入前先窄读全文(read({jsonPath:"该子树路径"}),结果根豁免返全文)或 set_focus 聚焦该区域;勿凭键名印象猜路径/猜值直写(直接写占位子树会被拦下要求先窄读)。`),a.push(`对比当前与历史快照(或一段 JSON against)的差异用 diff_data({snapshotId?,against?})(返回结构化 path→from/to,verify 自纠/操作审计/"刚才改了啥");只读查历史快照值用 history_data({id?,jsonPath?})。`)),r.subagent&&a.push(`独立子任务可 spawn_agent 委派(过程隔离,不占主上下文):默认只读,需要子 agent 写数据时传 writablePaths(路径前缀白名单,越界 PATH_OUT_OF_SCOPE)。多个独立子任务可 spawn_agents 并行委派(各子互不通信,结论由你汇总;并行委派不可授写权限,写操作由你收尾执行)。`),r.inspectEnv&&a.push(`排查页面环境(当前 URL/浏览器/视口/集成方调试变量)用 inspect_env——不传参返回环境摘要(location/navigator/viewport/document),传 key 读特定 window 属性(如 inspect_env({key:"appConfig"}) 读 window.appConfig)。改完数据看渲染、定位"为何没生效"时用它(只读,不改数据)。`),r.domInspect){let n=t&&e?.hasActions?`配合宿主 actions(save_draft/publish 等)形成"改数据→截图/get_dom 看渲染→触发动作"闭环。`:t?`改完数据可用截图/get_dom 查看渲染效果(本集成未注册宿主动作)。`:``,r=e?.skills?`长文按关键词定位(找某术语/某节在哪)先 load_skill("dom-inspect") 取得 dom_search 文本检索,命中后窄读那一节 —— 勿整页翻页找。`:``;a.push(`回答用户关于当前页面/文档的问题时优先用 read_page({selector?,offset?,limit?}) 读页面正文纯文本(长文按 hasMore 分页续读;自动排除本对话框自身);需要页面结构(检查渲染是否生效/定位元素/辅助 UI 设计问答)再用 get_dom({selector?,depth?}) 读渲染后 DOM(结构化返回 tag/attrs/text/children,depth 控制深度防爆炸,只读)。${n}${r}`)}if(e?.screenshot&&a.push(`视觉验证(看布局/样式/渲染效果像不像、对不对)用 take_screenshot({selector?, fullPage?}) 截图查看:selector 截指定元素、fullPage 截整页、默认当前视口;截图自动压缩投递(多模态直看图/纯文本模型走识图转述)。优先级:视觉问题先截图,结构/属性问题用 dom_info。`),e?.domEdit&&a.push(`修改宿主页面元素(高亮/改文案/调样式/插删移元素)用 dom_edit({patches:[{op,selector,...}],dryRun?}) 批量原子操作(op:set_text/set_html/set_attr/add_class/remove_class/set_style/insert/remove/move/highlight);selector 必须唯一命中(先 get_dom/dom_search 定位);改前自动快照,dom_restore 回滚最近一批;改动为会话临时态(刷新即失)——数据驱动页面改数据(write)不要改 DOM。`),e?.viewImage&&a.push(`看「页面数据里的某张图」(轮播第 N 帧/商品图/封面,read 结果里有其 URL)用 view_image({url}) 原图直投 —— 问特定帧时勿截当前渲染帧(自动轮播可能已切帧);要看渲染后的组件(布局/叠加文案)才用 take_screenshot。`),e?.hasProposals&&a.push(`【内容修改(提案制)】修改当前内容(文章/笔记/文档)只有一条通道:①先 read_content 取真实原文与 hash;②propose_content 带 baseHash 提案 —— 优先 ops 增量操作(replace/insertAfter/insertBefore/append,find/anchor 用原文字面片段且须唯一命中,多带上下文保唯一),勿全量重发整篇(token 只花在改动上);③提案仅送达:评审面板打开、用户点「应用」才会写回 —— 提案后如实告知用户待确认,勿声称已修改;用户裁决结果会在下一轮告知你,以裁决为准作答。`),r.draftWrite&&(a.push(`生成超大 JSON(如 50+ 组件页面,单次 write 受 max_tokens 限制装不下)用 draft_write 分块构建 → draft_commit 原子提交:draft_write({draftId, chunk, mode}) mode:"start" 新建/"append" 追加(拼 JSON 片段到 drafts 池);累积完 draft_commit({draftId}) 合并 + schema 校验 + 写主数据(失败草稿保留可修后重试,成功自动清草稿)。小改仍用 write patch,只在大 JSON 从零生成时用 draft。`),a.push(`⚠️ 大 JSON 分块构建是典型多轮工具调用(draft_write×N + draft_commit + read 确认 + 调研 read/query),默认 maxToolRounds=30(3.43 起;轮次预算吃紧时 system 会注入预算提示段,按提示优先收口);目标组件数很大时集成方仍可在 createChatSdk 显式上调 maxToolRounds(按 N+10 估算)。draft_commit 提交同样走乐观锁(改前 read 拿 hash,bind 被改过会触发冲突介入,不静默覆盖)。`)),r.focus&&t&&(a.push(`【上下文聚焦】判断任务范围,用 set_focus/add_focus/remove_focus/clear_focus 自动收敛工作范围:`),a.push(`  · 局部任务(只改某一组件/区域,如「调导航栏」「改 components.3 样式」)→ 先 read 定位 jsonPath,再 set_focus({path:"该子树路径"}) 聚焦;聚焦后每轮只看该子树结构,写其他位置会被 PATH_DENIED 拒绝。`),a.push(`  · 多个相关组件(如「同时改导航栏和页脚」)→ set_focus 聚焦首个后用 add_focus({path}) 追加其余;聚焦后可写任一焦点子树,越界仍被拒;移除单个用 remove_focus({path})。`),a.push(`  · 全局任务(多处/整体结构,如「重排所有组件」「换主题」)→ 不要聚焦,保持全量视野直接写。`),a.push(`  · 完成局部精修、要转向其他区域或做整体改动 → 调 clear_focus 退出聚焦(清空全部焦点),恢复全部读写权限。`),a.push(`  · set_focus/add_focus 的 path 必须在 schema 内(类型校验);不确定路径先 read 查。`)),e?.subagents?.length){let t=e.subagents.filter(e=>(e.temperature??0)>=l3||/规划|创意|设计|方案|brainstorm|plan/i.test(e.description)),n=e.subagents.filter(e=>(e.temperature??0)<l3&&/反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));a.push(`【规划-反思-执行·路由】按任务性质选模式,不要对简单任务过度编排:`),t.length&&(a.push(`  · 创作/设计/开放性需求(如"设计主题风格""换个感觉")→ 先调 ${t.map(e=>`use_`+e.id).join(`/`)} 出 2-3 套方案(高温创意),`),a.push(e?.humanConfirm?`    不要自己拍板;拿到方案后,若需用户拍板用 request_human_confirmation 弹选项。`:`    不要自己拍板;拿到方案后以文字列出选项等用户回复(humanConfirm 未开,勿调不存在工具)。`)),n.length&&a.push(`  · 严谨/易错/校验类 → 可先调 ${n.map(e=>`use_`+e.id).join(`/`)} 反思挑刺(低温审查),据反馈修订。`),a.push(`  · 方案定稿后,由你(主 agent)用 write 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。`),a.push(`  · 简单/明确任务(如"标题改红色")直接执行,不必走规划-反思。`)}e?.humanConfirm&&(a.push(`【人工确认·必读】以下情形必须先调 request_human_confirmation 征询用户、拿到答复后再继续,不要自行拍板:`),a.push(`  1) 用户让你「给方案/列选项/我来选/挑一个」时:把每个方案作为一个 option,调 request_human_confirmation(question=简述, options=[方案A,方案B,...], recommendation=你推荐的)。不要只回文字罗列方案让用户自己回复——要用工具把选项做成可点选按钮。`),a.push(`  2) 需求有歧义/不确定时:调工具问清楚(options 不传则用户答同意或拒绝)。`),a.push(`  3) 即将执行高风险不可逆操作(删除/覆盖/批量改动)前:调工具确认。`),a.push(`  4) 规划出多步方案需用户确认时:把整个方案(或关键分步)作为 option 调 request_human_confirmation,确认后再执行。`),a.push(`用户在选项里选了哪个,就按那个方案继续;选「拒绝」则停止并询问如何调整。`));let o=i?.loopProgress;if(o){let e=Ige(o.invokeUsage.prompt_tokens||o.invokeUsage.total_tokens,n?.promptSoftCap??1/0);e&&a.push(e);let t=Object.entries(o.writeFailures).filter(([,e])=>e>=2);if(t.length){let e=t.map(([e,t])=>`${e||`(整体)`}×${t}`).join(`、`);a.push(`⚠️ 以下路径已连续写失败:${e}。连续失败常意味着方向错了——先 read 重新核对实际值/类型,或 restore_data 回退后再改;若确需继续,换思路而非原样重试。`)}}return a.length&&a.unshift(`调用工具务必用标准 function calling(工具调用)格式发起,不要在回复正文里输出伪 XML/标签(如 deepseek 的 tool_calls 标签、invoke、function_call、tool_call 等)或 JSON 文本——那不会被识别为工具调用,会被当普通文字,工具不执行。`),a.length?`## 能力使用提示
+`)}}var Oge=$4();Lp();function kge(e){let t=e;return typeof t.tagName==`string`||typeof t.nodeType==`number`&&typeof t.nodeName==`string`}function e3(e,t=3,n=2e3,r,i){if(e==null)return e;if(typeof e==`string`)return e.length>n?e.slice(0,n)+`…(已截断)`:e;if(typeof e==`number`||typeof e==`boolean`)return e;if(typeof e==`function`)return`[Function: ${e.name||`anonymous`}]`;if(typeof e==`symbol`)return e.toString();if(typeof e==`bigint`)return`${e.toString()}n`;if(typeof e!=`object`)return String(e);let a=e;if(kge(a)){let e=a;return e.tagName?`[Element: <${e.tagName.toLowerCase()}>]`:`[Node: ${e.nodeName}]`}if(r?.has(a))return`[Circular]`;let o=r??new WeakSet;if(o.add(a),Array.isArray(e)){let r=e.slice(0,100).map(e=>e3(e,t-1,n,o,i));return e.length>100&&r.push(`…(共 ${e.length} 项,已截断)`),r}if(t<0)return`(对象,已截断)`;let s={},c=Object.keys(a);for(let e=0;e<c.length;e++){let r=c[e];if(e>=50){s[`…`]=`(共 ${c.length} 键,已截断)`;break}try{let e=a[r];i?.test(r)?s[r]=`[REDACTED]`:s[r]=e3(e,t-1,n,o,i)}catch{s[r]=`(getter 抛错)`}}return s}function t3(e){let t=e??(typeof window<`u`?window:{}),n=t.navigator,r=t.location,i=t.document;return{location:{href:r?.href,origin:r?.origin,protocol:r?.protocol,host:r?.host,hostname:r?.hostname,pathname:r?.pathname,search:r?.search},navigator:{userAgent:n?.userAgent,language:n?.language,languages:n?.languages,platform:n?.platform,onLine:n?.onLine},viewport:{innerWidth:t.innerWidth,innerHeight:t.innerHeight,devicePixelRatio:t.devicePixelRatio,scrollX:t.scrollX,scrollY:t.scrollY},document:i?{title:i.title,readyState:i.readyState,characterSet:i.characterSet}:`(无 document)`}}var Age=/^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/,n3=/token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i,r3=IF(({key:e})=>{if(e){if(Age.test(e)||n3.test(e))return JSON.stringify({key:e,denied:!0,reason:`安全:该 key 在 denylist(localStorage/sessionStorage/cookie/document 或敏感命名 token/secret/key/auth),不读取防泄漏`},null,2);let t=(typeof window<`u`?window:{})[e];return JSON.stringify({key:e,exists:t!==void 0,type:typeof t,value:e3(t,3,2e3,void 0,n3)},null,2)}return JSON.stringify(t3(),null,2)},{name:`inspect_env`,description:`读宿主页面环境信息(排查调试)。不传参返回摘要(URL/origin、浏览器/语言、viewport、title/readyState);传 key 读指定 window 属性值(如 key:"appConfig")。只读,大结果自动外存 vfs。`,schema:B({key:R().optional().describe(`要读取的 window 属性名(如 "appConfig"/"__DEBUG__");不传 = 返回环境摘要`)})}),i3=[r3];function jge(e,t,n){let r=0;return{name:`budget`,beforeAgent:()=>{r=Date.now()},wrapModelCall:async(i,a)=>{let{tokenBudget:o,timeBudgetMs:s}=t,c=o!=null&&(e.total_tokens??0)>o,l=s!=null&&Date.now()-r>s;return c||l?(n({type:`error`,severity:`observable`,code:`BUDGET_EXCEEDED`,message:`资源预算超限:${c?`token 超限(累计 ${e.total_tokens??0} > 上限 ${o})`:`时间超限(${Date.now()-r}ms > 上限 ${s}ms)`},agent 已停止(未完成部分可用 restoreLastCheckpoint 回退)。`}),{message:new $x({content:``}),content:``,toolCalls:[],aborted:!0}):a(i)}}}Lp();var a3=/^[a-zA-Z][a-zA-Z0-9_]*$/;function o3(e,t={}){let n=[];for(let[r,i]of Object.entries(e)){if(!a3.test(r)){console.warn(`[page-agent-sdk][actions] 动作名 "${r}" 非法(须匹配 ${a3}),已跳过`);continue}let e=i.description||`宿主动作 ${r}`;n.push(IF(async e=>{try{let t=await i.run(e||{});return t===void 0?`动作 ${r} 执行完成。`:typeof t==`string`?t:JSON.stringify(t)}catch(e){let n=e?.message||String(e);return t.onError?.({name:r,message:n}),XV({code:`ACTION_FAILED`,message:`动作 ${r} 执行失败:${n}`,hint:`检查参数与宿主状态后修正重试;连续失败时换思路或如实告知用户,不要原样重发相同调用。`})}},{name:r,description:e,schema:i.params??i.schema??B({})}))}return n}function s3(e){let t={};for(let[n,r]of Object.entries(e))a3.test(n)&&(t[n]={description:r.description,hasParams:!!(r.params||r.schema),readsHostState:r.readsHostState===!0,deferredWrite:r.deferredWrite===!0});return t}var Mge=F4,Nge=H4;function Pge(e,t){return O0(e,t)}function c3(e,t,n,r,i){let a=H2(e);return[...a.dataOps?t:[],...a.fetch?n:[],...a.domInspect&&r?r:[],...a.inspectEnv&&i?i:[]]}var l3=.7,Fge=.5,u3=.85;function Ige(e,t){if(!Number.isFinite(t)||t<=0||e<=0||e<t*Fge)return``;let n=Math.max(1,Math.round(e/1e3));return e>=t*u3?`⏳ 预算告急:本任务累计约 ${n}K prompt tokens(已达 softCap 上限的 ${Math.round(u3*100)}%)。立即停止扩展性操作(新查询/重读/优化),完成手头最关键一步后基于已有工具结果给出结论,并如实汇报剩余未完成项。轮次预算吃紧时系统会另行注入轮次提示段。`:`⏳ 预算提示:本任务累计约 ${n}K prompt tokens(已过 softCap 半程)。若已接近目标请收敛并给出总结;尚未接近请向用户汇报进度与剩余计划,勿默默继续。轮次预算吃紧时系统会另行注入轮次提示段。`}function d3(e,t,n){let r=H2(e);return{name:`usageHints`,augmentPrompt:i=>{let a=[];if(r.planning&&(a.push(`【自适应规划】按任务复杂度决定是否先规划,不要对简单任务过度编排:`),a.push(`  · 简单/明确任务(改单字段、调样式、查值)→ 直接 read/write 执行,不必 write_todos。`),a.push(`  · 复杂任务(多步、大改、有歧义、不可逆)→ 先 write_todos 拆解,首个任务标 in_progress,逐项推进。`),a.push(`  · 执行中发现步骤要改/补/细分 → 用 update_todo({id, content?, status?}) 按 id 增量改单项,不必重传整个清单。`),a.push(`  · update_todo 标 completed 时附 evidence: 本次实际写入的 jsonPath(如 "components.2"),供收口对账;工作经委派子 agent 完成等无主写路径时,如实写明完成方式(勿编造路径)。`),e?.humanConfirm?a.push(`  · 规划出多步方案若需用户拍板 → 先 request_human_confirmation 给方案选项,确认后再执行。`):a.push(`  · 规划出多步方案若需用户拍板 → 以文字列出方案选项等用户回复,勿自行拍板。`),a.push(`  · 计划修订有次数上限(maxPlanRevisions,默认 5,只计 write_todos 调用、调研轮不计):勿反复改计划而不执行,规划充分后即开始 write 落地。`)),t&&(a.push(`改主数据前先 read({jsonPath}) 读其当前真实值(返回末尾 hash=xxx 为乐观锁标识),基于真实值改,不要凭记忆。写入是否被自动校验由集成方 conflictWatchFields 声明决定:若已声明且主数据在你 read 之后被外部改过,会触发冲突——集成方若开启人工介入,工具会挂起等用户决定(保留外部/强制覆盖/回退),你应等待工具返回后按结果继续(保留外部→重新 read 再改;强制覆盖→已写入,继续;回退→已回退到历史快照,基于回退值重写);未开启人工介入时返回 VERSION_CONFLICT 不写入,重新 read 拿最新值再改。`),a.push(`读类分流:取值/结构 → read(多路径用 jsonPaths);字段约束 → schema_data;条件筛选定位 → query_data(多条一次用 queries);名字模糊找 → search_data;整体说明 → read 不传路径。`),a.push(`修改大对象/数组优先用 write 增量改({patch:{op,jsonPath,value}} 只发改动部分),避免 write({value}) 整体重传被 max_tokens 截断导致 JSON 不完整、校验失败。`),a.push(`修改主数据出错时可用 restore_data 回退最近一次。`),a.push(`在大数组里按条件筛选元素用 query_data(JSONPath,如 $.components[?(@.type=="card" && @.price<100)]),返回匹配元素的 path/index;定位后再 write({patch}) 改。`),a.push(`找名字记不清的元素用 search_data(支持 substring/regex/fuzzy 模糊搜索)。`),a.push(`需要过滤/映射/聚合/批量重写大数组时用 eval_script(沙箱脚本,入参 data);只读探查用 mode=query,批量重写用 mode=transform(返回值经校验后落地)。`),a.push(`读大数组用 read({jsonPath,offset,limit}) 分页(返回 hasMore=true 时 offset+=limit 续读);一次读多个不相关子路径用 read({jsonPaths});复杂改动先 write({...,dryRun:true}) 预检不落盘。`),a.push(`【省轮次·批量】≥2 个路径一律 read({jsonPaths:[...]}) 一次取回(路径互不相关也合批,禁止连续单路径 read);多条件筛选用 query_data({queries:[expr1,expr2,…]}) 一次取回(2-10 条);改多处用 write({patches:[{op:"set",jsonPath,value},...]}) 一次提交多改动(原子任一失败回滚),勿逐个 write 烧轮次预算。`),a.push(`读到 <subtree Nkb keys:[…] #指纹> 或 <code Nkb> 占位 = 该子树键名/体积可见但内容未见:写入前先窄读全文(read({jsonPath:"该子树路径"}),结果根豁免返全文)或 set_focus 聚焦该区域;勿凭键名印象猜路径/猜值直写(直接写占位子树会被拦下要求先窄读)。`),a.push(`对比当前与历史快照(或一段 JSON against)的差异用 diff_data({snapshotId?,against?})(返回结构化 path→from/to,verify 自纠/操作审计/"刚才改了啥");只读查历史快照值用 history_data({id?,jsonPath?})。`)),r.subagent&&a.push(`独立子任务可 spawn_agent 委派(过程隔离,不占主上下文):默认只读,需要子 agent 写数据时传 writablePaths(路径前缀白名单,越界 PATH_OUT_OF_SCOPE)。多个独立子任务可 spawn_agents 并行委派(各子互不通信,结论由你汇总;并行委派不可授写权限,写操作由你收尾执行)。`),r.inspectEnv&&a.push(`排查页面环境(当前 URL/浏览器/视口/集成方调试变量)用 inspect_env——不传参返回环境摘要(location/navigator/viewport/document),传 key 读特定 window 属性(如 inspect_env({key:"appConfig"}) 读 window.appConfig)。改完数据看渲染、定位"为何没生效"时用它(只读,不改数据)。`),r.domInspect){let n=t&&e?.hasActions?`配合宿主 actions(save_draft/publish 等)形成"改数据→截图/get_dom 看渲染→触发动作"闭环。`:t?`改完数据可用截图/get_dom 查看渲染效果(本集成未注册宿主动作)。`:``,r=e?.skills?`长文按关键词定位(找某术语/某节在哪)先 load_skill("dom-inspect") 取得 dom_search 文本检索,命中后窄读那一节 —— 勿整页翻页找。`:``;a.push(`回答用户关于当前页面/文档的问题时优先用 read_page({selector?,offset?,limit?}) 读页面正文纯文本(长文按 hasMore 分页续读;自动排除本对话框自身);需要页面结构(检查渲染是否生效/定位元素/辅助 UI 设计问答)再用 get_dom({selector?,depth?}) 读渲染后 DOM(结构化返回 tag/attrs/text/children,depth 控制深度防爆炸,只读)。${n}${r}`)}if(e?.screenshot&&a.push(`视觉验证(看布局/样式/渲染效果像不像、对不对)用 take_screenshot({selector?, fullPage?}) 截图查看:selector 截指定元素、fullPage 截整页、默认当前视口;截图自动压缩投递(多模态直看图/纯文本模型走识图转述)。优先级:视觉问题先截图,结构/属性问题用 dom_info。`),e?.domEdit&&a.push(`修改宿主页面元素(高亮/改文案/调样式/插删移元素)用 dom_edit({patches:[{op,selector,...}],dryRun?}) 批量原子操作(op:set_text/set_html/set_attr/add_class/remove_class/set_style/insert/remove/move/highlight);selector 必须唯一命中(先 get_dom/dom_search 定位);改前自动快照,dom_restore 回滚最近一批;改动为会话临时态(刷新即失)——数据驱动页面改数据(write)不要改 DOM。`),e?.viewImage&&a.push(`看「页面数据里的某张图」(轮播第 N 帧/商品图/封面,read 结果里有其 URL)用 view_image({url}) 原图直投 —— 问特定帧时勿截当前渲染帧(自动轮播可能已切帧);要看渲染后的组件(布局/叠加文案)才用 take_screenshot。`),e?.hasProposals&&a.push(`【内容修改(提案制)】修改当前内容(文章/笔记/文档)只有一条通道:①先 read_content 取真实原文与 hash;②propose_content 带 baseHash 提案 —— 优先 ops 增量操作(replace/insertAfter/insertBefore/append,find/anchor 用原文字面片段且须唯一命中,多带上下文保唯一),勿全量重发整篇(token 只花在改动上);③提案仅送达:评审面板打开、用户点「应用」才会写回 —— 提案后如实告知用户待确认,勿声称已修改;用户裁决结果会在下一轮告知你,以裁决为准作答。`),r.draftWrite&&(a.push(`生成超大 JSON(如 50+ 组件页面,单次 write 受 max_tokens 限制装不下)用 draft_write 分块构建 → draft_commit 原子提交:draft_write({draftId, chunk, mode}) mode:"start" 新建/"append" 追加(拼 JSON 片段到 drafts 池);累积完 draft_commit({draftId}) 合并 + schema 校验 + 写主数据(失败草稿保留可修后重试,成功自动清草稿)。小改仍用 write patch,只在大 JSON 从零生成时用 draft。`),a.push(`⚠️ 大 JSON 分块构建是典型多轮工具调用(draft_write×N + draft_commit + read 确认 + 调研 read/query),默认 maxToolRounds=30(3.43 起;轮次预算吃紧时 system 会注入预算提示段,按提示优先收口);目标组件数很大时集成方仍可在 createChatSdk 显式上调 maxToolRounds(按 N+10 估算)。draft_commit 提交同样走乐观锁(改前 read 拿 hash,bind 被改过会触发冲突介入,不静默覆盖)。`)),r.focus&&t&&(a.push(`【上下文聚焦】判断任务范围,用 set_focus/add_focus/remove_focus/clear_focus 自动收敛工作范围:`),a.push(`  · 局部任务(只改某一组件/区域,如「调导航栏」「改 components.3 样式」)→ 先 read 定位 jsonPath,再 set_focus({path:"该子树路径"}) 聚焦;聚焦后每轮只看该子树结构,写其他位置会被 PATH_DENIED 拒绝。`),a.push(`  · 多个相关组件(如「同时改导航栏和页脚」)→ set_focus 聚焦首个后用 add_focus({path}) 追加其余;聚焦后可写任一焦点子树,越界仍被拒;移除单个用 remove_focus({path})。`),a.push(`  · 全局任务(多处/整体结构,如「重排所有组件」「换主题」)→ 不要聚焦,保持全量视野直接写。`),a.push(`  · 完成局部精修、要转向其他区域或做整体改动 → 调 clear_focus 退出聚焦(清空全部焦点),恢复全部读写权限。`),a.push(`  · set_focus/add_focus 的 path 必须在 schema 内(类型校验);不确定路径先 read 查。`)),e?.subagents?.length){let t=e.subagents.filter(e=>(e.temperature??0)>=l3||/规划|创意|设计|方案|brainstorm|plan/i.test(e.description)),n=e.subagents.filter(e=>(e.temperature??0)<l3&&/反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));a.push(`【规划-反思-执行·路由】按任务性质选模式,不要对简单任务过度编排:`),t.length&&(a.push(`  · 创作/设计/开放性需求(如"设计主题风格""换个感觉")→ 先调 ${t.map(e=>`use_`+e.id).join(`/`)} 出 2-3 套方案(高温创意),`),a.push(e?.humanConfirm?`    不要自己拍板;拿到方案后,若需用户拍板用 request_human_confirmation 弹选项。`:`    不要自己拍板;拿到方案后以文字列出选项等用户回复(humanConfirm 未开,勿调不存在工具)。`)),n.length&&a.push(`  · 严谨/易错/校验类 → 可先调 ${n.map(e=>`use_`+e.id).join(`/`)} 反思挑刺(低温审查),据反馈修订。`),a.push(`  · 方案定稿后,由你(主 agent)用 write 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。`),a.push(`  · 简单/明确任务(如"标题改红色")直接执行,不必走规划-反思。`)}e?.humanConfirm&&(a.push(`【人工确认·必读】以下情形必须先调 request_human_confirmation 征询用户、拿到答复后再继续,不要自行拍板:`),a.push(`  1) 用户让你「给方案/列选项/我来选/挑一个」时:把每个方案作为一个 option,调 request_human_confirmation(question=简述, options=[方案A,方案B,...], recommendation=你推荐的)。不要只回文字罗列方案让用户自己回复——要用工具把选项做成可点选按钮。`),a.push(`  2) 需求有歧义/不确定时:调工具问清楚(options 不传则用户答同意或拒绝)。`),a.push(`  3) 即将执行高风险不可逆操作(删除/覆盖/批量改动)前:调工具确认。`),a.push(`  4) 规划出多步方案需用户确认时:把整个方案(或关键分步)作为 option 调 request_human_confirmation,确认后再执行。`),a.push(`用户在选项里选了哪个,就按那个方案继续;选「拒绝」则停止并询问如何调整。`));let o=i?.loopProgress;if(o){let e=Ige(o.invokeUsage.prompt_tokens||o.invokeUsage.total_tokens,n?.promptSoftCap??1/0);e&&a.push(e);let t=Object.entries(o.writeFailures).filter(([,e])=>e>=2);if(t.length){let e=t.map(([e,t])=>`${e||`(整体)`}×${t}`).join(`、`);a.push(`⚠️ 以下路径已连续写失败:${e}。连续失败常意味着方向错了——先 read 重新核对实际值/类型,或 restore_data 回退后再改;若确需继续,换思路而非原样重试。`)}}return a.length&&a.unshift(`调用工具务必用标准 function calling(工具调用)格式发起,不要在回复正文里输出伪 XML/标签(如 deepseek 的 tool_calls 标签、invoke、function_call、tool_call 等)或 JSON 文本——那不会被识别为工具调用,会被当普通文字,工具不执行。`),a.length?`## 能力使用提示
 `+a.join(`
 `):void 0}}}function Lge(e,t){let n=[`[当前页面] 用户正在浏览:`,`- 标题:${e.title}`,`- URL:${e.url}`,`用户问题通常针对此页面内容。`];return t&&n.push(`需要页面正文时用 read_page 读取纯文本(长文按 hasMore 分页续读);读结构用 get_dom。`),n.join(`
 `)}function Rge(e){return{name:`pageContext`,augmentPrompt:()=>{let t=e.getPageInfo();if(t)return Lge(t,e.canReadPage)}}}function zge(e){return{name:`resourcesPin`,augmentPrompt:()=>{let t=e.getResourcesSnapshot();if(!t.length)return;let n=[`## 受保护资源(跨压缩保留 · 精确值保护)`];for(let e of t)e.mode===`freeze`?n.push(`- ${e.path} (freeze 已冻结,不可改)`):n.push(`- ${e.path} (verbatim 原样保留)${e.handle?` ⟦res:${e.handle}⟧`:``}`);return n.push(`读到 ⟦frozen:path⟧/⟦res:handle⟧ 占位符 = 精确值在冻结区/资源池(不入消息流);需真值用 resource_get({path});freeze 字段不可写(撞 FROZEN_FIELD 即放弃);verbatim 直接写新值会 VERBATIM_MISMATCH,先 resource_update 再写回句柄;撞 RESOURCE_EVICTED/RESOURCE_NOT_FOUND 重新 read 懒注册。`),n.join(`
@@ -3156,7 +3156,7 @@ ${`- 输出形态:完整、自包含的 HTML 页面(.${r},可独立成页)`}
 
 `+LG.htmlDirectWriteFallback,console.warn(`[page-agent-sdk] 检测到 schema 含 code 字段但未注册 html 子 agent:已自动注入「主 agent 自己写 HTML」编排(code 作普通字段直接 write,无 vfs 工作副本 / 无格式校验门禁)。如需代码资产机制(vfs + 格式校验 + 增量 commit + 主上下文 code 摘要),注册 createHtmlSubagent;若确为降级意图可忽略。`));let _e=pe&&te?O0(te,{onAudit:e.onAudit??(e.debug?e=>console.log(`[page-agent-sdk][data audit]`,e):void 0),maxSnapshots:e.maxSnapshots,onConflict:i.set,conflictWatchFields:e.conflictWatchFields,maxParallelTools:e.maxParallelTools,vfsStore:me||te?.resources?.length?v:void 0,...se.length?{pgIdPaths:se}:{},...ce.length?{largeTextPaths:ce}:{}}):[],ve=pe?_e:[],ye=pe&&te?_e.controller??null:null,I=pe&&te?_e.previewWrite:void 0,be=pe&&te?.resources?.length&&ye?.getResourcesSnapshot?zge({getResourcesSnapshot:()=>ye?.getResourcesSnapshot?.()??[]}):void 0,xe=()=>ye?.get()??te,Se=new Set(_e.map(e=>e.name)),Ce=e.conflictWatchFields??[],we=!Ce.includes(`*`)&&Ce.length?new Set(Ce):void 0,Te=ye?gme({getBind:()=>xe()?.bind,recomputeAll:()=>ye.recomputeAllBaselines?.(),hasBaselines:()=>ye.hasBaselines?.()??!1,isManaged:e=>Se.has(e),hash:e=>we?lK($q(e),we):cK($q(e)),log:(e,t)=>{let n=L.agent?.debugLogs;n&&(n.value.push({timestamp:Date.now(),type:`middleware`,data:{stage:`baseline_guard`,...t}}),yR(n))}}):void 0,Ee=new Map;P.domInspect&&!ge&&console.warn(`[page-agent-sdk][take_screenshot] domInspect 已开启但主模型不支持图片(vision=false)且未配 images.describe,截图工具未装载(视觉验证退回 get_dom/dom_info 结构推断;换多模态模型 / llm.vision:true / 配 images.describe 后重建 SDK 生效)`);let De=[],Oe=e=>{if(e.type===`tool_result`&&e.name===`take_screenshot`){let t=De.find(e=>!e.eventConsumed);if(t)return t.eventConsumed=!0,Object.assign(e,{image:{dataUri:t.image.dataUri,vfsRef:t.meta.vfsRef}})}return e},ke=d.vision===!0||typeof e.images?.describe==`function`?nge({getVision:()=>d.vision===!0,describe:e.images?.describe,onShot:(e,t)=>{De.push({image:e,meta:t})}}):void 0,Ae=ge?ege({render:e.screenshot?.renderer,getActiveFocus:()=>L.getFocus(),focusSelector:e.screenshot?.focusSelector,stow:e=>{if(e.dataUri)try{let t=`userImages/${e.id}`;return v.files[t]={content:e.dataUri,updatedAt:Date.now()},t}catch{return}},getVision:()=>d.vision===!0,describe:e.images?.describe,onShot:(e,t)=>{De.push({image:e,meta:t})}}):void 0,je=!g2(e.llm)&&(e.llm.provider??`openai`)===`anthropic`?`anthropic`:`openai`,Me=Ae||ke?{name:`screenshotChannel`,wrapModelCall:async(e,t)=>{if(De.length){let t=De.splice(0),n=rH(t.map((e,t)=>e.meta.mode===`url`?`[图片 ${t+1}] 原图直投 ${e.image.url??``}(view_image,全分辨率非渲染态)`:`[截图 ${t+1}] ${e.meta.mode}${e.meta.selector?` selector="${e.meta.selector}"`:``}${e.meta.vfsRef?`(原图 vfs:${e.meta.vfsRef})`:``}`).join(`
 `)+`
-(视觉内容如上,请结合图片回答/继续)`,t.map(e=>({dataUri:e.image.dataUri,url:e.image.url})),je);n&&e.messages.push(new Lx({content:n}))}return t(e)}}:null,Ne=!1,Pe=P.domEdit?uge({onEdit:e=>{L.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`dom_edit`,ops:e.ops.join(`,`),applied:e.applied,dryRun:e.dryRun}}),!e.dryRun&&e.applied>0&&(Ne=!0)},onRestore:e=>{e.restored>0&&(Ne=!0)}}):[],Fe=[...c3(P,ve,F4,P.domInspect?[...H4,...Pe,...Ae?[Ae]:[],...P.skills?[]:[Z4,Q4]]:[],i3),...ke?[ke]:[]];ke&&Ee.set(`view_image`,`builtin`),Fe.forEach(e=>Ee.set(e.name,`builtin`));let Ie=e.proposals?_ge(e.proposals,{emit:e=>{try{Jt(e)}catch{}},log:(e,t)=>{L.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`proposal`,kind:e,...t}})}}):null,Le=[...e.tools||[],...Ie?.tools??[]];Le.forEach(e=>Ee.set(e.name,`user`));let Re=o3(e.actions??{});Re.forEach(e=>Ee.set(e.name,`action`));let ze=Ie?e.proposals?.readToolName||`read_content`:null,Be=Ie?e.proposals?.toolName||`propose_content`:null,Ve=new Set([...Object.entries(e.actions??{}).filter(([,e])=>e?.readsHostState===!0).map(([e])=>e),...ze?[ze]:[]]),He=new Set([...Object.entries(e.actions??{}).filter(([,e])=>e?.deferredWrite===!0).map(([e])=>e),...Be?[Be]:[]]),Ue=[],We=!1,Ge=e.humanConfirm!==!1&&(!e.approval||e.approval.humanConfirmTool!==!1),Ke=Ge?Zq():null;Ke&&Ee.set(Yq,`builtin`);let qe=ue&&de?[IF(async()=>{let e=de.list();return e.length?de.restore()?`已回退到最近一次正常状态(checkpoint #${e[e.length-1].id})。对话历史、主数据、vfs、todos 已整体还原。请基于回退后的状态重新判断并继续。`:`回退失败:无可用 checkpoint。`:`无可用 checkpoint,无法回退。`},{name:`restore_last_checkpoint`,description:`回退到最近一次正常状态(整体还原对话历史 + 主数据 + vfs + todos)。当本轮操作出错、页面被改坏、或走偏时调用,回到本轮起点重新来过。不传参数即回退最近一次。`,schema:B({}).optional()}),IF(async()=>{let e=de.list();return e.length?`可用 checkpoint:
+(视觉内容如上,请结合图片回答/继续)`,t.map(e=>({dataUri:e.image.dataUri,url:e.image.url})),je);n&&e.messages.push(new Lx({content:n}))}return t(e)}}:null,Ne=!1,Pe=P.domEdit?uge({onEdit:e=>{L.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`dom_edit`,ops:e.ops.join(`,`),applied:e.applied,dryRun:e.dryRun}}),!e.dryRun&&e.applied>0&&(Ne=!0)},onRestore:e=>{e.restored>0&&(Ne=!0)}}):[],Fe=[...c3(P,ve,F4,P.domInspect?[...H4,...Pe,...Ae?[Ae]:[],...P.skills?[]:[Z4,Q4]]:[],i3),...ke?[ke]:[]];ke&&Ee.set(`view_image`,`builtin`),Fe.forEach(e=>Ee.set(e.name,`builtin`));let Ie=e.proposals?_ge(e.proposals,{emit:e=>{try{Jt(e)}catch{}},log:(e,t)=>{L.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`proposal`,kind:e,...t}})}}):null,Le=[...e.tools||[],...Ie?.tools??[]];Le.forEach(e=>Ee.set(e.name,`user`));let Re=o3(e.actions??{},{onError:({name:e,message:t})=>{L.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`action_failed`,name:e,message:t.slice(0,300)}})}});Re.forEach(e=>Ee.set(e.name,`action`));let ze=Ie?e.proposals?.readToolName||`read_content`:null,Be=Ie?e.proposals?.toolName||`propose_content`:null,Ve=new Set([...Object.entries(e.actions??{}).filter(([,e])=>e?.readsHostState===!0).map(([e])=>e),...ze?[ze]:[]]),He=new Set([...Object.entries(e.actions??{}).filter(([,e])=>e?.deferredWrite===!0).map(([e])=>e),...Be?[Be]:[]]),Ue=[],We=!1,Ge=e.humanConfirm!==!1&&(!e.approval||e.approval.humanConfirmTool!==!1),Ke=Ge?Zq():null;Ke&&Ee.set(Yq,`builtin`);let qe=ue&&de?[IF(async()=>{let e=de.list();return e.length?de.restore()?`已回退到最近一次正常状态(checkpoint #${e[e.length-1].id})。对话历史、主数据、vfs、todos 已整体还原。请基于回退后的状态重新判断并继续。`:`回退失败:无可用 checkpoint。`:`无可用 checkpoint,无法回退。`},{name:`restore_last_checkpoint`,description:`回退到最近一次正常状态(整体还原对话历史 + 主数据 + vfs + todos)。当本轮操作出错、页面被改坏、或走偏时调用,回到本轮起点重新来过。不传参数即回退最近一次。`,schema:B({}).optional()}),IF(async()=>{let e=de.list();return e.length?`可用 checkpoint:
 `+e.map(e=>`#${e.id} [${e.label??`auto`}] 消息数=${e.messageCount} 时间=${new Date(e.timestamp).toLocaleTimeString()}`).join(`
 `):`无可用 checkpoint。`},{name:`list_checkpoints`,description:`列出可用会话 checkpoint(回退点)。`,schema:B({}).optional()})]:[];qe.forEach(e=>Ee.set(e.name,`builtin`));let Je=P.focus&&pe,Ye=IF(async({path:e,label:t})=>{let n=xe()?.schema;return n?oG(n,e)?(O.setFocus(k({path:e,...t?{label:t}:{}}),`agent`),`已聚焦到 ${e}${t?`(${t})`:``}。后续仅可写该子树(越界被拒),每轮只看到该组件结构。完成精修后调 clear_focus 退出。`):`PATH_DENIED · 聚焦失败:path "${e}" 不在 schema 内。请先用 read 查看可操作路径再聚焦。`:`聚焦失败:当前无主数据 schema,无法聚焦。`},{name:`set_focus`,description:`聚焦到指定组件子树(如 components.3)精修,替换全部已有焦点(非累积;要保留已有焦点追加用 add_focus)。聚焦后:仅可写该子树(越界 PATH_DENIED)+ 每轮只看到该组件结构。多组件页面精修其中一个时用,避免改到别处。先 read 定位 path 再聚焦;完成调 clear_focus。`,schema:B({path:R().describe(`要聚焦的组件 jsonPath,如 components.3`),label:R().optional().describe(`人类可读标签,如「导航栏」`)})}),Xe=IF(async()=>(O.clearFocus(`agent`),`已清除聚焦,恢复全量可操作范围(可读写所有组件)。`),{name:`clear_focus`,description:`清除当前聚焦,退出精修模式,恢复对全部组件的读写权限。`,schema:B({}).optional()}),Ze=IF(async({path:e,label:t})=>{let n=xe()?.schema;if(!n)return`聚焦失败:当前无主数据 schema,无法聚焦。`;if(!oG(n,e))return`PATH_DENIED · 聚焦失败:path "${e}" 不在 schema 内。请先用 read 查看可操作路径再聚焦。`;O.addFocus(k({path:e,...t?{label:t}:{}}),`agent`);let r=O.getFocuses();return`已聚焦 ${e}${t?`(${t})`:``}(当前共 ${r.length} 个焦点:${r.map(e=>e.path).join(`, `)})。后续仅可写这些子树之一(越界被拒)。`},{name:`add_focus`,description:`追加聚焦一个组件子树(multi-focus,可同时聚焦多个相关组件)。校验 path 在 schema 内。聚焦后仅可写已聚焦的子树之一(越界 PATH_DENIED)。与 set_focus(替换全部)不同:本工具累积追加,不清除已有焦点。`,schema:B({path:R().describe(`要追加聚焦的组件 jsonPath,如 components.3`),label:R().optional().describe(`人类可读标签`)})}),Qe=IF(async({path:e})=>{let t=O.getFocuses().length;O.removeFocus(e,`agent`);let n=O.getFocuses();return n.length===t?`path "${e}" 不在当前焦点列表中(当前:${n.map(e=>e.path).join(`, `)||`无`})。`:n.length?`已移除焦点 ${e}(剩余 ${n.length} 个:${n.map(e=>e.path).join(`, `)})。`:`已移除焦点 ${e},聚焦已清空,恢复全量操作范围。`},{name:`remove_focus`,description:`移除单个聚焦焦点(by path),保留其他焦点。移除最后一个等价退出精修。全部退出用 clear_focus。`,schema:B({path:R().describe(`要移除的焦点 jsonPath`)})}),$e=Je?[Ye,Xe,Ze,Qe]:[];$e.forEach(e=>Ee.set(e.name,`builtin`));let et=[],tt=new Map,nt=the({builtinTools:()=>Fe,userTools:()=>Le,actionTools:()=>Re,humanConfirmTool:()=>Ke,checkpointTools:()=>qe,focusTools:()=>$e,mcpTools:()=>Ue,loadedSkillTools:()=>et}),rt=nt(),it=P.planning,at=P.missionAnchor,ot=P.workingMemory,st=P.skills,ct=P.vfs||oe;if(ct)for(let e of Hpe)Ee.set(e,`builtin`);if(it)for(let e of y.tools??[])Ee.set(e.name,`builtin`);let lt=P.summarization,ut=P.agentCompression&&!!u;e.debug&&P.agentCompression&&!u&&console.warn(`[page-agent-sdk][agentCompression] agentCompression 开启但 summaryLlm 不可用(或缺 apiKey / 模型不支持工具),压缩决策不启用,回退静态压缩`);let dt=P.memory,ft=P.subagent,pt=ft?fq():void 0,mt=e.verify?.maxAttempts??2,ht=!!(e.verify?.check||e.verify?.maxAttempts||e.verify?.adversarial),gt=e.capabilities?.verify===!1,_t=(P.verify||ht&&!gt)&&e.verify?.enabled!==!1&&mt>0,vt=P.contextInspector;ht&&!_t&&e.verify?.enabled!==!1&&console.warn(`[page-agent-sdk][verify] 检测到 verify 配置(check/maxAttempts/adversarial)但未装载(capabilities.verify:false 显式关闭 或 maxAttempts≤0)`);let yt=e.subagent,bt=yt?.allowedTools??[],xt=e.permissions?.length?qq(e.permissions):void 0,St=e.approval?.preview===!0&&I?(e,t)=>e===`write`?I(t):null:void 0,Ct=e.approval?.previewWrite||St?(t,n)=>e.approval?.previewWrite?.(t,n)??St?.(t,n)??null:void 0,wt=new Set,Tt=e.approval&&(e.approval.tools!==void 0||e.approval.confirm||e.approval.remember===!0)?Jq({...e.approval,remember:e.approval.remember===!0,grants:wt,timeoutMs:e.approval.timeoutMs??T,onAutoReject:E,previewWrite:Ct}):void 0,Et=[...xt?[xt]:[],...Tt?[Tt]:[],...Te?[Te]:[]],Dt=!ft||yt?.enabled===!1?void 0:Mq({llm:yt?.llm??e.llm,allTools:()=>L.agent?.allTools??rt,allowedTools:bt.length?bt:void 0,...e.staleReadInvalidation===void 0?{}:{staleReadInvalidation:e.staleReadInvalidation},systemPrompt:yt?.systemPrompt,temperature:yt?.temperature,maxTokens:yt?.maxTokens,skills:yt?.skills,maxDepth:yt?.maxDepth,maxParallel:yt?.maxParallel,thinkingMode:yt?.thinkingMode,debug:e.debug,getFocuses:()=>O.getActiveFocuses(),getSchema:()=>xe()?.schema??null,tracker:pt,guardMiddleware:Et.length?Et:void 0,getVfsFiles:ct?()=>v.files:void 0,enterDataScope:ye?.enterScope?e=>ye.enterScope(e):void 0,exitDataScope:ye?.exitScope?e=>ye.exitScope(e):void 0,onUsage:e=>{r.prompt_tokens=(r.prompt_tokens??0)+(e.prompt_tokens??0),r.completion_tokens=(r.completion_tokens??0)+(e.completion_tokens??0),r.total_tokens=(r.total_tokens??0)+(e.total_tokens??0),e.reasoning_tokens&&(r.reasoning_tokens=(r.reasoning_tokens??0)+e.reasoning_tokens)},timeoutMs:yt?.timeoutMs}),Ot=ae?.map(e=>{if(!e._codeAsset)return e;let t=e._codeAsset,n=ame({writablePaths:t.writablePaths,codeVfsPrefix:t.codeVfsPrefix,ext:t.ext,codeField:t.codeField,craftNotes:t.craftNotes,onWarning:e=>console.warn(`[page-agent-sdk][code-asset] ${e}`),getController:()=>ye,vfsStore:v}),r=[...e.middleware??[],n];for(let e of r)e&&AW(e)&&e._setGetController(()=>ye);return{...e,middleware:r}}),kt=oe&&ft?ome():void 0,At=kt?dme({getBind:()=>xe()?.bind,writablePaths:se,getLocked:()=>kt.locked(),tools:rt,getCodeFieldPaths:()=>lme(xe()?.bind,ie.map(e=>({writablePaths:e._codeAsset.writablePaths,codeField:e._codeAsset.codeField})))}):void 0,jt=ye?.getSummarizedPaths&&ye.clearSummarizedPaths?pme({getSummarizedPaths:()=>ye.getSummarizedPaths(),clearSummarizedPaths:()=>ye.clearSummarizedPaths()}):void 0,Mt=ft&&Ot!==void 0?Fq(Ot,{llm:e.llm,thinkingModeDefault:e.subagent?.thinkingMode,staleReadInvalidation:e.staleReadInvalidation,allTools:()=>L.agent?.allTools??rt,debug:e.debug,getFocuses:()=>O.getActiveFocuses(),getSchema:()=>xe()?.schema??null,getBind:()=>xe()?.bind,tracker:pt,guardMiddleware:Et.length?Et:void 0,getVfsFiles:ct?()=>v.files:void 0,enterDataScope:ye?.enterScope?e=>ye.enterScope(e):void 0,exitDataScope:ye?.exitScope?e=>ye.exitScope(e):void 0,onUsage:e=>{r.prompt_tokens=(r.prompt_tokens??0)+(e.prompt_tokens??0),r.completion_tokens=(r.completion_tokens??0)+(e.completion_tokens??0),r.total_tokens=(r.total_tokens??0)+(e.total_tokens??0),e.reasoning_tokens&&(r.reasoning_tokens=(r.reasoning_tokens??0)+e.reasoning_tokens)},timeoutMs:e.subagent?.timeoutMs,...kt?{componentLock:kt,resolveComponents:e=>sme(e,rme(xe()?.bind,se))}:{}}):void 0,Nt=Mt?Mt.controller:null,Pt=t=>{let n=t.thinkingMode??e.subagent?.thinkingMode,r=n?g2(t.llm??e.llm)?`instance-noop`:`applied`:`inherited`;return{...t,...n?{thinkingMode:n}:{},thinkingApplied:r}},Ft=[`read`,`fetch_document`],It=rt.filter(e=>Ft.includes(e.name)),Lt=_t?lJ({check:e.verify.check??hJ({schemas:()=>xe()?{"":xe().schema}:{},root:()=>xe()?.bind}),adversarial:e.verify?.adversarial?{llm:e.llm,tools:It}:void 0}):void 0,Rt=vt?kJ({contextWindow:d.contextWindow,thresholdRatio:G2(e,d.contextWindow).summaryThresholdRatio}):void 0,zt=d3({...P,humanConfirm:Ge,screenshot:!!Ae,domEdit:P.domEdit,hasActions:!!e.actions&&Object.keys(e.actions).length>0,hasProposals:!!e.proposals,viewImage:!!ke,subagents:ae?.map(Pt)},pe&&!!te,{promptSoftCap:sq(d.contextWindow,f.promptSoftCapTokens)}),Bt=P.pageContext?Rge({getPageInfo:()=>typeof document<`u`&&typeof location<`u`?{title:document.title||``,url:location.href}:null,canReadPage:P.domInspect===!0}):void 0,Vt={epoch:0,notices:[],readsInvalidated:0},Ht=0,Ut={name:`hostNotice`,beforeAgent:()=>{Ht=Vt.epoch},wrapModelCall:async(e,t)=>{if(Ne){Ne=!1;let t=SU(e.messages,`agent 已通过 dom_edit 修改页面,此前读取为改前状态`,Ve);if(t.invalidatedCount>0){for(let n=0;n<t.messages.length;n++)e.messages[n]=t.messages[n];L.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`dom_edit_read_invalidated`,count:t.invalidatedCount}})}}if(Vt.epoch>Ht){Ht=Vt.epoch;let t=Vt.notices[Vt.notices.length-1]??``,n=SU(e.messages,t||void 0,Ve);if(n.invalidatedCount>0){for(let t=0;t<n.messages.length;t++)e.messages[t]=n.messages[t];Vt.readsInvalidated+=n.invalidatedCount,L.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`host_read_invalidated`,count:n.invalidatedCount,epoch:Vt.epoch,reason:t||void 0}})}}return t(e)},augmentPrompt:()=>Vt.notices.length?[`【宿主页面已变更】`,...Vt.notices.filter(Boolean).map(e=>`· ${e}`),P.domInspect===!0?`此前的页面读取/截图结果已过期,回答任何关于当前页面的问题前必须重新 read_page / get_dom 读取当前页面;不要凭此前的读取结果或记忆作答。`:`页面内容可能已变化,断言页面前先核实当前状态;不要凭此前的印象作答。`].join(`
 `):void 0,afterAgent:()=>{Vt.notices.length=0}},Wt=Ie?{name:`proposalNotice`,augmentPrompt:()=>Ie.state.notices.length?[`【内容提案裁决结果】(以此为准,不要凭提案前状态作答)`,...Ie.state.notices].join(`

package/dist/page-agent-sdk.js

@@ -17410,35 +17410,42 @@ function gC(e, t, n) {
 //#endregion
 //#region src/core/sdk/actions.ts
 var _C = /^[a-zA-Z][a-zA-Z0-9_]*$/;
-function vC(e) {
-	let n = [];
-	for (let [r, i] of Object.entries(e)) {
-		if (!_C.test(r)) {
-			console.warn(`[page-agent-sdk][actions] 动作名 "${r}" 非法(须匹配 ${_C}),已跳过`);
+function vC(e, n = {}) {
+	let r = [];
+	for (let [i, a] of Object.entries(e)) {
+		if (!_C.test(i)) {
+			console.warn(`[page-agent-sdk][actions] 动作名 "${i}" 非法(须匹配 ${_C}),已跳过`);
 			continue;
 		}
-		let e = i.description || `宿主动作 ${r}`;
-		n.push(s(async (e) => {
+		let e = a.description || `宿主动作 ${i}`;
+		r.push(s(async (e) => {
 			try {
-				let t = await i.run(e || {});
-				return t === void 0 ? `动作 ${r} 执行完成。` : typeof t == "string" ? t : JSON.stringify(t);
+				let t = await a.run(e || {});
+				return t === void 0 ? `动作 ${i} 执行完成。` : typeof t == "string" ? t : JSON.stringify(t);
 			} catch (e) {
 				let t = e?.message || String(e);
-				return `动作 ${r} 执行失败:${t}`;
+				return n.onError?.({
+					name: i,
+					message: t
+				}), Q({
+					code: "ACTION_FAILED",
+					message: `动作 ${i} 执行失败:${t}`,
+					hint: "检查参数与宿主状态后修正重试;连续失败时换思路或如实告知用户,不要原样重发相同调用。"
+				});
 			}
 		}, {
-			name: r,
+			name: i,
 			description: e,
-			schema: i.params ?? t.object({})
+			schema: a.params ?? a.schema ?? t.object({})
 		}));
 	}
-	return n;
+	return r;
 }
 function yC(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) _C.test(n) && (t[n] = {
 		description: r.description,
-		hasParams: !!r.params,
+		hasParams: !!(r.params || r.schema),
 		readsHostState: r.readsHostState === !0,
 		deferredWrite: r.deferredWrite === !0
 	});
@@ -17914,7 +17921,17 @@ function qC(e, n, r) {
 		}
 	}) : null, Ve = [...e.tools || [], ...Be?.tools ?? []];
 	Ve.forEach((e) => Ae.set(e.name, "user"));
-	let He = vC(e.actions ?? {});
+	let He = vC(e.actions ?? {}, { onError: ({ name: e, message: t }) => {
+		U.agent?.debugLogs?.value?.push({
+			timestamp: Date.now(),
+			type: "middleware",
+			data: {
+				stage: "action_failed",
+				name: e,
+				message: t.slice(0, 300)
+			}
+		});
+	} });
 	He.forEach((e) => Ae.set(e.name, "action"));
 	let Ue = Be ? e.proposals?.readToolName || "read_content" : null, We = Be ? e.proposals?.toolName || "propose_content" : null, Ge = /* @__PURE__ */ new Set([...Object.entries(e.actions ?? {}).filter(([, e]) => e?.readsHostState === !0).map(([e]) => e), ...Ue ? [Ue] : []]), Ke = /* @__PURE__ */ new Set([...Object.entries(e.actions ?? {}).filter(([, e]) => e?.deferredWrite === !0).map(([e]) => e), ...We ? [We] : []]), qe = [], Je = !1, Ye = e.humanConfirm !== !1 && (!e.approval || e.approval.humanConfirmTool !== !1), Xe = Ye ? vg() : null;
 	Xe && Ae.set(gg, "builtin");

package/dist/page-agent-sdk.legacy.js

@@ -75265,36 +75265,44 @@ function NFe(e, t, n) {
 }
 EP(), qd();
 var R8 = /^[a-zA-Z][a-zA-Z0-9_]*$/;
-function PFe(e) {
-	let t = [];
-	for (let [r, i] of Object.entries(e)) {
-		var n;
-		if (!R8.test(r)) {
-			console.warn(`[page-agent-sdk][actions] 动作名 "${r}" 非法(须匹配 ${R8}),已跳过`);
+function PFe(e, t = {}) {
+	let n = [];
+	for (let [a, o] of Object.entries(e)) {
+		var r, i;
+		if (!R8.test(a)) {
+			console.warn(`[page-agent-sdk][actions] 动作名 "${a}" 非法(须匹配 ${R8}),已跳过`);
 			continue;
 		}
-		let e = i.description || `宿主动作 ${r}`;
-		t.push(xP(async (e) => {
+		let e = o.description || `宿主动作 ${a}`;
+		n.push(xP(async (e) => {
 			try {
-				let t = await i.run(e || {});
-				return t === void 0 ? `动作 ${r} 执行完成。` : typeof t == "string" ? t : JSON.stringify(t);
+				let t = await o.run(e || {});
+				return t === void 0 ? `动作 ${a} 执行完成。` : typeof t == "string" ? t : JSON.stringify(t);
 			} catch (e) {
-				let t = (e == null ? void 0 : e.message) || String(e);
-				return `动作 ${r} 执行失败:${t}`;
+				var n;
+				let r = (e == null ? void 0 : e.message) || String(e);
+				return (n = t.onError) == null || n.call(t, {
+					name: a,
+					message: r
+				}), KY({
+					code: "ACTION_FAILED",
+					message: `动作 ${a} 执行失败:${r}`,
+					hint: "检查参数与宿主状态后修正重试;连续失败时换思路或如实告知用户,不要原样重发相同调用。"
+				});
 			}
 		}, {
-			name: r,
+			name: a,
 			description: e,
-			schema: (n = i.params) == null ? B({}) : n
+			schema: (r = (i = o.params) == null ? o.schema : i) == null ? B({}) : r
 		}));
 	}
-	return t;
+	return n;
 }
 function FFe(e) {
 	let t = {};
 	for (let [n, r] of Object.entries(e)) R8.test(n) && (t[n] = {
 		description: r.description,
-		hasParams: !!r.params,
+		hasParams: !!(r.params || r.schema),
 		readsHostState: r.readsHostState === !0,
 		deferredWrite: r.deferredWrite === !0
 	});
@@ -75831,7 +75839,18 @@ function sIe(e, t, n) {
 		}
 	}) : null, Bt = [...e.tools || [], ...(E = zt == null ? void 0 : zt.tools) == null ? [] : E];
 	Bt.forEach((e) => kt.set(e.name, "user"));
-	let Vt = PFe((D = e.actions) == null ? {} : D);
+	let Vt = PFe((D = e.actions) == null ? {} : D, { onError: ({ name: e, message: t }) => {
+		var n;
+		(n = R.agent) == null || (n = n.debugLogs) == null || (n = n.value) == null || n.push({
+			timestamp: Date.now(),
+			type: "middleware",
+			data: {
+				stage: "action_failed",
+				name: e,
+				message: t.slice(0, 300)
+			}
+		});
+	} });
 	Vt.forEach((e) => kt.set(e.name, "action"));
 	let Ht = zt ? ((O = e.proposals) == null ? void 0 : O.readToolName) || "read_content" : null, Ut = zt ? ((k = e.proposals) == null ? void 0 : k.toolName) || "propose_content" : null, Wt = /* @__PURE__ */ new Set([...Object.entries((A = e.actions) == null ? {} : A).filter(([, e]) => (e == null ? void 0 : e.readsHostState) === !0).map(([e]) => e), ...Ht ? [Ht] : []]), Gt = /* @__PURE__ */ new Set([...Object.entries((M = e.actions) == null ? {} : M).filter(([, e]) => (e == null ? void 0 : e.deferredWrite) === !0).map(([e]) => e), ...Ut ? [Ut] : []]), Kt = [], qt = !1, Jt = e.humanConfirm !== !1 && (!e.approval || e.approval.humanConfirmTool !== !1), Yt = Jt ? e$() : null;
 	Yt && kt.set($Q, "builtin");

package/dist/page-agent-sdk.umd.cjs

@@ -2988,7 +2988,7 @@ ${`- 输出形态:完整、自包含的 HTML 页面(.${r},可独立成页)`}
 
 `).trim()}function VS(e){try{return e.querySelector?.(RS)!=null||e.querySelector?.(`.chat-dialog, .chat-mask, .debug-drawer, .skill-mask, .skill-panel, .chat-selection-menu`)!=null}catch{return!0}}function HS(e,t){return t===`invalid`?`ERROR: selector 非法 "${e}"。不要手编复杂选择器 —— 先 dom_search 关键词定位,复用命中结果的 selector 原文。`:`未找到匹配元素:selector="${e}"(若不确定元素定位,先 dom_search 关键词取其 selector 再复用)`}var US=[FS,(0,i.tool)(({selector:e,offset:t,limit:n})=>{if(typeof document>`u`)return`ERROR: read_page 仅在浏览器环境可用(当前运行在 node/服务端,无 DOM)。请基于用户消息中的引用原文回答。`;let r,i;if(e){try{r=document.querySelector(e)}catch{return HS(e,`invalid`)}if(!r)return HS(e,`miss`);i=e}else r=zS(document),i=r?r.tagName.toLowerCase():`body`;let a=BS(r,hu,VS),o=t??0,s=n??4e3;if(o>a.length)return`offset=${o} 超出正文长度 ${a.length}(先从 offset=0 读,按 hasMore 续读)`;let c=a.slice(o,o+s);return JSON.stringify({text:c,totalChars:a.length,offset:o,limit:s,hasMore:o+c.length<a.length,container:i})},{name:`read_page`,description:`读当前页面正文纯文本(自动定位 article/main 等文章容器;排除 SDK 对话框自身与脚本样式)。回答「这个页面讲了什么/某段内容在哪」类问题用;长文按 hasMore=true 时 offset+=本次返回长度 续读。只读,大结果自动外存 vfs。`,schema:t.z.object({selector:t.z.string().optional().describe(`CSS 选择器(默认智能定位 article/main/[role=main]/.content,兜底 body)`),offset:t.z.number().int().min(0).optional().describe(`起始字符偏移(默认 0;续读传上次 offset + 返回 text 长度)`),limit:t.z.number().int().min(200).max(2e4).optional().describe(`本次返回字符上限(默认 4000,上限 20000)`)})})],WS=`display.position.visibility.opacity.color.background-color.background-image.font-size.font-weight.line-height.text-align.z-index.overflow.width.height.margin.padding.border.border-radius.box-shadow.transform.transition.animation.cursor.pointer-events.flex-direction.gap.max-width.min-height`.split(`.`),GS=new WeakMap,KS=!1;function qS(){if(KS)return;let e=globalThis.EventTarget;if(!e?.prototype?.addEventListener)return;KS=!0;let t=e.prototype.addEventListener,n=e.prototype.removeEventListener;e.prototype.addEventListener=function(e,...n){try{let t=GS.get(this);t||(t=new Map,GS.set(this,t)),t.set(String(e),(t.get(String(e))??0)+1)}catch{}return t.call(this,e,...n)},e.prototype.removeEventListener=function(e,...t){try{let t=GS.get(this);if(t){let n=(t.get(String(e))??1)-1;n<=0?t.delete(String(e)):t.set(String(e),n)}}catch{}return n.call(this,e,...t)}}function JS(e){return[...GS.get(e)?.entries()??[]].filter(([,e])=>e>0).map(([e])=>e)}function YS(e,t=12){let n=[],r=e,i=0;for(;r&&r.tagName&&i<t;){let e=r.tagName.toLowerCase(),t=r.id;if(t){n.unshift(`${e}#${t}`);break}if(typeof r.getAttribute==`function`){let t=(r.getAttribute(`class`)||``).split(/\s+/).filter(Boolean)[0];t&&/^[A-Za-z][\w-]*$/.test(t)&&(e+=`.${t}`)}let a=r.parentElement;if(a){let t=Array.from(a.children).filter(e=>e.tagName===r.tagName);t.length>1&&(e+=`:nth-of-type(${t.indexOf(r)+1})`)}n.unshift(e),r=a,i++}return n.join(` > `)}function XS(e,t,n={}){if(!e)return{hits:[],total:0,truncated:!1};let r=Math.max(1,Math.min(n.limit??10,20)),i=n.mode??`selector`,a=[];if(i===`selector`)try{a=Array.from(e.querySelectorAll(t))}catch{return{hits:[],total:0,truncated:!1}}else{a=Array.from(e.querySelectorAll(`*`)).filter(e=>{let n=e.tagName.toLowerCase();if(n===`script`||n===`style`||n===`noscript`)return!1;let r=(e.textContent||``).trim();return r.length>0&&r.includes(t)});let n=a.slice(0,100),r=new Set(n);a=n.filter(e=>{for(let t of r)if(t!==e&&e.contains(t))return!1;return!0})}a=a.filter(e=>!hu(e));let o=Math.min(a.length,r);return{hits:a.slice(0,o).map(e=>{let n=(typeof e.textContent==`string`&&e.textContent?e.textContent:Array.from(e.childNodes??[]).filter(e=>e.nodeType===3).map(e=>e.textContent||``).join(``)).replace(/\s+/g,` `).trim(),r=n.slice(0,120);if(i!==`selector`&&t){let e=n.indexOf(String(t));e>=0&&(r=(e>100?`…`:``)+n.slice(Math.max(0,e-100),e+120)+(e+120<n.length?`…`:``))}return{selector:YS(e),tag:e.tagName.toLowerCase(),text:r}}),total:a.length,truncated:a.length>o}}var ZS=[`content`,`display`,`width`,`height`,`background-color`,`position`];function QS(e,t={}){if(!e)return null;let n={selector:YS(e),tag:e.tagName.toLowerCase(),attrs:{}};for(let t of Array.from(e.attributes))!(jS.includes(t.name)||t.name.startsWith(`data-`))||MS.test(t.name)||NS.test(t.name)||(n.attrs[t.name]=t.value);let r=Array.from(e.childNodes).filter(e=>e.nodeType===3).map(e=>e.textContent||``).join(``).trim();r&&(n.text=r.slice(0,400));let i=String(e.innerText??e.textContent??``).trim();if(i&&(n.textAll=i.slice(0,1e3)),(t.includeRect??!0)&&typeof e.getBoundingClientRect==`function`){let t=e.getBoundingClientRect();n.rect={x:Math.round(t.x),y:Math.round(t.y),width:Math.round(t.width),height:Math.round(t.height)}}if(t.includeHtml){let r=Math.min(t.htmlLimit??1500,4e3),i=e.outerHTML??``;n.html=i.length>r?i.slice(0,r)+`…(截断 ${i.length-r} 字符)`:i}let a=t.getComputedStyle??globalThis.window?.getComputedStyle?.bind(globalThis.window),o=n=>{let r={};if(typeof a!=`function`)return r;try{let i=a(e,n??null);for(let e of n?ZS:t.styles??WS){let t=typeof i.getPropertyValue==`function`?i.getPropertyValue(e):i[e];t&&(r[e]=String(t).slice(0,200))}}catch{}return r};if((t.styles===void 0||t.styles.length>0)&&(n.styles=o()),t.pseudo&&(n.pseudoStyles={before:o(`::before`),after:o(`::after`)}),t.includeEvents!==!1){let t=Array.from(e.attributes).filter(e=>/^on\w+$/i.test(e.name)).map(e=>({type:e.name.toLowerCase().slice(2),snippet:e.value.slice(0,100)})),r=e.__vueParentComponent?.vnode?.props;n.events={inline:t,vue:r?Object.keys(r).filter(e=>/^on[A-Z]/.test(e)).map(e=>e.slice(2).toLowerCase()):[],captured:JS(e)}}return n}var $S=(0,i.tool)(({query:e,mode:t,limit:n,root:r})=>{qS();let i=r?document.querySelector(r):document;if(r&&!i)return`未找到 root 元素:selector="${r}"`;let a=XS(i,e,{mode:t,limit:n});return a.total?JSON.stringify({...a,note:a.truncated?`共 ${a.total} 处命中,仅返回前 ${a.hits.length} 处`:void 0},null,2):t===`text`?`未找到包含文本「${e}」的元素`:`selector "${e}" 未匹配到元素`},{name:`dom_search`,description:`搜索页面元素:CSS 选择器或可见文本两种模式,返回命中元素的 CSS 路径 + 文本片段(≤20 处)。定位元素/查渲染结果用;找到 selector 后可用 dom_info 看详情或 get_dom 看结构。`,schema:t.z.object({query:t.z.string().describe(`selector 模式 = CSS 选择器(如 ".banner .title");text 模式 = 文本关键词`),mode:t.z.enum([`selector`,`text`]).optional().describe(`搜索模式(默认 selector;text = 文本包含匹配)`),limit:t.z.number().int().min(1).max(20).optional().describe(`返回上限(默认 10)`),root:t.z.string().optional().describe(`限定搜索范围的容器选择器(默认整页)`)})}),eC=(0,i.tool)(({selector:e,styles:t,includeHtml:n,htmlLimit:r,includeEvents:i,includeRect:a,pseudo:o})=>{qS();let s=document.querySelector(e);if(!s)return`未找到匹配元素:selector="${e}"(可先用 dom_search 定位)`;if(hu(s))return`ERROR: 该 selector 命中 SDK 对话框自身(排障应读宿主页面元素)。`;let c=QS(s,{styles:t,includeHtml:n,htmlLimit:r,includeEvents:i,includeRect:a,pseudo:o});return c?JSON.stringify(c,null,2):`selector="${e}" 读取失败`},{name:`dom_info`,description:`读单个元素完整信息:内容(直接文本/全文本/HTML 片段)+ 计算样式(默认排障高频预设,可指定属性列表)+ 几何位置 + 事件绑定(inline on*/Vue props/addEventListener 记录;记录器仅覆盖 SDK 加载后注册的监听)。验证样式落地/排查交互绑定用。`,schema:t.z.object({selector:t.z.string().describe(`CSS 选择器(取首个匹配;可先用 dom_search 定位)`),styles:t.z.array(t.z.string()).optional().describe(`计算样式属性列表(不传 = 常用预设 ~30 项)`),includeHtml:t.z.boolean().optional().describe(`是否含 outerHTML 片段(默认 false,大 HTML 省 token)`),htmlLimit:t.z.number().int().min(100).max(4e3).optional().describe(`HTML 片段上限字符(默认 1500)`),includeEvents:t.z.boolean().optional().describe(`是否含事件绑定(默认 true)`),includeRect:t.z.boolean().optional().describe(`是否含几何位置(默认 true)`),pseudo:t.z.boolean().optional().describe(`是否含 ::before/::after 伪元素摘要(默认 false)`)})}),tC=`dom-inspect`;function nC(e={}){return{name:tC,description:`页面 DOM 深度检视工具(dom_search 搜索元素 / dom_info 读内容·计算样式·事件绑定·几何)。定位元素、验证样式落地、排查交互绑定时加载`,getContent:()=>[`# DOM 检视工具用法`,`## read_page({ selector?, offset?, limit? })—— 读正文首选`,`- 返回页面正文纯文本(JSON:text/totalChars/offset/hasMore/container),自动定位 article/main/[role=main]/.content 容器并排除本对话框自身与 script/style`,`- 长文分页:默认每次 4000 字符;hasMore=true 时下一次调用传 offset=上次 offset+本次 text 长度 续读`,`- 回答「这个页面讲了什么/某段在哪」类问题用 read_page,不要用 get_dom 逐层翻结构(爆 token)`,`## dom_search({ query, mode?, limit?, root? })`,`- mode="selector"(默认):query 为 CSS 选择器;mode="text":文本关键词包含匹配(跳过 script/style)`,`- 返回命中列表:CSS 路径(selector)+ 文本片段;超 limit 标注总数`,`## dom_info({ selector, styles?, includeHtml?, pseudo?, ... })`,`- selector 取首个匹配(先用 dom_search 定位更稳)`,`- styles 不传 = 排障高频预设(display/position/color/background/font/z-index/transform 等约 30 项);传数组 = 只取指定属性`,`- includeHtml: true 附 outerHTML 片段(默认省);pseudo: true 附 ::before/::after 摘要`,`- events 三源:inline on* 属性 / Vue vnode props(onXxx)/ addEventListener 记录器(⚠ 仅记录本 SDK 加载之后注册的监听,更早的挂载捕不到)`,`- rect:视口坐标 + 宽高(验证可见性/布局)`,...e.withScreenshot?[`## take_screenshot({ selector?, fullPage? })—— 视觉验证`,`- 截图「看」页面:selector 截指定元素区域 / fullPage 截整页 / 都不传截当前视口;截图经压缩投递(多模态直看图,纯文本模型自动走识图转述)`,`- 布局/样式/渲染效果类问题优先截图(视觉真值),结构/属性类用 dom_info;截图失败(CSP/跨域图)会回灌原因与替代建议`]:[],...e.withDomEdit?[`## dom_edit({ patches, dryRun? })—— 修改页面元素(宿主开启才有)`,`- patches 批量原子(任一失败整批拒绝):set_text/set_html(内容)、set_attr/remove_attr、add_class/remove_class、set_style、insert(新建元素 anchor+position: before/after/prepend/append/replace)、remove、move(层级调整)、highlight(高亮+滚动)`,`- 写纪律:selector 必须唯一命中(多匹配被拒,用 dom_search 拿精确路径);先读后写(get_dom/dom_info 看现状);拿不准先 dryRun 预检`,`- 改前自动快照:dom_restore 回滚最近一批(可连续回退);改动为会话临时态(刷新即失);数据驱动页面改数据(write)不要改 DOM`]:[],`## 排障套路`,...e.withScreenshot?[`1. dom_search(mode:"text", query:按钮文案) 定位 → 2. 视觉验证 take_screenshot / 结构验证 dom_info(styles) → 3. `+(e.withDataOps?`不符则改数据(write 修正后再验证)`:`不符则如实报告差异(页面为真值;本页面无数据写通道,调整预期或告知用户)`)]:[`1. dom_search(mode:"text", query:按钮文案) 定位 → 2. dom_info(styles:["display","background-color","pointer-events"]) 验证样式/点击性 → 3. `+(e.withDataOps?`不符则改数据(write 修正后再验证)`:`不符则如实报告差异(页面为真值;本页面无数据写通道,调整预期或告知用户)`)]].join(`
 `),tools:[()=>[$S,eC]]}}var rC=`page-analysis`;function iC(e={}){return{name:rC,description:`页面内容分析策略:按问题类型选工具(引用原文/整页理解/定位/结构/视觉/页面操作),含分页探索纪律与基于页面实料的回答纪律。回答用户关于当前页面的问题时加载`,getContent:()=>[`# 页面内容分析策略`,`## 第一步:问题分型(按类型选主力工具,不要一上来读整页)`,`- **引用原文类**(用户消息带引用块):优先围绕引用原文作答;需要上下文再向外探索(所在小节 → 整页)`,`- **整页理解类**(「这页讲了什么/总结要点」):read_page 读正文,长文按 hasMore 翻页,边读边归纳不要一次读爆`,`- **定位类**(「某概念在本页哪里/那个按钮在哪」):dom_search mode:"text" 按关键词定位 → 需要细节再 read_page 带 selector 读该区域`,`- **结构/属性类**(「这个区块是什么组件/有哪些属性」):dom_info(selector) 读单元素;层级关系用 get_dom`,...e.withScreenshot?[`- **视觉类**(「看起来对不对/布局乱不乱/渲染效果」):take_screenshot 截图看视觉真值;selector 截局部、fullPage 截整页;截图是唯一能看到实际渲染效果的手段,结构推断不能代替`]:[],...e.withDomEdit?[`- **操作类**(「把这段高亮/隐藏广告/调大字体/把这个块挪过去」):dom_edit patches 批量操作;纪律 = 先 get_dom/dom_search 定位唯一 selector → 拿不准先 dryRun → 改后 dom_info/截图验证 → 不满意 dom_restore 回滚;页面是临时态,持久修改要走宿主自己的机制`]:[],`## 探索纪律`,`1. **先窄后宽**:引用/焦点 → 所在小节 → 整页;每一步只取够回答当前问题的量`,`2. **翻页不重复**:read_page 续读传 offset = 上次 offset + 返回 text 长度;不要回头重读已读区`,`3. **定位失败换路**:selector 不命中 → dom_search text 模式换关键词;还不中 → read_page 扫小节标题再回来`,...e.withVfs?[`4. **大结果在外存**:超大结果被移入 vfs 后用 vfs_read/vfs_grep 按需取,不要盲目重调`]:[],`## 回答纪律(页面问答的底线)`,`- **基于页面实料**:答案须来自你读到的页面内容(引用原文/read_page/dom 工具结果),并在回答中点明出处小节/位置`,`- **页面 ≠ 训练数据**:页面内容可能与你的先验知识不同,冲突时以页面为准;页面没写的不要编造`,`- **不确定就说不确定**:找不到的内容如实说「本页未找到」,给出已探索的范围,勿凭印象补全`,`## 输出纪律(直接说内容,不写过程)`,`- 禁**过程叙述**:「我先读一下页面」「让我确认一下」—— 工具调用用户看得见,不需要旁白`,`- 禁**元话术**:「先给结论」「依据是」「简言之」—— 第一句直接就是答案本身,不要先宣布你要说什么`,`- 禁**方法论自述**:不要解释结论是怎么来的(「这些不是页面写明的,而是从正文用词反推的」)—— 那是你的内部过程`,`- 禁**预告与套话**:「下面分三点」「综上」—— 该分点就直接分点,说完就停`,`- 出处仍要标,但用最简形式:句末括注(如「(§小节名)」「(原文)」);引原文时直接引,不写「依据是…原文两行:」这样的引导句`].join(`
-`)}}var aC=nC();function oC(e){let t=e;return typeof t.tagName==`string`||typeof t.nodeType==`number`&&typeof t.nodeName==`string`}function sC(e,t=3,n=2e3,r,i){if(e==null)return e;if(typeof e==`string`)return e.length>n?e.slice(0,n)+`…(已截断)`:e;if(typeof e==`number`||typeof e==`boolean`)return e;if(typeof e==`function`)return`[Function: ${e.name||`anonymous`}]`;if(typeof e==`symbol`)return e.toString();if(typeof e==`bigint`)return`${e.toString()}n`;if(typeof e!=`object`)return String(e);let a=e;if(oC(a)){let e=a;return e.tagName?`[Element: <${e.tagName.toLowerCase()}>]`:`[Node: ${e.nodeName}]`}if(r?.has(a))return`[Circular]`;let o=r??new WeakSet;if(o.add(a),Array.isArray(e)){let r=e.slice(0,100).map(e=>sC(e,t-1,n,o,i));return e.length>100&&r.push(`…(共 ${e.length} 项,已截断)`),r}if(t<0)return`(对象,已截断)`;let s={},c=Object.keys(a);for(let e=0;e<c.length;e++){let r=c[e];if(e>=50){s[`…`]=`(共 ${c.length} 键,已截断)`;break}try{let e=a[r];i?.test(r)?s[r]=`[REDACTED]`:s[r]=sC(e,t-1,n,o,i)}catch{s[r]=`(getter 抛错)`}}return s}function cC(e){let t=e??(typeof window<`u`?window:{}),n=t.navigator,r=t.location,i=t.document;return{location:{href:r?.href,origin:r?.origin,protocol:r?.protocol,host:r?.host,hostname:r?.hostname,pathname:r?.pathname,search:r?.search},navigator:{userAgent:n?.userAgent,language:n?.language,languages:n?.languages,platform:n?.platform,onLine:n?.onLine},viewport:{innerWidth:t.innerWidth,innerHeight:t.innerHeight,devicePixelRatio:t.devicePixelRatio,scrollX:t.scrollX,scrollY:t.scrollY},document:i?{title:i.title,readyState:i.readyState,characterSet:i.characterSet}:`(无 document)`}}var lC=/^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/,uC=/token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i,dC=(0,i.tool)(({key:e})=>{if(e){if(lC.test(e)||uC.test(e))return JSON.stringify({key:e,denied:!0,reason:`安全:该 key 在 denylist(localStorage/sessionStorage/cookie/document 或敏感命名 token/secret/key/auth),不读取防泄漏`},null,2);let t=(typeof window<`u`?window:{})[e];return JSON.stringify({key:e,exists:t!==void 0,type:typeof t,value:sC(t,3,2e3,void 0,uC)},null,2)}return JSON.stringify(cC(),null,2)},{name:`inspect_env`,description:`读宿主页面环境信息(排查调试)。不传参返回摘要(URL/origin、浏览器/语言、viewport、title/readyState);传 key 读指定 window 属性值(如 key:"appConfig")。只读,大结果自动外存 vfs。`,schema:t.z.object({key:t.z.string().optional().describe(`要读取的 window 属性名(如 "appConfig"/"__DEBUG__");不传 = 返回环境摘要`)})}),fC=[dC];function pC(e,t,n){let i=0;return{name:`budget`,beforeAgent:()=>{i=Date.now()},wrapModelCall:async(a,o)=>{let{tokenBudget:s,timeBudgetMs:c}=t,l=s!=null&&(e.total_tokens??0)>s,u=c!=null&&Date.now()-i>c;return l||u?(n({type:`error`,severity:`observable`,code:`BUDGET_EXCEEDED`,message:`资源预算超限:${l?`token 超限(累计 ${e.total_tokens??0} > 上限 ${s})`:`时间超限(${Date.now()-i}ms > 上限 ${c}ms)`},agent 已停止(未完成部分可用 restoreLastCheckpoint 回退)。`}),{message:new r.AIMessage({content:``}),content:``,toolCalls:[],aborted:!0}):o(a)}}}var mC=/^[a-zA-Z][a-zA-Z0-9_]*$/;function hC(e){let n=[];for(let[r,a]of Object.entries(e)){if(!mC.test(r)){console.warn(`[page-agent-sdk][actions] 动作名 "${r}" 非法(须匹配 ${mC}),已跳过`);continue}let e=a.description||`宿主动作 ${r}`;n.push((0,i.tool)(async e=>{try{let t=await a.run(e||{});return t===void 0?`动作 ${r} 执行完成。`:typeof t==`string`?t:JSON.stringify(t)}catch(e){let t=e?.message||String(e);return`动作 ${r} 执行失败:${t}`}},{name:r,description:e,schema:a.params??t.z.object({})}))}return n}function gC(e){let t={};for(let[n,r]of Object.entries(e))mC.test(n)&&(t[n]={description:r.description,hasParams:!!r.params,readsHostState:r.readsHostState===!0,deferredWrite:r.deferredWrite===!0});return t}var _C=AS,vC=US;function yC(e,t){return ov(e,t)}function bC(e,t,n,r,i){let a=pb(e);return[...a.dataOps?t:[],...a.fetch?n:[],...a.domInspect&&r?r:[],...a.inspectEnv&&i?i:[]]}var xC=.7,SC=.5,CC=.85;function wC(e,t){if(!Number.isFinite(t)||t<=0||e<=0||e<t*SC)return``;let n=Math.max(1,Math.round(e/1e3));return e>=t*CC?`⏳ 预算告急:本任务累计约 ${n}K prompt tokens(已达 softCap 上限的 ${Math.round(CC*100)}%)。立即停止扩展性操作(新查询/重读/优化),完成手头最关键一步后基于已有工具结果给出结论,并如实汇报剩余未完成项。轮次预算吃紧时系统会另行注入轮次提示段。`:`⏳ 预算提示:本任务累计约 ${n}K prompt tokens(已过 softCap 半程)。若已接近目标请收敛并给出总结;尚未接近请向用户汇报进度与剩余计划,勿默默继续。轮次预算吃紧时系统会另行注入轮次提示段。`}function TC(e,t,n){let r=pb(e);return{name:`usageHints`,augmentPrompt:i=>{let a=[];if(r.planning&&(a.push(`【自适应规划】按任务复杂度决定是否先规划,不要对简单任务过度编排:`),a.push(`  · 简单/明确任务(改单字段、调样式、查值)→ 直接 read/write 执行,不必 write_todos。`),a.push(`  · 复杂任务(多步、大改、有歧义、不可逆)→ 先 write_todos 拆解,首个任务标 in_progress,逐项推进。`),a.push(`  · 执行中发现步骤要改/补/细分 → 用 update_todo({id, content?, status?}) 按 id 增量改单项,不必重传整个清单。`),a.push(`  · update_todo 标 completed 时附 evidence: 本次实际写入的 jsonPath(如 "components.2"),供收口对账;工作经委派子 agent 完成等无主写路径时,如实写明完成方式(勿编造路径)。`),e?.humanConfirm?a.push(`  · 规划出多步方案若需用户拍板 → 先 request_human_confirmation 给方案选项,确认后再执行。`):a.push(`  · 规划出多步方案若需用户拍板 → 以文字列出方案选项等用户回复,勿自行拍板。`),a.push(`  · 计划修订有次数上限(maxPlanRevisions,默认 5,只计 write_todos 调用、调研轮不计):勿反复改计划而不执行,规划充分后即开始 write 落地。`)),t&&(a.push(`改主数据前先 read({jsonPath}) 读其当前真实值(返回末尾 hash=xxx 为乐观锁标识),基于真实值改,不要凭记忆。写入是否被自动校验由集成方 conflictWatchFields 声明决定:若已声明且主数据在你 read 之后被外部改过,会触发冲突——集成方若开启人工介入,工具会挂起等用户决定(保留外部/强制覆盖/回退),你应等待工具返回后按结果继续(保留外部→重新 read 再改;强制覆盖→已写入,继续;回退→已回退到历史快照,基于回退值重写);未开启人工介入时返回 VERSION_CONFLICT 不写入,重新 read 拿最新值再改。`),a.push(`读类分流:取值/结构 → read(多路径用 jsonPaths);字段约束 → schema_data;条件筛选定位 → query_data(多条一次用 queries);名字模糊找 → search_data;整体说明 → read 不传路径。`),a.push(`修改大对象/数组优先用 write 增量改({patch:{op,jsonPath,value}} 只发改动部分),避免 write({value}) 整体重传被 max_tokens 截断导致 JSON 不完整、校验失败。`),a.push(`修改主数据出错时可用 restore_data 回退最近一次。`),a.push(`在大数组里按条件筛选元素用 query_data(JSONPath,如 $.components[?(@.type=="card" && @.price<100)]),返回匹配元素的 path/index;定位后再 write({patch}) 改。`),a.push(`找名字记不清的元素用 search_data(支持 substring/regex/fuzzy 模糊搜索)。`),a.push(`需要过滤/映射/聚合/批量重写大数组时用 eval_script(沙箱脚本,入参 data);只读探查用 mode=query,批量重写用 mode=transform(返回值经校验后落地)。`),a.push(`读大数组用 read({jsonPath,offset,limit}) 分页(返回 hasMore=true 时 offset+=limit 续读);一次读多个不相关子路径用 read({jsonPaths});复杂改动先 write({...,dryRun:true}) 预检不落盘。`),a.push(`【省轮次·批量】≥2 个路径一律 read({jsonPaths:[...]}) 一次取回(路径互不相关也合批,禁止连续单路径 read);多条件筛选用 query_data({queries:[expr1,expr2,…]}) 一次取回(2-10 条);改多处用 write({patches:[{op:"set",jsonPath,value},...]}) 一次提交多改动(原子任一失败回滚),勿逐个 write 烧轮次预算。`),a.push(`读到 <subtree Nkb keys:[…] #指纹> 或 <code Nkb> 占位 = 该子树键名/体积可见但内容未见:写入前先窄读全文(read({jsonPath:"该子树路径"}),结果根豁免返全文)或 set_focus 聚焦该区域;勿凭键名印象猜路径/猜值直写(直接写占位子树会被拦下要求先窄读)。`),a.push(`对比当前与历史快照(或一段 JSON against)的差异用 diff_data({snapshotId?,against?})(返回结构化 path→from/to,verify 自纠/操作审计/"刚才改了啥");只读查历史快照值用 history_data({id?,jsonPath?})。`)),r.subagent&&a.push(`独立子任务可 spawn_agent 委派(过程隔离,不占主上下文):默认只读,需要子 agent 写数据时传 writablePaths(路径前缀白名单,越界 PATH_OUT_OF_SCOPE)。多个独立子任务可 spawn_agents 并行委派(各子互不通信,结论由你汇总;并行委派不可授写权限,写操作由你收尾执行)。`),r.inspectEnv&&a.push(`排查页面环境(当前 URL/浏览器/视口/集成方调试变量)用 inspect_env——不传参返回环境摘要(location/navigator/viewport/document),传 key 读特定 window 属性(如 inspect_env({key:"appConfig"}) 读 window.appConfig)。改完数据看渲染、定位"为何没生效"时用它(只读,不改数据)。`),r.domInspect){let n=t&&e?.hasActions?`配合宿主 actions(save_draft/publish 等)形成"改数据→截图/get_dom 看渲染→触发动作"闭环。`:t?`改完数据可用截图/get_dom 查看渲染效果(本集成未注册宿主动作)。`:``,r=e?.skills?`长文按关键词定位(找某术语/某节在哪)先 load_skill("dom-inspect") 取得 dom_search 文本检索,命中后窄读那一节 —— 勿整页翻页找。`:``;a.push(`回答用户关于当前页面/文档的问题时优先用 read_page({selector?,offset?,limit?}) 读页面正文纯文本(长文按 hasMore 分页续读;自动排除本对话框自身);需要页面结构(检查渲染是否生效/定位元素/辅助 UI 设计问答)再用 get_dom({selector?,depth?}) 读渲染后 DOM(结构化返回 tag/attrs/text/children,depth 控制深度防爆炸,只读)。${n}${r}`)}if(e?.screenshot&&a.push(`视觉验证(看布局/样式/渲染效果像不像、对不对)用 take_screenshot({selector?, fullPage?}) 截图查看:selector 截指定元素、fullPage 截整页、默认当前视口;截图自动压缩投递(多模态直看图/纯文本模型走识图转述)。优先级:视觉问题先截图,结构/属性问题用 dom_info。`),e?.domEdit&&a.push(`修改宿主页面元素(高亮/改文案/调样式/插删移元素)用 dom_edit({patches:[{op,selector,...}],dryRun?}) 批量原子操作(op:set_text/set_html/set_attr/add_class/remove_class/set_style/insert/remove/move/highlight);selector 必须唯一命中(先 get_dom/dom_search 定位);改前自动快照,dom_restore 回滚最近一批;改动为会话临时态(刷新即失)——数据驱动页面改数据(write)不要改 DOM。`),e?.viewImage&&a.push(`看「页面数据里的某张图」(轮播第 N 帧/商品图/封面,read 结果里有其 URL)用 view_image({url}) 原图直投 —— 问特定帧时勿截当前渲染帧(自动轮播可能已切帧);要看渲染后的组件(布局/叠加文案)才用 take_screenshot。`),e?.hasProposals&&a.push(`【内容修改(提案制)】修改当前内容(文章/笔记/文档)只有一条通道:①先 read_content 取真实原文与 hash;②propose_content 带 baseHash 提案 —— 优先 ops 增量操作(replace/insertAfter/insertBefore/append,find/anchor 用原文字面片段且须唯一命中,多带上下文保唯一),勿全量重发整篇(token 只花在改动上);③提案仅送达:评审面板打开、用户点「应用」才会写回 —— 提案后如实告知用户待确认,勿声称已修改;用户裁决结果会在下一轮告知你,以裁决为准作答。`),r.draftWrite&&(a.push(`生成超大 JSON(如 50+ 组件页面,单次 write 受 max_tokens 限制装不下)用 draft_write 分块构建 → draft_commit 原子提交:draft_write({draftId, chunk, mode}) mode:"start" 新建/"append" 追加(拼 JSON 片段到 drafts 池);累积完 draft_commit({draftId}) 合并 + schema 校验 + 写主数据(失败草稿保留可修后重试,成功自动清草稿)。小改仍用 write patch,只在大 JSON 从零生成时用 draft。`),a.push(`⚠️ 大 JSON 分块构建是典型多轮工具调用(draft_write×N + draft_commit + read 确认 + 调研 read/query),默认 maxToolRounds=30(3.43 起;轮次预算吃紧时 system 会注入预算提示段,按提示优先收口);目标组件数很大时集成方仍可在 createChatSdk 显式上调 maxToolRounds(按 N+10 估算)。draft_commit 提交同样走乐观锁(改前 read 拿 hash,bind 被改过会触发冲突介入,不静默覆盖)。`)),r.focus&&t&&(a.push(`【上下文聚焦】判断任务范围,用 set_focus/add_focus/remove_focus/clear_focus 自动收敛工作范围:`),a.push(`  · 局部任务(只改某一组件/区域,如「调导航栏」「改 components.3 样式」)→ 先 read 定位 jsonPath,再 set_focus({path:"该子树路径"}) 聚焦;聚焦后每轮只看该子树结构,写其他位置会被 PATH_DENIED 拒绝。`),a.push(`  · 多个相关组件(如「同时改导航栏和页脚」)→ set_focus 聚焦首个后用 add_focus({path}) 追加其余;聚焦后可写任一焦点子树,越界仍被拒;移除单个用 remove_focus({path})。`),a.push(`  · 全局任务(多处/整体结构,如「重排所有组件」「换主题」)→ 不要聚焦,保持全量视野直接写。`),a.push(`  · 完成局部精修、要转向其他区域或做整体改动 → 调 clear_focus 退出聚焦(清空全部焦点),恢复全部读写权限。`),a.push(`  · set_focus/add_focus 的 path 必须在 schema 内(类型校验);不确定路径先 read 查。`)),e?.subagents?.length){let t=e.subagents.filter(e=>(e.temperature??0)>=xC||/规划|创意|设计|方案|brainstorm|plan/i.test(e.description)),n=e.subagents.filter(e=>(e.temperature??0)<xC&&/反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));a.push(`【规划-反思-执行·路由】按任务性质选模式,不要对简单任务过度编排:`),t.length&&(a.push(`  · 创作/设计/开放性需求(如"设计主题风格""换个感觉")→ 先调 ${t.map(e=>`use_`+e.id).join(`/`)} 出 2-3 套方案(高温创意),`),a.push(e?.humanConfirm?`    不要自己拍板;拿到方案后,若需用户拍板用 request_human_confirmation 弹选项。`:`    不要自己拍板;拿到方案后以文字列出选项等用户回复(humanConfirm 未开,勿调不存在工具)。`)),n.length&&a.push(`  · 严谨/易错/校验类 → 可先调 ${n.map(e=>`use_`+e.id).join(`/`)} 反思挑刺(低温审查),据反馈修订。`),a.push(`  · 方案定稿后,由你(主 agent)用 write 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。`),a.push(`  · 简单/明确任务(如"标题改红色")直接执行,不必走规划-反思。`)}e?.humanConfirm&&(a.push(`【人工确认·必读】以下情形必须先调 request_human_confirmation 征询用户、拿到答复后再继续,不要自行拍板:`),a.push(`  1) 用户让你「给方案/列选项/我来选/挑一个」时:把每个方案作为一个 option,调 request_human_confirmation(question=简述, options=[方案A,方案B,...], recommendation=你推荐的)。不要只回文字罗列方案让用户自己回复——要用工具把选项做成可点选按钮。`),a.push(`  2) 需求有歧义/不确定时:调工具问清楚(options 不传则用户答同意或拒绝)。`),a.push(`  3) 即将执行高风险不可逆操作(删除/覆盖/批量改动)前:调工具确认。`),a.push(`  4) 规划出多步方案需用户确认时:把整个方案(或关键分步)作为 option 调 request_human_confirmation,确认后再执行。`),a.push(`用户在选项里选了哪个,就按那个方案继续;选「拒绝」则停止并询问如何调整。`));let o=i?.loopProgress;if(o){let e=wC(o.invokeUsage.prompt_tokens||o.invokeUsage.total_tokens,n?.promptSoftCap??1/0);e&&a.push(e);let t=Object.entries(o.writeFailures).filter(([,e])=>e>=2);if(t.length){let e=t.map(([e,t])=>`${e||`(整体)`}×${t}`).join(`、`);a.push(`⚠️ 以下路径已连续写失败:${e}。连续失败常意味着方向错了——先 read 重新核对实际值/类型,或 restore_data 回退后再改;若确需继续,换思路而非原样重试。`)}}return a.length&&a.unshift(`调用工具务必用标准 function calling(工具调用)格式发起,不要在回复正文里输出伪 XML/标签(如 deepseek 的 tool_calls 标签、invoke、function_call、tool_call 等)或 JSON 文本——那不会被识别为工具调用,会被当普通文字,工具不执行。`),a.length?`## 能力使用提示
+`)}}var aC=nC();function oC(e){let t=e;return typeof t.tagName==`string`||typeof t.nodeType==`number`&&typeof t.nodeName==`string`}function sC(e,t=3,n=2e3,r,i){if(e==null)return e;if(typeof e==`string`)return e.length>n?e.slice(0,n)+`…(已截断)`:e;if(typeof e==`number`||typeof e==`boolean`)return e;if(typeof e==`function`)return`[Function: ${e.name||`anonymous`}]`;if(typeof e==`symbol`)return e.toString();if(typeof e==`bigint`)return`${e.toString()}n`;if(typeof e!=`object`)return String(e);let a=e;if(oC(a)){let e=a;return e.tagName?`[Element: <${e.tagName.toLowerCase()}>]`:`[Node: ${e.nodeName}]`}if(r?.has(a))return`[Circular]`;let o=r??new WeakSet;if(o.add(a),Array.isArray(e)){let r=e.slice(0,100).map(e=>sC(e,t-1,n,o,i));return e.length>100&&r.push(`…(共 ${e.length} 项,已截断)`),r}if(t<0)return`(对象,已截断)`;let s={},c=Object.keys(a);for(let e=0;e<c.length;e++){let r=c[e];if(e>=50){s[`…`]=`(共 ${c.length} 键,已截断)`;break}try{let e=a[r];i?.test(r)?s[r]=`[REDACTED]`:s[r]=sC(e,t-1,n,o,i)}catch{s[r]=`(getter 抛错)`}}return s}function cC(e){let t=e??(typeof window<`u`?window:{}),n=t.navigator,r=t.location,i=t.document;return{location:{href:r?.href,origin:r?.origin,protocol:r?.protocol,host:r?.host,hostname:r?.hostname,pathname:r?.pathname,search:r?.search},navigator:{userAgent:n?.userAgent,language:n?.language,languages:n?.languages,platform:n?.platform,onLine:n?.onLine},viewport:{innerWidth:t.innerWidth,innerHeight:t.innerHeight,devicePixelRatio:t.devicePixelRatio,scrollX:t.scrollX,scrollY:t.scrollY},document:i?{title:i.title,readyState:i.readyState,characterSet:i.characterSet}:`(无 document)`}}var lC=/^(localStorage|sessionStorage|cookie|document|frames|frameElement|opener|parent|top|self|window|globalThis|closed|history|navigation|trustedTypes|origin|crossOriginIsolated)$/,uC=/token|secret|password|passwd|api[-_]?key|auth|cred|csrf|session|ticket/i,dC=(0,i.tool)(({key:e})=>{if(e){if(lC.test(e)||uC.test(e))return JSON.stringify({key:e,denied:!0,reason:`安全:该 key 在 denylist(localStorage/sessionStorage/cookie/document 或敏感命名 token/secret/key/auth),不读取防泄漏`},null,2);let t=(typeof window<`u`?window:{})[e];return JSON.stringify({key:e,exists:t!==void 0,type:typeof t,value:sC(t,3,2e3,void 0,uC)},null,2)}return JSON.stringify(cC(),null,2)},{name:`inspect_env`,description:`读宿主页面环境信息(排查调试)。不传参返回摘要(URL/origin、浏览器/语言、viewport、title/readyState);传 key 读指定 window 属性值(如 key:"appConfig")。只读,大结果自动外存 vfs。`,schema:t.z.object({key:t.z.string().optional().describe(`要读取的 window 属性名(如 "appConfig"/"__DEBUG__");不传 = 返回环境摘要`)})}),fC=[dC];function pC(e,t,n){let i=0;return{name:`budget`,beforeAgent:()=>{i=Date.now()},wrapModelCall:async(a,o)=>{let{tokenBudget:s,timeBudgetMs:c}=t,l=s!=null&&(e.total_tokens??0)>s,u=c!=null&&Date.now()-i>c;return l||u?(n({type:`error`,severity:`observable`,code:`BUDGET_EXCEEDED`,message:`资源预算超限:${l?`token 超限(累计 ${e.total_tokens??0} > 上限 ${s})`:`时间超限(${Date.now()-i}ms > 上限 ${c}ms)`},agent 已停止(未完成部分可用 restoreLastCheckpoint 回退)。`}),{message:new r.AIMessage({content:``}),content:``,toolCalls:[],aborted:!0}):o(a)}}}var mC=/^[a-zA-Z][a-zA-Z0-9_]*$/;function hC(e,n={}){let r=[];for(let[a,o]of Object.entries(e)){if(!mC.test(a)){console.warn(`[page-agent-sdk][actions] 动作名 "${a}" 非法(须匹配 ${mC}),已跳过`);continue}let e=o.description||`宿主动作 ${a}`;r.push((0,i.tool)(async e=>{try{let t=await o.run(e||{});return t===void 0?`动作 ${a} 执行完成。`:typeof t==`string`?t:JSON.stringify(t)}catch(e){let t=e?.message||String(e);return n.onError?.({name:a,message:t}),Q({code:`ACTION_FAILED`,message:`动作 ${a} 执行失败:${t}`,hint:`检查参数与宿主状态后修正重试;连续失败时换思路或如实告知用户,不要原样重发相同调用。`})}},{name:a,description:e,schema:o.params??o.schema??t.z.object({})}))}return r}function gC(e){let t={};for(let[n,r]of Object.entries(e))mC.test(n)&&(t[n]={description:r.description,hasParams:!!(r.params||r.schema),readsHostState:r.readsHostState===!0,deferredWrite:r.deferredWrite===!0});return t}var _C=AS,vC=US;function yC(e,t){return ov(e,t)}function bC(e,t,n,r,i){let a=pb(e);return[...a.dataOps?t:[],...a.fetch?n:[],...a.domInspect&&r?r:[],...a.inspectEnv&&i?i:[]]}var xC=.7,SC=.5,CC=.85;function wC(e,t){if(!Number.isFinite(t)||t<=0||e<=0||e<t*SC)return``;let n=Math.max(1,Math.round(e/1e3));return e>=t*CC?`⏳ 预算告急:本任务累计约 ${n}K prompt tokens(已达 softCap 上限的 ${Math.round(CC*100)}%)。立即停止扩展性操作(新查询/重读/优化),完成手头最关键一步后基于已有工具结果给出结论,并如实汇报剩余未完成项。轮次预算吃紧时系统会另行注入轮次提示段。`:`⏳ 预算提示:本任务累计约 ${n}K prompt tokens(已过 softCap 半程)。若已接近目标请收敛并给出总结;尚未接近请向用户汇报进度与剩余计划,勿默默继续。轮次预算吃紧时系统会另行注入轮次提示段。`}function TC(e,t,n){let r=pb(e);return{name:`usageHints`,augmentPrompt:i=>{let a=[];if(r.planning&&(a.push(`【自适应规划】按任务复杂度决定是否先规划,不要对简单任务过度编排:`),a.push(`  · 简单/明确任务(改单字段、调样式、查值)→ 直接 read/write 执行,不必 write_todos。`),a.push(`  · 复杂任务(多步、大改、有歧义、不可逆)→ 先 write_todos 拆解,首个任务标 in_progress,逐项推进。`),a.push(`  · 执行中发现步骤要改/补/细分 → 用 update_todo({id, content?, status?}) 按 id 增量改单项,不必重传整个清单。`),a.push(`  · update_todo 标 completed 时附 evidence: 本次实际写入的 jsonPath(如 "components.2"),供收口对账;工作经委派子 agent 完成等无主写路径时,如实写明完成方式(勿编造路径)。`),e?.humanConfirm?a.push(`  · 规划出多步方案若需用户拍板 → 先 request_human_confirmation 给方案选项,确认后再执行。`):a.push(`  · 规划出多步方案若需用户拍板 → 以文字列出方案选项等用户回复,勿自行拍板。`),a.push(`  · 计划修订有次数上限(maxPlanRevisions,默认 5,只计 write_todos 调用、调研轮不计):勿反复改计划而不执行,规划充分后即开始 write 落地。`)),t&&(a.push(`改主数据前先 read({jsonPath}) 读其当前真实值(返回末尾 hash=xxx 为乐观锁标识),基于真实值改,不要凭记忆。写入是否被自动校验由集成方 conflictWatchFields 声明决定:若已声明且主数据在你 read 之后被外部改过,会触发冲突——集成方若开启人工介入,工具会挂起等用户决定(保留外部/强制覆盖/回退),你应等待工具返回后按结果继续(保留外部→重新 read 再改;强制覆盖→已写入,继续;回退→已回退到历史快照,基于回退值重写);未开启人工介入时返回 VERSION_CONFLICT 不写入,重新 read 拿最新值再改。`),a.push(`读类分流:取值/结构 → read(多路径用 jsonPaths);字段约束 → schema_data;条件筛选定位 → query_data(多条一次用 queries);名字模糊找 → search_data;整体说明 → read 不传路径。`),a.push(`修改大对象/数组优先用 write 增量改({patch:{op,jsonPath,value}} 只发改动部分),避免 write({value}) 整体重传被 max_tokens 截断导致 JSON 不完整、校验失败。`),a.push(`修改主数据出错时可用 restore_data 回退最近一次。`),a.push(`在大数组里按条件筛选元素用 query_data(JSONPath,如 $.components[?(@.type=="card" && @.price<100)]),返回匹配元素的 path/index;定位后再 write({patch}) 改。`),a.push(`找名字记不清的元素用 search_data(支持 substring/regex/fuzzy 模糊搜索)。`),a.push(`需要过滤/映射/聚合/批量重写大数组时用 eval_script(沙箱脚本,入参 data);只读探查用 mode=query,批量重写用 mode=transform(返回值经校验后落地)。`),a.push(`读大数组用 read({jsonPath,offset,limit}) 分页(返回 hasMore=true 时 offset+=limit 续读);一次读多个不相关子路径用 read({jsonPaths});复杂改动先 write({...,dryRun:true}) 预检不落盘。`),a.push(`【省轮次·批量】≥2 个路径一律 read({jsonPaths:[...]}) 一次取回(路径互不相关也合批,禁止连续单路径 read);多条件筛选用 query_data({queries:[expr1,expr2,…]}) 一次取回(2-10 条);改多处用 write({patches:[{op:"set",jsonPath,value},...]}) 一次提交多改动(原子任一失败回滚),勿逐个 write 烧轮次预算。`),a.push(`读到 <subtree Nkb keys:[…] #指纹> 或 <code Nkb> 占位 = 该子树键名/体积可见但内容未见:写入前先窄读全文(read({jsonPath:"该子树路径"}),结果根豁免返全文)或 set_focus 聚焦该区域;勿凭键名印象猜路径/猜值直写(直接写占位子树会被拦下要求先窄读)。`),a.push(`对比当前与历史快照(或一段 JSON against)的差异用 diff_data({snapshotId?,against?})(返回结构化 path→from/to,verify 自纠/操作审计/"刚才改了啥");只读查历史快照值用 history_data({id?,jsonPath?})。`)),r.subagent&&a.push(`独立子任务可 spawn_agent 委派(过程隔离,不占主上下文):默认只读,需要子 agent 写数据时传 writablePaths(路径前缀白名单,越界 PATH_OUT_OF_SCOPE)。多个独立子任务可 spawn_agents 并行委派(各子互不通信,结论由你汇总;并行委派不可授写权限,写操作由你收尾执行)。`),r.inspectEnv&&a.push(`排查页面环境(当前 URL/浏览器/视口/集成方调试变量)用 inspect_env——不传参返回环境摘要(location/navigator/viewport/document),传 key 读特定 window 属性(如 inspect_env({key:"appConfig"}) 读 window.appConfig)。改完数据看渲染、定位"为何没生效"时用它(只读,不改数据)。`),r.domInspect){let n=t&&e?.hasActions?`配合宿主 actions(save_draft/publish 等)形成"改数据→截图/get_dom 看渲染→触发动作"闭环。`:t?`改完数据可用截图/get_dom 查看渲染效果(本集成未注册宿主动作)。`:``,r=e?.skills?`长文按关键词定位(找某术语/某节在哪)先 load_skill("dom-inspect") 取得 dom_search 文本检索,命中后窄读那一节 —— 勿整页翻页找。`:``;a.push(`回答用户关于当前页面/文档的问题时优先用 read_page({selector?,offset?,limit?}) 读页面正文纯文本(长文按 hasMore 分页续读;自动排除本对话框自身);需要页面结构(检查渲染是否生效/定位元素/辅助 UI 设计问答)再用 get_dom({selector?,depth?}) 读渲染后 DOM(结构化返回 tag/attrs/text/children,depth 控制深度防爆炸,只读)。${n}${r}`)}if(e?.screenshot&&a.push(`视觉验证(看布局/样式/渲染效果像不像、对不对)用 take_screenshot({selector?, fullPage?}) 截图查看:selector 截指定元素、fullPage 截整页、默认当前视口;截图自动压缩投递(多模态直看图/纯文本模型走识图转述)。优先级:视觉问题先截图,结构/属性问题用 dom_info。`),e?.domEdit&&a.push(`修改宿主页面元素(高亮/改文案/调样式/插删移元素)用 dom_edit({patches:[{op,selector,...}],dryRun?}) 批量原子操作(op:set_text/set_html/set_attr/add_class/remove_class/set_style/insert/remove/move/highlight);selector 必须唯一命中(先 get_dom/dom_search 定位);改前自动快照,dom_restore 回滚最近一批;改动为会话临时态(刷新即失)——数据驱动页面改数据(write)不要改 DOM。`),e?.viewImage&&a.push(`看「页面数据里的某张图」(轮播第 N 帧/商品图/封面,read 结果里有其 URL)用 view_image({url}) 原图直投 —— 问特定帧时勿截当前渲染帧(自动轮播可能已切帧);要看渲染后的组件(布局/叠加文案)才用 take_screenshot。`),e?.hasProposals&&a.push(`【内容修改(提案制)】修改当前内容(文章/笔记/文档)只有一条通道:①先 read_content 取真实原文与 hash;②propose_content 带 baseHash 提案 —— 优先 ops 增量操作(replace/insertAfter/insertBefore/append,find/anchor 用原文字面片段且须唯一命中,多带上下文保唯一),勿全量重发整篇(token 只花在改动上);③提案仅送达:评审面板打开、用户点「应用」才会写回 —— 提案后如实告知用户待确认,勿声称已修改;用户裁决结果会在下一轮告知你,以裁决为准作答。`),r.draftWrite&&(a.push(`生成超大 JSON(如 50+ 组件页面,单次 write 受 max_tokens 限制装不下)用 draft_write 分块构建 → draft_commit 原子提交:draft_write({draftId, chunk, mode}) mode:"start" 新建/"append" 追加(拼 JSON 片段到 drafts 池);累积完 draft_commit({draftId}) 合并 + schema 校验 + 写主数据(失败草稿保留可修后重试,成功自动清草稿)。小改仍用 write patch,只在大 JSON 从零生成时用 draft。`),a.push(`⚠️ 大 JSON 分块构建是典型多轮工具调用(draft_write×N + draft_commit + read 确认 + 调研 read/query),默认 maxToolRounds=30(3.43 起;轮次预算吃紧时 system 会注入预算提示段,按提示优先收口);目标组件数很大时集成方仍可在 createChatSdk 显式上调 maxToolRounds(按 N+10 估算)。draft_commit 提交同样走乐观锁(改前 read 拿 hash,bind 被改过会触发冲突介入,不静默覆盖)。`)),r.focus&&t&&(a.push(`【上下文聚焦】判断任务范围,用 set_focus/add_focus/remove_focus/clear_focus 自动收敛工作范围:`),a.push(`  · 局部任务(只改某一组件/区域,如「调导航栏」「改 components.3 样式」)→ 先 read 定位 jsonPath,再 set_focus({path:"该子树路径"}) 聚焦;聚焦后每轮只看该子树结构,写其他位置会被 PATH_DENIED 拒绝。`),a.push(`  · 多个相关组件(如「同时改导航栏和页脚」)→ set_focus 聚焦首个后用 add_focus({path}) 追加其余;聚焦后可写任一焦点子树,越界仍被拒;移除单个用 remove_focus({path})。`),a.push(`  · 全局任务(多处/整体结构,如「重排所有组件」「换主题」)→ 不要聚焦,保持全量视野直接写。`),a.push(`  · 完成局部精修、要转向其他区域或做整体改动 → 调 clear_focus 退出聚焦(清空全部焦点),恢复全部读写权限。`),a.push(`  · set_focus/add_focus 的 path 必须在 schema 内(类型校验);不确定路径先 read 查。`)),e?.subagents?.length){let t=e.subagents.filter(e=>(e.temperature??0)>=xC||/规划|创意|设计|方案|brainstorm|plan/i.test(e.description)),n=e.subagents.filter(e=>(e.temperature??0)<xC&&/反思|审查|挑刺|校验|review|critique|reflect/i.test(e.description));a.push(`【规划-反思-执行·路由】按任务性质选模式,不要对简单任务过度编排:`),t.length&&(a.push(`  · 创作/设计/开放性需求(如"设计主题风格""换个感觉")→ 先调 ${t.map(e=>`use_`+e.id).join(`/`)} 出 2-3 套方案(高温创意),`),a.push(e?.humanConfirm?`    不要自己拍板;拿到方案后,若需用户拍板用 request_human_confirmation 弹选项。`:`    不要自己拍板;拿到方案后以文字列出选项等用户回复(humanConfirm 未开,勿调不存在工具)。`)),n.length&&a.push(`  · 严谨/易错/校验类 → 可先调 ${n.map(e=>`use_`+e.id).join(`/`)} 反思挑刺(低温审查),据反馈修订。`),a.push(`  · 方案定稿后,由你(主 agent)用 write 落地成 JSON(低温度执行 + schema 校验 + 写前确认)。`),a.push(`  · 简单/明确任务(如"标题改红色")直接执行,不必走规划-反思。`)}e?.humanConfirm&&(a.push(`【人工确认·必读】以下情形必须先调 request_human_confirmation 征询用户、拿到答复后再继续,不要自行拍板:`),a.push(`  1) 用户让你「给方案/列选项/我来选/挑一个」时:把每个方案作为一个 option,调 request_human_confirmation(question=简述, options=[方案A,方案B,...], recommendation=你推荐的)。不要只回文字罗列方案让用户自己回复——要用工具把选项做成可点选按钮。`),a.push(`  2) 需求有歧义/不确定时:调工具问清楚(options 不传则用户答同意或拒绝)。`),a.push(`  3) 即将执行高风险不可逆操作(删除/覆盖/批量改动)前:调工具确认。`),a.push(`  4) 规划出多步方案需用户确认时:把整个方案(或关键分步)作为 option 调 request_human_confirmation,确认后再执行。`),a.push(`用户在选项里选了哪个,就按那个方案继续;选「拒绝」则停止并询问如何调整。`));let o=i?.loopProgress;if(o){let e=wC(o.invokeUsage.prompt_tokens||o.invokeUsage.total_tokens,n?.promptSoftCap??1/0);e&&a.push(e);let t=Object.entries(o.writeFailures).filter(([,e])=>e>=2);if(t.length){let e=t.map(([e,t])=>`${e||`(整体)`}×${t}`).join(`、`);a.push(`⚠️ 以下路径已连续写失败:${e}。连续失败常意味着方向错了——先 read 重新核对实际值/类型,或 restore_data 回退后再改;若确需继续,换思路而非原样重试。`)}}return a.length&&a.unshift(`调用工具务必用标准 function calling(工具调用)格式发起,不要在回复正文里输出伪 XML/标签(如 deepseek 的 tool_calls 标签、invoke、function_call、tool_call 等)或 JSON 文本——那不会被识别为工具调用,会被当普通文字,工具不执行。`),a.length?`## 能力使用提示
 `+a.join(`
 `):void 0}}}function EC(e,t){let n=[`[当前页面] 用户正在浏览:`,`- 标题:${e.title}`,`- URL:${e.url}`,`用户问题通常针对此页面内容。`];return t&&n.push(`需要页面正文时用 read_page 读取纯文本(长文按 hasMore 分页续读);读结构用 get_dom。`),n.join(`
 `)}function DC(e){return{name:`pageContext`,augmentPrompt:()=>{let t=e.getPageInfo();if(t)return EC(t,e.canReadPage)}}}function OC(e){return{name:`resourcesPin`,augmentPrompt:()=>{let t=e.getResourcesSnapshot();if(!t.length)return;let n=[`## 受保护资源(跨压缩保留 · 精确值保护)`];for(let e of t)e.mode===`freeze`?n.push(`- ${e.path} (freeze 已冻结,不可改)`):n.push(`- ${e.path} (verbatim 原样保留)${e.handle?` ⟦res:${e.handle}⟧`:``}`);return n.push(`读到 ⟦frozen:path⟧/⟦res:handle⟧ 占位符 = 精确值在冻结区/资源池(不入消息流);需真值用 resource_get({path});freeze 字段不可写(撞 FROZEN_FIELD 即放弃);verbatim 直接写新值会 VERBATIM_MISMATCH,先 resource_update 再写回句柄;撞 RESOURCE_EVICTED/RESOURCE_NOT_FOUND 重新 read 懒注册。`),n.join(`
@@ -3000,7 +3000,7 @@ ${`- 输出形态:完整、自包含的 HTML 页面(.${r},可独立成页)`}
 
 `+nm.htmlDirectWriteFallback,console.warn(`[page-agent-sdk] 检测到 schema 含 code 字段但未注册 html 子 agent:已自动注入「主 agent 自己写 HTML」编排(code 作普通字段直接 write,无 vfs 工作副本 / 无格式校验门禁)。如需代码资产机制(vfs + 格式校验 + 增量 commit + 主上下文 code 摘要),注册 createHtmlSubagent;若确为降级意图可忽略。`));let be=ge&&F?ov(F,{onAudit:e.onAudit??(e.debug?e=>console.log(`[page-agent-sdk][data audit]`,e):void 0),maxSnapshots:e.maxSnapshots,onConflict:s.set,conflictWatchFields:e.conflictWatchFields,maxParallelTools:e.maxParallelTools,vfsStore:_e||F?.resources?.length?T:void 0,...fe.length?{pgIdPaths:fe}:{},...R.length?{largeTextPaths:R}:{}}):[],xe=ge?be:[],Se=ge&&F?be.controller??null:null,Ce=ge&&F?be.previewWrite:void 0,we=ge&&F?.resources?.length&&Se?.getResourcesSnapshot?OC({getResourcesSnapshot:()=>Se?.getResourcesSnapshot?.()??[]}):void 0,Te=()=>Se?.get()??F,Ee=new Set(be.map(e=>e.name)),De=e.conflictWatchFields??[],Oe=!De.includes(`*`)&&De.length?new Set(De):void 0,ke=Se?zv({getBind:()=>Te()?.bind,recomputeAll:()=>Se.recomputeAllBaselines?.(),hasBaselines:()=>Se.hasBaselines?.()??!1,isManaged:e=>Ee.has(e),hash:e=>Oe?Dm(_g(e),Oe):Em(_g(e)),log:(e,t)=>{let n=U.agent?.debugLogs;n&&(n.value.push({timestamp:Date.now(),type:`middleware`,data:{stage:`baseline_guard`,...t}}),Bn(n))}}):void 0,Ae=new Map;B.domInspect&&!ve&&console.warn(`[page-agent-sdk][take_screenshot] domInspect 已开启但主模型不支持图片(vision=false)且未配 images.describe,截图工具未装载(视觉验证退回 get_dom/dom_info 结构推断;换多模态模型 / llm.vision:true / 配 images.describe 后重建 SDK 生效)`);let je=[],Me=e=>{if(e.type===`tool_result`&&e.name===`take_screenshot`){let t=je.find(e=>!e.eventConsumed);if(t)return t.eventConsumed=!0,Object.assign(e,{image:{dataUri:t.image.dataUri,vfsRef:t.meta.vfsRef}})}return e},Ne=m.vision===!0||typeof e.images?.describe==`function`?eS({getVision:()=>m.vision===!0,describe:e.images?.describe,onShot:(e,t)=>{je.push({image:e,meta:t})}}):void 0,Pe=ve?Qx({render:e.screenshot?.renderer,getActiveFocus:()=>U.getFocus(),focusSelector:e.screenshot?.focusSelector,stow:e=>{if(e.dataUri)try{let t=`userImages/${e.id}`;return T.files[t]={content:e.dataUri,updatedAt:Date.now()},t}catch{return}},getVision:()=>m.vision===!0,describe:e.images?.describe,onShot:(e,t)=>{je.push({image:e,meta:t})}}):void 0,Fe=!xy(e.llm)&&(e.llm.provider??`openai`)===`anthropic`?`anthropic`:`openai`,Ie=Pe||Ne?{name:`screenshotChannel`,wrapModelCall:async(e,t)=>{if(je.length){let t=je.splice(0),n=ru(t.map((e,t)=>e.meta.mode===`url`?`[图片 ${t+1}] 原图直投 ${e.image.url??``}(view_image,全分辨率非渲染态)`:`[截图 ${t+1}] ${e.meta.mode}${e.meta.selector?` selector="${e.meta.selector}"`:``}${e.meta.vfsRef?`(原图 vfs:${e.meta.vfsRef})`:``}`).join(`
 `)+`
-(视觉内容如上,请结合图片回答/继续)`,t.map(e=>({dataUri:e.image.dataUri,url:e.image.url})),Fe);n&&e.messages.push(new r.HumanMessage({content:n}))}return t(e)}}:null,Le=!1,Re=B.domEdit?pS({onEdit:e=>{U.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`dom_edit`,ops:e.ops.join(`,`),applied:e.applied,dryRun:e.dryRun}}),!e.dryRun&&e.applied>0&&(Le=!0)},onRestore:e=>{e.restored>0&&(Le=!0)}}):[],ze=[...bC(B,xe,AS,B.domInspect?[...US,...Re,...Pe?[Pe]:[],...B.skills?[]:[$S,eC]]:[],fC),...Ne?[Ne]:[]];Ne&&Ae.set(`view_image`,`builtin`),ze.forEach(e=>Ae.set(e.name,`builtin`));let Be=e.proposals?OS(e.proposals,{emit:e=>{try{Zt(e)}catch{}},log:(e,t)=>{U.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`proposal`,kind:e,...t}})}}):null,Ve=[...e.tools||[],...Be?.tools??[]];Ve.forEach(e=>Ae.set(e.name,`user`));let He=hC(e.actions??{});He.forEach(e=>Ae.set(e.name,`action`));let Ue=Be?e.proposals?.readToolName||`read_content`:null,We=Be?e.proposals?.toolName||`propose_content`:null,Ge=new Set([...Object.entries(e.actions??{}).filter(([,e])=>e?.readsHostState===!0).map(([e])=>e),...Ue?[Ue]:[]]),Ke=new Set([...Object.entries(e.actions??{}).filter(([,e])=>e?.deferredWrite===!0).map(([e])=>e),...We?[We]:[]]),qe=[],Je=!1,Ye=e.humanConfirm!==!1&&(!e.approval||e.approval.humanConfirmTool!==!1),Xe=Ye?hg():null;Xe&&Ae.set(pg,`builtin`);let Ze=pe&&me?[(0,i.tool)(async()=>{let e=me.list();return e.length?me.restore()?`已回退到最近一次正常状态(checkpoint #${e[e.length-1].id})。对话历史、主数据、vfs、todos 已整体还原。请基于回退后的状态重新判断并继续。`:`回退失败:无可用 checkpoint。`:`无可用 checkpoint,无法回退。`},{name:`restore_last_checkpoint`,description:`回退到最近一次正常状态(整体还原对话历史 + 主数据 + vfs + todos)。当本轮操作出错、页面被改坏、或走偏时调用,回到本轮起点重新来过。不传参数即回退最近一次。`,schema:t.z.object({}).optional()}),(0,i.tool)(async()=>{let e=me.list();return e.length?`可用 checkpoint:
+(视觉内容如上,请结合图片回答/继续)`,t.map(e=>({dataUri:e.image.dataUri,url:e.image.url})),Fe);n&&e.messages.push(new r.HumanMessage({content:n}))}return t(e)}}:null,Le=!1,Re=B.domEdit?pS({onEdit:e=>{U.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`dom_edit`,ops:e.ops.join(`,`),applied:e.applied,dryRun:e.dryRun}}),!e.dryRun&&e.applied>0&&(Le=!0)},onRestore:e=>{e.restored>0&&(Le=!0)}}):[],ze=[...bC(B,xe,AS,B.domInspect?[...US,...Re,...Pe?[Pe]:[],...B.skills?[]:[$S,eC]]:[],fC),...Ne?[Ne]:[]];Ne&&Ae.set(`view_image`,`builtin`),ze.forEach(e=>Ae.set(e.name,`builtin`));let Be=e.proposals?OS(e.proposals,{emit:e=>{try{Zt(e)}catch{}},log:(e,t)=>{U.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`proposal`,kind:e,...t}})}}):null,Ve=[...e.tools||[],...Be?.tools??[]];Ve.forEach(e=>Ae.set(e.name,`user`));let He=hC(e.actions??{},{onError:({name:e,message:t})=>{U.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`action_failed`,name:e,message:t.slice(0,300)}})}});He.forEach(e=>Ae.set(e.name,`action`));let Ue=Be?e.proposals?.readToolName||`read_content`:null,We=Be?e.proposals?.toolName||`propose_content`:null,Ge=new Set([...Object.entries(e.actions??{}).filter(([,e])=>e?.readsHostState===!0).map(([e])=>e),...Ue?[Ue]:[]]),Ke=new Set([...Object.entries(e.actions??{}).filter(([,e])=>e?.deferredWrite===!0).map(([e])=>e),...We?[We]:[]]),qe=[],Je=!1,Ye=e.humanConfirm!==!1&&(!e.approval||e.approval.humanConfirmTool!==!1),Xe=Ye?hg():null;Xe&&Ae.set(pg,`builtin`);let Ze=pe&&me?[(0,i.tool)(async()=>{let e=me.list();return e.length?me.restore()?`已回退到最近一次正常状态(checkpoint #${e[e.length-1].id})。对话历史、主数据、vfs、todos 已整体还原。请基于回退后的状态重新判断并继续。`:`回退失败:无可用 checkpoint。`:`无可用 checkpoint,无法回退。`},{name:`restore_last_checkpoint`,description:`回退到最近一次正常状态(整体还原对话历史 + 主数据 + vfs + todos)。当本轮操作出错、页面被改坏、或走偏时调用,回到本轮起点重新来过。不传参数即回退最近一次。`,schema:t.z.object({}).optional()}),(0,i.tool)(async()=>{let e=me.list();return e.length?`可用 checkpoint:
 `+e.map(e=>`#${e.id} [${e.label??`auto`}] 消息数=${e.messageCount} 时间=${new Date(e.timestamp).toLocaleTimeString()}`).join(`
 `):`无可用 checkpoint。`},{name:`list_checkpoints`,description:`列出可用会话 checkpoint(回退点)。`,schema:t.z.object({}).optional()})]:[];Ze.forEach(e=>Ae.set(e.name,`builtin`));let Qe=B.focus&&ge,$e=(0,i.tool)(async({path:e,label:t})=>{let n=Te()?.schema;return n?Tp(n,e)?(P.setFocus(re({path:e,...t?{label:t}:{}}),`agent`),`已聚焦到 ${e}${t?`(${t})`:``}。后续仅可写该子树(越界被拒),每轮只看到该组件结构。完成精修后调 clear_focus 退出。`):`PATH_DENIED · 聚焦失败:path "${e}" 不在 schema 内。请先用 read 查看可操作路径再聚焦。`:`聚焦失败:当前无主数据 schema,无法聚焦。`},{name:`set_focus`,description:`聚焦到指定组件子树(如 components.3)精修,替换全部已有焦点(非累积;要保留已有焦点追加用 add_focus)。聚焦后:仅可写该子树(越界 PATH_DENIED)+ 每轮只看到该组件结构。多组件页面精修其中一个时用,避免改到别处。先 read 定位 path 再聚焦;完成调 clear_focus。`,schema:t.z.object({path:t.z.string().describe(`要聚焦的组件 jsonPath,如 components.3`),label:t.z.string().optional().describe(`人类可读标签,如「导航栏」`)})}),et=(0,i.tool)(async()=>(P.clearFocus(`agent`),`已清除聚焦,恢复全量可操作范围(可读写所有组件)。`),{name:`clear_focus`,description:`清除当前聚焦,退出精修模式,恢复对全部组件的读写权限。`,schema:t.z.object({}).optional()}),tt=(0,i.tool)(async({path:e,label:t})=>{let n=Te()?.schema;if(!n)return`聚焦失败:当前无主数据 schema,无法聚焦。`;if(!Tp(n,e))return`PATH_DENIED · 聚焦失败:path "${e}" 不在 schema 内。请先用 read 查看可操作路径再聚焦。`;P.addFocus(re({path:e,...t?{label:t}:{}}),`agent`);let r=P.getFocuses();return`已聚焦 ${e}${t?`(${t})`:``}(当前共 ${r.length} 个焦点:${r.map(e=>e.path).join(`, `)})。后续仅可写这些子树之一(越界被拒)。`},{name:`add_focus`,description:`追加聚焦一个组件子树(multi-focus,可同时聚焦多个相关组件)。校验 path 在 schema 内。聚焦后仅可写已聚焦的子树之一(越界 PATH_DENIED)。与 set_focus(替换全部)不同:本工具累积追加,不清除已有焦点。`,schema:t.z.object({path:t.z.string().describe(`要追加聚焦的组件 jsonPath,如 components.3`),label:t.z.string().optional().describe(`人类可读标签`)})}),nt=(0,i.tool)(async({path:e})=>{let t=P.getFocuses().length;P.removeFocus(e,`agent`);let n=P.getFocuses();return n.length===t?`path "${e}" 不在当前焦点列表中(当前:${n.map(e=>e.path).join(`, `)||`无`})。`:n.length?`已移除焦点 ${e}(剩余 ${n.length} 个:${n.map(e=>e.path).join(`, `)})。`:`已移除焦点 ${e},聚焦已清空,恢复全量操作范围。`},{name:`remove_focus`,description:`移除单个聚焦焦点(by path),保留其他焦点。移除最后一个等价退出精修。全部退出用 clear_focus。`,schema:t.z.object({path:t.z.string().describe(`要移除的焦点 jsonPath`)})}),rt=Qe?[$e,et,tt,nt]:[];rt.forEach(e=>Ae.set(e.name,`builtin`));let H=[],it=new Map,at=wb({builtinTools:()=>ze,userTools:()=>Ve,actionTools:()=>He,humanConfirmTool:()=>Xe,checkpointTools:()=>Ze,focusTools:()=>rt,mcpTools:()=>qe,loadedSkillTools:()=>H}),ot=at(),st=B.planning,ct=B.missionAnchor,lt=B.workingMemory,ut=B.skills,dt=B.vfs||de;if(dt)for(let e of y_)Ae.set(e,`builtin`);if(st)for(let e of E.tools??[])Ae.set(e.name,`builtin`);let ft=B.summarization,pt=B.agentCompression&&!!p;e.debug&&B.agentCompression&&!p&&console.warn(`[page-agent-sdk][agentCompression] agentCompression 开启但 summaryLlm 不可用(或缺 apiKey / 模型不支持工具),压缩决策不启用,回退静态压缩`);let mt=B.memory,ht=B.subagent,gt=ht?Ah():void 0,_t=e.verify?.maxAttempts??2,vt=!!(e.verify?.check||e.verify?.maxAttempts||e.verify?.adversarial),yt=e.capabilities?.verify===!1,bt=(B.verify||vt&&!yt)&&e.verify?.enabled!==!1&&_t>0,xt=B.contextInspector;vt&&!bt&&e.verify?.enabled!==!1&&console.warn(`[page-agent-sdk][verify] 检测到 verify 配置(check/maxAttempts/adversarial)但未装载(capabilities.verify:false 显式关闭 或 maxAttempts≤0)`);let St=e.subagent,Ct=St?.allowedTools??[],wt=e.permissions?.length?dg(e.permissions):void 0,Tt=e.approval?.preview===!0&&Ce?(e,t)=>e===`write`?Ce(t):null:void 0,Et=e.approval?.previewWrite||Tt?(t,n)=>e.approval?.previewWrite?.(t,n)??Tt?.(t,n)??null:void 0,Dt=new Set,Ot=e.approval&&(e.approval.tools!==void 0||e.approval.confirm||e.approval.remember===!0)?fg({...e.approval,remember:e.approval.remember===!0,grants:Dt,timeoutMs:e.approval.timeoutMs??ee,onAutoReject:N,previewWrite:Et}):void 0,kt=[...wt?[wt]:[],...Ot?[Ot]:[],...ke?[ke]:[]],At=!ht||St?.enabled===!1?void 0:Xh({llm:St?.llm??e.llm,allTools:()=>U.agent?.allTools??ot,allowedTools:Ct.length?Ct:void 0,...e.staleReadInvalidation===void 0?{}:{staleReadInvalidation:e.staleReadInvalidation},systemPrompt:St?.systemPrompt,temperature:St?.temperature,maxTokens:St?.maxTokens,skills:St?.skills,maxDepth:St?.maxDepth,maxParallel:St?.maxParallel,thinkingMode:St?.thinkingMode,debug:e.debug,getFocuses:()=>P.getActiveFocuses(),getSchema:()=>Te()?.schema??null,tracker:gt,guardMiddleware:kt.length?kt:void 0,getVfsFiles:dt?()=>T.files:void 0,enterDataScope:Se?.enterScope?e=>Se.enterScope(e):void 0,exitDataScope:Se?.exitScope?e=>Se.exitScope(e):void 0,onUsage:e=>{o.prompt_tokens=(o.prompt_tokens??0)+(e.prompt_tokens??0),o.completion_tokens=(o.completion_tokens??0)+(e.completion_tokens??0),o.total_tokens=(o.total_tokens??0)+(e.total_tokens??0),e.reasoning_tokens&&(o.reasoning_tokens=(o.reasoning_tokens??0)+e.reasoning_tokens)},timeoutMs:St?.timeoutMs}),jt=ue?.map(e=>{if(!e._codeAsset)return e;let t=e._codeAsset,n=wv({writablePaths:t.writablePaths,codeVfsPrefix:t.codeVfsPrefix,ext:t.ext,codeField:t.codeField,craftNotes:t.craftNotes,onWarning:e=>console.warn(`[page-agent-sdk][code-asset] ${e}`),getController:()=>Se,vfsStore:T}),r=[...e.middleware??[],n];for(let e of r)e&&Yf(e)&&e._setGetController(()=>Se);return{...e,middleware:r}}),Mt=de&&ht?Tv():void 0,Nt=Mt?Mv({getBind:()=>Te()?.bind,writablePaths:fe,getLocked:()=>Mt.locked(),tools:ot,getCodeFieldPaths:()=>Av(Te()?.bind,L.map(e=>({writablePaths:e._codeAsset.writablePaths,codeField:e._codeAsset.codeField})))}):void 0,Pt=Se?.getSummarizedPaths&&Se.clearSummarizedPaths?Fv({getSummarizedPaths:()=>Se.getSummarizedPaths(),clearSummarizedPaths:()=>Se.clearSummarizedPaths()}):void 0,Ft=ht&&jt!==void 0?$h(jt,{llm:e.llm,thinkingModeDefault:e.subagent?.thinkingMode,staleReadInvalidation:e.staleReadInvalidation,allTools:()=>U.agent?.allTools??ot,debug:e.debug,getFocuses:()=>P.getActiveFocuses(),getSchema:()=>Te()?.schema??null,getBind:()=>Te()?.bind,tracker:gt,guardMiddleware:kt.length?kt:void 0,getVfsFiles:dt?()=>T.files:void 0,enterDataScope:Se?.enterScope?e=>Se.enterScope(e):void 0,exitDataScope:Se?.exitScope?e=>Se.exitScope(e):void 0,onUsage:e=>{o.prompt_tokens=(o.prompt_tokens??0)+(e.prompt_tokens??0),o.completion_tokens=(o.completion_tokens??0)+(e.completion_tokens??0),o.total_tokens=(o.total_tokens??0)+(e.total_tokens??0),e.reasoning_tokens&&(o.reasoning_tokens=(o.reasoning_tokens??0)+e.reasoning_tokens)},timeoutMs:e.subagent?.timeoutMs,...Mt?{componentLock:Mt,resolveComponents:e=>Ev(e,bv(Te()?.bind,fe))}:{}}):void 0,It=Ft?Ft.controller:null,Lt=t=>{let n=t.thinkingMode??e.subagent?.thinkingMode,r=n?xy(t.llm??e.llm)?`instance-noop`:`applied`:`inherited`;return{...t,...n?{thinkingMode:n}:{},thinkingApplied:r}},Rt=[`read`,`fetch_document`],zt=ot.filter(e=>Rt.includes(e.name)),Bt=bt?Dg({check:e.verify.check??Ng({schemas:()=>Te()?{"":Te().schema}:{},root:()=>Te()?.bind}),adversarial:e.verify?.adversarial?{llm:e.llm,tools:zt}:void 0}):void 0,Vt=xt?qg({contextWindow:m.contextWindow,thresholdRatio:_b(e,m.contextWindow).summaryThresholdRatio}):void 0,Ht=TC({...B,humanConfirm:Ye,screenshot:!!Pe,domEdit:B.domEdit,hasActions:!!e.actions&&Object.keys(e.actions).length>0,hasProposals:!!e.proposals,viewImage:!!Ne,subagents:ue?.map(Lt)},ge&&!!F,{promptSoftCap:Th(m.contextWindow,h.promptSoftCapTokens)}),Ut=B.pageContext?DC({getPageInfo:()=>typeof document<`u`&&typeof location<`u`?{title:document.title||``,url:location.href}:null,canReadPage:B.domInspect===!0}):void 0,Wt={epoch:0,notices:[],readsInvalidated:0},Gt=0,Kt={name:`hostNotice`,beforeAgent:()=>{Gt=Wt.epoch},wrapModelCall:async(e,t)=>{if(Le){Le=!1;let t=Bd(e.messages,`agent 已通过 dom_edit 修改页面,此前读取为改前状态`,Ge);if(t.invalidatedCount>0){for(let n=0;n<t.messages.length;n++)e.messages[n]=t.messages[n];U.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`dom_edit_read_invalidated`,count:t.invalidatedCount}})}}if(Wt.epoch>Gt){Gt=Wt.epoch;let t=Wt.notices[Wt.notices.length-1]??``,n=Bd(e.messages,t||void 0,Ge);if(n.invalidatedCount>0){for(let t=0;t<n.messages.length;t++)e.messages[t]=n.messages[t];Wt.readsInvalidated+=n.invalidatedCount,U.agent?.debugLogs?.value?.push({timestamp:Date.now(),type:`middleware`,data:{stage:`host_read_invalidated`,count:n.invalidatedCount,epoch:Wt.epoch,reason:t||void 0}})}}return t(e)},augmentPrompt:()=>Wt.notices.length?[`【宿主页面已变更】`,...Wt.notices.filter(Boolean).map(e=>`· ${e}`),B.domInspect===!0?`此前的页面读取/截图结果已过期,回答任何关于当前页面的问题前必须重新 read_page / get_dom 读取当前页面;不要凭此前的读取结果或记忆作答。`:`页面内容可能已变化,断言页面前先核实当前状态;不要凭此前的印象作答。`].join(`
 `):void 0,afterAgent:()=>{Wt.notices.length=0}},qt=Be?{name:`proposalNotice`,augmentPrompt:()=>Be.state.notices.length?[`【内容提案裁决结果】(以此为准,不要凭提案前状态作答)`,...Be.state.notices].join(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "page-agent-sdk",
-  "version": "4.26.1",
+  "version": "4.26.2",
   "type": "module",
   "description": "AI agent SDK for web pages — embed a chat assistant that edits page data via schema-validated tools. A lighter, framework-agnostic alternative to CopilotKit/LangChain for in-page JSON-editing agents. Vue-bundled; works with DeepSeek, OpenAI, MCP.",
   "main": "./dist/page-agent-sdk.umd.cjs",

package/types/headless.d.ts

@@ -983,6 +983,8 @@ export interface ActionDef {
   run: (args: Record<string, unknown>) => unknown | Promise<unknown>;
   /** 可选参数 schema(ZodObject);不传 = 无参 tool */
   params?: any;
+  /** params 的别名:与 defineTool 的 schema 同名同义(消除两入口命名分叉);两者同给时 params 优先 */
+  schema?: any;
   /** 标记本 action 读取宿主态(4.20+):旧工具结果随 `sdk.notifyHostChange()` 替换为过期占位(修前仅 read_page 等五个内置页面读工具享受,action 仅靠 reason 文案口头告知);页面断言门禁的「页面依据」计数也计入。不标记 = 现行为零变化 */
   readsHostState?: boolean;
   /** 标记本 action 的效果延迟到用户确认才生效(提案类,4.20+):调用成功 ≠ 已写入 → 零工具门禁事实清单对此类调用注记「待用户确认后才生效」,防模型收口「已修改完成」;等效写计数不含此类。不标记 = 现行为零变化 */

package/types/index.d.ts

@@ -1353,6 +1353,8 @@ export interface ActionDef {
   run: (args: Record<string, unknown>) => unknown | Promise<unknown>;
   /** 可选参数 schema(ZodObject);不传 = 无参 tool */
   params?: any;
+  /** params 的别名:与 defineTool 的 schema 同名同义(消除两入口命名分叉);两者同给时 params 优先 */
+  schema?: any;
   /** 标记本 action 读取宿主态(4.20+):旧工具结果随 `sdk.notifyHostChange()` 替换为过期占位(修前仅 read_page 等五个内置页面读工具享受,action 仅靠 reason 文案口头告知);页面断言门禁的「页面依据」计数也计入。不标记 = 现行为零变化 */
   readsHostState?: boolean;
   /** 标记本 action 的效果延迟到用户确认才生效(提案类,4.20+):调用成功 ≠ 已写入 → 零工具门禁事实清单对此类调用注记「待用户确认后才生效」,防模型收口「已修改完成」;等效写计数不含此类。不标记 = 现行为零变化 */