@trujaycc/dsh-weixin-minigame

English | 中文

Preview, develop, and debug (through logs and screenshots) WeChat Mini Games inside the dsh Web GUI. Modelled on the official WeChat Mini Game Helper.

What it gives you

Surface	What it does
Preview panel	A floating preview window inside the interface that can be opened on its own. Both the preview and the credentials are managed by the official mini game helper service; this plugin neither stores nor uploads anything.
weixin-minigame-helper skill	Guidance for the MCP tools and this plugin, and for the game development workflow.
MCP bridge	Connects dsh to the mini game helper service.

What you can do

From your side

Triggered by natural language.

You want to	Example prompt
See the game running	"Bring the mini game project in the current workspace up so I can look at it"
Fix a crash or a blank screen	"Preview the current workspace mini game and keep fixing until the log is clean"
Check what the frame actually renders	"Take a screenshot after that change so I can see it"
Try it on a real phone	"Run a real-device test on the current workspace mini game"
Ship a version	"Publish the current workspace mini game as 1.0.1, note: score fix"

From the capability side

Capability	Backing MCP tools
Start or hot-reload the preview	run_game
Read console output and errors	get_logs
Capture the rendered frame, single or burst	capture_screenshot, capture_screenshot_burst, stop_screenshot_burst
Real-device QR preview	real_device_preview
Upload a version to the WeChat platform	publish
Platform launch workflow — game info, filing, qualification, version submission	open_onboarding and the mp_* family

Install

• Requires: dsh Web, Node ^22.19.0 or >=24.0.0 (the same range dsh itself requires), npx
• Not required: WeChat DevTools (install it if you want to debug code yourself)

From npm

dsh plugin --profile web add @trujaycc/dsh-weixin-minigame

Then restart dsh web: the client-module registry caches package metadata for the life of the process, so a newly added row is only discovered at the next boot. After that, edits to lib/client.js reload on their own through the always-mounted client HMR chain.

From a local checkout (developing this plugin)

pnpm install
pnpm run build
dsh plugin --profile web add 

Installing from a directory creates a link to the checkout, so a later pnpm run build takes effect without reinstalling. The first activation still needs the dsh web restart above.

To verify what npm would actually publish, use a tarball instead:

pnpm pack
dsh plugin --profile web add ./trujaycc-dsh-weixin-minigame-0.1.0.tgz

A tarball is an unpacked copy, so later code changes need another pnpm pack and a reinstall.

Uninstall

dsh plugin --profile web remove @trujaycc/dsh-weixin-minigame

The game project itself

• A WeChat Mini Game directory containing game.js.
• Real-device preview and publish additionally need a WeChat AppID and an upload private key, configured through the ⚙️ button in the preview page; see the official documentation.

Effect on dsh

Skill injection

One skill joins the session catalog — weixin-minigame-helper, described as the preview/repair loop for WeChat mini game code. Its body is loaded only when the model calls the skill tool; the catalog itself carries the name and description alone, capped by the harness's catalog limit.

No other prompt injection

No system-prompt section is registered, so nothing is paid on unrelated turns. The MCP tool schemas come from the upstream service and are registered only after a successful handshake; a bridge that fails to start merely leaves those tools absent and does not affect dsh startup.

Interface

A trigger button joins the top-right of the session header (the lamp on its left is green while a project is running, grey when idle, and hollow when the plugin is not mounted), alongside a floating window that embeds the official mini game helper preview service.

Known Limitations and Deferred Work

• The upstream MCP server is a third-party dependency. It is fetched by npx at boot, with the version pinned in cordis.patch.yml (currently 0.1.35). Tool names, parameters, and behaviour can change with an upstream release, so run this plugin's tests before bumping that pin.
• The official mini game helper service leaves files in the game project (screenshots, and so on). Add them to .gitignore yourself.
• One preview server per machine, shared across dsh instances and other hosts. The helper records where it listens in a single file under the user's home directory, and the first process to bind takes the default port, so a second process using the helper (another dsh instance, or the official editor extension) overwrites that record and serves on the next free port.
• The preview status is readable by any caller on the loopback interface. It exposes nothing but a local address, so that is proportionate; there is no authentication beyond it.
• Restart required for first activation. The client-module registry's package metadata cache never expires, so a freshly installed plugin is invisible until dsh web restarts.

Develop

pnpm install
pnpm run typecheck
pnpm test
pnpm run build    # emits lib/index.js and lib/client.js (ModuleLoader handoff)

The client bundle resolves react from the dsh Web loader's platform module table and declares no other runtime dependency.

pnpm run watch rebuilds lib/client.js on change; the client HMR chain reloads the plugin in the browser without a page refresh.

References

The workflow this plugin guides the agent through, and the way it drives the MCP server, are modelled on the official WeChat Mini Game Helper.

The MCP service is @weadmin/weixin-minigame-helper-mcp. It is fetched with npx at runtime and is not redistributed with this package.