背景
KnowledgeFlow 当前只有单一黑金主题,所有颜色硬编码在 CSS 中,无主题切换能力。学习场景下用户会长时间盯着 Markdown 正文,高对比黑金加速视疲劳;白天明亮教室与晚上昏暗宿舍共用同一界面,无法适配环境光。
需求
为提升学习效率,添加 3 套预设主题 + 系统跟随:
- Obsidian(默认·现状保留):黑金奢华,夜间/品牌展示
- Parchment(米黄纸):长时间阅读/白天柔和,模拟旧书纸
- Daylight(清亮白):强光环境/偏好浅色,保留金色作品牌锚点
- System:跟随
prefers-color-scheme,首次访问自动选择
技术方案:CSS 变量 + data-theme 属性切换,偏好持久化到 settingsStore,防 FOUC。
验收
- 三套主题切换无视觉断裂,全站(含着陆页)颜色一致变化
- 刷新后主题保持,无首帧闪烁
- 首次访问时深色系统→Obsidian,浅色系统→Daylight
prefers-color-scheme 变化时(且 theme=system)实时跟随
- 现有黑金视觉与切换前像素级一致
SDD 产物
- Spec:
docs/superpowers/specs/2026-06-23-theme-system-design.md
- Plan:
docs/superpowers/plans/2026-06-23-theme-system-implementation.md
背景
KnowledgeFlow 当前只有单一黑金主题,所有颜色硬编码在 CSS 中,无主题切换能力。学习场景下用户会长时间盯着 Markdown 正文,高对比黑金加速视疲劳;白天明亮教室与晚上昏暗宿舍共用同一界面,无法适配环境光。
需求
为提升学习效率,添加 3 套预设主题 + 系统跟随:
prefers-color-scheme,首次访问自动选择技术方案:CSS 变量 +
data-theme属性切换,偏好持久化到 settingsStore,防 FOUC。验收
prefers-color-scheme变化时(且 theme=system)实时跟随SDD 产物
docs/superpowers/specs/2026-06-23-theme-system-design.mddocs/superpowers/plans/2026-06-23-theme-system-implementation.md