# 数学公式、头像、对话框与受限交互卡

卡片运行、静态回退及照片错误提示显示在消息气泡外的独立黄色区域，可逐条关闭。关闭只影响当前提示的显示，不改变脚本权限或执行结果；新的错误会重新显示。

[English](CONVERSATION_PRESENTATION_en.md) · [使用](USAGE_zh-CN.md) · [API](API.md) · [安全](../SECURITY.md)

本合同适用于 Tavern 3.1.5，目标 DSH `0.2.1-rc.2` / `0.2.1-rc.3`。通过官方 UI 服务和 slots 嵌入 Web/桌面主页面，不需要另开浏览器。DSH 历史仍为消息权威，以下数据都只是显示元数据。

RP 页面直接显示 DSH 会话/轮次错误的具体信息。若提示活动写入句柄占用，同一数据目录中的会话可能正由另一个网页端或桌面端实例持有；结束其操作并关闭该实例后，再重新打开会话。静态消息的样式表和行内样式均受 Shadow DOM 与外层绘制边界限制，固定定位内容不能覆盖主界面。

## 渲染顺序

这是 RP 显示链路，与发送给模型的提示词装配顺序分开：

1. **读取显示来源与姓名**：读取 DSH 历史、开场白或当前流式文本，解析当前绑定的用户和角色姓名。手动保存的显示覆盖正文跳过下面的源码宏和正则步骤。
2. **展开消息源码中的姓名宏**：先处理 `{{user}}` / `{{char}}`，以及符合下节条件的正文 `<user>`。此时尚未运行卡片脚本，也尚未把 MVU 变量中的字符串读入状态栏。
3. **运行显示正则**：按全局 → 当前预设 → 当前角色的资源顺序，再按各资源内的规则顺序执行；过滤关闭、不匹配消息身份或深度的规则。后续规则读取前一条的结果，替换结果不会再次从头运行姓名宏或整组正则。
4. **分流排版与卡片**：普通文本走 Markdown → KaTeX → HTML 净化及样式隔离；识别出的交互 HTML 卡片先解析源码、核实已启用依赖并提取脚本，显示无脚本的净化页面。
5. **启动卡片与读取变量**：满足脚本开关、消息完成和历史绑定条件后，读取本消息的 MVU 快照，再启动受限运行时。Worker 路径先运行已启用的 Helper，再按卡片脚本顺序执行；脚本从原始变量生成虚拟 DOM，变量更新后可再次生成。
6. **投影 Worker 的动态画面**：Worker 输出 HTML 经净化、节点数量与身份检查后，在独立显示副本的普通文本节点中展开孤立的 `<user>`，最后显示到无脚本 iframe。只写文本节点，不把姓名当成 HTML；不处理属性、表单值、可编辑区域、代码、样式、模板数据或成对的角色包装文本。这一步不重跑显示正则，不改 Worker 内的 DOM、脚本读取的变量或持久 MVU 值。

例如，MVU 中的 `邀请 <user> 参加会议` 在脚本运行时仍保持原值；用户姓名为“小明”时，Worker 状态栏显示副本呈现 `邀请 小明 参加会议`。源码的宏步骤和运行后的文本投影是两个阶段，不把 MVU 值提前替换后再写回。内嵌简化 DOM 桥不经过 Worker 画面投影；静态 HTML 导出也不执行脚本、不导出动态 MVU 画面。

## 姓名占位符

普通正文、开场白和流式回复沿用当前绑定用户/角色资源的姓名来展开 `{{user}}` / `{{char}}`；正文中孤立的 `<user>` 也可表示用户姓名。重新读取同一历史对话时采用当前名称，不逐条保存旧姓名。手动编辑后保存的显示正文沿用现有固定结果，不再次运行姓名宏或显示正则。

消息源码阶段的 `<user>` 写法不处理代码围栏、缩进代码、行内代码、转义文本、HTML 属性/注释、`pre`/`code`/脚本/样式内容、完整 HTML 文档，或成对的 `<user>…</user>` 结构；需要原样展示时使用代码或 `\<user>`。既有双花括号姓名宏的处理规则保持不变。静态 HTML 导出使用相同的当前名称解析；DSH 原始消息和提示词装配不受此显示兼容影响，JSONL 的对话正文保留原文，开场白仍按既有导出规则展开姓名。

## 数学公式

RP 正文、开场白、显示编辑和静态 HTML 导出共用 Markdown → KaTeX MathML → DOMPurify 路径。公式默认开启，不增加 conversation-settings 字段或专门控制按钮，也不改写 DSH 原文、提示词和 JSONL。行内用 `$…$` / `\(…\)`，独立公式用 `$$…$$` / `\[…\]`；多行分隔符各占一行。分数、根号、积分、矩阵和对齐公式使用 KaTeX 语法，浏览器负责原生 MathML 排版，不加载远程字体或脚本。

仅识别 Markdown 文字中的分隔符；代码、HTML 属性/注释、原始 HTML 块、完整文档模板和交互卡片内部保持原语义。行内 HTML 文字与 `<details>` 的 Markdown 正文/标题可使用公式。常见金额不会被当成公式，但字面 `$x$` 必须转义或放进代码。Markdown 强调不会消耗公式内部的 `*` / `_`；公式样式限于 Tavern 内容，普通公式不会为整条消息引入 Shadow DOM。独立长公式横向滚动，流式内容闭合后才排版，未变化的历史消息复用 DOM。

单个公式限制为 4096 字符、200 次宏展开与用户指定尺寸上限 10 em；宏定义不跨公式共享，错误或不支持的 TeX 回退源码。KaTeX 使用 `trust: false`，禁用公式中需要显式授权的外部资源和 HTML 扩展命令；此设置不影响普通 Markdown 链接、图片或现有 HTML 渲染。公式生成内容仍须净化；允许 MathML 及纯文本 `annotation`，禁止 `annotation-xml`。这不是完整 LaTeX 文档运行环境，浏览器布局仍有资源成本；需要支持 MathML 的现代浏览器。详细转义与混排规则见[使用说明](USAGE_zh-CN.md#markdownhtml-与模板样式)。

## 头像

在 **DT → 用户** 上传 PNG/JPEG/WebP，然后保存资源。浏览器接受最多 8 MiB、边长不超过 8192 的图片，中心裁成 256×256 WebP。API 接受至多 128 KiB 的 raster data URI，校验媒体类型、base64 与文件签名；不接受 SVG、外部 URL 或文件路径。

默认用户图取自周目根 session 所绑定的用户资源；角色图使用当前绑定角色卡的现有 PNG 接口，缺图使用占位。名称/描述参与提示词装配，头像不进入提示词。

消息头像位于输入栏外沿两侧：角色在左，用户在右；正文和操作按钮位于中间。开场和助手气泡默认占满中间列的可用最大宽度，不随初始内容长度收缩；用户气泡默认随内容收缩，正文仍右对齐。可在外观设置中分别选择两种角色的“随内容收缩”或“占满消息栏”。交互卡 iframe 随父容器收缩，后续动态内容在既有宽度内换行。布局使用 Host 的 composer 宽度变量，在显示 Tavern 的 Session 内通过公开 slot 限定 composer 两侧留白；离开 Tavern 视图后恢复 Host 默认留白。设置预览使用相同的气泡布局，按钮尺寸随草稿实时变化，点击“应用并保存”后生效。

点击对话头像可以上传替换图，选择“仅此条”或“此周目所有用户/角色头像”。优先级如下：

```mermaid
flowchart LR
  A[单条显示覆盖] -->|无| B[本周目该角色覆盖]
  B -->|无| C[绑定用户头像或角色卡图]
  C -->|无| D[占位头像]
```

- **仅此条**：用户按 QA node ID，角色按 QA node ID + variant ID + 输出段序号保存。开场白按开场序号，导入正文按导入位置保存。流式临时消息不可编辑头像，终态再编辑。
- **整周目替换**：覆盖该角色已有及后续消息，并清除该角色所有单条覆盖。另一个角色保持原样。
- **此条恢复继承**：只删除单条覆盖，继续继承本周目覆盖或资源默认值。
- **此周目全部恢复资源默认图**：清除该角色整周目覆盖及所有单条覆盖。
- 在用户面板修改资源头像，会改变所有继承该资源默认图的周目；对话内编辑不会修改用户资源、角色卡源图或其他周目。
- 新建普通周目从资源默认图开始。分支为新周目时复制当时的显示元数据；此后独立保存，不与原周目联动。更换导入记录后，导入位置覆盖仍跟随该位置；需要时恢复默认。

资源 `avatar` 随用户 JSON 导入/导出。覆盖保存在已有 timeline 的 `ext.pmpDshTavern.appearance`，`schemaVersion:1`，字段为可选 `user`、`assistant` 和 `messages`。图片是有界 data URI，`messages` 最多 500 个键，appearance 总计不超过 512K 字符（JSON 序列化后）；timeline 仍受原来的 1 MiB 总限制。更新使用现有 workspace 文件 API 的 revision/CAS，不写 DSH 日志；超限或冲突失败不会覆盖原文件。

## 对话框样式 v1

进入 **DT → 对话设置**，选择柔和、书页或夜色，或使用颜色、圆角、边距和字体控件编辑；预览后点“应用并保存”。也可展开 JSON 编辑、导入或导出。导入只更新预览，应用才保存。一个自定义样式随当前全局对话设置保存；可导出多个文件作为自己的样式库。

[完整示例](examples/bubble-paper.json)：

```json
{
  "format": "tavern-bubble", "version": 1, "name": "Paper",
  "radius": 4, "padding": 20, "borderWidth": 1, "font": "serif",
  "user": {"background":"#f4ecd9","text":"#483923","border":"#d5c6a9","widthMode":"content"},
  "assistant": {"background":"#fffaf0","text":"#40392d","border":"#ded3bd","widthMode":"full"}
}
```

`user`、`assistant` 分别支持可选 `widthMode`，取值为 `content`（随内容收缩）或 `full`（占满消息栏）。缺省时用户为 `content`、助手为 `full`，旧 v1 样式无需迁移；预览、保存及 JSON 导入导出使用同一规则。尚不认识该字段的旧客户端会按未知字段拒绝包含它的样式。

名称 1–80 字符；颜色必须是六位 `#RRGGBB`；圆角 0–32、边距 8–24、边框 0–3（整数像素）；字体为 `sans|serif|mono`。文件最多 16 KiB，未知字段、版本或非法值明确拒绝。没有 CSS、HTML、JS、资源 URL 或任意代码字段。

`PUT /v1/conversation-settings` 在既有 `textScale/actionScale` 外接受可选 `bubbleStyle`（上述完整文档）和 `interactiveCards`（boolean）。省略恢复默认，DELETE 恢复全部默认。设置存于原有 `conversation-settings.json`；不绑定周目，不改变 DSH 原生样式。

## 三种边界与方案选择

1. **静态内容**：Markdown → DOMPurify；样式在 Shadow DOM 与绘制边界内隔离。实时视图的 `img` 与 CSS `background` / `background-image`（包括图片自定义变量）经过下述按需媒体控制器；导入不下载图库，静态 HTML 导出不加载远程图片。移除 srcset、poster 等；字体、其他 CSS 外部资源、`@import`、image/image-set/src 函数和转义仍拒绝。正常布局、颜色、渐变、变量、媒体查询和动画可用。外链需用户主动点击，带 `noopener noreferrer`。
2. **脚本环境**：识别已闭合 `html` 围栏、无语言但以 `<body>`/`<html>` 开头或包含完整 `<head>…</head><body>…</body>` 文档的围栏，以及完整 `<html>…</html>`/`<body>…</body>` 中的控件或脚本。无语言的完整文档可带 HTML doctype 和注释；不完整的 head/body 片段和明确标为其他代码语言的围栏仍按文本呈现。静态 DOM 在 `sandbox="allow-same-origin"`、无 `allow-scripts` 的 iframe 内呈现，CSP 禁止连接、外部图片、脚本、子 frame、表单提交等。卡片 JS 在独立 QuickJS WASM 中运行，不在 iframe 或父页面执行。iframe/Shadow DOM 本身不承担完整权限保证。
3. **能力接口**：唯一的 JSON bridge 白名单提供卡片内部 DOM 与只读姓名上下文，以及“建议消息”。没有通用 RPC、Host API、凭据、文件、网络、父页面或 native eval 入口；模块仅从资源限定的已装配内容映射解析。建议在卡片外显示，由用户点击 Tavern 按钮提交；下述受控 ST 输入适配也允许直接模式中的卡片内真实用户点击，经既有 `user-message` API 请求提交。

[DSH sandbox 固定版文档](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.1-rc.2/packages/sandbox/sandbox/README.md) 隔离的是子进程与文件访问，不能复用为消息 JS 的浏览器隔离。[官方桌面转发](https://github.com/deepseek-ai/deepseek-harness/blob/dsh-v0.2.1-rc.2/apps/desktop/src/web-document.ts) 会剥离 Origin；[桌面请求令牌](API.md#桌面请求令牌) 解决此差异，没有关闭 webSecurity。

[酒馆助手渲染器文档](https://n0vi028.github.io/JS-Slash-Runner-Doc/guide/基本用法/渲染器.html) 与 [固定源码](https://github.com/N0VI028/JS-Slash-Runner/blob/519599bc68247d8e759cc844a983f8f5252941a8/src/panel/render/Iframe.vue) 使用 srcdoc/blob iframe；其构建函数注入公共接口、外部库和头像路径，部分工具桥接父页面。因此复用其显示思路，不能照搬权限模型或声明全量兼容。实现为 Tavern 内可关闭模块，复用已有周目与组件销毁边界；额外插件目前没有独立宿主能力需求，反而需要跨插件生命周期和权限协商。后续若增加通用、独立授权能力，再评估拆分。

```mermaid
flowchart LR
  A[闭合消息 HTML] --> B[净化与禁脚本 iframe]
  A --> C[QuickJS 配额解释器]
  C --> D[有界 JSON 白名单]
  D --> B
  D --> E[姓名上下文]
  D --> H[受控输入请求]
  H -->|真实点击与作用域校验| G
  D --> F[卡片外消息建议]
  F -->|用户点击| G[已有 Tavern API / DSH 历史]
  A --> H[惰性图片来源]
  H --> I[可信宿主按可见性获取 / 校验 / 缓存]
  I --> B
```

### 远程图片按需加载

媒体不计入代码的 script/import/`.loadHTML` 依赖图或下载进度。可信父页根据实际视口、折叠、隐藏、iframe 和页面可见性获取图片；图片状态单独显示可见、已显示、加载中与不可用数量。关闭、禁用、变体/会话切换及卸载会释放 DOM 图片并取消无人使用的队列/请求，旧代次结果不能覆盖新界面。同一 URL 去重；页面内存缓存采用 LRU，不写 Host、资源文件、浏览器持久存储或图片 URL 日志。

支持静态 PNG/JPEG/WebP/GIF，以及同类有界 data URI；拒绝 SVG、APNG/动画 WebP/多帧 GIF、音视频、字体与通用文件/canvas 访问。远程来源必须为无凭据、无非默认端口的绝对 HTTPS 命名 URL；拒绝 IP、本机/私网形式的主机名、相对 URL及其他协议。URL 形式检查不核验 DNS 结果，不能保证阻止 DNS 重绑定。浏览器 CORS、`credentials: omit`、`referrerPolicy: no-referrer`、`redirect: error`、`cache: no-store` 保持生效；不支持需要登录、重定向或缺少 CORS 的图片服务。图片服务器仍可看到客户端 IP 和 URL，URL 中的查询参数也会发送给该服务器。

页面共享最多 4 个并发请求、32 个可见图片租约、64 个缓存项与 32 MiB（数据字符串和解码像素合计）；单图源最多 3 MiB、4194304 像素、边长 8192 与 15 秒。先校验流式字节与文件头/尺寸，再解码、复核并重编码为 PNG；输出与 CSS 变量文本限 1 MiB 字符，超限时有界等比缩图并保留透明度，避免浏览器静默拒绝大 CSS 值。背景只有在原生 CSS 写入回读成功、实际计算背景包含该栅格后才计为已显示；写入或级联失败报告 `IMAGE_CSS` 并释放租约。超限/格式/网络错误显示占位，并在 `data-dtv-image-error` 提供无 URL 的固定原因码，等待全局额度的可见图片会在额度释放后重试。尚无尺寸声明的 img 使用 160×90 占位布局。浏览器临时解码、布局及引擎漏洞不由这些预算完全约束。

卡片可以通过受限 DOM 表达要显示的图片，不能调用通用 fetch 或读取 HTTP 响应。iframe 仍仅允许 `img-src data:`、`connect-src 'none'`，QuickJS/Worker 没有任意网络、Host 或凭据权限；只有可信宿主把校验后的栅格注入实际视图。CSS 图片 URL 转为惰性占位，只有在实际背景中使用才获取；未使用的自定义变量不会下载；html/body 根背景也纳入发现。伪元素只支持无子内容和其他生成盒的空宿主，须有生成内容、可见 display/visibility/opacity，且可确认其无变换的有界盒位于完整可见宿主内，未知几何不加载；隐藏、生成内容和视口变化会释放租约。惰性 `template` 可保留净化后的 SUOT 数据标记，标记在模板外会被展开为内容；模板脚本和事件属性不执行。


### 选择一张照片

开启卡片脚本后，净化后的 `input[type=file]` 可接收用户主动选择的一张静态 PNG/JPEG/WebP。卡片按钮只有在新的可信点击与浏览器用户激活期内才能打开该输入；合成点击/变更不获权限。可信父页只读取选定 File，解码前检查 8 MiB、8388608 像素与单边 8192，去除原始元数据并输出最长边不超过 640、data URI 不超过 65536 字符的 JPEG。解码串行执行，最多排队四项；新选择、禁用、源码变化或卸载使旧结果失效，格式/额度错误单独显示照片提示。

VM 只收到合成的 `selected-photo.jpg` 描述与有界 JPEG。窄 FileReader/Image/canvas 门面支持读取此次选择、自然尺寸，以及既有 `drawImage(image,0,0,width,height)` → `toDataURL('image/jpeg',0.82)` 流程，返回宿主已处理的 JPEG；没有通用 canvas、真实 File、路径、原文件名、任意图片获取或 Host 入口。照片变更不携带输入框发送权限。持久化仍遵守调用者已有预算及独立授权，选图不扩大存储额度或自动授予写入。输入保持单文件及栅格 accept 白名单；`hidden` 和明确的 `data-opening-choice`/`data-opening-perk` 属性可通过净化。

## 受控 ST 输入兼容

SUOT 选项卡使用窄范围的虚拟 `window.parent` / `window.top` facade。这些对象只含解释器自有代理，不包含宿主页面或真实 Window。惰性 `<template>` 数据保留 `<SUOT>` 标记，template fragment 支持纯文本读取，虚拟 window 收到 `DOMContentLoaded`；脚本和活动属性仍经过净化。

| 接口 | 支持的请求 |
| --- | --- |
| `parent.document.getElementById('send_textarea')` | 脱离文档的虚拟 textarea；value setter 与 input/change 事件请求替换最多 4000 字符的草稿 |
| `textarea.focus()` | 公开 DSH 编辑器插入会选中插入文本，不提供宿主 DOM focus handle |
| `SillyTavern.getContext().generate()` / 虚拟 `send_but.click()` | 在明确直接模式中，请求提交本次点击填入的草稿；受理不等于模型完成 |
| `extensionSettings.XiaJin.directSend` / `saveSettingsDebounced()` | 仅此布尔字段；按源码、渲染作用域与卡片位置绑定的本地偏好，最多 128 条，不保存写权限 |
| `parent.document.querySelectorAll('iframe')` | 仅此卡自己的 frame proxy；`remove()` 只在其发送已受理后关闭 |
| `parent.postMessage({type:'resizeIframe',height}, '*')` | 仅请求调整此 iframe，高度限制在 1–800 px；固定高度面板仍由宿主管理 |

可信接收端将请求绑定到 runtime nonce、单调请求 ID 和近期原生点击。 发送回执不续期原点击的 1500ms 权限；迟到的受理回执只允许本卡完成一次已受理关闭，不授予新的变量写入、选图或开场选择权限。脚本合成事件、定时器、重复动作及事件任务结束后的请求不能继承该点击。仅填入模式不提交消息。发送需要同一事件填入的文本及未变化的草稿修订，然后使用已有、按 session 绑定的用户消息 API。并发或重复发送被拒绝；受理后清空草稿不会覆盖用户的新编辑。忙碌、带结构引用或附件的草稿拒绝替换。切换会话/源码、禁用或卸载会释放待处理请求；已受理的请求无法撤回。超时明确报告发送结果未知，不自动重试。输入/设置/发送拒绝保持可见，也不能关闭卡片。历史过渡画面不取得可写 composer。

发送中的开场 dock 或开场布局保留到该点击的关闭或任务结束，以免 DSH 首条消息的界面转场先卸载回执接收端。会话或输入 shell 替换仍立即失效，其他卡片不能释放该请求的私有占用。启动期间的事件进入有界队列，处理时仍检查原点击的有效期。

历史原文保持不变。当前会话中重新展示的历史卡使用新绑定实例，用户的新真实点击仍可填入或提出发送；旧实例或旧待处理点击不能继续提交。该输入请求独立于 MVU 的 initial 变量写授权。

## 支持接口与限制

Swipe 等待以 DSH 的实际 turn 状态为准；仍在生成的长回复不会因前端初始等待时限而失去登记。页面保持打开时，读取暂时失败后已保存的回复可在重新读取时补登记为原 QA 的变体，不重发输入；若用户已切换持久 head，恢复不会覆盖该选择。等待期间开场白继续读取来源回复的已核实只读 checkpoint，新回复仅在持久坐标确认后绑定自己的 MVU。脚本关闭、消息生成中、历史绑定待确认分别显示不同提示。

默认关闭脚本，在对话设置明确启用。可从[计数器示例](examples/interactive-counter.html)开始，将完整文件放进 `html` 代码围栏。每次重新挂载/切换周目/修改卡片源码都新建运行时；普通父组件刷新保留状态。生成中的消息不执行脚本，历史卡片不因其他消息的流式更新而重置。卡片局部变量只在内存中，刷新或重挂载后重置。

| 接口 | 支持范围 |
| --- | --- |
| `document.body`, `getElementById`, `querySelector`, `querySelectorAll` | 仅卡片 body 内，返回 facade，不返回真实浏览器对象；净化可能移除 DOM 保留名称 |
| 元素 `textContent`, `innerHTML`, `value`, `checked` | innerHTML 每次重新净化；不激活插入的脚本 |
| `createElement`, `appendChild`, `remove` | 白名单 HTML 标签，禁止创建 script、iframe、style、img、input；现有受限 input 可交互 |
| `setAttribute/getAttribute`, `classList`, `style.setProperty` | 写属性仅 id/class/title/disabled/aria-label/data-action；CSS 仍在 CSP/iframe 内 |
| `addEventListener` | click/input/change；document 仅同步 DOMContentLoaded；不支持定时器、动画回调、网络或浏览器库 |
| `TavernUI.version`, `getContext()` | v1；角色与挂载时复制的 userName/characterName，复制的 JSON，不含 session ID 或凭据 |
| `TavernUI.proposeMessage(text)` | 最多 4000 字符，生成可见建议；不能自行发送 |

外部 `<script src>` 和 ES 模块使用下述资源依赖获取流程；缺失依赖与内联 on* 会停用整卡脚本。外部来源、Helper 和 JSX 使用专用 Worker 内的 QuickJS 与 linkedom。固定官方 jQuery 3.6.0、React 18.3.1、Vue 3.5.13 夹具覆盖插入 DOM、点击和状态更新；这不代表完整浏览器兼容。提供下述卡片内限定布局读值；可变 CSSOM、canvas、父页面与系统接口仍不可用；仅下述受控 ST 输入子集提供聊天提交请求，通用世界书/聊天/模型生成接口仍不可用；写变量走下述单独授权的 MVU 桥。未提供的 API 报错并销毁运行时，不静默成功。静态 HTML 导出不运行卡片脚本，也不导出内存中的交互状态。

上表描述小型内嵌 facade；其每卡源码最多 128K UTF-16 字符单元、解释器 8 MiB/256 KiB 栈；每次执行 60 ms 与 500 次中断检查双重上限、1000 bridge 操作、100 Promise jobs；DOM 最多 2048 handles，最多 256 listeners；高度 1–800 px。超限显示错误。浏览器布局/图片解码、WASM 引擎缺陷和复杂 CSS 的拒绝服务不由解释器配额完全覆盖，不能承诺绝对安全；显示正则仍有既有 RegExp 回溯风险。

自动检查见 [TESTING](TESTING.md)。安装到真实 profile 前，仍应对目标官方桌面发行包、实际角色卡与模型完成维护者验收。

## 解释器依赖

`quickjs-emscripten-core` 与 `@jitl/quickjs-singlefile-browser-release-sync` 固定为 `0.31.0`。浏览器变体把 WASM 嵌入客户端包（嵌入生成客户端包），不使用 CDN 或外部脚本加载器。包装库与引擎的 MIT 声明保留在生成包和[源码声明](../packages/presentation/THIRD_PARTY_NOTICES.txt)中。小型内嵌解释器延迟初始化；外部卡各自使用可终止 Worker 和独立 runtime。Worker 内置 linkedom 0.18.12，并用独立 QuickJS context 运行固定 @babel/standalone 7.26.10，只允许 React preset，不接受卡片编译插件。依赖发现使用 Acorn 8.15.0 与 acorn-jsx 5.3.2。额外声明见[虚拟 DOM 声明](../packages/presentation/VIRTUAL_DOM_NOTICES.txt)。升级依赖需重新验证配额与隔离测试。[上游发布说明](https://github.com/justjake/quickjs-emscripten/releases/tag/v0.31.0)。

样式页顶部为“导入 JSON、导出 JSON、创建样式”。正文字号纳入样式预览，通过滑块或数字输入调节，以可选整数字段 `fontSize` 保存（8–48 px），点击“应用并保存”生效。没有此字段的旧 v1 文件仍可导入，并继承旧的文字缩放；编辑器应用时转换为像素字号。不支持的脚本提示按原因本地化并去重，区分外部文件、模块、其他 script 类型与内联事件属性；脚本总开关不会下载缺失的外部依赖。


## 统一设置与外部依赖

“外部代码”页按当前卡脚本、外部依赖和相关操作分组。唯一的“允许运行卡片脚本”保留原总执行开关语义，包括消息内嵌脚本。左侧勾选通过对话设置保存普通条目选择，首次继承导入的 enabled/disabled 值；“恢复来源默认”删除覆盖。展开可在有界滚动区查看完整惰性源码，长地址不撑宽面板。ⓘ 使用 Host 提示组件，支持悬停、键盘焦点与触屏点击；下载进度、暂停和错误状态仍直接显示。依赖图遵循保存的条目与 URL 选择，就绪且开启的脚本可读写当前绑定变量。内置 MVU 直接由本地能力提供，无需下载原模块。身份、重置和持久化规则见[设置 API](API.md)。

**DT → 对话设置**包含对话外观、正则替换、外部代码三个页签。切页签保留外观和正则草稿；通过关闭、Esc 或菜单离开时有未保存检查。切换绑定资源时，旧正则草稿保留但停止保存，需先导出或放弃并重新加载。原独立正则菜单合并至此。

清单识别角色卡/预设的 `extensions.tavern_helper` 对象 `{scripts,variables}` 及旧式键值对数组；支持直接脚本和 `type/value`、嵌套 scripts/children 格式。仅读取 scripts，变量语义由 MVU 模块负责。清单同时读取开场白、备选开场白，以及全局、预设和角色正则替换中的 script src、ES import/export/import() 及 `.load()` 字面量，保留来源资源与字段路径。JavaScript 依赖使用 AST 分析，支持多行 import/export 和字面量动态 import，注释和普通字符串不产生依赖。计算型动态 import 与语法错误会明确阻断依赖图。

1. 导入角色卡或预设后，列出当前启用来源中需要下载的原版代码依赖，并询问是否下载这些静态递归依赖；仅含内置 MVU 时不提示下载；旧资源可在“外部代码”点击“下载资源依赖”。内嵌 Helper 不需要内容审批，按原卡启用值、本地选择与总开关运行。就绪且开启的受支持来源即可运行及读写当前绑定变量；下载不开放 Host、网络或父页面 DOM。
2. 可信界面使用浏览器 CORS、无凭据、禁止重定向及 no-referrer 获取 HTTPS 静态文本；单文件上限 8 MiB、15 秒超时。图按 URL 去重并自动收敛，最多 128 个文件、8 层与 24 MiB。直接声明按规范化 URL 去重，下载前显示 `0/n`；递归获取期间显示已获取/已发现数量，最终总数仍未知。只有图完整获取后才显示完成比例；超限保留未下载数量，元数据最多记录 4096 个唯一身份，更多时显示下界 `n+`。图深度定义为各 owner 当前选定声明入口到 URL 的最短边数，直接 URL 为 0；汇合路径和循环不会按较长 DFS 路径重新判限。获取缓存保留最短深度；条目或 URL 选择变化使运行图失效，未选条目不提供深度捷径。没有深度元数据的旧缓存在装配时按执行入口重算，仍检查每个 owner 的启用、来源及内容冲突。缓存、装配均拒绝超 8 层的已就绪依赖；Worker 只收到装配允许的封闭模块集合，其数量、字节、堆、栈和时限约束仍生效。循环引用不重复下载，计算型或不能解析的引用、网络失败与超限都有明确状态。清单不抓取 img/srcset、CSS URL、字体、视频或脚本内普通字符串中的图库；媒体不属于代码获取预算。URL 形式检查不核验 DNS 结果，不能视为 public-only 网络保证。
3. 获取状态按资源显示进度与失败项，可展开浏览完整代码、重新下载或清除下载缓存。内置 MVU 条目显示本地能力提供，不显示下载按钮；仅在有下载内容或未完成下载时显示清除操作，成功后显示完成提示；清除缓存不会移除随插件提供的本地能力。重新下载只替换当前选定图的字节，未选缓存仍惰性保留并可浏览；取消/卸载中止请求并忽略迟到结果。获取与卸载在共享存储事务中递增资源代次，下载提交须原子校验代次；卸载只保留不含源码的代次墓碑，迟到下载不能恢复旧图。跨标签消息只触发存储重读；恢复缓存会在异步源码准备后，向 Host 重读并再次校验代次与发布状态才装载，延迟的旧快照不能恢复已卸载代码。未完成的下载可重新接管。相同精确 URL 与内容摘要的源码字节在同一 Tavern 环境内只持久保存一份，新 owner 获取时优先复用；同一前端同时首次获取尚未缓存的同一来源合并网络请求。一张卡的启用选择、适配模式、图入口/深度和装载记录仍独立校验，不能继承另一张卡的执行或写权限。明确重新下载会获取新字节，各 owner 继续引用自己的版本；卸载只释放当前 owner 的引用，最后一个引用释放后才删除共享字节。一张卡同时使用同 URL 不同内容时明确拒绝。
4. 图、资源来源指纹与共享源码字节保存在 Tavern 持久目录的 `rendering-cache/` 中（默认 `<DSH_HOME>/pmp-dsh-tavern/rendering-cache/`；自定义 `storageDir` 时位于该目录下）。刷新从本地 Host 恢复缓存，不发起外部下载；不同浏览器、端口及桌面客户端连接同一环境时使用同一持久缓存。复制整个 Tavern 持久目录即可携带已下载内容。来源内容、启用选择或适配模式变化仍撤销旧运行图并要求更新选定依赖。资源卸载释放其缓存引用，并通知同源标签页重读；其他 origin 的活动界面在重新读取时观察变更。插件卸载销毁运行时并保留环境缓存以便重装。首次打开原浏览器、原 origin 会将旧 IndexedDB 图及源码导入缺失的 Host 记录，保留来源/选择指纹与代次墓碑；已有 Host 记录（包括卸载墓碑）不覆盖。迁移失败保留浏览器原件并允许重试；更换浏览器前需先在旧 origin 完成迁移，无法跨浏览器直接读取旧缓存。摘要只标识内容，不证明作者身份；缓存不携带执行绑定，卡片不能操作 Host 缓存接口。旧客户端仍使用自己的浏览器缓存，不能读取环境缓存。
5. 受限 `$('body').load('https://…')` / jQuery 包装读取已下载 HTML；相对脚本/模块以原 URL 解析，不提供请求参数、回调、选择器后缀或嵌套包装，也不为 Worker 开放网络。禁用、图替换、会话/variant 切换及卸载会取消旧绑定、销毁解释器和订阅。缺失依赖保留静态界面与原因；“已下载”不代表执行成功。

固定身份页兼容器只接受已登记包装和 HTML 的精确摘要。通用固定 IIFE loader 还会验证选择器的词法绑定；局部 `$` / `jQuery` 不能冒充全局加载器。原包装不执行，最终开场只生成卡片外待确认的消息提案。身份页的 `getCurrentChatId()` 是本卡草稿的 opaque 命名空间，`getCurrentMessageId()` 是绑定变量消息 ID 或 null；它们不是通用 ST/DSH 会话身份。草稿隔离于来源、owner 和当前卡作用域，最多 32 键、单值 64 KiB UTF-8、总 JSON 128 KiB，缓存原文先检查大小再解析。

需要补充角色世界书的固定开场选择，才会由可信页面获取一份登记的只读文本；此文本在同一环境缓存中使用独立的固定开场记录、固定 URL/摘要、8 MiB 下载上限和 15 秒截止，不进入模块图或执行。冷启动恢复会重新核摘要并计入共享代码/数据字节预算。准备提案使用可信当前角色、0-based 开场索引和宏/正则展开前的原文摘要，不依赖卡内草稿 ID。完整条目由 Host 静态 registry 校验，独立卡片外按钮确认后按 CAS 和稳定 operationId 提交；只有真实回执才继续身份选择。空条目选择仅核实绑定后跳过，取消、切换和销毁撤销待决桥，下载不授予世界书写入或模型装配权限；已下载且开启的脚本可使用当前绑定变量。

登记的身份页随后提交不可信的完整变量替换提案，整包限制为 128 KiB UTF-8。固定摘要的有限数据解释器核对所选开场、选项及完整变换。可信展示层独立读取同一活动资源的 `currentRevision`，保留其权威 schema，分别预览精确原始输入和服务端规范化后的预期结果，并使用固定纯函数从规范化后的身份生成精确待发送文本。schema 若改变冻结的开场、奖励或身份控制字段，提案会被拒绝；姓名等普通文本依赖仍可按 schema 规范化一次。卡片外确认检查原生事件时间戳，换算时间基准后仍须小于 1500ms，缺失、未来或过期时间戳不能用处理时刻替代。确认消耗一个不可变票据，直接使用已有执行绑定、作用域校验和 card-write primitive；不会把 user-interaction 来源交给 VM Promise、定时器或回调。普通脚本回执取代原页面重复写入和发送的完成路径。

展示层将本次 POST 的精确操作结果与较新的轮询快照分开保存。提交前取消为零写入；提交后取消可能留下已提交或未知结果。传输结果未知时，仅在原授权仍有效的同一作用域内重试相同不可变 operationId。变量已保存但提案展示失败时，只重试展示，不再写变量。新选择、编辑、来源、作用域或许可变更使待决授权失效；迟到文本不能覆盖较新的提案，也不修改原生输入草稿，发送仍须独立确认。已补入的世界书条目不回滚。票据与回执仅属于当前挂载的展示层，销毁后不持久保留。

```mermaid
flowchart LR
  A[卡片 / 预设 / 正则来源] --> B[静态发现依赖]
  B --> L[精确入口与调用形式匹配本地 MVU 合同]
  L --> E
  B --> C[原版代码同意获取资源依赖图]
  C --> D[浏览器有界下载与 Host 环境缓存]
  D --> E[隔离 QuickJS 与禁脚本 iframe]
  F[更新 / 禁用 / 卸载] --> G[取消绑定并销毁运行时]
```

执行缓存最多 512 项；同一可信前端运行时中，执行缓存、未选原文与 opening 固定只读数据共用 64 MiB 字节预算。冷恢复等待其他缓存初始化，并原子核算同一环境的完整已存来源；空 opening 缓存的暂留预算先释放，避免误拒合法执行缓存。相同精确 URL 与内容的字节跨 owner、活跃和未选引用只计一次，超限不替换旧预约或授予运行许可。初始化失败会阻止新的获取、暂存和装载，保留原缓存；释放预算或显式卸载后，必须成功重新核算完整清单才可继续。共享初始化任务失败会持续阻断，直至同一任务显式重试成功。Host 发布另外检查同一环境所有引用的物理字节与条目预算，避免不同客户端分别写入造成磁盘缓存超限。每卡装载最多 128 个 URL、24M UTF-16 字符单元和 8 层。输入 HTML 仍限 128K 字符，解析后的远程 HTML 限 1 MiB。Helper 在本卡 HTML 脚本之前运行，不提供独立后台任务，也不声称任意 MVU bundle 已兼容。

外部 Worker 每卡解释器分配上限为 192 MiB、栈 1 MiB；这是单实例上限，不是启动预分配或整页内存预算。运行面板没有固定四实例门槛。冷启动外部看门狗为 15 秒，初始单次执行 2 秒，后续入口 120 ms，响应外部看门狗 1.5 秒。每入口最多 200 Promise jobs、10,000 桥接调用；每卡最多 128 定时器、8,192 DOM 节点、1 MiB 输出，每秒最多 256 输出消息和 128 输入事件。定时器范围 16–60,000 ms；动画回调用定时器实现，不等价原生布局时钟。展示 iframe 无脚本权限且 CSP 禁止网络；第三方代码只得到解释器内虚拟 DOM，不获得原生 Worker/浏览器句柄。

脚本面板首次进入可见区域时启动；不支持 IntersectionObserver 的浏览器按原初始化路径启动。当前 RP 视图内，已启动实例在滚动离屏后保留同一 VM、DOM 与内存状态，滚回不会重跑初始化。离开 RP 视图、实际显示区域隐藏、替换周目或消息源码/绑定范围、禁用或卸载时释放其 Worker、定时器、变量订阅和临时权限，不取消后台 Agent 或模型任务。返回时缓存画面先只读，完成本次权威读取后才启用新的脚本/输入权限。swipe 保留已下载依赖与来源缓存；消息实例和权限按精确 scope 重新创建，helper 在各面板 VM 内运行。显示区域隐藏依据实际布局或 CSS 可见性；仅滚出视口、transform 位移、裁剪或 opacity 不触发释放。逐步浏览更长历史会保留更多实例；当前没有整页内存预算或两倍可见数量的缓存淘汰策略。

受控草稿存储 IPC 暂停只向当前解释器入口补偿一次实际等待时间，每次最多 1 秒；等待前的验证、发送与序列化，以及恢复后的 JavaScript 仍计入原执行预算。补偿不会重置已消耗的时间、桥接次数或 Promise jobs。存储回复 1 秒、响应 1.5 秒、冷启动 15 秒及可信点击、来源和会话权限期限仍按真实墙钟计时；取消、超时或迟到回复不能恢复已销毁的卡片。成功的原生布局回复仅补偿受控暂停时间，每个解释器入口合计最多 1 秒；验证及计算仍消耗原预算，拒绝、超时、过期和已销毁的测量不补偿。定时器、变量写入和开场确认不获得存储等待补偿。

解释器入口失败报告固定诊断码：中断处理器实际触发截止时为 `CARD_EXECUTION_TIME`，其他 JS 异常为 `CARD_EXECUTION_JS`。同时报告固定阶段（包括 timer/resize）、入口墙钟耗时、受控桥等待耗时及实际补偿耗时；墙钟耗时不是 CPU 用时。布局等待计入 bridgeWaitMs，仅成功且仍属于本入口的回复获得上述有界时间补偿；layoutFailure 的固定枚举区分无布局错误、回复超时、接收端拒绝及原布局预算耗尽。诊断不读取或输出卡片异常正文、变量、存储键或私有源码。外部错误与所属卡片使用同一临时展示标识。脚本失败会终止 Worker、事件桥、变量订阅与临时权限，保留本卡禁脚本 DOM 的被动尺寸观察，原生 details 展开/收起仍按当前内容更新高度；替换或卸载时一并释放。脚本 resize 消息请求可信父页重新测量当前 DOM，迟到的数字不会覆盖最新高度。

可信展示/测量接收端在更新 iframe 或读取布局前，独立校验视图类型、1 MiB 大小及净化片段的 8,192 节点预算（含 body、文本及注释，不含接收端固定添加的样式节点）。惰性 HTML 解析本身仍受输入大小限制；预算检查不是浏览器解析或布局的可抢占保证。接收端从已接受片段建立唯一节点映射；只有明确的 documentElement 请求使用根 ID，其他目标须有合法且匹配的标识并仍挂载在本卡，缺失、重复、移除或被净化去除的目标明确报错。

click/input/change/key/pointer 事件复制为虚拟事件，输出净化后展示；快照恢复焦点、选区和滚动位置，不等价完整 DOM diff。缺失 API 明确失败，不伪造零值尺寸。卡片不添加启动、重启、暂停按钮或运行源码入口；原文可通过消息编辑查看，下载状态与运行开关仍由会话设置管理。普通文本、静态 HTML 与脚本卡片都置于同一个配置的 RP 消息壳内，统一按角色对齐。HTML 不替换消息壳，也不在壳内再加正文气泡；来源 HTML 的样式仍隔离在内容区域。iframe 基础根规则在加载时匹配嵌入页配色方案，避免透明画布被浏览器改为不透明背景；来源样式仍可覆盖该规则。

| 扩展接口 | 明确支持的子集 |
| --- | --- |
| `$` / `jQuery` | 选择卡片内元素、ready 回调、text/html/val/on；独立实现，无 AJAX、插件或原生 DOM 句柄 |
| `TavernUI.getVariables(options?)` / `getVariables` | 无参数或 `{type:'message'}`；返回整个 variables 对象，含 stat_data/schema/display_data/delta_data，额外字段由 MVU 决定；只读 JSON 副本 |
| `getAllVariables()` | 同一绑定消息快照，不合并全局/chat 变量 |
| `TavernUI.onVariables(callback)` | 返回取消订阅函数；已提交快照 `{version,scope,revision,variables,status}`，最多 64 个订阅；不是原版可变的 before-update 事件 |

变量绑定由可信历史消息的 playthrough/session/node/variant/endEventId（以及已有格式版本）确定，服务再次验证；脚本不能用 options 改变作用域。空开场白可用明确的 `{mode:'initial',playthroughId,sessionId,characterId}` 作用域，仅绑定已解析的根会话及所选角色；来源再次验证空持久历史，首个 turn 开始后永久关闭该初始作用域。离开、切角色/会话、重挂载均销毁旧绑定与授权。没有可核实坐标的导入与流式内容不绑定变量。MVU 不可用时读取明确报错；不回退到当前焦点会话。只读轮询与变量提交语义由 MVU bridge 提供，写操作需要单独的 Host capability，不继承模型工具权限。消息建议仍需卡片外确认；受控输入请求走其独立的真实点击校验，与模型工具授权完全分离。

开场白的读取 iframe 在生成及初始写作用域消失时保留；写授权和待执行写入独立撤销。历史卡片正文不变时复用解析、清洗结果，避免随流式刷新重复处理。初次 MVU 读取显示加载状态；读取失败或缺失快照提供本卡重新加载入口。生成中尚未读到快照的卡片在生成结束后重试；schema 原文或解释器版本不匹配仍报错。离开视图销毁旧运行时，返回后先完成本次挂载的权威读取，再启用脚本。

## 就绪且开启的脚本变量

外观面板管理下载和脚本开关。总开关未设置时默认开启，已保存的关闭选择保持关闭。就绪且开启的受支持代码可使用当前绑定变量，不需要源码核对、单独写批准或按时失效的权限。刷新恢复持久缓存，运行时重建自动替换内部绑定；切换 session 不转移变量值或 capability 对象。Host 校验完整执行包 hash 与准确 scope；执行绑定不保存源码正文，下载原文另存于环境缓存。

渲染器支持已核实的 `Mvu.getMvuData(options?)` 整对象读取、`Mvu.updateVariablesWith(JSONPatchArray)` 和 `await Mvu.replaceMvuData(wholeVariables, options?)`，不声称支持回调重载。options 只可指向本绑定消息；global/chat/character、latest 或数字别名不会把历史气泡暗中改指当前焦点。`eventOn(Mvu.events.VARIABLE_UPDATE_ENDED, callback)` 在本绑定有更新的已提交 revision 或从不可用恢复为可用时无参回调；恢复读取不表示新提交。不声称原版事件 payload 或可变 before-update 语义。

MVU 服务验证当前资源/头、选择与成员关系、来源 schema、CAS revision、幂等操作 ID 和最终执行 lease。缺失集成及历史 scope 明确失败。渲染器生成 operationId，并保留 Worker 实际看到的 revision。关闭或卸载立即停止本地执行并撤销内部绑定。原生卡片提交发出 card_variable_update 事实供 manager 观察，不再请求第二次 manager 批准；模型注入与助手更新保持原有策略。

主线程识别浏览器 `isTrusted` 输入，原生 Worker 仅在处理该事件期间携带私有 taskId，VM 不接触它。原生定时器单独标记 interval，程序生成点击与初始执行为 script，卡不能选择 cause。Host 服务依赖现有可信 UI dispatcher 提供浏览器事件证据，不能独立或密码学证明人类点击；grant 创建及撤销在读请求体前额外要求 DSH connection admission，并保留本机 Origin/媒体类型/桌面 token 防护；缺少 admission 时关闭写入口。已 admission 的 dispatcher 是受信边界，不等于密码学人类点击证明。grantId 和 MVU capability 从不进入解释器。


内置 MVU 兼容层默认按 `mvu-builtins.js` 中的精确导入入口选择本地能力合同 v1，并检查每个选定引用的调用形式。受支持的副作用 import 或普通 script 初始化直接使用本地实现，不下载原 bundle 或其 provider 图。完整 Helper schema 先经共享有界 schema DSL 解释器验证声明语义。无法匹配入口或调用语义时显示不支持，不自动回退；只有明确选择原代码模式才获取原模块图。`renderingAdapters` 仅保存资源限定的模式覆盖，不含审批、摘要或写许可。兼容记录保存本地能力种类与版本，不携带原 bundle 的正文或摘要；旧下载内容作为惰性缓存保留，原 bundle 不执行。支持副作用 import 与普通 script 初始化；不冒充具名导出、动态注册或任意运行时 Zod 对象。完整 schema Helper 仅在可用权威快照的 `variables.mvu_schema` 满足 `mvuSchema:1`、`interpreterVersion:1` 且完整 source 精确一致时跳过 VM 执行。显示的 `source-registered` 是快照派生的本地确认，不是注册 API；快照不可用、未知版本及原文不同均明确失败。

传输前及 Worker 内再次限制展开后的初始化：最多 128 个 runs、128 个模块及 24 MiB UTF-8 总量，重复代码仍计费，context/variables 限 256 KiB。早期 timer 的 idle 不取消启动截止。会话设置中的脚本开关、视图切换与卸载仍能终止所属实例。原生待决写入最多 32 项并要求单调 ID；一次可信输入 task 最多归属一次写入。写入等待截止为 30 秒，结果不确定或回传失败会终止运行时并显示 operationId 供回执核查，不自动生成新 ID 重试。本地撤销立即停止写入；服务端撤销失败即使卡片卸载仍保留可见重试项。


## 卡片内布局读值

外部 Worker 使用固定 QuickJS Asyncify 0.31.0，让 `getBoundingClientRect()`、scrollHeight/scrollWidth、offsetHeight/offsetWidth/offsetTop/offsetLeft、clientHeight/clientWidth 及 `getComputedStyle()` 在脚本看来同步返回真实布局。每次读取先提交当前虚拟 DOM 的净化快照，再仅测量该卡的无脚本 iframe；不读取 Host 页面、其他卡或任意外部窗口。computed style 是本次读值的快照，支持普通属性与 `getPropertyValue`，不承诺浏览器的 live CSSOM。卡内未渲染的节点不能冒充有布局的节点。父页面、canvas、网络、模型工具及系统权限不会因此开放。

事件、计时器、变量通知和 Promise jobs 串行进入解释器；一次任务最多 16 次布局请求，单次测量 1 秒截止，沿用整体执行/启动截止。请求绑定 Worker nonce、单调 ID 和当前 iframe 代次；切换、撤销、卸载或超时会取消旧测量并终止 Worker，迟到响应不恢复旧任务。布局结果只返回有界 JSON；不伪造零值尺寸，不把 Promise 改成同步执行。截止是任务看门狗，不能抢占浏览器主线程内已经开始的同步布局；DOM/源码大小限制仍是必要边界。

`quickjs-async-jobs.js` 是固定版本的内部 API 兼容层。0.31.0 的公开同步作业入口不适用于挂起的 Asyncify job；兼容层使用明确异步 C 包装，等待作业返回后才释放输出指针和值句柄。构建检查 core/variant 版本一致且均为 0.31.0，运行时检查所需符号；未知版本或缺失符号关闭该能力，不回退至同步 wrapper。升级 QuickJS 必须重新验证此处内部 API 耦合、嵌套 Promise、异常、取消、截止和恰一次释放。

卡片 viewport 只提供只读的 `innerWidth/innerHeight`（同名全局属性亦可读），取自本卡 iframe 的实际内容尺寸，不提供 Host DOM、screen 或任意 Window API。宿主观察本卡尺寸变化，合并连续更新后在原串行解释器队列派发 `window` 的 `resize` 事件；该事件属于 script 原因，不提升为用户点击。切换、禁用、撤销与卸载会断开观察和待执行回调。html/body 的 class、内联样式（包括 CSS 变量）作为有界展示数据投影，其他根属性不在此接口内。包含固定定位或 `vh/dvh/svh/lvh` 高度单位的页面使用 `clamp(362px,75dvh,800px)` 卡片面板，iframe 内的高度单位与脚本尺寸都针对该面板；面板统一管理高度，脚本 resize 请求不会覆盖它。仅使用 `vw` 的响应式宽度或字体不启用此面板；单独出现在 `max-height` 声明中的视口高度上限（例如滚动列表的 `max-height: min(430px,68vh)`）也不启用此面板。普通流式页面按内容高度展示，基础 body 流布局把子元素边距纳入测量，不添加宿主内边距。

普通流式卡片按实际内容高度缩放，不保留宿主额外的 100px 最低空间；最大高度仍为 800px。仅填入保留选项卡片，直接发送受理后本卡的关闭请求移除整个 iframe，不再向对话添加发送成功提示。

开场 dock 中，只有显式标记容器内的单张 viewport 卡会使用嵌入式布局：面板高 `clamp(392px,75dvh,800px)`，iframe 填满网格区域；存在媒体状态或错误时才为其保留空间，不添加运行控件栏。脚本仍读取 iframe 的实际尺寸；不再在 `45dvh` 的外层滚动窗口里独立放入更高的 iframe。普通开场文本、多卡布局与原生 Host 窗口保持原布局。窄屏时，源页面可在自己的滚动区域内响应较小尺寸；此接口不重写源页面的最小高度或响应式规则。