dsh-theme-palette 1.9.10 → 1.10.0

package/CHANGELOG.md

@@ -4,6 +4,19 @@
 
 ## 版本一览
 
+### 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,7 +69,7 @@ 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).

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,7 +69,7 @@ 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 सेटिंग × दोनों कंट्रास्ट स्तर)।

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,7 +69,7 @@ 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).

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,7 +70,7 @@ 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。

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,7 +70,7 @@ 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`.

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.10.0'
     const STORE_KEY = 'dsh-theme-palette.v1'
     const OVERRIDE_SOURCE = 'dsh-theme-palette'
 
@@ -238,10 +238,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 +526,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 +750,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 这种大面积色块——不能整块换成主题色，
@@ -1862,6 +1926,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 +2150,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
     }
@@ -2222,10 +2288,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.10.0：高对比档新增「跟随系统」（系统开提高对比度就自动切高对比）；自定义配色可「由主色派生」底色与文字；三级与链接的浅色下限抬高，色觉缺陷模拟下也守 AA；诊断信息新增覆盖报告。',
         dismiss: '知道了',
         explainClamp: '强调色已归一化：{from} → {to}（保证按钮与勾选可读）',
         explainLink: '链接已为可读性压暗：{ratio}:1（目标 {target}:1）',
+        explainCvd: '色觉缺陷提示：{kind} 视觉下强调色与底色/文字几乎同色（ΔE {dE}）。文字仍可读，但按钮与色块会分不开；换一个更亮或更暗的强调色即可。',
         preview: '预览',
         sample: '试试示例',
         copyDiag: '复制诊断',
@@ -2261,7 +2331,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 +2356,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.10.0：高對比檔新增「跟隨系統」（系統開提高對比度就自動切高對比）；自訂配色可「由主色派生」底色與文字；三級與連結的淺色下限抬高，色覺缺陷模擬下也守 AA；診斷資訊新增覆蓋報告。',
         dismiss: '知道了',
         explainClamp: '強調色已正規化：{from} → {to}（確保按鈕與勾選可讀）',
         explainLink: '連結已為可讀性壓暗：{ratio}:1（目標 {target}:1）',
+        explainCvd: '色覺缺陷提示：{kind} 視覺下強調色與底色/文字幾乎同色（ΔE {dE}）。文字仍可讀，但按鈕與色塊會分不開；換一個更亮或更暗的強調色即可。',
         preview: '預覽',
         sample: '試試示例',
         copyDiag: '複製診斷',
@@ -2325,7 +2399,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 +2424,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.10.0: high contrast gains "follow the system" (switches automatically when the OS increases contrast); custom palettes can "derive from accent" to fill in background and text; lighter-tier floors for tertiary text and links are raised so the AA floor also holds under colour-vision simulation; diagnostics now include a coverage report.',
         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 +2467,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 +2492,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.10.0：ハイコントラストに「システムに従う」を追加（OS のコントラスト強化に自動追従）。カスタム配色は「メイン色から生成」で背景色と文字色を導出できます。三次テキストとリンクの明るい側の下限を引き上げ、色覚シミュレーション下でも AA を維持。診断情報にカバレッジレポートを追加。',
         dismiss: '了解',
         explainClamp: 'アクセント色を正規化しました：{from} → {to}（ボタンとチェックの可読性のため）',
         explainLink: 'リンクを可読性のため暗くしました：{ratio}:1（目標 {target}:1）',
+        explainCvd: '色覚のヒント：{kind} ではアクセント色が背景・文字とほぼ同色になります（ΔE {dE}）。文字は読めますが、ボタンと色面は見分けにくくなります。もっと明るい／暗いアクセント色に変えてください。',
         preview: 'プレビュー',
         sample: 'サンプルを試す',
         copyDiag: '診断をコピー',
@@ -2453,7 +2535,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 +2550,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 +2562,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 +2574,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 +2586,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 +2723,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 +2793,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 +3122,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, 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 {
@@ -3141,9 +3232,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 +3446,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 +3454,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 +3466,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 +3477,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 +3540,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 })
         }
@@ -3410,6 +3567,22 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
           emitCustom()
           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
+        }
         const setHcMode = (id) => {
           if (!HC_MODES.some((m) => m.id === id)) return
           hcMode = id
@@ -3477,6 +3650,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 +3730,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**。
@@ -249,6 +249,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**，

package/package.json

@@ -1,114 +1,115 @@
-{
-  "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.10.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",
+    "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"
+  }
+}