jsonlee12138 compiler
用途
处理与编译、单文件构建校验、模拟器刷新相关的操作。先判断用户要的是“局部文件编译结果”，还是“让项目窗口里的模拟器重新运行”。
典型任务：
- 编译并打开指定页面
- 校验单个 JS/TS 文件并查看结果
- 编译 WXML 模板或 WXSS 样式
- 构建 npm
- 重编译刷新模拟器
工作流
- 确认项目路径，必要时先用
open_project_window打开项目窗口。 - 如果用户要模拟器打开某个页面看效果，用
simulator_open_page。 - 如果用户只说刷新、重新跑当前页面、模拟器像没更新，用
simulator_refresh。 - 如果用户只想排查局部文件语法或产物，用单文件编译工具。
- 如果失败，返回工具输出中的错误信息，不要把模拟器刷新结果当成编译校验结果。
工具列表
simulator_open_page — 编译并打开指定页面
触发项目窗口模拟器编译并打开指定页面，不修改持久编译条件列表。适合“去某个页面看效果”，不承诺返回完整编译错误。
wechatide -c <clientName> -t simulator_open_page --project <project> --page pages/index/index [--query id=1]
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
page |
string | 是 | 目标页面路径（如 "pages/index/index"） |
query |
string | 否 | 页面参数（如 "id=1&type=test"） |
scene |
number | 否 | 场景值 |
compile_wxml — 编译 WXML 模板
编译 WXML 模板文件，返回编译结果。isPlugin / isLazyLoad 由工具根据项目配置自动推断。
wechatide -c <clientName> -t compile_wxml --project <project> --file-path pages/index/index.wxml
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
filePath |
string | 是 | 相对 miniprogramRoot 或 pluginRoot 的 .wxml 路径 |
compile_wxss — 编译 WXSS 样式
编译 WXSS 样式文件，返回编译结果。isPlugin / isLazyLoad 由工具根据项目配置自动推断。
wechatide -c <clientName> -t compile_wxss --project <project> --file-path pages/index/index.wxss
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
filePath |
string | 是 | 相对 miniprogramRoot 或 pluginRoot 的 .wxss 路径 |
buildnpm — 构建 npm
构建项目 npm 依赖产物，会修改本地构建结果。
wechatide -c <clientName> -t buildnpm --project <project> [--compile-type miniprogram]
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
compile-type |
string | 否 | 编译类型：miniprogram（默认）或 plugin |
simulator_refresh — 刷新模拟器
触发项目窗口模拟器重新编译/刷新当前页面。适合恢复或刷新运行态。返回 success: true 只表示刷新动作已触发，不代表编译通过；需要验证局部文件结果时，还要按场景单独调用单文件编译工具。
wechatide -c <clientName> -t simulator_refresh --project <project>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
常见目标到工具
| 用户意图 | 选择 |
|---|---|
| "直接编到这个页面让我看效果" | simulator_open_page |
| "模板是不是编挂了" | compile_wxml |
| "样式编译是不是有问题" | compile_wxss |
| "依赖没好，帮我构建 npm" | buildnpm |
| "页面没刷新，重新跑一下" | simulator_refresh |
| "编译一下" | simulator_refresh |
选择指引
- 想直接跳到某个页面并看模拟器表现：用
simulator_open_page - 只想刷新当前模拟器页面或等同点工具栏编译按钮：用
simulator_refresh；返回成功不代表编译通过 - 只排查单文件编译产物：用
compile_wxml、compile_wxss - 依赖产物缺失或用户明确要求构建 npm：用
buildnpm
默认边界
simulator_open_page和simulator_refresh是本地模拟器操作，返回成功只表示触发成功；要确认编译结果必须再用合适的编译校验工具- 单文件编译工具只覆盖局部文件，不代表整个项目能通过完整构建
buildnpm会修改本地构建产物，不要在被动排查中默认执行