Skip to content

Repository files navigation

WageJar 图标

WageJar

把月薪拆成今天、此刻和每一分钟。

一款 macOS 菜单栏今日工资进度工具,实时计算今日工作到此刻已经积累了多少工资,并记录本月收入、下班倒计时。

简体中文 · English

macOS 14+ Swift 6 纯本地 MIT CI

下载 WageJar

WageJar 暖色工作场景封面

工资按月到账,但你付出的时间,是一秒一秒发生的。

工资按月到账,工作却一秒一秒发生

大多数工资工具只告诉你一个月薪数字。WageJar 更关心正在发生的今天:

  • 现在这一刻,今天已经积累了多少?
  • 午休不计入之后,距离下班还有多久?
  • 法定节假日、周末调休和公积金算进去后,本月进度是多少?

它常驻 macOS 菜单栏,不占程序坞。点开看一眼,关掉继续工作。

9 秒看看 WageJar

WageJar 今日工资、时间轴、收入日历与本地隐私功能演示

动图使用隔离演示数据,不包含真实个人收入。

一眼看懂今天

WageJar 今日工资进度首页 WageJar 收入日历
今日工资时间轴
此刻积累、本月累计与下班倒计时
中国工作日收入日历
上班、休息、调休和月度记录放在一起

演示数据:月工资 ¥10,000、公积金 ¥1,000、工作时间 09:00–17:00;不包含真实个人收入。

WageJar 的三个核心特色

每一分钟都有进度 不是简单地排除周末 记录时间,不窥探内容
今日金额按有效工作时间实时变化。午休暂停,拖动时间轴还能查看任意时刻对应的工资。 内置中国大陆法定节假日与周末调休。该上班的周末会计入,该休息的工作日不会误算。 软件时间只按前台焦点累计,不读取窗口标题、网页地址、文件名、键盘输入或屏幕内容。

下载使用

GitHub Releases 下载最新版:

  • WageJar-*-macOS-universal.dmg:推荐,打开后将 WageJar 拖入“应用程序”。
  • WageJar-*-macOS-universal.zip:解压后将 WageJar 拖入“应用程序”。
  • 支持 macOS 14 Sonoma 或更高版本,以及 Apple Silicon 和 Intel Mac。

当前版本采用本机临时签名,尚未完成 Apple 公证。第一次运行时,请在 Finder 的“应用程序”中右键 WageJar → 打开 → 再次确认打开。后续完成 Developer ID 签名、公证并接入更新框架后,即可正常双击启动和自动更新。

从源码开始

系统要求:

  • macOS 14 Sonoma 或更高版本
  • Xcode 16 或兼容 Swift 6 的命令行工具

当前 App 界面只提供简体中文。

git clone https://github.com/LeoForgeLab/WageJar.git
cd WageJar
./Scripts/build-app.sh

构建产物位于:

dist/WageJar.app

将它拖入 Finder 的“应用程序”文件夹即可。构建脚本使用本机临时签名,不要求 Apple Developer 证书;若要消除首次打开警告,仍需要 Developer ID 签名和 Apple 公证。

开发与测试:

swift run
swift test
查看项目结构
.
├── Sources/WorkTracker
│   ├── DashboardView.swift          # 首页、收入说明与日历
│   ├── AppUsageMonitor.swift        # 前台应用监测和本地记录
│   ├── AppUsageView.swift           # 软件使用统计界面
│   ├── EarningsCalculator.swift     # 收入、工作进度与时间换算
│   ├── ChinaHolidayCalendar.swift   # 法定节假日与调休
│   └── WorkTrackerApp.swift         # 菜单栏、弹窗与单实例生命周期
├── Tests/WorkTrackerTests           # Swift Testing 测试
├── Scripts/build-app.sh             # 生成 macOS App
├── Scripts/package-release.sh       # 生成 Universal ZIP、DMG 与校验文件
└── Support                          # Info.plist 与应用图标

不只是“月薪 ÷ 30”

WageJar 按自然月和真实工作规则计算:

月度基准 = 到手工资 + 公积金
日薪     = 月度基准 ÷ 本月官方工作日
今日积累 = 日薪 × 今天有效工作进度
本月累计 = 已完成工作日 × 日薪 + 今日积累
  • 上下班时间和午休时间可以调整。
  • 工资与公积金按月保存;未填写的月份自动参考最近一次记录。
  • 点击历史日期,可以查看当天金额和截至当天的累计金额。
  • 计算说明会展示日薪、时薪、分钟收入和每一步公式。

这里展示的是可解释的估算,而不是一个来源不明的数字。

为真实办公场景准备的细节

  • 金额默认隐藏:每次打开面板都会重新显示为 ***,需要时再点眼睛查看。
  • 两条可拖动时间轴:今日进度查看具体时刻,年度进度查看具体日期。
  • 完整下班状态:区分上班前、工作中、午休、下班后和休息日。
  • 月度收入历史:工资和公积金可以逐月录入,也能恢复参考值。
  • 软件使用历史:查看今日、本周、历史月历、软件排行和准确使用时段。
  • 暖色日常感:日间与下班封面、每日轮换的鼓励语、存钱罐应用图标。
  • 原生菜单栏体验:单实例运行,不占程序坞,可直接重启或退出。

软件使用时间是怎么记录的

WageJar 按 macOS 当前处于前台的应用形成时间段:切换到后台时结束这一段,再次切回来时开始新的一段。锁屏、睡眠或超过设定时间无操作时会暂停。

它只保存应用名称、应用标识、开始结束时间和累计时长。不会保存窗口标题、网页、文件、剪贴板、键盘输入或屏幕内容。

不需要账号,没有广告、遥测或业务网络请求。工资、公积金、工作设置和软件使用记录只保存在当前 Mac。

完整边界请阅读 隐私说明。所有本机数据也可以在“设置 → 本机数据”中永久清除。

中国大陆法定节假日

新年度通知发布后,欢迎按照 贡献指南补充官方日历。

参与贡献

Bug 修复、界面改进、测试补充和新年度节假日数据都欢迎提交。开始前请阅读 贡献指南

涉及软件使用监测的改动必须继续遵守现有隐私边界。

获取帮助

发现计算异常、界面问题或有功能建议,请在 GitHub Issues 中提交,并尽量附上 macOS 版本、复现步骤和相关截图。

WageJar 由 LeoForgeLab 维护。

路线图

  • 官方公布后补充后续年度法定节假日与调休
  • 本地数据导出与备份
  • 更完整的无障碍与键盘操作
  • Developer ID 签名、公证和 GitHub Releases

说明与许可证

WageJar 是收入进度估算工具,不是工资结算、税务、考勤或法律工具。奖金、请假、加班、个税和公司特殊制度需要按实际情况另行处理。

代码以 MIT License 开源。仓库中的原创图标和插画也按 MIT License 提供;素材为项目创作与 AI 辅助生成,不包含第三方品牌素材。

About

一款 macOS 菜单栏今日工资进度工具,实时计算今日工作到此刻已经积累了多少工资,并记录本月收入、下班倒计时

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages