初始化项目版本

.agents/skills/pptx/scripts/office/helpers/__init__.py

@@ -0,0 +1,111 @@
+import os
+import posixpath
+import re
+import stat
+import tempfile
+import urllib.parse
+import zipfile
+from pathlib import Path
+
+OOXML_FAMILY = {
+    ".docx": "docx",
+    ".dotx": "docx",
+    ".pptx": "pptx",
+    ".potx": "pptx",
+    ".xlsx": "xlsx",
+    ".xltx": "xlsx",
+}
+
+_SCHEME_RE = re.compile(r"^[A-Za-z][A-Za-z0-9+.\-]*:")
+
+SLIDE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide"
+
+
+def opc_target(target: str, source_part: str, target_mode: str = "") -> str | None:
+    if not target:
+        return None
+    if target_mode.lower() == "external":
+        return None
+    if _SCHEME_RE.match(target):
+        return None
+
+    target = urllib.parse.unquote(target)
+
+    if "\\" in target:
+        raise ValueError(f"relationship target is not a POSIX part name: {target!r}")
+
+    if target.startswith("/"):
+        joined = target.lstrip("/")
+    else:
+        joined = posixpath.join(posixpath.dirname(source_part), target)
+
+    parts: list[str] = []
+    for segment in posixpath.normpath(joined).split("/"):
+        if segment in ("", "."):
+            continue
+        if segment == "..":
+            if not parts:
+                raise ValueError(f"relationship target escapes the package: {target!r}")
+            parts.pop()
+        else:
+            parts.append(segment)
+
+    if not parts:
+        raise ValueError(f"relationship target resolves to nothing: {target!r}")
+    return "/".join(parts)
+
+
+def rels_source_part(rels_file: Path, unpacked_dir: Path) -> str:
+    owner_dir = rels_file.parent.parent.relative_to(unpacked_dir)
+    return posixpath.join(owner_dir.as_posix(), rels_file.name[: -len(".rels")]).lstrip("./")
+
+
+def part_text(data: bytes) -> str:
+    return data.decode("utf-8", "surrogateescape")
+
+
+XML_SPACE = " \t\r\n"
+
+
+def rendered_text(text: str, preserve: bool) -> str:
+    return text if preserve else text.strip(XML_SPACE)
+
+
+def safe_extract(zf: zipfile.ZipFile, dest: Path) -> None:
+    dest = dest.resolve()
+    for m in zf.infolist():
+        if stat.S_ISLNK(m.external_attr >> 16):
+            raise ValueError(f"symlink archive entry not allowed: {m.filename!r}")
+        target = (dest / m.filename).resolve()
+        if not target.is_relative_to(dest):
+            raise ValueError(f"unsafe archive entry: {m.filename!r}")
+        zf.extract(m, dest)
+
+
+def rezip(src_dir: Path, out_path: Path) -> None:
+    files = sorted(p for p in src_dir.rglob("*") if p.is_file())
+    ct = src_dir / "[Content_Types].xml"
+    fd, tmp_name = tempfile.mkstemp(
+        prefix=out_path.name + ".", suffix=".tmp", dir=out_path.parent
+    )
+    tmp_out = Path(tmp_name)
+    try:
+        with os.fdopen(fd, "wb") as fh:
+            with zipfile.ZipFile(fh, "w", zipfile.ZIP_DEFLATED) as zf:
+                if ct.exists():
+                    zf.write(ct, ct.relative_to(src_dir), compress_type=zipfile.ZIP_STORED)
+                for f in files:
+                    if f == ct:
+                        continue
+                    zf.write(f, f.relative_to(src_dir))
+        if out_path.exists():
+            mode = out_path.stat().st_mode & 0o777
+        else:
+            umask = os.umask(0)
+            os.umask(umask)
+            mode = 0o666 & ~umask
+        os.chmod(tmp_out, mode)
+        os.replace(tmp_out, out_path)
+    finally:
+        if tmp_out.exists():
+            tmp_out.unlink()

.agents/skills/pptx/scripts/office/helpers/pptx_chart.py

@@ -0,0 +1,170 @@
+"""Find chart XML that PowerPoint refuses but the schema accepts.
+
+Detection only: for either fault more than one repair is valid, and only the
+author knows which was meant.
+"""
+
+
+from __future__ import annotations
+
+import re
+from typing import Mapping
+
+from . import part_text
+
+
+_CHART_PART_RE = re.compile(r"ppt/charts/chart\d+\.xml")
+
+_GROUPING_RE = re.compile(r"""<c:grouping\b[^>]*?\bval=["'](\w+)["']""")
+_DLBL_POS_RE = re.compile(r"""<c:dLblPos\b[^>]*?\bval=["'](\w+)["']""")
+
+def _strip_ext_lst(text: str) -> str:
+    out, cursor = [], 0
+    for lo, hi in _ext_lst_spans(text):
+        out.append(text[cursor:lo])
+        cursor = hi
+    out.append(text[cursor:])
+    return "".join(out)
+
+_BAR_GROUP_RE = re.compile(r"<c:(bar3DChart|barChart)\b[^>]*(?<!/)>.*?</c:\1\s*>", re.DOTALL)
+
+STACKED_GROUPINGS = frozenset({"stacked", "percentStacked"})
+ILLEGAL_ON_STACKED = frozenset({"outEnd"})
+LEGAL_ON_STACKED = ("ctr", "inEnd", "inBase")
+
+
+def _check_stacked_label_positions(part: str, xml: str) -> list[str]:
+    problems: list[str] = []
+    for match in _BAR_GROUP_RE.finditer(xml):
+        block = _strip_ext_lst(match.group(0))
+        group = match.group(1)
+
+        grouping = _GROUPING_RE.search(block)
+        if grouping is None or grouping.group(1) not in STACKED_GROUPINGS:
+            continue
+
+        bad = [p for p in _DLBL_POS_RE.findall(block) if p in ILLEGAL_ON_STACKED]
+        for pos in sorted(set(bad)):
+            problems.append(
+                f'{part}: {bad.count(pos)} data label(s) use dLblPos="{pos}" on a '
+                f"{grouping.group(1)} {group}; PowerPoint allows only "
+                f"{', '.join(LEGAL_ON_STACKED)} there"
+            )
+    return problems
+
+
+
+_ANY_CHART_GROUP_RE = re.compile(r"<c:(\w+Chart)\b[^>]*(?<!/)>.*?</c:\1\s*>", re.DOTALL)
+
+_AXID_RE = re.compile(
+    r"""\s*<c:axId\b[^>]*?\bval=["'](-?\d+)["']\s*(?:/>|>\s*</c:axId\s*>)"""
+)
+
+_AXIS_DECL_RE = re.compile(
+    r"""<c:(catAx|valAx|serAx|dateAx)\b[^>]*(?<!/)>\s*<c:axId\b[^>]*?\bval=["'](-?\d+)["']"""
+)
+
+AXID_LIMIT = {
+    "barChart": 2, "lineChart": 2, "areaChart": 2, "scatterChart": 2,
+    "bubbleChart": 2, "radarChart": 2, "stockChart": 2,
+    "bar3DChart": 3, "line3DChart": 3, "area3DChart": 3,
+    "surfaceChart": 3, "surface3DChart": 3,
+}
+
+AXID_MINIMUM = {
+    "barChart": 2, "lineChart": 2, "areaChart": 2, "scatterChart": 2,
+    "bubbleChart": 2, "radarChart": 2, "stockChart": 2,
+    "bar3DChart": 2, "area3DChart": 2, "surfaceChart": 2,
+    "line3DChart": 3, "surface3DChart": 3,
+}
+
+
+def _declared_axes(xml: str) -> dict[str, list[str]]:
+    axes: dict[str, list[str]] = {}
+    for kind, axid in _AXIS_DECL_RE.findall(xml):
+        axes.setdefault(kind, []).append(axid)
+    return axes
+
+
+def _canonical_ids(axes: dict[str, list[str]], limit: int) -> list[str] | None:
+    category = axes.get("catAx", []) + axes.get("dateAx", [])
+    value = axes.get("valAx", [])
+    series = axes.get("serAx", [])
+    if len(category) != 1 or len(value) != 1 or len(series) > 1:
+        return None
+    ids = [category[0], value[0]]
+    if limit >= 3 and series:
+        ids.append(series[0])
+    return ids
+
+
+def _undeclared_axes(kind: str, block: str, axes: dict[str, list[str]]) -> list[str] | None:
+    if kind not in AXID_LIMIT:
+        return None
+    ids = _AXID_RE.findall(block)
+    declared = {i for group in axes.values() for i in group}
+    if len([i for i in ids if i in declared]) >= 2:
+        return None
+    return ids
+
+
+def _check_chart_axis_references(part: str, xml: str) -> list[str]:
+    axes = _declared_axes(xml)
+    problems: list[str] = []
+    declared = {i for group in axes.values() for i in group}
+    for match in _ANY_CHART_GROUP_RE.finditer(xml):
+        kind, block = match.group(1), match.group(0)
+        ids = _undeclared_axes(kind, block, axes)
+        if ids is None:
+            continue
+        if not ids:
+            problems.append(
+                f"{part}: <c:{kind}> declares no <c:axId> this part can resolve; a chart "
+                f"group needs {AXID_MINIMUM[kind]}, and PowerPoint discards one with fewer"
+            )
+            continue
+        dead = [i for i in ids if i not in declared]
+        canonical = _canonical_ids(axes, AXID_LIMIT[kind])
+        if canonical is not None and len(canonical) >= AXID_MINIMUM[kind]:
+            hint = f"Fix: point them at the axes this part declares ({', '.join(canonical)})"
+        else:
+            hint = ("Fix: the part declares several axes of a kind -- declare the "
+                    "secondary axes the series expects, or drop them")
+        detail = (f"of which {', '.join(dead)} name no declared axis"
+                  if dead else f"only {len(ids)} of which this part declares")
+        problems.append(
+            f"{part}: <c:{kind}> references axId {', '.join(ids)}, {detail}, "
+            f"leaving fewer than two live axes; PowerPoint discards the chart. {hint}"
+        )
+    return problems
+
+
+def _ext_lst_spans(text: str) -> list[tuple[int, int]]:
+    spans: list[tuple[int, int]] = []
+    depth = 0
+    start = 0
+    for match in re.finditer(r"<(/?)c:extLst\b[^>]*?(/?)>", text):
+        closing, self_closing = match.group(1), match.group(2)
+        if self_closing:
+            continue
+        if closing:
+            depth -= 1
+            if depth == 0:
+                spans.append((start, match.end()))
+        else:
+            if depth == 0:
+                start = match.start()
+            depth += 1
+    return spans
+
+
+CHART_CHECKS = (_check_stacked_label_positions, _check_chart_axis_references)
+
+
+def find_chart_problems(files: Mapping[str, bytes]) -> list[str]:
+    problems: list[str] = []
+    for part in sorted(n for n in files if _CHART_PART_RE.fullmatch(n)):
+        xml = part_text(files[part])
+        for check in CHART_CHECKS:
+            problems.extend(check(part, xml))
+    return problems

.agents/skills/pptx/scripts/office/helpers/pptx_slide.py

@@ -0,0 +1,60 @@
+"""Pick the slide-XML schema errors PowerPoint refuses the file over.
+
+A denylist over lxml's messages, so an unrecognised error class is a miss rather
+than a false alarm.
+"""
+
+
+from __future__ import annotations
+
+import re
+
+SLIDE_PART_RE = re.compile(
+    r"ppt/(slides|slideLayouts|slideMasters|notesSlides|notesMasters|handoutMasters)"
+    r"/[^/]+\.xml"
+)
+
+FATAL_SLIDE_ERRORS: tuple[tuple[re.Pattern[str], str], ...] = (
+    (
+        re.compile(r"\}tableStyleId': This element is not expected"),
+        "two <a:tableStyleId> in one <a:tblPr> (the schema allows one)",
+    ),
+    (
+        re.compile(r"\}srgbClr', attribute 'val'"),
+        "a colour that is not six hex digits",
+    ),
+    (
+        re.compile(r"\}txBody': Missing child element"),
+        "a <p:txBody> with no children",
+    ),
+    (
+        re.compile(r"\}miter', attribute 'lim'"),
+        'a line join with lim="NaN"',
+    ),
+    (
+        re.compile(r"\}uLnTx': This element is not expected"),
+        "<a:uLnTx> in a position the schema forbids",
+    ),
+    (
+        re.compile(r"\}overrideClrMapping': This element is not expected"),
+        "<p:overrideClrMapping> in a position the schema forbids",
+    ),
+    (
+        re.compile(r"\}nvGrpSpPr': Missing child element"),
+        "a <p:nvGrpSpPr> with no children",
+    ),
+)
+
+
+def is_schema_verdict(error: str) -> bool:
+    return error.startswith("Element ")
+
+
+def fatal_slide_errors(errors: set[str]) -> list[str]:
+    out = []
+    for error in sorted(errors):
+        for pattern, meaning in FATAL_SLIDE_ERRORS:
+            if pattern.search(error):
+                out.append(f"{meaning}: {error}")
+                break
+    return out

.agents/skills/pptx/scripts/office/helpers/pptx_theme.py

@@ -0,0 +1,114 @@
+"""Find masters sharing a theme part in the way PowerPoint refuses to open.
+
+Reports only; the fix is to move <p:notesMasterIdLst> back to directly after
+<p:sldIdLst> in ppt/presentation.xml.
+"""
+
+
+from __future__ import annotations
+
+import posixpath
+import re
+from typing import Mapping
+
+from . import part_text
+
+THEME_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme"
+
+_MASTER_RE = re.compile(
+    r"^ppt/(?P<group>slideMasters|notesMasters|handoutMasters)/"
+    r"(?:slide|notes|handout)Master(?P<num>\d+)\.xml$"
+)
+_GROUP_ORDER = {"slideMasters": 0, "notesMasters": 1, "handoutMasters": 2}
+
+_RELATIONSHIP_RE = re.compile(
+    r"<Relationship\b[^>]*?(?:/>|>.*?</Relationship\s*>)", re.DOTALL
+)
+
+
+def _sort_key(name: str) -> tuple[int, int]:
+    m = _MASTER_RE.match(name)
+    assert m is not None
+    return (_GROUP_ORDER[m.group("group")], int(m.group("num")))
+
+
+def _rels_path(part: str) -> str:
+    directory, base = posixpath.split(part)
+    return f"{directory}/_rels/{base}.rels"
+
+
+def _resolve(rels_path: str, target: str) -> str:
+    if target.startswith("/"):
+        return target.lstrip("/")
+    part_dir = posixpath.dirname(posixpath.dirname(rels_path))
+    return posixpath.normpath(posixpath.join(part_dir, target))
+
+
+def _theme_rel(files: Mapping[str, bytes], master: str):
+    rels_path = _rels_path(master)
+    rels = files.get(rels_path)
+    if rels is None:
+        return None
+    for element in _RELATIONSHIP_RE.findall(part_text(rels)):
+        if f'Type="{THEME_REL_TYPE}"' not in element:
+            continue
+        target = re.search(r'\bTarget="([^"]+)"', element)
+        if target is None:
+            continue
+        return rels_path, element, _resolve(rels_path, target.group(1))
+    return None
+
+
+def _masters(files: Mapping[str, bytes]) -> list[str]:
+    return sorted((n for n in files if _MASTER_RE.match(n)), key=_sort_key)
+
+
+_PRESENTATION = "ppt/presentation.xml"
+_NOTES_MASTERS = "ppt/notesMasters/"
+_IGNORABLE_RE = re.compile(r"<!--.*?-->|<\?.*?\?>", re.DOTALL)
+_AFTER_SLDIDLST_RE = re.compile(
+    r"<p:sldIdLst\b(?:[^>]*/>|[^>]*>.*?</p:sldIdLst\s*>)\s*(<[^>\s/]+)", re.DOTALL
+)
+
+
+def _notes_master_share_is_inert(files: Mapping[str, bytes]) -> bool:
+    data = files.get(_PRESENTATION)
+    if data is None:
+        return False
+    match = _AFTER_SLDIDLST_RE.search(_IGNORABLE_RE.sub("", part_text(data)))
+    return match is not None and match.group(1) == "<p:notesMasterIdLst"
+
+
+def _shares(files: Mapping[str, bytes]):
+    owner: dict[str, str] = {}
+    for master in _masters(files):
+        found = _theme_rel(files, master)
+        if found is None:
+            continue
+        rels_path, element, theme = found
+        if theme not in files:
+            continue  
+        if theme in owner:
+            yield master, rels_path, element, theme, owner[theme]
+        else:
+            owner[theme] = master
+
+
+def _is_inert(master: str, inert_notes: bool) -> bool:
+    return inert_notes and master.startswith(_NOTES_MASTERS)
+
+
+def find_shared_master_themes(files: Mapping[str, bytes]) -> list[str]:
+    return [
+        f"{master} shares {theme} with {first}"
+        for master, _, _, theme, first in _shares(files)
+    ]
+
+
+def live_shared_master_themes(files: Mapping[str, bytes]) -> list[str]:
+    inert_notes = _notes_master_share_is_inert(files)
+    return [
+        f"{master} shares {theme} with {first}"
+        for master, _, _, theme, first in _shares(files)
+        if not _is_inert(master, inert_notes)
+    ]