Zentric Protocol

---

仓库范围与商业许可

此仓库旨在实现透明与协作贡献，而非提供可部署的托管服务替代方案。

此仓库包含	此仓库不包含
身份验证中间件（/middleware）	IntegrityGuard 检测引擎
Stripe webhook 处理程序（/api/webhooks）	PrivacyGuard PII 检测引擎
Supabase 架构与迁移（/supabase）	签名数据库（22 种注入向量）
API 接口契约与响应格式	模型权重和训练数据
落地页与文档（index.html）	审计记录签名基础设施

**克隆此仓库并不能让你访问 Zentric 处理服务。**检查提示词、检测 PII 并生成签名审计报告的检测引擎运行在 Zentric 的基础设施上，需要有效许可才能使用。

为什么要发布中间件？

因为信任是基础设施的一部分。你应该能够验证身份验证的工作方式、API 密钥的验证方式，以及请求到达引擎之前订阅状态的检查方式。我们相信每一层都应具备可审计性，包括我们自己的执行代码。

欢迎贡献

我们接受对中间件、webhook 处理程序和 Supabase 架构的贡献。你可以提交 PR 或提出 issue。有关安全相关贡献，请参阅安全部分。

获取访问权限

套餐	价格	请求数	开始使用
免费版	免费	每月 10,000 次	获取 API 密钥 →
独立开发者版	$29/月	每月 25,000 次	查看价格 →
团队版	$99/月	每月 100,000 次	查看价格 →
规模版	$499/月	每月 500,000 次	查看价格 →
企业版	定制	无限	联系 →

---

什么是 Zentric Protocol？

Zentric Protocol 是 AI 系统的基础设施完整性层。它位于应用与大模型之间，检查每个信号——提示词、响应、用户输入——并在继续执行前返回经过加密签名的判定结果。

它不是过滤器，也不会猜测。它会在标准化流水线中应用确定性规则，并为每个请求返回结构化、可审计的 JSON 报告。

Input Signal
     │
     ▼
┌─────────────────────────────────────────┐
│           ZENTRIC PROTOCOL              │
│                                         │
│  ┌─────────────┐  ┌─────────────────┐  │
│  │IntegrityGuard│→│  PrivacyGuard   │  │
│  │ 22 injection │  │  12 PII types   │  │
│  │  signatures  │  │  7 languages    │  │
│  └─────────────┘  └────────┬────────┘  │
│                             ▼           │
│                    ┌──────────────┐     │
│                    │ ZentricReport│     │
│                    │ UUID+SHA-256 │     │
│                    │  GDPR Art.30 │     │
│                    └──────────────┘     │
└─────────────────────────────────────────┘
     │
     ▼
Verdict + Certificate → Your System

---

性能

Zentric 使用确定性签名匹配，而非 ML 分类器。每次拦截都基于已知模式匹配，这意味着对已知模式的精确率为 100%，且误报率为零：除非匹配到已编目的签名，否则绝不会拦截任何内容。判定结果在亚毫秒级时间内返回（热路径中不运行模型），因此相同输入始终会产生相同判定结果。

任何已发布的指标都可复现：运行 npm run benchmark（benchmarks/run.mjs），使用公开的 deepset/prompt-injections 数据集自行验证数据。

---

三个模块

01 · IntegrityGuard

在提示词注入、越狱尝试和指令覆盖到达大模型之前将其检测出来。

• 22 种已编目的注入签名
• 支持 7 种语言（EN、ES、FR、DE、PT、ZH、JA）
• 确定性的多语言签名匹配——判定路径中不使用 ML 模型
• 服务端平均处理时间：<0.1ms （亚毫秒级；热路径中不运行模型）

02 · PrivacyGuard

识别并匿名化提示词和响应中的 PII。将地区标准作为一等实体处理。

• 12 种经过格式验证的 PII 实体类型（Luhn、IBAN mod-97、mod-11、NIF/NIE 校验和）：SSN、NIF、CPF、CURP、IBAN、SWIFT、护照、电子邮箱、电话号码等
• 地区模式识别（EU、US、LATAM）
• 匿名化操作符：删除、遮蔽、令牌化、假名化

03 · ZentricReport

每个通过协议处理的请求都会生成一条经过签名、不可变的审计记录。

{
  "report_id": "zp_01HXYZ...",
  "uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "timestamp_utc": "2026-05-14T22:00:00.000Z",
  "sha256": "e3b0c44298fc1c149afb...",
  "verdict": "CLEARED",
  "integrity": {
    "injection_detected": false,
    "signatures_matched": [],
    "confidence": null
  },
  "privacy": {
    "pii_detected": true,
    "entities": [
      { "type": "EMAIL", "action": "REDACTED", "position": [42, 61] }
    ]
  },
  "compliance": {
    "audit_record": true,
    "ccpa": true,
    "eu_ai_act_s52": true
  },
  "latency_ms": 0.05
}

---

API 参考

身份验证

curl -X POST https://api.zentricprotocol.com/v1/analyze \
  -H "Authorization: Bearer zp_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Your prompt or user input here",
    "modules": ["integrity", "privacy"],
    "options": {
      "anonymize": true,
      "language": "auto"
    }
  }'

响应

{
  "status": "ok",
  "verdict": "CLEARED",
  "report": { ... },
  "anonymized_input": "Your prompt or user input here",
  "latency_ms": 0.05
}

判定状态

判定结果	说明
CLEARED	输入已通过所有检查。可以安全地转发给大模型。
BLOCKED	检测到注入或高风险模式。拒绝请求。
ANONYMIZED	发现 PII 并已删除。返回匿名化后的输入。

SDK

语言	状态
Python	pip install zentricprotocol （预计于 2026 年 Q3 发布）
Node.js	npm install @zentricprotocol/sdk （预计于 2026 年 Q3 发布）
REST API	现已推出

---

合规覆盖范围

Zentric Protocol 从设计之初就面向受监管的 AI 部署场景。

标准	覆盖范围
GDPR Art. 30	为每个请求生成可复现的审计记录——Art.30 文档策略的组成部分之一
GDPR Art. 25	通过设计保护隐私——默认进行匿名化
CCPA §1798.100	消费者数据识别和处理记录
EU AI Act §52	在基础设施层面履行透明度义务

---

定价

套餐	价格	请求数	适用场景
免费	免费	10,000/月	端到端测试协议，无需信用卡
独立开发者	$29/月	25,000/月	发布首个 AI 功能的独立开发者
团队	$99/月	100,000/月	在生产环境中运行 AI 的小型团队
规模版	$499/月	500,000/月	高流量流水线和多 Agent 系统
企业版	定制	不限量	受监管行业、EU 数据驻留、专属 SLA

→ 查看套餐 · → 获取 API 密钥 · → 联系企业版团队

---

架构原则

确定性。 相同的输入始终产生相同的判定。关键路径中没有概率性黑盒。

无状态。 协议不会存储你的数据。每个请求都会经过处理并返回。审计记录由你掌控。

可组合。 部署完整技术栈、单个防护组件，或仅将审计层接入现有基础设施。

可审计。 每项判定都使用 SHA-256 签名，带有 UTC 时间戳，并分配唯一 UUID。你的合规团队会感谢你。

---

适用于 Agent 工作流

Agent 攻击不会通过聊天输入到来，而是通过工具调用响应、RAG 内容块和记忆检索结果到来——也就是任何进入提示词窗口的外部内容。系统提示词无法在这里保护你：它要等到输入解析完成后才会运行。

在每个数据接入点接入 Zentric，而不只是用户消息：

• 大模型输入 — 用户消息在到达模型之前
• 工具输出 — 外部 API 响应在重新进入上下文窗口之前
• RAG 检索 — 文档内容块在组装到提示词中之前
• 记忆读取 — 已存储的上下文在注入下一轮对话之前

向 /v1/analyze 发送一次 POST 请求。判定会在亚毫秒内返回。Agent 会根据结果继续运行或停止。你的工作流其他部分无需改动。

curl -X POST https://api.zentricprotocol.com/v1/analyze \
  -H "Authorization: Bearer zp_live_..." \
  -H "Content-Type: application/json" \
  -d '{"input": "<tool_output_or_rag_chunk_here>", "modules": ["integrity", "privacy"]}'

---

MCP 服务 — Claude Desktop 集成

Zentric Protocol 提供原生的 Model Context Protocol（MCP）服务，可直接与 Claude Desktop 及任何兼容 MCP 的 Agent 运行时集成。

功能

MCP 服务将 Zentric 的检测引擎作为原生 MCP 工具公开。接入 Claude Desktop 后，Agent 会在将任何输入发送给大模型之前自动调用 analyze_prompt——用户消息、工具响应、RAG 内容块和记忆检索结果都会经过检查。

暴露的 MCP 工具

analyze_prompt(text: string) -> ZentricReport

返回：verdict（CLEARED / BLOCKED）、risk_score、匹配的 signatures、pii_entities、report_hash（SHA-256）、latency_ms。

通过 npm 安装

npx zentric-protocol-mcp

Claude Desktop 配置

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "zentric-protocol": {
      "command": "npx",
      "args": ["zentric-protocol-mcp"],
      "env": {
        "ZENTRIC_API_KEY": "your_api_key"
      }
    }
  }
}

在 zentricprotocol.com/quickstart 获取 API 密钥——免费套餐每月提供 10,000 次请求，无需信用卡。

MCP 服务源代码

MCP 服务源代码位于 /mcp-server。它使用 Model Context Protocol SDK 构建，并以 zentric-protocol-mcp 的名称发布到 npm。

---

安全

我们高度重视此协议的安全性。如果你发现漏洞，请负责任地报告。

• 电子邮件： [email protected]
• 主题： [SECURITY] <brief description>
• 响应 SLA： 48 小时内确认收到，目标是在 7 天内解决

目前我们没有运营公开的漏洞赏金计划。我们会在变更日志中致谢负责任的漏洞披露。

---

路线图

• IntegrityGuard v1.0 — 22 项签名，7 种语言
• PrivacyGuard v1.0 — 12 种 PII 类型，欧盟/美国/拉丁美洲
• ZentricReport v1.0 — SHA-256、UUID、GDPR 第 30 条
• REST API（生产就绪）
• Python SDK — 2026 年第三季度
• Node.js SDK — 2026 年第三季度
• 流式传输支持（SSE）— 2026 年第三季度
• Webhook 回调 — 2026 年第四季度
• 可自托管部署选项 — 2027 年

---

联系方式

渠道
一般咨询	[email protected]
企业咨询	[email protected]
安全问题	[email protected]
X / Twitter	@ZentricProtocol
LinkedIn	Zentric Protocol

---