中国天气预报查询 (China Weather)

核心用法

weather-china 是一个专为中国用户设计的本地化天气预报工具，通过解析中国天气网（weather.com.cn）的公开数据，提供7天天气预报及生活指数服务。无需注册账号或申请API密钥，纯Python实现保证了轻量化和跨平台兼容性。

使用方法简洁直观：通过命令行执行 weather_cn.py 脚本，支持 query 模式输出格式化文本、json 模式输出结构化数据。城市名称支持自动搜索匹配，内置60+常见城市代码缓存，其他城市通过搜索接口动态获取。

显著优点

1. 零成本接入：无需API Key，无调用次数限制，适合个人开发者和小型项目
2. 数据丰富度高：除基础温湿度、风力外，提供6项生活指数（感冒、运动、过敏、穿衣、洗车、紫外线），实用性强
3. 中文原生优化：数据源、输出格式、城市名称均为中文，契合国内用户习惯
4. 轻量依赖：仅需Python3标准环境，无额外库依赖

潜在缺点与局限性

• 数据源稳定性：依赖中国天气网页面结构，若官网改版可能导致解析失效
• 网络地域限制：需要能够访问 www.weather.com.cn，部分海外或特殊网络环境可能受限
• 无历史数据：仅支持预报查询，不具备天气数据存档功能
• 更新延迟：页面数据同步存在延迟，极端天气预警可能不够及时

适合人群

• 需要快速集成天气功能的国内开发者
• 个人自动化工作流（如定时天气推送、出行提醒）
• 对英文API不熟悉的普通中文用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 数据准确性 | 中 | 依赖第三方网站，存在解析误差可能 |

| 服务可用性 | 中高 | 受目标网站可用性和反爬策略影响 |

| 隐私泄露 | 低 | 仅传输城市名称，无个人敏感信息 |

| 法律合规 | 低 | 公开数据抓取，但需关注网站ToS变更 |

核心用法

weather-china 是一款专为中国用户设计的天气查询技能，通过解析中国天气网（weather.com.cn）公开页面数据，提供 7 天天气预报及生活指数服务。用户可直接通过命令行调用 python3 skills/weather-china/lib/weather_cn.py query <城市名> 获取格式化的天气信息，或使用 json 子命令获取结构化数据便于二次处理。技能内置 60+ 常见城市代码实现快速查询，其他城市则通过自动搜索接口匹配城市代码，使用门槛极低。

该技能完全基于 Python 标准库（urllib、html.parser、json、re）实现，无需安装任何第三方依赖，也无需申请 API Key，部署便捷。支持的生活指数涵盖感冒、运动、过敏、穿衣、洗车、紫外线等实用维度，可直接响应"今天穿什么""出门带伞吗"等日常决策场景。

显著优点

• 零配置开箱即用：无需注册账号、申请密钥或配置环境变量，下载即可使用。
• 纯标准库实现：彻底规避供应链攻击风险，无第三方依赖包的版本冲突或恶意注入隐患。
• 数据权威可靠：直接对接中国天气网官方数据源，预报信息与国内主流天气 App 同源。
• 轻量化高性能：单文件 425 行代码，资源占用极低，适合在资源受限环境中部署。
• 输出灵活：同时支持人类友好的格式化文本和机器可读的 JSON 格式，便于集成。

潜在缺点与局限性

• 网络传输未加密：当前使用 HTTP 明文传输，存在被窃听或中间人攻击的潜在风险（虽天气数据不敏感）。
• 无服务可用性保障：依赖中国天气网的公开接口稳定性，若官方调整反爬策略或接口格式，可能导致解析失败。
• 输入验证薄弱：城市名称仅做简单 strip 处理，对特殊字符或注入攻击的防御不足。
• 缺乏缓存与重试机制：每次查询均实时请求外部接口，网络波动时体验下降，频繁调用也可能触发频率限制。
• 地理覆盖有限：仅支持中国境内城市，无法查询海外地区天气。

适合的目标群体

• 个人用户：需要快速获取本地天气、规划日常穿衣出行。
• 开发者/运维人员：希望在脚本或自动化工作流中集成轻量天气查询，避免引入复杂 SDK。
• IoT/边缘设备场景：资源受限环境下需要稳定、无依赖的天气数据源。
• 国内业务系统：需为中国用户提供本地化天气服务的 Web 应用或聊天机器人。

使用风险

• 网络依赖风险：必须能访问 www.weather.com.cn，企业内网或境外网络可能受限。
• 接口变更风险：页面解析逻辑依赖 HTML 结构，官方改版可能导致技能临时失效。
• 频率限制风险：大量并发请求可能被 weather.com.cn 限流或封禁 IP。
• 数据时效性：页面数据刷新频率由官方决定，极端天气场景下可能存在延迟。