feat: publish linux led manager panel

README.md

@@ -0,0 +1,145 @@
+# LED Manager Panel
+
+一个无第三方依赖的 Linux LED Web 管理面板，用 Python 标准库直接管理：
+
+```text
+/sys/class/leds/
+```
+
+适合 Debian、OpenWrt、Raspberry Pi OS、4G 路由器等 Linux 设备。
+
+你的设备示例：
+
+```text
+blue:wan green:wlan mmc0:: red:power sim:en sim:en2 sim:sel sim:sel2
+```
+
+## 功能
+
+- 列出 `/sys/class/leds/` 下所有 LED
+- 查看 brightness / max_brightness / 当前 trigger
+- 打开 / 关闭 LED
+- 调整亮度
+- 切换 trigger，例如 `none`、`timer`、`netdev`、`mmc0` 等，具体取决于内核暴露的能力
+- 设置 `timer` trigger 的 `delay_on` / `delay_off`
+- “识别 3 秒”闪烁指定 LED
+- 无数据库、无 Node、无 pip 依赖
+
+## 一键安装
+
+```bash
+curl -fsSL https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh | sh
+```
+
+如果设备没有 `curl`，用 `wget`：
+
+```bash
+wget -qO- https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh | sh
+```
+
+默认端口 `8088`，安装后浏览器打开：
+
+```text
+http://设备IP:8088/
+```
+
+自定义端口：
+
+```bash
+PORT=8090 sh -c "$(curl -fsSL https://gitea.chickliu.fun/Hermes/led-manager-panel/raw/branch/main/install.sh)"
+```
+
+## 手动运行
+
+把 `led_panel.py` 上传到设备，例如：
+
+```bash
+scp led_panel.py root@4G-wifi:/root/led_panel.py
+```
+
+在设备上运行：
+
+```bash
+chmod +x /root/led_panel.py
+python3 /root/led_panel.py --host 0.0.0.0 --port 8088
+```
+
+如果设备没有 Python3：
+
+```bash
+# Debian/Ubuntu
+apt update && apt install -y python3
+
+# OpenWrt
+opkg update && opkg install python3
+```
+
+## Debian systemd 安装
+
+```bash
+mkdir -p /opt/led-manager
+cp led_panel.py /opt/led-manager/led_panel.py
+chmod +x /opt/led-manager/led_panel.py
+cp led-manager.service /etc/systemd/system/led-manager.service
+systemctl daemon-reload
+systemctl enable --now led-manager
+systemctl status led-manager
+```
+
+默认端口：`8088`。
+
+## OpenWrt procd 安装
+
+```bash
+mkdir -p /opt/led-manager
+cp led_panel.py /opt/led-manager/led_panel.py
+chmod +x /opt/led-manager/led_panel.py
+cp led-manager.openwrt.init /etc/init.d/led-manager
+chmod +x /etc/init.d/led-manager
+/etc/init.d/led-manager enable
+/etc/init.d/led-manager start
+/etc/init.d/led-manager status
+```
+
+## 安全说明
+
+这个面板会写 `/sys/class/leds/*`，建议只在内网使用，不要直接暴露公网。
+
+如需公网访问，请放到反代后面加认证，或者只监听 `127.0.0.1`：
+
+```bash
+python3 /root/led_panel.py --host 127.0.0.1 --port 8088
+```
+
+## 常见问题
+
+### 1. 按钮提示权限不足
+
+需要 root 运行，因为 `/sys/class/leds/*/brightness` 通常只有 root 可写。
+
+### 2. 某些 LED 不能调亮度
+
+有些 LED 只有 `0/1` 两档，`max_brightness` 会是 `1`。
+
+### 3. 切换 trigger 后亮度不能手动控制
+
+Linux LED 子系统里，手动亮度通常要先切回：
+
+```bash
+echo none > /sys/class/leds/<led-name>/trigger
+```
+
+面板在手动设置亮度时会自动尝试切到 `none`。
+
+### 4. netdev trigger 怎么绑定网卡？
+
+如果某个 LED 支持 `netdev` trigger，切到 netdev 后可能会出现这些文件：
+
+```text
+device_name
+link
+tx
+rx
+```
+
+当前版本先做通用亮度/trigger/timer 管理；如果你要把 `blue:wan` 绑定到具体网卡，我可以继续加 netdev 绑定配置。