# Markdown文件自动处理与定时推送系统

## 功能说明

本系统用于自动处理Markdown文件，将24小时内更新的文件复制到指定目录并提交Git变更，然后定时推送到远程仓库。

## 主要功能

1. **遍历目录**：遍历指定目录下的所有Markdown文件（包含子文件夹）
2. **解析frontmatter**：解析每个文件的YAML frontmatter属性
3. **检查更新时间**：优先使用frontmatter中的`updated`字段，否则使用文件修改时间
4. **筛选24小时内更新的文件**：只处理最近24小时内更新的文件
5. **同名文件处理**：支持三种策略：overwrite(覆盖), skip(跳过), rename(重命名)
6. **Git提交**：自动提交变更，提交信息格式：`feat: 📝 {title}`
7. **定时推送**：每天早上六点、中午12点、晚上零点推送到远程仓库

## 文件说明

- `parse_frontmatter.py`：主脚本，用于处理Markdown文件
- `push_to_remote.py`：推送脚本，用于将本地提交推送到远程仓库
- `push_to_remote.bat`：Windows批处理文件，用于运行推送脚本
- `push_to_remote.sh`：Linux shell脚本，用于运行推送脚本
- `example.md`：示例Markdown文件

## 配置说明

### 1. 添加远程仓库

在目标目录下执行以下命令添加远程仓库（使用SSH协议）：

```bash
git remote add origin git@github.com:username/repo.git
```

### 2. SSH密钥配置

确保SSH密钥已正确配置，密钥文件应位于`~/.ssh/`目录下：

- 检查SSH密钥是否存在：
  ```bash
  ls -la ~/.ssh/
  ```

- 如果没有SSH密钥，生成新密钥：
  ```bash
  ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
  ```

- 将公钥添加到GitHub/GitLab等平台

### 3. 定时任务配置

#### Windows系统（使用任务计划程序）

1. 打开"任务计划程序"（搜索"Task Scheduler"）
2. 点击"创建基本任务"
3. 输入任务名称和描述
4. 选择"每天"触发器
5. 设置起始时间为"00:00:00"，重复任务间隔为"12"小时，持续时间为"1天"
6. 选择"启动程序"操作
7. 浏览并选择`push_to_remote.bat`文件
8. 勾选"当单击完成时，打开此任务属性的对话框"
9. 切换到"触发器"选项卡，点击"新建"
10. 设置另一个触发器为"每天"，起始时间为"12:00:00"
11. 点击"确定"完成配置

#### Linux系统（使用cron）

1. 打开cron配置文件：
   ```bash
   crontab -e
   ```

2. 添加以下行，设置每天零点、六点、十二点执行推送脚本：
   ```bash
   0 0 * * * /path/to/push_to_remote.sh
   0 6 * * * /path/to/push_to_remote.sh
   0 12 * * * /path/to/push_to_remote.sh
   ```

3. 保存并退出（对于vim编辑器，按`Esc`，然后输入`:wq`）

### 4. 脚本参数配置

可以根据需要修改脚本中的默认参数：

- **parse_frontmatter.py**：
  - `source_dir`：源目录路径
  - `destination_dir`：目标目录路径
  - `overwrite_strategy`：同名文件处理策略

- **push_to_remote.py**：
  - `repo_path`：Git仓库路径
  - `remote_name`：远程仓库名称
  - `branch`：分支名称

## 使用说明

1. **运行主脚本**：
   ```bash
   python parse_frontmatter.py
   ```

2. **手动运行推送脚本**：
   - Windows：
     ```bash
     push_to_remote.bat
     ```
   - Linux：
     ```bash
     chmod +x push_to_remote.sh
     ./push_to_remote.sh
     ```

## 注意事项

1. 确保Python环境已正确安装，并且已安装所需依赖：
   ```bash
   pip install pyyaml gitpython
   ```

2. 确保目标目录已初始化Git仓库，或者主脚本会自动初始化

3. 确保已正确配置SSH密钥，并且有权限访问远程仓库

4. 定时任务运行时，确保系统处于开机状态

## 日志说明

脚本会输出详细的日志信息，包括：
- 处理的文件数量
- 成功复制的文件数量
- 提交的Git变更
- 推送到远程仓库的结果

可以根据需要将日志重定向到文件，以便查看历史记录：

```bash
python parse_frontmatter.py > log.txt 2>&1
```