Tru8 Evidence Research

Tru8 — AI 驱动的证据研究平台

Tru8 会整理证据，帮助你判断哪些内容重要。提交一项主张或 URL，Tru8 就会从开放网络和专业 API 检索证据，按层级（原始资料 / 新闻报道 / 评论）和类型（数据 / 官方资料 / 新闻 / 分析 / 观点 / 学术研究）分类，将主张拆解为多个要素，把证据映射到相应要素，并呈现完整全貌——结构化呈现，而非总结。

使命：“我们负责整理，你负责判断。”

快速开始

前置条件

• Docker 和 Docker Compose
• Python 3.11+
• Node.js 20+

1. 启动基础设施

docker-compose up -d    # PostgreSQL 16, Redis 7, Qdrant

2. 后端

cd backend
python -m venv venv
source venv/bin/activate    # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env        # Edit with your API keys
alembic upgrade head
uvicorn app.main:app --reload    # http://localhost:8000

3. 前端

cd web
npm install
npm run dev    # http://localhost:3000

项目结构

tru8/
├── backend/              # FastAPI backend + evidence pipeline
│   ├── app/
│   │   ├── api/v1/       # REST endpoints (checks, agent, verify, payments)
│   │   ├── core/         # Config, auth, pricing, manifest signing
│   │   ├── models/       # SQLModel schemas (Check, Claim, Evidence, ClaimConsensus)
│   │   ├── pipeline/     # Two-phase evidence pipeline
│   │   ├── services/     # API adapters, search, payments, consensus
│   │   └── utils/        # Classifiers, deduplication, query planning
│   ├── alembic/          # Database migrations
│   ├── tru8_mcp/         # MCP server package for AI agents
│   └── tests/            # 990 unit + integration tests
├── web/                  # Next.js 14 frontend
│   ├── app/              # Pages (dashboard, developers, public reports)
│   ├── components/       # Evidence views, claim map, marketing
│   └── lib/              # API client, tiers, diagnostics
├── shared/               # Shared TypeScript types
├── docker-compose.yml    # PostgreSQL, Redis, Qdrant, MinIO (optional)
└── .claude/CLAUDE.md     # Full engineering context

流程

包含用户主张选择关卡的两阶段流程（文章模式）：

Phase 1:  Ingest → Extract claims → Classify article → Rank claims
          [PAUSE — user selects claims]

Phase 2:  Fact-check lookup → Decompose into elements → Retrieve evidence →
          Score relevance → Classify tier/type → Map evidence to elements →
          Derive orientation → Complete

Post:     Coverage recovery (Stage 5.1), video recommendations, auto-archiving

证据通过网络搜索和专业来源适配器获取：

类别	来源
网络搜索	Serper.dev、Brave Search、SerpAPI（备用链）
事实核查	Google Fact-Check API
政府	GOV.UK、Hansard、GovInfo、Companies House、ONS
法律	UK Legislation (legislation.gov.uk)
经济	FRED、Marketaux、World Bank
学术	Semantic Scholar、OpenAlex、PubMed
气候	NOAA、WeatherAPI、Open-Meteo、GBIF
档案	Wikipedia（+ 引用挖掘）、Library of Congress、Internet Archive
健康	WHO
体育	Transfermarkt、Football-Data.org
视频	YouTube Data API

六种证据视图

视图	回答的问题
制图师	这场讨论的整体形态是什么？
图书管理员	这是否是完整的资料集？标签是否清晰？
解读者	这些证据能否回答这个子问题？
放映员	镜头中说了什么？
编年史家	证据何时出现？
探寻者	我们还不知道什么？

API 和 Agent 接入

Tru8 提供面向开发者的 API 和供 AI Agent 使用的 MCP 服务。

Agent 商务网关

# Quick check (~15s, heuristic classification)
curl -X POST https://api.trueight.com/api/v1/agent/quick \
  -H "X-API-Key: $TRU8_API_KEY" \
  -d '{"claim": "UK inflation is 3.2%"}'

# Smart endpoint with tier fallback (lookup → consensus → quick → full)
curl -X POST https://api.trueight.com/api/v1/agent/check \
  -H "X-API-Key: $TRU8_API_KEY" \
  -d '{"claim": "UK inflation is 3.2%", "max_tier": "full"}'

层级	费用	耗时	内容
查询	~£0.02	即时	缓存的既有分析
共识	~£0.03	即时	跨用户汇总的全景（k>=3 次检查）
快速	~£0.07	~15s	网络搜索 + 启发式分类
完整	~£0.15	~60-90s	网络搜索 + 专业 API、LLM 分类、要素拆解

支持三种支付通道：x402 (USDC/SIWE)、Skyfire (JWT)、预付额度。

MCP 服务

{
  "mcpServers": {
    "tru8": {
      "command": "python",
      "args": ["-m", "tru8_mcp"],
      "env": { "TRU8_API_KEY": "tru8_sk_..." }
    }
  }
}

工具：tru8_check（带层级回退的证据研究）、tru8_get_result（含分析数据）、tru8_get_result_raw。

清单验证

每次检查完成后都会生成一份经 HMAC-SHA256 签名的清单。验证已签名字段自签名后是否发生更改：

curl https://api.trueight.com/verify/{check_id}

测试

cd backend
pytest tests/ -v                        # Full suite (990 tests)
pytest tests/unit/pipeline/ -v          # Pipeline unit tests
pytest tests/unit/agent/ -v             # Agent/commerce tests
pytest tests/integration/ -v            # Integration tests

基础设施

服务	端口	用途
PostgreSQL 16	5433	主数据库（SQLModel）
Redis 7	6379	缓存 + 速率限制
Qdrant	6333	向量相似度搜索
MinIO（可选）	9000	用于文件上传的本地 S3

身份验证：仪表板使用 Clerk（JWT + JWKS），开发者接入使用 API 密钥。 支付：Stripe（4 个订阅层级）+ Agent 按次付费。

API 文档

• Swagger UI： http://localhost:8000/api/docs
• ReDoc： http://localhost:8000/api/redoc
• 健康状态： http://localhost:8000/api/v1/health/

环境变量

将 backend/.env.example 复制到 backend/.env。主要分组：

分组	必需	变量
数据库	是	DATABASE_URL
Redis	是	REDIS_URL
身份验证	是	CLERK_SECRET_KEY、CLERK_JWT_ISSUER
大模型	是	GOOGLE_AI_API_KEY、OPENAI_API_KEY
搜索	是（至少一个）	SERPER_API_KEY、BRAVE_API_KEY、SERP_API_KEY
支付	用于订阅	STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET
政府 API	可选	FRED_API_KEY、NOAA_API_KEY 等
清单签名	可选	MANIFEST_SIGNING_ENABLED、MANIFEST_SIGNING_KEY

功能标志（默认值均合理）：ENABLE_API_RETRIEVAL、ENABLE_LLM_RELEVANCE_SCORER、ENABLE_QUERY_PLANNING 等。完整列表请参阅 backend/.env.example。

许可证

私有 — 保留所有权利。