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 时需遵循谷歌平台的安全建议。

核心功能

vehicle-tracker 是一款面向车主的多语言费用管理工具，专注于解决油费、保养、维修、配件等支出的系统化记录需求。其设计亮点在于双轨数据架构：既可通过 Google Sheets API 实现多设备云端同步，也可在零配置情况下退化为本地 Excel 存储，兼顾便利性与隐私偏好。

工具支持公制/英制单位自动换算（km/L ↔ mi/gal），内置繁体中文、英语、日语三种本地化方案。照片管理模块会自动为收据、维修单等影像添加时间戳并规范化命名，解决车主「随手拍后找不到」的痛点。别名系统允许用户用「camry」「car」等简称快速指代车辆，降低重复输入负担。

显著优点

• 零依赖部署：核心功能仅依赖 Python 标准库，Excel 支持通过可选的 openpyxl 实现，无第三方包污染风险
• dry-run 预览机制：所有写入操作前必须显式确认，防止误录数据
• 路径安全设计：文件操作严格限制于用户目录下的 ~/vehicle_tracker，采用 pathlib 规范化处理
• GDPR/CCPA 合规：仅收集功能必需的车辆数据，无追踪脚本或遥测上报

局限性与风险

作为 T3 级别个人开发者项目，存在以下客观限制：

1. 维护持续性风险：单一维护者（huchengtw）可能因个人原因中断更新，企业用户需评估替代方案
2. 功能边界：无自动汇率换算、无燃油效率趋势分析图表、无多用户权限管理
3. Google API 依赖：云端同步需用户自行配置 Service Account，对非技术用户门槛较高
4. 测试覆盖不足：安全扫描显示缺乏单元测试，边界条件（如异常大数值、特殊字符）可能引发未定义行为

适合人群

• 多车家庭需分账管理的精细型车主
• 自由职业者/网约车司机需保留完整用车成本凭证
• 偏好数据自主托管、对 SaaS 订阅敏感的隐私意识用户
• 具备基础 Python 环境配置能力的技术爱好者

安全等级说明

CLS 认证综合评分 85/A级，静态与动态分析均未发现高危威胁模式。唯一黄色预警来自「T3 来源」本身——建议用户通过 GitHub Watch 功能监控仓库更新，并在重大版本变更时重新审查代码差异。