tencent-weather

天气信息查询工具，覆盖中国市级和区县级行政区。当用户查询实况天气、天气预报信息时使用。

Security Scan

The skill's behavior mostly matches a Tencent weather wrapper, but it instructs or references a remote curl|sh installer and includes runtime scripts that will execute an external CLI — the install mechanism and some small mismatches merit caution.

Purpose & Capability

The skill is a thin wrapper around a tencent-news-cli to fetch weather for Chinese administrative regions; requiring/using that CLI is coherent with the stated purpose.

Instruction Scope

SKILL.md confines runtime actions to detecting/using the CLI (help weather, weather commands, apikey-get/set), requires parsing CLI output, and explicitly forbids fallback to other web searches or auto-opening browsers.

Install Mechanism

Installation guidance and update guides instruct users to run remote installer commands that pipe shell scripts from https://mat1.gtimg.com (curl | sh and irm | iex). While this is a vendor CDN (Tencent), piping remote scripts to a shell is a high-risk install pattern and should be verified before running. There is no registry-level install spec; the skill ships helper scripts that expect a separately-downloaded CLI.

Credentials

The skill does not declare required env vars, which is consistent with its model (the CLI manages API key storage). The code/scripts call the CLI's apikey-get to check whether an API key is configured; this is reasonable, but the skill will rely on whatever API key the CLI is configured with — the registry does not declare or request that credential explicitly.

Persistence & Privilege

always is false, no system-wide config modifications are requested by the skill itself, and the skill does not request to modify other skills or agent settings. Runtime scripts execute the external CLI from user paths only.

What to consider before installing

This skill wraps a Tencent CLI to provide weather data and is internally consistent, but take these precautions before installing/using it: - Do NOT blindly run the curl | sh or irm | iex install commands; fetch and review the install script (or download from a verifiable release) before executing. Piping remote scripts to a shell is high risk even when hosted on a corporate CDN. - Verify the download host and checksum/signature of any downloaded CLI binary if possible. - The helper scripts will execute whatever tencent-news-cli is present on your system. Only install a CLI you trust; the CLI can run arbitrary commands and could exfiltrate data if malicious. - The skill checks the CLI for an API key via apikey-get; the skill itself does not request credentials but will use whichever key the CLI holds. Keep sensitive credentials in a secure location and be deliberate when configuring the CLI. - On Windows the TypeScript helpers expect Bun; the registry metadata did not declare this dependency — ensure required runtimes are present and inspect scripts before running them. If you want higher assurance, run the installer and CLI in a sandboxed/test environment first or request the upstream CLI source and verify its contents and signatures.

腾讯天气查询

通过 tencent-news-cli 的天气能力完成天气查询。

核心原则：基础设施交给脚本处理；智能体只负责依据当前 CLI 能力选择命令和参数。除 cli-state 外，所有 CLI 调用都通过 run-cli 执行；始终先读 help weather，不要硬编码任何业务命令。

平台约定

平台	脚本运行方式	示例
macOS / Linux	sh scripts/<name>.sh	sh scripts/cli-state.sh
Windows	bun scripts/<name>.ts	bun scripts/cli-state.ts

Windows 需先确保 bun 可用。若不可用：powershell -c "irm bun.sh/install.ps1 | iex"，安装后重启终端确认 bun --version。

以下所有脚本调用均以 macOS / Linux 为例，Windows 将 .sh 替换为 .ts，sh 替换为 bun。

除 cli-state 外，所有 CLI 命令都通过 run-cli 脚本执行：

平台	CLI 调用模板
macOS / Linux	sh scripts/run-cli.sh <command> [args]
Windows	bun scripts/run-cli.ts <command> [args]

Phase 1：环境就绪

环境已就绪时直接跳到 Phase 2。

1. 状态检查

sh scripts/cli-state.sh

解析返回的 JSON，关注以下字段：

字段	含义
platform.cliPath	底层实际使用的 CLI 完整路径，供诊断错误或权限问题时参考
platform.cliSource	global（优先命中 PATH 中可用的全局命令，否则命中默认全局安装目录）/ local（旧版 skill 目录内安装，兼容兜底）/ none（以上路径都未找到）
cliExists	CLI 是否存在
update.needUpdate	当前版本是否需要更新
update.error	version 检查失败时的错误信息
apiKey.present	API Key 是否已配置
apiKey.status	configured / missing / error
apiKey.error	apikey-get 执行异常或输出异常时的错误信息

2. 安装 CLI（cliExists 为 false 时）

仅当 cliSource 为 none 时才需要安装；local 表示命中了旧版本地安装，可继续使用但建议后续迁移到全局安装。

按照 references/installation-guide.md 中的安装命令执行安装。

安装成功后重新执行 sh scripts/cli-state.sh（Windows 用 bun scripts/cli-state.ts）刷新状态。

若安装失败，参考 references/installation-guide.md 中的故障排查部分，引导用户手动处理。

3. 更新 CLI（update.needUpdate 为 true，或 CLI 提示版本过旧时）

sh scripts/run-cli.sh update

Windows 使用 bun scripts/run-cli.ts update。

若 update.error 不为空，先展示错误并让用户处理。

若 update 命令失败，或错误信息表明当前 CLI 不支持 update（如 unknown command、not found、not recognized），按上述步骤 2 重新安装。仍然失败时，引导用户参考 references/update-guide.md 手动处理。

4. 配置 API Key（apiKey.status 不为 configured 时）

• missing → 引导用户打开 API Key 获取页面 自行获取，不要执行 open / xdg-open / start 等命令自动打开浏览器
• error → 展示 apiKey.error，让用户先处理（权限、网络、CLI 异常），处理后重试

设置 Key（通过 run-cli 执行，KEY 是裸值不加引号）：

sh scripts/run-cli.sh apikey-set KEY

Windows 分别使用 bun scripts/run-cli.ts apikey-set KEY、bun scripts/run-cli.ts apikey-get、bun scripts/run-cli.ts apikey-clear。

验证：sh scripts/run-cli.sh apikey-get 清除（仅用户明确要求时）：sh scripts/run-cli.sh apikey-clear

详见 references/env-setup-guide.md。

Phase 2：天气查询

天气相关命令可能随 CLI 版本变化。始终以当前 help weather 输出为准，不要假设或记忆任何业务命令。

1. 先执行 help weather 通过 run-cli 执行：macOS / Linux 为 sh scripts/run-cli.sh help weather，Windows 为 bun scripts/run-cli.ts help weather。

2. 根据 help weather 选择命令

   • 实时天气 → 优先选择帮助中用于查询当前天气的命令
   • 未来天气 / 逐小时 / 多天预报 → 优先选择帮助中包含时间范围、预报或趋势信息的命令
   • 复合请求（如“看看北京今天和明天的天气，再说下会不会下雨”）→ 尽量映射到一个命令；若帮助中没有单条命令覆盖，再拆成多个天气请求依次执行
   • 地点缺失 → 先结合上下文判断用户是否已经给出城市/区县；无法确定时再请用户补充地点
   • 地点参数一律使用 Adcode → 若用户给的是地点名称，先转换成对应的 Adcode 再执行天气命令，不要直接传中文地名；例如“北京”使用 110000
   • 时间缺失 → 默认理解为“当前/今天”；若帮助中的命令要求显式日期参数，再按帮助要求补足默认值
   • 若 help weather 中无匹配命令，如实告知用户当前 CLI 不支持该天气场景

3. 执行命令时遵守四条约束

   • 所有实际 CLI 调用都走 run-cli 脚本，不要直接执行 platform.cliPath
   • 业务命令、参数名、参数顺序都以 help weather 展示为准，必要时照抄帮助中的示例
   • 地点相关参数优先传 Adcode；若用户只给了地名，先换成对应的 Adcode 再调用，例如北京 → 110000
   • 不要自行猜测 weather 子命令下的参数缩写或默认值；按帮助输出里的完整用法组装

4. 输出结果

   • 若 CLI 返回的内容已经是格式完善的 markdown 或可直接阅读的文本，原样输出
   • 若 CLI 返回结构化字段，再整理成用户可读结果，至少包含地点、天气现象、温度，以及 CLI 返回的其他关键字段（如降水、风力、空气质量、湿度、体感、预警）

输出格式

优先遵循 CLI 的原始输出形式：

• CLI 已返回完整 markdown / 文本时，直接原样输出，不要改写
• CLI 返回结构化结果时，按下面格式整理

**地点**：深圳
**时间**：今天
**天气**：多云
**温度**：26°C

- 降水：10%
- 风力：东北风 3 级
- 空气质量：优

**来源：腾讯天气**

通用规则：

• 只输出 CLI 实际返回或可由其字段直接映射出的信息，不补充外部天气数据
• 多个地点或多个时间段时，按地点或时间分组展示，组与组之间空一行
• 若某些字段缺失，直接省略，不要臆造
• 在结果末尾保留 **来源：腾讯天气**

CLI 执行失败处理

CLI 命令失败后，立即停止，绝不通过 WebSearch 或其他方式自行补做天气查询。

1. CLI 返回非零退出码、超时或输出含权限/安全错误时，不要重试，不要换方式。
2. 根据错误信息引导用户：
   • macOS Gatekeeper（cannot be opened、not verified）→ 系统设置 → 隐私与安全性 → 「仍要打开」
   • 企业安全软件（connection refused、防火墙拦截）→ 安全提示中点击「信任」/「允许」
   • 权限不足（permission denied）→ chmod +x <cliPath>
   • 其他 → 展示完整错误，请用户处理
3. 用户确认操作完成后再重试。即使多次失败，也只能告知当前无法完成天气查询并说明原因，绝不回退到其他信息源。

References

• 用户手动安装指南：references/installation-guide.md
• 用户手动更新指南：references/update-guide.md
• API Key 获取与手动配置：references/env-setup-guide.md