名称： control-ikea-lightbulb
描述： 控制宜家/TP-Link Kasa智能灯泡（开关、亮度与颜色设置）。适用于希望通过局域网IP以编程方式控制本地智能灯泡的场景。

control-ikea-lightbulb

本技能提供了一个轻量级Python脚本，用于控制本地智能灯泡（通过python-kasa支持TP-Link Kasa兼容灯泡）。它专为无需云凭证的局域网设备设计，通过IP地址进行控制。

使用场景

• 需要打开或关闭灯泡时
• 需要设置亮度（0-100）时
• 需要设置颜色（HSV）时
• 已知灯泡的本地IP且可从本机访问时

内容说明

• scripts/control_kasa_light.py — 主运行脚本（Python 3.9+）
• scripts/light_show.py — 用于灯光序列控制的小型演示控制器（使用python-kasa）。主要变更包括：
• 默认白色使用高色温（9000K）使白色更“纯白”；可通过--white-temp参数覆盖。
• 错误修复：修复了蓝→红切换时的闪烁问题，现忽略向白色（饱和度==0）的过渡以避免白↔蓝乒乓效应；白色色温仅应用于白色步骤（修复了红色在闪烁时被跳过的问题）。白色步骤即使未使用--double-write也会设置亮度。
• scripts/run_test_light_show.sh — 通过uv运行light_show的辅助脚本

注意事项

• 本项目使用uv管理环境（无需手动激活）。依赖项位于pyproject.toml中，包装脚本优先使用uv run。
  示例：
  bash uv run --project ./skills/control-ikea-lightbulb python ./skills/control-ikea-lightbulb/scripts/control_kasa_light.py --ip 192.168.4.69 --on --hsv 0 100 80 --brightness 80
• 安装uv：
• macOS: brew install uv
• 跨平台: pipx install uv
• 提供的包装脚本需要uv：
  bash ./skills/control-ikea-lightbulb/scripts/run_control_kasa.sh --ip 192.168.4.69 --on --hsv 0 100 80 --brightness 80
• 测试辅助脚本同样优先使用uv：
  bash ./skills/control-ikea-lightbulb/scripts/run_test_light_show.sh --ip 192.168.4.69 --duration 6 --transition 1 --off-flash --verbose
• 如果您的设备是宜家TRADFRI（非Kasa），本脚本可作为起点；请告知，我将添加TRADFRI支持。
• 无需云凭证；所有控制均通过局域网直接访问设备IP完成。

快速开始

1. 安装uv（macOS）：
   bash brew install uv
2. 打开灯泡（请替换IP地址）：
   bash ./skills/control-ikea-lightbulb/scripts/run_control_kasa.sh --ip 192.168.4.69 --on
3. 设置颜色和亮度：
   bash ./skills/control-ikea-lightbulb/scripts/run_control_kasa.sh --ip 192.168.4.69 --hsv 0 100 80 --brightness 80

Git说明

• 不跟踪本地环境文件；请使用uv。

Python依赖说明与近期变更

• 本技能之前声明python-kasa>=0.13.0，导致在本机出现依赖解析失败。为使技能可在本地运行，已调整项目的pyproject.toml：
• requires-python = ">=3.11, <4.0"
• python-kasa>=0.10.2
• 这允许解析器在Python 3.11+的机器上选择兼容的python-kasa版本。如果您希望使用其他约束（或希望我撤销此更改），请告知，我将相应更新pyproject.toml和README。