5 Commits

Author SHA1 Message Date
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