@tanzerfe/page-use 0.0.5 → 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,315 +8,85 @@
 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
-// 生产环境需由业务系统按需调出时，改为常驻挂载：mountPageUseUI({ launcher: { defaultHidden: true } })
-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__` |
-| `tts` | `PageUseTtsEngine \| PageUseTtsEngine[]` | — | 演示播报的在线语音合成引擎，见「自定义语音合成引擎」 |
-
-### 调试面板 `PageUseLauncherConfig`
-
-| 选项 | 说明 |
-|---|---|
-| `title` | 标题，默认 `Page Use` |
-| `presets` | 追加到「常用」分组的快捷指令 `{ label, task }[]` |
-| `scenarios` | 「复杂场景」分组的快捷指令 |
-| `menuPresetLimit` | 由菜单生成「打开 XX」的数量上限，默认 6 |
-| `sourceLabels` | 任务来源到展示名的映射，如 `{ assistant: 'AI 助手' }` |
-| `defaultHidden` | 默认隐藏调试入口，由业务系统调用方法或 URL 参数调出；仅在用户从未关闭 / 显示过入口时生效，默认 `false` |
-
-**标题栏**：从左到右为状态圆点、标题、执行状态，以及按钮「静音 · 设置（⚙）· 收起（−）· 关闭（×）」。
-
-- 执行状态：空闲时不显示（悬停状态圆点可查看，设置页顶部显示「当前状态」）；其它状态显示「状态 · N 步 · token · 耗时」，token 数小于 1000 显示原值，否则以 `k` / `M` 为单位并保留 1 位小数（如 `12.3k tok`、`1.5M tok`）。
-- 静音：仅在任务执行中且开启语音播报时显示，见「演示播报」。
-- 收起：面板收起为浮动入口。
-- 关闭：隐藏面板与浮动入口，状态持久化，刷新后仍隐藏；重新打开见「调试入口的显示与隐藏」。
-
-**元信息面板**：在任意连续 5 秒内点击面板标题 10 次打开，用于开发排查，展示包版本、LLM 端点完整地址、模型、API Key 是否已配置（只显示「已配置 / 未配置」，不展示明文）、存储键前缀、当前播报引擎与音色、全部可选引擎（id、名称、是否可用）。点击 ⚙ 位置的按钮返回；打开状态不持久化。设置页不再展示端点与模型。
-
-#### 快捷指令
-
-快捷指令在空执行记录页与输入框上方的「快捷指令」托盘中展示，分组顺序为：
-
-1. 「我的」：用户在面板中自定义的指令；没有自定义指令时不显示；
-2. 「常用」：由菜单生成的「打开 XX」（最多 `menuPresetLimit` 条）、库内置通用示例、宿主 `presets`；
-3. 「复杂场景」：宿主 `scenarios`，为空时不显示。
-
-设置页最底部的「快捷指令设置」进入编辑视图，标题栏返回按钮依次回到设置页、主视图：
-
-- 自定义指令：可新增、编辑、删除；名称与指令内容必填，指令内容不能与已有自定义指令重复；新增的指令排在最前。
-- 来源指令（上述菜单、内置、`presets`、`scenarios` 四类）：可删除。删除只是在本地隐藏，不修改宿主配置。隐藏记录以指令内容（`task`）为标识，宿主修改某条指令的 `task` 后，该条会重新显示。
-- 菜单生成的指令被隐藏后，由后续菜单补位，数量仍为 `menuPresetLimit`（可见菜单不足时除外）。
-- 「恢复默认指令」：恢复全部已隐藏的来源指令，不影响自定义指令；当前没有被隐藏的来源指令时禁用。
-- 任务执行中也可编辑，只影响之后的展示，不影响正在执行的任务。
-
-自定义指令与隐藏记录保存在 localStorage，键为 `${storageKeyPrefix}-presets`。宿主也可通过导出的 `pageUsePresets` 读取或维护这些数据（`add` / `update` / `remove` / `hide` / `restoreHidden`，订阅使用 `pageUsePresets.store`）。
-
-#### 调试入口的显示与隐藏
-
-入口是否显示按以下优先级判定（面板挂载时）：
-
-1. URL 参数 `pageUseDebug`：`1` / `true` 显示，`0` / `false` 隐藏，并写入持久化状态；
-2. 持久化状态（设置 `launcherVisible`，localStorage）：用户点击关闭或调用下述方法后写入；
-3. 宿主配置 `defaultHidden`：前两者都未设置时生效，默认显示。
-
-业务系统可调用以下方法调出或隐藏入口（显示方法同时展开面板），状态均持久化：
-
-```ts
-import { showPageUseLauncher, hidePageUseLauncher } from '@tanzerfe/page-use'
-
-showPageUseLauncher()
-hidePageUseLauncher()
-
-// 不走模块导入时
-window.__TZ_PAGE_USE__.showLauncher()
-window.__TZ_PAGE_USE__.hideLauncher()
-```
-
-方法只作用于已挂载的面板：宿主未挂载面板时调用显示方法只保存状态并在控制台警告。若希望生产环境默认不显示、由业务系统按需调出，应常驻挂载面板并设置 `defaultHidden`：
-
-```ts
-mountPageUseUI({ launcher: { defaultHidden: true } })
-// Vue：<PageUseHost :options="options" :launcher="{ defaultHidden: true }" />
-```
-
-用户关闭入口后，也可在 URL 上加 `?pageUseDebug=1` 重新显示。隐藏入口不会中断正在执行的任务，也不影响运行期光晕；此时可通过模块 API 或全局对象的 `stop()` 终止任务。
-
-调试面板设置中不提供「显示 page-agent 自带面板」与「定制光晕与光标配色」：自带面板始终隐藏，蒙层始终使用定制光晕与光标配色，本地存储中的旧值会被忽略。`PageUseSettings` 仍保留 `showBuiltinPanel` / `customMaskEffect` 字段，但修改不生效。
-
-## 演示播报
-
-演示时可用语音同步播报智能体的执行过程。默认使用浏览器语音合成（`speechSynthesis`），无需宿主额外配置；宿主也可注入在线语音合成引擎（见下文「自定义语音合成引擎」）。
-
-- **开关**：调试面板「设置 → 语音播报」，**默认关闭**，状态保存在本地存储（`voiceEnabled`）。关闭时设置中只显示该开关；开启后显示：
-  - **播报引擎**（`voiceEngineId`）：仅在宿主注入了在线引擎时显示，可在注入引擎与「本地语音（浏览器）」之间切换，切换时立即停止当前播报；
-  - **语速**（`voiceRate`，倍率 0.5–2，默认 1.1），所有引擎共用；
-  - **音色**（`voiceNames`，按引擎 id 分别保存）：当前引擎提供音色列表时显示，「自动」表示由引擎选择（浏览器引擎为第一个中文语音）。
-  - **试听**：位于音色下拉框右侧（引擎不提供音色列表时单独一行），用当前引擎、音色与语速播报「您好，我是页面智能体。」；试听中按钮显示「停止」，再次点击、切换引擎或音色、离开设置页、收起或关闭面板时中止。试听与任务播报互斥：任务执行中按钮禁用，任务开始时中止正在进行的试听；当前引擎不可用时同样禁用。试听不受「本次任务静音」影响。**在线引擎每次试听都会发起一次合成请求，消耗一次调用额度。**
-
-  开关对所有来源的任务生效，包括其它智能体经模块 API、function calling 或全局对象下达的任务。
-- **设置字段变更（BREAKING）**：`PageUseSettings.voiceName` 已移除，改为 `voiceNames`（`Record<引擎 id, 音色>`）。本地存储中的旧值在读取时自动迁移为 `voiceNames.browser`，用户已选的浏览器语音不会丢失；直接读取 `voiceName` 的宿主代码需改为读取 `voiceNames.browser`。
-- **本次任务静音**：任务执行中且开启语音播报时，面板标题栏显示静音按钮。静音后立即停止当前播报，本次任务剩余的步骤、提问与结论都不播报；再次点击取消静音，只播报之后的内容（不补播）。下一次任务开始时自动恢复。静音状态不持久化，也不修改「语音播报」开关。
-- **播报内容**：
-  - 执行步骤：模型对每一步的目标描述；滚动、等待、结束、提问、出错、重试步骤不播报；
-  - 提问：模型向用户提出的问题；
-  - 结论：任务结束时的 `summary`（成功、未达成、出错均播报；被终止的任务不播报）。
-- **不阻塞执行**：智能体不等待语音结束。正在播报时到达的新步骤只保留最新一条待播，中间步骤被丢弃；提问与结论会打断当前播报；新任务开始、终止、销毁或关闭开关时停止播报。
-- **播报时机**：page-agent 在模型调用内部执行点击等动作，目标描述在动作完成后才可获得，因此播报会略晚于页面变化；模型思考期间没有播报。
-- **文本清洗**：播报前去除 Markdown 标记、表格分隔线、链接地址、代码块、emoji 与元素编号（如「索引为 23 的」「[23]」）；清洗后超过 240 字（语速 1 时约 1 分钟）时在句子边界截断，并追加提示语「详细内容请查看「面板标题」」（面板标题即 `PageUseLauncherConfig.title`，如「详细内容请查看「页面智能体」」；未挂载调试面板时为「详细内容请查看面板」）。清洗只影响播报，`result.summary`、面板展示与返回给调用方的数据保持原样。
-- **提示词**：开启播报后的下一次任务起，系统提示追加一条约束，要求 `next_goal` 写成面向观众的一句中文、不含元素编号；关闭时系统提示不变。执行中切换开关只影响下一次任务的提示词。
-
-浏览器语音合成的限制：
-
-- 可用语音取决于操作系统与浏览器。Windows 上的 Edge / Chrome 有中文语音；Linux 上的 Chromium 通常没有，此时设置面板会提示并使用默认语音。
-- 浏览器要求用户与页面交互过才允许发声。从调试面板下达任务、在对话框中输入指令均满足条件；页面加载后未经交互直接调用可能无声。
-- `speechSynthesis` 是整个页面共用的队列。提问 / 结论打断时会调用 `speechSynthesis.cancel()`，宿主页面同时在播报的其它语音也会被停止；反之，宿主调用 `cancel()` 也会停止 Page Use 的播报。当前引擎不是浏览器引擎时，包内不调用 `speechSynthesis`。
-
-### 自定义语音合成引擎
-
-通过 `createPageUse({ tts })` 注入一个或多个实现 `PageUseTtsEngine` 的对象，即可接入在线 TTS 服务商（如讯飞、阿里云、Azure 等，不限厂商）。注入的引擎与内置浏览器引擎一起出现在调试面板「设置 → 语音播报 → 播报引擎」中供切换。播报内容、待播与抢占规则、文本清洗均由包统一处理，引擎只负责播出一段文本。
+### 其它框架
 
 ```ts
-import type { PageUseTtsEngine } from '@tanzerfe/page-use'
-
-const vendorA: PageUseTtsEngine = {
-  id: 'vendor-a',                // 必填，稳定标识：用于保存所选引擎与该引擎的音色
-  label: '在线语音 A',            // 显示在设置面板「播报引擎」下拉框
-  splitSentences: false,         // false：一组句子合并为一次 speak；true：逐句调用
-  isAvailable: () => typeof WebSocket !== 'undefined',
-  // 可选；不提供或返回空时不显示音色下拉框
-  listVoices: () => [{ value: 'voice-1', label: '音色 1' }],
-  async speak(text, { rate, voice, signal }) {
-    // rate：语速倍率（1 为正常）；voice：该引擎在设置中的音色（空串表示自动）；
-    // signal 触发时立即停止自身的合成与播放并返回
-  },
-}
-
-createPageUse({ /* ... */, tts: [vendorA, vendorB] })   // 也可传单个对象
-```
-
-- **`id`**：必填且应保持不变，修改后已保存的引擎选择与音色会失效。`'browser'` 保留给内置浏览器引擎（`BROWSER_ENGINE_ID`）；注入的引擎 id 重复或为 `'browser'` 时，保留先出现者并在控制台警告。
-- **默认引擎**：浏览器引擎（本地语音）排在「播报引擎」下拉框最前，用户未选择过引擎时使用它，注入的引擎按注入顺序排在其后，需要用户手动切换。已保存的引擎被宿主移除后，播报回退到浏览器引擎，保存的选择不被改写，宿主恢复该引擎后继续生效。
-- `speak()` 在播完、失败或被中止时 resolve，**不应 reject**；失败由引擎自行记录（包仍会兜底捕获并继续播报后续内容）。
-- 抢占、终止、销毁、关闭开关、本次任务静音或切换引擎时，包通过 `signal` 中止当前 `speak()`。停止播报只作用于引擎自身的音频，不会停止宿主页面上其它来源的语音。
-- 引擎的 `isAvailable()` 为 false 时播报静默跳过；设置面板中该引擎不可选并标注「（不可用）」。
-
-## 对接方式
+import { createPageUse, mountPageUseUI } from '@tanzerfe/page-use'
 
-### 1. 模块 API
-
-```ts
-import { pageUseCapability } from '@tanzerfe/page-use'
+const handle = createPageUse({
+  llm: { baseURL: '/api/llm-proxy/v1', model: 'deepseek-flash' },
+  appName: '订单管理系统',
+  getMenus: () => myMenus, // [{ label, path, children? }]
+})
+const unmount = mountPageUseUI({ launcher: true }) // launcher：显示操作面板
 
-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 为结论
-}
+// 退出登录或卸载时
+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'
-
-// tools: [PAGE_USE_TOOL, ...]
-// 模型返回的 tool_call.name === PAGE_USE_TOOL_NAME 时：
-const { content } = await runPageUseTool(toolCall.function.arguments, { source: 'my-agent' })
-// content 作为 role=tool 的消息回给模型
-```
-
-### 3. 结构化指令块
-
-模型在回复中输出 `{ "type": "pageAction", "instruction": "..." }`，前端用 `isPageUseCommand(value)` 校验后调用 `pageUseCapability.run(value.instruction)`。
-
-### 4. 全局对象
-
-`window.__TZ_PAGE_USE__` 包含 `pageUseCapability` 的全部方法及 `tool`、`runTool`，以及调试入口的显示控制 `showLauncher()` / `hideLauncher()`（见「调试入口的显示与隐藏」），可用于控制台调试、E2E 脚本和同源外部脚本：
+import { pageUseCapability } from '@tanzerfe/page-use'
 
-```js
-await window.__TZ_PAGE_USE__.run('打开首页')
-window.__TZ_PAGE_USE__.showLauncher()
+const result = await pageUseCapability.run('打开订单列表，告诉我第一条订单的收货地址')
+console.log(result.status, result.summary)
 ```
 
-`showLauncher` / `hideLauncher` 只在全局对象上提供，不属于 `pageUseCapability`（交给其它智能体的执行能力不含 UI 控制）。
+也可将 `PAGE_USE_TOOL` 作为 function calling 工具提供给模型，并用 `runPageUseTool` 执行。
 
-## API Key 安全
+## 操作面板
 
-`llm.apiKey` 会出现在浏览器请求和前端产物中。**生产环境应由网关或代理注入 Key**，前端只传代理地址。
-
-本地开发可用 Vite 代理规避 CORS：
-
-```ts
-// vite.config.ts
-server: {
-  proxy: {
-    '/__page-use-llm': {
-      target: 'https://api.deepseek.com/v1',
-      changeOrigin: true,
-      rewrite: (p) => p.replace(/^\/__page-use-llm/, ''),
-    },
-  },
-}
-```
+- 传入 `launcher` 后，面板入口显示在页面右下角，可拖动。
+- 用户关闭后，可在 URL 上加 `?pageUseDebug=1` 重新显示，或由业务系统调用 `showPageUseLauncher()` 调出。
+- 希望默认隐藏、按需调出时，传入 `launcher: { defaultHidden: true }`。
+- 面板支持快捷指令、历史记录与语音播报。
 
 ## 主题
 
-在宿主页面设置 CSS 变量调整配色，例如 `:root { --tz-page-use-primary: #1677ff }`：
-
-| 变量 | 默认 | 用途 |
-|---|---|---|
-| `--tz-page-use-primary` | `#0879ff` | 主色：面板按钮、光晕 |
-| `--tz-page-use-flow-gradient` | 橙-黄-绿-青-紫径向渐变 | 流光渐变：收起时入口按钮的背景与展开面板的 2px 边框（放大到 300% 循环移动，执行中加速）；可替换为任意渐变，如 `radial-gradient(#0879ff, #36cfc9, #597ef7)` |
-| `--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` | — | 面板状态色 |
+通过 CSS 变量调整主色：
 
-模拟光标配色见导出常量 `PAGE_USE_MASK_COLORS`。
-
-### 机器人图标
-
-调试面板入口按钮上的机器人图标以 SVG 字符串常量 `PAGE_USE_ROBOT_ICON_SVG` 导出，供宿主在自身界面中复用（如智能体列表卡片）。颜色跟随 `currentColor`，不含 `width` / `height`，尺寸由宿主 CSS 控制；`viewBox` 为 24×24、线宽 2，小尺寸显示时线条偏粗可用 CSS 覆盖 `stroke-width`。
-
-```vue
-<template>
-  <span class="agent-icon" v-html="PAGE_USE_ROBOT_ICON_SVG" />
-</template>
-
-<script setup lang="ts">
-import { PAGE_USE_ROBOT_ICON_SVG } from '@tanzerfe/page-use/vue'
-</script>
-
-<style scoped>
-.agent-icon :deep(svg) {
-  width: 18px;
-  height: 18px;
+```css
+:root {
+  --tz-page-use-primary: #1677ff;
 }
-</style>
 ```
 
+机器人图标以 `PAGE_USE_ROBOT_ICON_SVG` 导出，可在业务界面中复用。
+
 ## License
 
 MIT

package/dist/index.mjs

@@ -1,3 +1,3 @@
-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-tOb9oqjb.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 { 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 };

package/dist/{src-tOb9oqjb.mjs → src-CHB0xWWP.mjs}

@@ -2058,7 +2058,7 @@ var PageUseGlowElement = class extends LitElement {
 
 //#endregion
 //#region package.json
-var version = "0.0.5";
+var version = "0.0.6";
 
 //#endregion
 //#region src/ui/drag.ts
@@ -3921,7 +3921,7 @@ var PageUseLauncherElement = class extends LitElement {
       type="button"
       class="btn preview-btn"
       ?disabled=${!available || running}
-      title=${running ? "任务执行中不可试听" : "用当前引擎、音色与语速试听"}
+      title=${running ? "任务执行中不可试听" : "按当前设置试听"}
       @click=${() => playing ? stopPreview() : startPreview(engine, {
 			rate: settings.voiceRate,
 			voice: voiceName
@@ -4231,7 +4231,7 @@ var PageUseLauncherElement = class extends LitElement {
             <button
               type="button"
               class="icon-btn close"
-              title="关闭（可调用 showPageUseLauncher 或加 URL 参数 pageUseDebug=1 重新打开）"
+              title="关闭"
               @click=${() => this.close()}
             >
               ${closeIcon}

package/dist/vue.mjs

@@ -1,4 +1,4 @@
-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-tOb9oqjb.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";
 import { defineComponent, inject, onBeforeUnmount, onScopeDispose, shallowRef } from "vue";
 import { routerKey } from "vue-router";
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tanzerfe/page-use",
   "private": false,
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "基于 page-agent 的页面操作智能体：自然语言指令驱动页面点击与输入，框架无关，附 Web Component 调试面板与 Vue 适配层",
   "type": "module",
   "main": "./dist/index.mjs",