主题模式与对比度
Scholarly 将配色身份和可读性 token 分开处理。用 colorTheme 控制品牌感， 用 colorMode 控制普通页面背景，用 sectionMode 控制章节分隔页。
推荐默认值
yaml
themeConfig:
colorTheme: classic-blue
fontTheme: classic
colorMode: light
sectionMode: dark- 引用、正文、图表密集的页面优先使用
colorMode: light。 - 章节分隔页可以使用
sectionMode: dark，前提是文字足够大。 - 明亮会议室或投影效果不稳定时使用
high-contrast。 - 截图、图表或代码应成为视觉主体时可使用
monochrome。
quote 与 Highlight 安全规则
最容易出问题的组合是：页面正文为深色文字，但 quote、Highlight 或语义块背景也偏深。 P0 token 模型已经把 quote、Highlight、Block 和组件 surface 映射到 mode-aware semantic tokens，但写作者仍应避免在浅色页面上使用大面积深色高亮。
推荐做法：
- Highlight 只用于短语，不用于整段。
- 需要标题和正文时用 Block 或 EvidenceBlock。
type="warning"只用于真正的警告；普通强调优先用type="info"或type="primary"。- 导出前用
high-contrast做一次可访问性检查。
快速检查
分享前运行 doctor 和视觉导出：
bash
sch doctor
pnpm run theme:matrix如果只需要快速检查 matrix 是否可生成：
bash
node scripts/check-theme-matrix.mjs --dry-run