1c6cd23ac5
Use resource identity for thumbnail state and distinguish stale refs from unexpected errors. Append image diagnostics before deciding whether MCP results are empty, and reuse shared role, media and workspace helpers. Use the capture filter's geometry consistently, share mobile plugin transport, and remove redundant state, error variants and test assertions. Update the API and architecture documentation to match. Validation: pnpm run check; focused frontend, Gemini, MCP, image and byte-stream tests; Android debug APK build.
3 KiB
window.__TAURITAVERN__.api.layout — 内容视口
在移动端，宿主让内容视口只占据可交互区域：系统栏、刘海和停靠键盘已经从视口尺寸中扣除。扩展按普通浏览器规则排版即可，不需要识别宿主或扣除 inset。浮动与分离键盘不缩小视口。
.my-panel {
position: fixed;
inset: 0;
display: flex;
flex-direction: column;
}
.my-panel-content {
flex: 1;
min-height: 0;
overflow: auto;
}
100vh、100dvh、window.innerHeight、position: fixed、<dialog> 和 iframe 都使用各自正常的浏览器坐标系。--doc-height 是静态 CSS 别名：支持时为 100dvh，否则为 100vh。
读取与订阅
const layout = window.__TAURITAVERN__.api.layout;
const snapshot = layout.snapshot();
const unsubscribe = await layout.subscribe(snapshot => {
console.log(snapshot.viewport.width, snapshot.viewport.height);
});
await unsubscribe();
宿主 abiVersion: 2；布局快照 version: 2，长度单位为 CSS px：
timestampMs：读取时间。viewport：visual viewport 的{ left, top, width, height, right, bottom }；没有 VisualViewport API 时读取布局视口。safeFrame：与viewport相同。safeInsets：{ top: 0, right: 0, bottom: 0, left: 0 }。ime：{ bottom: 0, viewportBottomInset: 0, keyboardOffset: 0 }。
safeInsets 与 ime 表示视口内仍需页面自行避让的量，宿主已全部消费，因此为零。订阅立即交付一次快照，之后把 window resize 与 visual viewport resize/scroll 按帧合并交付；最后一个订阅取消时移除监听。
系统栏区域
非沉浸模式下，系统栏后面显示宿主绘制的壁纸或主题底色。网页像素（包括遮罩、滤镜和视频）不会延伸到系统栏。
截取
await layout.capture() 返回当前内容视口的 image/png Blob，属于第一方使用的 Project Contract。图像左上角对应内容视口 (0, 0)，宽度对应 window.innerWidth；分辨率由平台决定，调用方用图片宽度除以视口宽度换算 CSS 坐标。系统栏不在图中，不滚动页面或拼接视口外内容。
调用方负责等待重绘，原生接口只读取像素。macOS 使用 ScreenCaptureKit 捕获本进程窗口并裁至内容视口，无需屏幕录制授权；iOS 使用 WK snapshot，其他平台使用各自的原生截图接口。失败直接拒绝 Promise，Web Host 以 Unsupported 拒绝。
旧契约
ime.activeSurface与ime.kind已移除。--tt-inset-*保留为env(safe-area-inset-*, 0px)的别名；--tt-viewport-bottom-inset是--tt-inset-bottom的别名。--tt-ime-bottom与--tt-base-viewport-height已移除。data-tt-mobile-surface属性与layout-kit.js的SURFACE/applySurface()没有布局作用，只为已有调用保留。layout-kit.js的getLayoutApi()、waitForHostReady()、subscribeLayout()继续可用。
使用旧键盘位移、spacer 或安全区补偿的扩展，删除这些代码，直接按内容视口排版。