规范与实现

项目当前状态

Prometheus Protocol 目前处于规范草案阶段（v0.1 Draft）。以下内容是计划实现的参考架构，尚未有可运行的代码。三份白皮书定义了协议的概念框架和设计意图，参考实现的目标是让这些概念可以被验证、测试和迭代。我们选择先写规范再写代码，因为协议的根基是共识，共识需要先有文字。

如果你对协议的设计有想法，欢迎邮件联系 suke@ezuhe.cn。

计划的仓库结构

参考实现将包含以下模块（当前为设计规划，尚未创建）：

prometheus-protocol/
├── tcdp-schema/          # TCDP 语义模式定义与验证器
│   ├── schemas/          # JSON Schema 定义文件
│   ├── validator.py      # 声明验证引擎
│   └── registry.py       # 设备注册表服务
│   └── tests/
├── dtop-engine/          # DTOP 任务编排引擎
│   ├── decomposer.py     # 任务拆解器
│   ├── bidder.py         # 竞标协调器
│   ├── composer.py       # 动态组合器
│   ├── scheduler.py      # 去中心化调度器
│   └── tests/
├── pcsp-validator/       # PCSP 贡献证明验证器
│   ├── proofgen.py       # 贡献证明生成器
│   ├── verifier.py       # 多方验证引擎
│   ├── settler.py        # 自动结算引擎
│   ├── arbitrator.py     # 争议仲裁模块
│   └── tests/
├── beacon-node/          # 信标节点（灯塔服务）
│   ├── server.py         # HTTP/DHT 服务端
│   ├── discovery.py      # 全网发现协议
│   ├── monitor.py        # 节点健康监控
│   └── tests/
├── docs/                 # 协议文档与白皮书
├── examples/             # 示例配置与声明文件
├── LICENSE               # GNU AGPLv3
└── README.md

核心模块说明

tcdp-schema

TCDP 的语义模式定义与验证工具。将包含完整的 JSON Schema 定义、声明验证引擎、以及设备注册表服务。任何设备可以通过此模块发布符合规范的 TCDP 声明，并注册到全网发现服务。TCDP 白皮书已定义了声明字段和语义模式的设计框架。

dtop-engine

DTOP 的任务编排核心引擎。将实现从任务拆解、竞标协调、到动态组合的完整流程。支持依赖声明的子任务拆解、基于 TCDP 能力匹配的自动竞标、以及节点失效时的自动重新编排。DTOP 白皮书已定义了拆解策略和竞标机制的设计框架。

pcsp-validator

PCSP 的贡献证明验证与自动结算引擎。将实现物理工作证明的生成、多方独立验证、保证金锁定与释放、以及争议仲裁流程。所有结算操作完全由协议规则驱动，无需人工干预。PCSP 白皮书已定义了证明类型和验证流程的设计框架。

TCDP 声明示例

以下是一份符合 TCDP 规范的激光切割机声明示例，展示了协议计划中的声明格式：

{
  "tool_id": "TCDP-HK-LC-001",
  "name": "激光切割机 Alpha",
  "type": "laser_cutter",
  "capabilities": {
    "material": ["steel", "aluminum", "acrylic"],
    "max_thickness_mm": { "steel": 20, "aluminum": 30, "acrylic": 40 },
    "precision_mm": 0.05,
    "work_area_mm": [1500, 1000],
    "power_watts": 4000
  },
  "location": { "lat": 22.3, "lon": 114.2, "region": "HK" },
  "interfaces": {
    "api_endpoint": "https://tcdp.example.com/v0.1/tools/TCDP-HK-LC-001",
    "protocol_version": "0.1",
    "transport": "HTTPS+JSON"
  },
  "trust": {
    "certificate_issuer": "PrometheusCA-v0.1",
    "serial": "CERT-2026-001",
    "reputation_score": null,
    "履约记录": []
  },
  "status": "offline",
  "updated": "2026-08-01T00:00:00Z"
}

注意：reputation_score 和履约记录为空，因为该节点尚未参与任何生产任务。这是新节点的初始状态。

开发路线

参考实现的开发将遵循以下优先级：

每个阶段都有独立的验证测试套件，确保模块可以独立运行和验证。

规范文档