page-agent-sdk 4.8.3 → 4.9.0

package/dist/page-agent-sdk.js

@@ -4569,7 +4569,7 @@ function ql(e, t) {
 		code: "SCHEMA_INVALID",
 		path: e,
 		message: `值不符合 "${e}" 的 schema(${t.length} 处问题)`,
-		hint: `用 read({jsonPath:"${e}"}) 查看当前值,按 describe_data() 查看主数据 schema,修正后重试;改大对象优先用 write 的 patch 增量(只发改动部分)`,
+		hint: `用 read({jsonPath:"${e}"}) 查看当前值,按 schema_data() 查看主数据 schema,修正后重试;改大对象优先用 write 的 patch 增量(只发改动部分)`,
 		details: Kl(t)
 	});
 }
@@ -4947,17 +4947,8 @@ function zu(e) {
 	return !0;
 }
 //#endregion
-//#region src/core/harness/writeGate.ts
-function Bu(e, t, n) {
-	if (!e || !n || n.status === "error" || t && t.dryRun === !0) return !1;
-	let r = "writeCapable" in e ? e.writeCapable : void 0;
-	if (!(typeof r == "function" ? r(t ?? {}) : r === !0)) return !1;
-	let i = String(n.content || "");
-	return !(i.startsWith("ERROR:") || i.includes("未写入") || i.includes("无需删除"));
-}
-//#endregion
 //#region src/core/tools/sandbox.ts
-function Vu(e) {
+function Bu(e) {
 	let t = (t, n) => {
 		try {
 			Object.defineProperty(e, t, {
@@ -4985,7 +4976,7 @@ function Vu(e) {
 		});
 	} catch {}
 }
-var Hu = `(${Vu.toString()})(self);`, Uu = [
+var Vu = `(${Bu.toString()})(self);`, Hu = [
 	{
 		re: /\bimport\s*\(/,
 		msg: "动态 import() 拉外网模块"
@@ -5031,17 +5022,17 @@ var Hu = `(${Vu.toString()})(self);`, Uu = [
 		msg: "沙箱脚本不允许反射访问"
 	}
 ];
-function Wu(e) {
+function Uu(e) {
 	return /\breturn\b/.test(e) ? e : `return (${e})`;
 }
-function Gu(e, t = 3e3) {
+function Wu(e, t = 3e3) {
 	return async (n) => {
-		for (let { re: t, msg: n } of Uu) if (t.test(e)) return {
+		for (let { re: t, msg: n } of Hu) if (t.test(e)) return {
 			ok: !1,
 			error: `沙箱拒绝执行:脚本含禁用模式(${n})`,
 			elapsedMs: 0
 		};
-		let r = Wu(e);
+		let r = Uu(e);
 		return new Promise((e) => {
 			let i = Date.now(), a = !1, o = (t) => {
 				if (!a) {
@@ -5054,7 +5045,7 @@ function Gu(e, t = 3e3) {
 						elapsedMs: Date.now() - i
 					});
 				}
-			}, s = Hu + "\nself.onmessage = async (e) => {\n  try {\n    const fn = new Function(\"data\", e.data.script);\n    try { self.eval = undefined; self.Function = undefined; } catch {}\n    let result = fn(e.data.data);\n    if (result && typeof result.then === \"function\") result = await result;\n    self.postMessage({ ok: true, result });\n  } catch (err) {\n    self.postMessage({ ok: false, error: String((err && err.message) || err) });\n  }\n};", c = "", l;
+			}, s = Vu + "\nself.onmessage = async (e) => {\n  try {\n    const fn = new Function(\"data\", e.data.script);\n    try { self.eval = undefined; self.Function = undefined; } catch {}\n    let result = fn(e.data.data);\n    if (result && typeof result.then === \"function\") result = await result;\n    self.postMessage({ ok: true, result });\n  } catch (err) {\n    self.postMessage({ ok: false, error: String((err && err.message) || err) });\n  }\n};", c = "", l;
 			try {
 				let e = new Blob([s], { type: "application/javascript" });
 				c = URL.createObjectURL(e), l = new Worker(c);
@@ -5090,8 +5081,8 @@ function Gu(e, t = 3e3) {
 }
 //#endregion
 //#region src/core/tools/dataSlotQuery.ts
-var Ku = /[\w$-]/;
-function qu(e) {
+var Gu = /[\w$-]/;
+function Ku(e) {
 	let t = [], n = e.trim(), r = +(n[0] === "$");
 	for (; r < n.length;) {
 		let e = n[r];
@@ -5102,7 +5093,7 @@ function qu(e) {
 					continue;
 				}
 				let e = "";
-				for (; r < n.length && Ku.test(n[r]);) e += n[r++];
+				for (; r < n.length && Gu.test(n[r]);) e += n[r++];
 				if (!e) throw Error("JSONPath: .. 后缺属性名");
 				t.push({
 					type: "descendKey",
@@ -5115,7 +5106,7 @@ function qu(e) {
 				continue;
 			}
 			let e = "";
-			for (; r < n.length && Ku.test(n[r]);) e += n[r++];
+			for (; r < n.length && Gu.test(n[r]);) e += n[r++];
 			if (!e) throw Error("JSONPath: . 后缺属性名");
 			t.push({
 				type: "key",
@@ -5171,7 +5162,7 @@ function qu(e) {
 	}
 	return t;
 }
-function Ju(e) {
+function qu(e) {
 	let t = [], n = 0, r = e.trim();
 	for (; n < r.length;) {
 		let e = r[n];
@@ -5216,7 +5207,7 @@ function Ju(e) {
 	}
 	return t;
 }
-var Yu = class {
+var Ju = class {
 	toks;
 	item;
 	pos = 0;
@@ -5252,12 +5243,12 @@ var Yu = class {
 			return this.next(), e;
 		}
 		let e = this.operand(), t = this.peek();
-		return t === "==" || t === "!=" || t === "<" || t === "<=" || t === ">" || t === ">=" ? (this.next(), Qu(t, e, this.operand())) : Xu(e);
+		return t === "==" || t === "!=" || t === "<" || t === "<=" || t === ">" || t === ">=" ? (this.next(), Zu(t, e, this.operand())) : Yu(e);
 	}
 	operand() {
 		let e = this.next();
 		if (e === void 0) throw Error("过滤表达式:缺操作数");
-		if (e.startsWith("@")) return Zu(e, this.item);
+		if (e.startsWith("@")) return Xu(e, this.item);
 		if (e[0] === "'" || e[0] === "\"") return e.slice(1, -1);
 		if (e === "true") return !0;
 		if (e === "false") return !1;
@@ -5267,10 +5258,10 @@ var Yu = class {
 		throw Error(`过滤表达式:未知操作数 '${e}'`);
 	}
 };
-function Xu(e) {
+function Yu(e) {
 	return !!e && e !== 0 && e !== "" && e !== null;
 }
-function Zu(e, t) {
+function Xu(e, t) {
 	let n = e.split(".").filter((e) => e && e !== "@"), r = t;
 	for (let e of n) {
 		if (typeof r != "object" || !r) return;
@@ -5278,7 +5269,7 @@ function Zu(e, t) {
 	}
 	return r;
 }
-function Qu(e, t, n) {
+function Zu(e, t, n) {
 	switch (e) {
 		case "==": return t === n;
 		case "!=": return t !== n;
@@ -5289,47 +5280,47 @@ function Qu(e, t, n) {
 		default: return !1;
 	}
 }
-function $u(e, t) {
-	return new Yu(Ju(e), t).parse();
+function Qu(e, t) {
+	return new Ju(qu(e), t).parse();
 }
-function ed(e, t) {
+function $u(e, t) {
 	return e ? `${e}.${t}` : String(t);
 }
-function td(e, t) {
+function ed(e, t) {
 	let n = [{
 		path: "",
 		value: e
 	}];
-	for (let e of qu(t)) {
+	for (let e of Ku(t)) {
 		let t = [];
 		if (e.type === "key") for (let r of n) r.value != null && typeof r.value == "object" && e.key in r.value && t.push({
-			path: ed(r.path, e.key),
+			path: $u(r.path, e.key),
 			value: r.value[e.key]
 		});
 		else if (e.type === "index") {
 			for (let r of n) if (Array.isArray(r.value)) {
 				let n = r.value[e.index];
 				e.index >= 0 && e.index < r.value.length && t.push({
-					path: ed(r.path, e.index),
+					path: $u(r.path, e.index),
 					value: n,
 					index: e.index
 				});
 			}
 		} else if (e.type === "wildcard") {
 			for (let e of n) if (Array.isArray(e.value)) e.value.forEach((n, r) => t.push({
-				path: ed(e.path, r),
+				path: $u(e.path, r),
 				value: n,
 				index: r
 			}));
 			else if (e.value != null && typeof e.value == "object") for (let n of Object.keys(e.value)) t.push({
-				path: ed(e.path, n),
+				path: $u(e.path, n),
 				value: e.value[n]
 			});
 		} else if (e.type === "descendKey") {
 			let r = e.key, i = (e) => {
 				if (!(e.value == null || typeof e.value != "object")) for (let n of Object.keys(e.value)) {
 					let a = {
-						path: ed(e.path, n),
+						path: $u(e.path, n),
 						value: e.value[n]
 					};
 					n === r && t.push(a), i(a);
@@ -5340,7 +5331,7 @@ function td(e, t) {
 			let e = (n) => {
 				if (!(n.value == null || typeof n.value != "object")) for (let r of Object.keys(n.value)) {
 					let i = {
-						path: ed(n.path, r),
+						path: $u(n.path, r),
 						value: n.value[r]
 					};
 					t.push(i), e(i);
@@ -5349,16 +5340,16 @@ function td(e, t) {
 			for (let t of n) e(t);
 		} else if (e.type === "filter") {
 			for (let r of n) if (Array.isArray(r.value)) r.value.forEach((n, i) => {
-				$u(e.filter, n) && t.push({
-					path: ed(r.path, i),
+				Qu(e.filter, n) && t.push({
+					path: $u(r.path, i),
 					value: n,
 					index: i
 				});
 			});
 			else if (r.value != null && typeof r.value == "object") for (let n of Object.keys(r.value)) {
 				let i = r.value[n];
-				$u(e.filter, i) && t.push({
-					path: ed(r.path, n),
+				Qu(e.filter, i) && t.push({
+					path: $u(r.path, n),
 					value: i
 				});
 			}
@@ -5367,7 +5358,7 @@ function td(e, t) {
 	}
 	return n;
 }
-function nd(e, t) {
+function td(e, t) {
 	let n = e.length, r = t.length;
 	if (!n) return r;
 	if (!r) return n;
@@ -5383,7 +5374,7 @@ function nd(e, t) {
 	}
 	return i[r];
 }
-function rd(e, t, n = {}) {
+function nd(e, t, n = {}) {
 	let r = n.mode || "substring", i = n.limit ?? 50, a = n.matchKey !== !1, o = [], s = null;
 	if (r === "regex") try {
 		s = new RegExp(t, "i");
@@ -5393,11 +5384,11 @@ function rd(e, t, n = {}) {
 	let c = (e, l, u) => {
 		if (o.length >= i || e == null) return;
 		if (typeof e == "object") {
-			if (Array.isArray(e)) e.forEach((e, t) => c(e, ed(l, t), String(t)));
-			else for (let t of Object.keys(e)) c(e[t], ed(l, t), t);
+			if (Array.isArray(e)) e.forEach((e, t) => c(e, $u(l, t), String(t)));
+			else for (let t of Object.keys(e)) c(e[t], $u(l, t), t);
 			return;
 		}
-		let d = String(e), f = id(d, t, r, n.fuzzyThreshold ?? 2, s);
+		let d = String(e), f = rd(d, t, r, n.fuzzyThreshold ?? 2, s);
 		if (f) {
 			o.push({
 				path: l,
@@ -5408,7 +5399,7 @@ function rd(e, t, n = {}) {
 			return;
 		}
 		if (a && u) {
-			let e = id(u, t, r, n.fuzzyThreshold ?? 2, s);
+			let e = rd(u, t, r, n.fuzzyThreshold ?? 2, s);
 			e && o.push({
 				path: l,
 				key: u,
@@ -5419,65 +5410,65 @@ function rd(e, t, n = {}) {
 	};
 	return c(e, ""), o;
 }
-function id(e, t, n, r, i) {
+function rd(e, t, n, r, i) {
 	let a = e.toLowerCase(), o = t.toLowerCase();
 	if (n === "substring") return a.includes(o) ? 1 : null;
 	if (n === "regex") return i && i.test(e) ? 1 : null;
 	if (n === "fuzzy") {
 		if (a.includes(o)) return 2;
-		let e = nd(a, o);
+		let e = td(a, o);
 		return e <= r ? r - e + 1 : null;
 	}
 	return null;
 }
-function ad(e, t, n = 3e3) {
-	return Gu(t, n)(e);
+function id(e, t, n = 3e3) {
+	return Wu(t, n)(e);
 }
 //#endregion
 //#region src/core/harness/readInvalidation.ts
-var od = "", sd = "根(整体)", cd = /* @__PURE__ */ new Set([
+var ad = "", od = "根(整体)", sd = /* @__PURE__ */ new Set([
 	"read",
 	"query_data",
 	"search_data"
-]), ld = /* @__PURE__ */ new Set(["resource_update", "resource_delete"]), ud = /* @__PURE__ */ new Set(["remove", "move"]);
-function dd(e) {
+]), cd = /* @__PURE__ */ new Set(["resource_update", "resource_delete"]), ld = /* @__PURE__ */ new Set(["remove", "move"]);
+function ud(e) {
 	let t = String(e).trim();
-	return t === "(root)" || t === "$" ? od : (t.startsWith("$.") ? t = t.slice(2) : t.startsWith("$") && (t = t.slice(1)), t = t.replace(/\[(\d+)\]/g, ".$1"), t);
+	return t === "(root)" || t === "$" ? ad : (t.startsWith("$.") ? t = t.slice(2) : t.startsWith("$") && (t = t.slice(1)), t = t.replace(/\[(\d+)\]/g, ".$1"), t);
 }
-function fd(e) {
-	let t = dd(e);
-	return t === od ? sd : t;
+function dd(e) {
+	let t = ud(e);
+	return t === ad ? od : t;
 }
-function pd(e) {
+function fd(e) {
 	let t = Math.max(e.lastIndexOf("."), e.lastIndexOf("["));
-	return t <= 0 ? od : e.slice(0, t);
+	return t <= 0 ? ad : e.slice(0, t);
 }
-function md(e, t) {
-	let n = dd(e), r = dd(t);
-	return n === od || r === od || n === r || n.startsWith(r + ".") || n.startsWith(r + "[") || r.startsWith(n + ".") || r.startsWith(n + "[");
+function pd(e, t) {
+	let n = ud(e), r = ud(t);
+	return n === ad || r === ad || n === r || n.startsWith(r + ".") || n.startsWith(r + "[") || r.startsWith(n + ".") || r.startsWith(n + "[");
 }
-function hd(e) {
-	if (!e) return od;
+function md(e) {
+	if (!e) return ad;
 	try {
 		let t = [];
-		for (let n of qu(e)) if (n.type === "key" && n.key) t.push(n.key);
+		for (let n of Ku(e)) if (n.type === "key" && n.key) t.push(n.key);
 		else if (n.type === "index" && n.index !== void 0) t.push(String(n.index));
 		else break;
-		return t.length ? t.join(".") : od;
+		return t.length ? t.join(".") : ad;
 	} catch {
-		return od;
+		return ad;
 	}
 }
-function gd(e, t) {
+function hd(e, t) {
 	let n = t || {};
-	if (e === "query_data") return (Array.isArray(n.queries) && n.queries.length ? n.queries.map(String) : [String(n.expr || "")]).map((e) => hd(e));
-	if (e === "search_data") return [od];
+	if (e === "query_data") return (Array.isArray(n.queries) && n.queries.length ? n.queries.map(String) : [String(n.expr || "")]).map((e) => md(e));
+	if (e === "search_data") return [ad];
 	let r = [];
 	if (typeof n.jsonPath == "string" && n.jsonPath && r.push(n.jsonPath), Array.isArray(n.jsonPaths)) for (let e of n.jsonPaths) typeof e == "string" && e && r.push(e);
-	return r.length ? r.map(dd) : [od];
+	return r.length ? r.map(ud) : [ad];
 }
-function _d(e) {
-	if (ld.has(e.name)) return null;
+function gd(e) {
+	if (cd.has(e.name)) return null;
 	let t = e.args || {}, n = t.del === !0, r = [];
 	if (n) r.push({
 		path: String(t.patch?.jsonPath ?? t.jsonPath ?? ""),
@@ -5499,15 +5490,15 @@ function _d(e) {
 		path: t.path,
 		op: "set"
 	}) : r.push({
-		path: od,
+		path: ad,
 		op: "set"
 	});
 	let i = /* @__PURE__ */ new Set();
 	for (let { path: e, op: t, value: n } of r) {
-		let r = dd(e);
-		if (i.add(r), ud.has(t) && i.add(pd(r)), t === "move" && typeof n == "string" && n) {
-			let e = dd(n);
-			i.add(e), i.add(pd(e));
+		let r = ud(e);
+		if (i.add(r), ld.has(t) && i.add(fd(r)), t === "move" && typeof n == "string" && n) {
+			let e = ud(n);
+			i.add(e), i.add(fd(e));
 		}
 	}
 	return {
@@ -5516,12 +5507,12 @@ function _d(e) {
 		callIndex: e.callIndex
 	};
 }
-function vd(e, t, n, r) {
-	let i = e.map(fd).join("、"), a = [...new Set(n.flatMap((e) => e.paths))].map(fd).join("、"), o = [`⏱[过期快照] 此前读取 ${i} 的结果已失效(${r === void 0 ? `已写入 ${a}` : `第 ${r} 轮写入了 ${a}`})。`];
+function _d(e, t, n, r) {
+	let i = e.map(dd).join("、"), a = [...new Set(n.flatMap((e) => e.paths))].map(dd).join("、"), o = [`⏱[过期快照] 此前读取 ${i} 的结果已失效(${r === void 0 ? `已写入 ${a}` : `第 ${r} 轮写入了 ${a}`})。`];
 	return n.some((e) => e.hasPostValue) ? o.push(`该轮写入结果已含 ${a} 最新值与新 hash,直接引用即可;原读取结果整体已过期,未提及路径需引用时按下方指引重读/重跑。`) : o.push("原读取结果整体已过期(含未触及的兄弟路径),需引用时按下方指引重读/重跑。"), t === "query_data" || t === "search_data" ? o.push(`需当前结果时重跑 ${t}(表达式/条件不变即可)。`) : o.push(`需当前精确值时再 read(建议窄读:${i})。`), o.join("\n");
 }
-function yd(e, t, n = {}) {
-	let r = n.maxParallelTools ?? 1, i = t.map((e) => _d(e)).filter((e) => e !== null);
+function vd(e, t, n = {}) {
+	let r = n.maxParallelTools ?? 1, i = t.map((e) => gd(e)).filter((e) => e !== null);
 	if (!i.length || !e.length) return {
 		messages: e,
 		invalidatedCount: 0,
@@ -5556,11 +5547,11 @@ function yd(e, t, n = {}) {
 				let e = n.name;
 				r = e ? l.find((t) => !t.used && t.name === e) : l.find((e) => !e.used);
 			}
-			r && (r.used = !0, cd.has(r.name) && c.push({
+			r && (r.used = !0, sd.has(r.name) && c.push({
 				aiIndex: u,
 				callIndex: r.callIndex,
 				name: r.name,
-				paths: gd(r.name, r.args),
+				paths: hd(r.name, r.args),
 				msgIndex: t
 			}));
 		}
@@ -5569,11 +5560,11 @@ function yd(e, t, n = {}) {
 	for (let t of c) {
 		let a = e[t.msgIndex];
 		if (String(a.content ?? "").startsWith("⏱[过期快照]")) continue;
-		let c = i.filter((e) => e.paths.some((e) => t.paths.some((t) => md(t, e))));
+		let c = i.filter((e) => e.paths.some((e) => t.paths.some((t) => pd(t, e))));
 		if (!c.length) continue;
 		let l;
 		if (l = t.aiIndex !== s || r > 1 || c.some((e) => e.callIndex === void 0 || t.callIndex < e.callIndex), !l) continue;
-		let u = vd(t.paths, t.name, c, n.round);
+		let u = _d(t.paths, t.name, c, n.round);
 		d ||= e.slice(), d[t.msgIndex] = new o({
 			tool_call_id: a.tool_call_id ?? "",
 			name: a.name,
@@ -5591,47 +5582,51 @@ function yd(e, t, n = {}) {
 }
 //#endregion
 //#region src/core/harness/actionGate.ts
-var bd = /(改|改掉|改成|修改|更新|加|添加|新增|加上|删|删掉|删除|移除|移|移动|换|替换|调|调整|调换|生成|创建|做|做个|做一个|建|搭建|重建|重新|清空|设置|配置|美化|优化|排版|布置|填充|写入|保存|发布|上线|部署)/, xd = /(看看|看一下|查|查一下|查询|了解|了解下|说说|讲讲|解释|解释下|总结|总结一下|对比|对比一下|确认|确认一下|核对|检查|检查一下|看看有没有|帮我看看|review|Review)/, Sd = /(不用改|不用动|只是问|只是想问|先别动|先不要|不用写入|不要保存|只是确认|告诉我即可|不用执行)/, Cd = /^(use_|spawn_agent|spawn_agents)/;
-function wd(e) {
+var yd = /(改|改掉|改成|修改|更新|加|添加|新增|加上|删|删掉|删除|移除|移|移动|换|替换|调|调整|调换|生成|创建|做|做个|做一个|建|搭建|重建|重新|清空|设置|配置|美化|优化|排版|布置|填充|写入|保存|发布|上线|部署)/, bd = /(看看|看一下|查|查一下|查询|了解|了解下|说说|讲讲|解释|解释下|总结|总结一下|对比|对比一下|确认|确认一下|核对|检查|检查一下|看看有没有|帮我看看|review|Review)/, xd = /(不用改|不用动|只是问|只是想问|先别动|先不要|不用写入|不要保存|只是确认|告诉我即可|不用执行)/, Sd = /^(use_|spawn_agent|spawn_agents)/;
+function Cd(e) {
 	let t = (e || "").trim();
-	if (!t || Sd.test(t) || /(吗|呢)[?？]?\s*$/.test(t) || /[?？]\s*$/.test(t)) return !1;
+	if (!t || xd.test(t) || /(吗|呢)[?？]?\s*$/.test(t) || /[?？]\s*$/.test(t)) return !1;
 	let n = (t.split(/[。！？；，!?;,\n]/)[0] ?? t).slice(0, 16);
-	return !xd.test(n) && bd.test(n);
+	return !bd.test(n) && yd.test(n);
 }
-function Td(e, t) {
-	for (let [n, r] of Object.entries(e.counts)) if (!(r <= 0) && (t(n) || Cd.test(n))) return !1;
+function wd(e, t) {
+	for (let [n, r] of Object.entries(e.counts)) if (!(r <= 0) && (t(n) || Sd.test(n) && r - (e.rejectedDelegations?.[n] ?? 0) > 0)) return !1;
 	return !0;
 }
-function Ed(e, t, n = () => !1) {
-	let r = Object.entries(e.counts).filter(([e, t]) => t > 0 || n(e)).map(([e, t]) => `${e}×${t}`);
+function Td(e, t, n = () => !1) {
+	let r = Object.entries(e.counts).filter(([e, t]) => t > 0 || n(e)).map(([t, n]) => {
+		let r = e.rejectedDelegations?.[t] ?? 0;
+		return r > 0 && Sd.test(t) ? `${t}×${n}(其中 ${r} 次被拒未生效,如组件锁 COMPONENT_BUSY)` : `${t}×${n}`;
+	});
 	e.counts.write === void 0 && n("write") && r.push("write×0");
 	let i = r.length ? r.join(", ") : "无", a = e.writePaths.length ? e.writePaths.slice(0, 5).join(", ") + (e.writePaths.length > 5 ? ` 等 ${e.writePaths.length} 处` : "") : "无", o = t?.length ?? 0, s = t?.filter((e) => e.status === "completed").length ?? 0, c = o ? `${s}/${o} 完成` : "无 todos";
 	return `本轮事实:工具调用 ${i};成功写入路径:${a};失败/回灌 ${e.failures};todos:${c}。`;
 }
-var Dd = /(components?\.\d+|child(ren)?\.\d+|[a-zA-Z][a-zA-Z0-9_-]{3,}\.\d+|jsonPath|@ ?"[^"]+"|路径)/;
-function Od(e) {
+var Ed = /(components?\.\d+|child(ren)?\.\d+|[a-zA-Z][a-zA-Z0-9_-]{3,}\.\d+|jsonPath|@ ?"[^"]+"|路径)/;
+function Dd(e) {
 	return [
 		"⚠️ 这条指令看起来需要改动数据,但本轮没有任何写入或委派操作。",
 		`${e}`,
 		"如果确实已完成:请在回复中逐项说明改动位置(jsonPath / 组件 id),与上述事实对账;",
 		"如果尚未完成:请继续执行(用 write 增量改 / 委派对应子 agent);",
+		"如果委派被组件锁拒绝(COMPONENT_BUSY/COMPONENT_LOCKED):说明在途委派占用,等其结束后重试,勿谎称已完成;",
 		"如果做不到或需要用户决定:请如实说明原因,不要回复「已完成」。"
 	].join("\n");
 }
-function kd(e) {
-	return Dd.test(e || "");
+function Od(e) {
+	return Ed.test(e || "");
+}
+var kd = /(写到了哪|写到哪|在哪写|什么位置|完成了吗|完成没|做完了吗|做好了|好了吗|搞定了吗|生成了吗|改好了吗|改完了吗|保存了吗|写入了吗|写入了没有|有没有写入|有没有保存|现在的?(页面|数据|状态|内容)|当前(页面|数据|状态)|进度如何|进度怎么样|什么状态)/, Ad = /(已写入|已保存|已添加|已删除|已修改|已更新|已设置|已生成|已创建|已搭建|已删除|已经写入|已经完成|全部完成|全部搞定)/;
+function jd(e) {
+	return kd.test((e || "").trim());
 }
-var Ad = /(写到了哪|写到哪|在哪写|什么位置|完成了吗|完成没|做完了吗|做好了|好了吗|搞定了吗|生成了吗|改好了吗|改完了吗|保存了吗|写入了吗|写入了没有|有没有写入|有没有保存|现在的?(页面|数据|状态|内容)|当前(页面|数据|状态)|进度如何|进度怎么样|什么状态)/, jd = /(已写入|已保存|已添加|已删除|已修改|已更新|已设置|已生成|已创建|已搭建|已删除|已经写入|已经完成|全部完成|全部搞定)/;
 function Md(e) {
-	return Ad.test((e || "").trim());
+	return Ad.test(e || "");
 }
 function Nd(e) {
-	return jd.test(e || "");
-}
-function Pd(e) {
 	return Object.values(e.counts).every((e) => e <= 0);
 }
-function Fd(e) {
+function Pd(e) {
 	return [
 		"⚠️ 这是关于数据现状的询问,但本轮你没有调用任何工具(含 read)就断言了「已写入/已完成」状态。",
 		`${e}`,
@@ -5639,27 +5634,36 @@ function Fd(e) {
 		"请先用 read / list 类工具核实实际数据再据实回答;若实际未写入,如实说明并继续完成,不要凭印象回复「已完成」。"
 	].join("\n");
 }
-var Id = /(我先|让我先|我先看|先看看|先了解|先加载|先查阅|稍后|接下来我|我将先|等我|查完.{0,12}再|看完.{0,12}再|了解.{0,8}再)/, Ld = /(已完成|已生成|已修改|已创建|已添加|已删除|已更新|已调整|已处理|已委派|已配置|已切换|成功|完成[。!?]|搞定了|做好了)/;
-function Rd(e) {
+var Fd = /(我先|让我先|我先看|先看看|先了解|先加载|先查阅|稍后|接下来我|我将先|等我|查完.{0,12}再|看完.{0,12}再|了解.{0,8}再)/, Id = /(已完成|已生成|已修改|已创建|已添加|已删除|已更新|已调整|已处理|已委派|已配置|已切换|成功|完成[。!?]|搞定了|做好了)/;
+function Ld(e) {
 	if (!e) return !1;
 	let t = e.trim();
-	return t.length > 160 || Ld.test(t) ? !1 : Id.test(t);
+	return t.length > 160 || Id.test(t) ? !1 : Fd.test(t);
 }
-var zd = /(add_component|delete_component|move_component|list_components|select_component|load_skill|use_[a-z]+|rag_[a-z]+|request_human_confirmation|\bwrite\b|\bread\b)/, Bd = /(我来|让我|我先|现在|开始|先加载|先添加|先写|先删|先看看|执行|添加|写入|加载|删除)/;
-function Vd(e) {
+var Rd = /(add_component|delete_component|move_component|list_components|select_component|load_skill|use_[a-z]+|rag_[a-z]+|request_human_confirmation|\bwrite\b|\bread\b)/, zd = /(我来|让我|我先|现在|开始|先加载|先添加|先写|先删|先看看|执行|添加|写入|加载|删除)/;
+function Bd(e) {
 	if (!e) return !1;
 	let t = e.trim();
-	return zd.test(t) && Bd.test(t);
+	return Rd.test(t) && zd.test(t);
 }
-function Hd(e) {
+function Vd(e) {
 	if (!e) return [];
 	let t = String(e).replace(/\$\.?/g, " ").replace(/\[(\d+)\]/g, ".$1"), n = [];
 	for (let e of t.matchAll(/[A-Za-z_][\w-]*(?:\.[A-Za-z_][\w-]*|\.\d+)+/g)) n.push(e[0]);
 	return [...new Set(n)];
 }
-function Ud(e, t) {
+function Hd(e, t) {
 	let n = Array.from(t);
-	return n.length ? e.some((e) => n.some((t) => md(e, t))) : !1;
+	return n.length ? e.some((e) => n.some((t) => pd(e, t))) : !1;
+}
+//#endregion
+//#region src/core/harness/writeGate.ts
+function Ud(e, t, n) {
+	if (!e || !n || n.status === "error" || t && t.dryRun === !0) return !1;
+	let r = "writeCapable" in e ? e.writeCapable : void 0;
+	if (!(typeof r == "function" ? r(t ?? {}) : r === !0)) return !1;
+	let i = String(n.content || "");
+	return !(i.startsWith("ERROR:") || i.includes("未写入") || i.includes("无需删除"));
 }
 //#endregion
 //#region src/core/harness/todos.ts
@@ -5795,7 +5799,7 @@ var Zd = 2, Qd = 2, $d = 2, ef = 2;
 function tf(e) {
 	let { state: t, garbled: n, rounds: r } = e, i = e.finalContent;
 	if (n) return null;
-	let a = !/[?？]\s*$/.test(i.trim()) && (r > 0 ? Rd(i) : Vd(i));
+	let a = !/[?？]\s*$/.test(i.trim()) && (r > 0 ? Ld(i) : Bd(i));
 	if (t.transitionalRetries < Zd && a) return t.transitionalRetries += 1, {
 		kind: "feedback",
 		gate: {
@@ -5846,38 +5850,38 @@ function tf(e) {
 			break;
 		}
 	}
-	if (t.zeroToolRetries < $d && Td(e.turnUsage, e.isWriteToolByName) && wd(s) && !kd(i) && !/[?？]\s*$/.test(i.trim())) {
+	if (t.zeroToolRetries < $d && wd(e.turnUsage, e.isWriteToolByName) && Cd(s) && !Od(i) && !/[?？]\s*$/.test(i.trim())) {
 		t.zeroToolRetries += 1;
-		let n = Ed(e.turnUsage, e.todos, e.isWriteToolByName);
+		let n = Td(e.turnUsage, e.todos, e.isWriteToolByName);
 		return {
 			kind: "feedback",
 			gate: {
 				stage: "zero_tool_gate",
 				attempt: t.zeroToolRetries,
-				feedback: Od(n),
+				feedback: Dd(n),
 				logData: { factSheet: n }
 			}
 		};
 	}
-	if (t.zeroToolRetries < $d && Pd(e.turnUsage) && Md(s) && Nd(i)) {
+	if (t.zeroToolRetries < $d && Nd(e.turnUsage) && jd(s) && Md(i)) {
 		t.zeroToolRetries += 1;
-		let n = Ed(e.turnUsage, e.todos, e.isWriteToolByName);
+		let n = Td(e.turnUsage, e.todos, e.isWriteToolByName);
 		return {
 			kind: "feedback",
 			gate: {
 				stage: "status_query_gate",
 				attempt: t.zeroToolRetries,
-				feedback: Fd(n),
+				feedback: Pd(n),
 				logData: { factSheet: n }
 			}
 		};
 	}
-	return t.zeroToolRetries >= $d && Td(e.turnUsage, e.isWriteToolByName) && wd(s) ? {
+	return t.zeroToolRetries >= $d && wd(e.turnUsage, e.isWriteToolByName) && Cd(s) ? {
 		kind: "observable",
 		obs: {
 			code: "ZERO_TOOL_GATE_EXHAUSTED",
 			message: "操作指令经 2 次回灌后仍以零工具纯文本收尾(疑似谎报完成),已放行;最终回复可能不实",
-			context: { factSheet: Ed(e.turnUsage, e.todos, e.isWriteToolByName) }
+			context: { factSheet: Td(e.turnUsage, e.todos, e.isWriteToolByName) }
 		}
 	} : null;
 }
@@ -5887,8 +5891,8 @@ function nf(e, t, n) {
 		if (e.status !== "completed") return !1;
 		let n = t?.get(e.id);
 		if (n && n.status === "completed" && n.content === e.content) return !1;
-		let i = Hd(e.evidence ?? "");
-		return i.length ? !Ud(i, r) : !1;
+		let i = Vd(e.evidence ?? "");
+		return i.length ? !Hd(i, r) : !1;
 	});
 }
 function rf(e) {
@@ -6618,14 +6622,14 @@ function Df(e) {
 					let t = _[e];
 					if (!t) continue;
 					let n = p[e].call.name;
-					if (f.counts[n] = (f.counts[n] ?? 0) + 1, t.status === "error" && (f.failures += 1), Bu(R.find((e) => e.name === n), p[e].call.args, t)) {
+					if (f.counts[n] = (f.counts[n] ?? 0) + 1, t.status === "error" && (f.failures += 1), Sd.test(n) && String(t.content || "").startsWith("ERROR:") && (f.rejectedDelegations = f.rejectedDelegations ?? {}, f.rejectedDelegations[n] = (f.rejectedDelegations[n] ?? 0) + 1), Ud(R.find((e) => e.name === n), p[e].call.args, t)) {
 						let t = Ef(p[e].call.args);
 						f.writePaths.push(t || "(整体)"), E.push({
 							name: n,
 							args: p[e].call.args,
 							callIndex: e
 						});
-						let r = _d({
+						let r = gd({
 							name: n,
 							args: p[e].call.args,
 							callIndex: e
@@ -6634,7 +6638,7 @@ function Df(e) {
 					}
 				}
 				if (ne && E.length) {
-					let e = yd(c, E, {
+					let e = vd(c, E, {
 						round: x + 1,
 						maxParallelTools: C
 					});
@@ -7871,7 +7875,7 @@ async function lm(e) {
 		};
 		r = t;
 	} else r = e.code;
-	let i = await Gu(r)(void 0);
+	let i = await Wu(r)(void 0);
 	return i.ok ? {
 		ok: !0,
 		text: sm(i.result)
@@ -8196,7 +8200,7 @@ function Pm(e = {}) {
 			let e = C();
 			if (e.length) {
 				let t = e.map((e) => `- ${e.path ? e.path + ": " : ""}${e.description}`).join("\n");
-				S.push("\n【当前可操作数据(动态增删后的最新状态,操作前以 describe_data / read 为准)】", t);
+				S.push("\n【当前可操作数据(动态增删后的最新状态,操作前以 read 为准)】", t);
 			}
 		} catch {}
 		let w = {
@@ -8302,7 +8306,6 @@ function Lm(e) {
 	return !!e && typeof e == "object" && typeof e.invoke == "function" && typeof e.stream == "function";
 }
 var Rm = [
-	"describe_data",
 	"read",
 	"query_data",
 	"search_data",
@@ -8911,7 +8914,6 @@ var fh = /* @__PURE__ */ new Set([
 	"draft_commit",
 	"eval_script"
 ]), ph = /* @__PURE__ */ new Set([
-	"describe_data",
 	"read",
 	"query_data",
 	"search_data",
@@ -9335,7 +9337,7 @@ async function Wh(e, t, n, r) {
 		"你是严格的对抗式审查者,目标是找出以下 AI 助手回复的错误并证明它有问题(事实错误 / 遗漏 / 逻辑矛盾 / 与需求不符)。",
 		`用户需求:${i || "(未明确)"}`,
 		`助手回复:${a}`,
-		o ? "重点检查主数据修改:① jsonPath 是否正确(是否误写不存在的子路径);② 值类型是否符合主数据 schema;③ 语义是否符合字段 description。可用只读工具(read / describe_data 等)读回实际值实证。" : "只报告具体、可验证的问题。",
+		o ? "重点检查主数据修改:① jsonPath 是否正确(是否误写不存在的子路径);② 值类型是否符合主数据 schema;③ 语义是否符合字段 description。可用只读工具(read / schema_data 等)读回实际值实证。" : "只报告具体、可验证的问题。",
 		"若确实无问题,只回复\"无问题\"。"
 	].join("\n"), c = "你是严格的对抗式审查者,只找问题不赞美。目标是反驳,不是改进。", l = n ? (e) => n(e.type, {
 		...e.data,
@@ -10465,7 +10467,7 @@ function Kg(e) {
 			code: "SCHEMA_INVALID",
 			path: e,
 			message: `值不符合 "${e}" 的 schema(${t.length} 处问题)`,
-			hint: `用 read({jsonPath:"${e}"}) 查看当前值,按 describe_data() 查看主数据 schema,修正后重试;改大对象优先用 write 的 patch 增量(只发改动部分)${r}`,
+			hint: `用 read({jsonPath:"${e}"}) 查看当前值,按 schema_data() 查看主数据 schema,修正后重试;改大对象优先用 write 的 patch 增量(只发改动部分)${r}`,
 			details: Kl(t)
 		}) : ql(e, t);
 	}, f = (e) => $({
@@ -10540,16 +10542,16 @@ function Kg(e) {
 			continue;
 		}
 		if (i === "append") {
-			let e = o[m++]?.elems ?? [], r = Dp(n, a);
-			if (typeof r == "string" && typeof e[0] == "string") {
-				let n = e[0], i = Pf(t, a);
+			let e = o[m++]?.elems ?? [], n = Dp(r, a);
+			if (typeof n == "string" && typeof e[0] == "string") {
+				let r = e[0], i = Pf(t, a);
 				if (i.kind === "missing") return {
 					ok: !1,
 					error: f([a]),
 					writeBacks: [],
 					notices: c
 				};
-				let o = r + n;
+				let o = n;
 				if (i.kind !== "open") {
 					let e = i.schemas.map((e) => e.safeParse(o)).find((e) => !e.success);
 					if (e) return {
@@ -10562,7 +10564,7 @@ function Kg(e) {
 				p.push({
 					op: "appendStr",
 					jp: a,
-					str: n
+					str: r
 				});
 				continue;
 			}
@@ -10932,18 +10934,21 @@ function Jg(e) {
 		value: f ?? Ap(t),
 		...l ? { label: l } : {}
 	}); a.length > o;) a.shift();
-	for (let e of b.writeBacks) if (e.op === "remove") kp(t, e.jp);
-	else if (e.op === "set") Op(t, e.jp, e.value);
-	else if (e.op === "move") Vp(t, e.jp, e.toPath);
-	else if (e.op === "mergeKeys") {
-		let n = e.jp ? Dp(t, e.jp) : t;
-		if (n && typeof n == "object" && !Array.isArray(n)) for (let [t, r] of e.entries ?? []) n[t] = r;
-	} else if (e.op === "appendElems") {
-		let n = e.jp ? Dp(t, e.jp) : t;
-		Array.isArray(n) && e.elems?.length && n.push(...e.elems);
-	} else if (e.op === "appendStr") {
-		let n = e.jp ? Dp(t, e.jp) : t;
-		typeof n == "string" && typeof e.str == "string" && Op(t, e.jp, n + e.str);
+	let S = new Set(b.writeBacks.filter((e) => e.op === "set").map((e) => e.jp));
+	for (let e of b.writeBacks) if (!((e.op === "appendElems" || e.op === "appendStr") && S.has(e.jp))) {
+		if (e.op === "remove") kp(t, e.jp);
+		else if (e.op === "set") Op(t, e.jp, e.value);
+		else if (e.op === "move") Vp(t, e.jp, e.toPath);
+		else if (e.op === "mergeKeys") {
+			let n = e.jp ? Dp(t, e.jp) : t;
+			if (n && typeof n == "object" && !Array.isArray(n)) for (let [t, r] of e.entries ?? []) n[t] = r;
+		} else if (e.op === "appendElems") {
+			let n = e.jp ? Dp(t, e.jp) : t;
+			Array.isArray(n) && e.elems?.length && n.push(...e.elems);
+		} else if (e.op === "appendStr") {
+			let n = e.jp ? Dp(t, e.jp) : t;
+			typeof n == "string" && typeof e.str == "string" && Op(t, e.jp, n + e.str);
+		}
 	}
 	return e.internalAfterWrite?.(t, f), Mg(d), s?.(), {
 		ok: !0,
@@ -11049,7 +11054,7 @@ function i_(e) {
 	})(e);
 }
 function a_(e, n = {}) {
-	let r = n.pgIdPaths ?? [], i = n.sandboxRunner ?? ad, a = r.length ? (e, t) => {
+	let r = n.pgIdPaths ?? [], i = n.sandboxRunner ?? id, a = r.length ? (e, t) => {
 		if (t && typeof t == "object") for (let n of r) {
 			let r = Dp(t, n), i = Dp(e, n);
 			if (!Array.isArray(r) || !Array.isArray(i)) continue;
@@ -11263,11 +11268,7 @@ function a_(e, n = {}) {
 	}
 	let se = (e, t = !0) => {
 		e.writeCapable = t;
-	}, ce = s(async () => [`说明: ${l}`, "格式: 写入值需为 JSON,且通过声明的 schema 校验(校验失败时 write 会返回结构化错误,含具体字段与期望类型)。"].join("\n"), {
-		name: "describe_data",
-		description: "获取主数据的说明与格式要求(等价于 read 不传 jsonPath;优先用 read 单一入口)。",
-		schema: t.object({})
-	}), le = s(async ({ id: e }, t) => {
+	}, ce = s(async ({ id: e }, t) => {
 		let n = y(t);
 		if (!h.length) return $({
 			code: "NO_SNAPSHOT",
@@ -11281,23 +11282,67 @@ function a_(e, n = {}) {
 			hint: "用 history_data({list:true}) 查看可用快照序号"
 		});
 		let i = o.safeParse(r.value);
-		return i.success ? (Up(c, Ap(r.value)), N(), P({
-			op: "restore",
-			detail: `#${r.id}`,
-			timestamp: Date.now()
-		}), w(O(), n), `已回退主数据到快照 #${r.id}[${r.op}]${r.label ? `(${r.label})` : ""}。`) : $({
+		if (!i.success) return $({
 			code: "SNAPSHOT_SCHEMA_INVALID",
 			message: `快照 #${r.id} 的值不符合当前 schema,无法回退`,
 			hint: "schema 可能已变更;该快照已过期,选其他快照或重新设置",
 			details: Kl(i.error.issues)
 		});
+		let a = [];
+		if (m && m.resourcesByPath.size) for (let [e] of m.resourcesByPath) {
+			let t = Dp(c, e);
+			kg(t, Dp(r.value, e)) || a.push({
+				p: e,
+				cur: t
+			});
+		}
+		if (!a.length) return Up(c, Ap(r.value)), N(), P({
+			op: "restore",
+			detail: `#${r.id}`,
+			timestamp: Date.now()
+		}), w(O(), n), `已回退主数据到快照 #${r.id}[${r.op}]${r.label ? `(${r.label})` : ""}。`;
+		let s = a.map(({ p: e }) => {
+			let t = Wg(e), n = t ? Dp(c, `${t}.__pgId`) : void 0;
+			return {
+				p: e,
+				parent: t,
+				pgId: typeof n == "string" ? n : void 0
+			};
+		}).map((e) => ({
+			...e,
+			val: e.p ? Dp(c, e.p) : void 0
+		}));
+		Up(c, Ap(r.value));
+		let l = [], u = [];
+		for (let e of s) {
+			let t = e.p.slice(e.p.lastIndexOf(".") + 1), n = e.p;
+			if (e.pgId) {
+				let r = Wg(e.parent), i = r ? Dp(c, r) : c, a = Array.isArray(i) ? i.findIndex((t) => t?.__pgId === e.pgId) : -1;
+				if (a < 0) {
+					u.push(e.p);
+					continue;
+				}
+				n = `${r ? `${r}.${a}` : String(a)}.${t}`;
+			} else if (e.parent && Dp(c, e.parent) === void 0) {
+				u.push(e.p);
+				continue;
+			}
+			e.val === void 0 ? u.push(e.p) : Op(c, n, e.val), l.push(e.p);
+		}
+		N(), P({
+			op: "restore",
+			detail: `#${r.id}(保护字段保留 ${l.length}${u.length ? `,未能回填 ${u.length}` : ""})`,
+			timestamp: Date.now()
+		}), w(O(), n);
+		let d = u.length ? `;⚠ 以下保护字段未能回填当前值(快照窗口内元素已变/已删,保留快照旧值,请由宿主侧核对):${u.join("、")}` : "";
+		return `已回退主数据到快照 #${r.id}[${r.op}]${r.label ? `(${r.label})` : ""}。⚠ 受保护字段保留当前值未回退:${l.join("、")}(freeze/verbatim 由宿主管辖,快照旧值不覆盖;history_data 看到的是快照原值,实际结果以 read 为准)${d}`;
 	}, {
 		name: "restore_data",
 		description: "把主数据回退到某个快照(不传 id 回退最近一次)。快照列表用 history_data({list:true})。",
 		schema: t.object({ id: t.number().int().optional().describe("快照序号;不传回退最近一次") })
 	});
-	se(le);
-	let ue = s(async ({ id: e, jsonPath: t, list: n }) => {
+	se(ce);
+	let le = s(async ({ id: e, jsonPath: t, list: n }) => {
 		if (n) {
 			if (!h.length) return "无快照。set/edit/delete 会自动存快照。";
 			let e = h.map((e) => {
@@ -11342,7 +11387,7 @@ function a_(e, n = {}) {
 			jsonPath: t.string().optional().describe("只看快照的某子路径"),
 			list: t.boolean().optional().describe("true 列出快照时间线(序号/操作/标签/时间/大小)")
 		})
-	}), F = s(async ({ expr: e, queries: t, limit: n }, r) => {
+	}), ue = s(async ({ expr: e, queries: t, limit: n }, r) => {
 		let i = y(r);
 		if (typeof c != "object" || !c) return $({
 			code: "NOT_OBJECT",
@@ -11352,7 +11397,7 @@ function a_(e, n = {}) {
 		let a = u ? Wf(c, o) : c, s = b(r), l = (e) => {
 			let t;
 			try {
-				t = td(a, e);
+				t = ed(a, e);
 			} catch (t) {
 				return $({
 					code: "JSONPATH_SYNTAX",
@@ -11385,13 +11430,13 @@ function a_(e, n = {}) {
 			queries: t.array(t.string()).min(2).max(10).optional().describe("批量模式:2-10 条 JSONPath 一次取回(与 expr 同传按 queries);逐条独立返回,单条失败该项标 error 不整批"),
 			limit: t.number().int().min(1).max(200).optional().describe("返回结果上限(批量时逐条适用),默认 50")
 		})
-	}), I = s(async ({ query: e, mode: t, fuzzyThreshold: n, matchKey: r, limit: i }) => {
+	}), F = s(async ({ query: e, mode: t, fuzzyThreshold: n, matchKey: r, limit: i }) => {
 		if (c == null) return $({
 			code: "EMPTY",
 			message: "主数据为空,无可搜索内容"
 		});
 		try {
-			let a = rd(u ? Wf(c, o) : c, e, {
+			let a = nd(u ? Wf(c, o) : c, e, {
 				mode: t,
 				fuzzyThreshold: n,
 				matchKey: r,
@@ -11423,7 +11468,7 @@ function a_(e, n = {}) {
 			matchKey: t.boolean().optional().describe("是否同时匹配 key 名,默认 true"),
 			limit: t.number().int().min(1).max(200).optional().describe("返回上限,默认 50")
 		})
-	}), de = s(async ({ script: e, mode: t, jsonPath: n }, r) => {
+	}), I = s(async ({ script: e, mode: t, jsonPath: n }, r) => {
 		let s = y(r);
 		if (e.length > 8e3) return $({
 			code: "SCRIPT_TOO_LARGE",
@@ -11466,7 +11511,9 @@ function a_(e, n = {}) {
 			if (l) {
 				let e = await j();
 				try {
-					let e = Jg({
+					let n = await oe("edit", D ? C(s) : void 0, void 0, e);
+					if (n !== null) return n;
+					let r = Jg({
 						bindRef: c,
 						patches: [{
 							op: "set",
@@ -11483,11 +11530,11 @@ function a_(e, n = {}) {
 						internalAfterWrite: a,
 						protectedCtx: m
 					});
-					return e.ok ? (P({
+					return r.ok ? (P({
 						op: "edit",
 						detail: `eval_transform_subtree @ ${l}`,
 						timestamp: Date.now()
-					}), w(O(), s), `已通过脚本 transform 子树 @ ${l} 更新(耗时 ${_.elapsedMs}ms)。当前值: ${Fp(c, 600)}`) : e.error;
+					}), w(O(), s), `已通过脚本 transform 子树 @ ${l} 更新(耗时 ${_.elapsedMs}ms)。当前值: ${Fp(c, 600)}`) : r.error;
 				} finally {
 					e.release();
 				}
@@ -11500,7 +11547,9 @@ function a_(e, n = {}) {
 				});
 				let e = await j();
 				try {
-					let e = Jg({
+					let n = await oe("edit", D ? C(s) : void 0, void 0, e);
+					if (n !== null) return n;
+					let r = Jg({
 						bindRef: c,
 						patches: t.patches,
 						schema: o,
@@ -11513,11 +11562,11 @@ function a_(e, n = {}) {
 						internalAfterWrite: a,
 						protectedCtx: m
 					});
-					return e.ok ? (P({
+					return r.ok ? (P({
 						op: "edit",
-						detail: `eval_transform(${e.applied.length} patches)`,
+						detail: `eval_transform(${r.applied.length} patches)`,
 						timestamp: Date.now()
-					}), w(O(), s), `已通过脚本 transform(patches) 更新主数据(${e.applied.length} 个 patch,耗时 ${_.elapsedMs}ms)。当前值: ${Fp(c, 600)}`) : e.error;
+					}), w(O(), s), `已通过脚本 transform(patches) 更新主数据(${r.applied.length} 个 patch,耗时 ${_.elapsedMs}ms)。当前值: ${Fp(c, 600)}`) : r.error;
 				} finally {
 					e.release();
 				}
@@ -11539,21 +11588,23 @@ function a_(e, n = {}) {
 			});
 			let i = a ? Ap(c) : null, d = await j();
 			try {
-				let e = Gg({
+				let e = await oe("set", D ? C(s) : void 0, n, d);
+				if (e !== null) return e;
+				let t = Gg({
 					schema: o,
 					allowKeys: u,
 					value: n,
 					bindRef: c
 				});
-				return e.ok ? (ae("edit", "eval_transform"), e.wholeParsed ? Wp(c, e.assembly) : e.assembly !== null && typeof e.assembly == "object" && Ep(c, e.assembly), N(), a && (a(c, i), N()), P({
+				return t.ok ? (ae("edit", "eval_transform"), t.wholeParsed ? Wp(c, t.assembly) : t.assembly !== null && typeof t.assembly == "object" && Ep(c, t.assembly), N(), a && (a(c, i), N()), P({
 					op: "edit",
 					detail: "eval_transform",
 					timestamp: Date.now()
 				}), w(O(), s), `已通过脚本 transform 更新主数据(耗时 ${_.elapsedMs}ms)。当前值: ${Fp(c, 600)}`) : $({
 					code: "SCHEMA_INVALID",
 					message: "脚本返回值校验失败,未写入(transform 模式要求返回主数据的完整新值或顶层 key 子集)",
-					hint: "确认脚本 return 了完整新值(非部分);或返回 {patches:[...]} 走增量模式;按 describe_data() 查看格式",
-					details: (e.error.match(/"details":\s*(\[[^\]]*\])/)?.[1] ?? "") || e.error
+					hint: "确认脚本 return 了完整新值(非部分);或返回 {patches:[...]} 走增量模式;按 schema_data() 查看格式",
+					details: (t.error.match(/"details":\s*(\[[^\]]*\])/)?.[1] ?? "") || t.error
 				});
 			} finally {
 				d.release();
@@ -11573,8 +11624,8 @@ function a_(e, n = {}) {
 			jsonPath: t.string().optional().describe("子树模式:仅对该子树执行;transform 返回值作为子树新值")
 		})
 	});
-	se(de, (e) => e?.mode === "transform");
-	let L = s(async ({ jsonPath: e, jsonPaths: t, fields: n, depth: r, offset: i, limit: a }, s) => {
+	se(I, (e) => e?.mode === "transform");
+	let de = s(async ({ jsonPath: e, jsonPaths: t, fields: n, depth: r, offset: i, limit: a }, s) => {
 		let d = y(s), f = b(s), p = O();
 		if (t && t.length) {
 			let e = !1, i = t.map((t) => {
@@ -11664,7 +11715,7 @@ function a_(e, n = {}) {
 			offset: t.number().int().min(0).optional().describe("数组分页起始偏移(仅数组目标,默认 0)"),
 			limit: t.number().int().min(1).max(200).optional().describe("数组分页每页条数(默认 50,上限 200),返回切片+total/hasMore")
 		})
-	}), fe = s(async ({ value: e, patch: t, patches: n, del: i, dryRun: s }, l) => {
+	}), L = s(async ({ value: e, patch: t, patches: n, del: i, dryRun: s }, l) => {
 		let d = y(l), f = "set";
 		i ? f = "delete" : (n && n.length || t) && (f = "edit");
 		let p = t?.value === void 0 ? e : t.value, _ = await j();
@@ -11810,8 +11861,8 @@ function a_(e, n = {}) {
 			dryRun: t.boolean().optional().describe("预检:走完整校验链但不落盘不入快照;冲突返回 VERSION_CONFLICT 不挂起")
 		})
 	});
-	se(fe);
-	let R = s(async ({ jsonPath: e }) => {
+	se(L);
+	let fe = s(async ({ jsonPath: e }) => {
 		let t = e || "", n = t ? jf(o, t) : o;
 		return n ? `schema${t ? ` @ ${t}` : ""} = ${Fp(Zf(n))}` : $({
 			code: "PATH_DENIED",
@@ -11822,7 +11873,7 @@ function a_(e, n = {}) {
 		name: "schema_data",
 		description: "查看主数据(或子路径)的字段约束:类型/min/max/enum/必填/默认值/嵌套 shape。写前查约束,避免写错重试。不传 jsonPath 查根;传子路径(如 components.0)查该位置约束。",
 		schema: t.object({ jsonPath: t.string().optional().describe("要查约束的子路径;不传查根 schema") })
-	}), pe = s(async ({ snapshotId: e, against: t }) => {
+	}), R = s(async ({ snapshotId: e, against: t }) => {
 		let n = t != null, r, i;
 		if (n) {
 			let e = t;
@@ -11854,7 +11905,7 @@ function a_(e, n = {}) {
 			snapshotId: t.number().int().optional().describe("对比的快照序号;不传则最近一次"),
 			against: t.unknown().optional().describe("对比的一段 JSON 值(与 snapshotId 互斥;传则忽略快照)")
 		})
-	}), me = [];
+	}), pe = [];
 	if (n.vfsStore) {
 		let e = n.vfsStore, r = (e) => `drafts/${e}.json`, i = s(({ draftId: t, chunk: n, mode: i }) => {
 			let a = r(t), o = e.files[a], s = i === "append" && o, c = s ? o.content + n : n;
@@ -11922,9 +11973,9 @@ function a_(e, n = {}) {
 			description: "把 draft_write 累积的草稿合并 + JSON.parse + 乐观锁 + schema 校验,原子提交主数据(任一步失败不写,草稿保留可修后重试;成功清草稿 + 自动快照可回退)。仅大 JSON 从零生成用;小改用 write。",
 			schema: t.object({ draftId: t.string().describe("要提交的草稿标识(对应 draft_write 的 draftId)") })
 		});
-		se(l), me.push(i, l);
+		se(l), pe.push(i, l);
 	}
-	let z = [];
+	let me = [];
 	if (e.resources?.length && f) {
 		let e = s(async ({ path: e, handle: t }) => {
 			let n = e;
@@ -12036,9 +12087,9 @@ function a_(e, n = {}) {
 				handle: t.string().optional().describe("占位符句柄(与 path 二选一)")
 			})
 		});
-		se(i), z.push(e, n, r, i);
+		se(i), me.push(e, n, r, i);
 	}
-	let B = [
+	let z = [
 		ce,
 		le,
 		ue,
@@ -12048,22 +12099,21 @@ function a_(e, n = {}) {
 		L,
 		fe,
 		R,
-		pe,
-		...me,
-		...z
+		...pe,
+		...me
 	];
-	Object.defineProperty(B, "controller", {
+	Object.defineProperty(z, "controller", {
 		value: ie,
 		enumerable: !1,
 		configurable: !1,
 		writable: !1
 	});
-	for (let e of B) Object.defineProperty(e, "__dataOpsScoped", {
+	for (let e of z) Object.defineProperty(e, "__dataOpsScoped", {
 		value: !0,
 		enumerable: !1,
 		configurable: !1
 	});
-	return B;
+	return z;
 }
 //#endregion
 //#region src/core/tools/htmlValidate.ts
@@ -13198,7 +13248,7 @@ function av(e, t, n) {
 
 两条工作路径:
 - **修改已有组件**(改颜色/文案/布局等):必经 vfs —— 上下文有「组件代码文件地图」(name → vfs 路径),按 name 找到对应文件直接 vfs_edit 增量改目标片段 → validate_code 自检;框架自动回写 data.${t}。勿直接 write data.${t} 改已有组件(绕过 vfs/verify,且无增量友好);文件未检出时先 vfs_write 创建
-- **新建组件**:write({ patch:{ op:'set', jsonPath:'${n}.N', value:{...} } }) —— value 按 data schema **全字段写**(含全部必填字段 —— 字段名以样本为准照抄,如类型/名称,外加 ${t} 代码正文;缺必填字段会被 schema 拒)。调研**只看一个样本**:read({jsonPath:'${n}', offset:0, limit:1}) 取首个元素照抄字段名即可(**禁止分页逐个翻完整数组**,大数组翻页纯烧轮次;也不要 describe_data/schema_data 反复查);N = 数组长度(追加到末尾,read 返回的 total/length 即是)。框架自动补 __pgId。**固定流程**:直接 write data → validate_code({jsonPath:'${n}.N.${t}'}) 自检(从 data 读刚写的代码,零重传 content)→ read 确认;**不必手动 vfs_write 建工作副本**(框架下次委派自动 checkout;仅当本次委派内还要继续精修它,才 vfs_write 建副本再 vfs_edit)。**校验方式**:新建组件用 jsonPath(零重传)/ 修改组件用 path(vfs 文件)/ content 仅兜底;**禁止在思考里权衡「content 太长 / 要不要重传 / 先 vfs_write 再 by path」**,选对应方式一次校验即收口(为之纠结反费更多 token,真实复盘子 agent 曾在此循环 10+ 回合致整页超时)。**${t} 字段直接写完整代码字符串,换行/引号照常写,无需手工 JSON 转义**
+- **新建组件**:write({ patch:{ op:'set', jsonPath:'${n}.N', value:{...} } }) —— value 按 data schema **全字段写**(含全部必填字段 —— 字段名以样本为准照抄,如类型/名称,外加 ${t} 代码正文;缺必填字段会被 schema 拒)。调研**只看一个样本**:read({jsonPath:'${n}', offset:0, limit:1}) 取首个元素照抄字段名即可(**禁止分页逐个翻完整数组**,大数组翻页纯烧轮次;也不要 schema_data 反复查);N = 数组长度(追加到末尾,read 返回的 total/length 即是)。框架自动补 __pgId。**固定流程**:直接 write data → validate_code({jsonPath:'${n}.N.${t}'}) 自检(从 data 读刚写的代码,零重传 content)→ read 确认;**不必手动 vfs_write 建工作副本**(框架下次委派自动 checkout;仅当本次委派内还要继续精修它,才 vfs_write 建副本再 vfs_edit)。**校验方式**:新建组件用 jsonPath(零重传)/ 修改组件用 path(vfs 文件)/ content 仅兜底;**禁止在思考里权衡「content 太长 / 要不要重传 / 先 vfs_write 再 by path」**,选对应方式一次校验即收口(为之纠结反费更多 token,真实复盘子 agent 曾在此循环 10+ 回合致整页超时)。**${t} 字段直接写完整代码字符串,换行/引号照常写,无需手工 JSON 转义**
 
 焦点精修(若继承到主 agent 焦点):
 - 上下文若提示「当前精修目标」(如 ${n}.2),说明主 agent 聚焦了某组件 → 你**只能改该焦点组件**的代码文件(vfs 文件 ${e}<焦点组件 __pgId>.${r});改其他组件的代码文件会被 PATH_DENIED 硬拦
@@ -14263,11 +14313,11 @@ var uy = {
 		enableLLMSummary: !0
 	}
 }, dy = {
-	auto: ["describe_data", "read"],
-	conservative: ["describe_data"],
-	aggressive: ["describe_data", "read"],
+	auto: ["schema_data", "read"],
+	conservative: ["schema_data"],
+	aggressive: ["schema_data", "read"],
 	complex: [
-		"describe_data",
+		"schema_data",
 		"read",
 		"query_data",
 		"search_data"
@@ -14810,7 +14860,7 @@ function Qy(e, t, n) {
 		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 不传路径(= describe_data)。"), 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 && a.push("改完数据想确认渲染是否生效(或定位元素/辅助 UI 设计问答)用 get_dom({selector?,depth?}) 读渲染后 DOM(结构化返回 tag/attrs/text/children,depth 控制深度防爆炸,只读)。配合宿主 actions(save_draft/publish 等)形成\"改数据→get_dom 看渲染→触发动作\"闭环。"), 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 && (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/describe_data 查。")), e?.subagents?.length) {
+			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 && a.push("改完数据想确认渲染是否生效(或定位元素/辅助 UI 设计问答)用 get_dom({selector?,depth?}) 读渲染后 DOM(结构化返回 tag/attrs/text/children,depth 控制深度防爆炸,只读)。配合宿主 actions(save_draft/publish 等)形成\"改数据→get_dom 看渲染→触发动作\"闭环。"), 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 && (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) >= Zy || /规划|创意|设计|方案|brainstorm|plan/i.test(e.description)), n = e.subagents.filter((e) => (e.temperature ?? 0) < Zy && /反思|审查|挑刺|校验|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("  · 简单/明确任务(如\"标题改红色\")直接执行,不必走规划-反思。");
 			}
@@ -15335,11 +15385,7 @@ function hb(e, n) {
 			...n ? { thinkingMode: n } : {},
 			thinkingApplied: r
 		};
-	}, mt = [
-		"describe_data",
-		"read",
-		"fetch_document"
-	], ht = ze.filter((e) => mt.includes(e.name)), gt = et ? Mh({
+	}, mt = ["read", "fetch_document"], ht = ze.filter((e) => mt.includes(e.name)), gt = et ? Mh({
 		check: e.verify.check ?? Rh({
 			schemas: () => W() ? { "": W().schema } : {},
 			root: () => W()?.bind
@@ -30939,4 +30985,4 @@ function dL(e) {
 	return gb(e, UI);
 }
 //#endregion
-export { yj as ApprovalBar, sy as CAPABILITIES, uy as CONTEXT_PRESETS, HI as ChatDialog, GE as ChatHeader, aM as ChatInput, uL as CodePreview, _v as CompressDecisionSchema, Ij as ConflictBar, Cy as DEFAULT_COMPUTED_STYLES, Ew as DEFAULT_DIALOG_ICONS, km as DEFAULT_PROMPT_SOFT_CAP, ig as DEFAULT_SYSTEM_PROMPT, ag as DEFAULT_SYSTEM_PROMPT_EN, hI as DebugDrawer, nD as FocusBar, rA as HLJS_BLOCK_MAX_CHARS, o_ as HTML_VOID_TAGS, yh as HUMAN_CONFIRM_TOOL_NAME, gE as IconGlyph, tu as ImageInputError, T as LOW_CAPS_HINT_BASELINE, kw as MESSAGES_EN_US, Ow as MESSAGES_ZH_CN, S as MIN_CONTEXT_WINDOW, Ru as MODEL_UNAVAILABLE_GUIDANCE, hA as MessageContent, JA as MessageList, RA as MessageRow, ij as QueuedBar, Om as SOFT_CAP_MIN_WINDOW, Sm as STOP_WORDS, VI as SkillPanel, wp as UNSAFE_KEYS, Gy as actionsToInspectInfo, Wy as actionsToTools, Zl as agentError, Zh as analyzeContext, zp as applyPatchToClone, Hp as applyPatchToLive, Jg as applyPatchesToBind, Lf as arrayMinLength, Xl as asAgentError, Z_ as buildCollectorJs, Oy as buildCssPath, og as buildDataPrompt, U_ as buildDiagnosticsReport, sv as buildHtmlFragmentSkill, Q_ as buildSandboxSrcdoc, sg as buildSystemPrompt, Mw as chatContextKey, qg as commitSetToBind, iv as composeStructureThenRender, fu as compressImage, rg as connectMcp, ie as constructLlmFromConfig, ne as constructOpenLlmSync, Tw as copyText, Df as createAgent, vh as createApprovalMiddleware, Nw as createChatContext, dL as createChatSdk, kh as createCheckpointManager, Ah as createCheckpointMiddleware, Av as createConflictManager, Qh as createContextInspectorMiddleware, dv as createCraftNoteCheck, a_ as createDataOps, lv as createHtmlFormatCheck, rv as createHtmlRenderCheck, pv as createHtmlSubagent, Sh as createHumanConfirmMiddleware, xh as createHumanConfirmTool, Qv as createMemoryBackend, dh as createMemoryMiddleware, y as createProxyLlm, YI as createRagSubagent, Gu as createSandboxRunner, ly as createSdkEvents, cb as createSerialRunner, ny as createSessionStore, ry as createSessionStoreWithBackend, ib as createSkillStore, nh as createSubagentMiddleware, Im as createSubagentTracker, ah as createSubagentsMiddleware, Qy as createUsageHintsMiddleware, Mh as createVerifyMiddleware, dg as createVfs, ey as createWebStorageBackend, Rh as createWriteBackCheck, zu as decorateModelUnavailable, Ap as deepClone, Jy as defineDataToolset, Qp as defineSkill, mv as defineTool, kp as deleteByPath, vv as deriveTitle, Zf as describeSchemaNode, pf as detectGarbledToolCall, Rd as detectTransitionalReply, Kp as diffObjects, Ny as domInfoTool, Py as domInspectSkill, My as domSearchTool, by as domToStructure, Sy as domTools, qy as domToolsStatic, Rf as elementSchemaCandidates, Ey as ensureDomListenerRecorder, wm as estimateMessageTokens, Tm as estimateRoundTokens, O as estimateTokens, ae as extractReasoningDelta, up as extractSchemaHint, $h as extractText, P as extractTextDelta, oe as extractUsage, gy as fetchDocTools, Ky as fetchTools, Gp as findStrippedKeys, Qf as formatConstraints, Kl as formatZodIssues, Dp as getByPath, xy as getDomTool, jy as getElementInfo, Ly as getEnvSummary, Dy as getRecordedListeners, tv as getSandboxLifecycle, jf as getSchemaAtPath, Of as getSchemaTopKeys, Lp as hashValue, cv as htmlFragmentSkill, ap as htmlOrchestratorPrompt, Em as indexSummarize, By as inspectEnvTool, Vy as inspectTools, bv as isChatModel, Iu as isContextLengthError, iE as isIconHtml, Lu as isModelUnavailableError, kf as isPathAllowed, Wv as isQuotaError, Tp as isUnsafePath, td as jpEval, Jl as jsonParseError, Pp as limitDepth, E as lowCapsHint, lA as markedToHtml, V_ as maskUrlCredentials, Mp as maybeParseValue, F_ as measureWriteScale, Vp as moveByPath, M as normalizeBaseUrl, X_ as normalizeRenderResult, ce as normalizeUsage, A as offloadPassThroughChars, k as offloadThresholdChars, ip as presets, Gf as projectBySchema, Wf as projectBySchemaDeep, Np as projectFields, Dm as recallRounds, nv as renderInSandbox, uA as renderMarkdownHtml, $f as renderSchemaHint, ep as renderSchemaOverview, rp as renderSchemaShallow, cy as resolveCapabilities, fy as resolveContextOptions, oy as resolveDialogConfig, Dw as resolveDialogIcons, jw as resolveDialogMessages, kv as resolveLlm, D as resolveModelCaps, jm as resolvePromptSoftCap, Pf as resolveSchemaPath, ay as resolveStorage, Wp as restoreInPlace, Up as restoreLive, Yl as routeError, ad as runSandboxedScript, Ep as safeMerge, Iy as safeSerialize, Fp as safeStringify, mf as sanitizeGarbledContent, cE as sanitizeIconHtml, dE as sanitizeMessageHtml, If as schemaHasRefinement, ky as searchDom, rd as searchJson, Yy as selectBuiltinTools, Op as setByPath, Mm as shouldTriggerCompression, W_ as stringifyDiagnosticsReport, te as stripStainlessFetch, op as systemPromptHelpers, w as tableMaxOutputTokens, Cm as tokenize, $ as toolError, Af as unwrapSchema, ww as useChat, Pw as useChatContext, Ff as validateAtPath, c_ as validateHtmlFormat, Gg as validateRootValueLocally, Kg as validateWriteLocally, Rp as watchFieldsHash, e as z, ql as zodError };
+export { yj as ApprovalBar, sy as CAPABILITIES, uy as CONTEXT_PRESETS, HI as ChatDialog, GE as ChatHeader, aM as ChatInput, uL as CodePreview, _v as CompressDecisionSchema, Ij as ConflictBar, Cy as DEFAULT_COMPUTED_STYLES, Ew as DEFAULT_DIALOG_ICONS, km as DEFAULT_PROMPT_SOFT_CAP, ig as DEFAULT_SYSTEM_PROMPT, ag as DEFAULT_SYSTEM_PROMPT_EN, hI as DebugDrawer, nD as FocusBar, rA as HLJS_BLOCK_MAX_CHARS, o_ as HTML_VOID_TAGS, yh as HUMAN_CONFIRM_TOOL_NAME, gE as IconGlyph, tu as ImageInputError, T as LOW_CAPS_HINT_BASELINE, kw as MESSAGES_EN_US, Ow as MESSAGES_ZH_CN, S as MIN_CONTEXT_WINDOW, Ru as MODEL_UNAVAILABLE_GUIDANCE, hA as MessageContent, JA as MessageList, RA as MessageRow, ij as QueuedBar, Om as SOFT_CAP_MIN_WINDOW, Sm as STOP_WORDS, VI as SkillPanel, wp as UNSAFE_KEYS, Gy as actionsToInspectInfo, Wy as actionsToTools, Zl as agentError, Zh as analyzeContext, zp as applyPatchToClone, Hp as applyPatchToLive, Jg as applyPatchesToBind, Lf as arrayMinLength, Xl as asAgentError, Z_ as buildCollectorJs, Oy as buildCssPath, og as buildDataPrompt, U_ as buildDiagnosticsReport, sv as buildHtmlFragmentSkill, Q_ as buildSandboxSrcdoc, sg as buildSystemPrompt, Mw as chatContextKey, qg as commitSetToBind, iv as composeStructureThenRender, fu as compressImage, rg as connectMcp, ie as constructLlmFromConfig, ne as constructOpenLlmSync, Tw as copyText, Df as createAgent, vh as createApprovalMiddleware, Nw as createChatContext, dL as createChatSdk, kh as createCheckpointManager, Ah as createCheckpointMiddleware, Av as createConflictManager, Qh as createContextInspectorMiddleware, dv as createCraftNoteCheck, a_ as createDataOps, lv as createHtmlFormatCheck, rv as createHtmlRenderCheck, pv as createHtmlSubagent, Sh as createHumanConfirmMiddleware, xh as createHumanConfirmTool, Qv as createMemoryBackend, dh as createMemoryMiddleware, y as createProxyLlm, YI as createRagSubagent, Wu as createSandboxRunner, ly as createSdkEvents, cb as createSerialRunner, ny as createSessionStore, ry as createSessionStoreWithBackend, ib as createSkillStore, nh as createSubagentMiddleware, Im as createSubagentTracker, ah as createSubagentsMiddleware, Qy as createUsageHintsMiddleware, Mh as createVerifyMiddleware, dg as createVfs, ey as createWebStorageBackend, Rh as createWriteBackCheck, zu as decorateModelUnavailable, Ap as deepClone, Jy as defineDataToolset, Qp as defineSkill, mv as defineTool, kp as deleteByPath, vv as deriveTitle, Zf as describeSchemaNode, pf as detectGarbledToolCall, Ld as detectTransitionalReply, Kp as diffObjects, Ny as domInfoTool, Py as domInspectSkill, My as domSearchTool, by as domToStructure, Sy as domTools, qy as domToolsStatic, Rf as elementSchemaCandidates, Ey as ensureDomListenerRecorder, wm as estimateMessageTokens, Tm as estimateRoundTokens, O as estimateTokens, ae as extractReasoningDelta, up as extractSchemaHint, $h as extractText, P as extractTextDelta, oe as extractUsage, gy as fetchDocTools, Ky as fetchTools, Gp as findStrippedKeys, Qf as formatConstraints, Kl as formatZodIssues, Dp as getByPath, xy as getDomTool, jy as getElementInfo, Ly as getEnvSummary, Dy as getRecordedListeners, tv as getSandboxLifecycle, jf as getSchemaAtPath, Of as getSchemaTopKeys, Lp as hashValue, cv as htmlFragmentSkill, ap as htmlOrchestratorPrompt, Em as indexSummarize, By as inspectEnvTool, Vy as inspectTools, bv as isChatModel, Iu as isContextLengthError, iE as isIconHtml, Lu as isModelUnavailableError, kf as isPathAllowed, Wv as isQuotaError, Tp as isUnsafePath, ed as jpEval, Jl as jsonParseError, Pp as limitDepth, E as lowCapsHint, lA as markedToHtml, V_ as maskUrlCredentials, Mp as maybeParseValue, F_ as measureWriteScale, Vp as moveByPath, M as normalizeBaseUrl, X_ as normalizeRenderResult, ce as normalizeUsage, A as offloadPassThroughChars, k as offloadThresholdChars, ip as presets, Gf as projectBySchema, Wf as projectBySchemaDeep, Np as projectFields, Dm as recallRounds, nv as renderInSandbox, uA as renderMarkdownHtml, $f as renderSchemaHint, ep as renderSchemaOverview, rp as renderSchemaShallow, cy as resolveCapabilities, fy as resolveContextOptions, oy as resolveDialogConfig, Dw as resolveDialogIcons, jw as resolveDialogMessages, kv as resolveLlm, D as resolveModelCaps, jm as resolvePromptSoftCap, Pf as resolveSchemaPath, ay as resolveStorage, Wp as restoreInPlace, Up as restoreLive, Yl as routeError, id as runSandboxedScript, Ep as safeMerge, Iy as safeSerialize, Fp as safeStringify, mf as sanitizeGarbledContent, cE as sanitizeIconHtml, dE as sanitizeMessageHtml, If as schemaHasRefinement, ky as searchDom, nd as searchJson, Yy as selectBuiltinTools, Op as setByPath, Mm as shouldTriggerCompression, W_ as stringifyDiagnosticsReport, te as stripStainlessFetch, op as systemPromptHelpers, w as tableMaxOutputTokens, Cm as tokenize, $ as toolError, Af as unwrapSchema, ww as useChat, Pw as useChatContext, Ff as validateAtPath, c_ as validateHtmlFormat, Gg as validateRootValueLocally, Kg as validateWriteLocally, Rp as watchFieldsHash, e as z, ql as zodError };