Shopify网络复制器
Shopify Web Replicator是本地首款MCP产品,用于将公共店面转化为可审查的输出。
它目前支持两个轨道:
replicate_site_to_theme:确定性Shopify主题生成和操作员审查的稳定默认路径replicate_site_to_hydrogen:使用Playwright发现和现场Figma桥生成异步Hydrogen工作空间的高级/测试路径
回购包括共享相同引擎行为的配套API和web UI表面,因此团队可以在代理驱动和人工审核工作流之间移动,而无需切换工具。MCP客户端可以通过本地连接 stdio 或可流式传输的HTTP,具体取决于客户端。
团队首发
pnpm installpnpm buildcp config/destination-stores.example.json config/destination-stores.jsonpnpm dev用于手表模式- 打开MCP或UI流
docs/mcp-setup.md/docs/operator-runbook.md
工作区布局
apps/mcp:具有stdio和可流式传输HTTP入口点的MCP服务器apps/api:由同一复制引擎支持的配套HTTP APIapps/web:用于接收、工作审查和交接的配套操作员UIpackages/engine:MCP和API使用的共享确定性复制引擎packages/shared:共享合同和管道类型packages/theme-workspace:接收生成输出的Shopify主题工作区
脚本
pnpm dev:构建共享和引擎包,然后启动共享监视、引擎监视、API、web应用程序和MCP服务器监视pnpm build:构建共享、引擎、API、web和MCP软件包pnpm typecheck:在所有应用程序和软件包中运行TypeScript检查pnpm test:按顺序运行共享、引擎、API、web和MCP测试pnpm theme:check:在本地主题工作区上运行Shopify主题验证
运行时配置
REPLICATOR_DB_PATH
违约: .data/replicator.db
THEME_WORKSPACE_PATH
违约: packages/theme-workspace
REPLICATOR_HYDROGEN_ROOT
违约: generated-sites
REPLICATOR_CAPTURE_ROOT
违约: .data/captures
REPLICATOR_DESTINATION_STORES_PATH
违约: config/destination-stores.json
FIGMA_MCP_URL
违约: http://127.0.0.1:3845/mcp
这些变量影响MCP服务器、API和伴随网络切换流,因为它们都使用相同的引擎包。
目标存储是从本地JSON文件加载的。使用 config/destination-stores.example.json 作为本地模板 config/destination-stores.json.
MCP刀具表面
replicate_site_to_theme
在一个工具调用中运行源资格、参考捕获和确定性管道端到端,并返回终端切换有效载荷。
replicate_site_to_hydrogen
创建运行Playwright发现的异步Hydrogen复制作业, figma_import, figma_design_context后端推理和Hydrogen工作空间生成。
get_replication_job
按id加载持久作业。
list_replication_jobs
列出最近保留的作业,最新的先列出。
list_destination_stores
列出已配置的目标存储配置文件,以便代理可以选择有效的 destinationStore 运行复制之前的id。
一次性工具返回:
- 作业标识和生命周期状态
- 类型化源确认、捕获、分析、映射、生成、存储设置、商务、验证和集成快照
- 生成的工件元数据和时间戳
- 解析目标存储元数据(如果可用)
- 运行时切换信息:主题工作区路径、捕获根路径和预览命令
- 操作员审查的确定性下一步行动
主题流稳定
- 代理或配套UI选择配置的目标存储,并提交参考URL、可选页面类型和可选注释。
- 该引擎持久保存SQLite作业记录。
- 管道运行
source_qualification首先,对于不受支持或非Shopify来源,它会快速失败。 capture使用Playwright捕获渲染的源代码,导出标题、导航链接、主CTA、图像资产、样式标记、路线提示,并在本地捕获根下保存捕获包以及桌面/移动屏幕截图。- 然后,确定性管道运行
analysis,mapping,theme_generation,store_setup,commerce_wiring,validation,integration_check,以及review. - 主题生成会覆盖主题工作区中特定于稳定页面类型的部分和模板输出。
- 店铺设置计划撰写
config/generated-store-setup.json. - 商业布线写
snippets/generated-commerce-wiring.liquid. - 最终验证在完全生成的工作区上运行。
- 集成检查写入
config/generated-integration-report.json并验证磁盘上生成的文件、商务入口点、部分代码段渲染、签出切换标记和最终验证状态。 - 最终结果是
needs_review或failed.
先进的氢气流量
- 一位代理人打来电话
replicate_site_to_hydrogen和referenceUrl,targetId,可选targetLabel,notes,以及seedRoutes. - 该引擎创建了一个持久的氢气作业,并异步运行这些阶段:
- source_qualification - playwright_discovery - figma_import - figma_design_context - frontend_spec - backend_inference - hydrogen_generation - workspace_validation - review
- 生成的氢气工作空间写在
generated-sites/默认情况下。 - 工作流程取决于可到达的Figma MCP桥。如果网桥不可用,则作业将失败
figma_import通过设计。
捕获工件
- 捕获包写在
.data/captures/默认情况下。 - 每次成功捕获都会写道:
- capture-bundle.json - desktop.jpg - mobile.jpg
- 作业有效负载存储工件路径、提取的样式标记和路由提示,而不是在SQLite中嵌入大blob。
稳定的发电量
sections/generated-reference.liquidsections/generated-homepage-reference.liquidsections/generated-product-reference.liquidsections/generated-collection-reference.liquidtemplates/page.generated-reference.jsontemplates/index.generated-reference.jsontemplates/product.generated-reference.jsontemplates/collection.generated-reference.jsonconfig/generated-store-setup.jsonsnippets/generated-commerce-wiring.liquidconfig/generated-integration-report.json
配套HTTP API
POST /api/jobsPOST /api/hydrogen/jobsGET /api/jobs/:jobIdGET /api/jobs?limit=GET /api/runtimeGET /api/destination-stores
API使用相同的 packages/engine 编排器作为MCP服务器。
本地MCP设置
看 docs/mcp-setup.md 有关stdio启动的详细信息、可流式传输的HTTP设置、Figma网桥配置和环境覆盖。 docs/setup-guide.md 是面向客户的更广泛的设置指南。
配套操作流程
web应用程序对于手动审查稳定的主题工作流程仍然有用:
- 使用以下命令启动repo
pnpm dev. - 在web UI中提交作业或通过MCP创建作业。
- 打开作业详细信息或移交视图。
- 审查源资格、捕获工件路径、提取的路线/样式信号、生成的工件、验证输出、集成输出和下一步。
- 跑
shopify theme dev在配置的工作区中,验证布局、内容、商务布线和购物车到收银台的切换。
Hydrogen目前更倾向于MCP优先,而不是web UI优先。使用 get_replication_job 或API检查这些作业并在 generated-sites/.
电流限制
- 该管道仅限于本地,目前支持符合公共Shopify店面条件的来源。
- 源代码捕获需要本地Playwright/Chromium运行时,目前目标是可以在浏览器会话中加载的公共Shopify店面。
- 商店设置输出仍然是生成的计划,而不是Shopify管理员自动化。
- 商业布线是基于确定性和本地路由的,而不是实时结账自动化。
- 多页复制和签出自定义超出了此切片的范围。
- Hydrogen+Figma路径是一个高级/测试版工作流程。它依赖于一个实时的Figma MCP桥,尚未被记录为一流的web UI审查流程。
