73 Commits

Author SHA1 Message Date
liufumingren
2042f5207d chore(desktop): csproj 版本跟进到 1.0.161
build.ps1 不传 -Version 时默认取 csproj 的 <Version>,而它一直停在 1.0.112,
裸跑会打出一个比线上还旧的版本号(自动更新不会提示)。跟已发布的 1.0.161 对齐。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-17 01:25:11 +08:00
liufumingren
2a81047f81 perf(desktop): 回放合并改用 xstack 一次合成 + 硬件编码(含自动兜底)
合成(ComposeAsync):
- 链式 overlay 在 1080p 画布上要走 N-1 遍整帧混合,改成一条 xstack 一次合成;
  画布比矩形并集大就 pad 补黑,越界摆位就 crop 裁掉(等价于原来叠在黑画布上)
- 实测(本机 i5-12400 + UHD 730):60s x 4 路 24.7s -> 16.1s(libx264)、
  26.5s -> 16.5s(qsv);120s 片段走 ComposeAsync 实路径 36.3s -> 25.2s
- 输出与旧实现逐像素一致(PSNR inf):标准 2x2、混合尺寸、留空、越界裁剪四种布局;
  矩形重叠时 z-order 与 overlay 一致

编码器(新增 FfmpegVideoEncoder):
- 优先 h264_qsv / h264_nvenc / h264_amf,都没有或跑不起来回落 libx264
- 探测 = 拿 0.2 秒黑场真编一帧(看 -encoders 列表不够:装 nvenc 没 N 卡也在列表里),
  结果缓存在进程内;QSV 探测约 1 秒,驱动缺失的候选 0.05 秒,单个候选上限 4 秒
- 硬件编码失败(非 0 退出 / 退出码 0 但没写出成片)自动用 libx264 重试一次
- 质量档位对齐原 crf23:qsv gq26(PSNR 持平,体积 +7%)、nvenc/amf qp26
- 排障:YUNCANG_COMPOSE_ENCODER 可跳过探测强制指定,写错名字按 libx264 处理

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-17 01:20:33 +08:00
liufumingren
c07d5c640b fix: 扫码结束键按设备识别、发现列表就地刷新、NVR 唯一性按主体
AndroidStation
- 有的扫码枪(Newtologic DW-8200,T95MAX/Android 12)用 KEYCODE_DPAD_CENTER 当结束键,
  之前只认 ENTER/TAB:结束键会落到当前焦点按钮上(一扫就进「服务设置」,焦点在
  「清空记录」时还会清空记录),而且扫码只能等 50ms 超时才提交。现在按 deviceId 认
  “刚发过条码字符的那台设备”,DPAD_CENTER 也算结束键,遥控器 OK 键不受影响。
- 新增「播报走本机扬声器(AV / 3.5mm)」开关(默认关):个别机型插 HDMI 时 HAL 会把
  媒体声音锁在 HDMI 声卡,需要显式指定内建扬声器。

桌面端
- 发现列表改为按 MAC 就地合并,不再整表 Clear(每 3 秒一次刷新会把 ListView 的选中项
  和滚动位置清掉,现场表现为“设备选不中”)。
- 「添加为通道」从标题行移到列表行内「操作」列,不再依赖选中项。

后端
- NVR 唯一键由全局 (host, port, username) 改为 (subject_id, host, port, username):
  不同仓库的内网地址经常相同,之前会报「已被其他主体添加」。查重也只查本主体。
- 新增迁移 20261116010000-scope-nvr-unique-to-subject 与按主体范围的测试。

构建
- android_client/build.ps1:gradle 把 javac 的 stderr 提示写出来时,PowerShell 的
  $ErrorActionPreference='Stop' 会把它当终止错误,release 包必失败;改为只以退出码判定。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-16 02:43:26 +08:00
liufumingren
53da30f733 feat(label-scan): 多码同框全部解出 + 条码历史判断新码/最后出现
一帧里只认第一个解码成功的条码,两张面单并排时必然只报旧码、漏掉新码
(角点顺序由检测器决定,跟哪张是新面单无关)。改成:

- 一帧的每个候选都解,不再解出第一个就停;同帧两个新码都上报,不压帧不投票;
- 新增条码历史(旧→新,最多 4 个):本帧解出的每个码都刷新「最后出现时间」;
  历史里没有的码立即上报,已有一律只刷新在场、不重复建档/播报;
- 多码同框时上报/续期的是「最后出现的那个」,不是检测器先解出来的那个;
  一直看得见的码不重排(避免每帧互相顶掉导致上报抖动),离开又回来的挪到末尾;
- 超过 45 秒没再出现的码淘汰(与「面单离开」同一阈值),再出现按新码上报。

排障新增 agent-status.json 的 LabelScan.Items[].RecentCodes(历史,旧→新)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 23:04:29 +08:00
liufumingren
2ed4fa8483 feat(workstation): 一台工作台支持多路面单摄像头 + 绑定管理可改画布尺寸
- 面单摄像头不再限制一台工作台一路:设置新的不清旧标记,取消最后一路时才清理虚拟通道
- 面单识别配置按 工作台+摄像头 逐路下发,多路共用上报通道;多路时虚拟通道名改用工作台名
- 绑定管理新增画布尺寸(宽×高)编辑:160~7680、自动取偶数;改尺寸时已摆放摄像头按比例缩放
- 画布组件在宽度变化时重新计算等比缩放,避免新画布溢出或缩不满
- 补充后端单测与相关文档

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-08 23:45:25 +08:00
liufumingren
6f52613e5e feat(desktop): 下线 Edge 企业策略安装(扩展已上架商店)
- 工具菜单去掉「安装浏览器插件(企业策略:Chrome / Edge)」「卸载浏览器插件(企业策略)」,
  删除 Services/ExtensionInstaller.cs(.reg 生成 + 提权导入 + 注册表校验)
- 只保留「安装浏览器插件(Edge 应用商店)」与「复制插件路径(Chrome / 开发者模式)」;
  商店弹窗去掉「审核中会 404」的说法,Chrome 用户直接引导到开发者模式
- 文档同步(桌面 README / 后端 README / extension README / STORE-SUBMISSION / keys README):
  写清老机器上残留的 HKLM 策略怎么手工清理,避免和商店版同时注入
- extension:publish(.crx + updates.xml)保留,仅给内网/离线分发用

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 16:32:55 +08:00
liufumingren
1dc3404eae fix(osd): 空闲回退写回摄像头名,不再写工作台名
- DesiredText:60 秒没扫到时还原成**摄像头自己的名字**(摄像头没名字才退回工作台名,
  避免把通道名写空)
- 配置里被移除的摄像头同样还原成摄像头名
- 同步注释与文档(桌面 README / 根 README / 后端接口注释)
- 实测(真实 NVR 通道 35/37):首次="测试A/测试B"、扫码="测试A 7734… / 测试B 7734…"、
  70 秒后回退="测试A/测试B",三个阶段的并行时间差 50~103ms

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 06:55:07 +08:00
liufumingren
b8629dd0dc perf(osd): 多路摄像头并行写 OSD,去掉 1 秒空转
- WorkstationOsdService:单路串行队列改成批量并行(一批最多 4 路,批内按通道去重),
  写完一批还有待写的立刻继续,不再固定等 1 秒 tick
- HikDeviceService:SetChannelOsdName 走 serialize:false,不占用会话 Gate(不同通道可同时下发),
  登录改用会话内锁,保证并发时只登录一次
- 实测(真实 NVR 通道 35/37):两路写入时间差 49ms / 36ms(改造前串行 + 1 秒 tick 时为 1~3 秒);
  并发读改写 20 次全部成功,除通道名外配置字段零差异

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 06:48:57 +08:00
liufumingren
9e57925dd7 docs(desktop): 说明多摄像头工作台的 OSD 是依次写入
同一台录像机的配置是整包读-改-写,不能并发,所以第二路通常比第一路晚 1~3 秒上屏。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 06:30:42 +08:00
liufumingren
c7cf7127d4 feat(osd): 工作台摄像头 OSD 字幕写入运单号
- 后端:新增 workstationConfigOf 与 GET /api/scanner/workstations,只下发绑定了本机通道的工作台及其摄像头与 NVR 凭据
- 桌面:新增 WorkstationOsdService/OsdText——扫码命中即写「摄像头名 + 单号」,单号不变不重写,连续 60s 未识别恢复工作台名;单线程写队列、失败退避、配置移除的摄像头还原一次
- 桌面:HikDeviceService.SetChannelOsdName 读-改-写 + 回读校验(GBK、31 字节、按字符边界截断)
- 修复 build.ps1 / test-update.ps1 丢失 UTF-8 BOM,PowerShell 5.1 按 GBK 解析中文注释导致语法错误

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 05:39:40 +08:00
liufumingren
78a923235d feat(desktop): 工具菜单按渠道分流——Edge 走商店、受管设备走企业策略
插件分发现在有两条线,菜单按浏览器/设备分流,避免现场走弯路:

- 新增「安装浏览器插件(Edge 应用商店)」:优先用 msedge.exe 打开商店安装页
  (mgdonmkicojkabgalgekobaoohaohfcj),点「获取」即可,不需要开发者模式/管理员权限;
  审核期打开会 404,弹窗里已说明;
- 原「安装谷歌插件」改为「安装浏览器插件(企业策略:Chrome / Edge)」,确认框补一句
  「电脑必须已纳管,否则浏览器会拒绝非商店来源扩展」;
- 策略安装失败时,弹窗从只能走开发者模式改为按浏览器给两条路(Edge→商店、Chrome→开发者模式);
- 「卸载谷歌插件」→「卸载浏览器插件(企业策略)」,其余文案统一去掉谷歌字样(Chrome 也叫不了谷歌);
- README:补商店优先、两个 ID(mgdon… / lkei…)不能混装、剪贴板重试改为后台 STA + 截止时间。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 05:02:12 +08:00
liufumingren
6818da707e build(extension): 分发用压缩产物(esbuild minify,不混淆)
MV3 没有编译产物,桌面安装包会把插件源码装在 <安装目录>\extension,用户能直接看到
带注释的代码并随手改。这里加一层「压缩」:去注释、压空白、缩短标识符,体积 71KB → 30KB。

- backend/scripts/deploy/build-extension.cjs(新):esbuild 逐文件 minify 输出 extension/dist,
  不做 bundle(importScripts('lib/rules.js') 与各处路径原样有效),无 eval/Function,
  满足 MV3 的 CSP 与商店「代码可读」要求;
- publish-extension.cjs:打包/压缩包一律从 dist 取源;商店 zip 改用自写的
  zip-util.cjs —— PowerShell 5.1 的 Compress-Archive 会把条目名写成 `src\x.js`,
  8.3 短路径下还会多出前导 `/`,商店会当成怪文件名;
- desktop csproj 改为打 ..\extension\dist\**,installer/build.ps1 在 dotnet publish 前
  自动跑一次 bundle(找不到 node/esbuild 明确报错,避免打进上次的旧 dist);
- extension:rules.js 的兜底 urlTemplate/fallback 从 localhost:7301 改为线上站点
  (和服务端默认值保持一致),版本 1.1.2;
- backend 增加 esbuild devDependency 与 npm run extension:bundle;文档同步。

验证:5 个 js 全部 node --check 通过;dist 里 manifest 引用的 14 个文件都在;
Chrome --pack-extension 成功(扩展 ID 不变);zip 条目全部是标准 `/` 且 manifest.json 在根目录、
可正常解压;desktop Debug 编译 0 警告 0 错误,输出目录里是指向 dist 的压缩版(无 keys/README/test)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:53:13 +08:00
liufumingren
73ee020025 fix(desktop): 复制插件路径不再误报「剪贴板被占用」
现场日志显示 6/6 次写入都抛 CLIPBRD_E_CANT_OPEN,但用户粘贴完全正常 ——
根因是远程桌面软件(实测 BilldDesk)长期把剪贴板开着,同时它会把内容同步成
「上次复制的那段文字」,所以剪贴板里本来就是我们要复制的路径。

- 复制前先核对剪贴板内容,已经是目标文本就直接算成功(不再弹占用提示)
- 写失败后读回来核对(OleFlushClipboard 失败时数据其实已写入)
- 重试改成带截止时间(4 秒)的退避重试,并补一次 OleFlushClipboard
- 全部剪贴板操作放到后台 STA 线程(带 5 秒兜底超时),事件处理器改 async,
  剪贴板被锁时界面不会卡住
- 真失败时用 GetOpenClipboardWindow 查出占用进程名,写进提示与日志

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:43:06 +08:00
liufumingren
fd433ee0fc chore: 本地其他改动(EXE 安装包、统计口径、扫码与工作台视图)
- desktop/installer:新增 Inno Setup 的 EXE 安装包定义(YuncangTrace.iss)与 build.ps1 的 MSI/EXE 双产物支持
- backend:统计口径排除已删除/未绑定工作台的记录;扫码相关调整
- frontend:首页/工作台排行/本机软件下载等视图微调

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:16:30 +08:00
liufumingren
11ebb33966 feat(extension): 插件配置集中管理 + 桌面端策略安装 + 跨网下载修复
- 后端:sys_config 存插件配置(识别前缀/生效站点/模板),平台管理员 GET/PUT /api/web/admin/extension;
  插件读取 GET /api/web/extension/config(Redis 缓存 1 小时,保存即失效)
- 前端:平台管理 → 插件配置页(只维护前缀,单号正则由服务端生成)
- 插件:改为只拉取执行(每 5 分钟 + 手动同步),移除规则编辑/试跑/导入导出;安装包地址自动取最新发布
- 桌面端:工具 → 安装/卸载谷歌插件(生成 .reg + reg import 写 HKLM 策略,读注册表验证);
  跨网下载改走云端中转;局域网探测补排障日志;自动更新按包类型取 md5Exe/sizeExe
- 发布:npm run extension:publish(crx + updates.xml)、extension:zip(商店上传包),
  nginx 对 /download/extension/updates.xml 关缓存

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:16:26 +08:00
liufumingren
a4a0b18440 chore(desktop): 修正 csproj 注释与产品名乱码(GBK 被当 UTF-8 存)
注释、Product / Company / AssemblyTitle 原来是乱码,按 UTF-8 重新保存;
版本号(1.0.112)与构建参数(TargetFramework / ServerBaseUrl 等)均未改动。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:05:31 +08:00
liufumingren
43dae198db chore: Android 扫码台设置页、发布脚本健壮性与文档同步
- Android 扫码台:设置页新增「设为默认桌面 / 解除默认桌面 / 回到盒子桌面 / 打开系统设置」等现场免 adb 操作
- android_client/build.ps1:gradle 的 javac 提示走 stderr,改成 2>&1 逐行 Write-Host,避免被当成构建失败
- deploy-lib.cjs:ssh 加 ServerAliveInterval/CountMax 与 -n,避免发布脚本卡在远端命令结束前不退出
- set-password.js:重置密码时补写 password_changed_at(否则旧 JWT 不失效)
- .gitignore:忽略 video_split/(调试用的视频拆帧产物)
- 文档同步:README / backend README(微信网关、成员扫码绑定、平台管理员、顶栏下载入口、已下线的自建微信表)/
  database README / desktop README

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:21:41 +08:00
liufumingren
b2eea28001 feat(微信网关): 扫码登录 / 绑定微信 / 工作台扫码登入,废弃自建登录码
对接 https://gateway.gztbyc.com:二维码与「扫码确认」由网关提供,本服务只负责
申请临时码 → 验签收通知 → 落地自己的业务。

- 新增 service/wx_gateway.js + controller/gateway/notify.js(POST /api/wechat-gateway/notify,验签 401 / 会话过期 200 ignored)
- 新增 controller/web/wx_gateway.js(登录二维码 / 长轮询 / SVG+GIF / 个人中心绑定与解绑)
- 新表 wechat_gateway_bindings(uk(app_key, openid)):一个微信只绑一个账号,解绑是软删,
  再绑定走 restore 复用(否则会撞唯一键报 Validation error)
- 「这个微信已绑别的账号」策略:原账号正常 → 拒绝并提示对方账号名;原账号禁用/已删 → 直接改绑;
  拿不到原账号 → 运维接口 GET/DELETE /api/internal/wechat-bindings 强制解绑
- 主体成员改为「扫码绑定」:管理员出二维码 → 成员微信扫码 → 已有账号直接继承(自动建的临时账号删掉),
  没有账号则由服务端建号并绑成其登录方式;subject_members.temp_user_id 记录临时账号
- 废弃自建登录码:删除 GET /api/wechat/login(6 位串码)与 workstations.login_code(迁移 20261028121000),
  工作台改扫码登入,成员绑定码与 /wechat?bind= 手机确认页下线
- 前端:登录页/个人中心/主体成员/工作台全部切到网关;桌面端登录窗改网关二维码 + 长轮询
- 测试:wx-gateway.test.js 覆盖登录/绑定/解绑-再绑/禁用账号改绑/运维强制解绑/成员绑定/工作台登入

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:20:05 +08:00
liufumingren
f8aa4c4899 feat(工作台): 成员扫码登入、面单摄像头与虚拟通道
- 工作台成员扫码登入:workstation_login_records 记录谁在什么时候登入/下线了哪台工作台,
  超时(团购 1h / 散单 30min)由 schedule/workstation_idle_offline 自动下线;
  运单查询的 packers 取当时的登入成员
- 面单摄像头识别:workstation_cameras.is_label_camera + service/label_scan 下发本机该跑的识别配置,
  设备端(桌面端 LabelScan 工作线程)按配置做面单识别并上报
- 虚拟通道 CAM-<工作台id>:工作台没接扫码枪时,面单摄像头那一路顶替扫码枪上报,records 规则按 ws_type 区分
- 桌面端:新增 LabelScanMonitor/LabelScanWorker/ScanDeviceKind 与面单预览页,扫描通道支持改名,静默窗口 5s

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:19:24 +08:00
liufumingren
b135ef09d4 扫码上报静默窗口从 5 分钟改成 5 秒
有积压时上报循环每秒检查一次(空闲仍 30 秒保活),保证「最后一次扫描 + 5 秒」就能上报;时间被刷新则重新计时并再次上报。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 23:28:21 +08:00
liufumingren
ed063db9f4 桌面端补上「通道改名」:已添加的通道不用再删了重加
之前通道一旦添加就只能删掉再添加来改名,而删除会让服务器软删该通道、
解绑工作台,还容易把通道号换掉。

- 扫码通道页新增「重命名」按钮(选中一行才可用),弹 RenameChannelWindow:
  只改名字、通道号不动
- ScanService.RenameChannelAsync:名字落本机 channels.json 后用普通推送同步服务器
  (POST /api/scan/channels 按 channelId 更新 channelName,不走 replace 全量对账);
  名字没变就不推服务器
- 可选「同时把名称写入设备」(SYS.HostName,默认勾选,设备 IP 未知时禁用):
  与添加通道一致,写失败只提示、不回滚本机改名
- 服务模式下本机只写通道文件,后台服务发现文件变化会自己重载并重连
- 删除通道按钮同样改成「选中才可用」,避免点了没反应

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 21:39:28 +08:00
liufumingren
fd2ed16033 多路回放/预览改为以最长的那一路为准收尾
各路是从自己的关键帧起推的,同样 8 秒的请求,20fps 那路只有 8.0 秒、
25fps 那路有 9.0 秒。按请求窗口统一截断会把长的那段尾巴切掉,
不截断又会一直往后播。

- 预览窗口:按「队列空了 + 1.5 秒没再收到新帧」判定这一路播完,
  且必须播过窗口 80% 才认(中间网络卡一下不能当播完);
  先播完的定格最后一帧,等全部播完再释放设备会话;
  另有 Window + 15 秒硬上限,防止录像机一直推流
- 标题显示「回放结束(Xs)」,X 是最长那路的实际时长
- 合并下载:总时长取各段真实时长中最长的一段(读 ffmpeg 的 Duration:),
  短的那格在 overlay 里定格最后一帧

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 21:30:38 +08:00
liufumingren
41063761f7 主码流实时预览改走 UDP + 关掉流分析与重排缓冲
主码流走 RTSP over TCP 时,一旦设备发送缓冲/交换队列有排队,延迟只会越堆越高
且永远追不回来(TCP 不丢帧),现场表现就是「越看越慢」。

- Open() 默认低延迟:-rtsp_transport udp,外加
  -analyzeduration 0 -max_delay 0 -reorder_queue_size 0 -avioflags direct
  -fflags nobuffer -flags low_delay -fps_mode passthrough
- 4 秒还收不到帧就杀掉进程、改用 TCP 重开一次(部分网络禁 UDP,
  不能让用户因此看不到画面);重开只做一次,并用 RestartGate 串行化
- 复用键带 |ll 后缀,实时预览与回放(OpenUrl 默认 lowLatency=false)不会串流;
  回放仍走 TCP,因为回放靠时间戳对齐,丢包会算错延迟
- 补两行日志:ffmpeg 实际用的传输方式、首帧耗时(ms)
- README 补齐子码流/主码流两条链路的延迟差异与排查日志

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 21:30:29 +08:00
liufumingren
8c83275719 本机 HTTP/WS 改用自建 TcpListener,不再依赖 HTTP.sys
现场机器上 HTTP 服务被安全软件/系统优化禁用或卡在 STOP_PENDING 时,
HttpListener.Start() 抛「句柄无效(6)」,HTTP 17300 与 WS 17301 会同时起不来
(2026-10-23 升级 1.0.113 后的现场故障)。

- 新增 LoopbackHttpServer:TcpListener 直接监听 127.0.0.1 + ::1,自己解析 HTTP/1.1 请求,
  Host 不是回环地址的直接断开;不需要 urlacl / 管理员权限
- LocalHttpServer 改用它,请求处理不再直接摸 HttpListener 类型
- LocalWsServer 在同一层自己完成 WebSocket 握手(Sec-WebSocket-Accept),
  再交给 WebSocket.CreateFromStream;关闭时 CloseReceived 也回一帧 Close,
  避免浏览器报「未完成关闭握手」
- 启动失败的提示改成按 SocketError 判断(端口占用 / 无权限)
- 已回过响应后不再兜底写 500(否则一条连接上会出现两个响应头)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 21:30:25 +08:00
liufumingren
950b16a0dd 选路细节只进日志,界面只留结果
现场反馈「校验完成了还显示【选路】是什么意思」。那些行本来是给排障用的
(局域网设备管理服务 → 云端 → 本机直连 三级降级),操作员看只会困惑,
而且降级链一长,结果和过程就混在一起。

- [选路] / [时钟] 全部改写日志([route] / [playback])
- 界面只保留:正在校验第 N 路、[有录像]/[无录像]/[失败]、校验完成总结

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:34:28 +08:00
liufumingren
7b4705c73c 走设备管理服务时本机不再登录录像机
校验循环里在判断 peer 之前就调了 _playback.ClockOffset(),而它内部会
初始化 HCNetSDK 并登录 NVR —— 于是「走设备管理服务」之后本机又登了一次,
既出现「明明检查过又检查一遍」的观感,也正好抵消了共用会话池的意义
(海康并发登录通常只有 6~16)。

- 时钟对齐挪进 peer is null 的本机分支
- 走边端时结果行标注「(设备管理服务)」,本机不碰录像机

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:32:48 +08:00
liufumingren
85db722384 修复:A→B 的 POST 全部无效(JsonContent 不带 Content-Length)
边端是手写的 HTTP 读取,只认 Content-Length;而 A 侧一直用
JsonContent.Create(),它产生的是 chunked 请求 —— 边端把 body 读成空,
/check 直接 400,界面就显示「设备管理服务无响应,改由本机校验」。
也就是说局域网共用取流池这条路,用真实客户端从来没成功过,
此前只有 curl 验证过所以一直没暴露。

- EdgeClient 改用 StringContent(显式 Content-Length)
- 边端遇到 chunked 请求时明确记一行,不再让调用方看到「空 body」的怪错误

实测:JsonContent → 400 contentLength=null;StringContent → 200 contentLength=186

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:28:58 +08:00
liufumingren
63b70c6ad5 补上边端取流的请求级日志,并让 A 侧连接失败自动重试一次
现场表现:查询提示「设备管理服务无响应,改由本机校验」,但边端和 A 侧
都没留下任何痕迹 —— /check 这条路径原来只在异常时记一行,成功完全静默,
A 侧拿到非 2xx 也只返回 null。

- 边端 /check 每次记一行(通道、时间窗、hasRecord、帧数、来源、耗时)
- 主体不符被拒时记录路径、原因和本体主体
- A 侧 EdgeClient:非 2xx 记录状态码+响应体;传输层异常(worker 重启后
  连接池里的死连接)自动重试一次,取成片同理

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:24:41 +08:00
liufumingren
f38bf082f1 修掉「本机明明有设备管理服务却走云端」
现场表现:更新/重启后头几十秒里本机查询都提示「改问云端」。原因是
hik-worker 的懒启动被安排在 20 秒后,而 UDP 17310 应答由 worker 提供;
A 探测不到就只能走云端,偏偏是云任务反过来才把 worker 拉起来,形成死循环。

- worker 自检从启动后 20 秒提前到 3 秒(实测 UDP/TCP 约 5 秒内就绪)
- 局域网应答的 UDP 绑定加 30 次重试(约 60 秒),上一条日志里它在重启后
  没绑上且没有任何痕迹;现在失败会记「第 N 次重试」和最终放弃
- AppLog 改为独占写 + 失败落本进程旁路文件 log_<日期>.p<pid>.txt,
  避免并发写把行写截断(FileShare.ReadWrite 会撕裂行)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:19:09 +08:00
liufumingren
49681b7bdd 加固日志:写入不再静默丢失 + 心跳每 5 分钟落一行
上次现场排查发现 16:28-22:47 六小时日志全丢,但同一时间上报和
scan-records.json 都正常 —— 原因是 File.AppendAllText 按 FileShare.Read
打开,日志文件被别的程序占着时每次都抛 IOException,又被 catch{} 吞掉。

- AppLog 改用 FileShare.ReadWrite|Delete 打开并重试一次,仍失败则累加丢弃计数
- agent-status.json 暴露 LogDropped / LogLastDroppedAt,现场能看出日志是否完整
- 心跳日志改为每 5 分钟一行(含在线通道数、待上传条数),持续失败也每 5 分钟补一行
- 通道断开日志沿用原有节流(前 3 次 + 每 10 次),配合心跳行可定位断点

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:12:14 +08:00
liufumingren
fbcbd80acc 修复两个会导致软件无法使用的启动/校验缺陷
1) 提权重启无限循环:内置 Administrator 没有 UAC 分离令牌,自愈重启后
   仍是提权,于是每秒自我重启一次,窗口永远出不来。加 30 秒时间戳防抖,
   第二次直接留在提权状态运行并记录原因。
2) 自动校验静默卡死:ValidatePlaybackAsync 内部 await ConfigureAwait(false)
   之后仍直接写 WPF 控件,抛出的异常又被 fire-and-forget 吞掉,界面停在
   「正在校验 N 路回放…」。UI 更新统一切回 Dispatcher,并给入口加 try/catch
   把异常写进日志、显示到界面上。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 02:39:22 +08:00
liufumingren
c280e94b9a 加固局域网询问应答:主体 + 后端身份双校验
主体 id 在各环境的库里都从 1 开始,光比 subjectId 挡不住跨环境串台
(开发库和生产库的测试仓库都是 1),旧机器只要 agent.json 还在就会一直应答。

- 询问必须带 subjectId>0 和 server,缺任一项不应答
- 应答回带 server,A 侧也校验一致;不一致直接丢弃
- 多台应答按 (SN, 主机) 去重,并优先本机地址
- 版本号提到 1.0.105

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 01:27:49 +08:00
liufumingren
9075a1f4f3 desktop: 选路结果落日志 + 云端校验结果带帧数
- ValidatePlaybackAsync 记录最终选路结论(云端/本机、有没有录像、给了哪些按钮),
  现场排障不用再靠猜;跨网时也能直接从日志看出走没走云端。
- EdgeCheckOutcome 增加 Frames,与本地校验的展示保持一致。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 01:00:08 +08:00
liufumingren
9d3ad422de desktop: 边端监听地址可配置(YUNCANG_EDGE_BIND)
默认 0.0.0.0(局域网可发现、可直连);设成 127.0.0.1 时只给本机用,
不把取流端口暴露到局域网 —— 既方便同机多实例测试,
也适用于"这台机器只服务自己、不让同网段其它查询机发现"的部署。

配合已有的 YUNCANG_EDGE_UDP_PORT / YUNCANG_EDGE_HTTP_PORT 使用。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 00:50:48 +08:00
liufumingren
993c7acd30 跨公司下载:云端中转成片(分片上传 + Range 下载)
A(查询机)和 B(仓库)不同网络、B 无公网 IP。B 出站领任务后把成片传回云端中转,
A 再从云端取回本地 —— 全程不需要任何一方有公网入口。

云端
- POST /api/web/edge/download      建任务(按主体选在线设备 → 下发 download)
- GET  /api/web/edge/download/:id  查进度(queued/uploading/done/failed)
- GET  /api/web/edge/download/:id/file  取成片,支持 Range(浏览器播放要拖动进度条)
- POST /api/scanner/tasks/:id/upload  设备分片上传(原始字节流,不是 base64)
- bodyParser 对该上传路由禁用:否则原始请求体会被解析掉
- 成片落 run/edge-files(run/ 属部署保留目录,不会被发布覆盖)
- 每次建任务顺手清理过期文件;元数据按主体校验,越权一律 404

桌面端
- AgentHost 新增 download 任务执行:worker 拉流合并 → 分片上传 → 传完删本地临时文件
- 失败时把 uploadTaskId 带回云端,立刻落 failed,查询机不用干等到超时
- ApiClient 新增建任务 / 查状态 / 取文件 / 分片上传
- PlaybackDownloadService 改为三级选路:
  LAN 设备管理服务 → 云端中转 → 本机直连

实测(真实 NVR)
  建任务 → 设备拉流 1.9MB → 上传 → 下载:7.5 秒,字节数一致,ftypisom
  Range: bytes=0-99 → HTTP 206 + Content-Range 正确

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 00:30:09 +08:00
liufumingren
290f29e547 跨公司取流:云端边缘任务通道 + 三级降级
场景:查询机 A 和打包仓库 B 在不同网络,B 没有公网 IP。
B 只能主动出站,所以云端从不反向连它 —— 复用设备出站链路做任务通道。

云端(backend)
- 新增 edge_task 服务:Redis List 做队列、短 TTL 存结果,
  多实例共享,不依赖 sticky session
- POST /api/scanner/tasks/poll:设备长轮询领任务(挂 20 秒,
  有任务立刻返回,没任务 204)
- POST /api/scanner/tasks/:id/result:设备回结果
- POST /api/web/edge/check:查询机问「这段有没有录像」,
  云端按主体选出在线扫码服务 → 下发 check → 等结果(默认 8 秒)
- 不阻塞共享 Redis 连接:任务用短间隔轮询而非 BLPOP
  (egg-redis 是共享连接,阻塞命令会卡住其它请求)

桌面端(desktop)
- AgentHost 新增边缘任务循环:长轮询领任务 → 交 worker 执行 → 回结果,
  与扫码链路完全解耦,异常只退避重试
- worker 新增 check 能力(复用 HikPlaybackService.CheckAsync)
- ApiClient 长轮询单独用不限时客户端(共享 HttpClient 的 15 秒超时会掐断)

三级降级(桌面端校验)
1. 局域网有设备管理服务 → 交给它(共用 NVR 会话池)
2. 没有 → 问云端;云端确认有录像时**隐藏预览、只显示下载**
   (跨网拉流成本高,短片段/下载更合适)
3. 云端也判断不了 → 本机自己校验(仓库内操作员的常规路径)

实测(真实 NVR 192.168.8.241 通道 34)
  设备心跳 → 领任务 → worker 校验 → 回结果 → 网页拿到结论
  端到端 2.17 秒(其中 NVR 拉流约 2 秒)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 00:26:27 +08:00
liufumingren
6f8095913b desktop: 选路改为「有设备管理服务就统一走它」
之前的判定是「本机连不上 NVR 才走 B」,导致同 LAN 多台机器各连各的,
录像机并发登录数照样被打满,设备管理服务的会话池闲置。

选路(StreamGateway)
- 新增 StreamGateway:广播询问(带 NVR 地址)→ 有应答就用它,
  没有才本机直连;结果缓存 15 秒(含"没找到"的负结果)
- 转发失败时 Invalidate,下次重新探测
- 广播询问带 nvrHosts:对端实测连不上该 NVR 就不应答

校验走设备管理服务
- B 侧新增 POST /check,复用 HikPlaybackService.CheckAsync
  (真拉一小段,语义与桌面端本地校验一致)
- 桌面端校验改为优先交给设备管理服务;服务无响应则降级本机并重新探测
- 并发上限 4,避免多台查询机同时校验把 NVR 打满

下载走设备管理服务
- PlaybackDownloadService 去掉 CanReachNvrAsync 判定,改用 StreamGateway
- 服务端(hik-worker)自身不装网关,永远本地执行

其他
- 边端端口支持 YUNCANG_EDGE_UDP_PORT / YUNCANG_EDGE_HTTP_PORT 覆盖
  (同机并行跑两个实例测试时用,与 YUNCANG_LOCAL_WS_PORT 同思路)
- SDK 校验路径不数帧(返回 -1),界面只在有帧数时显示"试拉 N 帧"
- 顺带修复:下载临时文件名未对 CameraName 做 Sanitize,
  摄像头名含 ? : * 等字符时会整段下载失败

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 23:51:54 +08:00
liufumingren
46e4f12802 desktop: 取流子进程隔离 + 局域网询问应答 + 跨网下载
把海康取流从扫码服务主进程拆到 --hik-worker 子进程,原生 SDK 崩溃
不再连带扫码收码;新增局域网询问-应答与跨网下载通道。

隔离与守护
- 新增 HikWorker(子进程):独占 HCNetSDK 与 NVR 会话池
- 新增 HikWorkerSupervisor(主进程):懒启动、管道通信、
  5 分钟内失败 3 次熔断 10 分钟
- 管道协议为 [4 字节长度][JSON],进程退出即知,不占端口
- ServiceInstaller 复制 native(HCNetSDK/ffmpeg),先删后拷,
  避免 SDK 升级残留旧 DLL;安装时放行 TCP 17311 / UDP 17310

局域网询问-应答(不是主动公告)
- UDP 17310 收询问,只回同 subjectId;带了 nvrHosts 时先实测可达,
  连不上就不应答,让查询机继续走本机
- 应答带 TCP 17311,查询机一次连接即可判定是否同 LAN

跨网下载
- TCP 17311 提供 /health、/probe、/download、/download/{id}
- 除 /health 外均要求 X-Edge-Subject 且与配置主体一致
- 成片在传输完成后立即删除,另有 done 10 分钟 / failed 15 分钟
  TTL 兜底,避免现场磁盘被临时文件吃满

桌面端选路
- DownloadAsync 先探 NVR 8000(600ms):通则沿用原有本机直连,
  不通才广播找取流服务,取回后落到本机录像目录
- DownloadByPlanAsync 拆分:不查库、不需要用户令牌,
  供只有设备令牌的服务端复用

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 22:48:09 +08:00
liufumingren
000a45d6cb 拉取通道补回通道名(走 8000 私有协议,不依赖 ISAPI)
- 新增 NET_DVR_GET_PICCFG_V30(1002):结构体头部 DWORD dwSize + char sChanName[32] 即通道名,GBK 编码;
  实测 DS-7932N-R4 32 路约 250ms,中文(团购复核区1 / 单号:xxx)正常
- 只查 enabled 通道(空槽位回 err=4 直接跳过),失败只写日志,不影响其他字段
- ISAPI 降级为兜底:PICCFG 一个名字都拿不到时才读 ContentMgmt/InputProxy/channels
  (先 500ms TCP 探测,依次试 80/443/8443,按 IP 匹配、再按 id 推)
- 新增 HikSdk.DecodeGbk:注册 CodePagesEncodingProvider 后按 GBK(936) 解码,注册失败退回 ASCII
- 桌面端 README 更新通道名来源说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 14:21:32 +08:00
liufumingren
27482723ff 修复「复制谷歌插件地址」剪贴板占用报错
- Clipboard.SetText 在别的进程持有剪贴板时会直接抛 CLIPBRD_E_CANT_OPEN(0x800401D0),
  改为先 WPF 再 WinForms 两套实现各自重试(3 次 ×150ms)
- 仍失败时提示原因(输入法 / 剪贴板工具 / 远程桌面 rdpclip),并可选择打开记事本显示路径
- 桌面端 README 补充该行为说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 14:03:10 +08:00
liufumingren
228723e0c3 设备端扫码上报 + 桌面端/Android 正式包发布脚手架
AndroidStation(原中控改造为纯设备端)
- 只做三件事:UDP 48899 被桌面端发现、TCP 8087 推送 USB 扫码结果、离线语音播报
- 扫码不再经过 UI:去掉逐键重绘,50ms 自动提交,同一码重复扫码也一律上报
- 离线语音种子(数字/字母/“开始打包”/欢迎语)随包安装,MediaPlayer 播放,启动把音量拉满
- 启动播报「欢迎使用溯源系统,初始化已经完成,扫码即可开始打包」
- 移除 Device Owner / 设备管理员 / lock task / 网络与 IP 设置等非普通应用能力(仅保留开机自启)
- 正式签名 keystore + release 签名配置,versionName/versionCode 可由打包脚本覆盖

发布脚手架
- backend/android_client:Android 正式包构建(build.ps1 + package.config.json)
- backend/scripts/deploy/publish-android.cjs + npm run android:build / android:publish
- 桌面端安装包改为 download/desktop,Android 为 download/android_client;
  version.json 仍走 /download/version.json(老客户端写死),新增 /download/android_client/version.json
- 谷歌插件随桌面端 MSI 安装到 <安装目录>\extension,工具菜单新增「复制谷歌插件地址」
- git-safety-check 增加仓库级禁区(keystore.properties / *.jks / local.properties)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 05:53:27 +08:00
liufumingren
e8923dbe56 feat(desktop): 多路回放按 OSD 时间对齐,合并时摆回同一时间轴
- 每路下载后读 NET_DVR_GetPlayBackOsdTime 得到真实起播时间,算出相对请求起点的偏移,
  返回 PlaybackClip(Path, StartOffset);合并时按偏移补 -itsoffset,画面不再错位
- 各路都从自己的关键帧起播 → 单路内容多了就裁掉,最后一路固定以收尾时间对齐
- 回放预览改成多路同播:每路独立 FfmpegStream 订阅帧、按第一帧到达时间对齐,
  队列超长时跳到最新帧(追帧),窗口结束即停;去掉「关闭」按钮改由流程自动关闭
- FfmpegStream 支持多订阅者(同一 rtsp 只拉一次),避免多路预览重复解码

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:43 +08:00
liufumingren
e5a6558eb5 feat(desktop): NTP 校时同时同步摄像头(IPC)时钟
录像机与摄像头各有一块钟:只写录像机的话,画面里烧的 OSD 时间还是旧的
(现场有摄像头比录像机快 13 小时)。校完录像机后逐个通道 SET_TIMECFG,
单通道失败不影响其它通道,结果汇总到该录像机的进度行。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:37 +08:00
liufumingren
7b11f7052d feat(subject): 主体到期暂停设备上报,新增续期订单与支付回调
- 主体状态缓存(Redis 优先、进程内兜底):设备心跳与上报判断不再查库,续期/停用后主动失效
- 上报写接口按缓存校验期限:过期 403 subject_expired、停用 subject_disabled、主体缺失 subject_missing
- 心跳与 /api/scanner/me 返回 subject 状态,桌面端据此暂停推送并在续期后自动补传积压
- 新增续期订单(subject_orders)与接口,支付回调 POST /api/pay/notify 幂等、支持 HMAC 签名,
  另提供内部令牌模拟支付用于联调
- 顺带提交工作区中已完成的「登录协议」后端改动(agreement):与本次改动共用 router.js / config.default.js

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-20 18:55:57 +08:00
liufumingren
c68ec63e91 桌面端:托盘退出加确认 + 后台服务 .NET 环境兜底(1.0.75)
- 托盘「退出」改为 ConfirmExitFromTray:弹「退出确认」,默认按钮为取消;
  文案按状态区分(服务模式提示后台 Windows 服务仍会继续扫码,普通模式提示扫码与查询都会停)。
  登录取消等内部路径仍直接退出,不弹框
- ServiceInstaller:
  - StartCore 启动前调用 EnsureServiceDotnetEnvironment(框架依赖版服务写 DOTNET_ROOT,
    自包含版自动清理),避免 LocalSystem 找不到用户目录里的 .NET 8 而表现为「后台服务启动超时」
  - 用 RuntimeEnvironment.GetRuntimeDirectory() 取运行时目录,消除单文件发布下的 IL3000 警告
    (typeof(object).Assembly.Location 在单文件里恒为空)
2026-10-20 00:55:59 +08:00
liufumingren
bca8f7270c 本机预览/云台/拉通道全部改走 WebSocket(桌面 1.0.75)
桌面端
- 新增 LocalWsServer(ws://127.0.0.1:17301):hello / ping / get_channels /
  start_preview / stop_preview / open_window / close_window / ptz / ptz_preset,
  一条连接可同时推多路 JPEG 帧(帧头带 sid);慢命令并发派发,云台命令按连接串行,
  页面断开自动清理会话与满帧率窗口
- LocalHttpServer 删除预览(MJPEG/快照/满帧率窗口)、/api/hik/channels、/api/hik/ptz*,
  HTTP 17300 只保留 /api/query/{code}、/api/activate-login、/api/playback/download,
  其余 POST 统一回 404 并提示已迁到 WS;不再依赖 HCNetSDK
- App 自行组装 HikStreamService -> HikPreviewService + HikNativePreviewService 注入 WS
- 后台服务加固:框架依赖(开发版)安装/启动时自动写服务环境变量 DOTNET_ROOT,
  避免 LocalSystem 找不到用户目录里的 .NET 8 而报「后台服务启动超时」

前端
- 新增 api/localWs.ts(连接/断线/请求-响应/二进制帧分发),补 getChannels / openWindow /
  closeWindow / ptz / ptzPreset
- CamerasView 预览只走 WS(保留「唤起本机软件 -> 等待 -> 提示安装」兜底),
  满帧率窗口、云台、预置点改走 WS
- NvrsView 拉取通道改走 WS(连不上时自动唤起一次再重试)
- CameraLayoutCanvas 合成画面 4 路改 WS 推帧
- 删除 createHikPreview/closeHikPreview*/openHikWindow/closeHikWindow*/ptzControl/ptzPreset
  与 isLocalServiceAlive/waitForLocalService

其他
- 移除 cameras.has_ptz(迁移 20261019233000)与相关接口/字段/UI
- 通道号按 struStreamMode 映射(IP 通道空槽导致 51 之后整体错位)
- 扫码 24 小时内只保留最后一次扫描(后上报时间更新时覆盖)
- 清理历史 DESKTOP 占位通道(迁移 20261019230000)
- README / desktop README 补 17301 与 WS 接口说明,修正已删除的 /api/health 描述
2026-10-20 00:47:31 +08:00
liufumingren
2122c7517b feat(desktop): 支持以 Windows 服务常驻,安装包内置 native 运行库 2026-10-19 22:04:19 +08:00
liufumingren
0b0296cece feat(desktop): NTP 校时与提权校时助手 2026-10-19 22:04:19 +08:00
liufumingren
cb504608a1 feat(desktop): 海康 NVR/摄像机预览、录像回放下载与内置 HCNetSDK 2026-10-19 22:04:16 +08:00
liufumingren
cb511f33ae feat(desktop): 本地 HTTP 服务与扫码通道、扫码记录界面 2026-10-19 22:04:12 +08:00