onedrive-photo-batch（Onedrive 照片批处理）

OneDrive Photo Batch

Overview

使用 scripts/onedrive_photo_batch.py 执行 OneDrive 照片批处理。 保持“云端为主、临时落地、索引持久化”的原则：仅在处理时临时下载，识别后立即删除临时文件；删除云端照片时（非 hard）保存回收副本到 tmp_photo/。

Hard Rules

1. 默认不长期保留云端照片本地副本。
2. 执行 full 时，每张照片完成识别并写入索引后，立即删除本地临时文件。
3. 删除云端照片时，除非显式 --hard，否则必须写入本地回收站 tmp_photo/。
4. 本地索引对删除照片使用逻辑删除（logical_deleted=1），不物理清空索引主体。
5. 每次运行技能前，静默执行 15 天回收站清理：删除超期本地回收副本。

Required Files

• Runtime script: scripts/onedrive_photo_batch.py
• Config template: references/config.example.json

Runtime Requirement (必须)

• 本技能依赖 msal 等 Python 包，必须在已安装依赖的虚拟环境中运行。
• 不要默认使用系统 python3 直接执行（可能报 缺少依赖 msal）。
• 推荐解释器：/root/.openclaw/workspace/tmp/onedrive-demo-venv/bin/python

示例：

/root/.openclaw/workspace/tmp/onedrive-demo-venv/bin/python \
  /root/.openclaw/workspace/skills/onedrive-photo-batch/scripts/onedrive_photo_batch.py \
  --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json search --limit 1

复制配置模板并填写真实值，例如：

cp /root/.openclaw/workspace/skills/onedrive-photo-batch/references/config.example.json /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json

Command Quickstart

1) 云端筛选检索

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  search --name "invoice" --name-mode fuzzy --formats jpg,png --limit 20

2) 全量索引（支持筛选、并发、限速、模型策略）

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  full --parallel 2 --max-download-kbps 2048 --batch nightly_full

3) 语义检索 / 关键词精确检索

语义检索：

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  search --semantic-query "带香港理工大学招聘信息的海报" --limit 10

关键词精确检索（命中 OCR/summary 原文，适合“必须包含某词”）：

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  search --keyword "产品经理" --keyword-mode exact --keyword-field all --limit 20

4) 删除与回收站

软删除（默认，进入 tmp_photo/）：

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  delete --name "old" --name-mode fuzzy --limit 5

硬删除（不进入回收站）：

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  delete --name "old" --hard --limit 5

恢复（15天内）：

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  restore --limit 10

清空回收站：

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  trash-empty

5) 移动/上传/导出

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  move --album "/Pictures/Inbox" --album-mode exact --target-album-path "/Pictures/Archive" --limit 20

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  upload --target-album-path "/Pictures/Inbox" /path/a.jpg /path/b.png

python3 scripts/onedrive_photo_batch.py --config /root/.openclaw/workspace/tmp/onedrive_photo_batch/config.json \
  export --format csv --out /root/.openclaw/workspace/tmp/onedrive_photo_batch/export.csv

Notes

• 默认配置是只读验收模式：mode.read_only=true，会屏蔽 delete/restore/trash-empty/move/upload。
• 需要启用写操作时，显式将配置改为：mode.read_only=false，并把 auth.scopes 升级到 Files.ReadWrite。
• 为了低性能主机可用，优先通过 --parallel 与 --max-download-kbps 控制负载。
• vNext 新增稳态参数（performance）：

- api_retry：下载/API 调用重试次数 - backoff_sec：重试退避基数秒 - download_timeout_sec：下载超时时间（秒）

• 模型节流在配置中通过 ocr.default_interval_sec 与 ocr.model_intervals_sec 控制。
• 相册模型覆盖与批次模型覆盖在配置中通过 ocr.album_overrides 和 ocr.batch_overrides 定义。
• vNext 增加 preflight：运行前会检查关键配置与依赖，错误统一返回 JSON（ok=false, error.code/message）。