test(M00): 完善MQTT冒烟配置自检

docs/local-dev-mqtt.md

@@ -28,6 +28,7 @@ bash scripts/dev/wsl/check-local-mqtt.sh
 ```bash
 cp scripts/dev/wsl/mqtt-smoke.env.example scripts/dev/wsl/mqtt-smoke.env
 # 在本地被 Git 忽略的 mqtt-smoke.env 中填写最小权限 MQTT 账号
+bash scripts/dev/wsl/mqtt-smoke.sh --check-config
 bash scripts/dev/wsl/mqtt-smoke.sh
 ```
 
@@ -44,6 +45,12 @@ bash scripts/dev/wsl/mqtt-smoke.sh
 如果未配置 `QIPAI_MQTT_USERNAME` 和 `QIPAI_MQTT_PASSWORD`，脚本会输出 `SKIP`，不得视为认证/ACL 已通过。
 
 本轮验证结果：未配置本地账号时，`scripts/dev/wsl/mqtt-smoke.sh` 已按预期输出 `SKIP`。
+示例文件验证结果：`scripts/dev/wsl/mqtt-smoke.env.example` 可在 `set -u` 下安全加载，`'$SYS/#'` 保持为字面 Topic。
+
+配置注意：
+
+- `QIPAI_MQTT_DENIED_SUBSCRIBE_TOPIC` 默认值为 `'$SYS/#'`，必须保留引号，避免 shell 把 `$SYS` 当作本地变量展开。
+- `--check-config` 只确认本地账号配置存在，不打印口令，不执行 MQTT 连接。
 
 ## 验收边界