vehicle-tracker

Vehicle Expense Tracker 是一款专为车主设计的双模费用记录工具，支持通过命令行界面快速记录车辆相关的各类开支。该工具的核心用法围绕 tracker.py 脚本展开，用户可通过参数指定车辆别名、里程数、费用类别（如加油、维修、保养）、金额及照片附件。工具提供 --dry-run 预览模式，允许用户在正式写入数据前确认操作详情，确保数据准确性。数据存储支持两种模式：一是通过 Google Sheets API 直接写入云端表格，便于多设备同步与协作；二是在未配置云表格时自动回退至本地 Excel 文件，默认存储于用户主目录的 vehicle_tracker 文件夹中。

该工具的显著优点体现在国际化与灵活性设计上。首先，原生支持繁体中文、英文、日文三种语言界面，且可根据配置切换公制与英制单位，适应不同地区用户习惯。其次，照片管理功能可自动按时间戳重命名并归档相关票据或维修记录照片，实现费用凭证的数字化管理。别名系统允许用户为车辆设置简短代号（如 "camry"），大幅简化日常输入流程。此外，类别默认值功能可根据费用类型自动填充计量单位，减少重复输入。

然而，该工具也存在一定局限性。作为个人开发者维护的开源项目（T3 来源），其长期维护稳定性与代码审计深度不及企业级产品，建议金融机构或高安全要求场景谨慎使用。功能上，工具依赖外部 google-workspace skill 完成 Google 认证，增加了配置复杂度。同时，工具仅提供命令行界面，对非技术用户存在学习门槛，且需要 Python 运行环境及 openpyxl 等依赖库。

目标用户群体主要包括：注重养车成本分析的个人车主、需要管理多辆车的家庭用户、小型车队管理者，以及习惯使用电子表格进行数据分析的财务人员。对于希望将车辆维护历史与开支数据结构化存储，并可能需要与会计师或维修店共享记录的用户尤为适用。

使用风险方面，虽然代码层面已通过安全审计（无危险函数、无动态代码执行），但用户需注意：照片文件复制操作基于用户提供的文件路径，若路径指向系统敏感文件可能导致意外覆盖；Google Sheets 集成需要妥善保管服务账号凭证；本地 Excel 模式依赖文件系统权限，建议定期备份 ~/vehicle_tracker 目录以防数据丢失。此外，工具不进行网络传输加密处理，敏感财务数据存储于 Google Sheets 时需遵循谷歌平台的安全建议。