177 lines
3.4 KiB
Markdown
177 lines
3.4 KiB
Markdown
|
# 🔗 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的第一步**
|