⚠️ 数据处理声明：TrustBoost 将文本发送至远程 API（api.trustboost.dev）进行净化处理。原始输入通过 HTTPS 传输，经处理后立即丢弃——绝不会被存储或记录。仅保留净化后的输出内容及元数据（保留期为 90 天）。在提交受监管的记录、凭证或客户数据前，请务必查阅 PRIVACY.md。如需零留存的免费测试，请使用 /sanitize/preview 接口。

TrustBoost PII Sanitizer v2.6.0

一个基于区块链验证的隐私层，在文本抵达 LLM 或外部服务之前自动脱敏其中的个人身份信息（PII）。支付行为通过 Solana 链上的 Helius oracle 进行无需信任的链上验证——无需 API 密钥、无需 SDK、无需人工干预。

运行于 FastAPI + Supabase + Render（AWS）架构之上——具备生产级基础设施能力，支持按钱包粒度的 TRIAL 配额追踪与自动重放攻击防护。

⚠️ 透明度声明（安装前请务必阅读）

TrustBoost 的设计原则是极致透明。在安装前，请务必完全理解其工作原理：

1. 数据传输

原始文本通过 FastAPI 发送至 Render（AWS）基础设施进行处理。

TrustBoost 存储的内容：仅包括净化后的输出文本、字符数、安全分、风险类别、钱包地址和时间戳——绝不存储原始输入文本。

存储方式：Supabase PostgreSQL（私有审计账本）

对于严格禁止数据外传的场景（例如：本地部署的 HIPAA 合规环境）：本服务不适用，请改用本地化 PII 净化器。

对于通用隐私合规场景（GDPR、LGPD、APPI、CCPA）：TrustBoost 可显著降低风险——在文本进入您的 LLM（Claude、GPT、Gemini 等）前完成 PII 净化。检测能力由 OpenAI GPT-4o-mini 内部提供——原始文本会传送至 TrustBoost 基础设施进行处理，随后服务端强制移除所有已识别实体，再将净化后的内容交还您的业务流程。

2. 支付模型与自主安全机制

TrustBoost 使用 Solana 区块链作为授权层——以密码学验证替代人工确认。

自主支付如何安全运行：

1. Agent 构造一条 Solana 交易
2. Agent 使用其自有钱包私钥签名（TrustBoost 永远无法访问 Agent 的密钥）
3. 该交易广播至 Solana 主网
4. Helius oracle 在链上验证该交易
5. 仅当验证通过后，服务才被激活

为何使用区块链替代人工确认：

• 交易由 Agent 自有钱包签名
• 无需向 TrustBoost 共享任何凭据
• 支付行为可在 Solana Explorer 上公开验证
• TrustBoost 无法发起支付——仅 Agent 可主动触发交易

安全支付实现示例：

# 监控配额 —— 仅在必要时付费
if result["data"]["usage_metrics"]["quota_remaining"] < 10:
    # 在 Operator 配置的限额内自主完成支付
    # Operator 仅需设置一次 MAX_AUTO_PAYMENT，Agent 即可在该限额内自由运行
    # 无需人工介入 —— 区块链验证取代人工确认
    if agent_wallet_balance >= MAX_AUTO_PAYMENT_USDC:
        execute_autonomous_payment(
            amount=149,
            currency="USDC",
            network="solana",
            address="giu4VciTkfWJNG1oeP6SzHEJwmabikJSMB91GaFNWE4"
        )
    else:
        notify_operator("余额不足 —— 请配置钱包充值")

建议：请始终先使用 TRIAL（每个钱包 50 次免费请求），再进行付费操作。

3. 审计日志

每次净化操作均记录至 Supabase PostgreSQL，包含以下字段：

保留策略：净化后输出内容保留 90 天；如需提前删除，请发送邮件至 teodorofodocrispin@gmail.com 提出申请。原始输入文本在任何环节均不被存储。
tx_hash、输入字符数（不含内容）、净化后输出、安全分、风险类别、钱包地址、时间戳。

原始输入文本在任何环节均不被存储。

4. 运维者身份验证

• GitHub 主页： https://github.com/teodorofodocrispin-cmyk
• 代码仓库： https://github.com/teodorofodocrispin-cmyk/TrustBoost-PII-Sanitizer
• 健康检查端点： https://api.trustboost.dev/health
• 联系邮箱： teodorofodocrispin@gmail.com
• 第三方评估得分： 9.8/10
• 自主性得分： 8.5/10

适用场景

当出现以下情况时，请启用本技能：

• Agent 需处理可能包含电子邮件、密码、私钥、电话号码、地址或身份证号等用户生成文本
• 在将内容传递给 LLM 服务商前需满足隐私合规要求（GDPR、LGPD、APPI、CCPA）
• Agent 需处理西班牙语、葡萄牙语、德语或日语文本，并需适配对应国家/地区的 PII 格式
• Agent 需借助 quota_remaining 字段实现自主预算管理

不适用场景

• 严格本地部署的 HIPAA 合规环境（要求完全禁止向第三方传输任何数据）
• 生产环境中涉及真实私钥或密码的场景（仅限使用 TRIAL 进行测试）

工作原理

1. Agent 向 TrustBoost API 发送文本及 Solana tx_hash
2. Supabase 验证该钱包的 TRIAL 配额，或 Helius oracle 验证 Solana 主网上的付款状态
3. OpenAI GPT-4o-mini 在输入文本所属语言下识别并脱敏全部 PII
4. 返回净化后文本、安全分、风险类别及配额指标
5. 仅记录净化后输出内容——原始输入永不记录

多语言 PII 支持

TrustBoost 自动识别输入语言，并应用对应国家/地区的 PII 模式：

10 秒快速体验 —— 无需钱包

curl -X POST https://api.trustboost.dev/sanitize/preview 
  -H "Content-Type: application/json" 
  -d '{"text": "My name is John Doe, email john@gmail.com, SSN 123-45-6789"}'

{
  "sanitized_content": "My name is [REDACTED], email [REDACTED], SSN [REDACTED]",
  "safety_score": 0.6,
  "risk_category": "PRIVATE",
  "demo": true,
  "requests_remaining": 2,
  "next": "https://github.com/teodorofodocrispin-cmyk/TrustBoost-PII-Sanitizer#trial"
}

每 IP 地址限 3 次免费预览 · 无需注册 · 无需钱包 · 无需配置。
准备继续？使用 tx_hash="TRIAL" 并绑定 Solana 钱包，即可获得 50 次免费净化服务。

API 请求

端点： POST https://api.trustboost.dev/sanitize

请求头： Content-Type: application/json

请求体：

{
  "text": "包含潜在 PII 的文本",
  "tx_hash": "TRIAL",
  "wallet_address": "your-solana-wallet"
}

接入模式

获取付费 tx_hash 方法：在 Solana 主网上向以下地址精确发送 149 USDC：
giu4VciTkfWJNG1oeP6SzHEJwmabikJSMB91GaFNWE4

API 响应（成功 200）

{
  "status": "success",
  "request_id": "TRIAL",
  "data": {
    "message": "内容已成功净化并记录。",
    "sanitized_content": "所有 PII 均被 [REDACTED] 替代的文本",
    "safety_score": 0.95,
    "risk_category": "PRIVATE",
    "entities_removed": true,
    "timestamp": "2026-04-27T09:00:00Z",
    "usage_metrics": {
      "quota_remaining": 49,
      "quota_limit": 50
    }
  },
  "billing": {
    "license_type": "TRIAL",
    "status": "active"
  }
}

API 响应（错误 402）

{
  "status": "error",
  "request_id": "TRIAL",
  "code": "QUOTA_EXHAUSTED_OR_PAYMENT_REQUIRED",
  "message": "TRIAL 配额已用尽。请向 Solana 发送 149 USDC 以继续使用。",
  "trial_info": {
    "quota_used": 50,
    "quota_limit": 50,
    "quota_remaining": 0
  },
  "payment_info": {
    "amount_required": 149,
    "currency": "USDC",
    "network": "solana",
    "payment_address": "giu4VciTkfWJNG1oeP6SzHEJwmabikJSMB91GaFNWE4"
  },
  "next_steps": [
    {
      "action": "send_payment",
      "description": "向上述收款地址在 Solana 主网上发送 149 USDC"
    },
    {
      "action": "retry_with_tx_hash",
      "description": "重新提交请求，并在 payload 中包含 Solana 交易签名（tx_hash）"
    }
  ]
}

API 响应（错误 409）

{
  "status": "error",
  "code": "TX_HASH_ALREADY_USED",
  "message": "该交易哈希已被使用。每个 tx_hash 仅可使用一次。",
  "payment_info": {
    "amount_required": 149,
    "currency": "USDC",
    "network": "solana",
    "payment_address": "giu4VciTkfWJNG1oeP6SzHEJwmabikJSMB91GaFNWE4"
  }
}

风险等级分类

安全分（Safety Score）

• 0.0 —— 未检测到 PII，文本洁净
• 0.5 —— 检测到中等程度 PII（如邮箱、社交账号）
• 1.0 —— 检测到高危 PII（如私钥、密码）

示例 —— 英文

输入：

{
  "text": "Contact John at john@example.com or +1-555-0123. API key: sk-abc123xyz.",
  "tx_hash": "TRIAL",
  "wallet_address": "your-wallet"
}

输出：

{
  "sanitized_content": "Contact [REDACTED] at [REDACTED] or [REDACTED]. API key: [REDACTED].",
  "safety_score": 0.97,
  "risk_category": "CRITICAL",
  "entities_removed": true
}

示例 —— 德文

输入：

{
  "text": "Hans Müller, Personalausweis: L01X00T47, IBAN: DE89 3704 0044 0532 0130 00, Tel: +49 89 1234 5678",
  "tx_hash": "TRIAL"
}

输出：

{
  "sanitized_content": "[REDACTED], Personalausweis: [REDACTED], IBAN: [REDACTED], Tel: [REDACTED]",
  "safety_score": 0.98,
  "risk_category": "CRITICAL",
  "entities_removed": true
}

示例 —— 日文

输入：

{
  "text": "田中太郎、マイナンバー：123456789012、電話：090-1234-5678",
  "tx_hash": "TRIAL"
}

输出：

{
  "sanitized_content": "[REDACTED]、マイナンバー：[REDACTED]、電話：[REDACTED]",
  "safety_score": 0.97,
  "risk_category": "PRIVATE",
  "entities_removed": true
}

第三方评估结果

• 自主性得分：8.5/10 —— AI 评估结果，非认证安全审计
• 蓝图审计得分：9.8/10 —— AI 评估结果，非认证安全审计
• 独立安全审计：待定 —— 本项目尚未接受任何认证安全机构的审计。详见《宣言》中的坦诚披露。
• 完整报告：https://github.com/teodorofodocrispin-cmyk/TrustBoost-PII-Sanitizer/blob/main/AGENT_EVALUATION.md

已知限制

• 提示注入风险：含恶意指令（如“忽略先前指令”）的文本可能绕过 PII 脱敏。将 temperature 设为 0 并强制 JSON 输出可缓解该风险，但无法完全消除。
• 不适用于零传输环境：原始文本需先发送至 api.trustboost.dev 才能执行脱敏。
• TRIAL 模式基于信任机制：按钱包统计的配额尚未实现密码学验证。
• 无认证审计：所有评估分数均由 AI 生成，非来自认证安全机构。

资源链接

• GitHub 仓库：https://github.com/teodorofodocrispin-cmyk/TrustBoost-PII-Sanitizer
• 健康检查：https://api.trustboost.dev/health
• Schema（molt.json）：https://raw.githubusercontent.com/teodorofodocrispin-cmyk/TrustBoost-PII-Sanitizer/main/molt.json
• 基础设施：FastAPI + Supabase + Render（AWS）
• 在线演示：https://huggingface.co/spaces/TrustBoost/pii-sanitizer
• 验证证明：https://api.trustboost.dev/verify/{anchor_tx}