快递运费计算器

按客户计算快递运费的 Windows 桌面软件（兼容 Win10 / Win11）。

功能

功能	说明
Excel 上传	导入快递账单（单号明细编辑格式），一个 Sheet 内可混合多个客户
客户识别	按「运单发放」列自动区分客户，新客户自动建档
报价规则	客户 × 省份 价格表（首重 / 首重价 / 续重价），可随时修改、复制
体积计算	长×宽×高 ÷ 抛比（抛比可自定义，默认 8000），体积重与实重取大
公式确认	逐单展示计算公式（如 首重1kg=5元 + 续重1.84kg×2元/kg = 8.68元），核对后再导出
按客户导出	一键把每个客户导出为单独的 Excel，含明细 + 省份汇总两个 Sheet

未定价的省份会在核对页标红提醒，导出的文件中「应收运费」单元格也会标红。

使用流程

1. ① 上传账单：选择快递公司给的 Excel 账单 → 点「开始计算运费」
2. 报价规则：选择客户，逐省填写 首重 / 首重价 / 续重价 → 保存
3. ② 计算核对：逐单检查计算公式；红色 = 该省未定价，回报价页补价格后点「重新计算」
4. ③ 导出账单：选择文件夹，勾选客户，导出为多个 Excel 文件
5. 设置：调整抛比、是否启用体积重、重量进位规则（默认按实际值计算）

在 Windows 上打包成 exe（两种方式任选）

方式 A：自己的 Windows 电脑打包（无需联网环境除外）

1. 安装 Python 3.10 以上（安装时勾选 Add to PATH）
2. 把整个 express-fee-calculator 文件夹拷到 Windows 电脑
3. 双击运行 build_windows.bat
4. 生成的 dist\ExpressFeeCalc.exe 就是成品软件，拷到任何 Win10/Win11 电脑双击即用（无需装 Python）

方式 B：GitHub 云端打包（不需要 Windows 电脑）

1. 把本项目上传到 GitHub 仓库
2. 打开仓库的 Actions 页，手动运行 build-windows-exe 工作流
3. 运行完成后在产物（Artifacts）里下载 快递运费计算器-Windows

本地开发（Mac）

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
cd app && ../.venv/bin/python main.py

数据存放

• 报价规则、客户档案、设置保存在 SQLite 数据库中：
  • Windows 打包版：用户目录 .express_fee_calc\express_fee.db
  • 开发模式：项目目录 data/express_fee.db
• 上传的账单不会被修改，软件只读取。

项目结构

express-fee-calculator/
├── app/
│   ├── main.py          # 程序入口
│   ├── main_window.py   # 界面（上传/报价/核对/导出/设置 五个页面）
│   ├── pricing.py       # 计算引擎（体积重、计费重量、公式生成）
│   ├── excel_io.py      # Excel 导入导出
│   └── db.py            # SQLite 存储
├── build_windows.bat    # Windows 一键打包脚本
├── .github/workflows/build-windows.yml  # GitHub 云端打包
└── requirements.txt