docs: 明确设备编辑请求边界 (#56)

2026-08-13 22:37:08 +08:00
parent 06b68d16bf
commit f9c089d2b9
1 changed files with 6 additions and 0 deletions
@@ -90,3 +90,9 @@
 - **审计事实**：成功生命周期事实只追加；失败、重复和拒绝尝试写入安全审计，但不记录令牌、密码或连接密钥。
 <!-- bell-mvp:end -->

+
+
+## 设备编辑请求边界
+
+- 新建设备请求显式提交名称、安装位置、设备类型和能力；编辑设备请求只提交名称、安装位置、能力和版本，不提交新建专用的 `modality` 或响应中的只读字段。
+- 设备名称和安装位置允许 UTF-8 中文；后端继续严格拒绝未知 JSON 字段，前端必须使用字段白名单构造请求，不得直接展开整个表单或响应对象。