Mollie's Stitch Studio

Mollie's Stitch Studio — это рабочий пример самой безопасной архитектуры для отправки пользовательских дизайнов вышивки на Brother SE700 без необходимости оставлять Mac включённым.

Для скопированной вставки краткого задания локальному агент-кодеру Молли см. MOLLIE_AGENT_HANDOFF.md.

VPS хранит проверенные дизайны. Нативное приложение для iPhone загружает одобренный файл PES, находит SE700 в той же Wi-Fi сети и выполняет локальную передачу только после подтверждения Молли.

Что уже работает

• Детерминированные дизайны вышивки, собираемые из типизированной геометрии.

• Реальная компиляция PES с помощью pywindow.

• Декодирование PES и проверка границ пялец, длины стежков, количества стежков и размера загрузки.

• Техническое происхождение стайловых превью из декодированного PES в SVG.

• Аутентифицированная очередь VPS на https://stitch.204.168.230.132.sslip.io.

• Нативное приложение-спутник для iPhone с SwiftUI и сопряжением через Keychain.

• Обнаружение SE700 в одной сети Wi-Fi, точная проверка модели и пининг сертификата.

• ChatGPT может запрашивать передачу со стороны телефона, не получая доступа к локальной сети или возможности записи на машину.

• Явное одобрение перед загрузкой и проверка доставки после неё.

• Точное поведение многокомпонентной загрузки Brother pedxml на основе открытых протокольных заметок, указанных в THIRD_PARTY_NOTICES.md.

Бэкенд и приложение для iPhone собраны и протестированы. Ни один файл ещё не был загружен на физическую многофункциональную машину. Это остаётся намеренным, отдельно подтверждаемым действием.

Архитектура

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

VPS не может напрямую достигнуть машины в домашней сети. iPhone является безопасным локальным реле, так как он может работать и по HTTPS в Интернете, и с SE700 в локальной сети Wi-Fi. ChatGPT может сформировать запрос на передачу в очереди VPS, но только активное приложение iPhone может обнаружить машину и выполнить загрузку после подтверждения Молли.

PES — это бинарный скомпилированный машинный формат, содержащий упорядоченные команды стежка, перехода, обрезки, смены цвета и завершения. SVG используется только как редактируемый и проверяемый промежуточный формат. Обычное изображение не является автоматически безопасным дизайном для вышивки.

Надёжность в зависимости от источника дизайна

Эти интервалы оценивают качество строчки без ручного редактирования. Валидность PES и передача по локальной сети могут быть детерминированными, но ткань, стабилизатор, игла, нитка, натяжение и вышивальная кассета всё равно влияют на физический результат. Для каждого нового класса дизайнов следует выполнять контрольную стяжку.

Запуск бэкенда локально

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

Выполните проверки:

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

Проверка статуса — только для чтения. Не выполняйте физическую передачу как фоновый тест без письменного соглашения.

Запуск приложения для iPhone

Проект Xcode создаётся из ios/project.yml с XcodeGen.

cd ios
xcodegen generate
open MolliesStitchStudio.xcodeproj

Чтобы установить на физическое устройство iPhone, выполните выбор команды разработки Apple в Xcode в разделе «Signing & Capabilities», подключите телефон и запустите приложение. У этого Mac нет допустимой подписи кода Apple, поэтому исходники собираются в Симуляторе, но пока этого нельзя поставить на физический телефон или переписать через TestFlight.

Сопружение требует открытый адрес сервера и закрытый токен, хранящийся в окружении VPS. Токен сохраняется в iPhone Keychain и не ничего в этом репозитории.

Статус интеграции ChatGPT

Защищённый OAuthное подключение ChatGPT работает по адресу:

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

Он реализует Streamable HTTP MCP, динамическую регистрацию клиентов, OAuth-авторизацию с S256 PKCE, токены ограниченного доступа, ротацию refresh-токенов, обнаружение защищённого ресурса и отдельную страницу согласия.

Чтобы подключить учётную запись Молли:

1. Войдите в учётную запись Mollie's в ChatGPT.

2. Включите режим разработчика в настройках ChatGPT.

3. Выберите «Tools», «Add», а затем «MCP Server».

4. Enter address /mcp above.

5. Введите закрытый пароль подключения на странице согласия Stitch Studio.

6. Начните новый диалог и выберите Mollie's Stitch Studio из Tools.

Пароль подключения не хранится в исходниках или в этом README. На компьютере Джейка он хранится в Keychain под Mollies Stitch Studio ChatGPT.

Инструменты MCP могут описать ограничения SE700, показать очередь дизайнов, создать ограниченный одноцветный радиальный цветок из 3–12 лепестков и запросить перенос с телефона. Каждый получившийся PES декодируется и проходит валидацию, прежде чем появиться в очереди приложения iPhone.

Когда Молли просит ChatterGPT отправить дизайн, агенту besoinювался вызывать request_machine_transfer с идентификатором очереди. Ответ изменяет задание на send_requested; очередь на телефон обновляется, пока приложение открыто, и метит запрос. Молли по-прежнему открывает дизайн, проверяет декодированный превью, подтверждает передачу и запускает вышивку на машине. ChatGPT никогда не сканирует локальную сеть LAN и не подтверждает физическую передачу до тех пор, пока телефони не сообщит о доставке.

Такое разделение предотвращает бесшумную запись на вышивальную машину из чата или удалённого VPS-процесса.

Безопасность передачи

• Приложение проверяет подпись PES и контрольную сумму SHA-256 до обнаружения.

• Проверка устанавливает модель Brother 60, тип 3 и версию pedxml 1.

• Точно известный отпечаток сертификата SE700 привязан в приложении.

• Передача никогда не происходит автоматически после неоднозначной записи.

• Приложение сравнивает список файлов на машине до и после передачи.

• На бэкенде задание считается выполненным только после появления файла на машине.

• Пользователь по-прежнему сам выбирает дизайн и запускает вышивку на станке.