wiz-light-control

通过本地 WiFi 控制 Wiz 智能灯泡（打开/关闭、RGB 颜色、迪斯科模式）。

# Wiz Light Control Skill

This skill allows the agent to control physical Wiz smart lights on the local network. 

⚠️ **IMPORTANT CONFIGURATION:**
The IP address `192.168.1.109` used in examples is a placeholder. You **MUST** find the actual Local IP address of the Wiz Bulb on the network before running commands.

## 🛠️ Installation & Setup (READ FIRST)

**Before running the script for the first time, you MUST set up the Python environment.**
The agent should verify if `venv` exists. If not, run this setup command block automatically:

```bash
# 1. Create Virtual Environment and Install Dependencies
python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt
```
## Tools & Usage

### `wiz.py`

The main script to interact with the light.

**Arguments:**
- `--ip`: The IP address of the bulb (Required).
- `--action`: The command to execute. Options: `on`, `off`, `color`, `disco`.
- `--r`, `--g`, `--b`: Red, Green, Blue values (0-255) (Used for `color` action).
- `--duration`: Duration in seconds (Used for `disco` action).

**Example Prompts:**
- "Turn on the disco mode in my room for 30 seconds."
- "Turn off the light."
- "Change the light color to red."

**Execution Examples:**

```bash
# 1. Turn on Disco Mode (Check IP first!)
python wiz.py --ip 192.168.1.109 --action disco --duration 60

# 2. Turn OFF
python wiz.py --ip 192.168.1.109 --action off

# 3. Turn ON
python wiz.py --ip 192.168.1.109 --action on

# 4. Set specific color (e.g., Red)
python wiz.py --ip 192.168.1.109 --action color --r 255 --g 0 --b 0

---

## 中文说明

# Wiz 灯光控制技能

此技能允许代理控制本地网络上的物理 Wiz 智能灯。

⚠️ **重要配置：**
示例中使用的 IP 地址 `192.168.1.109` 是占位符。在运行命令之前，您**必须**找到网络上 Wiz 灯泡的实际本地 IP 地址。

## 🛠️ 安装与设置（请先阅读）

**在首次运行脚本之前，您必须先设置 Python 环境。**
代理应验证 `venv` 是否存在。如果不存在，请自动运行以下设置命令块：

```bash
# 1. Create Virtual Environment and Install Dependencies
python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt
```
## 工具与用法

### `wiz.py`

与灯光交互的主脚本。

**参数：**
- `--ip`：灯泡的 IP 地址（必填）。
- `--action`：要执行的命令。选项：`on`、`off`、`color`、`disco`。
- `--r`、`--g`、`--b`：红、绿、蓝值（0-255）（用于 `color` 操作）。
- `--duration`：持续时间（秒）（用于 `disco` 操作）。

**示例提示：**
- "Turn on the disco mode in my room for 30 seconds."
- "Turn off the light."
- "Change the light color to red."

**执行示例：**

```bash
# 1. Turn on Disco Mode (Check IP first!)
python wiz.py --ip 192.168.1.109 --action disco --duration 60

# 2. Turn OFF
python wiz.py --ip 192.168.1.109 --action off

# 3. Turn ON
python wiz.py --ip 192.168.1.109 --action on

# 4. Set specific color (e.g., Red)
python wiz.py --ip 192.168.1.109 --action color --r 255 --g 0 --b 0
```