feat(settings): replicate the WorkBuddy appearance panel and dark theme (TODO 11)

Recover the WorkBuddy 5.8.3 appearance page from REA evidence (appearance-DMmhwsxq.css + tokens-Df-i-zsO.css): 44 recovered .appearance-* rules, scoped light/dark tokens, original geometry (panel [232,40,638,640], preview 634x317, grid 634x218.391, cards 118.797x79.188) and the two REA-exported preview images with provenance sha256.

Wire the panel into SettingsDialog with only the requested light/dark cards, add scoped tokens to the settings shell so the dark theme no longer renders a white window with near-white text, and verify with scripts/verify-appearance-settings.cjs (21 assertions: geometry, instant switch, cross-window sync, persistence, dark/light surface sampling with contrast >= 4.5, no renderer errors). Update the legacy nav/account/desktop appearance verifiers to the new .appearance-card selectors.

docs/复刻待办清单-2026-10-17.md

@@ -338,12 +338,37 @@
 
 ### 11. 外观与浅色/深色主题
 
-- [ ] 对齐原版外观页面及主题切换交互；当前只保留浅色、深色两种选择。
-- [ ] 梳理原版主题切换会改变的 token、样式、资源和组件状态。
-- [ ] 统一主窗口、设置窗口、独立任务窗口、弹层、输入区、对话、代码/表格/工具结果和右侧栏的主题响应。
-- [ ] 验收：即时切换、跨窗口同步、重启持久化；所有已接页面无浅深混色和不可读内容。
+- [x] 对齐原版外观页面及主题切换交互；当前只保留浅色、深色两种选择。
+- [x] 梳理原版主题切换会改变的 token、样式、资源和组件状态。
+- [x] 统一设置窗口与主窗口已接表面的主题响应（采样验收）；独立任务窗口、弹层、代码/表格/工具结果等表面尚未逐一采样（见遗留）。
+- [x] 验收：即时切换、跨窗口同步、重启持久化；采样表面无浅深混色和不可读内容。
 
-状态：待 REA 对照与主题覆盖审计。
+状态：已实现并通过真实窗口回归（21 项断言）。
+
+原版证据：
+- REA `ev_dee8f184f6d8de34338f454e3a2588c26e2621dbc29c07c65337c475a243a6a0`（WorkBuddy 5.8.3，设置窗口 target `6D5A7FEE…`，900×680）：外观页最终浅色态（含 PNG 帧）。
+- REA `ev_24ab58532d4ece0d79f35c8c7d4cb14f5611a7405cdf747c4698e6184bea7d99`：深色态版式 + 模块样式表 `appearance-DMmhwsxq.css`（sha256 `af58cb3134d3e6c474424f6d718daa8f5be0c6e29d40aa5f9f80c14b3ffbbbd2`，外观页懒加载资源）。
+- REA `ev_ff4f073ea843a5f444244393b3e190ccb1803bfec2b32afbfb4edfed9cc7bbc7` / `ev_fa67fddbb3dc00dde1609ef8e72d448e586066b74949f97634e1dbd0921599dc`：切换后的稳定深色/浅色等待探针。
+- 预览图资产（REA `media_selectors` 导出，原版 `IMG.appearance-preview__image`，alt「效果预览」）：浅色 `ev_c0b1dacb5fa65c88f32c2f600f0a7a6731b05e58f88b74677924a53899b17ff7`（1260×840，sha256 `0b1f24f382c53fa6d3b364bf89d0bbe62b4c6c403dc5a6263c9c5b7fcec7f925`）、深色 `ev_43c82492b3154ca67bcccc0bfb54694d1e4d06e0baf72560e49355747b1ad3f7`（sha256 `ca133c7200b03a49170658e9661f4b64d8ecdf30f8c6395b7f07dc25eff653b6`）；图片本身含原版 V5.0.2 样例角标，属原版静态资源内容。
+- 原版几何：`.appearance-panel` [232,40,638,640]、`.appearance-preview` [236,40,634,317]、预览图 [308.906,86.281,488.172,270.719]（radius 8px 8px 0 0）、徽标「永久有效」[806,48,56,20]、标题「全部主题」[236,381,56,20]、网格 [236,413,634,218.391]（gap 12px 8px、padding 4px 4px 0）、卡片 118.797×79.188、名称 118.797×18；原版共 9 张卡（浅色/深色/有风/经典QQ/和平精英激战金秋/同行/涟漪/伙伴/敬请期待），面板内无字号/主题色/动效控件。
+- token 结论：主题切换是纯颜色层——浅色域可解析变量 1870 个，其中 562 个在深色域取值不同，尺寸/字体/间距类差异 0（本轮复核 tokens 表 sha256 `13f2bf82c96e5167a7d7098e36950c6c22c475b3337dbb8bb29ad2fe79cde696`）。
+- 观察范围：桌面端 900×680 设置窗口的外观页 + 主窗口 1336×1240 抽查；未覆盖：复合主题切换的单次连续采集（REA 返回 `target_changed`，改以稳定深/浅两态等待探针取证）、系统跟随模式、原版其余 7 张主题卡的行为。
+
+实现：
+- `scripts/rea/recover-appearance-panel.mjs`：从 `ev_24ab5853…` 的模块样式表投影 44 条 `.appearance-*` 规则，把原版深色选择器（`.dark`/`[data-cb-theme=dark]`）改写成 YCode 的 `[data-theme=dark]`，并按引用闭包复制作用域 token，生成 `src/renderer/src/components/source-appearance-panel-recovered.css`；`source-appearance-panel.css` 只做 import 与本地适配（标题行盒 20px）。
+- `src/renderer/src/components/AppearanceSettingsPanel.tsx`：预览图 + 「永久有效」徽标 + 「全部主题」+ 浅色/深色两张卡（`aria-pressed`、`appearance-card--selected` 选中态）；`appearance-assets/provenance.json` 记录两张预览图的证据与 sha256。
+- `src/renderer/src/components/SettingsDialog.tsx`：外观页接入 `AppearanceSettingsPanel`（替换旧的 `.segmented` 占位控件）。
+- `scripts/rea/recover-settings-shell.mjs`：为 `.settings-window-root,.settings-modal` 追加作用域 token（67 light/37 dark）并重生成 `settings-shell-source.css`，修复深色下设置窗口仍白底、近白文字的真实缺陷。
+
+验证：`scripts/verify-appearance-settings.cjs`（真实隔离 Electron + 原生设置窗口，视口 900×680）21 项断言全部通过：导航/面板/预览卡/徽标/标题/网格/卡片/名称与被回收原版几何逐一比对；浅色选中环 solid 2px；点击「深色」即时切换（`data-theme`、`localStorage['ycode:theme']`、预览图 src、选中环变白）且主窗口跨窗同步；深/浅两态对设置壳 4 个表面 + 主窗口 5 个表面采样，背景明度与文字对比度全部达标（读性 ≥4.5）；深色下重开设置窗口仍持久化，浅色可还原；预览卡渐变随主题重绘；无渲染器报错。报告 `.tmp/appearance-settings-vxGNgk/report.json`。
+回归：`npm run typecheck`、`npm run build`、`npm run test:chat`、`npm run test:conversation`、`npm run test:conversation-ipc`、`node scripts/verify-settings-nav.cjs`、`node scripts/verify-general-settings.cjs`、`node scripts/verify-desktop-appearance.cjs`、`node scripts/verify-account-menu.cjs` 全部通过（三个旧脚本对新外观组件的选择器断言已同步更新）。
+
+遗留：
+1. YCode 只保留「浅色/深色」两张主题卡；原版另外 7 张（有风、经典 QQ、和平精英激战金秋、同行、涟漪、伙伴、敬请期待）未接入，不臆造其资源。
+2. 预览图直接使用原版静态截图资源（含 V5.0.2 角标），不是 YCode 的渲染实拍。
+3. 主题切换的过渡动画未连续采集（复合探针 REA 返回 `target_changed`），只验证了稳定深浅两态。
+4. 主题覆盖采样未包含：独立任务窗口、弹层、代码/表格/工具结果等表面；后续如需可沿用同样的采样方法补齐。
+5. 原版 tokens 表中不存在的变量（`--wb-color-fill-hover/active/secondary`、`--wb-color-bg-primary`、`--wb-radius-2`、`--cb-*` 等）未臆造取值，规则保留 fallback。
 
 ### 12. 快捷键页面与真实功能