核心用法
charger 是一个面向电动车用户的高级充电桩查询工具，基于 Google Places (New) API 获取实时充电数据。提供三种查询模式：
1. 收藏夹检查 — 预存常用地点，快速查询（charger check home）
2. 直接查询 — 通过地点 ID 或地址名称检索（charger check "Wien Energie Charging Station..."）
3. 附近搜索 — 指定经纬度与半径，发现周边可用桩（charger nearby --lat 48.18 --lng 16.34 --radius 2000）
智能通知机制
配套 charger-notify.sh 脚本实现状态变更触发的通知逻辑：
- 仅当充电桩从不可用/未知变为可用时 (
NO/UNKNOWN → YES) 才输出通知 - 利用
~/.cache/charger-notify/持久化状态，避免重复打扰 - 与 cron 配合可实现 Telegram 定时推送，推荐每 10 分钟轮询
显著优点
- 数据源权威：Google Places (New) EV 数据覆盖广、更新及时
- 低打扰设计：状态差分通知，只有"变成可用"时才提醒
- CLI 友好：纯命令行工具，易于集成自动化工作流
- 灵活部署：Node.js 18+ 环境即可运行，Clawdbot 原生支持
潜在局限
- 依赖 Google API：需自备
GOOGLE_PLACES_API_KEY，存在用量配额与费用风险 - 地理限制：Google Places EV 数据在某些区域覆盖不如本地服务商（如欧洲部分城市可能偏好 GoingElectric、ChargeMap 等）
- 状态精度：API 返回的"可用"为瞬时快照，实际到达时可能已被占用
- 无原生 UI：纯 CLI 工具，对非技术用户门槛较高
适合人群
- 技术型 EV 车主，习惯命令行与自动化脚本
- 需要低打扰、智能触发通知的用户（而非持续轰炸）
- 已将 Clawdbot 作为日常助手的现有用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | 需妥善保管 `GOOGLE_PLACES_API_KEY`，避免硬编码 |
| 地理位置隐私 | `nearby` 查询会上传精确坐标 |
| 数据时效性 | 充电桩状态变化快，存在"显示有实际无"的概率 |
| cron 频率过高 | 过于频繁的轮询可能触发 API 限流或产生费用 |