彩云天气 / Caiyun Weather

核心用法

caiyun-weather 技能通过彩云天气 API 提供全维度气象数据查询。用户可直接使用中文城市名（如"北京""上海"）发起查询，无需手动输入经纬度。技能覆盖六大核心场景：实时天气状况、72小时逐小时预报、7天趋势预报、24小时历史天气回顾、空气质量（AQI/PM2.5）监测，以及气象灾害预警信息。

技术实现上，脚本基于 Python 标准库编写，零依赖安装，内置 40+ 中国主要城市坐标实现毫秒级响应，其他城市自动调用 OpenStreetMap 地理编码服务。执行时需配置 CAIYUN_WEATHER_API_TOKEN 环境变量，免费申请即可使用。

显著优点

• 本土化精度高：彩云天气以分钟级降水预报著称，中国地区数据准确度显著优于国际通用API
• 交互零门槛：中文城市名直查，符合国内用户直觉，无需理解坐标系统
• 功能覆盖全：从实时到历史、从气温到空气质量、从预报到预警，形成完整决策链条
• 部署轻量化：纯标准库实现，无需 pip 依赖，兼容各类受限环境

潜在局限

• 地理覆盖偏置：对中国以外地区的数据精度与更新频率相对薄弱
• API 配额限制：免费套餐存在调用频率上限，高并发场景可能触发限流
• 数据源单一：完全依赖彩云天气 API，无多源交叉验证机制
• 历史数据浅层：仅支持过去24小时回顾，无法满足气候分析需求

适合人群

日常出行规划者、户外活动爱好者、对空气质量敏感人群、需要快速天气决策的商务人士，以及构建本地化智能助理的开发者。

常规风险

API Token 管理不善可能导致配额被盗用；地理编码服务异常时非内置城市可能解析失败；极端天气下预警信息存在分钟级延迟，不应作为紧急避险唯一依据。

核心用法

彩云天气 Skill 是一个轻量级天气查询工具，基于 Python 标准库开发，无需额外安装依赖包。用户只需配置 CAIYUN_WEATHER_API_TOKEN 环境变量，即可通过城市名称（中英文）查询实时天气、72小时逐小时预报、7天天气预报、过去24小时历史数据以及天气预警信息。

使用方式简洁直观：--city 参数支持北京、上海、深圳等中文城市名直接查询，内置40+国内主要城市即时解析；其他城市及全球城市通过 OpenStreetMap 在线地理编码自动解析。如需精确定位，可改用 --lng 和 --lat 坐标参数。

显著优点

• 零依赖安全：仅使用 Python 标准库（urllib、json、os 等），彻底规避第三方依赖包的供应链攻击风险
• 凭证管理规范：API Token 强制从环境变量读取，无硬编码密钥风险
• 网络传输安全：全部使用 HTTPS TLS 1.2+ 加密，仅访问彩云天气和 OpenStreetMap 官方 API
• 中文原生友好：支持中文城市名直接查询，内置常见城市无需网络解析
• 功能覆盖全面：实时天气、逐小时/逐日预报、历史数据、空气质量、天气预警一应俱全

潜在局限

• 来源可信度 T3：作者为个人开发者（tjefferson），无组织级背书，长期维护稳定性需持续关注
• API 依赖限制：依赖彩云天气 API 可用性及免费版频率限制，高并发场景可能受限
• 数据外传范围：城市名称和坐标需发送至彩云天气及 OpenStreetMap，敏感位置查询需注意
• 离线不可用：完全依赖网络，无法在无网络环境使用

适合人群

• 日常需要快速查询天气的普通用户
• 对供应链安全敏感、希望最小化依赖的技术用户
• 中文环境下的天气自动化工作流开发者
• 轻量级天气数据集成场景

常规风险

• 免费 API 有调用频率限制，需合理控制查询频次
• T3 级别来源建议定期审查更新后再升级
• 需确保 API Token 环境变量配置正确，避免日志泄露