wxminiapp-cli

name	wxminiapp-cli
description	微信小程序自动化截图工具，支持全页面滚动截图、动态项目切换和配置缓存。通过 wxminiapp 命令行工具操作。

微信小程序 CLI 工具 (wxminiapp)

本 Skill 提供微信小程序自动化截图能力，基于微信开发者工具的自动化接口，支持全页面滚动截图。

GitHub: https://github.com/crowforkotlin/crowforkotlin.skill.miniapp-cli

首次配置

CLI 路径只需配置一次（缓存到 ~/.wxminiapp/config.properties）：

wxminiapp config --cli "D:/software/微信web开发者工具/cli.bat"

设置默认项目（可选，也可以每次截图时动态指定）：

wxminiapp config --project "C:/path/to/your/miniprogram"

截图

使用缓存的默认项目：

wxminiapp screenshot

动态指定项目（不影响缓存配置）：

wxminiapp screenshot --project "C:/another-project/dist/mp-weixin"

截图自动保存到系统临时目录，路径会在输出中显示。

⚠️ 使用完毕后清理临时文件：

wxminiapp clean

命令参考

wxminiapp init                                安装 Skill 到所有 AI 代理目录
wxminiapp config                              查看当前缓存配置
wxminiapp config --cli <路径>                  缓存微信开发者工具路径
wxminiapp config --project <路径>              缓存默认项目路径
wxminiapp config --port <端口>                 缓存自动化端口（默认 9420）
wxminiapp screenshot [--project <路径>]        截图（可动态覆盖项目）
wxminiapp clean                               清理临时截图
wxminiapp help                                显示帮助

注意事项

• 配置缓存在 ~/.wxminiapp/config.properties，一次配置全局可用
• screenshot 的 --project、--cli、--port 参数可临时覆盖缓存，不修改缓存
• 截图前确保微信开发者工具已安装并已登录
• 临时截图文件使用后务必调用 wxminiapp clean 清理