docs: AGENTS.md补充所有TCP指令详细介绍章节

AGENTS.md

@@ -477,6 +477,177 @@ operation_log(操作日志)
 
 **pow_off**：平台下发分闸指令，柜控板断开接触器切断380V充电电源供电。
 
+### 指令详情
+
+#### login（设备→平台）
+
+设备登录，验证签名。
+
+```json
+{"act":"login","msg_id":1,"dev_id":"123456789012345","sign":"abc12345","timestamp":1719800000,"h_ver":"1.0.0","s_ver":"1.0.0"}
+```
+
+**字段说明：**
+- `sign` — 签名（SHA256(dev_id+auth_str+timestamp)后8位）
+- `timestamp` — 秒级时间戳（平台校验±60秒）
+- `h_ver` — 硬件版本
+- `s_ver` — 软件版本
+- `cell` — 仓控板数量（响应）
+
+---
+
+#### auth_str（设备→平台）
+
+获取8位安全码，仅首次连接调用。
+
+```json
+{"act":"auth_str","msg_id":2,"dev_id":"123456789012345","ccid":"89860000000000000000"}
+```
+
+**字段说明：**
+- `ccid` — SIM卡ICCID号
+- `auth_str` — 8位随机安全码（响应，仅返回一次）
+
+---
+
+#### status_post（设备→平台）
+
+定时上报，空闲60秒/充电15秒。
+
+```json
+{"act":"status_post","msg_id":10,"dev_id":"123456789012345","rssi":85,"status":{"123456789012345-01":"000100020003000400050006"}}
+```
+
+**status字段说明：**
+- key: `IMEI-仓控板ID`
+- value: 6个通道状态拼接（每通道2字节=4个HEX字符）
+
+---
+
+#### pow_fail（设备→平台）
+
+电源掉电上报。
+
+```json
+{"act":"pow_fail","msg_id":15,"dev_id":"123456789012345","info":"0"}
+```
+
+**字段说明：**
+- `info` — 停电类型：`0`=直流停电(12V掉电)，`1`=交流停电(380V掉电)
+
+---
+
+#### pow_on（平台→设备）
+
+接触器合闸，恢复380V充电电源供电。
+
+```json
+{"act":"pow_on","msg_id":16,"dev_id":"123456789012345"}
+```
+
+---
+
+#### pow_off（平台→设备）
+
+接触器分闸，切断380V充电电源供电。
+
+```json
+{"act":"pow_off","msg_id":16,"dev_id":"123456789012345"}
+```
+
+---
+
+#### bat_in（设备→平台）
+
+电池插入事件，立即上报。
+
+```json
+{"act":"bat_in","msg_id":20,"id":"123456789012345-01-6","bms":{"soc":45,"voltage":52.3}}
+```
+
+**平台处理：**
+1. 记录电池信息
+2. 验证电池合规性
+3. 自动下发 `on` 指令
+
+---
+
+#### bat_out（设备→平台）
+
+电池拔出事件，立即上报。
+
+```json
+{"act":"bat_out","msg_id":21,"id":"123456789012345-01-6"}
+```
+
+---
+
+#### on（双向）
+
+**平台→设备：** 开始充电
+
+```json
+{"act":"on","msg_id":30,"id":"123456789012345-01-6"}
+```
+
+**设备→平台：** 充电开始确认（自动充电模式）
+
+```json
+{"act":"on","msg_id":30,"id":"123456789012345-01-6"}
+```
+
+---
+
+#### off（双向）
+
+**平台→设备：** 手动停止充电
+
+```json
+{"act":"off","msg_id":31,"id":"123456789012345-01-6"}
+```
+
+**设备→平台：** 充满自动停止
+
+```json
+{"act":"off","msg_id":31,"id":"123456789012345-01-6"}
+```
+
+---
+
+#### open（平台→设备）
+
+开门，只需IMEI。
+
+```json
+{"act":"open","msg_id":40,"id":"123456789012345"}
+```
+
+**错误码63 = 门锁故障。**
+
+---
+
+#### status_get（平台→设备）
+
+查询仓板状态。
+
+```json
+{"act":"status_get","msg_id":50,"id":"123456789012345-01"}
+```
+
+---
+
+#### reset（平台→设备）
+
+重启整柜或仓控板。
+
+```json
+// 重启整柜
+{"act":"reset","msg_id":60,"id":"123456789012345"}
+
+// 重启仓控板
+{"act":"reset","msg_id":61,"id":"123456789012345-01"}
+```
+
 ### 充电结束原因（平台判断）
 
 | 平台收到 | 判断原因 |