notion-sync-obsidian

自动将Notion文章同步到本地Obsidian目录的完整解决方案。支持定时检查、完整内容导出、智能标题提取、移动端优化通知。

✨ 功能特性

✅ 核心功能

• 自动同步: 定时检查Notion更新并同步到本地Obsidian目录
• 完整导出: 导出文章标题、元数据、完整内容
• 智能标题: 自动识别文章原始标题（非摘要内容）
• 移动通知: 移动端优化格式，只在有更新时通知

✅ 高级特性

• 定时检查: 可配置检查频率（默认15分钟）
• 安静时段: 支持配置安静时段（默认00:00-08:30）
• 强制检查: 支持用户手动触发检查，忽略安静时段
• 增量同步: 基于时间戳避免重复导出
• 错误处理: 完善的错误处理和日志记录

✅ 技术特性

• Python支持: 使用Python requests库进行完整API调用
• 环境兼容: 自动处理Python依赖安装
• 配置灵活: 支持自定义API密钥、导出目录、检查频率
• 跨平台: 支持Linux/macOS/Windows（容器环境已验证）

🚀 快速开始

1. 前置要求

• Notion API密钥（从 https://notion.so/my-integrations 获取）
• Obsidian目录路径
• Python 3.6+（可选，用于完整内容导出）

2. 基础配置

# 1. 进入skill目录
cd ~/.openclaw/workspace/skills/notion-sync-obsidian

# 2. 编辑配置文件
nano config.json

配置文件示例 (config.json):

{
  "notion": {
    "api_key": "ntn_your_api_key_here",
    "api_version": "2022-06-28"
  },
  "obsidian": {
    "root_dir": "/path/to/your/obsidian/notion"
  },
  "sync": {
    "check_interval_minutes": 15,
    "quiet_hours_start": "00:00",
    "quiet_hours_end": "08:30",
    "enable_notifications": true
  }
}

3. 启动同步系统

# 启动定时同步（每15分钟检查一次）
./scripts/start_timer.sh

# 手动检查（忽略安静时段）
FORCE_CHECK=1 ./scripts/simple_checker.sh

# 查看状态
./scripts/status_timer.sh

# 停止同步
./scripts/stop_timer.sh

📁 目录结构

notion-sync-obsidian/
├── SKILL.md                    # 技能说明文档
├── config.json                 # 配置文件模板
├── scripts/                    # 核心脚本
│   ├── real_notion_checker.py  # 完整Python检查器
│   ├── simple_checker.sh       # 简化Shell检查器
│   ├── timer_checker.sh        # 定时检查器
│   ├── start_timer.sh          # 启动定时器
│   ├── stop_timer.sh           # 停止定时器
│   ├── status_timer.sh         # 查看状态
│   ├── list_recent_articles.sh # 列出最近文章
│   └── debug_page_structure.py # 调试页面结构
├── references/                 # 参考文档
│   └── NOTION_API_GUIDE.md     # Notion API使用指南
└── examples/                   # 示例文件
    └── exported_article.md     # 导出文件示例

🔧 详细配置

Notion API配置

1. 访问 https://notion.so/my-integrations 创建集成
2. 复制API密钥（以 ntn_ 开头）
3. 将集成分享到你的Notion工作空间
4. 在 config.json 中配置API密钥

导出目录配置

• 默认路径: /hellox/openclaw/obsidian/notion/
• 组织结构: 按年月分目录 YYYY-MM/
• 文件命名: 使用文章原始标题，特殊字符自动过滤

定时检查配置

• 检查频率: 默认15分钟，可配置
• 安静时段: 默认00:00-08:30，避免夜间打扰
• 强制模式: FORCE_CHECK=1 环境变量忽略所有限制

🛠️ 脚本说明

核心脚本

• real_notion_checker.py: 完整Python检查器，导出完整内容
• simple_checker.sh: 简化Shell检查器，快速检查更新
• timer_checker.sh: 定时检查器，管理定时任务

管理脚本

• start_timer.sh: 启动定时同步系统
• stop_timer.sh: 停止定时同步系统
• status_timer.sh: 查看系统状态和日志
• list_recent_articles.sh: 列出Notion最近文章

调试脚本

• debug_page_structure.py: 调试Notion页面结构
• test_title_fix.py: 测试标题提取修复

📊 系统状态

查看状态

./scripts/status_timer.sh

输出示例:

📊 Notion定时同步状态检查
检查时间: 2026-02-24 15:44:53
时区: Asia/Shanghai
========================================
🟢 状态: 运行中
进程PID: 4538
运行时间:       10:29