| name | initializer |
| description | 初始化微信开发者工具环境:打开/关闭项目窗口、扫码登录、获取 AppID、读取运行时上下文。 用户说打开项目、接管项目、登录、有哪些 AppID、退出开发者工具时使用。不负责自动化、预览或云操作。 |
initializer
用途
开发前基础初始化。准备好登录态、项目窗口与关键上下文后,移交给目标 scene。
工具(参数以 --help / tools.yaml 为准)
| 意图 | 工具 |
|---|
| 查登录/版本 | check_wechatide_status(会话已在根入口查过则跳过) |
| 扫码登录 | login(勿把「已展示二维码」说成已登录) |
| 打开项目窗口 | open_project_window |
| 关闭项目窗口 | close_project_window |
| 退出 WechatIDE | quit |
| 可用 AppID 列表 | get_user_appids(可选 --type miniprogram|minigame) |
| 当前页/系统信息 | automation_runtime_info(主归属本 scene) |
项目设置读写 → skills/project-config/SKILL.md(勿调已废弃的 project_setting_*)。
构建 npm → skills/compiler/SKILL.md 的 build_npm。
带 --project 的配置/appid 错误 → project-tool-error-guide.md。
open_project_window
wechatide -c <clientName> open_project_window --project <project>
使用边界
- 只准备环境与基础信息,不顺带自动化/调试/预览/上传/云写操作
- AppID、路径等未齐时,作为 blocker 输出,不要猜
失败快表
| 情况 | 处理 |
|---|
PROJECT_* / APPID_ERROR | project-tool-error-guide.md |
login 已出码但 loginExpired: true | 等待用户扫码;勿声称已登录 |
| 开窗失败且路径/配置无误 | 原样抛错;勿反复无差别 open_project_window |
移交
遵循根 SKILL「跨 scene 移交」。信息齐备后再给 nextScene,handoffContext 至少含 project。
| 目标 | 还需带上 |
|---|
| automator | 当前/目标页、关键选择器或待验证结果;confirmed 含窗口已开 |
| debugger | currentPage、异常现象、可复现步骤或关键字;窗口已开 |
| compiler | 目标页或文件、是否需 build_npm;窗口已开 |
| cloudbase-operator | appid/env、函数目录;增量还需相对变更路径 |
| previewer | project;通常不经本 scene,可直接预览 |
预览 / 上传通常不经本 scene:直接走 previewer(可不打开窗口)。