# 微信小游戏助手（WorkBuddy 版本）

# 1. 产品简介

weixin-minigame-helper（WorkBuddy 插件）提供基于 AI 的小游戏开发能力，支持通过自然语言直接驱动小游戏的预览、调试、真机测试与发布。

核心定位：

• AI 驱动的小游戏开发工具链。
• WorkBuddy 生态中的小游戏执行与运行能力组件。

# 2. 安装

在 WorkBuddy 插件市场中搜索：

weixin-minigame-helper

点击安装即可。

注意：安装完成之后，请重启 WorkBuddy，让MCP服务正常运行，如果对话中出现MCP服务未启动，或者不可用等情况，请输入“帮我全局安装最新版NodeJS环境”，等待安装成功之后，重启WorkBuddy重新尝试即可。

# 3. 快速开始

# 3.1 项目结构要求

项目根目录需包含以下文件：

my-game/
├── game.js
├── game.json
└── project.config.json

# 3.2 使用方式

自然语言调用

您可以直接通过自然语言向 WorkBuddy AI 助手发出指令，例如：

• "预览小游戏"
• "进行真机测试"
• "发布 1.0.0 版本"
• "帮我做个微信小游戏，内容为 xxx"

AI 会自动调用插件的相应功能执行任务。

Slash 命令

您也可以使用以下 Slash 命令直接调用插件功能：

# 4. 核心功能

# 4.1 预览

AI 完成微信小游戏开发或手动调用预览后，右侧会打开预览窗口，显示预览界面。

预览界面核心功能：

• 启动 / 停止 / 重载预览。
• 自动监听文件变更（热更新）。
• 多设备尺寸模拟（手机 / 平板 / 自定义）。
• 内置日志面板（Console 输出）。

# 4.2 真机测试

前置条件

请参考"5.1 权限配置"部分完成配置，之后即可使用真机测试与发布功能。

使用流程

1. 点击主界面上的"真机预览"按钮，或在聊天框中输入"帮我进行真机预览"。
2. 若未配置权限，将自动弹出权限配置页面；若已配置，则进入下一步。
3. 插件将编译项目并生成二维码。
4. 使用微信扫码预览。

# 4.3 上传发布

1. 点击主界面上的"上传"按钮，或在聊天框中输入"帮我发布这个微信小游戏，版本号为1.0.0"。
2. 在弹出的对话框中填写版本号与项目备注。
3. 点击"确认发布"。

在微信开发者平台，进入"管理" > "版本管理" > "开发版本"，即可看到已上传的版本。点击"提交审核"，即可进入后续流程。

# 5. 配置说明

点击预览窗口右上角的"配置"按钮，即可进入配置窗口。

# 5.1 权限配置

权限配置主要包括微信小游戏 AppID 和代码上传密钥：

1. 微信小游戏 AppID：在微信公众平台注册获取。
2. 代码上传密钥：在微信公众平台 → 开发 → 开发设置 → 小程序代码上传中生成并下载。

⚠️ 重要：请确保 AppID 对应的是"小游戏"类型，而非"小程序"，否则会报错。

3. 白名单配置：请务必确认 IP 白名单中已包含您的工作机 IP。

# 6. 使用场景（重点）

本插件的核心应用场景包括：

• 在 AI IDE / AI Agent 中驱动全流程开发。
• 根据需求自动生成小游戏代码。
• 自动运行并进行实时验证。
• 自动调试与修复问题。

简而言之，它是作为 AI Agent 执行小游戏开发任务的专用工具。

# 7. 支持范围与限制

说明：

• 当前仅支持标准的 H5 / JS 结构小游戏以及使用cocos引擎的小游戏。
• 部分引擎（如 Unity、Laya）的项目暂未适配。
• 插件将持续迭代，未来版本将逐步增加对主流引擎的支持。

# 8. 常见问题 (FAQ)

Q1: 插件提示"非标准项目结构"。

A: 请确保项目根目录中包含以下三个文件：game.js、game.json 和 project.config.json。

Q2: 真机测试失败。

A: 请检查：

• project.config.json 中的 AppID 是否为"小游戏"类型，而非"小程序"。
• 代码上传密钥文件是否正确配置。

Q3: 提示"IP 白名单错误"。

A: 请登录微信公众平台，在"开发设置"中，将服务器所在的公网 IP 地址添加到 IP 白名单中。

# 9. 联系我们

如有任何问题或建议，欢迎通过以下方式联系我们：

QQ 群

微信助手