fix(a11y): 面板对比度达标 WCAG AA，改用面板自己的语义色层（#178）

AGENTS.md

@@ -60,6 +60,7 @@ dsh-mneme 是 DSH 宿主的记忆插件（蒸馏 / 注入 / 检索 / 巩固 / sc
 6. 提交署名可归属与 AI 内容核验义务见 [CONTRIBUTING](CONTRIBUTING.md)（硬性要求）；
 7. **发布/打包只在 `dsh-mneme/` 包目录内执行**——根目录历史上发出过坏包（0.6.9、0.7.0–0.7.10），此条为防复发红线；
 8. **注释写「为什么」，不写「是什么」**：非常规实现、防御段、行为开关的动机（issue 编号、消融数据、基准数字）必须落注释，代码含义靠命名与测试名表达；测试同样适用——锁形状/锁字面量的用例要注释写清它在防哪类回归（例：`test/recall-evals.test.js` 的 signals 形状锁）。
+9. **面板配色走 `--mneme-*` 语义色层**：宿主 `label-tertiary` / `label-dimmed` 是分隔线/占位符用的低对比层，**不是正文色**，直接拿来当 `color` 会在浅色或深色主题下掉到 AA 以下（#178 实测 70 条）。正文与图形一律用 `.mneme-x,.mneme-overlay,.mneme-triggerwrap,.mneme-topentry` 上定义的语义变量；新增或改动颜色后 `test/contrast.test.js` 会自动重算全部 `color` 声明的对比度（解析不出的颜色记失败，不静默跳过），并锁死「引用的 `--dsw-*` 必须真实存在」「四个渲染根一个不少」「图形色按 3:1」「虚线边不得靠 `opacity` 区分」。
 
 ## 闸门清单
 

README.md

@@ -10,7 +10,7 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-3E63DD?style=flat-square" alt="license"></a>
   <a href="https://github.com/slow-stack/mneme/actions"><img src="https://img.shields.io/github/actions/workflow/status/slow-stack/mneme/ci.yml?style=flat-square&label=CI" alt="CI"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-22%2B-3E63DD?style=flat-square&logo=nodedotjs&logoColor=white" alt="node"></a>
-  <a href="https://github.com/slow-stack/mneme"><img src="https://img.shields.io/badge/tests-1615%20passed-3E63DD?style=flat-square" alt="tests"></a>
+  <a href="https://github.com/slow-stack/mneme"><img src="https://img.shields.io/badge/tests-1620%20passed-3E63DD?style=flat-square" alt="tests"></a>
   <a href="https://codecov.io/gh/slow-stack/mneme"><img src="https://img.shields.io/codecov/c/github/slow-stack/mneme/main?style=flat-square" alt="coverage"></a>
   <a href="https://github.com/awesome-dsh-plugin/awesome-dsh-plugin"><img src="https://awesome-dsh-plugin.com/badge.svg" alt="Awesome"></a>
 </p>
@@ -207,7 +207,7 @@ dsh-mneme-serve          # 默认 ~/.dsh/memory + 127.0.0.1:8790
 
 ```bash
 cd dsh-mneme && npm install
-npm test        # 1615 个测试
+npm test        # 1620 个测试
 npm run stress  # 三轴线压测
 npm run sync    # src → lib 同步
 ```
@@ -414,7 +414,7 @@ Community projects that wire mneme into more platforms — not part of this repo
 
 ```bash
 cd dsh-mneme && npm install
-npm test        # 1615 tests
+npm test        # 1620 tests
 npm run stress  # three-axis stress test
 npm run sync    # src → lib sync
 ```

dsh-mneme/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## [Unreleased]
 
+## 🐛 修复
+
+- **面板文字对比度全面达标 WCAG AA（issue #178）**：面板有 270 条 `color` 声明，此前 **70 条**在浅色或深色主题下达不到 AA（正文 4.5:1、大字号 3:1；浅色 65 条、深色 5 条，最差的两条 `.mneme-statfoot` 只有 1.26 / 1.64）。根因是面板直接拿宿主的**标签层** token 当正文色（`label-tertiary` 50 处、`label-dimmed` 4 处）：这些是给分隔线/占位符用的低对比层，不是正文层。另有三处**图形**同病（不在文字口径内，按 3:1 复核）：热度条与热度点的冷档用 `label-dimmed` 压在热度轨道上只有 1.14:1、关系图连线描边 1.26:1，等于把三档热度画成同一个看不见的灰。修法不是逐条换颜色，而是在四个渲染根上定义**面板自己的语义色层**：`.mneme-x,.mneme-overlay,.mneme-triggerwrap,.mneme-topentry{…}` 六条 `--mneme-*`（`fg-dim` / `graphic-dim` / `accent` / `danger` / `warn` / `ok`），每条都用 `color-mix()` 从宿主 token 混出——`fg-dim` = `label-primary` 60% + 透明（浅 4.94 / 深 6.30），其余同法。**四个根一个都不能少**：`.mneme-overlay` 与 `.mneme-topentry` 是 `createPortal` 出来的独立子树，`.mneme-triggerwrap` 挂在宿主 sidebar footer 插槽，只挂 `.mneme-x` 的话这三个根拿不到变量、静默退回旧色。顺带修掉 **5 个幻影 token**（`--dsw-alias-state-error` 19 处、`state-warning` 14 处、`state-success` 3 处、`border` 2 处、`state-warn` 1 处）：这些名字宿主从未定义过，一直靠 CSS 兜底字面量在跑，宿主改配色时面板不会跟——现全部换成真名（`state-error-primary` / `static-amber-600` / `border-l1` 等）。另需分清：`label-dimmed`（4 处）与 `label-tertiary`（50 处）**都是真实存在的宿主 token**，问题不在名字而在用法——宿主把它们定位成分隔线/占位符的低对比层，面板却拿来当正文与图形色。三处 knockout 配色一并修：`.mneme-conflict-primary` 浅色主题下白字压品牌蓝 `#4176e6` 只有 4.23:1，底色换成 `--mneme-accent`（浅 5.32 / 深 7.67）；`.mneme-entrybadge` 深色主题下 `bg-layer-1` 压 `#c33` 只有 3.06:1，底色换成 `--mneme-danger`；`.mneme-btndangerconfirm` 底色同步换成 `--mneme-danger`，并把写死的 `#fff` 换成 `var(--dsw-alias-bg-layer-1)`——它旧的写死白字只在旧底色上侥幸过关，底色一变浅就会在深色主题掉到 2.67:1。回归锁 `test/contrast.test.js` 五条：①把宿主 token 的浅/深取值快照硬编码进测试（CI 上没有宿主包，读不到 asar），逐条重算全部 `color` 声明的对比度，两主题都必须过，**解析不出的颜色记失败而不是跳过**（否则改成 `var(--mneme-unknown)` 就能静默溜过）；②面板引用的每个 `--dsw-*` 必须在快照表里存在（幻影名回归锁）；③语义色层的选择器必须恰好是那四个根（少了根主锁照样全绿——主锁只算颜色，不知道变量有没有继承到）；④图形色（`background` / `stroke`，非 `color`）单独按 3:1 复核——热度条、热度点、打卡点、关系图连线都不在主锁的视野里；⑤虚线关系边不得靠 `opacity` 区分（无 `memory_id` 的边同时命中 `.mneme-gedge` 与 `.mneme-gedge-dashed`，后者的 `opacity:.7` 把 50% 描边压到浅色 2.28，而图形锁只读单条规则、看不见这种叠加）。变异检验七条：改淡 `fg-dim`、一处正文用回宿主标签色、塞回幻影名、渲染根少挂一个、热度冷档改回宿主 `label-dimmed`、一条 `color` 改成解析不出的 `var(--mneme-unknown)`、虚线边加回 `opacity:.7`，七条锁分别转红。
+
 ## [0.8.15] - 2026-10-10
 
 ## 🆕 新增

dsh-mneme/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/@modusensus/dsh-mneme?color=blue&label=npm)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
 [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
 [![Awesome](https://awesome-dsh-plugin.com/badge.svg)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)
-[![tests](https://img.shields.io/badge/tests-1615%20passed-success)](https://github.com/slow-stack/mneme)
+[![tests](https://img.shields.io/badge/tests-1620%20passed-success)](https://github.com/slow-stack/mneme)
 [![CI](https://img.shields.io/github/actions/workflow/status/slow-stack/mneme/ci.yml)](https://github.com/slow-stack/mneme/actions)
 [![node](https://img.shields.io/badge/node-22%2B-blue)](https://nodejs.org)
 [![npm downloads](https://img.shields.io/npm/d18m/@modusensus/dsh-mneme.svg?color=blue&label=downloads)](https://www.npmjs.com/package/@modusensus/dsh-mneme)
@@ -613,7 +613,7 @@ src/
 ├── api.js            # HTTP 路由（Web 面板数据通道，含 /conflicts 冲突队列）
 └── index.js          # 插件接线
 lib/                  # src 的同步分发产物（npm run sync；发布前由 root prepack 的 check-sync.js 校验一致性；唯一手写例外 lib/client.js——Web 面板 bundle，sync 不覆盖）
-test/                 # 1615 个 node:test 测试（审计与三轴线压测不变量；src↔lib 一致性由 scripts/check-sync.js 发布闸门校验）
+test/                 # 1620 个 node:test 测试（审计与三轴线压测不变量；src↔lib 一致性由 scripts/check-sync.js 发布闸门校验）
 scripts/              # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压测 · sync-lib.js 同步 · check-sync.js 发布闸门 · benchmark-recall.js / benchmark-embed.js / benchmark-rerank.js 基准 · sync-test-badge.mjs 测试徽章 · build-runtime-manifest.mjs 运行时清单
 ```
 
@@ -622,7 +622,7 @@ scripts/              # e2e-dsh.js 端到端演示 · stress-dsh.js 三轴线压
 ```bash
 cd dsh-mneme
 npm install        # 安装 peer 依赖（以 devDependencies 形式，用于本地测试）
-npm test           # 运行 1615 个测试
+npm test           # 运行 1620 个测试
 npm run stress     # 三轴线压测：长会话检索 / 冲突仲裁 / 多 Agent 并发（离线 mock LLM）
 npm run sync       # 把 src/ 同步到 lib/（发布时由 prepack 钩子自动执行）
 ```