104 Commits

Author SHA1 Message Date
liufumingren
9c1c19bcd8 docs(extension): 详细描述换成 ≤1000 字符版本(Edge 字段上限)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 04:32:19 +08:00
liufumingren
ac38ab0939 docs(extension): 补「提交时逐字段对照表」(Partner Center 上传包之后)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 04:29:11 +08:00
liufumingren
2caad31fb4 docs(extension): 隐私政策/商店材料联系邮箱改为 821298006@qq.com
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 04:15:58 +08:00
liufumingren
cbbe54b2d9 docs(extension): 隐私政策/商店材料改用真实联系邮箱 pack_service@gztbyc.com
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 04:06:36 +08:00
liufumingren
9b37101a7b docs(extension): Edge 商店上架材料 + 扩展隐私政策页
国内实测 Chrome 商店不可达(chromewebstore.google.com / clients2.google.com 均超时),
Edge 加载项商店 200/0.43s 可达,所以官方分发走 Edge 商店。

- extension/STORE-SUBMISSION.md(新):上架检查清单、中英文 listing 文案、逐条权限用途说明、
  数据使用声明、截图清单、审核退回应对、上架后 ID 变化与升级流程、现场操作对照;
- frontend/public/extension-privacy.html(新):隐私政策页,随前端构建发布到
  https://pack.wms.gztbyc.com/extension-privacy.html(npm run deploy 会自动带上);
- extension/README.md:分发章节补上「国内走 Edge 商店」与上面两份文档的入口。

扩展 1.1.2(压缩产物 + 跳转默认值修复)已发布到线上:
updates.xml -> YuncangTraceExtension-1.1.2.crx(27766 字节,200)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 04:03:58 +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
6e52f82cde chore: 入库手机网页(mobile-web)与局域网扫描脚本(tools)
- mobile-web/:独立的 Vue3 + TS + WeUI 手机网页(开发端口 7303、预览 7304,
  /api 反代到后端 7300);node_modules/、dist/ 由根 .gitignore 统一覆盖
- tools/scan-web-viewer.ps1:扫局域网 80 端口并按网页标题匹配设备的排查脚本

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:43:43 +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
7021e18e7c fix(extension): 插件单号跳转默认值改为线上站点
默认 urlTemplate 原来是 http://localhost:7301/local,插件装在员工浏览器里
点单号会打开他们自己的机器 —— 改成 https://pack.wms.gztbyc.com/local。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:29:57 +08:00
liufumingren
3570c6ad5c fix(extension): 修复插件配置接口 404(controller 方法名 config 被 this.config 顶掉)
Egg 的 BaseContextClass 构造时会把 `this.config = app.config` 挂到实例上,
控制器里叫 `config()` 的动作会被这个实例属性覆盖:路由能匹配上,但
egg-router 拿到的不是函数,最终静默返回 404「接口不存在」。

- controller/web/extension.js:动作改名为 show()
- router.js:/api/web/extension/config 指向 controller.web.extension.show
- 插件:同步周期文案改为「每 5 分钟」,版本 1.1.1

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 03:25:43 +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
4586fe5217 chore: 移除已弃用的 miniprogram(uni-app 微信小程序)
- 删除 miniprogram/ 整个工程(28 个跟踪文件:uni-app 页面、接口封装、构建配置)
- README 去掉小程序目录、7304 端口、进度条目与用法链接
- cors 中间件与 CORS_ORIGINS 示例注释不再以「小程序 H5 预览」举例

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:10:59 +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
4704e10777 feat(首页/订单): 实时看板 + 待支付订单 2 小时自动失效
- 首页改成深色实时看板:今日/昨日维度、每 30 秒静默刷新(后台标签页跳过)、
  切维度/切回前台立刻刷;工作台榜按「占比」出条并同时给条数与百分比;
  支持原生全屏,`AppLayout :immersive` 隐藏左侧菜单与顶栏占满整屏
- 待支付订单 2 小时自动失效(`config.pay.orderTtl` / `PAY_ORDER_TTL`,默认 7200 秒):
  定时任务 `app/schedule/subject_order_expire.js` 每分钟扫一次,
  详情/列表/平台订单列表读到超时订单就地关单,支付回调入口再兜一层;
  超时后的渠道回调与手工确认一律 409;`present()` 下发 `payExpireAt / expired / pending`,
  前端展示支付截止时间、超时后停止轮询、平台端隐藏「确认订单」按钮
- 文档同步:根 README 与 backend/README(订单 TTL、看板刷新策略、全屏降级)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:05:26 +08:00
liufumingren
9027857303 fix(权限): 普通成员可下载本主体录像;面单摄像头不再被 cameras.enabled 快照挡住
- 回放/下载要用的 GET /api/web/nvrs/:id/credential 不再挂 subjectAdmin:
  普通成员可读(取本主体录像机凭据去拉流),范围由 credentialOf(id, subjectId) 限定当前主体,
  别的主体一律 404;其余 /nvrs 管理接口仍然只给主体管理员
- 面单摄像头下发只看 cameras.status:cameras.enabled 是「导入通道那一刻」的快照,
  通道后来才装上摄像头(预览正常)时它一直是 0,会把正常的一路挡在设备列表外
- 停用的工作台/摄像头不再静默丢弃,改为给 warning(设备端页面底部可见)
- 补测试:nvr-credential 权限 5 条、label-scan 3 条

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-30 23:03:21 +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
3e2bd56416 feat(平台管理): 平台管理员与平台管理台(主体管理 / 订单管理 / 管理员)+ 顶栏下载入口
- 新表 admin_members(user_id 唯一、name、role、status、remark,软删):平台级管理员,
  与「主体管理员」完全分开;迁移会把内置管理员(username=admin,没有则 id=1)先入表
- 鉴权:middleware/platform_admin.js —— admin_members 启用行 **或** INTERNAL_ADMIN_IDS(内置/救急入口),
  其余一律 403 not_platform_admin;接口挂在 /api/web/admin/*
- 主体管理:GET 所有主体(成员数/管理员/是否过期)+ PUT 改授权到期时间
  (直接设 expireAt 或 extendDays 顺延),改完失效 subjectState 缓存,设备心跳立刻生效
- 订单管理:GET 所有订单(主体名/下单人/续期前后)+ POST 确认订单 ——
  复用支付回调的 payNotify()(标记已支付 + 主体顺延 + 失效缓存 + 幂等),渠道记 manual
- 管理员:GET/POST/DELETE /api/web/admin/members(按账号加人、不能删自己/最后一个);
  软删行仍占唯一键,查重带 paranoid:false + restore 复用
- 前端:左侧菜单新增「平台管理」组(只有平台管理员可见,路由 meta.platformAdmin 守卫、
  不需要选主体),新增 AdminSubjectsView / AdminOrdersView / AdminMembersView
- 顶栏右侧新增「下载桌面端 / 下载 Android 扫码台」两个按钮(与权限无关,所有人都显示),
  版本号读 /download/version.json 与 /download/android_client/version.json,未发布则置灰提示
- 测试:admin.test.js 12 例(403/表内/内置/列表/添加/重复/删自己/主体列表/改期限/顺延/订单/确认幂等)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:21:16 +08:00
liufumingren
98fae0f9d2 feat(首页统计): 增加今日/昨日维度,修正统计 SQL 与卡片高度
- /api/web/stats 支持 ?period=today|yesterday:趋势改成按小时(0~23 点补零),
  工作台榜只统计那一天;新增与维度无关的 todayCount / yesterdayCount(KPI 直接用)
- service/scan.hourlyCounts():MySQL 走 HOUR(scan_time) 分组,单测环境退化成内存聚合
- 修复首页统计 500:sequelize.col('scan_records.xxx') 在 FROM ... AS scanRecord 时会被 MySQL 判「未知列」,
  单表查询改用未限定列名
- 前端首页:KPI 加「昨日扫码」(带较昨日环比)、图表维度切 今日/昨日/7/14/30 天,
  新增 ScanTrendChart / WorkstationRankChart 两个纯 CSS 图表组件
- 卡片高度不一致修复:全局 .card + .card 的 margin-top 漏进网格容器,把第 2 张之后的卡片下推 16px;
  网格内清零并加 grid-auto-rows: 1fr,图表正文区等高

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:20:52 +08:00
liufumingren
08d9ea103b chore(微信): 移除自建微信授权表 wechat_oauth / wechat_mp_accounts
微信侧接入已统一到登录网关,自建的两套都下线:

- 删除表:wechat_oauth(自建公众号网页授权 + 运维手工维护的绑定关系)、
  wechat_mp_accounts(小程序 code2Session 一键登录);迁移 20261029100000(up 删表、down 按原结构重建)
- 删除代码:service/{wechat,wechat_mp}.js、controller/web/wechat_mp.js、model/{wechat_oauth,wechat_mp_account}.js、
  service/user.js#findByOpenid、user 模型的 hasMany WechatOauth、公众号 OAuth 回调与 /api/web/auth/wechat/*
- 删除环境变量:WECHAT_APPID/SECRET/REDIRECT_URI/API_BASE、WX_MP_*(config.wechat 只剩设备扫码登录用到的串码/二维码参数)
- 小程序:去掉「微信一键登录」tab,只留账号密码登录(删 utils/wechat.ts 与 wechatLogin 调用)
- sql/schema.sql 同步去掉 wechat_oauth 建表

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-29 17:20:28 +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
dd9482a3fe 注册 / 找回密码:先判邮箱占用 + 每邮箱每天最多 10 封
后端
- 新增 service/mail_quota.js:每个邮箱每天最多 config.email.dailyLimit(默认 10,EMAIL_DAILY_LIMIT)封,
  注册验证码与找回密码**共用**额度;按北京时间切日,key TTL 到次日 0 点;
  发信失败 / 被 60 秒节流拦下会还回额度;超限返回 429 daily_limit「… 请明天再试」
- service.user.findByEmail() / emailExists():LOWER(email) 查询(大小写不敏感)+ paranoid:false
  (软删除账号仍占用邮箱),单测环境无 sequelize 时退化为等值查询
- register/code:先判邮箱已占用 → 409 email_taken(含「忘记密码可找回」提示),一封邮件都不发;
  发送失败/超限统一返回 429 + status(daily_limit / send_failed)
- register:提交时再判一次邮箱占用(防发码后被抢注)
- forgot:改用 findByEmail(大小写/软删除一致),日额度与注册共用,超限 429
- 单测:新增「邮箱已使用不发信」「每日 10 封上限(注册/找回)」4 个用例;fake-redis 补 decr

前端
- 登录页获取验证码:先做邮箱格式校验,并展示后端 409/429 的具体文案
- 忘记密码页:邮箱格式校验 + 小写归一,429 文案直接显示

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 18:03:31 +08:00
liufumingren
3030f50cd3 续期改为选套餐下单,支付回调确认后才续期
数据库
- 新增 subject_plans(天数 + 定价):迁移内置三档
  30 天 ¥99 / 180 天 ¥499(推荐,划线 594)/ 365 天 ¥899(最划算,划线 1204)
- subject_orders 增加 plan_id / plan_code / plan_name 快照

后端
- GET /api/web/subject-plans:上架套餐(含 pricePerDay)
- POST /api/web/subjects/:id/orders 改为 { planId }:金额只认套餐价,
  前端传的 amount/days 一律忽略;套餐不存在/下架/未配价格 → 422
- 新增 GET /api/web/subjects/:id/orders/:orderNo(轮询支付状态)、
  POST .../orders/:orderNo/close(关闭待支付订单)
- 下单仍然只建单不动期限;续期只发生在 POST /api/pay/notify(渠道回调)成功之后

前端
- 续期不再 prompt 输入天数:弹窗展示套餐卡片(天数/价格/划线价/角标/折合每天),
  点「生成订单(¥xxx)」→ 显示订单号、金额、状态(待支付)
- 每 2s 轮询订单状态,回调确认后自动刷新主体列表并提示新到期时间;
  待支付时可「关闭订单」,避免留下悬挂单

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 17:43:18 +08:00
liufumingren
e6198a4334 web 端权限收紧:业务数据接口与菜单仅主体管理员
后端
- 新增 middleware/subject_admin.js:在 subjectAuth 之后校验「创建者 或 role=1」,否则 403
  { status: subject_forbidden, message: 只有主体管理员可以查看该数据(请联系主体管理员) }
- 挂到全部业务数据接口:/api/web/devices*、/records、/nvrs*(含 credential)、/cameras*、
  /workstations*、/workstation-scan-channels
- 有意不拦:/api/web/stats(首页概览)、/api/web/pack-query(桌面端打包查询,工位日常要用)

前端
- 路由加 meta.adminOnly(设备/录像机/摄像头/工作台/扫码记录,dev 的测试页同样),
  守卫里非管理员直接回首页 ?denied=1
- AppLayout 菜单按 isSubjectAdmin 过滤,成员只看到 首页 / 主体·成员 / 个人中心
- 首页对成员改成说明卡片(不再请求 stats、不显示设备/通道/记录数),被挡回时给出提示

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 17:00:09 +08:00
liufumingren
dc159c6f08 主体成员:支持多名管理员 + 成员管理仅管理员可写
后端
- 数据库层面本来就允许多管理员(subject_members 只有 subject_id+user_id 唯一索引,role 无唯一约束),
  新增 PUT /api/web/subjects/:id/members/:memberId/role(role=1 管理员 / 2 成员)
- 服务层 setMemberRole:创建者不能降级、不能改自己的角色、role 只接受 1/2;返回带 isCreator
- 成员管理收口到管理员:addMember / removeMember / createBindCode 由 findForUser 改为 ensureAdmin
  (此前任何成员都能增删成员,属于越权)
- removeMember 增加「管理员需先取消管理员身份再移除」;members() 返回 isCreator

前端
- 成员管理弹窗:「设为管理员 / 取消管理员」按钮,仅管理员可见;创建者行标「创建者」、自己行标「(你自己)」
  并隐藏不可操作的按钮;非管理员进入弹窗只看到只读列表 + 提示文案
- subjectApi 增加 updateSubjectMemberRole,SubjectItem.memberId / SubjectMemberItem.isCreator 类型补齐

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 16:38:33 +08:00
liufumingren
52907b66b7 摄像头列表:双击名称就地改名
- 名称列双击变成 input(自动聚焦并全选旧名),回车或失焦提交,Esc 取消
- 提交走 PUT /api/web/cameras/:id(只带 name),成功后只更新当前行,不整表重载
  (避免丢失分页/滚动位置),并提示「已改名:xxx」
- 名称去空格后不得为空,为空时提示「摄像头名称不能为空」并放弃本次编辑
- 工具栏提示补上「双击名称可直接改名」,名称列光标为 text、悬停提示可改名

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 15:05:29 +08:00
liufumingren
46c7d4f359 拉取通道弹窗:一通道一行 + 打开即拉取
- 通道列表由三列网格改为单列(一行一个):通道号 / 通道名 / IP:端口 都完整显示,
  名字不再被 120px 的 max-width 截断(名字与地址都补了 title,窄窗时仍可悬停看全)
- 点表格里的「拉取通道」直接拉取:并行取「已导入通道 + 库里存的设备密码」,
  拿到密码立刻 pull 一次,不用再点第二次按钮;弹窗里的按钮改为「重新拉取」(换密码用)
- 没有存密码时给出提示并自动聚焦密码框,回车即拉
- 拉取中/关闭弹窗/切换 NVR 都有保护,不会把旧结果写进新窗口

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 14:39:50 +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