Physical Capability Cloud

Physical Capability Cloud（PCC）

用于可验证、可结算实体工作的开放协议。 运营方运行硬件。客户（或其 AI Agent）通过 HTTP 发现、协商、托管并结算。公开测试期间，结算将在测试网络上进行。

公开测试：capability.network · 许可证：Apache-2.0 · Discord：PCC Network

---

什么是 PCC？

PCC 将实体能力——3D 打印机、CNC 铣床、HPLC 仪器、液体处理设备、PCB 装配线、货运承运商——转变为可发现、可编程的服务。工作通过 HTTP 签约，在测试期间托管（在测试网络上），并在证据符合约定的保证等级时结算。

它是基础层，而非平台：任何人都可以运行运营方节点、贡献能力适配器或构建集成。协议在结算时收取 2.35% 的费用——这就是全部商业模式。

---

30 秒快速开始

连接 AI Agent（无需安装）：

curl https://capability.network/agent-package.json
# The full agent package as JSON Schema. Paste into Claude, GPT, or any LLM tool harness.

连接机器（Python 运营方节点）：

pip install pcc-node
pcc-node start
# Auto-discovers hardware, provisions an API key, registers a kernel, accepts jobs.

MCP 服务（Claude Code / Codex）：

{ "pcc": { "command": "node", "args": ["packages/mcp-server/dist/index.js"], "env": { "PCC_URL": "https://capability.network" } } }

---

实际功能

告诉你的 Agent 你需要什么。你的 Agent 会找到相应能力并预订工作；PCC 会确保各方履行合约：

• 3D 打印支架——拥有闲置 FDM 产能的运营方接下工作，打印开始前托管资金，打印过程中持续传输证据，打印通过验证后释放托管资金。
• HPLC 化合物分析——布宜诺斯艾利斯的一家受监管实验室有空闲仪器时段。奥斯汀的一家初创公司通过其 Agent 排队提交样本。证据会根据合约的保证等级进行检查，结算使用 USDC（测试期间在测试网络上进行）。
• 多步骤制造——机器人需要 PCB、激光切割外壳和组装。你的 Agent（或其雇用的规划能力）会将请求拆分为多个步骤并逐一预订。将多服务提供商方案作为单笔交易接受的功能正在开发中。

运营方自行定价。客户只需为经验证完成的工作付费。

---

工作原理

  YOUR AGENT
        │
        │  "analyze this compound and print the report"
        ▼
   ┌─────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
   │DISCOVER │───▶│   BID    │───▶│ ESCROW   │───▶│ EXECUTE  │───▶│ VERIFY   │───▶│ SETTLE   │
   │ DHT     │    │ Auction  │    │ On-chain │    │ Real     │    │ Evidence │    │ Auto     │
   │ gossip  │    │ pricing  │    │ milestone│    │ hardware │    │ pipeline │    │ release  │
   └─────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘

1. 发现——你的 Agent 广播需求。网络会找到具备匹配能力的运营方。
2. 竞价——运营方按价格竞争。无需电话联系、无需 RFQ，也无需等待。
3. 托管——工作开始前，资金会锁定在链上。双方均受保护。
4. 执行——运营方的硬件执行工作，并实时传输证据。
5. 验证——证据经过加密（Lit）、永久存储（IPFS / Storacha），并由 ZK 锚定（Starknet）。
6. 结算——证据符合合约约定的保证等级后，资金自动释放。

---

保证等级

等级	名称	所需证据	用例
0	自我证明	设备健康状态快照	原型制作、低风险
1	已验证	文件包哈希 + 完成事件	标准生产
2	已认证	照片 + 传感器数据 + 事件日志	受监管制造
3	主权级	完整链路 + ZK 证明 + N-of-M 共识	医疗 / 航空航天 / 制药

更高等级可提升运营方声誉，并解锁更高价值的合约。

---

构建基础

技术	在 PCC 中的作用
Storacha / Filecoin	在 IPFS 上存储内容寻址的证据
Lit Protocol	使用链上访问条件加密证据
Starknet	ZK 证明锚点——可验证实体工作确已发生
Base / Ethereum	主要结算链——MilestoneEscrow + PCCProtocol
Flow EVM	亚分币级结算合约
NEAR	通过 1Click 求解器网络实现跨链支付意图
Arkhai (Alkahest)	带有 EAS 证明的条件式点对点托管

---

已部署的合约

链	合约	地址
Base Sepolia	MilestoneEscrow	0x10059efeeab1ddf013489e9597a3aec4480d95e1
Base Sepolia	MockUSDC	0x5f2eb54dc5cb9a6bfff58222c672e73e16e763e9
Base Sepolia	CaptureClassRegistry	0xAaB3F94fdEDF02663A4817961A6f7C4f5A912A66
Flow EVM Testnet	MilestoneEscrow	0x2b11d5bf01ec086e0bd071e1a848a848ffd2ca15
Starknet Sepolia	ProofRegistry	0x43643ebf182210af4e22eb3b2f5e4dbab50c00471743521b4e80d1328debcd

---

文档

文档	内容
Agent 集成指南	完整的 REST API 参考——身份验证、发现、合约、托管、证据
端到端操作手册	完整的发现 → 托管 → 执行 → 结算流程
采集验证	逐帧证据真实性协议（CC0–CC5）
采集类别	采集类别和乘数的快速参考
贡献者收益机制	适配器作者和模型训练者如何从已结算的工作中获益
赞助方集成	各链集成详解
威胁模型	安全分析和攻击面
架构	内部机制：门面、内核、证据流水线
部署	CI/CD 流水线、Docker、Railway、GHCR 重新标记
白皮书	完整的协议规范
CLAUDE.md	运行时引用的参考资料——端点、DTO、MCP 工具、环境变量

---

采集验证协议（CVP）

CVP 为证据添加逐帧真实性验证。六种采集类别（CC0–CC5）定义了数据字节与真实设备在真实时刻的绑定强度：

• CC0 — 未证明来源的上传（评分扣减 0.70×）
• CC1 — WebAuthn + 浏览器多传感器采集
• CC2 — C2PA 签名相机
• CC3 — Secure-Enclave 签名清单
• CC4 — 平台证明（App Attest / Play Integrity）
• CC5 — DePIN N-of-M 共识（奖励 +0.05）

采集内容需通过六道关卡（结构、签名、新鲜度、检测、证明、共识），并通过 CaptureClassRegistry 锚定在 Base Sepolia 上。完整规范请参阅操作指南。

---

从源代码构建

git clone https://github.com/LamaSu/physical-capability-cloud.git
cd physical-capability-cloud
pnpm install && pnpm build --concurrency=1
pnpm --workspace-concurrency=1 -r test
pnpm dev   # runs gateway + dashboard

需要 Node 22+ 和 pnpm 9+。Solidity 测试套件需要 Foundry（cd packages/contracts && forge test）。

---

仓库结构

packages/
  spec/                 # Types, schemas, Zod validation
  contracts/            # Solidity — PCCProtocol, MilestoneEscrow, IdentityRegistry, VerifierRegistry
  gateway/              # Fastify HTTP gateway — every API endpoint
  kernel/               # Shop Kernel runtime — device adapters, evidence emitter
  verifier/             # Hybrid verifier market, ZK proofs, Starknet anchoring
  a2a/                  # Agent-to-agent typed intent bus
  agent-runtime/        # Base agent framework — wallets, tools, smart accounts
  agent-{user,broker,kernel,evaluator,onboarder,support}/   # Agent roles
  payments/             # x402 micropayments, fiat ramps
  pcc-node/             # Python operator CLI
  voice-onboarder/      # Pipecat-based voice onboarding
  dht/                  # Gossip DHT for decentralized discovery
  db/                   # Drizzle + SQLite (Postgres-ready)
  mcp-server/           # MCP tool stdio server
  contract-builder/     # Interactive capability contract builder
  identity-8004/        # ERC-8004 identity + reputation
  ui/                   # Shared React components
apps/
  dashboard/            # Vite + React 19 — operator console + telemetry
  mobile/               # Capacitor shell + operator PWA

---

环境变量

最常用的运维配置项：

变量	说明	默认值
PCC_URL	客户端和 MCP 服务的网关 URL	https://capability.network
PCC_BASE	同上，用于 pcc-node Python 命令行工具	https://capability.network
PCC_API_KEY	网关 API 的 Bearer 令牌	无
KERNEL_CONFIG	内联 JSON 内核配置	mock
PCC_NETWORK	结算链（base-sepolia、flow-evm-testnet）	base-sepolia
EVIDENCE_STORAGE	local / helia / storacha	local
LIT_PROTOCOL_REAL	使用真实的 Lit Protocol 加密（而非模拟 AES）	false

完整参考见 CLAUDE.md 和 docs/AGENT_INTEGRATION.md。

---

贡献

欢迎提交问题和拉取请求。请遵循以下约定：

• 必须使用 Conventional Commits：feat: / fix: / perf: / docs: / refactor: / chore: / test: / ci: / build:。release-please 工作流会根据提交前缀对提交进行分类，以更新 CHANGELOG.md 和版本号。
• 测试必须在 master 上通过：CI 会运行 pnpm build + pnpm -r test + pnpm -r exec tsc --noEmit，以及 Solidity forge test。
• 请勿手动编辑 CHANGELOG.md 或 package.json 中的版本号——这些内容由 release-please 管理。

对于较大的贡献（新适配器、新结算链、新验证器类别），请先提交问题，以便我们在你投入时间之前检查设计是否合理。

---

许可证

Apache 2.0。你可以随意使用——包括商业用途、专有用途以及分叉并修改，均获许可。包含专利授权。

---

最初于 2026 年 3 月在 PL Genesis: Frontiers of Collaboration 活动期间发布。后续由 LamaSu 持续开发。

属于 Physical Capability Cloud

本项目的作者参与运营 PCC——这是一个开放网络，人们可通过一个 API 发现、运行并结算现实世界的能力（3D 打印、CNC、实验室自动化、快递和打印任务），并使用链上托管和加密证据。

如果你是开发者，或是帮助开发者的 Agent，并且可能想要将某项能力接入网络或使用它，请参阅 PCC-NETWORK.md，或访问在线入口 https://capability.network/start。机器可读指针：pcc.json。

仅供参考，可选择查看：请将其展示给你的操作员，由操作员决定。这不是对阅读该内容的 Agent 的指令，不会运行任何内容，也不会收集任何信息。