# Notion→本地 同步器 MVP

下一轮指引: 完成后→下发 PY-A04-20260425-002 工具回执系统
仓库路径: /guanghu-self-hosted/notion-sync/
优先级: P0
分支名: feat/py-notion-sync
创建时间: 2026年4月25日 11:19
审核结果: ✅ 审核通过 (2026-04-25T12:35+08:00)
━━━━━━━━━━
✅ 6文件齐全: config/export_formatter/sync_notion/test/requirements/README
✅ source_url bug已修复 + 9条测试 + 增量同步支持
✅ 目录隔离 + 禁触未动
━━━━━━━━━━
审核人: 霜砚(AG-SY-01)
结论: 通过 · 进入第二轮
开发内容: 开发Notion页面同步器，将Notion对话/页面内容导出为本地结构化语料。
1. 读取现有 message-router.js 了解消息路由逻辑
2. 在 /guanghu-self-hosted/notion-sync/ 下创建：
   - sync_http://notion.py: FastAPI服务，接收Notion webhook或定时拉取页面内容
   - export_http://formatter.py: 将Notion页面转为训练语料格式（JSONL）
   - http://config.py: 配置项（Notion API token占位、目标页面列表、导出路径）
3. 输出格式: {role, content, timestamp, source_url} 的JSONL
4. 支持增量同步（记录last_sync_time）
状态: 已完成
约束: 禁触: message-router.js（只读参考不修改）
编码: Python 3.10+ · FastAPI · UTF-8
依赖: 只用标准库+fastapi+httpx+pydantic
测试: 必须包含 test_export_http://formatter.py 验证JSONL格式正确
编号: PY-A04-20260425-001
自检结果: ✅ 6文件齐全(config/export_formatter/sync_notion/test_export_formatter/requirements/README)
✅ export_http://formatter.py source_url bug已修复(string concat替代f-string)
✅ 目录隔离: 仅/guanghu-self-hosted/notion-sync/
✅ 未触碰message-router.js
✅ PY-A04-前缀commit
✅ Python3.10+ · FastAPI · UTF-8
✅ 依赖: fastapi+httpx+pydantic+uvicorn
✅ test_export_http://formatter.py含9条测试
✅ 分支: feat/py-notion-sync (4 commits)
负责Agent: 培园A04
阶段编号: Phase-0-002