什么是Paycheck
Paycheck 是一款专为工资计算与记录设计的轻量级命令行工具，旨在帮助用户高效管理个人或企业薪资数据。该工具通过简洁的命令行接口，支持对工资明细、扣除项分析、薪酬对比等多种财务操作进行结构化记录和追踪。所有数据均本地存储于 `~/.local/share/paycheck/` 目录下，无需网络连接或外部依赖，确保隐私与安全。
Paycheck v2.0.0 提供了超过十二种核心命令，涵盖从基础工资录入到复杂薪酬结构分析的各个环节。无论是记录单次薪资发放结果，还是系统性地比较不同职位的待遇方案，用户都可以通过标准化的日志格式快速归档关键信息。每条记录均包含精确的时间戳，便于后续回溯审计或生成报告。
除了基本的记录功能外，Paycheck 还支持全文搜索、统计数据汇总以及多格式导出（JSON/CSV/TXT），使其不仅适用于日常薪资跟踪，也能满足向第三方系统提交数据的需求。其设计哲学强调轻量化与自动化，适合程序员、HR 人员或任何需要频繁处理薪酬信息的个体使用。
核心功能特点
- 支持十二类工资相关操作记录：run（薪资计算）、check（支票发放）、compare（薪酬对比）等
- 本地文件存储，无网络依赖，保障数据隐私安全
- 提供 stats 命令统计各分类条目数量及磁盘占用情况
- 内置全文搜索功能，可跨日志快速检索关键词
- 支持将历史记录导出为 JSON、CSV 或 TXT 格式
- 统一 history.log 实现全操作轨迹的可视化追溯
适用场景
Paycheck 特别适合需要长期维护薪资档案的用户场景。例如，自由职业者可以定期运行 `paycheck run` 命令，记录每次项目结算后的实际到账金额与税费构成，形成完整的收入流水账本。对于正在求职的职场人士，则可通过 `paycheck compare` 功能，将多个 Offer 的 base salary、奖金结构、福利补贴等进行横向对比，辅助做出最优选择。
在企业内部 payroll 管理中，Paycheck 同样具备实用价值。人力资源部门可利用其分析模块（analyze）详细拆解社保公积金、个税预扣等扣除项占比，并生成周期性报告供管理层审阅。而通过批量导出功能，还能轻松对接财务软件或 Excel 表格，提升数据处理效率。
此外，开发者或技术管理者也可借助 Paycheck 构建自动化脚本体系——比如结合 cron 定时执行 paycheck stats 获取团队薪酬变动摘要，或通过 grep 提取特定关键词（如 ‘bonus’）快速定位奖励发放记录。这种高度定制化的能力，让 Paycheck 超越了普通记账工具的范畴，成为专业级薪酬管理工具链中的重要一环。