Mollie's Stitch Studio

Mollie's Stitch Studio ist ein funktionierender Nachweis der sichersten Architektur, um individuelle Stickdesigns an eine Brother SE700 zu senden, ohne dass ein Mac laufen muss.

Für eine Kurzbeschreibung zum Kopieren, die man Mollies lokalem Coding-Agenten geben kann, siehe MOLLIE_AGENT_HANDOFF.md.

Der VPS speichert validierte Designs. Eine native iPhone-App lädt eine freigegebene PES-Datei herunter, findet die SE700 im selben Wi-Fi-Netzwerk und führt die lokale Übertragung erst durch, nachdem Mollie sie bestätigt hat.

Was bereits funktioniert

• Deterministische Stickdesigns, die aus typisierter Geometrie zusammengesetzt werden.

• Echte PES-Kompilierung mit pyembroidery.

• PES-Dekodierung und -Validierung für Stickrahmen-Grenzen, Stichlänge, Stichzahl und Upload-Größe.

• Technische SVG-Stichvorschauen, die aus der dekodierten PES erzeugt werden.

• Eine authentifizierte VPS-Warteschlange unter https://stitch.204.168.230.132.sslip.io.

• Eine native SwiftUI-Begleit-App für iPhone mit Keychain-Pairing.

• SE700-Erkennung im selben Wi-Fi, exakte Modellprüfung und Zertifikats-Pinning.

• ChatGPT kann eine Übertragung auf der Telefonseite anfordern, ohne LAN-Zugriff oder Schreibberechtigung für die Maschine zu erhalten.

• Ausdrückliche Genehmigung vor dem Upload und Zustellungsprüfung danach.

• Exaktes Brother-pedxml-Multipart-Upload-Verhalten auf Grundlage der Open-Source-Protokollhinweise, die in THIRD_PARTY_NOTICES.md aufgeführt sind.

Backend und iPhone-App sind gebaut und getestet. Es wurde noch keine Datei auf die physische Maschine hochgeladen. Das bleibt eine bewusste, separat bestätigte Aktion.

Architektur

ChatGPT design conversation
          |
          v
typed design recipe -> PES compiler -> decode and validate -> VPS queue
                                                            |
                                                            v
                                                  native iPhone app
                                                            |
                                                   same home Wi-Fi
                                                            |
                                                            v
                                                      Brother SE700

Der VPS kann eine Maschine im Heimnetzwerk nicht direkt erreichen. Das iPhone ist das sichere lokale Relay, weil es sowohl auf HTTPS im Internet als auch auf die SE700 im lokalen Wi-Fi zugreifen kann. ChatGPT kann eine Übertragungsanfrage in die VPS-Warteschlange stellen, aber nur die iPhone-App im Vordergrund kann die Maschine entdecken und den Upload nach Mollies Bestätigung durchführen.

PES ist ein kompiliertes, binäres Maschinenformat mit geordneten Stich-, Sprung-, Trimm-, Farbwechsel- und End-Befehlen. SVG wird nur als bearbeitbares oder überprüfbares Zwischenformat verwendet. Ein beliebiges Bild ist nicht automatisch ein sicheres Stickdesign.

Zuverlässigkeit nach Designquelle

Diese Bereiche schätzen die Stichqualität ohne manuelle Bearbeitung ab. Die PES-Gültigkeit und die LAN-Übertragung können deterministisch sein, aber Stoff, Vlieseline, Nadel, Garn, Spannung und Einspannen in den Rahmen beeinflussen weiterhin das physische Ergebnis. Für jede neue Designklasse sollte eine Probestickung angefertigt werden.

Backend lokal ausführen

uv sync --python 3.12
export STITCH_STUDIO_PAIRING_TOKEN="replace-with-a-long-random-token"
export STITCH_STUDIO_PUBLIC_BASE_URL="http://127.0.0.1:8900"
export STITCH_STUDIO_DATA_DIRECTORY="$(pwd)/work/jobs"
uv run stitch-studio-api

Führe die Prüfungen aus:

uv run ruff check .
uv run pytest -q
uv run stitch-studio generated
uv run stitch-machine-status 192.168.1.112

Der Statusbefehl ist read-only. Führe keinen physischen Upload als unbeaufsichtigten Test aus.

Die iPhone-App ausführen

Das Xcode-Projekt wird aus ios/project.yml mit XcodeGen generiert.

cd ios
xcodegen generate
open MolliesStitchStudio.xcodeproj

Zum Installieren auf einem echten iPhone wählst du in Xcode unter Signing & Capabilities ein Apple-Developmentteam aus, verbindest das Telefon und startest die App. Dieser Mac hat derzeit keine gültige Apple-Identität fürs Codesignier, weshalb der Quellcode im Simulator gebaut werden kann, aber noch nicht auf einem physischen Telefon installiert oder über TestFlight verteilt werden kann.

Für das Pairing werden die öffentliche Server-URL und das private Token aus der VPS-Umgebung benötigt. Das Token in der iPhone-Keychain gespeichert und ist nicht Teil dieses Repositorys.

ChatGPT-Integrationsstatus

Der OAuth-geschützte ChatGPT-Konnektor ist live unter:

https://stitch.204.168.230.132.sslip.io/mcp

Er implementiert Streamable HTTP MCP, dynamische Client-Registrierung, OAuth-Autorisierungscode mit S256-PKCE, eingeschränkte Zugriffstokens, rotierende Refresh-Tokens, die Ermittlung geschlossener Ressourcen und eine private Zustimmungsseite.

So verbindest du Mollies Konto:

1. Melde dich bei Mollies ChatGPT-Konto an.

2. Aktiviere den Entwicklermodus in den ChatGPT-Einstellungen.

3. Wähle Tools, Add und dann MCP Server.

4. Gib die /mcp-Adresse oben ein.

5. Gib das private Verbindungskennwort auf der Zustimmungsseite von Stitch Studio ein.

6. Starte eine neue Unterhaltung und wähle Mollie's Stitch Studio aus den Tools aus.

Das Verbindungskennwort ist nicht im Quellcode oder in dieser README gespeichert. Auf Jakes Mac wird es in der Keychain unter Mollies Stitch Studio ChatGPT abgelegt.

Die MCP-Tools können die SE700-Grenzen beschreiben, Warteschlangen anzeigen, eine eingeschränkte, einfarbige Radblume mit 3 bis 12 Blütenblättern kompilieren und eine Übertragung auf der Telefonseite anfordern. Jede von einem Tool erzeugte PES wird dekodiert und validiert, bevor sie in der iPhone-Warteschlange auftaucht – Stichproben.

Wenn Mollie ChatGPT bittet, ein Design zu senden, sollte die Agent request_machine_transfer mit der ID des wartenden Jobs aufrufen. Die Antwort ändert den Job versand in send_requested; die iPhone-Warteschlange aktualisiert sich, solange die App geöffnet ist, und markiert den Antrag. Mollie öffnet das Design weiterhin selbst, prüft die dekodierte Vorschau, bestätigt die Übertragung und startet das Nähen an derMaschine. ChatGPT prüft das lokale LAN nie und meldet eine physische Übertragung erst, wenn das Telefon die Zustellung meldet.

Diese Trennung verhindert, dass eine Chat-Sitzung oder ein entfernter VPS-Prozess stillschweigend auf die Stickmaschine zugreifen kann.

Übertragung

sicherheit

• Die App prüft vor der Erkennung die PES-Signatur und SHA-256-Prüfsumme.

• Die Erkennung prüft das Brother-Modell 60, den Typ 3 und die pedxml-Version 1.

• Der bekannte Zertifikat-Fingerabdruck der SE700 ist im nativen Client verankert.

• Der Upload wird nach einem unsicheren Schreibvorgang nie automatisch wiederholt.

• Die App vergleicht die Dateiliste der Maschine vor und nach dem Upload.

• Der VPS markiert einen Auftrag nur dann als zugestellt, wenn eine neue Maschinendatei beobachtet wird.

• Die Bedienperson wählt das Design weiterhin selbst aus und startet die Stickarbeit an der Maschine.