核心用法
kma-weather 是一款专为韩国地区设计的气象数据查询技能，通过调用韩国气象厅（KMA）官方开放API，为用户提供多维度、高精度的天气信息服务。该技能包含三大核心功能模块：
1. 精准预报系统：支持当前实况、超短期（6小时）、短期（3天）及中期（3-10天）四级预报体系，覆盖全韩17个行政区域。采用5公里网格坐标转换技术，定位精度远超城市级通用天气服务。
2. 气象特报预警：实时获取韩国气象厅发布的官方预警信息（기상특보），包括干旱警报、风浪预警、强风预备特报等灾害性天气通知，支持全国范围批量查询。
3. 灵活输出格式：提供友好的韩文格式化输出（含天气emoji）及原始JSON数据两种模式，便于终端查看或二次开发集成。
典型使用场景包括：旅行规划时查询目的地详细天气、农业生产参考中期趋势、户外活动前确认预警状态等。
显著优点
官方权威数据源：直接对接韩国政府公共数据平台（data.go.kr），数据更新频率达每小时级别（短期预报每日8次发布），信息时效性和准确性有保障。
极致安全架构：采用纯Python标准库实现（urllib、json、argparse、datetime），零第三方依赖，彻底规避供应链攻击风险。代码开源透明，可完整审计。
精细化空间分辨率：5公里网格定位系统（对比通用天气API的城市级精度），适合韩国地形复杂、微气候差异显著的特点，首尔江南与江北可能呈现不同预报结果。
完善的韩文本地化：输出界面完全韩文化，包括天气现象描述、风向表达、预警术语等，符合韩国用户阅读习惯，也便于在韩外国用户对照理解。
环境变量密钥管理：API密钥通过KMA_SERVICE_KEY环境变量注入，无硬编码风险，支持多环境（Sandbox/Host）灵活配置。
潜在缺点与局限性
地理范围受限：仅覆盖韩国全境（含济州岛、郁陵岛·独岛等离岛），无法服务全球其他区域。如需跨国场景需配合通用weather技能使用。
API密钥门槛：必须注册韩国公共数据门户账户并申请三个独立API的访问权限，对外国用户或韩语非熟练者存在一定上手门槛。
网络稳定性依赖：所有数据实时拉取自韩国政府服务器，未设计本地缓存机制。若遇SERVICE_TIMEOUT_ERROR需用户手动重试，暂不支持自动重试回退。
功能单一性：专注于数据查询与展示，未内置智能分析功能（如穿衣建议、出行提示生成），需用户自行解读气象数据。
时区固定：全部时间戳基于韩国标准时（KST，UTC+9），未提供时区转换选项，跨国协作场景需注意时间换算。
适合的目标群体
- 在韩居住/工作者：需要比手机天气App更专业的网格级预报，关注特定区域微气候
- 赴韩旅行者：提前规划行程，特别是登山、海岛、滑雪等天气敏感活动
- 农业/渔业从业者：依赖中期预报安排播种、收获或出海作业
- 韩语学习者：通过真实气象数据接触专业术语（특보、예보、실황等）
- 数据分析师：需要标准化JSON格式的韩国历史天气数据用于研究
- 应急响应人员：快速获取全国气象预警分布，辅助灾害评估
常规使用风险
性能风险：单次查询需发起1-3次HTTP请求（当前+预报+网格转换），网络延迟可能达1-3秒。批量区域查询建议采用异步策略或限制并发。
API配额限制：韩国公共数据门户对免费账户设有调用频次上限，高频应用需关注配额消耗，必要时申请商用权限。
密钥泄露风险：环境变量配置不当（如误提交至Git仓库）可能导致API密钥泄露。建议配合.gitignore及密钥扫描工具使用。
数据更新延迟：气象实况数据存在约40分钟观测延迟（每小时:40发布），极端天气快速变化场景下信息可能滞后。
服务可用性依赖：韩国政府API服务可能因维护或网络故障临时中断，生产环境使用建议增加降级方案（如切换至备用天气源）。