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 参数覆盖该值。
  • 修复 Bug：蓝→红切换过程中的关灯闪烁（off-flash）现在会忽略饱和度为 0 的白色过渡，避免白色与蓝色之间反复跳变（white<->blue ping-pong）；同时，white-temp 仅应用于白色步骤（解决了 off-flash 过程中跳过红色的问题）；此外，白色步骤也会在未启用 --double-write 的情况下设置亮度。
• scripts/run_test_light_show.sh — 使用 uv 运行 light_show 的辅助脚本

注意事项

• 本仓库已配置为使用 uv（无需手动激活虚拟环境）。依赖项定义于 pyproject.toml，所有封装脚本均优先使用 uv run。
  示例命令：
  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：
  • brew install uv（macOS）
  • pipx install uv（跨平台）
• 所提供的封装脚本依赖 uv：
  ./skills/control-ikea-lightbulb/scripts/run_control_kasa.sh --ip 192.168.4.69 --on --hsv 0 100 80 --brightness 80
• 测试辅助脚本同样推荐使用 uv：
  ./skills/control-ikea-lightbulb/scripts/run_test_light_show.sh --ip 192.168.4.69 --duration 6 --transition 1 --off-flash --verbose
• 若您的设备实际为 IKEA TRADFRI 灯泡（非 Kasa 协议），本脚本可作为起点；请告知我，我将添加 TRADFRI 支持。
• 无需任何云凭证；所有控制均通过局域网直连设备 IP 完成。

快速上手

1. 安装 uv（macOS）：
   brew install uv
2. 开启灯泡（请替换为实际 IP）：
   ./skills/control-ikea-lightbulb/scripts/run_control_kasa.sh --ip 192.168.4.69 --on
3. 设置颜色与亮度：
   ./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 文件。