# 壁纸颜色提取 + 卡片自适应 — 需求契约

> 创建时间：2026-05-28
> 状态：需求已确认

## 目标

从当前壁纸自动提取主色调，动态调整信息卡片的文字颜色和背景，确保在任何壁纸上都可读。

## 用户场景

1. 用户切换壁纸后，卡片文字颜色自动适配（深色壁纸白字、浅色壁纸黑字）
2. 卡片背景增加半透明遮罩，提升文字可读性
3. 用户无需手动调色，全程自动

## 验收标准

- [ ] 壁纸切换后 1s 内完成颜色提取
- [ ] 文字颜色自动切换：深底白字 / 浅底黑字
- [ ] 卡片背景增加自适应半透明遮罩
- [ ] 支持所有壁纸类型（主题/图片/Bing/视频/颜色）
- [ ] 提取结果缓存，同一壁纸不重复计算

## 本次范围

- 壁纸主色调提取
- 卡片文字颜色自适应
- 卡片背景遮罩

## 非目标

- 完整调色板提取（只取主色调）
- 用户手动覆盖颜色

## 约束

- 前端 Canvas 采样，不依赖 Go 端图像处理
- 采样频率：壁纸切换时触发一次
- 不影响壁纸渲染性能

## 技术方案

- 壁纸切换后，Canvas 绘制壁纸帧 → 采样若干像素点 → 取平均值 → 判断明暗
- 前端状态管理增加 `isDarkWallpaper` 变量
- 卡片组件根据 `isDarkWallpaper` 切换 CSS class