vid-com 1.0.4

package/README.md

@@ -0,0 +1,228 @@
+# vid-com
+
+Video bitrate scanner & batch compressor CLI, with Sony ARW → JPEG conversion and safe interactive cleanup. Powered by FFmpeg with Apple hardware acceleration (hevc_videotoolbox).
+
+视频码率扫描 & 批量压缩 CLI 工具，含 Sony ARW → JPEG 转换及安全交互式清理。基于 FFmpeg，使用 Apple 硬件加速（hevc_videotoolbox）。
+
+## Requirements / 依赖
+
+- Node.js >= 16
+- `ffmpeg` / `ffprobe` in PATH
+- macOS (VideoToolbox hardware acceleration)
+
+```bash
+brew install ffmpeg
+```
+
+## Installation / 安装
+
+```bash
+# Global install (recommended) / 全局安装（推荐）
+npm install -g media-compress
+
+# Or run directly / 或直接运行
+node video_bitrate_tool.js <command>
+```
+
+## Commands / 命令
+
+### find — Scan for high-bitrate videos / 扫描高码率视频
+
+Scans a directory for videos exceeding a bitrate threshold and outputs a JSON list sorted by file size.
+
+扫描目录，找出码率超过阈值的视频，输出 JSON 列表，按文件大小升序排列。
+
+```bash
+vid-com find --dir <dir> [options]
+```
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--dir` | Directory to scan (required) / 扫描目录（必填） | — |
+| `--threshold` | Bitrate threshold in kbps / 码率阈值（kbps） | `4000` |
+| `--output` | Output JSON file path / 输出 JSON 文件路径 | `bitrate_list.json` |
+| `--recursive` | Recurse into subdirectories / 递归扫描子目录 | off |
+
+```bash
+vid-com find --dir ~/Videos --threshold 3000 --recursive --output dji.json
+```
+
+Output JSON format / 输出 JSON 格式：
+```json
+[
+  {
+    "path": "/absolute/path/to/video.mp4",
+    "bitrate_kbps": 12800,
+    "size_mb": 3200.00
+  }
+]
+```
+
+---
+
+### compress — Batch compress / 批量压缩
+
+Reads the JSON list from `find`, compresses files sequentially with a real-time progress bar.
+
+读取 `find` 输出的 JSON 列表，串行压缩，实时显示进度条。
+
+```bash
+vid-com compress --input <json-file> [options]
+```
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--input` | JSON list file (required) / JSON 列表文件（必填） | — |
+| `--outdir` | Output directory / 输出目录 | same as source / 原文件同目录 |
+| `--suffix` | Output filename suffix / 文件名后缀 | `_compressed` |
+| `-q` / `--quality` | Quality value 0–100, higher is better / 画质值（越高越好） | `65` |
+| `--target` | Fixed bitrate in kbps, overrides `-q` / 固定码率，指定后忽略 `-q` | — |
+| `--audio` | Audio bitrate in kbps / 音频码率（kbps） | `128` |
+
+**Encoder notes / 编码说明：**
+- Encoder / 编码器: `hevc_videotoolbox` (Apple hardware H.265)
+- Decoder / 解码器: `videotoolbox` (hardware decode, lower CPU load)
+- Pixel format / 像素格式: `nv12` (native VideoToolbox format)
+- Codec tag / codec tag: `hvc1` (QuickTime / Final Cut / iOS compatible)
+
+```bash
+# Quality mode (default, recommended) / 画质模式（默认，推荐）
+vid-com compress --input dji.json --outdir ./out
+
+# Fixed bitrate mode / 固定码率模式
+vid-com compress --input dji.json --target 8000 --outdir ./out
+
+# Custom quality and audio bitrate / 自定义画质和音频码率
+vid-com compress --input dji.json -q 50 --outdir ./out --suffix _h265 --audio 192
+```
+
+Progress bar example / 进度条示例：
+```
+▶  [3/79]  DJI_20260328141509_0169_D.MP4
+   Source bitrate: 110001 kbps  →  Quality -q:v 65
+   Output: /Volumes/QWER/out/DJI_20260328141509_0169_D_compressed.MP4
+   [████████████░░░░░░░░░░░░░░░░░░]  42.3%  3.2x      ETA 87s
+```
+
+---
+
+### delete — Verify and delete original videos / 校验后删除原始视频
+
+Reads the `find` JSON list, locates the `_compressed.MP4` counterpart in the same directory, verifies source metadata via `ffprobe`, then prompts for deletion.
+
+读取 JSON 列表，查找同目录下的 `_compressed.MP4`，通过 `ffprobe` 验证源信息后询问删除。
+
+```bash
+vid-com delete [--input <json-file>]
+```
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--input` | JSON list from `find` / `find` 输出的 JSON | `my_list.json` |
+
+Source metadata checks / 源信息对比（`ffprobe`）：
+- **Duration / 时长**: difference must be ≤ 1 second / 差值须 ≤ 1 秒
+- **Capture time / 拍摄时间**: `creation_time` must match exactly (preserved via `-map_metadata 0`)
+- Any mismatch → auto-skipped, no deletion prompt / 任一不匹配则自动跳过
+
+```
+[3/79]
+  Original  : /Volumes/QWER/DJI_0169.MP4
+  Orig size : 3200.00 MB
+  Compressed: /Volumes/QWER/DJI_0169_compressed.MP4
+  Comp size : 800.00 MB
+  Saved     : 2400.00 MB (75.0%)
+  Duration  : 42.3s → 42.3s  ✓
+  Captured  : 2026-03-28T14:15:09.000000Z  ✓
+  Delete original? [y = yes / other = skip]: y
+  -> DELETED
+```
+
+---
+
+### arw-convert — Sony ARW to JPEG / Sony ARW 转 JPEG
+
+Batch-converts Sony `.arw` RAW files to JPEG using macOS built-in `sips` with multi-threaded parallel processing.
+
+批量将索尼 `.arw` RAW 文件转换为 JPEG，使用 macOS 内置 `sips` 多线程并发处理。
+
+```bash
+vid-com arw-convert <source-dir> [output-dir]
+```
+
+| Argument | Description | Default |
+|----------|-------------|---------|
+| `<source-dir>` | Directory containing `.arw` files, searched recursively / 含 `.arw` 文件的目录（递归查找） | required |
+| `[output-dir]` | JPEG output directory, flat (no subdirectory structure) / JPEG 输出目录（平级输出） | `./converted_jpgs` |
+
+- Concurrency / 并发数: CPU cores − 1
+- Output quality / 输出质量: JPEG quality 90
+- Dependency / 依赖: macOS built-in `sips`, no extra install needed / macOS 内置，无需额外安装
+
+```bash
+vid-com arw-convert /Volumes/Untitled/DCIM /Volumes/QWER/out
+```
+
+---
+
+### arw-delete — Verify and delete ARW originals / 校验后删除 ARW 原始文件
+
+Scans a directory for `.arw` files, finds a same-named `.jpg`, verifies pixel dimensions via `sips`, then prompts for deletion of the ARW.
+
+扫描目录下所有 `.arw` 文件，查找同名 `.jpg`，通过 `sips` 验证像素尺寸后询问删除 ARW。
+
+```bash
+vid-com arw-delete --dir <dir>
+```
+
+| Option | Description |
+|--------|-------------|
+| `--dir` | Directory containing `.arw` files (required) / 含 `.arw` 文件的目录（必填） |
+
+Source metadata check / 源信息对比（`sips`）：
+- **Pixel dimensions / 像素尺寸**: width × height must match exactly / 必须完全一致
+- Missing JPG or dimension mismatch → auto-skipped / JPG 不存在或尺寸不匹配则自动跳过
+
+```
+[12/80]
+  ARW  : DSC00169.ARW
+  Size : 24.50 MB
+  JPG  : DSC00169.jpg  (8.20 MB)
+  Dims : 7952×5304 vs 7952×5304  ✓
+  Delete ARW? [y = yes / other = skip]: y
+  -> DELETED
+```
+
+---
+
+## Typical workflow / 典型工作流
+
+```bash
+# Video workflow / 视频工作流
+vid-com find --dir ~/Videos --recursive --output /tmp/list.json
+vid-com compress --input /tmp/list.json --outdir ~/Videos/out
+vid-com delete --input /tmp/list.json
+
+# ARW workflow / ARW 工作流
+vid-com arw-convert /Volumes/Untitled/DCIM /Volumes/QWER/out
+vid-com arw-delete --dir /Volumes/Untitled/DCIM
+```
+
+---
+
+## Quality reference / 画质参考（-q:v）
+
+| `-q` value | Effect / 效果 |
+|------------|---------------|
+| 80–90 | Near-lossless, large file / 接近无损，文件较大 |
+| 60–70 | Balanced quality/size (recommended) / 画质/尺寸均衡（推荐） |
+| 45–55 | Noticeable compression, archive use / 明显压缩，适合纯归档 |
+| < 40 | Visible quality loss / 肉眼可见质量损失 |
+
+---
+
+## Help / 帮助
+
+```bash
+vid-com --help
+```

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "vid-com",
+  "version": "1.0.4",
+  "description": "Video bitrate scanner & batch compressor with ARW→JPEG conversion (macOS, FFmpeg, hevc_videotoolbox)",
+  "main": "video_bitrate_tool.js",
+  "bin": {
+    "vid-com": "./video_bitrate_tool.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/check-deps.js"
+  },
+  "keywords": [
+    "video",
+    "ffmpeg",
+    "compress",
+    "bitrate"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=16",
+    "ffmpeg": ">=4.0 (install via: brew install ffmpeg)"
+  }
+}

package/scripts/arw_to_jpg.sh

@@ -0,0 +1,56 @@
+#!/bin/bash
+
+# 1. 处理输入参数
+if [ -z "$1" ]; then
+    echo "用法: $0 <源目录> [输出目录]"
+    exit 1
+fi
+
+SOURCE_DIR="$1"
+OUTPUT_DIR="${2:-./converted_jpgs}"
+
+# 2. 检查源目录是否存在
+if [ ! -d "$SOURCE_DIR" ]; then
+    echo "错误: 源目录 '$SOURCE_DIR' 不存在。"
+    exit 1
+fi
+
+mkdir -p "$OUTPUT_DIR"
+
+# 3. 计算并发数：当前 CPU 数量 - 1 (最少为 1)
+CPU_CORES=$(sysctl -n hw.ncpu)
+THREADS=$((CPU_CORES > 1 ? CPU_CORES - 1 : 1))
+
+echo "------------------------------------------"
+echo "系统 CPU 核心数: $CPU_CORES"
+echo "并发线程数: $THREADS"
+echo "正在开始平级转换..."
+echo "------------------------------------------"
+
+# 4. 定义转换函数并导出，以便 xargs 调用
+# 使用 export -f 需要在脚本环境运行
+do_convert() {
+    local src_file="$1"
+    local out_dir="$2"
+    
+    # 获取纯文件名 (不带路径)
+    local filename=$(basename "$src_file")
+    # 构造目标路径 (平级输出)
+    local target_file="$out_dir/${filename%.*}.jpg"
+    
+    echo "正在转换: $filename"
+    
+    # 执行转换
+    sips -s format jpeg -s formatOptions 90 "$src_file" --out "$target_file" > /dev/null 2>&1
+}
+
+export -f do_convert
+
+# 5. 使用 find + xargs 进行多线程处理
+# -0: 处理带空格的文件名
+# -P: 并发数
+# -I: 占位符
+find "$SOURCE_DIR" -type f -iname "*.arw" -print0 | xargs -0 -I {} -P "$THREADS" bash -c "do_convert '{}' '$OUTPUT_DIR'"
+
+echo "------------------------------------------"
+echo "转换完成！所有文件已输出到: $OUTPUT_DIR"

package/scripts/batch_delete.js

@@ -0,0 +1,347 @@
+#!/usr/bin/env node
+
+/**
+ * batch_delete.js
+ *
+ * 用法：
+ *   node scripts/batch_delete.js [--input <json>]          # 视频模式（默认）
+ *   node scripts/batch_delete.js --mode arw --dir <目录>   # ARW 模式
+ */
+
+const fs       = require('fs');
+const path     = require('path');
+const readline = require('readline');
+const { execSync } = require('child_process');
+
+// ─── 参数解析 ─────────────────────────────────────────────────────────────────
+
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i].startsWith('--')) {
+      const key = argv[i].slice(2);
+      args[key] = argv[i + 1] && !argv[i + 1].startsWith('-') ? argv[++i] : true;
+    }
+  }
+  return args;
+}
+
+const args = parseArgs(process.argv.slice(2));
+const MODE = (args.mode || 'video').toLowerCase();
+
+// ─── 共用工具 ─────────────────────────────────────────────────────────────────
+
+function formatSize(bytes) {
+  return (bytes / 1024 / 1024).toFixed(2) + ' MB';
+}
+
+function getFileSizeBytes(filePath) {
+  try { return fs.statSync(filePath).size; } catch { return null; }
+}
+
+/** 单键确认（TTY），或换行输入（非 TTY） */
+function askKey(question) {
+  return new Promise((resolve) => {
+    process.stdout.write(question);
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.once('data', (buf) => {
+        const key = buf.toString();
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write(key === '\r' || key === '\n' ? '\n' : key + '\n');
+        resolve(key);
+      });
+    } else {
+      const rl = readline.createInterface({ input: process.stdin, terminal: false });
+      rl.once('line', (line) => { rl.close(); resolve(line.trim()); });
+    }
+  });
+}
+
+// ─── 视频模式 ─────────────────────────────────────────────────────────────────
+
+/** 在同目录下找 *_compressed.MP4（大小写不敏感） */
+function getCompressedVideoPath(originalPath) {
+  const dir  = path.dirname(originalPath);
+  const ext  = path.extname(originalPath);
+  const base = path.basename(originalPath, ext);
+  const pattern = new RegExp(
+    '^' + base.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '_compressed\\.[mM][pP]4$'
+  );
+  try {
+    const match = fs.readdirSync(dir).find((f) => pattern.test(f));
+    return match ? path.join(dir, match) : path.join(dir, base + '_compressed.MP4');
+  } catch {
+    return path.join(dir, base + '_compressed.MP4');
+  }
+}
+
+/** 用 ffprobe 读取视频元信息：creation_time + duration */
+function getVideoMeta(filePath) {
+  try {
+    const raw = execSync(
+      `ffprobe -v error \
+        -show_entries format_tags=creation_time \
+        -show_entries format=duration \
+        -of json "${filePath}"`,
+      { stdio: ['pipe', 'pipe', 'pipe'] }
+    ).toString().trim();
+    const obj = JSON.parse(raw);
+    return {
+      creation_time: obj.format?.tags?.creation_time || null,
+      duration:      parseFloat(obj.format?.duration) || null,
+    };
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 对比原始视频与压缩视频的源信息
+ * @returns {{ match: boolean|null, lines: string[] }}
+ */
+function checkVideoSourceMatch(origPath, compPath) {
+  const origMeta = getVideoMeta(origPath);
+  const compMeta = getVideoMeta(compPath);
+  const lines    = [];
+
+  if (!origMeta || !compMeta) {
+    return { match: null, lines: ['  源信息  : 无法读取（ffprobe 失败），跳过验证'] };
+  }
+
+  let match = true;
+
+  // 时长对比（±1s 容差）
+  if (origMeta.duration !== null && compMeta.duration !== null) {
+    const diff = Math.abs(origMeta.duration - compMeta.duration);
+    const ok   = diff <= 1.0;
+    lines.push(`  时长     : ${origMeta.duration.toFixed(1)}s → ${compMeta.duration.toFixed(1)}s  ${ok ? '✓' : '✗ 不匹配'}`);
+    if (!ok) match = false;
+  }
+
+  // 拍摄时间对比
+  if (origMeta.creation_time && compMeta.creation_time) {
+    const ok = origMeta.creation_time === compMeta.creation_time;
+    lines.push(`  拍摄时间 : ${origMeta.creation_time}  ${ok ? '✓' : '✗ 不匹配'}`);
+    if (!ok) match = false;
+  }
+
+  if (lines.length === 0) {
+    lines.push('  源信息  : 无可用元数据，跳过验证');
+    return { match: null, lines };
+  }
+
+  return { match, lines };
+}
+
+async function runVideoMode(jsonFile) {
+  if (!fs.existsSync(jsonFile)) {
+    console.error(`File not found: ${jsonFile}`);
+    process.exit(1);
+  }
+
+  const list = JSON.parse(fs.readFileSync(jsonFile, 'utf-8'));
+  if (!Array.isArray(list) || list.length === 0) {
+    console.log('No entries found in JSON.');
+    process.exit(0);
+  }
+
+  let deleted = 0, skipped = 0, noCompressed = 0, mismatch = 0;
+  console.log(`Processing ${list.length} file(s) from: ${jsonFile}\n`);
+
+  for (let i = 0; i < list.length; i++) {
+    const item     = list[i];
+    const origPath = item.path;
+    const compPath = getCompressedVideoPath(origPath);
+
+    console.log(`[${i + 1}/${list.length}]`);
+    console.log(`  Original  : ${origPath}`);
+
+    const origSize = getFileSizeBytes(origPath);
+    if (origSize === null) {
+      console.log(`  Original  : NOT FOUND, skipping\n`);
+      skipped++;
+      continue;
+    }
+    console.log(`  Orig size : ${formatSize(origSize)}`);
+
+    const compSize = getFileSizeBytes(compPath);
+    if (compSize === null) {
+      console.log(`  Compressed: NOT FOUND (${path.basename(compPath)}), skipping\n`);
+      noCompressed++;
+      continue;
+    }
+
+    console.log(`  Compressed: ${compPath}`);
+    console.log(`  Comp size : ${formatSize(compSize)}`);
+    console.log(`  Saved     : ${formatSize(origSize - compSize)} (${(((origSize - compSize) / origSize) * 100).toFixed(1)}%)`);
+
+    // 源信息对比
+    const { match, lines } = checkVideoSourceMatch(origPath, compPath);
+    lines.forEach((l) => console.log(l));
+
+    if (match === false) {
+      console.log('  -> 源信息不匹配，自动跳过\n');
+      mismatch++;
+      continue;
+    }
+
+    const key = await askKey('  Delete original? [y = yes / other = skip]: ');
+    if (key.toLowerCase() === 'y') {
+      try {
+        fs.unlinkSync(origPath);
+        console.log('  -> DELETED\n');
+        deleted++;
+      } catch (err) {
+        console.error(`  -> FAILED: ${err.message}\n`);
+      }
+    } else {
+      console.log('  -> Skipped\n');
+      skipped++;
+    }
+  }
+
+  console.log('─'.repeat(50));
+  console.log(`Deleted: ${deleted}  |  Skipped: ${skipped}  |  No compressed: ${noCompressed}  |  Mismatch: ${mismatch}`);
+}
+
+// ─── ARW 模式 ─────────────────────────────────────────────────────────────────
+
+/** 用 sips 读取图片尺寸（支持 ARW / JPG） */
+function getImageDimensions(filePath) {
+  try {
+    const out = execSync(
+      `sips -g pixelWidth -g pixelHeight "${filePath}"`,
+      { stdio: ['pipe', 'pipe', 'pipe'] }
+    ).toString();
+    const w = out.match(/pixelWidth:\s*(\d+)/)?.[1];
+    const h = out.match(/pixelHeight:\s*(\d+)/)?.[1];
+    if (w && h) return { width: parseInt(w, 10), height: parseInt(h, 10) };
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/** 在同目录下查找同名的 .jpg / .jpeg（大小写不敏感） */
+function findJpgForArw(arwPath) {
+  const dir  = path.dirname(arwPath);
+  const base = path.basename(arwPath, path.extname(arwPath)).toLowerCase();
+  try {
+    const match = fs.readdirSync(dir).find((f) => {
+      const fExt  = path.extname(f).toLowerCase();
+      const fBase = path.basename(f, path.extname(f)).toLowerCase();
+      return fBase === base && (fExt === '.jpg' || fExt === '.jpeg');
+    });
+    return match ? path.join(dir, match) : null;
+  } catch {
+    return null;
+  }
+}
+
+/** 列出目录下所有 .arw 文件（不递归） */
+function listArwFiles(dir) {
+  try {
+    return fs.readdirSync(dir, { withFileTypes: true })
+      .filter((e) => e.isFile() && path.extname(e.name).toLowerCase() === '.arw')
+      .map((e) => path.join(dir, e.name));
+  } catch {
+    return [];
+  }
+}
+
+async function runArwMode(dir) {
+  const arwFiles = listArwFiles(dir);
+  if (arwFiles.length === 0) {
+    console.log(`未找到 .arw 文件：${dir}`);
+    process.exit(0);
+  }
+
+  let deleted = 0, skipped = 0, noJpg = 0, mismatch = 0;
+  console.log(`扫描到 ${arwFiles.length} 个 .arw 文件，目录：${dir}\n`);
+
+  for (let i = 0; i < arwFiles.length; i++) {
+    const arwPath = arwFiles[i];
+    const jpgPath = findJpgForArw(arwPath);
+
+    console.log(`[${i + 1}/${arwFiles.length}]`);
+    console.log(`  ARW  : ${path.basename(arwPath)}`);
+
+    const arwSize = getFileSizeBytes(arwPath);
+    if (arwSize === null) {
+      console.log(`  ARW  : NOT FOUND, skipping\n`);
+      skipped++;
+      continue;
+    }
+    console.log(`  大小 : ${formatSize(arwSize)}`);
+
+    if (!jpgPath) {
+      console.log(`  JPG  : NOT FOUND，跳过\n`);
+      noJpg++;
+      continue;
+    }
+
+    const jpgSize = getFileSizeBytes(jpgPath);
+    console.log(`  JPG  : ${path.basename(jpgPath)}  (${formatSize(jpgSize ?? 0)})`);
+
+    // 源信息对比：像素尺寸
+    const arwDim = getImageDimensions(arwPath);
+    const jpgDim = getImageDimensions(jpgPath);
+
+    if (!arwDim || !jpgDim) {
+      console.log(`  尺寸 : 无法读取（sips 失败），跳过\n`);
+      mismatch++;
+      continue;
+    }
+
+    const dimMatch = arwDim.width === jpgDim.width && arwDim.height === jpgDim.height;
+    console.log(
+      `  尺寸 : ${arwDim.width}×${arwDim.height} vs ${jpgDim.width}×${jpgDim.height}  ${dimMatch ? '✓' : '✗ 不匹配'}`
+    );
+
+    if (!dimMatch) {
+      console.log(`  -> 尺寸不匹配，自动跳过\n`);
+      mismatch++;
+      continue;
+    }
+
+    const key = await askKey('  Delete ARW? [y = yes / other = skip]: ');
+    if (key.toLowerCase() === 'y') {
+      try {
+        fs.unlinkSync(arwPath);
+        console.log('  -> DELETED\n');
+        deleted++;
+      } catch (err) {
+        console.error(`  -> FAILED: ${err.message}\n`);
+      }
+    } else {
+      console.log('  -> Skipped\n');
+      skipped++;
+    }
+  }
+
+  console.log('─'.repeat(50));
+  console.log(`Deleted: ${deleted}  |  Skipped: ${skipped}  |  No JPG: ${noJpg}  |  Mismatch: ${mismatch}`);
+}
+
+// ─── 入口 ─────────────────────────────────────────────────────────────────────
+
+if (MODE === 'arw') {
+  const dir = args.dir;
+  if (!dir) {
+    console.error('ARW 模式需要 --dir 指定目录');
+    process.exit(1);
+  }
+  if (!fs.existsSync(dir)) {
+    console.error(`目录不存在：${dir}`);
+    process.exit(1);
+  }
+  runArwMode(path.resolve(dir)).catch((err) => { console.error(err); process.exit(1); });
+} else {
+  // 兼容旧版位置参数（node batch_delete.js my_list.json）
+  const positional = process.argv.slice(2).find((a) => !a.startsWith('-'));
+  const jsonFile   = args.input || positional || path.join(__dirname, '../my_list.json');
+  runVideoMode(jsonFile).catch((err) => { console.error(err); process.exit(1); });
+}

package/scripts/check-deps.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+
+const { execSync } = require("child_process");
+
+const deps = ["ffmpeg", "ffprobe"];
+let missing = false;
+
+for (const bin of deps) {
+  try {
+    execSync(`which ${bin}`, { stdio: "ignore" });
+  } catch {
+    console.warn(`\n⚠️  未找到 ${bin}，请先安装：brew install ffmpeg\n`);
+    missing = true;
+  }
+}
+
+if (missing) process.exit(1);

package/video_bitrate_tool.js

@@ -0,0 +1,708 @@
+#!/usr/bin/env node
+
+/**
+ * video_bitrate_tool.js
+ * 
+ * 功能：
+ *   mode 1 (find)     - 扫描目录，找出码率超过阈值的视频，输出 JSON 列表
+ *   mode 2 (compress) - 读取 JSON 列表，用 FFmpeg 将视频压缩到目标码率
+ * 
+ * 用法：
+ *   node video_bitrate_tool.js find   --dir /path/to/videos --threshold 4000 [--output list.json] [--recursive]
+ *   node video_bitrate_tool.js compress --input list.json --target 2000 [--outdir /path/to/output] [--suffix _compressed]
+ * 
+ * 依赖：ffprobe / ffmpeg（需已安装并在 PATH 中）
+ */
+
+const { execSync, spawn, spawnSync } = require("child_process");
+const readline = require("readline");
+const fs   = require("fs");
+const path = require("path");
+
+// ─── 工具函数 ────────────────────────────────────────────────────────────────
+
+/** 递归或单层列出目录中的文件 */
+function listFiles(dir, recursive) {
+  let results = [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory() && recursive) {
+      results = results.concat(listFiles(full, recursive));
+    } else if (entry.isFile()) {
+      results.push(full);
+    }
+  }
+  return results;
+}
+
+/** 视频扩展名白名单 */
+const VIDEO_EXTS = new Set([
+  ".mp4", ".mkv", ".avi", ".wmv",
+  ".flv", ".webm", ".m4v", ".ts", ".mts", ".m2ts",
+]);
+
+function isVideo(filePath) {
+  return VIDEO_EXTS.has(path.extname(filePath).toLowerCase());
+}
+
+/**
+ * 用 ffprobe 获取视频码率（kbps）
+ * 返回 null 表示无法读取
+ */
+function getVideoBitrate(filePath) {
+  try {
+    const raw = execSync(
+      `ffprobe -v error -select_streams v:0 -show_entries stream=bit_rate ` +
+      `-of default=noprint_wrappers=1:nokey=1 "${filePath}"`,
+      { stdio: ["pipe", "pipe", "pipe"] }
+    ).toString().trim();
+
+    let kbps = parseInt(raw, 10);
+    if (!isNaN(kbps) && kbps > 0) return Math.round(kbps / 1000);
+
+    // 回退：读取容器级别码率
+    const raw2 = execSync(
+      `ffprobe -v error -show_entries format=bit_rate ` +
+      `-of default=noprint_wrappers=1:nokey=1 "${filePath}"`,
+      { stdio: ["pipe", "pipe", "pipe"] }
+    ).toString().trim();
+    kbps = parseInt(raw2, 10);
+    return (!isNaN(kbps) && kbps > 0) ? Math.round(kbps / 1000) : null;
+  } catch {
+    return null;
+  }
+}
+
+/** 格式化文件大小 */
+function fmtSize(bytes) {
+  if (bytes >= 1e9) return (bytes / 1e9).toFixed(2) + " GB";
+  if (bytes >= 1e6) return (bytes / 1e6).toFixed(2) + " MB";
+  return (bytes / 1e3).toFixed(2) + " KB";
+}
+
+// ─── 解析命令行参数 ──────────────────────────────────────────────────────────
+
+function parseArgs(argv) {
+  const args = {};
+  for (let i = 0; i < argv.length; i++) {
+    const isLong  = argv[i].startsWith("--");
+    const isShort = !isLong && argv[i].startsWith("-") && argv[i].length === 2;
+    if (isLong || isShort) {
+      const key = isLong ? argv[i].slice(2) : argv[i].slice(1);
+      args[key] = argv[i + 1] && !argv[i + 1].startsWith("-") ? argv[++i] : true;
+    }
+  }
+  return args;
+}
+
+// ─── Mode 1: find ────────────────────────────────────────────────────────────
+
+function runFind(args) {
+  const dir       = args.dir;
+  const threshold = parseInt(args.threshold || "4000", 10); // kbps
+  const outFile   = args.output || "bitrate_list.json";
+  const recursive = !!args.recursive;
+
+  if (!dir) {
+    console.error("❌  请用 --dir 指定扫描目录");
+    process.exit(1);
+  }
+  if (!fs.existsSync(dir)) {
+    console.error(`❌  目录不存在：${dir}`);
+    process.exit(1);
+  }
+
+  console.log(`\n🔍  扫描目录：${path.resolve(dir)}`);
+  console.log(`📊  码率阈值：${threshold} kbps  |  递归：${recursive}\n`);
+
+  const files  = listFiles(dir, recursive).filter(isVideo);
+  const result = [];
+
+  for (const file of files) {
+    process.stdout.write(`  检测：${path.basename(file)} ... `);
+    const kbps = getVideoBitrate(file);
+    if (kbps === null) {
+      console.log("⚠️  无法读取码率，跳过");
+      continue;
+    }
+    const size = fs.statSync(file).size;
+    if (kbps > threshold) {
+      console.log(`✅  ${kbps} kbps  (${fmtSize(size)})`);
+      result.push({ path: path.resolve(file), bitrate_kbps: kbps, size_mb: parseFloat((size / 1e6).toFixed(2)) });
+    } else {
+      console.log(`——  ${kbps} kbps，未超阈值`);
+    }
+  }
+
+  console.log(`\n📋  共找到 ${result.length} 个超标视频`);
+
+  result.sort((a, b) => a.size_mb - b.size_mb);
+  fs.writeFileSync(outFile, JSON.stringify(result, null, 2), "utf8");
+  console.log(`💾  已保存到：${path.resolve(outFile)}`);
+  console.log(`\n下一步：\n  vid-com compress --input ${outFile} --target 2000\n`);
+}
+
+// ─── Mode 2: compress ────────────────────────────────────────────────────────
+
+
+/** 用 ffprobe 获取视频时长（秒），失败返回 0 */
+function getVideoDuration(filePath) {
+  try {
+    const raw = execSync(
+      `ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "${filePath}"`,
+      { stdio: ["pipe", "pipe", "pipe"] }
+    ).toString().trim();
+    const sec = parseFloat(raw);
+    return isNaN(sec) ? 0 : sec;
+  } catch {
+    return 0;
+  }
+}
+
+/** 渲染进度条到当前行 */
+function renderProgress(pct, speed, eta) {
+  const WIDTH = 30;
+  const filled = Math.round(WIDTH * pct / 100);
+  const bar = "█".repeat(filled) + "░".repeat(WIDTH - filled);
+  const etaStr = eta > 0 ? `ETA ${Math.ceil(eta)}s` : "ETA --";
+  process.stdout.write(`\r   [${bar}] ${pct.toFixed(1).padStart(5)}%  ${speed.padEnd(8)}  ${etaStr}   `);
+}
+
+/** 压缩单个文件，返回 Promise */
+function compressOne(srcPath, destPath, targetKbps, qualityVal, audioKbps, durationSec) {
+  return new Promise((resolve, reject) => {
+    // targetKbps === null 表示使用 quality 模式
+    const videoArgs = targetKbps !== null
+      ? ["-b:v", `${targetKbps}k`]
+      : ["-q:v", String(qualityVal)];
+
+    const ffmpegArgs = [
+      "-y",
+      "-hwaccel", "videotoolbox",   // 硬件解码
+      "-i", srcPath,
+      "-progress", "pipe:1",        // 结构化进度 → stdout
+      "-nostats",
+      "-c:v", "hevc_videotoolbox",  // 硬件编码 H.265
+      "-tag:v", "hvc1",             // QuickTime/Apple 兼容 tag
+      "-pix_fmt", "nv12",           // 与 videotoolbox 原生格式对齐，避免色彩转换
+      ...videoArgs,
+      "-map_metadata", "0",         // 保留原始 meta（创建时间、GPS 等）
+      "-c:a", "aac",
+      "-b:a", `${audioKbps}k`,
+      "-movflags", "+faststart",
+      destPath,
+    ];
+
+    const proc = spawn("ffmpeg", ffmpegArgs, { stdio: ["ignore", "pipe", "ignore"] });
+
+    const startTime = Date.now();
+    let buf = "";
+
+    proc.stdout.on("data", (chunk) => {
+      buf += chunk.toString();
+      const lines = buf.split("\n");
+      buf = lines.pop(); // 保留不完整的最后一行
+
+      let outTimeMs = -1, speed = "";
+      for (const line of lines) {
+        if (line.startsWith("out_time_ms=")) outTimeMs = parseInt(line.slice(12), 10);
+        if (line.startsWith("speed="))       speed = line.slice(6).trim();
+      }
+
+      if (outTimeMs > 0 && durationSec > 0) {
+        const pct = Math.min((outTimeMs / 1e6 / durationSec) * 100, 100);
+        const elapsed = (Date.now() - startTime) / 1000;
+        const eta = pct > 0 ? (elapsed / pct) * (100 - pct) : 0;
+        renderProgress(pct, speed, eta);
+      }
+    });
+
+    proc.on("close", (code) => {
+      process.stdout.write("\n");
+      if (code === 0) resolve();
+      else reject(new Error(`ffmpeg 退出码 ${code}`));
+    });
+
+    proc.on("error", reject);
+  });
+}
+
+async function runCompress(args) {
+  const inputFile      = args.input;
+  const fixedTargetKbps = args.target ? parseInt(args.target, 10) : null;
+  const qualityVal      = args.quality ?? args.q ?? "65"; // -q / --quality，默认 65
+  const outDir         = args.outdir || null;
+  const suffix         = args.suffix || "_compressed";
+  const audioKbps      = args.audio  || "128";
+
+  if (!inputFile) {
+    console.error("❌  请用 --input 指定 JSON 列表文件");
+    process.exit(1);
+  }
+  if (!fs.existsSync(inputFile)) {
+    console.error(`❌  文件不存在：${inputFile}`);
+    process.exit(1);
+  }
+
+  const list = JSON.parse(fs.readFileSync(inputFile, "utf8"));
+  if (!Array.isArray(list) || list.length === 0) {
+    console.log("⚠️  列表为空，无需处理");
+    return;
+  }
+
+  if (outDir) fs.mkdirSync(outDir, { recursive: true });
+
+  const modeDesc = fixedTargetKbps ? `固定码率 ${fixedTargetKbps} kbps` : `Quality 模式（-q:v ${qualityVal}）`;
+  console.log(`\n🎬  开始压缩  |  ${modeDesc}  |  编码：hevc_videotoolbox\n`);
+
+  let done = 0, failed = 0;
+
+  for (let i = 0; i < list.length; i++) {
+    const item    = list[i];
+    const srcPath = item.path || item;
+
+    if (!fs.existsSync(srcPath)) {
+      console.warn(`⚠️  文件不存在，跳过：${srcPath}`);
+      failed++;
+      continue;
+    }
+
+    const ext      = path.extname(srcPath);
+    const base     = path.basename(srcPath, ext);
+    const destDir  = outDir || path.dirname(srcPath);
+    const destPath = path.join(destDir, base + suffix + ext);
+
+    // fixedTargetKbps 有值时用固定码率，否则用 quality 模式（targetKbps = null）
+    const targetKbps = fixedTargetKbps ?? null;
+
+    console.log(`▶  [${i + 1}/${list.length}]  ${path.basename(srcPath)}`);
+    console.log(`   原始码率：${item.bitrate_kbps ?? "?"} kbps  →  ${targetKbps !== null ? `${targetKbps} kbps` : `Quality -q:v ${qualityVal}`}`);
+    console.log(`   输出：${destPath}`);
+
+    const durationSec = getVideoDuration(srcPath);
+    const startTime   = Date.now();
+
+    try {
+      await compressOne(srcPath, destPath, targetKbps, qualityVal, audioKbps, durationSec);
+
+      const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
+      const newSize = fs.statSync(destPath).size;
+      const oldSize = item.size_mb != null ? item.size_mb * 1e6 : fs.statSync(srcPath).size;
+      const ratio   = ((1 - newSize / oldSize) * 100).toFixed(1);
+
+      console.log(`   ✅  完成  耗时 ${elapsed}s  ${fmtSize(oldSize)} → ${fmtSize(newSize)}  压缩率 ${ratio}%\n`);
+      done++;
+    } catch (err) {
+      console.error(`   ❌  失败：${err.message}\n`);
+      failed++;
+    }
+  }
+
+  console.log(`\n🏁  全部完成：成功 ${done} 个，失败 ${failed} 个\n`);
+}
+
+// ─── 共用删除工具 ─────────────────────────────────────────────────────────────
+
+function getFileSizeBytes(filePath) {
+  try { return fs.statSync(filePath).size; } catch { return null; }
+}
+
+function askKey(question) {
+  return new Promise((resolve) => {
+    process.stdout.write(question);
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+      process.stdin.resume();
+      process.stdin.once("data", (buf) => {
+        const key = buf.toString();
+        process.stdin.setRawMode(false);
+        process.stdin.pause();
+        process.stdout.write(key === "\r" || key === "\n" ? "\n" : key + "\n");
+        resolve(key);
+      });
+    } else {
+      const rl = readline.createInterface({ input: process.stdin, terminal: false });
+      rl.once("line", (line) => { rl.close(); resolve(line.trim()); });
+    }
+  });
+}
+
+// ─── Mode 3: delete ───────────────────────────────────────────────────────────
+
+function getCompressedVideoPath(originalPath) {
+  const dir  = path.dirname(originalPath);
+  const ext  = path.extname(originalPath);
+  const base = path.basename(originalPath, ext);
+  const pattern = new RegExp(
+    "^" + base.replace(/[.*+?^${}()|[\]\\]/g, "\\$&") + "_compressed\\.[mM][pP]4$"
+  );
+  try {
+    const match = fs.readdirSync(dir).find((f) => pattern.test(f));
+    return match ? path.join(dir, match) : path.join(dir, base + "_compressed.MP4");
+  } catch {
+    return path.join(dir, base + "_compressed.MP4");
+  }
+}
+
+function getVideoMeta(filePath) {
+  try {
+    const raw = execSync(
+      `ffprobe -v error \
+        -show_entries format_tags=creation_time \
+        -show_entries format=duration \
+        -of json "${filePath}"`,
+      { stdio: ["pipe", "pipe", "pipe"] }
+    ).toString().trim();
+    const obj = JSON.parse(raw);
+    return {
+      creation_time: obj.format?.tags?.creation_time || null,
+      duration:      parseFloat(obj.format?.duration) || null,
+    };
+  } catch {
+    return null;
+  }
+}
+
+function checkVideoSourceMatch(origPath, compPath) {
+  const origMeta = getVideoMeta(origPath);
+  const compMeta = getVideoMeta(compPath);
+  const lines    = [];
+
+  if (!origMeta || !compMeta) {
+    return { match: null, lines: ["  源信息  : 无法读取（ffprobe 失败），跳过验证"] };
+  }
+
+  let match = true;
+
+  if (origMeta.duration !== null && compMeta.duration !== null) {
+    const diff = Math.abs(origMeta.duration - compMeta.duration);
+    const ok   = diff <= 1.0;
+    lines.push(`  时长     : ${origMeta.duration.toFixed(1)}s → ${compMeta.duration.toFixed(1)}s  ${ok ? "✓" : "✗ 不匹配"}`);
+    if (!ok) match = false;
+  }
+
+  if (origMeta.creation_time && compMeta.creation_time) {
+    const ok = origMeta.creation_time === compMeta.creation_time;
+    lines.push(`  拍摄时间 : ${origMeta.creation_time}  ${ok ? "✓" : "✗ 不匹配"}`);
+    if (!ok) match = false;
+  }
+
+  if (lines.length === 0) {
+    lines.push("  源信息  : 无可用元数据，跳过验证");
+    return { match: null, lines };
+  }
+
+  return { match, lines };
+}
+
+async function runDelete(args, rest) {
+  const positional = rest.find((a) => !a.startsWith("-"));
+  const jsonFile   = args.input || positional || path.join(__dirname, "my_list.json");
+
+  if (!fs.existsSync(jsonFile)) {
+    console.error(`File not found: ${jsonFile}`);
+    process.exit(1);
+  }
+
+  const list = JSON.parse(fs.readFileSync(jsonFile, "utf-8"));
+  if (!Array.isArray(list) || list.length === 0) {
+    console.log("No entries found in JSON.");
+    process.exit(0);
+  }
+
+  let deleted = 0, skipped = 0, noCompressed = 0, mismatch = 0;
+  console.log(`Processing ${list.length} file(s) from: ${jsonFile}\n`);
+
+  for (let i = 0; i < list.length; i++) {
+    const item     = list[i];
+    const origPath = item.path;
+    const compPath = getCompressedVideoPath(origPath);
+
+    console.log(`[${i + 1}/${list.length}]`);
+    console.log(`  Original  : ${origPath}`);
+
+    const origSize = getFileSizeBytes(origPath);
+    if (origSize === null) {
+      console.log(`  Original  : NOT FOUND, skipping\n`);
+      skipped++;
+      continue;
+    }
+    console.log(`  Orig size : ${fmtSize(origSize)}`);
+
+    const compSize = getFileSizeBytes(compPath);
+    if (compSize === null) {
+      console.log(`  Compressed: NOT FOUND (${path.basename(compPath)}), skipping\n`);
+      noCompressed++;
+      continue;
+    }
+
+    console.log(`  Compressed: ${compPath}`);
+    console.log(`  Comp size : ${fmtSize(compSize)}`);
+    console.log(`  Saved     : ${fmtSize(origSize - compSize)} (${(((origSize - compSize) / origSize) * 100).toFixed(1)}%)`);
+
+    const { match, lines } = checkVideoSourceMatch(origPath, compPath);
+    lines.forEach((l) => console.log(l));
+
+    if (match === false) {
+      console.log("  -> 源信息不匹配，自动跳过\n");
+      mismatch++;
+      continue;
+    }
+
+    const key = await askKey("  Delete original? [y = yes / other = skip]: ");
+    if (key.toLowerCase() === "y") {
+      try {
+        fs.unlinkSync(origPath);
+        console.log("  -> DELETED\n");
+        deleted++;
+      } catch (err) {
+        console.error(`  -> FAILED: ${err.message}\n`);
+      }
+    } else {
+      console.log("  -> Skipped\n");
+      skipped++;
+    }
+  }
+
+  console.log("─".repeat(50));
+  console.log(`Deleted: ${deleted}  |  Skipped: ${skipped}  |  No compressed: ${noCompressed}  |  Mismatch: ${mismatch}`);
+}
+
+// ─── Mode 4: arw-convert ─────────────────────────────────────────────────────
+
+function runArwConvert(positionals) {
+  const srcDir = positionals[0];
+  const outDir = positionals[1];
+  if (!srcDir) {
+    console.error("❌  请指定源目录：vid-com arw-convert <源目录> [输出目录]");
+    process.exit(1);
+  }
+  const scriptPath = path.join(__dirname, "scripts", "arw_to_jpg.sh");
+  const result = spawnSync("bash", [scriptPath, srcDir, ...(outDir ? [outDir] : [])], {
+    stdio: "inherit",
+  });
+  if (result.status !== 0) process.exit(result.status || 1);
+}
+
+// ─── Mode 5: arw-delete ──────────────────────────────────────────────────────
+
+function getImageDimensions(filePath) {
+  try {
+    const out = execSync(
+      `sips -g pixelWidth -g pixelHeight "${filePath}"`,
+      { stdio: ["pipe", "pipe", "pipe"] }
+    ).toString();
+    const w = out.match(/pixelWidth:\s*(\d+)/)?.[1];
+    const h = out.match(/pixelHeight:\s*(\d+)/)?.[1];
+    if (w && h) return { width: parseInt(w, 10), height: parseInt(h, 10) };
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+function findJpgForArw(arwPath) {
+  const dir  = path.dirname(arwPath);
+  const base = path.basename(arwPath, path.extname(arwPath)).toLowerCase();
+  try {
+    const match = fs.readdirSync(dir).find((f) => {
+      const fExt  = path.extname(f).toLowerCase();
+      const fBase = path.basename(f, path.extname(f)).toLowerCase();
+      return fBase === base && (fExt === ".jpg" || fExt === ".jpeg");
+    });
+    return match ? path.join(dir, match) : null;
+  } catch {
+    return null;
+  }
+}
+
+function listArwFiles(dir) {
+  try {
+    return fs.readdirSync(dir, { withFileTypes: true })
+      .filter((e) => e.isFile() && path.extname(e.name).toLowerCase() === ".arw")
+      .map((e) => path.join(dir, e.name));
+  } catch {
+    return [];
+  }
+}
+
+async function runArwDelete(args) {
+  const dir = args.dir;
+  if (!dir) {
+    console.error("❌  请用 --dir 指定目录");
+    process.exit(1);
+  }
+  if (!fs.existsSync(dir)) {
+    console.error(`❌  目录不存在：${dir}`);
+    process.exit(1);
+  }
+
+  const arwFiles = listArwFiles(dir);
+  if (arwFiles.length === 0) {
+    console.log(`未找到 .arw 文件：${dir}`);
+    process.exit(0);
+  }
+
+  let deleted = 0, skipped = 0, noJpg = 0, mismatch = 0;
+  console.log(`扫描到 ${arwFiles.length} 个 .arw 文件，目录：${dir}\n`);
+
+  for (let i = 0; i < arwFiles.length; i++) {
+    const arwPath = arwFiles[i];
+    const jpgPath = findJpgForArw(arwPath);
+
+    console.log(`[${i + 1}/${arwFiles.length}]`);
+    console.log(`  ARW  : ${path.basename(arwPath)}`);
+
+    const arwSize = getFileSizeBytes(arwPath);
+    if (arwSize === null) {
+      console.log(`  ARW  : NOT FOUND, skipping\n`);
+      skipped++;
+      continue;
+    }
+    console.log(`  大小 : ${fmtSize(arwSize)}`);
+
+    if (!jpgPath) {
+      console.log(`  JPG  : NOT FOUND，跳过\n`);
+      noJpg++;
+      continue;
+    }
+
+    const jpgSize = getFileSizeBytes(jpgPath);
+    console.log(`  JPG  : ${path.basename(jpgPath)}  (${fmtSize(jpgSize ?? 0)})`);
+
+    const arwDim = getImageDimensions(arwPath);
+    const jpgDim = getImageDimensions(jpgPath);
+
+    if (!arwDim || !jpgDim) {
+      console.log(`  尺寸 : 无法读取（sips 失败），跳过\n`);
+      mismatch++;
+      continue;
+    }
+
+    const dimMatch = arwDim.width === jpgDim.width && arwDim.height === jpgDim.height;
+    console.log(
+      `  尺寸 : ${arwDim.width}×${arwDim.height} vs ${jpgDim.width}×${jpgDim.height}  ${dimMatch ? "✓" : "✗ 不匹配"}`
+    );
+
+    if (!dimMatch) {
+      console.log(`  -> 尺寸不匹配，自动跳过\n`);
+      mismatch++;
+      continue;
+    }
+
+    const key = await askKey("  Delete ARW? [y = yes / other = skip]: ");
+    if (key.toLowerCase() === "y") {
+      try {
+        fs.unlinkSync(arwPath);
+        console.log("  -> DELETED\n");
+        deleted++;
+      } catch (err) {
+        console.error(`  -> FAILED: ${err.message}\n`);
+      }
+    } else {
+      console.log("  -> Skipped\n");
+      skipped++;
+    }
+  }
+
+  console.log("─".repeat(50));
+  console.log(`Deleted: ${deleted}  |  Skipped: ${skipped}  |  No JPG: ${noJpg}  |  Mismatch: ${mismatch}`);
+}
+
+// ─── 帮助信息 ────────────────────────────────────────────────────────────────
+
+function printHelp() {
+  console.log(`
+media-compress — Video & ARW media toolkit / 视频扫描压缩 & ARW 转换工具
+═══════════════════════════════════════════════════════════════════════════════
+
+Usage / 用法：vid-com <command> [options]
+
+Commands / 命令：
+  find         Scan for high-bitrate videos, output JSON list
+               扫描目录，找出高码率视频，输出 JSON 列表
+  compress     Batch compress using FFmpeg hardware acceleration
+               读取 JSON 列表，FFmpeg 硬件加速批量压缩
+  delete       Verify compressed files then delete originals
+               校验压缩文件后删除原始视频
+  arw-convert  Convert ARW RAW files to JPEG (parallel, macOS sips)
+               批量转换 ARW 为 JPEG（多线程，macOS sips）
+  arw-delete   Verify JPEG exists then delete ARW originals
+               校验 JPEG 后删除 ARW 原始文件
+
+─────────────────────────────────────────────────────────────────────────────
+find options：
+
+  --dir        <path>    Required. Directory to scan / 必填，扫描目录
+  --threshold  <kbps>    Bitrate threshold, default 4000 / 码率阈值，默认 4000
+  --output     <file>    Output JSON file, default bitrate_list.json
+  --recursive            Recurse into subdirectories / 递归扫描子目录
+
+─────────────────────────────────────────────────────────────────────────────
+compress options：
+
+  --input    <json>      Required. JSON list from find
+  --outdir   <dir>       Output directory, default: same as source
+  --suffix   <suffix>    Filename suffix, default _compressed
+  -q/--quality <0-100>   Quality value, higher is better, default 65
+  --target   <kbps>      Fixed bitrate mode, overrides -q
+  --audio    <kbps>      Audio bitrate, default 128
+
+  Encoder：hevc_videotoolbox (Apple hardware H.265, macOS only)
+
+─────────────────────────────────────────────────────────────────────────────
+delete options：
+
+  --input    <json>      JSON list from find (default: my_list.json)
+
+─────────────────────────────────────────────────────────────────────────────
+arw-convert usage：
+
+  vid-com arw-convert <源目录> [输出目录]
+  输出目录默认为 ./converted_jpgs，质量 90，多线程并发
+
+─────────────────────────────────────────────────────────────────────────────
+arw-delete options：
+
+  --dir      <path>      Required. Directory containing ARW files
+
+─────────────────────────────────────────────────────────────────────────────
+Video pipeline / 视频工作流：
+
+  vid-com find --dir ~/Videos --recursive --output /tmp/list.json
+  vid-com compress --input /tmp/list.json --outdir ~/Videos/out
+  vid-com delete --input /tmp/list.json
+
+ARW pipeline / ARW 工作流：
+
+  vid-com arw-convert /Volumes/Untitled/DCIM /Volumes/QWER/out
+  vid-com arw-delete --dir /Volumes/Untitled/DCIM
+
+═══════════════════════════════════════════════════════════════════════════════
+`);
+}
+
+// ─── 入口 ────────────────────────────────────────────────────────────────────
+
+const [,, mode, ...rest] = process.argv;
+const args = parseArgs(rest);
+
+if (!mode || mode === "--help" || mode === "-h") {
+  printHelp();
+} else if (mode === "find") {
+  runFind(args);
+} else if (mode === "compress") {
+  runCompress(args).catch((err) => { console.error(err); process.exit(1); });
+} else if (mode === "delete") {
+  runDelete(args, rest).catch((err) => { console.error(err); process.exit(1); });
+} else if (mode === "arw-convert") {
+  const positionals = rest.filter((a) => !a.startsWith("-"));
+  runArwConvert(positionals);
+} else if (mode === "arw-delete") {
+  runArwDelete(args).catch((err) => { console.error(err); process.exit(1); });
+} else {
+  console.error(`❌  未知命令：${mode}（可用：find / compress / delete / arw-convert / arw-delete）`);
+  printHelp();
+  process.exit(1);
+}