@webskill/sdk 0.27.1 → 0.29.0

package/dist/browser.js

@@ -2,14 +2,14 @@ import { n as messageOf$1, t as WebSkillError } from "./errors-BDZNpC13.js";
 import { A as SKILL_MANIFEST_FILE, D as verifySkillSignature, M as buildManifest, O as MANIFEST_EXCLUDED_FILES, P as verifyManifest, b as parseSkillMarkdown, c as unzipWithLimits, f as SKILL_PACK_FILE, i as buildCatalog, k as SKILLS_LOCKFILE, m as parseSkillPackManifest, n as SkillDiscovery, o as readResponseWithLimit, p as exportSkills, t as validateSkills, u as detectSkillArchiveShapeFromFs, w as readSkillSignature, y as isValidSkillName } from "./skill-WSUDp6A1.js";
 import { o as atomicWriteText, r as resolveInsideRoot, s as isAtomicTempPath } from "./pathSecurity-CirkQwWP.js";
 import { t as assertRemoteUrlAllowed } from "./urlSafety-CiSuCJvX.js";
-import { t as ATTACHMENT_TEXT_LIMIT } from "./kind-Dc8x0HWz.js";
-import { _ as FsRunSnapshotStore, a as networkPolicyLibSource, c as bridgeError, ct as ProgressiveRouter, d as FsMemoryStore, l as parseBridgeRequest, m as AgentLoop, r as normalizeToolError, s as UPLOAD_FILES_UNAVAILABLE, t as CapabilityApproval, u as FsArtifactStore } from "./approval-BSwffz8P.js";
+import { c as toBase64$1, f as SPREADSHEET_MIME_TYPE, y as ATTACHMENT_TEXT_LIMIT } from "./linkedDocument-GE-VV_Gj.js";
+import { _ as FsRunSnapshotStore, a as networkPolicyLibSource, c as bridgeError, ct as ProgressiveRouter, d as FsMemoryStore, l as parseBridgeRequest, m as AgentLoop, r as normalizeToolError, s as UPLOAD_FILES_UNAVAILABLE, t as CapabilityApproval, u as FsArtifactStore } from "./approval-DnUytrkq.js";
 import { a as GoogleGenAiClient, o as AnthropicClient, s as OpenAiCompatibleClient, t as MockLlmClient } from "./llm-eIQNO9tr.js";
-import { c as toBase64$1, f as SPREADSHEET_MIME_TYPE } from "./linkedDocument-0iiVPd5t.js";
 import { n as normalizeToolContent, t as mergeCatalogEntries } from "./external-_ZRQe-V9.js";
-import { t as createWebSkillApi } from "./webSkillApi-C_7CTwtB.js";
-import { A as frameSteps, D as SCROLL_DIRECTIONS, E as toActionFrameScopes, O as toFrameScopes, _ as defersImage, a as columnWidthToPixels, b as isPdfTextTrustworthy, c as isRangeTopLeft, d as rangeContains, f as readImageSize, k as frameLabel, l as parseCellAddress, n as EMU_PER_POINT, o as fitWithin, p as PDF_LARGE_IMAGE_RATIO, r as EMU_PER_TWIP$1, s as formatCellAddress, t as EMU_PER_PIXEL, u as parseCellRange, v as takesImage } from "./geometry-BXMPNuM6.js";
-import { zipSync } from "fflate";
+import { t as createWebSkillApi } from "./webSkillApi-TeWPPFDn.js";
+import { A as frameSteps, D as SCROLL_DIRECTIONS, E as toActionFrameScopes, O as toFrameScopes, _ as defersImage, a as columnWidthToPixels, b as isPdfTextTrustworthy, c as isRangeTopLeft, d as rangeContains, f as readImageSize, k as frameLabel, l as parseCellAddress, n as EMU_PER_POINT, o as fitWithin, p as PDF_LARGE_IMAGE_RATIO, r as EMU_PER_TWIP$1, s as formatCellAddress, t as EMU_PER_PIXEL, u as parseCellRange, v as takesImage } from "./geometry-QmrkJw1_.js";
+import { Unzip, UnzipInflate, zipSync } from "fflate";
+import { SaxesParser } from "saxes";
 
 //#region ../browser/src/fs/featureDetection.ts
 /** 检测当前环境是否可用 OPFS（navigator.storage.getDirectory） */
@@ -98,6 +98,21 @@ var OpfsProvider = class {
 			return new Uint8Array(await (await handle.getFile()).arrayBuffer());
 		});
 	}
+	async createReadStream(p) {
+		const stream = (await this.#wrap(p, async () => (await this.#walkFile(p)).getFile())).stream();
+		return (async function* () {
+			const reader = stream.getReader();
+			try {
+				for (;;) {
+					const { done, value } = await reader.read();
+					if (done) return;
+					if (value !== void 0) yield value;
+				}
+			} finally {
+				reader.releaseLock();
+			}
+		})();
+	}
 	async writeBinary(p, content) {
 		await this.#wrap(p, async () => {
 			const segments = this.#segments(p);
@@ -6408,14 +6423,129 @@ async function extractDocxText(bytes) {
 	return blocks.join("\n").replace(/\n{3,}/g, "\n\n").trim();
 }
 
+//#endregion
+//#region ../browser/src/document/xlsConversion.ts
+const OLE2_SIGNATURE = [
+	208,
+	207,
+	17,
+	224,
+	161,
+	177,
+	26,
+	225
+];
+function isLegacyXls(bytes) {
+	return OLE2_SIGNATURE.every((byte, index) => bytes[index] === byte);
+}
+/** 旧 BIFF/OLE2 工作簿只在内存中转换；原件与上传落盘内容都不改写。 */
+async function convertXlsToXlsx(bytes) {
+	if (!isLegacyXls(bytes)) throw new WebSkillError("TOOL_EXECUTION_FAILED", "The file is not a legacy OLE2 .xls workbook.");
+	try {
+		const [XLSX, codepage] = await Promise.all([import("@e965/xlsx"), import("@e965/xlsx/dist/cpexcel.full.mjs")]);
+		const { cptable } = codepage;
+		const { utils } = codepage;
+		XLSX.set_cptable({
+			...cptable,
+			utils
+		});
+		const workbook = XLSX.read(bytes, {
+			type: "array",
+			cellDates: false,
+			cellNF: true
+		});
+		const output = XLSX.write(workbook, {
+			type: "array",
+			bookType: "xlsx",
+			compression: true
+		});
+		if (output instanceof Uint8Array) return output;
+		if (output instanceof ArrayBuffer) return new Uint8Array(output);
+		throw new Error("The converter returned an unsupported binary output.");
+	} catch (error) {
+		throw new WebSkillError("TOOL_EXECUTION_FAILED", `The legacy .xls workbook could not be converted to .xlsx: ${error instanceof Error ? error.message : String(error)}`, error);
+	}
+}
+async function normalizeExcelBytes(bytes) {
+	return isLegacyXls(bytes) ? convertXlsToXlsx(bytes) : bytes;
+}
+async function collect(chunks) {
+	const parts = [];
+	let length = 0;
+	for await (const chunk of chunks) {
+		parts.push(chunk);
+		length += chunk.byteLength;
+	}
+	const bytes = new Uint8Array(length);
+	let offset = 0;
+	for (const part of parts) {
+		bytes.set(part, offset);
+		offset += part.byteLength;
+	}
+	return bytes;
+}
+/**
+* 流式读取先复用首段判断魔数。普通 xlsx 的首段会原样接回流，不整份缓存；
+* 只有必须整体转换的 xls 才收集全部字节。
+*/
+async function normalizeExcelSource(source) {
+	if (typeof source !== "function") return normalizeExcelBytes(source);
+	const iterator = (await source())[Symbol.asyncIterator]();
+	const prefix = [];
+	let prefixLength = 0;
+	let done = false;
+	while (prefixLength < OLE2_SIGNATURE.length && !done) {
+		const next = await iterator.next();
+		if (next.done === true) done = true;
+		else {
+			prefix.push(next.value);
+			prefixLength += next.value.byteLength;
+		}
+	}
+	const replay = async function* () {
+		yield* prefix;
+		try {
+			while (!done) {
+				const next = await iterator.next();
+				if (next.done === true) {
+					done = true;
+					break;
+				}
+				yield next.value;
+			}
+		} finally {
+			if (!done) await iterator.return?.();
+		}
+	};
+	const head = new Uint8Array(Math.min(prefixLength, OLE2_SIGNATURE.length));
+	let offset = 0;
+	for (const chunk of prefix) {
+		head.set(chunk.subarray(0, head.byteLength - offset), offset);
+		offset = Math.min(head.byteLength, offset + chunk.byteLength);
+		if (offset === head.byteLength) break;
+	}
+	if (!isLegacyXls(head)) {
+		let pending = replay();
+		return async () => {
+			if (pending !== void 0) {
+				const first = pending;
+				pending = void 0;
+				return first;
+			}
+			return await source();
+		};
+	}
+	return convertXlsToXlsx(await collect(replay()));
+}
+
 //#endregion
 //#region ../browser/src/document/xlsx.ts
 /**
 * xlsx 文本抽取（0.13.0 分册 12）。
 *
-* **零新增依赖**：xlsx 和 docx 是同一种容器（OPC = zip + XML），
-* 所以沿用 docx 那条路 —— zip 走仓内既有的 `unzipWithLimits`（fflate，
-* 自带解压体积上限，顺带挡住 zip 炸弹），XML 走浏览器原生 `DOMParser`。
+* xlsx 和 docx 是同一种容器（OPC = zip + XML），所以沿用 docx 那条路 ——
+* zip 走仓内既有的 `unzipWithLimits`（fflate，自带解压体积上限，顺带挡住 zip 炸弹），
+* XML 走浏览器原生 `DOMParser`。旧版 xls 先由 `xlsConversion` 在内存中转成 xlsx。
 *
 * ⚠️ `DOMParser` 是浏览器 API，Node 没有 —— 所以这个模块只在 `@webskill/browser`。
 * Node 宿主没有 xlsx 能力，与 docx 同一条**显式声明**的限制，不是静默降级（备案 D55）。
@@ -6437,21 +6567,10 @@ const XLSX_UNEXTRACTED = [
 	"hidden row and column marking",
 	"formula expressions (only cached values are read)"
 ];
-const WORKBOOK = "xl/workbook.xml";
-const WORKBOOK_RELS = "xl/_rels/workbook.xml.rels";
-const SHARED_STRINGS = "xl/sharedStrings.xml";
-const STYLES = "xl/styles.xml";
-/** OLE2 复合文档签名：旧版 .xls 的开头，它不是 zip，走不到解压那一步 */
-const OLE2_SIGNATURE = [
-	208,
-	207,
-	17,
-	224,
-	161,
-	177,
-	26,
-	225
-];
+const WORKBOOK$1 = "xl/workbook.xml";
+const WORKBOOK_RELS$1 = "xl/_rels/workbook.xml.rels";
+const SHARED_STRINGS$1 = "xl/sharedStrings.xml";
+const STYLES$1 = "xl/styles.xml";
 /** 内建的日期/时间数字格式 id（ECMA-376 §18.8.30） */
 const BUILTIN_DATE_FORMATS = /* @__PURE__ */ new Set([
 	14,
@@ -6467,14 +6586,14 @@ const BUILTIN_DATE_FORMATS = /* @__PURE__ */ new Set([
 	46,
 	47
 ]);
-function fail(message) {
+function fail$1(message) {
 	throw new WebSkillError("TOOL_EXECUTION_FAILED", message);
 }
 /** 按 localName 取子孙元素，忽略命名空间前缀：不同生成器的前缀写法并不统一 */
-const byTag$3 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
-function parseXml$3(bytes, what) {
+const byTag$4 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
+function parseXml$4(bytes, what) {
 	const doc = new DOMParser().parseFromString(new TextDecoder().decode(bytes), "application/xml");
-	if (doc.getElementsByTagName("parsererror").length > 0) fail(`The workbook ${what} could not be parsed as XML.`);
+	if (doc.getElementsByTagName("parsererror").length > 0) fail$1(`The workbook ${what} could not be parsed as XML.`);
 	return doc;
 }
 /** `B` → 1、`AA` → 26；拿不到列号时返回 undefined，由调用方顺位补上 */
@@ -6519,14 +6638,14 @@ function isDateFormatCode(code) {
 /** 单元格样式索引 → 是否日期格式 */
 function readDateStyles(bytes) {
 	if (bytes === void 0) return [];
-	const doc = parseXml$3(bytes, "styles");
+	const doc = parseXml$4(bytes, "styles");
 	const custom = /* @__PURE__ */ new Map();
-	for (const fmt of byTag$3(doc, "numFmt")) {
+	for (const fmt of byTag$4(doc, "numFmt")) {
 		const id = Number(fmt.getAttribute("numFmtId"));
 		const code = fmt.getAttribute("formatCode");
 		if (Number.isFinite(id) && code !== null) custom.set(id, code);
 	}
-	const cellXfs = byTag$3(doc, "cellXfs")[0];
+	const cellXfs = byTag$4(doc, "cellXfs")[0];
 	if (cellXfs === void 0) return [];
 	return [...cellXfs.children].filter((xf) => xf.localName === "xf").map((xf) => {
 		const id = Number(xf.getAttribute("numFmtId") ?? "0");
@@ -6591,7 +6710,7 @@ function cellText$1(cell, shared, dateStyles, date1904) {
 function sheetRows(doc, shared, dateStyles, date1904) {
 	const rows = [];
 	let previousRow = 0;
-	for (const row of byTag$3(doc, "row")) {
+	for (const row of byTag$4(doc, "row")) {
 		const declared = Number(row.getAttribute("r"));
 		const rowNumber = Number.isInteger(declared) && declared > 0 ? declared : previousRow + 1;
 		for (let gap = previousRow + 1; gap < rowNumber; gap++) rows.push([]);
@@ -6614,49 +6733,48 @@ function sheetRows(doc, shared, dateStyles, date1904) {
 }
 /** 一行的文本：单元格用制表符分隔（与 docx 的表格同口径），行尾制表符不留 */
 const rowLine = (cells) => cells.join("	").replace(/\t+$/, "");
-const looksLikeOle2 = (bytes) => bytes.length >= OLE2_SIGNATURE.length && OLE2_SIGNATURE.every((byte, i) => bytes[i] === byte);
 /** rels 里的 Target 可能是相对 `xl/` 的，也可能是包根绝对路径 */
-function resolveSheetPath(target) {
+function resolveSheetPath$1(target) {
 	const clean = target.replace(/^\.\//, "");
 	return clean.startsWith("/") ? clean.slice(1) : `xl/${clean}`;
 }
 /**
 * 把 xlsx 拆成「每张表的每一行文本」。
 *
-* @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
+* @throws WebSkillError 归档损坏、旧版 `.xls` 转换失败、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
 */
 async function readXlsxWorkbook(bytes) {
-	if (looksLikeOle2(bytes)) fail("This is a legacy .xls workbook, which is not supported. Save it as .xlsx and try again.");
+	const normalized = await normalizeExcelBytes(bytes);
 	let entries;
 	try {
-		entries = await unzipWithLimits(bytes);
+		entries = await unzipWithLimits(normalized);
 	} catch {
-		fail("This file could not be read as an Excel workbook: the archive is damaged or not a .xlsx file.");
+		fail$1("This file could not be read as an Excel workbook: the archive is damaged or not a .xlsx file.");
 	}
 	const parts = new Map(entries);
-	const workbookBytes = parts.get(WORKBOOK);
-	if (workbookBytes === void 0) fail(`This file is not an Excel workbook: it has no ${WORKBOOK} entry.`);
-	const workbook = parseXml$3(workbookBytes, "index");
-	const workbookPr = byTag$3(workbook, "workbookPr")[0];
+	const workbookBytes = parts.get(WORKBOOK$1);
+	if (workbookBytes === void 0) fail$1(`This file is not an Excel workbook: it has no ${WORKBOOK$1} entry.`);
+	const workbook = parseXml$4(workbookBytes, "index");
+	const workbookPr = byTag$4(workbook, "workbookPr")[0];
 	const date1904 = workbookPr?.getAttribute("date1904") === "1" || workbookPr?.getAttribute("date1904") === "true";
-	const relsBytes = parts.get(WORKBOOK_RELS);
+	const relsBytes = parts.get(WORKBOOK_RELS$1);
 	const targets = /* @__PURE__ */ new Map();
-	if (relsBytes !== void 0) for (const rel of byTag$3(parseXml$3(relsBytes, "relationships"), "Relationship")) {
+	if (relsBytes !== void 0) for (const rel of byTag$4(parseXml$4(relsBytes, "relationships"), "Relationship")) {
 		const id = rel.getAttribute("Id");
 		const target = rel.getAttribute("Target");
-		if (id !== null && target !== null) targets.set(id, resolveSheetPath(target));
+		if (id !== null && target !== null) targets.set(id, resolveSheetPath$1(target));
 	}
-	const sharedBytes = parts.get(SHARED_STRINGS);
-	const shared = sharedBytes === void 0 ? [] : byTag$3(parseXml$3(sharedBytes, "shared strings"), "si").map(sharedStringText);
-	const dateStyles = readDateStyles(parts.get(STYLES));
+	const sharedBytes = parts.get(SHARED_STRINGS$1);
+	const shared = sharedBytes === void 0 ? [] : byTag$4(parseXml$4(sharedBytes, "shared strings"), "si").map(sharedStringText);
+	const dateStyles = readDateStyles(parts.get(STYLES$1));
 	const sheets = [];
-	for (const [ordinal, sheet] of byTag$3(workbook, "sheet").entries()) {
+	for (const [ordinal, sheet] of byTag$4(workbook, "sheet").entries()) {
 		const name = sheet.getAttribute("name") ?? `Sheet${ordinal + 1}`;
 		const relId = sheet.getAttributeNS("http://schemas.openxmlformats.org/officeDocument/2006/relationships", "id") ?? sheet.getAttribute("r:id");
 		const path = relId !== null ? targets.get(relId) : void 0;
 		const sheetBytes = path !== void 0 ? parts.get(path) : void 0;
-		if (path === void 0 || sheetBytes === void 0) fail(`The worksheet "${name}" could not be located inside the workbook.`);
-		const rows = sheetRows(parseXml$3(sheetBytes, `worksheet "${name}"`), shared, dateStyles, date1904);
+		if (path === void 0 || sheetBytes === void 0) fail$1(`The worksheet "${name}" could not be located inside the workbook.`);
+		const rows = sheetRows(parseXml$4(sheetBytes, `worksheet "${name}"`), shared, dateStyles, date1904);
 		const lines = rows.map(rowLine);
 		while (lines.length > 0 && lines[lines.length - 1] === "") {
 			lines.pop();
@@ -6677,7 +6795,7 @@ async function readXlsxWorkbook(bytes) {
 /**
 * 从 xlsx 字节里抽出文本，每个工作表一段、段首是表名。
 *
-* @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
+* @throws WebSkillError 归档损坏、旧版 `.xls` 转换失败、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
 */
 async function extractXlsxText(bytes) {
 	const { sheets } = await readXlsxWorkbook(bytes);
@@ -6738,7 +6856,7 @@ const DEFAULT_BODY_TWIPS = 9360;
 function attr(node, name) {
 	for (const item of node.attributes) if (item.name === name || item.localName === name) return item.value;
 }
-function parseXml$2(bytes, what) {
+function parseXml$3(bytes, what) {
 	const doc = new DOMParser().parseFromString(new TextDecoder().decode(bytes), "application/xml");
 	if (doc.getElementsByTagName("parsererror").length > 0) throw new WebSkillError("TOOL_EXECUTION_FAILED", `The Word document's ${what} could not be parsed as XML.`);
 	return doc;
@@ -6801,10 +6919,10 @@ async function readDocxBlocks(bytes) {
 	const files = new Map(entries);
 	const main = files.get(DOCUMENT$1);
 	if (main === void 0) throw new WebSkillError("TOOL_EXECUTION_FAILED", `This file is not a Word document: it has no ${DOCUMENT$1} entry.`);
-	const doc = parseXml$2(main, "body");
+	const doc = parseXml$3(main, "body");
 	const targets = /* @__PURE__ */ new Map();
 	const rels = files.get(RELS);
-	if (rels !== void 0) for (const rel of parseXml$2(rels, "relationships").getElementsByTagName("Relationship")) {
+	if (rels !== void 0) for (const rel of parseXml$3(rels, "relationships").getElementsByTagName("Relationship")) {
 		const id = attr(rel, "Id");
 		const target = attr(rel, "Target");
 		if (id !== void 0 && target !== void 0) targets.set(id, `word/${target.replace(/^\.?\//, "")}`);
@@ -6853,8 +6971,8 @@ const ANCHOR_TAGS = /* @__PURE__ */ new Set([
 /** 绝对锚点没有行号；放在表尾，保证图片不丢。 */
 const AFTER_LAST_ROW = Number.MAX_SAFE_INTEGER;
 const RELATIONSHIPS_NS = "http://schemas.openxmlformats.org/officeDocument/2006/relationships";
-const byTag$2 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
-function parseXml$1(bytes) {
+const byTag$3 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
+function parseXml$2(bytes) {
 	const doc = new DOMParser().parseFromString(new TextDecoder().decode(bytes), "application/xml");
 	return doc.getElementsByTagName("parsererror").length > 0 ? void 0 : doc;
 }
@@ -6875,9 +6993,9 @@ const relsOf = (path) => `${dirOf(path)}_rels/${path.slice(path.lastIndexOf("/")
 function readRels(parts, path) {
 	const out = /* @__PURE__ */ new Map();
 	const bytes = parts.get(relsOf(path));
-	const doc = bytes === void 0 ? void 0 : parseXml$1(bytes);
+	const doc = bytes === void 0 ? void 0 : parseXml$2(bytes);
 	if (doc === void 0) return out;
-	for (const rel of byTag$2(doc, "Relationship")) {
+	for (const rel of byTag$3(doc, "Relationship")) {
 		const id = rel.getAttribute("Id");
 		const target = rel.getAttribute("Target");
 		if (id !== null && target !== null) out.set(id, resolveRelative$1(dirOf(path), target));
@@ -6885,7 +7003,7 @@ function readRels(parts, path) {
 	return out;
 }
 const anchorNumber = (anchor, name) => {
-	const node = anchor === void 0 ? void 0 : byTag$2(anchor, name)[0];
+	const node = anchor === void 0 ? void 0 : byTag$3(anchor, name)[0];
 	const value = Number(node?.textContent ?? NaN);
 	return Number.isInteger(value) && value >= 0 ? value : 0;
 };
@@ -6902,14 +7020,14 @@ function imagesOf(parts, sheetPath) {
 	for (const [, target] of sheetRels) {
 		if (!target.includes("/drawings/")) continue;
 		const drawingBytes = parts.get(target);
-		const drawing = drawingBytes === void 0 ? void 0 : parseXml$1(drawingBytes);
+		const drawing = drawingBytes === void 0 ? void 0 : parseXml$2(drawingBytes);
 		if (drawing === void 0) continue;
 		const drawingRels = readRels(parts, target);
 		const anchors = [...drawing.documentElement?.children ?? []].filter((element) => ANCHOR_TAGS.has(element.localName));
 		for (const anchor of anchors) {
-			const from = byTag$2(anchor, "from")[0];
+			const from = byTag$3(anchor, "from")[0];
 			const row = anchor.localName === "absoluteAnchor" || from === void 0 ? AFTER_LAST_ROW : anchorNumber(from, "row");
-			const blip = byTag$2(anchor, "blip")[0];
+			const blip = byTag$3(anchor, "blip")[0];
 			const relId = blip?.getAttributeNS(RELATIONSHIPS_NS, "embed") ?? blip?.getAttribute("r:embed");
 			const path = relId === null || relId === void 0 ? void 0 : drawingRels.get(relId);
 			const data = path === void 0 ? void 0 : parts.get(path);
@@ -6926,7 +7044,7 @@ function createXlsxBlockReader() {
 	return { read: readXlsxBlocks };
 }
 /**
-* @throws WebSkillError 归档损坏、旧版 `.xls`、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
+* @throws WebSkillError 归档损坏、旧版 `.xls` 转换失败、缺 `xl/workbook.xml`、工作表关系解不开、XML 解析失败
 * @experimental
 */
 async function readXlsxBlocks(bytes) {
@@ -6951,18 +7069,358 @@ async function readXlsxBlocks(bytes) {
 	return { sheets: out };
 }
 
+//#endregion
+//#region ../browser/src/document/xlsxStreaming.ts
+const WORKBOOK = "xl/workbook.xml";
+const WORKBOOK_RELS = "xl/_rels/workbook.xml.rels";
+const SHARED_STRINGS = "xl/sharedStrings.xml";
+const STYLES = "xl/styles.xml";
+function fail(message) {
+	throw new WebSkillError("TOOL_EXECUTION_FAILED", message);
+}
+async function sourceChunks(source) {
+	if (typeof source !== "function") return (async function* () {
+		yield source;
+	})();
+	return await source();
+}
+async function* entryChunks(source, path, state) {
+	const output = [];
+	let failure;
+	const unzip = new Unzip();
+	unzip.register(UnzipInflate);
+	unzip.onfile = (file) => {
+		if (file.name !== path) return;
+		state.found = true;
+		file.ondata = (error, chunk) => {
+			if (error !== null) failure = error;
+			else if (failure === void 0) output.push(chunk);
+		};
+		file.start();
+	};
+	try {
+		const chunks = await sourceChunks(source);
+		for await (const chunk of chunks) {
+			unzip.push(chunk, false);
+			yield* output.splice(0);
+			await Promise.resolve();
+			yield* output.splice(0);
+		}
+		unzip.push(/* @__PURE__ */ new Uint8Array(), true);
+		await Promise.resolve();
+		yield* output.splice(0);
+	} catch (e) {
+		failure ??= e;
+	}
+	if (failure !== void 0) {
+		if (failure instanceof WebSkillError) throw failure;
+		throw new WebSkillError("TOOL_EXECUTION_FAILED", `The workbook entry "${path}" could not be read: ${failure instanceof Error ? failure.message : String(failure)}`, failure);
+	}
+}
+async function entryBytes(source, path) {
+	const chunks = [];
+	let total = 0;
+	const state = { found: false };
+	for await (const chunk of entryChunks(source, path, state)) {
+		chunks.push(chunk);
+		total += chunk.byteLength;
+	}
+	if (!state.found) return void 0;
+	const out = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		out.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return out;
+}
+function parseXml$1(bytes, what) {
+	const doc = new DOMParser().parseFromString(new TextDecoder().decode(bytes), "application/xml");
+	if (doc.getElementsByTagName("parsererror").length > 0) fail(`The workbook ${what} could not be parsed as XML.`);
+	return doc;
+}
+const byTag$2 = (scope, name) => [...scope.getElementsByTagNameNS("*", name)];
+const localName = (value) => {
+	const name = typeof value === "string" ? value : value.name;
+	return name.slice(name.lastIndexOf(":") + 1);
+};
+function attribute(tag, name) {
+	const direct = tag.attributes[name];
+	if (direct !== void 0) return direct;
+	const key = Object.keys(tag.attributes).find((candidate) => candidate.endsWith(`:${name}`));
+	return key === void 0 ? null : tag.attributes[key] ?? null;
+}
+function newParser(onError) {
+	const parser = new SaxesParser();
+	parser.on("error", onError);
+	return parser;
+}
+async function readSharedStrings(source) {
+	const shared = [];
+	let inside = false;
+	let textDepth = 0;
+	let phoneticDepth = 0;
+	let text = "";
+	let parseError;
+	const parser = newParser((error) => {
+		parseError = error;
+	});
+	parser.on("opentag", (tag) => {
+		const name = localName(tag.name);
+		if (name === "si") {
+			inside = true;
+			text = "";
+		} else if (inside && name === "rPh") phoneticDepth += 1;
+		else if (inside && name === "t" && phoneticDepth === 0) textDepth += 1;
+	});
+	parser.on("text", (value) => {
+		if (inside && textDepth > 0 && phoneticDepth === 0) text += value;
+	});
+	parser.on("cdata", (value) => {
+		if (inside && textDepth > 0 && phoneticDepth === 0) text += value;
+	});
+	parser.on("closetag", (nameValue) => {
+		const name = localName(nameValue);
+		if (name === "t" && textDepth > 0) textDepth -= 1;
+		else if (name === "rPh" && phoneticDepth > 0) phoneticDepth -= 1;
+		else if (name === "si" && inside) {
+			shared.push(text);
+			inside = false;
+			text = "";
+		}
+	});
+	const state = { found: false };
+	const decoder = new TextDecoder();
+	for await (const chunk of entryChunks(source, SHARED_STRINGS, state)) parser.write(decoder.decode(chunk, { stream: true }));
+	if (!state.found) return [];
+	parser.write(decoder.decode());
+	parser.close();
+	if (parseError !== void 0) fail(`The workbook shared strings could not be parsed as XML: ${parseError.message}`);
+	return shared;
+}
+function scanWorksheet(source, path, shared, dateStyles, date1904) {
+	return (async function* () {
+		const queue = [];
+		let previousRow = 0;
+		let lastYielded = 0;
+		let rowNumber = 0;
+		let cells = [];
+		let nextColumn = 0;
+		let cell;
+		let parseError;
+		const parser = newParser((error) => {
+			parseError = error;
+		});
+		const drain = async function* () {
+			for (const entry of queue.splice(0)) {
+				for (let gap = lastYielded + 1; gap < entry.row; gap += 1) yield {
+					row: gap,
+					cells: []
+				};
+				lastYielded = entry.row;
+				yield entry;
+			}
+		};
+		parser.on("opentag", (tag) => {
+			const name = localName(tag.name);
+			if (name === "row") {
+				const declared = Number(attribute(tag, "r"));
+				rowNumber = Number.isInteger(declared) && declared > 0 ? declared : previousRow + 1;
+				previousRow = rowNumber;
+				cells = [];
+				nextColumn = 0;
+				return;
+			}
+			if (name === "c") {
+				const column = columnIndex(attribute(tag, "r")) ?? nextColumn;
+				cell = {
+					type: attribute(tag, "t"),
+					style: Number(attribute(tag, "s") ?? "0"),
+					column,
+					raw: "",
+					inline: "",
+					valueDepth: 0,
+					inlineDepth: 0,
+					textDepth: 0,
+					phoneticDepth: 0
+				};
+				nextColumn = column + 1;
+			} else if (cell !== void 0 && name === "v") cell.valueDepth += 1;
+			else if (cell !== void 0 && name === "is") cell.inlineDepth += 1;
+			else if (cell !== void 0 && name === "rPh" && cell.inlineDepth > 0) cell.phoneticDepth += 1;
+			else if (cell !== void 0 && name === "t" && cell.inlineDepth > 0 && cell.phoneticDepth === 0) cell.textDepth += 1;
+		});
+		parser.on("text", (value) => {
+			if (cell === void 0) return;
+			if (cell.valueDepth > 0) cell.raw += value;
+			if (cell.textDepth > 0 && cell.phoneticDepth === 0) cell.inline += value;
+		});
+		parser.on("cdata", (value) => {
+			if (cell === void 0) return;
+			if (cell.valueDepth > 0) cell.raw += value;
+			if (cell.textDepth > 0 && cell.phoneticDepth === 0) cell.inline += value;
+		});
+		parser.on("closetag", (nameValue) => {
+			const name = localName(nameValue);
+			if (cell !== void 0 && name === "t" && cell.textDepth > 0) cell.textDepth -= 1;
+			else if (cell !== void 0 && name === "rPh" && cell.phoneticDepth > 0) cell.phoneticDepth -= 1;
+			else if (cell !== void 0 && name === "is" && cell.inlineDepth > 0) cell.inlineDepth -= 1;
+			else if (cell !== void 0 && name === "v" && cell.valueDepth > 0) cell.valueDepth -= 1;
+			else if (name === "c" && cell !== void 0) {
+				let text = cell.raw;
+				if (cell.type === "inlineStr") text = cell.inline;
+				else if (cell.type === "s") {
+					const index = Number(cell.raw);
+					text = Number.isInteger(index) ? shared[index] ?? "" : "";
+				} else if (cell.type === "b") text = cell.raw === "1" ? "TRUE" : "FALSE";
+				else if (cell.type !== "str" && cell.type !== "e" && cell.raw !== "") {
+					const numeric = Number(cell.raw);
+					if (Number.isFinite(numeric) && Number.isInteger(cell.style) && dateStyles[cell.style] === true) text = serialToIso(numeric, date1904);
+				}
+				for (let gap = cells.length; gap < cell.column; gap += 1) cells.push("");
+				if (cells.length > cell.column) cells[cell.column] = text;
+				else cells.push(text);
+				cell = void 0;
+			} else if (name === "row") {
+				while (cells.length > 0 && cells[cells.length - 1] === "") cells.pop();
+				if (cells.length > 0) queue.push({
+					row: rowNumber,
+					cells
+				});
+				cells = [];
+			}
+		});
+		const state = { found: false };
+		const decoder = new TextDecoder();
+		for await (const chunk of entryChunks(source, path, state)) {
+			parser.write(decoder.decode(chunk, { stream: true }));
+			yield* drain();
+		}
+		if (!state.found) fail(`The worksheet entry "${path}" could not be located inside the workbook.`);
+		parser.write(decoder.decode());
+		parser.close();
+		if (parseError !== void 0) fail(`The worksheet "${path}" could not be parsed as XML: ${parseError.message}`);
+		yield* drain();
+	})();
+}
+function blank(cells) {
+	return cells.every((value) => value.trim() === "");
+}
+function wide(code) {
+	return code >= 19968 && code <= 40959 || code >= 13312 && code <= 19903 || code >= 12288 && code <= 12543 || code >= 44032 && code <= 55215 || code >= 63744 && code <= 64255 || code >= 65280 && code <= 65519;
+}
+const MAX_CACHED_ROWS = 5e4;
+const MAX_CACHED_CELLS = 5e5;
+async function measure(sheet) {
+	let rowCount = 0;
+	let columnCount = 0;
+	let firstNonEmptyRow = 0;
+	let firstRow = [];
+	let dataRows = 0;
+	let wideChars = 0;
+	let otherChars = sheet.name.length + 8;
+	let cellCount = 0;
+	const rows = [];
+	for await (const entry of sheet.scan()) {
+		rowCount += 1;
+		cellCount += entry.cells.length;
+		if (rowCount <= MAX_CACHED_ROWS && cellCount <= MAX_CACHED_CELLS) rows.push(entry);
+		columnCount = Math.max(columnCount, entry.cells.length);
+		otherChars += Math.max(entry.cells.length - 1, 0) + 1;
+		for (const value of entry.cells) for (let index = 0; index < value.length; index += 1) if (wide(value.charCodeAt(index))) wideChars += 1;
+		else otherChars += 1;
+		if (blank(entry.cells)) continue;
+		if (firstNonEmptyRow === 0) {
+			firstNonEmptyRow = entry.row;
+			firstRow = entry.cells;
+		} else dataRows += 1;
+	}
+	return {
+		meta: {
+			rowCount,
+			columnCount,
+			firstNonEmptyRow,
+			firstRow,
+			dataRows,
+			estimatedTokens: wideChars + Math.ceil(otherChars / 4),
+			textChars: wideChars + otherChars
+		},
+		...rowCount <= MAX_CACHED_ROWS && cellCount <= MAX_CACHED_CELLS ? { rows } : {}
+	};
+}
+function resolveSheetPath(target) {
+	const clean = target.replace(/^\.\//, "");
+	return clean.startsWith("/") ? clean.slice(1) : `xl/${clean}`;
+}
+async function readStreamingXlsxWorkbook(input) {
+	const source = await normalizeExcelSource(input);
+	const workbookBytes = await entryBytes(source, WORKBOOK);
+	if (workbookBytes === void 0) fail(`This file is not an Excel workbook: it has no ${WORKBOOK} entry.`);
+	const workbook = parseXml$1(workbookBytes, "index");
+	const workbookPr = byTag$2(workbook, "workbookPr")[0];
+	const date1904 = workbookPr?.getAttribute("date1904") === "1" || workbookPr?.getAttribute("date1904") === "true";
+	const relsBytes = await entryBytes(source, WORKBOOK_RELS);
+	const targets = /* @__PURE__ */ new Map();
+	if (relsBytes !== void 0) for (const rel of byTag$2(parseXml$1(relsBytes, "relationships"), "Relationship")) {
+		const id = rel.getAttribute("Id");
+		const target = rel.getAttribute("Target");
+		if (id !== null && target !== null) targets.set(id, resolveSheetPath(target));
+	}
+	const [shared, dateStyles] = await Promise.all([readSharedStrings(source), entryBytes(source, STYLES).then((bytes) => readDateStyles(bytes))]);
+	const sheets = [];
+	for (const [ordinal, sheet] of byTag$2(workbook, "sheet").entries()) {
+		const name = sheet.getAttribute("name") ?? `Sheet${ordinal + 1}`;
+		const relId = sheet.getAttributeNS("http://schemas.openxmlformats.org/officeDocument/2006/relationships", "id") ?? sheet.getAttribute("r:id");
+		const path = relId !== null ? targets.get(relId) : void 0;
+		if (path === void 0) fail(`The worksheet "${name}" could not be located inside the workbook.`);
+		let metadata;
+		let cachedRows;
+		const scan = () => {
+			const rows = cachedRows;
+			if (rows !== void 0) return (async function* () {
+				yield* rows;
+			})();
+			return scanWorksheet(source, path, shared, dateStyles, date1904);
+		};
+		const entry = {
+			name,
+			scan,
+			meta: () => {
+				metadata ??= measure({
+					name,
+					scan
+				}).then((result) => {
+					cachedRows = result.rows;
+					return result.meta;
+				}).catch((error) => {
+					metadata = void 0;
+					throw error;
+				});
+				return metadata;
+			}
+		};
+		sheets.push(entry);
+	}
+	return {
+		kind: "streaming",
+		sheets
+	};
+}
+
 //#endregion
 //#region ../browser/src/document/xlsxTable.ts
 /**
-* xlsx → 单元格网格（0.26.0 分册 10 · FR-10.20）。
+* xls(x) → 单元格网格或可重复扫描的行流；旧版 xls 先在内存中转换成 xlsx。
 *
-* 与 `extractXlsxText` 共用 `readXlsxWorkbook` 的同一份解析（单元格取值、日期换算、空格补位），
-* 所以画像与查询看到的格，和模型从文本里读到的格是同一批。
-* 错误语义同 `extractXlsxText`：旧版 `.xls`、归档损坏、缺 `xl/workbook.xml` 都抛 `WebSkillError`。
+* `read` 保留既有网格契约；`readStreaming` 用 SAX 逐行解析工作表，不受整包解压的 64 MiB 条目上限约束。
+* 两条路径使用同一套单元格取值、日期换算与空格补位规则，错误均带 `WebSkillError`。
 * @experimental
 */
 function createXlsxTableReader() {
-	return { read: readXlsxTable };
+	return {
+		read: readXlsxTable,
+		readStreaming: readStreamingXlsxWorkbook
+	};
 }
 async function readXlsxTable(bytes) {
 	const { sheets } = await readXlsxWorkbook(bytes);