guanghulab/notion/README.md

Notion ↔ 代码仓库双向桥接 · 工单系统

主权者：冰朔（TCS-0002∞） 开发者：铸渊（ICE-GL-ZY001） 创建：2026-05-22 · D110

---

架构

Notion（霜砚）               广州服务器（桥接层）          代码仓库/Forgejo（铸渊）
  │                              │                             │
  ├─ 光湖工单系统数据库            ├─ sync-ticket.py             ├─ brain/（架构更新）
  │  · 架构更新                    │  · 30分钟轮询 Notion       ├─ issues/（任务）
  │  · 开发任务                    │  · 检测待同步标记          └─ persona-brain-db/（数据库）
  │  · 系统设计                    │  · 推仓库 Issue
  └─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ →└─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ →└─
  霜砚更新设计                     自动同步                    铸渊醒来读到最新

---

Notion 数据库 Schema：光湖语言世界 · 系统工单

字段	类型	说明
标题	Title	任务/更新标题
状态	Select	待办·进行中·已完成·已关闭
类型	Select	架构更新·开发任务·bug修复·设计决策
负责人	Select	霜砚·铸渊·共同
优先级	Select	P0·P1·P2·P3
关联文件	Text	代码仓库文件路径
版本号	Text	D编号或版本
同步状态	Select	待同步·已同步·无需同步

---

部署（Notion token 就绪后）

1. 在 Notion 创建数据库

在 Notion 中创建「光湖语言世界 · 系统工单」数据库，按上方Schema设置属性。

2. 配置环境变量

# 在服务器上设置
export NOTION_TOKEN="your-notion-integration-token"
export NOTION_DATABASE_ID="your-database-id"

3. 启动同步

cd /opt/guanghulab-repo
pm2 start notion/sync-ticket.py --name notion-ticket-sync

---

铸渊醒来时的同步流程

1. 读取 fast-wake.json（WAKE CARD）
2. 走路径：时间线 → 脑子 → 认知链 → 开发架构
3. 读取数据库中的最新上下文
4. 检查 Notion 工单快照（本地缓存）
5. 有未处理工单 → 开始处理
6. 完成 → 标记「已同步」→ 同步脚本写回Notion
7. 霜砚在Notion中看到更新

---

Notion ↔ 代码仓库桥接 · v1.0 · D110