switchbot

SwitchBot Smart Home Control 是一款专注于 SwitchBot 生态的智能家居自动化技能，通过调用官方 Cloud API v1.1，为用户提供完整的设备控制能力。

核心用法围绕 Python 脚本展开，用户首先需在 SwitchBot App 中获取 Token 和 Secret 并配置本地凭证文件，随后可通过命令行实现设备发现、窗帘开合（支持 0-100 精确位置控制）、灯具与插座开关、温湿度传感器数据读取等操作。技能采用声明式命令结构，支持 Curtain、Plug、Bot、Light、Lock、Humidifier、Meter 等全系列设备，并提供完善的错误代码映射机制。

显著优点体现在安全性与轻量性方面：实现代码仅依赖 Python 标准库（urllib、json、hashlib 等），零外部 pip 依赖极大降低了供应链攻击风险；所有网络通信强制通过 HTTPS 加密；敏感凭证存储于本地配置文件并建议设置 600 权限；代码中严格避免 eval、exec、system 等危险函数，输入参数经过验证，整体通过 A 级安全认证。

潜在局限性包括：功能强依赖 SwitchBot Cloud 服务，设备控制需保持互联网连接，离线场景无法使用；当前为个人开发者维护（T3 来源），长期维护稳定性和代码审计更新频率存疑；初次配置需手动获取 API 凭证并创建配置文件，对非技术用户门槛较高；仅兼容 SwitchBot 品牌设备，生态封闭。

该技能适合已部署 SwitchBot 硬件的智能家居用户、希望通过脚本实现自动化场景（如定时开合窗帘、根据温湿度自动调节）的技术爱好者，以及需要将 SwitchBot 设备集成到自有 Home Assistant 或自动化工作流中的进阶用户。

使用风险主要涉及：网络延迟或 API 服务中断可能导致控制失败；API 凭证若未按建议设置文件权限存在泄露风险；作为社区项目，后续可能面临更新滞后或兼容性维护问题。建议用户在可信网络环境下使用，并定期审查凭证安全状态。