个人 IP 自查、电商 IP 质量调查与网站防滥用共用同一套检测核心：观察出口、环境差异和会话聚合，先给结论，再查证据。Agent 的 API Key、接口地址、模型名称由调用者配置。
import { detect, analyze, verify } from
'https://prophet.offfold.com/sdk/prophet.js';
// 绑定用户操作，在被检测的浏览器内运行；导入不采集。
// 未部署同源 /api/network 时另加 network: false。
const detections = await detect({
publicNetwork: true,
stun: true,
behavior: { durationMs: 8_000 }
});
// 绑定到你的网站“开始验证”按钮。
const verification = await verify({ network: false });
// verification: detections, analysis, evidenceGraph, observedAt
// 调用者明确配置 Key、接口地址、模型；以下地址和名称仅为占位符。
const result = await analyze({
detections,
question: '关联分析代理、自动化与异常信号',
observedAt: new Date().toISOString()
}, {
apiKey: yourModelApiKey,
model: 'your-model-id',
baseUrl: 'https://your-provider.example/v1'
});detect() 默认注册 283 项检查，包含 31 项跨环境一致性观测、30 项主动诊断。示例按首页完整流程运行，最多登记 302 项；全部 15 项可选边缘字段均提供时为 317 项，不保证全部可读。主动诊断在被动与交互采集后执行，避免临时存储影响用量读取。
network、integrity、diagnostics 默认开启，设为 false 可关闭；公网 HTTP、STUN、交互采样默认关闭，示例已主动开启。network 读取接入网站同源的 /api/network。verify() 默认开启公网 HTTP 与 15 秒交互采样，STUN 仍需主动开启。支持 signal 取消。
检测分析包含 22 条关联规则与有来源的证据图，最多保留 500 个节点、32 个检查假设。图谱提供环境、IP 质量、防滥用三种配置侧重；同一证据家族取最大优先级，未经概率校准，不是欺诈概率或 IP 信誉分。
| 接口 | 用途 | 模型 Key |
|---|---|---|
| GET /api/network | 连接与边缘观测 | 无需 |
| POST /api/detections/analyze | 信号关联与证据关系图 | 无需 |
| POST /api/agent/analyze | Agent 调查与分析 | 调用者自带 |
POST https://prophet.offfold.com/api/agent/analyze
Authorization: Bearer <your-model-api-key>
X-Prophet-Model: your-model-id
Content-Type: application/json
{
"detections": [ /* SDK 返回的观测 */ ],
"question": "这些信号能说明什么？",
"observedAt": "2026-11-02T00:00:00.000Z"
}HTTP Agent 要求运营方显式配置 AGENT_BASE_URL，没有内置提供方地址。调用者认证通过、但上游未配置时返回 503，不发起模型请求；缺少调用者 Key 始终返回 401。模型必须由 X-Prophet-Model 或运营方显式设置的 AGENT_MODEL 提供，否则在上游已配置时返回 400。没有公共 Key 回退。
首页先等待完整检测结束，再运行使用者已配置的可选 Agent，公共模型字段初始为空。未配置时，GET /api/agent/status 返回 model: null、providerConfigured: false。浏览器 SDK 使用调用者明确提供的 apiKey、baseUrl、model，不继承 HTTP 运营配置；直连模型需要供应商允许跨域访问。
跨站 HTTP 集成由商家后端调用；两个分析接口共享每个来源 IP 每分钟 4 次的额度，返回 429 时等待 60 秒。
用户点击 → 浏览器采集 → 多维关系分析 → 商家接收结果。SDK 返回值可交给你的业务后端；检测接口返回 trust: client-observations，业务判断保留观测来源和缺失证据。