| name | compiler |
| description | 小程序/小游戏编译与模拟器刷新：打开指定页面、编译 WXML/WXSS、构建 npm、刷新模拟器。 小游戏以刷新模拟器与构建 npm 为主；单文件 WXML/WXSS 编译仅小程序页面适用。 用户说编译一下、跳到某页看效果、构建 npm、模拟器没刷新时使用。 |
compiler
用途
区分「让模拟器跑起来看效果」与「校验局部文件编译产物」。
小游戏：以 simulator_refresh 为主。
compile_wxml / compile_wxss：仅适用于小程序页面模板与样式，不要用于小游戏工程。
意图 → 工具
| 意图 | 工具 |
|---|
| 编到某页看效果 | simulator_open_page |
| 刷新/等同工具栏编译 | simulator_refresh（成功只表示已触发，≠编译通过） |
| 校验 WXML（仅小程序） | compile_wxml |
| 校验 WXSS（仅小程序） | compile_wxss |
| 构建 npm | build_npm（主归属本 scene） |
wechatide -c <clientName> simulator_open_page --project <project> --page pages/index/index [--query id=1]
wechatide -c <clientName> simulator_refresh --project <project>
wechatide -c <clientName> build_npm --project <project> [--compile-type miniprogram]
参数细节：--help / tools.yaml。需要开窗时先走 initializer。小游戏构建 npm 时按项目类型传合适的 --compile-type。
边界
simulator_open_page / simulator_refresh 成功 ≠ 整包或单文件编译通过- 单文件工具只覆盖局部，不代表整包构建成功；且仅小程序页面适用
build_npm 会改本地产物，排查时不要默认执行
失败快表
| 情况 | 处理 |
|---|
| 窗口未开 / 开窗类错误 | 经 initializer open_project_window；PROJECT_* 见 project-tool-error-guide.md |
simulator_refresh 成功但仍异常 | 用 debugger 取 console/截图；勿连续无差别刷新 |
对小游戏调用 compile_wxml/compile_wxss | 停止并改用 simulator_refresh / build_npm |
build_npm 失败 | 原样报告依赖/产物错误；勿在未要求时反复构建 |
移交
| 目标 | 还需 |
|---|
| automator | 已打开的页面路径、待验证点 |
| debugger | 编译后现象、目标页、是否已 refresh |
| previewer | project；可不经模拟器直接预览 |
