docs(core): [SITE-04] document subtitle loading and resource ownership

refactor/baselines/site04-subtitle.json

@@ -0,0 +1,955 @@
+{
+  "task": "SITE-04",
+  "taskStatus": "doing",
+  "sourceBefore": "de45f5b978a69aaae3b466325ac4dce35bd0dee2",
+  "capturedAt": "2026-09-15T23:17:13.871Z",
+  "validation": {
+    "task": "SITE-04",
+    "node": "v24.21.0",
+    "compiler": "5.9.3",
+    "static": [
+      {
+        "language": "zh",
+        "name": "built-in",
+        "source": {
+          "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6"
+        },
+        "html": {
+          "path": "docs/document/advanced/built-in.html",
+          "sha256": "25794ecbe79571154672a3360d9dfb2c1fa48786b7537eb1cde78ebe3ea1ec41"
+        },
+        "typeFixtures": [
+          {
+            "path": "refactor/.cache/site04-subtitle/zh-built-in-0.mts",
+            "sha256": "e613264ed42611dcaf9d113b6657369fee86259fa4f93dd886e44d31daada1e0"
+          },
+          {
+            "path": "refactor/.cache/site04-subtitle/zh-built-in-1.mts",
+            "sha256": "e2813bfdb0e54859385e00b5b4cbe0a3f6670fdc2dee15c93d8993b64dfc78a6"
+          },
+          {
+            "path": "refactor/.cache/site04-subtitle/zh-built-in-2.mts",
+            "sha256": "8845a21ecf86b0b0b08a0b0de4d2488fbde834fe795eedb7cd125e66f6a46eae"
+          }
+        ],
+        "snippets": [
+          {
+            "id": "advanced/built-in.md:12",
+            "sha256": "087735467fd821c2f6b73050a9bf932f1cefa183e017391ad6e963e9e988b8d6"
+          },
+          {
+            "id": "advanced/built-in.md:33",
+            "sha256": "debeb79b856f191cba1b357ba3462342b1de2c93074d1bb5c161becc60506937"
+          },
+          {
+            "id": "advanced/built-in.md:95",
+            "sha256": "8dcf8fe91915f7bad2fb1f47e49294cc703cfbe80b21b7155e1d7ebacef017b2"
+          },
+          {
+            "id": "advanced/built-in.md:138",
+            "sha256": "aed4de9f5ce94737018c9e169d9319e44da9468bf244a25dd484b64b71d6a905"
+          },
+          {
+            "id": "advanced/built-in.md:161",
+            "sha256": "78a8622566fb190dad9687fcd3366aeca1ce2c440f98db1b8a63d936dd44601a"
+          },
+          {
+            "id": "advanced/built-in.md:181",
+            "sha256": "ecafa8f0bcab78ca1eceef2223e0d9e7adb3c2ca546cdf6733534f9d0a344bf4"
+          },
+          {
+            "id": "advanced/built-in.md:217",
+            "sha256": "9a1dabfbd2b43b4d7cc76c259c0e6da4fec0af51ffa87607ff2cf274e37ffebc"
+          },
+          {
+            "id": "advanced/built-in.md:292",
+            "sha256": "5622bd1dd05bd1b95b3dd4db0a0dd28387cba88bc1f6ad5da3a7451abdd9ec55"
+          },
+          {
+            "id": "advanced/built-in.md:325",
+            "sha256": "2429bccae4d847890c92fbad4ed2df3ffa6ba3172b7babe7e5081869542daece"
+          },
+          {
+            "id": "advanced/built-in.md:360",
+            "sha256": "97425833bd778311e3765b0f8c268cc15f38ab83e39727dbb35210060d332d17"
+          },
+          {
+            "id": "advanced/built-in.md:396",
+            "sha256": "3355c478c71f59548fd2be177f607fbcfb359b007067fcd9dc9524bb4cfc591f"
+          },
+          {
+            "id": "advanced/built-in.md:478",
+            "sha256": "c478d5976a42b468d48f6aa5594313b60d49a9daf007839c6ee2cd0881daeb63"
+          },
+          {
+            "id": "advanced/built-in.md:501",
+            "sha256": "2c8bd606ef43ceedd726f81b29260866558b12aedd7798e9955ba5c4ebb72b37"
+          },
+          {
+            "id": "advanced/built-in.md:525",
+            "sha256": "564713373d9c96b69e3c9f7ea82686ddb7b2ba8156ea6db8621c8e59d63c6ce6"
+          },
+          {
+            "id": "advanced/built-in.md:548",
+            "sha256": "48afe798b0202fd30467e8d148d082e7deb986db08da0c28ceffe1c440bd2d1c"
+          },
+          {
+            "id": "advanced/built-in.md:587",
+            "sha256": "c893a368edcb1a8320ff7ce682723294e900298f91022da0e49ee0ee9d41f449"
+          },
+          {
+            "id": "advanced/built-in.md:613",
+            "sha256": "b0e79e18d105f505cdc4a9cec236b96b39a916c4f2086e4c2e13b0d74e92c627"
+          },
+          {
+            "id": "advanced/built-in.md:644",
+            "sha256": "7ba346613aa1e0600f67a618b385c1b7b5bf06b136a67408c5d959490bf8f9dd"
+          }
+        ],
+        "localLinks": [
+          "/document/advanced/built-in.html#VPContent",
+          "/document/",
+          "/document/en/",
+          "/document/start/option.html",
+          "/document/start/i18n.html",
+          "/document/component/layers.html",
+          "/document/component/controls.html",
+          "/document/component/contextmenu.html",
+          "/document/component/setting.html",
+          "/document/advanced/property.html",
+          "/document/advanced/built-in.html",
+          "/document/advanced/class.html",
+          "/document/advanced/global.html",
+          "/document/advanced/event.html",
+          "/document/advanced/plugin.html",
+          "/document/plugin/danmuku.html",
+          "/document/plugin/danmuku-mask.html",
+          "/document/plugin/ads.html",
+          "/document/plugin/hls-control.html",
+          "/document/plugin/dash-control.html",
+          "/document/plugin/vtt-thumbnail.html",
+          "/document/plugin/auto-thumbnail.html",
+          "/document/plugin/multiple-subtitles.html",
+          "/document/plugin/jassub.html",
+          "/document/plugin/chromecast.html",
+          "/document/plugin/vast.html",
+          "/document/plugin/chapter.html",
+          "/document/plugin/ambilight.html",
+          "/document/plugin/document-pip.html",
+          "/document/plugin/asr.html",
+          "/document/plugin/audio-track.html",
+          "/document/tool/iframe.html",
+          "/document/tool/thumbnail.html",
+          "/document/proxy/canvas.html",
+          "/document/proxy/mediabunny.html",
+          "/document/advanced/built-in.html#%E9%AB%98%E7%BA%A7%E5%B1%9E%E6%80%A7",
+          "/document/advanced/built-in.html#option",
+          "/document/advanced/built-in.html#template",
+          "/document/advanced/built-in.html#events",
+          "/document/advanced/built-in.html#storage",
+          "/document/advanced/built-in.html#icons",
+          "/document/advanced/built-in.html#i18n",
+          "/document/advanced/built-in.html#notice",
+          "/document/advanced/built-in.html#layers",
+          "/document/advanced/built-in.html#controls",
+          "/document/advanced/built-in.html#contextmenu",
+          "/document/advanced/built-in.html#subtitle",
+          "/document/advanced/built-in.html#subtitle-contract",
+          "/document/advanced/built-in.html#subtitle-runtime",
+          "/document/advanced/built-in.html#info",
+          "/document/advanced/built-in.html#loading",
+          "/document/advanced/built-in.html#hotkey",
+          "/document/advanced/built-in.html#mask",
+          "/document/advanced/built-in.html#setting",
+          "/document/advanced/built-in.html#plugins",
+          "/document/advanced/built-in.html#%E6%9C%8D%E5%8A%A1%E7%9A%84-typescript-%E8%A7%86%E5%9B%BE",
+          "/document/advanced/built-in.html#%E6%A8%A1%E6%9D%BF%E4%B8%8E%E5%9B%BE%E6%A0%87%E7%9A%84-typescript-%E8%A7%86%E5%9B%BE"
+        ]
+      },
+      {
+        "language": "en",
+        "name": "built-in",
+        "source": {
+          "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a"
+        },
+        "html": {
+          "path": "docs/document/en/advanced/built-in.html",
+          "sha256": "c0d0bc59222d022e99ee2ed5e9281fd8f2fd3b227a554669bbd45a169396ff0d"
+        },
+        "typeFixtures": [
+          {
+            "path": "refactor/.cache/site04-subtitle/en-built-in-0.mts",
+            "sha256": "e613264ed42611dcaf9d113b6657369fee86259fa4f93dd886e44d31daada1e0"
+          },
+          {
+            "path": "refactor/.cache/site04-subtitle/en-built-in-1.mts",
+            "sha256": "e2813bfdb0e54859385e00b5b4cbe0a3f6670fdc2dee15c93d8993b64dfc78a6"
+          },
+          {
+            "path": "refactor/.cache/site04-subtitle/en-built-in-2.mts",
+            "sha256": "8845a21ecf86b0b0b08a0b0de4d2488fbde834fe795eedb7cd125e66f6a46eae"
+          }
+        ],
+        "snippets": [
+          {
+            "id": "en/advanced/built-in.md:12",
+            "sha256": "087735467fd821c2f6b73050a9bf932f1cefa183e017391ad6e963e9e988b8d6"
+          },
+          {
+            "id": "en/advanced/built-in.md:33",
+            "sha256": "debeb79b856f191cba1b357ba3462342b1de2c93074d1bb5c161becc60506937"
+          },
+          {
+            "id": "en/advanced/built-in.md:95",
+            "sha256": "8dcf8fe91915f7bad2fb1f47e49294cc703cfbe80b21b7155e1d7ebacef017b2"
+          },
+          {
+            "id": "en/advanced/built-in.md:138",
+            "sha256": "aed4de9f5ce94737018c9e169d9319e44da9468bf244a25dd484b64b71d6a905"
+          },
+          {
+            "id": "en/advanced/built-in.md:161",
+            "sha256": "78a8622566fb190dad9687fcd3366aeca1ce2c440f98db1b8a63d936dd44601a"
+          },
+          {
+            "id": "en/advanced/built-in.md:181",
+            "sha256": "ecafa8f0bcab78ca1eceef2223e0d9e7adb3c2ca546cdf6733534f9d0a344bf4"
+          },
+          {
+            "id": "en/advanced/built-in.md:217",
+            "sha256": "9a1dabfbd2b43b4d7cc76c259c0e6da4fec0af51ffa87607ff2cf274e37ffebc"
+          },
+          {
+            "id": "en/advanced/built-in.md:292",
+            "sha256": "5622bd1dd05bd1b95b3dd4db0a0dd28387cba88bc1f6ad5da3a7451abdd9ec55"
+          },
+          {
+            "id": "en/advanced/built-in.md:325",
+            "sha256": "2429bccae4d847890c92fbad4ed2df3ffa6ba3172b7babe7e5081869542daece"
+          },
+          {
+            "id": "en/advanced/built-in.md:361",
+            "sha256": "97425833bd778311e3765b0f8c268cc15f38ab83e39727dbb35210060d332d17"
+          },
+          {
+            "id": "en/advanced/built-in.md:397",
+            "sha256": "3355c478c71f59548fd2be177f607fbcfb359b007067fcd9dc9524bb4cfc591f"
+          },
+          {
+            "id": "en/advanced/built-in.md:479",
+            "sha256": "c478d5976a42b468d48f6aa5594313b60d49a9daf007839c6ee2cd0881daeb63"
+          },
+          {
+            "id": "en/advanced/built-in.md:502",
+            "sha256": "2c8bd606ef43ceedd726f81b29260866558b12aedd7798e9955ba5c4ebb72b37"
+          },
+          {
+            "id": "en/advanced/built-in.md:526",
+            "sha256": "564713373d9c96b69e3c9f7ea82686ddb7b2ba8156ea6db8621c8e59d63c6ce6"
+          },
+          {
+            "id": "en/advanced/built-in.md:549",
+            "sha256": "48afe798b0202fd30467e8d148d082e7deb986db08da0c28ceffe1c440bd2d1c"
+          },
+          {
+            "id": "en/advanced/built-in.md:588",
+            "sha256": "c893a368edcb1a8320ff7ce682723294e900298f91022da0e49ee0ee9d41f449"
+          },
+          {
+            "id": "en/advanced/built-in.md:614",
+            "sha256": "b0e79e18d105f505cdc4a9cec236b96b39a916c4f2086e4c2e13b0d74e92c627"
+          },
+          {
+            "id": "en/advanced/built-in.md:645",
+            "sha256": "7ba346613aa1e0600f67a618b385c1b7b5bf06b136a67408c5d959490bf8f9dd"
+          }
+        ],
+        "localLinks": [
+          "/document/en/advanced/built-in.html#VPContent",
+          "/document/",
+          "/document/en/",
+          "/document/en/start/option.html",
+          "/document/en/start/i18n.html",
+          "/document/en/component/layers.html",
+          "/document/en/component/controls.html",
+          "/document/en/component/contextmenu.html",
+          "/document/en/component/setting.html",
+          "/document/en/advanced/property.html",
+          "/document/en/advanced/built-in.html",
+          "/document/en/advanced/class.html",
+          "/document/en/advanced/global.html",
+          "/document/en/advanced/event.html",
+          "/document/en/advanced/plugin.html",
+          "/document/en/plugin/danmuku.html",
+          "/document/en/plugin/danmuku-mask.html",
+          "/document/en/plugin/ads.html",
+          "/document/en/plugin/hls-control.html",
+          "/document/en/plugin/dash-control.html",
+          "/document/en/plugin/vtt-thumbnail.html",
+          "/document/en/plugin/auto-thumbnail.html",
+          "/document/en/plugin/multiple-subtitles.html",
+          "/document/en/plugin/jassub.html",
+          "/document/en/plugin/chromecast.html",
+          "/document/en/plugin/vast.html",
+          "/document/en/plugin/chapter.html",
+          "/document/en/plugin/ambilight.html",
+          "/document/en/plugin/document-pip.html",
+          "/document/en/plugin/asr.html",
+          "/document/en/plugin/audio-track.html",
+          "/document/en/tool/iframe.html",
+          "/document/en/tool/thumbnail.html",
+          "/document/en/proxy/canvas.html",
+          "/document/en/proxy/mediabunny.html",
+          "/document/en/advanced/built-in.html#advanced-properties",
+          "/document/en/advanced/built-in.html#option",
+          "/document/en/advanced/built-in.html#template",
+          "/document/en/advanced/built-in.html#events",
+          "/document/en/advanced/built-in.html#storage",
+          "/document/en/advanced/built-in.html#icons",
+          "/document/en/advanced/built-in.html#i18n",
+          "/document/en/advanced/built-in.html#notice",
+          "/document/en/advanced/built-in.html#layers",
+          "/document/component/layers.html",
+          "/document/en/advanced/built-in.html#controls",
+          "/document/component/controls.html",
+          "/document/en/advanced/built-in.html#contextmenu",
+          "/document/component/contextmenu.html",
+          "/document/en/advanced/built-in.html#subtitle",
+          "/document/en/advanced/built-in.html#subtitle-contract",
+          "/document/en/advanced/built-in.html#subtitle-runtime",
+          "/document/en/advanced/built-in.html#info",
+          "/document/en/advanced/built-in.html#loading",
+          "/document/en/advanced/built-in.html#hotkey",
+          "/document/en/advanced/built-in.html#mask",
+          "/document/en/advanced/built-in.html#setting",
+          "/document/component/setting.html",
+          "/document/en/advanced/built-in.html#plugins",
+          "/document/en/advanced/built-in.html#typescript-service-views",
+          "/document/en/advanced/built-in.html#typescript-template-and-icon-views"
+        ]
+      }
+    ],
+    "browsers": [
+      {
+        "engine": "chromium",
+        "version": "153.0.8010.12",
+        "language": "zh",
+        "name": "built-in",
+        "passed": true,
+        "errors": [],
+        "forwarded": [
+          "087735467fd821c2f6b73050a9bf932f1cefa183e017391ad6e963e9e988b8d6",
+          "debeb79b856f191cba1b357ba3462342b1de2c93074d1bb5c161becc60506937",
+          "8dcf8fe91915f7bad2fb1f47e49294cc703cfbe80b21b7155e1d7ebacef017b2",
+          "aed4de9f5ce94737018c9e169d9319e44da9468bf244a25dd484b64b71d6a905",
+          "78a8622566fb190dad9687fcd3366aeca1ce2c440f98db1b8a63d936dd44601a",
+          "ecafa8f0bcab78ca1eceef2223e0d9e7adb3c2ca546cdf6733534f9d0a344bf4",
+          "9a1dabfbd2b43b4d7cc76c259c0e6da4fec0af51ffa87607ff2cf274e37ffebc",
+          "5622bd1dd05bd1b95b3dd4db0a0dd28387cba88bc1f6ad5da3a7451abdd9ec55",
+          "2429bccae4d847890c92fbad4ed2df3ffa6ba3172b7babe7e5081869542daece",
+          "97425833bd778311e3765b0f8c268cc15f38ab83e39727dbb35210060d332d17",
+          "3355c478c71f59548fd2be177f607fbcfb359b007067fcd9dc9524bb4cfc591f",
+          "c478d5976a42b468d48f6aa5594313b60d49a9daf007839c6ee2cd0881daeb63",
+          "2c8bd606ef43ceedd726f81b29260866558b12aedd7798e9955ba5c4ebb72b37",
+          "564713373d9c96b69e3c9f7ea82686ddb7b2ba8156ea6db8621c8e59d63c6ce6",
+          "48afe798b0202fd30467e8d148d082e7deb986db08da0c28ceffe1c440bd2d1c",
+          "c893a368edcb1a8320ff7ce682723294e900298f91022da0e49ee0ee9d41f449",
+          "b0e79e18d105f505cdc4a9cec236b96b39a916c4f2086e4c2e13b0d74e92c627",
+          "7ba346613aa1e0600f67a618b385c1b7b5bf06b136a67408c5d959490bf8f9dd"
+        ],
+        "screenshot": {
+          "path": "refactor/.cache/site04-subtitle/chromium-zh-built-in.png",
+          "sha256": "9fa2783136271bfe68c1307b5c616b21ef7c8ef23dd45832d88e42affbc7485a"
+        }
+      },
+      {
+        "engine": "chromium",
+        "version": "153.0.8010.12",
+        "language": "en",
+        "name": "built-in",
+        "passed": true,
+        "errors": [],
+        "forwarded": [
+          "087735467fd821c2f6b73050a9bf932f1cefa183e017391ad6e963e9e988b8d6",
+          "debeb79b856f191cba1b357ba3462342b1de2c93074d1bb5c161becc60506937",
+          "8dcf8fe91915f7bad2fb1f47e49294cc703cfbe80b21b7155e1d7ebacef017b2",
+          "aed4de9f5ce94737018c9e169d9319e44da9468bf244a25dd484b64b71d6a905",
+          "78a8622566fb190dad9687fcd3366aeca1ce2c440f98db1b8a63d936dd44601a",
+          "ecafa8f0bcab78ca1eceef2223e0d9e7adb3c2ca546cdf6733534f9d0a344bf4",
+          "9a1dabfbd2b43b4d7cc76c259c0e6da4fec0af51ffa87607ff2cf274e37ffebc",
+          "5622bd1dd05bd1b95b3dd4db0a0dd28387cba88bc1f6ad5da3a7451abdd9ec55",
+          "2429bccae4d847890c92fbad4ed2df3ffa6ba3172b7babe7e5081869542daece",
+          "97425833bd778311e3765b0f8c268cc15f38ab83e39727dbb35210060d332d17",
+          "3355c478c71f59548fd2be177f607fbcfb359b007067fcd9dc9524bb4cfc591f",
+          "c478d5976a42b468d48f6aa5594313b60d49a9daf007839c6ee2cd0881daeb63",
+          "2c8bd606ef43ceedd726f81b29260866558b12aedd7798e9955ba5c4ebb72b37",
+          "564713373d9c96b69e3c9f7ea82686ddb7b2ba8156ea6db8621c8e59d63c6ce6",
+          "48afe798b0202fd30467e8d148d082e7deb986db08da0c28ceffe1c440bd2d1c",
+          "c893a368edcb1a8320ff7ce682723294e900298f91022da0e49ee0ee9d41f449",
+          "b0e79e18d105f505cdc4a9cec236b96b39a916c4f2086e4c2e13b0d74e92c627",
+          "7ba346613aa1e0600f67a618b385c1b7b5bf06b136a67408c5d959490bf8f9dd"
+        ],
+        "screenshot": {
+          "path": "refactor/.cache/site04-subtitle/chromium-en-built-in.png",
+          "sha256": "367366053e2bdb1964991ac1f26d61dbfe60ea3448e5c47b5ffbae45d5f7e4dd"
+        }
+      },
+      {
+        "engine": "firefox",
+        "version": "155.0",
+        "language": "zh",
+        "name": "built-in",
+        "passed": true,
+        "errors": [],
+        "forwarded": [
+          "087735467fd821c2f6b73050a9bf932f1cefa183e017391ad6e963e9e988b8d6",
+          "debeb79b856f191cba1b357ba3462342b1de2c93074d1bb5c161becc60506937",
+          "8dcf8fe91915f7bad2fb1f47e49294cc703cfbe80b21b7155e1d7ebacef017b2",
+          "aed4de9f5ce94737018c9e169d9319e44da9468bf244a25dd484b64b71d6a905",
+          "78a8622566fb190dad9687fcd3366aeca1ce2c440f98db1b8a63d936dd44601a",
+          "ecafa8f0bcab78ca1eceef2223e0d9e7adb3c2ca546cdf6733534f9d0a344bf4",
+          "9a1dabfbd2b43b4d7cc76c259c0e6da4fec0af51ffa87607ff2cf274e37ffebc",
+          "5622bd1dd05bd1b95b3dd4db0a0dd28387cba88bc1f6ad5da3a7451abdd9ec55",
+          "2429bccae4d847890c92fbad4ed2df3ffa6ba3172b7babe7e5081869542daece",
+          "97425833bd778311e3765b0f8c268cc15f38ab83e39727dbb35210060d332d17",
+          "3355c478c71f59548fd2be177f607fbcfb359b007067fcd9dc9524bb4cfc591f",
+          "c478d5976a42b468d48f6aa5594313b60d49a9daf007839c6ee2cd0881daeb63",
+          "2c8bd606ef43ceedd726f81b29260866558b12aedd7798e9955ba5c4ebb72b37",
+          "564713373d9c96b69e3c9f7ea82686ddb7b2ba8156ea6db8621c8e59d63c6ce6",
+          "48afe798b0202fd30467e8d148d082e7deb986db08da0c28ceffe1c440bd2d1c",
+          "c893a368edcb1a8320ff7ce682723294e900298f91022da0e49ee0ee9d41f449",
+          "b0e79e18d105f505cdc4a9cec236b96b39a916c4f2086e4c2e13b0d74e92c627",
+          "7ba346613aa1e0600f67a618b385c1b7b5bf06b136a67408c5d959490bf8f9dd"
+        ],
+        "screenshot": {
+          "path": "refactor/.cache/site04-subtitle/firefox-zh-built-in.png",
+          "sha256": "08d9818d9d473ad9f8e922dcb488304d35dd976a0d62ae11feba18695a22e853"
+        }
+      },
+      {
+        "engine": "firefox",
+        "version": "155.0",
+        "language": "en",
+        "name": "built-in",
+        "passed": true,
+        "errors": [],
+        "forwarded": [
+          "087735467fd821c2f6b73050a9bf932f1cefa183e017391ad6e963e9e988b8d6",
+          "debeb79b856f191cba1b357ba3462342b1de2c93074d1bb5c161becc60506937",
+          "8dcf8fe91915f7bad2fb1f47e49294cc703cfbe80b21b7155e1d7ebacef017b2",
+          "aed4de9f5ce94737018c9e169d9319e44da9468bf244a25dd484b64b71d6a905",
+          "78a8622566fb190dad9687fcd3366aeca1ce2c440f98db1b8a63d936dd44601a",
+          "ecafa8f0bcab78ca1eceef2223e0d9e7adb3c2ca546cdf6733534f9d0a344bf4",
+          "9a1dabfbd2b43b4d7cc76c259c0e6da4fec0af51ffa87607ff2cf274e37ffebc",
+          "5622bd1dd05bd1b95b3dd4db0a0dd28387cba88bc1f6ad5da3a7451abdd9ec55",
+          "2429bccae4d847890c92fbad4ed2df3ffa6ba3172b7babe7e5081869542daece",
+          "97425833bd778311e3765b0f8c268cc15f38ab83e39727dbb35210060d332d17",
+          "3355c478c71f59548fd2be177f607fbcfb359b007067fcd9dc9524bb4cfc591f",
+          "c478d5976a42b468d48f6aa5594313b60d49a9daf007839c6ee2cd0881daeb63",
+          "2c8bd606ef43ceedd726f81b29260866558b12aedd7798e9955ba5c4ebb72b37",
+          "564713373d9c96b69e3c9f7ea82686ddb7b2ba8156ea6db8621c8e59d63c6ce6",
+          "48afe798b0202fd30467e8d148d082e7deb986db08da0c28ceffe1c440bd2d1c",
+          "c893a368edcb1a8320ff7ce682723294e900298f91022da0e49ee0ee9d41f449",
+          "b0e79e18d105f505cdc4a9cec236b96b39a916c4f2086e4c2e13b0d74e92c627",
+          "7ba346613aa1e0600f67a618b385c1b7b5bf06b136a67408c5d959490bf8f9dd"
+        ],
+        "screenshot": {
+          "path": "refactor/.cache/site04-subtitle/firefox-en-built-in.png",
+          "sha256": "09aaa1c9005f7cd277720504a9ff2ab8ebfb60a6c25f93af6bbd5fe8a6421f87"
+        }
+      },
+      {
+        "engine": "webkit",
+        "version": "26.6",
+        "language": "zh",
+        "name": "built-in",
+        "passed": true,
+        "errors": [],
+        "forwarded": [
+          "087735467fd821c2f6b73050a9bf932f1cefa183e017391ad6e963e9e988b8d6",
+          "debeb79b856f191cba1b357ba3462342b1de2c93074d1bb5c161becc60506937",
+          "8dcf8fe91915f7bad2fb1f47e49294cc703cfbe80b21b7155e1d7ebacef017b2",
+          "aed4de9f5ce94737018c9e169d9319e44da9468bf244a25dd484b64b71d6a905",
+          "78a8622566fb190dad9687fcd3366aeca1ce2c440f98db1b8a63d936dd44601a",
+          "ecafa8f0bcab78ca1eceef2223e0d9e7adb3c2ca546cdf6733534f9d0a344bf4",
+          "9a1dabfbd2b43b4d7cc76c259c0e6da4fec0af51ffa87607ff2cf274e37ffebc",
+          "5622bd1dd05bd1b95b3dd4db0a0dd28387cba88bc1f6ad5da3a7451abdd9ec55",
+          "2429bccae4d847890c92fbad4ed2df3ffa6ba3172b7babe7e5081869542daece",
+          "97425833bd778311e3765b0f8c268cc15f38ab83e39727dbb35210060d332d17",
+          "3355c478c71f59548fd2be177f607fbcfb359b007067fcd9dc9524bb4cfc591f",
+          "c478d5976a42b468d48f6aa5594313b60d49a9daf007839c6ee2cd0881daeb63",
+          "2c8bd606ef43ceedd726f81b29260866558b12aedd7798e9955ba5c4ebb72b37",
+          "564713373d9c96b69e3c9f7ea82686ddb7b2ba8156ea6db8621c8e59d63c6ce6",
+          "48afe798b0202fd30467e8d148d082e7deb986db08da0c28ceffe1c440bd2d1c",
+          "c893a368edcb1a8320ff7ce682723294e900298f91022da0e49ee0ee9d41f449",
+          "b0e79e18d105f505cdc4a9cec236b96b39a916c4f2086e4c2e13b0d74e92c627",
+          "7ba346613aa1e0600f67a618b385c1b7b5bf06b136a67408c5d959490bf8f9dd"
+        ],
+        "screenshot": {
+          "path": "refactor/.cache/site04-subtitle/webkit-zh-built-in.png",
+          "sha256": "0e39c014df842039efa94a364c2037a86bdceb10d1279d38978c830aa679d7b8"
+        }
+      },
+      {
+        "engine": "webkit",
+        "version": "26.6",
+        "language": "en",
+        "name": "built-in",
+        "passed": true,
+        "errors": [],
+        "forwarded": [
+          "087735467fd821c2f6b73050a9bf932f1cefa183e017391ad6e963e9e988b8d6",
+          "debeb79b856f191cba1b357ba3462342b1de2c93074d1bb5c161becc60506937",
+          "8dcf8fe91915f7bad2fb1f47e49294cc703cfbe80b21b7155e1d7ebacef017b2",
+          "aed4de9f5ce94737018c9e169d9319e44da9468bf244a25dd484b64b71d6a905",
+          "78a8622566fb190dad9687fcd3366aeca1ce2c440f98db1b8a63d936dd44601a",
+          "ecafa8f0bcab78ca1eceef2223e0d9e7adb3c2ca546cdf6733534f9d0a344bf4",
+          "9a1dabfbd2b43b4d7cc76c259c0e6da4fec0af51ffa87607ff2cf274e37ffebc",
+          "5622bd1dd05bd1b95b3dd4db0a0dd28387cba88bc1f6ad5da3a7451abdd9ec55",
+          "2429bccae4d847890c92fbad4ed2df3ffa6ba3172b7babe7e5081869542daece",
+          "97425833bd778311e3765b0f8c268cc15f38ab83e39727dbb35210060d332d17",
+          "3355c478c71f59548fd2be177f607fbcfb359b007067fcd9dc9524bb4cfc591f",
+          "c478d5976a42b468d48f6aa5594313b60d49a9daf007839c6ee2cd0881daeb63",
+          "2c8bd606ef43ceedd726f81b29260866558b12aedd7798e9955ba5c4ebb72b37",
+          "564713373d9c96b69e3c9f7ea82686ddb7b2ba8156ea6db8621c8e59d63c6ce6",
+          "48afe798b0202fd30467e8d148d082e7deb986db08da0c28ceffe1c440bd2d1c",
+          "c893a368edcb1a8320ff7ce682723294e900298f91022da0e49ee0ee9d41f449",
+          "b0e79e18d105f505cdc4a9cec236b96b39a916c4f2086e4c2e13b0d74e92c627",
+          "7ba346613aa1e0600f67a618b385c1b7b5bf06b136a67408c5d959490bf8f9dd"
+        ],
+        "screenshot": {
+          "path": "refactor/.cache/site04-subtitle/webkit-en-built-in.png",
+          "sha256": "293b36489a25d198026e90e6058780ec12a08c1cd3c18763465e98391b62b06a"
+        }
+      }
+    ],
+    "dom": [
+      {
+        "engine": "chromium",
+        "version": "153.0.8010.12",
+        "passed": true,
+        "errors": [],
+        "checks": [
+          "initial manager/track shape",
+          "style overloads return container",
+          "switch returns blob before caller waits for native load",
+          "SRT conversion and callback receiver",
+          "native load arguments and cue identity",
+          "switch does not change base settings or track label",
+          "style shallow options leave existing CSS",
+          "arrays are snapshots with shared cue identity",
+          "active cue and ordered render events",
+          "switch-only escape override does not affect rendering",
+          "base escape false enables trusted HTML",
+          "show toggle class and events",
+          "empty switch does not remove current track",
+          "next switch uses base rather than previous switch options",
+          "replacement clears old listeners and revokes owned URL",
+          "active fetch failure rejects and notices but retains track",
+          "failed attempt remains last option",
+          "superseded request settles undefined and aborts transport",
+          "late canceled response does not overwrite track",
+          "destroy settles pending request and aborts",
+          "destroy revokes active owned blob",
+          "player cleanup removes DOM and registry instance"
+        ]
+      },
+      {
+        "engine": "firefox",
+        "version": "155.0",
+        "passed": true,
+        "errors": [],
+        "checks": [
+          "initial manager/track shape",
+          "style overloads return container",
+          "switch returns blob before caller waits for native load",
+          "SRT conversion and callback receiver",
+          "native load arguments and cue identity",
+          "switch does not change base settings or track label",
+          "style shallow options leave existing CSS",
+          "arrays are snapshots with shared cue identity",
+          "active cue and ordered render events",
+          "switch-only escape override does not affect rendering",
+          "base escape false enables trusted HTML",
+          "show toggle class and events",
+          "empty switch does not remove current track",
+          "next switch uses base rather than previous switch options",
+          "replacement clears old listeners and revokes owned URL",
+          "active fetch failure rejects and notices but retains track",
+          "failed attempt remains last option",
+          "superseded request settles undefined and aborts transport",
+          "late canceled response does not overwrite track",
+          "destroy settles pending request and aborts",
+          "destroy revokes active owned blob",
+          "player cleanup removes DOM and registry instance"
+        ]
+      },
+      {
+        "engine": "webkit",
+        "version": "26.6",
+        "passed": true,
+        "errors": [],
+        "checks": [
+          "initial manager/track shape",
+          "style overloads return container",
+          "switch returns blob before caller waits for native load",
+          "SRT conversion and callback receiver",
+          "native load arguments and cue identity",
+          "switch does not change base settings or track label",
+          "style shallow options leave existing CSS",
+          "arrays are snapshots with shared cue identity",
+          "active cue and ordered render events",
+          "switch-only escape override does not affect rendering",
+          "base escape false enables trusted HTML",
+          "show toggle class and events",
+          "empty switch does not remove current track",
+          "next switch uses base rather than previous switch options",
+          "replacement clears old listeners and revokes owned URL",
+          "active fetch failure rejects and notices but retains track",
+          "failed attempt remains last option",
+          "superseded request settles undefined and aborts transport",
+          "late canceled response does not overwrite track",
+          "destroy settles pending request and aborts",
+          "destroy revokes active owned blob",
+          "player cleanup removes DOM and registry instance"
+        ]
+      }
+    ],
+    "complete": true,
+    "limitations": [
+      "Page navigation and DOM contracts only; no playback, codec, physical-device or release acceptance."
+    ],
+    "core": {
+      "artifact": {
+        "path": "packages/artplayer/dist/artplayer.js",
+        "sha256": "8a4caaa50a069875b3898a83765457b3c502700f4731d0c38988d6c463c3d20a"
+      },
+      "candidate": {
+        "kind": "npm-tarball",
+        "path": "refactor/.cache/packages/run-qQwwPA/artplayer.tgz",
+        "version": "6.0.0",
+        "sourceCommit": "96962a69a4faaecd986387efadb54c5623a23f2c",
+        "inputFingerprint": "f580b888bb9664b4dd30d900152a7b20560a49adc176ad9782103f7fe89be848",
+        "integrity": "sha512-+2+VWecKb9CbI3wTCs0sV7au8SNShyXahpwDAmGgZhDr22wbdv51QZnLnkPwgMgfNpVuTbsZ6A26Lpj3eY7NbQ=="
+      }
+    }
+  },
+  "semanticMapping": {
+    "addedRecords": 27,
+    "totalRecords": 358,
+    "remainingInventoryRecords": 605,
+    "unchanged": [
+      {
+        "group": "events",
+        "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+        "nonSubtitleSha256": "283df6319f48dc19c64fe9a3fe7d1f26e3a1c43d0ded760de0f63ad5bd49cc02"
+      },
+      {
+        "group": "events",
+        "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+        "nonSubtitleSha256": "c3d7299d857a3a758a1a1877b02ad1b3d42735eceaf516cdc0d0da7e2a65ef6c"
+      },
+      {
+        "group": "storage",
+        "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+        "nonSubtitleSha256": "283df6319f48dc19c64fe9a3fe7d1f26e3a1c43d0ded760de0f63ad5bd49cc02"
+      },
+      {
+        "group": "storage",
+        "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+        "nonSubtitleSha256": "c3d7299d857a3a758a1a1877b02ad1b3d42735eceaf516cdc0d0da7e2a65ef6c"
+      },
+      {
+        "group": "i18n",
+        "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+        "nonSubtitleSha256": "283df6319f48dc19c64fe9a3fe7d1f26e3a1c43d0ded760de0f63ad5bd49cc02"
+      },
+      {
+        "group": "i18n",
+        "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+        "nonSubtitleSha256": "c3d7299d857a3a758a1a1877b02ad1b3d42735eceaf516cdc0d0da7e2a65ef6c"
+      },
+      {
+        "group": "hotkey",
+        "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+        "nonSubtitleSha256": "283df6319f48dc19c64fe9a3fe7d1f26e3a1c43d0ded760de0f63ad5bd49cc02"
+      },
+      {
+        "group": "hotkey",
+        "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+        "nonSubtitleSha256": "c3d7299d857a3a758a1a1877b02ad1b3d42735eceaf516cdc0d0da7e2a65ef6c"
+      },
+      {
+        "group": "notice",
+        "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+        "nonSubtitleSha256": "283df6319f48dc19c64fe9a3fe7d1f26e3a1c43d0ded760de0f63ad5bd49cc02"
+      },
+      {
+        "group": "notice",
+        "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+        "nonSubtitleSha256": "c3d7299d857a3a758a1a1877b02ad1b3d42735eceaf516cdc0d0da7e2a65ef6c"
+      },
+      {
+        "group": "template",
+        "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+        "nonSubtitleSha256": "283df6319f48dc19c64fe9a3fe7d1f26e3a1c43d0ded760de0f63ad5bd49cc02"
+      },
+      {
+        "group": "template",
+        "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+        "nonSubtitleSha256": "c3d7299d857a3a758a1a1877b02ad1b3d42735eceaf516cdc0d0da7e2a65ef6c"
+      },
+      {
+        "group": "icons",
+        "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+        "nonSubtitleSha256": "283df6319f48dc19c64fe9a3fe7d1f26e3a1c43d0ded760de0f63ad5bd49cc02"
+      },
+      {
+        "group": "icons",
+        "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+        "nonSubtitleSha256": "c3d7299d857a3a758a1a1877b02ad1b3d42735eceaf516cdc0d0da7e2a65ef6c"
+      }
+    ]
+  },
+  "tests": {
+    "count": 34,
+    "pass": 34,
+    "fail": 0,
+    "skipped": 0,
+    "durationMs": 1449.102,
+    "suites": [
+      "subtitle",
+      "site-loading",
+      "documentation-pipeline"
+    ]
+  },
+  "build": {
+    "vitepressSeconds": 9.85,
+    "yarnSeconds": 11.47,
+    "checked": [
+      "build:docs",
+      "build:llm",
+      "check:llm",
+      "site-inventory --write/--check",
+      "demos --check"
+    ]
+  },
+  "ledger": {
+    "report": {
+      "path": "refactor/.cache/release-ledger-os1f7M/report.json",
+      "sha256": "4694dc14aab051e82a05010c069736e465ce43189015b7b672c99d0e0d7778b9"
+    },
+    "libraries": [
+      {
+        "name": "artplayer",
+        "fingerprint": "f580b888bb9664b4dd30d900152a7b20560a49adc176ad9782103f7fe89be848",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-ads",
+        "fingerprint": "55236854b94ac7b0dd91b4107dcb60e97ac6f1a5e8b6b8a9dcb63bba66c6509a",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-ambilight",
+        "fingerprint": "f88a6a2f1c5548389cae293614f648d72077ed03a7be6c81ad017a1155a839a3",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-asr",
+        "fingerprint": "7fa3ca9577b53f3bb90e2c23fec9e6e70fbbb0c089ccae2923084b9059bcbdf9",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-audio-track",
+        "fingerprint": "0c73b970872fe56df1c669e5badfa91f9cd7ec3c73070a9852cfea076cc8923f",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-auto-thumbnail",
+        "fingerprint": "9ced9b18e4b260ccbcf6ac016b32ec0852040cb5c0f57be72718a03d40d598bf",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-chapter",
+        "fingerprint": "f1dd73097e43df504f686f18a6ca30bcb1f57ab74d3cc62909db20505c994072",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-chromecast",
+        "fingerprint": "d6d79d4b47afaefa66d32c5b1709f412ed9d32c636462723918c268a6601e631",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-danmuku",
+        "fingerprint": "3d32a4c6d94d9eaa31cd982ec43ae2b710a4c923e5076f357ba4c902be48d729",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-danmuku-mask",
+        "fingerprint": "ceb17cbb235a42438c28df15ddf830d104a749b58515333c43da2b18534b166c",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-dash-control",
+        "fingerprint": "6716002b92bb12b54d17772d87a560bb9e863da35abfa37988907d54e02cdf74",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-document-pip",
+        "fingerprint": "a3a56ecc218c8e180621d1bc00684950cca4ada8d483334b0cb91fd783c10831",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-hls-control",
+        "fingerprint": "00a07f33277bae211a553e9fb2e924ade219513135bc54921886f4518dd27964",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-jassub",
+        "fingerprint": "cc9304759ff3cdd84767eee38fcbb9cf70e234f2449946536fd1da972cde679f",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-multiple-subtitles",
+        "fingerprint": "43825f602514c9e6a0bd8f0a270a54a03d1cb76f821b99d1e736d0150dafc190",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-vast",
+        "fingerprint": "3503e145a591a406105eb953f9ac75c8373992c9f3f1f23b713de65c85a3bb3d",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-plugin-vtt-thumbnail",
+        "fingerprint": "b7932e08a086cfe16ed5e78872e274fb897931d0653dbf7ac61a19b404ddec85",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-proxy-canvas",
+        "fingerprint": "a0a8efb762e823fe4dd8c8de9601f74ac873ade8c6953a7e5305297608c71a12",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-proxy-mediabunny",
+        "fingerprint": "9fd7e62c56ae78866267cdd5650dc4e4af4aad76dd6ff8466b68908bc25d661c",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-tool-iframe",
+        "fingerprint": "00dc477ad56d12cfa6cd0d1e071e80f4120afed23f44af0393e23e5dac516a3b",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      },
+      {
+        "name": "artplayer-tool-thumbnail",
+        "fingerprint": "78bf5be3b2b5656a0b95ce2ce3cf1a635b6df609361a840b8298476f65af9d52",
+        "build": {
+          "status": "evidence-recorded"
+        },
+        "status": "blocked"
+      }
+    ],
+    "publicationAuthorized": false
+  },
+  "limitations": [
+    "Native track parsing and local seek/cue rendering checked; not full media playback acceptance or iOS/macOS fullscreen validation.",
+    "Two delayed fetches intentionally use a controlled wrapper to exercise cancellation even when transport ignores AbortSignal; other subtitle loads use routed HTTP responses and real Blob/native tracks."
+  ],
+  "visualInspection": "chromium-zh-built-in.png",
+  "attachments": [
+    {
+      "path": "refactor/.cache/site04-subtitle-validate.mjs",
+      "sha256": "8fe77b1b562f74d0ea1b548951631ae4c1818b592c4cc8724c6209b363b61bc2"
+    },
+    {
+      "path": "refactor/.cache/site04-subtitle-probe.js",
+      "sha256": "f07da099aa4ce45d6560f5e211f5d6c2d803effcfeb6ec10f642cb1ce6e75ece"
+    },
+    {
+      "path": "refactor/.cache/site04-subtitle/report.json",
+      "sha256": "dbaafecc3742a4a252489575c27121d718714e55374dd874847c4039e0e340f1"
+    },
+    {
+      "path": "refactor/.cache/site04-subtitle-build.log",
+      "sha256": "8bcf65221b4195bf81f99a274d412521a2e95ea5f8c919a6f4cbdd39e3658388"
+    },
+    {
+      "path": "refactor/.cache/site04-subtitle-llm.log",
+      "sha256": "362b5c76bfff0db1689626d5867480786aa855d15231b2da495362ae252718af"
+    },
+    {
+      "path": "refactor/.cache/site04-subtitle-tests.log",
+      "sha256": "124cdbb7c02d90ec888d0c4ba2b19625d863aa42e4a2affd56fb4faf490bdc90"
+    },
+    {
+      "path": "refactor/.cache/site04-subtitle-validate.log",
+      "sha256": "e07f7b177b499fa6d14cc152e8772b09013d23186ade29c5e2cc40e3544210a1"
+    },
+    {
+      "path": "refactor/.cache/site04-subtitle-ledger.log",
+      "sha256": "e248524ca797e8fe761b021f0f699a38d7383489fae4bafb959eab7e0e4da8ad"
+    }
+  ]
+}

refactor/changes/2026-09-16-SITE-04-subtitle.md

@@ -0,0 +1,29 @@
+# SITE-04 字幕指南与语义映射
+
+起点：`de45f5b978a69aaae3b466325ac4dce35bd0dee2`。本批属于既定实施文档，
+SITE-04 保持 doing；不进入用户保留的三轮正式复盘。
+
+双语高级属性的字幕章节补齐配置默认值、switch 浅合并与配置归属、转换回调、
+Promise/原生加载阶段、轨道与 cue 引用、渲染事件和 escape、资源归属和取消。
+说明空 URL 不清除轨道、原生 track 错误不会追溯拒绝已经兑现的 Promise、低层
+init/createTrack/destroyEvent 的边界，以及根历史声明与 runtime 准确声明的区别。
+核心运行时、声明、入口和旧36个 Run Code 片段均未修改。
+
+新增27条配置、管理器、cue/track及实例入口映射，累计358/963，605条仍待核对。
+之前分组源码哈希保持不变；高级属性指南除字幕章节外的内容，经过 LF 归一化后与
+起点逐字一致，才更新相应整页哈希。没有将字幕章节的核对扩展到其他播放/事件成员。
+
+Node24.21.0 / Yarn1.22.22：34项测试通过，0失败/跳过，1449.102ms。
+VitePress9.85秒，Yarn整体11.47秒；LLM生成/只读检查、站点清点和demo检查通过。
+两页共六份 strict/NodeNext TS 代码通过（含原有四份）。六组浏览器页面、108次
+代码转发一致。Chromium153.0.8010.12、Firefox155.0、WebKit26.6各通过22项
+字幕断言：真实原生track加载SRT/VTT、seek后的cue/渲染、事件、样式/转义、错误、
+替换及销毁资源回收。中文页面截图目视检查通过。
+
+迟到请求使用受控fetch包装，故意忽略AbortSignal，以验证取消后的结果隔离；其他
+字幕通过HTTP路由响应、真实Blob和原生track加载。没有据此声称完成播放/解码、
+iOS/macOS原生全屏或真机验收。21库候选build证据仍有效，其他发布门槛未改。
+详情、文件哈希和日志见[证据](../baselines/site04-subtitle.json)。
+
+docs/document与LLM文件由项目脚本生成。回退本提交恢复指南和生成文件即可，
+无需回退核心行为。继续其余核心声明与文档核对；不推送或发布。

refactor/core-content-review.json

@@ -3,13 +3,13 @@
   "task": "SITE-04",
   "inventory": {
     "path": "refactor/baselines/site-inventory.json",
-    "sha256": "503c389f66788737851288e0b2879dd73dfc630f9ce4f0474b49a2ba6bcb32e1"
+    "sha256": "ada7e484d1d751be99fb56a145a6578eb1642a5e3ef9c3ab54aa5e451fd5b2bb"
   },
-  "reviewedAt": "2026-09-15T23:09:40.297Z",
+  "reviewedAt": "2026-09-15T23:17:13.870Z",
   "counts": {
     "inventoryRecords": 963,
-    "reviewedRecords": 331,
-    "unreviewedRecords": 632
+    "reviewedRecords": 358,
+    "unreviewedRecords": 605
   },
   "note": "Explicit declaration-record semantic mapping, including overload/getter/setter rows and root/runtime aliases. Counts are not overall API or release completion. Recheck affected groups if their source/document hashes drift. Other declarations and inline members are not implicitly covered.",
   "groups": [
@@ -118,20 +118,20 @@
       "docs": [
         {
           "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
-          "sha256": "a80bec28ca80291bc9e2c6d043544a5476dbca38a3f0fa14356c3755418f2800",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
           "anchor": "events"
         },
         {
           "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
-          "sha256": "d34b8ff8cbfce43aa727c35cf52d857952e33cc44eb619f5e5f748e09006bacc",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
           "anchor": "events"
         }
       ],
       "evidence": "baselines/site04-core-services.json",
       "documentHashRevalidation": {
-        "sourceBefore": "a1488f11bb73f7b96a04fadbce072a24bf626e79",
-        "evidence": "baselines/site04-template-icons.json",
-        "reason": "Relevant service section is byte-identical after LF normalization; source hashes remain unchanged. Whole-guide hash changed for template/icon additions."
+        "sourceBefore": "de45f5b978a69aaae3b466325ac4dce35bd0dee2",
+        "evidence": "baselines/site04-subtitle.json",
+        "reason": "Whole-guide hash changed for subtitle section only. All content outside that section is byte-identical after LF normalization; source hashes remain unchanged."
       }
     },
     {
@@ -217,20 +217,20 @@
       "docs": [
         {
           "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
-          "sha256": "a80bec28ca80291bc9e2c6d043544a5476dbca38a3f0fa14356c3755418f2800",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
           "anchor": "storage"
         },
         {
           "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
-          "sha256": "d34b8ff8cbfce43aa727c35cf52d857952e33cc44eb619f5e5f748e09006bacc",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
           "anchor": "storage"
         }
       ],
       "evidence": "baselines/site04-core-services.json",
       "documentHashRevalidation": {
-        "sourceBefore": "a1488f11bb73f7b96a04fadbce072a24bf626e79",
-        "evidence": "baselines/site04-template-icons.json",
-        "reason": "Relevant service section is byte-identical after LF normalization; source hashes remain unchanged. Whole-guide hash changed for template/icon additions."
+        "sourceBefore": "de45f5b978a69aaae3b466325ac4dce35bd0dee2",
+        "evidence": "baselines/site04-subtitle.json",
+        "reason": "Whole-guide hash changed for subtitle section only. All content outside that section is byte-identical after LF normalization; source hashes remain unchanged."
       }
     },
     {
@@ -619,20 +619,20 @@
       "docs": [
         {
           "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
-          "sha256": "a80bec28ca80291bc9e2c6d043544a5476dbca38a3f0fa14356c3755418f2800",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
           "anchor": "i18n"
         },
         {
           "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
-          "sha256": "d34b8ff8cbfce43aa727c35cf52d857952e33cc44eb619f5e5f748e09006bacc",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
           "anchor": "i18n"
         }
       ],
       "evidence": "baselines/site04-core-services.json",
       "documentHashRevalidation": {
-        "sourceBefore": "a1488f11bb73f7b96a04fadbce072a24bf626e79",
-        "evidence": "baselines/site04-template-icons.json",
-        "reason": "Relevant service section is byte-identical after LF normalization; source hashes remain unchanged. Whole-guide hash changed for template/icon additions."
+        "sourceBefore": "de45f5b978a69aaae3b466325ac4dce35bd0dee2",
+        "evidence": "baselines/site04-subtitle.json",
+        "reason": "Whole-guide hash changed for subtitle section only. All content outside that section is byte-identical after LF normalization; source hashes remain unchanged."
       }
     },
     {
@@ -719,20 +719,20 @@
       "docs": [
         {
           "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
-          "sha256": "a80bec28ca80291bc9e2c6d043544a5476dbca38a3f0fa14356c3755418f2800",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
           "anchor": "hotkey"
         },
         {
           "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
-          "sha256": "d34b8ff8cbfce43aa727c35cf52d857952e33cc44eb619f5e5f748e09006bacc",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
           "anchor": "hotkey"
         }
       ],
       "evidence": "baselines/site04-core-services.json",
       "documentHashRevalidation": {
-        "sourceBefore": "a1488f11bb73f7b96a04fadbce072a24bf626e79",
-        "evidence": "baselines/site04-template-icons.json",
-        "reason": "Relevant service section is byte-identical after LF normalization; source hashes remain unchanged. Whole-guide hash changed for template/icon additions."
+        "sourceBefore": "de45f5b978a69aaae3b466325ac4dce35bd0dee2",
+        "evidence": "baselines/site04-subtitle.json",
+        "reason": "Whole-guide hash changed for subtitle section only. All content outside that section is byte-identical after LF normalization; source hashes remain unchanged."
       }
     },
     {
@@ -811,20 +811,20 @@
       "docs": [
         {
           "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
-          "sha256": "a80bec28ca80291bc9e2c6d043544a5476dbca38a3f0fa14356c3755418f2800",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
           "anchor": "notice"
         },
         {
           "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
-          "sha256": "d34b8ff8cbfce43aa727c35cf52d857952e33cc44eb619f5e5f748e09006bacc",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
           "anchor": "notice"
         }
       ],
       "evidence": "baselines/site04-core-services.json",
       "documentHashRevalidation": {
-        "sourceBefore": "a1488f11bb73f7b96a04fadbce072a24bf626e79",
-        "evidence": "baselines/site04-template-icons.json",
-        "reason": "Relevant service section is byte-identical after LF normalization; source hashes remain unchanged. Whole-guide hash changed for template/icon additions."
+        "sourceBefore": "de45f5b978a69aaae3b466325ac4dce35bd0dee2",
+        "evidence": "baselines/site04-subtitle.json",
+        "reason": "Whole-guide hash changed for subtitle section only. All content outside that section is byte-identical after LF normalization; source hashes remain unchanged."
       }
     },
     {
@@ -1328,7 +1328,7 @@
       "docs": [
         {
           "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
-          "sha256": "a80bec28ca80291bc9e2c6d043544a5476dbca38a3f0fa14356c3755418f2800",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
           "anchor": "template"
         },
         {
@@ -1338,7 +1338,7 @@
         },
         {
           "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
-          "sha256": "d34b8ff8cbfce43aa727c35cf52d857952e33cc44eb619f5e5f748e09006bacc",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
           "anchor": "template"
         },
         {
@@ -1347,7 +1347,12 @@
           "anchor": "html"
         }
       ],
-      "evidence": "baselines/site04-template-icons.json"
+      "evidence": "baselines/site04-template-icons.json",
+      "documentHashRevalidation": {
+        "sourceBefore": "de45f5b978a69aaae3b466325ac4dce35bd0dee2",
+        "evidence": "baselines/site04-subtitle.json",
+        "reason": "Whole-guide hash changed for subtitle section only. All content outside that section is byte-identical after LF normalization; source hashes remain unchanged."
+      }
     },
     {
       "id": "icons",
@@ -1595,16 +1600,21 @@
       "docs": [
         {
           "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
-          "sha256": "a80bec28ca80291bc9e2c6d043544a5476dbca38a3f0fa14356c3755418f2800",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
           "anchor": "icons"
         },
         {
           "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
-          "sha256": "d34b8ff8cbfce43aa727c35cf52d857952e33cc44eb619f5e5f748e09006bacc",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
           "anchor": "icons"
         }
       ],
-      "evidence": "baselines/site04-template-icons.json"
+      "evidence": "baselines/site04-template-icons.json",
+      "documentHashRevalidation": {
+        "sourceBefore": "de45f5b978a69aaae3b466325ac4dce35bd0dee2",
+        "evidence": "baselines/site04-subtitle.json",
+        "reason": "Whole-guide hash changed for subtitle section only. All content outside that section is byte-identical after LF normalization; source hashes remain unchanged."
+      }
     },
     {
       "id": "components",
@@ -3044,6 +3054,307 @@
         }
       ],
       "evidence": "baselines/site04-plugin-registry.json"
+    },
+    {
+      "id": "subtitle",
+      "status": "semantic-reviewed",
+      "conclusion": "Options, shallow switch merge and base-versus-attempt settings; conversion and callback receiver, fetch/track completion distinction, exact Promise outcomes and errors; track/cue identity, rendering/event order and escape source; style/show/update differences from generic components, low-level init/createTrack/destroyEvent boundaries, owned URL lifetime and cancellation. Root legacy types versus runtime manager; physical native fullscreen remains unverified.",
+      "records": [
+        {
+          "id": "packages/artplayer/public/artplayer.ts#Artplayer.subtitle@178",
+          "file": "packages/artplayer/public/artplayer.ts",
+          "declaration": "Artplayer",
+          "name": "subtitle",
+          "line": 178
+        },
+        {
+          "id": "packages/artplayer/public/runtime.ts#Artplayer.subtitle@90",
+          "file": "packages/artplayer/public/runtime.ts",
+          "declaration": "Artplayer",
+          "name": "subtitle",
+          "line": 90
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#SubtitleCue.text@6",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "SubtitleCue",
+          "name": "text",
+          "line": 6
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#SubtitleCue.originalStartTime@7",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "SubtitleCue",
+          "name": "originalStartTime",
+          "line": 7
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#SubtitleCue.originalEndTime@8",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "SubtitleCue",
+          "name": "originalEndTime",
+          "line": 8
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#SubtitleTrack.offset@11",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "SubtitleTrack",
+          "name": "offset",
+          "line": 11
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.name@14",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "name",
+          "line": 14
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.option@15",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "option",
+          "line": 15
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.destroyEvent@16",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "destroyEvent",
+          "line": 16
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.url@17",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "url",
+          "line": 17
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.textTrack@18",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "textTrack",
+          "line": 18
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.activeCues@19",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "activeCues",
+          "line": 19
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.cues@20",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "cues",
+          "line": 20
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.show@21",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "show",
+          "line": 21
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.toggle@22",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "toggle",
+          "line": 22
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.style@23",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "style",
+          "line": 23
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.update@27",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "update",
+          "line": 27
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.switch@28",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "switch",
+          "line": 28
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.init@29",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "init",
+          "line": 29
+        },
+        {
+          "id": "packages/artplayer/public/runtime/subtitle.ts#Subtitle.createTrack@30",
+          "file": "packages/artplayer/public/runtime/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "createTrack",
+          "line": 30
+        },
+        {
+          "id": "packages/artplayer/public/subtitle.ts#Subtitle.url@5",
+          "file": "packages/artplayer/public/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "url",
+          "line": 5
+        },
+        {
+          "id": "packages/artplayer/public/subtitle.ts#Subtitle.name@10",
+          "file": "packages/artplayer/public/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "name",
+          "line": 10
+        },
+        {
+          "id": "packages/artplayer/public/subtitle.ts#Subtitle.type@15",
+          "file": "packages/artplayer/public/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "type",
+          "line": 15
+        },
+        {
+          "id": "packages/artplayer/public/subtitle.ts#Subtitle.style@20",
+          "file": "packages/artplayer/public/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "style",
+          "line": 20
+        },
+        {
+          "id": "packages/artplayer/public/subtitle.ts#Subtitle.encoding@25",
+          "file": "packages/artplayer/public/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "encoding",
+          "line": 25
+        },
+        {
+          "id": "packages/artplayer/public/subtitle.ts#Subtitle.escape@30",
+          "file": "packages/artplayer/public/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "escape",
+          "line": 30
+        },
+        {
+          "id": "packages/artplayer/public/subtitle.ts#Subtitle.onVttLoad@35",
+          "file": "packages/artplayer/public/subtitle.ts",
+          "declaration": "Subtitle",
+          "name": "onVttLoad",
+          "line": 35
+        }
+      ],
+      "sources": [
+        {
+          "path": "packages/artplayer/src/subtitle/index.ts",
+          "sha256": "b4ead680dc82fa47c53d1ec7e5fb8bf94abbf55730d5d1130ad8d544cb42adc8"
+        },
+        {
+          "path": "packages/artplayer/src/subtitle/parse.ts",
+          "sha256": "7db540c5edb1d2312eed82757fd15a7ce6a28996ba20d0087e56730f21dede74"
+        },
+        {
+          "path": "packages/artplayer/src/subtitle/request.ts",
+          "sha256": "543c964571bd5ab984bc1adc9f64a8917dd134ed2892ad10b30ed9c859f34119"
+        },
+        {
+          "path": "packages/artplayer/src/subtitle/render.ts",
+          "sha256": "96493fc35680af635a8db225a8bf002208df79ed48b1d4ee6cc73587543add5c"
+        },
+        {
+          "path": "packages/artplayer/src/subtitle/state.ts",
+          "sha256": "9f79b982d66747170bc39bdaf99b65676310965f23da62a4dec15547c756a56b"
+        },
+        {
+          "path": "packages/artplayer/src/subtitle/track.ts",
+          "sha256": "707f4c43af4ebf4b87521f6f577168460e739274d0cec28b9efe5704d2540d18"
+        },
+        {
+          "path": "packages/artplayer/src/subtitle/types.ts",
+          "sha256": "c7fd0568c71611fe44f0a7d2735a246250c8a63daefd15c63091e37d38bf1edb"
+        },
+        {
+          "path": "packages/artplayer/src/subtitle/timing.ts",
+          "sha256": "f2c1dbb63697a51c200371127da4fb8ea6e90a5b4de888bb1c2d7eae4007a5f8"
+        },
+        {
+          "path": "packages/artplayer/src/player/subtitleOffsetMix.ts",
+          "sha256": "cf9834711842c8a31c3143ab3028f0cf9ba541fafe6f0a3076067daa9d4c750a"
+        },
+        {
+          "path": "packages/artplayer/src/utils/subtitle.ts",
+          "sha256": "f058851d11a418e321a8a498472b67fa535fec2c7b5d3df739b6b4f263d00337"
+        },
+        {
+          "path": "packages/artplayer/src/utils/file.ts",
+          "sha256": "ea71d7fc0e818d473bf5a596211ba9d571e4febdf1878014eadefa8d0a98d4cc"
+        },
+        {
+          "path": "packages/artplayer/src/utils/component.ts",
+          "sha256": "c3fa96467e8b315d974a42a19591aa4a4a7514853db796135b2acbcdcb160ea3"
+        },
+        {
+          "path": "packages/artplayer/src/dom/styles.ts",
+          "sha256": "734e0a4e04d666417a18ac09ed6271ee7630c399d52d7f510a1c19fd6e7b3493"
+        },
+        {
+          "path": "packages/artplayer/src/option/defaults.ts",
+          "sha256": "0bfdc329c48716ac5987c8979fee7e116f6894a70fefc908c99876dfbb4d9dc0"
+        },
+        {
+          "path": "packages/artplayer/src/scheme/index.ts",
+          "sha256": "dc4a3b5e08478cf72b46b0b59c023359ad5f79b891ea8a6a119ce24a5251821a"
+        },
+        {
+          "path": "packages/artplayer/src/lifecycle/instance.ts",
+          "sha256": "3168f7db4271bae7a242e80798546b755ac15443e15dd9ebb7675f5a259299d8"
+        },
+        {
+          "path": "packages/artplayer/public/artplayer.ts",
+          "sha256": "26a42ac66811e70f68a8ebe62cbf304eb1993451b3e658961be98e7106162527"
+        },
+        {
+          "path": "packages/artplayer/public/runtime.ts",
+          "sha256": "ec4b1d56993eb482a77eb0f94b701047549d009e6ba6433f27e7d464fef30c2b"
+        },
+        {
+          "path": "packages/artplayer/public/runtime/subtitle.ts",
+          "sha256": "13241c4f9a87517aa2cf7b3e0bb8cedaa12fa0b4d3f8934285797583b752557e"
+        },
+        {
+          "path": "packages/artplayer/public/subtitle.ts",
+          "sha256": "d25b470e47d6a9bd696d9c1ad8adb58e56a208f05695186d513bc8c43c2e8acf"
+        }
+      ],
+      "docs": [
+        {
+          "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
+          "anchor": "subtitle-contract"
+        },
+        {
+          "path": "packages/artplayer-vitepress/docs/advanced/built-in.md",
+          "sha256": "7e3532221a87652457371babdcc816643984f4a7fd080a5aed07b1807cedb8e6",
+          "anchor": "subtitle-runtime"
+        },
+        {
+          "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
+          "anchor": "subtitle-contract"
+        },
+        {
+          "path": "packages/artplayer-vitepress/docs/en/advanced/built-in.md",
+          "sha256": "3fc59e64a6cda6f1a176dddee92a24cfb0d0b56982bf535aa048e46a1bea774a",
+          "anchor": "subtitle-runtime"
+        }
+      ],
+      "evidence": "baselines/site04-subtitle.json"
     }
   ]
 }

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) [记录](changes/2026-09-16-SITE-04-existing-guides.md) [记录](baselines/site04-existing-guides.json) [记录](core-content-review.json) [记录](baselines/site04-core-services.json) [记录](changes/2026-09-16-SITE-04-core-services.md) [记录](baselines/site04-template-icons.json) [记录](changes/2026-09-16-SITE-04-template-icons.md) [记录](baselines/site04-components.json) [记录](changes/2026-09-16-SITE-04-components.md) [记录](baselines/site04-setting.json) [记录](changes/2026-09-16-SITE-04-setting.md) [记录](baselines/site04-plugin-registry.json) [记录](changes/2026-09-16-SITE-04-plugin-registry.md)
+- 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) [记录](core-content-review.json) [记录](baselines/site04-core-services.json) [记录](changes/2026-09-16-SITE-04-core-services.md) [记录](baselines/site04-template-icons.json) [记录](changes/2026-09-16-SITE-04-template-icons.md) [记录](baselines/site04-components.json) [记录](changes/2026-09-16-SITE-04-components.md) [记录](baselines/site04-setting.json) [记录](changes/2026-09-16-SITE-04-setting.md) [记录](baselines/site04-plugin-registry.json) [记录](changes/2026-09-16-SITE-04-plugin-registry.md) [记录](baselines/site04-subtitle.json) [记录](changes/2026-09-16-SITE-04-subtitle.md)
 - 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,13 @@
 # 进度与证据
 
+## SITE-04 字幕语义映射
+
+补齐双语字幕加载、渲染、配置归属与清理指南，新增27条声明映射，累计358/963，
+605条仍待核对。34项测试、六份TS、六组页面/108次代码转发，以及三浏览器各22项
+原生track/渲染/取消断言通过。见[记录](changes/2026-09-16-SITE-04-subtitle.md)和
+[证据](baselines/site04-subtitle.json)。只刷新字幕章节相关指南哈希，其余章节与
+源码已核对不变。21库build有效；SITE-04继续doing，224/22/39不变，不进入正式复盘。
+
 ## SITE-04 插件注册语义映射
 
 补齐双语插件编写指南，明确同步/异步注册、ready独立、命名/返回值、工厂构造阶段、

refactor/site-content-review.md

@@ -97,6 +97,12 @@ range字段导致切换形态失败的示例。两份严格TS、六组页面、5
 断言和27项测试通过，见[证据](baselines/site04-plugin-registry.json)。之前各组
 源码/指南哈希不变；21库候选build有效，字幕/内置插件具体行为尚未由此覆盖。
 
+字幕随后新增27条，累计358条映射、605条待核对。配置归属、Promise与track事件、
+cue身份、渲染/转义、低层接口、取消和Blob归属已补双语指南；34项测试、两页六份
+TS、六组页面/108次转发及三浏览器各22项字幕断言通过，见
+[证据](baselines/site04-subtitle.json)。原有组源码不变，相关指南仅字幕章节变化；
+原生全屏设备验收仍单独保留，21库build有效。
+
 - 核心：依据 site-inventory.json 的 963 条成员逐项或按明确的共享声明分组核对；
   必须记录对应文档及语义结论，不能仅按同名标题匹配标为通过。
 - Danmuku、HLS、DASH、Audio、VTT 的当前声明/源码语义已补核对；既有媒体报告

refactor/tasks.json

@@ -4583,7 +4583,9 @@
         "baselines/site04-setting.json",
         "changes/2026-09-16-SITE-04-setting.md",
         "baselines/site04-plugin-registry.json",
-        "changes/2026-09-16-SITE-04-plugin-registry.md"
+        "changes/2026-09-16-SITE-04-plugin-registry.md",
+        "baselines/site04-subtitle.json",
+        "changes/2026-09-16-SITE-04-subtitle.md"
       ]
     },
     {