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

docs(env): move inline # comments to their own line in .env examples

hugohe32fdce4c563a1
diff --git a/.env.example b/.env.example
index 24773e57..23c69672 100644
--- a/.env.example
+++ b/.env.example
@@ -38,10 +38,14 @@
# OPENAI_API_KEY=sk-xxx
# OPENAI_MODEL=gpt-image-2
# OPENAI_BASE_URL=http://127.0.0.1:3000/v1
-# OPENAI_OUTPUT_FORMAT=png # png / jpeg / webp
-# OPENAI_OUTPUT_COMPRESSION=80 # jpeg/webp only, 0-100
-# OPENAI_BACKGROUND=auto # gpt-image-2: auto / opaque
-# OPENAI_MODERATION=auto # auto / low
+# Allowed values: png / jpeg / webp
+# OPENAI_OUTPUT_FORMAT=png
+# jpeg/webp only, 0-100
+# OPENAI_OUTPUT_COMPRESSION=80
+# gpt-image-2: auto / opaque
+# OPENAI_BACKGROUND=auto
+# auto / low
+# OPENAI_MODERATION=auto
# ─────────────────────────────────────────────────────────────
# Example: Gemini / Gemini 示例
@@ -57,8 +61,10 @@
# IMAGE_BACKEND=minimax
# MINIMAX_API_KEY=your-minimax-key
# MINIMAX_MODEL=image-01
-# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation # Default China endpoint / 默认国内地址
-# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation # Optional overseas endpoint / 可选海外地址
+# Default China endpoint / 默认国内地址
+# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation
+# Optional overseas endpoint / 可选海外地址
+# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation
# ─────────────────────────────────────────────────────────────
# Example: Qwen / 通义生图示例
@@ -102,8 +108,10 @@
#
# MINIMAX_API_KEY=your-minimax-key
# MINIMAX_MODEL=image-01
-# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation # Default China endpoint / 默认国内地址
-# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation # Optional overseas endpoint / 可选海外地址
+# Default China endpoint / 默认国内地址
+# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation
+# Optional overseas endpoint / 可选海外地址
+# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation
#
# SILICONFLOW_API_KEY=your-siliconflow-key
# SILICONFLOW_MODEL=Qwen/Qwen-Image
@@ -161,8 +169,10 @@
#
# Optional provider-specific TTS endpoint overrides.
# 可选:按提供商覆盖 TTS 接入点。
-# MINIMAX_TTS_BASE_URL=https://api.minimaxi.com/v1/t2a_v2 # Default China endpoint / 默认国内地址
-# MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2 # Optional overseas endpoint / 可选海外地址
+# Default China endpoint / 默认国内地址
+# MINIMAX_TTS_BASE_URL=https://api.minimaxi.com/v1/t2a_v2
+# Optional overseas endpoint / 可选海外地址
+# MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2
# QWEN_TTS_BASE_URL=https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
# COSYVOICE_TTS_BASE_URL=https://dashscope.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer
@@ -177,5 +187,7 @@
# Openverse 和 Wikimedia 无需 Key,但图片质量不稳定。
# 如需更稳定的商业图库风格 PPT 配图,建议配置 Pexels 和/或 Pixabay。
#
-# PEXELS_API_KEY=your-pexels-key # signup: https://www.pexels.com/api/
-# PIXABAY_API_KEY=your-pixabay-key # signup: https://pixabay.com/api/docs/
+# Sign up: https://www.pexels.com/api/
+# PEXELS_API_KEY=your-pexels-key
+# Sign up: https://pixabay.com/api/docs/
+# PIXABAY_API_KEY=your-pixabay-key
diff --git a/skills/ppt-master/.env.example b/skills/ppt-master/.env.example
index 24773e57..23c69672 100644
--- a/skills/ppt-master/.env.example
+++ b/skills/ppt-master/.env.example
@@ -38,10 +38,14 @@
# OPENAI_API_KEY=sk-xxx
# OPENAI_MODEL=gpt-image-2
# OPENAI_BASE_URL=http://127.0.0.1:3000/v1
-# OPENAI_OUTPUT_FORMAT=png # png / jpeg / webp
-# OPENAI_OUTPUT_COMPRESSION=80 # jpeg/webp only, 0-100
-# OPENAI_BACKGROUND=auto # gpt-image-2: auto / opaque
-# OPENAI_MODERATION=auto # auto / low
+# Allowed values: png / jpeg / webp
+# OPENAI_OUTPUT_FORMAT=png
+# jpeg/webp only, 0-100
+# OPENAI_OUTPUT_COMPRESSION=80
+# gpt-image-2: auto / opaque
+# OPENAI_BACKGROUND=auto
+# auto / low
+# OPENAI_MODERATION=auto
# ─────────────────────────────────────────────────────────────
# Example: Gemini / Gemini 示例
@@ -57,8 +61,10 @@
# IMAGE_BACKEND=minimax
# MINIMAX_API_KEY=your-minimax-key
# MINIMAX_MODEL=image-01
-# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation # Default China endpoint / 默认国内地址
-# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation # Optional overseas endpoint / 可选海外地址
+# Default China endpoint / 默认国内地址
+# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation
+# Optional overseas endpoint / 可选海外地址
+# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation
# ─────────────────────────────────────────────────────────────
# Example: Qwen / 通义生图示例
@@ -102,8 +108,10 @@
#
# MINIMAX_API_KEY=your-minimax-key
# MINIMAX_MODEL=image-01
-# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation # Default China endpoint / 默认国内地址
-# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation # Optional overseas endpoint / 可选海外地址
+# Default China endpoint / 默认国内地址
+# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation
+# Optional overseas endpoint / 可选海外地址
+# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation
#
# SILICONFLOW_API_KEY=your-siliconflow-key
# SILICONFLOW_MODEL=Qwen/Qwen-Image
@@ -161,8 +169,10 @@
#
# Optional provider-specific TTS endpoint overrides.
# 可选:按提供商覆盖 TTS 接入点。
-# MINIMAX_TTS_BASE_URL=https://api.minimaxi.com/v1/t2a_v2 # Default China endpoint / 默认国内地址
-# MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2 # Optional overseas endpoint / 可选海外地址
+# Default China endpoint / 默认国内地址
+# MINIMAX_TTS_BASE_URL=https://api.minimaxi.com/v1/t2a_v2
+# Optional overseas endpoint / 可选海外地址
+# MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2
# QWEN_TTS_BASE_URL=https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
# COSYVOICE_TTS_BASE_URL=https://dashscope.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer
@@ -177,5 +187,7 @@
# Openverse 和 Wikimedia 无需 Key,但图片质量不稳定。
# 如需更稳定的商业图库风格 PPT 配图,建议配置 Pexels 和/或 Pixabay。
#
-# PEXELS_API_KEY=your-pexels-key # signup: https://www.pexels.com/api/
-# PIXABAY_API_KEY=your-pixabay-key # signup: https://pixabay.com/api/docs/
+# Sign up: https://www.pexels.com/api/
+# PEXELS_API_KEY=your-pexels-key
+# Sign up: https://pixabay.com/api/docs/
+# PIXABAY_API_KEY=your-pixabay-key
diff --git a/skills/ppt-master/scripts/docs/image.md b/skills/ppt-master/scripts/docs/image.md
index 9fb0d1b8..820cd59d 100644
--- a/skills/ppt-master/scripts/docs/image.md
+++ b/skills/ppt-master/scripts/docs/image.md
@@ -44,11 +44,16 @@ Example `.env`:
IMAGE_BACKEND=openai
OPENAI_API_KEY=sk-xxx
OPENAI_MODEL=gpt-image-2
-# OPENAI_BASE_URL=http://127.0.0.1:3000/v1 # optional proxy
-# OPENAI_OUTPUT_FORMAT=png # png / jpeg / webp
-# OPENAI_OUTPUT_COMPRESSION=80 # jpeg/webp only, 0-100
-# OPENAI_BACKGROUND=auto # gpt-image-2: auto / opaque
-# OPENAI_MODERATION=auto # auto / low
+# Optional proxy
+# OPENAI_BASE_URL=http://127.0.0.1:3000/v1
+# Allowed values: png / jpeg / webp
+# OPENAI_OUTPUT_FORMAT=png
+# jpeg/webp only, 0-100
+# OPENAI_OUTPUT_COMPRESSION=80
+# gpt-image-2: auto / opaque
+# OPENAI_BACKGROUND=auto
+# auto / low
+# OPENAI_MODERATION=auto
```
Example process environment: