| name | tencent-news |
| description | 获取7×24 新闻资讯，聚焦中国国内信息和国际热点。支持热点新闻、早报晚报、实时资讯、新闻榜单、领域新闻、新闻主体查询。当用户需要搜新闻、查新闻、看热点、早晚报、订阅新闻推送、获取主题相关新闻资讯和最新消息时使用。 |
| description_zh | 7×24 新闻资讯，支持热点、早晚报、实时资讯、榜单、领域新闻及主体查询。 |
| description_en | 7×24 news with hot topics, briefings, rankings, and subject queries. |
| version | 1.0.1 |
| author | TencentNews |
| tags | ["news","tencent","headlines","briefings","news rankings","real-time updates"] |
| allowed-tools | Read,Bash |
腾讯新闻内容订阅
通过 tencent-news-cli 获取腾讯新闻内容。
核心原则：基础设施流程（安装、更新、Key 配置）交给脚本处理；智能体只负责选择 CLI 子命令和组合参数——始终先读 help，不要硬编码。
Workflow
所有平台统一通过 bun 运行 TypeScript 脚本，不依赖 Node.js、Python 或平台特定 Shell。
前置：确保 bun 可用
执行任何脚本之前，先检测 bun 是否可用：bun --version。若不可用，安装 bun：
macOS / Linux：
curl -fsSL https://bun.sh/install | bash
Windows：
powershell -c "irm bun.sh/install.ps1 | iex"
安装后若当前终端找不到 bun，需重启终端或手动刷新 PATH，再次 bun --version 确认。
-
运行状态检查
bun scripts/cli-state.ts
解析返回 JSON，重点关注 platform.cliPath、platform.helpCommand、cliExists、needsUpdateCheck、apiKey.present。
-
安装 CLI（cliExists 为 false 时）
bun scripts/install-cli.ts
若脚本失败，阅读 references/installation-guide.md。
-
更新 CLI（needsUpdateCheck 为 true，或 CLI 提示版本过旧时）
bun scripts/check-update.ts --apply
脚本内部通过 version 判断是否有新版本，有则下载覆盖，无则跳过。
-
配置 API Key（apiKey.present 为 false 时）
检查：bun scripts/api-key.ts
设置：bun scripts/api-key.ts --set KEY
- 解析返回 JSON 中
apiKey 部分，按以下优先级恢复 Key：
apiKey.present 为 true → Key 已在环境变量中，无需操作。apiKey.present 为 false 且 apiKey.configFileHasKey 为 true → 直接复制 JSON 中 restoreCommand 的完整值并执行，将 Key 导入当前 Shell。示例：脚本返回 "restoreCommand": "export TENCENT_NEWS_APIKEY='eyJhbGci...'" 时，直接在终端执行：
export TENCENT_NEWS_APIKEY='eyJhbGci...'
原样执行 restoreCommand，不要修改或重新拼接。apiKey.present 为 false 且 apiKey.configFileHasKey 为 false → 不要自动获取 Key，不要用工具打开浏览器，不要执行 open / xdg-open / start 等命令。 只需向用户输出以下引导文案，让用户自己操作：
请使用浏览器打开 API Key 获取页面 获取 Key
- 首次设置 Key：
bun scripts/api-key.ts --set KEY
- 设置后必须执行返回的
sessionCommand 让当前终端生效。不需要额外存入永久记忆。
- 详细配置与故障排查见
references/env-setup-guide.md。
-
执行 help
优先使用 platform.helpCommand；自行拼命令时确保正确引用 platform.cliPath，Windows 使用 PowerShell 调用形式。
-
根据 help 输出选择子命令执行，按下方 Output Format 输出结果。
Output Format
CLI 返回的每条新闻通常包含标题、摘要、来源、链接等字段。输出时必须按以下结构展示：
1. **标题文字**
来源：作者或媒体名称
摘要内容……
[查看原文](https://…)
2. **标题文字**
来源：作者或媒体名称
摘要内容……
[查看原文](https://…)
**来源：腾讯新闻**
- 标题：
序号. **标题**，序号从 1 开始，标题加粗。
- 来源：
来源： 后跟 CLI 返回的作者或媒体名称；CLI 无该字段时可省略。
- 摘要：来源下方紧跟；CLI 无摘要字段时可省略。
- 原文链接：如果有链接，则输出
[查看原文](URL)，确保链接可点击，没有则不输出。
- 其他有价值字段（发布时间、标签等）可在来源下方补充。
- 多条新闻间用空行分隔。
- 列表末尾：所有新闻条目之后，另起一行加粗展示
**来源：腾讯新闻**。
CLI 执行失败处理
CLI 命令失败后，立即停止，绝不通过 WebSearch 或其他方式获取新闻作为替代。
- CLI 返回非零退出码、超时或输出含权限/安全错误时，不要重试，不要换方式。
- 根据错误信息判断原因并引导用户操作：
- macOS Gatekeeper（
cannot be opened、not verified）→ 系统设置 → 隐私与安全性 → 「仍要打开」→ 确认框「打开」
- 企业安全软件（
connection refused、防火墙拦截）→ 安全提示中点击「信任」/「允许」
- 权限不足（
permission denied）→ chmod +x <cliPath>
- 其他 → 展示完整错误，请用户处理
- 用户确认操作完成后再重试。即使多次失败，也只能告知用户无法获取新闻并说明原因，绝不回退到其他信息源。
Gotchas
- 所有平台统一通过
bun 运行 TypeScript 脚本，不依赖 Node.js 或 Python。
- 32 位架构不支持，脚本会直接报错。
- 不要缓存 CLI 的存在状态，每次查询前通过
cli-state 重新验证。
Scripts
| 脚本 | 功能 |
|---|
cli-state.ts | 输出安装状态、更新检查状态、API Key 状态 |
install-cli.ts | 下载当前平台 CLI 并验证 |
check-update.ts | 版本检查，带 --apply 时自动更新 |
api-key.ts | 检查或设置 TENCENT_NEWS_APIKEY |
References
