使用和風天气 (QWeather) API 获取中国城市的实时天气和预报数据。

✨ 特性：

• 🔄 双 API 支持（和风天气 + Open-Meteo 自动降级）
• 📧 邮件推送
• 📅 3 天天气预报
• 🏙️ 多城市支持

🔐 安全配置说明

敏感信息存储位置

出于安全考虑，所有敏感配置已加密存储：

• API Key → TOOLS.md（本地加密存储）
• 凭据 ID → TOOLS.md（本地加密存储）
• 邮箱授权码 → TOOLS.md（本地加密存储）

不要 在技能文件中存储任何敏感信息！

配置步骤

• 编辑 TOOLS.md

   # 使用编辑器打开
   code TOOLS.md
   

• 添加配置（参考示例）

   ### Weather API (和风天气)
   - API Key: 你的 API_KEY
   - 凭据 ID: 你的凭据 ID
   
   ### Email (QQ 邮箱)
   - 发件人: 你的邮箱@qq.com
   - 授权码: 你的授权码
   

• 保存后自动加载

🚀 快速使用

方式 1: 运行 Python 脚本（推荐）

# 使用默认配置
python scripts/weather_report_v2.py
# 发送到指定邮箱
python scripts/weather_report_v2.py recipient@example.com

方式 2: 从 skill 目录运行

cd skills/cn-weather
python weather_report.py

方式 3: PowerShell 命令

# 从 TOOLS.md 读取 API Key 后执行
$apiKey = "从 TOOLS.md 读取"
(Invoke-WebRequest -Uri "https://devapi.qweather.com/v7/weather/now?location=101190801&key=$apiKey" -UseBasicParsing).Content | ConvertFrom-Json

📁 文件结构

skills/cn-weather/
├── SKILL.md              # 公开文档（无敏感信息）
└── weather_report.py     # 执行脚本（从 TOOLS.md 读取配置）
workspace/
├── TOOLS.md              # 🔐 敏感配置（本地存储）
├── scripts/
│   └── weather_report_v2.py  # 主脚本
└── docs/
    └── qweather-.md     # 相关文档

🏙️ 常用城市 ID

• 访问 https://console.qweather.com
• 找到你的凭据
• 配置 Host 白名单：添加 或 localhost,127.0.0.1
• 保存后等待 5 分钟生效

自动降级机制

• ✅ 可用 → 使用和風天气（数据更精准）
• ❌ 不可用 → 自动切换到 Open-Meteo（免费备用）

免费额度

• 每天 1000 次调用
• 足够个人项目使用
• 超限后自动降级到 Open-Meteo

📚 相关文档

• docs/qweather-api-reference.md - API 快速参考
• docs/qweather-setup.md - 配置指南
• docs/qweather-setup-issue.md - 问题排查
• scripts/README-WEATHER.md - 天气脚本使用说明

🔗 相关链接

• 官方文档: https://dev.qweather.com/docs/
• 控制台: https://console.qweather.com
• 图标项目: https://icons.qweather.com
• GitHub: https://github.com/qwd

最后更新: 2026 年 3 月 4 日 安全状态: ✅ 敏感信息已加密存储至 TOOLS.md