diff --git a/refactor/README.md b/refactor/README.md
index 207d98775..bd74c3925 100644
--- a/refactor/README.md
+++ b/refactor/README.md
@@ -40,6 +40,7 @@
| [差异与风险索引](risk-table.md) | 已复现问题、源码事实和待核实事项的责任任务 |
| [风险维护说明](risk-guide.md) | 证据等级、关闭条件、第三方边界和校验命令 |
| [第三方来源清单](third-party.json) | 依赖解析、vendor 文件指纹、SDK/CDN 与许可来源缺口 |
+| [消费者与真实环境矩阵](environment-matrix.md) | 22 包的版本依据、能力/设备/样本、现有证据、验证任务及发布影响 |
## 维护规则
diff --git a/refactor/changes/2026-09-10-BASE-08-environment-matrix.md b/refactor/changes/2026-09-10-BASE-08-environment-matrix.md
new file mode 100644
index 000000000..5a3eeec8d
--- /dev/null
+++ b/refactor/changes/2026-09-10-BASE-08-environment-matrix.md
@@ -0,0 +1,9 @@
+# BASE-08：消费者与真实环境矩阵
+
+日期 2026-09-10；起点 ed293231；分支 codex/compatible-modernization。
+
+[环境矩阵](../environment-matrix.md) 覆盖全部 22 包的初始版本、发布证据范围、类型/格式与运行能力、媒体/SDK/设备、现有报告和后续任务。明确旧核心+新插件等四种组合、Node10 解析模式含义、内置浏览器替代 Chrome 的范围，以及缺环境阻止哪些批次、如何补证据。
+
+本次没有新跑浏览器或声明新的最低浏览器/TS 版本。已有 core/chapter 基线被引用；其他包、三引擎、Safari/Android/Cast/PiP/IMA/模型和 codec 范围仍待对应任务验证。没有把矩阵完成改写为其中检查全部通过。
+
+通过现有 plan 校验与一次性 22 包/版本覆盖及任务引用检查，人工核对任务职责和媒体报告路径；纯文档改动无需新增测试框架。生产源码、依赖和产物均未改动。独立提交 BASE-08，可单独撤销；下一项 ENG-04，直接落地类型配置和正反例，不新增整批外部环境等待依赖。
diff --git a/refactor/environment-matrix.md b/refactor/environment-matrix.md
new file mode 100644
index 000000000..40aaaa363
--- /dev/null
+++ b/refactor/environment-matrix.md
@@ -0,0 +1,64 @@
+# 消费者与真实环境矩阵
+
+BASE-08；2026-09-10；来源提交 ed293231。矩阵建立完成，矩阵内未运行的检查仍待完成。版本与路径以 [发布冻结](baselines/releases.json)、[包初始快照](package-inventory.json)、[分发观察](baselines/distribution.json)、[demo 清单](baselines/demo-inventory.json) 和 [第三方清单](third-party.json) 为依据。
+
+## 版本和分发维度
+
+工作区版本不是发布证据。当前只冻结 core 5.4.0 和 chapter 1.1.0 的发布 tarball，核心工作区为 5.4.1；其余包的真实发布版本、旧核心支持窗口由各包 01 任务核实。历史最低浏览器/TS 版本尚未证明，不把本机版本设为用户最低版本。全部包仍按自身下一 major 准备，版本目标见 [版本策略](version-policy.md)。
+
+| 检查 ID | 内容及执行方法 | 当前证据/状态 | 责任与发布影响 |
+| --- | --- | --- | --- |
+| ENV-FORMAT | 库的 root/legacy、CJS/ESM/UMD/AMD/global；核心 i18n、SSR import；隔离 tarball 消费 | core/chapter Node 24.21.0 的 18 项 runtime 检查通过，见 [消费者报告](baselines/consumers.json)；其他包未验证 | ENG-06/07、各包分发任务；入口缺失阻止对应库，公共构建变化要求全部受影响库复验 |
+| ENV-TYPES | TS 5.9.3：Node10+CJS、NodeNext+CJS/ESM、Bundler+ESM，strict、不跳过声明检查 | core/chapter 16 场景中 8 成功、8 历史失败，见 [类型明细](baselines/consumer-coverage.md)；最低 TS 与其他包待核实 | ENG-04、CORE-07、各包类型任务；BASE-TYPE-01/02/03/04 不能按基线失败豁免候选 |
+| ENV-COMBINATION | 旧核心+旧插件、新核心+旧插件、旧支持范围核心+新插件、新核心+新插件 | 前一组合仅 core/chapter 最小覆盖；其他组合未运行 | PILOT-01、CORE-22、各包集成任务；缺少受影响旧调用/旧核心支持证据阻止该批次 |
+| ENV-SITE | VitePress 构建、docs HTML、编辑器加载/执行/声明、移动入口、React/Vue 消费 | 站点静态构建在 [Yarn 验证](baselines/yarn-validation.json) 通过；完整页面/编辑器/框架真实运行未验证 | SITE-01..06、EX-01..03；按站点 URL/资源验收，不创造未经历史核实的 npm 库 API |
+
+Node10 是 TS 模块解析模式名，不代表支持 Node.js 10。现代 es2020 / legacy es2015 是构建语法目标；不保证 WebCodecs、WebAudio、PiP、Cast 或 SDK 在所有旧浏览器中存在。
+
+## 运行环境和媒体维度
+
+| 检查 ID | 环境、媒体和自动化方法 | 已执行范围/缺口 | 责任与解除方式 |
+| --- | --- | --- | --- |
+| ENV-DESKTOP | Windows 内置浏览器，报告 UA Chrome/152.0.0.0；真实 DOM、键盘、媒体事件和时间推进 | core/chapter 的 API/生命周期/DOM/SSR/性能已采集；见 [API](baselines/public-api.json)、[生命周期](baselines/lifecycle.json)、[DOM](baselines/dom.json)、[SSR](baselines/ssr.json)、[性能](baselines/performance.json)。历史问题另见 risks.json；不是所有功能通过 | ENG-05/08、CORE-18/22；将同夹具接入候选及 Playwright。Chrome 连接不可用可继续用内置浏览器，记录实际 UA |
+| ENV-ENGINES | Playwright Chromium/Firefox/WebKit，Range/失败媒体服务，依据状态等待而非固定 sleep | 三引擎自动化尚未安装/运行；内置浏览器不能替代 Firefox/WebKit 结论 | ENG-05；取得各引擎的基础播放/清理报告。WebKit 自动化不代替 Apple 真机 |
+| ENV-MEDIA | docs/assets/sample/video.mp4、video2.mp4；HTTP /assets/sample/；源路径和 SHA-256 已随 lifecycle 报告保存 | 已有 MP4 在本机实际解码/seek/切源；首个样本宽 640、时长约 90.046 秒。没有将扩展名推断为精确 codec/profile。WebM、HLS/DASH、无音轨、损坏/慢响应/中断的全矩阵未完成 | ENG-05、EX-03、相关包；固定授权样本、codec/profile/容器和哈希，补充拓扑/错误样本。现有素材完整来源仍属 BASE-MEDIA-01 |
+| ENV-APPLE | macOS Safari、iPhone/iPad Safari；原生全屏、AirPlay、音频解锁、旋转/触控 | 设备/版本当前未知、未运行；桌面 UA 或触控模拟不是设备证据 | CORE-16/17/18/22、REL-03、相关包 05；在实际设备记录 OS/浏览器/媒体/操作与结果。缺口阻止受影响核心/插件发布，不阻止本地纯计算和 TS 迁移 |
+| ENV-ANDROID | Android Chrome；触控、横竖屏、前后台、播放恢复 | 设备/版本当前未知、未运行 | CORE-16/17/18/22、REL-03、相关包集成；真实设备执行，报告不能只含 viewport 模拟 |
+| ENV-SPECIAL | PiP/Document PiP、Cast 接收设备、IMA、模型 GPU/WASM、WebCodecs、AudioContext | 具体版本/资源见 third-party.json；源码路径观察，完整设备/服务运行未验证 | 按下表包责任执行，记录权限、用户手势、网络与能力检测、失败/退出/销毁；mock 只覆盖适配器逻辑 |
+
+## 每包能力、样本与验收责任
+
+下表版本全部是工作区初始版本；仅明确写“发布已冻结”的两包另有 tarball 证据。所有库均受 ENV-FORMAT/TYPES/COMBINATION 约束，浏览器基本路径受 ENV-DESKTOP/ENGINES 约束。包内 demo 的精确路径从 demo-inventory.json 读取，避免另存一份会漂移的 URL 清单。每行“待”均指尚未执行，不是 skip 或通过。
+
+| 包 / 工作区版本 | 能力与固定样本/资源要求 | 当前状态、待补环境 | 负责验证任务 |
+| --- | --- | --- | --- |
+| artplayer / 5.4.1 | 原生媒体、字幕、切源、控件/设置、全屏/PiP、SSR；ENV-MEDIA + VTT/SRT | 发布 5.4.0 已冻结；桌面部分基线，移动/原生全屏/PiP/多引擎待测 | CORE-07/16/17/18/22/23、ENG-05 |
+| artplayer-plugin-ads / 2.1.0 | 广告图片/视频、本片恢复、跳过、错误/销毁；本地短广告和主片 | 发布范围及所有浏览器场景待；无需借 IMA 结果代替自有广告逻辑 | PKG-ADS-01/02/05/06 |
+| artplayer-plugin-ambilight / 1.1.0 | Canvas 采样、CORS、resize、后台/销毁；同源及受控跨源 MP4 | 待真实画布和资源测量 | PKG-AMBILIGHT-01/02/05/06 |
+| artplayer-plugin-asr / 2.1.0 | PCM 音频输出/暂停/销毁；AudioContext + 调用方服务 | 待音频环境与调用方 WebSocket 验证；示例服务版本未知，不在 PR 调线上服务 | PKG-ASR-01/02/05/06、EX-03 |
+| artplayer-plugin-audio-track / 1.1.0 | 音轨切换与同步；固定双音轨/单音轨/无音轨样本 | 待轨道来源和支持窗口确认、Safari/桌面实测 | PKG-AUDIO-01/02/05/06 |
+| artplayer-plugin-auto-thumbnail / 1.1.0 | 帧提取/跳转、CORS、回收；本地 MP4+跨源失败 | 待 Canvas/seek/移动内存行为 | PKG-AUTO-THUMB-01/02/05/06 |
+| artplayer-plugin-chapter / 1.1.0 | 区间、边界/重叠、hover/update、进度条组合；MP4+固定章节 | 发布 1.1.0 已冻结；最小注册/两段 DOM 已验，边界和新旧组合待 | PKG-CHAPTER-01/02/04/05/06、PILOT-01 |
+| artplayer-plugin-chromecast / 1.1.0 | Cast SDK、发送/接收会话、取消/断线、本机恢复；接收端可访问媒体 | SDK 动态地址已记录；真实接收设备和 sender 版本未知、待运行 | PKG-CAST-01/02/05/06 |
+| artplayer-plugin-danmuku / 5.3.0 | 弹幕布局/碰撞/时间/worker、seek/restart；固定弹幕时间表 | 待桌面/移动、长播放/压力及组合 | PKG-DANMUKU-01/02/05/06/07/08/09 |
+| artplayer-plugin-danmuku-mask / 1.1.0 | MediaPipe/TensorFlow 模型、GPU/CPU/WASM、停止/销毁；人物短片 | Yarn 与 model URL 分开；默认 solutionPath 无固定版本，下载/推理/失败待 | PKG-MASK-01/02/05/06 |
+| artplayer-plugin-dash-control / 1.1.0 | dash.js 实际表示/音轨、自动/手动高亮、切换拓扑；固定 MPD/segments | 本地选择逻辑 Node 测试已有；真实 dash.js/浏览器流待，示例版本见 SDK-02 | PKG-DASH-01/02/05/06、EX-03 |
+| artplayer-plugin-document-pip / 1.1.0 | Document PiP、节点/样式迁移与退出恢复 | 支持浏览器/版本待确认，真实用户手势与 PiP 窗口待 | PKG-DPIP-01/02/05/06 |
+| artplayer-plugin-hls-control / 1.1.0 | hls.js 清晰度/音轨自动手动切换；主/子列表与拓扑变化 | 实际 SDK/流未运行，示例版本见 SDK-01；Safari 原生 HLS 与 hls.js 路径分开 | PKG-HLS-01/02/05/06、EX-03 |
+| artplayer-plugin-jassub / 1.1.0 | ASS、worker/WASM/font 加载、切源/销毁；短 ASS+明确来源字体 | 内嵌资源哈希已有；版本对应、跨源/worker 限制、实际渲染待 | PKG-JASSUB-01/02/05/06 |
+| artplayer-plugin-multiple-subtitles / 1.2.0 | VTT 合并/排序/解析错误、URL 回收；双语言/空/坏 VTT | parser 来源头已观察；特有行为和浏览器字幕待 | PKG-MULTI-SUB-01/02/05/06 |
+| artplayer-plugin-vast / 1.2.0 | Glomex/Google IMA、广告错误/恢复、重复初始化；供应商测试广告标签 | 依赖版本已记录；实际 IMA 网络/广告流程待，PR 用受控 adapter | PKG-VAST-01/02/05/06 |
+| artplayer-plugin-vtt-thumbnail / 1.1.0 | WebVTT 时间和 sprite xywh、图片失败/跨源；本地 VTT+sprite | 发布/浏览器/边界待 | PKG-VTT-THUMB-01/02/05/06 |
+| artplayer-proxy-canvas / 1.1.0 | video-like 属性/事件、Canvas 绘制、seek/销毁；MP4 | shim 与实际媒体顺序、跨源/移动待 | PKG-CANVAS-01/02/05/06 |
+| artplayer-proxy-mediabunny / 1.2.0 | Mediabunny 1.56.1 当前解析；WebCodecs/AudioContext、HLS/轨道拓扑、AV 同步 | 库依赖不等于 codec 可用；准确 codec/profile、设备能力、长播放待 | PKG-MB-01/02/07/08/09/10 |
+| artplayer-tool-iframe / 1.1.0 | 跨窗协议、ready/错误/销毁；同源与两个受控不同 origin 页面 | 消息/嵌套浏览器及沙箱权限待 | PKG-IFRAME-01/02/05/06 |
+| artplayer-tool-thumbnail / 4.4.0 | 视频抽帧、下载图片/VTT、seek/错误/取消；本地 MP4 | BASE-DIST-01 的入口/声明问题待核实；Canvas/下载/移动待 | PKG-TOOL-THUMB-01/02/04/05/06 |
+| artplayer-vitepress / 1.1.0 | ENV-SITE；Monaco/vConsole、示例 CDN/声明、构建静态资源 | 本地站点构建已验；编辑器实际执行/移动 HTML/旧链接待，npm 意图待核实 | SITE-01/02/03/04/05/06、EX-01/02/03 |
+
+## 报告和发布判定
+
+已有报告位置见上文及 baselines/；新验证将命令、源码 SHA/候选 tarball integrity、包/核心/SDK/浏览器/OS/设备版本、样本哈希与 codec、能力检测、通过/失败/缺环境、trace 位置和限制写入对应 changes/任务记录，CI 大型 trace/录像留 artifact。缺环境报告写清获得何种设备/服务后执行哪个场景，不能虚构负责人姓名或设备版本。
+
+REL-08 按实际改变的依赖/能力选择本矩阵中的门槛。核心或共享构建变化可能影响所有旧插件，不能以某插件未改文件就豁免其组合测试。独立 chapter 试点不需要等待 Cast 接收器，但核心 Cast 相关行为改变后，缺 Cast 实测就阻止受影响核心批次。声明或分发失败阻止该包；codec 不支持要区分原本支持的能力回归和已证明的可选能力边界。
+
+矩阵用于分配工作，不新增整批等待依赖。下一步直接实施 ENG-04 类型配置；多引擎、样本、真机与外部资源分别由既有工程和包任务补齐。修改候选源码、依赖或构建后，旧候选测试结论不再自动有效。三轮复盘和正式授权发布门槛保持不变。
diff --git a/refactor/plan.md b/refactor/plan.md
index a6bb3ce4f..e838ce183 100644
--- a/refactor/plan.md
+++ b/refactor/plan.md
@@ -4,7 +4,7 @@
基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 214 项，范围 22 个包及工作区/示例。
-状态：todo 190 / doing 0 / blocked 0 / done 24 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
+状态：todo 189 / doing 0 / blocked 0 / done 25 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
前置依赖是启动条件；验收是完成条件。任务可以继续拆分，但不能复用或悄悄删除旧 ID。
@@ -67,7 +67,7 @@
| BASE-05 | workspace
捕获包入口、资源和类型消费 | BASE-01 | 全包 manifest/资源路径清单；核心/试点的 UMD/AMD/ESM/CJS/legacy/i18n 和类型消费者基线；登记契约/版本/固定测试 ID/命令/报告与负责任务；区分库/npm 与站点实际分发类别，SSR import/模板/非浏览器构造错误分别捕获 | 核心/试点隔离消费可运行，其他包由各自契约任务验证，thumbnail tool 差异已登记 | H | done |
| BASE-06 | workspace
记录性能与资源基线 | BASE-03, BASE-04 | 固定媒体/设备测量、包体积、反复装卸资源报告 | 多次采样可重跑，指标和审查阈值确定，不承诺未经测量的收益；使用已发布包和最小可重跑探针启动，不等待后续 ENG 服务 | M | done |
| BASE-07 | workspace
建立差异和风险台账 | BASE-03, BASE-05 | 销毁/切源/类型差异、vendored 许可和外部 SDK 清单 | 已确认与待复现分开，每项有负责任务及兼容处理路线；纳入 BASE-TYPE-01/02/03/04 和 BASE-DIST-01 的发布/声明/工作区证据；纳入 BASE-PERF-01 销毁后 resize/notice 延迟工作 | H | done |
-| BASE-08 | workspace
建立消费者与真实环境验证矩阵 | BASE-01, BASE-05 | 每包版本/浏览器/codec/SDK/设备/样本、证据和负责验证任务的矩阵 | 格式兼容与运行能力分开，未知/缺环境不算通过，明确哪些检查阻止哪些批次发布 | H | todo |
+| BASE-08 | workspace
建立消费者与真实环境验证矩阵 | BASE-01, BASE-05 | 每包版本/浏览器/codec/SDK/设备/样本、证据和负责验证任务的矩阵 | 格式兼容与运行能力分开，未知/缺环境不算通过，明确哪些检查阻止哪些批次发布 | H | done |
## 2 工程保障
@@ -424,6 +424,7 @@
- BASE-05: [记录](changes/2026-09-10-BASE-05-consumers.md) [记录](baselines/consumer-coverage.md) [记录](baselines/consumers.json) [记录](baselines/ssr.json) [记录](baselines/distribution.json)
- BASE-06: [记录](changes/2026-09-10-BASE-06-performance.md) [记录](baselines/performance-coverage.md) [记录](baselines/performance.json) [记录](baselines/sizes.json)
- BASE-07: [记录](changes/2026-09-10-BASE-07-risk-register.md) [记录](risk-guide.md) [记录](risk-table.md) [记录](risks.json) [记录](third-party.json)
+- BASE-08: [记录](environment-matrix.md) [记录](changes/2026-09-10-BASE-08-environment-matrix.md)
- ENG-01: [记录](changes/2026-09-10-ENG-01-reproducible-toolchain.md) [记录](baselines/toolchain-validation.json)
- ENG-PM-01: [记录](changes/2026-09-10-ENG-PM-01-yarn-toolchain.md) [记录](baselines/yarn-validation.json)
- ENG-02: [记录](changes/2026-09-10-ENG-02-readonly-ci.md) [记录](baselines/ci-validation.json)
diff --git a/refactor/progress.md b/refactor/progress.md
index 57ffffc65..1c07cbed6 100644
--- a/refactor/progress.md
+++ b/refactor/progress.md
@@ -1,5 +1,9 @@
# 进度与证据
+## 当前实施：BASE-08 环境矩阵完成
+
+22 包的格式/类型/运行环境/codec/SDK/设备与样本缺口已分配任务和发布影响；见 [矩阵](environment-matrix.md)。只引用已有基线，没有新增浏览器通过结论。当前 214 项，25 完成、189 待办；生产源码 TS 迁移仍为零。BASE-07 提交 ed293231；本任务独立提交。下一项直接实施 ENG-04 类型检查配置，再推进构建与 chapter 试点。
+
## 当前实施：BASE-07 风险与第三方来源台账完成
39 项差异/来源缺口已关联责任任务、证据与关闭条件，22 包运行依赖、8 组内嵌资源（123 个文件）及 12 个集成边界可校验。全部风险仍 open，不能把清点完成视为已修复或获准发布。见 [BASE-07](changes/2026-09-10-BASE-07-risk-register.md)。
diff --git a/refactor/tasks.json b/refactor/tasks.json
index 60f3682cf..aed45a8ca 100644
--- a/refactor/tasks.json
+++ b/refactor/tasks.json
@@ -407,9 +407,12 @@
"scope": [
"workspace"
],
- "status": "todo",
+ "status": "done",
"risk": "H",
- "evidence": [],
+ "evidence": [
+ "environment-matrix.md",
+ "changes/2026-09-10-BASE-08-environment-matrix.md"
+ ],
"id": "BASE-08",
"phase": "1 基线",
"title": "建立消费者与真实环境验证矩阵",