122 Commits

Author SHA1 Message Date
liufumingren
21ffb6a54f fix(frontend): 弹窗点遮罩不再关闭,避免编辑中误触丢输入
管理页的弹窗基本都是表单(套餐 / NVR / 摄像头 / 工作台 / 主体 / 文档 / 成员…),
原来 ModalBox 的遮罩无条件 `@click.self="emit('close')"`,手一滑点到外面整屏输入就没了。

- ModalBox 新增 maskClosable,默认 false:点遮罩不关闭,只能用 × 或底部按钮;
- 纯展示类弹窗(实时预览 / 合并输出预览)显式加 mask-closable,保留点击外面关闭的习惯。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-11 00:59:07 +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
b82b07b84f feat(doc): 栏目内容两级结构与悬浮目录
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 04:22:52 +08:00
liufumingren
0bb288dc86 style(doc): 文档页面不再整体滚动,滚动条仅出现在侧边栏与正文区
- body 固定视口高度、flex 纵向布局并 overflow:hidden,页面级滚动条移除,sidebar/content 各自独立滚动(含移动端 40vh 侧边栏)

- 标题下显示创建时间(创建于),正文末尾显示最后更新时间(新增 .doc-foot 样式)

- 新增 @media print,打印时恢复自然文档流避免长文被固定高度裁切

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-09 15:32:53 +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
78cee0fe1a feat(doc): 首页登录分流 + 文档站(简易 CMS / 静态 HTML / sitemap)
- 首页:`/` 未登录原地显示登录页(不再跳 /login),已登录直接进 `/dashboard`;
  看板路由由 `/` 迁到 `/dashboard`,侧边栏「首页」与无权限回跳同步;
  桌面端「工具 → 打开配置页」的 `/?token=` 免登录仍然可用
- 文档站:`/doc/**` 由后端整站生成静态 HTML(顶部分类 tab 全局切换、左侧栏目 → 内容页、
  右侧本页目录);`/sitemap.txt` 新链接追加到末尾,下架 / 删除的会被清理
- 平台管理 · 文档管理(`/admin/doc`):分类 / 栏目 / 内容页(Markdown)简易 CMS,
  内容页有编辑表单与列表,保存后自动重生成目录与静态页面
- 登录页右下角、顶栏(登录后)、看板右上角新增进入文档站的链接
- 部署:nginx 模板为 `/doc`、`/doc/`、`/sitemap.txt` 增加反代(否则会落到 SPA 回退);
  Vite dev server 增加同名代理;`middleware/frontend.js` 排除这些路径
- 登录页插画改为内联 SVG(沿用工作区已有的未提交改动)
- 测试:新增 Markdown 渲染单测;后端 218 个用例通过,前端 typecheck / build 通过

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 20:33:46 +08:00
liufumingren
0c59bede7e feat(admin): 平台管理新增套餐管理(改价 / 改天数 / 上下架 / 删除)
- 后端:新增 service/admin_plan.js、controller/web/admin_plan.js,
  GET/POST /api/web/admin/plans、PUT/DELETE /api/web/admin/plans/:id(需平台管理员)
- 套餐 code 创建后不可改(历史订单已快照 plan_code);留空按天数自动生成(如 p30)
- 前端:新增 /admin/plans「套餐管理」页面,并接入「平台管理」菜单与路由
- 续期下单只按库里的售价算钱,改完即生效、不用发版
- 文档与测试同步更新

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 16:23:17 +08:00
liufumingren
8949b7198c feat(pay): 微信 Native 扫码支付(下单出码 + 回调入账 + 扫码轮询)
- 新增 service/wxpay.js:统一下单 / 查询订单 / 关闭订单 / APIv2 验签,二维码在服务端本地生成 SVG
- 新增 pay/wechat.js 与 XML 编解码,公开回调 POST /api/pay/wechat/notify
- 订单:同主体 + 同套餐复用未超时待支付单;2 小时超时关单;回调 / 查单 / 手工确认统一走 payNotify
- 迁移 subject_orders 增加 code_url / prepay_id 等字段,配置项 WXPAY_*
- 前端续期弹窗展示二维码并按 2s 轮询支付结果
- 文档与测试同步更新

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-07 16:23:03 +08:00
liufumingren
3566c000f4 fix(frontend): 登录卡文字盖回深色,标题不再浅到看不清
- .login-page 为了深色背景把整页文字设成 #e7efff,卡片里的「欢迎登录」继承成浅色,
  白底上几乎看不见
- .login-card 显式 color: var(--text),卡片内文字(标题 / 后续新增内容)一律按深色渲染
- 桌面 1440×900 与窄屏 390px 两种布局复验:登录 / 注册面板标题均清晰

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-02 00:25:28 +08:00
liufumingren
a5fbd48229 style(frontend): 登录卡宽度 400 → 300px
- .form-pane 宽 300px(卡片内容区 260px),账号占位符与注册页「邮箱验证码 + 获取验证码」
  同一行仍能完整显示,未截断
- 桌面分栏 / 窄屏(≤960px)居中两种布局都复验过
- README 版面约定里的卡片宽度同步为 300px

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-02 00:03:37 +08:00
liufumingren
2d117458a9 feat(frontend): 登录页改深色科技底 + 左插画 / 右卡片
- LoginView 不再用 .bare-page / .bare-card,改为 .login-page(海军蓝渐变 + 淡网格 + 光晕,
  装饰层 pointer-events: none,光斑用 overflow: hidden 裁掉避免撑出滚动条)
- 左右分栏:左侧品牌区(标题 + 副标题 + 等距插画),右侧 400px 白卡 .login-card;
  ≤960px 隐藏品牌区、卡片回中间
- 新增 frontend/src/assets/login-hero.svg(手写等距插画:货架纸箱 / 摄像头 / 存证单据 / 扫码枪,
  纯 SVG 无外链图片),带轻浮动动画,prefers-reduced-motion 下关闭
- 卡片标题跟着面板走(欢迎登录 / 注册账号 / 微信扫码登录),品牌名只留在左侧品牌区
- 登录/注册/扫码逻辑不变:.corner-toggle 折角切换、.panel-switch 同高布局、悬浮字段提示照旧
- 文档同步:README 的「登录页版面」约定改写为分栏结构,main.css 注释改为 .login-card 挂三角

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 23:38:31 +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
f94fd28f7b docs(extension): 记录 Edge 商店标识(Store/CRX/Product ID)与两个 ID 的关系
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-01 04:55:57 +08:00
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