Back to Details

slide-renderer

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Slide Renderer

幻灯片渲染工具

Gemini API를 사용하여 프롬프트 파일(.md)을 4K 16:9 PNG 이미지로 변환하는 스크립트 실행 가이드.
本指南介绍如何使用Gemini API将提示文件(.md)转换为4K 16:9比例PNG图像的脚本运行方法。

스크립트 참조 및 실행 (CRITICAL)

脚本引用与执行（重要）

스크립트는 이 스킬의 상대경로에 위치합니다:
scripts/generate_slide_images.py
실행 순서:
Step 1. 상대경로로 실행 (최우선)
bash
python scripts/generate_slide_images.py \
  --prompts-dir [프롬프트 폴더 경로] \
  --output-dir [이미지 출력 폴더 경로]
Step 2. 상대경로 실패 시 Glob 폴백
Glob: **/visual-generator/skills/slide-renderer/scripts/generate_slide_images.py
Step 3. Glob도 실패 시 확장 탐색
Glob: **/generate_slide_images.py
절대 금지: 스크립트를 찾지 못했을 때 자체적으로 Python 코드를 작성하지 마세요. 반드시 에러를 보고하고 사용자에게 경로 확인을 요청하세요.
脚本位于本技能的相对路径下：
scripts/generate_slide_images.py
执行步骤:
步骤1. 通过相对路径执行（优先选择）
bash
python scripts/generate_slide_images.py \
  --prompts-dir [提示文件文件夹路径] \
  --output-dir [图像输出文件夹路径]
步骤2. 相对路径执行失败时使用Glob回退
Glob: **/visual-generator/skills/slide-renderer/scripts/generate_slide_images.py
步骤3. Glob方式也失败时进行扩展搜索
Glob: **/generate_slide_images.py
绝对禁止：当无法找到脚本时，请勿自行编写Python代码。必须上报错误并请求用户确认路径。

환경 요구사항

环境要求

항목설명
Python3.8+
패키지google-genai, Pillow
환경변수
GEMINI_API_KEY
필수
모델gemini-3-pro-image-preview
출력4K, 16:9 비율 PNG
项目说明
Python3.8+
依赖包google-genai, Pillow
环境变量
GEMINI_API_KEY
必须配置
模型gemini-3-pro-image-preview
输出4K分辨率、16:9比例的PNG图像

스크립트 출력 해석

脚本输出解析

출력 패턴의미처리
[OK] Saved:
이미지 생성 성공성공 카운트 증가
[FAIL] Failed:
이미지 생성 실패재시도 대상 추가
[SKIP] Already exists:
파일 이미 존재스킵 카운트 증가
[에러]
API 오류 또는 시스템 오류로그 기록
输出模式含义处理方式
[OK] Saved:
图像生成成功增加成功计数
[FAIL] Failed:
图像生成失败添加至重试列表
[SKIP] Already exists:
文件已存在增加跳过计数
[에러]
API错误或系统错误记录日志

에러 처리

错误处理

에러 유형별 처리

按错误类型处理

에러 유형처리 방법최대 재시도
GEMINI_API_KEY 미설정즉시 중단, 사용자 안내0
API 타임아웃5초 대기 후 재시도3
API 응답 없음5초 대기 후 재시도3
이미지 데이터 없음5초 대기 후 재시도3
파일 쓰기 오류권한 확인, 사용자 안내0
错误类型处理方法最大重试次数
未配置GEMINI_API_KEY立即终止，通知用户0
API超时等待5秒后重试3
API无响应等待5秒后重试3
无图像数据等待5秒后重试3
文件写入错误检查权限，通知用户0

재시도 로직

重试逻辑

실패 발생
  → 재시도 가능 여부 판단 (현재 시도 < 3)
    → YES: 5초 대기 → 해당 프롬프트만 재실행 (기존 성공 파일은 자동 스킵)
    → NO: 최종 실패 목록에 추가, 사유 기록
发生失败
  → 判断是否可重试（当前尝试次数 < 3）
    → 是：等待5秒 → 仅重新执行该提示（已成功生成的文件将自动跳过）
    → 否：添加至最终失败列表，记录原因