用途：pvgis-pp-cli 是访问 JRC PVGIS 服务的只读命令行工具，供智能体或数据管道获取太阳能发电量估算，无需订阅商业 API。适合多候选站点、重复参数扫描，或向下游（PVSyst、SAM、自定义模型）输出干净 JSON/CSV。
安装（必做，先验证）：npx -y @mvanhorn/printing-press-library install pvgis --cli-only，然后 pvgis-pp-cli --version。若 npx 失败可回退：go install github.com/mvanhorn/printing-press-library/library/other/pvgis/cmd/pvgis-pp-cli@latest（需 Go 1.26.6+）。若报 command not found，说明运行环境 PATH 未包含二进制目录，验证成功前不要继续。
主要能力：horizon 返回 49 方位角地形地平线；production 提供固定安装的月度汇总与逐时序列（hourly/monthly，另有 optimal-tilt）；radiation 返回水平/倾斜/最优倾角月度辐照；weather 返回 8760 小时 TMY 数据（weather tmy 可输出 CSV）。本地状态命令：sites rank 按年发电量对候选站点排序、sites diff 对比基线/目标站点、production sweep 生成倾角×方位角二维网格并缓存插值、production compare 跨 SARAH3、NSRDB、ERA5 数据库比较、weather similar 按气候相似度排名 TMY。
用法：所有命令可加 --agent（等于 --json --compact --no-input --no-color --yes）。支持 --select 过滤字段、--dry-run 预览、--deliver file:/webhook: 输出、profile 保存参数、which 自然语言找命令。读取结果解析 .results，.meta.source 区分 live/local。无需鉴权，可用 pvgis-pp-cli doctor 自检。限制：仅只读，不得用于创建、更新、删除、发布、下单、发消息等改变远端状态的操作；上游数据库覆盖范围不同（如 SARAH3 可能不覆盖某些经度）。