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(validate): align canvas display names with canvas-formats.md; accept the format ID in canvas.format

hugohe38cae9cf1943a
diff --git a/skills/ppt-master/scripts/config.py b/skills/ppt-master/scripts/config.py
index 61ebd910..b539a7ea 100644
--- a/skills/ppt-master/scripts/config.py
+++ b/skills/ppt-master/scripts/config.py
@@ -192,7 +192,7 @@ CANVAS_FORMATS = {
'use_case': 'WeChat article cover images'
},
'xiaohongshu': {
- 'name': '小红书',
+ 'name': 'Xiaohongshu (RED)',
'dimensions': '1242×1660',
'viewbox': '0 0 1242 1660',
'width': 1242,
@@ -201,7 +201,7 @@ CANVAS_FORMATS = {
'use_case': 'Knowledge sharing, product reviews'
},
'moments': {
- 'name': 'Moments/Instagram',
+ 'name': 'WeChat Moments / IG',
'dimensions': '1080×1080',
'viewbox': '0 0 1080 1080',
'width': 1080,
@@ -210,7 +210,7 @@ CANVAS_FORMATS = {
'use_case': 'Social media square images'
},
'story': {
- 'name': 'Story/Vertical',
+ 'name': 'Story / TikTok',
'dimensions': '1080×1920',
'viewbox': '0 0 1080 1920',
'width': 1080,
@@ -219,7 +219,7 @@ CANVAS_FORMATS = {
'use_case': 'Short video covers, stories'
},
'banner': {
- 'name': 'Horizontal Banner',
+ 'name': 'Landscape Banner',
'dimensions': '1920×1080',
'viewbox': '0 0 1920 1080',
'width': 1920,
diff --git a/skills/ppt-master/scripts/project_management/project_specs.py b/skills/ppt-master/scripts/project_management/project_specs.py
index 6abd2086..68732342 100644
--- a/skills/ppt-master/scripts/project_management/project_specs.py
+++ b/skills/ppt-master/scripts/project_management/project_specs.py
@@ -87,6 +87,15 @@ _CUSTOM_REFERENCE_CATALOGS = (
),
)
+# Display names the registry carried before it was aligned with
+# references/canvas-formats.md; locks written against them still validate.
+_LEGACY_CANVAS_NAMES = {
+ "xiaohongshu": ("小红书",),
+ "moments": ("Moments/Instagram",),
+ "story": ("Story/Vertical",),
+ "banner": ("Horizontal Banner",),
+}
+
_MARKDOWN_H2_RE = re.compile(r"^##[ \t]+(.+?)[ \t]*$", re.MULTILINE)
_MARKDOWN_SUBHEADING_RE = re.compile(r"^#{3,6}[ \t]+(.+?)[ \t]*$", re.MULTILINE)
_MARKDOWN_DATA_LINE_RE = re.compile(
@@ -1227,9 +1236,14 @@ def _validate_spec_lock_relations(
if canvas is not None:
expected_format = str(canvas["name"])
expected_viewbox = str(canvas["viewbox"])
+ accepted_formats = {
+ expected_format,
+ format_key,
+ *_LEGACY_CANVAS_NAMES.get(format_key, ()),
+ }
if (
"format" in canvas_fields
- and _normalize_schema_value(canvas_fields["format"]) != expected_format
+ and _normalize_schema_value(canvas_fields["format"]) not in accepted_formats
):
errors.append(
f"{markdown_name} schema: canvas.format must be '{expected_format}'"
diff --git a/skills/ppt-master/scripts/project_utils.py b/skills/ppt-master/scripts/project_utils.py
index 72f9488d..e40dc889 100644
--- a/skills/ppt-master/scripts/project_utils.py
+++ b/skills/ppt-master/scripts/project_utils.py
@@ -47,25 +47,25 @@ except ImportError:
'aspect_ratio': '2.35:1'
},
'xiaohongshu': {
- 'name': '小红书',
+ 'name': 'Xiaohongshu (RED)',
'dimensions': '1242×1660',
'viewbox': '0 0 1242 1660',
'aspect_ratio': '3:4'
},
'moments': {
- 'name': 'Moments/Instagram',
+ 'name': 'WeChat Moments / IG',
'dimensions': '1080×1080',
'viewbox': '0 0 1080 1080',
'aspect_ratio': '1:1'
},
'story': {
- 'name': 'Story/Vertical',
+ 'name': 'Story / TikTok',
'dimensions': '1080×1920',
'viewbox': '0 0 1080 1920',
'aspect_ratio': '9:16'
},
'banner': {
- 'name': 'Horizontal Banner',
+ 'name': 'Landscape Banner',
'dimensions': '1920×1080',
'viewbox': '0 0 1920 1080',
'aspect_ratio': '16:9'
diff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.md
index 203c97e4..715774b9 100644
--- a/skills/ppt-master/templates/spec_lock_reference.md
+++ b/skills/ppt-master/templates/spec_lock_reference.md
@@ -14,7 +14,7 @@ After Generate Step 4 Gate 1, read the completed Design Spec and current page/re
| Section | Required keys | Notes |
| --- | --- | --- |
-| `canvas` | `viewBox`, `format` | `format` is the canonical display name (e.g. `PPT 16:9`); `viewBox` the exact geometry |
+| `canvas` | `viewBox`, `format` | `format` is the Format column of [`canvas-formats.md`](../references/canvas-formats.md) (e.g. `PPT 16:9`) or the format ID; `viewBox` the exact geometry |
| `communication` | `primary_language`, `audience`, `objective`, `core_message` | Canonical BCP-47 (reject `und` and Chinese without script/region; old locks may omit it); `objective` merges intent/outcome; `consumption_mode` optional off PPT |
| `mode` | `mode` | Preset or `custom` |
| `visual_style` | `visual_style` | Preset or `custom` |