一、立项背景与目标
本项目面向农产品合作社的日常数据处理需求,将分散在各片区的 Excel 台账、农户照片与商品图片整理为统一格式的可用数据。
合作社现有流程中,各片区上报的销售明细表头命名与列顺序不一致;农户提供的照片文件名为相机默认名或即时通讯软件自动命名;商品图片需按电商平台要求统一尺寸与体积后方可上架。上述工作原由单人手工完成,效率低且易出错。
目标为提供一款本地运行、无需联网的桌面工具,完成上述三类批处理任务。
二、功能模块
1. 数据汇总模块
自动识别指定文件夹中的 Excel 文件,按别名映射表对齐表头(如「数量」「销量」「件数」「销售数量」归为同一字段),统一日期与金额格式,按日期、商品、数量、金额组合去重,输出合并总表,并将关键字段为空的行单独导出为异常清单。
2. 素材整理模块
按「前缀 + 日期 + 序号」规则批量重命名文件,执行前生成完整的前后对照预览,按文件类型归档至子目录,遇重名文件自动跳过。
3. 图片批处理模块
批量调整输出宽度与压缩质量,添加文字水印(位置与字号按图片宽度自适应),支持 JPG、PNG、WEBP 格式互转,处理后输出体积变化统计。
三、业务流程
选择目标文件夹 → 扫描并识别文件 → 生成处理预览 → 用户确认 → 执行处理 → 输出至指定目录。全部处理在本机完成,不产生网络请求。
一、整体架构
后端采用 Python,前端为 HTML、CSS、JavaScript,通过 pywebview(WebView2 内核)封装为桌面窗口应用。界面与业务逻辑分离,ui 目录存放静态资源,修改界面无需调整 Python 代码。
各模块采用「扫描 → 预览 → 执行 → 输出」的统一交互,但数据结构与校验规则相互独立。
二、负责模块与量化结果
1. 数据汇总。实测 5 个表头格式不一致的文件、170 行原始数据,输出 160 行有效记录,去除重复 10 行,耗时 0.1 秒。别名映射表覆盖 8 组同义表头。
2. 素材整理。实测 12 个命名不规则文件,处理耗时 3 秒,输出命名格式为「甲村_0905_001.jpg」。
3. 图片批处理。4 张 1200×1200 原图由 1.0 MB 压缩至 219 KB,体积减少 79%,耗时 0.2 秒。
三、难点与解决方案
1. 表头对齐。各片区上报文件的列顺序与命名不统一,硬编码列序会导致字段错位。改用别名映射表,按字段语义匹配而非位置匹配。
2. 去重键设计。同一天同一商品可能存在多个批次,按单列去重会误删有效记录。改用日期、商品、数量、金额四字段组合作为去重键。
3. 打包失败。使用 PyInstaller 打包可执行文件时,pywebview 依赖的 pythonnet 组件在打包环境中回退至 .NET Framework 模式,程序启动即异常退出(Failed to resolve Python.Runtime.Loader.Initialize)。改用 VBS 脚本调用 Python 启动,规避该问题。
4. 界面可读性。使用实景背景时表格文字对比度不足,通过降低背景亮度、面板增加半透明模糊层、标题区单独加遮罩三种方式解决。
说明:界面中的村名与商品名为演示用示意数据(甲、乙、丙、丁、戊村及商品 A 至 D),合作社真实经营信息已脱敏。工具本身可现场运行演示。