WorkBuddy 实战:把数据分析脚本打包成桌面小程序
## 一、背景:为什么要做这个工具? 我所在的车间每天都会产生一份 Excel 格式的《生产日报》,里面记录了储罐存量、各装置运行数据、工序处理量等信息。以前分析这些数据需要手动翻 Excel,费时费力还容易看漏。 于是我想:能不能做一个桌面小程序,**选一下文件,点一下按钮,自动生成一份排版漂亮的 HTML 分析报告?** 答案是可以,而且全程用 WorkBuddy 搞定,自己几乎没写一行代码。 --- ## 二、技术选型 |环节|技术|说明| | --- | --- | --- | |读取 Excel|openpyxl|Python 生态最成熟的 Excel 读取库| |数据处理|纯 Python|字典 + 列表,无需 Pandas| |报告生成|HTML + 内联 CSS|无外部依赖,直接浏览器打开| |GUI 界面|tkinter|Python 自带,无需额外安装| |打包发布|PyInstaller|--onefile --windowed 打包成单个 EXE| **为什么不用 Pandas?** 因为日报的表格结构不规则(合并单元格、多级表头),按行列坐标精确读取比 DataFrame 更可靠。 --- ## 三、第一步:用 openpyxl 读取 Excel 数据 ### 3.1 基本读取 ``` from openpyxl import load_workbook wb = load_workbook(file_path, data_only=True) ws = wb['生产日报'] # 指定 sheet ``` > **踩坑提示**:一定要加 `data_only=True`,否则读出来的是公式而不是计算后的值。 ### 3.2 按行列坐标精确提取 日报的数据分布在不同行,我们需要逐行提取: ``` # 储罐数据:第3行到第23行 tank_data = [] for row_idx in range(3, 24): name = ws.cell(row=row_idx, column=1).value if name is None: continue capacity = ws.cell(row=row_idx, column=2).value # 容量 opening = ws.cell(row=row_idx, column=3).value # 期初库存 closing = ws.cell(row=row_idx, column=4).value # 期末库存 recv = ws.cell(row=row_idx, column=5).value # 接收水量 disp = ws.cell(row=row_idx, column=6).value # 处理水量 tank_data.append({ 'name': str(name).strip(), 'capacity': capacity, 'opening': opening, 'closing': closing, 'recv': recv, 'disp': disp, }) ``` ### 3.3 多行合并汇总 有些装置的数据分散在多行(主行 + 子行),需要累加: ``` # 多效蒸发器:第27-31行,处理量需累加所有子行 duo_xiao_total = 0 for r in range(27, 32): v = ws.cell(row=r, column=4).value if isinstance(v, (int, float)): duo_xiao_total += v ``` > **踩坑提示**:一定要用 `isinstance(v, (int, float))` 判断,不能直接 `if v:`,因为 `0` 是合法值但会被 `if v:` 跳过。 ### 3.4 多罐合计查找 干燥机 A/B 在表格中合并为一行,但对应的储罐有两个,需要合计: ``` def find_tank_closing(key): """模糊匹配储罐名称,返回期末库存。支持字符串(单罐)和列表(多罐合计)""" if isinstance(key, list): total = 0 for k in key: for name, td in tank_lookup.items(): if k in name: # 模糊匹配 c = td['closing'] if isinstance(c, (int, float)): total += c break return total # 单罐查找... ``` 这样传入 `['千方浓液罐-二次浓液', 'C类二次浓液B罐']` 就能自动合计两个罐的库存。 --- ## 四、第二步:生成 HTML 报告 ### 4.1 报告结构 报告分两个部分: 1. **各装置运行概况**:3列网格卡片,每个装置独立一张卡 1. **各工序接收/日处理/存量**:表格,含状态判定 ### 4.2 状态判定逻辑 储罐液位超过 85% 容量时标记为"需关注": ``` THRESHOLD = 85 if isinstance(closing, (int, float)) and isinstance(capacity, (int, float)) and capacity > 0: fill_pct = closing / capacity * 100 if fill_pct > THRESHOLD: status = '需关注' # 红色加粗 else: status = '正常' # 绿色 ``` ### 4.3 卡片与表格差异化显示 有个特殊需求:干燥机 A/B 在**卡片中分开显示**(各自独立数据),但在**表格中合并为一行**(数据合计)。解决方案是用 `card_only` 标记: ``` # 卡片列表:干燥机-A 和 干燥机-B 分别是独立卡片 devices = [ # ... 其他装置 ... {'name': '干燥机-A', ..., 'card_only': True}, # 只在卡片显示 {'name': '干燥机-B', ..., 'card_only': True}, # 只在卡片显示 ] # 表格生成时:遇到 card_only 设备跳过,插入合并行 for dev in devices: if dev.get('card_only'): if dev['name'] == '干燥机-A' and not dryer_merged_inserted: # 插入合并行:"干燥机-A、B" # 数据 = A + B 的合计 dryer_merged_inserted = True continue # 正常输出... ``` ### 4.4 数值格式化函数 ``` def fmt(v, decimals=2): if v is None: return '-' if isinstance(v, float): return f'{v:.{decimals}f}' if isinstance(v, int): return f'{float(v):.{decimals}f}' return str(v) ``` > **踩坑提示**:之前用 `v or '/'` 来处理空值,结果 `0` 也被转成了 `'/'`。后来改用 `isinstance` 显式判断类型才解决。 --- ## 五、第三步:构建 tkinter GUI 界面 ``` import tkinter as tk from tkinter import filedialog, messagebox import threading import webbrowser class DailyReportApp: THRESHOLD = 85 def __init__(self): self.root = tk.Tk() self.root.title('生产日报') self.root.geometry('520x320') self.root.resizable(False, False) self.build_ui() def build_ui(self): # 蓝色标题栏 title_frame = tk.Frame(self.root, bg='#2196F3', height=50) title_frame.pack(fill=tk.X) title_frame.pack_propagate(False) tk.Label(title_frame, text='生产日报分析工具', font=('Microsoft YaHei', 16, 'bold'), fg='white', bg='#2196F3').pack(expand=True) # 文件选择框 + 浏览按钮 file_frame = tk.Frame(body) file_frame.pack(fill=tk.X, pady=(5, 10)) self.file_entry = tk.Entry(file_frame, font=('Microsoft YaHei', 10)) self.file_entry.pack(side=tk.LEFT, fill=tk.X, expand=True) tk.Button(file_frame, text='浏览...', command=self.select_file).pack(side=tk.RIGHT) # 生成按钮 self.btn_generate = tk.Button(body, text='生成报告', command=self.generate_report, bg='#2196F3', fg='white', width=20, height=2, relief=tk.FLAT) self.btn_generate.pack(pady=(10, 0)) ``` ### 关键点:用线程避免界面卡死 生成报告可能需要几秒,如果直接在主线程执行,界面会无响应。用子线程处理: ``` def generate_report(self): self.btn_generate.config(state=tk.DISABLED, text='正在生成...') self.status_label.config(text='正在读取数据并生成报告...', fg='#ff6f00') # 子线程执行耗时操作 threading.Thread(target=self._do_generate, daemon=True).start() def _do_generate(self): try: html_content = self.extract_and_build(self.file_path) with open(output_path, 'w', encoding='utf-8') as f: f.write(html_content) webbrowser.open(output_path) # 自动打开浏览器 # 用 after 回到主线程更新 UI self.root.after(0, lambda: self.status_label.config(text='报告已生成!', fg='#2e7d32')) except Exception as e: self.root.after(0, lambda: messagebox.showerror('生成失败', str(e))) finally: self.root.after(0, lambda: self.btn_generate.config(state=tk.NORMAL, text='生成报告')) ``` > **关键**:tkinter 不允许在子线程中直接操作 UI,必须用 `self.root.after(0, callback)` 切回主线程。 --- ## 六、第四步:打包成 EXE ### 6.1 安装 PyInstaller ``` pip install pyinstaller ``` ### 6.2 打包命令 ``` pyinstaller --onefile --windowed --name "生产日报" daily_report_app.py ``` |参数|说明| | --- | --- | |--onefile|打包成单个 EXE 文件| |--windowed|不弹出黑色控制台窗口| |--name|EXE 文件名| 打包完成后,EXE 在 `dist/` 目录下,大小约 23MB。 ### 6.3 踩坑:EXE 文件锁定无法覆盖 **问题**:桌面上的旧 EXE 还在运行,新打包的文件无法覆盖。 **解决方案**: - 方法一:关闭正在运行的旧 EXE,再复制 - 方法二:每次打包用不同目录名(`dist_v2`、`dist_v3`…),最后统一复制到桌面 --- ## 七、最终效果 用户操作流程: ``` 打开"生产日报.exe" → 点击"浏览"选择 Excel 文件 → 点击"生成报告" → 浏览器自动打开 HTML 报告 ``` 报告包含: 1. **各装置运行概况**:8个装置卡片(3列网格),显示接收来源、处理水量、浓液产生、产盐量、运行效率,停机状态红色高亮 1. **各工序接收/日处理/存量**:表格显示各工序的日接收量(绿色)、日处理量(绿色)、储罐存量、总存储量、状态,超过85%标记"需关注" --- ## 八、踩坑总结 |问题|原因|解决方案| | --- | --- | --- | |读出来全是 None|没加 data_only=True|加上该参数读取计算后的值| |0 被显示为 /|用 v or '/' 处理空值|改用 isinstance(v, (int, float)) 判断| |界面卡死|耗时操作在主线程执行|用 threading.Thread + root.after()| |子线程操作 UI 报错|tkinter 线程安全限制|用 self.root.after(0, callback) 切回主线程| |EXE 无法覆盖|旧程序还在运行|关闭旧程序或换目录打包| |429 额度用尽|API 调用频繁|等额度恢复,或切换轻量模型| --- ## 九、与 WorkBuddy 协作的经验 整个过程中,WorkBuddy 承担了以下工作: 1. **理解需求**:我用自然语言描述需求(“把干燥机 A/B 在卡片里分开,表格里合并”),它自动转化为 `card_only` 标记 + 合并逻辑 1. **写代码**:从数据提取到 HTML 生成到 GUI 构建,全部由 WorkBuddy 生成 1. **打包**:一条指令自动执行 PyInstaller 打包 1. **迭代修改**:每次说"把XX改成YY",它精准定位并修改对应代码 **省积分技巧**:需求一次说清楚,减少来回对话。比如先确认好报告结构再让它写代码,比边写边改省很多额度。 --- ## 十、总结 |项目|数据| | --- | --- | |开发时间|约 2 小时(含多轮迭代)| |代码行数|~590 行 Python| |EXE 大小|23 MB| |手写代码量|0 行| |依赖库|openpyxl, pyinstaller(tkinter 为内置库)| 如果你也有类似的 Excel 数据分析需求,不妨试试用 WorkBuddy 搭一个专属桌面工具。整个过程不需要编程基础,只需要把需求说清楚就行。 **核心思路**:读数据 → 生成 HTML → 包一层 GUI → 打包 EXE。四步走,任何 Excel 报表都能变成一键生成的桌面工具。