16 Commits

Author SHA1 Message Date
liufumingren
d302c16f13 fix(camera): 每台设备的云台操作串行执行(保障 control→stop 顺序)
背景:平台把 control/stop 挨得很近下发,而 core/wsClient.js 是并发处理 WS 消息的,
两个 SOAP 请求会同时打到同一台相机。风险不对称:
  - 并发下若 stop 先于 control 执行完,云台会一直转(ONVIF 靠 30s 兜底超时才停,
    ISAPI 路径没有兜底);
  - 同一设备上重复建 ONVIF 会话/并发连接也没有必要。
现在同一 host 的操作排成一条链,串行执行,顺序与下发顺序一致。

诚实说明:8.85 那 16 次 `Parse Error` / `Authority failure` 不是这条改动能解释的——
本地用 0 间隔背靠背(甚至 Promise.all 并发)压 8.85 共 40 次请求,A/B 都是 0 失败,
复现不出来,判断是设备侧瞬时故障(那台相机同时在推流+被平台高频点)。
这条改动是顺序保障/防御,不宣称修掉了那 16 次。

另外:本次排查中我自己的测试脚本踩过一个坑并已修正——密码含 @ 时 rtspUrl 必须写成
`admin:qwe2024@@host`(或 %40),写成单个 @ 解析出来的密码是 `qwe2024`(错的),
会得到误导性的 Authority failure。

离线回归 46 断言全通过。
2026-09-16 17:35:27 +08:00
liufumingren
efeed362a4 fix(camera): 云台改为直连摄像机(NVR 报文里 data.ip 是录像机,不是摄像机)
线上整夜实测 215 条指令、13 台设备,暴露两个问题:

1) 带录像机的报文全打错设备(77 次 401)
   平台对"挂在录像机上的摄像机"下发的形状是:
     data.ip / username / password = 录像机;camera.ip = 摄像机;server.* = 录像机详情
   (实测例:camera.ip=192.168.8.86,而 data.ip=192.168.8.241、password=ky666888)
   原来把 data.ip 当摄像机地址,又用 rtspUrl 里的摄像机密码去连录像机 → 401 HTML。
   现在 _parseTarget 的目标是【摄像机】(camera.ip → rtspUrl 的 host → data.ip 兜底),
   凭据取 rtspUrl;录像机(server 块)只作兜底:摄像机失败才改试,且优先走 ContentMgmt 代理路径。

   为什么录像机只能是兜底:实测 8.241(DS-7932N-R4) 的 /ISAPI/ContentMgmt/PTZCtrlProxy/channels
   里 16 个 IP 通道全部 enabled=false、controlProtocol 为空(录像机没配云台),
   /ISAPI/PTZCtrl/channels 还一直 503 Device Busy —— 走录像机根本驱动不了云台。

2) ONVIF 偶发错误重试不足
   "Wrong ONVIF SOAP response" 没被识别为偶发错误(水星 MIPC332 那台会回这个),且只重试 1 次。
   现在纳入偶发集合(Parse Error / Wrong ONVIF SOAP response / 连接重置类),
   改为首次 + 最多 2 次重试、间隔递增;SOAP Fault(设备明确的拒绝)仍不重试。

顺带把 4 个动作的执行路径统一到 _runChain/_execOnce(原先每个函数各写一遍协议分支),
去掉明显重复。

真机验证(平台原报文形状):目标主机由 192.168.8.241 变为 192.168.8.86,ONVIF 认证通过,
左转 0.8 秒 Δx=-0.0867。离线回归 46 断言全通过(新增"摄像机优先 / 录像机兜底"4 条)。
2026-09-16 17:07:56 +08:00
liufumingren
22013959a4 fix(camera): ONVIF 偶发传输错误重连重试一次(避免丢掉 stop 导致云台一直转)
线上复验(修复凭据后)统计:ONVIF 连接失败 0、Authority failure 0,运动成功 4 + 停止成功 5。
但出现过 1 次 "Parse Error: Expected HTTP/, RTSP/ or ICE/"——设备在 control/stop 连得很快时
偶发返回非 HTTP 响应(TP-Link 侧问题),原实现直接判失败。

风险不对称:丢一次"动作"无所谓,丢一次 stop 就是云台一直转(虽然有 30s 兜底超时)。
新增 _withOnvifRetry:识别 Parse Error / ECONNRESET / socket hang up / EPIPE / timeout /
ECONNREFUSED 这类偶发传输错误 → 断开该设备的 ONVIF 会话 → 重建后重试一次。
control / stop / presetGoto / presetSet 全部走这个包装;这些操作本身幂等(stop 幂等、
同速度运动幂等、预置点幂等),重试安全。非传输类错误(如设备明确拒绝)不重试,直接上报。

离线回归 42 断言仍全通过;真机回归(8.165)仍正确返回"没有云台机构"。
2026-09-15 22:15:29 +08:00
liufumingren
0d0b0b8db2 fix(camera): 云台凭据以 rtspUrl 为准 + ISAPI 通道号以设备自报为准
线上实测(69 条指令、5 台相机)暴露两个问题:

1) ONVIF 全部报 "SOAP Fault: Authority failure"
   平台下发的 username/password 字段不可靠:密码含 @ 时它把 @ 切给了 ip 字段
   (下发 ip="@192.168.11.247" + password="qwe2024",而 rtspUrl 里是 admin:qwe2024@…)。
   原来 _parseTarget 让显式字段优先,于是拿着错密码去连 → 认证失败(4 台全挂)。
   改为凭据以 rtspUrl 解析结果为准,显式字段只在 rtspUrl 缺项时兜底
   (ip / channel / port 仍以上层下发为准)。

2) 海康 IPC 直连时通道号错了 → 403
   平台从 rtspUrl 的 /streamN 推出来的 channel 是它自己的相机编号。实测 192.168.8.165
   (海康 DS-2XD8F826E 双目 IPC)只有 PTZ 通道 1,发通道 6 直接 403。
   新增:枚举 GET /ISAPI/PTZCtrl/channels,以设备自报通道为准(下发编号在列表里就用它,
   否则用第一个);枚举不到(如 NVR 不支持该接口)则沿用原推导逻辑;结果按 host 缓存。

3) 顺带:无云台机构的摄像机给出明确原因
   同一台 8.165 的 panSupport/tiltSupport/zoomSupport 全是 false(没有云台机构),
   发通道 1 设备会回 200 但什么也不动(属假成功)。现在直接返回
   "该摄像机没有云台机构,已跳过发送",避免日志里出现误导性的成功。

另:上一版试验过的"ISAPI 二次确认"(要求 deviceInfo 返回 <DeviceInfo>)已撤除——
实测未发现 ISAPI 误判(8.165 本就是真海康),而它会把权限受限/返回体不含 DeviceInfo
的真海康设备误判成 ONVIF。

真机复验:11.247 用平台那条"错密码"报文 → ONVIF 认证通过并成功转向(凭据修复生效);
8.165 → 明确报无云台机构,不再 403。离线回归 42 断言全通过(新增通道回退 / 无云台 4 条)。
2026-09-15 22:13:58 +08:00
liufumingren
8fa511dfa1 feat(camera): 云台支持 ONVIF,兼容非海康设备(实测 TP-Link 可动)
背景:平台下发的 camera.ptz.* 目标实测是 TP-Link TL-IPC682P-A4(192.168.9.226 /
192.168.11.247),设备没有 ISAPI(/ISAPI/System/deviceInfo 404,PUT 返回 405 +
{"error_code":-10000} 的 JSON),纯 ISAPI 实现必然全失败(线上 20 条指令 0 成功)。

- 协议选路:先探海康 ISAPI(_isapiProbe),不通则走 ONVIF;结果按 host 缓存,
  不会每条指令都多一次探测往返
- ONVIF 实现:continuousMove(方向用 onlySendPanTilt、变倍用 onlySendZoom,
  速度档 1~7 → 0.15~1)/ stop / gotoPreset / setPreset;
  聚焦、光圈、autoPan 在 ONVIF 下无对应接口,明确返回不支持(而不是静默失败)
- 新增 ONVIF_MOVE_TIMEOUT_MS=30s 兜底:ONVIF 的 ContinuousMove 不带 Timeout 时
  设备会一直转,服务端漏发 stop 就停不下来;设 0 可关闭以与 ISAPI 行为完全一致
- 预置点:契约里的 presetId 先按 token 匹配、再按 Preset{id} / preset_{id} 名字匹配;
  setPreset 优先指定 token,设备不接受时让它自行分配并把实际 token 写进日志
- 平台下发的 ip 字段实测是 "@192.168.11.247"(多一个前导 @),新增 _cleanHost
  统一清洗,并兼容误传完整 rtsp:// 的情况
- utils/cameraOsd.js 导出 _isapiProbe 并支持自定义 port(默认 80,原调用行为不变)

真机实测(192.168.11.247,与生产同一台):协议探测 → ONVIF,会话 profileToken=profile_1,
left 1 秒后位置 x 由 0.6766 → 0.5717(Δx=0.1049,方向正确),设备预置点 token 1~8。
离线回归 38 断言仍全通过。
2026-09-15 22:03:22 +08:00
liufumingren
13872b0514 feat(camera): 云台优先使用服务端下发的 ip/账号密码/通道
- cameraPtz#_parseTarget(rtspUrl, opts) 改为优先使用 opts 的 ip/username/password/channel/port
  (rtspUrl 仅作兜底,解析失败不再报错)
- services/camera.js 把 data.ip / data.username / data.password 透传给 cameraPtz
2026-09-15 21:57:50 +08:00
liufumingren
5258a84bee fix(camera): 云台/OSD 日志目录改用 getAppDataDir(),修复 Linux 下落到字面量目录
cameraPtz.js/cameraOsd.js 自己用 process.env.ProgramData || SystemDrive/ProgramData 拼日志目录,非 Windows 上两者都为空 → path.join('C:','ProgramData') 变成相对路径,在 9.101 上实际写到 /opt/printserver/C:/ProgramData/printServer/*.log(cameraOsd 自 7/30 起如此)。

改用项目既有约定 utils/runtime.js#getAppDataDir()(frpc.js 同款):Windows 打包版仍为 %ProgramData%\\printServer(与文档一致),Linux/开发态为项目根目录,与 frpc.log/run.log 同级。
2026-09-15 19:05:57 +08:00
liufumingren
68d84351a5 feat(camera): 云台 PTZ WS 下发(ISAPI),修复预置点路径缓存串号与 port 透传
服务端(services.printer 中转)下发 camera.ptz.control/stop/presetGoto/presetSet/auto,客户端走海康 ISAPI 执行,路径与报文对齐官方无插件 SDK(webVideoCtrl.js)。

- utils/cameraPtz.js 新增:动作表/别名/SDK 索引、速度换算(<7 档 ×15,≥7 档 100,停止=0)、候选路径回退与缓存、Digest/Basic 自适应、独立 cameraPtz.log

- services/camera.js 新增 ptz 服务;这些方法一律不返回值,避免 wsClient 回显被服务端当成一次服务调用(服务路径 camera 不存在)

- utils/cameraOsd.js 导出 extractRTSPInfo/_isapiAuth/_isapiRequest 并给后两者加可选 port(默认 80,行为不变)

- 修复:路径缓存原来存整条 URI,预置点 URI 带 presetId,goto(3) 之后 goto(5) 会先命中 presets/3 调错预置点 → 改为缓存候选序号,presetGoto/presetSet 分键

- 修复:presetGoto/presetSet/auto 漏传 opts.port,非 80 端口设备这三个动作永远失败

- 修复:日志 _writeLog 只 join 参数,%s 占位符被原样写入日志 → 改用 util.format(cameraOsd/cameraPtz)
2026-09-15 19:03:12 +08:00
liufumingren
8047294c67 feat(osd): ISAPI模式枚举设备全部通道逐一设置,不再依赖rtspUrl通道号 2026-08-27 00:02:51 +08:00
liufumingren
a6569b5cc3 fix(osd): ISAPI写入前校验通道存在性,回读验证精确匹配displayText标签 2026-08-26 23:51:12 +08:00
liufumingren
7ed52dcefe feat(osd): ONVIF失败自动嗅探回退海康ISAPI协议,RTSP通道解析+坐标系转换 2026-08-26 23:32:00 +08:00
liufumingren
fff6a2f46b chore: 移除系统服务功能,桌面壳直接托管后端子进程 2026-08-24 02:20:39 +08:00
liufumingren
4e9135c9f4 feat: Linux录制模式支持 - 平台适配/frpc/打印守卫 2026-07-28 21:55:56 +08:00
liufumingren
4912056fbf feat: improve service startup and printer status UI 2026-03-31 00:55:42 +08:00
liufumingren
5bc0e6637e docs: 完善README并收敛更新发布流程 2026-03-29 19:32:28 +08:00
liufumingren
79bae5b51e chore: init printServer and remove rsa keys 2026-03-29 13:26:23 +08:00