diff --git a/Troubleshooting.md b/Troubleshooting.md
index 282967b..774c00e 100644
--- a/Troubleshooting.md
+++ b/Troubleshooting.md
@@ -69,3 +69,10 @@
 `demo` 只用于临时查看。生产数据持久性、真实设备和媒体链路不能用 demo 验证替代。
 <!-- sense-windows-package:end -->
 
+
+
+## 设备管理
+
+| 现象 | 处理 |
+|---|---|
+| 编辑设备时提示“请求内容格式不正确” | 中文名称和安装位置本身受支持。检查 PATCH payload 是否误带只允许新建时提交的 `modality` 或其他未知字段；编辑请求应只包含 `name`、`location`、`capabilities`、`version`。不要通过放宽后端未知字段校验绕过前端契约错误。 |