添加红外扩展

apps/web-console/README.md

@@ -41,11 +41,27 @@ make dev-lan
 
 其他设备访问启动日志打印的 `http://<LAN-IP>:8000`。页面与后端 API 由同一服务提供，无需单独配置前端地址。
 
-自扩展接口统一位于 `/api/extension/*`，GSCU1B 默认以 TCP 模式监听
-`0.0.0.0:4444`。可通过 `GSCU_TRANSPORT=simulation` 使用演示学习器，或通过
-`GSCU_TRANSPORT=mqtt` 与 `GSCU_MQTT_*` 配置接入 MQTT。MQTT 依赖已包含在
-核心环境中；NFC 串口依赖通过 `ir` 可选依赖安装。自扩展不再需要独立的
-`8010` 前端服务。
+自扩展接口统一位于 `/api/extension/*`。红外模块默认使用已验证的 GSCU1B TCP
+模式：Linux 端在 `0.0.0.0:4444` 监听，GSCU1B 作为 TCP Client 主动接入。
+“外设与扩展能力”中的“TCP 设置”可修改监听 IP、端口并立即重启监听，配置持久化到
+`artifacts/tmp/gscu_gateway.json`；同一弹窗可执行查询、学习、取消、发射、读取、
+写入、软重启、WiFi 配网锁、擦除、恢复出厂和原始 JSON 调试动作。模块配置的
+服务器地址必须填写 Linux 的实际局域网 IP，不能填写 `0.0.0.0`。
+
+TCP 发射、取消、写入和设置类动作在操作系统确认写入连接后立即返回“已下发”，
+不会因设备不回 ACK 而阻塞前端。固件 1.1.5 的学习动作同样不主动返回 ACK，因此
+前端在学习命令下发后自动读取目标槽位，以实际 `ir_data` 回读确认学习完成；设备查询
+和读取槽位仍等待带 `messageId` 的实际回执。
+学习时可为每个 `1–248` 红外槽位填写信号名称；槽位与名称持久化在本机
+`artifacts/server/gscu_ir_catalog.sqlite3` 数据库中，并在 TCP 动作调试区按槽位号
+升序显示为小卡片。浏览器中已有的旧名称会自动迁移到数据库。单卡片删除操作只删除
+本地目录记录，不会擦除设备红外码；已验证的设备协议仅支持全部擦除。全部擦除会先
+弹出不可恢复确认，设备命令提交成功后才同步清空本地槽位数据库。
+
+如需回退 MQTT，可设置 `GSCU_TRANSPORT=mqtt`，通过 `GSCU_MQTT_*`、
+`GSCU_COMMAND_TOPIC` 和 `GSCU_RESPONSE_TOPIC` 指定 Broker 与话题；通过
+`GSCU_TRANSPORT=simulation` 使用演示学习器。MQTT 依赖已包含在核心环境中；
+NFC 串口依赖通过 `ir` 可选依赖安装。自扩展不再需要独立的 `8010` 前端服务。
 
 ## NFC 玩具识别与红外学习