# 兼容矩阵

当前发布候选为 `0.1.0-alpha.13`。本版将媒体拆为包内 PNG／MP3，通过 DSH `webServer` 同源固定路由加载，真实运行入口和媒体进入 Git；不扩大运行时兼容范围。已通过 69 项测试、37 浏览器、类型检查、构建、21 文件包检查及真实隔离 DSH 媒体与动画验收。客户端入口 80,268 bytes；dsh.pub 本地静态分发检查与远程审核分别记录，详见 [TESTING.md](TESTING.md) Alpha.13 节及 [MARKETPLACE.md](MARKETPLACE.md)。

静态媒体服务只用于 Web HTTP 载体，不能据此宣称支持 Desktop／file://。依赖宿主的标准 `webServer` 服务；媒体来自安装包，运行时不依赖外部音乐或图片服务器。

Alpha.11 历史：47 单测、36 浏览器及 18 文件包检查通过，并在真实隔离 DSH 中录制双效果、验证固定节奏与两轴反弹；Alpha.10 的完整宿主 BGM 检验与性能记录另保留为历史。本轮不把旧版本专项记录冒充重新执行的结果。

Alpha.10 历史：运行时沿用 Alpha.9，新增命名／图标／中英文发现信息并修复验收脚本；已通过干净副本安装、47 单测、36 浏览器测试、构建、18 文件包检查和真实隔离 DSH 运行，双效果 1261 帧相位误差 0 ms，音乐、飞行反弹与退出清理通过。证据保留在 TESTING.md 的 Alpha.10 节及 `.qa/release-final/`。下表保留当时 Alpha.9 已安装版本的事实。本版日常实例更新与内置浏览器预览单独记录于 `.qa/deployment/static-alpha13/installation.json`，不能从隔离测试推断。

适配范围：DSH `0.2.0-rc.2`，桌面 Chromium 浏览器中的 Web 客户端。`engines.dsh` 锁定适配版本，本身不证明运行验收通过。

已交付版本 `0.1.0-alpha.9` 将原梗 BGM 改为内置 MP3，移除左下角视频并保留来源跳转链接。两个独立效果、固定 120 BPM、扩大文字与图像候选覆盖及简洁面板沿用 Alpha.8。Alpha.9 类型检查、42 项单元测试、36 项浏览器测试、构建、包检查与真实隔离 DSH 验收通过；日常安装以交付记录为准，结果见 [测试记录](TESTING.md)。历史版本通过结论不替代当前候选重新验收。

| 组合／证据 | Alpha.9 已交付版本的结论与边界 |
| --- | --- |
| 已安装 CLI 的 bundle、client modules、slots 声明 | DSH `0.2.0-rc.2` 公开契约及本版隔离安装运行通过 |
| 真正 DSH Web Host + Alpha.9 tarball | 隔离安装通过，双效果 1261 帧、500 ms 周期、相位误差 0 ms、越界 0；飞行反弹、内置音乐和清理通过，零 pageerror |
| 本地模拟宿主 + Chromium | 36 项浏览器通过，包含内置音乐实际播放／循环／生命周期、播放拒绝、视觉节拍与既有交互保护 |
| 旧设置迁移 | 沿用 Alpha.8：pageEnabled／petEnabled 及 preset 保留，musicEnabled 默认 false；控制器恢复已移除的高级项默认 |
| 内置 BGM | 用户指定 BV1hXbN6VEKV 导出 MP3，默认关闭，固定音量 0.5、循环；无 iframe／平台媒体请求；实际完整解码、内嵌字节哈希和浏览器生命周期通过 |
| BGM 自动播放与同步 | 受浏览器有声播放策略约束，失败提示；视觉固定时钟独立于音乐，不宣称精确跟拍 |
| 日常 profile 更新与内置浏览器预览 | 以 `.qa/deployment/bundled-alpha9/installation.json`、实际构建哈希和 `preview.png` 为准；隔离验收不能代替日常更新 |
| 玩偶运行范围 | 包含 DSH 侧栏的页面可视区，不覆盖浏览器工具栏、其他应用或 Windows 桌面 |
| Windows 中文输入法、物理性能／输入延迟、真实审批与模型流式 | 需人工或专项测量；合成事件与历史 headless 结果不能替代 |
| DSH Desktop／TUI／移动端／其他版本 | 未承诺支持 |
| 跨域 iframe、封闭 Shadow DOM、Canvas 内部 | 不通用遍历，只处理安全可识别外壳；本版 BGM 自身不创建 iframe |

Alpha.8 历史：本机 37 项单元测试、35 项浏览器测试、构建和 14 个公开文件检查通过；真实隔离宿主双效果采样 1260 帧、500 ms 周期、相位误差 0 ms。原版官方 iframe 播放器的媒体状态仅适用于 Alpha.8，不作为本版内置 MP3 的播放证据。

Alpha.7 历史：本机 37 项单元测试、31 项浏览器测试与真实隔离 DSH 检查通过；双效果采样 605 帧、500 ms 周期、最大相位差 0 ms。详见 TESTING.md 的 Alpha.7 历史节与 `.qa/alpha.7/`，这些不是 Alpha.9 的通过证据。

版本适配器按语义标签、可见组件及 `data-chat-flow`／`data-streaming` 等实际标记识别目标，不依赖构建后的 CSS 哈希。扩大候选后仍不对所有 DOM 节点强制施加动画：父级带动的子区域计入覆盖，滚动根、原生弹层、已有变换冲突、固定定位冲突与交互保护区可被主动排除。玩偶使用独立浮层，不依赖文字覆盖率；插件控制入口与面板排除在扫描之外。新增 DSH 版本需更新适配器与验收证据，再扩大声明。