jsonlee12138 initializer
用途
这个 scene 用来完成开发前的基础初始化，不负责后续自动化、调试、预览或云操作本身。
适合场景：
- 打开项目或接管已有项目窗口
- 关闭项目窗口或退出 微信开发者工具
- 获取当前登录信息
- 获取项目相关 AppID 信息
- 获取项目身份、运行时上下文、云环境上下文
- 读取或更新项目设置
- 构建 npm 依赖
- 判断后续能力调用所需的基础信息是否已经齐全
工具列表
check_wechatide_status — 检查 微信开发者工具 状态
读取 微信开发者工具 当前登录态、openid 和当前运行的 skill 版本号；传入当前调用侧 agent 加载的 skill.yaml version 字段值时，会检查两者是否匹配。通过 skill-cli 调用时，如果 微信开发者工具 MCP 服务未启动或当前 client 尚未授权，CLI 会使用同一个 <clientName> 自动执行一次 auth 并重试。会话开始时调用一次，确认返回内容中有 openid 且无 warning 后不必重复调用。
wechatide -c <clientName> -t check_wechatide_status --skill-version <skillVersionFromSkillYaml>
其中 <skillVersionFromSkillYaml> 不是固定字符串；调用前应读取当前调用侧 agent 加载的 wechatide-skill/skill.yaml，取该文件顶层 version 字段的值填入。
重要：当工具调用返回当前的版本较低时，务必提醒用户，并从返回的内容中的 skillPath 中更新本 skill
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
version |
string | 否 | 当前调用侧 agent 加载的 wechatide-skill/skill.yaml 文件中的 version 字段值；不传则跳过版本对比提醒 |
login — 触发扫码登录
打开微信开发者工具并显示扫码登录二维码，等待用户扫码完成登录。
wechatide -c <clientName> -t login
无参数。
open_project_window — 打开项目窗口
打开包含模拟器的项目窗口，自动导入到项目列表（如尚未导入）。
⚠️ 必须先执行前置检查，不得直接调用：
- 读取
<project>/project.config.json文件内容 - 确认
appid字段存在且不为空（""和"touristappid"视为无效） - 通过
appid属性预检触发 微信开发者工具 请求链路的 token 刷新与重试 - 如果
project.config.json不存在或appid无效：- 调用
get_user_appids获取可用 AppID - 让用户选择 AppID
- 创建或补全
project.config.json（参考wechatide-tools/references/open-project-window-guide.md）
- 调用
- 如果 AppID 属性预检失败，先触发登录或让用户重新登录，确认登录态后再继续
- 确认配置和登录态均有效后，再执行
open_project_window
wechatide -c <clientName> -t open_project_window --project <project>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
close_project_window — 关闭项目窗口
关闭包含模拟器的项目窗口，不等于关闭整个 DevTools。
wechatide -c <clientName> -t close_project_window --project <project>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
quit — 退出 微信开发者工具
关闭 DevTools。
wechatide -c <clientName> -t quit
无参数。
get_user_appids — 获取用户可管理的全部 AppID
获取当前登录用户可管理的全部 AppID 列表。可通过 type 按小程序/小游戏过滤。
wechatide -c <clientName> -t get_user_appids
wechatide -c <clientName> -t get_user_appids --type miniprogram
wechatide -c <clientName> -t get_user_appids --type minigame
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
type |
string | 否 | 类型：all(默认)、miniprogram、minigame |
automation_runtime_info — 运行时信息
读取 微信开发者工具 当前项目窗口和运行时基础状态（pageStack、currentPage、systemInfo）。
wechatide -c <clientName> -t automation_runtime_info --project <project> --action currentPage
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
action |
string | 是 | pageStack、currentPage、systemInfo |
项目设置请直接读写 project.config.json / project.private.config.json，见 skills/project-config/SKILL.md。project_setting_get / project_setting_update 已废弃，调用只会返回废弃提示。
buildnpm — 构建 npm
构建项目 npm 依赖产物，会修改本地构建结果。
wechatide -c <clientName> -t buildnpm --project <project> [--compile-type miniprogram]
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
compile-type |
string | 否 | 编译类型：miniprogram（默认）或 plugin |
常见目标到工具
| 用户意图 | 选择 |
|---|---|
| "先把项目打开" / "接管当前项目" | 先读取 project.config.json 确认 appid 有效 → open_project_window |
| "看看现在登没登录" | check_wechatide_status |
| "换一个登录用户" | login |
| "关闭项目窗口" | close_project_window |
| "退出 微信开发者工具" | quit |
| "帮我看看我能用的 AppID" | get_user_appids |
| "当前页面是什么" | automation_runtime_info（action: currentPage） |
| "看看项目设置" / "改一下项目设置" | 使用 skills/project-config/SKILL.md（读写 project.config.json / project.private.config.json，不要调 MCP） |
| "构建 npm" | buildnpm |
使用边界
- 这里只负责把开发环境和基础信息准备好
- 不要在这里顺带完成自动化、调试、预览、上传或云侧写操作
- 如果登录是后续动作前提，可以触发登录流程，但不要把等待扫码表述成已经完成登录
- 如果 AppID、项目路径或目标 scene 所需关键信息还不可用，应明确把它作为 blocker 输出
典型移交
只有在登录态、项目路径以及目标 scene 所需关键信息已经明确时，才给出 nextScene。移交时不要让下一个 scene 重新判断初始化问题；把已确认的信息放到 handoffContext。
| 目标 scene | 适用目标 | 移交前必须带上的信息 |
|---|---|---|
automator |
点击、输入、滚动、截图、页面断言 | projectPath、当前页面或目标页面、关键选择器或待验证结果 |
debugger |
console/network/运行态/模拟器状态排查 | projectPath、currentPage、已观察到的异常、可复现步骤或日志关键字 |
compiler |
编译到页面、单文件编译、构建 npm、刷新模拟器 | projectPath、目标页面或目标文件、编译参数、是否需要构建 npm |
previewer |
推送手机预览、生成二维码、上传体验版 | projectPath、预览方式、上传版本信息或二维码输出诉求 |
cloudbase-operator |
查询云环境、云函数列表、部署或增量部署云函数 | projectPath 或 appid、目标 env、函数目录；增量部署需带 appid、云函数目录和相对变更文件或目录 |
如果用户目标同时覆盖多个 scene，先只移交给当前最直接能完成目标的 scene；后续 scene 由任务结果自然触发，不在 initializer 中提前串联多步计划。