From 3ee073ae07bb2ab04f02b1178b6d289f6f5a2063 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Wed, 12 Aug 2026 17:31:34 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=20Sense=20MVP=20?= =?UTF-8?q?=E6=A8=A1=E5=9D=97=E4=B8=8E=E4=BA=A4=E4=BB=98=E8=A7=84=E5=88=99?= =?UTF-8?q?=20(#22-#27)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Troubleshooting.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/Troubleshooting.md b/Troubleshooting.md index 6f11b0d..0843593 100644 --- a/Troubleshooting.md +++ b/Troubleshooting.md @@ -31,3 +31,22 @@ - 契约破坏性变化没有新版本、迁移和回退方案; - 涉及删除、不可逆迁移、发布或生产变更但没有明确授权; - 工作区出现来源不明且与当前任务重叠的修改。 + + +## Sense MVP 排错 + +| 现象/状态 | 检查与处理 | +|---|---| +| 启动提示缺少 `SENSE_DATABASE_URL` | 正式模式必须提供独立 PostgreSQL URL;只有测试/smoke 可显式使用 `memory`。 | +| 登录统一提示用户名或密码错误 | 为避免枚举账户,失败响应不区分用户不存在、密码错误或账户停用;由管理员查看审计。 | +| `adapter_not_ready` | 当前设备类型尚无适配器,不代表网络故障;首期完整支持 video。 | +| `discovery_unavailable` | 未设置获准的 `SENSE_ONVIF_DISCOVERY_IP`,或该 IP 不属于本机网卡。可改用手工 ONVIF 地址。 | +| `authentication_failed` | 在设备管理中重新写入凭据后再次执行接入检查;不要把凭据写进地址。 | +| `clock_skew` | 校准摄像机时间后重新探测。 | +| `process_failed` | 检查仓库外 `SENSE_MEDIAMTX_BINARY`、基础配置和进程退出原因;达到三次重启上限后需人工处理。 | +| `apply_failed` / `unconverged` | 检查 localhost Control API 是否启用并为 v3;确认媒体路径和外部进程状态。 | +| 画面等待、断开或会话过期 | 先在视频服务执行对账,再重新连接;播放会话最长两分钟。 | +| 区域提示需要重新校准 | Profile 分辨率已变化,按新画面重新绘制并发布新版本,不能静默复用旧坐标。 | + +自动测试不访问真实摄像头或未授权网络。PostgreSQL、MediaMTX、目标浏览器与实验室摄像机的联合验证必须在获准部署环境完成。 +