docs(core): [SITE-04] document CSS variables and theme behavior

2026-10-19 03:11:20 -08:00 · 2026-09-16 08:27:47 +08:00
1 parent 24011ea266
commit cec5049c40
@@ -0,0 +1,38 @@
+# SITE-04 CSS 变量与主题接口
+
+起点：`24011ea26678ab7b52f9d10b3fd589f388a6a0cc`。继续实施期内容核对，
+SITE-04 保持 doing，不进入用户保留的正式复盘。
+
+双语实例属性指南新增 43 个 CSS 变量的默认值、使用位置、模式覆盖与布局归属，
+以及 cssVar/theme 的真实读写行为。根类型的数字返回/9999 字面量、数字零触发
+读取、字符串零执行写入、行内覆盖移除和配置对象不回写都明确区分。保留已有
+API、声明、样式和运行时，不因文档核对改变用户视觉效果。
+
+逐文件核对确认 42 个声明变量有 CSS 消费者；--art-mini-progress-height 仅保留
+声明和 2px 默认值，核心没有读取它。--art-controls-height 是布局观察器写入的
+内部测量值，不把它冒充已有的声明输入。移动端和全屏类的变化记录为样式规则，
+不当作设备能力承诺。
+
+新增 48 条映射（43 个变量、根/runtime cssVar/theme 的五条声明记录），累计
+768/963，195 条仍待核对。以前分组的源码和指南哈希全部保持一致。原有 94 个
+Run Code 片段逐字不变，新增两份严格 TS 样例。
+
+Node 24.21.0 / Yarn 1.22.22 下，最终 47 项相关测试通过，0 失败/跳过，
+1594.0244ms。最终 VitePress 9.06 秒，Yarn 整体 10.65 秒；LLM 生成/检查、
+inventory 和 demo 检查通过。两份 strict/NodeNext 样例及 94 个既有片段的语法/
+内容比对通过。
+
+Chromium 153.0.8010.12、Firefox 155.0、WebKit 26.6 各 83 项断言通过，其中
+43 项是基础值、8 项是模拟移动端类的默认值比对，不称为 83 个独立交互场景。
+其余验证字符串/零值、实例隔离、主题消费、样式层叠、控制栏测量、网页全屏
+及闲置变量无效果。六组双语页面检查与 12 次 cssVar/theme 示例转发通过；
+中文说明和变量表截图已目视检查。无原生全屏、真机或全量示例验收结论。
+
+验证中保留并纠正三项过程问题：LLM 产物未同步导致文档测试失败，生成后重跑；
+新 TS 样例漏处理 $player 可空性，改为空值安全访问后重建；浏览器断言把压缩
+CSS 的 .75 写死成 0.75，对照证明未操作实例仍保持 .75，改为比较写入前后
+实际值。没有修改生产类型、放宽零值/隔离行为断言或覆盖失败日志。
+
+证据与输入哈希见[报告](../baselines/site04-css.json)。当前隔离 8083 服务用于
+浏览器验证，旧 8082 未改动。21 库候选 build 仍有效，其他发布门槛保留。
+未推送或发布；回退本提交仅恢复文档、映射及生成内容。继续剩余播放/实例接口。
@@ -3,13 +3,13 @@
  "task": "SITE-04",
  "inventory": {
    "path": "refactor/baselines/site-inventory.json",
-    "sha256": "9a444c8db60f47c9d12ac6d183d3aff88e1f088072927ce967cca77a8356b24e"
+    "sha256": "e478cd552039ff1fd4f089c4c4a94ad5fd59d47e7ba57df98f214ce0aefe5d78"
  },
-  "reviewedAt": "2026-09-16T00:12:40.060Z",
+  "reviewedAt": "2026-09-16T00:26:27.419Z",
  "counts": {
    "inventoryRecords": 963,
-    "reviewedRecords": 720,
-    "unreviewedRecords": 243
+    "reviewedRecords": 768,
+    "unreviewedRecords": 195
  },
  "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": [
@@ -6746,6 +6746,548 @@
        }
      ],
      "evidence": "baselines/site04-options.json"
+    },
+    {
+      "id": "css-variables-theme",
+      "status": "semantic-reviewed",
+      "conclusion": "43 historical CSS variables with base defaults, actual consumers and mobile/fullscreen overrides; mini-progress-height is retained but unused. cssVar/theme read computed strings and write only truthy values, numeric-zero/read and string-zero/write distinction, removal through native style API, legacy numeric/9999 types versus runtime signatures. Instance-local cascade, unchanged option snapshots, initial theme precedence, internal measured controls height and platform limitations. No runtime or CSS behavior changed.",
+      "records": [
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-theme@2",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-theme",
+          "line": 2
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-font-color@3",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-font-color",
+          "line": 3
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-background-color@4",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-background-color",
+          "line": 4
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-text-shadow-color@5",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-text-shadow-color",
+          "line": 5
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-transition-duration@6",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-transition-duration",
+          "line": 6
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-padding@7",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-padding",
+          "line": 7
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-border-radius@8",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-border-radius",
+          "line": 8
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-progress-height@9",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-progress-height",
+          "line": 9
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-progress-color@10",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-progress-color",
+          "line": 10
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-progress-top-gap@11",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-progress-top-gap",
+          "line": 11
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-hover-color@12",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-hover-color",
+          "line": 12
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-loaded-color@13",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-loaded-color",
+          "line": 13
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-state-size@14",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-state-size",
+          "line": 14
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-state-opacity@15",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-state-opacity",
+          "line": 15
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-bottom-height@16",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-bottom-height",
+          "line": 16
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-bottom-offset@17",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-bottom-offset",
+          "line": 17
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-bottom-gap@18",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-bottom-gap",
+          "line": 18
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-highlight-width@19",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-highlight-width",
+          "line": 19
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-highlight-color@20",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-highlight-color",
+          "line": 20
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-control-height@21",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-control-height",
+          "line": 21
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-control-opacity@22",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-control-opacity",
+          "line": 22
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-control-icon-size@23",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-control-icon-size",
+          "line": 23
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-control-icon-scale@24",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-control-icon-scale",
+          "line": 24
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-volume-height@25",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-volume-height",
+          "line": 25
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-volume-handle-size@26",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-volume-handle-size",
+          "line": 26
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-lock-size@27",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-lock-size",
+          "line": 27
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-indicator-scale@28",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-indicator-scale",
+          "line": 28
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-indicator-size@29",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-indicator-size",
+          "line": 29
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-fullscreen-web-index@30",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-fullscreen-web-index",
+          "line": 30
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-settings-icon-size@31",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-settings-icon-size",
+          "line": 31
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-settings-max-height@32",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-settings-max-height",
+          "line": 32
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-selector-max-height@33",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-selector-max-height",
+          "line": 33
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-contextmenus-min-width@34",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-contextmenus-min-width",
+          "line": 34
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-subtitle-font-size@35",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-subtitle-font-size",
+          "line": 35
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-subtitle-gap@36",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-subtitle-gap",
+          "line": 36
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-subtitle-bottom@37",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-subtitle-bottom",
+          "line": 37
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-subtitle-border@38",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-subtitle-border",
+          "line": 38
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-widget-background@39",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-widget-background",
+          "line": 39
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-tip-background@40",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-tip-background",
+          "line": 40
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-scrollbar-size@41",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-scrollbar-size",
+          "line": 41
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-scrollbar-background@42",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-scrollbar-background",
+          "line": 42
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-scrollbar-background-hover@43",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-scrollbar-background-hover",
+          "line": 43
+        },
+        {
+          "id": "packages/artplayer/public/cssVar.ts#CssVar.--art-mini-progress-height@44",
+          "file": "packages/artplayer/public/cssVar.ts",
+          "declaration": "CssVar",
+          "name": "--art-mini-progress-height",
+          "line": 44
+        },
+        {
+          "id": "packages/artplayer/public/player.ts#Player.theme@79",
+          "file": "packages/artplayer/public/player.ts",
+          "declaration": "Player",
+          "name": "theme",
+          "line": 79
+        },
+        {
+          "id": "packages/artplayer/public/player.ts#Player.theme@80",
+          "file": "packages/artplayer/public/player.ts",
+          "declaration": "Player",
+          "name": "theme",
+          "line": 80
+        },
+        {
+          "id": "packages/artplayer/public/player.ts#Player.cssVar@100",
+          "file": "packages/artplayer/public/player.ts",
+          "declaration": "Player",
+          "name": "cssVar",
+          "line": 100
+        },
+        {
+          "id": "packages/artplayer/public/runtime/player.ts#Player.theme@42",
+          "file": "packages/artplayer/public/runtime/player.ts",
+          "declaration": "Player",
+          "name": "theme",
+          "line": 42
+        },
+        {
+          "id": "packages/artplayer/public/runtime/player.ts#Player.cssVar@74",
+          "file": "packages/artplayer/public/runtime/player.ts",
+          "declaration": "Player",
+          "name": "cssVar",
+          "line": 74
+        }
+      ],
+      "sources": [
+        {
+          "path": "packages/artplayer/src/player/cssVarMix.ts",
+          "sha256": "0d023f28b7a8b4c1a5e2c4dd5672ef4294c86bce0013babd9d52efa32a443b2a"
+        },
+        {
+          "path": "packages/artplayer/src/player/themeMix.ts",
+          "sha256": "5bf11bcf8b77cd5d5f2970bc3edcee315c693c1be3d567770d5107a5951cb48f"
+        },
+        {
+          "path": "packages/artplayer/src/player/optionInit.ts",
+          "sha256": "7c1c47679ee6201d0e0d203fc7b449a09309e7b24a0a1099ad259a70fc1b1a35"
+        },
+        {
+          "path": "packages/artplayer/src/control/layout.ts",
+          "sha256": "72e0b95bc632561e97569d789b76d16f36edd94eac8c62ba9e1918c9a222d328"
+        },
+        {
+          "path": "packages/artplayer/src/style/index.ts",
+          "sha256": "856afc037ffcd4d18c4b54901ddbb30e310014553fe9d19560e34fb54b8378c1"
+        },
+        {
+          "path": "packages/artplayer/src/style/inject.ts",
+          "sha256": "9cddbe51b5de0da74f27c045ab982b509c3854cc6b81eeb02a6b974914760a4d"
+        },
+        {
+          "path": "packages/artplayer/public/cssVar.ts",
+          "sha256": "e027d82fb4f01c9ce7559cf679b2d5ee1962d3f7e5b4dd64ca21f472b933efb6"
+        },
+        {
+          "path": "packages/artplayer/public/player.ts",
+          "sha256": "f1e50257df2ea592d0a0e1f36078dda77eaf2cf3b3d795307501396562d99f28"
+        },
+        {
+          "path": "packages/artplayer/public/runtime/player.ts",
+          "sha256": "a4a24794e26cfb9e4310bf0f459a7a407e85bf81b4f3a4feb6294331af8036fb"
+        },
+        {
+          "path": "packages/artplayer/src/style/accessibility.less",
+          "sha256": "eb9cfe282c64a059d2e102280750bcd33ac33726fa09042eb9875f534335efef"
+        },
+        {
+          "path": "packages/artplayer/src/style/artplayer.less",
+          "sha256": "4e8513138d5d10c05b66986977d24ed17f1de3c0df3816dec6d90db7a97b5da3"
+        },
+        {
+          "path": "packages/artplayer/src/style/aspectRatio.less",
+          "sha256": "091931a0cdc83e65a669332811ef3276b85bca9e55f7fff42aa46893d728c1ef"
+        },
+        {
+          "path": "packages/artplayer/src/style/backdrop.less",
+          "sha256": "6c2cd0fa200d1f3525df98c3c56dbdc553445724aece3feb0386949245813343"
+        },
+        {
+          "path": "packages/artplayer/src/style/bottom.less",
+          "sha256": "6fb307d8449fd04b804d5e72ea0f175f8aa9c9dd2bf1efbf756f800b39ac97ab"
+        },
+        {
+          "path": "packages/artplayer/src/style/contextmenu.less",
+          "sha256": "70f6c7e26dc96652b659c7bf6fdad92737ed477dea69d253c57dc7266c76586d"
+        },
+        {
+          "path": "packages/artplayer/src/style/controls.less",
+          "sha256": "eb6d4bf4e4ff903d724d45f3ff60f0cf10c02e622fba195555a8179100cdce87"
+        },
+        {
+          "path": "packages/artplayer/src/style/danmuku.less",
+          "sha256": "e4215ee9fa2f1d0599e7311a2415cc975138265b7c6af0448d27d21b6c9e3511"
+        },
+        {
+          "path": "packages/artplayer/src/style/flip.less",
+          "sha256": "5d3c7a81df9be455c2f683ebf48f39597d218dc2144addacb72ee1736bac3b7f"
+        },
+        {
+          "path": "packages/artplayer/src/style/fullscreen.less",
+          "sha256": "dd350d3a0fc556d59b622a53c786b8c2a583e8fb28176e4b9e91baff90479496"
+        },
+        {
+          "path": "packages/artplayer/src/style/fullscreenWeb.less",
+          "sha256": "d74e785c2fbbb2976e131620e751326f622f2916eceff9f2333059ca3296cdc9"
+        },
+        {
+          "path": "packages/artplayer/src/style/hideCursor.less",
+          "sha256": "09a4607c8b0005dc199828172aa8dda395f861e407769b9696d793476c4a7823"
+        },
+        {
+          "path": "packages/artplayer/src/style/hint.less",
+          "sha256": "ae9f3115dfdb1e2d7b8249497c080e6a25f9667f915f6e89820338d67bbc2d85"
+        },
+        {
+          "path": "packages/artplayer/src/style/icon.less",
+          "sha256": "52d8f75c1d193e6160f57ca6997c3f9135adad8eb2338ed60c1eb8e5fe443be5"
+        },
+        {
+          "path": "packages/artplayer/src/style/index.less",
+          "sha256": "7fece0bc5b5a106d051eb80152d5e4558f2e73953c4c33175aa901b9695be61b"
+        },
+        {
+          "path": "packages/artplayer/src/style/info.less",
+          "sha256": "fa56d1b8c8936218e581b2426026e4ba85cd5fea20d045c4f69aca96be4059be"
+        },
+        {
+          "path": "packages/artplayer/src/style/layers.less",
+          "sha256": "9653c581190bb22d60a706109819cd010908898740701c9526957b5682991c5f"
+        },
+        {
+          "path": "packages/artplayer/src/style/loading.less",
+          "sha256": "185b0f05274196ba71fdb1d088b55af568f3342a495490c99c3f0e058a40659e"
+        },
+        {
+          "path": "packages/artplayer/src/style/mask.less",
+          "sha256": "d1239a171b71ea6184cb4aee6660d74d6ffc0c48f7c47c3cf5fbe52d2e93ac92"
+        },
+        {
+          "path": "packages/artplayer/src/style/mini.less",
+          "sha256": "8be782a3054154ab908b1cce650b6131330cf0f0e936b749accb4b2dfe605a27"
+        },
+        {
+          "path": "packages/artplayer/src/style/mixins.less",
+          "sha256": "c6be95aa682f266749fe37cb89796fbec6488abc537174f817da79bdac6e00b5"
+        },
+        {
+          "path": "packages/artplayer/src/style/mobile.less",
+          "sha256": "ff3f64fca5d2dd7ddd50385d88d9b2fa1a645909488ab7a0978ba4f1670b7c0e"
+        },
+        {
+          "path": "packages/artplayer/src/style/notice.less",
+          "sha256": "72a935c0effc557a9d7ab3baccb2c3b77fc3a1783450b4e3178a40a5325fe369"
+        },
+        {
+          "path": "packages/artplayer/src/style/plugins.less",
+          "sha256": "ea345094ea5708dd3a3c290f357dbb301b38af35464d213c47e3ec6c60eaadca"
+        },
+        {
+          "path": "packages/artplayer/src/style/poster.less",
+          "sha256": "36b38fe138f8c9537ff4e93f7ec4f2dbdba1ec41d243d741ddf1da7c6581e546"
+        },
+        {
+          "path": "packages/artplayer/src/style/progress.less",
+          "sha256": "59b9d95d49dbcb1be40752d7086239b6de5925b0574da231199d999e22ff4990"
+        },
+        {
+          "path": "packages/artplayer/src/style/selector.less",
+          "sha256": "44585c6b0179e34d21eeefce6d3494faacc0e9d108079426876e8847fd441513"
+        },
+        {
+          "path": "packages/artplayer/src/style/setting.less",
+          "sha256": "5618eb443ab6368bc4a18e9a379ce6552629555cdca6074e753aa6fd7baf9bf9"
+        },
+        {
+          "path": "packages/artplayer/src/style/subtitle.less",
+          "sha256": "273cacb63ec0214ba434dcf19a4a455dbbdd408fb2d1749de4878804c1371e41"
+        },
+        {
+          "path": "packages/artplayer/src/style/variables.less",
+          "sha256": "703739b2bdfc77bfde063d8788ef6b6a55b8730764baae8e7d755b7c54d8ecc7"
+        },
+        {
+          "path": "packages/artplayer/src/style/video.less",
+          "sha256": "b89c6f6e27592d49825c68c9ab98d46e81cb1e5add855863f89d19637f98e35f"
+        },
+        {
+          "path": "packages/artplayer/src/style/volume.less",
+          "sha256": "6e99bbe0dbcb40667ef99789b65812dc9c94ce8a1071c00d2edec5eba041c434"
+        }
+      ],
+      "docs": [
+        {
+          "path": "packages/artplayer-vitepress/docs/advanced/property.md",
+          "sha256": "a3c53867cd8b43b517d19bad61893606791cef967ce9e953e3a6ffe67371093e",
+          "anchor": "css-variable-contract"
+        },
+        {
+          "path": "packages/artplayer-vitepress/docs/advanced/property.md",
+          "sha256": "a3c53867cd8b43b517d19bad61893606791cef967ce9e953e3a6ffe67371093e",
+          "anchor": "css-variable-defaults"
+        },
+        {
+          "path": "packages/artplayer-vitepress/docs/advanced/property.md",
+          "sha256": "a3c53867cd8b43b517d19bad61893606791cef967ce9e953e3a6ffe67371093e",
+          "anchor": "css-variable-modes"
+        },
+        {
+          "path": "packages/artplayer-vitepress/docs/en/advanced/property.md",
+          "sha256": "bec5fe09633dfc4d35739f70d46303e73fd5befd62f123ba81d4799c8dae55a8",
+          "anchor": "css-variable-contract"
+        },
+        {
+          "path": "packages/artplayer-vitepress/docs/en/advanced/property.md",
+          "sha256": "bec5fe09633dfc4d35739f70d46303e73fd5befd62f123ba81d4799c8dae55a8",
+          "anchor": "css-variable-defaults"
+        },
+        {
+          "path": "packages/artplayer-vitepress/docs/en/advanced/property.md",
+          "sha256": "bec5fe09633dfc4d35739f70d46303e73fd5befd62f123ba81d4799c8dae55a8",
+          "anchor": "css-variable-modes"
+        }
+      ],
+      "evidence": "baselines/site04-css.json"
    }
  ]
 }
@@ -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) [记录](baselines/site04-subtitle.json) [记录](changes/2026-09-16-SITE-04-subtitle.md) [记录](baselines/site04-utils.json) [记录](changes/2026-09-16-SITE-04-utils.md) [记录](baselines/site04-globals.json) [记录](changes/2026-09-16-SITE-04-globals.md) [记录](baselines/site04-events.json) [记录](changes/2026-09-16-SITE-04-events.md) [记录](baselines/site04-options.json) [记录](changes/2026-09-16-SITE-04-options.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) [记录](baselines/site04-utils.json) [记录](changes/2026-09-16-SITE-04-utils.md) [记录](baselines/site04-globals.json) [记录](changes/2026-09-16-SITE-04-globals.md) [记录](baselines/site04-events.json) [记录](changes/2026-09-16-SITE-04-events.md) [记录](baselines/site04-options.json) [记录](changes/2026-09-16-SITE-04-options.md) [记录](baselines/site04-css.json) [记录](changes/2026-09-16-SITE-04-css.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)
@@ -1,5 +1,14 @@
 # 进度与证据

+## SITE-04 CSS 变量与主题接口
+
+补齐43个CSS变量的默认值、实际用途与模式覆盖，明确cssVar/theme读写及历史类型
+边界；新增48条映射，累计768/963，195条待核对。47项测试、两份严格TS、六组
+页面/12次转发与三浏览器各83项断言通过（含51项默认值比对），见
+[记录](changes/2026-09-16-SITE-04-css.md)与[证据](baselines/site04-css.json)。
+94个既有示例及运行时不变，21库build有效。SITE-04继续doing，224/22/39不变；
+继续播放与实例接口，不进入正式复盘。
+
 ## SITE-04 构造配置与初始化边界

 新增双语默认值、合并归属、覆盖顺序、平台开关和分阶段回调说明，纠正缩略图/
@@ -128,6 +128,12 @@ build有效；移动端/SDK/播放验收仍不由此覆盖。
 构造断言通过，见[证据](baselines/site04-options.json)。使用当前服务的隔离端口，
 不把桌面构造验证算作手机手势、SDK或完整媒体验收。

+CSS变量与theme随后新增48条映射，累计768条、195条待核对。43个默认值与实际
+消费者逐项对应，明确闲置mini-progress-height与内部测量controls-height的边界。
+47项测试、两份TS、六组页面/12次转发与三浏览器各83项断言通过，其中51项为
+默认值比对，见[证据](baselines/site04-css.json)。原94个示例、样式和运行时不变，
+模拟移动端CSS类与网页全屏不代替真实移动设备或原生全屏验收。
+
 - 核心：依据 site-inventory.json 的 963 条成员逐项或按明确的共享声明分组核对；
  必须记录对应文档及语义结论，不能仅按同名标题匹配标为通过。
 - Danmuku、HLS、DASH、Audio、VTT 的当前声明/源码语义已补核对；既有媒体报告
@@ -4593,7 +4593,9 @@
        "baselines/site04-events.json",
        "changes/2026-09-16-SITE-04-events.md",
        "baselines/site04-options.json",
-        "changes/2026-09-16-SITE-04-options.md"
+        "changes/2026-09-16-SITE-04-options.md",
+        "baselines/site04-css.json",
+        "changes/2026-09-16-SITE-04-css.md"
      ]
    },
    {