From 7deb549d8b0ae87cdca0c7494e36150d261248a1 Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Thu, 13 Aug 2026 22:37:11 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E8=AE=BE=E5=A4=87?=
 =?UTF-8?q?=E7=BC=96=E8=BE=91=E6=A0=BC=E5=BC=8F=E9=94=99=E8=AF=AF=E6=8E=92?=
 =?UTF-8?q?=E6=9F=A5=20(#56)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Troubleshooting.md | 7 +++++++
 1 file changed, 7 insertions(+)

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`。不要通过放宽后端未知字段校验绕过前端契约错误。 |