wld (Timrogers)

wld

💡 控制 白色发光二极管 命令行中的灯光

______________________________________________________________________

特性

使用此工具，您可以：

• 按名称保存和管理多个WLED设备
• 为快速访问设置默认设备
• 从终端打开和关闭WLED设备
• 设置WLED设备的亮度级别（0-255或0-100%）
• 按保存的名称或直接按IP地址控制设备

安装

macOS或Linux通过 家酿

1. 通过运行安装最新版本 brew tap timrogers/tap && brew install wld.
2. 跑 wld --help 检查一切是否正常，并查看可用命令。

macOS、Linux或Windows通过 货物Rust的包管理器

1. 安装 锈 如果尚未安装，请在您的计算机上安装。
2. 安装 wld 板条箱通过运行 cargo install wld.
3. 跑 wld --help 检查一切是否正常，并查看可用命令。

通过直接二进制下载macOS、Linux或Windows

1. 下载 最新版本 为了你的平台。支持macOS、Linux和Windows设备。
2. 将二进制文件添加到 $PATH，因此您可以从shell执行它。为了获得最佳体验，请称之为 wld 在macOS和Linux上，以及 wld.exe 在Windows上。
3. 跑 wld --help 检查一切是否正常，并查看可用命令。

用法

从命令行

这 wld CLI提供以下命令：

设备管理

• wld add ：添加一个具有友好名称的新WLED设备。自动添加的第一个设备将成为您的默认设备。

  wld add desk-light 192.168.1.100

• wld delete ：从配置中删除已保存的设备。

  wld delete desk-light

• wld ls：列出所有已保存的设备。默认设备标记为 (default).

  wld ls

• wld set-default ：将设备设置为未指定设备的命令的默认设备。

  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 ：设置默认设备的亮度，或指定一个设备 --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一起使用：

1. 在Claude应用程序中，打开“开发人员”菜单，然后单击“打开应用程序配置文件…”。
2. 将MCP服务器添加到 mcpServers 键入您的配置：

{
  "mcpServers": {
    "wld": {
      "command": "wld",
      "args": [
        "mcp"
      ]
    }
  }
}

1. 回到Claude应用程序，打开“开发人员”菜单，然后单击“重新加载MCP配置”。
2. 要检查MCP服务器是否正在运行，请启动聊天，然后单击聊天输入下的“搜索和工具”按钮，并检查菜单中的“wld”项。

可用工具

以下工具可用：

• wled_devices：从配置中列出已保存的WLED设备，包括其名称、IP地址以及设置为默认的设备
• wled_on：打开WLED设备。默认情况下，使用默认设备，但您可以选择指定设备名称或IP地址。
• wled_off：关闭WLED设备。默认情况下，使用默认设备，但您可以选择指定设备名称或IP地址。
• wled_brightness：设置WLED设备亮度（0-255）。默认情况下，使用默认设备，但您可以选择指定设备名称或IP地址。
• wled_status：检查所有已配置的WLED设备的状态。显示每个设备是打开、关闭还是不可更换。