中国天气技能 (CN Weather)

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

✨ 特性：

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

🔐 安全配置说明

敏感信息存储位置

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

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

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

配置步骤

1. 编辑 TOOLS.md

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

2. 添加配置（参考示例）

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

3. 保存后自动加载

   • 脚本会自动从 TOOLS.md 读取配置
   • 无需修改技能文件

🚀 快速使用

方式 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

🌤️ 天气代码对照（完整版）

晴天

多云

雨

雪

雾/霾/沙尘

特殊

📊 API 对比

⚠️ 注意事项

安全提示

• ✅ 敏感信息已加密存储在 TOOLS.md
• ✅ 技能文件可安全分享（无密钥）
• ❌ 不要 将 TOOLS.md 提交到 Git
• ❌ 不要 在公开场合分享 API Key

Host 白名单配置

如果 API 返回 403 Invalid Host 错误：

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

自动降级机制

脚本会自动检测和風天气 API 是否可用：

• ✅ 可用 → 使用和風天气（数据更精准）
• ❌ 不可用 → 自动切换到 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