一起装·设备运营

概述

摄像头与设备运营

确定用户想看当前状态、历史在线表现还是设备流转，以及公司、时间和工地范围；使用当前授权的一起装 MCP，先看实时工具定义和返回。当前资产台账查 list_device_inventory，历史在线表现查 list_device_online_rate，流转查 list_device_binding_records、list_device_claim_records；单工地摄像头与画面查 list_cameras。批量统计须按工具分页取完整范围并核对。

当前设备台账

• list_device_inventory 每行一台权限范围内的摄像头设备，page 从 1 起，pageSize 最大 1000。按状态、领用 claimed、绑定 bound、在线 online、SD 卡状态等筛选，直接使用同范围 total 统计；需要明细或本地分组时分页取全并核对。序列号是模糊筛选，匹配后再精确核对。
• 经实测可按以下口径与 PC 页面快捷统计对照：设备总数=未筛选；库内闲置=claimed=false；已领用=claimed=true；库外闲置=claimed=true 且 bound=false；已领用已绑工地=claimed=true 且 bound=true；在线/离线=bound=true 且 online=true/false；在线未绑工地=bound=false 且 online=true；SD 卡异常=sdCardStatus=exception。对其他公司或权限范围复核页面定义。只按 online 筛选覆盖未绑定设备，不等于 PC 页面已绑设备在线统计。
• status 包括 normal、in_transit、expired、under_repair、damaged、lost、scrapped；未激活状态上游不可直接筛选，需不传 status 取全后本地筛选。ownerViewable 是绑定工地的业主可看直播开关，未绑定设备缺键不等于 false；设备状态不等于在线、领用或绑定状态。claimedDate、validStartDate、validEndDate 是日期；lastOnlineStatusChangedAt 是最近上下线时刻。

多设备的领用/归还分析：先按需要的日期范围用 list_device_claim_records 批量分页（当前每页上限 1000），再在本地以 deviceId 或完整序列号精确分组，不为每台设备逐次请求。仅问一台设备时可按序列号过滤，但该过滤是模糊匹配，须再精确核对。核对 total、各页数和失败，保留事件流水；若要推断当前领用状态，按足够历史和同日事件不确定性处理，不能仅以月内流水替代当前台账。

在线与现场覆盖

• 单工地眼下状态取 list_cameras.isOnline，最新画面只在 hasSnapshot=true 且有 coverImageUrl 时提供；无抓拍时间字段时称最近一次抓拍，不推断实时。历史设备在线率查 list_device_online_rate：周期用 type=period，日趋势用 day。跨设备总体在线率以在线秒数之和除应在线秒数之和；零分母单列，不能平均百分比，也不能用 day 行相加替代 period。
• 单行应在线秒数是设备绑定区间与统计桶的交集，不是整个查询窗口时长；不能只凭单行秒数反推窗口结束时刻、全体设备分母或完整覆盖。报备回加可能使在线率达 100% 时仍存在离线秒数，因此不能说该设备从未离线。
• 排查低在线表现时给设备标识、统计窗口、在线率、应在线时间和所属工地（可可靠关联时），并提出核实网络、电源、绑定和报备等方向，不将原因猜成事实。isOnline 与周期在线率不是同一指标。

流转与周转

• 绑定历史的时间过滤按绑定时间，领用台账按领用/归还日期；指定一段时间时可能遗漏窗口前的最新事件。先按设备序列号精确核对并读取足够历史，以绑定/解绑时间、事件类型及先后关系梳理历程；缺失解绑时间、同日多条或事件不完整时标记无法确认。
• 找“解绑后未重新绑定”的候选：同一序列号的解绑事件后，在所查可见历史中没有更新的绑定事件；分别检查数据范围和查询是否完整。只能称“未查到后续绑定，待核实”，不能断定设备闲置、库存、当前物理位置或可用，也不能把没有后续领用记录当成设备已归还。
• 领用归还仅含两类动作；日期只有日精度，记录无独立 ID，按设备×动作×日期复合核对，重复记录先核实，不能据此恢复日内顺序。设备绑定、领用、库存是不同过程，不按时间接近强行拼接。
• 看到解绑与同日归还只能称记录上有归还，不足以判定完整生命周期闭合或无需跟进；同日先后及当前库存须有独立依据。
• 输出管理结论、可核查清单、事件时间和下一步；缺失、空结果和调用错误分开。只读取和分析，不变更绑定或发送消息。