前言¶
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 內完成從預覽到發佈的操作。
