fact-check-x-unified

Fact-Check-X 统一入口

本技能只做编排，不内嵌三个业务层。它按以下顺序调用兄弟技能：

1. llm-answer-reference-compare：多平台回答、引用与现场存证采集。
2. fact-check-x-knowledge-compare：本地知识点结构化对比，可选。
3. fact-check-x-authoritative-verify：逐知识点并发权威核验与平台表现报告。

所有语义拆解和证据裁决由当前承载技能的智能体完成。脚本不调用任何模型 API。

依赖定位

四个技能放在同一目录时可直接运行。也可设置：

export FACTCHECK_SKILLS_DIR="<四个技能的父目录>"

检查依赖：

python3 scripts/fact_check_x.py locate

完整流程

先采集 results.json，然后准备知识点对比：

python3 scripts/fact_check_x.py prepare-comparison \
  --results <results.json> \
  --run-dir <run>

命令会同步生成“各方答案汇总”，在运行目录顶层生成 01-capture-report.html，并通过 deliverables 返回用户可见路径。调用方必须先用该路径发送真正的 Markdown 文件链接，再继续知识点对比；禁止只显示反引号路径。

默认交互模式下，程序会把阶段状态写入 stage-checkpoints.json。调用方发送本阶段产物并收到用户“继续下一步”后，必须使用 checkpoint.acknowledgement.token 执行：

python3 scripts/fact_check_x.py acknowledge-stage \
  --run-dir <run> --stage <checkpoint.stage> \
  --token <checkpoint.acknowledgement.token> --decision continue

未确认时，下一阶段命令会直接失败。即使用户最初要求完整连续执行，也必须依次展示每个阶段产物并取得确认；不存在可绕过确认的自动推进模式。

当前智能体读取 <run>/comparison-task.json，写入 <run>/comparison-analysis.json，再执行：

拆解时，原子性同时约束知识点和各平台 claim。一个原句包含多个独立义务、条件、对象、数值或后果时必须拆点，每个 claim 只保留当前事实；平台独有的实质新增事实也要另起无锚点知识点，不能并入宽泛知识点后复用深知晓锚点免查。

python3 scripts/fact_check_x.py complete-comparison \
  --results <results.json> \
  --run-dir <run>

命令会在运行目录顶层生成 02-comparison-report.html，并通过 deliverables 返回路径；调用方必须把它作为独立可点击文件展示给用户。报告必须包含明确标为“未核验”的综合草案。默认交互模式下，用户确认继续后才能进入权威核验。

生成每个知识点的独立云端请求并并发取证：

python3 scripts/fact_check_x.py prepare-authority --run-dir <run>
python3 scripts/fact_check_x.py search-authority --run-dir <run> --max-workers 12

知识点已有深知晓/深知晓（深度溯源）本次回答所附的官方材料，或其他平台本次回答所附的 gov.cn 材料，且原文确实支持当前主张时，直接复用为官方证据，不调用可信搜索。只有不属于上述情形或已有材料不足以裁决时，才是非免查知识点。

若存在非免查知识点但本机尚无可信搜索配置，prepare-authority 和 search-authority 会返回 status=configuration_required、userPrompt 与 configuration.command 并以非零状态退出。调用方先展示登录提示，再前台执行该命令。用户只需在自动打开的深知 MaaS 页面完成登录；组件会自动复用已有完整 Key，没有时创建 Fact-Check-X 专用 Key，验证后保存到 ~/.fact-check-x/credentials/trusted-search-key。Codex、Claude Code、WorkBuddy 等载体共享该配置，检测到已有 Key 时直接跳过登录。配置成功后调用方自动重跑 prepare-authority，不得要求用户复制 Key、编辑 shell 配置、回复“已配置”，也不得改用深知晓来源或普通搜索绕过。