（8090期）control-ikea-lightbulb – 零云依赖的本地智能灯控

零云依赖的本地智能灯控 基于 python-kasa 的本地局域网智能灯泡控制工具，无需云凭证即可通过 IP 地址直接操控 TP-Link Kasa 兼容设备，实现开关、亮度调节与 HSV 色彩控制。 使用说明 核心用法 control-ikea-lightbulb 是一个轻量级的本地智能灯泡控制技能，专为 TP-Link Kasa 兼容设备设计（IKEA TRADFRI 支持待扩展）。用户通过提供设备的局域网 IP 地址，即可直接控制灯泡的开关状态、亮度（0-100%）以及 HSV 色彩空间的颜色设置。该技能采用 uv 作为 Python 环境管理工具，无需手动激活虚拟环境，依赖管理通过 pyproject.toml 完成。 主要使用方式包括： 基础控制：通过 runcontrolkasa.sh 脚本执行开关、亮度、颜色设置 灯光秀模式：通过 light_show.py 实现序列化的灯光效果演示，支持自定义色温、过渡时间和闪烁效果 命令行直接调用：使用 uv run 直接执行 Python 脚本，灵活传递参数 显著优点 零云依赖：完全基于本地 LAN 通信，无需注册账号、API Key 或云凭证，隐私性极强 轻量高效：基于成熟的 python-kasa 库，代码简洁，响应迅速 环境友好：采用 uv 工具链，告别传统 pip/venv 的繁琐配置，一键运行 功能完整：覆盖日常灯光控制的核心需求——开关、亮度、色彩、序列动画 输入安全：完善的 argparse 参数验证，IP 必填、数值范围限制，防止误操作 潜在缺点与局限性 设备兼容性有限：当前仅支持 TP-Link Kasa 协议，IKEA TRADFRI 设备需等待后续更新 网络环境受限：必须知晓设备 IP 地址且处于同一局域网，无法跨网段或远程控制 工具链依赖：强制依赖 uv 工具，未安装时需额外步骤（brew/pipx 安装） 无状态反馈：单向控制模式，无法读取灯泡当前状态进行同步 T3 来源风险：个人开发者维护，长期更新保障相对较弱 适合的目标群体 智能家居爱好者：希望本地私有化控制灯光，拒绝云服务 开发者/极客：需要通过脚本自动化控制灯光场景 演示场景搭建者：灯光秀功能适合展览、活动氛围营造 隐私敏感用户：不愿将设备数据上传至厂商云端 使用风险 网络配置风险：若 IP 地址输入错误，可能向局域网内其他设备发送控制指令（虽无破坏性，但可能干扰其他 Kasa 设备） 依赖更新风险：python-kasa 库更新可能引入协议变更，需关注兼容性 uv 工具链依赖：若 uv 出现安装或版本问题，整个技能将无法运行 无加密传输：本地 LAN 通信未提及加密，在开放网络环境中存在被嗅探风险 权限边界：虽无系统级权限需求，但网络权限的滥用可能理论上被用于扫描内网 原始说明 Control IKEA/TP-Link Kasa smart bulbs (set on/off, brightness, and color). Use when you want to programmatically control a local smart bulb by IP on the LAN.