45 Commits

Author SHA1 Message Date
liufumingren
031778c0e3 fix(camera): 认证被拒后按 host 静默 5 秒,避免重连风暴把设备限流越打越死
现场:9.101 对整队相机都报 `SOAP Fault: Authority failure`,而**同一刻从开发机(换来源 IP)
裸 ONVIF 探针全通**,说明不是凭据问题——是设备侧对来源的会话/频率限制。
我们每条指令会做 2 次端口连接 × 最多 3 次重试,高频下发时等于持续重连,
只会把限流窗口越拉越长。

改动:
- 新增 `_connBackoff`:host 收到 `Authority failure` 后静默 5 秒,这期间不再尝试建立连接,
  直接快速失败并给出明确提示("已暂停重连 Xs(疑似设备限流)")
- 连接失败的报错信息里带上剩余静默时间,便于排查
- 保留原有的偶发错误重试(Parse Error / 网络类仍会断开重连)

另外本轮同时验证/修复的主问题:
**TP-Link 固件 bug——ContinuousMove 的 PanTilt 里 x=0 且 y≠0(纯抬头/低头)会返回畸形响应**
(Parse Error),表现为"上下没反应、左右正常"。修复方式:纯俯仰时发 ±0.001 的 x
(按 host 交替正负,pan 漂移 ~0.0006/次)。实测 9.226 从 0/6 全失败变为 6/6 全成功。

离线回归 46 断言全通过。
2026-09-16 17:47:34 +08:00
liufumingren
1a27402749 fix(camera): 修掉 TP-Link 纯俯仰失效(x=0 触发固件 bug)——"上下没反应"的真因
现象:192.168.8.85 / 192.168.9.226 上"上下操作没反应,左右正常"。

定位过程:
- 协议层看是成功的(返回 200/无异常)——不对,重新看日志发现失败全集中在 up/down:
  cameraPtz.log 里 69 次 `Parse Error: Expected HTTP/, RTSP/ or ICE/` 全部发生在
  control(up)/control(down),left/right/斜向 0 次(8.85 家族 22 次、9.226 18 次)。
- 用裸 ONVIF 做对照实验(9.226,各 6 次):
    x=0,   y=-0.4 → 成功 0/6    (Parse Error)
    x=0.02,y=-0.4 → 成功 6/6
    再测 x=0      → 成功 0/6
  relativeMove 用 x=0 同样 0/4 失败,x=0.001 则 4/4 成功。
- 也就是说这是 **TP-Link 固件 bug:ContinuousMove 的 PanTilt 里 x=0 且 y≠0 时返回畸形响应**。
  左右/斜向都带 x≠0,所以从不触发;纯抬头/低头必然 x=0,于是"上下没反应"。
  不同机器严重程度不同(9.226 100% 复现、8.85 大量、8.82/8.86 基本正常)。

修复:纯俯仰时把 x 从 0 换成 ±0.001(按 host 交替正负,避免 pan 单向累积)。
实测 pan 漂移约 0.0006/次,可忽略;9.226 修复后 up/down 8/8 全成功(修复前 0/6)。

同时提交上一轮未入库的两处(已部署但没提交):
- `_parseTarget` 有 camera 块时优先用 camera.port(顶层 port 属于录像机)
- `_onvifSession` 的端口候选改为 [payload port, 2020, 80](payload 给 2020 时也要能回退 80)

离线回归 46 断言全通过。
2026-09-16 17:46:09 +08:00
liufumingren
fd2b1caf8b fix(camera): ONVIF 连接阶段的失败也纳入重试(并把根因带进错误信息)
排查"往下不行"时发现:设备被高频点时会对 ONVIF 认证瞬时拒绝
(`SOAP Fault: Authority failure`,实测 8.85/8.86 都会偶发,几十秒后自恢复),
但这类失败发生在【连接阶段】,而原实现是 `if (!sess) return {ok:false,...}`——
不抛异常,重试包装根本拦不到,于是直接判失败。

改动:
- _onvifSession 记录每个 host 最近一次连接失败原因(超时/异常/取不到 profileToken)
- 连接失败改为 throw,并把根因拼进错误信息(否则重试逻辑按文案匹配不到"偶发")
- `Authority failure` 纳入偶发错误集合(配合 300ms/800ms 递增退避,
  给设备留出从限流中恢复的时间,比快速重试更有效)
- 退避从 150/300ms 调整为 300/800ms

验证:错密码场景耗时 1242ms(3 次尝试后失败,错误信息含 Authority failure);
正确密码 138ms 成功;离线回归 46 断言全通过。

注意副作用:凭据真的错时也会多花约 1.1s 重试才报错——这是刻意取舍,
因为高频下把"限流"误判成"密码错"会让云台整个命令失效。
2026-09-16 17:37:26 +08:00
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
f81605af2a chore(git): 停止追踪 config.json(本机运行时配置,含 token)
config.json 里是机器本地运行时状态:token/refreshToken、tokenExpireTime、downloadDir、
名称、isRecording 等,每台机器都不一样,且含有效期内的凭据。它被当作"bundled 配置"写入
时还会整体覆盖 AppData 下的实际配置(token/refreshToken/hikvision 会一起丢)。
入库既没意义又有泄露风险,改为不追踪(文件保留在本地,未删除)。

打包/默认配置仍由 config.packaged.json 提供,未受影响。

注意:其它机器 pull 到这次删除时,若本地 config.json 有改动会被拒("local changes would
be overwritten"),需要先备份该文件再 pull,或改用当前工作区的配置。
2026-09-15 22:37:40 +08:00
liufumingren
1f4083709f chore: 版本号 1.0.37/1.0.29 -> 1.0.39 2026-09-15 22:35:57 +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
4303dd55eb chore(gitignore): 忽略运行时产物(runtime.json、SQLite WAL、临时脚本)
runtime.json 由 writeRuntimeState() 在启动时生成;*.db-shm/*.db-wal 是 SQLite WAL 临时文件;v133_monitor_tmp.ps1 是一次性排查脚本。runtime.json 原已被跟踪,此处一并 git rm --cached(本地文件保留,下次启动会重新生成)。
2026-09-15 20:29:51 +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
9345485ece fix(hikvision): WS 拉流 10 秒无数据改为可重试的『取流超时』并立即断开重连重试
旧逻辑:10 秒内无二进制帧 → 判『录像机无此时间视频』→ 写 retry=3/notice=1 永久失败不再重试

实测该判定是误判:直连 8.241 查 ISAPI 搜索,该通道录像片段完整覆盖失败窗口(覆盖率 100%),同窗口任务重新入队后成功录得 20.9MB;累计 3763 条任务被此误判永久丢弃(耗时分布 10s=3243、11s=441)

新逻辑:10 秒无数据 → 抛『录像机取流超时(10秒无数据)』并立即断开,_doDownload 原地重连重试最多 2 次(间隔 2s),仍失败则交给任务队列按普通失败重试;『录像机无此时间视频』保留给 HTTP 回放路径(它先做 ISAPI 搜索确认无片段,属真实无录像)
2026-09-13 19:39:05 +08:00
liufumingren
37e7b8ddaa feat(hikvision): 任务权重与普通/加急双通道调度,修复录制进程崩溃与 frpc 孤儿问题
feat: hik_tasks 新增 weight(0=普通 1=加急),三处下发入口(fetchTasks/receiveTask/HTTP download)解析落库,老库启动 ALTER 自动补列+索引

feat: 调度器拆双通道——普通通道只跑 weight=0、加急通道只跑 weight=1,每 NVR 各 1 路,两通道互不排斥、加急通道自身互斥;任务启动抽成 _startHikTaskDownload

fix: fetchTasks 对已排队任务同步权重复下发(此前直接 continue,服务端把排队任务转加急不生效)

fix(hikvision): _httpPlaybackDownload 的 ws.on('finish') 裸调 fs.statSync,临时文件被 cleanupTmp 删除后抛 ENOENT 未捕获导致整个进程退出(2026-09-11 平台离线约 48 分钟);加 settled 守卫 + try/catch

feat(index): 增加 uncaughtException/unhandledRejection 兜底,未捕获异常只记日志不退出进程

feat(frpc): 启动前清理使用同一 ini 的遗留/孤儿 frpc(孤儿长期占着 frp 代理名,导致平台经隧道进来的调用全部失败);新增启动代际守卫,避免并发调用产生多个 frpc 抢同一代理名;修正日志占位符未格式化问题
2026-09-11 18:14:12 +08:00
liufumingren
caeca2da52 feat(hikvision): 7681 不可用时降级 HTTP 回放下载,兼容老固件 NVR 2026-09-08 20:50:15 +08:00
liufumingren
a38c369c30 fix(hikvision): 每NVR并发从3降为1,多路回放会拖垮NVR推流导致录制不完整 2026-08-29 18:42:20 +08:00
liufumingren
33e379be05 feat(hikvision): 失败任务重扫改为3分钟定时,无running且最近结束<5分钟时重置最早20个,失败记录>10条排除 2026-08-27 01:11:15 +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
a7aae1cda3 fix(osd): 新增camera.osd.set/clear WS别名服务路由,修复服务器下发OSD无响应 2026-08-26 23:45:24 +08:00
liufumingren
9ccd25459a chore: bump 1.0.37 2026-08-26 23:32:03 +08:00
liufumingren
7ed52dcefe feat(osd): ONVIF失败自动嗅探回退海康ISAPI协议,RTSP通道解析+坐标系转换 2026-08-26 23:32:00 +08:00
liufumingren
93198a8828 perf(live-stream): 低延迟参数+RTSP通道编码修正+4K缩放转码+快照兜底恢复 2026-08-26 23:31:57 +08:00
liufumingren
9ebe3d0dc4 fix(frpc): 非录制模式不自动启动穿透,仅录制模式按配置拉起 2026-08-25 15:00:03 +08:00
liufumingren
f17d8386a5 chore: 发布 1.0.33 2026-08-24 02:21:05 +08:00
liufumingren
38fa36c180 perf: 更新下载进度300ms节流、状态栏仅变化时写DOM、轮询失败静默 2026-08-24 02:21:01 +08:00
liufumingren
28a0b5db37 fix(live-stream): MJPEG限帧默认5fps、streamType=0子码流生效、三路转发背压丢帧防内存泄漏 2026-08-24 02:20:57 +08:00
liufumingren
093ca9da46 fix(shell): 修复后端子进程spawn参数传Promise导致秒退,加心跳自愈与后端日志落盘 2026-08-24 02:20:53 +08:00
liufumingren
ffd2d238c2 fix(bridge): WS桥接统一回显_msgId/_callId,响应严格按ID匹配避免广播误匹配 2026-08-24 02:20:48 +08:00
liufumingren
5bb8c30e12 fix(hikvision): PS转MP4不指定-f与bsf,由ffmpeg自动检测容器与编码 2026-08-24 02:20:43 +08:00
liufumingren
fff6a2f46b chore: 移除系统服务功能,桌面壳直接托管后端子进程 2026-08-24 02:20:39 +08:00
liufumingren
f56ca33a8d feat: 每NVR 3并发 + ffmpeg纯复制修复 + onvif依赖 + OSD日志
- 调度器: maxPerNvr 1→3, running追踪从Set改Map计数
- ffmpeg: 移除libx264重编码兜底, 修正-f mpegps→自动检测
- 新增 onvif 依赖用于摄像头OSD
- setting.setCameraOSD 增加入口/参数/结果日志
- wsClient 心跳更新
2026-07-31 23:31:33 +08:00
liufumingren
1c8f945773 feat(hikvision): WS下载稳定性与任务调度优化
- WS下载: 5s静默超时自动完成(socketClosed标志避免死锁)
- WS下载: 视频帧日志跳过(op=0x02)防止日志膨胀
- 10s无数据: 直接标记永久失败(录像机无此时间视频),不再重试
- receiveTask: 强制推送时终止进行中的旧下载,防止同一NVR双下载
- API层: 内存error状态统一映射为failed,与DB一致
- 调度器: per-IP槽位+全局并发上限
- UI: 新增完成时间列,输出显示文件大小/时长
2026-07-30 04:31:37 +08:00
liufumingren
35fefaeddf 1 2026-07-28 23:46:46 +08:00
liufumingren
4e9135c9f4 feat: Linux录制模式支持 - 平台适配/frpc/打印守卫 2026-07-28 21:55:56 +08:00
liufumingren
da67b15465 1 2026-06-06 03:46:02 +08:00
liufumingren
b0cbc3c666 1 2026-06-03 14:31:58 +08:00
liufumingren
d190c2add6 1 2026-05-29 17:45:51 +08:00
liufumingren
9978ba9c3d 1 2026-05-13 01:18:42 +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
f77ab95a90 docs: add runtime/service todo note 2026-03-29 13:27:42 +08:00
liufumingren
79bae5b51e chore: init printServer and remove rsa keys 2026-03-29 13:26:23 +08:00