68 Commits

Author SHA1 Message Date
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
liufumingren
4fdc10d4a3 fix(miniprogram): tsconfig 不再继承过期的 @vue/tsconfig,改用 bundler 解析
@vue/tsconfig@0.1.3 仍设 importsNotUsedAsValues / preserveValueImports,TS 5.5 起已删除;
它的 moduleResolution=Node 与 baseUrl 在 TS 6 也已弃用(VS Code 报 4 个错)。

- tsconfig 改成自包含:moduleResolution=bundler,paths 不再需要 baseUrl
- typescript ^6.0.3、vue-tsc ^3.3.13,移除未再使用的 @vue/tsconfig
- 已验证:npm run type-check / build:h5 / build:mp-weixin 均通过

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 01:07:05 +08:00
liufumingren
04bacb44d5 chore(workspace): 记录常用终端命令的自动批准设置
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:48:02 +08:00
liufumingren
3469b6fcb3 perf(frontend): 工作台预览改用 canvas 直绘帧,不再每帧置换 object URL
每次帧都 new Blob + createObjectURL 再塞给 img,连续播放时 URL 抖动、内存回收压力大。
改为把 WS 收到的 JPEG/PNG 帧直接画到磁贴 canvas(utils/frameCanvas 抽公共绘制器),
画布常驻只重绘,有无画面靠提示层说明。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:49 +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
143e153bdd docs(readme): 补充小程序目录、H5 预览端口与登录约定
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:19 +08:00
liufumingren
8f1a8b7ddb feat(miniprogram): 新增 uni-app + Vue3 + TS 微信小程序
- 登录:微信一键登录(code2Session)+ 账号登录双 tab;个人中心为整页登录,其它页走抽屉
- 协议:登录前必须阅读并同意,版本号随登录上报落库
- 不强制登录:启动不弹窗,点功能或遇到 401 才提示(符合小程序审核)
- 页面:首页统计 / 扫码记录 / 个人中心;H5 预览端口 7304

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:16 +08:00
liufumingren
4f637f1307 feat(web): 微信小程序 code2Session 登录与账号绑定
- POST /api/web/auth/wechat/login:code 换 openid,已绑定直接签发令牌,
  未绑定自动建平台账号(首登标记 firstTime)
- bind / bindings / unbind:登录态下绑定、查询、解绑小程序账号
- wechat_mp_accounts 表 + 迁移;未配置 WX_MP_APPID/SECRET 时本地与单测走 mock
- 新增 cors 中间件(小程序 H5 预览直连后端;鉴权只靠 header 令牌,不依赖 cookie)
- 补充 wechat-mp 接口单测

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:11 +08:00
liufumingren
517fafeef9 refactor(web): 登录会话与协议同意逻辑抽到 service/login
账号密码登录、微信小程序登录共用同一套:客户端归一、协议校验(428)、
落库同意记录、签发令牌 + 主体列表。auth 控制器只保留参数校验与业务编排。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:06 +08:00
liufumingren
413bd9f981 chore(db): 新增 npm run db:deploy,部署时一次执行全部库结构变更
- scripts/db-deploy.js:建库(有权限时) → 基线表 sql/schema.sql → 全部未执行的 database/migrations,
  幂等可重复执行;--check 只列出待执行迁移(有 pending 时退出码 1),便于上线前/CI 卡一道
- 保留仓库内所有迁移脚本:sql/migrations 历史补丁、database/migrations、一次性数据脚本都不删不改,
  顺序与用途写进 README「部署 / 升级(库结构)」

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-20 21:26:30 +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
424389a97a 修复工作台「合并输出预览」两格都不出画面
根因:CameraLayoutCanvas 里每格的帧写进了「本地对象」而不是 reactive 代理。
- state 先被 previews[cameraId] = state 挂上去,随后回调里又 state.src = url 再 current.src = url;
  两者是同一个 target,Vue 的 setter 比较后发现值没变 → 不触发重渲染,
  页面上的 <img src> 一直是空字符串(WS 帧其实一直在到,实测 5fps / 两路都有帧)。

改法:
- 先 previews[cameraId] = state,再 const live = previews[cameraId](代理),帧只往 live.url / live.src 写;
- 「无画面(摄像头可能离线)」占位改成 v-if="!previews[tile.cameraId]?.src",有画面时不再渲染。

验证(7301 + 本机软件 1.0.75,工作台「1号工作台」通道 34 / 45):
- 两格 <img> 均为 blob: URL、naturalSize 1280×720,占位文字消失;
- 同时用 node 直连 WS 复测:channel 34 / 45 均 40 帧 / 8 秒(5.1fps),确认设备侧正常。
2026-10-20 01:18:33 +08:00
liufumingren
f07e8da021 统一「连不上本机软件」提示窗覆盖 /local;团购不再写「最大录制时长」
前端
- LocalServiceGate 新增 probe 属性(ws / http):/local 查件页用 HTTP 17300 根路径探活,
  兼容没有 WebSocket 的老版本软件;ws 用于预览/拉通道/大屏
- LocalServiceView:offline 状态改为弹该组件(启动 / 下载),卡片内只留简短提示 +
  「启动 / 下载本机软件」「重新连接」,删除自带的 DOWNLOAD_URL / launch() / launchFailed /
  APP_PROTOCOL 文案与 launchApp 依赖

后端
- 团购工作台(ws_type = 2)的 record_max_sec 不再写 before + after 的派生值,统一存 0(不限制)
  · web 本来就没有「最大时长」配置项(只有散单有),库里出现 20 + 10 = 30 会被误读成
    「被多加 30 秒限制、实际只录 30 秒」
  · 团购的录制区间一直是 扫码时间 - before ~ 扫码时间 + after(buildPlan 团购分支不使用 max)
- 迁移 20261020010000-group-workstation-max-zero:把现有团购行 record_max_sec 改为 0,
  down 时恢复为 before + after;scan_records.workstation_snapshot 属于历史快照,不动

验证
- 库:1号工作台(团购)20 / 20 / max=0;团购计划区间 = 扫码时间 ±20 = 40 秒
- 单测:pack.test.js 7 passing(含「团购:以扫码时间为基准,前后各留配置的秒数」)
- 前端 vue-tsc 通过
2026-10-20 01:09:32 +08:00
liufumingren
1786d9430a 前端:预览连不上本机软件时立即弹提示窗(不再干等 12 秒)
CamerasView.openPreview 之前是「连不上 -> 自动 yuncang:// 唤起 -> 轮询 waitForLocalWs(12s) -> 再弹窗」,
用户点预览后要等 16 秒左右才看到任何提示,容易误以为「没走统一提示」。

改为:`localWs.connect` 失败就直接 `previewOffline = true`,交给 LocalServiceGate 的
「启动本机软件」按钮(唤起 + 等待 + 进度提示都在组件里,用户看得见)。

实测(7301,注入 WebSocket 构造抛错模拟离线):点预览 3 秒内弹出
「实时预览需要本机软件 / 最新安装包 1.0.75 · 103.6 MB / 稍后 · 立即下载 · 启动本机软件」;
改前同样场景需 16 秒。
2026-10-20 01:02:41 +08:00
liufumingren
cec0254d38 前端:本机软件连不上时统一提示窗(启动 / 下载)
- 新增 components/LocalServiceGate.vue:标题 + 场景说明 + 两条处理路径
  「启动本机软件」(yuncang:// 唤起后等 WS 17301 连上,成功 emit ready 让调用方重试)
  与「立即下载」(读取 /download/version.json,显示版本号与体积)
- NvrsView:拉通道遇到 WS 连不上 → 弹该窗,就绪后自动重试(不再只给一行红字)
- CamerasView:预览弹窗内的旧 offline 区块换成该窗,就绪后自动重开预览;
  删除 launchSoftware / launchHint / release / downloadUrl 等重复状态
- CameraLayoutCanvas:合成画面连不上时同样弹该窗,就绪后重新拉 4 路画面

实测(7301,注入 WebSocket 构造抛错模拟离线):点「拉取通道」→ 弹出
「拉取通道需要本机软件 / 最新安装包:1.0.75 · 103.6 MB / 稍后 · 立即下载 · 启动本机软件」,
下载链接指向 http://127.0.0.1:7300/download/YuncangTraceSetup-1.0.75.msi
2026-10-20 01:01:09 +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
liufumingren
c3cae69e6e feat(desktop): 主体切换与登录、主界面及日志留存改造 2026-10-19 22:04:10 +08:00
liufumingren
8aa1973a99 feat(extension): 增加本机软件探测并完善 WMS 页面注入规则 2026-10-19 22:04:07 +08:00
liufumingren
27df32d7bc feat(frontend): 主体/工作站/摄像机/NVR 页面与本地服务对接 2026-10-19 22:04:06 +08:00
liufumingren
0594a26f4f test(backend): 补充主体、设备扫码与工作站相关接口测试 2026-10-19 22:04:04 +08:00
liufumingren
881b8d52f5 feat(backend): 主体/工作站/摄像机/NVR/打包查询与扫码鉴权增强 2026-10-19 22:04:03 +08:00
liufumingren
77661b91b1 feat(backend): 引入 sequelize 迁移体系与数据库脚本 2026-10-19 22:04:01 +08:00
liufumingren
2573404981 chore: 忽略内置 ffmpeg 可执行文件并更新各端 README 2026-10-19 22:03:59 +08:00
liufumingren
79f89ec392 feat(desktop): 「重启软件」移到工具菜单
- 工具:测试查询 / 打开日志目录 / 清理日志 / 清理更新缓存 / 重启软件
- 服务:只剩只读的「服务状态:运行中|未启动」
2026-10-17 18:28:00 +08:00
liufumingren
62ab25e6fe feat(desktop): 主界面/托盘不再显示服务地址与运行状态
- 主界面移除整行「● 本机服务 运行中 · http://…」,顶部只留「已登录:xxx / 退出登录」
- UpdateServerState 只刷新菜单「服务 → 服务状态」,不再碰界面控件
- 托盘菜单的状态项改成固定的「本机服务」(原来是「服务:<地址>」),
  UpdateStatus 只传「运行中 / 未启动」;TrayIconService 构造不再需要 serverUrl
- 运行状态统一在菜单里看,界面不再重复展示内部实现细节
2026-10-17 18:23:55 +08:00
liufumingren
e7ff6ed784 fix(desktop): 菜单贴紧标题栏,去掉顶部空隙
- 外层 Grid 不再加 18 边距:行 0 = Menu(Padding 10,3,0,3,紧贴标题栏),
  行 1 = 内容区(Margin 18,10,18,18),标题/查询卡改到内容区 Grid 的 row 0/1
- 原来的 Margin="-6,0,0,8" + Grid 18 边距会让菜单离标题栏多出 18px
2026-10-17 18:16:03 +08:00
liufumingren
21dfc7f651 feat(desktop): 日志改为落文件(软件目录 logs\log_日期.txt),界面移除日志模块
- AppLog:不再做内存缓冲/事件,直接按天追加到 <软件目录>\logs\log_yyyy-MM-dd.txt
  行格式 [yyyy-MM-dd HH:mm:ss] 内容;写失败一律吞掉,不影响主流程
  装到只读目录(如 Program Files)时自动退回 %LOCALAPPDATA%\YuncangTrace\logs
- 新增 AppLog.Clear():删除目录下全部 log_*.txt(当天文件也能删,之后重建)
- MainWindow:删掉「运行日志」ListBox 与整套集合/订阅代码,Grid 行 4→3
  查询卡改成 Grid(结果框自适应高度),窗口 620→460
- 菜单「工具」增加「打开日志目录」「清理日志」
- build.ps1 补 -p:AppEnvironment:原来 Release 发布时环境恒为 Production,
  开发包日志/关于里也显示「生产环境」(现在与 -Environment 一致)
- test-update.ps1:更新完成后轮询 60s 等服务与进程起来,避免误报「无响应」
2026-10-17 18:10:28 +08:00
liufumingren
7fdbe5afc1 feat(desktop): 主界面增加 工具 / 服务 / 帮助 菜单
- 工具:测试查询(聚焦输入框)、清理更新缓存(删 %TEMP%\YuncangTraceUpdate)
- 服务:服务状态(只读,随启停实时刷新)、重启软件
- 帮助:检查更新(复用启动时的检查流程)、关于(版本/环境/服务状态)
- 重启/检查更新通过事件交给 App,避免 MainWindow 直接碰进程与更新逻辑
- 保持界面不出现服务地址 / 协议 / 停止服务 等内部信息
2026-10-17 18:03:59 +08:00
liufumingren
2ab3ad35e5 主界面移除协议状态文字;修复「未登录/网络异常时不会自动更新」与「误清登录令牌」
一、UI
- 主界面删除「已注册 yuncang://(网页可叫醒本软件)」整行(`ProtocolText`),
  行定义 4→3(标题 / 查询 / 日志);删除 `UpdateProtocolState()` 及其调用。
  协议对用户是内部实现,不展示;注册由 MSI 完成、卸载自动删除、启动自动校正。

二、修复(本次测试暴露的真实缺陷)
1. **更新检查提前到登录之前**(`App.OnStartup`):
   原来放在 `ShowMainWindow()` 之后,一旦本地令牌失效/未登录,软件停在登录窗,
   **永远不会检查更新**(实测 1.0.7 → 1.0.8 卡在登录窗 180s 未更新)。
2. **`ApiClient.MeAsync` 不再把网络错误当成"令牌失效"**:
   原来 catch(ApiException) → return null,调用方据此 `SessionStore.Clear()`,
   后端启动中/一时连不上就会**误删 session.json**(本次就丢了登录态)。
   现在只有 401/403 返回 null;超时/连不上/5xx 抛异常 → 登录窗保留令牌并提示,
   下次启动仍可自动登录。

三、验证(标准流程:打包 → 启动旧版 → 自动更新)
- 打包 1.0.9(含修复)并安装(旧版 1.0.7 因缺陷无法自更新,只能手工升级一次);
- 打包 1.0.10 → `test-update.ps1`:
    当前安装 1.0.9(**处于登录窗,未登录**)→ 后端目标 1.0.10
    [4s] 1.0.9 → [10s] 1.0.10
    ✔ 自动更新完成:1.0.9 → 1.0.10(耗时 10.1s)
    ✔ 本机服务 17300 有响应(HTTP 401)
    ✔ 软件进程已恢复
  证明「未登录也能检测并完成更新」。

四、待用户操作:本次测试中 session.json 被旧逻辑误删,需要**重新登录一次**;
   之后的版本不会因为网络抖动再丢登录态。
2026-10-17 16:59:23 +08:00
liufumingren
457fbd6c9e 新增 test-update.ps1:一条命令验证「启动旧版 → 自动更新」(不卸载重装)
用法:
    cd desktop\installer
    .\build.ps1 -Environment Development -Version 1.0.7   # 发布更高版本
    .\test-update.ps1                                     # 启动旧版,等它自己升级

脚本流程:
1. 从后端 /download/version.json 读目标版本,和当前安装版本比较(已是最新直接退出);
2. 关掉运行中的软件(单文件自解压出来的真实进程);
3. 设 YUNCANG_AUTO_UPDATE=1 启动**旧版本**(更新窗口自动开始下载);
4. 每 3s 轮询安装目录 ProductVersion,直到等于目标版本或超时;
5. 检查本机服务 17300 响应与进程是否恢复,输出 ✔/✘ 与耗时。

实测(本次):
    当前安装版本:1.0.6
    后端目标版本:1.0.7
    [3s] 1.0.6 → [10.4s] 1.0.7
    ✔ 自动更新完成:1.0.6 → 1.0.7(耗时 10.4s)
    ✔ 本机服务 17300 有响应(HTTP 401)
    ✔ 软件进程已恢复(PID 12024)
    随后日志显示「已恢复登录:管理员」。

README:新增「验证自动更新(不卸载重装)」小节(命令、脚本行为、输出示例、
每次需打更高版本的提醒)。
2026-10-17 12:47:49 +08:00
liufumingren
d32656a2f4 主界面不再显示服务地址(内部协议不需要用户关心)
- MainWindow.xaml:删除「服务地址 / 复制地址 / 在浏览器打开」整块;
  行定义从 6 行缩到 4 行(标题 / 协议状态 / 查询 / 日志)。
- MainWindow.xaml.cs:删除 AddressBox 赋值、CopyAddress_Click、OpenInBrowser_Click
  以及不再需要的 using System.Diagnostics。
- README:补充「主界面不展示服务地址」的说明,托盘菜单文案同步(续 重启软件)。

验证(重点:自动更新全链路,不卸载重装):
1. build.ps1 -Environment Development -Version 1.0.6 → version.json/MSI 落到后端;
2. 当前安装的是 1.0.5,直接启动(带 YUNCANG_AUTO_UPDATE=1 走自动下载):
   → 检测到 1.0.6 → 软件内下载 + MD5 校验 → msiexec /passive 安装 → 进程退出 → 自动重开;
3. 监控结果:安装目录 ProductVersion 从 1.0.5 → **1.0.6**,进程恢复、服务 17300 正常
   (query 200),启动后不再提示更新(version.json 也是 1.0.6);
4. 升级后界面元素只剩:退出登录 / 本机服务状态 / 协议状态 / 测试查询 / 运行日志 ——
   已无服务地址、复制地址、在浏览器打开。

备注:中途遇到一次「看起来没更新」,原因是测试时序错了——启动软件时后端 version.json
还是 1.0.5(打包尚未完成),属于测试操作问题,不是逻辑缺陷。
2026-10-17 12:43:29 +08:00