diff --git a/docs/06-troubleshooting.md b/docs/06-troubleshooting.md
index 70f620f..43b17a0 100644
--- a/docs/06-troubleshooting.md
+++ b/docs/06-troubleshooting.md
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Troubleshooting
 wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Troubleshooting
-wiki_revision: b70e92180546609cb9b3b05b2c13c1a49676c03b
-synchronized_at: 2026-08-13T14:05:00Z
+wiki_revision: 7deb549d8b0ae87cdca0c7494e36150d261248a1
+synchronized_at: 2026-08-13T14:37:00Z
 <!-- gitea-wiki-mirror:end -->
 
 # 故障排查
@@ -76,4 +76,9 @@ synchronized_at: 2026-08-13T14:05:00Z
 
 `demo` 只用于临时查看。生产数据持久性、真实设备和媒体链路不能用 demo 验证替代。
 <!-- sense-windows-package:end -->
+## 设备管理
+
+| 现象 | 处理 |
+|---|---|
+| 编辑设备时提示“请求内容格式不正确” | 中文名称和安装位置本身受支持。检查 PATCH payload 是否误带只允许新建时提交的 `modality` 或其他未知字段；编辑请求应只包含 `name`、`location`、`capabilities`、`version`。不要通过放宽后端未知字段校验绕过前端契约错误。 |