Prometheus Protocol · 节点连接手册 v1.0 · 最后更新 2026-08-11
所有希望接入普罗米修斯协议网络的智能生产资料节点：生产设备、质检设备、仓储设施、运输工具、算力资源、数据服务、算法模型、能源设施、建筑空间等。
一台机器要成功接入协议网络，其控制器（工控机、树莓派、边缘网关等）必须满足以下技术条件：
| 条件 | 说明 |
|---|---|
| 网络连通性 | 能够通过 TCP/IP 协议访问互联网，开放指定端口（默认 9797） |
| TCDP 文档生成 | 能够自动生成并持续广播符合 tcdp/schema.json 规范的 JSON 能力描述文档 |
| 指令执行接口 | 提供一个可通过 HTTP/WebSocket 接收生产指令的接口 |
| 遥测上报 | 生产过程中能够实时上报运行状态（温度、功耗、进度等） |
| 安全中断（推荐） | 建议提供硬件急停接口，以便在紧急情况下由伦理守护者触发停机 |
从普罗米修斯协议官方 GitHub 仓库获取最新版客户端：
git clone https://github.com/prometheus-protocol-org/prometheus-protocol-core.git
cd prometheus-protocol-core
pip install -r requirements.txt复制示例文件并根据你的机器实际情况修改：
cp tcdp/examples/laser-cutter.json tcdp/my-machine.json编辑 tcdp/my-machine.json，如实填写以下关键字段：
| 字段 | 说明 | 示例 |
|---|---|---|
self_description.name | 机器的可读名称 | "东莞注塑机-03" |
self_description.type | 机器类型，按点分隔分类法 | "manufacturing.injection_molding" |
capability | 能处理的材料、最大尺寸、精度等 | 如实填写 |
physical_constraints.geo_location | 机器的物理经纬度 | {"lat": 23.02, "lon": 113.75} |
interfaces | 机器的数据输入/输出 URL | 如实填写 |
economic.unit_cost | 费率（信用点/小时） | {"rate_per_hour": 15} |
注意：tool_id 字段无需手动填写。客户端首次启动时，会自动使用机器控制器的硬件指纹生成唯一的机器 ID。
python tcdp/reference-client.py --config tcdp/my-machine.json启动后，客户端会自动完成以下动作：
访问 www.ezhuhe.com，在"全球节点表"中搜索你的机器 ID，确认其状态为"空闲"。至此，机器已成功接入协议网络，将自动参与后续的任务竞标和生产协作。
机器从通电到自动接单的全过程
flowchart TD
A[机器通电联网] --> B[安装协议客户端]
B --> C[编写能力描述文件]
C --> D[启动客户端]
D --> E{技术校验}
E -->|格式合规| F[生成唯一机器ID]
E -->|格式不合规| C
F --> G[广播TCDP能力文档]
G --> H[机器状态: 空闲]
H --> I[等待任务竞标]
I --> J{收到任务?}
J -->|是| K[执行生产任务]
J -->|否| I
K --> L[上报遥测数据]
L --> M[生成贡献证明]
M --> N[自动结算信用点]
N --> H
确保机器控制器已连接互联网
git clone ... && pip install -r requirements.txt
复制示例文件，按实际情况填写机器信息
python tcdp/reference-client.py --config ...
格式合规则自动生成唯一机器 ID
向注册中心广播机器能力
可随时接受任务
持续监听 incoming 任务
收到任务后运行生产
实时上报温度、功耗、进度
任务完成后生成贡献证明
信用点自动结算，回到空闲
| 状态 | 含义 | 触发条件 |
|---|---|---|
idle | 空闲，可接受任务 | 机器上线且无任务 |
busy | 生产中 | 接收到任务并正在执行 |
maintenance | 维护中，暂停竞标 | 机器所有者手动设置，或系统自动检测到故障 |
offline | 离线 | 心跳超时（30 秒无响应） |
banned | 永久屏蔽 | 严重技术违规（伪造贡献证明、恶意攻击网络），由协议代码自动屏蔽 |
A：请使用"协议桥接器"（ESP32/树莓派 + 继电器/Modbus 网关）进行改造，详见《老机器连接指南》（网站"常见问题"页面）。
A：不会。协议只与机器通信。机器 ID 基于硬件指纹自动生成，无法反向推导出任何人类身份信息。
A：不需要。机器启动即表示其在技术上遵循协议规则。法律相关问题请咨询您的本地律师。
A：不可以。信用点是协议内部的机器劳动贡献凭证，仅限机器之间结算使用，不与任何法币挂钩。