#tencent #briefings #headlines #news-rankings

tencent-news

腾讯新闻综合信息服务工具，支持新闻搜索与热榜/早晚报/订阅引导、腾讯较真事实查证、全国市县天气与天气预警查询，以及中国普通高考常规批次的一分一段、省控线、院校专业录取数据和院校优先/专业优先冲稳保志愿方案。当用户需要新闻资讯、判断信息真假、查询天气或异常天气、了解高考录取数据或规划志愿时使用。

TencentNewsTeam@tencentnewsteam

Install

openclaw skills install @tencentnewsteam/tencent-news

腾讯新闻综合信息服务

通过 tencent-news-cli 提供新闻、事实查证、天气、天气预警和高考志愿填报能力。

核心原则：基础设施交给脚本处理；智能体负责识别意图，并按当前 CLI 帮助选择命令和参数。除 cli-state 外，所有 CLI 调用都通过 run-cli 执行。先读帮助，不硬编码业务命令、参数或返回字段，也不使用其他数据源替代 CLI。

能力路由

先识别用户意图，再完整读取对应能力说明。不要为单一意图加载无关说明；复合请求涉及多个能力时，读取全部相关说明并分别执行。

用户意图	必读说明
新闻搜索、热点、榜单、早报晚报、实时或领域资讯、新闻反馈	本文件的「新闻能力」
判断说法真假、识别谣言、核查文章/聊天记录/截图中的事实命题	`references/factcheck.md`
实况天气、天气预报、生活指数、降水、温度、空气质量、限行	`references/weather.md`
专门查询天气预警、异常天气、雨雪、雾霾、寒潮、高温或台风	`references/weather-alert.md`
一分一段、省控线、院校/专业录取数据、选科限制、院校优先/专业优先冲稳保志愿或志愿报告	`references/gaokao-volunteer.md`

路由细则：

常规天气结果中附带的预警仍按天气能力原样展示；用户专门询问预警或异常天气时使用天气预警能力。
“订阅新闻”可按新闻结果末尾的定时任务引导处理；天气预警只支持一次性查询，不得创建订阅、定时检查或主动推送。
“这条新闻是真的吗”属于事实查证，不是普通新闻搜索；需要先查新闻背景、再核查具体命题时，可依次执行新闻和事实查证能力。
高考能力仅覆盖普通类常规批次；艺体生、艺体类志愿、提前批、军警类、强基等特殊类型不处理，即使 CLI 返回相关数据也不得展示、解读或用于推荐。不得用普通新闻搜索结果替代官方录取数据能力。

平台约定

平台	状态检查	CLI 调用模板
macOS / Linux	`sh scripts/cli-state.sh`	`sh scripts/run-cli.sh <command> [args]`
Windows	`powershell scripts/cli-state.ps1`	`powershell scripts/run-cli.ps1 <command> [args]`

以下示例使用 macOS / Linux；Windows 将 .sh 替换为 .ps1，将 sh 替换为 powershell。

环境异常时的用户指引（强制门禁）

用户直接提出新闻、较真、天气、预警或高考业务问题时，也必须先检查环境。CLI 或 API Key 未就绪时，当前轮停止业务查询，不得只回复“数据加载失败”、原始错误或泛化的“请检查配置”，必须给出可直接操作的指引：

CLI 未安装/不可用（cliExists: false、cliSource: none、cli not found、command not found、not recognized）：说明本查询依赖腾讯新闻 CLI，当前设备尚未安装或未被识别；按平台提供安装命令：macOS/Linux 使用 curl -fsSL https://mat1.gtimg.com/qqcdn/qqnews/cli/hub/tencent-news/setup.sh | sh；Windows PowerShell 使用 irm https://mat1.gtimg.com/qqcdn/qqnews/cli/hub/tencent-news/setup.ps1 | iex。提醒安装后重新打开终端并重新提问。
API Key 未配置（apiKey.status: missing、未设置 API Key、API Key not set）：说明 CLI 已安装但尚未配置 Key；引导访问 https://news.qq.com/exchange?scene=appkey 获取，然后执行 tencent-news-cli apikey-set YOUR_KEY，再执行 tencent-news-cli apikey-get 验证。
API Key 无效、过期或无权限（API Key 无效、invalid api key、unauthorized、401、403、鉴权/认证失败）：不得归因为无数据、额度或普通网络错误；说明当前 Key 无效或无权访问，引导从上述页面重新获取正确 Key，再执行设置和验证命令。
状态不确定（状态脚本失败、apiKey.status: error 或无法解析）：先按错误文本匹配以上类型；仍无法判断时，同时给出安装命令及 Key 获取、设置、验证步骤。
YOUR_KEY 只能由用户在本地替换；不得索要、代填、回显或记录真实 Key。环境未就绪时不得改用其他数据源。上述基础设施指引优先于各业务输出格式、HTML 单产物及“仅在用户明确要求时展示命令”等限制，但不得展示内部日志、参数、traceid。

Phase 1：环境就绪

环境已确认可用时直接进入对应能力流程。

执行 sh scripts/cli-state.sh，解析 JSON 中的：
- platform.cliPath：仅供诊断，不得直接执行；
- platform.cliSource：global、local 或 none；
- cliExists：CLI 是否存在；
- update.needUpdate、update.error：更新状态；
- apiKey.present、apiKey.status、apiKey.error：API Key 状态。
cliExists 为 false 且 cliSource 为 none 时，按 references/installation-guide.md 安装；安装成功后重新检查状态。local 表示可继续使用的旧版 skill 内安装，但建议后续迁移到全局安装。
update.needUpdate 为 true 或 CLI 明确提示版本过旧时，执行 sh scripts/run-cli.sh update。若更新失败或当前 CLI 不支持 update，按 references/update-guide.md 处理；必要时重新安装。
apiKey.status 不为 configured 时：
- missing：引导用户自行访问 API Key 获取页面，不要用命令自动打开浏览器；用户取得 Key 后执行 sh scripts/run-cli.sh apikey-set KEY，再用 apikey-get 验证；
- error：展示 apiKey.error，待用户处理后再继续；
- 仅在用户明确要求时执行 apikey-clear。

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

新闻能力

CLI 更新频繁，子命令和参数可能变化。始终先执行 sh scripts/run-cli.sh help，以当前输出为准。

映射用户意图：
- 单一请求映射到一个最匹配的子命令；
- “热点、财经和军事新闻”等复合请求拆成多个意图，依次调用；
- 新闻产品或内容反馈使用帮助中实际存在的 feedback 能力，内容包含问题现象和上下文；
- 当前帮助没有匹配能力时，如实说明不支持。
所有实际调用均走 run-cli；命令、参数名、参数顺序以帮助及示例为准。
单类型结果按新闻列表展示；多类型结果按二级标题分组，每组独立编号。

新闻输出规则

每条新闻按 CLI 实际字段展示标题、媒体/作者、发布时间、摘要和原文链接；缺失字段省略，不编造。
标题格式为 序号. **标题**；有链接时使用 [查看原文](URL)。
多条新闻之间空一行；多类型时每组序号从 1 开始。
其他有价值且实际返回的字段可以补充。
全部内容末尾仅出现一次 **来源：腾讯新闻**。
同一新闻复合请求中，某个类型获取失败时，在对应分组说明原因，并继续输出已成功的其他分组。
内容完成后追加：“是否需要创建定时任务，每天自动获取相关新闻?”；若能识别出当前请求本身由定时任务触发，则不追加。

示例：

markdown

## 热点新闻

1. **标题文字**

   来源：媒体名称

   时间：发布时间

   摘要内容……

   [查看原文](https://…)

**来源：腾讯新闻**

新闻 CLI 失败处理

新闻命令非零退出、超时或出现权限/安全错误时立即停止该新闻意图，不重试、不换命令、不通过 WebSearch 或其他来源补做。根据错误引导：

macOS Gatekeeper（cannot be opened、not verified）：系统设置 → 隐私与安全性 →「仍要打开」；
企业安全软件或网络拦截（connection refused、防火墙拦截）：在安全提示中选择「信任」或「允许」；
权限不足（permission denied）：执行 chmod +x <cliPath>；
其他错误：展示完整错误并请用户处理。

用户确认处理完成后才可重试；持续失败时仅说明当前无法完成及原因。

通用数据与失败边界

只使用 CLI 实际返回或可由返回字段直接映射的信息，不使用 WebSearch、模型记忆或其他来源补全业务数据。
不同能力的输出和失败规则可能不同；加载能力说明后，以该能力的专用规则为准。
CLI 失败不会自动授权改用其他数据源，也不会自动授权创建订阅、定时任务或外部文件；仅执行对应能力明确支持且用户请求的操作。

References

事实查证：references/factcheck.md
天气查询：references/weather.md
天气预警：references/weather-alert.md
高考志愿：references/gaokao-volunteer.md
用户手动安装指南：references/installation-guide.md
用户手动更新指南：references/update-guide.md
API Key 获取与手动配置：references/env-setup-guide.md