名称： charger
描述： 通过 Google Places 查询电动汽车充电桩可用性（收藏夹、附近搜索）。
元数据：
clawdbot:
config:
requiredEnv:
- GOOGLE_PLACES_API_KEY
stateDirs:
- config
- .cache

charger

基于 Google Places（新版）电动汽车充电数据构建的高级充电桩检查工具。

此技能包含一个 bin/charger CLI（Node.js）程序，用于检查充电桩可用性。

安装设置

• 要求：
• Node.js 18+（Clawdbot 已包含 Node）

• GOOGLE_PLACES_API_KEY（建议在 ~/.clawdbot/.env 中配置）

• 将 CLI 添加到 PATH（示例）：

• ln -sf "$(pwd)"/bin/charger /home/claw/clawd/bin/charger

• 添加收藏地点：

• charger favorites add home --place-id <placeId>

命令

• 检查收藏夹/地点 ID/查询：
• charger check home

• charger check "Wien Energie Charging Station Liniengasse 2 1060 Wien"

• 查找附近充电桩：

• charger nearby --lat 48.188472 --lng 16.348854 --radius 2000 --max 10

通知机制

推荐的工作流程：

1) charger（本技能）生成清晰的 Any free: YES|NO 结果。
2) 定时任务（Gateway cron）运行一个小型辅助脚本，仅在需要通知时输出内容。

辅助脚本（实际决定是否通知）

本包包含 scripts/charger-notify.sh。

功能说明：
- 运行 charger check <目标>
- 如果结果为 Any free: YES 且 上次运行结果不是 YES，则输出一行通知信息。
- 否则不输出任何内容。

因此：无输出 = 无通知。

状态管理：
- 将上次状态存储在 ~/.cache/charger-notify/<目标>.state 中，确保仅在状态从 NO/UNKNOWN 变为 YES 时通知。

用法：
- bash scripts/charger-notify.sh home

通知输出示例：
- EV charger available: Tanke Wien Energie Charging Station — Amtshausgasse 9, 1050 Wien, Austria — 1/2 available (OOS 0) (updated 2026-01-21T21:05:00Z)

典型 cron 计划（实际接收 Telegram 通知的方式）

Cron 作为调度器，定时运行辅助脚本并发送脚本输出的内容。
由于辅助脚本仅在充电桩变为可用时输出，因此您只会在关键时刻收到消息。

每 10 分钟检查一次：
- */10 * * * *

如需将此功能接入 Clawdbot Gateway cron（以便接收 Telegram 通知），请告知：
- 目标名称（如 home）
- 检查间隔（每 5/10/20 分钟）
- 静默时段（可选）