charger

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）。