70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
|
# Notion 桥接地图 — notion-bridge-map.md
|
|||
|
|
|
|||
|
|
> 铸渊执行层系统升级产物 · TCS-0002∞
|
|||
|
|
> 生成时间：2026-03-14
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 连接总览
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Notion 主脑（数字地球主控台）
|
|||
|
|
↕
|
|||
|
|
connectors/notion-sync（双向同步模块）
|
|||
|
|
↕
|
|||
|
|
仓库执行层（铸渊）
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## API 调用路径
|
|||
|
|
|
|||
|
|
| 脚本 | 方向 | Notion 数据库 | 环境变量 |
|
|||
|
|
|------|------|---------------|----------|
|
|||
|
|
| `scripts/notion-bridge.js` | 仓库 → Notion | SYSLOG Inbox / Changes Log | `NOTION_TOKEN`, `SYSLOG_DB_ID`, `CHANGES_DB_ID` |
|
|||
|
|
| `scripts/notion-signal-bridge.js` | Notion → 仓库 | 工单数据库 / 信号日志 | `NOTION_API_TOKEN`, `WORKORDER_DB_ID`, `SIGNAL_LOG_DB_ID` |
|
|||
|
|
| `scripts/notion-heartbeat.js` | Notion ↔ 仓库 | 工单数据库 | `NOTION_TOKEN`, `NOTION_TICKET_DB_ID` |
|
|||
|
|
| `scripts/brain-bridge-sync.js` | Notion ↔ 仓库 | 大脑同步 | `NOTION_TOKEN` |
|
|||
|
|
| `connectors/notion-sync/index.js` | 双向统一接口 | 广播 / 日志 | `NOTION_TOKEN`, `BROADCAST_DB_ID` |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 数据同步逻辑
|
|||
|
|
|
|||
|
|
### 仓库 → Notion（上行）
|
|||
|
|
|
|||
|
|
1. **SYSLOG 上报**：`syslog-inbox/` → `notion-bridge.js` → Notion SYSLOG 数据库
|
|||
|
|
2. **变更同步**：Git commits/PRs → `notion-bridge.js` → Notion Changes Log
|
|||
|
|
3. **执行日志**：任务完成 → `connectors/notion-sync` → Notion 广播数据库
|
|||
|
|
4. **心跳回写**：工单状态 → `notion-heartbeat.js` → Notion 工单数据库
|
|||
|
|
|
|||
|
|
### Notion → 仓库（下行）
|
|||
|
|
|
|||
|
|
1. **广播监听**：Notion 广播 → `connectors/notion-sync` → `core/broadcast-listener`
|
|||
|
|
2. **工单派发**：Notion 工单 → `notion-signal-bridge.js` → 本地任务执行
|
|||
|
|
3. **人格唤醒**：Notion 触发 → `persona-invoke.yml` → 人格体执行
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 连接方式
|
|||
|
|
|
|||
|
|
| 连接类型 | 实现 | 说明 |
|
|||
|
|
|----------|------|------|
|
|||
|
|
| Notion API | HTTPS REST | Notion API v2022-06-28 |
|
|||
|
|
| 轮询机制 | Cron / workflow_dispatch | 定时拉取 + 手动触发 |
|
|||
|
|
| 心跳监控 | 5 分钟间隔 Cron | 超时自动重试（最多 3 次） |
|
|||
|
|
| 信号桥 | 工单状态驱动 | `已发送` → 执行 → `已完成` |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 关联工作流
|
|||
|
|
|
|||
|
|
| 工作流 | 触发方式 | 功能 |
|
|||
|
|
|--------|----------|------|
|
|||
|
|
| `notion-heartbeat.yml` | cron `*/5 * * * *` | 工单心跳监控 |
|
|||
|
|
| `bridge-syslog-to-notion.yml` | push (syslog-inbox) | SYSLOG 上报 |
|
|||
|
|
| `bridge-changes-to-notion.yml` | push (main) | 变更同步 |
|
|||
|
|
| `brain-sync.yml` | workflow_dispatch | 大脑数据同步 |
|
|||
|
|
| `process-notion-orders.yml` | workflow_dispatch | 工单处理 |
|
|||
|
|
| `persona-invoke.yml` | workflow_dispatch | 人格唤醒执行 |
|