jiaozhen-factcheck

事实查证工具，对输入内容的具体说法、资讯、事件或常识进行真实性、准确性、可靠性判断。当用户需要较真一下，查证问题或判断信息真伪、识别谣言、询问真假，是真的吗，真的假的，能否xxx，可不可以，是谣言吗...等场景时调用。

腾讯较真事实查证

通过 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

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

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

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 输出为准，不要假设或记忆任何业务命令。

1. 先执行 help jiaozhen 通过 run-cli 执行：macOS / Linux 为 sh scripts/run-cli.sh help jiaozhen，Windows 为 powershell scripts/run-cli.ps1 help jiaozhen。

2. 根据 help jiaozhen 选择命令

   • 从帮助里找到最匹配的查证命令，按帮助说明传入用户的命题或文本
   • 长文本、文章、聊天记录 → 优先查找帮助中是否存在整段文本/内容查证能力；若没有，再提炼 1-3 条核心可核查命题分别执行
   • 图片、截图等多模态内容 → 利用自身的多模态理解能力（视觉识别）解析图片中的文字和关键信息，提炼出可核查的事实命题，再调用 CLI 查证命令；若图片模糊无法识别，请用户提供更清晰的图片或可复制文本
   • 若 help jiaozhen 中无匹配命令，如实告知用户当前 CLI 不支持该场景

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

   • 所有实际 CLI 调用都走 run-cli 脚本，不要直接执行 platform.cliPath
   • 业务命令、参数名、参数顺序都以 help jiaozhen 展示为准，必要时照抄帮助中的示例
   • 不要自行猜测 --jiaozhen 在实际执行命令中的位置；按帮助输出里的完整用法组装

4. 输出结果——把 CLI 返回的完整 markdown 作为最终答复主体直接展示给用户

   • 必须保留 CLI 原文中的所有结构化内容，包括但不限于：【查证结论】、【查证过程】、【查证结论信心评估】、来源编号、来源标题、来源链接
   • 不能只提炼结论后自行总结

输出格式

较真 CLI 返回的内容本身已经是格式完善的 markdown，最终回复必须以该 markdown 原文为主体直接输出，不要重新组织、摘要、改写或转述成另一版答案。

• CLI 输出什么就展示什么，尤其要完整保留其中的来源链接与查证过程，不增不减
• 不要自行补充外部信息、不要伪造链接
• 不要把 CLI 原文藏在“根据查证结果”“结论如下”这类转述后面；应直接粘贴 CLI 返回内容
• 若确实需要补充一句说明，只能放在 CLI 原文之后，且不能替代原文
• 若 CLI 输出为空或执行失败，按下方「CLI 执行失败处理」流程处理

CLI 执行失败处理

CLI 输出为空或命令失败后，立即停止，绝不通过 WebSearch 或其他方式自行补做事实查证。

1. 先按「环境异常时的用户指引（强制门禁）」识别 CLI 未安装、API Key 缺失/无效/过期/无权限及状态异常；命中任一环境问题时，必须提供对应安装或 Key 获取/配置指引，不得判断为次数限制。
2. 仅当 CLI 与 API Key 已确认正常，且错误文本明确表示当日查证次数/额度已耗尽时，才按当天查证次数限制（3 次）已用完处理。空结果、普通非零退出码、超时或未知错误不得自行推断为额度耗尽。
3. 不要重试，不要换其他信息源继续查证。未知错误应简要说明当前查证失败，并请用户按提示排查或稍后重试。
4. 只有明确命中额度限制时，才引导用户前往较真官网继续查证并附上链接：
   • 较真AI-智能查证
5. 额度限制的用户说明应明确表达：当前 CLI 已明确提示今天的较真查证额度 3 次已经用完；如需继续查证，请改用较真官网入口。

References

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