@webskill/chatbot 0.9.0 → 0.11.0

package/dist/index.js

@@ -6,11 +6,11 @@ import { t as yaml } from "./yaml-C888tCbJ.js";
 import { t as json } from "./json-BOcU6nei.js";
 import { t as typescript } from "./typescript-DAau_Qyl.js";
 import { t as jsx$1 } from "./jsx-D2Jv0wvt.js";
-import { BEHAVIOR_RECORDS_KEY, DEFAULT_LOOP_LIMITS, DEFAULT_USER_PROFILE_LIMITS, EventBus, FsArtifactStore, FsMemoryStore, FsRunSnapshotStore, FsRunTraceStore, FsSessionStore, FsToolStepStore, FullDisclosureRouter, SerializingMemoryStore, SkillDiscovery, USER_PROFILE_KEY, WebSkillError, WebSkillRuntime, applyUserProfileImport, assertRemoteUrlAllowed, atomicWriteText, diffUserProfile, exportUserProfile, isUnsupportedRunSnapshot, messageOf, readBehaviorRecords, readUserProfile, refineUserProfile, summarizeRunUsage, summarizeToolCalls, textParts } from "@webskill/sdk";
+import { BEHAVIOR_RECORDS_KEY, DEFAULT_LOOP_LIMITS, DEFAULT_USER_PROFILE_LIMITS, EventBus, FsArtifactStore, FsMemoryStore, FsRunSnapshotStore, FsRunTraceStore, FsSessionStore, FsToolStepStore, FullDisclosureRouter, SUPPORTED_DOCUMENT_MIME, SerializingMemoryStore, SkillDiscovery, USER_PROFILE_KEY, WebSkillError, WebSkillRuntime, applyUserProfileImport, assertRemoteUrlAllowed, atomicWriteText, diffUserProfile, exportUserProfile, formatAttachmentText, isUnsupportedRunSnapshot, messageOf, readBehaviorRecords, readUserProfile, refineUserProfile, summarizeRunUsage, summarizeToolCalls, textParts } from "@webskill/sdk";
 import { BrowserWorkerScriptExecutor, checkDictationAvailability, compressImageToBudget, createEncryptedMemoryStore, createLlmClient, deleteMemoryEncryptionKey, openMemoryEncryptionKey, probeChromeBuiltinAvailability, startDictation } from "@webskill/sdk/browser";
 import { JsonRenderSpecSurface, NativeSpecSurface, OpenUiSpecSurface, ReactBridgeState, SpecInteractionChannel, SurfaceFormTextsProvider, UiSurfaceSnapshotList, probeJsonRenderAvailability } from "@webskill/sdk/ui-react";
 import { A2UI_SPEC_FORM_PATH, collectFormScopes, createUiCatalogToolSource, fromA2uiSpecAction, fromA2uiSurfaceAction, interactionToFormModel, interactionToUiSpec, loadOpenUiPeers, loadWebSkillLitCatalog, renderMiniChart, shapeInteractionValue, toA2uiSpecMessages, toA2uiSurfaceAction, toVercelToolInvocation, uiCatalog } from "@webskill/sdk/ui";
-import { TodoStore, createDelegationToolSource, createPageActionToolSource, createPagePerceptionToolSource, createSkillGenerationToolSource, createTodoToolSource, withDelegationOrigin } from "@webskill/sdk/agent";
+import { DownloadedFilePolicy, PAGE_ACTION_KINDS, TodoStore, createDelegationToolSource, createDownloadedFileToolSource, createPageActionToolSource, createPagePerceptionToolSource, createSkillGenerationToolSource, createTodoToolSource, withDelegationOrigin } from "@webskill/sdk/agent";
 import * as React$1 from "react";
 import React, { Children, Component, Fragment, createContext, createElement, forwardRef, isValidElement, memo, useCallback, useContext, useDeferredValue, useEffect, useEffectEvent, useId, useInsertionEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
@@ -26,6 +26,63 @@ import { Derived, attachTransformScopes, useClientLookup, useClientResource } fr
 import { resource, useMemoCache, withKey } from "@assistant-ui/tap";
 import { POLICY_DENIAL_CODES } from "@webskill/sdk/governance";
 
+//#region ../ui-kit/src/i18n/localizedText.ts
+/**
+* 键的声明顺序即回退顺序（0.13.0 分册 21 FR-21.2）。
+* 写成 `Record<Locale, …>` 而不是 `['zh','en'] as const satisfies readonly Locale[]`：
+* 后者只校验元素合法、不校验取值穷尽，新增语种时会安静地少一个。
+*/
+const FALLBACK_ORDER = {
+	zh: null,
+	en: null
+};
+/**
+* SDK 支持的语种，声明顺序同时是缺语种时的回退顺序与设置界面里的展示顺序。
+* @experimental
+*/
+const SUPPORTED_LOCALES = Object.keys(FALLBACK_ORDER);
+const trimmed = (value) => {
+	if (typeof value !== "string") return void 0;
+	const text = value.trim();
+	return text === "" ? void 0 : text;
+};
+/**
+* 按当前语种解析多语种文案（0.13.0 分册 21 FR-21.2）：
+* 当前语种非空 → 用它；否则按 {@link SUPPORTED_LOCALES} 顺序取第一个非空的；
+* 全空返回 `undefined`——调用方据此整条丢弃，返回空串会一路流到渲染层变成空白卡片。
+* @experimental
+*/
+function resolveLocalizedText(text, locale) {
+	if (typeof text === "string") return trimmed(text);
+	if (typeof text !== "object" || text === null) return void 0;
+	const preferred = trimmed(text[locale]);
+	if (preferred !== void 0) return preferred;
+	for (const candidate of SUPPORTED_LOCALES) {
+		const value = trimmed(text[candidate]);
+		if (value !== void 0) return value;
+	}
+}
+/** 字符串简写填满全部语种：「这条不分语种，就这一句」。空白串得到空对象。 */
+function normalizeLocalizedText(value) {
+	if (typeof value === "string") {
+		const text = trimmed(value);
+		if (text === void 0) return {};
+		return Object.fromEntries(SUPPORTED_LOCALES.map((locale) => [locale, text]));
+	}
+	if (typeof value !== "object" || value === null) return {};
+	const out = {};
+	for (const locale of SUPPORTED_LOCALES) {
+		const text = trimmed(value[locale]);
+		if (text !== void 0) out[locale] = text;
+	}
+	return out;
+}
+/** 是否有任何语种填了内容；全空的条目一律丢弃（FR-21.2 规则 3） */
+function hasLocalizedText(text) {
+	return SUPPORTED_LOCALES.some((locale) => resolveLocalizedText(text, locale) !== void 0);
+}
+
+//#endregion
 //#region ../ui-kit/src/i18n/createI18n.ts
 /** 字典工厂：各包定义自己的双语字典（恒等返回，保留字面量类型） */
 function defineDictionary(dict) {
@@ -947,72 +1004,6 @@ const __iconNode$22 = [
 ];
 const Mic = createLucideIcon("mic", __iconNode$22);
 
-//#endregion
-//#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/monitor-off.mjs
-/**
-* @license lucide-react v1.27.0 - ISC
-*
-* This source code is licensed under the ISC license.
-* See the LICENSE file in the root directory of this source tree.
-*/
-const __iconNode$21 = [
-	["path", {
-		d: "M12 17v4",
-		key: "1riwvh"
-	}],
-	["path", {
-		d: "M17 17H4a2 2 0 0 1-2-2V5a2 2 0 0 1 1.184-1.826",
-		key: "cv7jms"
-	}],
-	["path", {
-		d: "m2 2 20 20",
-		key: "1ooewy"
-	}],
-	["path", {
-		d: "M8 21h8",
-		key: "1ev6f3"
-	}],
-	["path", {
-		d: "M8.656 3H20a2 2 0 0 1 2 2v10a2 2 0 0 1-.293 1.042",
-		key: "z8ni2w"
-	}]
-];
-const MonitorOff = createLucideIcon("monitor-off", __iconNode$21);
-
-//#endregion
-//#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/monitor.mjs
-/**
-* @license lucide-react v1.27.0 - ISC
-*
-* This source code is licensed under the ISC license.
-* See the LICENSE file in the root directory of this source tree.
-*/
-const __iconNode$20 = [
-	["rect", {
-		width: "20",
-		height: "14",
-		x: "2",
-		y: "3",
-		rx: "2",
-		key: "48i651"
-	}],
-	["line", {
-		x1: "8",
-		x2: "16",
-		y1: "21",
-		y2: "21",
-		key: "1svkeh"
-	}],
-	["line", {
-		x1: "12",
-		x2: "12",
-		y1: "17",
-		y2: "21",
-		key: "vw1qmm"
-	}]
-];
-const Monitor = createLucideIcon("monitor", __iconNode$20);
-
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/octagon-x.mjs
 /**
@@ -1021,7 +1012,7 @@ const Monitor = createLucideIcon("monitor", __iconNode$20);
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
-const __iconNode$19 = [
+const __iconNode$21 = [
 	["path", {
 		d: "m15 9-6 6",
 		key: "1uzhvr"
@@ -1035,7 +1026,7 @@ const __iconNode$19 = [
 		key: "z0biqf"
 	}]
 ];
-const OctagonX = createLucideIcon("octagon-x", __iconNode$19);
+const OctagonX = createLucideIcon("octagon-x", __iconNode$21);
 
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/panel-left.mjs
@@ -1045,7 +1036,7 @@ const OctagonX = createLucideIcon("octagon-x", __iconNode$19);
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
-const __iconNode$18 = [["rect", {
+const __iconNode$20 = [["rect", {
 	width: "18",
 	height: "18",
 	x: "3",
@@ -1056,7 +1047,7 @@ const __iconNode$18 = [["rect", {
 	d: "M9 3v18",
 	key: "fh3hqa"
 }]];
-const PanelLeft = createLucideIcon("panel-left", __iconNode$18);
+const PanelLeft = createLucideIcon("panel-left", __iconNode$20);
 
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/paperclip.mjs
@@ -1066,11 +1057,11 @@ const PanelLeft = createLucideIcon("panel-left", __iconNode$18);
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
-const __iconNode$17 = [["path", {
+const __iconNode$19 = [["path", {
 	d: "m16 6-8.414 8.586a2 2 0 0 0 2.829 2.829l8.414-8.586a4 4 0 1 0-5.657-5.657l-8.379 8.551a6 6 0 1 0 8.485 8.485l8.379-8.551",
 	key: "1miecu"
 }]];
-const Paperclip = createLucideIcon("paperclip", __iconNode$17);
+const Paperclip = createLucideIcon("paperclip", __iconNode$19);
 
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/pencil.mjs
@@ -1080,14 +1071,59 @@ const Paperclip = createLucideIcon("paperclip", __iconNode$17);
 * This source code is licensed under the ISC license.
 * See the LICENSE file in the root directory of this source tree.
 */
-const __iconNode$16 = [["path", {
+const __iconNode$18 = [["path", {
 	d: "M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",
 	key: "1a8usu"
 }], ["path", {
 	d: "m15 5 4 4",
 	key: "1mk7zo"
 }]];
-const Pencil = createLucideIcon("pencil", __iconNode$16);
+const Pencil = createLucideIcon("pencil", __iconNode$18);
+
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/pin-off.mjs
+/**
+* @license lucide-react v1.27.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const __iconNode$17 = [
+	["path", {
+		d: "M12 17v5",
+		key: "bb1du9"
+	}],
+	["path", {
+		d: "M15 9.34V7a1 1 0 0 1 1-1 2 2 0 0 0 0-4H7.89",
+		key: "znwnzq"
+	}],
+	["path", {
+		d: "m2 2 20 20",
+		key: "1ooewy"
+	}],
+	["path", {
+		d: "M9 9v1.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h11",
+		key: "c9qhm2"
+	}]
+];
+const PinOff = createLucideIcon("pin-off", __iconNode$17);
+
+//#endregion
+//#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/pin.mjs
+/**
+* @license lucide-react v1.27.0 - ISC
+*
+* This source code is licensed under the ISC license.
+* See the LICENSE file in the root directory of this source tree.
+*/
+const __iconNode$16 = [["path", {
+	d: "M12 17v5",
+	key: "bb1du9"
+}], ["path", {
+	d: "M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7a1 1 0 0 1 1-1 2 2 0 0 0 0-4H8a2 2 0 0 0 0 4 1 1 0 0 1 1 1z",
+	key: "1nkz8b"
+}]];
+const Pin = createLucideIcon("pin", __iconNode$16);
 
 //#endregion
 //#region ../../node_modules/.pnpm/lucide-react@1.27.0_react@19.2.8/node_modules/lucide-react/dist/esm/icons/play.mjs
@@ -7967,7 +8003,7 @@ const DIALOG_WIDTHS = {
 * 基类锁定 `h` `rounded` `z`（className 覆盖不生效）：
 * `max-h` 是视口上限，圆角与层级属 ui-kit 的整体契约。
 */
-function Dialog({ open, onClose, title, description, footer, hideCloseButton = false, className = "", size, children }) {
+function Dialog({ open, onClose, title, description, footer, hideCloseButton = false, dismissOnOutsideClick = true, className = "", size, children }) {
 	const restoreFocusRef = useRef(null);
 	const wasOpenRef = useRef(false);
 	if (open && !wasOpenRef.current && typeof document !== "undefined") restoreFocusRef.current = document.activeElement;
@@ -7978,6 +8014,7 @@ function Dialog({ open, onClose, title, description, footer, hideCloseButton = f
 		children: /* @__PURE__ */ jsxs(DialogPortal, {
 			container: usePortalContainer(),
 			children: [/* @__PURE__ */ jsx(DialogOverlay, { className: "fixed inset-0 z-[var(--webskill-z-scrim)] bg-scrim" }), /* @__PURE__ */ jsxs(DialogContent, {
+				...dismissOnOutsideClick ? {} : { onInteractOutside: (event) => event.preventDefault() },
 				onCloseAutoFocus: (event) => {
 					const source = restoreFocusRef.current;
 					if (source instanceof HTMLElement && source.isConnected) {
@@ -12748,7 +12785,7 @@ function merge(definitions, space) {
 *   Value that can be used to look up the properly cased property on a
 *   `Schema`.
 */
-function normalize$1(value) {
+function normalize$2(value) {
 	return value.toLowerCase();
 }
 
@@ -12899,8 +12936,8 @@ function create(definition) {
 		const info = new DefinedInfo(property, definition.transform(definition.attributes || {}, property), value, definition.space);
 		if (definition.mustUseProperty && definition.mustUseProperty.includes(property)) info.mustUseProperty = true;
 		properties[property] = info;
-		normals[normalize$1(property)] = property;
-		normals[normalize$1(info.attribute)] = property;
+		normals[normalize$2(property)] = property;
+		normals[normalize$2(info.attribute)] = property;
 	}
 	return new Schema(properties, normals, definition.space);
 }
@@ -13992,7 +14029,7 @@ const valid = /^data[-\w.:]+$/i;
 *   Info.
 */
 function find(schema, value) {
-	const normal = normalize$1(value);
+	const normal = normalize$2(value);
 	let property = value;
 	let Type = Info;
 	if (normal in schema.normal) return schema.property[schema.normal[normal]];
@@ -18879,7 +18916,7 @@ function join(...segments) {
 		assertPath$1(segments[index]);
 		if (segments[index]) joined = joined === void 0 ? segments[index] : joined + "/" + segments[index];
 	}
-	return joined === void 0 ? "." : normalize(joined);
+	return joined === void 0 ? "." : normalize$1(joined);
 }
 /**
 * Normalize a basic file path.
@@ -18889,7 +18926,7 @@ function join(...segments) {
 * @returns {string}
 *   File path.
 */
-function normalize(path) {
+function normalize$1(path) {
 	assertPath$1(path);
 	const absolute = path.codePointAt(0) === 47;
 	let value = normalizeString(path, !absolute);
@@ -27475,7 +27512,7 @@ function addChild(nodes, value) {
 function parsePrimitive(info, name, value) {
 	if (typeof value === "string") {
 		if (info.number && value && !Number.isNaN(Number(value))) return Number(value);
-		if ((info.boolean || info.overloadedBoolean) && (value === "" || normalize$1(value) === normalize$1(name))) return true;
+		if ((info.boolean || info.overloadedBoolean) && (value === "" || normalize$2(value) === normalize$2(name))) return true;
 	}
 	return value;
 }
@@ -30298,6 +30335,55 @@ const fadeInUp = {
 	}
 };
 
+//#endregion
+//#region ../core/src/attachment/kind.ts
+/** 可作为图片分片外发的 MIME 类型 @experimental */
+const IMAGE_MIME_TYPES = [
+	"image/png",
+	"image/jpeg",
+	"image/webp",
+	"image/gif"
+];
+/**
+* 可按文本读取的扩展名。accept 白名单与判定白名单共用这一份——
+* 0.5.x 两处不一致，`log`/`yaml`/`yml` 能通过判定却在文件选择器里选不到。
+*/
+const TEXT_EXTENSIONS = [
+	"txt",
+	"md",
+	"csv",
+	"json",
+	"log",
+	"yaml",
+	"yml"
+];
+/** 非文本非图片但仍可整体外发的类型（provider 的 file 分片） @experimental */
+const FILE_MIME_TYPES = ["application/pdf"];
+/**
+* 需要**客户端先抽取成文本**才能外发的类型（FR-23.9 / 0.13.0 FR-12.5）。
+* 不走直通的 `file`：docx / xlsx 发给 provider 会被当成二进制垃圾。
+*/
+const DOCX_MIME = "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+const XLSX_MIME = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
+const TEXT_EXTENSION_SET = new Set(TEXT_EXTENSIONS);
+const IMAGE_MIME_SET = new Set(IMAGE_MIME_TYPES);
+const FILE_MIME_SET = new Set(FILE_MIME_TYPES);
+const EXTRACTED_MIME_SET = /* @__PURE__ */ new Set([DOCX_MIME, XLSX_MIME]);
+const EXTRACTED_EXTENSION_SET = /* @__PURE__ */ new Set(["docx", "xlsx"]);
+function extensionOf(fileName) {
+	return fileName.split(".").pop()?.toLowerCase() ?? "";
+}
+/** 分类集中一处，不散落在各 UI 分支里 @experimental */
+function classifyAttachment(contentType, fileName) {
+	const type = contentType.toLowerCase();
+	if (IMAGE_MIME_SET.has(type)) return "image";
+	if (EXTRACTED_MIME_SET.has(type)) return "document-text";
+	if (FILE_MIME_SET.has(type)) return "file";
+	if (type.startsWith("text/") || type === "application/json") return "text";
+	if (type === "" && TEXT_EXTENSION_SET.has(extensionOf(fileName))) return "text";
+	if (type === "" && EXTRACTED_EXTENSION_SET.has(extensionOf(fileName))) return "document-text";
+}
+
 //#endregion
 //#region ../runtime/src/tools/types.ts
 /**
@@ -30348,6 +30434,101 @@ const DEFAULT_LOOP_LIMITS$1 = {
 	maxHistoryMessages: 1e3
 };
 
+//#endregion
+//#region ../ui-kit/src/runtime-config/quickPrompts.ts
+/**
+* 图标表。这张表不进任何包的公开面：宿主只认名字，具体用哪套图标是实现细节。
+*/
+const ICONS = {
+	chart: ChartColumn,
+	document: FileText,
+	report: ClipboardList,
+	search: Search,
+	list: List,
+	bug: Bug,
+	test: FlaskConical,
+	metric: Gauge,
+	compare: GitCompare,
+	page: AppWindow,
+	run: Play,
+	warn: TriangleAlert,
+	sparkles: Sparkles,
+	settings: Settings
+};
+/** 受控枚举的全部取值（console 的图标下拉数据源） */
+const QUICK_PROMPT_ICON_NAMES = Object.keys(ICONS);
+/** 空态网格是两列，8 条即四行（FR-17.4 / D-17-6）；用户可在 console 里上调 */
+const DEFAULT_QUICK_PROMPT_LIMIT = 8;
+/** 可调范围的天花板：20 条已经把欢迎区撑成十行，再多就满屏都是按钮 */
+const MAX_QUICK_PROMPT_LIMIT = 20;
+/** 未知名字每个只提示一次，免得每次渲染都刷屏 */
+const warned$1 = /* @__PURE__ */ new Set();
+/**
+* 解析图标名；取值不在枚举内时返回 undefined（按无图标渲染），
+* 并在控制台提示一次可用取值——宿主拼错时不至于只看到「图标没出来」。
+*/
+function resolveQuickPromptIcon(icon) {
+	if (icon === void 0) return void 0;
+	const resolved = ICONS[icon];
+	if (resolved !== void 0) return resolved;
+	if (!warned$1.has(icon)) {
+		warned$1.add(icon);
+		console.debug("[webskill] unknown quick prompt icon", {
+			icon,
+			available: Object.keys(ICONS)
+		});
+	}
+}
+/** 统一成对象形态：宿主可以只给字符串，该字符串填满全部语种（FR-21.1） */
+const normalize = (entry) => typeof entry === "string" ? { text: normalizeLocalizedText(entry) } : entry;
+/**
+* 拼接动态与静态两批快捷指令（FR-17.4）。
+*
+* 动态在前——它是上下文相关的，更容易点到的位置留给它。
+* 去重**只发生在跨界处**：静态清单里与某条动态指令同文案的会让位；
+* 静态清单**内部**的重复原样保留（0.12.0 AC-21.6：宿主自定义时文案本就无唯一性约束，
+* 混排 `['A', {text:'A', icon:'bug'}]` 是合法的两张卡）。
+*
+* 0.13.0 分册 21 FR-21.4：去重口径是**按 `locale` 解析后的文案**，
+* 因此同一对条目在一个语种下会合并、在另一个语种下可能各自保留。
+* 按 `id` 去重不可行：动态清单传的是 `QuickPrompt`，本来就没有 `id`。
+*
+* 结果按 `limit` 截断（默认 {@link DEFAULT_QUICK_PROMPT_LIMIT}）。
+*/
+function mergeQuickPrompts(dynamic, statics, locale, limit = 8) {
+	const resolve = (entry) => {
+		const prompt = normalize(entry);
+		const text = resolveLocalizedText(prompt.text, locale);
+		if (text === void 0) return void 0;
+		return {
+			text,
+			...prompt.icon !== void 0 ? { icon: prompt.icon } : {}
+		};
+	};
+	const head = [];
+	const claimed = /* @__PURE__ */ new Set();
+	for (const entry of dynamic ?? []) {
+		const prompt = resolve(entry);
+		if (prompt === void 0 || claimed.has(prompt.text)) continue;
+		claimed.add(prompt.text);
+		head.push(prompt);
+	}
+	const tail = [];
+	for (const entry of statics) {
+		const prompt = resolve(entry);
+		if (prompt === void 0 || claimed.has(prompt.text)) continue;
+		tail.push(prompt);
+	}
+	return [...head, ...tail].slice(0, clampQuickPromptLimit(limit));
+}
+/** 存储里的脏值不能让空态变成空白或一堵墙；非正整数一律回默认 */
+function clampQuickPromptLimit(value) {
+	if (typeof value !== "number" || !Number.isFinite(value)) return 8;
+	const floored = Math.floor(value);
+	if (floored < 1) return 8;
+	return Math.min(floored, 20);
+}
+
 //#endregion
 //#region ../ui-kit/src/runtime-config/types.ts
 /**
@@ -30402,11 +30583,13 @@ function defaultRuntimeConfig() {
 				fetchData: false
 			},
 			maxDataSourceBytes: DEFAULT_MAX_DATA_SOURCE_BYTES,
+			dataSources: [],
 			remoteUrl: {
 				allowHttp: false,
 				allowPrivateHosts: false
 			},
-			typescript: { enabled: false }
+			typescript: { enabled: false },
+			downloadedFiles: false
 		},
 		llm: { entries: [] },
 		agentCapabilities: {
@@ -30427,7 +30610,8 @@ function defaultRuntimeConfig() {
 			imageAttachments: false,
 			pageImageCapture: false,
 			maxImageBytes: 10 * 1024 * 1024,
-			maxImagesPerMessage: 5
+			maxImagesPerMessage: 50,
+			minImageArea: 1024
 		},
 		documentSurface: { enabled: false },
 		userProfile: {
@@ -30437,6 +30621,9 @@ function defaultRuntimeConfig() {
 			encrypted: true
 		},
 		skillState: { quarantineThreshold: 5 },
+		quickPrompts: [],
+		quickPromptsSeeded: false,
+		quickPromptLimit: 8,
 		dismissedAutoEntries: []
 	};
 }
@@ -30508,7 +30695,8 @@ function mergeRuntimeConfigDefaults(partial) {
 			typescript: {
 				...d.sandbox.typescript,
 				...p["sandbox"]?.["typescript"] ?? {}
-			}
+			},
+			dataSources: readDataSourceEntries(p["sandbox"]?.["dataSources"])
 		},
 		llm: mergeLlmSelection(p["llm"]),
 		agentCapabilities: {
@@ -30521,6 +30709,9 @@ function mergeRuntimeConfigDefaults(partial) {
 		documentSurface: mergeDocumentSurface(p["documentSurface"], d.documentSurface),
 		userProfile: mergeUserProfile(p["userProfile"], d.userProfile),
 		skillState: mergeSkillState(p["skillState"], d.skillState),
+		quickPrompts: readQuickPrompts(p["quickPrompts"]),
+		quickPromptsSeeded: p["quickPromptsSeeded"] === true,
+		quickPromptLimit: clampQuickPromptLimit(p["quickPromptLimit"]),
 		dismissedAutoEntries: readStringList$1(p["dismissedAutoEntries"], [])
 	};
 }
@@ -30543,6 +30734,58 @@ function readStringList$1(raw, fallback) {
 	if (!Array.isArray(raw)) return [...fallback];
 	return raw.filter((item) => typeof item === "string");
 }
+/**
+* 快捷指令逐条校验（FR-17.2）：缺 `id` 或文案全语种皆空的条目**单条丢弃**，
+* 不因为一条脏数据把整段回退——用户其余的配置不该被连坐。
+* `icon` 取值不在枚举内时抹掉该字段（渲染侧按无图标处理）。
+*
+* 0.13.0 分册 25 FR-25.3：`text: string` 的存量条目一并丢弃，不再升级为语种对象——
+* 它们在 console 的快捷指令页里没有身份可言，留着就是「看得见、删不掉」。
+*/
+function readQuickPrompts(raw) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	for (const item of raw) {
+		if (typeof item !== "object" || item === null) continue;
+		const entry = item;
+		const id = typeof entry["id"] === "string" ? entry["id"].trim() : "";
+		const rawText = entry["text"];
+		if (id === "" || typeof rawText !== "object" || rawText === null) continue;
+		const text = normalizeLocalizedText(rawText);
+		if (!hasLocalizedText(text)) continue;
+		const icon = entry["icon"];
+		const valid = typeof icon === "string" && QUICK_PROMPT_ICON_NAMES.includes(icon) ? icon : void 0;
+		out.push({
+			id,
+			text,
+			...valid !== void 0 ? { icon: valid } : {}
+		});
+	}
+	return out;
+}
+/**
+* 逐条校验用户配的数据源：`id` / `url` 缺失或非字符串即整条丢弃。
+* 不整段回退，一条脏数据不该连坐其余几条。
+*/
+function readDataSourceEntries(raw) {
+	if (!Array.isArray(raw)) return [];
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const item of raw) {
+		if (typeof item !== "object" || item === null) continue;
+		const entry = item;
+		const id = typeof entry["id"] === "string" ? entry["id"].trim() : "";
+		const url = typeof entry["url"] === "string" ? entry["url"].trim() : "";
+		if (id === "" || url === "" || seen.has(id)) continue;
+		seen.add(id);
+		out.push({
+			id,
+			url,
+			description: typeof entry["description"] === "string" ? entry["description"] : ""
+		});
+	}
+	return out;
+}
 /** 上限字段非正数时回退默认值：0 或负数会把整条通道变成永远拒收 */
 function mergeMultimodal(raw, d) {
 	const p = typeof raw === "object" && raw !== null ? raw : {};
@@ -30551,9 +30794,14 @@ function mergeMultimodal(raw, d) {
 		imageAttachments: typeof p["imageAttachments"] === "boolean" ? p["imageAttachments"] : d.imageAttachments,
 		pageImageCapture: typeof p["pageImageCapture"] === "boolean" ? p["pageImageCapture"] : d.pageImageCapture,
 		maxImageBytes: positive(p["maxImageBytes"], d.maxImageBytes),
-		maxImagesPerMessage: positive(p["maxImagesPerMessage"], d.maxImagesPerMessage)
+		maxImagesPerMessage: positive(p["maxImagesPerMessage"], d.maxImagesPerMessage),
+		minImageArea: nonNegative(p["minImageArea"], d.minImageArea)
 	};
 }
+/** 非有限数 / 负数回退默认值，`0` 原样保留 */
+function nonNegative(value, fallback) {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
+}
 /**
 * CSP 白名单只收字符串数组；存储被污染时回退默认值（空），
 * **不能**把非法值原样带进 CSP —— `viewerCspHeader` 会抛，等于整条投放面瘫掉。
@@ -31292,6 +31540,9 @@ const chatbotDictionary = defineDictionary({
 		"app.title": "WebSkill Chat",
 		"header.sessions": "Sessions",
 		"header.settings": "Settings",
+		"header.dock": "Dock to page",
+		"header.undock": "Undock from page",
+		"header.close": "Close chat",
 		"header.console": "Open Console",
 		"header.theme.light": "Switch to light theme",
 		"header.theme.dark": "Switch to dark theme",
@@ -31337,10 +31588,6 @@ const chatbotDictionary = defineDictionary({
 		"welcome.capability.transparency.title": "Run transparency",
 		"welcome.capability.transparency.description": "Routing, skill activation, tool calls and results are visible live, step by step.",
 		"welcome.quickPrompts": "Try an example",
-		"welcome.prompt.1": "What skills are installed in this workspace?",
-		"welcome.prompt.2": "Draft a short product update announcement for me",
-		"welcome.prompt.3": "Show me a bar chart of this quarter’s sales",
-		"welcome.prompt.4": "Explain how WebSkill runs skill scripts safely",
 		"message.copy": "Copy",
 		"message.copied": "Copied",
 		"message.retry": "Retry",
@@ -31426,11 +31673,20 @@ const chatbotDictionary = defineDictionary({
 		"interaction.pageAction.click": "Allow the assistant to click “{target}”?",
 		"interaction.pageAction.fill": "Allow the assistant to fill “{target}” with:",
 		"interaction.pageAction.submit": "Allow the assistant to submit “{target}”?",
+		"interaction.pageAction.select": "Allow the assistant to select an option in “{target}”?",
+		"interaction.pageAction.set": "Allow the assistant to toggle “{target}”?",
+		"interaction.pageAction.attach": "Allow the assistant to attach a file to “{target}”?",
 		"interaction.pageAction.role.click": "this control",
 		"interaction.pageAction.role.fill": "this field",
 		"interaction.pageAction.role.submit": "this form",
+		"interaction.pageAction.role.select": "this list",
+		"interaction.pageAction.role.set": "this switch",
+		"interaction.pageAction.role.attach": "this upload field",
+		"interaction.pageAction.remember": "Don’t ask again for this kind of action",
 		"interaction.pageAction.frame": "The target is in the embedded frame \"{frame}\".",
 		"interaction.pageAction.elevated": "This dialog is outside the usual allowlist; it was opened by this task.",
+		"interaction.downloadedFile.file": "{name} · {size}",
+		"interaction.downloadedFile.remember": "Don’t ask again for this kind of access",
 		"interaction.traceEvidence.title": "Steps this skill claims",
 		"interaction.traceEvidence.columnDraft": "In the skill",
 		"interaction.traceEvidence.columnTrace": "Actually run in this session",
@@ -31495,9 +31751,6 @@ const chatbotDictionary = defineDictionary({
 		"composer.noModel.description": "A large language model has not been configured yet. Configure one on the model settings page before chatting.",
 		"composer.noModel.configure": "Configure model",
 		"capability.group": "Model capabilities",
-		"composer.pageCapture": "Read the page view",
-		"composer.pageCapture.disabled.setting": "page image capture is off in Settings → Multimodal",
-		"composer.pageCapture.disabled.model": "the selected model does not accept images",
 		"composer.addAttachment.imagesOff": "images are off in Settings → Multimodal",
 		"composer.addAttachment.modelNoImages": "the selected model does not accept images",
 		"attachment.imagesDropped": "Only {limit} images can be sent per message. Not sent: {names}",
@@ -31648,6 +31901,9 @@ const chatbotDictionary = defineDictionary({
 		"app.title": "WebSkill Chat",
 		"header.sessions": "会话",
 		"header.settings": "设置",
+		"header.dock": "固定到页面",
+		"header.undock": "取消固定",
+		"header.close": "关闭对话框",
 		"header.console": "打开 Console",
 		"header.theme.light": "切换到亮色主题",
 		"header.theme.dark": "切换到暗色主题",
@@ -31693,10 +31949,6 @@ const chatbotDictionary = defineDictionary({
 		"welcome.capability.transparency.title": "运行透明",
 		"welcome.capability.transparency.description": "路由、技能激活、工具调用与结果，逐步实时可见。",
 		"welcome.quickPrompts": "试试这些示例",
-		"welcome.prompt.1": "这个工作区里安装了哪些技能？",
-		"welcome.prompt.2": "帮我起草一份简短的产品更新公告",
-		"welcome.prompt.3": "给我展示本季度销售额的柱状图",
-		"welcome.prompt.4": "解释一下 WebSkill 如何安全地运行技能脚本",
 		"message.copy": "复制",
 		"message.copied": "已复制",
 		"message.edit": "编辑消息",
@@ -31782,11 +32034,20 @@ const chatbotDictionary = defineDictionary({
 		"interaction.pageAction.click": "允许助手点击「{target}」吗？",
 		"interaction.pageAction.fill": "允许助手在「{target}」中填入：",
 		"interaction.pageAction.submit": "允许助手提交「{target}」吗？",
+		"interaction.pageAction.select": "允许助手在「{target}」中选择选项吗？",
+		"interaction.pageAction.set": "允许助手切换「{target}」吗？",
+		"interaction.pageAction.attach": "允许助手向「{target}」附加文件吗？",
 		"interaction.pageAction.role.click": "这个控件",
 		"interaction.pageAction.role.fill": "这个输入框",
 		"interaction.pageAction.role.submit": "这个表单",
+		"interaction.pageAction.role.select": "这个选择框",
+		"interaction.pageAction.role.set": "这个开关",
+		"interaction.pageAction.role.attach": "这个上传控件",
+		"interaction.pageAction.remember": "以后不再询问此类操作",
 		"interaction.pageAction.frame": "目标位于嵌入帧「{frame}」中。",
 		"interaction.pageAction.elevated": "该对话框不在常规允许清单内，是本次任务打开的。",
+		"interaction.downloadedFile.file": "{name} · {size}",
+		"interaction.downloadedFile.remember": "以后不再询问此类访问",
 		"interaction.traceEvidence.title": "该技能声称的步骤",
 		"interaction.traceEvidence.columnDraft": "技能里写的",
 		"interaction.traceEvidence.columnTrace": "本会话实际执行的",
@@ -31851,9 +32112,6 @@ const chatbotDictionary = defineDictionary({
 		"composer.noModel.description": "大模型尚未配置，请先前往大模型配置页面完成配置，再开始对话。",
 		"composer.noModel.configure": "配置大模型",
 		"capability.group": "模型能力",
-		"composer.pageCapture": "读取页面画面",
-		"composer.pageCapture.disabled.setting": "页面图像抓取已在「设置 → 多模态」中关闭",
-		"composer.pageCapture.disabled.model": "当前模型不接受图片",
 		"composer.addAttachment.imagesOff": "图片已在「设置 → 多模态」中关闭",
 		"composer.addAttachment.modelNoImages": "当前模型不接受图片",
 		"attachment.imagesDropped": "每条消息最多发送 {limit} 张图片。未发送：{names}",
@@ -32162,8 +32420,6 @@ function redactInteractionValues(value, request) {
 	}
 	return out;
 }
-/** 注入模型的单个附件正文上限（超出截断并标注） */
-const ATTACHMENT_TEXT_LIMIT = 32 * 1024;
 /**
 * 行为记录与画像归属的 user 作用域标识。chatbot 是单人本地应用，没有账号体系，
 * 固定值即可；它只决定 memory 里的作用域名，不参与任何鉴权。
@@ -32613,6 +32869,17 @@ var ChatEngine = class {
 		this.#maxHistoryMessages = void 0;
 	}
 	/**
+	* 技能仓变更后调用（安装/卸载/发布）：作废 runtime 缓存的技能目录，下次 send 重新扫描。
+	*
+	* 比 `reloadConfig()` 轻，因为它不清 `#handles`——那会连带丢掉每个会话的模型上下文。
+	* 装技能的界面与对话不在同一个页面时（如扩展的 options 页 vs side panel），
+	* 宿主必须自己把变更通知过来，否则新技能要等页面重载才出现在 catalog 里。
+	* @experimental
+	*/
+	invalidateSkills() {
+		this.#ready?.then((runtime) => runtime.invalidate(), () => void 0);
+	}
+	/**
 	* 会话列表页。归档会话也返回：UI 自己分区展示。
 	* `limit` 不给默认值——缺省属于 `SessionStore` 实现，在这里兜底就等于只下推了一半。
 	*/
@@ -32787,7 +33054,7 @@ var ChatEngine = class {
 		const rc = await this.#runtimeConfigStore()?.load();
 		if (!(rc?.multimodal.imageAttachments ?? false)) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "Image attachments are turned off. Enable them in settings before sending images.");
 		if (!entryCapabilities(pickLlmEntry(rc, this.#selectedModelId)).image) throw new WebSkillError("MODEL_IMAGE_UNSUPPORTED", "Current model does not support image input. Switch model or remove the image.");
-		const limit = rc?.multimodal.maxImagesPerMessage ?? 5;
+		const limit = rc?.multimodal.maxImagesPerMessage ?? defaultRuntimeConfig().multimodal.maxImagesPerMessage;
 		if (images.length <= limit) return { accepted: attachments };
 		const dropped = images.slice(limit);
 		const droppedIds = new Set(dropped.map((a) => a.id));
@@ -32811,11 +33078,14 @@ var ChatEngine = class {
 			if (!await this.#adapter.storage.exists(path)) continue;
 			if (attachment.kind === "text" || attachment.kind === "document-text") {
 				const body = await this.#adapter.storage.readText(path);
-				const clipped = body.length > ATTACHMENT_TEXT_LIMIT ? `${body.slice(0, ATTACHMENT_TEXT_LIMIT)}\n[truncated]` : body;
-				const label = attachment.kind === "document-text" ? `${attachment.name} (${attachment.contentType}, body text only)` : `${attachment.name} (${attachment.contentType})`;
 				parts.push({
 					type: "text",
-					text: `--- Attachment: ${label} ---\n${clipped}`
+					text: formatAttachmentText({
+						name: attachment.name,
+						contentType: attachment.contentType,
+						body,
+						kind: attachment.kind
+					})
 				});
 				continue;
 			}
@@ -33165,16 +33435,30 @@ var ChatEngine = class {
 			})] : [],
 			...pagePerception ? [createPagePerceptionToolSource({
 				policy: pagePerception,
+				...this.#adapter.pagePerceptionPaging === void 0 ? {} : { paging: () => this.#adapter.pagePerceptionPaging },
 				imageCapture: async () => {
 					const live = await this.#runtimeConfigStore()?.load();
 					return {
 						enabled: (live?.multimodal.pageImageCapture ?? false) && entryCapabilities(pickLlmEntry(live, this.#selectedModelId)).image,
 						maxImageBytes: live?.multimodal.maxImageBytes ?? 0,
-						maxImages: live?.multimodal.maxImagesPerMessage ?? 0
+						maxImages: live?.multimodal.maxImagesPerMessage ?? 0,
+						minImageArea: live?.multimodal.minImageArea ?? 0
 					};
 				}
 			})] : [],
-			...this.#adapter.pageActions ? [createPageActionToolSource({ policy: this.#adapter.pageActions })] : []
+			...this.#adapter.pageActions ? [createPageActionToolSource({ policy: this.#adapter.pageActions })] : [],
+			...this.#adapter.downloads ? [createDownloadedFileToolSource({ policy: new DownloadedFilePolicy({
+				reader: this.#adapter.downloads.reader,
+				ui: this.#uiBridge,
+				capabilityEnabled: () => rc?.sandbox.downloadedFiles === true,
+				imageCapable: async () => {
+					return entryCapabilities(pickLlmEntry(await this.#runtimeConfigStore()?.load(), this.#selectedModelId)).image;
+				},
+				...this.#adapter.downloads.consent ? { consent: this.#adapter.downloads.consent } : {},
+				...this.#adapter.docxExtractor ? { docxExtractor: this.#adapter.docxExtractor } : {},
+				...this.#adapter.xlsxExtractor ? { xlsxExtractor: this.#adapter.xlsxExtractor } : {},
+				...this.#adapter.documentAudit ? { audit: this.#adapter.documentAudit } : {}
+			}) })] : []
 		];
 		const deps = {
 			fs,
@@ -33209,8 +33493,11 @@ var ChatEngine = class {
 			...Object.keys(loopConfig).length > 0 ? { config: loopConfig } : {},
 			...model ? { model } : {},
 			...this.#options.fetchData ? { fetchData: this.#options.fetchData } : {},
+			...this.#options.dataSources ? { dataSources: this.#options.dataSources } : {},
 			...this.#adapter.linkedDocuments ? { linkedDocuments: this.#adapter.linkedDocuments } : {},
 			...this.#adapter.docxExtractor ? { docxExtractor: this.#adapter.docxExtractor } : {},
+			...this.#adapter.xlsxExtractor ? { xlsxExtractor: this.#adapter.xlsxExtractor } : {},
+			...this.#adapter.pdfExtractor ? { pdfExtractor: this.#adapter.pdfExtractor } : {},
 			...this.#adapter.documentAudit ? { documentAudit: this.#adapter.documentAudit } : {},
 			...toolStepStore ? { toolSteps: toolStepStore } : {}
 		};
@@ -34129,47 +34416,6 @@ function useWebSkillAui({ messages, live, sessions, currentSessionId, sessionsLo
 	}) });
 }
 
-//#endregion
-//#region src/react/quickPromptIcons.ts
-/**
-* 快捷指令图标表（0.12.0 分册 21）。
-* 这张表不导出到包外：宿主只认名字，具体用哪套图标是实现细节。
-*/
-const ICONS = {
-	chart: ChartColumn,
-	document: FileText,
-	report: ClipboardList,
-	search: Search,
-	list: List,
-	bug: Bug,
-	test: FlaskConical,
-	metric: Gauge,
-	compare: GitCompare,
-	page: AppWindow,
-	run: Play,
-	warn: TriangleAlert,
-	sparkles: Sparkles,
-	settings: Settings
-};
-/** 未知名字每个只提示一次，免得每次渲染都刷屏 */
-const warned$1 = /* @__PURE__ */ new Set();
-/**
-* 解析图标名；取值不在枚举内时返回 undefined（按无图标渲染），
-* 并在控制台提示一次可用取值——宿主拼错时不至于只看到「图标没出来」。
-*/
-function resolveQuickPromptIcon(icon) {
-	if (icon === void 0) return void 0;
-	const resolved = ICONS[icon];
-	if (resolved !== void 0) return resolved;
-	if (!warned$1.has(icon)) {
-		warned$1.add(icon);
-		console.debug("[webskill] unknown quick prompt icon", {
-			icon,
-			available: Object.keys(ICONS)
-		});
-	}
-}
-
 //#endregion
 //#region src/react/AssistantUiShell.tsx
 /**
@@ -34411,63 +34657,94 @@ function AssistantUiSessionList({ className = "", onNavigate, onCollapse, hasEar
 	});
 }
 /** Minimal Base toolbar: workspace controls stay secondary to the thread itself. */
-function AssistantUiThreadToolbar({ title, onOpenSessions, onCreateSession, onOpenSettings }) {
+function AssistantUiThreadToolbar({ title, onOpenSessions, onCreateSession, onOpenSettings, docked, onDock, onClose }) {
 	const t = useT();
+	const dockLabel = docked === true ? t("header.undock") : t("header.dock");
 	return /* @__PURE__ */ jsxs("header", {
 		className: "flex h-14 shrink-0 items-center justify-between bg-background px-3",
 		children: [/* @__PURE__ */ jsxs("div", {
 			className: "flex min-w-0 items-center gap-1",
-			children: [/* @__PURE__ */ jsx("button", {
-				type: "button",
-				"aria-label": t("session.expand"),
-				title: t("session.expand"),
-				"data-testid": "chatbot-sessions-button",
-				onClick: onOpenSessions,
-				className: "webskill-aui-sessions-button inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
-				children: /* @__PURE__ */ jsx(PanelLeft, {
-					className: "size-4",
-					"aria-hidden": true
-				})
-			}), title !== void 0 ? /* @__PURE__ */ jsx("span", {
-				className: "truncate px-2 text-sm font-medium text-ink",
-				children: title
-			}) : null]
+			children: [
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					"aria-label": t("session.expand"),
+					title: t("session.expand"),
+					"data-testid": "chatbot-sessions-button",
+					onClick: onOpenSessions,
+					className: "webskill-aui-sessions-button inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: /* @__PURE__ */ jsx(PanelLeft, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}),
+				onDock ? /* @__PURE__ */ jsx("button", {
+					type: "button",
+					"data-testid": "header-dock",
+					"aria-label": dockLabel,
+					"aria-pressed": docked === true,
+					title: dockLabel,
+					onClick: () => onDock(docked !== true),
+					className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: docked === true ? /* @__PURE__ */ jsx(PinOff, {
+						className: "size-4",
+						"aria-hidden": true
+					}) : /* @__PURE__ */ jsx(Pin, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}) : null,
+				title !== void 0 ? /* @__PURE__ */ jsx("span", {
+					className: "truncate px-2 text-sm font-medium text-ink",
+					children: title
+				}) : null
+			]
 		}), /* @__PURE__ */ jsxs("div", {
 			className: "flex items-center gap-1",
-			children: [/* @__PURE__ */ jsx("button", {
-				type: "button",
-				"data-testid": "header-new-chat",
-				"aria-label": t("session.new"),
-				title: t("session.new"),
-				onClick: onCreateSession,
-				className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
-				children: /* @__PURE__ */ jsx(Plus, {
-					className: "size-4",
-					"aria-hidden": true
-				})
-			}), onOpenSettings ? /* @__PURE__ */ jsx("button", {
-				type: "button",
-				"data-testid": "header-settings",
-				"aria-label": t("header.settings"),
-				title: t("header.settings"),
-				onClick: onOpenSettings,
-				className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
-				children: /* @__PURE__ */ jsx(Settings, {
-					className: "size-4",
-					"aria-hidden": true
-				})
-			}) : null]
+			children: [
+				/* @__PURE__ */ jsx("button", {
+					type: "button",
+					"data-testid": "header-new-chat",
+					"aria-label": t("session.new"),
+					title: t("session.new"),
+					onClick: onCreateSession,
+					className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: /* @__PURE__ */ jsx(Plus, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}),
+				onOpenSettings ? /* @__PURE__ */ jsx("button", {
+					type: "button",
+					"data-testid": "header-settings",
+					"aria-label": t("header.settings"),
+					title: t("header.settings"),
+					onClick: onOpenSettings,
+					className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: /* @__PURE__ */ jsx(Settings, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}) : null,
+				onClose ? /* @__PURE__ */ jsx("button", {
+					type: "button",
+					"data-testid": "header-close",
+					"aria-label": t("header.close"),
+					title: t("header.close"),
+					onClick: onClose,
+					className: "inline-flex size-8 items-center justify-center rounded-md text-muted hover:bg-subtle hover:text-ink",
+					children: /* @__PURE__ */ jsx(X, {
+						className: "size-4",
+						"aria-hidden": true
+					})
+				}) : null
+			]
 		})]
 	});
 }
-function AssistantUiEmptyState({ title, prompts, disabled, onPrompt }) {
+function AssistantUiEmptyState({ title, prompts, dynamicPrompts, limit, disabled, onPrompt }) {
 	const t = useT();
-	const starterPrompts = prompts ?? [
-		t("welcome.prompt.1"),
-		t("welcome.prompt.2"),
-		t("welcome.prompt.3"),
-		t("welcome.prompt.4")
-	];
+	const locale = useLocale();
+	const starterPrompts = mergeQuickPrompts(dynamicPrompts, prompts ?? [], locale, limit);
 	return /* @__PURE__ */ jsx("div", {
 		"data-testid": "assistant-ui-empty-state",
 		className: "flex min-h-48 flex-col justify-center py-8 sm:min-h-72 sm:py-10",
@@ -34478,8 +34755,7 @@ function AssistantUiEmptyState({ title, prompts, disabled, onPrompt }) {
 				children: title ?? t("welcome.assistantTitle")
 			}), starterPrompts.length > 0 ? /* @__PURE__ */ jsx("div", {
 				className: "grid w-full grid-cols-1 gap-2 pt-3 sm:grid-cols-2",
-				children: starterPrompts.map((entry, index) => {
-					const item = typeof entry === "string" ? { text: entry } : entry;
+				children: starterPrompts.map((item, index) => {
 					const Icon = resolveQuickPromptIcon(item.icon);
 					return /* @__PURE__ */ jsxs("button", {
 						type: "button",
@@ -34496,6 +34772,11 @@ function AssistantUiEmptyState({ title, prompts, disabled, onPrompt }) {
 		})
 	});
 }
+/**
+* 对话进行中的动态快捷指令条（0.13.0 FR-17.6）已废止：
+* 每轮对话结束都在输入区上方冒出一条横向滚动的胶囊带，构成持续干扰。
+* `ChatbotConfig.dynamicQuickPrompts` 保留，但只在空态（`AssistantUiEmptyState`）生效。
+*/
 
 //#endregion
 //#region src/react/format.ts
@@ -34649,12 +34930,10 @@ const DEFAULT_DICTATION_LANG = {
 	zh: "zh-CN"
 };
 /**
-* 三个图标共用一套外观规则（FR-28.4）：明暗只由 supported 决定，
-* 交互可供性由 interactive 决定——能力是状态，取像是动作。
+* 两个图标共用一套外观（FR-28.4）：明暗只由 supported 决定。
 */
-function CAPABILITY_ICON_CLASS(supported, interactive) {
-	const base = `inline-flex size-8 shrink-0 items-center justify-center rounded-full ${supported ? "text-ink" : "text-muted"}`;
-	return interactive ? `${base} transition-colors hover:bg-accent hover:text-ink disabled:cursor-not-allowed disabled:hover:bg-transparent` : base;
+function CAPABILITY_ICON_CLASS(supported) {
+	return `inline-flex size-8 shrink-0 items-center justify-center rounded-full ${supported ? "text-ink" : "text-muted"}`;
 }
 function AttachmentMeta({ info }) {
 	const t = useT();
@@ -34714,16 +34993,14 @@ function ModelMenuButton({ models }) {
 		}, option.id))
 	})] });
 }
-function AssistantUiComposer({ running, disabled = false, waitTarget, placeholder, attachments = false, attachmentInfo, attachmentImages, centered = false, models, noModel, dictationLang, pageCapture, capabilities }) {
+function AssistantUiComposer({ running, disabled = false, waitTarget, placeholder, attachments = false, attachmentInfo, attachmentImages, centered = false, models, noModel, dictationLang, capabilities }) {
 	const t = useT();
 	const locale = useLocale();
 	const dictation = useComposerDictation(dictationLang ?? DEFAULT_DICTATION_LANG[locale]);
 	const dictationReason = dictation.availability.available ? void 0 : t(`composer.dictate.${dictation.availability.reason}`);
 	const waitReason = disabled ? t("interaction.wait", { target: waitTarget ?? t("interaction.wait.fallback") }) : void 0;
 	const attachmentReason = attachmentImages === void 0 || attachmentImages.enabled && attachmentImages.imageCapable ? void 0 : attachmentImages.enabled ? t("composer.addAttachment.modelNoImages") : t("composer.addAttachment.imagesOff");
-	const pageCaptureReason = pageCapture === void 0 || pageCapture.enabled && pageCapture.imageCapable ? void 0 : pageCapture.enabled ? t("composer.pageCapture.disabled.model") : t("composer.pageCapture.disabled.setting");
 	const plainChatHintId = useId();
-	const pageCaptureHintId = useId();
 	return /* @__PURE__ */ jsx(ComposerPrimitive.Root, {
 		"data-testid": "assistant-ui-composer",
 		"data-centered": centered,
@@ -34823,7 +35100,7 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 										"aria-label": t(capabilities.tools ? "capability.tools.on" : "capability.tools.off"),
 										title: capabilities.tools ? t("capability.tools.on") : `${t("capability.tools.off")} — ${t("settings.capability.plainChat")}`,
 										...capabilities.tools ? {} : { "aria-describedby": plainChatHintId },
-										className: CAPABILITY_ICON_CLASS(capabilities.tools, false),
+										className: CAPABILITY_ICON_CLASS(capabilities.tools),
 										children: capabilities.tools ? /* @__PURE__ */ jsx(Wrench, {
 											className: "size-4",
 											"aria-hidden": true
@@ -34842,7 +35119,7 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 										"data-supported": capabilities.image,
 										"aria-label": t(capabilities.image ? "capability.images.on" : "capability.images.off"),
 										title: t(capabilities.image ? "capability.images.on" : "capability.images.off"),
-										className: CAPABILITY_ICON_CLASS(capabilities.image, false),
+										className: CAPABILITY_ICON_CLASS(capabilities.image),
 										children: capabilities.image ? /* @__PURE__ */ jsx(Image, {
 											className: "size-4",
 											"aria-hidden": true
@@ -34852,29 +35129,6 @@ function AssistantUiComposer({ running, disabled = false, waitTarget, placeholde
 										})
 									})
 								]
-							}) : null,
-							pageCapture ? /* @__PURE__ */ jsx("button", {
-								type: "button",
-								"data-testid": "capability-page-capture",
-								"data-supported": pageCaptureReason === void 0,
-								"aria-label": t("composer.pageCapture"),
-								title: pageCaptureReason === void 0 ? t("composer.pageCapture") : `${t("composer.pageCapture")} — ${pageCaptureReason}`,
-								disabled: pageCaptureReason !== void 0,
-								...pageCaptureReason !== void 0 ? { "aria-describedby": pageCaptureHintId } : {},
-								onClick: pageCapture.onSelect,
-								className: CAPABILITY_ICON_CLASS(pageCaptureReason === void 0, true),
-								children: pageCaptureReason === void 0 ? /* @__PURE__ */ jsx(Monitor, {
-									className: "size-4",
-									"aria-hidden": true
-								}) : /* @__PURE__ */ jsx(MonitorOff, {
-									className: "size-4",
-									"aria-hidden": true
-								})
-							}) : null,
-							pageCapture && pageCaptureReason !== void 0 ? /* @__PURE__ */ jsx("span", {
-								id: pageCaptureHintId,
-								className: "sr-only",
-								children: pageCaptureReason
 							}) : null
 						]
 					}), /* @__PURE__ */ jsxs("div", {
@@ -46537,52 +46791,6 @@ function AssistantUiMessage(props) {
 
 //#endregion
 //#region src/core/attachmentKind.ts
-/** 可作为图片分片外发的 MIME 类型 @experimental */
-const IMAGE_MIME_TYPES = [
-	"image/png",
-	"image/jpeg",
-	"image/webp",
-	"image/gif"
-];
-/**
-* 可按文本读取的扩展名。accept 白名单与判定白名单共用这一份——
-* 0.5.x 两处不一致，`log`/`yaml`/`yml` 能通过判定却在文件选择器里选不到。
-*/
-const TEXT_EXTENSIONS = [
-	"txt",
-	"md",
-	"csv",
-	"json",
-	"log",
-	"yaml",
-	"yml"
-];
-const TEXT_EXTENSION_SET = new Set(TEXT_EXTENSIONS);
-const IMAGE_MIME_SET = new Set(IMAGE_MIME_TYPES);
-/** 非文本非图片但仍可整体外发的类型（provider 的 file 分片） */
-const FILE_MIME_TYPES = ["application/pdf"];
-const FILE_MIME_SET = new Set(FILE_MIME_TYPES);
-/**
-* 需要**客户端先抽取成文本**才能外发的类型（FR-23.9）。
-* 不走直通的 `file`：docx 发给 provider 会被当成二进制垃圾。
-*/
-const EXTRACTED_MIME_TYPES = ["application/vnd.openxmlformats-officedocument.wordprocessingml.document"];
-const EXTRACTED_MIME_SET = new Set(EXTRACTED_MIME_TYPES);
-const EXTRACTED_EXTENSIONS = ["docx"];
-const EXTRACTED_EXTENSION_SET = new Set(EXTRACTED_EXTENSIONS);
-function extensionOf(fileName) {
-	return fileName.split(".").pop()?.toLowerCase() ?? "";
-}
-/** 分类集中一处，不散落在各 UI 分支里 @experimental */
-function classifyAttachment(contentType, fileName) {
-	const type = contentType.toLowerCase();
-	if (IMAGE_MIME_SET.has(type)) return "image";
-	if (EXTRACTED_MIME_SET.has(type)) return "document-text";
-	if (FILE_MIME_SET.has(type)) return "file";
-	if (type.startsWith("text/") || type === "application/json") return "text";
-	if (type === "" && TEXT_EXTENSION_SET.has(extensionOf(fileName))) return "text";
-	if (type === "" && EXTRACTED_EXTENSION_SET.has(extensionOf(fileName))) return "document-text";
-}
 const TEXT_ACCEPT = [
 	"text/plain",
 	"text/markdown",
@@ -46598,7 +46806,8 @@ function attachmentAccept(options) {
 	const parts = [...TEXT_ACCEPT, ...TEXT_EXTENSIONS.map((ext) => `.${ext}`)];
 	if (options.images) parts.push(...IMAGE_MIME_TYPES);
 	if (options.files) parts.push(...FILE_MIME_TYPES);
-	if (options.documents) parts.push(...EXTRACTED_MIME_TYPES, ...EXTRACTED_EXTENSIONS.map((ext) => `.${ext}`));
+	if (options.documents) parts.push(DOCX_MIME, ".docx");
+	if (options.spreadsheets) parts.push(XLSX_MIME, ".xlsx");
 	return parts.join(",");
 }
 
@@ -46607,17 +46816,19 @@ function attachmentAccept(options) {
 /** 非图片附件无法压缩，沿用固定上限；图片走 `RuntimeMultimodalConfig.maxImageBytes` */
 const MAX_BYTES = 10 * 1024 * 1024;
 const MAX_TEXT_CHARS = 32 * 1024;
-const DEFAULT_MULTIMODAL = {
-	imageAttachments: false,
-	pageImageCapture: false,
-	maxImageBytes: MAX_BYTES,
-	maxImagesPerMessage: 5
-};
+/** 0.13.0 FR-13.3：兜底值必须与 SDK 默认配置同源，各自写一份字面量必然静默漂移 */
+const DEFAULT_MULTIMODAL = defaultRuntimeConfig().multimodal;
 /** 去掉路径分隔符与 `..`，防止写出附件目录 */
 function safeName(name) {
 	const cleaned = (name.split(/[\\/]/).pop() ?? "attachment").replace(/[^\w.\- ]+/g, "_").replace(/^\.+/, "");
 	return cleaned === "" ? "attachment" : cleaned.slice(0, 80);
 }
+/** 两种待抽取格式共用 `document-text` 这一种 kind，选抽取器时要按格式再分一次 */
+function isSpreadsheet(file) {
+	const type = file.type.toLowerCase();
+	if (type !== "") return type === SUPPORTED_DOCUMENT_MIME.xlsx;
+	return file.name.toLowerCase().endsWith(".xlsx");
+}
 /**
 * 附件落盘到 `<attachmentsRoot>/<sessionId>/`，`ChatEngine.send` 再按路径读回构造 `LlmContentPart[]`。
 * UI 只持有元数据，正文的唯一真相是存储。
@@ -46634,7 +46845,8 @@ var WebSkillAttachmentAdapter = class {
 		return attachmentAccept({
 			images: this.#imagesAllowed(),
 			files: true,
-			documents: this.#options.docxExtractor !== void 0
+			documents: this.#options.docxExtractor !== void 0,
+			spreadsheets: this.#options.xlsxExtractor !== void 0
 		});
 	}
 	#multimodal() {
@@ -46643,13 +46855,16 @@ var WebSkillAttachmentAdapter = class {
 	#imagesAllowed() {
 		return this.#multimodal().imageAttachments && (this.#options.imageCapable?.() ?? false);
 	}
+	#extractorFor(file) {
+		return isSpreadsheet(file) ? this.#options.xlsxExtractor : this.#options.docxExtractor;
+	}
 	async add({ file }) {
 		const kind = classifyAttachment(file.type, file.name);
 		if (kind === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", `Attachment "${file.name}" has an unsupported type "${file.type === "" ? "unknown" : file.type}"`);
 		if (kind === "image") {
 			if (!this.#multimodal().imageAttachments) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "Image attachments are turned off. Enable them in settings before sending images.");
 			if (!(this.#options.imageCapable?.() ?? false)) throw new WebSkillError("MODEL_IMAGE_UNSUPPORTED", "Current model does not support image input. Switch model or remove the image.");
-		} else if (kind === "document-text" && this.#options.docxExtractor === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "Word documents are not supported in this environment: no docx extractor is wired up.");
+		} else if (kind === "document-text" && this.#extractorFor(file) === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", `${isSpreadsheet(file) ? "Excel workbooks" : "Word documents"} are not supported in this environment: no ${isSpreadsheet(file) ? "xlsx" : "docx"} extractor is wired up.`);
 		else if (file.size > MAX_BYTES) throw new WebSkillError("ATTACHMENT_TOO_LARGE", `Attachment "${file.name}" is ${Math.round(file.size / 1024 / 1024)} MB, which exceeds the 10 MB limit`);
 		const id = `att-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
 		const relative = `${this.#options.sessionId() ?? "pending"}/${id}-${safeName(file.name)}`;
@@ -46692,8 +46907,8 @@ var WebSkillAttachmentAdapter = class {
 			};
 		}
 		if (kind === "document-text") {
-			const extract = this.#options.docxExtractor;
-			if (extract === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "No docx extractor is wired up in this environment.");
+			const extract = this.#extractorFor(file);
+			if (extract === void 0) throw new WebSkillError("ATTACHMENT_TYPE_REJECTED", "No document text extractor is wired up in this environment.");
 			await this.#options.storage.writeText(path, await extract(new Uint8Array(await file.arrayBuffer())));
 			return {
 				...base,
@@ -47097,18 +47312,43 @@ function pageActionDetails(details) {
 	const record = details;
 	const action = record["action"];
 	const target = record["target"];
-	if (action !== "click" && action !== "fill" && action !== "submit") return void 0;
+	if (typeof action !== "string" || !PAGE_ACTION_KINDS.includes(action)) return void 0;
 	if (typeof target !== "object" || target === null) return void 0;
 	const { role, name, frame } = target;
 	if (typeof role !== "string") return void 0;
 	const value = record["value"];
+	const rememberLabel = record["rememberLabel"];
 	return {
 		action,
 		role,
 		...typeof name === "string" ? { name } : {},
 		...typeof value === "string" ? { value } : {},
 		...typeof frame === "string" ? { frame } : {},
-		...record["elevated"] === true ? { elevated: true } : {}
+		...record["elevated"] === true ? { elevated: true } : {},
+		...record["rememberable"] === true ? { rememberable: true } : {},
+		...typeof rememberLabel === "string" ? { rememberLabel } : {}
+	};
+}
+/**
+* 下载文件确认卡的载荷（0.14.0 分册 20）。与 `pageActionDetails` 同一条规矩：
+* 形状不对就整段不渲染，退回通用授权展示，不猜。
+*/
+function downloadedFileDetails(details) {
+	if (typeof details !== "object" || details === null) return void 0;
+	const record = details;
+	const action = record["action"];
+	if (action !== "list" && action !== "read") return void 0;
+	const file = record["file"];
+	const rememberLabel = record["rememberLabel"];
+	const named = typeof file === "object" && file !== null ? file : void 0;
+	return {
+		action,
+		...typeof named?.["name"] === "string" && typeof named["size"] === "number" ? { file: {
+			name: named["name"],
+			size: named["size"]
+		} } : {},
+		...record["rememberable"] === true ? { rememberable: true } : {},
+		...typeof rememberLabel === "string" ? { rememberLabel } : {}
 	};
 }
 /**
@@ -47141,8 +47381,10 @@ function traceEvidenceDetails(details) {
 }
 function ActiveInteractionCard({ request, bridge }) {
 	const t = useT();
+	const [remember, setRemember] = useState(false);
 	const isAuthorize = request.type === "authorize";
 	const pageAction = isAuthorize && request.capability === "pageAction" ? pageActionDetails(request.details) : void 0;
+	const downloadedFile = isAuthorize && request.capability === "readDownloadedFile" ? downloadedFileDetails(request.details) : void 0;
 	const traceEvidence = isAuthorize ? traceEvidenceDetails(request.details) : void 0;
 	const spec = interactionToUiSpec(request.type === "authorize" && pageAction !== void 0 ? {
 		...request,
@@ -47170,7 +47412,8 @@ function ActiveInteractionCard({ request, bridge }) {
 		const value = shapeInteractionValue(interactionToFormModel(request), event.value ?? {});
 		bridge.resolve({
 			id: request.id,
-			value
+			value,
+			...remember ? { remembered: true } : {}
 		});
 	};
 	return /* @__PURE__ */ jsxs(motion.div, {
@@ -47246,8 +47489,33 @@ function ActiveInteractionCard({ request, bridge }) {
 							"data-testid": "interaction-page-action-elevated",
 							className: "text-sm font-medium text-warning",
 							children: t("interaction.pageAction.elevated")
+						}) : null,
+						pageAction.rememberable === true ? /* @__PURE__ */ jsxs("label", {
+							className: "flex items-center gap-2 text-sm text-ink",
+							children: [/* @__PURE__ */ jsx("input", {
+								type: "checkbox",
+								"data-testid": "interaction-page-action-remember",
+								checked: remember,
+								onChange: (event) => setRemember(event.currentTarget.checked)
+							}), pageAction.rememberLabel ?? t("interaction.pageAction.remember")]
 						}) : null
 					] }) : null,
+					downloadedFile ? /* @__PURE__ */ jsxs(Fragment$1, { children: [downloadedFile.file ? /* @__PURE__ */ jsx("p", {
+						"data-testid": "interaction-downloaded-file",
+						className: "text-sm text-ink",
+						children: t("interaction.downloadedFile.file", {
+							name: downloadedFile.file.name,
+							size: formatBytes(downloadedFile.file.size)
+						})
+					}) : null, downloadedFile.rememberable === true ? /* @__PURE__ */ jsxs("label", {
+						className: "flex items-center gap-2 text-sm text-ink",
+						children: [/* @__PURE__ */ jsx("input", {
+							type: "checkbox",
+							"data-testid": "interaction-downloaded-file-remember",
+							checked: remember,
+							onChange: (event) => setRemember(event.currentTarget.checked)
+						}), downloadedFile.rememberLabel ?? t("interaction.downloadedFile.remember")]
+					}) : null] }) : null,
 					traceEvidence ? /* @__PURE__ */ jsxs("div", {
 						"data-testid": "interaction-trace-evidence",
 						children: [/* @__PURE__ */ jsx("div", {
@@ -47666,8 +47934,35 @@ function LocalizedUndoToastProvider({ children }) {
 	});
 }
 const toErrorMessage = (e) => e instanceof Error ? e.message : String(e);
-/** 「读取页面画面」菜单项发出的提示词：说清要的是画面，模型才会走取像而非纯文本抽取 */
-const PAGE_CAPTURE_PROMPT = "Read the current page view, including the images on it, and tell me what you see.";
+/** 与 console 的快捷指令条目同款 id：时间戳 + 随机后缀 */
+const newQuickPromptId = () => `qp-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+/**
+* 宿主种子只注入一次（0.13.0 分册 21 FR-21.6）。
+* 写盘会触发 subscribe 再跑一遍装载，届时 `quickPromptsSeeded` 已为 true，不会二次写入。
+* 宿主没传种子（`undefined`）时什么都不做——不该为「宿主没配」产生一次持久化；
+* 传空数组是「本应用不要快捷指令」，照样落盘打标记（FR-25.4）。
+* 返回已注入的条目（可能是空数组），调用方要立刻拿去更新界面：写盘是 fire-and-forget。
+*/
+function seedQuickPrompts(store, config, seed) {
+	if (config.quickPromptsSeeded || seed === void 0) return void 0;
+	const entries = [];
+	for (const item of seed) {
+		const text = normalizeLocalizedText(typeof item === "string" ? item : item.text);
+		if (Object.keys(text).length === 0) continue;
+		const icon = typeof item === "string" ? void 0 : item.icon;
+		entries.push({
+			id: newQuickPromptId(),
+			text,
+			...icon !== void 0 ? { icon } : {}
+		});
+	}
+	store.save({
+		...config,
+		quickPrompts: entries,
+		quickPromptsSeeded: true
+	}).catch(() => void 0);
+	return entries;
+}
 /** 读 artifact 存储并触发浏览器下载（Blob + a[download]） */
 async function downloadArtifactFile(storage, chatRoot, file) {
 	const fullPath = `${chatRoot}/artifacts/${file.runId ?? ""}/${file.path}`;
@@ -47689,7 +47984,7 @@ async function downloadArtifactFile(storage, chatRoot, file) {
 * presentation shell and accessible thread primitives.
 * @stable
 */
-function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout = "auto", sessionList = "auto", onOpenSettings, onEngineReady }) {
+function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, renderer: rendererProp, dictationLang: dictationLangProp, surfaceRegistry, layout = "auto", sessionList = "auto", onOpenSettings, docked, onDock, onClose, onEngineReady }) {
 	const engine = useMemo(() => new ChatEngine(adapter, {
 		...config?.chatRoot ? { chatRoot: config.chatRoot } : {},
 		...config?.llm ? { llm: config.llm } : {},
@@ -47700,6 +47995,8 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 		...config?.governance ? { governance: config.governance } : {},
 		...config?.skillCandidates ? { skillCandidates: config.skillCandidates } : {},
 		...config?.fetchData ? { fetchData: config.fetchData } : {},
+		...config?.dataSources ? { dataSources: config.dataSources } : {},
+		...config?.executorFactory ? { executorFactory: config.executorFactory } : {},
 		...rendererProp ? { renderer: rendererProp } : {}
 	}), [
 		adapter,
@@ -47712,6 +48009,8 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 		config?.governance,
 		config?.skillCandidates,
 		config?.fetchData,
+		config?.dataSources,
+		config?.executorFactory,
 		rendererProp
 	]);
 	useEffect(() => {
@@ -47770,6 +48069,29 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 	});
 	/** 当前进行中 run 的 part 累积器（流式正文 / 工具 / 生命周期步进的唯一来源） */
 	const [live, setLive] = useState();
+	/** RuntimeConfig 里快捷指令的镜像（FR-21.5）：console 改完经 subscribe 回来 */
+	const [storedQuickPrompts, setStoredQuickPrompts] = useState([]);
+	/** 空态与动态指令条最多展示多少条（console 可改） */
+	const [quickPromptLimit, setQuickPromptLimit] = useState(8);
+	/** 种子的 ref 镜像：props 每次渲染都是新数组，进 effect 依赖表会让配置订阅反复重建 */
+	const seedRef = useRef(config?.quickPrompts);
+	seedRef.current = config?.quickPrompts;
+	/**
+	* 静态清单（FR-21.6 / FR-25.2）：存储里有什么就是什么。
+	* 未接配置存储的宿主用 props；接了存储就以存储为准，两者皆空即一张卡都不渲染——
+	* 内置示例已下线（分册 25），chatbot 显示的每一条都要在 console 的快捷指令页里管得到。
+	*/
+	const staticQuickPrompts = useMemo(() => {
+		if (storedQuickPrompts.length > 0) return storedQuickPrompts.map(({ text, icon }) => ({
+			text,
+			...icon !== void 0 ? { icon } : {}
+		}));
+		return configStore === void 0 ? config?.quickPrompts : [];
+	}, [
+		storedQuickPrompts,
+		config?.quickPrompts,
+		configStore
+	]);
 	const [interactionPending, setInteractionPending] = useState(false);
 	/** 等待对象名称（interaction-requested 携带）：等待指示器要说清在等什么 */
 	const [interactionLabel, setInteractionLabel] = useState();
@@ -47823,7 +48145,8 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 		sessionId: () => sessionRef.current,
 		multimodal: () => multimodalRef.current,
 		imageCapable: () => imageCapableRef.current,
-		...adapter.docxExtractor ? { docxExtractor: adapter.docxExtractor } : {}
+		...adapter.docxExtractor ? { docxExtractor: adapter.docxExtractor } : {},
+		...adapter.xlsxExtractor ? { xlsxExtractor: adapter.xlsxExtractor } : {}
 	}), [adapter, engine]);
 	useEffect(() => {
 		let cancelled = false;
@@ -47850,6 +48173,9 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 					...rc.llm.defaultId ? { defaultId: rc.llm.defaultId } : {}
 				});
 				setLlmSelectionLoaded(true);
+				const seeded = seedQuickPrompts(merged, rc, seedRef.current);
+				setStoredQuickPrompts(seeded ?? rc.quickPrompts);
+				setQuickPromptLimit(rc.quickPromptLimit);
 				multimodalRef.current = rc.multimodal;
 				setMultimodal(rc.multimodal);
 				setLoopLimits({
@@ -47868,7 +48194,9 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			unsubscribe?.();
 		};
 	}, [configStore, engine]);
+	const hasBuiltinEntry = llmSelection.entries.some((entry) => entry.provider === "chrome-builtin");
 	useEffect(() => {
+		if (!hasBuiltinEntry) return void 0;
 		let cancelled = false;
 		probeChromeBuiltinAvailability().then((result) => {
 			if (!cancelled) setChromeBuiltin(result);
@@ -47876,7 +48204,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 		return () => {
 			cancelled = true;
 		};
-	}, []);
+	}, [hasBuiltinEntry]);
 	/** 选中模型条目 id：能力受限提示、设置面板置灰与附件门槛都以它为准 */
 	const selectedModelId = modelId ?? llmSelection.defaultId ?? llmSelection.entries[0]?.id ?? "";
 	const selectedEntry = llmSelection.entries.find((entry) => entry.id === selectedModelId);
@@ -48087,6 +48415,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			setCurrentSessionId(id);
 			setMessages(history.items);
 			setMessagesCursor(history.nextCursor);
+			setError(void 0);
 			setModelId(engine.modelId);
 		}).catch((e) => setError({ message: toErrorMessage(e) }));
 	}, [engine, flushPendingDeletes]);
@@ -48146,6 +48475,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			setCurrentSessionId(meta.id);
 			setMessages([]);
 			setMessagesCursor(void 0);
+			setError(void 0);
 			setModelId(engine.modelId);
 			await refreshSessions();
 		}).catch((e) => setError({ message: toErrorMessage(e) }));
@@ -48181,6 +48511,7 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 			if (id === currentSessionId) {
 				setCurrentSessionId(void 0);
 				setMessages([]);
+				setError(void 0);
 			}
 			await refreshSessions();
 		}).catch((e) => setError({ message: toErrorMessage(e) }));
@@ -48246,7 +48577,10 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 							...config?.title ? { title: config.title } : {},
 							onOpenSessions: () => setSessionsOpen(true),
 							onCreateSession: handleCreate,
-							...onOpenSettings ? { onOpenSettings: () => onOpenSettings() } : {}
+							...onOpenSettings ? { onOpenSettings: () => onOpenSettings() } : {},
+							...docked !== void 0 ? { docked } : {},
+							...onDock ? { onDock } : {},
+							...onClose ? { onClose } : {}
 						}),
 						/* @__PURE__ */ jsx(InterruptedBanner, {
 							engine,
@@ -48262,7 +48596,9 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 										children: [
 											messages.length === 0 && !sending ? /* @__PURE__ */ jsx(AssistantUiEmptyState, {
 												...config?.title ? { title: config.title } : {},
-												...config?.quickPrompts ? { prompts: config.quickPrompts } : {},
+												...staticQuickPrompts ? { prompts: staticQuickPrompts } : {},
+												...config?.dynamicQuickPrompts ? { dynamicPrompts: config.dynamicQuickPrompts } : {},
+												limit: quickPromptLimit,
 												disabled: sending,
 												onPrompt: handleSend
 											}) : null,
@@ -48343,11 +48679,6 @@ function Chatbot({ adapter, config, locale: localeProp, theme: themeProp, render
 										enabled: multimodal.imageAttachments,
 										imageCapable: modelTakesImages
 									},
-									pageCapture: {
-										enabled: multimodal.pageImageCapture,
-										imageCapable: modelTakesImages,
-										onSelect: () => handleSend(PAGE_CAPTURE_PROMPT)
-									},
 									...dictationLang !== "" ? { dictationLang } : {},
 									...composerModels && !noUsableModel ? { models: composerModels } : {},
 									...noUsableModel ? { noModel: { onConfigure: () => setNoModelGuideOpen(true) } } : {},
@@ -48425,7 +48756,7 @@ function VercelPayloadPreview({ bridge }) {
 * Version of the published `@webskill/chatbot` package, injected at build time.
 * @stable
 */
-const CHATBOT_VERSION = "0.8.0";
+const CHATBOT_VERSION = "0.11.0";
 
 //#endregion
 export { A2uiSurfaceHost, A2uiSurfaceSnapshotHost, CHATBOT_VERSION, ChatEngine, Chatbot, CompositeUiBridge, DEFAULT_RENDERER_CAPABILITIES, DEFAULT_RUNTIME_CONFIG_STORAGE_KEY, ErrorCard, InteractionCard, InterruptedBanner, OpenUiSurfaceHost, OpenUiSurfaceSnapshotHost, ResultBlockList, ResultBlocksPro, SkillBadges, SpecInteraction, VercelPayloadPreview, VercelSurfaceHost, VercelSurfaceSnapshotHost, chatbotDictionary, configureA2uiMarkdown, createLocalStorageRuntimeConfigStore, createMemoryRuntimeConfigStore, isLlmEntryUsable, pickUsableLlmEntry, probeA2uiAvailability, probeOpenUiAvailability, sandboxExecutorDeps, useT };