## 功能特性 - 局域网设备发现：通过 ARP、mDNS、SSDP、DHCP 和可选 SNMP 持续发现局域网内的设备变化。 - 设备事件记录：保存新设备出现、IP 变化、厂商变化和重新上线等事件，便于回看网络动态。 - 设备台账维护：可在 `Devices（设备）` 页面把未知设备登记为已知设备，并补充名称、归属人和设备类型。 - 状态面板：可在 `Status（状态）` 页面查看各扫描器的运行状态、最近扫描结果和异常提示。 - 多端接入：Web、桌面端、iOS 和 Android 客户端都通过同一套 REST API 访问后端。 ### 首次使用流程 1. 在配置向导中需要确认并记录 `OOTT API Key`。这个值需要在 Web、桌面端或移动端首次接入时填写。 2. 在浏览器打开应用地址 `https://oott.你的微服名.heiyu.space/`。入口会先把你带到 OOTT Web UI 的 `/web`，首次尚未配置时通常会直接停在 `Settings（设置）` 路由并弹出 `Backend configuration（后端配置）` 对话框。 3. 在 `Base URL of your OOTT server's API（OOTT 后端 API 地址）` 中填写 `https://oott.你的微服名.heiyu.space/api`。这里必须写 `/api`，不能只写站点根地址。 4. 在 `API key（接口密钥）` 中填写安装时记录的 `OOTT API Key`。 5. 先点击 `Test（测试）`。按本次实测，测试通过后按钮会变成已通过状态，页面底部会出现 `It works!` 提示。 6. 再点击 `Save（保存）`。保存成功后，页面底部会出现 `Settings saved successfully`，同时 `Settings（设置）` 页顶部会开始显示当前保存的 `Base URL` 和掩码后的 `API key`。 7. 完成保存后进入 `Home（首页）`，确认首页已经能看到通知区、设备统计和扫描器摘要；按本次实测，首次可见到 `new devices found on your network` 这类通知，以及右侧 `Devices / Scanners` 面板。 8. 如果你使用桌面端或移动端客户端，也在其设置页填写同一个 API 地址 `https://oott.你的微服名.heiyu.space/api` 和同一个 API Key。 ### 日常使用方式 1. 先看 `Home（首页）`。这里可以直接按 `New / Old / All` 切换通知视图，并在右侧同时查看 `Devices` 统计和 `Scanners` 摘要，适合用来做“今天网络有没有新变化”的第一眼检查。 2. 如果首页出现 `new devices found on your network` 这类通知，立刻进入 `Devices（设备）` 页面，优先看 `Not registered（未登记）` 视图；当前界面会直接列出 `Name`、`Owner`、`MAC Address`、`IP Address`、`Last Seen`、`Vendor` 等列，便于先确认是不是你认识的设备。 3. 对已经确认用途的设备，可继续在 `Devices（设备）` 里打开右侧操作菜单或设备详情，补充登记信息；如果只是想快速巡检，也可以保留在未登记状态，等后续出现更多事件再统一整理。 4. 日常巡检时建议顺手打开 `Status（状态）` 页面确认扫描器是否还在工作。按本次实测，常见状态文案会显示为 `ARP Scanner = Running`、`mDNS / SSDP / DHCP = Listening`、`SNMP = Not started`；如果这些状态长期不刷新，优先排查网络可见性而不是前端配置。 5. 需要重新换盒子地址、替换 API Key 或让同一个部署接入别的客户端时，再去 `Settings（设置）` 页面使用 `Re-configure`。该页会展示当前保存的 `Base URL`、掩码后的 `API key` 和主题设置，适合作为连接配置的维护入口。 6. 当你要对接桌面端、移动端或自己写脚本调接口时，直接打开 `API Docs（接口文档）`，也就是 `https://oott.你的微服名.heiyu.space/api/docs`，用 Swagger UI 查看真实请求路径和鉴权方式。