a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
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的第一步** |