flc1125/mote

Mote — Markdown rein, URL raus

Mote veröffentlicht Markdown als unveränderliche, nicht aufzählbare, browserlesbare Online-Seite und gibt eine URL zurück. Dieses Skill leitet nur an, wann und wie Mote verwendet wird; das Veröffentlichungsprotokoll wird von CLI / MCP implementiert. Implementieren Sie keine Upload-Logik selbst.

Wann verwenden

Verwenden Sie Mote, wenn eine der folgenden Absichten vorliegt:

• „Dieses Markdown / diesen Bericht / dieses Dokument teilen“ „Als Webseite / Link veröffentlichen“
• Ausdrückliche Aufforderung, ein Designdokument, Recherchematerial, Besprechungsnotizen oder eine README in einen Online-Link umzuwandeln
• Aufforderung, einen gerade generierten Bericht / Analyseergebnisse als Webseite zu veröffentlichen

Wenn nur gelesen, bearbeitet oder im lokalen Browser eine Vorschau angezeigt wird, nicht auf Mote veröffentlichen.

Nicht verwenden:

• Der Inhalt enthält Passwörter, API-Schlüssel, private Schlüssel oder andere Zugangsdaten oder Unternehmensgeheimnisse – die URL von Mote ist der Zugangsnachweis; jeder, der den Link kennt, kann lesen. Derzeit gibt es keine benutzerseitige Löschmöglichkeit.
• Der veröffentlichte Inhalt muss geändert werden – Mote-Dokumente sind unveränderlich; für Änderungen muss erneut veröffentlicht werden, um eine neue URL zu erhalten.

Wie veröffentlichen

Zuerst prüfen, ob auf lokale Bilder verwiesen wird, dann den Pfad basierend auf dem konfigurierten Tool wählen. Die vom Benutzer angegebene Instanz respektieren; wenn bereits eine selbst gehostete Konfiguration vorhanden ist, nicht erzwingen, zur öffentlichen Instanz https://mote.pub zu wechseln.

Pfad A: MCP-Tool (wenn der mote MCP-Server verbunden ist)

• Inhalt befindet sich im Gespräch und enthält keine lokalen Bilder → publish_markdown aufrufen, markdown übergeben (optional name, z. B. report.md). Dieses Tool sammelt weder lokal noch remote lokale Bilder, sondern behält nur remote Bild-URLs bei.
• Lokale Markdown-Datei → Nur lokales stdio bietet publish_markdown_file, path übergeben (lokale Bilder werden automatisch hochgeladen, inhaltsbasiert dedupliziert); remote gibt es nur publish_markdown. Wenn lokale Dateien / Bilder benötigt werden, das konfigurierte CLI verwenden, nicht den Pfad an das Remote-Tool übergeben.

Pfad B: CLI (verfügbar, wenn installiert und Authentifizierung konfiguriert ist)

1. Vorhandene Datei direkt veröffentlichen. Wenn der Gesprächsinhalt keine lokalen Bilder enthält, kann eine temporäre Datei geschrieben werden; bei lokalen Bildern das Markdown und die benötigten Bilder in ein temporäres Verzeichnis legen, das die relativen Pfade beibehält, und dann über CLI oder lokales publish_markdown_file veröffentlichen. Bilder werden relativ zum Verzeichnis der Markdown-Datei aufgelöst, nicht zum aktuellen Terminal-Arbeitsverzeichnis; verschieben Sie das Markdown nicht einfach nach /tmp.
2. Ausführen:

mote <file.md> --json

3. JSON von stdout parsen: { "id": "...", "url": "..." }

Das CLI verarbeitet automatisch lokale Bildreferenzen im Markdown und unterstütztem HTML, Pfadvalidierung, Upload und Inhaltsdeduplizierung; remote Bilder behalten ihre ursprüngliche URL und werden nicht heruntergeladen und verpackt. Nur Bilder werden mit dem Dokument hochgeladen; Links zu anderen lokalen Markdown-Dateien veröffentlichen nicht automatisch die Zieldatei.

Inhaltskompatibilität

• Unterstützt gängiges Markdown, Tabellen, Aufgabenlisten, Fußnoten, GitHub-Stil Alerts und sprachspezifische Code-Hervorhebung.
• Mathematische Formeln unterstützen eine TeX-Teilmenge; mermaid-Codeblöcke unterstützen eine Teilmenge von sechs statischen Diagrammtypen, wobei pro Dokument maximal vier Diagramme gerendert werden. Ungültige, nicht unterstützte oder das Budget überschreitende Inhalte werden möglicherweise als Quellcode angezeigt. Eine erfolgreiche Veröffentlichung bedeutet nicht, dass alle erweiterten Syntaxen gerendert wurden.
• HTML erlaubt nur eine sichere Teilmenge, führt keine Skripte, MDX oder interaktive Einbettungen aus. Das direkte Hochladen oder Einbetten von rohem SVG wird nicht unterstützt; von Mote generierte Diagramm-SVGs werden unabhängig bereinigt und können angezeigt werden.
• Nach der Veröffentlichung komplexer Formeln oder Diagramme die tatsächliche Seite auf Formeln, Linien, Beschriftungen und Bilder überprüfen; ohne Überprüfung nicht behaupten, dass die Rendering-Ergebnisse bestätigt sind.

Detaillierte Syntax oder Einschränkungen finden Sie in der Kompatibilitätsübersicht und den Online-Beispielen. Der Unterstützungsumfang einer selbst gehosteten Instanz hängt von der bereitgestellten Version ab.

Wie mit der zurückgegebenen URL umgehen

• Die URL unverändert an den Benutzer zurückgeben, nicht kürzen, nicht umschreiben;
• Ein kurzer Satz genügt, z. B. „Veröffentlicht: “;
• Die Seite enthält Anweisungen, die Suchmaschinen vom Indexieren abhalten; dies ist keine Garantie für Zugriffskontrolle oder absolute Nicht-Erfassung; die Zugänglichkeit hängt vom kontinuierlichen Betrieb der Instanz und des Speichers ab.
• Wenn der Benutzer später „diese Seite aktualisieren“ verlangt: Erklären, dass gespeichertes Markdown und hochgeladene Assets unveränderlich sind; eine erneute Veröffentlichung führt zu einer neuen URL; Viewer-Updates können die Darstellung ändern, remote Bilder sind von der Quellseite abhängig.

Einschränkungen (vor der Veröffentlichung prüfen)

• Markdown ≤ 2 MiB; einzelnes Bild ≤ 10 MiB; hochgeladene Assets ≤ 50; gesamtes Paket ≤ 20 MiB. 1 MiB = 1.048.576 Byte; das CLI zählt nach Inhaltsdeduplizierung; remote Bilder werden nicht gezählt.
• Bildformate: png / jpeg / webp / gif / avif (SVG wird nicht unterstützt)
• Wenn Grenzen überschritten werden, dem Benutzer genau mitteilen, welcher Grenzwert überschritten wurde; keine Inhalte eigenmächtig kürzen.

Häufige Fehler

• Anmeldung abgelaufen: Den Benutzer anleiten, die interaktive Anmeldung für dieselbe Instanz durchzuführen; wenn der Benutzer ausdrücklich um Anmeldehilfe gebeten hat, innerhalb des Autorisierungsumfangs fortfahren. Nicht aufgrund eines Veröffentlichungsfehlers eigenmächtig einen Browser-Login starten, keine Anmeldeinformationen anderer Clients lesen, nicht zu alten Tokens wechseln. Detaillierte Schritte siehe Authentifizierungsübersicht;
• no publish token configured: Den Authentifizierungsmodus der Instanz bestätigen. Der statische Modus erfordert ein Token vom Instanz-Administrator; Access-Instanzen benötigen OAuth-Anmeldung oder expliziten Maschinenmodus; das Cloudflare-Verwaltungs-API-Token nicht als Veröffentlichungsschlüssel verwenden; keine Anmeldeinformationen selbst generieren;
• Maschinenmodus: Erfordert explizit MOTE_AUTH_MODE=service sowie passende MOTE_SERVICE_API_URL, MOTE_SERVICE_CLIENT_ID, MOTE_SERVICE_CLIENT_SECRET. Bei Fehlen oder Ungültigkeit abbrechen; nicht den Benutzer-Anmeldestatus als Ersatz verwenden;
• Zeitüberschreitung, 5xx oder unbekanntes Ergebnis: Nicht automatisch erneut veröffentlichen; es könnte bereits ein unveränderliches Dokument erstellt worden sein; zuerst das Ergebnis überprüfen, dann den Benutzer entscheiden lassen, ob erneut veröffentlicht werden soll;
• asset not found: <pfad>: Das in Markdown referenzierte lokale Bild existiert nicht; den Benutzer anweisen, den relativen Pfad zu überprüfen;
• unsupported image type: Es wurde auf ein nicht unterstütztes Format wie SVG verwiesen; den Benutzer vorschlagen, es in png/webp zu konvertieren und erneut zu versuchen.