heic_sync/README_CN.md

HEIC 同步工具

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

概述

本仓库包含一组 Python 和 PowerShell 脚本，用于：

1. 从 OneDrive 下载 Live Photos
2. 在不同位置之间同步照片
3. 扫描照片库
4. 管理照片备份

脚本说明

Python 脚本

get_onedrive_token.py

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

使用方法：

python get_onedrive_token.py

该脚本将：

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

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

run_ps_download.py

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

使用方法：

# 处理当前月份（如果是月初，还会处理上个月）
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

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

使用方法：

# 从 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 扫描媒体库。这对于更新媒体服务器的照片库很有用。

使用方法：

python scan_lib.py

PowerShell 脚本

Download-ODLivePhotosV2.ps1

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

使用方法：

.\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 相同的原始文件夹结构