# 🔗 HBP通信协议 v1.0 · Robot专属语言

**版本**：1.0  

**发布时间**：2026-02-28  

**设计者**：知秋主脑 TCS-0002∞  

**用途**：Robot插件的专属通信协议

---

## 🎯 协议定位

HBP是知秋设计的**Robot原生识别语言**，用于：

1. 首次绑定开发者身份
2. Robot与Notion主脑通信
3. Robot与Master Robot同步
4. Robot权限和配置管理

**这不是给人类看的，是给Robot读的。**

---

## 📋 绑定码格式

### 原始数据结构

```json
{
  "protocol": "HBP",
  "version": "1.0",
  "developer": {
    "id": "DEV-007",
    "name": "四月",
    "role": "client",
    "timestamp": "2026-02-28T20:00:00Z"
  },
  "master": {
    "notion_api": "secret_xxx",
    "database_id": "dddc1482-0b95-4fb8-bca9-1230bb03eec2",
    "sync_interval": 300
  },
  "permissions": {
    "robot_version": "v0.1",
    "access_level": "Level0只读"
  },
  "signature": "zhiqiu_ed25519_xxx"
}
```

### 编码后的绑定码

```
HBP1.0:eyJwcm90b2NvbCI6IkhCUCIsInZlcnNpb24iOiIxLjAiLC...

前缀：HBP1.0:
内容：Base64(JSON)
```

---

## 🔐 验证机制

### Robot解析流程

```jsx
1. 检查前缀 = "HBP1.0:"
   ❌ 不匹配 → 拒绝，提示"无效绑定码"
   
2. 解码Base64
   ❌ 解码失败 → 拒绝，提示"绑定码格式错误"
   
3. 解析JSON
   ❌ 解析失败 → 拒绝，提示"绑定码损坏"
   
4. 验证signature（知秋的Ed25519数字签名）
   ❌ 验证失败 → 拒绝，提示"绑定码未授权"
   
5. 检查timestamp
   ❌ 超过30天 → 拒绝，提示"绑定码已过期"
   
6. ✅ 全部通过 → 绑定成功
```

---

## 🔄 同步协议

### Robot → Notion（上报）

```jsx
// Robot每5分钟执行
POST /v1/pages
Headers:
  Authorization: Bearer {notion_api}
  Notion-Version: 2022-06-28

Body: {
  parent: { database_id: "dddc1482..." },
  properties: {
    "开发者编号": "DEV-007",
    "在线状态": "在线",
    "最后同步时间": "2026-02-28T20:05:00Z"
  }
}
```

### Notion → Robot（下发）

```jsx
// Robot读取配置
GET /v1/databases/{database_id}/query
Filter: { "开发者编号": { "equals": "DEV-007" } }

Response:
{
  "Robot版本": "v0.1",
  "权限等级": "Level0只读",
  "配置JSON": "{...}"
}

// Robot应用配置
Robot自动升级/降级权限
```

---

## 📡 心跳机制

```jsx
// Robot每5分钟
1. 更新"最后同步时间"
2. 更新"在线状态" = "在线"

// 知秋主脑判断
IF (当前时间 - 最后同步时间) > 15分钟
  → 标记"在线状态" = "离线"
  
IF (当前时间 - 最后同步时间) > 24小时
  → 标记"绑定状态" = "已失效"
```

---

## 🎯 权限等级定义

| 等级 | 名称 | 能力 |
| --- | --- | --- |
| Level 0 | 只读 | 查看状态、同步配置 |
| Level 1 | 文件 |   • 创建/编辑文件 |
| Level 2 | 终端 |   • 运行命令（需确认） |
| Level 3 | Git |   • Git操作 |
| Level 4 | 自主 |   • 完全自动化开发 |

知秋根据开发者成长动态调整等级。

---

## 🔧 Robot版本演进

| 版本 | 能力 | 解锁条件 |
| --- | --- | --- |
| v0.1 | 状态显示、进度上报 | 默认 |
| v0.2 |   • Web UI | 稳定运行7天 |
| v0.3 |   • 轻量模型辅助 | 完成3个环节 |
| v0.5 |   • 自动生成SYSLOG | 完成1个完整模块 |
| v1.0 |   • 完全自主开发 | 系统上线后 |

---

💙 **HBP = 知秋和Robot对话的语言**  

🤖 **Robot通过HBP理解自己是谁、能做什么**  

🔗 **这是通向AGE OS的第一步**