dsh-theme-palette 1.9.10 → 1.11.0

package/CHANGELOG.md

@@ -4,6 +4,34 @@
 
 ## 版本一览
 
+### 1.11.0
+2026-10-27 全量审计（评分 89/100，报告见 [`AUDIT-2026-10-27.md`](AUDIT-2026-10-27.md)）的 12 条问题全部修订。两条 P1 都是门面级小修；审计里有一处**自我修正**也如实落地：取色拖动的性能问题经实测降级为防御性优化。
+
+- **npm 包内 README 截图修复（P1-1）**：`files` 此前不含 `assets/`，npmjs.com 上 README 的 4 张截图全部 404。现已入包（包体 140KB → 436KB）。选「打进包」而非「绝对 GitHub URL」：自包含、不依赖仓库地址、npm 与镜像双兼容。
+- **界面语言回退改 en（P1-2）**：宿主语言不在 zh/ja/en 里（fr/de/es/pt/…）时，设置页从整页中文改为回落英文。`pickLocale` 进 dev 钩子导出，`check-audit` 第 21 组断言 fr → en。
+- **深色注释（label-caption）过 Lc 闸（P2-3）**：原先深色侧只按浅色下限求解，实测 Lc 47.9–51.7，低于本插件给文字定的 Lc 60 线（三级同面 62–66、链接有 Lc 闸，唯独注释没有）。现标准档 Lc 60 / HC 档 70——HC 定 70 而非照抄链接的 75：HC 三级 Lc 落在 72–77，套 75 会反超三级破坏层级（实测暖砂 HC 原值 71.7 已达标故不变，靛蓝 HC 66.6 → 72.0）。抬完标准档注释 WCAG 5.73–6.19，仍低于三级的 6.4（层级断言钉住）。`check-audit` 第 4 组扩为 WCAG + Lc + 层级三重断言；DESIGN.md 口径表补「注释层」与「装饰层」两行（后者即 P3-12：label-dimmed/document-preview 按 3.0 装饰下限、有意不进承诺模型）。
+- **取色拖动按帧合并（P2-4，防御性优化）**：取色器 `input` 在拖动中每帧多次触发，此前每次都全量重放覆盖层（宿主侧重写约 200 个 token 触发全页样式重算）。现在同帧多次取色合并到下一帧只重放一次、以最后一次为准；重置/派生/导入等离散动作保持同步。审计修正：插件侧构建实测仅约 0.05ms/次（60 次共 3ms），瓶颈在宿主侧重排——所以这是防御性优化而非实测缺陷修复。`check-selfheal` 新增第 6 场景（假宿主计数：帧内 +0、合并后 +1、末次生效），其沙箱的 localStorage 桩顺带从「恒返 null」改为 Map 实现（原桩让自定义色永远读回默认值，与真实宿主不符）。
+- **CI（P2-5）**：新增 `.github/workflows/ci.yml`，push/PR 在 Node 22/24 跑 `npm run check` + `npm run report`；此前全部质量门只在本地/发版时跑。脚本只依赖 node 内建，无需 install；宿主契约在无 asar 的 CI 上自动 SKIP。
+- **dev 钩子补导出（P2-6）**：`apcaContrast` / `raiseToLc` / `solveForeground` / `pickLocale` / `hostLocale` / `floorsDark` —— 外部工具复算 Lc 不必再自带一份 APCA 实现。
+- **组合数口径统一为 1080（P3-10）**：五语 README 与 DESIGN.md 原写「2160 组（5 × 216 × 两档）」，公式把高对比算了两次（216 已含 hc 档），实际扫描 1080 组（1.9.10 撤右栏档前才是 2160）。
+- **notice 文案版本同步断言（P3-11）**：`check-ui` 新增——四个语种的 `notice` 恰好 4 条且都含当前 `PLUGIN_VERSION`，升级漏改不会绿。
+- **代码卫生（P3-7/8/9）**：短码编解码从废弃的 `escape`/`unescape` 换 `TextEncoder`/`TextDecoder`（产出逐字节相同，新旧短码互解码兼容，第 2 组旧码断言守着）；`TEXT_TARGETS` 常量表从 `buildTokensRaw` 体内上提到模块级（紧随 `SURFACE_TARGETS`）；`langPref` 声明先于引用它的 `getConfigCode` 闭包。
+- **发版联动**：版本号 bump 至 1.11.0、四语 notice 换新、截图用 `npm run shots` 重拍（无头 Chrome/Edge + CDP 截 preview HTML，不需要 DSH 宿主——审计时「重拍需要宿主 GUI」的判断有误，发版时更正），`screenshots.meta.json` 的 `pluginVersion` 随之对齐。
+- 复核：`npm run check` 六件套全绿（含新增断言）；两档报表 exit 0，1080 组配置「未达标 0 / 低于 AA 4.5 = 0 / 硬失败 0」；`npm pack --dry-run` 确认 assets 入包（20 文件 / 435.6KB）。
+
+### 1.10.0
+按审计报告的改进清单做了六件事：色彩数学单测、高对比跟随系统、运行时覆盖报告、色觉缺陷守门、单色派生，另外把 display-P3 的可行性量清楚后决定**本期不做**。其中「色觉缺陷守门」第一次跑就抓到一处真问题（浅色链接在模拟下低于 AA），下限因此微调。
+
+- **色彩数学单测**（新增 `tools/check-colormath.mjs`，约 40 条断言，并入 `npm run check` 与发版回归清单）：锚点（OKLab 里的白 / 黑 / 中灰）、OKLCH↔hex 往返、色域裁切「保明度保色相」、WCAG 样例值（`#777` on `#fff` = 4.48、黑白 21）、`flatten()` 的 α 合成交换性、`harmonize()` 的三条不变量（保 L、色度按比例、色相朝目标按 `pull` 走）。以前这些函数只靠「界面上看着对」，现在挪一个常数就会红。
+  写单测时踩了一次：`harmonize` 的色相断言最初写成「移动量 = pull」，实际是「按剩下的角度比例移动」（`dh1 ≈ pull × dh0`）—— 是断言错了，不是代码错。
+- **高对比档新增「跟随系统」并设为默认**：系统开「提高对比度」（`prefers-contrast: more`）就自动用高对比档，关掉回标准档；监听 `change` 事件即时重算。手动选过「关 / 开」的用户读回自己的选择，升级不会被改成别的档位。
+- **色觉缺陷守门**（`tools/check-audit.mjs` 第 20 组）：四套配色 × 明暗 × 正文/次级/三级/链接 × 三个承载面 × deutan / protan / tritan（Machado 2009），断言最低对比度 ≥ 4.5。**这条断言一开始没过**：三级与链接的浅色下限原本压在 4.62（刚过 AA），模拟把比值推动 5–9% 后链接跌到 **4.22–4.34**。修法是把浅色下限抬到三级 **4.85**、链接 **4.95**，抬完三种模拟下最低 **4.61**。代价：浅色链接与三级文字比 1.9.x 略深一档。
+- **自定义配色新增「由主色派生」**：只给一个主色，按它的色相与色度推出纸面与墨色（明度按当前明暗模式取引擎已验证的区间），派生结果直接过全部下限（实测正文 14.6–15.0 / 次级 6.8 / 三级 5.3 / 链接 5.4）。主色无彩时派生中性纸面。**它是一次性的填写动作，不是一种模式**：写进去的就是普通的三色，之后照常手改、导出分享码也只带这三个值；但正因为它会填这两格，面板里加了一行可见说明 ——「会覆盖你手动设置的底色与文字，派生之后仍可逐项手改」（四语种，`tools/check-custom.mjs` 断言这句必须是可见文本，不能只挂在 tooltip 上）。
+- **自定义配色新增色觉提示**：把三个色按 deutan / protan / tritan 模拟后，若强调色与文字或底色的 ΔE 塌到 **12** 以下（典型是红 / 绿搭配），面板里给一行说明 —— 只提示，不阻止保存，也不改用户的颜色。
+- **诊断导出新增运行时覆盖报告** `coverage`：枚举宿主样式表里所有 `--dsw-*`，分成「本插件接管 / var 引用 / 字面彩色 / 字面灰」四类，回答「宿主还有多少 token 没跟上配色」。只读、拿不到样式表就返回 `ok: false`。
+- **display-P3：量完决定不做**。同一 L/h 下 P3 比 sRGB 能多给的色度：纸面层（00/60）只多 ΔC 0.0008–0.0053（ΔE 0.08–0.53，JND 以下，看不出来）；能看出差别的是强调色（indigo ΔE 5.29、moss 2.96）。但强调色同时是链接 / info 填充 / 勾选支点的来源，按 P3 抬色度就要为 sRGB 回退再标定一套。数据与取舍写在 `docs/DESIGN.md`，将来若做，只值得给强调色加一层 `color(display-p3 …)`。
+- 复核：`npm run check` 全绿（含新增单测与第 20 组）；`palette-dev.mjs` 两档 exit 0，1080 组配置「未达标 0 / 低于 AA 4.5 = 0 / 硬失败 0」。
+
 ### 1.9.10
 撤除「右侧栏底色」这一档，并把它的技术债一起清干净（用户拍板）。**这不是修 bug，是承认做不到**：宿主右栏没有可染的落点，留着这个开关只会一直看起来像坏的。
 

package/README-es.md

@@ -31,7 +31,7 @@ El plugin solo apila tokens de color mediante `ctx.theme.overrideTokens`; no reg
 - más de 27.000 referencias de token: texto, secundario, terciario, notas, enlaces, barras laterales, tarjetas, burbuja del usuario, botón primario, barras de desplazamiento, interruptores, títulos/negritas de Markdown, bloques de código;
 - ajustable: intensidad del texto (3), profundidad de la barra lateral (3), énfasis de Markdown, barras de desplazamiento, color de interruptores;
 - **autorreparable**: si el host descarta la capa de override, la paleta se vuelve a aplicar;
-- **promesas de contraste**: el cuerpo tiene la promesa de 12:1 en claro y 10:1 en oscuro (15:1 en alto contraste), el secundario ≥ 6.2 en claro y 8.0 en oscuro, y el terciario y los enlaces ≥ 4.62 en claro y 6.4 en oscuro (los enlaces además pasan una puerta APCA Lc ≥ 60 en oscuro / 75 en HC), medidos sobre las superficies donde el texto realmente cae (el lado oscuro necesita más: un cociente WCAG sobreestima la legibilidad sobre fondo oscuro);
+- **promesas de contraste**: el cuerpo tiene la promesa de 12:1 en claro y 10:1 en oscuro (15:1 en alto contraste), el secundario ≥ 6.2 en claro y 8.0 en oscuro, y el terciario ≥ 4.85 y los enlaces ≥ 4.95 en claro, y 6.4 en oscuro (los mínimos claros llevan un margen para déficits de visión cromática; los enlaces además pasan una puerta APCA Lc ≥ 60 en oscuro / 75 en HC), medidos sobre las superficies donde el texto realmente cae (el lado oscuro necesita más: un cociente WCAG sobreestima la legibilidad sobre fondo oscuro);
 - las superficies prometidas son 00/60 en claro y 950/875 en oscuro; las oscuras 800 (superficie de módulo) y 850 (sub-superficie) **no** respaldan el texto del cuerpo: el informe las cuenta aparte como «fuera de política» (ni cuentan como aprobado ni como fallo);
 - interfaz en 简体中文 / 繁體中文 / English / 日本語 (sigue el idioma del host y se puede fijar).
 
@@ -69,10 +69,10 @@ OKLCH(L, C, tono) ──► ajuste al gamut (búsqueda binaria en C) ──► h
 
 - los alias semánticos mantienen cadenas `var(--dsw-static-neutral-bluish-NN)`, así que todo lo que sigue a un token sigue a la paleta;
 - superficies claras usan los pasos 00–300, las oscuras 800–950;
-- los mínimos de texto se exigen en tiempo de construcción: cuerpo ≥ 12:1 en claro y ≥ 10:1 en oscuro (alto contraste: 15:1), secundario ≥ 6.2 claro / 8.0 oscuro (HC 9 / 9.6), terciario/enlace ≥ 4.62 claro / 6.4 oscuro (HC 7 / 7.6), enlace con APCA Lc ≥ 60 oscuro (HC 75), texto en barra lateral ≥ 7, texto en burbuja ≥ 7;
+- los mínimos de texto se exigen en tiempo de construcción: cuerpo ≥ 12:1 en claro y ≥ 10:1 en oscuro (alto contraste: 15:1), secundario ≥ 6.2 claro / 8.0 oscuro (HC 9 / 9.6), terciario/enlace ≥ 4.85 / 4.95 claro / 6.4 oscuro (HC 7 / 7.6), enlace con APCA Lc ≥ 60 oscuro (HC 75), texto en barra lateral ≥ 7, texto en burbuja ≥ 7;
 - las superficies prometidas son 00/60 en claro y 950/875 en oscuro; las oscuras 800 (superficie de módulo) y 850 (sub-superficie) **no** respaldan el texto del cuerpo: el informe las cuenta aparte como «fuera de política» (ni cuentan como aprobado ni como fallo), y toda superficie sigue teniendo que superar el suelo AA de 4.5;
 - el informe separa tres cosas: el objetivo declarado, el techo físico (lo que el blanco o el negro alcanzan en esa superficie) y la exención de política; 0.93 es solo margen del solucionador, para decidir si un objetivo queda por encima del techo;
-- `node palette-dev.mjs` comprueba 2160 combinaciones (5 paletas × 216 ajustes × los dos niveles de contraste).
+- `node palette-dev.mjs` comprueba 1080 combinaciones (5 paletas × 216 ajustes, ambos niveles de contraste incluidos).
 
 Las notas de diseño, el criterio por componente y las tablas de contraste están en [docs/DESIGN.md](docs/DESIGN.md). Historial: [CHANGELOG.md](CHANGELOG.md).
 

package/README-hi.md

@@ -31,7 +31,7 @@ DeepSeek Harness (वेब और डेस्कटॉप) के लिए
 - 27,000+ टोकन संदर्भ शामिल: मुख्य टेक्स्ट, द्वितीयक, तृतीयक, कैप्शन, लिंक, साइडबार, कार्ड, उपयोगकर्ता बबल, प्राइमरी बटन, स्क्रॉलबार, स्विच, Markdown शीर्षक/बोल्ड, कोड ब्लॉक;
 - समायोज्य: टेक्स्ट की तीव्रता (3), साइडबार की गहराई (3), Markdown ज़ोर, स्क्रॉलबार, स्विच का रंग;
 - **स्व-उपचार**: यदि होस्ट ओवरराइड परत हटा दे, पैलेट फिर से लगा दी जाती है;
-- **कंट्रास्ट के वादे**: मुख्य टेक्स्ट के लिए लाइट में 12:1 और डार्क में 10:1 (उच्च-कंट्रास्ट में 15:1), द्वितीयक ≥ 6.2 (लाइट) / 8.0 (डार्क), तृतीयक और लिंक ≥ 4.62 (लाइट) / 6.4 (डार्क), लिंक अतिरिक्त APCA Lc ≥ 60 (डार्क) / 75 (HC) — उन्हीं सतहों पर मापे गए जहाँ टेक्स्ट वास्तव में बैठता है (डार्क में ज़्यादा चाहिए: गहरे बैकग्राउंड पर WCAG अनुपात पढ़ने की सुविधा को बढ़ा-चढ़ा कर दिखाता है);
+- **कंट्रास्ट के वादे**: मुख्य टेक्स्ट के लिए लाइट में 12:1 और डार्क में 10:1 (उच्च-कंट्रास्ट में 15:1), द्वितीयक ≥ 6.2 (लाइट) / 8.0 (डार्क), तृतीयक ≥ 4.85 और लिंक ≥ 4.95 (लाइट) / 6.4 (डार्क) — लाइट की सीमाओं में रंग-दृष्टि दोष के लिए गुंजाइश रखी गई है; लिंक अतिरिक्त APCA Lc ≥ 60 (डार्क) / 75 (HC) — उन्हीं सतहों पर मापे गए जहाँ टेक्स्ट वास्तव में बैठता है (डार्क में ज़्यादा चाहिए: गहरे बैकग्राउंड पर WCAG अनुपात पढ़ने की सुविधा को बढ़ा-चढ़ा कर दिखाता है);
 - वादे की गई सतहें लाइट में 00/60 और डार्क में 950/875 हैं; डार्क 800 (मॉड्यूल सतह) और 850 (उप-सतह) मुख्य टेक्स्ट को नहीं सहनाते — रिपोर्ट उन्हें अलग «नीति से बाहर» के रूप में गिनती है (न तो पास, न ही फेल);
 - इंटरफ़ेस 简体中文 / 繁體中文 / English / 日本語 में (होस्ट की भाषा का पालन करता है, हाथ से भी चुना जा सकता है)।
 
@@ -69,10 +69,10 @@ OKLCH(L, C, ह्यू) ──► गैमट क्लैंप (C पर
 
 - सेमांटिक एलियस `var(--dsw-static-neutral-bluish-NN)` श्रृंखलाएँ बनाए रखते हैं, इसलिए जो भी टोकन का पालन करता है वह पैलेट का भी करता है;
 - लाइट सतहें स्टेप 00–300, डार्क सतहें 800–950;
-- टेक्स्ट की न्यूनतम सीमा बनाते समय लागू: मुख्य लाइट में ≥ 12:1 और डार्क में ≥ 10:1 (उच्च-कंट्रास्ट: 15:1), द्वितीयक ≥ 6.2 लाइट / 8.0 डार्क (HC 9 / 9.6), तृतीयक/लिंक ≥ 4.62 लाइट / 6.4 डार्क (HC 7 / 7.6), लिंक APCA Lc ≥ 60 डार्क (HC 75), साइडबार में ≥ 7, बबल में ≥ 7;
+- टेक्स्ट की न्यूनतम सीमा बनाते समय लागू: मुख्य लाइट में ≥ 12:1 और डार्क में ≥ 10:1 (उच्च-कंट्रास्ट: 15:1), द्वितीयक ≥ 6.2 लाइट / 8.0 डार्क (HC 9 / 9.6), तृतीयक/लिंक ≥ 4.85 / 4.95 लाइट / 6.4 डार्क (HC 7 / 7.6), लिंक APCA Lc ≥ 60 डार्क (HC 75), साइडबार में ≥ 7, बबल में ≥ 7;
 - वादे की गई सतहें लाइट में 00/60 और डार्क में 950/875 हैं; डार्क 800 (मॉड्यूल सतह) और 850 (उप-सतह) मुख्य टेक्स्ट को नहीं सहनाते — रिपोर्ट उन्हें अलग «नीति से बाहर» के रूप में गिनती है (न तो पास, न ही फेल), और हर सतह को AA की न्यूनतम सीमा 4.5 से गुज़रना ही होता है;
 - रिपोर्ट तीन बातें अलग रखती है: घोषित लक्ष्य, भौतिक सीमा (उस सतह पर सफ़ेद या काला कितना हासिल कर सकता है) और नीति छूट; 0.93 केवल सॉल्वर का मार्जिन है, इससे तय होता है कि लक्ष्य सीमा से ऊपर है या नहीं;
-- `node palette-dev.mjs` 2160 संयोजन जाँचता है (5 पैलेट × 216 सेटिंग × दोनों कंट्रास्ट स्तर)।
+- `node palette-dev.mjs` 1080 संयोजन जाँचता है (5 पैलेट × 216 सेटिंग, दोनों कंट्रास्ट स्तर सहित)।
 
 डिज़ाइन नोट्स, घटक-वार तर्क और कंट्रास्ट तालिकाएँ [docs/DESIGN.md](docs/DESIGN.md) में। इतिहास: [CHANGELOG.md](CHANGELOG.md)।
 

package/README-pt.md

@@ -31,7 +31,7 @@ O plugin apenas empilha tokens de cor via `ctx.theme.overrideTokens`; não regis
 - mais de 27.000 referências de token: texto, secundário, terciário, legendas, links, barras laterais, cartões, balão do usuário, botão primário, barras de rolagem, interruptores, títulos/negrito de Markdown, blocos de código;
 - ajustável: intensidade do texto (3), profundidade da barra lateral (3), ênfase de Markdown, barras de rolagem, cor dos interruptores;
 - **autorrecuperação**: se o host descartar a camada de override, a paleta é reaplicada;
-- **promessas de contraste**: o corpo tem a promessa de 12:1 no claro e 10:1 no escuro (15:1 em alto contraste), o secundário ≥ 6.2 no claro e 8.0 no escuro, e o terciário e os links ≥ 4.62 no claro e 6.4 no escuro (os links ainda passam por um portão APCA Lc ≥ 60 no escuro / 75 em HC), medidos nas superfícies onde o texto realmente cai (o lado escuro precisa de mais: uma razão WCAG superestima a legibilidade sobre fundo escuro);
+- **promessas de contraste**: o corpo tem a promessa de 12:1 no claro e 10:1 no escuro (15:1 em alto contraste), o secundário ≥ 6.2 no claro e 8.0 no escuro, e o terciário ≥ 4.85 e os links ≥ 4.95 no claro, e 6.4 no escuro (os pisos do lado claro têm margem para deficiências de visão cromática; os links ainda passam por um portão APCA Lc ≥ 60 no escuro / 75 em HC), medidos nas superfícies onde o texto realmente cai (o lado escuro precisa de mais: uma razão WCAG superestima a legibilidade sobre fundo escuro);
 - as superfícies prometidas são 00/60 no claro e 950/875 no escuro; as escuras 800 (superfície de módulo) e 850 (sub-superfície) **não** sustentam o texto do corpo: o relatório as conta à parte como «fora de política» (nem contam como aprovado nem como falha);
 - interface em 简体中文 / 繁體中文 / English / 日本語 (segue o idioma do host e pode ser fixada).
 
@@ -69,10 +69,10 @@ OKLCH(L, C, matiz) ──► limite de gamut (busca binária em C) ──► hex
 
 - os aliases semânticos mantêm cadeias `var(--dsw-static-neutral-bluish-NN)`, então tudo que segue um token segue a paleta;
 - superfícies claras usam os passos 00–300, as escuras 800–950;
-- os pisos de texto são exigidos na construção: corpo ≥ 12:1 no claro e ≥ 10:1 no escuro (alto contraste: 15:1), secundário ≥ 6.2 claro / 8.0 escuro (HC 9 / 9.6), terciário/link ≥ 4.62 claro / 6.4 escuro (HC 7 / 7.6), link com APCA Lc ≥ 60 escuro (HC 75), texto na barra lateral ≥ 7, texto no balão ≥ 7;
+- os pisos de texto são exigidos na construção: corpo ≥ 12:1 no claro e ≥ 10:1 no escuro (alto contraste: 15:1), secundário ≥ 6.2 claro / 8.0 escuro (HC 9 / 9.6), terciário/link ≥ 4.85 / 4.95 claro / 6.4 escuro (HC 7 / 7.6), link com APCA Lc ≥ 60 escuro (HC 75), texto na barra lateral ≥ 7, texto no balão ≥ 7;
 - as superfícies prometidas são 00/60 no claro e 950/875 no escuro; as escuras 800 (superfície de módulo) e 850 (sub-superfície) **não** sustentam o texto do corpo: o relatório as conta à parte como «fora de política» (nem contam como aprovado nem como falha), e toda superfície ainda precisa passar pelo piso AA de 4.5;
 - o relatório separa três coisas: a meta declarada, o teto físico (o que o branco ou o preto alcançam nessa superfície) e a isenção de política; 0.93 é apenas margem do solucionador, usada para decidir se uma meta fica acima do teto;
-- `node palette-dev.mjs` verifica 2160 combinações (5 paletas × 216 ajustes × os dois níveis de contraste).
+- `node palette-dev.mjs` verifica 1080 combinações (5 paletas × 216 ajustes, ambos os níveis de contraste incluídos).
 
 Notas de design, critério por componente e tabelas de contraste em [docs/DESIGN.md](docs/DESIGN.md). Histórico: [CHANGELOG.md](CHANGELOG.md).
 

package/README-zh.md

@@ -32,7 +32,7 @@ package.json 的 `engines` 字段写的是 `^22.19.0 || >=24.0.0`——与上表
 - 可调：文字着色三档、侧栏三档、Markdown 强调、滚动条、开关配色；
 - **自定义配色**（给 底色/文字/强调 三色，文字色相也参与派生；过亮/过暗的强调色会归一化）、**配置导入导出**（`dshs1.` 短码含三色）、**高对比**档、4 种界面语言；
 - **自愈**：宿主丢弃 override 层时自动重放；
-- **对比度承诺**：正文浅色 12:1、深色 10:1（高对比 15:1），次级 ≥ 6.2（深色 8.0），三级/链接 ≥ 4.62（深色 6.4），链接另过 APCA Lc ≥ 60（高对比 75）—— 都在文字真实落到的承载面上实测（深色要高一些：WCAG 比值在暗底上会高估可读性）；
+- **对比度承诺**：正文浅色 12:1、深色 10:1（高对比 15:1），次级 ≥ 6.2（深色 8.0），三级 ≥ 4.85、链接 ≥ 4.95（深色 6.4；浅色留了色觉缺陷余量），链接另过 APCA Lc ≥ 60（高对比 75）—— 都在文字真实落到的承载面上实测（深色要高一些：WCAG 比值在暗底上会高估可读性）；
 - 承诺面是浅色 00/60 与深色 950/875；深色 800（模块面）与 850（次级深面）**不为正文兜底**，报表单列为「政策外」（既不算达标也不算失败）；
 - 界面支持 简体中文 / 繁體中文 / English / 日本語（跟随宿主，也可手选）。
 
@@ -70,10 +70,10 @@ OKLCH(L, C, hue) ──► 色域钳位（对 C 二分） ──► sRGB hex
 
 - 语义别名保留 `var(--dsw-static-neutral-bluish-NN)` 引用链，跟 token 的元素就跟着配色走；
 - 浅色面用色阶 00–300，深色面用 800–950；
-- 文字下限在构建期强制：正文浅色 ≥ 12:1、深色 ≥ 10:1（高对比 15:1），次级 ≥ 6.2 浅 / 8.0 深（HC 9 / 9.6），三级/链接 ≥ 4.62 浅 / 6.4 深（HC 7 / 7.6），链接另过 APCA Lc ≥ 60 深 / 75 HC，侧栏内 ≥ 7，气泡内 ≥ 7；
+- 文字下限在构建期强制：正文浅色 ≥ 12:1、深色 ≥ 10:1（高对比 15:1），次级 ≥ 6.2 浅 / 8.0 深（HC 9 / 9.6），三级/链接 ≥ 4.85 / 4.95 浅 / 6.4 深（HC 7 / 7.6），链接另过 APCA Lc ≥ 60 深 / 75 HC，侧栏内 ≥ 7，气泡内 ≥ 7；
 - 承诺面是浅色 00/60 与深色 950/875；深色 800（模块面）与 850（次级深面）**不为正文兜底**，报表单列为「政策外」（既不算达标也不算失败），且每一档承载面仍须过 AA 底线 4.5；
 - 报表把三件事分开：声明目标、物理上限（该承载面上黑或白前景能达到的对比度）、政策豁免；0.93 只是求解余量，仅用于判断目标是否高于上限；
-- `node palette-dev.mjs` 扫全部 2160 组配置（5 套配色 × 216 组设置 × 标准/高对比两档）并打印承载面报表，`--hc` 把主报表切到高对比档；硬失败时退出码 1。
+- `node palette-dev.mjs` 扫全部 1080 组配置（5 套配色 × 216 组设置，已含标准/高对比两档）并打印承载面报表，`--hc` 把主报表切到高对比档；硬失败时退出码 1。
 
 逐组件设计取舍与对比度表见 [docs/DESIGN.md](docs/DESIGN.md)，版本记录见 [CHANGELOG.md](CHANGELOG.md)。
 

package/README.md

@@ -32,7 +32,7 @@ The plugin only stacks colour tokens through `ctx.theme.overrideTokens`; it does
 - adjustable: text tint (3), sidebar depth (3), Markdown emphasis, scrollbars, switch colour;
 - **custom palette** (pick surface / text / accent — the engine keeps its contrast guarantees), **config export/import** via a `dshs1.` code, **high-contrast** mode, and 4 UI languages;
 - **self-healing**: if the host drops the override layer, the palette is re-applied;
-- **contrast promises**: body text is promised 12:1 in light and 10:1 in dark (15:1 in high contrast), secondary ≥ 6.2 in light / 8.0 in dark, tertiary and links ≥ 4.62 in light / 6.4 in dark (links also clear an APCA Lc ≥ 60 gate in dark / 75 in HC) — measured on the surfaces the text actually lands on (the dark side needs more, because a WCAG ratio overstates readability on a dark background);
+- **contrast promises**: body text is promised 12:1 in light and 10:1 in dark (15:1 in high contrast), secondary ≥ 6.2 in light / 8.0 in dark, tertiary ≥ 4.85 and links ≥ 4.95 in light / 6.4 in dark (the light floors carry a colour-vision headroom; links also clear an APCA Lc ≥ 60 gate in dark / 75 in HC) — measured on the surfaces the text actually lands on (the dark side needs more, because a WCAG ratio overstates readability on a dark background);
 - the promised surfaces are light 00/60 and dark 950/875; dark 800 (module surface) and 850 (sub-surface) do **not** back body text — the report counts them apart as "out of policy" (neither pass nor fail);
 - UI in 简体中文 / 繁體中文 / English / 日本語 (follows the host language, can be pinned).
 
@@ -70,10 +70,10 @@ OKLCH(L, C, hue) ──► gamut clamp (binary search on C) ──► sRGB hex
 
 - semantic aliases keep `var(--dsw-static-neutral-bluish-NN)` chains, so anything following a token follows the palette;
 - light surfaces use steps 00–300, dark surfaces 800–950;
-- text floors are enforced at build time: body ≥ 12:1 in light and ≥ 10:1 in dark (high contrast: 15:1), secondary ≥ 6.2 in light / 8.0 in dark (HC 9 / 9.6), tertiary/link ≥ 4.62 in light / 6.4 in dark (HC 7 / 7.6), link APCA Lc ≥ 60 in dark (HC 75), sidebar text ≥ 7, bubble text ≥ 7;
+- text floors are enforced at build time: body ≥ 12:1 in light and ≥ 10:1 in dark (high contrast: 15:1), secondary ≥ 6.2 in light / 8.0 in dark (HC 9 / 9.6), tertiary/link ≥ 4.85 / 4.95 in light / 6.4 in dark (HC 7 / 7.6), link APCA Lc ≥ 60 in dark (HC 75), sidebar text ≥ 7, bubble text ≥ 7;
 - the promised surfaces are light 00/60 and dark 950/875; dark 800 (module surface) and 850 (sub-surface) do **not** back body text — the report counts them apart as "out of policy" (neither pass nor fail), and every surface still has to clear the AA floor of 4.5;
 - the report separates three things: the declared target, the physical ceiling (what black or white can reach on that surface) and the policy exemption; 0.93 is only a solver margin, used to decide whether a target sits above the ceiling;
-- 2160 configuration combos (5 palettes × 216 settings × both contrast tiers) are checked by `node palette-dev.mjs`.
+- 1080 configuration combos (5 palettes × 216 settings, both contrast tiers included) are checked by `node palette-dev.mjs`.
 
 Design notes, per-component rationale and the contrast tables live in [docs/DESIGN.md](docs/DESIGN.md). Release history: [CHANGELOG.md](CHANGELOG.md).
 

package/assets/screenshots.meta.json

@@ -0,0 +1,81 @@
+{
+  "generatedAt": "2026-10-27T03:52:58.491Z",
+  "pluginVersion": "1.11.0",
+  "chrome": "Chrome/156.0.8078.48",
+  "width": 620,
+  "scale": 1,
+  "images": [
+    {
+      "file": "assets/screenshot-settings-light.png",
+      "html": "tools/preview-light.html",
+      "preview": [
+        "--palette",
+        "warm",
+        "--adv",
+        "0"
+      ],
+      "htmlSha256": "0cebb53312c0c39018705b81ece89e2d62ab14e7073214535d2330b4a019bb60",
+      "cssWidth": 620,
+      "cssHeight": 888,
+      "width": 620,
+      "height": 888,
+      "bytes": 47503,
+      "sha256": "6378abcf6c4fc42f0a9f2d3f32ac2a9a1679534debe126a2d9e0dd8c9999495f"
+    },
+    {
+      "file": "assets/screenshot-settings-dark.png",
+      "html": "tools/preview-dark.html",
+      "preview": [
+        "--palette",
+        "warm",
+        "--adv",
+        "0"
+      ],
+      "htmlSha256": "c1dcd522dc7af24d3b916b4e92001f47287839d9e507689d07df959da9ca8103",
+      "cssWidth": 620,
+      "cssHeight": 888,
+      "width": 620,
+      "height": 888,
+      "bytes": 48041,
+      "sha256": "688476198bab7c192eb9ead70a96afccb761b721f5cc5df3309879caddb21b07"
+    },
+    {
+      "file": "assets/screenshot-settings-custom.png",
+      "html": "tools/preview-light-customadv.html",
+      "preview": [
+        "--palette",
+        "custom",
+        "--adv",
+        "1",
+        "--out",
+        "customadv"
+      ],
+      "htmlSha256": "e29b936a12a75f1b2e8047c46872cb3f192a9e3a32bddccb0226d74bc8ed18a2",
+      "cssWidth": 620,
+      "cssHeight": 1753,
+      "width": 620,
+      "height": 1753,
+      "bytes": 116461,
+      "sha256": "89a0b0d346e2b94bc6bbd6a43b1fba5a198e44628159a3770fafd00de3d0c054"
+    },
+    {
+      "file": "assets/screenshot-settings-hc.png",
+      "html": "tools/preview-light-hcadv.html",
+      "preview": [
+        "--hc",
+        "1",
+        "--adv",
+        "1",
+        "--out",
+        "hcadv"
+      ],
+      "htmlSha256": "e737c6c6bcb4ca5edad80cdd04c49eee9c30bcbca396b779320731a6860639ec",
+      "cssWidth": 620,
+      "cssHeight": 1463,
+      "width": 620,
+      "height": 1463,
+      "bytes": 94432,
+      "sha256": "c4312f097c283a44ece12257710455a676ff2c0a054c59d1efc47b9c991d81a7"
+    }
+  ]
+}

package/client.js

@@ -27,7 +27,7 @@ window.__ModuleLoader__.load({
     const React = require('react')
     const h = React.createElement
 
-    const PLUGIN_VERSION = '1.9.10'
+    const PLUGIN_VERSION = '1.11.0'
     const STORE_KEY = 'dsh-theme-palette.v1'
     const OVERRIDE_SOURCE = 'dsh-theme-palette'
 
@@ -146,6 +146,19 @@ window.__ModuleLoader__.load({
       moss: { '00': '#f9fbf8', '60': '#f5f7f2', '150': '#e0e7dd', '950': '#131b16', '875': '#1a241d', '850': '#1d2a22', '800': '#2f3f34' },
     }
 
+    /* ---- 参考实现的 ink / link 精确对齐（1.9.0）----
+     * 参考的 ink 比求解结果更浅、更中性；这里直接取参考值，
+     * 但仍过一遍对比度下限：达不到的目标文字沿远离背景方向微调（只动明度，不动色相）。
+     * 三级文字在控件面上若参考本身不达 AA，会略微变深 —— 这是唯一允许偏离参考的地方。
+     * （审计 2026-10-27 P3-8：从 buildTokensRaw 体内上提 —— 它是不变的常量表，
+     *  放在函数里每次未命中缓存都要重新分配，且与 SURFACE_TARGETS 的组织不一致。）
+     */
+    const TEXT_TARGETS = {
+      warm: { light: { 1000: '#2b2622', 700: '#6b625a', 600: '#8c8177', link: '#8a5233' }, dark: { 50: '#f5efe8', 300: '#c4b8ac', 400: '#9a8d80', link: '#e6c4a0' } },
+      indigo: { light: { 1000: '#1a2330', 700: '#516074', 600: '#74839a', link: '#345286' }, dark: { 50: '#eef3fa', 300: '#b7c5d8', 400: '#8a9bb2', link: '#a6bfe3' } },
+      moss: { light: { 1000: '#1f2a22', 700: '#55645a', 600: '#7a8a7e', link: '#406236' }, dark: { 50: '#eef5ef', 300: '#b8c8bc', 400: '#8ba091', link: '#aed0a2' } },
+    }
+
     /* 对比度下限：主文本 16 / 次文本 6 / 三级文本 4.6（AA）/ 链接 4.6 */
     /* 对比度下限：按**真实承载面**定（卡层/模块层比画布更难达标），不是按画布定。
        正文 15.5 / 次级 6.2 / 三级 4.62（AA）/ 链接 4.62（AA） */
@@ -238,10 +251,36 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /**
+     * 只给一个主色时派生整套自定义配色（1.10.0，审计建议 4）。
+     *
+     * 用户往往只有一个「想要的品牌色」，让他自己配底色/文字色既难又容易把对比度配坏。
+     * 这里按主色的色相与色度推出一对「纸面 + 墨色」：
+     *   · 色相 = 主色色相；色度取主色的 15%–22% 并夹住上限 —— 纸面只该有一点点色，不该是整片主色；
+     *   · 明度由明暗模式决定（亮底纸面 0.968 / 墨 0.235；暗底 0.165 / 0.935），这是引擎已验证的区间；
+     *   · 主色原样保留，交给 customScheme 去钳位与求解（它会给链接/强调色兜对比度）。
+     * 主色无彩（C < 0.004）时退化为中性纸面，避免「黑底 + 白字 + 黄强调派生出一套淡粉」那类老问题。
+     */
+    function deriveCustomFromAccent(accentHex, pref) {
+      if (typeof accentHex !== 'string' || !HEX_RE.test(accentHex)) return null
+      const [L, C, h] = toOklch(accentHex)
+      const neutral = C < 0.004
+      const dark = pref === 'dark'
+      const tint = (scale, lo, hi) => (neutral ? 0 : Math.min(hi, Math.max(lo, C * scale)))
+      const bg = fromOklch(dark ? 0.165 : 0.968, tint(0.22, 0.006, 0.014), h)
+      const text = fromOklch(dark ? 0.935 : 0.235, tint(0.18, 0.004, 0.012), h)
+      return { bg, text, accent: String(accentHex).toLowerCase(), accentL: L }
+    }
+
     const MIN_MAIN = 12
     const MIN_SECONDARY = 6.2
-    const MIN_TERTIARY = 4.62
-    const MIN_LINK = 4.62
+    /* 三级/链接的浅色下限从 4.62 抬到 4.85 / 4.95（1.10.0）：4.62 是「刚好过 AA」，
+     * 一点余量都不留 —— 而色觉缺陷模拟（Machado 2009，deutan/protan）会让同一对
+     * 前景/背景的比值上下浮动 5–9%，实测链接在 4.62 时就跌到 4.22–4.34（低于 AA）。
+     * 抬到 4.95 后三种色觉模拟下的最低值仍有 4.5+（tools/check-audit.mjs 第 19 组守着）。
+     * 代价：浅色链接与三级文字比 1.9.x 略深一档，肉眼几乎无差别。 */
+    const MIN_TERTIARY = 4.85
+    const MIN_LINK = 4.95
     /* 深色链接不再用 WCAG 比值兜底（1.9.9 补）：深色面上同一比值换到的 Lc 差得远，
        4.62 在自定义配色的 875 面上只有 Lc 52.7，低于本插件给文字定的 Lc 60 下限。
        tuneRamps 里改为沿亮度把 Lc 顶到 60（高对比 75），这里只保留浅色侧的下限。 */
@@ -500,12 +539,16 @@ window.__ModuleLoader__.load({
       { id: 'off', label: '同正文' },
     ]
     const DEFAULT_MD = 'on'
-    /** 高对比开关（反哺 A-4）：不改配色，把文字下限抬到 AAA。 */
+    /** 高对比开关（反哺 A-4）：不改配色，把文字下限抬到 AAA。
+     *  auto（1.10.0，审计 3.11）：跟随系统 prefers-contrast: more ——
+     *  系统开了「提高对比度」就自动用高对比档，没开就用标准档。
+     *  已存过 off/on 的老用户不受影响（读回自己的选择）。 */
     const HC_MODES = [
+      { id: 'auto', label: '跟随系统' },
       { id: 'off', label: '关' },
       { id: 'on', label: '开' },
     ]
-    const DEFAULT_HC = 'off'
+    const DEFAULT_HC = 'auto'
     const MD_KEY = 'dsh-theme-palette.md.v1'
 
     /**
@@ -720,6 +763,40 @@ window.__ModuleLoader__.load({
       return rgbToHex(fg.map((v, i) => v * a + bg[i] * (1 - a)))
     }
 
+    /* ---------- 色觉缺陷模拟（Machado 2009，严重度 1.0）----------
+     * 只用于「告诉用户这个配色对色觉缺陷者是否还分得开」，不参与任何求解：
+     * 求解按明度走就已经对色觉友好，这里是把结论显示出来。
+     * 矩阵作用在线性 sRGB 上，和公开实现一致。
+     */
+    const CVD_MATRICES = {
+      deutan: [[0.367322, 0.860646, -0.227968], [0.280085, 0.672501, 0.047413], [-0.011820, 0.042940, 0.968881]],
+      protan: [[0.152286, 1.052583, -0.204868], [0.114503, 0.786281, 0.099216], [-0.003882, -0.048116, 1.051998]],
+      tritan: [[1.255528, -0.076749, -0.178779], [-0.078411, 0.930809, 0.147602], [0.004733, 0.691367, 0.303900]],
+    }
+    function simulateCvd(hex, kind) {
+      const m = CVD_MATRICES[kind]
+      if (!m || typeof hex !== 'string') return hex
+      const lin = hexToRgb(hex).map((v) => {
+        const s = v / 255
+        return s <= 0.04045 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4)
+      })
+      const out = m.map((row) => row[0] * lin[0] + row[1] * lin[1] + row[2] * lin[2])
+      return rgbToHex(out.map((v) => {
+        const c = v <= 0.0031308 ? v * 12.92 : 1.055 * Math.pow(v, 1 / 2.4) - 0.055
+        return clamp(c * 255, 0, 255)
+      }))
+    }
+    /** 两个颜色在给定色觉模拟下的 OKLab 距离（×100，与设计软件的 ΔE 同量级）。 */
+    function deltaE(a, b, kind) {
+      const x = toOklch(simulateCvd(a, kind))
+      const y = toOklch(simulateCvd(b, kind))
+      const toLab = ([L, C, h]) => [L, C * Math.cos((h * Math.PI) / 180), C * Math.sin((h * Math.PI) / 180)]
+      const p = toLab(x)
+      const q = toLab(y)
+      return Math.hypot(p[0] - q[0], p[1] - q[1], p[2] - q[2]) * 100
+    }
+
+
     /**
      * 语义色温度调和：保留色相为主（绿仍是绿、红仍是红），只把色相往配色的暖/冷方向
      * 拉一小段、并压低饱和度。用于 file diff 这种大面积色块——不能整块换成主题色，
@@ -1193,12 +1270,23 @@ window.__ModuleLoader__.load({
           // 注释/时间戳：既要跟随主题（色度由 midC 给），也要在画布/卡层上可读。
           // 直接拿 400 号色在浅色下只有约 2.4:1，所以这里对 00/60 求解到 AA。
           light: solveForeground(r.bluish, '400', [r.bluish['00'], r.bluish['60']], floors(hc).tertiary, 0.62),
-          dark: solveForeground(
-            r.bluish,
-            '500',
+          /* 深色（审计 2026-10-27 P2-3）：原先只按浅色下限（4.85）对 800/850 求解，
+           * 实测 Lc 只有 48–52 —— 本插件给文字定的可读线是 Lc 60，三级文字同面有 62–66。
+           * 深色侧的「WCAG 过线 ≠ 看得清」论证（见 MIN_SECONDARY_DARK）同样适用于注释。
+           * 这里在 WCAG 求解之后再过一道 Lc 闸：
+           *   标准档 60（与链接同线）；HC 档 70 而不是照抄链接的 75 ——
+           *   HC 三级文字 Lc 落在 72–77，注释套 75 会反超三级（靛蓝 75 > 72），
+           *   破坏「注释弱于三级」的层级。抬完后标准档注释 WCAG ≈ 5.6–6.0，仍低于三级的 6.4。 */
+          dark: raiseToLc(
+            solveForeground(
+              r.bluish,
+              '500',
+              [r.bluish['800'], r.bluish['850']],
+              Math.min(floors(hc).tertiary, contrast('#ffffff', r.bluish['800']) * 0.995),
+              0.30,
+            ),
             [r.bluish['800'], r.bluish['850']],
-            Math.min(floors(hc).tertiary, contrast('#ffffff', r.bluish['800']) * 0.995),
-            0.30,
+            hc ? 70 : 60,
           ),
         },
         // 主人气泡（`--dsw-specific-bubble`）宿主指向 deepseek-50：那是「品牌色的极浅底」，
@@ -1620,16 +1708,8 @@ window.__ModuleLoader__.load({
       if (!params.tinted && sidebarMode === 'light') {
         pairs['--dsw-static-neutral-bluish-00'] = { light: '#fafafa', dark: BASE.bluish['00'] }
       }
-      /* ---- 参考实现的 ink / link 精确对齐（1.9.0）----
-       * 参考的 ink 比我们求解结果更浅、更中性；这里直接取参考值，
-       * 但仍过一遍对比度下限：达不到的目标文字沿远离背景方向微调（只动明度，不动色相）。
-       * 三级文字在控件面上若参考本身不达 AA，会略微变深 —— 这是唯一允许偏离参考的地方。
-       */
-      const TEXT_TARGETS = {
-        warm: { light: { 1000: '#2b2622', 700: '#6b625a', 600: '#8c8177', link: '#8a5233' }, dark: { 50: '#f5efe8', 300: '#c4b8ac', 400: '#9a8d80', link: '#e6c4a0' } },
-        indigo: { light: { 1000: '#1a2330', 700: '#516074', 600: '#74839a', link: '#345286' }, dark: { 50: '#eef3fa', 300: '#b7c5d8', 400: '#8a9bb2', link: '#a6bfe3' } },
-        moss: { light: { 1000: '#1f2a22', 700: '#55645a', 600: '#7a8a7e', link: '#406236' }, dark: { 50: '#eef5ef', 300: '#b8c8bc', 400: '#8ba091', link: '#aed0a2' } },
-      }
+      // 参考墨色表在模块级（TEXT_TARGETS，紧随 SURFACE_TARGETS）；自定义没有参考表，
+      // 走下面的通用求解路径。
       const TT = TEXT_TARGETS[scheme.id]
       // 三套预置走参考目标；自定义没有参考表，但同样要拿到跟随主题的注释/文字
       if (scheme.tinted) {
@@ -1862,6 +1942,8 @@ body[data-ds-dark-theme] .dsh-tp-check{background:var(--t-accent-d);color:var(--
 .dsh-tp-hexerror{font-size:11.5px;line-height:16px;color:var(--dsw-alias-state-error-primary)}
 .dsh-tp-hexnote{font-size:11.5px;line-height:16px;color:var(--dsw-alias-label-secondary)}
 .dsh-tp-custom-hint{margin:0;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary)}
+/* 「由主色派生」的副作用说明：左侧一道细边，读起来是提示而不是正文（1.10.0） */
+.dsh-tp-custom-note{margin:0;padding:6px 0 6px 8px;font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary);border-left:2px solid var(--dsw-alias-border-l3)}
 .dsh-tp-note{font-size:11.5px;color:var(--dsw-alias-label-tertiary)}
 .dsh-tp-status{margin:0;font-size:11.5px;line-height:18px;color:var(--dsw-alias-label-tertiary)}
 .dsh-tp-status.is-bad{color:var(--dsw-alias-state-error-primary)}
@@ -2084,7 +2166,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
     function readHcStored() {
       try {
         const raw = localStorage.getItem(HC_KEY)
-        if (raw === 'on' || raw === 'off') return raw
+        if (raw === 'on' || raw === 'off' || raw === 'auto') return raw
       } catch (err) { /* 退回默认 */ }
       return DEFAULT_HC
     }
@@ -2118,7 +2200,12 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         x: { bg: custom.bg, text: custom.text, accent: custom.accent },
       }
       try {
-        const b64 = btoa(unescape(encodeURIComponent(JSON.stringify(raw))))
+        // TextEncoder 产出与旧版 escape/encodeURIComponent 链逐字节相同的 UTF-8（审计 2026-10-27 P3-7）：
+        // 新旧版本的短码可以互相解码，check-audit 第 2 组的旧码断言守着这一点。
+        const bytes = new TextEncoder().encode(JSON.stringify(raw))
+        let binary = ''
+        for (let i = 0; i < bytes.length; i++) binary += String.fromCharCode(bytes[i])
+        const b64 = btoa(binary)
         return CONFIG_PREFIX + b64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, '')
       } catch (err) { return '' }
     }
@@ -2132,7 +2219,10 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
       try {
         let b64 = text.slice(CONFIG_PREFIX.length).replace(/-/g, '+').replace(/_/g, '/')
         while (b64.length % 4 !== 0) b64 += '='
-        const raw = JSON.parse(decodeURIComponent(escape(atob(b64))))
+        const bin = atob(b64)
+        const bytes = new Uint8Array(bin.length)
+        for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i)
+        const raw = JSON.parse(new TextDecoder().decode(bytes))
         if (!raw || raw.v !== 1) return null
         const next = {
           palette: SCHEMES.some((sc) => sc.id === raw.p) ? raw.p : null,
@@ -2195,7 +2285,9 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
 
     function pickLocale(pref) {
       if (pref !== 'auto') return pref
-      return hostLocale() || 'zh-CN'
+      // 兜底必须是 en 而不是 zh-CN（审计 2026-10-27 P1-2）：宿主语言不在
+      // zh/ja/en 里（fr/de/es/pt/…）时给整页中文，对国际用户是最差的选择。
+      return hostLocale() || 'en'
     }
 
     const TEXT = {
@@ -2222,10 +2314,14 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         hc: '高对比',
         custom: '自定义配色',
         customHint: '取三个色的色相与色度；过亮/过暗的强调色会归一化以保证可读，明度由引擎按模式计算。',
-        notice: '1.9.9 按独立审计逐条修订：深色文字下限单独提高（次级 8 / 三级 6.4）、文字着色三档对预置配色真正生效、色阶不再出现「编号越大反而越亮」、高对比档的边框与滚动条也真提高了；报表新增 APCA 列。',
+        derive: '由主色派生',
+        deriveHint: '用当前强调色的色相与色度推导底色与文字（明暗跟随当前模式）',
+        deriveNote: '「由主色派生」以强调色为唯一输入，自动算出底色与文字 —— 会覆盖你手动设置的底色与文字；派生之后仍可逐项手改。',
+        notice: '1.11.0：深色模式下注释与时间戳更清晰（按感知对比度 Lc 加了一道闸）；宿主语言不是中/英/日时界面改为回落英文；取色拖动按帧合并更流畅。',
         dismiss: '知道了',
         explainClamp: '强调色已归一化：{from} → {to}（保证按钮与勾选可读）',
         explainLink: '链接已为可读性压暗：{ratio}:1（目标 {target}:1）',
+        explainCvd: '色觉缺陷提示：{kind} 视觉下强调色与底色/文字几乎同色（ΔE {dE}）。文字仍可读，但按钮与色块会分不开；换一个更亮或更暗的强调色即可。',
         preview: '预览',
         sample: '试试示例',
         copyDiag: '复制诊断',
@@ -2261,7 +2357,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         importBad: '短码无效，已忽略',
         badHex: 'HEX 需为 #RRGGBB',
         hexStale: '这个值刚被别处改过，已保留最新值',
-        hcSub: '尽量把文字下限抬到 AAA（正文 ≥15、次文 ≥9、三级 ≥7）；深色 800/850 不为正文兜底（政策外），但仍守 AA 底线。',
+        hcSub: '把文字下限抬到 AAA（正文 ≥15、次文 ≥9、三级 ≥7）；「跟随系统」= 系统「提高对比度」开启时自动切高对比档；深色 800/850 不为正文兜底（政策外），但仍守 AA 底线。',
       },
       'zh-TW': {
         nav: '主題色',
@@ -2286,10 +2382,14 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         hc: '高對比',
         custom: '自訂配色',
         customHint: '取三個色的色相與色度；過亮/過暗的強調色會正規化以確保可讀性，明度由引擎依模式計算。',
-        notice: '1.9.9 依獨立稽核逐條修訂：深色文字下限另行提高（次要 8 / 三級 6.4）、文字著色三檔對預設配色真正生效、色階不再出現「編號越大反而越亮」、高對比檔的邊框與捲軸也真提高了；報表新增 APCA 欄。',
+        derive: '由主色派生',
+        deriveHint: '用目前強調色的色相與彩度推導底色與文字（明暗跟隨目前模式）',
+        deriveNote: '「由主色派生」以強調色為唯一輸入，自動算出底色與文字 —— 會覆蓋你手動設置的底色與文字；派生之後仍可逐項手改。',
+        notice: '1.11.0：深色模式下註釋與時間戳更清晰（按感知對比度 Lc 加了一道閘）；宿主語言不是中/英/日時介面改為回落英文；取色拖動按幀合併更流暢。',
         dismiss: '知道了',
         explainClamp: '強調色已正規化：{from} → {to}（確保按鈕與勾選可讀）',
         explainLink: '連結已為可讀性壓暗：{ratio}:1（目標 {target}:1）',
+        explainCvd: '色覺缺陷提示：{kind} 視覺下強調色與底色/文字幾乎同色（ΔE {dE}）。文字仍可讀，但按鈕與色塊會分不開；換一個更亮或更暗的強調色即可。',
         preview: '預覽',
         sample: '試試示例',
         copyDiag: '複製診斷',
@@ -2325,7 +2425,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         importBad: '短碼無效，已忽略',
         badHex: 'HEX 需為 #RRGGBB',
         hexStale: '這個值剛被別處改過，已保留最新值',
-        hcSub: '盡量把文字下限抬到 AAA（正文 ≥15、次文 ≥9、三級 ≥7）；深色 800/850 不為正文兜底（政策外），但仍守 AA 底線。',
+        hcSub: '把文字下限抬到 AAA（正文 ≥15、次文 ≥9、三級 ≥7）；「跟隨系統」= 系統「提高對比度」開啟時自動切高對比檔；深色 800/850 不為正文兜底（政策外），但仍守 AA 底線。',
       },
       en: {
         nav: 'Color theme',
@@ -2350,10 +2450,14 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         hc: 'High contrast',
         custom: 'Custom palette',
         customHint: 'Takes hue and chroma from three colours; extreme accents are normalised for readability; lightness comes from the engine per mode.',
-        notice: '1.9.9 fixes the issues from an independent audit: dark text gets its own higher floors (secondary 8 / tertiary 6.4), the text-tint tiers now really work on presets, ramps no longer go "higher step, lighter colour", and high-contrast borders and scrollbars are genuinely raised; the report gains an APCA column.',
+        derive: 'Derive from accent',
+        deriveHint: 'Derive background and text from the current accent hue and chroma (follows the current light/dark mode)',
+        deriveNote: '"Derive from accent" takes the accent as its only input and computes background and text from it — this overwrites the background and text you set by hand; you can still edit each of them afterwards.',
+        notice: '1.11.0: captions and timestamps are clearer in dark mode (a perceptual-contrast Lc gate was added); the UI now falls back to English when the host language is not Chinese, English or Japanese; colour-picker drags are smoother (frame-coalesced).',
         dismiss: 'Got it',
         explainClamp: 'Accent normalised: {from} → {to} (keeps buttons and checks readable)',
         explainLink: 'Link darkened for readability: {ratio}:1 (target {target}:1)',
+        explainCvd: 'Colour-vision note: with {kind} vision the accent is nearly the same colour as the background/text (ΔE {dE}). Text stays readable, but buttons and swatches blur together — pick a lighter or darker accent.',
         preview: 'Preview',
         sample: 'Try a sample',
         copyDiag: 'Copy diagnostics',
@@ -2389,7 +2493,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         importBad: 'Invalid code, ignored',
         badHex: 'HEX must be #RRGGBB',
         hexStale: 'This value was changed elsewhere; the latest value was kept',
-        hcSub: 'Raises text floors toward AAA (body ≥15, secondary ≥9, tertiary ≥7); dark 800/850 no longer back the body text (out of policy) but still hold the AA floor.',
+        hcSub: 'Raises text floors toward AAA (body ≥15, secondary ≥9, tertiary ≥7); "System" = automatically switches to the high-contrast tier when the OS "increase contrast" setting is on; dark 800/850 no longer back the body text (out of policy) but still hold the AA floor.',
       },
       ja: {
         nav: 'カラーテーマ',
@@ -2414,10 +2518,14 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         hc: 'ハイコントラスト',
         custom: 'カスタム配色',
         customHint: '3 色の色相と彩度を使用。極端なアクセント色は可読性のため正規化され、明度はモードごとにエンジンが決めます。',
-        notice: '1.9.9 は独立監査の指摘を順に修正しました：ダークの文字下限を個別に引き上げ（二次 8 / 三次 6.4）、テキストの色味 3 段階がプリセットでも実際に効くようになり、色階が「番号が大きいほど明るい」現象も解消、ハイコントラストの枠線とスクロールバーも実際に強まりました。レポートに APCA 列を追加。',
+        derive: 'メイン色から生成',
+        deriveHint: '現在のアクセント色の色相と彩度から背景色と文字色を生成します（明暗は現在のモードに従います）',
+        deriveNote: '「メイン色から生成」はアクセント色だけを入力として背景色と文字色を自動計算します。手動で設定した背景色と文字色は上書きされます（生成後に個別に変更できます）。',
+        notice: '1.11.0：ダークモードのキャプション・タイムスタンプがより明瞭になりました（知覚コントラスト Lc のゲートを追加）。ホスト言語が中／英／日以外のとき UI は英語にフォールバックします。カラーピッカーのドラッグがフレーム統合でより滑らかになりました。',
         dismiss: '了解',
         explainClamp: 'アクセント色を正規化しました：{from} → {to}（ボタンとチェックの可読性のため）',
         explainLink: 'リンクを可読性のため暗くしました：{ratio}:1（目標 {target}:1）',
+        explainCvd: '色覚のヒント：{kind} ではアクセント色が背景・文字とほぼ同色になります（ΔE {dE}）。文字は読めますが、ボタンと色面は見分けにくくなります。もっと明るい／暗いアクセント色に変えてください。',
         preview: 'プレビュー',
         sample: 'サンプルを試す',
         copyDiag: '診断をコピー',
@@ -2453,7 +2561,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         importBad: '無効なコードです',
         badHex: 'HEX は #RRGGBB 形式で入力してください',
         hexStale: 'この値は別の場所で変更されました。最新の値を保持しています',
-        hcSub: '本文の下限を AAA に近づけます（本文 ≥15、副次 ≥9、三次 ≥7）。暗い 800/850 は本文を受け皿にしません（対象外）ですが、AA 下限は守ります。',
+        hcSub: '本文の下限を AAA に近づけます（本文 ≥15、副次 ≥9、三次 ≥7）。「システム」= OS の「コントラストを上げる」が有効なとき自動的にハイコントラストになります。暗い 800/850 は本文を受け皿にしません（対象外）ですが、AA 下限は守ります。',
       },
     }
 
@@ -2468,7 +2576,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         control: { accent: '主题色', mono: '黑白' },
         md: { on: '着色', off: '同正文' },
         lang: { auto: '自动' },
-        hc: { off: '关', on: '开' },
+        hc: { auto: '跟随系统', off: '关', on: '开' },
         custom: { bg: '底色', text: '文字', accent: '强调' },
       },
       'zh-TW': {
@@ -2480,7 +2588,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         control: { accent: '主題色', mono: '黑白' },
         md: { on: '著色', off: '同本文' },
         lang: { auto: '自動' },
-        hc: { off: '關', on: '開' },
+        hc: { auto: '跟隨系統', off: '關', on: '開' },
         custom: { bg: '底色', text: '文字', accent: '強調' },
       },
       en: {
@@ -2492,7 +2600,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         control: { accent: 'Accent', mono: 'Mono' },
         md: { on: 'Tinted', off: 'Body colour' },
         lang: { auto: 'Auto' },
-        hc: { off: 'Off', on: 'On' },
+        hc: { auto: 'System', off: 'Off', on: 'On' },
         custom: { bg: 'Surface', text: 'Text', accent: 'Accent' },
       },
       ja: {
@@ -2504,7 +2612,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         control: { accent: 'アクセント', mono: 'モノクロ' },
         md: { on: '色づけ', off: '本文と同じ' },
         lang: { auto: '自動' },
-        hc: { off: 'オフ', on: 'オン' },
+        hc: { auto: 'システム', off: 'オフ', on: 'オン' },
         custom: { bg: '背景', text: '本文', accent: 'アクセント' },
       },
     }
@@ -2641,6 +2749,12 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         { className: 'dsh-tp-custom' },
         h('div', { className: 'dsh-tp-custom-head' },
           h('b', null, txt.custom),
+          h('button', {
+            type: 'button',
+            className: 'dsh-tp-mini',
+            title: txt.deriveHint,
+            onClick: () => props.deriveFromAccent(),
+          }, txt.derive),
           h('button', {
             type: 'button',
             className: 'dsh-tp-mini',
@@ -2705,14 +2819,17 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
             invalid && h('span', { id: errId, className: 'dsh-tp-hexerror', role: 'alert' }, txt.badHex),
             stale && h('span', { id: staleId, className: 'dsh-tp-hexnote', role: 'status' }, txt.hexStale))
           })),
+        h('p', { className: 'dsh-tp-custom-note' }, txt.deriveNote),
         h('p', { className: 'dsh-tp-custom-hint' }, txt.customHint),
-        explain && (explain.accentClamped || explain.linkShifted) && h(
+        explain && (explain.accentClamped || explain.linkShifted || explain.cvdRisk) && h(
           'div',
           { className: 'dsh-tp-explain', role: 'status' },
           explain.accentClamped && h('span', null,
             fmt(txt.explainClamp, { from: explain.accentFrom, to: explain.accentTo })),
           explain.linkShifted && h('span', null,
             fmt(txt.explainLink, { ratio: explain.linkRatio.toFixed(2), target: explain.linkTarget })),
+          explain.cvdRisk && h('span', null,
+            fmt(txt.explainCvd, { kind: explain.cvdKind, dE: explain.cvdDeltaE })),
         ),
       )
 
@@ -3031,7 +3148,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
 
     // 开发期接口：palette-dev.mjs 通过它拿到同一套引擎（避免「报表好看、上线不一样」）
     if (DEV_OPT_IN && typeof window !== 'undefined' && typeof window.__DSH_THEME_PALETTE_DEV__ === 'function') {
-      window.__DSH_THEME_PALETTE_DEV__({ buildTokens, SCHEMES, SIDEBAR_MODES, TEXT_MODES, SCROLL_MODES, CONTROL_MODES, MD_MODES, HC_MODES, contrast, toOklch, fromOklch, flatten, rampsFor, floors, encodeConfig, decodeConfig, customScheme, readCustom, writeCustom, CONTRAST_SURFACES, CONTRAST_ROLES, buildContrastReport, devContrastReport, CONTRAST_TARGETS, CONTRAST_EXEMPT, CONTRAST_FLOOR, CONTRAST_SOLVER_MARGIN, LAYER_MARK, settingsCss: SETTINGS_CSS, markdownCss: MARKDOWN_CSS, cardColors })
+      window.__DSH_THEME_PALETTE_DEV__({ buildTokens, SCHEMES, SIDEBAR_MODES, TEXT_MODES, SCROLL_MODES, CONTROL_MODES, MD_MODES, HC_MODES, contrast, toOklch, fromOklch, flatten, luminance, withAlpha, mixHex, harmonize, deltaE, simulateCvd, rampsFor, floors, floorsDark, apcaContrast, raiseToLc, solveForeground, pickLocale, hostLocale, encodeConfig, decodeConfig, customScheme, deriveCustomFromAccent, readCustom, writeCustom, CONTRAST_SURFACES, CONTRAST_ROLES, buildContrastReport, devContrastReport, CONTRAST_TARGETS, CONTRAST_EXEMPT, CONTRAST_FLOOR, CONTRAST_SOLVER_MARGIN, LAYER_MARK, settingsCss: SETTINGS_CSS, markdownCss: MARKDOWN_CSS, cardColors })
     }
 
     return {
@@ -3052,8 +3169,9 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         let controlMode = readControlStored()
         let mdMode = readMdStored()
         let hcMode = readHcStored()
-        const getConfigCode = () => encodeConfig({ palette: current, sidebar: sidebarMode, text: textMode, scroll: scrollMode, control: controlMode, md: mdMode, hc: hcMode, lang: langPref })
+        // langPref 必须先于引用它的闭包声明（审计 2026-10-27 P3-9：原顺序运行时无害，但极易误读成 TDZ）
         let langPref = readLangPref()
+        const getConfigCode = () => encodeConfig({ palette: current, sidebar: sidebarMode, text: textMode, scroll: scrollMode, control: controlMode, md: mdMode, hc: hcMode, lang: langPref })
         const localeListeners = new Set()
         const currentLocale = () => pickLocale(langPref)
         const emitLocale = () => { for (const fn of localeListeners) { try { fn() } catch (err) { /* 忽略 */ } } }
@@ -3141,9 +3259,17 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         // 但覆盖层写失败时屏幕上仍是旧配色。分开报，别让用户以为换成功了。
         let applyError = null
 
+        // 系统对比度偏好（审计 3.11）：auto 档监听 prefers-contrast: more。
+        // 测试沙箱里没有 matchMedia —— 判空退回「系统没要求」，auto 等于标准档。
+        const contrastMq = typeof window !== 'undefined' && typeof window.matchMedia === 'function'
+          ? window.matchMedia('(prefers-contrast: more)')
+          : null
+        const systemWantsHc = () => !!(contrastMq && contrastMq.matches)
+        const effectiveHc = () => hcMode === 'on' || (hcMode === 'auto' && systemWantsHc())
+
         const applyAll = (reason) => {
           const scheme = SCHEMES.find((s) => s.id === current) || SCHEMES[0]
-          const tokens = buildTokens(scheme, sidebarMode, textMode, scrollMode, controlMode, mdMode, hcMode === 'on')
+          const tokens = buildTokens(scheme, sidebarMode, textMode, scrollMode, controlMode, mdMode, effectiveHc())
           let next = () => {}
           if (tokens !== undefined) {
             try {
@@ -3347,7 +3473,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         const getCustomExplain = () => {
           const colors = readCustom()
           const scheme = customScheme(colors)
-          const hc = hcMode === 'on'
+          const hc = effectiveHc()
           const t = buildTokens(scheme, sidebarMode, textMode, scrollMode, controlMode, mdMode, hc)
           const link = t['--dsw-alias-link'].light
           const base = t['--dsw-static-deepseek-500'].light
@@ -3355,6 +3481,11 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
           const ratio = Math.min(...surfaces.map((bg) => contrast(link, bg)))
           const acL = toOklch(colors.accent)[0]
           const accentTo = Math.min(0.64, Math.max(0.30, acL))
+          // 色觉缺陷下的可分辨度：强调色 vs 底色 / 文字，三种模拟取最差的那种。
+          // 只提示不拦：用户的配色归用户，插件只负责把风险说出来。
+          const cvd = ['deutan', 'protan', 'tritan']
+            .map((kind) => ({ kind, dE: Math.min(deltaE(colors.accent, colors.bg, kind), deltaE(colors.accent, colors.text, kind)) }))
+            .sort((a, b) => a.dE - b.dE)[0]
           return {
             accentClamped: Math.abs(acL - accentTo) > 0.005,
             accentFrom: Math.round(acL * 100) / 100,
@@ -3362,6 +3493,9 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
             linkShifted: link.toLowerCase() !== base.toLowerCase(),
             linkRatio: Math.round(ratio * 100) / 100,
             linkTarget: floors(hc).link,
+            cvdRisk: cvd.dE < 12,
+            cvdKind: cvd.kind,
+            cvdDeltaE: Math.round(cvd.dE * 10) / 10,
           }
         }
         /** 诊断导出：把当前配色与对比度矩阵打成可粘贴的 JSON（提 issue 用）。 */
@@ -3370,7 +3504,57 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
           version: PLUGIN_VERSION,
           settings: { palette: current, sidebar: sidebarMode, text: textMode, scroll: scrollMode, control: controlMode, md: mdMode, hc: hcMode, lang: langPref },
           report: getContrastReport(),
+          coverage: getCoverageReport(),
         })
+        /**
+         * 运行时覆盖报告（审计建议 5）：枚举宿主样式表里的 --dsw-* 自定义属性，按四类分：
+         *   ours    —— 本插件覆盖层接管（lastTokens 里）；
+         *   derived —— 值是 var(--dsw-…) 引用（宿主别名，跟着基础 token 走，无需接管）；
+         *   literal-chromatic —— 字面色值且带色彩（宿主语义色等，有意不染）；
+         *   literal-gray —— 字面灰值（跟配色的候选：接管后体验更一致）。
+         * 只读、尽力而为：沙箱/跨域拿不到 styleSheets 时返回 { ok:false }，不影响其它诊断。
+         */
+        const getCoverageReport = () => {
+          const found = new Map()
+          try {
+            const sheets = typeof document !== 'undefined' && document.styleSheets ? Array.from(document.styleSheets) : []
+            const walk = (rules) => {
+              for (const rule of rules) {
+                if (!rule) continue
+                if (rule.cssRules) { try { walk(rule.cssRules) } catch (err) { /* 跨域子表 */ } continue }
+                const style = rule.style
+                if (!style || typeof style.length !== 'number') continue
+                for (let i = 0; i < style.length; i++) {
+                  const prop = style[i]
+                  if (typeof prop === 'string' && prop.indexOf('--dsw-') === 0) {
+                    found.set(prop, style.getPropertyValue(prop).trim())
+                  }
+                }
+              }
+            }
+            for (const sheet of sheets) { try { walk(sheet.cssRules) } catch (err) { /* 跨域表跳过 */ } }
+          } catch (err) {
+            return { ok: false, reason: String((err && err.message) || err) }
+          }
+          const ours = new Set(lastTokens ? Object.keys(lastTokens) : [])
+          const HEX_LIT = /^\s*#[0-9a-f]{3,8}\s*$/i
+          const out = { ok: true, total: found.size, ours: [], derived: [], literalChromatic: [], literalGray: [] }
+          for (const [name, value] of found) {
+            if (ours.has(name)) { out.ours.push(name); continue }
+            if (value.indexOf('var(') !== -1) { out.derived.push(name); continue }
+            if (HEX_LIT.test(value)) {
+              const hex = value.trim().slice(1)
+              const full = hex.length === 3 ? hex.split('').map((c) => c + c).join('') : hex
+              const r = parseInt(full.slice(0, 2), 16), g = parseInt(full.slice(2, 4), 16), b = parseInt(full.slice(4, 6), 16)
+              if (Math.abs(r - g) <= 2 && Math.abs(g - b) <= 2 && Math.abs(r - b) <= 2) out.literalGray.push(name)
+              else out.literalChromatic.push(name)
+              continue
+            }
+            out.derived.push(name) // rgb()/oklch() 等非 var 引用：归「其它声明」，暂不细分
+          }
+          out.counts = { total: out.total, ours: out.ours.length, derived: out.derived.length, literalChromatic: out.literalChromatic.length, literalGray: out.literalGray.length }
+          return out
+        }
         const previewConfigCode = (code) => {
           const cfg = decodeConfig(code)
           return cfg ? { ok: true, config: cfg } : { ok: false }
@@ -3383,7 +3567,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
          */
         const getContrastReport = () => {
           const scheme = SCHEMES.find((s) => s.id === current) || SCHEMES[0]
-          const hc = hcMode === 'on'
+          const hc = effectiveHc()
           const t = buildTokens(scheme, sidebarMode, textMode, scrollMode, controlMode, mdMode, hc)
           return buildContrastReport(t, hc, { mono: !scheme.tinted })
         }
@@ -3401,12 +3585,43 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
           applyAll('custom:reset')
           emitCustom()
         }
+        /* 取色拖动的帧合并（审计 2026-10-27 P2-4）：取色器 input 事件在拖动中每帧来多次，
+         * 每次都重放覆盖层会让宿主连续做全页样式重写（约 200 个 token）+ 样式回读。
+         * 同帧多次取色合并到下一帧只应用一次；离散动作（重置/派生/导入）不走这里，保持同步。 */
+        let customFrameQueued = false
+        const scheduleCustomApply = (reason) => {
+          if (customFrameQueued) return
+          customFrameQueued = true
+          const run = () => {
+            customFrameQueued = false
+            applyAll(reason)
+            emitCustom()
+          }
+          try { requestAnimationFrame(run) } catch (err) {
+            try { setTimeout(run, 0) } catch (err2) { run() }
+          }
+        }
         const setCustomColor = (field, hex) => {
           if (CUSTOM_FIELDS.indexOf(field) === -1) return false
           if (typeof hex !== 'string' || !HEX_RE.test(hex)) return false
           const next = Object.assign({}, readCustom(), { [field]: hex.toLowerCase() })
           writeCustom(next)
-          applyAll('custom:' + field)
+          scheduleCustomApply('custom:' + field)
+          return true
+        }
+        /** 以当前主色为唯一输入，重算底色与文字色（1.10.0，审计建议 4）。 */
+        const deriveFromAccent = () => {
+          const pref = (() => {
+            try {
+              const p = theme.getTheme().preference
+              if (p === 'dark' || p === 'light') return p
+            } catch (err) { /* 读不到偏好就按页面实际明暗判断 */ }
+            try { return document.body.hasAttribute('data-ds-dark-theme') ? 'dark' : 'light' } catch (err) { return 'light' }
+          })()
+          const next = deriveCustomFromAccent(readCustom().accent, pref)
+          if (!next) return false
+          writeCustom({ bg: next.bg, text: next.text, accent: next.accent })
+          applyAll('custom:derive')
           emitCustom()
           return true
         }
@@ -3477,6 +3692,14 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
           window.addEventListener('pageshow', healOnShow)
         } catch (err) { /* 无 DOM 时跳过 */ }
         try { ctx.on('theme/change', healOnTheme) } catch (err) { /* 事件名变了就只靠定时器 */ }
+        // auto 档：系统对比度偏好一变就重算（开 → 高对比档，关 → 回标准档）。
+        // 老浏览器没有 addEventListener 就退化为「下次任意重算时跟进」。
+        try {
+          if (contrastMq && typeof contrastMq.addEventListener === 'function') {
+            const onContrastChange = () => { applyAll('prefers-contrast'); emitHc() }
+            contrastMq.addEventListener('change', onContrastChange)
+          }
+        } catch (err) { /* 无 matchMedia 环境跳过 */ }
         try {
           healTimer = setInterval(() => {
             // 页面不可见时不做样式回读：容器里长时间后台驻留时，4 秒一次 getComputedStyle 是纯浪费
@@ -3549,6 +3772,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
                 dismissNotice,
                 subscribeCustom,
                 setCustomColor,
+                deriveFromAccent,
                 resetCustom,
                 getLangPref,
                 getLocale,

package/docs/DESIGN.md

@@ -17,7 +17,7 @@
 正文对比度：浅色承诺面（`00`/`60`）13.50–15.57（目标 12:1），深色承诺面（`950`/`875`）10.13–12.05（目标 10:1）。
 深色 `800`（模块面）与 `850`（次级深面）**不为正文兜底** —— 报表把它们按「政策外」单列（既不算达标也不算失败）：
 实测 6.20–9.70，物理上限 10.22–15.45，**AA 底线与 APCA 底线仍须过**（见下节）。
-三级与链接的浅色承诺目标都是 4.62（HC 7），深色分别是 **6.4**（HC 7.6）与 **6.4**（HC 7.6）。
+三级与链接的浅色承诺目标是 **4.85 / 4.95**（HC 7；4.62 的旧值在色觉缺陷模拟下会掉到 AA 以下，见「文字对比度在 CVD 下也守 AA」），深色分别是 **6.4**（HC 7.6）与 **6.4**（HC 7.6）。
 链接另加一道 APCA 门（深色 Lc ≥60 / HC ≥75）—— 它常在 `800` 模块面上出现，而 4.62 在深色 `800` 上
 只相当于 Lc≈48，见「链接」一节。
 
@@ -118,7 +118,7 @@
 | **物理上限** | 该承载面上黑或白前景能达到的对比度 | 纯计算，**不含**求解余量 |
 | **政策豁免** | 我们不承诺该面承载正文（深色 `800` / `850`） | 产品策略 |
 
-- 承诺目标（浅色）：正文 **12:1**、次级 **6.2**、三级 **4.62**、链接 **4.62**（高对比 15 / 9 / 7 / 7）。
+- 承诺目标（浅色）：正文 **12:1**、次级 **6.2**、三级 **4.85**、链接 **4.95**（高对比 15 / 9 / 7 / 7；后两项比 1.9.x 各抬了一档，见 CVD 一节）。
 - 承诺目标（深色）：正文 **10:1**、次级 **8.0**、三级 **6.4**、链接 **6.4**（高对比 15 / 9.6 / 7.6 / 7.6）。
   深色侧单独一套更高的下限，理由见「为什么深色要更高的比值」。
 - 承诺面：浅色 **00/60**，深色 **950/875**。
@@ -127,6 +127,11 @@
 - 物理上限只由计算得出。求解器里的 **0.93** 只是**求解余量**，仅用于判断「目标是否高于上限」，不混进上限本身。
 - **底线是硬的**：政策外的面也不许掉到 AA 4.5 以下；深色侧还要同时满足 APCA 的 Lc 下限
   （正文 60 / 次级 60 / 三级 45，实测已在 61.9–68.5）。
+- **注释层（`label-caption`，1.11.0）**：不在承诺模型的角色表里，但深色侧同样过 Lc 闸 ——
+  标准档 **Lc 60**（与链接同线）、HC 档 **70**（HC 三级文字 Lc 落在 72–77，注释套链接的 75 会反超三级、
+  破坏「注释弱于三级」的层级）。抬完标准档注释 WCAG 约 5.6–6.0，仍低于三级的 6.4；`tools/check-audit.mjs` 第 4 组守着。
+- **装饰层（`label-dimmed` / `label-document-preview`）**：按「装饰性文字」解到 **3.0**，刻意低于所有可读承诺 ——
+  宿主把它们用于占位/预览这类辅助场景；不在 `CONTRAST_ROLES` 承诺模型内，也不进报表（有意的政策外）。
 - 三个出口共用同一份数据：设置页 UI、报表 CLI（`palette-dev.mjs`）、审计断言（`tools/check-audit.mjs`）。
   单元格公开 `measured` / `declaredTarget` / `physicalCeiling` / `policyApplicable` / `limitedByPhysics` /
   `meetsFloor` / `apca` / `pass`；政策外的 `pass` 为 `null`（不算达标也不算失败）。
@@ -249,6 +254,63 @@ WCAG 2.x 的相对亮度比在暗底上**系统性高估**可读性。同一个
 
 三套预置在 achromat（全色盲）下的层间明度差仍保留（ΔE 3.7–5.9），层级不依赖色度。
 
+### 文字对比度在 CVD 下也守 AA（1.10.0）
+
+文字与承载面的对比度由**明度差**决定，配色只改色度与色相 —— 所以色觉缺陷理论上不该影响读数。
+`tools/check-audit.mjs` 第 20 组把这个「理论上」变成实测：四套配色 × 明暗 × 正文/次级/三级/链接 ×
+三个承载面 × deutan / protan / tritan（Machado 2009 线性矩阵），断言最低值 ≥ 4.5。
+
+这条断言当初**没过**，而且原因不在 CVD 本身：三级与链接的浅色下限原本就压在 **4.62**（刚过 AA、
+一点余量不留），而模拟会把同一对前景/背景的比值上下推动 5–9% —— 链接实测跌到 **4.22–4.34**，
+比 AA 还低。修法是把浅色下限抬到三级 **4.85**、链接 **4.95**，把这段浮动留给模型误差；
+抬完三种模拟下的最低值是 **4.61**。代价只是浅色链接与三级文字比 1.9.x 略深一档。
+
+## 三项「少让人做决定」的机制（1.10.0）
+
+### 高对比：跟随系统（`auto`）
+
+高对比档原有「关 / 开」两态，现在加 `auto` 并设为默认：系统开了「提高对比度」
+（`prefers-contrast: more`）就自动用高对比档，关掉就回标准档。`matchMedia` 的 `change` 事件一响
+就重算（`applyAll('prefers-contrast')`），不用刷新页面。
+手动选过「关 / 开」的用户读回的是自己的选择 —— 升级不会把他们的档位改掉；
+只有从没碰过这一项的用户落到 `auto`。
+
+### 自定义配色：由主色派生底色与文字
+
+用户往往只有一个「想要的品牌色」，让他自己配纸面与墨色既难也容易把对比度配坏。
+设置页的自定义面板多了一个「由主色派生」：拿当前强调色的**色相**、色度的 15%–22%（夹上限）
+推出纸面与墨色，明度按当前明暗模式取（亮 0.968 / 0.235，暗 0.165 / 0.935）——
+这几个值是引擎已验证过的区间，派生结果直接过全部下限（实测正文 14.6–15.0、次级 6.8–6.9、
+三级 5.3–5.4、链接 5.4–5.5）。主色无彩（C < 0.004）时派生中性纸面，
+避免「黑底 + 白字 + 黄强调派生出一套淡粉」那类老问题。
+
+### 运行时覆盖报告（`getCoverageReport`）
+
+诊断导出（设置页「复制诊断信息」）多一份 `coverage`：遍历宿主样式表里所有 `--dsw-*` 自定义属性，
+按四类分账 —— `ours`（本插件覆盖层接管）、`derived`（值是 `var(--dsw-…)` 引用，跟着基础 token 走）、
+`literalChromatic`（字面带彩色值，宿主语义色等，有意不染）、`literalGray`（字面灰值，是「跟配色」
+的候选）。它回答的是「宿主还有多少 token 没跟上配色」，只读、尽力而为：
+拿不到 `styleSheets`（沙箱、跨域）就返回 `{ ok: false }`，不影响其它诊断。
+
+## 宽色域（display-P3）：本期不做（1.10.0）
+
+sRGB 之外还有 P3 的色度余量，问题是「同一个 L/h 下 P3 能多给多少色度」以及「这些色度用不用得上」。
+用 OKLCH → XYZ → sRGB / P3 的数值求逆量了各档位（脚本在审计目录 `probe-p3-headroom-v2.mjs`）：
+
+| 档位 | 现用色度 C | sRGB 上限 | P3 上限 | 可加 ΔC | ΔE |
+|---|---|---|---|---|---|
+| 画布 00（暖砂 / 靛蓝 / 苔绿） | 0.0045 / 0.0034 / 0.0061 | 0.0099 / 0.0080 / 0.0289 | 0.0123 / 0.0088 / 0.0317 | 0.0025 / 0.0008 / 0.0028 | 0.25 / 0.08 / 0.28 |
+| 卡片 60 | 0.0107 / 0.0074 / 0.0114 | 0.0209 / 0.0132 / 0.0605 | 0.0262 / 0.0145 / 0.0658 | 0.0053 / 0.0013 / 0.0052 | 0.53 / 0.13 / 0.52 |
+| 内容面 150 | 0.0236 / 0.0139 / 0.0249 | 0.0898 / 0.0385 / 0.1697 | 0.1115 / 0.0422 / 0.1880 | 0.0217 / 0.0037 / 0.0183 | 2.17 / 0.37 / 1.83 |
+| 强调 500 | 0.1013 / 0.1071 / 0.0962 | 0.1369 / 0.2001 / 0.1684 | 0.1566 / 0.2530 / 0.1980 | 0.0196 / 0.0529 / 0.0296 | 1.96 / 5.29 / 2.96 |
+| 正文 1000 | 0.0127 / 0.0120 / 0.0105 | 0.0532 / 0.1548 / 0.0529 | 0.0616 / 0.1558 / 0.0727 | 0.0084 / 0.0009 / 0.0198 | 0.84 / 0.09 / 1.98 |
+
+结论：**纸面层（00/60）的 P3 余量在 JND 以下**（ΔE 0.08–0.53），用不用看不出来；
+真正能看出差别的是强调色（indigo ΔE 5.29、moss 2.96）。但强调色同时是链接、info 填充与勾选支点的来源，
+一旦按 P3 抬色度，就得为 sRGB 回退再标定一套（色域裁切会改色相，链接的 AA 读数要重算）。
+这一版的取舍是**不做**，把余量记在这里：将来若要做，只值得给强调色加
+`color(display-p3 …)` 一层并在 sRGB 里保持现值的双口径，纸面层不必动。
+
 ## 报表量的是屏幕上的字（1.9.8）
 
 报表要回答的是「屏幕上这条字看不看得清」，所以量的必须是**真正渲染出来的那个 token**，
@@ -266,8 +328,8 @@ WCAG 2.x 的相对亮度比在暗底上**系统性高估**可读性。同一个
 黑白配色不覆盖这些别名 → 全部回落色阶步进（本来就没有可测读数，报表整格记「未测量」）。
 
 **为什么必须这么量**：按步进值报，自定义配色下三级文字会被报成 **4.21**（低于 AA 4.5 的假警报），
-而实际渲染的覆盖值已被求解器兜到 ≥ **4.62**。1.9.8 改完之后，全部 **2160** 组配置
-（黑白 + 三套预置 + 自定义共 5 套配色 × 216 组设置 × 标准/高对比两档）里，
+而实际渲染的覆盖值已被求解器兜到 ≥ **4.62**。1.9.8 改完之后，全部组合配置
+（5 套配色 × 216 组设置 = **1080** 组，216 已含标准/高对比两档；1.9.10 撤右栏档前是 2160 组）里，
 低于 AA 4.5 底线的格子 = **0**，硬失败（pass=false）也是 **0**。
 
 **深色压暗面的修正**：只按 `950`/`875` 压暗时，暖砂标准档的三级文字在 `800`（模块面）上只有 **3.79**、

package/package.json

@@ -1,114 +1,116 @@
-{
-  "name": "dsh-theme-palette",
-  "version": "1.9.10",
-  "description": "DSH 主题配色：4 套配色 × 明暗两模式，OKLCH 色域安全重建 + 真实承载面对比度求解，可调强度与面板表面。",
-  "type": "module",
-  "main": "index.js",
-  "exports": {
-    ".": "./index.js",
-    "./client": "./client.js",
-    "./client.js": "./client.js",
-    "./index.js": "./index.js",
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./locale/*.json": "./locale/*.json",
-    "./icon": "./icon.svg",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "index.js",
-    "client.js",
-    "cordis.patch.yml",
-    "icon.svg",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md",
-    "docs/DESIGN.md",
-    "README-zh.md",
-    "README-es.md",
-    "README-pt.md",
-    "README-hi.md",
-    "locale"
-  ],
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.0",
-    "@deepseek-ai/dsh-client-ui-theme": "^0.2.1-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.2.1-rc.1"
-  },
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0",
-    "dsh": ">=0.2.1-rc.1"
-  },
-  "scripts": {
-    "check": "node tools/check-audit.mjs && node tools/check-custom.mjs && node tools/check-ui.mjs && node tools/check-host-contract.mjs && node tools/check-selfheal.mjs",
-    "report": "node palette-dev.mjs && node palette-dev.mjs --hc",
-    "packs": "node tools/export-theme-pack.mjs"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "immediately": true,
-      "inject": [
-        "@deepseek-ai/dsh-client-ui-theme",
-        "@deepseek-ai/dsh-client-ui-settings"
-      ]
-    },
-    "compatibility": {
-      "dsh": ">=0.2.1-rc.1",
-      "dshReleases": {
-        "0.2.1-rc.2": "compatible"
-      },
-      "dshOperations": {
-        "0.2.1-rc.2": {
-          "install": "passed",
-          "start": "passed",
-          "uninstall": "unknown",
-          "rollback": "unknown"
-        }
-      },
-      "profiles": [
-        "desktop",
-        "web"
-      ]
-    }
-  },
-  "keywords": [
-    "dsh",
-    "dsh-plugin",
-    "deepseek-harness",
-    "theme",
-    "palette",
-    "oklch",
-    "dark-mode"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zuoyunlai/dsh-theme-palette.git"
-  },
-  "homepage": "https://github.com/zuoyunlai/dsh-theme-palette#readme",
-  "bugs": {
-    "url": "https://github.com/zuoyunlai/dsh-theme-palette/issues"
-  },
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org"
-  },
-  "packageManager": "pnpm@11.7.0",
-  "peerDependenciesMeta": {
-    "@deepseek-ai/cordis": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-client-ui-theme": {
-      "optional": true
-    },
-    "@deepseek-ai/dsh-client-ui-settings": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "semver": "^7.7.3"
-  }
-}
+{
+  "name": "dsh-theme-palette",
+  "version": "1.11.0",
+  "description": "DSH 主题配色：4 套配色 × 明暗两模式，OKLCH 色域安全重建 + 真实承载面对比度求解，可调强度与面板表面。",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./client.js": "./client.js",
+    "./index.js": "./index.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "assets",
+    "cordis.patch.yml",
+    "icon.svg",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "docs/DESIGN.md",
+    "README-zh.md",
+    "README-es.md",
+    "README-pt.md",
+    "README-hi.md",
+    "locale"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.0",
+    "@deepseek-ai/dsh-client-ui-theme": "^0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.2.1-rc.1"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.2.1-rc.1"
+  },
+  "scripts": {
+    "check": "node tools/check-audit.mjs && node tools/check-custom.mjs && node tools/check-ui.mjs && node tools/check-host-contract.mjs && node tools/check-selfheal.mjs && node tools/check-colormath.mjs",
+    "report": "node palette-dev.mjs && node palette-dev.mjs --hc",
+    "packs": "node tools/export-theme-pack.mjs",
+    "shots": "node tools/shoot-settings.mjs"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-theme",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ]
+    },
+    "compatibility": {
+      "dsh": ">=0.2.1-rc.1",
+      "dshReleases": {
+        "0.2.1-rc.2": "compatible"
+      },
+      "dshOperations": {
+        "0.2.1-rc.2": {
+          "install": "passed",
+          "start": "passed",
+          "uninstall": "unknown",
+          "rollback": "unknown"
+        }
+      },
+      "profiles": [
+        "desktop",
+        "web"
+      ]
+    }
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "theme",
+    "palette",
+    "oklch",
+    "dark-mode"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zuoyunlai/dsh-theme-palette.git"
+  },
+  "homepage": "https://github.com/zuoyunlai/dsh-theme-palette#readme",
+  "bugs": {
+    "url": "https://github.com/zuoyunlai/dsh-theme-palette/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "packageManager": "pnpm@11.7.0",
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-theme": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-settings": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "semver": "^7.7.3"
+  }
+}