Skip to content

添加 3 套主题切换系统提升学习效率 #4

Description

@ceilf6

背景

KnowledgeFlow 当前只有单一黑金主题,所有颜色硬编码在 CSS 中,无主题切换能力。学习场景下用户会长时间盯着 Markdown 正文,高对比黑金加速视疲劳;白天明亮教室与晚上昏暗宿舍共用同一界面,无法适配环境光。

需求

为提升学习效率,添加 3 套预设主题 + 系统跟随:

  1. Obsidian(默认·现状保留):黑金奢华,夜间/品牌展示
  2. Parchment(米黄纸):长时间阅读/白天柔和,模拟旧书纸
  3. Daylight(清亮白):强光环境/偏好浅色,保留金色作品牌锚点
  4. 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions