From 2573404981650a624e55e4b919af6612df8065d3 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Mon, 19 Oct 2026 22:03:59 +0800 Subject: [PATCH] =?UTF-8?q?chore:=20=E5=BF=BD=E7=95=A5=E5=86=85=E7=BD=AE?= =?UTF-8?q?=20ffmpeg=20=E5=8F=AF=E6=89=A7=E8=A1=8C=E6=96=87=E4=BB=B6?= =?UTF-8?q?=E5=B9=B6=E6=9B=B4=E6=96=B0=E5=90=84=E7=AB=AF=20README?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .gitignore | 3 + README.md | 22 +-- backend/README.md | 171 ++++++++++++++++++----- desktop/README.md | 240 +++++++++++++++++++++++++++++--- desktop/native/ffmpeg/README.md | 56 ++++++++ extension/README.md | 108 +++++++++++--- 6 files changed, 513 insertions(+), 87 deletions(-) create mode 100644 desktop/native/ffmpeg/README.md diff --git a/.gitignore b/.gitignore index ced8f61..332a55e 100644 --- a/.gitignore +++ b/.gitignore @@ -69,3 +69,6 @@ desktop.ini * - 副本.* # 联调用的临时脚本(如 .tmp-reset-probe.js / .tmp-css-audit.cjs),跑完就删,别提交 .tmp-* + +# ---------- 内置 ffmpeg(exe 体积大不进仓库;打包前按 desktop/native/ffmpeg/README.md 放好) ---------- +desktop/native/ffmpeg/*.exe diff --git a/README.md b/README.md index bd25126..63c9733 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,13 @@ # 云仓视频溯源系统 -前后端分离 + 一个浏览器扩展,三个目录: +前后端分离 + 一个浏览器扩展 + 一个 Windows 本机软件(WPF),四个目录: ``` packService/ ├── backend/ # Egg.js 3(纯 API;MySQL + Redis) ├── frontend/ # Vite + Vue3 + TypeScript(用户端 SPA) -└── extension/ # Chrome MV3 扩展:注入第三方 WMS 页面,把运单号加工成溯源入口 +├── extension/ # Chrome MV3 扩展:注入第三方 WMS 页面,把运单号加工成溯源入口 +└── desktop/ # WPF 本机软件:本机 HTTP 服务(127.0.0.1:17300)+ yuncang:// 启动协议 ``` ## 端口约定(⚠️ 本机项目多,不要用 Vite 默认的 5173) @@ -15,13 +16,14 @@ packService/ | --- | --- | --- | | 前端 dev(Vite) | **7301** | `cd frontend && npm run dev` | | 前端 preview(dist) | **7302** | `cd frontend && npm run preview` | -| 后端 dev | **7001** | `cd backend && npm run dev` | -| 后端 dev:test(与 7001 并存) | **7300** | `cd backend && $env:LOG_DIR='logs-test'; npm run dev:test` | +| 后端 dev | **7300** | `cd backend && npm run dev` | +| 本机软件(WPF,只监听 loopback) | **17300** | `cd desktop && dotnet run`(详见 [`desktop/README.md`](desktop/README.md)) | | 扩展自测页(可选) | **7310** | `npx --yes http-server extension/test -p 7310` | - 前端端口可用 `VITE_PORT=7303 npm run dev` 覆盖;`strictPort: true` → 端口被占用时**直接报错**,不会偷偷换端口(否则代理会对不上)。 -- 前端调接口走**同源代理**:Vite 把 `/api`、`/health` 反代到后端(默认 `127.0.0.1:7001`,用 `VITE_BACKEND` 覆盖)。 -- 联调更方便的做法:直接开后端 `:7001`,由后端(dev)把 `/` 反代到前端 dev server(`FRONTEND_DEV_SERVER`,默认 `http://127.0.0.1:7301`)。 +- 后端端口可用 `PORT=7400 npm run dev` 覆盖(默认 **7300**,配置在 `backend/config/config.default.js` 的 `config.cluster.listen.port`)。 +- 前端调接口走**同源代理**:Vite 把 `/api`、`/health` 反代到后端(默认 `127.0.0.1:7300`,用 `VITE_BACKEND` 覆盖)。 +- 联调更方便的做法:直接开后端 `:7300`,由后端(dev)把 `/` 反代到前端 dev server(`FRONTEND_DEV_SERVER`,默认 `http://127.0.0.1:7301`)。 - **上线**:后端托管 `frontend/dist`(静态资源 + SPA fallback),`/` 出前端、`/api/*` 出 JSON。 ## 身份与通讯约定 @@ -39,7 +41,7 @@ packService/ - [x] 目录拆分为 `backend/` + `frontend/` - [x] 前端脚手架(Vite + Vue3 + TS)跑通,登录页走通 `/api/web/auth/*` -- [x] 浏览器扩展 `extension/`(MV3,零构建):注入第三方 WMS 页面识别运单号 → 点击打开溯源页 +- [x] 浏览器扩展 `extension/`(MV3,零构建):注入第三方 WMS 页面,在运单号**旁边**渲染「查看打包视频」按钮 → 点按钮打开溯源页 - [x] **后端去掉服务端渲染**:删除 `app/controller/page/`、`app/view/`、`app/lib/page.js`、nunjucks / session / CSRF 配置与依赖,后端只剩 JSON 接口 - [x] 页面全部迁移到前端:登录 / 注册 / 找回密码 / 扫码 / 扫码确认 / 首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页 - [x] 后端 dev 反代前端(`app/middleware/frontend.js`)+ 生产托管 `frontend/dist`(SPA 深链回退) @@ -56,7 +58,7 @@ packService/ - **登录 / 注册 / 找回密码 / 重置密码 / 扫码确认**这类「裸页」:居中卡片(`.bare-page` + `.bare-card`,宽 360px)。 - ⚠️ 外层**不要用 `align-items: center`**:卡片比视口高时顶部会被裁掉且滚不上去 —— 用 `.bare-card { margin: auto }` 让它在容器里自己居中,`overflow-y: auto` 兜底; - **表单字段不用 `