跳到主要内容

主题

MintCat 支持主题切换，用于调整界面色彩和视觉风格。主题设置保存在本地配置中，导入旧配置后也会尝试恢复。

切换主题​

  1. 打开 MintCat。
  2. 进入 设置 页。
  3. 找到 MintCat Settings。
  4. 在主题选项中选择目标主题。
  5. 保存后界面会立即刷新或在下次启动时生效。

内置主题​

当前项目包含多套样式资源，常见主题包括：

  • 默认主题。
  • 深色主题。
  • 蓝色主题。
  • 粉色主题。
  • 紫色主题。

实际可选项以应用内设置页显示为准。

主题文件​

项目中的主题资源主要位于：

  • src/themes/default.ts
  • public/themes/dark-theme.css
  • public/themes/blue-theme.css
  • public/themes/pink-theme.css
  • public/themes/purple-theme.css

普通用户无需手动编辑这些文件。开发者可以基于这些文件扩展新主题。

自定义主题建议​

如果需要制作新主题，建议遵循以下原则：

  • 保证文字与背景对比度足够。
  • 保持按钮、输入框、列表选中态可识别。
  • 不要只依赖颜色表达状态，错误、警告、成功状态应有清晰区分。
  • 在首页、搜索页、设置页、弹窗中都检查效果。

导入配置后的主题刷新​

配置导入完成后，MintCat 会刷新主题和语言，使界面尽量立即反映迁移后的设置。

如果导入后主题没有变化：

  1. 进入设置页手动切换一次主题。
  2. 保存设置。
  3. 重启应用。

常见问题​

主题切换后部分区域颜色不一致​

可能是某个组件没有完整适配当前主题。可以切换到默认主题确认是否恢复，并反馈具体页面截图。

自定义 CSS 修改后无效​

如果你是开发者，请确认：

  • 文件路径正确。
  • 样式被应用加载。
  • 没有被 Ant Design 或更高优先级样式覆盖。
  • 构建产物已刷新。

深色主题下文字看不清​

优先切回默认主题或蓝色主题。反馈问题时请提供主题名称、页面位置和截图。