docs(site): [SITE-04] complete bilingual guides for JASSUB Mask and Cast

This commit is contained in:
Harvey Zhao committed 2026-09-16 03:37:35 +08:00
1 parent 558e946ae5
commit 3aad294aa5
106 files changed
+5268 -2065

No files matched your search

+48
View File
@@ -211,6 +211,54 @@
"owner": "SITE-VTT-01",
"finalDemoOwner": "EX-03",
"note": "Generated guide. Guide-specific browser evidence belongs to the owner; this entry does not complete full demo/release acceptance."
},
{
"source": "docs/document/plugin/jassub.html",
"route": "/document/plugin/jassub.html",
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
"owner": "SITE-04",
"finalDemoOwner": "EX-03",
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
},
{
"source": "docs/document/en/plugin/jassub.html",
"route": "/document/en/plugin/jassub.html",
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
"owner": "SITE-04",
"finalDemoOwner": "EX-03",
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
},
{
"source": "docs/document/plugin/danmuku-mask.html",
"route": "/document/plugin/danmuku-mask.html",
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
"owner": "SITE-04",
"finalDemoOwner": "EX-03",
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
},
{
"source": "docs/document/en/plugin/danmuku-mask.html",
"route": "/document/en/plugin/danmuku-mask.html",
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
"owner": "SITE-04",
"finalDemoOwner": "EX-03",
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
},
{
"source": "docs/document/plugin/chromecast.html",
"route": "/document/plugin/chromecast.html",
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
"owner": "SITE-04",
"finalDemoOwner": "EX-03",
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
},
{
"source": "docs/document/en/plugin/chromecast.html",
"route": "/document/en/plugin/chromecast.html",
"introducedAfter": "558e946ae538b6e0aac9754aed875ba521d6ca9d",
"owner": "SITE-04",
"finalDemoOwner": "EX-03",
"note": "Bilingual guide with original runnable example; navigation validation is not SDK, rendering or physical-device acceptance."
}
]
}
File diff suppressed because it is too large. Load diff
File diff suppressed because it is too large. Load diff
@@ -0,0 +1,57 @@
# SITE-04 checkpoint: JASSUB, Danmuku Mask and Chromecast guides
Six bilingual pages replace external-only or missing sidebar entries. All 16
plugins now have dedicated guides in both languages. Original demo JavaScript is
copied unchanged into visible Run Code blocks; Mask forwards both required plugin
libraries. New routes record pre-change HEAD
558e946ae538b6e0aac9754aed875ba521d6ca9d. This documents the unreleased branch,
not the capabilities of a package currently fetched from the registry.
JASSUB covers resource/rendering options, instance methods and fields, ASS data,
callback queries, actual resize argument order and return values, ownership and
the preserved root versus accurate runtime declarations. Mask covers all ten
options, fixed SDK/model selection, initialization and cancellation, previous-mask
retention, cleanup and NodeNext type-only extraction without inventing a runtime
default alias. Chromecast covers SDK loading, live options/callbacks, media MIME
and URL behavior, raw/normalized state, shared sessions and async runtime types.
Session presence is not described as receiver playback. The detailed source and
member mapping is in [the tracker](../site-content-review.md).
## Verification
- Node24.21.0, Yarn1.22.22 and TypeScript5.9.3. Six exact TS snippets pass strict
NodeNext with skipLibCheck:false and types:[], including JASSUB runtime and Mask
type extraction. All six runnable examples equal their original demo files.
- Each JASSUB/Mask page validates37 distinct local file/fragment targets; each
Chromecast page validates38. Original/additional demo route checks pass.
- Desktop Chromium153.0.8010.12, Firefox155.0 and Windows WebKit26.6 validate all
18 final guide cases without retries or page errors: HTTP load, sidebar, visible
Run Code, exact code/libs forwarding and language switch. Popup responses are
isolated; this does not execute the editor, SDK, segmentation or media playback.
- The initial run also passed18 cases. Its Mask screenshot exposed an excessively
wide options table. Move the CDN link into prose and combine type/default
columns. A separate final run retains new screenshots and verifies no horizontal
table scrolling is required at the tested1100px viewport. Initial evidence is
preserved; no mobile responsiveness or physical-device acceptance is inferred.
- Existing site-loading/documentation-pipeline tests:17 pass,0 failures/skips,
1204.8237ms. Config lint, build:llm/check:llm, build:docs and inventory checks
pass. Final VitePress build8.46s; Yarn10.12s. No new dependency or project script.
- Current inventory:58 Markdown (29 per language),67 HTML,30 examples,963 core
members and204 assets. Enumeration is not complete semantic coverage.
- All21 library build envelopes remain accepted. Library source, declarations,
distribution and dependency inputs were not changed; release blockers remain.
See [the evidence record](../baselines/site04-jassub-mask-cast-guides.json).
Generated HTML, browser assets and LLM outputs came from repository commands.
SITE-04 remains doing; totals remain224 done/22 doing/39 todo. Two proxy and two
tool guides, current earlier-guide checks and core semantic mapping remain.
SITE-05/EX-03, SDK/media/device gaps and user-directed formal reviews are separate.
No push, remote dispatch, deployment or publication occurred. Revert this
checkpoint to restore previous guides, navigation and generated outputs without
changing runtime APIs, root declarations or approved compatibility decisions.
Full staged whitespace checking exits2 on12 whitespace-only template lines in
the six new generated HTML files. Exact paths, lines and blank content were
inspected; excluding only these files passes. Generated HTML is preserved,
and the full check is not reported as passing. See the evidence record.
+1 -1
View File
@@ -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)
- 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)
- 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)
+12
View File
@@ -1,5 +1,17 @@
# 进度与证据
## SITE-04 JASSUB/弹幕遮罩/Chromecast双语指南
补齐六份页面、本地导航和原样示例,16个插件现均有独立双语指南。说明JASSUB实际
方法/查询/资源、遮罩start与首帧/SDK配置边界、Cast会话与接收端播放区别。
六份TS片段、37/38个页面链接、三浏览器18组最终导航及17项工具测试通过。
截图发现遮罩表格过宽后调整列和CDN链接,保留初轮证据并重新验证最终页面宽度。
当前58 Markdown/67 HTML,21库build仍有效。见
[记录](changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md)和
[证据](baselines/site04-jassub-mask-cast-guides.json)。SITE-04保持doing,224/22/39
不变;继续proxy/tool、已有指南和核心语义对应,不将导航计为SDK/媒体/设备通过,
不启动用户保留的正式复盘。
## SITE-04 Ads/VAST双语指南
补齐四份页面、本地导航和原样示例。Ads说明计时/媒体控制、skip与按钮限制、
+9 -1
View File
@@ -32,13 +32,21 @@ Ads 和 VAST 的本次核对:
| Ads | [入口](../packages/artplayer-plugin-ads/src/index.ts)、options.ts、countdown.ts、view.ts、session.ts、根/runtime声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/plugin/ads.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/ads.md):七个配置及四项i18n、name/play/pause/skip、click/skip事件、十个公开类型 | video优先、可信HTML、浅合并、计时非视频时长、按钮限制不拦截直接skip、ready/首播/早调用/销毁、事件活配置、totalDuration推导修正和忽略source/type |
| VAST | [入口](../packages/artplayer-plugin-vast/src/index.ts)、sdk.ts、session.ts、view.ts、根/runtime声明、README/ARCHITECTURE与两项已批准决策 | [中文](../packages/artplayer-vitepress/docs/plugin/vast.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/vast.md):回调/第二参数、全部context字段、init/playUrl/playRes、name/destroy、runtime命名类型及工作区别名 | npm默认回调前创建/数据快照,显式workspace惰性/getter/请求抑制/事件;config可覆盖主字段;注册等待回调非广告完成;session可重建/core终止;旧根类型与准确runtime分离,外部IMA仍单独验收 |
JASSUB、弹幕遮罩和 Chromecast 的本次核对:
| 包 | 对照源码与声明 | 双语指南覆盖 | 保留边界 |
| --- | --- | --- | --- |
| JASSUB | [入口](../packages/artplayer-plugin-jassub/src/index.ts)、registration.ts、vendor实现、根/runtime声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/plugin/jassub.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/jassub.md):全部RuntimeOption;实例方法与字段;AssEvent/AssStyle;13个runtime命名类型 | 同步注册非Worker ready;实际resize参数/void返回与旧声明分开;query回调/target关联/毫秒单位;资源部署、caller节点归属、晚到位图与销毁;离屏停顿和字体/真机缺口保留 |
| Danmuku Mask | [入口](../packages/artplayer-plugin-danmuku-mask/src/index.ts)、config.ts、controller.ts、output.ts、sdk.ts、根/legacy声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/plugin/danmuku-mask.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/danmuku-mask.md):十项配置、name/start/stop、NodeNext类型提取、双插件示例 | truthy默认值、固定MediaPipe/general与忽略字段、start不保证首mask、stop等待关系、无人物保留mask、model失败与其他拒绝区别;无runtime/新事件;SDK私有GPU完成未证明 |
| Chromecast | [入口](../packages/artplayer-plugin-chromecast/src/index.ts)、controller.ts、media.ts、sdk.ts、根/runtime声明、README/ARCHITECTURE | [中文](../packages/artplayer-vitepress/docs/plugin/chromecast.md) / [English](../packages/artplayer-vitepress/docs/en/plugin/chromecast.md):四项设置/四回调、name/getCastState/isCasting、八个命名类型与旧根兼容 | options必填/活读取、首次点击加载、共享SDK/首URL、30秒ready期限、原始与标准状态、请求取消、绝对媒体URL/MIME、销毁不结束共享会话;有会话不等于接收端播放,真机仍独立验收 |
## 接续范围
- 核心:依据 site-inventory.json 的 963 条成员逐项或按明确的共享声明分组核对;
必须记录对应文档及语义结论,不能仅按同名标题匹配标为通过。
- 已有 Danmuku、HLS、DASH、Audio、VTT 双语指南:继承各 SITE-* 任务的证据,但
仍需在本轮全包核对中检查其当前声明、示例和能力边界。
- 其余插件、两个 proxy、两个 tool:包内 README/ARCHITECTURE 不能替代缺失的
- 16个插件现均有独立双语指南;两个 proxy、两个 tool:包内 README/ARCHITECTURE 不能替代缺失的
双语使用说明。按实际能力分组补入口,不机械复制维护文档。
- SITE-05 和 EX-03 负责后续完整页面与实际 demo 验收;静态内容核对不等待真机,
也不能据此关闭真机、外部 SDK、发布或复盘门槛。
+3 -1
View File
@@ -4564,7 +4564,9 @@
"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"
"baselines/site04-ads-vast-guides.json",
"changes/2026-09-16-SITE-04-jassub-mask-cast-guides.md",
"baselines/site04-jassub-mask-cast-guides.json"
]
},
{