Mollie's Stitch Studio

Mollie's Stitch Studio 是一个可实际运行的验证原型，证明在不需要让 Mac 始终保持运行时，也能将自定义绣花设计发送到 Brother SE700 的最安全架构。

如需一份可直接复制粘贴给 Mollie 的本地编码代理的简报，请参阅 MOLLIE_AGENT_HANDOFF.md。

VPS 中保存经过验证的设计。原生 iPhone 应用会下载已批准的 PES 文件，在同一 Wi-Fi 网络上找到 SE700，并在 Mollie 确认之后才开始执行本地传输。

当前可用的功能

• 利用带类型的几何图形生成确定性的刺绣设计。

• 使用 `pybro 进行真正的 PES 编译。

• 解码和验证 PES，覆盖绣框边界、针脚长度、针脚数量和上传文件大小。

• 根据解码后的 PES 生成技术性 SVG 针脚预览。

• 一个位于 https://stitch.204.168.230.132.sslip.io 的经过认证的 VPS 队列。

• 一个原生 SwiftUI 开发的 iPhone 配套应用，支持 Keychain 配对。

• 同一 Wi-Fi 下 SE700 的发现、精确机型验证和证书固定。

• ChatGPT 可以提出手机端传输请求，但不会获得局域网访问权限或对设备的写入权限。

• 上传前必须获得明确批准，上传后还要进行交付验证。

• 与 THIRD_PARTY_NOTICES.md 中所记载并致谢的开源协议说明完全一致的 Brother pedxml multipart 上传行为。

后端与 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 队列中“暂存”一个转送请求，但只有前台打开状态下的 iPhone 应用，才能发现机器并在得到 Mollie 确认后执行上传操作。

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 上安装，需要在 Xcode 的建立“签名与能力”（Signing & Capabilities）中选择一个 Apple 开发团队，连接手机并运行应用。当前这台 Mac 没有合法 Apple 代码签名身份，因此代码可以可以在仿真器 Simulator 中构建，但还不能安装到物理 iPhone 上或通过 TestFlight 进行分发。

配对需要使用公共服务器 URL，以及存储在 VPS 环境中的私有令牌。该令牌保存在 iPhone 的 Keychain 之中，并且不会被写入本仓库。

ChatGPT 集成状态

受 OAuth 保护的 ChatGPT 连接器已上线，连接地址如下：

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

对应实现既有的 Streamable HTTP MCP、动态客户端注册、带 PKCE/S256 的 OAuth 授权码流程、作用域范围有限的访问令牌、轮转刷新的 refresh token、受保护资源的发现，以及一个专用的、私密授权页面。

要连接 Mollie 的账号，需要这样做：

1. 登录 Mollie 的 ChatGPT 账号。

2. 在 ChatGPT 设置中打开“开发者模式”（Developer Mode）。

3. 选择工具（Tools），点击“Add”，然后选择“MCP Server”。

4. 输入上面这个地址，并外加 /mcp。

5. 在 Stitch Studio 的授权页面上输入专用连接密码。

6. 新建对话，并在工具中选择“Mollie's Stitch Studio”。

连接密码不会存储于源码，也不会出现在这份 README 中。在 Jake 的 Mac 上，它存放在 Keychain 的钥匙串中，其名称是 Mollies Stitch Studio ChatGPT。

MCP 提供工具用于描述 SE700 的刺绣能力限制、列出队列中待处理的设计，并能根据限制条件下生成一朵 3–12 片花瓣的单色放射状花朵，以及提出手机端的传输请求。每一个由工具构造出来的 PES 文件，在进入 iPhone 队列之前都会先经过解码与验证。

当 Mollie 让 ChatGPT 交付一个设计时，代理应调用 request_machine_transfer 并提供排队中的作业 ID。该操作会立即把作业状态修改为 send_requested；在应用处于打开状态时，iPhone 队列也会刷新并显示出这个请求。Mollie 仍然需要亲自打开设计、查看解码过的预览、确认传输，并到设备处启动绣花程序。ChatGPT 从来不会扫描家庭局域网，也绝不会擅自宣称一次物理确认，直到手机回报传输已完成。

这样的隔离机制，防止聊天会话或其他远程 VPS 进程随意、静默地向刺绣机写入数据。

传输安全

• 在设备搜索之前，应用会对 PES 签名和 SHA-256 校验和进行校验。

• 设备搜索过程会，验证 Brother 型号 60、类型 3 以及 pedxml 版本 1。

• 已知某种的 SE700 证书指纹已经固定在原生客户端中。

• 对于结果不明确的写入动作，“不会”自动重试。

• 应用会对比上传前后主机机器上的文件列表。

• 只有在观察到新文件出现在设备之后，VPS 才会将作业例标记为“已交付”。

• 操作员仍须要在设备上完成设备设计和执行刺绣动作。