22-BitComet P2P × OpenClaw AI - 业务逻辑说明

📋 核心业务规则

🔄 {业务规则1名称}

{业务规则描述}

✅ 规则：

{具体规则说明}

⚠️ 注意：

{注意事项}

🔄 状态流转

{实体}状态流转图

stateDiagram-v2 [*] --> {状态1}: 创建 {状态1} --> {状态2}: {操作1} {状态2} --> {状态3}: {操作2} {状态2} --> {状态4}: {操作3} {状态3} --> [*]: 完成 {状态4} --> [*]: 取消

状态值	状态名称	说明	可执行操作
0	{状态1}	{状态说明}	{可执行操作列表}
1	{状态2}	{状态说明}	{可执行操作列表}
2	{状态3}	{状态说明}	无
-1	{状态4}	{状态说明}	无

⏱️ 关键时序图

{关键业务}时序

sequenceDiagram autonumber actor User as 用户角色 participant App as 客户端 participant API as API网关 participant Svc as 核心服务 participant Queue as 消息队列 participant AI as AI服务 participant DB as MySQL/Redis User->>App: 触发动作 App->>API: 请求接口 API->>Svc: 参数校验 + 权限校验 Svc->>DB: 写入业务数据 Svc->>Queue: 发布业务事件 Queue->>AI: 触发分析任务 AI->>DB: 写入分析结果 API-->>App: 返回处理结果 App-->>User: 展示结果

🔄 端到端流程图

{关键链路}流程

flowchart TD A[用户发起操作] --> B[前端校验] B --> C[服务处理] C --> D[事件发布] D --> E[异步任务处理] E --> F[结果写入] F --> G[消息通知] G --> H[页面刷新与反馈]

🏗️ 系统架构图

22-BitComet P2P × OpenClaw AI系统架构

flowchart LR subgraph Client["客户端层"] C1[客户端A] C2[客户端B] end subgraph Gateway["接入层"] G1[API网关] end subgraph Service["业务服务层"] S1[服务1] S2[服务2] end subgraph AI["AI能力层"] A1[AI模块] end subgraph Data["数据层"] D1[(MySQL)] D2[(Redis)] D3[(对象存储)] end C1 --> G1 C2 --> G1 G1 --> S1 G1 --> S2 S1 --> A1 S1 --> D1 S2 --> D2 S2 --> D3

🔢 计算规则

{计算项名称}

{计算公式} = {参数1} × {参数2} + {参数3}

{公式说明}

💡 计算示例

场景：{示例场景描述}

输入：{输入参数}

计算：{计算过程}

结果：{计算结果}

🔐 权限规则

👤 角色权限

角色	权限范围	操作限制
超级管理员	全部数据	无限制
{角色1}	{数据范围}	{操作限制}
{角色2}	{数据范围}	{操作限制}

🔐 资源发布与订阅访问控制（§8）

资源 / 订阅 / Wire 可选字段

权威说明见同目录 business_logic.md §8：resource_id、发布者 publisher_did、 ocp2p_resource_meta / ocp2p_subscription；ext=101 可选 visibility、sub_proof。本地 API 4031 表示无资源访问权限；完整隐私需 P1 E2EE（§1.4）。

🔗 DHT 发现与节点引导（§9）

Bootstrap / BEP-44 / peer 发现

权威说明见 business_logic.md §9。

属性	说明
公共 Bootstrap	bittorrent-dht 内置列表；初始 routing table 填充
私有 Bootstrap	联盟/企业场景，仅连预配置地址
BEP-44 节点注册	key: `openclaw:node:<node_id>`；value: DID + capabilities + 签名；seq 单调递增
Peer 发现	DHT get → 验签 → 贡献度排序 → TCP Wire handshake
投毒防护	seq 回退拒绝 + 签名校验 + 速率限制 + 多源交叉验证

🔌 Wire 连接管理与扩展协商（§10）

连接生命周期 / BEP-10 / 连接池

权威说明见 business_logic.md §10。

ext 编号	扩展名	说明
100	openclaw_msg	控制消息（ping/pong/node_info/close/error_report）
101	openclaw_chat	P2P 聊天（P0）
102	openclaw_task	任务分发/结果
103	openclaw_file	大文件分块（P1）
104	openclaw_sync	记忆同步（P1）
105	openclaw_heartbeat	心跳与应用存活
106	openclaw_capability	能力公告 + 信誉版本

连接池：最大 64（可配）；idle 5min 回收；断连后指数退避重试（1s→60s max）。

🪪 DID 身份管理（§11）

密钥生命周期 / Wire DID 验证

权威说明见 business_logic.md §11。

阶段	说明
格式	`did:openclaw:<base58_public_key>`（Ed25519）
生成	首次启动时生成密钥对
存储	OS 密钥链或加密文件（禁止明文落库）
Wire 验证	ext=100 node_info 交换 DID + 签名 → 双向验证 → 失败断连
轮换（P1）	新密钥签名轮换声明 → DHT 发布 → 旧密钥窗口内可验

💓 心跳与存活检测 ext=105（§12）

间隔 / 超时 / 贡献度关联

权威说明见 business_logic.md §12。

参数	默认值	说明
发送间隔	30s	每连接独立计时，可配
超时判定	3 次未回复	~90s 无响应标记不健康
贡献度	按小时累计 U_u	心跳中断期间不计

📢 能力公告与任务路由 ext=106（§13）

能力声明 / 路由决策

权威说明见 business_logic.md §13。任务路由：skill 匹配 → 贡献度排序 → 负载均衡 → 选择首个可用 peer。触发条件：首次连接、能力变更、信誉更新、暂停/恢复。

📨 控制消息 ext=100（§14）

ping/pong / node_info / error_report

权威说明见 business_logic.md §14。 ext=100 为协议层探活（轻量），ext=105 为应用层存活（业务数据），两者互补。 error_report 告知对端载荷解析失败或不支持的 ext。

⚠️ 异常处理

🚫 异常场景

异常场景	触发条件	处理方式
{异常1名称}	{触发条件}	{处理方式}
{异常2名称}	{触发条件}	{处理方式}

🔮 P2P + AI 去中心化前沿功能规划（§15）

群体推理 / Gossip / 推理市场 / 联邦学习 / Agent 编排

权威说明见 business_logic.md §15。基于 2025-2026 年 P2P AI 前沿实践调研。

功能	优先级	说明
群体推理共识 (Swarm Inference)	P2	多节点独立推理 + BFT 共识 + 信誉加权排名，+25% 准确率
Gossip 知识传播	P2	ext=107，fan-out=3，3 轮收敛，内容寻址去重 + DID 签名
分布式推理市场	P2	节点注册 GPU/模型，任务竞价，积分或 Token 结算
Agent 多步编排	P2	ext=102 DAG 扩展：parent_task_id + step_index + depends_on
联邦学习协调	P3	ext=108，去中心化聚合 + 差分隐私 + PEFT 异构适配
共享意识层	P3	加密验证的知识图谱 + 向量嵌入网络，消除幻觉
零知识推理证明	P3	zk-SNARKs / optimistic 验证，高价值任务可信保证

← 返回文档总览