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
refactor(svg_to_pptx): group drawingml and package modules into subpackages
hugohe35511ab62b9ff
diff --git a/skills/ppt-master/references/strategist.md b/skills/ppt-master/references/strategist.mdindex de05231f..39fcfbe3 100644--- a/skills/ppt-master/references/strategist.md+++ b/skills/ppt-master/references/strategist.md@@ -222,7 +222,7 @@ See [`../templates/icons/README.md`](../templates/icons/README.md) for the curre| Tech / developer | `Arial, "Microsoft YaHei", sans-serif` | same | `Consolas, "Courier New", monospace` || Concord (single family — pick the family by subject + `visual_style`) | `<family by subject>, …, sans-serif / serif` | same | — |-> **Stack length discipline (soft rule).** ≤4 fonts per stack. The exported CJK / Latin typefaces MUST be pre-installed after converter resolution ([`drawingml_utils.py parse_font_family`](../scripts/svg_to_pptx/drawingml_utils.py)). Choose those exported faces from the safe set **by the locked style's character**: `Microsoft YaHei` / `Arial` are the *neutral* members — perfect as the tail fallback and as the lead only when the style is plain-sans, but **not the automatic lead for every deck**. For a styled title, lead with `SimHei` / `KaiTi` / `FangSong` / `SimSun` / `Georgia` / `Cambria` / `Impact` / `Consolas` as the character asks. Keep at most **one** macOS-exclusive family (typically `"PingFang SC"`); macOS→Windows fallback is auto-mapped via `FONT_FALLBACK_WIN`.+> **Stack length discipline (soft rule).** ≤4 fonts per stack. The exported CJK / Latin typefaces MUST be pre-installed after converter resolution ([`drawingml/utils.py parse_font_family`](../scripts/svg_to_pptx/drawingml/utils.py)). Choose those exported faces from the safe set **by the locked style's character**: `Microsoft YaHei` / `Arial` are the *neutral* members — perfect as the tail fallback and as the lead only when the style is plain-sans, but **not the automatic lead for every deck**. For a styled title, lead with `SimHei` / `KaiTi` / `FangSong` / `SimSun` / `Georgia` / `Cambria` / `Impact` / `Consolas` as the character asks. Keep at most **one** macOS-exclusive family (typically `"PingFang SC"`); macOS→Windows fallback is auto-mapped via `FONT_FALLBACK_WIN`.> **Non-pre-installed directions** (require install or PPTX embed; note the constraint in Design Spec):> - **Retro / pixel** — Press Start 2P / VT323 / Silkscreendiff --git a/skills/ppt-master/scripts/native_narration_pptx.py b/skills/ppt-master/scripts/native_narration_pptx.pyindex 047030e6..691397eb 100644--- a/skills/ppt-master/scripts/native_narration_pptx.py+++ b/skills/ppt-master/scripts/native_narration_pptx.py@@ -43,12 +43,12 @@ if str(_SCRIPTS_DIR) not in sys.path:from console_encoding import configure_utf8_stdio # noqa: E402from pptx_animations import TRANSITIONS, create_transition_xml # noqa: E402-from svg_to_pptx.pptx_builder import ( # noqa: E402+from svg_to_pptx.pptx_package.builder import ( # noqa: E402_add_default_content_type,_append_relationship,_ensure_notes_master,)-from svg_to_pptx.pptx_narration import ( # noqa: E402+from svg_to_pptx.pptx_package.narration import ( # noqa: E402AUDIO_CONTENT_TYPES,AUDIO_MARKER_PNG_BYTES,AUDIO_REL_TYPE,@@ -60,7 +60,7 @@ from svg_to_pptx.pptx_narration import ( # noqa: E402next_shape_id,probe_audio_duration,)-from svg_to_pptx.pptx_notes import ( # noqa: E402+from svg_to_pptx.pptx_package.notes import ( # noqa: E402create_notes_slide_rels_xml,create_notes_slide_xml,markdown_to_plain_text,diff --git a/skills/ppt-master/scripts/pptx_to_svg/custgeom_to_svg.py b/skills/ppt-master/scripts/pptx_to_svg/custgeom_to_svg.pyindex efc2855f..ce3635c9 100644--- a/skills/ppt-master/scripts/pptx_to_svg/custgeom_to_svg.py+++ b/skills/ppt-master/scripts/pptx_to_svg/custgeom_to_svg.py@@ -1,6 +1,6 @@"""DrawingML <a:custGeom> -> SVG <path d="..."> conversion.-Reverse of svg_to_pptx/drawingml_paths.path_commands_to_drawingml.+Reverse of svg_to_pptx/drawingml/paths.py path_commands_to_drawingml.Path command mapping:<a:moveTo> -> Mdiff --git a/skills/ppt-master/scripts/pptx_to_svg/effect_to_svg.py b/skills/ppt-master/scripts/pptx_to_svg/effect_to_svg.pyindex 79c7ac50..2749db6b 100644--- a/skills/ppt-master/scripts/pptx_to_svg/effect_to_svg.py+++ b/skills/ppt-master/scripts/pptx_to_svg/effect_to_svg.py@@ -1,6 +1,6 @@"""DrawingML <a:effectLst> -> SVG <filter> conversion.-Reverse of svg_to_pptx/drawingml_styles.build_effect_xml.+Reverse of svg_to_pptx/drawingml/styles.py build_effect_xml.Covers the most common DrawingML effects:- <a:outerShdw> -> feDropShadow (or feGaussianBlur+feOffset+feFlood)diff --git a/skills/ppt-master/scripts/pptx_to_svg/emu_units.py b/skills/ppt-master/scripts/pptx_to_svg/emu_units.pyindex 155a2060..dd146181 100644--- a/skills/ppt-master/scripts/pptx_to_svg/emu_units.py+++ b/skills/ppt-master/scripts/pptx_to_svg/emu_units.py@@ -1,6 +1,6 @@"""EMU <-> pixel conversion and DrawingML unit constants.-Mirrors svg_to_pptx/drawingml_utils.py and pptx_dimensions.py, in reverse.+Mirrors svg_to_pptx/drawingml/utils.py and pptx_package/dimensions.py, in reverse.DrawingML unit conventions:- Coordinates / sizes: EMU (English Metric Unit). 914400 EMU = 1 inch = 96 px.diff --git a/skills/ppt-master/scripts/pptx_to_svg/ln_to_svg.py b/skills/ppt-master/scripts/pptx_to_svg/ln_to_svg.pyindex e570f6b5..a0b740bc 100644--- a/skills/ppt-master/scripts/pptx_to_svg/ln_to_svg.py+++ b/skills/ppt-master/scripts/pptx_to_svg/ln_to_svg.py@@ -1,6 +1,6 @@"""DrawingML <a:ln> -> SVG stroke conversion.-Reverse of svg_to_pptx/drawingml_styles.build_stroke_xml.+Reverse of svg_to_pptx/drawingml/styles.py build_stroke_xml.Produces an SVG attribute dict with stroke / stroke-width / stroke-opacity /stroke-dasharray / stroke-linecap / stroke-linejoin / marker-start /diff --git a/skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.py b/skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.pyindex 642409ab..511b2466 100644--- a/skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.py+++ b/skills/ppt-master/scripts/pptx_to_svg/txbody_to_svg.py@@ -1,6 +1,6 @@"""DrawingML <p:txBody> -> SVG <text> conversion.-Reverse of svg_to_pptx/drawingml_elements.convert_text.+Reverse of svg_to_pptx/drawingml/elements.py convert_text.Strategy (v1):- Each <a:p> paragraph emits one <text> element (one line of baseline).@@ -803,7 +803,7 @@ def _is_cjk(ch: str) -> bool:def _char_width(ch: str, font_size: float, bold: bool) -> float:"""Estimate a single character's rendered width in pixels.- Mirrors svg_to_pptx/drawingml_utils.estimate_text_width so wrapping breaks+ Mirrors svg_to_pptx/drawingml/utils.py estimate_text_width so wrapping breaksalign with the same heuristic used to estimate text-box sizes elsewhere."""if _is_cjk(ch):diff --git a/skills/ppt-master/scripts/svg_quality_checker.py b/skills/ppt-master/scripts/svg_quality_checker.pyindex 6fd5ba0b..74196dd2 100644--- a/skills/ppt-master/scripts/svg_quality_checker.py+++ b/skills/ppt-master/scripts/svg_quality_checker.py@@ -46,7 +46,7 @@ except ImportError:_validate_animation_config = Nonetry:- from svg_to_pptx.drawingml_utils import (+ from svg_to_pptx.drawingml.utils import (parse_font_family as _parse_export_font_family,)except ImportError:@@ -102,7 +102,7 @@ XLINK_NS = "http://www.w3.org/1999/xlink"# Fonts that survive direct PPTX typeface assignment on a typical Windows /# macOS viewer without requiring a custom install. Keep this aligned with-# strategist.md §g and drawingml_utils.FONT_FALLBACK_WIN.+# strategist.md §g and drawingml/utils.py FONT_FALLBACK_WIN.PPT_SAFE_FONTS = {'microsoft yahei', 'simhei', 'simsun', 'kaiti', 'fangsong','dengxian', 'microsoft jhenghei',diff --git a/skills/ppt-master/scripts/svg_to_pptx/__init__.py b/skills/ppt-master/scripts/svg_to_pptx/__init__.pyindex 4cc803bf..5ae582f0 100644--- a/skills/ppt-master/scripts/svg_to_pptx/__init__.py+++ b/skills/ppt-master/scripts/svg_to_pptx/__init__.py@@ -6,9 +6,9 @@ Public API:- create_pptx_with_native_svg(): Build PPTX from SVG files"""-from .pptx_cli import main-from .drawingml_converter import convert_svg_to_slide_shapes-from .pptx_builder import create_pptx_with_native_svg+from .pptx_package.cli import main+from .drawingml.converter import convert_svg_to_slide_shapes+from .pptx_package.builder import create_pptx_with_native_svg__all__ = ['main',diff --git a/skills/ppt-master/scripts/svg_to_pptx/animation_config.py b/skills/ppt-master/scripts/svg_to_pptx/animation_config.pyindex a3cdbe42..ebb6af78 100644--- a/skills/ppt-master/scripts/svg_to_pptx/animation_config.py+++ b/skills/ppt-master/scripts/svg_to_pptx/animation_config.py@@ -9,7 +9,7 @@ from pathlib import Pathfrom typing import Anyfrom xml.etree import ElementTree as ET-from .drawingml_utils import SVG_NS+from .drawingml.utils import SVG_NStry:from pptx_animations import ANIMATIONS, TRANSITIONSdiff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml/__init__.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/__init__.pynew file mode 100644index 00000000..a892d4d5--- /dev/null+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/__init__.py@@ -0,0 +1 @@+"""DrawingML conversion helpers for SVG-to-PPTX export."""diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_context.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/context.pysimilarity index 100%rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_context.pyrename to skills/ppt-master/scripts/svg_to_pptx/drawingml/context.pydiff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_converter.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/converter.pysimilarity index 98%rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_converter.pyrename to skills/ppt-master/scripts/svg_to_pptx/drawingml/converter.pyindex 045cde9f..e80da566 100644--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_converter.py+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/converter.py@@ -10,20 +10,20 @@ from xml.etree import ElementTree as ETfrom resource_paths import icon_search_dirs_for_svg-from .drawingml_context import ConvertContext, ShapeResult-from .drawingml_utils import (+from .context import ConvertContext, ShapeResult+from .utils import (SVG_NS, EMU_PER_PX,_extract_inheritable_styles, parse_transform_matrix, resolve_url_id,parse_svg_length,)-from .drawingml_styles import build_effect_xml-from .drawingml_elements import (+from .styles import build_effect_xml+from .elements import (convert_rect, convert_circle, convert_ellipse,convert_line, convert_path,convert_polygon, convert_polyline,convert_text, convert_image, convert_nested_svg,)-from .native_objects import convert_native_object+from ..native_objects import convert_native_objectclass SvgNativeConversionError(RuntimeError):@@ -515,7 +515,7 @@ def convert_svg_to_slide_shapes(# running this here makes the two pipelines behaviourally aligned.icons_dir, icons_fallback_dir = icon_search_dirs_for_svg(svg_path)if icons_dir.exists():- from .use_expander import expand_use_data_icons+ from ..use_expander import expand_use_data_iconsexpanded = expand_use_data_icons(root, icons_dir, icons_fallback_dir)if expanded:trace_steps.append({'action': 'expand-use-data-icons', 'count': expanded})@@ -530,7 +530,7 @@ def convert_svg_to_slide_shapes(# correct when reading raw svg_output/.# merge_paragraphs additionally folds mergeable paragraph blocks into a# single annotated <text> for downstream multi-<a:p> conversion.- from .tspan_flattener import flatten_positional_tspans+ from ..tspan_flattener import flatten_positional_tspansflattened = flatten_positional_tspans(tree, merge_paragraphs=merge_paragraphs)if flattened:trace_steps.append({diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_elements.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/elements.pysimilarity index 99%rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_elements.pyrename to skills/ppt-master/scripts/svg_to_pptx/drawingml/elements.pyindex ef9013d7..9d0d03f9 100644--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_elements.py+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/elements.py@@ -13,8 +13,8 @@ from xml.etree import ElementTree as ETfrom resource_paths import resolve_external_image_reference-from .drawingml_context import ConvertContext, ShapeResult-from .drawingml_utils import (+from .context import ConvertContext, ShapeResult+from .utils import (SVG_NS, XLINK_NS, ANGLE_UNIT, FONT_PX_TO_HUNDREDTHS_PT, DASH_PRESETS,px_to_emu, _f, _get_attr, parse_svg_length,svg_length_x, svg_length_y, svg_length_size,@@ -25,12 +25,12 @@ from .drawingml_utils import (detect_text_lang, resolve_text_run_fonts,matrix_multiply, parse_transform_matrix, transform_point, _xml_escape,)-from .drawingml_styles import (+from .styles import (build_solid_fill, build_gradient_fill,build_fill_xml, build_stroke_xml, build_effect_xml, classify_filter_effect,get_fill_opacity, get_stroke_opacity,)-from .drawingml_paths import (+from .paths import (PathCommand, parse_svg_path, svg_path_to_absolute,normalize_path_commands, path_commands_to_drawingml,)diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_paths.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/paths.pysimilarity index 99%rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_paths.pyrename to skills/ppt-master/scripts/svg_to_pptx/drawingml/paths.pyindex ec2d1036..04b115e3 100644--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_paths.py+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/paths.py@@ -6,7 +6,7 @@ import mathimport refrom dataclasses import dataclass, field-from .drawingml_utils import px_to_emu+from .utils import px_to_emu@dataclassdiff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_styles.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/styles.pysimilarity index 99%rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_styles.pyrename to skills/ppt-master/scripts/svg_to_pptx/drawingml/styles.pyindex 7d34f2fb..f6280c36 100644--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_styles.py+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/styles.py@@ -6,8 +6,8 @@ import mathimport refrom xml.etree import ElementTree as ET-from .drawingml_context import ConvertContext-from .drawingml_utils import (+from .context import ConvertContext+from .utils import (SVG_NS, ANGLE_UNIT, DASH_PRESETS,px_to_emu, _f, _get_attr, parse_svg_length,parse_hex_color, parse_stop_style, resolve_url_id,diff --git a/skills/ppt-master/scripts/svg_to_pptx/drawingml_utils.py b/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.pysimilarity index 99%rename from skills/ppt-master/scripts/svg_to_pptx/drawingml_utils.pyrename to skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.pyindex 213b8f6e..9065a2d1 100644--- a/skills/ppt-master/scripts/svg_to_pptx/drawingml_utils.py+++ b/skills/ppt-master/scripts/svg_to_pptx/drawingml/utils.py@@ -6,7 +6,7 @@ import reimport mathfrom xml.etree import ElementTree as ET-from .drawingml_context import AffineMatrix, ConvertContext, IDENTITY_MATRIX+from .context import AffineMatrix, ConvertContext, IDENTITY_MATRIX# ---------------------------------------------------------------------------# Constantsdiff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/__init__.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/__init__.pyindex d24a1fd2..fc0a37c8 100644--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/__init__.py+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/__init__.py@@ -5,8 +5,8 @@ from __future__ import annotationsfrom typing import Anyfrom xml.etree import ElementTree as ET-from ..drawingml_context import ConvertContext, ShapeResult-from ..drawingml_utils import _xml_escape+from ..drawingml.context import ConvertContext, ShapeResult+from ..drawingml.utils import _xml_escapefrom .chart_data import _chart_datafrom .chart_style import (_axis_titles,diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.pyindex 0b08a0a5..5cf85e9d 100644--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_style.py@@ -5,8 +5,8 @@ from __future__ import annotationsfrom typing import Anyfrom xml.etree import ElementTree as ET-from ..drawingml_context import ConvertContext-from ..drawingml_utils import detect_text_lang, _xml_escape+from ..drawingml.context import ConvertContext+from ..drawingml.utils import detect_text_lang, _xml_escapefrom .chart_data import _DEFAULT_CHART_COLORSfrom .marker_common import (_bool_attr,diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_xml.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_xml.pyindex 4e907033..b11cf7b9 100644--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_xml.py+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chart_xml.py@@ -5,7 +5,7 @@ from __future__ import annotationsfrom typing import Anyfrom xml.etree import ElementTree as ET-from ..drawingml_utils import detect_text_lang, px_to_emu, _xml_escape+from ..drawingml.utils import detect_text_lang, px_to_emu, _xml_escapefrom .chart_data import _chart_list, _data_labels_configfrom .chart_style import (_alpha_xml,diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chartex.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chartex.pyindex 61d081e4..09234c88 100644--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/chartex.py+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/chartex.py@@ -4,7 +4,7 @@ from __future__ import annotationsfrom typing import Any-from ..drawingml_utils import _xml_escape+from ..drawingml.utils import _xml_escapefrom .marker_common import (CHARTEX_URI,CHART_COLOR_STYLE_REL_TYPE,diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/marker_common.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/marker_common.pyindex 05bd2baf..ca2f9658 100644--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/marker_common.py+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/marker_common.py@@ -7,8 +7,8 @@ import refrom typing import Anyfrom xml.etree import ElementTree as ET-from ..drawingml_context import ConvertContext, IDENTITY_MATRIX-from ..drawingml_utils import (+from ..drawingml.context import ConvertContext, IDENTITY_MATRIX+from ..drawingml.utils import (FONT_PX_TO_HUNDREDTHS_PT,ctx_h,ctx_w,diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/table.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/table.pyindex 01e7584c..d71c11aa 100644--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/table.py+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/table.py@@ -6,8 +6,8 @@ import refrom typing import Anyfrom xml.etree import ElementTree as ET-from ..drawingml_context import ConvertContext, ShapeResult-from ..drawingml_utils import px_to_emu, _xml_escape+from ..drawingml.context import ConvertContext, ShapeResult+from ..drawingml.utils import px_to_emu, _xml_escapefrom .chart_style import _font_face_xmlfrom .marker_common import (TABLE_URI,diff --git a/skills/ppt-master/scripts/svg_to_pptx/native_objects/workbook.py b/skills/ppt-master/scripts/svg_to_pptx/native_objects/workbook.pyindex c2c2abb0..d0af5206 100644--- a/skills/ppt-master/scripts/svg_to_pptx/native_objects/workbook.py+++ b/skills/ppt-master/scripts/svg_to_pptx/native_objects/workbook.py@@ -11,7 +11,7 @@ try:except ImportError: # pragma: no cover - optional compatibility enhancementWorkbook = None-from ..drawingml_utils import _xml_escape+from ..drawingml.utils import _xml_escapefrom .marker_common import _excel_coldiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_package/__init__.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/__init__.pynew file mode 100644index 00000000..b677487d--- /dev/null+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/__init__.py@@ -0,0 +1 @@+"""PPTX package assembly helpers for SVG-to-PPTX export."""diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.pysimilarity index 99%rename from skills/ppt-master/scripts/svg_to_pptx/pptx_builder.pyrename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.pyindex 68b90130..759a288a 100644--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_builder.py+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/builder.py@@ -23,24 +23,24 @@ from xml.sax.saxutils import escapefrom pptx import Presentationfrom pptx.util import Emu-from .drawingml_converter import convert_svg_to_slide_shapes-from .pptx_dimensions import (+from ..drawingml.converter import convert_svg_to_slide_shapes+from .dimensions import (CANVAS_FORMATS,get_slide_dimensions, get_pixel_dimensions,get_viewbox_dimensions, detect_format_from_svg,)-from .pptx_media import (+from .media import (PNG_RENDERER,get_png_renderer_info, convert_svg_to_png, convert_svg_to_png_cached,)-from .pptx_notes import (+from .notes import (markdown_to_plain_text,create_notes_master_rels_xml,create_notes_master_xml,create_notes_slide_xml,create_notes_slide_rels_xml,)-from .pptx_narration import (+from .narration import (AUDIO_CONTENT_TYPES,AUDIO_REL_TYPE,AUDIO_MARKER_PNG_BYTES,@@ -51,7 +51,7 @@ from .pptx_narration import (next_shape_id,probe_audio_duration,)-from .pptx_slide_xml import (+from .slide_xml import (ANIMATIONS_AVAILABLE, TRANSITIONS,create_slide_xml_with_svg, create_slide_rels_xml,)diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.pysimilarity index 98%rename from skills/ppt-master/scripts/svg_to_pptx/pptx_cli.pyrename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.pyindex 25fbd7a3..ef4d3a7e 100644--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_cli.py+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/cli.py@@ -25,12 +25,12 @@ if __package__ in {None, ''}:sys.modules.setdefault('svg_to_pptx', package)__package__ = 'svg_to_pptx'-from .pptx_dimensions import CANVAS_FORMATS, get_project_info, get_viewbox_dimensions-from .pptx_discovery import find_svg_files, find_notes_files-from .pptx_builder import create_pptx_with_native_svg-from .pptx_narration import NARRATION_EXTENSIONS, find_narration_files, probe_audio_duration-from .pptx_slide_xml import TRANSITIONS-from .animation_config import load_animation_config, validate_animation_config+from .dimensions import CANVAS_FORMATS, get_project_info, get_viewbox_dimensions+from .discovery import find_svg_files, find_notes_files+from .builder import create_pptx_with_native_svg+from .narration import NARRATION_EXTENSIONS, find_narration_files, probe_audio_duration+from .slide_xml import TRANSITIONS+from ..animation_config import load_animation_config, validate_animation_configtry:from pptx_animations import ANIMATIONS as _ANIMATIONSdiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_dimensions.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/dimensions.pysimilarity index 100%rename from skills/ppt-master/scripts/svg_to_pptx/pptx_dimensions.pyrename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/dimensions.pydiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_discovery.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/discovery.pysimilarity index 100%rename from skills/ppt-master/scripts/svg_to_pptx/pptx_discovery.pyrename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/discovery.pydiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_media.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/media.pysimilarity index 100%rename from skills/ppt-master/scripts/svg_to_pptx/pptx_media.pyrename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/media.pydiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_narration.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/narration.pysimilarity index 100%rename from skills/ppt-master/scripts/svg_to_pptx/pptx_narration.pyrename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/narration.pydiff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_notes.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/notes.pysimilarity index 99%rename from skills/ppt-master/scripts/svg_to_pptx/pptx_notes.pyrename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/notes.pyindex 5d04e073..4533e3ee 100644--- a/skills/ppt-master/scripts/svg_to_pptx/pptx_notes.py+++ b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/notes.py@@ -4,7 +4,7 @@ from __future__ import annotationsimport re-from .drawingml_utils import detect_text_lang+from ..drawingml.utils import detect_text_langdef markdown_to_plain_text(md_content: str) -> str:diff --git a/skills/ppt-master/scripts/svg_to_pptx/pptx_slide_xml.py b/skills/ppt-master/scripts/svg_to_pptx/pptx_package/slide_xml.pysimilarity index 100%rename from skills/ppt-master/scripts/svg_to_pptx/pptx_slide_xml.pyrename to skills/ppt-master/scripts/svg_to_pptx/pptx_package/slide_xml.pydiff --git a/skills/ppt-master/scripts/template_fill_pptx/notes.py b/skills/ppt-master/scripts/template_fill_pptx/notes.pyindex d34cadba..80705407 100644--- a/skills/ppt-master/scripts/template_fill_pptx/notes.py+++ b/skills/ppt-master/scripts/template_fill_pptx/notes.py@@ -10,7 +10,7 @@ from __future__ import annotationsimport posixpathfrom xml.etree import ElementTree as ET-from svg_to_pptx.pptx_notes import create_notes_slide_xml, markdown_to_plain_text+from svg_to_pptx.pptx_package.notes import create_notes_slide_xml, markdown_to_plain_textfrom .ooxml import NOTES_SLIDE_REL_TYPE, REL_NS, SLIDE_REL_TYPE, _qn, _xml_bytesfrom .package import _empty_relationships_root, _max_numeric_riddiff --git a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.mdindex 1d175140..4ff534f9 100644--- a/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md+++ b/skills/ppt-master/templates/charts/CHART_STYLE_GUIDE.md@@ -162,7 +162,7 @@ font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Micr- `<feComponentTransfer>` + `<feFuncA slope=...>` → 用 `<feFlood flood-color flood-opacity>` 替代- `flood-opacity > 0.20` → 阴影过重,最大 0.15-0.20-> **被禁的是 sub-element,不是 `<filter>` 本身。** `<filter>` 是 PPT Master 允许的、官方推荐的阴影/发光路径(见 [`shared-standards.md`](../../references/shared-standards.md) §1 黑名单不含 filter、§6 把 filter shadow 列为 drop-shadow 的官方实现),转换器 [`svg_to_pptx/drawingml_styles.py`](../../scripts/svg_to_pptx/drawingml_styles.py) 也主动把 `feGaussianBlur` + `feOffset` + `feFlood` + `feComposite` + `feMerge`(以及 `feDropShadow` 简写)映射成 DrawingML `<a:outerShdw>`。+> **被禁的是 sub-element,不是 `<filter>` 本身。** `<filter>` 是 PPT Master 允许的、官方推荐的阴影/发光路径(见 [`shared-standards.md`](../../references/shared-standards.md) §1 黑名单不含 filter、§6 把 filter shadow 列为 drop-shadow 的官方实现),转换器 [`svg_to_pptx/drawingml/styles.py`](../../scripts/svg_to_pptx/drawingml/styles.py) 也主动把 `feGaussianBlur` + `feOffset` + `feFlood` + `feComposite` + `feMerge`(以及 `feDropShadow` 简写)映射成 DrawingML `<a:outerShdw>`。>> 单独禁 `feComponentTransfer/feFuncA(slope)` 的原因:**它物理上只能调透明度、无法携带颜色**。转换器读到 `feFuncA slope` 时只把它当作 alpha,颜色字段保持默认 `'000000'`——SVG 端看起来阴影颜色正常(因为 SourceAlpha 本身是黑),但导出到 PPTX 后阴影颜色会被定死成纯黑 `#000000`,与同页其他用 `feFlood flood-color="#0F172A"` 的卡片产生肉眼可见的冷暖色差。>diff --git a/skills/ppt-master/templates/design_spec_reference.md b/skills/ppt-master/templates/design_spec_reference.mdindex 673c5b9a..86c8067a 100644--- a/skills/ppt-master/templates/design_spec_reference.md+++ b/skills/ppt-master/templates/design_spec_reference.md@@ -124,7 +124,7 @@ Two views on the same font decisions — fill both, keep them consistent:> - `Georgia, "Microsoft YaHei", serif` → Latin in Georgia (elegant serif), CJK falls through to Microsoft YaHei. **Use when Latin typography is the primary design statement** (academic / editorial / Latin-heavy covers).> - `"Microsoft YaHei", Georgia, serif` → Everything in Microsoft YaHei (Latin uses YaHei's Latin glyphs — a different design tone). **Use when the deck is CJK-primary and Latin is incidental**.>-> The converter (`drawingml_utils.py parse_font_family`) maps these to PPTX `<a:latin>` / `<a:ea>` regardless of order — but browser preview and SVG native rendering reflect stack order. Pick the order matching your design intent.+> The converter (`drawingml/utils.py parse_font_family`) maps these to PPTX `<a:latin>` / `<a:ea>` regardless of order — but browser preview and SVG native rendering reflect stack order. Pick the order matching your design intent.> **Why two views**: the breakdown shows role assignment at a glance; stacks carry the ordering info the breakdown can't encode. Keep both consistent — table cells should be exactly the fonts in the stacks (any order).diff --git a/skills/ppt-master/templates/spec_lock_reference.md b/skills/ppt-master/templates/spec_lock_reference.mdindex e1e5a7cd..e282ab40 100644--- a/skills/ppt-master/templates/spec_lock_reference.md+++ b/skills/ppt-master/templates/spec_lock_reference.md@@ -75,7 +75,7 @@>> **⚠️ PPT-safe stack discipline (HARD rule).** PPTX stores concrete exported Latin / EA typefaces per run with no runtime fallback. Every stack's exported Latin / EA typefaces MUST resolve to cross-platform pre-installed fonts: `"Microsoft YaHei"` / `SimSun` / `Arial` / `"Times New Roman"` / `Consolas`. Stacks that export non-preinstalled typefaces (Inter / Google Fonts / brand typefaces) may be used only when the Design Spec notes the font-install or embedding requirement.>-> **Stack length discipline.** 3-4 fonts per stack is the sweet spot. Converter only writes the **first** Latin and **first** CJK font into PPTX — everything after is silently dropped. macOS-only families (`Songti SC`, `Menlo`, `Monaco`, `Helvetica`) are auto-mapped to Windows equivalents via `FONT_FALLBACK_WIN` (see `scripts/svg_to_pptx/drawingml_utils.py`); stacking both is redundant. Lead with Windows-preinstalled fonts (`Microsoft YaHei` / `SimSun` / `Arial` / `Georgia` / `Consolas`); keep at most **one** macOS-exclusive family (typically `"PingFang SC"`) as a browser-preview nicety.+> **Stack length discipline.** 3-4 fonts per stack is the sweet spot. Converter only writes the **first** Latin and **first** CJK font into PPTX — everything after is silently dropped. macOS-only families (`Songti SC`, `Menlo`, `Monaco`, `Helvetica`) are auto-mapped to Windows equivalents via `FONT_FALLBACK_WIN` (see `scripts/svg_to_pptx/drawingml/utils.py`); stacking both is redundant. Lead with Windows-preinstalled fonts (`Microsoft YaHei` / `SimSun` / `Arial` / `Georgia` / `Consolas`); keep at most **one** macOS-exclusive family (typically `"PingFang SC"`) as a browser-preview nicety.## icons- library: chunk-filled