charger

🔌 实时EV充电桩可用性监控

基于 Google Places API 的充电桩监控工具,支持收藏夹与附近搜索,智能追踪状态变化即时通知,助车主实时掌握充电站空闲。

收藏
3.6k
安装
1k
版本
v1.0.1
CLS 安全性认证2026-06-03
点击查看完整报告 >

使用说明

Charger 是一款专为电动汽车用户设计的充电桩可用性监控工具,基于 Google Places (New) API 构建,提供从实时查询到智能通知的完整解决方案。该技能通过 Node.js CLI 工具与 Bash 辅助脚本的无缝协作,帮助用户实时掌握周边充电设施的使用状态,有效缓解电动车主的"里程焦虑"。

核心用法

该技能提供三层核心功能:首先是收藏夹管理,用户可通过 charger favorites add 命令保存常用充电地点(如家庭、公司),后续通过 charger check <favorite> 快速查询;其次是地理搜索,利用 charger nearby 命令基于经纬度坐标搜索指定半径内的充电桩,支持灵活配置返回数量;最后是智能通知系统,通过配套的 charger-notify.sh 脚本与 Cron 定时任务结合,仅在充电桩从占用变为空闲时发送通知,避免信息骚扰。所有状态数据本地化存储于 ~/.cache/charger-notify/ 目录,确保隐私安全。

显著优点

1. 精准的状态追踪机制:不同于简单的定时提醒,该工具通过对比前后状态(YES/NO/UNKNOWN),仅在可用性发生变化时触发通知,大幅降低信息噪音。
2. 灵活的查询维度:既支持针对特定地点的精确查询(通过 Place ID),也支持基于地理位置的半径搜索,满足不同场景需求。

3. 轻量级架构:作为命令行工具,资源占用极低,适合长期运行在网关设备或服务器上;配合 Cron 可实现完全自动化的监控服务。

4. 安全的数据处理:所有操作均在本地完成,状态文件仅存储简单的可用性标记,不涉及敏感位置历史或用户行为数据的云端上传。

潜在缺点与局限性

1. 外部依赖较重:必须自行申请并配置 Google Places API 密钥,且 API 调用可能产生费用(尽管 Google 提供每月免费额度);同时需手动安装 Node.js 环境的 CLI 工具。
2. 技术门槛:需要一定的命令行操作能力和 Cron 配置经验,对非技术用户不够友好。

3. 数据准确性依赖 Google:充电桩实时状态完全依赖 Google Places 数据更新频率,可能存在延迟或不准确的情况,不适合作为唯一决策依据。

4. 地域限制:Google Places API 在某些地区的服务覆盖或数据质量可能参差不齐。

适合的目标群体

  • 拥有固定充电需求(如家庭、公司附近)且希望及时获知充电桩空闲状态的电动车主
  • 具备基础 Linux/Unix 命令行操作能力,能够配置环境变量和定时任务的技术用户
  • 已在使用 Clawdbot 生态,希望通过自动化工具优化充电体验的早期采用者
  • 需要监控多个充电站点(如车队管理、共享汽车运营)的中小型运营团队

使用风险与注意事项

1. API 配额与费用:高频监控(如每 5 分钟)可能快速消耗 Google Places API 的免费配额,建议合理设置检查间隔(推荐 10-30 分钟)。
2. 状态文件管理:长期运行会产生多个 .state 文件,需定期清理 ~/.cache/charger-notify/ 目录避免磁盘空间占用。

3. 网络稳定性:作为依赖外部 API 的工具,网络波动可能导致误报(UNKNOWN 状态),建议结合其他渠道交叉验证关键充电需求。

4. 环境变量安全GOOGLE_PLACES_API_KEY 应妥善保管,避免硬编码在脚本中或提交到版本控制,建议使用 ~/.clawdbot/.env 文件并设置适当权限(600)。

安全解读

核心用法

charger 是一款面向电动汽车车主的充电桩可用性查询技能,基于 Google Places (New) EV 充电数据构建。提供 CLI 工具与智能通知系统双模式:

  • 收藏夹管理charger favorites add home --place-id <id> 绑定常用充电点
  • 即时查询:支持收藏夹别名、Place ID 或自然语言地址(如 "Wien Energie Charging Station Liniengasse 2"
  • 附近搜索charger nearby --lat 48.188 --lng 16.349 --radius 2000 --max 10 按地理坐标检索
  • 智能通知charger-notify.sh 辅助脚本实现"状态变更触发"机制——仅当充电桩从不可用变为可用时推送 Telegram 消息,避免信息骚扰

显著优点

  • 零依赖风险:纯 Shell/Node.js 实现,无第三方依赖包,供应链攻击面极小
  • 安全编码规范:使用 set -euo pipefail,变量严格引用,无命令注入风险
  • 隐私合规:API 密钥通过环境变量注入,无硬编码敏感信息,符合 GDPR/CCPA
  • T2 可信来源:由 clawdbot 组织维护,GitHub 组织账号背书
  • 状态感知通知:基于 ~/.cache/charger-notify/ 的本地状态文件,实现边缘触发的精准通知

潜在局限

  • 区域限制:依赖 Google Places 覆盖范围,部分偏远地区数据可能不完整
  • API 成本:Google Places API 为付费服务,高频查询可能产生费用
  • 单点依赖:未实现多源数据聚合(如 OpenChargeMap 备用源)
  • 配置门槛:需手动申请 Google Places API Key 并完成 PATH 软链接配置
  • 通知延迟:Cron 最小粒度限制(建议 5-10 分钟),非实时推送

适合人群

  • 欧洲/北美地区 EV 车主,日常依赖固定通勤路线充电
  • 已将 Clawdbot Gateway 作为智能家居中枢的技术用户
  • 希望减少"桩满扑空"焦虑,偏好被动通知而非主动刷新的用户

常规风险

  • API 密钥泄露:若 ~/.clawdbot/.env 权限配置不当,存在本地文件读取风险
  • 缓存状态漂移:极端情况下 Google 数据更新延迟可能导致通知与实际可用性不符
  • Cron 任务堆积:若主机时间异常或脚本阻塞,可能造成通知重复或遗漏
  • 地理坐标误用--lat/--lng 参数缺乏范围校验,输入错误坐标将返回无意义结果

charger 内容

scripts文件夹
手动下载zip · 2.5 kB
charger-notify.shtext/x-shellscript
请选择文件