check charger availbility

核心用法

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 限流或产生费用 |

核心用法

charger 是一个基于 Google Places (New) EV 充电数据的高级查询技能，通过 Node.js CLI 工具实现充电桩可用性检查。核心工作流程包含三类操作：收藏夹管理（charger favorites add）、定向查询（charger check <placeId|名称>）以及附近搜索（charger nearby --lat --lng）。配套的智能通知脚本 charger-notify.sh 实现了状态变更驱动机制——仅当充电桩从不可用变为可用时触发 Telegram 通知，避免信息过载。

用户需配置 GOOGLE_PLACES_API_KEY 环境变量，将 CLI 加入 PATH 后即可使用。推荐通过 Clawdbot Gateway cron 设置定时任务（如每 10 分钟），配合通知脚本实现自动化监控。

显著优点

架构轻量可靠：代码仅 154 行，零外部依赖，无包管理风险。状态持久化采用简易文件存储（~/.cache/charger-notify/），逻辑透明可控。

通知机制精准：区别于传统轮询推送，采用"状态变更即通知"模式（NO/UNKNOWN → YES），大幅降低干扰，契合电动车车主"抢到充电桩"的核心痛点。

数据权威性高：依托 Google Places API，覆盖全球主要充电网络，POI 数据实时性强，地址与可用性状态可信度高。

部署灵活：既支持命令行交互式查询，也支持无人值守的自动化监控场景，兼容 cron 等标准调度工具。

潜在缺点与局限性

外部依赖耦合：核心功能依赖独立的 charger CLI 工具（Node.js），该组件未在技能包内，需用户自行安装并确保版本兼容。若 CLI 接口变更，通知脚本可能失效。

输入验证不足：charger-notify.sh 对 target 参数仅做简单字符替换，缺乏严格白名单校验，存在潜在路径遍历风险（虽受限于缓存目录权限，影响可控）。

功能边界有限：仅支持查询可用性状态，不支持预约、支付、导航深度集成，也无法预估充电时长或费用。

隐私与合规：依赖 Google Places API 需接受 Google 服务条款，位置查询数据可能被 Google 记录；用户需自行管理 API Key 的安全存储。

适合的目标群体

• 城市电动车主：常驻固定区域，需要监控常用充电点（住宅/公司附近）的实时空位
• 物流/运营车队管理者：需批量监控多个充电站点的可用性状态
• 开发者与极客用户：熟悉命令行与 cron，追求轻量可定制的自动化方案
• Telegram 重度用户：已通过 Clawdbot 生态获取服务的现有用户

使用风险

性能风险：依赖外部 CLI 调用而非原生 API，存在进程启动开销；高频轮询（<5分钟）可能触发 Google API 配额限制或产生额外费用。

依赖可用性：Google Places API 服务中断、API Key 失效或 CLI 工具异常均会导致监控失效，需建立备用查询机制。

状态同步延迟：Google 数据更新频率与现场实际情况可能存在分钟级偏差，紧急出行前建议人工复核。

权限与配置：需妥善保管 GOOGLE_PLACES_API_KEY，避免误提交至版本控制；缓存目录权限建议设为 600 以增强隐私保护。

维护连续性：作为个人开发者（T3）项目，长期更新承诺不明确，重大版本升级时需重新评估兼容性。