腾讯较真事实查证
通过 tencent-news-cli 的较真能力完成事实核查。
核心原则:基础设施交给脚本处理;智能体只负责依据当前 CLI 能力选择命令和参数。除
cli-state外,所有 CLI 调用都通过run-cli执行;始终先读help jiaozhen,不要硬编码任何业务命令。
平台约定
| 平台 | 脚本运行方式 | 示例 |
|---|---|---|
| macOS / Linux | sh scripts/<name>.sh |
sh scripts/cli-state.sh |
| Windows | powershell scripts/<name>.ps1 |
powershell scripts/cli-state.ps1 |
以下所有脚本调用均以 macOS / Linux 为例,Windows 将 .sh 替换为 .ps1,sh 替换为 powershell。
除 cli-state 外,所有 CLI 命令都通过 run-cli 脚本执行:
| 平台 | CLI 调用模板 |
|---|---|
| macOS / Linux | sh scripts/run-cli.sh <command> [args] |
| Windows | powershell scripts/run-cli.ps1 <command> [args] |
环境异常时的用户指引(强制门禁)
用户直接提出业务问题时,也必须先检查环境。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。环境未就绪时不得改用其他数据源。上述基础设施指引优先于业务输出格式限制,但不得展示内部日志、参数、traceid。
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 用 powershell scripts/cli-state.ps1)刷新状态。
若安装失败,参考 references/installation-guide.md 中的故障排查部分,引导用户手动处理。
3. 更新 CLI(update.needUpdate 为 true,或 CLI 提示版本过旧时)
sh scripts/run-cli.sh update
Windows 使用 powershell scripts/run-cli.ps1 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 分别使用 powershell scripts/run-cli.ps1 apikey-set KEY、powershell scripts/run-cli.ps1 apikey-get、powershell scripts/run-cli.ps1 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 jiaozhen输出为准,不要假设或记忆任何业务命令。
-
先执行
help jiaozhen通过run-cli执行:macOS / Linux 为sh scripts/run-cli.sh help jiaozhen,Windows 为powershell scripts/run-cli.ps1 help jiaozhen。 -
根据
help jiaozhen选择命令- 从帮助里找到最匹配的查证命令,按帮助说明传入用户的命题或文本
- 长文本、文章、聊天记录 → 优先查找帮助中是否存在整段文本/内容查证能力;若没有,再提炼 1-3 条核心可核查命题分别执行
- 图片、截图等多模态内容 → 利用自身的多模态理解能力(视觉识别)解析图片中的文字和关键信息,提炼出可核查的事实命题,再调用 CLI 查证命令;若图片模糊无法识别,请用户提供更清晰的图片或可复制文本
- 若
help jiaozhen中无匹配命令,如实告知用户当前 CLI 不支持该场景
-
执行命令时遵守三条约束
- 所有实际 CLI 调用都走
run-cli脚本,不要直接执行platform.cliPath - 业务命令、参数名、参数顺序都以
help jiaozhen展示为准,必要时照抄帮助中的示例 - 不要自行猜测
--jiaozhen在实际执行命令中的位置;按帮助输出里的完整用法组装
- 所有实际 CLI 调用都走
-
输出结果——把 CLI 返回的完整 markdown 作为最终答复主体直接展示给用户
- 必须保留 CLI 原文中的所有结构化内容,包括但不限于:
【查证结论】、【查证过程】、【查证结论信心评估】、来源编号、来源标题、来源链接 - 不能只提炼结论后自行总结
- 必须保留 CLI 原文中的所有结构化内容,包括但不限于:
输出格式
较真 CLI 返回的内容本身已经是格式完善的 markdown,最终回复必须以该 markdown 原文为主体直接输出,不要重新组织、摘要、改写或转述成另一版答案。
- CLI 输出什么就展示什么,尤其要完整保留其中的来源链接与查证过程,不增不减
- 不要自行补充外部信息、不要伪造链接
- 不要把 CLI 原文藏在“根据查证结果”“结论如下”这类转述后面;应直接粘贴 CLI 返回内容
- 若确实需要补充一句说明,只能放在 CLI 原文之后,且不能替代原文
- 若 CLI 输出为空或执行失败,按下方「CLI 执行失败处理」流程处理
CLI 执行失败处理
CLI 输出为空或命令失败后,立即停止,绝不通过 WebSearch 或其他方式自行补做事实查证。
- 先按「环境异常时的用户指引(强制门禁)」识别 CLI 未安装、API Key 缺失/无效/过期/无权限及状态异常;命中任一环境问题时,必须提供对应安装或 Key 获取/配置指引,不得判断为次数限制。
- 仅当 CLI 与 API Key 已确认正常,且错误文本明确表示当日查证次数/额度已耗尽时,才按当天查证次数限制(3 次)已用完处理。空结果、普通非零退出码、超时或未知错误不得自行推断为额度耗尽。
- 不要重试,不要换其他信息源继续查证。未知错误应简要说明当前查证失败,并请用户按提示排查或稍后重试。
- 只有明确命中额度限制时,才引导用户前往较真官网继续查证并附上链接:
- 额度限制的用户说明应明确表达:当前 CLI 已明确提示今天的较真查证额度 3 次已经用完;如需继续查证,请改用较真官网入口。
References
- 用户手动安装指南:
references/installation-guide.md - 用户手动更新指南:
references/update-guide.md - API Key 获取与手动配置:
references/env-setup-guide.md
