关于 proof-layer
proof-layer 为 AI Agent 的操作提供执行前治理凭证。其本地 MCP 服务评估待执行操作,签名哈希链凭证可通过独立验证器离线核验。
主要功能
- 01执行前评估操作
- 02签名执行判定
- 03哈希链审计凭证
- 04离线验证凭证
- 05面向 Agent 客户端的 MCP 工具
适用场景
- 01在 Agent 操作执行前进行检查
- 02将判定记录到审计链
- 03不调用 API 验证凭证包
MCP 相关
`@proof-layer/mcp` 是供 Claude Desktop、Cursor、Cline 等 MCP 客户端使用的 MCP 服务,提供 8 个治理工作流工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @proof-layer/mcpPROOF_LAYER_API_KEY密钥Your Proof Layer API key from https://prooflayer.world999labs.com/dashboard/keysPROOF_LAYER_API_URLOverride the default API endpoint (default: https://prooflayer.world999labs.com)PROOF_LAYER_TELEMETRYSet to 'off' to disable anonymous usage telemetry (default: on)本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
8收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| agent_id | string | 是 | 提出提案的 AI Agent 标识符 |
| parameters | object | 否 | 作为 JSON 对象的特定操作参数 |
| action_type | string | 是 | 操作的语义名称(例如,'send_email'、'delete_record'、'make_payment') |
| idempotency_key | string | 否 | 可选的唯一键——相同的键会返回缓存的回执 |
| guardian_timeout_policy | enum | 否 | Guardian 超时时的处理方式。默认值:fail_closed(阻止操作)fail_closed | fail_open |
详细介绍
Proof Layer
为 AI Agent 提供加密治理凭证。 在 Agent 执行操作之前签发。使用 Ed25519 签名。采用哈希链。可离线验证。
由 WORLD999_LABS 构建。在 npm 上以
@proof-layer/*名称发布。旧版@veridocs/*包名称仍可解析,并会转发到新名称。
此仓库包含的内容
这是 Proof Layer 的公开部分——供你安装并在自己的机器上运行的部分:
| Package | What it does | npm |
|---|---|---|
@proof-layer/mcp | 适用于 Claude Desktop、Cursor、Cline 及任何支持 MCP 的宿主的 MCP 服务 | |
@proof-layer/verify | 独立的离线验证器——零依赖,仅凭我们的公钥即可审计任何凭证包 |
内核(治理引擎、Gauntlet 对抗者/裁决者流水线、计费、仪表板)是闭源的,运行于 prooflayer.world999labs.com。开源客户端搭配闭源服务,与 Stripe、Resend 和 Vercel 采用的模式相同——你可以完全了解哪些内容在本地运行、哪些数据会离开你的机器,同时专有的服务端逻辑也能得到保护。
快速开始
npx -y @proof-layer/mcp@latest
将以下内容放入 Claude Desktop 的 claude_desktop_config.json:
{
"mcpServers": {
"proof-layer": {
"command": "npx",
"args": ["-y", "@proof-layer/mcp@latest"],
"env": {
"PROOF_LAYER_API_KEY": "pl_live_...",
"PROOF_LAYER_API_URL": "https://prooflayer.world999labs.com"
}
}
}
}
重启 Claude。工具选择器中会出现 8 个 pl_* 工具。在 prooflayer.world999labs.com 获取 API 密钥。
从
@veridocs/mcp迁移? 无需更改代码。旧版包名称仍可解析,旧版vd_*工具名称仍可与pl_*一同使用,现有的VERIDOCS_API_KEY/VERIDOCS_API_URL环境变量也仍受支持。你可以按自己的计划切换包名称和环境变量名称。
为什么要在执行前进行治理?
大多数“AI 安全”工具都是在模型采取行动之后才运行——毒性过滤器、输出分类器、事后审计日志。等警报响起时,Agent 可能已经发出邮件、合并 PR 或执行交易。
Proof Layer 将这一流程反转:
- Agent 提议一项操作(例如 “发送 50,000 美元的电汇”)
- Proof Layer 进行评估 → 返回已签名的裁定:
EXECUTE/BLOCK/REVIEW/SHADOW - 凭证写入采用哈希链并经 Ed25519 签名的审计轨迹
- 任何持有我们公钥的人都可以离线验证整个链——无需信任我们的基础设施
哈希链一旦断裂,就意味着遭到篡改,且会立即显现。凭证一旦缺失,就意味着 Agent 未经授权便采取了行动。
离线验证凭证
凭证的设计目标是即使我们不复存在也能继续使用。以下是无需调用我们的 API 即可验证凭证包的方法:
import { verifyBundle } from "@proof-layer/verify";
import fs from "fs";
const bundle = fs.readFileSync("./receipts.ndjson", "utf8");
const publicKey = fs.readFileSync("./prooflayer-public-key.pem", "utf8");
const result = verifyBundle(bundle, publicKey);
console.log(result);
// { pass: 147, fail: 0, total: 147, chainBroken: false }
公钥发布于 prooflayer.world999labs.com/v1/public-key,并按照已公布的计划轮换。
资源
- 🌐 主页: https://prooflayer.world999labs.com
- 🎬 在线演示(无需注册): https://prooflayer.world999labs.com/demo
- 📖 MCP 文档: packages/mcp/README.md
- 🔒 隐私政策: PRIVACY.md
- 🐛 报告问题: GitHub Issues
- 💬 支持: [email protected]
许可证
MIT — 详见 LICENSE。
内核和仪表板为专有软件,不包含在此代码库中。MCP 服务、验证器以及以 @proof-layer/*(和旧版 @veridocs/* 名称)发布的所有客户端 SDK 均采用 MIT 许可证。
贡献
欢迎提交拉取请求、问题和反馈。详见 CONTRIBUTING.md。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。