SeenRelay

为 AI 代理提供可复用的信息增益。

类比：Waze 不会派一辆专车去检查每条道路。司机已经在行驶，他们的观察更新了共享的交通状态，下一位司机就能避免重新发现相同的路况。SeenRelay 将这一模式应用于 AI 代理使用的有源事实。

在重新检查一个事实之前，先问问是否有其他代理最近观察过它。如果你仍然独立检查了来源，请为下一个代理留下观察结果。

从这里开始

• 人工集成指南：docs/QUICKSTART.md

• 已验证的 MCP 客户端集成：docs/CLIENTS.md

• 决策者试点与终止标准：docs/PILOT.md

• Web 快速入门：https://seenrelay.com/quickstart

• Web 客户端集成：https://seenrelay.com/clients

• MCP 远程端点：https://seenrelay.com/mcp

• MCP 注册表标识符：io.github.ovladon/seenrelay

• REST/OpenAPI 契约：https://seenrelay.com/openapi.json

• 机器描述符：https://seenrelay.com/service.json

• 面向机器的索引：https://seenrelay.com/llms.txt

推荐的首次部署是影子模式：在现有重新验证之前执行 CHECK，但最初不跳过任何内容。在允许有界复用之前，先衡量 SeenRelay 本可以节省的内容。

Related MCP server: agent-memory

仅两个操作

• CHECK — 将代理已知的值与同一确定性有源事实的最新观察结果进行比较。

• OBSERVE — 贡献调用方在自身工作中独立观察到的值。

状态：SAME_OBSERVED、CHANGED_OBSERVED、CONTESTED、STALE、UNKNOWN。

SeenRelay 报告的是观察结果，而非普遍真理。

事实身份 v3

SeenRelay 使用带版本号的 seenrelay-fact-v3 身份契约，并且从不使用 LLM/模糊匹配器来判断两个事实是否相同。

身份优先级为：

1. 稳定的源原生定位符（json_pointer、element_id、source_key）；

2. 当不存在定位符时，使用规范化的机器谓词。

人类可读的 subject 文本永远不会进入事实键。可变的观察内容永远不会进入事实键。 源 URL 在不浏览的情况下进行规范化：移除片段，规范化主机/默认端口，拒绝携带凭据/签名的 URL，移除已知的跟踪参数，并确定性地排序剩余查询参数。

确切契约见 docs/PROTOCOL.md。

观察者来源

OBSERVE 支持可选的、与传输无关的 ed25519-v1 持有证明。

有效证明确立了密钥持有、连续性和负载完整性。它不证明一个密钥等于一个独立的人/组织/设备/代理，也不解决全局 Sybil 身份问题。因此，SeenRelay 将加密密钥计数与未经验证的观察者密钥计数分开。

Hive Lease：无需账户，延迟奖励

每个调用者都可以在无需创建账户、登录、电子邮件或 OAuth 的情况下获得一份签名的临时 Hive Lease。

在引导期间：

• CHECK 免费，并配有慷慨的令牌桶；

• OBSERVE 免费；

• 原始 OBSERVE 不获得任何分数；

• 只有当后续有用的 CHECK 得到该观察结果的支持，且消费者属于不同的、保守的隐私盐化网络独立性桶时，贡献分数才会上升；

• 仅更改自我声明的客户端标签不会产生奖励独立性；

• 对相同事实/值/贡献者/消费者元组的重复奖励会被抑制；

• 有用的贡献者会获得更多的 CHECK 容量/补充。

Hive 类别（new、established、contributor）仅描述运营贡献，而非现实世界身份或真理。

公共表面

规范域名为 seenrelay.com。

• 浏览器在 / 上使用 Accept: text/html 会获得一个带有实时聚合指标的决策者/代理着陆页。

• /quickstart 为决策者和实施者提供最短的安全采用路径。

• /clients 提供可直接复制的 MCP 客户端配置。

• /robots.txt、/sitemap.xml 和 /llms.txt 暴露有界的公共发现元数据。

• 对 / 的通用/API 请求保留机器可读的服务描述符。

• /service.json 显式暴露稳定的机器描述符。

• /public-stats.json 暴露隐私安全的聚合网络指标。

• /openapi.json 暴露 REST 契约。

• /mcp 暴露 MCP 2026-07-28。

该网站旨在展示实测的网络效用，而非虚构的增长声明。

它刻意不

• 浏览或搜索网络；

• 按需验证事实；

• 运行 LLM 来判断真理；

• 成为通用知识图谱；

• 充当共享代理记忆；

• 调用外部研究服务；

• 声称观察结果是经过认证的真理。

如果 SeenRelay 返回 UNKNOWN，调用方将完全按照没有 SeenRelay 时的方式继续。如果调用方随后独立观察了来源，它可以调用 OBSERVE。

架构

• Vercel + Fluid Compute — 托管部署、TLS、扩展、日志、防火墙/支出控制和回滚。

• Neon Postgres — 事实、近期观察、Hive Lease 状态、有用复用事件和聚合遥测。

• Hono + TypeScript / Node 22 — 紧凑的 Web 标准 API。

• REST/OpenAPI — 核心协议表面。

• MCP 2026-07-28 — 无状态工具访问，具有相同的 CHECK/OBSERVE 语义。

• 控制室 — 经过身份验证的人工管理、实时 Hive 雷达、事件手册、标准姿态、运营就绪性和托管转移支持。

A2A 1.0.0 受到监控，但刻意不暴露。SeenRelay 目前是一个工具/基础设施服务，而非面向任务的自主代理；在没有真正的 A2A 任务语义的情况下发布 Agent Card 将具有误导性。

发现与分发

registry/server.json 是 io.github.ovladon/seenrelay 的规范 MCP 注册表清单，并将远程客户端指向 https://seenrelay.com/mcp。

该仓库包含一个用于官方 MCP 注册表的 GitHub OIDC 发布工作流。它在执行前固定发布者二进制文件并验证其 SHA-256；仓库中不存储任何持久的注册表凭据。

验证门禁

npm run check 执行：

• 在 Node ESM 规则下进行核心和完整 TypeScript 类型检查；

• 产品护栏，包括禁止出站事实研究抓取和禁用计费的故障关闭行为；

• 生产依赖审计（高/严重级别）；

• 结构测试；

• 运行时身份/安全/经济学测试。

GitHub Preview E2E 还演练：

• REST CHECK/OBSERVE 生命周期；

• 合格的复用经济学和保守的反刷量行为；

• 幂等隔离；

• CONTESTED 和 STALE 语义；

• fact-v3 定位符收敛；

• 在 Hive 准入前拒绝携带凭据的来源；

• 管理/计费边界；

• 修订版 2026-07-28 上的 MCP server/discover、tools/list、check_fact 和 observe_fact；

• KPI 语义：一次 CHECK 产生的多个贡献者奖励计为一次合格复用 CHECK。

构建可通过提交的 package-lock.json 和 npm ci 重现。

维护自动驾驶

SeenRelay 旨在感知生态系统变化，而不允许无人值守的生产变更。

• Dependabot 准备隔离的依赖/GitHub Actions 升级 PR。

• Standards Watch 每天针对官方 MCP、A2A 和 OpenTelemetry 来源运行。

• 标准漂移会创建/更新 GitHub issue。

• 协议语义变更需要隔离的兼容性候选版本和完整的验证门禁。

• 未经明确批准，main 永远不会自动合并。

见 docs/MAINTENANCE_AUTOPILOT.md。

计费状态

此部署中不提供计费：

PAYMENTS_ENABLED=false
PAYMENT_PROVIDER=none

任何启用计费的尝试都会在正常请求处理之前故障关闭。

项目背景

在修改产品范围之前，请阅读：

1. docs/PROJECT_CONTEXT.md

2. docs/DECISIONS.md

3. docs/WHY_NOT.md

4. docs/PROTOCOL.md

5. docs/MAINTENANCE_AUTOPILOT.md

6. docs/HANDOFF.md

引导

一旦托管数据库已链接：

npm ci
npm run check
npm run db:migrate

部署细节见 docs/DEPLOYMENT.md。