# Salary Monitor

把多份双周工时表汇成一张能核对、能导出的工资总表

Source: https://works.im0o.top/projects/salary-monitor/
Date: 2026-07-25
Tags: Python, Vue, pywebview, 数据分析


Salary Monitor 是一个汇总双周工时单的桌面工具。一个员工一期一个 Excel，主管想看某个人半年领了多少、哪几期还没交表，就得把文件逐个翻一遍。

我让工具读取这些文件，按员工和周期排成总览表。导入这一期的文件、确认冲突后，就可以预览和导出 Excel。

## 按员工和周期汇总工时单

每份工时单里既有每日打卡区，也有管理层填写的结算区。程序读取结算数据：工号、姓名、周期结束日，以及六个 Job Code 对应的工时、时薪和金额。

工号决定它属于哪个员工，周期决定它落在哪一列。总表里，每人保留 Hours、Rate、Total 三行，最新周期放在左侧。

| 总表里的位置 | 对应什么 |
| --- | --- |
| 员工行组 | 以工号归并，姓名用于显示 |
| 周期列 | 实际导入文件中出现过的周期 |
| Hours / Rate / Total | 这一期的结算内容 |
| Overall | 员工所有已导入周期的合计 |

没交表的位置留空，不补成 0；某一期完全没有文件，也不会凭日历多造一列。表格里的空白，本来就是主管要看的信息。

![未交表的位置留空，和确认过的 0 分开保留](https://image.im0o.top/2026/20261117104457511.webp "未交表的位置留空，和确认过的 0 分开保留")

## 导入时需要确认的冲突

同一个员工、同一个周期出现两份文件，需要决定保留哪份。最终我用了类似 Windows 复制文件冲突的交互：一项一项处理，显示还剩多少项，也可以把同一种选择应用到后续冲突。

姓名不一致则提供名称选择。表格里的日期和文件名冲突、填写了多个 Job Code、模板位置不对，这些情况作为备注留下；读不了的文件单独列出。能读的数据先进入导入列表，再由勾选决定是否参与汇总。

Excel 的公式也不能想当然。文件里可能只有公式，没有保存过的计算值；这个值和明确填写的 0 不一样。解析时保留这些差别，预览里给出对应标记，避免导出一张看着齐全、实际混进错误数字的表。

![工号与周期定位同一格，重复文件先确认再汇总](https://image.im0o.top/2026/20261117104450419.webp "工号与周期定位同一格，重复文件先确认再汇总")

## 预览应该占整个窗口

第一版把导入列表和预览长期平分两栏。员工数量不多，真正挤的是一年二十多期的横向列；导入结束后，列表却还占着一半宽度。

第二版我改成预览优先。总表占完整窗口，导入列表收进右侧抽屉，需要确认的冲突使用独立窗口处理。顶部保留已导入、待处理、需注意和无法读取的状态入口，点开时直接筛到对应内容。

整个窗口都可以接收 Excel 文件或目录拖入。空库时给一个明确的投放位置，导入后再看结果。目录扫描有范围限制，界面不会因为误拖一个很大的目录一直等下去。

预览也按导出表的布局来做，数字和列的位置要对得上。早期强调最新列的红色后来在预览与导出里一起取消，避免两个地方各是一种样子。

## 本地数据与桌面打包

读取、数据整理和 Excel 导出在 Python，Vue 负责界面，通过 pywebview bridge 通信。开发时也连接真实 bridge，方便发现只看浏览器示例数据遇不到的问题。

打包时，网页需要构建成一个内联 HTML。桌面窗口从 `file://` 加载，如果仍把脚本和样式拆成外部资源，开发服务器里好好的界面，打包后就可能白屏。我把这个约束也放进了构建检查。

程序可以打包成 Windows 文件夹交付，数据保存在本地。界面会显示当前数据目录，方便一起备份和迁移。

