Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

fix(scripts): make --help work across CLI entry points

hugohe383df8a28a001
diff --git a/skills/ppt-master/scripts/batch_validate.py b/skills/ppt-master/scripts/batch_validate.py
index cdb6df64..f9a85e0e 100644
--- a/skills/ppt-master/scripts/batch_validate.py
+++ b/skills/ppt-master/scripts/batch_validate.py
@@ -254,19 +254,28 @@ class BatchValidator:
print(f"\n[REPORT] Validation report exported: {output_file}")
+def print_usage() -> None:
+ """Print CLI usage information."""
+ print("PPT Master - Batch Project Validation Tool\n")
+ print("Usage:")
+ print(" python3 scripts/batch_validate.py <directory>")
+ print(" python3 scripts/batch_validate.py <dir1> <dir2> ...")
+ print(" python3 scripts/batch_validate.py --all")
+ print("\nExamples:")
+ print(" python3 scripts/batch_validate.py examples")
+ print(" python3 scripts/batch_validate.py projects")
+ print(" python3 scripts/batch_validate.py examples projects")
+ print(" python3 scripts/batch_validate.py --all")
+
+
def main() -> None:
"""Run the CLI entry point."""
if len(sys.argv) < 2:
- print("PPT Master - Batch Project Validation Tool\n")
- print("Usage:")
- print(" python3 scripts/batch_validate.py <directory>")
- print(" python3 scripts/batch_validate.py <dir1> <dir2> ...")
- print(" python3 scripts/batch_validate.py --all")
- print("\nExamples:")
- print(" python3 scripts/batch_validate.py examples")
- print(" python3 scripts/batch_validate.py projects")
- print(" python3 scripts/batch_validate.py examples projects")
- print(" python3 scripts/batch_validate.py --all")
+ print_usage()
+ sys.exit(0)
+
+ if sys.argv[1] in {"-h", "--help", "help"}:
+ print_usage()
sys.exit(0)
validator = BatchValidator()
diff --git a/skills/ppt-master/scripts/config.py b/skills/ppt-master/scripts/config.py
index 275de308..c7418c7b 100644
--- a/skills/ppt-master/scripts/config.py
+++ b/skills/ppt-master/scripts/config.py
@@ -578,21 +578,29 @@ class Config:
# Command Line Interface
# ============================================================
+def print_usage() -> None:
+ """Print CLI usage information."""
+ print("PPT Master - Configuration Management Tool\n")
+ print("Usage:")
+ print(" python3 scripts/config.py list-formats # List all canvas formats")
+ print(" python3 scripts/config.py list-colors # List all color schemes")
+ print(" python3 scripts/config.py list-industries # List all industry colors")
+ print(" python3 scripts/config.py export # Export configuration to JSON")
+ print(" python3 scripts/config.py format <key> # View a specific canvas format")
+
+
def main() -> None:
"""Command line entry point."""
import sys
if len(sys.argv) < 2:
- print("PPT Master - Configuration Management Tool\n")
- print("Usage:")
- print(" python3 scripts/config.py list-formats # List all canvas formats")
- print(" python3 scripts/config.py list-colors # List all color schemes")
- print(" python3 scripts/config.py list-industries # List all industry colors")
- print(" python3 scripts/config.py export # Export configuration to JSON")
- print(" python3 scripts/config.py format <key> # View a specific canvas format")
+ print_usage()
return
command = sys.argv[1]
+ if command in {"-h", "--help", "help"}:
+ print_usage()
+ return
if command == 'list-formats':
print("\nCanvas Format List:\n")
diff --git a/skills/ppt-master/scripts/error_helper.py b/skills/ppt-master/scripts/error_helper.py
index 49db738e..7c65b327 100644
--- a/skills/ppt-master/scripts/error_helper.py
+++ b/skills/ppt-master/scripts/error_helper.py
@@ -425,6 +425,10 @@ def main() -> None:
if len(sys.argv) > 1:
error_type = sys.argv[1]
+ if error_type in {'-h', '--help', 'help'}:
+ ErrorHelper.print_help()
+ return
+
context = {}
# Parse context parameters
diff --git a/skills/ppt-master/scripts/generate_examples_index.py b/skills/ppt-master/scripts/generate_examples_index.py
index 2f7c41c0..e7942852 100644
--- a/skills/ppt-master/scripts/generate_examples_index.py
+++ b/skills/ppt-master/scripts/generate_examples_index.py
@@ -205,6 +205,10 @@ def main() -> None:
examples_dir = 'examples'
if len(sys.argv) > 1:
+ if sys.argv[1] in {'-h', '--help', 'help'}:
+ print(__doc__)
+ sys.exit(0)
+
examples_dir = sys.argv[1]
print("=" * 80)
diff --git a/skills/ppt-master/scripts/image_backends/backend_bfl.py b/skills/ppt-master/scripts/image_backends/backend_bfl.py
index be168505..24cd7e37 100644
--- a/skills/ppt-master/scripts/image_backends/backend_bfl.py
+++ b/skills/ppt-master/scripts/image_backends/backend_bfl.py
@@ -8,6 +8,13 @@ Configuration keys:
BFL_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend bfl")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_common.py b/skills/ppt-master/scripts/image_backends/backend_common.py
index 5f9437a7..cdba2e7d 100644
--- a/skills/ppt-master/scripts/image_backends/backend_common.py
+++ b/skills/ppt-master/scripts/image_backends/backend_common.py
@@ -3,6 +3,13 @@
Shared helpers for image generation backends.
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("This is an internal helper module used by image_gen.py backends.")
+ raise SystemExit(0)
+
import io
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_fal.py b/skills/ppt-master/scripts/image_backends/backend_fal.py
index 726461ba..d8f78175 100644
--- a/skills/ppt-master/scripts/image_backends/backend_fal.py
+++ b/skills/ppt-master/scripts/image_backends/backend_fal.py
@@ -8,6 +8,13 @@ Configuration keys:
FAL_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend fal")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_gemini.py b/skills/ppt-master/scripts/image_backends/backend_gemini.py
index 9a3990a4..e9f979e3 100644
--- a/skills/ppt-master/scripts/image_backends/backend_gemini.py
+++ b/skills/ppt-master/scripts/image_backends/backend_gemini.py
@@ -14,6 +14,13 @@ Dependencies:
pip install google-genai Pillow
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend gemini")
+ raise SystemExit(0)
+
import os
import time
import threading
diff --git a/skills/ppt-master/scripts/image_backends/backend_ideogram.py b/skills/ppt-master/scripts/image_backends/backend_ideogram.py
index 7c1d4d66..e9c04847 100644
--- a/skills/ppt-master/scripts/image_backends/backend_ideogram.py
+++ b/skills/ppt-master/scripts/image_backends/backend_ideogram.py
@@ -8,6 +8,13 @@ Configuration keys:
IDEOGRAM_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend ideogram")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_minimax.py b/skills/ppt-master/scripts/image_backends/backend_minimax.py
index 87146fe7..4e8750a8 100644
--- a/skills/ppt-master/scripts/image_backends/backend_minimax.py
+++ b/skills/ppt-master/scripts/image_backends/backend_minimax.py
@@ -8,6 +8,13 @@ Configuration keys:
MINIMAX_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend minimax")
+ raise SystemExit(0)
+
import base64
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_openai.py b/skills/ppt-master/scripts/image_backends/backend_openai.py
index a1fc0d8f..5274e396 100644
--- a/skills/ppt-master/scripts/image_backends/backend_openai.py
+++ b/skills/ppt-master/scripts/image_backends/backend_openai.py
@@ -14,6 +14,13 @@ Dependencies:
pip install openai Pillow
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend openai")
+ raise SystemExit(0)
+
import base64
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_openrouter.py b/skills/ppt-master/scripts/image_backends/backend_openrouter.py
index 0ba27978..1fdc192d 100644
--- a/skills/ppt-master/scripts/image_backends/backend_openrouter.py
+++ b/skills/ppt-master/scripts/image_backends/backend_openrouter.py
@@ -8,6 +8,13 @@ Configuration keys:
OPENROUTER_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend openrouter")
+ raise SystemExit(0)
+
import base64
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_qwen.py b/skills/ppt-master/scripts/image_backends/backend_qwen.py
index 550bb477..6b47c405 100644
--- a/skills/ppt-master/scripts/image_backends/backend_qwen.py
+++ b/skills/ppt-master/scripts/image_backends/backend_qwen.py
@@ -8,6 +8,13 @@ Configuration keys:
QWEN_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend qwen")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_replicate.py b/skills/ppt-master/scripts/image_backends/backend_replicate.py
index 70dd4076..fc1f32e0 100644
--- a/skills/ppt-master/scripts/image_backends/backend_replicate.py
+++ b/skills/ppt-master/scripts/image_backends/backend_replicate.py
@@ -8,6 +8,13 @@ Configuration keys:
REPLICATE_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend replicate")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_siliconflow.py b/skills/ppt-master/scripts/image_backends/backend_siliconflow.py
index a8ae0b0f..60d55dd2 100644
--- a/skills/ppt-master/scripts/image_backends/backend_siliconflow.py
+++ b/skills/ppt-master/scripts/image_backends/backend_siliconflow.py
@@ -8,6 +8,13 @@ Configuration keys:
SILICONFLOW_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend siliconflow")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_stability.py b/skills/ppt-master/scripts/image_backends/backend_stability.py
index ecba2505..e484fb90 100644
--- a/skills/ppt-master/scripts/image_backends/backend_stability.py
+++ b/skills/ppt-master/scripts/image_backends/backend_stability.py
@@ -8,6 +8,13 @@ Configuration keys:
STABILITY_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend stability")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_volcengine.py b/skills/ppt-master/scripts/image_backends/backend_volcengine.py
index 3bc20f66..559c0596 100644
--- a/skills/ppt-master/scripts/image_backends/backend_volcengine.py
+++ b/skills/ppt-master/scripts/image_backends/backend_volcengine.py
@@ -8,6 +8,13 @@ Configuration keys:
VOLCENGINE_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend volcengine")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/image_backends/backend_zhipu.py b/skills/ppt-master/scripts/image_backends/backend_zhipu.py
index ac5c3943..97ff8c95 100644
--- a/skills/ppt-master/scripts/image_backends/backend_zhipu.py
+++ b/skills/ppt-master/scripts/image_backends/backend_zhipu.py
@@ -8,6 +8,13 @@ Configuration keys:
ZHIPU_MODEL (optional)
"""
+import sys
+
+if __name__ == "__main__" and any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]):
+ print(__doc__)
+ print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend zhipu")
+ raise SystemExit(0)
+
import os
import time
diff --git a/skills/ppt-master/scripts/notes_to_audio.py b/skills/ppt-master/scripts/notes_to_audio.py
index 8efea940..1e5c51b2 100644
--- a/skills/ppt-master/scripts/notes_to_audio.py
+++ b/skills/ppt-master/scripts/notes_to_audio.py
@@ -5,7 +5,6 @@ This script uses `edge-tts` for the same cross-platform behavior on macOS,
Linux, and Windows.
Usage:
- python3 skills/ppt-master/scripts/notes_to_audio.py <project_path>
python3 skills/ppt-master/scripts/notes_to_audio.py <project_path> --voice zh-CN-XiaoxiaoNeural
python3 skills/ppt-master/scripts/notes_to_audio.py --list-common-voices
python3 skills/ppt-master/scripts/notes_to_audio.py --list-voices --locale zh-CN
@@ -114,7 +113,10 @@ async def print_edge_voices(locale: str | None = None) -> None:
def main() -> int:
- parser = argparse.ArgumentParser(description=__doc__)
+ parser = argparse.ArgumentParser(
+ description=__doc__,
+ formatter_class=argparse.RawDescriptionHelpFormatter,
+ )
parser.add_argument("project_path", type=Path, nargs="?")
parser.add_argument("-o", "--output", type=Path, default=None)
parser.add_argument(
diff --git a/skills/ppt-master/scripts/pptx_animations.py b/skills/ppt-master/scripts/pptx_animations.py
index 6481eb72..49e62f95 100644
--- a/skills/ppt-master/scripts/pptx_animations.py
+++ b/skills/ppt-master/scripts/pptx_animations.py
@@ -24,8 +24,13 @@ Animation modes used by the builder:
- 'random' — pick a random effect from the same visible pool per element
Dependencies: None (pure XML generation)
+
+Usage:
+ python3 scripts/pptx_animations.py --demo
+ python3 scripts/pptx_animations.py --list
"""
+import argparse
from typing import Optional, Dict, Any
@@ -536,10 +541,32 @@ def get_animation_help() -> str:
return '\n'.join(lines)
+def main() -> None:
+ """Run the CLI entry point."""
+ parser = argparse.ArgumentParser(
+ description=__doc__,
+ formatter_class=argparse.RawDescriptionHelpFormatter,
+ )
+ parser.add_argument("--demo", action="store_true", help="print sample XML for a fade transition and animation")
+ parser.add_argument("--list", action="store_true", help="list available transitions and entrance animations")
+ args = parser.parse_args()
+
+ if args.list:
+ print(get_transition_help())
+ print()
+ print(get_animation_help())
+ return
+
+ if args.demo:
+ print("=== Transition Effect XML Example (fade, 500ms) ===")
+ print(create_transition_xml('fade', 0.5))
+ print()
+ print("=== Entrance Animation XML Example (fade) ===")
+ print(create_timing_xml('fade', 1.0))
+ return
+
+ parser.print_help()
+
+
if __name__ == '__main__':
- # Test output
- print("=== Transition Effect XML Example (fade, 500ms) ===")
- print(create_transition_xml('fade', 0.5))
- print()
- print("=== Entrance Animation XML Example (fade) ===")
- print(create_timing_xml('fade', 1.0))
+ main()
diff --git a/skills/ppt-master/scripts/project_manager.py b/skills/ppt-master/scripts/project_manager.py
index 65fb8dd3..4e7d0b60 100644
--- a/skills/ppt-master/scripts/project_manager.py
+++ b/skills/ppt-master/scripts/project_manager.py
@@ -676,6 +676,10 @@ def main() -> None:
sys.exit(1)
command = sys.argv[1]
+ if command in {"-h", "--help", "help"}:
+ print_usage()
+ sys.exit(0)
+
manager = ProjectManager()
try:
diff --git a/skills/ppt-master/scripts/project_utils.py b/skills/ppt-master/scripts/project_utils.py
index 68fe7c68..f19b0c21 100644
--- a/skills/ppt-master/scripts/project_utils.py
+++ b/skills/ppt-master/scripts/project_utils.py
@@ -442,7 +442,14 @@ if __name__ == '__main__':
# Test code
import sys
+ def print_usage() -> None:
+ print("Usage: python3 project_utils.py <project_path>")
+
if len(sys.argv) > 1:
+ if sys.argv[1] in {'-h', '--help', 'help'}:
+ print_usage()
+ sys.exit(0)
+
project_path = sys.argv[1]
info = get_project_info(project_path)
@@ -472,4 +479,4 @@ if __name__ == '__main__':
if is_valid and not warnings:
print("[OK] Project structure is complete, no issues found")
else:
- print("Usage: python3 project_utils.py <project_path>")
+ print_usage()
diff --git a/skills/ppt-master/scripts/rotate_images.py b/skills/ppt-master/scripts/rotate_images.py
index eda943e6..c5626bd1 100644
--- a/skills/ppt-master/scripts/rotate_images.py
+++ b/skills/ppt-master/scripts/rotate_images.py
@@ -8,6 +8,7 @@ and batch image rotation functionality.
Usage:
python3 scripts/rotate_images.py gen <images_directory>
python3 scripts/rotate_images.py fix <fixes.json>
+ python3 scripts/rotate_images.py auto <images_directory>
"""
@@ -527,6 +528,10 @@ def main() -> None:
sys.exit(1)
command = sys.argv[1]
+ if command in {"-h", "--help", "help"}:
+ print(__doc__)
+ sys.exit(0)
+
rotator = ImageRotator()
if command == 'gen':
diff --git a/skills/ppt-master/scripts/svg_finalize/crop_images.py b/skills/ppt-master/scripts/svg_finalize/crop_images.py
index 5b2e3103..bfe17187 100644
--- a/skills/ppt-master/scripts/svg_finalize/crop_images.py
+++ b/skills/ppt-master/scripts/svg_finalize/crop_images.py
@@ -19,6 +19,7 @@ import os
import re
import hashlib
import sys
+import argparse
from pathlib import Path
from xml.etree import ElementTree as ET
from urllib.parse import unquote
diff --git a/skills/ppt-master/scripts/svg_quality_checker.py b/skills/ppt-master/scripts/svg_quality_checker.py
index 31bfe93f..d3e18ae0 100644
--- a/skills/ppt-master/scripts/svg_quality_checker.py
+++ b/skills/ppt-master/scripts/svg_quality_checker.py
@@ -775,20 +775,34 @@ class SVGQualityChecker:
print(f"\n[REPORT] Check report exported: {output_file}")
+def print_usage() -> None:
+ """Print CLI usage information."""
+ print("PPT Master - SVG Quality Check Tool\n")
+ print("Usage:")
+ print(" python3 scripts/svg_quality_checker.py <svg_file>")
+ print(" python3 scripts/svg_quality_checker.py <directory>")
+ print(" python3 scripts/svg_quality_checker.py --all examples")
+ print("\nExamples:")
+ print(" python3 scripts/svg_quality_checker.py examples/project/svg_output/slide_01.svg")
+ print(" python3 scripts/svg_quality_checker.py examples/project/svg_output")
+ print(" python3 scripts/svg_quality_checker.py examples/project")
+
+
def main() -> None:
"""Run the CLI entry point."""
if len(sys.argv) < 2:
- print("PPT Master - SVG Quality Check Tool\n")
- print("Usage:")
- print(" python3 scripts/svg_quality_checker.py <svg_file>")
- print(" python3 scripts/svg_quality_checker.py <directory>")
- print(" python3 scripts/svg_quality_checker.py --all examples")
- print("\nExamples:")
- print(" python3 scripts/svg_quality_checker.py examples/project/svg_output/slide_01.svg")
- print(" python3 scripts/svg_quality_checker.py examples/project/svg_output")
- print(" python3 scripts/svg_quality_checker.py examples/project")
+ print_usage()
+ sys.exit(0)
+
+ if sys.argv[1] in {"-h", "--help", "help"}:
+ print_usage()
sys.exit(0)
+ if sys.argv[1].startswith("--") and sys.argv[1] not in {"--all"}:
+ print(f"[ERROR] Missing target before option: {sys.argv[1]}")
+ print_usage()
+ sys.exit(1)
+
checker = SVGQualityChecker()
# Parse arguments
diff --git a/skills/ppt-master/scripts/template_import/optimize_reference.py b/skills/ppt-master/scripts/template_import/optimize_reference.py
index ec9c4731..cc1c5c9a 100644
--- a/skills/ppt-master/scripts/template_import/optimize_reference.py
+++ b/skills/ppt-master/scripts/template_import/optimize_reference.py
@@ -15,12 +15,17 @@ import argparse
import json
import math
import re
+import sys
from collections import defaultdict
from dataclasses import dataclass
from pathlib import Path
from xml.etree import ElementTree as ET
-from .externalize_images import discover_svg_files
+try:
+ from .externalize_images import discover_svg_files
+except ImportError:
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
+ from externalize_images import discover_svg_files # type: ignore
SVG_NS = "http://www.w3.org/2000/svg"