Adaptive Lighting 新手指南：打造会呼吸的智能灯光系统

核心价值：让灯光随日出日落自然律动

Adaptive Lighting 是一款为 Home Assistant 设计的智能灯光控制组件，它能模拟自然光的变化规律，自动调节灯光的亮度和色温。想象一下：清晨，灯光从柔和的暖色调逐渐转变成清爽的冷白光，唤醒你的生物钟；黄昏时分，灯光又悄悄切换回温暖模式，帮助你放松身心。这种顺应自然节律的照明方式，不仅能提升生活品质，还可能改善你的睡眠质量和日常状态。

场景化问题与解决方案

问题一：如何让灯光成为你的私人作息助手？

你是否遇到过这样的困扰：冬天清晨在刺眼的冷光灯下醒来，一整天都感觉昏沉？或者深夜起夜时，突然亮起的强光让你难以再次入睡？Adaptive Lighting 正是为解决这类问题而生。

目标：将 Adaptive Lighting 集成到 Home Assistant 系统，建立基础的智能照明控制。

操作步骤：

1. 通过 HACS 安装
   🔍 检查点：确保已安装 HACS（Home Assistant Community Store）
   在 Home Assistant 界面中打开 HACS → 点击"集成" → 搜索"Adaptive Lighting" → 点击"安装"
   ✅ 成功标志：组件出现在已安装集成列表中

2. 基础配置
   🔍 检查点：确认 Home Assistant 配置文件可编辑
   在 configuration.yaml 中添加基础配置块：
   adaptive_lighting:
latitude: 你的纬度（如 39.9042）
   longitude: 你的经度（如 116.4074）
   lights:
- light.living_room（替换为你的灯光实体ID）
   ✅ 成功标志：配置检查无错误，保存后重启 Home Assistant

常见错误排查：

• 若提示"实体不存在"：检查灯光实体ID是否正确（可在开发者工具→状态中查找）
• 若配置不生效：确保 latitude/longitude 格式正确（使用小数形式，北纬东经为正）

问题二：如何让灯光响应你的生活场景？

你是否遇到过这样的场景：下班后到家，迎接你的却是昏暗的灯光；或者深夜阅读时，需要手动调整灯光亮度和色温？Adaptive Lighting 可以根据不同时段自动优化照明效果。

目标：配置灯光随日出日落自动调节，实现场景化照明。

操作步骤：

1. 高级参数配置
   🔍 检查点：已完成基础配置并正常运行
   在 configuration.yaml 中扩展配置：
   adaptive_lighting:
...（保留原有基础配置）
   min_brightness: 20（最低亮度百分比）
   max_brightness: 90（最高亮度百分比）
   min_color_temp: 2200（最低色温K值，暖光）
   max_color_temp: 6500（最高色温K值，冷光）
   ✅ 成功标志：重启后观察灯光在不同时段自动变化

2. 验证自动调节效果
   🔍 检查点：系统时间与实际地理位置匹配
   等待日出/日落时段，观察灯光是否按预期变化：

   • 日出后：色温逐渐升高（变凉），亮度增加
   • 日落前：色温逐渐降低（变暖），亮度调暗
     ✅ 成功标志：灯光变化符合自然光线规律

常见错误排查：

• 若色温变化异常：检查灯具是否支持色温调节（需兼容的智能灯泡）
• 若亮度调节不明显：调整 min_brightness 和 max_brightness 的差值（建议至少50%差距）

问题三：如何打造不打扰睡眠的夜间照明？

你是否遇到过这样的情况：半夜起床喝水，强光让你瞬间清醒，再也无法入睡？Adaptive Lighting 的睡眠模式可以解决这个问题。

目标：设置睡眠模式，实现夜间低亮度暖光照明。

操作步骤：

1. 配置睡眠模式参数
   🔍 检查点：已完成基础配置
   在 configuration.yaml 中添加：
   adaptive_lighting:
...（保留原有配置）
   sleep_mode:
enable: true
start_time: '22:30'（睡眠模式开始时间）
   end_time: '06:00'（睡眠模式结束时间）
   brightness: 10（睡眠模式亮度百分比）
   color_temp: 2200（睡眠模式色温K值）
   ✅ 成功标志：配置保存无错误

2. 激活睡眠模式
   🔍 检查点：Home Assistant 已重启并加载新配置
   在 Home Assistant 界面中：

   1. 进入"设置"→"设备与服务"→"Adaptive Lighting"
   2. 找到 switch.adaptive_lighting_sleep_mode_<你的实体ID> 开关
   3. 点击开启开关
      ✅ 成功标志：开关状态变为"开启"，灯光立即切换到预设的睡眠模式参数

常见错误排查：

• 若开关不显示：检查配置中是否正确启用 sleep_mode: enable: true
• 若时间范围不生效：确保时间格式为 'HH:MM'，且 start_time 晚于 end_time（表示跨午夜）

配置参数速查表

参数类别	参数名	说明
基础设置	latitude	地理位置纬度（影响日出日落计算）
基础设置	longitude	地理位置经度（影响日出日落计算）
基础设置	lights	受控灯光实体ID列表（如 light.bedroom）
亮度控制	min_brightness	最小亮度百分比（0-100）
亮度控制	max_brightness	最大亮度百分比（0-100）
色温控制	min_color_temp	最小色温K值（暖光，如2200）
色温控制	max_color_temp	最大色温K值（冷光，如6500）
睡眠模式	sleep_mode.enable	是否启用睡眠模式（true/false）
睡眠模式	sleep_mode.start_time	睡眠模式开始时间（'HH:MM'）
睡眠模式	sleep_mode.end_time	睡眠模式结束时间（'HH:MM'）
睡眠模式	sleep_mode.brightness	睡眠模式亮度百分比（建议5-20）
睡眠模式	sleep_mode.color_temp	睡眠模式色温K值（建议2200-2700）

进阶技巧：打造多场景自动化

1. 工作日/周末差异化设置

通过 Home Assistant 的自动化功能，为工作日和周末设置不同的亮度曲线：

• 工作日：早晨7:00开始提升亮度，模拟日出唤醒
• 周末：早晨9:00开始提升亮度，允许自然醒

2. 结合活动状态调整

将 Adaptive Lighting 与其他传感器联动：

• 当电视打开时，自动降低环境光亮度
• 当检测到有人活动时，暂时提升亮度，无人时恢复自动调节

3. 季节性调整

根据季节变化自动优化参数：

• 夏季：提前降低色温，帮助在较长日照后更快放松
• 冬季：增加整体亮度，弥补日照不足

社区支持资源

如果你在使用过程中遇到问题，以下资源可以提供帮助：

• 项目文档：docs/ 目录下包含详细的配置指南和高级功能说明
• 问题反馈：通过项目的 issue 系统提交 bug 报告或功能建议
• 社区讨论：Home Assistant 社区论坛中有专门的 Adaptive Lighting 讨论主题
• 测试支持：tests/ 目录下提供了示例测试用例，可帮助验证配置正确性

Adaptive Lighting 作为一款开源项目，欢迎你贡献代码或改进建议，一起打造更智能的照明体验。

Adaptive Lighting 标志