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

feat(template-fill): expose chart data in slide library

hugohe3c6d9963dc691
diff --git a/skills/ppt-master/scripts/template_fill_pptx/analyzer.py b/skills/ppt-master/scripts/template_fill_pptx/analyzer.py
index d08f3417..fe0108f2 100644
--- a/skills/ppt-master/scripts/template_fill_pptx/analyzer.py
+++ b/skills/ppt-master/scripts/template_fill_pptx/analyzer.py
@@ -7,15 +7,21 @@ from pathlib import Path
from typing import Any
from xml.etree import ElementTree as ET
+from .chart_read import empty_chart_data, read_chart_data
from .ooxml import (
+ CHART_REL_TYPE,
NS,
+ SlideRef,
_chart_containers,
_container_geometry,
_emu_to_px,
+ _normalize_part,
_paragraph_texts,
_parse_slide_refs,
_read_xml,
+ _qn,
_shape_identity,
+ _slide_relationships,
_table_containers,
_text_containers,
)
@@ -54,11 +60,23 @@ def _analyze_tables(slide_root: ET.Element, source_slide: int) -> list[dict[str,
return tables
-def _analyze_charts(slide_root: ET.Element, source_slide: int) -> list[dict[str, Any]]:
+def _analyze_charts(zf: zipfile.ZipFile, slide_root: ET.Element, slide_ref: SlideRef) -> list[dict[str, Any]]:
charts: list[dict[str, Any]] = []
+ relationships = _slide_relationships(zf, slide_ref.rels_name)
for order, container in enumerate(_chart_containers(slide_root), start=1):
shape_id, _shape_name = _shape_identity(container, order)
- charts.append({"chart_id": f"s{source_slide:02d}_ch{shape_id}"})
+ chart = container.find(".//c:chart", NS)
+ rel_id = chart.attrib.get(_qn(NS["r"], "id")) if chart is not None else ""
+ payload: dict[str, Any] = {"chart_id": f"s{slide_ref.index:02d}_ch{shape_id}"}
+ payload.update(empty_chart_data())
+ rel = relationships.get(rel_id)
+ if rel and rel.get("type") == CHART_REL_TYPE:
+ chart_part = _normalize_part(rel["target"], slide_ref.part_name)
+ try:
+ payload.update(read_chart_data(_read_xml(zf, chart_part)))
+ except RuntimeError:
+ payload.update(empty_chart_data())
+ charts.append(payload)
return charts
@@ -135,7 +153,7 @@ def analyze_pptx(pptx_path: Path) -> dict[str, Any]:
)
tables = _analyze_tables(slide_root, slide_ref.index)
- charts = _analyze_charts(slide_root, slide_ref.index)
+ charts = _analyze_charts(zf, slide_root, slide_ref)
slide_text = "\n".join(slot["text"] for slot in slots if slot["text"])
slides.append(
{
diff --git a/skills/ppt-master/scripts/template_fill_pptx/chart_read.py b/skills/ppt-master/scripts/template_fill_pptx/chart_read.py
new file mode 100644
index 00000000..ab930f20
--- /dev/null
+++ b/skills/ppt-master/scripts/template_fill_pptx/chart_read.py
@@ -0,0 +1,99 @@
+"""Read native PowerPoint chart display caches for slide-library analysis.
+
+The template-fill workflow edits chart data from explicit fill plans. This
+module only reads the data currently visible in a chart XML part, keeping
+workbook parsing out of the analyzer.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+from xml.etree import ElementTree as ET
+
+from .ooxml import NS
+
+
+def empty_chart_data() -> dict[str, Any]:
+ return {
+ "chart_type": None,
+ "category_count": 0,
+ "series_count": 0,
+ "categories": [],
+ "series": [],
+ }
+
+
+def _local_name(tag: str) -> str:
+ return tag.rsplit("}", 1)[-1]
+
+
+def _chart_type_with_series(chart_root: ET.Element) -> ET.Element | None:
+ plot_area = chart_root.find(".//c:plotArea", NS)
+ if plot_area is None:
+ return None
+ for child in list(plot_area):
+ if _local_name(child.tag).endswith("Chart") and child.findall("c:ser", NS):
+ return child
+ return None
+
+
+def _coerce_number(value: str) -> int | float | str:
+ try:
+ number = float(value)
+ except ValueError:
+ return value
+ if number.is_integer():
+ return int(number)
+ return number
+
+
+def _cache_values(parent: ET.Element | None, *, numeric: bool = False) -> list[Any]:
+ if parent is None:
+ return []
+ cache = parent.find(".//c:strCache", NS)
+ if cache is None:
+ cache = parent.find(".//c:numCache", NS)
+ if cache is None:
+ return []
+ values: list[Any] = []
+ for point in cache.findall("c:pt", NS):
+ value = point.findtext("c:v", default="", namespaces=NS)
+ values.append(_coerce_number(value) if numeric else value)
+ return values
+
+
+def _series_name(series: ET.Element, fallback: str) -> str:
+ tx = series.find("c:tx", NS)
+ if tx is None:
+ return fallback
+ values = _cache_values(tx)
+ if values:
+ return str(values[0])
+ direct = tx.findtext("c:v", default="", namespaces=NS)
+ return direct or fallback
+
+
+def read_chart_data(chart_root: ET.Element) -> dict[str, Any]:
+ """Return a compact summary of chart type, categories, series, and values."""
+ chart_type = _chart_type_with_series(chart_root)
+ if chart_type is None:
+ return empty_chart_data()
+
+ series_nodes = chart_type.findall("c:ser", NS)
+ categories = _cache_values(series_nodes[0].find("c:cat", NS)) if series_nodes else []
+ series_payload: list[dict[str, Any]] = []
+ for index, series in enumerate(series_nodes, start=1):
+ series_payload.append(
+ {
+ "name": _series_name(series, f"系列{index}"),
+ "values": _cache_values(series.find("c:val", NS), numeric=True),
+ }
+ )
+
+ return {
+ "chart_type": _local_name(chart_type.tag),
+ "category_count": len(categories),
+ "series_count": len(series_payload),
+ "categories": categories,
+ "series": series_payload,
+ }
diff --git a/skills/ppt-master/scripts/template_fill_pptx/ooxml.py b/skills/ppt-master/scripts/template_fill_pptx/ooxml.py
index fd73b321..4cb2812e 100644
--- a/skills/ppt-master/scripts/template_fill_pptx/ooxml.py
+++ b/skills/ppt-master/scripts/template_fill_pptx/ooxml.py
@@ -25,6 +25,10 @@ NS = {
REL_NS = "http://schemas.openxmlformats.org/package/2006/relationships"
CT_NS = "http://schemas.openxmlformats.org/package/2006/content-types"
P14_NS = "http://schemas.microsoft.com/office/powerpoint/2010/main"
+MC_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006"
+C14_NS = "http://schemas.microsoft.com/office/drawing/2007/8/2/chart"
+C16_NS = "http://schemas.microsoft.com/office/drawing/2014/chart"
+C16R2_NS = "http://schemas.microsoft.com/office/drawing/2015/06/chart"
SLIDE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide"
NOTES_SLIDE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide"
@@ -41,6 +45,10 @@ PX_PER_INCH = 96
for prefix, uri in NS.items():
ET.register_namespace(prefix, uri)
ET.register_namespace("", REL_NS)
+ET.register_namespace("mc", MC_NS)
+ET.register_namespace("c14", C14_NS)
+ET.register_namespace("c16", C16_NS)
+ET.register_namespace("c16r2", C16R2_NS)
ET.register_namespace("p14", P14_NS)
diff --git a/skills/ppt-master/scripts/template_fill_pptx/scaffolder.py b/skills/ppt-master/scripts/template_fill_pptx/scaffolder.py
index 32ef3dab..0e83fc5a 100644
--- a/skills/ppt-master/scripts/template_fill_pptx/scaffolder.py
+++ b/skills/ppt-master/scripts/template_fill_pptx/scaffolder.py
@@ -54,8 +54,8 @@ def scaffold_plan(
chart_edits.append(
{
"chart_id": chart["chart_id"],
- "categories": [],
- "series": [{"name": "系列1", "values": []}],
+ "categories": chart.get("categories", []),
+ "series": chart.get("series") or [{"name": "系列1", "values": []}],
}
)
slides.append(