docs(site): [SITE-04] cross-check existing plugin guide semantics

refactor/changes/2026-09-16-SITE-04-existing-guides.md

@@ -0,0 +1,59 @@
+# SITE-04 checkpoint: current semantics of five earlier plugin guides
+
+Cross-check the Chinese and English Danmuku, HLS Control, DASH Control, Audio
+Track and VTT Thumbnail guides against current source and public declarations.
+The ten guides retain all26 existing runnable snippets. Eight non-Danmuku
+snippets additionally match their original demo files exactly. No runtime,
+declaration, package README or dependency changed. DASH's packaged ARCHITECTURE
+clarifies the same synchronous-getter rule; its candidate requires a REL-02 refresh.
+
+Corrections and additions:
+
+- Restore visible Run Code text on both HLS and DASH language pages. Explain
+  synchronous SDK getters/formatters within asynchronously scheduled DASH refresh,
+  rather than implying Promise-returning SDK getters are supported. Record the
+  optional ordinary factory call and required final overload used by Parameters.
+- Correct Danmuku's English whitespace claim: direct and loaded comments preserve
+  text; the input panel trims it. Explain input defaulting mutations, shallow
+  queue copies, non-deduplicating ids, truthy filters, Owner versus registered
+  result, pooled nodes, unused slider show and exported icons versus bundled UI.
+- State VTT's exact progress endpoints and existing control/CSS hooks. Preserve
+  Audio Track's open Windows WebKit native buffering boundary independently of
+  passing source-switch order tests. Correct the English Proxies sidebar title.
+
+The [semantic tracker](../site-content-review.md) now includes these five packages.
+This leaves the core963 enumerated members for explicit semantic mapping. It does
+not substitute guide checks for SDK, media, physical-device or final-demo evidence.
+
+## Verification
+
+All10 exact TypeScript snippets pass strict NodeNext with skipLibCheck:false and
+types:[]. Each page's43–58 distinct local link/file/fragment targets resolve.
+All30 page cases pass on Chromium153.0.8010.12, Firefox155.0 and Windows WebKit26.6,
+with78 successful Run Code forwarding checks, no page errors and no retries within
+the final run. Screenshots are retained; Chromium Chinese HLS layout was inspected.
+Popup editor responses are isolated, so this is navigation rather than playback.
+
+Detailed results, source hashes, browser versions and retained failures are in
+[the evidence record](../baselines/site04-existing-guides.json). Node24.21.0,
+Yarn1.22.22 and TypeScript5.9.3 were used. Inventory remains66 Markdown,75 HTML,
+30 examples and204 assets; no new routes or task status transitions were added.
+
+The first documentation test run detected stale generated LLM content because it
+preceded build:llm. Regeneration followed by all17 tests passed in1209.7607ms.
+Two guide probe attempts failed on their translation-link selectors: first an
+absolute-href assumption, then a Danmuku-specific English-guide label. The final
+probe resolves actual relative URLs and handles both existing labels. These are
+recorded test-script failures, not player defects or silently retried assertions.
+
+build:docs passed in8.96s (Yarn10.51s), as did build:llm/check:llm, configuration
+lint, strict toolchain validation, inventory and historical demo path checks.
+The20 unaffected library build envelopes remain valid; DASH's prior candidate is
+stale after the packaged maintenance correction. All packages retain separate
+release blockers. Generated output came from repository scripts only.
+
+SITE-04 remains doing. Formal REVIEW-01/02/03 waits for user direction. No push,
+remote workflow dispatch, deployment or publication occurred. Reverting this
+checkpoint restores prior guide prose/navigation and generated assets.
+
+The complete staged whitespace check passes without generated-file exclusions.

refactor/plan.md

@@ -687,7 +687,7 @@
 - SITE-DANMUKU-01: [记录](changes/2026-09-15-SITE-DANMUKU-01-guides.md) [记录](baselines/danmuku-docs-validation.json)
 - SITE-HLS-01: [记录](changes/2026-09-15-SITE-HLS-01-guides.md) [记录](baselines/hls-docs-validation.json)
 - SITE-DASH-01: [记录](changes/2026-09-15-SITE-DASH-01-guides.md) [记录](baselines/dash-docs-validation.json)
-- SITE-04: [记录](site-content-review.md) [记录](changes/2026-09-16-SITE-04-chapter-ambilight-guides.md) [记录](baselines/site04-chapter-ambilight-guides.json) [记录](changes/2026-09-16-SITE-04-dpip-asr-guides.md) [记录](baselines/site04-dpip-asr-guides.json) [记录](changes/2026-09-16-SITE-04-auto-multi-guides.md) [记录](baselines/site04-auto-multi-guides.json) [记录](changes/2026-09-16-SITE-04-ads-vast-guides.md) [记录](baselines/site04-ads-vast-guides.json) [记录](changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md) [记录](baselines/site04-jassub-mask-cast-guides.json) [记录](changes/2026-09-16-SITE-04-tools-guides.md) [记录](baselines/site04-tools-guides.json) [记录](changes/2026-09-16-SITE-04-proxies-guides.md) [记录](baselines/site04-proxies-guides.json)
+- SITE-04: [记录](site-content-review.md) [记录](changes/2026-09-16-SITE-04-chapter-ambilight-guides.md) [记录](baselines/site04-chapter-ambilight-guides.json) [记录](changes/2026-09-16-SITE-04-dpip-asr-guides.md) [记录](baselines/site04-dpip-asr-guides.json) [记录](changes/2026-09-16-SITE-04-auto-multi-guides.md) [记录](baselines/site04-auto-multi-guides.json) [记录](changes/2026-09-16-SITE-04-ads-vast-guides.md) [记录](baselines/site04-ads-vast-guides.json) [记录](changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md) [记录](baselines/site04-jassub-mask-cast-guides.json) [记录](changes/2026-09-16-SITE-04-tools-guides.md) [记录](baselines/site04-tools-guides.json) [记录](changes/2026-09-16-SITE-04-proxies-guides.md) [记录](baselines/site04-proxies-guides.json) [记录](changes/2026-09-16-SITE-04-existing-guides.md) [记录](baselines/site04-existing-guides.json)
 - SITE-07: [记录](site-inventory.md) [记录](baselines/site-provenance.json) [记录](changes/2026-09-14-SITE-07-vendor-notices.md) [记录](baselines/site-notices-checkpoint.json) [记录](baselines/site-codicons-provenance.json) [记录](baselines/site-codicons-validation.json) [记录](changes/2026-09-15-SITE-07-codicons.md) [记录](baselines/vconsole-notices-provenance.json) [记录](baselines/vconsole-notices-validation.json) [记录](changes/2026-09-15-SITE-07-vconsole-notices.md) [记录](console-modernization.md) [记录](baselines/site-console-inventory.json) [记录](baselines/site-console-validation.json) [记录](changes/2026-09-15-SITE-07-console-baseline.md) [记录](baselines/console-feed-provenance.json) [记录](changes/2026-09-15-SITE-07-console-feed-source.md) [记录](baselines/console-commonjs-provenance.json) [记录](changes/2026-09-15-SITE-07-console-commonjs.md) [记录](baselines/console-esm-provenance.json) [记录](changes/2026-09-15-SITE-07-console-esm.md) [记录](baselines/console-embedded-notices.json) [记录](baselines/console-notices-validation.json) [记录](changes/2026-09-15-SITE-07-console-notices.md) [记录](baselines/console-embedded-sources.json) [记录](baselines/console-embedded-validation.json) [记录](changes/2026-09-15-SITE-07-console-embedded-sources.md) [记录](baselines/console-derived-attribution.json) [记录](baselines/console-derived-validation.json) [记录](changes/2026-09-15-SITE-07-console-derived-attribution.md) [记录](baselines/console-stackoverflow-provenance.json) [记录](baselines/console-stackoverflow-validation.json) [记录](changes/2026-09-15-SITE-07-console-stackoverflow.md) [记录](baselines/console-shallowequal-validation.json) [记录](changes/2026-09-15-SITE-07-console-shallowequal.md) [记录](console-notice-review.md) [记录](baselines/console-notice-review-validation.json) [记录](changes/2026-09-15-SITE-07-console-notice-review.md) [记录](baselines/monaco-typescript-provenance.json) [记录](baselines/monaco-typescript-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-typescript.md) [记录](baselines/monaco-languages-provenance.json) [记录](baselines/monaco-languages-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-languages.md) [记录](baselines/monaco-language-notices.json) [记录](baselines/monaco-language-notices-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-language-notices.md) [记录](baselines/monaco-modes-provenance.json) [记录](baselines/monaco-modes-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-modes.md) [记录](baselines/monaco-basic-provenance.json) [记录](baselines/monaco-basic-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-basic.md) [记录](baselines/monaco-core-origins-provenance.json) [记录](baselines/monaco-core-origins-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-core-origins.md) [记录](baselines/monaco-core-build-provenance.json) [记录](baselines/monaco-core-build-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-core-build.md) [记录](baselines/monaco-contributions-provenance.json) [记录](baselines/monaco-contributions-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-contributions.md) [记录](baselines/monaco-css-build-provenance.json) [记录](baselines/monaco-css-build-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-css.md) [记录](baselines/monaco-node-path-provenance.json) [记录](baselines/monaco-node-path-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-node-path.md) [记录](changes/2026-09-15-SITE-07-monaco-dom.md) [记录](baselines/monaco-dom-origins-validation.json) [记录](changes/2026-09-15-SITE-07-monaco-unicode.md) [记录](baselines/monaco-unicode-provenance.json) [记录](baselines/monaco-unicode-validation.json) [记录](changes/2026-09-15-SITE-07-font-notices.md) [记录](baselines/site-font-notices-provenance.json) [记录](baselines/site-font-notices-validation.json)
 - EX-01: [记录](changes/2026-09-14-EX-01-react-consumer.md) [记录](baselines/react-consumer-validation.json) [记录](scripts/react-consumer.mjs)
 - EX-02: [记录](changes/2026-09-14-EX-02-vue-consumer.md) [记录](baselines/vue-consumer-validation.json) [记录](scripts/vue-consumer.mjs)

refactor/progress.md

@@ -1,5 +1,15 @@
 # 进度与证据
 
+## SITE-04 早期五个插件指南的当前语义核对
+
+完成 Danmuku/HLS/DASH/Audio/VTT 十份双语指南的源码/声明对照：修正文本空格、
+异步刷新措辞，补齐内部返回对象、数据修改、节点复用、图标/滑块边界及端点行为，
+恢复HLS/DASH按钮文字。10份严格TS、30组真实浏览器页面与78次代码转发、17项工具
+检查通过。见[记录](changes/2026-09-16-SITE-04-existing-guides.md)和
+[证据](baselines/site04-existing-guides.json)。核心963条语义映射仍待完成，SITE-04
+保持doing、224/22/39不变；不进入正式复盘，不将页面转发计作媒体/真机验收。
+DASH包内维护说明同步修正，旧候选指纹已过期，需紧接REL-02重建；其余20库仍有效。
+
 ## SITE-04 Canvas/Mediabunny代理双语指南
 
 补齐四份代理指南、本地导航和原样示例；Canvas说明真实video/绘制/字幕/类型，

refactor/site-content-review.md

@@ -54,12 +54,26 @@ JASSUB、弹幕遮罩和 Chromecast 的本次核对：
 | Canvas | [入口](../packages/artplayer-proxy-canvas/src/index.ts)、adapter/media/renderer/scheduler/geometry/subtitles、根/runtime声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/proxy/canvas.md) / [English](../packages/artplayer-vitepress/docs/en/proxy/canvas.md)：可选回调、Canvas返回/媒体转发、draw/error、尺寸/字幕/生命周期、六个类型 | Canvas原生成员优先、真实video回调、位图先释放再同步回调、无Promise回调等待、首帧特例、调用方stream tracks不停止；旧根/runtime分离，无额外公开控制对象或设备能力保证 |
 | Mediabunny | [入口](../packages/artplayer-proxy-mediabunny/src/index.ts)、VideoShim/canvas-bridge/entry-lifecycle、input/preflight/tracks/hls-state/hls-selection/m3u8菜单、coordinator/playback/readiness、shim-values/frames、公开声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/proxy/mediabunny.md) / [English](../packages/artplayer-vitepress/docs/en/proxy/mediabunny.md)：13项顶层配置、两组五项菜单配置、shim全部公开成员、HLS字段、合成帧字段、11个公开类型 | 字符串后缀HLS检测、Range独立错误路径、配对/实际选中、Auto不保证ABR、兼容字段空setter、SDK fetch不由crossOrigin控制、合成TimeRanges/RVFC、全部不可解码code4与部分播放、过期操作/终止资源；设备/长期/真实SDK证据独立 |
 
+原有五份生态指南的当前语义核对：
+
+| 包 | 对照源码与声明 | 双语指南覆盖 | 保留边界 |
+| --- | --- | --- | --- |
+| Danmuku | [入口](../packages/artplayer-plugin-danmuku/src/index.ts)、danmuku/config/input/queue、scheduler/renderer、setting/setting-send/setting-slider/setting-template、heatmap/geometry/sampling、根/runtime-shared 声明 | [中文](../packages/artplayer-vitepress/docs/plugin/danmuku.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/danmuku.md)：全部配置、注册结果、Owner额外成员、18个runtime类型、11个事件与热力图选项 | 直接/加载文本不trim、原对象填默认值、浅拷贝、id不去重、filter truthy与beforeEmit严格true、追加/替换/取消、节点复用、内部返回对象非完整卸载；icons供外部复用不替换内置图标，show滑块字段未读取；#958坐标兼容及设备门槛保留 |
+| HLS Control | [入口](../packages/artplayer-plugin-hls-control/src/index.ts)、mapping/menu/sdk-events、根与ESM/CJS声明、exports | [中文](../packages/artplayer-vitepress/docs/plugin/hls-control.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/hls-control.md)：两组配置、五个类型、name/update、泛型与末尾必填重载 | 外部SDK所有权、id/索引选择、标签去重、回调可选index、ready/restart与SDK刷新、无runtime/自引用；恢复可见Run Code，仍保留Firefox两个独立故障和MSE/真机边界 |
+| DASH Control | [入口](../packages/artplayer-plugin-dash-control/src/index.ts)、sdk/mapping/menu/sdk-events/seek-buffer、根与ESM/CJS声明、exports | [中文](../packages/artplayer-vitepress/docs/plugin/dash-control.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/dash-control.md)：两组配置、五个类型、name/update、4/5 SDK方法族、同步返回与末尾必填重载 | 异步刷新中捕获同步getter/formatter异常，不支持Promise getter；菜单导航保留、ID零值、唯一轨道匹配、ABR设置、4.5.2指标定向恢复；恢复可见Run Code，SDK/设备验收独立 |
+| Audio Track | [入口](../packages/artplayer-plugin-audio-track/src/index.ts)、track、根/runtime声明 | [中文](../packages/artplayer-vitepress/docs/plugin/audio-track.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/audio-track.md)：url/offset/sync、name/audio/update、五个命名类型 | 阈值严格大于、初始空URL、同URL/空更新不换源、更新offset不即时seek、元素身份与外部监听归属、主音频不自动静音、旧必填url与runtime局部更新；明确WebKit缓冲缺口与换源排序不是同一验收 |
+| VTT Thumbnail | [入口](../packages/artplayer-plugin-vtt-thumbnail/src/index.ts)、request/parseVtt/preview/lifetime、根/runtime声明 | [中文](../packages/artplayer-vitepress/docs/plugin/vtt-thumbnail.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/vtt-thumbnail.md)：vtt/style、四个类型、异步注册、URL/裁剪/取整/首命中/端点与DOM挂钩 | 输入URL为相对图像基准、桌面精确端点隐藏/移动端无新绘制、取消仍返回名称、注册非图像解码、无update/独立destroy；root旧同步声明和runtime准确Promise分离 |
+
+本次保持全部既有可运行代码片段不变，并逐一验证当前页面的转发内容；不是将
+早期播放报告重新标为当前发布验收。十份源码指南的TypeScript片段、链接和三浏览器
+页面检查见本批证据。核心963条仍单独待核对。
+
 ## 接续范围
 
 - 核心：依据 site-inventory.json 的 963 条成员逐项或按明确的共享声明分组核对；
   必须记录对应文档及语义结论，不能仅按同名标题匹配标为通过。
-- 已有 Danmuku、HLS、DASH、Audio、VTT 双语指南：继承各 SITE-* 任务的证据，但
-  仍需在本轮全包核对中检查其当前声明、示例和能力边界。
+- Danmuku、HLS、DASH、Audio、VTT 的当前声明/源码语义已补核对；既有媒体报告
+  仍使用原候选和原环境，不用本轮页面验证覆盖SDK、解码或设备缺口。
 - 16个插件、两个tool、两个proxy现均有独立双语指南；新增页面的参数和限制已对照
   当前源码。包内维护地图与用户指南用途不同，继续维护二者的一致性。
 - SITE-05 和 EX-03 负责后续完整页面与实际 demo 验收；静态内容核对不等待真机，

refactor/tasks.json

@@ -4570,7 +4570,9 @@
         "changes/2026-09-16-SITE-04-tools-guides.md",
         "baselines/site04-tools-guides.json",
         "changes/2026-09-16-SITE-04-proxies-guides.md",
-        "baselines/site04-proxies-guides.json"
+        "baselines/site04-proxies-guides.json",
+        "changes/2026-09-16-SITE-04-existing-guides.md",
+        "baselines/site04-existing-guides.json"
       ]
     },
     {