feat: add lightweight API and web console

README.md

@@ -1,8 +1,8 @@
-# Pigway Pi Control v3.5.0 System Health
+# Pigway Pi Control v3.6.0
 
 Raspberry Pi 4B + 配套 128×32 OLED / 风扇 / RGB 散热扩展板的本机硬件监控 Agent。
 
-v3.5.0 完成本地检测、事件状态、日志、诊断、显示仲裁、可配置 RGB 告警和关机收尾，为后续轻量 API/Web 管理界面提供稳定基础。
+v3.6.0 在本地硬件监控、显示仲裁和可配置 RGB 告警基础上，增加轻量状态/日志/配置 API 与同源 Web 管理界面。
 
 ## 已有核心功能
 
@@ -11,7 +11,7 @@ v3.5.0 完成本地检测、事件状态、日志、诊断、显示仲裁、可
 - Wi-Fi RSSI / Ethernet 链路速率
 - 当前默认路由与 IP 同步切换
 - 风扇自动温控、回差防抖
-- RGB：内置灯效的颜色与速度表示严重程度
+- RGB：自定义颜色表示故障对象，频闪速度表示严重程度
 - systemd 服务与普通进程监控
 - Raspberry Pi PWR / ACT 运行时 Dark Mode
 
@@ -82,7 +82,7 @@ RGB 模式由当前 OLED 告警页决定；OLED 位于主页时则使用最高
 只在 **状态发生变化** 时记录关键事件，避免每秒刷屏。例如：
 
 ```text
-level=INFO event=START version=3.3.0
+level=INFO event=START version=3.6.0
 level=INFO event=NET_SWITCH old_if=eth0 new_if=wlan0 ...
 level=WARN event=NETWORK_DOWN ...
 level=INFO event=NETWORK_RECOVERED ...
@@ -136,6 +136,50 @@ RGB 保留卖家 MCU 0x0D 寄存器协议。实机校准确认静态自定义颜
 
 Pi 红色 PWR 灯关机后恢复硬件默认亮起的行为不强行修改，可作为“系统已关机但 UPS 仍供电”的直观提示。
 
+## v3.6.0 API 与 Web
+
+安装后访问：
+
+```text
+http://树莓派IP:6001/
+```
+
+Web 与 JSON API 由独立的 `pigway-pi-control-api.service` 提供。API 服务不访问 I²C；硬件 Agent 每秒原子更新 `/run/pigway-pi-control/status.json`，API 只读取该快照。默认监听地址和端口可在 `[api]` 中修改：
+
+```ini
+[api]
+bind = 0.0.0.0
+port = 6001
+log_limit = 200
+```
+
+只读接口：
+
+```text
+GET /api/v1/health
+GET /api/v1/status
+GET /api/v1/logs?limit=200
+GET /api/v1/config
+```
+
+配置写入接口：
+
+```text
+PUT /api/v1/config
+Authorization: Bearer <token>
+Content-Type: application/json
+
+{"updates":{"led":{"service_b":"96"},"api":{"port":"6001"}}}
+```
+
+读取 token：
+
+```bash
+sudo cat /etc/pigway-pi-control-api.token
+```
+
+配置更新仅允许 `[services]`、`[processes]`、`[alerts]`、`[fan]`、`[led]`、`[timing]`、`[dark_mode]`、`[display]` 和 `[api]`。每次写入先生成时间戳备份，再原地更新目标键并重启硬件 Agent；修改 `[api]` 时 API 服务也会自动重启。
+
 ## 用户配置
 
 正式配置只有一个：
@@ -165,21 +209,24 @@ sudo ./install.sh
 - 检查 I²C
 - 禁用旧 `temp-control.service`
 - 安装字体、程序、配置和 systemd unit
-- 完整保留用户现有配置（包括所有 section、用户值和注释），仅向 `[led]` 补入缺失的 RGB 颜色与频闪选项，已有用户值优先
-- 启动服务
+- 完整保留用户现有配置（包括所有 section、用户值和注释），仅补入缺失的 `[led]` 和 `[api]` 选项，已有用户值优先
+- 生成只读 root token，安装 API/Web 文件
+- 启动硬件 Agent 与 API/Web 服务
 - 执行版本、OLED、UI、P0健康监控和诊断入口自检
 
 ## 常用命令
 
 ```bash
 systemctl status pigway-pi-control --no-pager -l
+journalctl -u pigway-pi-control-api -f
 journalctl -u pigway-pi-control -f
 sudo systemctl restart pigway-pi-control
+sudo systemctl restart pigway-pi-control-api
 sudo /usr/local/sbin/pigway-pi-control --diagnose
 ```
 
 ## 版本路线
 
 - v3.2.0：主网络接口 / Wi-Fi RSSI / ETH速率 / 双网切换
-- **v3.5.0：System Health、显示仲裁与可配置 RGB 告警**
-- 后续：只读 `/api/v1/...` Agent API，再由 NAS 统一汇总多台设备
+- v3.5.0：System Health、显示仲裁与可配置 RGB 告警
+- **v3.6.0：轻量状态/日志/配置 API 与同源 Web 管理界面**