media-sync

Imported from nchungdev/agent-skills (plugins/media-sync/skills/media-sync/SKILL.md). Install upstream with npx skills add nchungdev/agent-skills --skill media-sync. Copyright stays with the author.

Media Sync & Library Dispatcher Skill

Bộ kỹ năng đóng vai trò Thủ thư chuẩn hóa (Librarian) và Động cơ phân phối dữ liệu đa đích (Sync Engine): Chuẩn hóa tên file theo chuẩn Plex/TheTVDB, tự động dò tìm thư mục NAS qua SSH, điều phối truyền tải lên Google Drive (qua Rclone) và NAS, kèm cơ chế tự động xóa đệm (Auto-Purge).

🚀 Các Lệnh CLI Cốt Lõi

# 1. Báo cáo trạng thái đồng bộ (Sync Report):
python3 <skill_dir>/scripts/sync_cli.py report

# 2. Dò tìm thư mục thư viện trên NAS từ xa qua SSH:
python3 <skill_dir>/scripts/librarian_cli.py scan-nas --host "<nas-ip>" --user "<username>"

# 3. Sinh đường dẫn chuẩn Plex/TheTVDB cho tập phim:
python3 <skill_dir>/scripts/librarian_cli.py format-name --title "The Westward" --year 2018 --tvdb 371131 --season 5 --episode 1

# 4. Đồng bộ lên Google Drive (qua Rclone):
python3 <skill_dir>/scripts/sync_cli.py sync --target gdrive --source "/local/path" --remote-path "Phim/TV Shows" [--auto-purge]

# 5. Đồng bộ lên NAS lưu trữ (qua SSH/SFTP/Rsync):
python3 <skill_dir>/scripts/sync_cli.py sync --target nas --source "/local/path" --remote-path "/srv/mergerfs/MainPool/Phim" [--auto-purge]

🏛️ 1. Chuẩn Hóa Tên Thư Mục Plex / TheTVDB (Librarian)

Tự động làm sạch các tag rác torrent (1080p, WEB-DL, x265, AAC, [EMBER]) và sinh layout chuẩn:

TV Shows/
└── The Westward (2018) {tvdb-371131} {tmdb-83031}/
    └── Season 05/
        ├── The Westward - S05E01.mkv
        └── The Westward - S05E01.vi.srt

☁️ 2. Hướng Dẫn Cấu Hình & Đổi Tài Khoản Rclone

Rclone quản lý tài khoản theo Tên Remote (Remote Names):

• gdrive_plex: — Google Drive lưu trữ phim
• gdrive_personal: — Google Drive cá nhân

Đăng nhập tài khoản mới (Interactive Login):

# Máy có trình duyệt web (tự động bật tab OAuth):
rclone config create gdrive_plex drive scope drive

# Máy không có trình duyệt (Headless):
rclone config create gdrive_plex drive scope drive config_is_local false

Đổi tài khoản hoặc đăng nhập lại:

rclone config reconnect gdrive_plex:

Lưu cấu hình theo từng Workspace:

Cấu hình target của dự án được lưu tại ./.agent/storage_targets.json:

{
  "cloud_target": {
    "provider": "rclone",
    "remote_name": "gdrive_plex",
    "remote_path": "Media/Phim"
  }
}

🧹 3. Cơ Chế Auto-Purge (Giải Phóng Đĩa Cục Bộ)

Sau khi phim được tải về máy cá nhân và đẩy thành công lên NAS hoặc Google Drive:

• Thêm cờ --auto-purge để Agent tự động xóa sạch file đệm trên máy cá nhân.
• Đảm bảo laptop/PC không bao giờ bị đầy ổ cứng khi xử lý hàng trăm GB phim.

📊 4. Định Dạng Báo Cáo: media-sync report

### 📊 Báo Cáo Trạng Thái Đồng Bộ (Media Sync Dashboard)
> **Google Drive Remote**: `gdrive_plex:` | **NAS Host**: `192.168.1.50`

| Thư Mục / Series | Trạng Thái NAS | Trạng Thái Cloud (Drive) | Local Buffer |
|---|:---:|:---:|:---:|
| `The Westward/Season 01` | ✅ 16/16 tập | ✅ 16/16 tập | 🧹 Đã dọn sạch |
| `The Westward/Season 05` | ⏳ 33/64 tập | ⏳ 0/64 tập (Đang chờ) | ⚠️ Còn 12GB chưa đẩy |