English
vite-plugin-shopify-theme
Theme Run 命令行工作流
按开发、构建、推送、打包、诊断和恢复任务选择 Theme Run 命令，区分 build、push、package 的职责与每一步的完成标准。
Theme Run 用一个运行上下文串联 Vite 和 Shopify CLI。选择命令时从任务出发，不要把 build、push 和 package 当成同义入口。
| 任务 | 命令 | 完成标准 |
|---|---|---|
| 本地开发 | dev | Vite 与 shopify theme dev 共同运行；退出信号转交给 Shopify CLI，Shopify CLI 退出后关闭 Vite |
| 生成生产资源 | build | Vite 生产构建完成，生产 Mixer、布局渲染标签和开发客户端残留检查通过 |
| 推送 Theme | push | 同一次运行完成构建、生产检查和 shopify theme push |
| 打包 Theme | package | 同一次运行完成构建、生产检查和 shopify theme package |
| 读取诊断 | doctor | 报告插件拥有的状态，不获取锁、不改变 Git、不连接商店；任一检查失败时退出码为 1 |
| 恢复工作区 | restore | 从 Git index 恢复 Mixer，并把它的 skip-worktree 标志还原到之前的状态 |
参数规则
所有命令都必须提供 --path <theme>，并从 Vite 项目根目录运行。Theme Run 只解析命令本身和 --path：
dev、push、package把其余参数原样转交 Shopify CLI，并附上解析后的--path。环境、商店、远端 Theme ID、认证和参数校验仍由 Shopify CLI 负责。build和restore不接受 Shopify 参数。doctor只接受--json，用于输出稳定的诊断码。
0.1 版本移除了旧的本地 --theme 和强制 --env 参数，改用 --path 与 Shopify CLI 原生的 --environment。
已安装版本的精确行为见仓库的 Theme Run CLI。自动化环境应直接使用满足任务的命令；不要先单独运行一次 Vite 构建，再假定后续推送仍处于同一个受保护的运行上下文。
把 doctor 用于读取状态和定位阻塞，把 restore 用于明确结束开发 Mixer 状态。二者职责不同：诊断不改变 Git；恢复会改变目标工作区，并要求 Git index 中保存当前的生产形态 Mixer。