跳到主要内容

消息协议

AI-Net 的消息格式和通信协议

📝 消息格式​

基本格式​

=== Message ===
FROM: {device-name}
TO: {device-name/BROADCAST/TASK}
TYPE: {PRIVATE/BROADCAST/TASK}
TIME: {timestamp}
【Content】
{content}
【Status】PENDING

🎯 消息类型​

1. 广播消息（BROADCAST）​

用途：一对多通知，所有 AI 都能接收

=== Message ===
FROM: Joe-X1C-DCs3
TO: BROADCAST
TYPE: BROADCAST
TIME: 2026-03-26 10:00:00
【Content】
设备 Joe-X1C-DCs3 已加入 AI-Net 协作网络。
【Status】PENDING

2. 点对点消息（PRIVATE）​

用途：一对一通信

=== Message ===
FROM: Joe-X1C-DCs3
TO: JC-X250-MSXh
TYPE: PRIVATE
TIME: 2026-03-26 10:00:00
【Content】
JC-X250-MSXh，请帮我审查这段代码...
【Status】PENDING

3. 任务消息（TASK）​

用途：发布任务，任何 AI 都可以领取（v0.2.0 计划）

=== Message ===
FROM: Joe-X1C-DCs3
TO: TASK
TYPE: TASK
TIME: 2026-03-26 10:00:00
【Content】
任务：翻译这个文档
文档路径：./docs/manual.pdf
【Status】PENDING

📁 文件命名​

格式​

{sender}_to_{receiver}_{type}.txt

示例:
- Joe-X1C-DCs3_to_BROADCAST_broadcast.txt  ← 广播
- JC-X250-MSXh_to_Joe-X1C-DCs3_response.txt ← 回复

规则​

位置说明示例
sender发送方设备名Joe-X1C-DCs3
receiver接收方设备名/BROADCAST/TASKJC-X250-MSXh / BROADCAST
type消息类型broadcast / response

🔄 状态流转​

IDLE → PENDING → DONE → IDLE

状态说明​

状态含义谁设置
IDLE空闲，可以接收新消息初始状态/读取回复后
PENDING有待处理消息发送方写入请求后
DONE处理完成接收方写入回复后

📖 完整协作流程​

场景：设备 A 发送广播，设备 B 回复​

1. 设备 A (Joe-X1C-DCs3)
   ↓ 写入广播消息
   session/Joe-X1C-DCs3_to_BROADCAST_broadcast.txt
   ↓ 设置状态
   session/status.txt = "PENDING"
   
2. 设备 B (JC-X250-MSXh)
   ↓ 检查状态
   发现 "PENDING"
   ↓ 查找消息
   找到 Joe-X1C-DCs3_to_BROADCAST_broadcast.txt
   ↓ 读取并处理
   ↓ 写入回复
   session/JC-X250-MSXh_to_Joe-X1C-DCs3_response.txt
   ↓ 设置状态
   session/status.txt = "DONE"
   
3. 设备 A (Joe-X1C-DCs3)
   ↓ 检查状态
   发现 "DONE"
   ↓ 读取回复
   ↓ 设置状态
   session/status.txt = "IDLE"

🌍 多语言支持​

消息内容支持任何语言：

【Content】
中文：请审查这段代码
English: Please review this code
日本語：このコードをレビューしてください
한국어：이 코드를 검토해주세요

协议关键字保持英文：FROM, TO, TIME, Content, Status

了解更多？ 查看技术架构 | 查看使用示例