jsonlee12138 previewer
用途
处理与预览和发布相关的操作。
典型任务：
- 推送预览到手机
- 生成预览二维码文件
- 触发真机预览流程
- 上传代码包到后台
工作流
- 确认项目已打开且登录态正常。
- 根据任务选择合适的工具（优先
auto_preview）。 - 执行并返回结果。
工具列表
auto_preview — 推送手机预览，自动预览
把预览直接推送到开发者微信，无需生成二维码文件。预览场景的默认首选。
对应 tools.yaml 中的 auto_preview。
wechatide -c <clientName> -t auto_preview --project <project>
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
重要：只传 project 一个参数即可。 不要传 info-output、qr-output 等额外参数。如需落地输出文件，请改用 create_preview_qrcode 并传本地输出路径。
create_preview_qrcode — 获取小程序预览二维码
生成可扫码的小程序预览二维码。默认使用 qr-format: "window" 在新窗口中展示二维码，无需指定本地输出路径。
wechatide -c <clientName> -t create_preview_qrcode --project <project> --qr-format window
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
qr-format |
string | 否 | window（默认，弹窗展示） |
qr-output |
string | 否 | 二维码本地输出文件路径；默认 window 不需要传 |
info-output |
string | 否 | 预览信息本地输出文件路径 |
重要：优先使用 qr-format: "window"，直接在 微信开发者工具 内弹窗展示二维码，用户扫码后手动关闭窗口或等待 120 秒自动关闭。不需要指定 qr-output 路径，避免路径权限问题。
upload — 上传代码 / 发布体验版
上传代码包 / 发布体验版。仅在用户明确要求「上传」、「上传代码」、「发布体验版」时调用。
对应 tools.yaml 中的 upload。
wechatide -c <clientName> -t upload --project <project> --upload-version 1.0.0 [--desc "备注"]
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
project |
string | 是 | 项目本地绝对路径 |
version |
string | 是 | 版本号（如 "1.0.0"） |
desc |
string | 否 | 版本备注说明 |
常见目标到工具
| 用户意图 | 选择 |
|---|---|
| “预览一下” / “发到手机看看” / “真机预览” / “自动预览” | auto_preview |
| “给我一个二维码” / “扫码预览” / “开发版二维码” | create_preview_qrcode（默认 qr-format: “window”） |
| “发布体验版” / “上传” | upload |
使用边界
- 只处理预览、二维码和上传相关目标
auto_preview是默认预览工具，只传projectupload只在用户明确提出上传代码 / 发布体验版时使用