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.pyindex 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.pyindex 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 sysif 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()returncommand = sys.argv[1]+ if command in {"-h", "--help", "help"}:+ print_usage()+ returnif 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.pyindex 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 parametersdiff --git a/skills/ppt-master/scripts/generate_examples_index.py b/skills/ppt-master/scripts/generate_examples_index.pyindex 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.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_common.py b/skills/ppt-master/scripts/image_backends/backend_common.pyindex 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 ioimport osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_fal.py b/skills/ppt-master/scripts/image_backends/backend_fal.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_gemini.py b/skills/ppt-master/scripts/image_backends/backend_gemini.pyindex 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 osimport timeimport threadingdiff --git a/skills/ppt-master/scripts/image_backends/backend_ideogram.py b/skills/ppt-master/scripts/image_backends/backend_ideogram.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_minimax.py b/skills/ppt-master/scripts/image_backends/backend_minimax.pyindex 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 base64import osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_openai.py b/skills/ppt-master/scripts/image_backends/backend_openai.pyindex 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 base64import osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_openrouter.py b/skills/ppt-master/scripts/image_backends/backend_openrouter.pyindex 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 base64import osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_qwen.py b/skills/ppt-master/scripts/image_backends/backend_qwen.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_replicate.py b/skills/ppt-master/scripts/image_backends/backend_replicate.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_siliconflow.py b/skills/ppt-master/scripts/image_backends/backend_siliconflow.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_stability.py b/skills/ppt-master/scripts/image_backends/backend_stability.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_volcengine.py b/skills/ppt-master/scripts/image_backends/backend_volcengine.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/image_backends/backend_zhipu.py b/skills/ppt-master/scripts/image_backends/backend_zhipu.pyindex 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 osimport timediff --git a/skills/ppt-master/scripts/notes_to_audio.py b/skills/ppt-master/scripts/notes_to_audio.pyindex 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-XiaoxiaoNeuralpython3 skills/ppt-master/scripts/notes_to_audio.py --list-common-voicespython3 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.pyindex 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 elementDependencies: None (pure XML generation)++Usage:+ python3 scripts/pptx_animations.py --demo+ python3 scripts/pptx_animations.py --list"""+import argparsefrom 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.pyindex 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.pyindex 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 codeimport 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.pyindex 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.pyindex 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 osimport reimport hashlibimport sys+import argparsefrom pathlib import Pathfrom xml.etree import ElementTree as ETfrom urllib.parse import unquotediff --git a/skills/ppt-master/scripts/svg_quality_checker.py b/skills/ppt-master/scripts/svg_quality_checker.pyindex 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 argumentsdiff --git a/skills/ppt-master/scripts/template_import/optimize_reference.py b/skills/ppt-master/scripts/template_import/optimize_reference.pyindex 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 argparseimport jsonimport mathimport re+import sysfrom collections import defaultdictfrom dataclasses import dataclassfrom pathlib import Pathfrom 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: ignoreSVG_NS = "http://www.w3.org/2000/svg"