From 2a0b63c88c877e972908c3e14a86ba7719fd7286 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Thu, 13 Aug 2026 11:41:05 +0800 Subject: [PATCH] docs: document ONVIF Digest compatibility (#48) --- docs/02-architecture-and-code-map.md | 6 +++--- docs/04-local-development-and-verification.md | 8 ++++---- docs/06-troubleshooting.md | 6 +++--- 3 files changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/02-architecture-and-code-map.md b/docs/02-architecture-and-code-map.md index 60c6f88..2cfc68b 100644 --- a/docs/02-architecture-and-code-map.md +++ b/docs/02-architecture-and-code-map.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Architecture-and-Code-Map wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Architecture-and-Code-Map.- -wiki_revision: 1712a8053f365781aef9cbf33c576c97491f31d4 -synchronized_at: 2026-08-12T10:21:55Z +wiki_revision: fbb20f3bcffe5c632236108e7883ac9a0061d830 +synchronized_at: 2026-08-13T03:39:20Z # 架构与代码地图 @@ -101,7 +101,7 @@ Sense 后端功能以 `Sense/server/app/sense/` 为根，并通过 `Sense/server - `identity/`：Sense 独立账户、bcrypt 密码、会话、四角色 RBAC 与统一审计；签发者和受众只属于 Sense。 - `device/`：Device 台账、状态、分页和 AES-256-GCM 凭据保险箱；读取模型只返回 `credential_configured`。 -- `adapters/onvif/`、`adapters/rtsp/`、`admission/`：获准网卡上的受控发现、手工 ONVIF 接入、Profile/StreamUri 读取和 RTSP 验证。 +- `adapters/onvif/`、`adapters/rtsp/`、`admission/`：获准网卡上的受控发现、手工 ONVIF 接入、Media 服务发现、Basic/Digest 认证、Profile/StreamUri 读取和 RTSP 验证。摄像机广播跨主机 Media 地址时固定回用户已授权的 Device Service origin，仅保留服务路径和查询参数。 - `adapters/mediamtx/`、`media/`：外部 MediaMTX 进程所有权、localhost Control API、媒体期望态与实际态对账。 - `liveview/`：绑定当前用户、最长两分钟的单路播放会话；只投影媒体路径，不暴露源 URI 或摄像机秘密。 - `area/`：归一化多边形/方向警戒线、不可变版本、并发版本校验和分辨率变化后的重新校准。 diff --git a/docs/04-local-development-and-verification.md b/docs/04-local-development-and-verification.md index e891b71..2c9087d 100644 --- a/docs/04-local-development-and-verification.md +++ b/docs/04-local-development-and-verification.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Local-Development-and-Verification wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Local-Development-and-Verification.- -wiki_revision: 4f3e1f218d29e17a3f8fabd43316d1a562c69d07 -synchronized_at: 2026-08-13T02:35:03Z +wiki_revision: 426001a8c28bde9c336ecc8b7166924f14aa55ae +synchronized_at: 2026-08-13T03:39:26Z # 本地开发与验证 @@ -73,8 +73,8 @@ Sense/Bell 的 Go、Node 与 pnpm 基线已冻结并记录于下文；Brain 的 ## 测试数据与日志 -- 只使用合成或脱敏事件、合成 RTSP 和明确授权的实验室设备。 -- 不提交真实视频、客户名称、地址、手机号、摄像头密码或通知凭据。 +- 只使用合成或脱敏事件、合成 RTSP 和明确授权的实验室设备。ONVIF 自动化测试需覆盖 Basic、Digest challenge、Media 服务发现、跨主机地址归一化、拒绝地址凭据和禁止重定向。 +- 不提交真实视频、客户名称、地址、手机号、摄像头密码或通知凭据；真实设备验证只记录状态与 Profile 数量，不记录设备地址、Authorization 或 Stream URI。 - 日志必须可按 request/event/alert ID 追踪，但不得记录 Authorization、Cookie 或连接密钥。 ## 完成修改前 diff --git a/docs/06-troubleshooting.md b/docs/06-troubleshooting.md index d5f99ad..db6732a 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: 84d5d336475613d77030a7c722ea9c4d18b307fe -synchronized_at: 2026-08-13T02:35:08Z +wiki_revision: 832eace3bb0083168cc9ff11f689180e2d13bdea +synchronized_at: 2026-08-13T03:39:34Z # 故障排查 @@ -50,7 +50,7 @@ synchronized_at: 2026-08-13T02:35:08Z | 管理员登录后侧栏没有模块 | 先确认 /api/v1/identity/me 返回角色与权限；若权限正常，检查前端是否从具有 children 的应用布局路由派生菜单，不得依赖重复 / 路由记录顺序。 | | `adapter_not_ready` | 当前设备类型尚无适配器，不代表网络故障；首期完整支持 video。 | | `discovery_unavailable` | 未设置获准的 `SENSE_ONVIF_DISCOVERY_IP`，或该 IP 不属于本机网卡。可改用手工 ONVIF 地址。 | -| `authentication_failed` | 在设备管理中重新写入凭据后再次执行接入检查；不要把凭据写进地址。 | +| `authentication_failed` | 在设备管理中重新写入凭据后再次执行接入检查；不要把凭据写进地址。Sense 支持 ONVIF Basic 与 Digest；若 Profile 能读取但视频验证失败，确认 ONVIF 与 RTSP 是否使用同一组账号。当前每台设备只保存一组凭据，不同账号需后续凭据模型支持。 | | `clock_skew` | 校准摄像机时间后重新探测。 | | `process_failed` | 检查仓库外 `SENSE_MEDIAMTX_BINARY`、基础配置和进程退出原因；达到三次重启上限后需人工处理。 | | `apply_failed` / `unconverged` | 检查 localhost Control API 是否启用并为 v3；确认媒体路径和外部进程状态。 |