@tanzerfe/page-use 0.0.4 → 0.0.6

package/README.md

@@ -1,10 +1,6 @@
 # @tanzerfe/page-use
 
-基于 [page-agent](https://github.com/alibaba/page-agent) 的页面操作智能体：接收自然语言指令，在当前页面中模拟点击与输入完成操作，并返回结论。
-
-- **框架无关**：核心不依赖 Vue / React，UI 为 Lit Web Component，在 Shadow DOM 中与宿主样式隔离。
-- **可供其它智能体调用**：支持模块 API、function calling 工具、结构化指令块与全局对象 `window.__TZ_PAGE_USE__`。
-- **Vue 适配层**：`@tanzerfe/page-use/vue` 提供 `PageUseHost` 组件。
+用自然语言操作当前页面：输入一句指令，智能体在页面中自动点击、输入并返回结论。基于 [page-agent](https://github.com/alibaba/page-agent)，框架无关，附带操作面板与 Vue 组件。
 
 ## 安装
 
@@ -12,192 +8,84 @@
 pnpm add @tanzerfe/page-use zod
 ```
 
-`zod` 为必需的 peer 依赖；`vue` / `vue-router` 仅在使用 `@tanzerfe/page-use/vue` 时需要。
-
 ## 快速开始
 
-### 非 Vue 项目
-
-```ts
-import { createPageUse, mountPageUseUI, readLauncherSwitch } from '@tanzerfe/page-use'
-
-const handle = createPageUse({
-  llm: { baseURL: '/api/llm-proxy/v1', model: 'deepseek-chat' },
-  appName: '订单管理系统',
-  getMenus: () => myMenus,          // [{ label, path, hidden?, children? }]
-  routerMode: 'hash',               // 或 'history'
-})
-
-// 调试面板：URL 参数 ?pageUseDebug=1 / 0 可临时开关，否则使用 fallback
-const unmount = mountPageUseUI({ launcher: readLauncherSwitch(import.meta.env.DEV) })
-
-// 登出 / 卸载时
-unmount()
-handle.destroy()
-```
-
-### Vue 3 项目
+### Vue 3
 
 ```vue
 <template>
-  <PageUseHost v-if="options.llm.baseURL" :options="options" :launcher="launcher" />
+  <PageUseHost :options="options" launcher />
 </template>
 
 <script setup lang="ts">
-import { PageUseHost, readLauncherSwitch, type PageUseOptions } from '@tanzerfe/page-use/vue'
+import { PageUseHost, type PageUseOptions } from '@tanzerfe/page-use/vue'
 
 const options: PageUseOptions = {
-  llm: { baseURL: import.meta.env.VITE_PAGE_USE_BASE_URL },
+  llm: { baseURL: '/api/llm-proxy/v1', model: 'deepseek-flash' },
   appName: '订单管理系统',
   getMenus: () => permissionStore.menus,
 }
-const launcher = readLauncherSwitch(import.meta.env.DEV) && { scenarios: [/* ... */] }
 </script>
 ```
 
-`PageUseHost` 自动完成初始化、UI 挂载与卸载销毁，并从 vue-router 推导 `routerMode`、`getCurrentPath`、`resolveRouteName`（显式传入优先）。UI 挂在 `document.body` 下，无需配置 `isCustomElement`。
-
-## 配置 `PageUseOptions`
-
-| 选项 | 类型 | 默认 | 说明 |
-|---|---|---|---|
-| `llm.baseURL` | `string` | — | OpenAI 兼容端点（到版本前缀为止），可用相对路径。**为空时能力不可用** |
-| `llm.apiKey` | `string` | 空 | 前端直连时使用，生产环境建议留空 |
-| `llm.model` | `string` | `deepseek-chat` | 需支持 function calling。默认值仅为示例，使用其它端点时应显式指定 |
-| `llm.maxSteps` | `number` | `20` | 单任务最大步数 |
-| `llm.disableNamedToolChoice` | `boolean` | `false` | 模型不支持对象形式 `tool_choice` 时开启 |
-| `llm.extraBody` | `object` | `{}` | 合并进请求体 |
-| `llm.sessionHeader` | `string \| false` | `x-opencode-session` | 会话 ID 请求头，`false` 不发送 |
-| `appName` | `string` | — | 写入系统提示 |
-| `getMenus` | `() => PageUseMenuNode[]` | 空 | 可见菜单树，用于生成站点地图 |
-| `routerMode` | `'hash' \| 'history'` | `'hash'` | 路由模式 |
-| `getCurrentPath` | `() => string` | 从 location 读取 | 当前路由路径，不含 `#` |
-| `resolveRouteName` | `(path) => string` | — | 由路径解析路由名，用于匹配 `routeHints` |
-| `routeHints` | `Record<string, string>` | `{}` | 按页操作提示，key 为路由名或路径（不带前导 `/`） |
-| `layoutHint` | `string` | 通用描述 | 替换系统提示中的「页面结构」段落 |
-| `beforeTask` | `() => void \| Promise<void>` | — | 任务开始前的预处理，如展开侧栏 |
-| `beforeTaskLabel` | `string` | — | `beforeTask` 在设置面板中的显示名 |
-| `storageKeyPrefix` | `string` | `tz-page-use` | 本地存储键前缀 |
-| `pageAgentOptions` | `Partial<PageAgentConfig>` | `{}` | 透传给 page-agent |
-| `exposeGlobal` | `boolean` | `true` | 是否安装 `window.__TZ_PAGE_USE__` |
-
-### 调试面板 `PageUseLauncherConfig`
-
-| 选项 | 说明 |
-|---|---|
-| `title` | 标题，默认 `Page Use` |
-| `presets` | 追加到「常用」分组的快捷指令 `{ label, task }[]` |
-| `scenarios` | 「复杂场景」分组的快捷指令 |
-| `menuPresetLimit` | 由菜单生成「打开 XX」的数量上限，默认 6 |
-| `sourceLabels` | 任务来源到展示名的映射，如 `{ assistant: 'AI 助手' }` |
-
-调试面板设置中不提供「显示 page-agent 自带面板」与「定制光晕与光标配色」：自带面板始终隐藏，蒙层始终使用定制光晕与光标配色，本地存储中的旧值会被忽略。`PageUseSettings` 仍保留 `showBuiltinPanel` / `customMaskEffect` 字段，但修改不生效。
-
-## 演示播报
-
-演示时可用浏览器语音合成（`speechSynthesis`）同步播报智能体的执行过程，无需宿主额外配置。
-
-- **开关**：调试面板「设置 → 语音播报」，**默认关闭**，状态保存在本地存储（`voiceEnabled`）。开启后可调节语速（`voiceRate`，0.5–2，默认 1.1）并选择中文语音（`voiceName`，默认自动选第一个中文语音）。开关对所有来源的任务生效，包括其它智能体经模块 API、function calling 或全局对象下达的任务。
-- **播报内容**：
-  - 执行步骤：模型对每一步的目标描述；滚动、等待、结束、提问、出错、重试步骤不播报；
-  - 提问：模型向用户提出的问题；
-  - 结论：任务结束时的 `summary`（成功、未达成、出错均播报；被终止的任务不播报）。
-- **不阻塞执行**：智能体不等待语音结束。正在播报时到达的新步骤只保留最新一条待播，中间步骤被丢弃；提问与结论会打断当前播报；新任务开始、终止、销毁或关闭开关时停止播报。
-- **播报时机**：page-agent 在模型调用内部执行点击等动作，目标描述在动作完成后才可获得，因此播报会略晚于页面变化；模型思考期间没有播报。
-- **文本清洗**：播报前去除 Markdown 标记、表格分隔线、链接地址、代码块、emoji 与元素编号（如「索引为 23 的」「[23]」）；清洗后超过 120 字时在句子边界截断，并追加「详细内容请查看面板」。清洗只影响播报，`result.summary`、面板展示与返回给调用方的数据保持原样。
-- **提示词**：开启播报后的下一次任务起，系统提示追加一条约束，要求 `next_goal` 写成面向观众的一句中文、不含元素编号；关闭时系统提示不变。执行中切换开关只影响下一次任务的提示词。
-
-浏览器限制：
-
-- 可用语音取决于操作系统与浏览器。Windows 上的 Edge / Chrome 有中文语音；Linux 上的 Chromium 通常没有，此时设置面板会提示并使用默认语音。
-- 浏览器要求用户与页面交互过才允许发声。从调试面板下达任务、在对话框中输入指令均满足条件；页面加载后未经交互直接调用可能无声。
-- `speechSynthesis` 是整个页面共用的队列。提问 / 结论打断时会调用 `speechSynthesis.cancel()`，宿主页面同时在播报的其它语音也会被停止；反之，宿主调用 `cancel()` 也会停止 Page Use 的播报。
-
-## 对接方式
-
-### 1. 模块 API
+### 其它框架
 
 ```ts
-import { pageUseCapability } from '@tanzerfe/page-use'
+import { createPageUse, mountPageUseUI } from '@tanzerfe/page-use'
 
-if (pageUseCapability.isReady()) {
-  const result = await pageUseCapability.run('打开订单列表，筛选待发货并查询，告诉我第一条订单的收货地址', {
-    source: 'my-agent',
-    signal: controller.signal,
-    onProgress: (event) => { if (event.type === 'activity') console.log(event.text) },
-    onAskUser: async (question) => askInMyChat(question), // 可选
-  })
-  // result.status: completed | failed | stopped | error；result.summary 为结论
-}
+const handle = createPageUse({
+  llm: { baseURL: '/api/llm-proxy/v1', model: 'deepseek-flash' },
+  appName: '订单管理系统',
+  getMenus: () => myMenus, // [{ label, path, children? }]
+})
+const unmount = mountPageUseUI({ launcher: true }) // launcher：显示操作面板
+
+// 退出登录或卸载时
+unmount()
+handle.destroy()
 ```
 
-`run()` 不会 reject。任务未能开始时 `status='error'` 并带 `errorCode`：
+## 常用配置
 
-| errorCode | 含义 |
+| 选项 | 说明 |
 |---|---|
-| `NOT_CONFIGURED` | 未初始化或未配置 `llm.baseURL` |
-| `NOT_READY` | 已 `destroy` |
-| `BUSY` | 已有任务在执行（同一时刻仅一个任务） |
-| `EMPTY_TASK` | 指令为空 |
-| `AGENT_ERROR` | agent 构造或钩子抛出错误 |
+| `llm.baseURL` | OpenAI 兼容接口地址，必填 |
+| `llm.model` | 模型名称，需支持 function calling |
+| `appName` | 系统名称 |
+| `getMenus` | 返回当前用户可见的菜单树，帮助智能体找到页面 |
+| `routerMode` | `'hash'`（默认）或 `'history'`，Vue 项目自动识别 |
 
-- 模型提问时依次交由 `onAskUser`、调试面板处理；两者都不可用时自动回复「无法补充信息」。
-- 进度可订阅 `pageUseStore` 获取，Vue 中使用 `usePageUseState()`。
+> 请勿在前端配置 API Key，生产环境应由网关或代理注入。
 
-### 2. LLM function calling
+## 在其它智能体中调用
 
 ```ts
-import { PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, runPageUseTool } from '@tanzerfe/page-use'
+import { pageUseCapability } from '@tanzerfe/page-use'
 
-// tools: [PAGE_USE_TOOL, ...]
-// 模型返回的 tool_call.name === PAGE_USE_TOOL_NAME 时：
-const { content } = await runPageUseTool(toolCall.function.arguments, { source: 'my-agent' })
-// content 作为 role=tool 的消息回给模型
+const result = await pageUseCapability.run('打开订单列表，告诉我第一条订单的收货地址')
+console.log(result.status, result.summary)
 ```
 
-### 3. 结构化指令块
-
-模型在回复中输出 `{ "type": "pageAction", "instruction": "..." }`，前端用 `isPageUseCommand(value)` 校验后调用 `pageUseCapability.run(value.instruction)`。
-
-### 4. 全局对象
+也可将 `PAGE_USE_TOOL` 作为 function calling 工具提供给模型，并用 `runPageUseTool` 执行。
 
-`window.__TZ_PAGE_USE__` 包含 `pageUseCapability` 的全部方法及 `tool`、`runTool`，可用于控制台调试、E2E 脚本和同源外部脚本：
+## 操作面板
 
-```js
-await window.__TZ_PAGE_USE__.run('打开首页')
-```
-
-## API Key 安全
+- 传入 `launcher` 后，面板入口显示在页面右下角，可拖动。
+- 用户关闭后，可在 URL 上加 `?pageUseDebug=1` 重新显示，或由业务系统调用 `showPageUseLauncher()` 调出。
+- 希望默认隐藏、按需调出时，传入 `launcher: { defaultHidden: true }`。
+- 面板支持快捷指令、历史记录与语音播报。
 
-`llm.apiKey` 会出现在浏览器请求和前端产物中。**生产环境应由网关或代理注入 Key**，前端只传代理地址。
+## 主题
 
-本地开发可用 Vite 代理规避 CORS：
+通过 CSS 变量调整主色：
 
-```ts
-// vite.config.ts
-server: {
-  proxy: {
-    '/__page-use-llm': {
-      target: 'https://api.deepseek.com/v1',
-      changeOrigin: true,
-      rewrite: (p) => p.replace(/^\/__page-use-llm/, ''),
-    },
-  },
+```css
+:root {
+  --tz-page-use-primary: #1677ff;
 }
 ```
 
-## 主题
-
-在宿主页面设置 CSS 变量调整配色，例如 `:root { --tz-page-use-primary: #1677ff }`：
-
-| 变量 | 默认 | 用途 |
-|---|---|---|
-| `--tz-page-use-primary` | `#0879ff` | 主色：入口、按钮、光晕 |
-| `--tz-page-use-cyan` / `--tz-page-use-indigo` | `#36cfc9` / `#597ef7` | 光晕渐变 |
-| `--tz-page-use-warning` | `#fa8c16` | 光晕误触警示 |
-| `--tz-page-use-success` / `--tz-page-use-error` / `--tz-page-use-warning-text` | — | 面板状态色 |
-
-模拟光标配色见导出常量 `PAGE_USE_MASK_COLORS`。
+机器人图标以 `PAGE_USE_ROBOT_ICON_SVG` 导出，可在业务界面中复用。
 
 ## License
 

package/dist/{index-CD2K3C_Q.d.mts → index-D4_hId31.d.mts}

@@ -1,5 +1,5 @@
 import { AgentStatus, PageAgentConfig } from "page-agent";
-import { LitElement, PropertyValues } from "lit";
+import { LitElement, PropertyValues, nothing } from "lit";
 //#region src/core/types.d.ts
 /**
  * Page Use 对外类型：菜单结构、能力 API、进度事件、任务结果。
@@ -139,6 +139,50 @@ interface PageUseCapability {
 }
 declare const pageUseCapability: PageUseCapability;
 //#endregion
+//#region src/voice/engine.d.ts
+/**
+ * 演示播报的语音合成引擎接口。
+ * 宿主可通过 PageUseOptions.tts 注入一个或多个（如不同厂商的在线 TTS 服务），与内置浏览器引擎一起供设置切换。
+ * 播报队列（待播、抢占、清空）由 speaker 统一处理，引擎只负责「把一段文本播出来」。
+ */
+interface PageUseTtsVoice {
+  /** 写入设置 voiceNames[引擎 id] 的值 */
+  value: string;
+  /** 下拉框显示名 */
+  label: string;
+}
+interface PageUseTtsSpeakOptions {
+  /** 语速倍率（设置 voiceRate，1 为正常语速）；引擎自行换算为服务参数 */
+  rate: number;
+  /** 当前引擎在设置 voiceNames 中的音色；空串表示由引擎自动选择 */
+  voice: string;
+  /** 播报被抢占或清空时触发：引擎应立即停止自身的合成与播放并 resolve */
+  signal: AbortSignal;
+}
+interface PageUseTtsEngine {
+  /**
+   * 稳定标识：作为设置中所选引擎（voiceEngineId）与各引擎音色（voiceNames）的保存键，
+   * 修改后已保存的选择会失效。'browser' 保留给内置浏览器引擎，注入同名引擎会被忽略。
+   */
+  id: string;
+  /** 引擎名称，显示在调试面板播报设置中 */
+  label: string;
+  /**
+   * true：一组句子逐句调用 speak（适合本地合成，句间无额外延迟）；
+   * false：整组句子合并为一次调用（适合在线服务，避免每句建连的停顿与调用次数）。
+   */
+  splitSentences: boolean;
+  /** 当前环境是否可用；不可用时播报静默跳过，设置面板显示提示 */
+  isAvailable(): boolean;
+  /** 可选音色列表；不提供或返回空时设置面板不显示音色下拉框 */
+  listVoices?(): PageUseTtsVoice[];
+  /**
+   * 播报一段文本，播完、失败或被中止时 resolve。
+   * 约定不 reject：失败由引擎自行记录，队列继续推进（speaker 仍会兜底捕获）。
+   */
+  speak(text: string, options: PageUseTtsSpeakOptions): Promise<void>;
+}
+//#endregion
 //#region src/core/options.d.ts
 /** 默认模型，仅为示例取值；接入其它端点时应通过 llm.model 显式指定支持 function calling 的模型 */
 declare const DEFAULT_MODEL = "deepseek-chat";
@@ -202,6 +246,11 @@ interface PageUseOptions {
   pageAgentOptions?: Partial<PageAgentConfig>;
   /** 是否安装 window.__TZ_PAGE_USE__ 全局桥接，默认 true */
   exposeGlobal?: boolean;
+  /**
+   * 演示播报的语音合成引擎（如不同厂商的在线 TTS 服务），可传单个或数组。
+   * 内置浏览器引擎（本地语音）始终可选且为默认引擎，排在下拉框最前；用户可在调试面板设置中切换到注入的引擎。
+   */
+  tts?: PageUseTtsEngine | PageUseTtsEngine[];
 }
 interface NormalizedLLMOptions {
   /** 绝对地址；page-agent 内部 `new URL(baseURL)` 解析，相对路径会抛错 */
@@ -228,6 +277,8 @@ interface NormalizedPageUseOptions {
   storageKeyPrefix: string;
   pageAgentOptions: Partial<PageAgentConfig>;
   exposeGlobal: boolean;
+  /** 可选引擎：注入引擎（去重）在前，浏览器引擎在最后；至少含浏览器引擎 */
+  ttsEngines: PageUseTtsEngine[];
 }
 declare function normalizeOptions(options: PageUseOptions): NormalizedPageUseOptions;
 /**
@@ -261,6 +312,11 @@ interface PageUseLauncherConfig {
   menuPresetLimit?: number;
   /** 任务来源 → 展示名；未登记的来源直接显示原值 */
   sourceLabels?: Record<string, string>;
+  /**
+   * 默认隐藏调试入口，由业务系统调用 showPageUseLauncher() 或 URL 参数 pageUseDebug=1 调出。
+   * 仅在用户从未关闭 / 显示过入口（设置 launcherVisible 为 null）时生效。
+   */
+  defaultHidden?: boolean;
 }
 declare class PageUseLauncherElement extends LitElement {
   static styles: import("lit").CSSResult;
@@ -268,11 +324,22 @@ declare class PageUseLauncherElement extends LitElement {
   /** 面板配置；赋值后立即重新渲染 */
   get config(): PageUseLauncherConfig;
   set config(value: PageUseLauncherConfig | undefined);
+  /** 撤销本面板登记的播报用面板名称 */
+  private unregisterPanelName;
+  /** 把面板标题登记为播报截断提示中的面板名称（「详细内容请查看「标题」」） */
+  private syncPanelName;
   private open;
-  private showSettings;
+  private view;
+  /** 标题点击时间戳（毫秒），用于元信息面板解锁的滑动窗口计数；不持久化 */
+  private titleTaps;
   private task;
   private answer;
   private tray;
+  /** 快捷指令编辑视图中正在编辑的表单；同一时刻只有一个，离开编辑视图时清空 */
+  private presetDraft;
+  /** 面板内轻提示文字；空串为不显示 */
+  private toastText;
+  private toastTimer;
   /**
    * 日志区跟随滚动：默认贴底跟随新内容；用户上翻后停止跟随，
    * 回到底部附近（阈值内）或点击「最新」后恢复。
@@ -295,6 +362,12 @@ declare class PageUseLauncherElement extends LitElement {
    */
   private panelAnchor;
   private wasRunning;
+  /** 入口按钮上次渲染时是否为「执行中」文案；文案切换时用于触发宽度过渡 */
+  private fabShowsRunning;
+  /** 文案切换前的入口宽度（px）；null 表示本次更新不需要宽度过渡 */
+  private fabFromWidth;
+  /** 进行中宽度过渡的结束回调注销函数；过渡中再次切换时先注销，避免旧回调提前清除宽度 */
+  private fabWidthCleanup;
   private cleanups;
   private get fabEl();
   private get panelEl();
@@ -305,8 +378,22 @@ declare class PageUseLauncherElement extends LitElement {
   private panelDrag;
   connectedCallback(): void;
   disconnectedCallback(): void;
-  /** Chrome 的语音列表异步加载，首次读取可能为空：加载完成后刷新语音下拉框 */
+  /** 可选播报引擎：宿主注入的引擎 + 浏览器引擎；尚未 createPageUse 时只有浏览器引擎 */
+  private ttsEngines;
+  /** 当前生效的播报引擎，与 narration 使用同一解析规则 */
+  private ttsEngine;
+  /**
+   * Chrome 的语音列表异步加载，首次读取可能为空：加载完成后刷新语音下拉框。
+   * 挂载时宿主可能尚未注入引擎，因此不按引擎判断；注入引擎时该事件只触发一次无害的重绘。
+   */
   private watchVoices;
+  /**
+   * 入口文案在「执行中」与标题之间切换时宽度会变化；CSS 无法对 width:auto 过渡，
+   * 因此在渲染新文案前记录旧宽度，渲染后由 animateFabWidth 从旧宽度过渡到新宽度。
+   */
+  protected willUpdate(): void;
+  /** 从记录的旧宽度过渡到新文案的自然宽度，结束后恢复自动宽度并重新测量入口尺寸 */
+  private animateFabWidth;
   protected firstUpdated(): void;
   protected updated(_changed: PropertyValues): void;
   private onStateChange;
@@ -319,6 +406,19 @@ declare class PageUseLauncherElement extends LitElement {
   private fabStyle;
   /** 面板位置完全由入口位置推导，展开时与入口重合于同一角 */
   private panelStyle;
+  /** 调试入口是否显示：持久化状态优先，未操作过时跟随宿主 defaultHidden */
+  private isVisible;
+  /** 展开面板（showPageUseLauncher 调用）：等入口按新的显示状态渲染后再测量定位 */
+  private expand;
+  /** 关闭调试入口：收起面板并持久化隐藏状态，之后需调用显示方法或 URL 参数调出 */
+  private close;
+  /** 标题点击计数：滑动窗口内达到次数时打开元信息面板并重新计数 */
+  private onTitleTap;
+  /** 切换面板视图：离开设置页时中止音色试听，离开快捷指令编辑时丢弃未保存的草稿 */
+  private switchView;
+  /** 在面板内显示轻提示，TOAST_DURATION_MS 后自动消失；连续触发时以最后一次为准并重新计时 */
+  private showToast;
+  private clearHistory;
   private collapse;
   private submit;
   private applyPreset;
@@ -339,18 +439,35 @@ declare class PageUseLauncherElement extends LitElement {
   private toggleTray;
   private onClearLog;
   private sourceLabel;
-  private presets;
-  private endpointLabel;
+  /** 快捷指令分组：来源指令排除用户隐藏项，外加用户自定义指令；展示区与编辑视图共用 */
+  private presetGroups;
   private renderChips;
+  /** 分组顺序：我的 → 常用 → 复杂场景；空分组不显示，全部为空时提示去设置中维护 */
   private renderPresetGroups;
   private renderCheckbox;
   private renderSettings;
-  /** 演示播报：开关 + 兼容提示；开启后显示语速与中文语音选择 */
+  /** 打开表单：id 为 null 时新增，否则编辑该条；替换当前未保存的草稿 */
+  private editPreset;
+  private savePreset;
+  private renderPresetForm;
+  /** 列表项：名称一行，指令内容灰色单行省略（悬停查看全文），右侧为操作按钮 */
+  private renderPresetItem;
+  /**
+   * 快捷指令编辑：我的指令（新增 / 编辑 / 删除）、按来源分组的来源指令（删除即隐藏）、
+   * 已隐藏条数与恢复按钮。任务执行中同样可编辑，只影响后续展示。
+   */
+  private renderPresetEditor;
+  /**
+   * 演示播报：总开关关闭时只显示开关；开启后依次为引擎下拉（可选引擎多于一个时）、
+   * 语速、音色下拉与试听按钮（无音色列表时只有试听按钮）、不可用 / 无中文语音提示。
+   */
   private renderVoiceSettings;
+  /** 元信息：与业务无关的配置与运行环境信息，仅供开发排查；API Key 只显示是否已配置 */
+  private renderMeta;
   private renderLog;
   private renderTray;
   private renderComposer;
-  render(): import("lit").TemplateResult<1>;
+  render(): typeof nothing | import("lit").TemplateResult<1>;
 }
 //#endregion
 //#region src/ui/mount.d.ts
@@ -409,12 +526,25 @@ interface PageUseCommand {
 }
 declare function isPageUseCommand(value: unknown): value is PageUseCommand;
 //#endregion
+//#region src/ui/launcherControl.d.ts
+/**
+ * 显示调试入口并展开面板，状态持久化。
+ * 宿主未挂载调试面板时只保存状态并警告，之后挂载的面板按该状态显示。
+ */
+declare function showPageUseLauncher(): void;
+/** 隐藏调试入口（面板与浮动入口），状态持久化；效果与面板标题栏的关闭按钮相同 */
+declare function hidePageUseLauncher(): void;
+//#endregion
 //#region src/capability/bridge.d.ts
 /** window 上的挂载名 */
 declare const PAGE_USE_GLOBAL_KEY = "__TZ_PAGE_USE__";
 interface PageUseGlobal extends PageUseCapability {
   tool: typeof PAGE_USE_TOOL;
   runTool: typeof runPageUseTool;
+  /** 调出调试面板（显示入口并展开），状态持久化；UI 控制不属于 pageUseCapability */
+  showLauncher: typeof showPageUseLauncher;
+  /** 隐藏调试入口，状态持久化 */
+  hideLauncher: typeof hidePageUseLauncher;
 }
 declare global {
   interface Window {
@@ -477,6 +607,11 @@ declare function getPageUseConfig(): NormalizedPageUseOptions | null;
  */
 declare function clearPageUseLog(): void;
 //#endregion
+//#region src/voice/browserEngine.d.ts
+/** 内置浏览器引擎的保留 id；注入引擎使用该 id 会被忽略 */
+declare const BROWSER_ENGINE_ID = "browser";
+declare const browserTtsEngine: PageUseTtsEngine;
+//#endregion
 //#region src/core/settings.d.ts
 interface PageUsePoint {
   x: number;
@@ -495,12 +630,19 @@ interface PageUseSettings {
   enableMask: boolean;
   /** 蒙层使用定制光晕与光标配色（false = page-agent 默认 ai-motion 效果） */
   customMaskEffect: boolean;
-  /** 演示播报：用浏览器语音合成播报执行步骤、提问与结论；默认关闭 */
+  /** 演示播报总开关：播报执行步骤、提问与结论；默认关闭 */
   voiceEnabled: boolean;
-  /** 播报语速（SpeechSynthesisUtterance.rate，1 为正常语速） */
+  /** 播报语速倍率（1 为正常语速），所有引擎共用，由引擎自行换算 */
   voiceRate: number;
-  /** 播报语音名（SpeechSynthesisVoice.name）；空串表示自动选择第一个中文语音 */
-  voiceName: string;
+  /** 所选播报引擎 id；空串表示默认引擎（浏览器引擎，即本地语音） */
+  voiceEngineId: string;
+  /** 各引擎的音色，键为引擎 id；缺省或空串表示由引擎自动选择（浏览器引擎为第一个中文语音） */
+  voiceNames: Record<string, string>;
+  /**
+   * 调试入口是否显示：true / false 为用户关闭或方法调用后的持久化结果；
+   * null 表示从未操作过，跟随宿主 PageUseLauncherConfig.defaultHidden。
+   */
+  launcherVisible: boolean | null;
   /** 浮动入口位置（null = 默认右下角）；面板展开时以入口为锚点定位，不单独存位置 */
   fabPos: PageUsePoint | null;
 }
@@ -539,11 +681,58 @@ declare const pageUseHistory: {
   clear(): void;
 };
 //#endregion
+//#region src/core/presetStore.d.ts
+interface PageUseCustomPreset extends PageUsePreset {
+  /** 本地生成的稳定标识，用于编辑定位与列表渲染 key；不参与去重（去重按 task） */
+  id: string;
+}
+interface PageUsePresetState {
+  custom: PageUseCustomPreset[];
+  /** 被隐藏的来源指令 task 文本（已去重） */
+  hidden: string[];
+}
+/**
+ * 新增 / 编辑的校验结果：
+ * - label-empty / task-empty：去除首尾空白后为空
+ * - duplicate：task 与另一条自定义指令相同
+ * - not-found：编辑的 id 不存在（已被其它入口删除）
+ */
+type PageUsePresetSaveResult = {
+  ok: true;
+} | {
+  ok: false;
+  reason: 'label-empty' | 'task-empty' | 'duplicate' | 'not-found';
+};
+declare const pageUsePresets: {
+  store: ReadonlyStore<PageUsePresetState>;
+  get(): PageUsePresetState;
+  /** 新增自定义指令，排在最前；label / task 去除首尾空白后保存 */
+  add(preset: PageUsePreset): PageUsePresetSaveResult;
+  /** 编辑自定义指令，位置不变 */
+  update(id: string, preset: PageUsePreset): PageUsePresetSaveResult;
+  remove(id: string): void;
+  /** 隐藏一条来源指令（以 task 文本为标识）；已隐藏时不重复记录 */
+  hide(task: string): void;
+  /** 恢复全部被隐藏的来源指令（含已失效的记录）；不影响自定义指令 */
+  restoreHidden(): void;
+};
+//#endregion
 //#region src/ui/presets.d.ts
 /** 通用示例：不依赖具体站点，覆盖详情、标签、返回等典型操作 */
 declare const PAGE_USE_STATIC_PRESETS: readonly PageUsePreset[];
-/** 取前 N 个可见叶子菜单，生成「打开 XX」快捷指令 */
-declare function buildMenuPresets(menus: PageUseMenuNode[] | undefined, limit?: number): PageUsePreset[];
+/**
+ * 取前 N 个可见叶子菜单，生成「打开 XX」快捷指令。
+ * exclude 中的 task 被跳过且不占名额，由后续菜单补位（用户隐藏菜单指令时使用）。
+ */
+declare function buildMenuPresets(menus: PageUseMenuNode[] | undefined, limit?: number, exclude?: ReadonlySet<string>): PageUsePreset[];
+//#endregion
+//#region src/ui/icons.d.ts
+/**
+ * 页面智能体机器人图标（天线 + 屏幕式头部 + 双眼）的 SVG 字符串，供宿主在自身界面中复用（如智能体列表卡片）。
+ * 颜色全部跟随 currentColor，不含 width / height，尺寸由宿主 CSS 控制；viewBox 为 24×24、线宽 2。
+ * robot-antenna / robot-eye 类名供面板在执行中做闪烁与眨眼动画，宿主不定义对应样式时无影响。
+ */
+declare const PAGE_USE_ROBOT_ICON_SVG = "<svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" aria-hidden=\"true\">\n  <circle class=\"robot-antenna\" cx=\"12\" cy=\"3\" r=\"1.5\" fill=\"currentColor\" stroke=\"none\" />\n  <path d=\"M12 4.5V7\" />\n  <rect x=\"4\" y=\"7\" width=\"16\" height=\"12.5\" rx=\"4\" />\n  <path d=\"M2 12v3.5\" /><path d=\"M22 12v3.5\" />\n  <circle class=\"robot-eye\" cx=\"9\" cy=\"12.5\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\" />\n  <circle class=\"robot-eye\" cx=\"15\" cy=\"12.5\" r=\"1.6\" fill=\"currentColor\" stroke=\"none\" />\n  <path d=\"M9.5 16.3h5\" />\n</svg>";
 //#endregion
 //#region src/ui/glow.d.ts
 declare const PAGE_USE_GLOW_TAG = "tz-page-use-glow";
@@ -591,4 +780,4 @@ declare const PAGE_USE_MASK_COLORS: {
   readonly warning: "#fa8c16";
 };
 //#endregion
-export { PageUsePreset as $, runPageUseTool as A, DEFAULT_MODEL as B, PageUseGlobal as C, PageUseCommand as D, PAGE_USE_TOOL_NAME as E, PageUseLauncherConfig as F, PageUseOptions as G, DEFAULT_STORAGE_KEY_PREFIX as H, PageUseLauncherElement as I, readLauncherSwitch as J, PageUseRouterMode as K, PageUseHandle as L, definePageUseElements as M, mountPageUseUI as N, formatPageUseResultForModel as O, PAGE_USE_LAUNCHER_TAG as P, PageUseMenuNode as Q, createPageUse as R, PAGE_USE_GLOBAL_KEY as S, PAGE_USE_TOOL as T, NormalizedPageUseOptions as U, DEFAULT_SESSION_HEADER as V, PageUseLLMOptions as W, pageUseCapability as X, PageUseCapability as Y, PageUseErrorCode as Z, getPageUseConfig as _, PAGE_USE_STATIC_PRESETS as a, PageUseTaskSource as at, pageUseStore as b, pageUseHistory as c, PageUseSettings as d, PageUseProgressEvent as et, pageUseSettings as f, getElapsedSeconds as g, clearPageUseLog as h, PageUseGlowElement as i, PageUseTaskResult as it, MountPageUseUIOptions as j, isPageUseCommand as k, DEFAULT_PAGE_USE_SETTINGS as l, PageUseState as m, SIMULATOR_MASK_ID as n, PageUseSnapshot as nt, buildMenuPresets as o, PageUseTaskStatus as ot, PageUseQuestion as p, normalizeOptions as q, PAGE_USE_GLOW_TAG as r, PageUseStepLog as rt, PageUseHistoryEntry as s, PAGE_USE_MASK_COLORS as t, PageUseRunOptions as tt, PageUsePoint as u, isPageUseConfigured as v, PAGE_USE_COMMAND_TYPE as w, ReadonlyStore as x, isRunning as y, DEFAULT_MAX_STEPS as z };
+export { PageUseLLMOptions as $, PageUseGlobal as A, MountPageUseUIOptions as B, getElapsedSeconds as C, pageUseStore as D, isRunning as E, PAGE_USE_TOOL_NAME as F, PageUseLauncherElement as G, mountPageUseUI as H, PageUseCommand as I, DEFAULT_MAX_STEPS as J, PageUseHandle as K, formatPageUseResultForModel as L, showPageUseLauncher as M, PAGE_USE_COMMAND_TYPE as N, ReadonlyStore as O, PAGE_USE_TOOL as P, NormalizedPageUseOptions as Q, isPageUseCommand as R, clearPageUseLog as S, isPageUseConfigured as T, PAGE_USE_LAUNCHER_TAG as U, definePageUseElements as V, PageUseLauncherConfig as W, DEFAULT_SESSION_HEADER as X, DEFAULT_MODEL as Y, DEFAULT_STORAGE_KEY_PREFIX as Z, pageUseSettings as _, PageUseTaskSource as _t, PAGE_USE_ROBOT_ICON_SVG as a, PageUseTtsSpeakOptions as at, PageUseQuestion as b, PageUseCustomPreset as c, pageUseCapability as ct, pageUsePresets as d, PageUsePreset as dt, PageUseOptions as et, PageUseHistoryEntry as f, PageUseProgressEvent as ft, PageUseSettings as g, PageUseTaskResult as gt, PageUsePoint as h, PageUseStepLog as ht, PageUseGlowElement as i, PageUseTtsEngine as it, hidePageUseLauncher as j, PAGE_USE_GLOBAL_KEY as k, PageUsePresetSaveResult as l, PageUseErrorCode as lt, DEFAULT_PAGE_USE_SETTINGS as m, PageUseSnapshot as mt, SIMULATOR_MASK_ID as n, normalizeOptions as nt, PAGE_USE_STATIC_PRESETS as o, PageUseTtsVoice as ot, pageUseHistory as p, PageUseRunOptions as pt, createPageUse as q, PAGE_USE_GLOW_TAG as r, readLauncherSwitch as rt, buildMenuPresets as s, PageUseCapability as st, PAGE_USE_MASK_COLORS as t, PageUseRouterMode as tt, PageUsePresetState as u, PageUseMenuNode as ut, BROWSER_ENGINE_ID as v, PageUseTaskStatus as vt, getPageUseConfig as w, PageUseState as x, browserTtsEngine as y, runPageUseTool as z };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as PageUsePreset, A as runPageUseTool, B as DEFAULT_MODEL, C as PageUseGlobal, D as PageUseCommand, E as PAGE_USE_TOOL_NAME, F as PageUseLauncherConfig, G as PageUseOptions, H as DEFAULT_STORAGE_KEY_PREFIX, I as PageUseLauncherElement, J as readLauncherSwitch, K as PageUseRouterMode, L as PageUseHandle, M as definePageUseElements, N as mountPageUseUI, O as formatPageUseResultForModel, P as PAGE_USE_LAUNCHER_TAG, Q as PageUseMenuNode, R as createPageUse, S as PAGE_USE_GLOBAL_KEY, T as PAGE_USE_TOOL, U as NormalizedPageUseOptions, V as DEFAULT_SESSION_HEADER, W as PageUseLLMOptions, X as pageUseCapability, Y as PageUseCapability, Z as PageUseErrorCode, _ as getPageUseConfig, a as PAGE_USE_STATIC_PRESETS, at as PageUseTaskSource, b as pageUseStore, c as pageUseHistory, d as PageUseSettings, et as PageUseProgressEvent, f as pageUseSettings, g as getElapsedSeconds, h as clearPageUseLog, i as PageUseGlowElement, it as PageUseTaskResult, j as MountPageUseUIOptions, k as isPageUseCommand, l as DEFAULT_PAGE_USE_SETTINGS, m as PageUseState, n as SIMULATOR_MASK_ID, nt as PageUseSnapshot, o as buildMenuPresets, ot as PageUseTaskStatus, p as PageUseQuestion, q as normalizeOptions, r as PAGE_USE_GLOW_TAG, rt as PageUseStepLog, s as PageUseHistoryEntry, t as PAGE_USE_MASK_COLORS, tt as PageUseRunOptions, u as PageUsePoint, v as isPageUseConfigured, w as PAGE_USE_COMMAND_TYPE, x as ReadonlyStore, y as isRunning, z as DEFAULT_MAX_STEPS } from "./index-CD2K3C_Q.mjs";
-export { DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, type MountPageUseUIOptions, type NormalizedPageUseOptions, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, type PageUseCapability, type PageUseCommand, type PageUseErrorCode, type PageUseGlobal, PageUseGlowElement, type PageUseHandle, type PageUseHistoryEntry, type PageUseLLMOptions, type PageUseLauncherConfig, PageUseLauncherElement, type PageUseMenuNode, type PageUseOptions, type PageUsePoint, type PageUsePreset, type PageUseProgressEvent, type PageUseQuestion, type PageUseRouterMode, type PageUseRunOptions, type PageUseSettings, type PageUseSnapshot, type PageUseState, type PageUseStepLog, type PageUseTaskResult, type PageUseTaskSource, type PageUseTaskStatus, type ReadonlyStore, SIMULATOR_MASK_ID, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool };
+import { $ as PageUseLLMOptions, A as PageUseGlobal, B as MountPageUseUIOptions, C as getElapsedSeconds, D as pageUseStore, E as isRunning, F as PAGE_USE_TOOL_NAME, G as PageUseLauncherElement, H as mountPageUseUI, I as PageUseCommand, J as DEFAULT_MAX_STEPS, K as PageUseHandle, L as formatPageUseResultForModel, M as showPageUseLauncher, N as PAGE_USE_COMMAND_TYPE, O as ReadonlyStore, P as PAGE_USE_TOOL, Q as NormalizedPageUseOptions, R as isPageUseCommand, S as clearPageUseLog, T as isPageUseConfigured, U as PAGE_USE_LAUNCHER_TAG, V as definePageUseElements, W as PageUseLauncherConfig, X as DEFAULT_SESSION_HEADER, Y as DEFAULT_MODEL, Z as DEFAULT_STORAGE_KEY_PREFIX, _ as pageUseSettings, _t as PageUseTaskSource, a as PAGE_USE_ROBOT_ICON_SVG, at as PageUseTtsSpeakOptions, b as PageUseQuestion, c as PageUseCustomPreset, ct as pageUseCapability, d as pageUsePresets, dt as PageUsePreset, et as PageUseOptions, f as PageUseHistoryEntry, ft as PageUseProgressEvent, g as PageUseSettings, gt as PageUseTaskResult, h as PageUsePoint, ht as PageUseStepLog, i as PageUseGlowElement, it as PageUseTtsEngine, j as hidePageUseLauncher, k as PAGE_USE_GLOBAL_KEY, l as PageUsePresetSaveResult, lt as PageUseErrorCode, m as DEFAULT_PAGE_USE_SETTINGS, mt as PageUseSnapshot, n as SIMULATOR_MASK_ID, nt as normalizeOptions, o as PAGE_USE_STATIC_PRESETS, ot as PageUseTtsVoice, p as pageUseHistory, pt as PageUseRunOptions, q as createPageUse, r as PAGE_USE_GLOW_TAG, rt as readLauncherSwitch, s as buildMenuPresets, st as PageUseCapability, t as PAGE_USE_MASK_COLORS, tt as PageUseRouterMode, u as PageUsePresetState, ut as PageUseMenuNode, v as BROWSER_ENGINE_ID, vt as PageUseTaskStatus, w as getPageUseConfig, x as PageUseState, y as browserTtsEngine, z as runPageUseTool } from "./index-D4_hId31.mjs";
+export { BROWSER_ENGINE_ID, DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, type MountPageUseUIOptions, type NormalizedPageUseOptions, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_ROBOT_ICON_SVG, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, type PageUseCapability, type PageUseCommand, type PageUseCustomPreset, type PageUseErrorCode, type PageUseGlobal, PageUseGlowElement, type PageUseHandle, type PageUseHistoryEntry, type PageUseLLMOptions, type PageUseLauncherConfig, PageUseLauncherElement, type PageUseMenuNode, type PageUseOptions, type PageUsePoint, type PageUsePreset, type PageUsePresetSaveResult, type PageUsePresetState, type PageUseProgressEvent, type PageUseQuestion, type PageUseRouterMode, type PageUseRunOptions, type PageUseSettings, type PageUseSnapshot, type PageUseState, type PageUseStepLog, type PageUseTaskResult, type PageUseTaskSource, type PageUseTaskStatus, type PageUseTtsEngine, type PageUseTtsSpeakOptions, type PageUseTtsVoice, type ReadonlyStore, SIMULATOR_MASK_ID, browserTtsEngine, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, hidePageUseLauncher, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUsePresets, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool, showPageUseLauncher };

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import { A as DEFAULT_STORAGE_KEY_PREFIX, C as pageUseStore, D as DEFAULT_MAX_STEPS, E as pageUseSettings, M as readLauncherSwitch, N as PAGE_USE_MASK_COLORS, O as DEFAULT_MODEL, P as SIMULATOR_MASK_ID, S as isRunning, T as DEFAULT_PAGE_USE_SETTINGS, _ as pageUseCapability, a as PAGE_USE_STATIC_PRESETS, b as getPageUseConfig, c as PageUseGlowElement, d as PAGE_USE_COMMAND_TYPE, f as PAGE_USE_TOOL, g as runPageUseTool, h as isPageUseCommand, i as PageUseLauncherElement, j as normalizeOptions, k as DEFAULT_SESSION_HEADER, l as createPageUse, m as formatPageUseResultForModel, n as mountPageUseUI, o as buildMenuPresets, p as PAGE_USE_TOOL_NAME, r as PAGE_USE_LAUNCHER_TAG, s as PAGE_USE_GLOW_TAG, t as definePageUseElements, u as PAGE_USE_GLOBAL_KEY, v as clearPageUseLog, w as pageUseHistory, x as isPageUseConfigured, y as getElapsedSeconds } from "./src-B9wNTD0L.mjs";
+import { A as pageUseSettings, B as browserTtsEngine, C as getPageUseConfig, D as pageUsePresets, E as pageUseStore, F as normalizeOptions, I as readLauncherSwitch, L as PAGE_USE_MASK_COLORS, M as DEFAULT_MODEL, N as DEFAULT_SESSION_HEADER, O as pageUseHistory, P as DEFAULT_STORAGE_KEY_PREFIX, R as SIMULATOR_MASK_ID, S as getElapsedSeconds, T as isRunning, _ as runPageUseTool, a as PAGE_USE_STATIC_PRESETS, b as pageUseCapability, c as PAGE_USE_GLOW_TAG, d as PAGE_USE_GLOBAL_KEY, f as PAGE_USE_COMMAND_TYPE, g as isPageUseCommand, h as formatPageUseResultForModel, i as PageUseLauncherElement, j as DEFAULT_MAX_STEPS, k as DEFAULT_PAGE_USE_SETTINGS, l as PageUseGlowElement, m as PAGE_USE_TOOL_NAME, n as mountPageUseUI, o as buildMenuPresets, p as PAGE_USE_TOOL, r as PAGE_USE_LAUNCHER_TAG, s as PAGE_USE_ROBOT_ICON_SVG, t as definePageUseElements, u as createPageUse, v as hidePageUseLauncher, w as isPageUseConfigured, x as clearPageUseLog, y as showPageUseLauncher, z as BROWSER_ENGINE_ID } from "./src-CHB0xWWP.mjs";
 
-export { DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, PageUseGlowElement, PageUseLauncherElement, SIMULATOR_MASK_ID, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool };
+export { BROWSER_ENGINE_ID, DEFAULT_MAX_STEPS, DEFAULT_MODEL, DEFAULT_PAGE_USE_SETTINGS, DEFAULT_SESSION_HEADER, DEFAULT_STORAGE_KEY_PREFIX, PAGE_USE_COMMAND_TYPE, PAGE_USE_GLOBAL_KEY, PAGE_USE_GLOW_TAG, PAGE_USE_LAUNCHER_TAG, PAGE_USE_MASK_COLORS, PAGE_USE_ROBOT_ICON_SVG, PAGE_USE_STATIC_PRESETS, PAGE_USE_TOOL, PAGE_USE_TOOL_NAME, PageUseGlowElement, PageUseLauncherElement, SIMULATOR_MASK_ID, browserTtsEngine, buildMenuPresets, clearPageUseLog, createPageUse, definePageUseElements, formatPageUseResultForModel, getElapsedSeconds, getPageUseConfig, hidePageUseLauncher, isPageUseCommand, isPageUseConfigured, isRunning, mountPageUseUI, normalizeOptions, pageUseCapability, pageUseHistory, pageUsePresets, pageUseSettings, pageUseStore, readLauncherSwitch, runPageUseTool, showPageUseLauncher };