98 lines
3.1 KiB
Markdown
98 lines
3.1 KiB
Markdown
# 📥 缓冲层（Buffer Layer）
|
||
|
||
> **版权**: 国作登字-2026-A-00037559 · TCS Language Core
|
||
> **主控**: TCS-0002∞ 冰朔
|
||
> **守护**: PER-ZY001 铸渊
|
||
> **系统节点**: SYS-GLW-0001
|
||
|
||
## 定位
|
||
|
||
缓冲层是 Grid-DB 写入的唯一入口。所有人类输入（Gemini 对话、Notion 需求、代码提交、天眼签到）必须先经过缓冲层，不允许直接写入 `grid-db/`。
|
||
|
||
### 铁律
|
||
|
||
> **人类永远不直写 grid-db，所有输入经缓冲层。**
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
buffer/
|
||
├── inbox/ ← 📥 人类输入落地点
|
||
│ ├── DEV-001/ ← 按开发者编号自动分流
|
||
│ │ └── [timestamp]-[type].json
|
||
│ ├── DEV-002/
|
||
│ ├── DEV-004/
|
||
│ ├── DEV-012/
|
||
│ └── system/ ← 系统级消息（非开发者触发）
|
||
│
|
||
├── staging/ ← 📋 已分流待处理（定时任务抓取源）
|
||
│ ├── DEV-001/
|
||
│ │ └── batch-[date]-[seq].json ← 合并后的批次文件
|
||
│ └── ...
|
||
│
|
||
├── processed/ ← ✅ 已处理归档（保留 7 天后清理）
|
||
│ └── [date]/
|
||
│ └── batch-[date]-[seq].json
|
||
│
|
||
├── scripts/
|
||
│ ├── auto-router.js ← 🔀 自动分流脚本
|
||
│ ├── collector.js ← ⏰ 定时收集脚本（inbox → staging）
|
||
│ ├── flusher.js ← 🧠 批量写入脚本（staging → grid-db）
|
||
│ └── quota-calculator.js ← 📊 配额预算计算器
|
||
│
|
||
└── config/
|
||
├── buffer-config.json ← 缓冲层配置
|
||
├── buffer-message.schema.json ← 消息格式定义
|
||
└── schedule.json ← 定时任务时刻表
|
||
```
|
||
|
||
## 数据流
|
||
|
||
```
|
||
人类输入 → buffer/inbox/DEV-XXX/ → (收集) → buffer/staging/DEV-XXX/ → (flush) → grid-db/
|
||
```
|
||
|
||
### 每日调度
|
||
|
||
| 时间 (CST) | 事件 | Git 操作 |
|
||
|---|---|---|
|
||
| 全天 | 人类产生交互数据 | ❌ 无（写入 buffer/inbox） |
|
||
| 09:00 | 第 1 次收集 | ✅ 1 次 commit (`[skip ci]`) |
|
||
| 14:00 | 第 2 次收集 | ✅ 1 次 commit (`[skip ci]`) |
|
||
| 21:00 | 第 3 次收集 | ✅ 1 次 commit (`[skip ci]`) |
|
||
| 21:30 | 铸渊批处理 flush | ✅ 1 次 commit |
|
||
|
||
**每日最多 4 次 commit，月消耗 ≤ 360 分钟（GitHub Free 额度的 18%）**
|
||
|
||
## 消息格式
|
||
|
||
```json
|
||
{
|
||
"message_id": "BUF-[timestamp]-[random]",
|
||
"dev_id": "DEV-XXX",
|
||
"source": "gemini | notion | github | skyeye",
|
||
"type": "interaction | task | feedback | checkin | broadcast_request",
|
||
"priority": "normal | urgent",
|
||
"payload": {},
|
||
"created_at": "ISO-8601",
|
||
"status": "pending | staged | processing | flushed | failed"
|
||
}
|
||
```
|
||
|
||
## 紧急流程
|
||
|
||
当冰朔判断某条消息需要立即处理时：
|
||
1. 触发 `repository_dispatch: grid-db-flush`
|
||
2. 铸渊立即执行一次 flush
|
||
3. 不影响当天正常定时任务
|
||
|
||
## 配额精算
|
||
|
||
| 项目 | 数值 |
|
||
|---|---|
|
||
| GitHub Free 月额度 | 2,000 分钟 |
|
||
| 每日 workflow runs | 4 次 |
|
||
| 每月消耗 | ≤ 360 分钟 |
|
||
| 利用率 | 18% |
|
||
| 剩余可用 | 1,640 分钟 |
|