介绍
# charger
基于 Google Places (New) EV 充电数据构建的高级 EV 充电器检查工具。
该技能包含一个用于检查充电器可用性的 `bin/charger` CLI (Node.js)。
## 设置
- Requirements: - 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 <target>` - 如果 `Any free: YES` **且** 上次运行结果不是 `YES`，则打印一行通知内容。 - 否则它 **不输出任何内容**。
因此：**无输出 = 无通知**。
状态： - 将上次状态存储在 `~/.cache/charger-notify/<target>.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 分钟) - 免打扰时间 (可选)