diff --git a/docs/06-troubleshooting.md b/docs/06-troubleshooting.md
index ee57c52..f6dd1fd 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: a076590915040eae0d165be6254c6302f308fc5a
-synchronized_at: 2026-08-12T10:22:09Z
+wiki_revision: b8e778ae4255ba3fc36a1cd6bcb735e29bd19eee
+synchronized_at: 2026-08-13T01:26:22Z
 <!-- gitea-wiki-mirror:end -->
 
 # 故障排查
@@ -47,6 +47,7 @@ synchronized_at: 2026-08-12T10:22:09Z
 |---|---|
 | 启动提示缺少 `SENSE_DATABASE_URL` | 正式模式必须提供独立 PostgreSQL URL；只有测试/smoke 可显式使用 `memory`。 |
 | 登录统一提示用户名或密码错误 | 为避免枚举账户，失败响应不区分用户不存在、密码错误或账户停用；由管理员查看审计。 |
+| 管理员登录后侧栏没有模块 | 先确认 /api/v1/identity/me 返回角色与权限；若权限正常，检查前端是否从具有 children 的应用布局路由派生菜单，不得依赖重复 / 路由记录顺序。 |
 | `adapter_not_ready` | 当前设备类型尚无适配器，不代表网络故障；首期完整支持 video。 |
 | `discovery_unavailable` | 未设置获准的 `SENSE_ONVIF_DISCOVERY_IP`，或该 IP 不属于本机网卡。可改用手工 ONVIF 地址。 |
 | `authentication_failed` | 在设备管理中重新写入凭据后再次执行接入检查；不要把凭据写进地址。 |