24 Commits

Author SHA1 Message Date
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
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
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
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
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
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
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
27df32d7bc feat(frontend): 主体/工作站/摄像机/NVR 页面与本地服务对接 2026-10-19 22:04:06 +08:00
liufumingren
c12ea3b197 移除探活接口:状态合进 /api/query;插件支持直接协议唤起 + 失败兜底
一、本机服务(桌面端)
- 删除 GET /api/health(说明页同步)。
- GET /api/query/{code} 合并状态,一次请求就能决定「展示结果」还是「提示唤起」:
  200 { ok, state:"ok", code, loggedIn, user, env, server, data }
  401 { ok:false, state:"need-login", ... } / 400 "bad-request" / 404 "not-found" / 500 "error"
  不论成败都带 loggedIn/user/env/server;只有网络层失败才代表「软件没启动」。
  原因:探活通过 ≠ 查询时软件还在(用户可能中途退出),两次请求之间状态会错位。

二、前端 /local
- api/local.ts:删 localHealth / checkLocalHealth / waitForHealth / waitForLoggedIn;
  新增 queryLocal()(非 2xx 但带 state 的 JSON 也正常返回)与 waitForQuery()(轮询同一接口)。
  request() 改为先读 body,这样 401 能拿到 state 而不只是状态码。
- LocalServiceView.vue:状态机改为单接口驱动
  连不上 → offline(下载/启动提示);need-login → 自动 activate-login + 轮询 query 等登录;
  ok → 展示;其它 → 展示错误。
  「重新查询」也走同一逻辑:用户中途退掉软件时点重查会**直接落到「服务暂不可用 + 可唤起」提示**,
  不再是一个莫名其妙的失败。
- 空 code 也发一次请求(服务端回 400 bad-request + 登录状态),所以没有 code 时同样能驱动页面状态。

三、Chrome 插件(extension/,工作区改动,暂未提交 —— 与另一会话的 WIP 混在同几个文件里)
- 默认目标模板改为 yuncang://open?code={code}:点击「查看打包视频」**直接唤起本机软件并带参**,
  不再先开网页;旧的 http 默认模板在配置升级(v2→v3)时自动换成协议模板,用户自定义的不动。
- content.js:按协议分流(http(s) → background 开标签页;其它 → 本页用户手势内用隐藏 iframe 触发)。
- 唤不起的兜底(浏览器不会告诉网页协议是否成功,必须超时猜):
  4 秒内页面没失焦 → 右下角卡片「没打开本机软件?」+「在网页中查看」(fallbackUrl)+「下载安装」
  (downloadUrl)+ 关闭。
- 新增配置:fallbackUrl(默认 http://localhost:7301/local?code={code})、downloadUrl(留空不显示下载按钮);
  options 页与使用说明同步。

四、验证
- /api/health → 404;/api/query/ABC123 → 200 state:ok + data;
  /api/query/ → 400 state:bad-request + loggedIn/user/env/server。
- 浏览器 /local?code=ABC123:正常展示;**杀掉软件后点「重新查询」→ 立即显示
  「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮 + 已安装启动按钮**。
- 插件脚本 node --check 全通过;PSTRules.buildUrl 输出 yuncang://open?code=YT1234567890,
  v2 旧配置升级后模板自动变为协议、fallbackUrl/downloadUrl 就位。
- 前端 vue-tsc + vite build 通过;桌面端 0 警告 0 错误。

五、文档
- desktop/README.md:接口表改为两个接口 + 状态码/state 对照表 + 响应示例;
  「和前端/插件怎么配合」改为插件直接唤起;新增「插件直接唤起与唤不起时的提示」一节。
2026-10-17 11:10:34 +08:00
liufumingren
700394b56f 本机服务端口改 17300,/api/health 带登录状态,网页可唤起软件登录
- 端口 17311 → **17300**(桌面端常量、localhost/127.0.0.1 双前缀、前端 LOCAL_BASE、
  插件默认目标与说明、两个 README 全部同步)。
- `/api/health` 返回值加上 `loggedIn` / `user`(由 App 提供:IsLoggedInProvider、UserNameProvider),
  前端只认 `ok`(探活),再用 `loggedIn` 决定要不要唤起登录。
- 新增 `POST /api/activate-login`:叫本机软件把登录窗(已登录则主界面)带到前台。
  用 POST 而不是 GET,避免被浏览器/聊天工具的链接预取误触发;CORS Allow-Methods 加了 POST。
- `/api/query/{code}` 未登录时返回 401(前端会转去唤起登录)。
- 桌面端:App 记住登录窗引用,收到 LoginRequested 时切回 UI 线程激活它(托盘里也能叫出来)。
- 前端 `/local?code=`:
  - 路由加 alias `/local/`;
  - 新增 need-login 状态:探活到「软件在跑但没登录」→ 自动 POST activate-login →
    每秒探活等登录(30s 上限)→ 登录完成后自动查询;期间有「再叫一次登录窗口」按钮与托盘提示;
  - api/local.ts 增加 localHealth()(online/loggedIn/user)、requestLocalLogin()、waitForLoggedIn();
    waitForHealth() 改为返回状态而非 bool;老版本软件没有 loggedIn 字段时按已登录处理(向后兼容)。
- 实测(7301 + 模拟的 17300):打开 /local/?code=… → 「本机软件未登录 / 正在等待登录…」→
  mock 翻成已登录后自动切到查询结果(5 行);杀掉 mock 后显示「服务暂不可用」且探测地址为 17300。
2026-10-17 10:28:01 +08:00
liufumingren
9be56db385 前端:/local 页支持「叫醒」已安装的本机软件(自定义协议 + 轮询探活)
网页没法直接执行 exe,只能走「自定义 URL Scheme」(百度云盘 baiduyunguanjia://、迅雷
thunder:// 都是这个套路):浏览器让系统按注册表里的协议去拉起应用。

- api/local.ts 新增 APP_PROTOCOL(VITE_APP_PROTOCOL,默认 yuncang)、appLaunchUrl()、
  launchApp()(隐藏 iframe 触发,避免协议没注册时整页报错)、waitForHealth()(1s 一次,
  默认最多等 12s)。
- 离线态多一个「已安装,启动本机软件」按钮:点完进 launching 态,轮询 health;
  起来了就自动查询原来的 code;12s 还没起来则提示「可能没安装 / 没注册启动协议」,
  并保留下载按钮。
- 下载按钮、探活提示与居中布局保持不变。

实测(7301 + 模拟的 17311):先打开显示「服务暂不可用」;点启动后进入「正在启动本机软件…」,
轮询期间把模拟服务起起来,页面自动切到查询结果(4 行)。
2026-10-17 10:06:08 +08:00
liufumingren
7198dd1eb4 前端:新增不需要登录的「本机软件」公共页 /local?code=
给 Chrome 插件用:点运单号旁的按钮直接打开这一页(插件里的默认目标地址模板已改成
http://localhost:7301/local?code={code},线上换域名即可)。

- 打开即探活 GET http://localhost:17311/api/health:
  - 连不上/超时/被 CORS 拦 → 「服务暂不可用」+「本地打印服务未启动,请下载安装后再试」
    + 居中的「下载 云仓视频溯源软件」按钮 + 「重新检测」(页面上也打出探测地址,方便排查);
  - 可用 → 用 ?code= 调 GET http://localhost:17311/api/query/{code},把返回按
    「项目 / 值」两列展示,另附可展开的原始 JSON(本机软件返回结构未知,做通用渲染)。
- 没带 code 时给一个输入框手动查;提交后把 code 同步进地址栏(命名路由 local-service)。
- 路由 meta.public,并且**已登录时也不被踢回首页**(和扫码确认页一样始终显示,
  因为插件/手机是直接打开它的)。
- 本机服务地址可用 VITE_LOCAL_SERVICE 覆盖(换端口或改用 127.0.0.1 时)。

⚠️ 本机软件需要放行 CORS(Access-Control-Allow-Origin),否则浏览器会拦掉跨域请求,
表现和「软件没启动」一样(页面只能提示服务暂不可用)。

实测:7301 前端 + 一个模拟的 17311 本机服务 —— 无服务时提示文案与居中正确;
起服务后 /local?code=321408064481797 自动查出 6 行信息;不带 code 时手动输入可查。
2026-10-17 10:02:48 +08:00
liufumingren
407551f86e 前端:去掉已弃用的 tsconfig baseUrl(修 IDE 橙色警告)
TypeScript 5.9 起 baseUrl 被标记弃用(TS 7.0 将移除),VS Code 会在 tsconfig.json 里画橙色波浪线。
去掉 baseUrl,paths 改成相对 tsconfig 的写法(TS 4.4+ 支持无 baseUrl 的 paths):

    "paths": { "@/*": ["./src/*"] }

Vite 侧的同名别名在 vite.config.ts 里单独配,不受影响;vue-tsc --noEmit + vite build 通过。

顺带在根 .gitignore 里加上 .tmp-*(联调用的临时脚本,跑完即删,不该进仓库)。
2026-10-17 09:49:37 +08:00
liufumingren
19f1daf7db 前端:接入旧页面的样式体系(登录面板 / 折角切换 / 列表填充高度)
从后端模板迁过来的样式现在真正用上了,并修掉两处不一致:

- 登录页:.panel-switch + .pane-account / .pane-wechat + 右上角 .corner-toggle 三角形切换;
  字段改成无 label 的 .field-plain + 悬浮 .tip;验证码用 .input-row 与按钮同行。
- 找回 / 重置密码页:同样换成 .field-plain 紧凑字段。
- 列表页(设备管理 / 扫码记录):AppLayout 支持 fill → 内容区加 .content-fill,
  表格包进 .table-wrap → 卡片撑满剩余高度、表头吸顶、只有表格内部滚动、分页贴底。
- 卡片间距交给 .card + .card;测试页结果区改用全局 .json-box 与 .sub-title。
- ⚠️ 修 bug:「注册」标签下注册面板不显示 —— 登录与注册共用 .pane-account,
  但 CSS 只写了 .is-login .pane-account / .is-register .pane-register(后者没有对应元素);
  同时给 .is-register 补上 padding-top,避免折角三角形压住第一个输入框。
- 顺带去掉不再需要的内联 margin。

验证:vue-tsc + vite build 通过;浏览器实测三个面板都能切换(注册面板 5 个字段可见、
三角形不压输入框),两个列表页 content-fill 生效、整页不滚动、表格内部滚动且表头 sticky。
2026-10-17 08:55:32 +08:00
liufumingren
bd2363bf00 chore: 初始化仓库(backend / frontend / extension 三块)
- backend/:Egg 3 纯 JSON 接口服务(MySQL 8 + Redis),全部走 header 令牌鉴权;
  已彻底去掉服务端渲染(删除 page 控制器 / app/view / nunjucks / session / CSRF),
  开发时把页面请求反代到前端 dev server,生产托管 frontend/dist(SPA 回退)。
  单测 91 个通过(不需要本机数据库)。
- frontend/:Vite + Vue3 + TypeScript 的 SPA(登录 / 注册 / 找回密码 / 扫码登录与确认 /
  首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页),vue-tsc 类型检查与构建通过。
- extension/:MV3 浏览器扩展(零构建),注入第三方 WMS 页面识别运单号并打开溯源页。
- 忽略规则统一放根 .gitignore:node_modules、dist、logs / logs-*、run、typings、
  .env*、config.local.js(含本机数据库与 Redis 密码,绝不入库)。
2026-10-17 08:50:32 +08:00