Qwen Vision Rename Skill

Use this skill for:

• understanding image content (single image)
• batch generating content-based filenames for local image folders
• direct batch rename with rollback support
• naming pattern 类型-主题 (example: 邀请函-万人大会主视觉)

Runtime behavior (strict)

• qwen-vision-rename is a skill name, not a built-in tool name.
• First use the read tool to open this SKILL.md, then run the Python command below.
• Never emit a tool call named qwen-vision-rename.
• Always execute the script. Do not fabricate recognition results.
• For rename requests, default to direct execution: run rename-dir --apply.
• If the user explicitly says "预览/试运行/dry-run/先看方案", run without --apply.
• Do not call qwen-image for rename tasks.
• Requests like "整理图片/按内容分类整理" still map to this skill. This skill renames by content first; if the user explicitly asks to move files into folders, explain that separately.
• If user does not provide a folder path, run rename-dir without --dir and let script auto-select default image directory.
• Filename style should be 类型-主题 first, not only plain title.
• If --apply is used, return both plan_file and rollback_file.
• If command fails, explain failure in 2 short Chinese sentences and provide next fix.

Setup

Install dependencies:

pip3 install -r {baseDir}/requirements.txt

Set API key:

export DASHSCOPE_API_KEY="your_api_key"

Optional model and endpoint:

export DASHSCOPE_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export DASHSCOPE_VISION_MODEL="qwen-vl-max-latest"

Commands

Describe one image:

python3 {baseDir}/scripts/vision_rename.py describe \
  --image /path/to/image.jpg

Batch dry-run plan (recommended first step):

python3 {baseDir}/scripts/vision_rename.py rename-dir \
  --dir /path/to/images

Batch apply rename:

python3 {baseDir}/scripts/vision_rename.py rename-dir \
  --dir /path/to/images \
  --apply

Auto directory (no explicit --dir, script picks default image directory):

python3 {baseDir}/scripts/vision_rename.py rename-dir --apply

Rollback by rollback file:

python3 {baseDir}/scripts/vision_rename.py rollback \
  --rollback-file /path/to/rename-rollback-YYYYMMDD-HHMMSS.json

Notes

• Supported image extensions: jpg, jpeg, png, webp, bmp, gif, tif, tiff, heic, heif.
• Default naming style: 类型-主题 (for example 邀请函-活动主视觉.jpg).
• Duplicate names auto-suffix with -02, -03 ...
• rename-dir writes a JSON plan file every run.
• --apply creates rollback JSON for reverse operation.
• If --dir is omitted, script tries OPENCLAW_RENAME_DEFAULT_DIR, then ~/图片, then ~/Pictures.
• On API failure for a single image, the default behavior is skip that file and continue.