notion-sync-obsidian

# 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. 基础配置
```bash
# 1. 进入skill目录
cd ~/.openclaw/workspace/skills/notion-sync-obsidian

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

配置文件示例 (`config.json`):
```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. 启动同步系统
```bash
# 启动定时同步（每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...

# notion-sync-obsidian

![Version](https://img.shields.io/badge/version-1.0.0-blue)
![License](https://img.shields.io/badge/license-MIT-green)
![OpenClaw](https://img.shields.io/badge/OpenClaw-Skill-orange)

自动将 Notion 文章同步到本地 Obsidian 目录的完整解决方案。

## ✨ 特性

### ✅ 核心功能
- **自动同步**: 定时检查 Notion 更新并同步到本地
- **完整导出**: 导出文章标题、元数据、完整内容
- **智能标题**: 正确提取文章原始标题（非摘要）
- **移动通知**: 移动端优化格式，智能通知

### ⚙️ 高级功能
- **可配置检查频率** (默认15分钟)
- **安静时段支持** (默认00:00-08:30)
- **强制检查模式** (用户手动触发)
- **增量同步** (避免重复导出)
- **错误处理和日志记录**

## 🚀 快速开始

### 安装
```bash
# 从 ClawHub 安装
clawhub install notion-sync-obsidian

# 或手动安装
git clone https://github.com/your-username/notion-sync-obsidian.git
cp -r notion-sync-obsidian ~/.openclaw/workspace/skills/
```

### 配置
1. 获取 Notion API 密钥: https://notion.so/my-integrations
2. 复制配置文件: `cp config.json.example config.json`
3. 编辑配置: 设置 API 密钥和 Obsidian 目录

### 使用
```bash
# 测试连接
./scripts/simple_checker.sh

# 启动定时同步
./scripts/start_timer.sh

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

## 📁 目录结构

```
notion-sync-obsidian/
├── SKILL.md                    # 技能详细文档
├── README.md                   # 项目说明
├── INSTALL.md                  # 安装指南
├── config.json                 # 配置文件
├── config.json.example         # 配置示例
├── 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/                   #...