xls-skill: Excel -> Markdown, Bilder in ihren Zellen behalten
Warum dieses Skill existiert
Die meisten Excel-Reader (openpyxl, pandas, CSV-Export) sehen nur Zellwerte. Zwei Arten von Bildern gehen verloren:
- In-Zell-Bilder. Das Bild ist der Inhalt einer Zelle.
- WPS Office „in Zelle einbetten“: Die Zelle zeigt nur
=DISPIMG("ID_...",1); das Bild befindet sich inxl/cellimages.xml. - Microsoft 365 „Place in Cell“ /
IMAGE: Die Zelle zeigt#WERT!; das Bild wird überxl/metadata.xmlundxl/richData/erreicht.
- WPS Office „in Zelle einbetten“: Die Zelle zeigt nur
- Schwebende Bilder und Textfelder, die über dem Raster gezeichnet sind (Prozessfotos, Etiketten, Formularnummern).
Dieses Skill extrahiert alle, speichert jedes Bild als Datei und schreibt es in die Markdown-Tabelle an die Zelle, in der es sich befindet, sodass ein Leser die Tabelle und ihre Bilder zusammen sieht:
| # | A | B | C | D |
|---|---|---|---|---|
| 2 | Bracket |  | Bracket \| In-Zell-Bild | 4 |
Ausführung
python <skill-verzeichnis>/scripts/xlsx_to_md.py <datei-oder-ordner> [...] -o <ausgabe-verzeichnis> [--ocr auto|off] [--ocr-lang eng+chi_sim]
- Akzeptiert
.xlsx,.xlsm,.xlsoder Ordner (rekursiv). Gibt eine Zeile pro Arbeitsmappe mit Bildanzahlen aus. - Benötigt Python 3.9+ und
openpyxl. Optional:Pillow(Bildgrößen), Tesseract OCR (Text in Bildern), Microsoft Excel oder LibreOffice (zum Öffnen von.xls). - Selbsttest:
python <skill-verzeichnis>/tests/run_tests.pyerstellt synthetische WPS- und Microsoft-365-Arbeitsmappen und prüft, ob jedes Bild in seiner Zelle landet.
Was Sie pro Arbeitsmappe erhalten (<ausgabe-verzeichnis>/<name>/)
| Datei | Inhalt |
|---|---|
<name>.md | Arbeitsmappenindex, dann jedes Blatt als vollständige Markdown-Tabelle (ohne Kürzung) mit Bildern inline in ihren Zellen; Blattangaben (ausgeblendeter Zustand, zusammengeführte Bereiche, ausgeblendete Zeilen/Spalten, Kommentare, Textfelder, Diagrammanzahl) oberhalb jeder Tabelle |
<name>.images.md | Ein Eintrag pro Bild: das Bild, Blatt!Zelle, Art, Größe, umgebender Zellentext, OCR-Text und ein Platzhalter für die Beschreibung |
images/ | Jedes Bild als Datei, benannt `_<zelle |
sheets_csv/ | Blattwerte; Bildzellen enthalten [image: images/...] |
image_manifest.csv | Blatt, Zelle, Art (in-cell (WPS DISPIMG) / in-cell (Microsoft 365) / floating), Datei, Paketkomponente, Alternativtext, Größe, OCR, umgebender Text |
formula_manifest.csv | Formeltext und zwischengespeicherter Wert pro Zelle |
shapes_manifest.csv | Text aus schwebenden Textfeldern/Formen mit Ankerzelle |
conversion_report.json | Anzahl, Warnungen, review_required |
Arbeitsablauf für den Agenten
- Konvertieren. Führen Sie das Skript mit der/den Arbeitsmappe(n) aus.
- Zuerst den Bericht lesen. Öffnen Sie
conversion_report.json. Handeln Sie jede Warnung:image not found in package-> Die Zelle ist als[image missing: ID]markiert; sagen Sie dies, raten Sie nicht das Bild..emf/.wmf saved as-is-> Konvertieren Sie zu PNG (z. B. Pillow unter Windows, LibreOffice anderswo), bevor Sie es ansehen.charts> 0 -> Diagramme werden gezählt, nicht dargestellt; öffnen oder exportieren Sie das Blatt, wenn das Diagramm wichtig ist.- OCR übersprungen oder eine Sprache fehlt -> Verlassen Sie sich darauf, die Bilder selbst anzusehen.
- Die Bilder ansehen. Öffnen Sie jede in
<name>.images.mdaufgeführte Datei und ersetzen Sie jedendescription-Platzhalter mit dem, was das Bild zeigt: Objekt, lesbarer Text (Etiketten, Modellnummern, Markierungen), Symbole und wie es mit den benachbarten Zellen zusammenhängt. OCR ist ein Hinweis, nicht die Antwort; kleiner Etiketten-Text erfordert oft einen Ausschnitt oder Zoom. - Aus Tabelle und Bildern gemeinsam antworten. Verwenden Sie die Markdown-Tabelle für genaue Zellwerte, Formeln und Struktur; verwenden Sie die Bilder für „Wie sieht es aus / was steht auf dem Teil?“. Zitieren Sie
Blatt!Zellefür beides. - Lücken ehrlich melden. Wenn in Schritt 2 etwas ungelöst blieb, markieren Sie die Arbeitsmappe als überprüfungsbedürftig.
Regeln
- Eine CSV- oder reine Wertetabelle ist kein vollständiger Beleg, wenn die Arbeitsmappe Bilder, Textfelder, Farben oder versteckte Inhalte hat. Prüfen Sie die Blattangaben und Manifeste.
- Ordnen Sie jedes Bild seiner Zelle und den Nachbarn zu; verlassen Sie sich niemals nur auf die Bildreihenfolge.
- Wichtiger Text kann außerhalb von Zellen stehen: Textfelder (Formularnummern, Revisionsmarkierungen), Kommentare, Kopf-/Fußzeilen. Textfelder und Kommentare werden extrahiert; Kopf-/Fußzeilen nicht – prüfen Sie diese in Excel, wenn eine Dokumentnummer fehlt.
- Farbe kann Daten sein (Bestanden/Nicht bestanden, Risikostufe, Status). Dieses Skript dekodiert keine Füllungen oder bedingte Formatierung; wenn Farben eine Bedeutung haben, prüfen Sie sie mit openpyxl oder einem Seitenexport und geben Sie die Zuordnung an.
- Zusammengeführte Bereiche behalten ihren Wert nur in der oberen linken Zelle; lesen Sie die Zeile
merged:, bevor Sie leere Zellen interpretieren. - Ausgeblendete Blätter, Zeilen und Spalten werden konvertiert und aufgelistet, nicht verworfen. Sagen Sie, wenn eine Antwort aus versteckten Inhalten stammt.
- Vertrauen Sie nicht auf mojibake-Pfade in einem Terminal; überprüfen Sie den tatsächlichen Pfad, bevor Sie eine Datei als fehlend melden.
Einschränkungen
- Schwebende Bilder werden in ihrer linken oberen Ankerzelle verlinkt; ein Bild, das sich über viele Zellen erstreckt, wird mit seiner
to_cellim Manifest aufgeführt. - Gruppierte Formen werden gelesen, aber Pfeile und Sprechblasen, die als separate Formen gezeichnet sind, behalten ihre Beziehung zu einem Foto nur in einer Seitenwiedergabe. Wenn das Layout wichtig ist („Welcher Pfeil zeigt wohin?“), exportieren Sie das Blatt mit Excel oder LibreOffice als PDF/PNG und betrachten Sie es zusammen mit dem Markdown.
- Bilder in Kopf-/Fußzeilen (VML) und in Kommentaren werden nicht extrahiert.
.xlsbenötigt Microsoft Excel (Windows, pywin32) oder LibreOffice zur Konvertierung; ohne diese werden nur Zellwerte gelesen und der Bericht sagt dies.
