核心功能与用法
Weather Query 是一款专为中国地区设计的气象数据查询工具，通过 Shell 脚本封装实现实时天气与预报数据的标准化获取。
主要能力
- 实时天气查询：当前温度、湿度、风力、空气质量指数（AQI）、天气预警及生活指数（穿衣、洗车、运动等）
- 预报服务：逐小时预报与最多 8 天逐日预报，含日出日落时间
- 多格式输出：
text（极简省 Token）、markdown（结构化默认）、json（完整原始数据） - 智能定位：支持省、市、区县三级中文地名（如
北京、浦东新区、雨花台）
使用示例
# 实时天气（默认 markdown 格式） ./scripts/realtime.sh 杭州 # 极简文本输出 ./scripts/realtime.sh 成都 --encoding text # 8 天预报 JSON 完整数据 ./scripts/forecast.sh 深圳 --encoding json --days 8
显著优点
1. Token 效率优化：三级编码策略精准控制输出长度，避免大模型上下文浪费
2. 本土化适配：针对中国行政区划设计，理解朝阳区与北京的层级关系
3. 场景化建议：内置最佳实践，可基于天气自动衍生出行提示（雨具、穿衣、口罩建议）
4. 故障降级：区县查询失败时自动建议市级名称重试
局限性与潜在风险
- 地理范围受限：仅覆盖中国境内，海外城市不支持
- 数据源依赖：未披露具体数据提供商，时效性与准确性依赖上游 API
- 输入敏感：必须使用中文地名，英文或拼音可能识别失败
- 无历史数据：仅支持当前及未来预报，无法查询过去天气
适合人群
- 需要为中国用户提供天气服务的 AI 应用开发者
- 构建出行、户外活动、健康管理场景的 Agent 系统
- 对中文地理信息有精确要求的自动化工作流
安全与可信度评估
- 数据敏感性：仅查询公开气象数据，不处理用户隐私信息
- 执行风险：Shell 脚本执行需关注路径注入，但参数经
query字段转义，风险可控 - 供应链：脚本调用外部 API，建议生产环境配置超时与熔断机制