# HEIC 同步工具

一套用于管理和同步 OneDrive 照片的脚本集合，特别支持 Live Photos 功能。

## 概述

本仓库包含一组 Python 和 PowerShell 脚本，用于：
1. 从 OneDrive 下载 Live Photos
2. 在不同位置之间同步照片
3. 扫描照片库
4. 管理照片备份

## 脚本说明

### Python 脚本

#### `get_onedrive_token.py`
使用官方 OneDrive 客户端 ID 获取 OAuth2 访问令牌的 Python 脚本。这是访问 OneDrive API 所必需的。

使用方法：
```bash
python get_onedrive_token.py
```

该脚本将：
1. 打开浏览器进行身份验证
2. 处理 OAuth2 流程
3. 将令牌数据（包括刷新令牌）保存到 `onedrive_token.json`

注意：该脚本使用官方 OneDrive 客户端 ID，无需额外设置。

#### `run_ps_download.py`
PowerShell Live Photo 下载器的 Python 封装。它处理 PowerShell 脚本的执行，并按照年/月路径组织文件。

使用方法：
```bash
# 处理当前月份（如果是月初，还会处理上个月）
python run_ps_download.py --base-save-to "D:\Photos\OneDrive-Photo" --base-path-to-scan "\Photos\Auto-saved"

# 处理特定月份（2表示上个月，3表示上上个月，以此类推）
python run_ps_download.py --base-save-to "D:\Photos\OneDrive-Photo" --base-path-to-scan "\Photos\Auto-saved" --months 2
```

#### `sync_task.py`
处理不同位置之间的照片同步，按年/月组织文件。

使用方法：
```bash
# 从 OneDrive 同步到本地备份
python sync_task.py d:\OneDrive\Photos\Auto-saved\ D:\Photos\Auto-saved --months 1

# 同步照片到 NAS
python sync_task.py d:\OneDrive\Photos\Auto-saved\ \\tiger-nas\Multimedia\Photos\ --months 1

# 同步本地动态照片到 NAS
python sync_task.py D:\Photos\OneDrive-Photo\ \\tiger-nas\Multimedia\Photos\ --months 1
```

#### `scan_lib.py`
使用 Immich API 扫描媒体库。这对于更新媒体服务器的照片库很有用。

使用方法：
```bash
python scan_lib.py
```

### PowerShell 脚本

#### `Download-ODLivePhotosV2.ps1`
用于从 OneDrive 下载 Live Photos 的主要脚本。它处理身份验证和 Live Photos 的图像及视频组件的下载。

使用方法：
```powershell
.\Download-ODLivePhotosV2.ps1 -SaveTo "C:\Live Photos" -PathToScan "\Pictures\Camera Roll"
```

## 系统要求

- Python 3.x
- PowerShell 5.1 或更高版本
- Microsoft Edge WebView2 运行时（用于 Live Photos 下载）
- 具有 Live Photos 功能的 OneDrive 账户
- Immich 照片服务器（用于库扫描）

## 注意事项

- 脚本设计为使用年/月文件夹结构
- Live Photos 下载需要通过 OneDrive 进行身份验证
- 对于大型库，由于 OneDrive API 的限制，某些脚本可能需要运行多次
- 下载 Live Photos 时请确保有足够的存储空间，因为它们包含图像和视频文件

## 错误处理

- 脚本包含基本的错误处理，会跳过已下载的文件
- 如果 OneDrive 服务暂时不可用，您可以稍后安全地重新运行脚本
- 脚本会保持与 OneDrive 相同的原始文件夹结构