Files

T

6f0df5a774 release: v0.2.0 repository hygiene, CI, and docs sync

Stop tracking personal workflow artifacts at repo root, add CI and MIT
license, align README and agent skills with artifacts/ defaults, and
enable Ruff in dev/CI so releases are verifiable without local-only runs.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

2026-06-01 15:32:03 +08:00

1.8 KiB

Raw Blame History

Documentation Status

Synced with artifacts/ baseline on 2026-06-01.

VLM Workflow Guide

This guide details the standard end-to-end process for organizing a video library using VLM.

1. Setup and Discovery

Initialize Configuration

vlm config init

Edit ~/.vlm/config.yaml to set library_root and optionally workspace_dir: artifacts.

Library Scan

vlm scan

Goal: Create artifacts/inventory.csv.
Note: Ensure ffprobe is installed for resolution and codec metadata.

2. Identification

Filename Parsing

vlm parse --inventory artifacts/inventory.csv

Goal: Create artifacts/identities.json.
Why --inventory?: Embeds video metadata (v2 schema) required for quality-based duplicate resolution.

Metadata Enrichment

vlm enrich

Goal: Update artifacts/identities.json with TMDB data.
Troubleshooting: Check enrichment.api_keys in config; never commit ~/.vlm/config.yaml.

3. Analysis and Planning

Detect Issues

vlm analyze

Goal: Create artifacts/analysis.json.
Outputs: Episode gaps and duplicate groups.

Create Execution Plan

vlm plan --analysis artifacts/analysis.json

Goal: Create artifacts/plan.json.
Strategy: Uses plan.duplicate_keep (default: by_reputation) for duplicate decisions.

4. Review and Execution

Human review

vlm review-plan
# Optional: vlm review-plan --tui  (requires textual extra)
vlm apply-review   # after editing artifacts/plan_manual_review.csv

Execute Changes

vlm execute           # Dry-run
vlm execute --confirm # Actual operations (explicit confirmation)

Reverting Changes

vlm rollback

Restores files using the latest log in ~/.vlm/rollback/.

1.8 KiB Raw Blame History