docs(danmuku): [SITE-DANMUKU-01] complete bilingual usage guides

refactor/baselines/site-inventory.json

@@ -4,9 +4,9 @@
   "note": "Read-only source inventory. Heading matches are candidates, never semantic API coverage. Asset identity is not permission. No runtime, remote Pages or npm acceptance is implied.",
   "counts": {
     "packages": 22,
-    "markdown": 27,
+    "markdown": 28,
     "examples": 30,
-    "html": 36,
+    "html": 37,
     "declarationMembers": 963,
     "assets": 204
   },
@@ -1946,6 +1946,73 @@
       "translation": "packages/artplayer-vitepress/docs/index.md",
       "translationOwner": null
     },
+    {
+      "file": "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
+      "sha256Lf": "a563349b064adac119dac943060ffc5bc82a8ccbd6e20d2d7b5a1e1cb4d66ba2",
+      "language": "en",
+      "route": "/document/en/plugin/danmuku.html",
+      "headings": [
+        {
+          "text": "Danmuku",
+          "line": 1
+        },
+        {
+          "text": "Demo",
+          "line": 8
+        },
+        {
+          "text": "Installation",
+          "line": 13
+        },
+        {
+          "text": "CDN",
+          "line": 39
+        },
+        {
+          "text": "Comment structure",
+          "line": 53
+        },
+        {
+          "text": "All options",
+          "line": 70
+        },
+        {
+          "text": "Array, XML and asynchronous input",
+          "line": 111
+        },
+        {
+          "text": "Lifecycle callbacks",
+          "line": 136
+        },
+        {
+          "text": "Methods and state",
+          "line": 156
+        },
+        {
+          "text": "Loading and configuration",
+          "line": 177
+        },
+        {
+          "text": "External mount",
+          "line": 214
+        },
+        {
+          "text": "Heatmap",
+          "line": 241
+        },
+        {
+          "text": "Events",
+          "line": 279
+        },
+        {
+          "text": "TypeScript",
+          "line": 301
+        }
+      ],
+      "runCodeMarkers": 4,
+      "translation": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
+      "translationOwner": null
+    },
     {
       "file": "packages/artplayer-vitepress/docs/en/start/i18n.md",
       "sha256Lf": "1551bf939aab1ee942d8480df891640109d18aa9adc016adf1d075bee5ef1de9",
@@ -2265,7 +2332,7 @@
     },
     {
       "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-      "sha256Lf": "a019e334d22628f1697a2a0be15e9c3f01e36b2c8da825f32ea86b4135b91c2b",
+      "sha256Lf": "3162d24c17eac5c7e07dd8552f8004ba2b74c9caf7f65b7bf0f54e7a4a8c1031",
       "language": "zh",
       "route": "/document/plugin/danmuku.html",
       "headings": [
@@ -2275,80 +2342,92 @@
         },
         {
           "text": "演示",
-          "line": 3
-        },
-        {
-          "text": "安装",
           "line": 7
         },
+        {
+          "text": "安装",
+          "line": 13
+        },
         {
           "text": "CDN",
-          "line": 29
+          "line": 35
         },
         {
           "text": "弹幕结构",
-          "line": 43
+          "line": 49
         },
         {
           "text": "全部选项",
-          "line": 58
+          "line": 64
         },
         {
           "text": "生命周期",
-          "line": 94
+          "line": 104
         },
         {
           "text": "使用弹幕数组",
-          "line": 158
+          "line": 170
         },
         {
           "text": "使用弹幕 XML",
-          "line": 181
+          "line": 193
         },
         {
           "text": "使用异步返回",
-          "line": 201
+          "line": 213
         },
         {
           "text": "`hide/show`",
-          "line": 228
+          "line": 242
         },
         {
           "text": "`isHide`",
-          "line": 264
+          "line": 278
         },
         {
           "text": "`emit`",
-          "line": 299
+          "line": 313
         },
         {
           "text": "`config`",
-          "line": 335
+          "line": 349
         },
         {
           "text": "`load`",
-          "line": 373
+          "line": 387
         },
         {
           "text": "`reset`",
-          "line": 424
+          "line": 438
         },
         {
           "text": "`mount`",
-          "line": 448
+          "line": 462
         },
         {
           "text": "`option`",
-          "line": 477
+          "line": 496
         },
         {
           "text": "事件",
-          "line": 501
+          "line": 520
+        },
+        {
+          "text": "`isStop` 与方法返回值",
+          "line": 582
+        },
+        {
+          "text": "热力图",
+          "line": 591
+        },
+        {
+          "text": "TypeScript",
+          "line": 626
         }
       ],
-      "runCodeMarkers": 13,
-      "translation": null,
-      "translationOwner": "SITE-04"
+      "runCodeMarkers": 14,
+      "translation": "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
+      "translationOwner": null
     },
     {
       "file": "packages/artplayer-vitepress/docs/start/i18n.md",
@@ -2702,7 +2781,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 335
+          "line": 349
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -2833,7 +2912,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 477
+          "line": 496
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -3457,7 +3536,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 477
+          "line": 496
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -3614,7 +3693,7 @@
       "candidateHeadings": [
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 299
+          "line": 313
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -3627,7 +3706,7 @@
       "candidateHeadings": [
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 299
+          "line": 313
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -3640,7 +3719,7 @@
       "candidateHeadings": [
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 299
+          "line": 313
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -3777,7 +3856,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 424
+          "line": 438
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -4853,7 +4932,7 @@
       "candidateHeadings": [
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 299
+          "line": 313
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -6807,6 +6886,10 @@
         {
           "file": "packages/artplayer-vitepress/docs/en/advanced/property.md",
           "line": 576
+        },
+        {
+          "file": "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
+          "line": 156
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -7091,7 +7174,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 335
+          "line": 349
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -8791,6 +8874,10 @@
         {
           "file": "packages/artplayer-vitepress/docs/en/advanced/property.md",
           "line": 576
+        },
+        {
+          "file": "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
+          "line": 156
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -8808,6 +8895,10 @@
         {
           "file": "packages/artplayer-vitepress/docs/en/advanced/property.md",
           "line": 576
+        },
+        {
+          "file": "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
+          "line": 156
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -10391,7 +10482,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 424
+          "line": 438
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -10669,7 +10760,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 477
+          "line": 496
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -11253,7 +11344,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 424
+          "line": 438
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -11357,7 +11448,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 335
+          "line": 349
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -11488,7 +11579,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 477
+          "line": 496
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -11721,7 +11812,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 477
+          "line": 496
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -13051,6 +13142,10 @@
         {
           "file": "packages/artplayer-vitepress/docs/en/advanced/property.md",
           "line": 576
+        },
+        {
+          "file": "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
+          "line": 156
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -13068,6 +13163,10 @@
         {
           "file": "packages/artplayer-vitepress/docs/en/advanced/property.md",
           "line": 576
+        },
+        {
+          "file": "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
+          "line": 156
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -14667,7 +14766,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 477
+          "line": 496
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -14874,7 +14973,7 @@
         },
         {
           "file": "packages/artplayer-vitepress/docs/plugin/danmuku.md",
-          "line": 477
+          "line": 496
         }
       ],
       "semanticReviewOwner": "SITE-04"
@@ -16766,6 +16865,7 @@
         "packages/artplayer-vitepress/docs/en/component/layers.md",
         "packages/artplayer-vitepress/docs/en/component/setting.md",
         "packages/artplayer-vitepress/docs/en/index.md",
+        "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
         "packages/artplayer-vitepress/docs/en/start/i18n.md",
         "packages/artplayer-vitepress/docs/en/start/option.md",
         "packages/artplayer-vitepress/docs/index.md",
@@ -16870,6 +16970,7 @@
       ],
       "sidebarMentionsPackage": true,
       "dedicatedPages": [
+        "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
         "packages/artplayer-vitepress/docs/plugin/danmuku.md"
       ],
       "contentReviewOwner": "SITE-04",
@@ -17047,6 +17148,7 @@
         "packages/artplayer-vitepress/docs/en/component/layers.md",
         "packages/artplayer-vitepress/docs/en/component/setting.md",
         "packages/artplayer-vitepress/docs/en/index.md",
+        "packages/artplayer-vitepress/docs/en/plugin/danmuku.md",
         "packages/artplayer-vitepress/docs/en/start/i18n.md",
         "packages/artplayer-vitepress/docs/en/start/option.md",
         "packages/artplayer-vitepress/docs/index.md",
@@ -17148,7 +17250,7 @@
     {
       "name": "canvas",
       "source": "docs/assets/example/canvas.js",
-      "sha256Lf": "95a971773e93cfb340a07eebcd49e333825f49ce0d167514ad98a188cd027799",
+      "sha256Lf": "cb92730640913cdc8f03e01cce9d7c877537177950491449d48817e77960f458",
       "menuLinks": [
         "/?libs=./uncompiled/artplayer-proxy-canvas/index.js&example=canvas"
       ],
@@ -17497,10 +17599,10 @@
     {
       "source": "docs/document/404.html",
       "route": "/document/404.html",
-      "sha256Lf": "539657203fa549c6cd296ded750c44bc0781f93c016deac48520294a41bbfbc9",
+      "sha256Lf": "3717d17f8ed125c4781ef3663b7b7d2bb72f579d6043a406ea5459010caa08e3",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17510,10 +17612,10 @@
     {
       "source": "docs/document/advanced/built-in.html",
       "route": "/document/advanced/built-in.html",
-      "sha256Lf": "172ce867c6e9be9cae181e82e798bf79d85d5019223d62b209e2c942f83b2d4c",
+      "sha256Lf": "70c42ca5bb8c524b56c7ebbb8eaf72f5be14fc41ebc5bf4ec790d0bfa7263097",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17523,10 +17625,10 @@
     {
       "source": "docs/document/advanced/class.html",
       "route": "/document/advanced/class.html",
-      "sha256Lf": "bf38af7c5748bf94a1bf1dcafbd6f23697e0cd50204d6e2509d020aa28bdcc26",
+      "sha256Lf": "9d5cd62993d6baf1300181830b2a780e2167bdcee0eeee683736c3d5b43baf24",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17536,10 +17638,10 @@
     {
       "source": "docs/document/advanced/event.html",
       "route": "/document/advanced/event.html",
-      "sha256Lf": "5a833a4b5328a35e0f5dcb19b993559321e6de2aa4d58751adc495d7d6b06d8a",
+      "sha256Lf": "a4624a2b6a7b68186ab03a4780fa795b97682ca5415c4022e56e8a36db1b49b2",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17549,10 +17651,10 @@
     {
       "source": "docs/document/advanced/global.html",
       "route": "/document/advanced/global.html",
-      "sha256Lf": "3733acaca58c75e9d8aad4b9d506f765d6b50f7e31b2043632b9f1fed52f0c06",
+      "sha256Lf": "1003ceb4ee253f71e0da816a4bded4fef25b4cab690c77273b2dd5b4ec459943",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17562,10 +17664,10 @@
     {
       "source": "docs/document/advanced/plugin.html",
       "route": "/document/advanced/plugin.html",
-      "sha256Lf": "836a34aab7f2648d9ac021e7c262ba45ed61b4a526322532ff92609cb81bf5d5",
+      "sha256Lf": "68792c9def7906427a8e47f682d1f2f55ee96e420531428622a4339a7ca18e0f",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17575,10 +17677,10 @@
     {
       "source": "docs/document/advanced/property.html",
       "route": "/document/advanced/property.html",
-      "sha256Lf": "39c16129fd8fffeea83dcc35d4fb91f2b9707c8a370be310017be3931c89eb50",
+      "sha256Lf": "0b15099f0a6c754cb05e2b5173b491960cb9e8b0b61e5c2de47589dc27d871b3",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17588,10 +17690,10 @@
     {
       "source": "docs/document/component/contextmenu.html",
       "route": "/document/component/contextmenu.html",
-      "sha256Lf": "6c4da715916004ab72d6ad9cd1b3d16c58cc3c16b433103bdd77c32afbb19af9",
+      "sha256Lf": "e6fe13021fe8e092e0c6588322c2f647bc16fff9b3f890b01398104f519cc8ce",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17601,10 +17703,10 @@
     {
       "source": "docs/document/component/controls.html",
       "route": "/document/component/controls.html",
-      "sha256Lf": "2df485cc46bb0bf30aab32ba21707e16403eadffd1c67f05e32f1b1662774c28",
+      "sha256Lf": "00134da8fcd9f14c21d0f3bc6dd1fe4a0e44f146c57d63a6db4255d0365007c6",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17614,10 +17716,10 @@
     {
       "source": "docs/document/component/layers.html",
       "route": "/document/component/layers.html",
-      "sha256Lf": "0455e8a65e52d91c4b570cb0a7a6f28327c935a5c041167ba2058cb94b892a00",
+      "sha256Lf": "9b5c25d8d9faa9a3a35815a1606ffea4a1ab127f12214ba2b5f3caac9eac2428",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17627,10 +17729,10 @@
     {
       "source": "docs/document/component/setting.html",
       "route": "/document/component/setting.html",
-      "sha256Lf": "4da033bf086aa86424a459c626f3768d17116a7c995bb13f2c0d5a929877147d",
+      "sha256Lf": "eaa3c6e752df873f6839888c5c6a163a91142697939954af61ee6526f9aab50f",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17640,10 +17742,10 @@
     {
       "source": "docs/document/en/advanced/built-in.html",
       "route": "/document/en/advanced/built-in.html",
-      "sha256Lf": "2ff6ed01ad01fe332dd01a202db0064b2d194cf975dcdd4b7f3287f6653feed1",
+      "sha256Lf": "5fc6b3db2706c3214f2e540cc5ebc46f87abbbbf9cd7770b5fe7f8ec0cdfd67b",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17653,10 +17755,10 @@
     {
       "source": "docs/document/en/advanced/class.html",
       "route": "/document/en/advanced/class.html",
-      "sha256Lf": "fb7606e487d485d5db02982d3b02cefb38bdf9ccc144a10b06beb1adf3c4ac09",
+      "sha256Lf": "ae3117b42d654f5c14d62923c7fe7198eae616895dd19885391265d5f11349fb",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17666,10 +17768,10 @@
     {
       "source": "docs/document/en/advanced/event.html",
       "route": "/document/en/advanced/event.html",
-      "sha256Lf": "04440e121d4427951e561a7759daae3928ac6d50c58ce8bca4c81d41591bb9ad",
+      "sha256Lf": "4514bf9c007728a1b9b0ec70a7c2a558754fcfafdb879901b1410fd5bc2d5b5b",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17679,10 +17781,10 @@
     {
       "source": "docs/document/en/advanced/global.html",
       "route": "/document/en/advanced/global.html",
-      "sha256Lf": "229287d5d83f834984c4877b23a9c934bcfe144e0c2ca4d3379da6020a927f52",
+      "sha256Lf": "edeb817d22b3726d8acfb3c23dd08b9aeeb64db0d8433a691f0087e05cf7b885",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17692,10 +17794,10 @@
     {
       "source": "docs/document/en/advanced/plugin.html",
       "route": "/document/en/advanced/plugin.html",
-      "sha256Lf": "82336d21ca5d5e291b0cfb59e1e0cf4d8cdf1475ddc5d924c15f2fbcbccf4e29",
+      "sha256Lf": "056784cf908fd500cf3404178916a9f104ccfa398ca2252513a6b630d813fdd0",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17705,10 +17807,10 @@
     {
       "source": "docs/document/en/advanced/property.html",
       "route": "/document/en/advanced/property.html",
-      "sha256Lf": "bfa5ea6f6b2da43af736138ee73316b9eb2a430d1ea152795ff726d4b65752de",
+      "sha256Lf": "5fb1b32907c402c28d41d137e94867bc78e21fc386004be0c91b76b4ed7a78d0",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17718,10 +17820,10 @@
     {
       "source": "docs/document/en/component/contextmenu.html",
       "route": "/document/en/component/contextmenu.html",
-      "sha256Lf": "318bfa1cc6124341c31eca2a3d305b56be15447312235e274bcac7d8f4dbbb22",
+      "sha256Lf": "5d627e52eaa6eb5e23a4e457413075da44891d86ceeca5bfc7abf82323cc565f",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17731,10 +17833,10 @@
     {
       "source": "docs/document/en/component/controls.html",
       "route": "/document/en/component/controls.html",
-      "sha256Lf": "901fdae7862dd45c79992e60d81b6c65afe8dd6e8c8b3acb1352fcaa56a5bd10",
+      "sha256Lf": "51d1d91c55ab2037dc5369f01671268147bc378f234f28d37431dd3ea10619c4",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17744,10 +17846,10 @@
     {
       "source": "docs/document/en/component/layers.html",
       "route": "/document/en/component/layers.html",
-      "sha256Lf": "3ab5d4f80f5a7d5edd85683e5a606ab0a40810d464df69c9b0d61c55e5a36c6f",
+      "sha256Lf": "db32aa21944b2fede614cb334e10e851be477db41e15d2f278984aaf78d811bb",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17757,10 +17859,10 @@
     {
       "source": "docs/document/en/component/setting.html",
       "route": "/document/en/component/setting.html",
-      "sha256Lf": "c142bc66446fd44dafb7c2de72ca8f7a16c1942a8801f94b69f84a4ab27a1e48",
+      "sha256Lf": "f93d37f4e55b63b9104db19d23036fd85834ed4912f096d37424c29cf46307ad",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17770,10 +17872,23 @@
     {
       "source": "docs/document/en/index.html",
       "route": "/document/en/",
-      "sha256Lf": "0fbd6f191738454a17aee0237e838c09b06f8695aa926fad9e131c1705814d41",
+      "sha256Lf": "87c123295fda463867a49c51100efe6f7cceba3c782f5b382ac74ab84d6e1f30",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
+        "/document/main.js",
+        "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
+      ],
+      "status": "not-run",
+      "owner": "EX-03"
+    },
+    {
+      "source": "docs/document/en/plugin/danmuku.html",
+      "route": "/document/en/plugin/danmuku.html",
+      "sha256Lf": "86621ce3fb3405c95218723fd6cbbc2cf5a6d891fb3ddb6b84c59b6b3c89e87b",
+      "kind": "generated-docs",
+      "scriptSources": [
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17783,10 +17898,10 @@
     {
       "source": "docs/document/en/start/i18n.html",
       "route": "/document/en/start/i18n.html",
-      "sha256Lf": "06d5dd102dbbafe05ca8d8cc5d968cb88fbe3b0933c7e18ca3b0cbb0f816760c",
+      "sha256Lf": "992222ce0409b150179d6a0550af3c9246d788b8f12f77f2bdb2037492657fcc",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17796,10 +17911,10 @@
     {
       "source": "docs/document/en/start/option.html",
       "route": "/document/en/start/option.html",
-      "sha256Lf": "7120aa0145aeb484115e59a55c048584dc0e50376b8b7e6feadb6fad662d6e80",
+      "sha256Lf": "0ffd030e774f314402529cf4c091b13d73d0530e0a8fb9772285cb39622ef9ec",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17809,10 +17924,10 @@
     {
       "source": "docs/document/index.html",
       "route": "/document/",
-      "sha256Lf": "c86b90d96e4aa9ece0f7f3e8e0f3cdffb2adb4e7c4bcf5655d1843fefa7cb319",
+      "sha256Lf": "d538b202da9fa5543c5e54e5fb76907e133a0d33edf273f3eb360cb0a2623160",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17822,10 +17937,10 @@
     {
       "source": "docs/document/plugin/danmuku.html",
       "route": "/document/plugin/danmuku.html",
-      "sha256Lf": "e7dde20704a5bc55bc064831e80ce1bfc6dc4525a497fd9bf57dd67166b3c82f",
+      "sha256Lf": "bbcdebc4df8b3feb86b46d565f731a72c02bf367ec00c8e893b9745693bf5db1",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17835,10 +17950,10 @@
     {
       "source": "docs/document/start/i18n.html",
       "route": "/document/start/i18n.html",
-      "sha256Lf": "6e43e29b3fbb0f1cb160a096d154380438034b769ee62251111e746b53324571",
+      "sha256Lf": "f40445700bc315b34b0d51a876d906954a302691259f66efcf3aa237f3791297",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17848,10 +17963,10 @@
     {
       "source": "docs/document/start/option.html",
       "route": "/document/start/option.html",
-      "sha256Lf": "0687d12ed7f615d232fb80bf1b342eeb4641088111a4b3fef92275b50ca590a1",
+      "sha256Lf": "9b8d61e7546ee088785c29dbf85b2f37f62e90d7b97d58ac9c934fccba46dd0f",
       "kind": "generated-docs",
       "scriptSources": [
-        "/document/assets/app.BfyKMyXg.js",
+        "/document/assets/app.CUpGwB5x.js",
         "/document/main.js",
         "https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-8579453810848662"
       ],
@@ -17981,7 +18096,9 @@
       "docs/assets/example/asr.local.js"
     ],
     "examplesRemoved": [],
-    "htmlAdded": [],
+    "htmlAdded": [
+      "docs/document/en/plugin/danmuku.html"
+    ],
     "htmlRemoved": []
   },
   "editorDeclarations": [
@@ -18135,11 +18252,11 @@
     },
     {
       "file": "scripts/projects.js",
-      "sha256Lf": "a88d5da78a0d50c4ac92a37ea5594a833b169a51d45b5442d3af4d97ffa16965"
+      "sha256Lf": "3956faff0032ab5b91daa45f390a664ca246559621f95fd2f53cef8bb8b58bdf"
     },
     {
       "file": "docs/assets/js/common.js",
-      "sha256Lf": "4ccfc0bba7093a45621e2fe0c9b48cb6da0e6101a2b87a5a0f8785611d2d98fc"
+      "sha256Lf": "63877e6800bcd9de557ac3f785500aa173bca856e6fc99ee1005810e59806c93"
     },
     {
       "file": "docs/assets/js/mobile.js",
@@ -18147,7 +18264,7 @@
     },
     {
       "file": "packages/artplayer-vitepress/docs/public/main.js",
-      "sha256Lf": "b8c9b9334abc800e12fd2b8154d89f04c580adf0a155718f2ed44e85f7fd44d7"
+      "sha256Lf": "44b388d74b23e241b534498f53b615dbf2e91be077336ed31971aa09e65a8fd4"
     },
     {
       "file": "packages/artplayer-vitepress/docs/vite.config.ts",
@@ -18155,7 +18272,7 @@
     },
     {
       "file": "packages/artplayer-vitepress/docs/.vitepress/config.js",
-      "sha256Lf": "6b43f16ad2f74dcab0e4d3b3426f36118621a7daa04a1b9547aac9c910ed4462"
+      "sha256Lf": "2363e83274e7f1cb0af335fb10a2933a65fd9eadd30a15facc844f83ef9a46a5"
     },
     {
       "file": "scripts/build-site-assets.mjs",
@@ -18175,7 +18292,7 @@
     },
     {
       "file": "scripts/editor-declarations/core.ts",
-      "sha256Lf": "0cda0fe093299099c62ae907a6f517f1cb5c49be9085d4c8fb20aed6579a0058"
+      "sha256Lf": "a5526f52c74746403aac06b47fe71ab8ea4e87f652a62abf29313dbcc2823353"
     },
     {
       "file": "scripts/editor-declarations/dependencies.ts",
@@ -18187,7 +18304,7 @@
     },
     {
       "file": "scripts/editor-declarations/plugin.ts",
-      "sha256Lf": "02dd90a19b75235ac6080aa2088114f3ae51c45567789c7daf2653be63ceee7d"
+      "sha256Lf": "5678bd5fe5d23669c734463196e2f96eaa75d891b713002e60819196e1e6dfbe"
     },
     {
       "file": "scripts/editor-declarations/syntax.ts",
@@ -18251,7 +18368,7 @@
     },
     {
       "file": "packages/artplayer-vitepress/browser/editor-host.ts",
-      "sha256Lf": "05673be0ca9aea7d890aa4cd84ab372b7d34407bd8ab674f2c0f619996586f03"
+      "sha256Lf": "4c8f657850f670528f513789dfcf798db10b6e6b0f0335ed4fbd822a09799b8a"
     },
     {
       "file": "packages/artplayer-vitepress/browser/editor-libraries.ts",
@@ -18275,7 +18392,7 @@
     },
     {
       "file": "packages/artplayer-vitepress/browser/editor.ts",
-      "sha256Lf": "e27f46bb84abc363a36a3239018168d7ec8d22fe8690cf835a2c354ce54443bd"
+      "sha256Lf": "132f6e12333aac3b54e4eea9f54469a26a9e676ea688034168c3a1ef134ba668"
     },
     {
       "file": "packages/artplayer-vitepress/browser/loader.ts",
@@ -18297,7 +18414,7 @@
     "build:i18n": "node ./scripts/build-i18n.js",
     "build:test": "node ./scripts/build-test.js",
     "build:all": "yarn ci:build && yarn lint",
-    "ci:build": "yarn build:types && yarn build all && yarn build:i18n && yarn build:ts && yarn build:llm && yarn build:test && yarn build:docs && yarn test:imports",
+    "ci:build": "yarn build:types && yarn build all && yarn build:i18n && yarn build:ts && yarn build:llm && yarn build:vconsole && yarn build:console && yarn build:site-notices && yarn build:test && yarn build:docs && yarn test:imports",
     "build:types": "node scripts/build-types.mjs --write"
   },
   "siteManifest": {
@@ -19330,13 +19447,13 @@
     },
     {
       "file": "docs/assets/js/vconsole.min.js",
-      "bytes": 282381,
-      "sha256": "671f47427e1e3048919147c765e9fb71e4ea40d79a8c2829089f499d3e9b9bf4"
+      "bytes": 283667,
+      "sha256": "3d1b8c3aff5f415ccf3bdc3cdcec6e01cff5b4c64d4558c078ca33d003f616ac"
     },
     {
       "file": "docs/assets/js/console.js",
-      "bytes": 340306,
-      "sha256": "e00bbf82bf08c452825690372ded39a9b60f4baf438f0e7ce8300e9bc4629c03"
+      "bytes": 340552,
+      "sha256": "a5f1388175fd885c03dd21b35fff97dca0b548745588dfca3172579a96537163"
     }
   ]
 }

refactor/changes/2026-09-15-SITE-DANMUKU-01-guides.md

@@ -0,0 +1,78 @@
+# SITE-DANMUKU-01 弹幕双语使用指南
+
+来源 HEAD：`520727d762d958bbc0378a04426bd885789d655b`。
+从 SITE-04 拆出不依赖 Thumbnail 历史决策的 Danmuku 文档核对，依赖已完成的
+SITE-03 和 PKG-DANMUKU-07。SITE-04 保留全部旧依赖并新增本任务；完整插件组合、
+物理设备、全站搜索和发布复盘没有改为完成。
+
+## 用户文档与准确边界
+
+新增英文独立页和侧栏入口，中文原路径与 19 个已有标题 ID 全部保留。
+中英文都覆盖配置、输入、回调、方法、状态、外部挂载、事件、热力图和类型入口。
+不是把旧文字直接翻译：逐项核对 src/index.ts、danmuku.ts、config.ts、input.ts、
+setting-send.ts、setting.ts、scheduler.ts、heatmap.ts、heatmap-geometry.ts 及 runtime-shared.d.ts。
+
+修正或补齐的具体事实：
+
+- time 缺省为 currentTime + 0.5 秒，显式 0 保留；单项颜色继承配置。
+- 工厂要求配置对象，但运行时字段均可省略；根历史声明仍要求 danmuku。
+- emit/load 返回 Promise，完成后是内部 owner；config/hide/show/reset 同步返回同一 owner。
+  owner 与 art.plugins 上的注册对象不同；入队完成不等于已显示。
+- 无参数 load 替换配置输入，带参数追加；config 不自动重载，输入读取失败与逐项过滤失败
+  的边界不同，不承诺整批原子回滚。取消加载的 Promise 仍正常结束，不发迟到事件。
+- beforeEmit 仅用于输入框且严格 true 才发送；filter 同步，不能用 Promise 做异步过滤。
+  beforeVisible 可异步，错误恢复与取消边界单独说明；三个回调的 receiver 与输入函数不同。
+- reset 不删除队列；isStop 与 isHide 不同；mount 要求有效目标，外部容器由应用清理。
+- heatmap 在初始化启用，points 配置不自动绘图；points 事件默认 x 为像素，内层数组会修改。
+  resize/load 恢复自动曲线；示例重新计算像素坐标并创建新数组。记录 issue #958 修复的范围。
+- root/legacy 继续保留 npm 5.3.0 声明，准确 /runtime 入口尚未发布；页面明确区分当前分支与 CDN。
+
+中文保留现有 13 个 Run Code 并补充热力图；修正 mount 示例误用播放器自身容器，增加外部
+容器清理和公开异步命令的 catch。visible 示例用 textContent 写文本。英文有 4 个 runnable
+示例及经过编译的类型示例。包源码、根历史声明、版本、依赖和锁文件均未改动。
+
+## 生成与维护
+
+源码在 packages/artplayer-vitepress/docs/；通过 build:site-assets、build:llm、build:docs
+更新导航路由、LLM 语料和实际 VitePress 站点，没有手工修改生成输出。
+LLM 重建还同步了此前已提交但尚未进入语料的三个输入：VAST 编辑器声明
+（e5c73fa62）、核心编辑器声明（7cf6f3313）、Canvas 示例（c3967bcbf）。逐字核对
+这三份输入与任务开始 HEAD 相同，本任务未编辑它们；生成物减少的旧声明文本是
+按当前已提交输入刷新，不是本次删除公开声明或另行完成插件任务。
+site-inventory 从 27 页更新为 28 页（中英各 14），HTML 从 36 到 37。
+build:test/check:docs-smoke 也执行通过，但其生成器排除所有 plugin/en 页面，因此输出不变；
+新 document-danmuku.spec.js 直接复用现有解析器和 readiness runner，专门执行双语弹幕示例。
+站点 README 与浏览器 README 写清维护入口、命令和验证边界。
+
+## 实际验证与失败记录
+
+Windows / Node 24.21.0 / Yarn Classic 1.22.22。
+
+- VitePress 真实构建通过，28 页清单和生成文件漂移检查通过。
+- 两份文档的原样 TS 片段分别使用 TS 5.9.3、strict、NodeNext、types: []、skipLibCheck: false
+  编译，均零诊断。静态检查双语页面所有 /document/ 本地链接和中文原有 19 个标题 ID。
+- 站点构建测试 7 项、导航和文档流程测试 17 项通过；定向 lint 通过。
+- 三引擎浏览器最终 60 通过、0 跳过、0 重试：18 个示例 × 3 的真实样本 readiness/清理，
+  加上双语导航和 Run Code × 3。本轮没有执行全部控件交互或声称完整播放/设备验收。
+
+保留首轮问题，不计作播放器缺陷：lint 首轮 1 项 import 排序错误已修正；调用构建测试时，
+直接 node 和 yarn node 都不提供脚本需要的 npm_execpath，改用既有 yarn test:site-build 后通过。
+浏览器首轮 54 通过、6 失败：Vue 客户端导航把 className 变成 class，旧测试选择器只查前者，
+站点原处理器已支持两者。测试改用两种选择器后全部通过，没有修改产品 handler。
+一次性静态核对也遇到 linkedom 属性大小写差异；改为读取实际属性名后检查成立。
+最后清理中文行尾空格并重新构建，两个页面 HTML 哈希与通过浏览器的版本相同。
+暂存源码 diff --check 通过；新英文 HTML 中 VitePress 模板生成的两行空白带有缩进，
+完整 diff --check 会报告它们。保留生成器原始输出，没有手工清理生成 HTML。
+
+命令：`yarn test:browser document-site.spec.js document-danmuku.spec.js --workers=1`、
+`yarn test:site-build`、`node --test test/site-loading.test.js test/documentation-pipeline.test.js`、
+`yarn check:site-assets`、`yarn check:llm`、`yarn check:docs-smoke`、
+`node refactor/scripts/site-inventory.mjs --check`。
+具体文件/片段/浏览器版本指纹、首轮与最终计数见
+[机器证据](../baselines/danmuku-docs-validation.json)。
+
+## 回退和剩余工作
+
+独立回退本提交会移除英文指南与导航，恢复中文指南和对应生成站点、语料、清单与测试。
+不改变播放器运行时。SITE-04 全包双语审查、SITE-05 搜索/全站验收、EX-03 完整示例和
+PKG-DANMUKU-08 组合验收仍未完成。没有推送、部署或 npm 发布。

refactor/plan.md

@@ -2,9 +2,9 @@
 
 > 由 tasks.json 生成。请修改数据后运行 `node refactor/scripts/plan.mjs --write`，不要手改本表。
 
-基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 270 项，范围 22 个包及工作区/示例。
+基线：`40fcda6a37d0049d42e49c1e64e70d4fd9ba5f7f`。总任务 271 项，范围 22 个包及工作区/示例。
 
-状态：todo 43 / doing 21 / blocked 0 / done 206 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
+状态：todo 43 / doing 21 / blocked 0 / done 207 / deferred 0。风险 L/M/H 表示兼容风险，不表示工期。
 
 前置依赖是启动条件；验收是完成条件。任务可以继续拆分，但不能复用或悄悄删除旧 ID。
 
@@ -22,7 +22,7 @@
 | artplayer-plugin-auto-thumbnail | 1.1.0 | PKG-AUTO-THUMB-01, PKG-AUTO-THUMB-02, PKG-AUTO-THUMB-03, PKG-AUTO-THUMB-04, PKG-AUTO-THUMB-05, PKG-AUTO-THUMB-06, PKG-AUTO-THUMB-07, PKG-AUTO-THUMB-08, PKG-AUTO-THUMB-09, PKG-AUTO-THUMB-10, PKG-AUTO-THUMB-11, PKG-AUTO-THUMB-12 |
 | artplayer-plugin-chapter | 1.1.0 | PILOT-01, PKG-CHAPTER-01, PKG-CHAPTER-02, PKG-CHAPTER-03, PKG-CHAPTER-04, PKG-CHAPTER-05, PKG-CHAPTER-06, PKG-CHAPTER-HOVER-01 |
 | artplayer-plugin-chromecast | 1.1.0 | PKG-CAST-01, PKG-CAST-02, PKG-CAST-03, PKG-CAST-04, PKG-CAST-05, PKG-CAST-06 |
-| artplayer-plugin-danmuku | 5.3.0 | PKG-DANMUKU-01, PKG-DANMUKU-02, PKG-DANMUKU-03, PKG-DANMUKU-04, PKG-DANMUKU-05, PKG-DANMUKU-06, PKG-DANMUKU-07, PKG-DANMUKU-08, PKG-DANMUKU-09, PKG-DANMUKU-10, PKG-DANMUKU-11, PKG-DANMUKU-12, PKG-DANMUKU-MASK-LOAD-01 |
+| artplayer-plugin-danmuku | 5.3.0 | PKG-DANMUKU-01, PKG-DANMUKU-02, PKG-DANMUKU-03, PKG-DANMUKU-04, PKG-DANMUKU-05, PKG-DANMUKU-06, PKG-DANMUKU-07, PKG-DANMUKU-08, PKG-DANMUKU-09, SITE-DANMUKU-01, PKG-DANMUKU-10, PKG-DANMUKU-11, PKG-DANMUKU-12, PKG-DANMUKU-MASK-LOAD-01 |
 | artplayer-plugin-danmuku-mask | 1.1.0 | PKG-MASK-01, PKG-MASK-02, PKG-MASK-03, PKG-MASK-04, PKG-MASK-05, PKG-MASK-06, ENG-LINT-01, PKG-DANMUKU-MASK-LOAD-01 |
 | artplayer-plugin-dash-control | 1.1.0 | PKG-DASH-01, PKG-DASH-02, PKG-DASH-03, PKG-DASH-04, PKG-DASH-SEEK-01, PKG-DASH-MENU-01, PKG-DASH-05, PKG-DASH-06, PKG-DASH-CLEANUP-01 |
 | artplayer-plugin-document-pip | 1.1.0 | PKG-DPIP-01, PKG-DPIP-02, PKG-DPIP-03, PKG-DPIP-04, PKG-DPIP-05, PKG-DPIP-06 |
@@ -35,7 +35,7 @@
 | artplayer-proxy-mediabunny | 1.2.0 | PKG-MB-01, PKG-MB-02, PKG-MB-03, PKG-MB-04, PKG-MB-05, PKG-MB-06, PKG-MB-07, PKG-MB-08, PKG-MB-09, PKG-MB-10 |
 | artplayer-tool-iframe | 1.1.0 | PKG-IFRAME-01, PKG-IFRAME-02, PKG-IFRAME-03, PKG-IFRAME-04, PKG-IFRAME-05, PKG-IFRAME-06 |
 | artplayer-tool-thumbnail | 4.4.0 | PKG-TOOL-THUMB-01, PKG-TOOL-THUMB-02, PKG-TOOL-THUMB-03, PKG-TOOL-THUMB-04, PKG-TOOL-THUMB-05, PKG-TOOL-THUMB-06, PKG-TOOL-THUMB-07 |
-| artplayer-vitepress | 1.1.0 | SITE-01, SITE-SMOKE-01, SITE-02, SITE-LOAD-01, SITE-AI-DOCS-01, SITE-BUILD-01, SITE-03, SITE-04, SITE-05, SITE-06, SITE-07, SITE-VCONSOLE-01, ENG-LINT-02, SITE-CONSOLE-01 |
+| artplayer-vitepress | 1.1.0 | SITE-01, SITE-SMOKE-01, SITE-02, SITE-LOAD-01, SITE-AI-DOCS-01, SITE-BUILD-01, SITE-03, SITE-DANMUKU-01, SITE-04, SITE-05, SITE-06, SITE-07, SITE-VCONSOLE-01, ENG-LINT-02, SITE-CONSOLE-01 |
 
 ## 0 规划
 
@@ -407,7 +407,8 @@
 | SITE-AI-DOCS-01 | artplayer-vitepress, workspace<br>重构可复现 LLM 文档与安全翻译草稿流程 | SITE-LOAD-01, SITE-02 | TS 离线文档聚合、显式远程翻译、草稿校验和可回退应用，保留命令与目标路径 | 默认不读密钥/调用网络；LLM 内容可复现并保留来源；旧翻译破坏性行为有复现；错误/限流/超时/结构损坏/过期/路径越界拒绝且英文文档不丢失；未执行付费翻译不计服务验收 | M | done |
 | SITE-BUILD-01 | artplayer, artplayer-vitepress, workspace<br>重构 i18n 与文档构建的暂存、替换和 Yarn 编排 | SITE-AI-DOCS-01 | 严格 TS 构建模块、编译后替换产物与失败回退，固定 Yarn 子进程和旧构建入口 | 旧 i18n 删除后失败有复现；失败不改变既有产物；语言集合、UMD/ESM/历史别名兼容；文档子进程退出码准确并完成真实 VitePress 构建；不隐式翻译、不修改播放器 API | M | done |
 | SITE-03 | artplayer-vitepress<br>整理 i18n/文档/LLM 生成流程 | SITE-02, SITE-LOAD-01, SITE-AI-DOCS-01, SITE-BUILD-01 | build-i18n/build-docs/build-llm/trans-docs 的任务边界和错误处理；桌面 common.js 自有 UI 的 TS 迁移与模块拆分 | 原命令兼容、生成可复现，翻译步骤不隐式运行远程服务；覆盖移动 loader 失败恢复 define、脚本依赖顺序、localhost/127.0.0.1 Run Code 目标和语言重定向；桌面剩余 UI 完成 TS 职责拆分并回归运行、导入与持久设置 | M | done |
-| SITE-04 | artplayer-vitepress<br>交叉核对逐包持续维护的文档 | CORE-21, SITE-03, PKG-CHAPTER-04, PKG-AMBILIGHT-04, PKG-AUDIO-04, PKG-AUTO-THUMB-04, PKG-VTT-THUMB-04, PKG-HLS-04, PKG-DASH-04, PKG-MULTI-SUB-04, PKG-JASSUB-04, PKG-MASK-04, PKG-ASR-04, PKG-ADS-04, PKG-VAST-04, PKG-CAST-04, PKG-DPIP-04, PKG-CANVAS-04, PKG-IFRAME-04, PKG-TOOL-THUMB-04, PKG-DANMUKU-06, PKG-MB-08 | 已随实现更新的中文/英文 API、包内实现地图、旧 JS 示例及已知能力限制的全包核对 | 未把缺环境的能力写成已验证，静态核对不等待设备任务；最终 demo 仍由 EX-03 验收；按 SITE-01 声明成员/候选标题清单逐项语义核对，补齐缺失的双语插件说明和 Danmuku 英文入口 | M | todo |
+| SITE-DANMUKU-01 | artplayer-vitepress, artplayer-plugin-danmuku<br>核对弹幕双语指南并补齐英文入口 | SITE-03, PKG-DANMUKU-07 | 按实现修正中文调用说明，新增英文完整选项/API/热力图/类型指南和导航；同步生成站点与LLM资料，新增双语示例浏览器验收 | 旧中文URL和标题保留；实际方法返回、加载语义、回调与points边界准确；双语页面、Run Code及示例实测，完整插件组合和设备验收不冒充完成 | L | done |
+| SITE-04 | artplayer-vitepress<br>交叉核对逐包持续维护的文档 | CORE-21, SITE-03, PKG-CHAPTER-04, PKG-AMBILIGHT-04, PKG-AUDIO-04, PKG-AUTO-THUMB-04, PKG-VTT-THUMB-04, PKG-HLS-04, PKG-DASH-04, PKG-MULTI-SUB-04, PKG-JASSUB-04, PKG-MASK-04, PKG-ASR-04, PKG-ADS-04, PKG-VAST-04, PKG-CAST-04, PKG-DPIP-04, PKG-CANVAS-04, PKG-IFRAME-04, PKG-TOOL-THUMB-04, PKG-DANMUKU-06, PKG-MB-08, SITE-DANMUKU-01 | 已随实现更新的中文/英文 API、包内实现地图、旧 JS 示例及已知能力限制的全包核对 | 未把缺环境的能力写成已验证，静态核对不等待设备任务；最终 demo 仍由 EX-03 验收；按 SITE-01 声明成员/候选标题清单逐项语义核对，补齐缺失的双语插件说明和 Danmuku 英文入口 | M | todo |
 | SITE-05 | artplayer-vitepress<br>构建文档站和验证链接/示例 | SITE-04, EX-01, EX-02, SITE-07, SITE-VCONSOLE-01, SITE-CONSOLE-01 | VitePress 构建、链接与嵌入 demo 检查 | 文档构建、链接、嵌入路径与声明注入通过；真实完整 demo 保留 EX-03 独立门槛；核对 ENG-PM-01 登记的搜索 peer 范围和真实搜索行为 | M | todo |
 | SITE-06 | artplayer-vitepress<br>文档站交付验收 | SITE-05 | 维护指南和站点变更记录 | 未手改 generated 目录，旧 URL 可用、部署与检查分离 | M | todo |
 | SITE-07 | artplayer-vitepress, workspace<br>整理站点第三方资产与来源说明 | SITE-01 | Monaco/vConsole/console bundle/字体和样本的冻结来源、可复现构建或替代与站点 notices | 接续 SITE-01 的字节与换行差异证据；完整许可随实际分发，consoleLog/global/CSS/worker 与旧 URL 兼容；缺字体/媒体使用依据明确处置；资产变更后执行编辑器/移动/字幕/示例回归，不以来源指纹替代授权或运行证据 | H | doing |
@@ -659,6 +660,7 @@
 - SITE-AI-DOCS-01: [记录](changes/2026-09-14-SITE-AI-DOCS-01-documentation-pipeline.md) [记录](baselines/documentation-pipeline-validation.json)
 - SITE-BUILD-01: [记录](changes/2026-09-14-SITE-BUILD-01-staged-builds.md) [记录](baselines/site-build-validation.json)
 - SITE-03: [记录](changes/2026-09-14-SITE-03-desktop-editor.md) [记录](baselines/site-editor-validation.json)
+- SITE-DANMUKU-01: [记录](changes/2026-09-15-SITE-DANMUKU-01-guides.md) [记录](baselines/danmuku-docs-validation.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)
 - 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,21 @@
 # 进度与证据
 
+## SITE-DANMUKU-01 双语指南和示例验证
+
+新增 Danmuku 英文指南/侧栏，按源码修正中文 Promise/owner、加载、回调、mount、
+reset、heatmap/points 与旧类型说明，保留旧中文路径和19个标题ID。明确 /runtime 与
+本轮修复尚未发布；CDN仍加载旧版本。站点现为28页，中英各14页。
+
+两个TS片段strict NodeNext零诊断，站点工具7+17项通过；三引擎60项通过无跳过，
+覆盖18个示例的真实样本ready/清理及双语导航/Run Code，不代表完整播放和设备验收。
+首轮54通过6失败来自Vue导航后的测试选择器，修正后全部通过，保留失败证据。
+生成站点、LLM、浏览器路由与清单同步；插件运行时/历史类型/依赖/版本不变。
+详见[记录](changes/2026-09-15-SITE-DANMUKU-01-guides.md)与[证据](baselines/danmuku-docs-validation.json)。
+
+SITE-04保留原依赖，其他包双语与最终验收继续未完成；207 done、21 doing、43 todo，
+共271项。没有推送、部署或发布。
+
+
 ## CI-NPM-01 精确候选的本地交付准备
 
 新增严格 TS 准备模块和 yarn release:bundle：干净 Git 状态、两次完整准入读取、

refactor/site-inventory.md

@@ -50,14 +50,15 @@ SITE-AI-DOCS-01/SITE-BUILD-01 已落实生成、翻译草稿和暂存构建；SI
 
 SITE-01 在 `d62ab13a35c756ea567c426d4fbe00d893dd7e2b` 后核对当前源码。
 可重跑清单见 [site-inventory.json](baselines/site-inventory.json)；它登记
-22 包、27 Markdown、30 示例、36 HTML、963 条声明成员和 204 个资产指纹。
+初始 22 包、27 Markdown、30 示例、36 HTML、963 条声明成员和 204 个资产指纹。
+SITE-DANMUKU-01 增加英文指南后，当前清单为 28 Markdown、37 HTML，其余数量不变。
 成员统计包括继承接口、重载和 runtime 声明，不能当作 963 个不同公开 API。
 标题匹配只是人工核对的候选位置；所有成员均明确交由 SITE-04 检查语义和中英文说明。
 
 ## 页面与内容责任
 
-- 中文 14 页、英文 13 页；核心安装、选项、i18n、四类组件、六类高级说明有对应页面。
-- Danmuku 有中文独立页，缺英文页；其余 15 插件使用包 README 和编辑器链接，缺独立双语指南。
+- 当前中文 14 页、英文 14 页；核心安装、选项、i18n、四类组件、六类高级说明有对应页面。
+- Danmuku 已补齐双语独立页和导航（SITE-DANMUKU-01）；其余 15 插件使用包 README 和编辑器链接，仍缺独立双语指南。
 - 2 proxy、2 tool 有包 README 和示例。包内维护文档不等于站点双语使用文档。
 - 清单逐包列出 README、ARCHITECTURE、菜单引用和示例；SITE-04 负责补充双语入口及缺失说明，
   不要求为了统一形式机械复制 20 份 README。SITE-05 验证实际生成页面和链接。

refactor/tasks.json

@@ -4412,6 +4412,27 @@
         "baselines/site-editor-validation.json"
       ]
     },
+    {
+      "id": "SITE-DANMUKU-01",
+      "phase": "6 文档与消费者",
+      "title": "核对弹幕双语指南并补齐英文入口",
+      "scope": [
+        "artplayer-vitepress",
+        "artplayer-plugin-danmuku"
+      ],
+      "dependsOn": [
+        "SITE-03",
+        "PKG-DANMUKU-07"
+      ],
+      "status": "done",
+      "risk": "L",
+      "deliverable": "按实现修正中文调用说明，新增英文完整选项/API/热力图/类型指南和导航；同步生成站点与LLM资料，新增双语示例浏览器验收",
+      "acceptance": "旧中文URL和标题保留；实际方法返回、加载语义、回调与points边界准确；双语页面、Run Code及示例实测，完整插件组合和设备验收不冒充完成",
+      "evidence": [
+        "changes/2026-09-15-SITE-DANMUKU-01-guides.md",
+        "baselines/danmuku-docs-validation.json"
+      ]
+    },
     {
       "id": "SITE-04",
       "phase": "6 文档与消费者",
@@ -4441,7 +4462,8 @@
         "PKG-IFRAME-04",
         "PKG-TOOL-THUMB-04",
         "PKG-DANMUKU-06",
-        "PKG-MB-08"
+        "PKG-MB-08",
+        "SITE-DANMUKU-01"
       ],
       "status": "todo",
       "risk": "M",