Path

Windows example

macOS example

WeChat DevTools CLI

C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat

/Applications/wechatwebdevtools.app/Contents/MacOS/cli

Mini program project root

D:\MyProjects\mini-app

/Users/<you>/Projects/mini-app

Tool

Function

Supported actions

wechat_ide

IDE lifecycle management

open login is_login close quit status

wechat_build

Build and publish

compile preview upload build_npm cache_clean

wechat_automator

Automated interaction

start tap input element_info set_data call_method call_wx mock_wx evaluate page_stack page_data system_info storage

wechat_inspector

Runtime log collection

console cdp

wechat_screenshot

UI screenshots (long image stitching)

—

wechat_navigate

Navigate to pages and collect CDP logs

—

wechat_file

Project file reading

project_info list_pages read_page read_file

What you say

What the AI executes

"Check all pages for errors"

SOP D — Full-page inspection

"Click the login button and take a screenshot"

SOP B — UI debugging

"The page is blank, help me troubleshoot"

SOP C — Exception troubleshooting

"Mock the payment API and test the payment flow"

SOP E — Mock integration testing

"Test the detail page, what are the parameter names?"

SOP G — Sub-page testing

"Compare whether points are consistent across pages"

SOP I — Cross-page data validation

Variable

Description

Default

Required

WECHAT_DEVTOOLS_CLI

WeChat DevTools CLI path

—

Yes

WECHAT_PROJECT_PATH

Default mini program project absolute path

—

Yes

WECHAT_CLI_TIMEOUT

CLI command timeout (seconds)

30

No

NODE_PATH

Node.js executable path

node

No

Version

Description

0.9.15

Adapt to DevTools 2.x (Electron) + fix long-standing CDP collection failure: DevTools 2.x switched to Electron (1.06.x Stable still uses NW.js, dual-track compatible, no replacement). macOS startup path auto-detects runtime based on presence of Resources/package.nw, reads CFBundleExecutable from Info.plist for the entry point, and kill mode uses the .app bundle path — the old mode couldn't match Electron processes, making wechat_ide(action='open') with default parameters completely unusable on macOS; 2.x no longer recognizes the --project command-line flag, instead it starts the process with CDP first, then opens the project via CLI, and waits for both the CDP and IDE service ports to be ready before continuing (otherwise CLI would spawn another instance without CDP, resulting in a false success where "the project is open but CDP can't connect"). Fix wechat_inspector(action='cdp') always returning 0 results since v0.9.0 — the daemon puts results in data, but the inspector reads the non-existent logs, so the most commonly used debugging tool silently failed for 8 minor versions. daemon stream limit raised from asyncio default 64 KiB to 16 MiB (measured 634 KiB in 6 seconds of collection under 2.x; exceeding the limit silently discards all results). CDP noise filtering adapted to 2.x target structure, removing the new IDE shell pages and devtools:// that slipped through due to type=webview (measured 734 items → 206 items). IDE port detection changed to read the .ide file written by the IDE (hardcoded candidate ports can't be guessed at all under 2.x); status adds service_port_enabled (the #1 cause of CLI_TIMEOUT, now self-diagnosable) and ide_port; wechat_ide / wechat_build add cdp_port parameter (9222 is often occupied by Chrome)

0.9.14

File read path fix + parameter invalidation fix: wechat_file's read_page/read_file changed to use the same resolution as list_pages (first resolve via miniprogramRoot in project.config.json, then fall back to project root) — previously in cloud development projects, feeding pages/xxx/index returned by list_pages to read_page would always report "page file not found", affecting the first step of SOP G; when a file with the same name exists under both roots, also_found_at is added to report it truthfully; project.config.json always takes the authoritative copy at the project root; read_page returns resolved_base, read_file returns resolved_path. wechat_inspector(action='cdp') adds cdp_port passthrough (previously this parameter was a no-op, always connecting to 9222). subprocess.CREATE_NO_WINDOW all switched to getattr fallback, eliminating the AttributeError risk on non-Windows platforms

0.9.13

--version early exit + documentation verification fix: wechat-devtools-mcp --version / -V prints the installed version with zero dependencies and exits directly (uvx reuses the installed environment and doesn't pull the latest; one command confirms the actual version); documentation fixes: navigate parameter table 5-column misalignment, 设置 -> 安全设置 menu name, mcp_version example de-versioned; added documentation for wechat_ide result_output and wechat_navigate timeout (not documented since v0.6.0); SKILL.md Step 1 adds a skill/MCP version consistency self-check line

0.9.12

Handshake response package version + dependency upper bound: Under mcp 2.x, initialize's serverInfo.version changed from empty string to this package's version (under 1.x it still reports the SDK version; the SDK has no parameter to override); dependency upper bound added: mcp[cli]>=1.9,<3 to prevent future major mcp versions from breaking things; dual-version imports unified into _compat.py (#9 #10)

0.9.11

Compatible with mcp 2.0.0: Official MCP Python SDK 2.0 (released 2026-07-28) removed mcp.server.fastmcp (renamed to MCPServer), causing newly installed users to crash on startup; all imports changed to be compatible with both 1.x/2.x; dependency explicitly set to mcp[cli]>=1.9 (#8)

0.9.10

Fix page_path silent failure: screenshot.js verifies page path match after navigation; returns explicit error when /index suffix is missing or page doesn't exist, instead of silently capturing the old page; node_bridge.py fixes daemon handler error message loss (#5)

0.9.9

Fix screenshot causing mini-program restart: screenshot.js changes navigation for non-TabBar pages from reLaunch (destroys entire page stack) to navigateTo (non-destructive push), fixing the simulator reset issue after screenshot on macOS (#4)

0.9.8

Fix automator connection stability: daemon.js currentPage() health check changed to polling retry (5 times × 3s+1.5s for new connections), no longer discarding established WebSocket connections due to slow page loading; _action_start switched to _run_cli to synchronously detect CLI return code, immediately aware of CLI failure (#3)

0.9.7

Fix daemon orphan process residue: daemon.js adds parent process watchdog, checks liveness every 5 seconds with process.kill(ppid, 0), automatically cleans up WS connections and exits after parent process is killed (#2)

0.9.6

macOS adaptation: cdp_enabled=true mode cross-platform startup (NW.js main program wechatdevtools + package.nw entry + pkill cleanup); default CLI path returned per platform; Node.js detection adds Homebrew/nvm candidate paths; README adds macOS path examples

0.9.5

Fix latent bug where compile health check permanently failed (ui_debug.js has no page_stack action; automator_verified has been falsely reporting false since v0.9.0); compile downgrades fatal patterns like EACCES/EADDRINUSE/#initialize-error to fail, preventing "false success publishing old bundle"; preview auto-resolves relative paths + mtime freshness detection; wechat_automator(action='start') upgraded to TCP+WS dual verification + retry_after_ms precise waiting; compile detects outdated miniprogram_npm and issues warning; inspector issues warning when catching exceptions with short duration; wechat_cloud tool disabled (use CloudBase MCP instead)

0.9.4

Fix switchTab navigation not taking effect (switched to miniProgram.switchTab() instead of callWxMethod); post-compile reconnection stability (remove redundant processes + 3s delay + WS health check); README 5 agent-friendliness improvements

Version

Description

0.9.3

status adds mcp_version field for version confirmation; prints version number to stderr on startup; README adds pip/uv version conflict troubleshooting guide

0.9.2

Fix navigate timeout after compile: daemon connection health check adds 3s timeout protection; automatically invalidates old cached connections and reconnects after compile; navigate currentPage polling adds 2s independent timeout per call; distinguishes HEALTH_CHECK_TIMEOUT and CONNECTION_ERROR error codes

0.9.1

Fix AttributeError crash when cdp_enabled=true; add WXML runtime error collection (CDP automatically captures warnings such as template not found after compile)

0.9.0

Persistent Node daemon architecture: single daemon process stays resident, NDJSON protocol communication, WS connections reused by port; single daemon.bundle.js replaces 8 independent bundles; tool call latency reduced from 500ms+ to ~3ms; daemon automatically rebuilds connections after compile with zero disconnects

0.8.0

Automatically reconnect automator after compile; navigate automatically detects TabBar pages and uses switchTab; screenshot adds full_page/scroll_top/page_path parameters and viewport screenshot mode; page_data adds expected_path polling to prevent stale data; long image stitching dynamic step size fixes content gaps; node_bridge unified connection disconnect retry + 500ms call interval; start port verification increased to 20 times

0.7.0

navigate variable scope fix (currentPageTimeout); evaluate supports declaration statements (const/let/var fallback); call_method returns current page path; automator start port polling verification replaces blind waiting; SKILL.md adds efficiency principles, recovery levels, page navigation methods, 6 troubleshooting entries

0.6.0

navigate supports query parameters (reLaunch timeout fallback); CDP startup noise filtering (console.assert/__route__/ide:// noise reduction + WXML error protection); compile return value three-way classification + automator invalidation prompt; navigate currentPage polling retry; configurable timeout

0.5.1

wechat_ide(action='open') adds CDP startup health check: automatically collects 5 seconds of CDP logs to detect fatal errors during startup, returns failure immediately if errors are found to block subsequent operations

0.5.0

Skill SOP comprehensive optimization: adds SOP I/J; adds AppID check and path validation; CDP noise filtering; screenshot stitching fuzzy matching fix

0.4.1

Screenshot long page stitching rewrite: fixed region detection, DPR adaptation, dynamic overlap calculation

0.4.0

CDP log enhancement, cloud function deployment automatic verification, navigate intelligent diagnostics, adds SOP G/H

0.3.0

Major refactor: 44 tools consolidated into 8 APIs; CDP log v2; adds SKILL.md knowledge base

0.2.6

README adds OpenAI Codex configuration instructions

0.2.5

Adds Kiro editor configuration instructions

0.2.4

Screenshot scroll stitching fix: sharp → jimp

0.2.3

Package optimization: excludes scripts/ source code, only keeps dist/ build artifacts

0.2.2

Node.js scripts changed to bundle-only mode

0.2.1

Version update and documentation improvements

0.2.0

navigate switched to CDP high-definition log collection

0.1.9

Fix UTF-8 encoding garbled text

0.1.8

Fix Windows Chinese path UnicodeDecodeError

0.1.7

Adds core/full toolset presets; adds MCP_DOC.md

0.1.6

wechat_open(cdp_enabled=true) automatically kills existing processes

0.1.5

Fix Windows stdio blocking issue

0.1.4

Adds CDP logs, screenshots, automation and other features

0.1.3

Initial version