使用说明
wld
💡 控制 白色发光二极管 命令行中的灯光
特性
使用此工具，您可以：
- 按名称保存和管理多个WLED设备
- 为快速访问设置默认设备
- 从终端打开和关闭WLED设备
- 设置WLED设备的亮度级别（0-255或0-100%）
- 按保存的名称或直接按IP地址控制设备
安装
macOS或Linux通过 家酿
- 通过运行安装最新版本
brew tap timrogers/tap && brew install wld. - 跑
wld --help检查一切是否正常，并查看可用命令。
macOS、Linux或Windows通过 货物Rust的包管理器
- 安装 锈 如果尚未安装，请在您的计算机上安装。
- 安装
wld板条箱通过运行cargo install wld. - 跑
wld --help检查一切是否正常，并查看可用命令。
通过直接二进制下载macOS、Linux或Windows
- 下载 最新版本 为了你的平台。支持macOS、Linux和Windows设备。
- 将二进制文件添加到
$PATH，因此您可以从shell执行它。为了获得最佳体验，请称之为wld在macOS和Linux上，以及wld.exe在Windows上。 - 跑
wld --help检查一切是否正常，并查看可用命令。
用法
从命令行
这 wld CLI提供以下命令：
设备管理
-
wld add <name> <ip>：添加一个具有友好名称的新WLED设备。自动添加的第一个设备将成为您的默认设备。wld add desk-light 192.168.1.100 -
wld delete <name>：从配置中删除已保存的设备。wld delete desk-light -
wld ls：列出所有已保存的设备。默认设备标记为(default).wld ls -
wld set-default <name>：将设备设置为未指定设备的命令的默认设备。wld set-default desk-light
设备控制
-
wld on：打开默认设备，或指定一个设备--device/-d.wld on # Turn on default device wld on -d desk-light # Turn on a specific saved device wld on -d 192.168.1.100 # Turn on a device by IP address -
wld off：关闭默认设备，或指定一个设备--device/-d.wld off # Turn off default device wld off -d desk-light # Turn off a specific saved device wld off -d 192.168.1.100 # Turn off a device by IP address -
wld brightness <value>：设置默认设备的亮度，或指定一个设备--device/-d。亮度值必须介于0和255之间，或者在以下情况下介于0和100之间--percentage/-p使用。wld brightness 128 # Set default device to half brightness wld brightness 50 -p # Set default device to 50% brightness wld brightness 255 -d desk-light # Set a specific saved device to full brightness wld brightness 0 -d 192.168.1.100 # Set a device to minimum brightness -
wld status：检查所有已配置设备的状态。显示每个设备是打开、关闭还是不可更换。wld status # Check status of all saved devices
来自模型上下文协议（MCP）客户端
运行 wld mcp 命令启动本地模型上下文协议（MCP）服务器，公开工具，允许您从AI应用程序和代理控制WLED设备。
使用Claude Desktop
要将MCP服务器与Claude Desktop一起使用：
- 在Claude应用程序中，打开“开发人员”菜单，然后单击“打开应用程序配置文件…”。
- 将MCP服务器添加到
mcpServers键入您的配置：
{
"mcpServers": {
"wld": {
"command": "wld",
"args": [
"mcp"
]
}
}
}
- 回到Claude应用程序，打开“开发人员”菜单，然后单击“重新加载MCP配置”。
- 要检查MCP服务器是否正在运行，请启动聊天，然后单击聊天输入下的“搜索和工具”按钮，并检查菜单中的“wld”项。
可用工具
以下工具可用：
wled_devices：从配置中列出已保存的WLED设备，包括其名称、IP地址以及设置为默认的设备wled_on：打开WLED设备。默认情况下，使用默认设备，但您可以选择指定设备名称或IP地址。wled_off：关闭WLED设备。默认情况下，使用默认设备，但您可以选择指定设备名称或IP地址。wled_brightness：设置WLED设备亮度（0-255）。默认情况下，使用默认设备，但您可以选择指定设备名称或IP地址。wled_status：检查所有已配置的WLED设备的状态。显示每个设备是打开、关闭还是不可更换。
