# 快递打包监控

**Repository Path**: chenjjian/ExpressPackingMonitoring

## Basic Information

- **Project Name**: 快递打包监控
- **Description**: 电商快递打包监控系统 | 快递助手联动播报备注 | 单号检索打包视频 | 局域网 Web 回放 | 需扫码枪 + USB 摄像头
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: https://www.bilibili.com/video/BV1cFXXBUEUW
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-18
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 淘宝, 电商, 快递助手, 打包监控, 监控

## README

# 📦 快递打包监控 (Express Packing Monitoring)

一款专为中小电商、快递打包站量身打造的**全链路智能打包监控终端**，仅需搭配普通USB摄像头+扫码枪即可开箱即用。从打印快递单到打包发货全程自动化闭环，内置开箱即用的局域网Web回放服务，彻底根治错发漏发、客诉扯皮、打包效率低三大行业痛点。

![alt text](Image/场景图.jpg)

## 🌟 核心优势（我们不一样！）

### 🚀 快递助手深度联动 —— 零手动录入

还在打印完快递单，反复切后台看买家备注、商品明细？手忙脚乱还容易漏看关键信息？

- 配套专属油猴脚本，**自动监听打印按钮点击动作**，触发即抓取页面订单信息
- 一键拉取：快递单号 + 买家留言 + 卖家备注 + 商品全信息，零遗漏
- 局域网实时推送到上位机，**扫码瞬间自动语音播报备注与商品信息**
- 彻底告别反复切页、低头核对，彻底解放双眼双手，从根源杜绝漏发错发

### 🛡️ 视频防损坏 —— 断电也不怕

怕打包中途断电、电脑死机，录了半天的视频直接报废？怕硬盘存满了要手动清理旧录像？

- 全程采用 MKV 容器录制，**中途掉电、程序异常退出，已录制内容自动完整保存**
- 录制完成后自动转码为 MP4 格式，同时兼顾录制安全性与播放兼容性
- 支持多磁盘优先级存储配置，磁盘满了自动循环删除最旧的录像
- 内置静止超时检测，长时间画面无变化自动停止录制，长时间不录制会休眠摄像头，省电省空间不冗余

### 🔍 售后一秒举证 —— 搜单号就够了，铁证如山不扯皮

遇到买家说少发、错发，翻遍硬盘找不到对应录像？客诉扯皮拿不出证据，只能吃哑巴亏？

- 软件内置**开箱即用的局域网Web服务**，无需额外部署、无需安装客户端，同网内手机/电脑/平板打开浏览器即可访问
- 支持**单号精准搜索、日期范围筛选**，输入快递单号秒级定位对应打包全程录像，无需翻文件夹、不用记录制时间
- 单条录像支持**在线流畅播放、一键原文件下载**，客诉对接直接甩视频链接/文件，举证效率拉满
- 视频全程自带**不可篡改硬水印**：录制时自动在画面右上角叠加快递单号 + 实时日期时间戳，打包全流程可追溯，铁证如山
- 再也不用替快递背锅、替误会买单，客诉处理效率直接翻倍

![alt text](Image/WebService.jpg)

## ✨ 更多硬核加分项

### 🔥 无接触控制体验

- 条码指令智控：扫描专用控制条码（START/STOP/SHIP/BACK/CLEAR）即可操控软件，全程无需触碰键盘鼠标
- 全局键盘监听：即使软件在后台运行，也能稳定接收扫码枪输入，不打断打包流程
- 防重复扫描机制：内置动态冷却时间控制，彻底避免误操作导致的重复录制/停止

### 💾 多磁盘顺序存储

- 支持同时配置多条存储路径，按自定义优先级排序，选择存储位置
- 每条存储路径可独立设置磁盘配额（GB），精细化管理存储空间
- 设置展示存储空间使用率，自动预估剩余可录制时长，存储状态一目了然

### ⚡ 高性能GPU加速编码

- 全平台显卡支持：NVIDIA NVENC、AMD AMF、Intel Quick Sync 全覆盖
- 多编码格式兼容：支持 H.264/H.265/AV1，兼顾极致压缩率与全设备播放兼容性
- 智能编码检测：软件启动时自动扫描可用编码器，一键匹配最佳性能配置
- 内置H.265转H.264缓存机制，支持自定义缓存上限，浏览器播放兼容性拉满

### 🗣️ AI语音播报

- 支持对接 Kokoro 本地AI语音引擎，彻底告别Windows自带机械音
- 内置电商商品名智能断词预处理逻辑，解决本地TTS连读糊读问题，播报更自然流畅
- 首次运行生成语音缓存，后续相同文本直接调用，极大提升响应速度

### 🎛️ 全可视化配置管理

- 视频水印一键开关，自由选择是否叠加单号+时间戳硬水印
- 局域网Web服务可视化配置，支持自定义监听端口（默认5280），修改后重启即可生效
- 摄像头、特写、录制、存储全参数可视化配置，无需改代码，点点鼠标就能适配你的打包场景

---

## 🎯 基础核心功能

- 📹 高可靠视频录制：原生支持 USB 摄像头、OBS 虚拟摄像头，基于 FFmpeg 实现高性能音视频编码
- 🔍 特写功能：开始录制后，放大中心区域，可配置延时、放大时间
- 🌐 局域网Web回放：内置HTTP服务，支持同网内设备远程搜索、播放、下载打包录像
- 🖼️ 防篡改视频水印：录制时自动叠加快递单号+实时时间戳，全程可追溯，举证更有力
- 🎨 现代化UI体验：基于 MVVM 架构开发，自带浅色/深色/跟随系统主题，美观又好用
- 📊 打包效率统计：可视化数据看板，直观展示近7日/30天打包效率与工作量趋势
- ⏱️ 全流程容错机制：扫码防误触、静止超时自动停录、异常状态语音预警，打包全程稳如泰山

---

## 📋 必备硬件要求

| 类型 | 要求说明 |
| ------ | ---------- |
| USB摄像头 | 支持UVC协议的普通USB摄像头、电脑内置摄像头、OBS虚拟摄像头均可，推荐1080P及以上分辨率 |
| 条码扫描枪 | 支持全局键盘输出的普通扫码枪（有线/无线均可），无需特殊驱动，即插即用 |

---

## 🛠️ 技术栈

- **核心框架**：.NET 8.0 Windows (WPF)
- **架构模式**：MVVM（基于 CommunityToolkit.Mvvm）
- **视频与图像处理**：AForge.Video + OpenCvSharp4 + FFmpeg
- **本地数据存储**：Microsoft.Data.Sqlite
- **UI 组件库**：Extended.Wpf.Toolkit

---

## 🚀 快速开始

### 运行环境要求

- 操作系统：Windows 10/11 x64
- 运行时：已安装 [.NET 8.0 Desktop Runtime](https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
- 编码依赖：**FFmpeg.exe（推荐Full版本）**，需添加至系统环境变量 PATH，或直接放置在程序运行根目录

### 编译与发布

```powershell
# 克隆仓库（GitHub为主仓库，Gitee为同步镜像，二选一即可）
git clone https://github.com/m-RNA/ExpressPackingMonitoring.git
# git clone https://gitee.com/chenjjian/ExpressPackingMonitoring.git

cd ExpressPackingMonitoring

# 编译运行
dotnet run --project ExpressPackingMonitoring

# 发布为合并为独立exe（减少额外依赖，适合打包站直接部署）
dotnet publish ExpressPackingMonitoring -c Release -r win-x64 --self-contained false -p:PublishSingleFile=true
```

### 核心功能启用指南

#### 1. 快递助手订单推送集成

- 先安装 Tampermonkey 或 Violentmonkey 浏览器扩展
- 打开仓库内 `Scripts/快递助手订单推送.user.js` 文件，点击「安装」即可
- 默认上位机连接地址：`http://127.0.0.1:5280`，通过脚本菜单修改为上位机IP与端口即可
- 脚本会自动在快递助手页面注入订单推送功能，每次打印订单时，脚本会自动推送给上位机

#### 2. 局域网Web回放服务启用

- 打开软件设置页面，进入「高级设置」选项卡
- 开启「启用Web服务」开关，默认监听端口为5280，可自定义修改
- 点击「保存应用」，重启软件后生效
- 同网内设备打开浏览器，输入 `http://[上位机IP]:5280` 即可访问录像回放页面

#### 3. Kokoro AI语音模型启用

- 打开软件设置页面，进入「高级设置」选项卡
- 开启「启用 AI 语音」开关
- 下载 Kokoro 语音模型后，解压至软件根目录即可自动识别

```powershell
Invoke-WebRequest -Uri "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/kokoro-multi-lang-v1_0.tar.bz2" -OutFile "kokoro-multi-lang-v1_0.tar.bz2" -UseBasicParsing
```

---

## 📄 许可证

本项目开源，遵守 [AGPL-3.0 License](LICENSE)。

- ✅ 个人学习、自家店铺自用，完全免费无限制
- ❌ 商用、二次开发、闭源分发，必须严格遵守 AGPL-3.0 协议要求
- 🔒 二次修改分发必须完整开源，必须保留原作者署名与版权声明

---

**用了这套系统，错发漏发不存在的，客诉扯皮不存在的，打包效率直接翻倍！** 🎉