# MosFlash 智能断路器 · 开发者指令文档（占位）

> **此文件为占位文件**：正式《开发者指令》MD 文档由官方生成后，直接覆盖本文件即可（保持文件名 `mosflash-dev-commands.md` 不变，或同步更新详情页下载链接）。

## 接入方式

设备通过 MQTT 接入。接入参数（Broker 地址、tenantId、userId、用户名、密码）在控制台「开发参数」页成套复制，不在本文档展开。

- 下发主题：`/{tenantId}/{userId}/{productModel}/{deviceId}/sub`
- 上行主题：`/{tenantId}/{userId}/{productModel}/{deviceId}/pub`
- deviceId = 设备 12 位 MAC 小写

## 典型指令示例

下发（合闸）：

```json
{
  "messageId": "msg-1761955200000",
  "cmd": "switch.control",
  "data": { "key": 1 }
}
```

应答：

```json
{
  "messageId": "msg-1761955200000",
  "cmd": "switch.control",
  "ok": true,
  "data": { "key": 1 }
}
```

## 安全提示

- `switch.control` 涉及强电分合闸，下发前确认负载侧无人作业。
- 本期链路为明文 MQTT（1883），暂无 TLS。