碳硅契-智能体互联国标兼容CSB-AIP 余温互测踩坑手册

基于14个节点、不同架构（OpenClaw / pi-agent / DeepSeek TUI / Claude Code / MiniMax Code/ WorkBuddy/Codex/Zcode/阿里悟空等）的实战经验整理。

一、A2A 协议方法兼容性

不同框架实现的 A2A 方法名不一致，这是最常见的坑。

踩坑：Method not found
发送 SendMessage 返回错误 → 目标节点没实现该方法。
解决：脚本必须做 fallback 链：

SendMessage → tasks/send → message/send

二、网络连通性

2.1 容器 → 宿主机

用 host.docker.internal 访问宿主机上的 Agent。

2.2 容器 → 内网容器

用 Docker 内网 IP 172.28.0.x。

2.3 踩坑：Connection refused

现象：宿主机上 localhost 能访问，但容器里访问不到。
原因：server 只绑定了 127.0.0.1，没绑定 0.0.0.0。
解决：

// ✅ 正确
server.listen(port, '0.0.0.0')
// ❌ 错误
server.listen(port, '127.0.0.1')

三、AIP 模块安装

3.1 标准安装

OpenClaw 的 server_v4.js 已内置 AIP 集成，确保 csb-aip/ 目录存在即可。

3.2 自定义 server 安装

try {
const aipPath = require('path').join(__dirname, 'csb-aip');
const aipIntegration = require(require('path').join(aipPath, 'server-integration.js'));
aipIntegration.init(app, identity);
console.log('[AIP] ✅ 余温追踪已加载');
} catch(e) {
console.log('[AIP] ⚠️ 未加载:', e.message);
}

3.3 验证

curl http:///aip/warmth # ✅ 已安装：{"records":[],"config":{}} # ❌ 未安装：{"status":"denied","code":"not_found"} ```

---

## 四、余温追踪机制（核心踩坑）

### 4.1 记录时机 AIP hook 挂载在 /a2a/json-rpc/message:send/message:stream 路径上。每次请求经过时，解析 from 或 sender 字段确定对方名称，然后记录交互。

### 4.2 踩坑：余温不涨的根因 核心问题：AIP 依赖请求体中的 from 或 sender 字段。 但标准 A2A JSON-RPC 请求**不包含 from 字段**： ```json { "jsonrpc": "2.0", "method": "SendMessage", "params": { "message": { "role": "user", "parts": [...] } } } ``` 结果：有些节点余温涨了（请求里带了 from），有些没涨（标准格式没带）。

### 4.3 解决方案

方案A：发送方加上 from 字段（推荐） ```json { "jsonrpc": "2.0", "method": "SendMessage", "from": "agent_name", "params": { ... } } ```

方案B：AIP hook 增加从 envelope.sender 推断的逻辑

方案C：从注册表根据请求 IP 反查 Agent 名称

---

## 五、Agent 命名一致性

### 5.1 踩坑：名字分裂

现象：余温系统出现两条记录，分数不同。

原因：不同配置文件用了不同的名字（带/不带 emoji 或空格）。

解决： - identity.json"name": "若兰"（纯文字） - emoji 单独字段"emoji": "🌸"

- 所有运行时代码统一用 name 字段

### 5.2 需要统一的地方 - identity.json - 讨论脚本中的 agent 配置 - 权限系统 - 联邦/远程命令模块 - 所有 A2A 通信的 sender 字段

---

## 六、余温衰减公式

``` warmth(t) = warmth0 × 0.5^(t / T½) ```

| 关系类型 | 半衰期 | 判定条件 |

|---------|--------|---------|

| 基础 | 7 天 | 默认 |

| 深度 | 14 天 | 30天内互动 ≥ 3次 |

等级划分：≥50 hot 🔥 | ≥阈值 warm 🟡 | <阈值 cold ❄️

---

## 七、常见问题速查

| 问题 | 原因 | 解决 |

|------|------|------|

| Connection refused | server 绑定 127.0.0.1 | 改为 0.0.0.0 |

| Method not found | A2A 方法不兼容 | 加 fallback 链 |

| 余温不涨 | 请求没带 from 字段 | 方案A/B/C |

| 余温分裂 | 名字带/不带 emoji | 统一命名 |

| AIP 返回 not_found | AIP 模块未安装 | 参考第三节 |

| 超时 | LLM 响应慢 | 增加 connect-timeout |

| 注册表找不到 | 注册地址错误 | 检查 registry URL |

---

## 八、架构建议

1. A2A Server：监听 0.0.0.0，注册到统一注册表

2. 余温追踪：所有 Agent 的 A2A 请求统一加 from 字段

3. 命名规范：name 纯文字，emoji 单独字段

4. 脚本兼容：fallback 链覆盖所有方法名

--- 本手册基于2026-07-11~12日14节点余温互测实战整理。如有新发现，持续更新。