名称： pvpc-spain
描述： 查询并优化西班牙 PVPC 电价（适用于家庭用户的 2.0TD 分时电价）。当你需要时使用：(1) 带上下文（相对于当日的高/中/低）的当前电价，(2) 根据时间识别峰/平/谷时段，(3) 找出当日最便宜的小时，(4) 优化家电（洗衣机、洗碗机、烘干机等）使用时间以最小化电费。

PVPC 西班牙电价助手

用于查询西班牙 PVPC（自愿小型消费者电价）并优化用电的技能。所有数据均来自 ESIOS（西班牙电网公司）的公开 API，针对 2.0TD 分时电价。

可用查询

1. 带上下文的当前电价

根据当日价格百分位数，显示当前电价，并分类为高/中/低。

# 完整当前电价
python scripts/get_pvpc.py --now

# 详细分类
python scripts/precio_referencia.py --now

响应包括：
- 当前电价 (€/kWh)
- 当日最低价和最高价
- 分类：低 (<30%分位数), 中 (30-70%分位数), 高 (>70%分位数)
- 相对于当日平均价格的偏差

2. 分时电价时段（谷/平/峰）

根据 2.0TD 电价规则，识别当前时段，并考虑星期几进行调整。

# 当前时段
python scripts/tarifa_periodos.py --now

# 查看所有时段
python scripts/tarifa_periodos.py --all

2.0TD 时段划分：
- 谷时段 🌙: 00:00-08:00 (每天) + 周六/周日全天
- 平时段 ⚡: 08:00-10:00, 14:00-18:00, 22:00-00:00 (周一至周五)
- 峰时段 🔴: 10:00-14:00, 18:00-22:00 (周一至周五)

注意： 对于 2.0TD 电价，冬令时和夏令时的时段划分相同。

3. 当日最便宜时段

找出当日价格低于 30% 分位数的连续小时区间。

# 便宜时段区间（默认使用 30% 分位数）
python scripts/find_cheap_ranges.py

# 调整分位数
python scripts/find_cheap_ranges.py --percentile 40

响应包括：
- 价格较低的连续 2 小时以上区间
- 每个区间的最低/最高/平均价格
- 相对于当日平均价格的节省百分比
- 按区间时长排序（最长的区间优先）

4. 优化家电使用时间

找出总成本最低的连续 N 小时窗口，用于运行家电。

# 洗衣机（默认 2 小时）
python scripts/optimize_appliance.py --duration 2 --name lavadora

# 洗碗机（3 小时）
python scripts/optimize_appliance.py --duration 3 --name lavavajillas

# 烘干机（1.5 小时）
python scripts/optimize_appliance.py --duration 2 --name secadora

响应包括：
- 最佳开始和结束时间
- 整个周期的总成本 (€)
- 每小时价格明细
- 与在平均电价时段使用相比的节省
- 最多 2 个成本差异 <10% 的备选方案

JSON 输出

所有脚本都支持 --json 参数，便于程序集成：

python scripts/get_pvpc.py --json
python scripts/find_cheap_ranges.py --json
python scripts/optimize_appliance.py --duration 3 --json

代理使用示例

用户： "现在电价多少钱？"

python scripts/get_pvpc.py --now
python scripts/precio_referencia.py --now

用户： "今天什么时候电最便宜？"

python scripts/find_cheap_ranges.py

用户： "我什么时候开洗衣机？"

python scripts/optimize_appliance.py --duration 2 --name lavadora

用户： "现在是谷时段吗？"

python scripts/tarifa_periodos.py --now

用户： "我有个要运行 3 小时的洗碗机，什么时候开？"

python scripts/optimize_appliance.py --duration 3 --name lavavajillas

技术说明

• 数据来源： ESIOS（西班牙电网公司）公开 API
• 电价类型： PVPC 2.0TD（适用于功率 <10 kW 的家庭用户）
• 数据更新： 价格通常在每日 20:00 左右发布第二天的数据
• 价格构成： 包含所有费用项（能源、输配电费、税费等），单位为 €/kWh
• 无需认证： 使用公开端点，无需令牌

限制

• 历史数据不本地存储（每次查询都是实时获取）
• 高/中/低 分类仅相对于当日价格，而非历史数据
• 不自动检测国家法定假日（按工作日处理）
• 需要互联网连接以查询 API