前言¶
DSH 的设计理念是“一切皆插件”。在微信小游戏的开发流程中，通常需要打开微信开发者工具进行预览和调试。mrtrujay/dsh-weixin-minigame 插件通过官方小游戏助手服务，将预览、日志查看和截图调试功能集成到 dsh Web GUI 的界面中，减少了工具切换的干扰。
核心功能¶
- 预览面板：在 dsh Web 界面内提供浮动预览窗口，由官方小游戏助手服务管理凭证和预览状态，插件本身不存储或上传任何内容。
- 技能指引：提供
weixin-minigame-helper技能，用于引导 MCP 工具的使用和小游戏开发工作流。 - MCP 桥接：建立 DSH 与小游戏助手服务的连接。
- MCP 工具集：支持以下操作：
- 启动或热重载预览 (
run_game) - 读取控制台输出和错误 (
get_logs) - 截取渲染帧（单张或连拍） (
capture_screenshot,capture_screenshot_burst,stop_screenshot_burst) - 真机二维码预览 (
real_device_preview) - 发布版本到微信平台 (
publish) - 开发者平台启动流程 (
open_onboarding) 及mp_*系列工具。
安装与启用¶
此插件需要 dsh Web 环境、Node.js ^22.19.0 或 >=24.0.0 以及 npx。
- 执行安装命令：
dsh plugin --profile web add @trujaycc/dsh-weixin-minigame
- 重启
dsh web。由于客户端模块注册表会缓存包元数据，新安装的插件不会立即生效，必须重启进程。
典型用法¶
该插件通过自然语言触发能力。以下是一些具体示例：
- 查看项目运行：输入 “Bring the mini game project in the current workspace up so I can look at it” 来启动预览。
- 修复崩溃：输入 “Preview the current workspace mini game and keep fixing until the log is clean”，系统会持续获取日志直到无报错。
- 查看渲染结果：输入 “Take a screenshot after that change so I can see it” 来截取当前帧。
- 真机测试：输入 “Run a real-device test on the current workspace mini game”。
- 发布版本：输入 “Publish the current workspace mini game as 1.0.1, note: score fix”。
注意事项¶
- 微信开发者工具：本插件运行时不需要安装微信开发者工具。
- 第三方依赖：上游 MCP 服务器是第三方依赖，通过
npx在启动时获取（当前版本在cordis.patch.yml中固定为0.1.35）。 - 文件残留：官方小游戏助手服务会在游戏项目中留下截图等文件，建议手动将相关文件加入
.gitignore。 - 预览服务器：每台机器只共享一个预览服务器，第一个启动的进程会占用默认端口，后续进程会自动寻找可用端口。
- 重启要求：首次激活插件需要重启
dsh web。 - 权限与安全：插件未注册系统提示注入部分，MCP 工具仅在握手成功后注册。预览状态仅在本地循环接口暴露。
总结¶
该插件为 DSH 用户在 Web 环境下进行微信小游戏开发提供了完整的调试闭环。通过官方助手服务，它无需用户额外安装微信开发者工具，即可在 dsh 内完成从预览到发布的操作。
