Mollie's Stitch Studio

Mollie's Stitch Studio는 Mac을 켜둔 상태로 유지하지 않고도 커스텀 자수 디자인을 Brother SE700으로 보낼 수 있는 가장 안전한 아키텍처의 실제 동작하는 개념 증명입니다.

Mollie의 로컬 코딩 에이전트에 제공할 복사-붙여넣기용 요약은 MOLLIE_AGENT_HANDOFF.md에서 확인할 수 있습니다.

VPS는 검증된 디자인을 저장합니다. 네이티브 iPhone 앱은 승인된 PES 파일을 다운로드하고, 같은 Wi-Fi 네트워크에서 SE700을 찾은 다음, Mollie가 확인한 후에만 로컬 전송을 수행합니다.

현재 작동하는 기능

• 입력된 지오메트리에서 조립되는 결정적(deterministic) 자수 디자인

• pyembroidery를 사용한 실제 PES 컴파일

• 훠프 한계, 스티치 길이, 스티치 개수, 업로드 크기에 관한 PES 디코딩 및 검증

• 디코딩된 PES에서 생성된 기술적 SVG 스티치 미리보기

• https://stitch.204.168.230.132.sslip.io에 있는 인증된 VPS 대기열

• Keychain 페어링을 지원하는 네이티브 SwiftUI iPhone 보조 앱

• 동일 Wi-Fi에서 SE700 검색, 정확한 모델 확인, 인증서 고정(pinning)

• ChatGPT가 LAN 접근이나 기기 쓰기 권한을 받지 않고 휴대전화 쪽 전송을 요청할 수 있음

• 업로드 전 명시적 승인 및 전송 후 도착 확인

• THIRD_PARTY_NOTICES.md에 출처가 명시된 오픈소스 프로토콜 노트를 기반으로 정확하게 재현한 Brother pedxml 멀티파트 업로드 동작

백엔드와 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와 로컬 Wi-Fi의 SE700 양쪽에 접근할 수 있는 안전한 로컬 릴레이입니다. ChatGPT는 VPS 대기열에 전송 요청을 준비해 둘 수 있지만, 기계를 발견하고 업로드를 실행할 수 있는 것은 Mollie가 확인한 후에 포그라운드에서 실행 중인 iPhone 앱뿐입니다.

PES는 스티치, 점프, 트림, 색상 변경, 종료 명령을 순서대로 포함하는 컴파일된 바이너리, 기기 형식입니다. SVG는 편집하거나 검손할 수 있는 중간 단계 형식으로만 사용됩니다. 일반 이미지가 자동으로 안전한 자수 디자인이 되는 것은 아닙니다.

디자인 원천별 신뢰성

이 범위는 수동 편집이 없을 때의 스티치 품질을 추정한 것입니다. **PES 유효성과 LAN 전송 자체는 결정적일 수 있지만, 원단, 보강 메지, 노퍼, 실, 장력과 후프 고정은 여전히 실제 결과에 영향을 미칩니다. 모든 새 디자인 유형은 샘플 자수(sticking)를 우선 미리 받아 보아야 합니다.

백엔드를 로컬로 실행하기

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

status 명령은 읽기 전용입니다. 물리 업로드를 무인(unattended) 테스트로 실행 해서는 안 됩니다.

iPhone 앱 실행하기

Xcode 프로젝트는 ios/project.yml에서 XcodeGen을 사용하여 생성됩니다.

cd ios
xcodegen generate
open MolliesStitchStudio.xcodeproj

실제 iPhone에 설치하려면 Xcode의 디버깅 Server를 진행하고, Xcode의 Signing & Capabilities에서 애플 개발 팀을 선택하고, 폰을 연결한 다음 앱을 실행합니다. 현재 이 Mac에는 유효한 Apple 코드 서명 ID가 없으므로 소스는 Simulator에서 빌드되지만, 아직 실제 기기에 설치하거나 Testflight로 보낼 수는 없습니다.

페어링 하려면 공개 서버 URL와 VPS 환경에 저장된 비공개 토큰이 필요합니다. 핵심은 iPhone Keychain에 저장되며 이 저장소에는 포함되지 않습니다.

ChatGPT 통합 확인

OAuth 보호되는 ChatGPT 연결(커넥터)이 다음 위치에 운영 중입니다:

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

Streamable HTTP MCP, 동적 클라이언트 등록, S256 및 PKCE를 이용한 OAuth 인가 코드, 스코프 지정 액세스 토큰, 순환용 갱신 토큰, 보호 리소스 검색, 비공개 동의 페이지를 구현합니다.

Mollie 계정을 연결하기:

1. Mollie의 다시 ChatGPT 계정에 로그인합니다.

2. ChatGPT 설정에서 개발자 모드(Developer Mode)를 활성화합니다.

3. Tools 기능, Add 추가를 다르게 하고 MCP Server를 선택합니다.

4. 위에 나타난 /mcp 주소를 입력하기.

5. Stitch Studio에서 동의 페이지에서 비공개 연결 암호를 입력합니다.

6. 새 대화에서 Tools를 선택하고, Tools중에 Mollie's Stitch Studio를 선택합니다.

연결 비밀번호는 소스 또는 이 README에 저장하지 않습니다. Jesse의 Mac에서는 Keychain Mollies Stitch Studio ChatGPT 항목에 저장됩니다.

MCP는 SE700의 한계를 설명하고, 대기열의 디자인을 나열하며, 제품이 3~12개인 한정 단색 방사형 꽃 한송이를 컴파일하고, 휴대전화 쪽 전송을 요청할 수 있습니다. 각 도구가 생성한 PES는 iPhone 대기열에 나타나기 전에 디코딩 및 검증됩니다. 즉, Mollie가 ChatGPT 디자인 전송을 실행하면:

• 에이전트가 대기열 작업 ID와 함께 request_machine_transfer를 호출합니다.

• 응답에 따라 작업이 send_requested 상태로 바뀝니다.

• 작업 대기열은 해당 SW의 상태를 표시합니다.

• Mollie는 여전히 직접 등 보이면 디자인을 열고 미리보기를 확인하며 전송을 확정한 다음 기계에서 봉제를 시작합니다.

ChatGPT는 사용자의 집 LAN을 스캔하지 않으며 휴대폰이 전송 완료를 신고할 때까지는 물리 전송이 완료 됐다고 판단하지 않습니다이렇게.

이렇게 만들어진 분리는 채팅 세션이나 원격 VPS 프로세스가 자수 기계에 메시온 것을 서너시일어나지 않도록 막아 줍니다.

전송 안전

• PES 시거니와 SHA-256 체크섬을 기기 탐색 전에 확인합니다.

• 검색 시 제작사 기종이 60, 모델 3, 버전 1인지를 확인합니다.

• 알려진 SE700 fingerprint를 기본 클라이언트에 고정해 두어 변조를 방지합니다.

• 잘못될 수 있는 소재를 기반으로 후처리를 반복하지 않습니다.

• 업로드 전후의 기기 파일 목록을 비교하는지 확인합니다.

• 새 바이너리 파일이 생기기 전까지는 VPS가 전송 성공으로 표시하지 않습니다—기존 자작시 단계는 여전히 운영자가 손으로 수행합니다.

물리적인 전송을 시작하는 것은 전적으로 Mollie의 확인 후 실행되는 방식입니다.