Ruta

Ejemplo en Windows

Ejemplo en macOS

CLI de WeChat DevTools

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

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

Directorio raíz del proyecto de mini programa

D:\MyProjects\mini-app

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

Herramienta

Función

Acciones compatibles

wechat_ide

Gestión del ciclo de vida del IDE

open login is_login close quit status

wechat_build

Compilación y publicación

compile preview upload build_npm cache_clean

wechat_automator

Interacción automatizada

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

wechat_inspector

Recopilación de registros en tiempo de ejecución

console cdp

wechat_screenshot

Captura de pantalla de la interfaz (composición de imágenes largas)

—

wechat_navigate

Navegar a páginas y recopilar registros CDP

—

wechat_file

Lectura de archivos del proyecto

project_info list_pages read_page read_file

Lo que usted dice

Flujo que ejecuta la IA

"Ayúdame a comprobar si todas las páginas tienen errores"

SOP D — Inspección de todas las páginas

"Haz clic en el botón de inicio de sesión y captura una captura de pantalla"

SOP B — Depuración de UI

"La página está en blanco, ayúdame a diagnosticar"

SOP C — Resolución de anomalías

"Simula la interfaz de pago y prueba el flujo de pago"

SOP E — Pruebas de integración con Mock

"Prueba la página de detalles, ¿cuál es el nombre del parámetro?"

SOP G — Pruebas de subpáginas

"Compara si los puntos de cada página son consistentes"

SOP I — Validación de datos entre páginas

Nombre de la variable

Descripción

Valor por defecto

Obligatoria

WECHAT_DEVTOOLS_CLI

Ruta de la CLI de WeChat DevTools

—

Sí

WECHAT_PROJECT_PATH

Ruta absoluta del proyecto de mini programa por defecto

—

Sí

WECHAT_CLI_TIMEOUT

Tiempo de espera de los comandos CLI (segundos)

30

No

NODE_PATH

Ruta del ejecutable de Node.js

node

No

Versión

Descripción

0.9.15

Adaptación a DevTools 2.x (Electron) + corrección de la falla prolongada en la recopilación de CDP: DevTools 2.x ahora usa Electron (1.06.x Stable sigue siendo NW.js, doble compatibilidad sin reemplazo). La ruta de inicio en macOS se determina automáticamente según la presencia de Resources/package.nw, la entrada lee CFBundleExecutable de Info.plist, y el modo kill usa la ruta del paquete .app — el modo antiguo no coincidía con el proceso de Electron, lo que hacía que wechat_ide(action='open') con parámetros predeterminados fuera completamente inutilizable en macOS; 2.x ya no reconoce el --project de la línea de comandos, en su lugar inicia el proceso con CDP y luego abre el proyecto mediante CLI, y espera a que tanto el puerto de CDP como el del servicio IDE estén listos antes de continuar (de lo contrario, CLI iniciaría otra instancia sin CDP, dando un falso éxito de "proyecto abierto pero CDP no conecta"). Corrección de wechat_inspector(action='cdp') que desde v0.9.0 siempre devolvía 0 resultados — el daemon coloca los resultados en data, mientras que el inspector lee logs que no existe, la herramienta de depuración más utilizada falló silenciosamente durante 8 versiones menores. El límite de flujo del daemon se elevó de los 64 KiB predeterminados de asyncio a 16 MiB (en 2.x, una recopilación de 6 segundos midió 634 KiB, y exceder el límite descartaba silenciosamente todos los resultados). El filtrado de ruido de CDP se adapta a la estructura de target de 2.x, eliminando las nuevas páginas de shell del IDE y los devtools:// que se filtraban por type=webview (medido: 734 → 206). La detección del puerto del IDE ahora lee el archivo .ide que el IDE escribe en disco (los puertos candidatos codificados no acertaban en 2.x); status agrega service_port_enabled (la principal causa de CLI_TIMEOUT, ahora autodiagnosticable) e ide_port; wechat_ide / wechat_build agregan el parámetro cdp_port (9222 suele estar ocupado por Chrome).

0.9.14

Corrección de rutas de lectura de archivos + corrección de parámetros inoperantes: read_page/read_file de wechat_file ahora usan el mismo criterio que list_pages (primero resuelven según miniprogramRoot de project.config.json, luego recurren a la raíz del proyecto) — antes, en proyectos de cloud, el pages/xxx/index devuelto por list_pages al pasarlo a read_page siempre daba error de "archivo de página no encontrado", afectando el primer paso del SOP G; cuando el mismo archivo existe en ambas raíces, se agrega also_found_at para indicarlo fielmente, y project.config.json siempre toma la copia autoritativa de la raíz del proyecto; read_page devuelve resolved_base, read_file devuelve resolved_path. wechat_inspector(action='cdp') agrega la transmisión de cdp_port (antes este parámetro era inútil, siempre conectaba a 9222). subprocess.CREATE_NO_WINDOW ahora usa getattr como respaldo, eliminando el riesgo de AttributeError en plataformas que no son Windows.

0.9.13

Salida temprana de --version + corrección de revisión de documentación: wechat-devtools-mcp --version / -V imprime la versión instalada sin dependencias y sale directamente (uvx reutiliza el entorno ya instalado y no descarga la última versión, un solo comando confirma la versión real); correcciones de documentación: la tabla de parámetros de navigate tenía 5 columnas desalineadas, el nombre del menú Configuración -> Configuración de seguridad, el ejemplo de mcp_version sin versión; se agregan result_output de wechat_ide y timeout de wechat_navigate (que no estaban en la documentación desde v0.6.0); en SKILL.md Step 1 se agrega una línea de autocomprobación de consistencia de versiones de skill/MCP.

0.9.12

Versión del paquete de respuesta de handshake + límite superior de dependencias: en mcp 2.x, serverInfo.version de initialize cambia de cadena vacía a la versión de este paquete (en 1.x sigue reportando la versión del SDK, el SDK no tiene parámetro para sobrescribirlo); se agrega límite superior a la dependencia mcp[cli]>=1.9,<3 para prevenir que futuras versiones mayores de mcp rompan; las importaciones de doble versión se unifican en _compat.py (#9 #10).

0.9.11

Compatibilidad con mcp 2.0.0: el SDK oficial de MCP Python 2.0 (lanzado el 2026-07-28) eliminó mcp.server.fastmcp (renombrado a MCPServer), lo que causaba que los nuevos usuarios fallaran al iniciar; todas las importaciones ahora son compatibles con ambas versiones 1.x/2.x; la dependencia se especifica como mcp[cli]>=1.9 (#8).

0.9.10

Corrección de fallo silencioso de page_path: screenshot.js verifica después de la navegación si la ruta de la página coincide; si falta el sufijo /index o la página no existe, devuelve un error claro en lugar de capturar silenciosamente la página anterior; node_bridge.py corrige la pérdida de mensajes de error del handler del daemon (#5).

0.9.9

Corrección de reinicio del mini programa causado por captura de pantalla: screenshot.js cambia el método de navegación para páginas que no son TabBar de reLaunch (destruye toda la pila de páginas) a navigateTo (apilamiento no destructivo), corrigiendo el problema de reinicio del simulador después de capturar en macOS (#4).

0.9.8

Corrección de estabilidad de conexión de automator: la verificación de salud de currentPage() en daemon.js cambia a reintentos de sondeo (5 veces × 3s+1.5s para nuevas conexiones), ya no descarta conexiones WebSocket establecidas por carga lenta de página; _action_start usa _run_cli para detectar síncronamente el código de retorno de CLI, percibiendo inmediatamente fallos de CLI (#3).

0.9.7

Corrección de procesos huérfanos residuales del daemon: daemon.js agrega un watchdog del proceso padre, que cada 5 segundos verifica la existencia con process.kill(ppid, 0), y cuando el proceso padre es eliminado, limpia automáticamente las conexiones WS y sale (#2).

0.9.6

Adaptación para macOS: el modo cdp_enabled=true se inicia de forma multiplataforma (programa principal NW.js wechatdevtools + entrada package.nw + limpieza con pkill); la ruta predeterminada de CLI se devuelve según la plataforma; la detección de Node.js agrega rutas candidatas de Homebrew/nvm; README agrega ejemplos de rutas para macOS.

0.9.5

Corrección de un bug latente que hacía fallar permanentemente la verificación de salud de compile (ui_debug.js no tiene la acción page_stack, y desde v0.9.0 automator_verified siempre reportaba false incorrectamente); compile degrada a fail para patrones fatales como EACCES/EADDRINUSE/#initialize-error, evitando "falso éxito que publica un bundle antiguo"; preview resuelve automáticamente rutas relativas + detección de frescura de mtime; wechat_automator(action='start') se actualiza a doble verificación TCP+WS + espera precisa con retry_after_ms; antes de compile se detecta si miniprogram_npm está desactualizado y se emite una advertencia; inspector emite advertencia cuando captura excepciones en duraciones cortas; la herramienta wechat_cloud está deshabilitada (usar CloudBase MCP).

0.9.4

Corrección de que switchTab no funcionaba (se usa miniProgram.switchTab() en lugar de callWxMethod); estabilidad de reconexión después de compile (eliminación de procesos redundantes + retraso de 3s + verificación de salud de WS); 5 mejoras de amigabilidad para agentes en README.

Versión

Descripción

0.9.3

status añade el campo mcp_version para confirmación de versión; imprime el número de versión en stderr al iniciar; README añade guía de resolución de conflictos de versiones pip/uv

0.9.2

Corregido el tiempo de espera de navigate tras compile: la comprobación de salud de la conexión del daemon añade protección de tiempo de espera de 3s; tras compile, invalida automáticamente las conexiones en caché antiguas y se reconecta; el sondeo de navigate currentPage añade un tiempo de espera independiente de 2s por llamada; distingue los códigos de error HEALTH_CHECK_TIMEOUT y CONNECTION_ERROR

0.9.1

Corregido el fallo AttributeError cuando cdp_enabled=true; nueva recopilación de errores de tiempo de ejecución de WXML (tras compile, CDP captura automáticamente advertencias como template not found)

0.9.0

Arquitectura de daemon Node persistente: un único proceso daemon residente, comunicación mediante protocolo NDJSON, conexiones WS reutilizadas por puerto; un único daemon.bundle.js sustituye a 8 bundles independientes; la latencia de las llamadas a herramientas se reduce de 500ms+ a ~3ms; tras compile, el daemon reconstruye automáticamente la conexión sin desconexiones

0.8.0

Reconexión automática del automator tras compile; navigate detecta automáticamente las páginas TabBar y usa switchTab; screenshot añade los parámetros full_page/scroll_top/page_path y el modo de captura de viewport; page_data añade sondeo de expected_path para evitar datos antiguos; el paso dinámico del mosaico de capturas largas corrige huecos de contenido; node_bridge unifica reintentos de desconexión + intervalo de llamada de 500ms; la verificación del puerto de start aumenta a 20 veces

0.7.0

Corregido el ámbito de variables de navigate (currentPageTimeout); evaluate admite sentencias de declaración (fallback const/let/var); call_method devuelve la ruta de la página actual; la verificación por sondeo del puerto de automator start sustituye a la espera ciega; SKILL.md añade principios de eficiencia, niveles de recuperación, métodos de navegación entre páginas y 6 entradas de fallos

0.6.0

navigate admite parámetros query (fallback de tiempo de espera de reLaunch); filtrado de ruido de inicio de CDP (reducción de ruido de console.assert/__route__/ide:// + protección de errores de WXML); valor de retorno de compile en tres categorías + aviso de automator no válido; reintento de sondeo de navigate currentPage; tiempo de espera configurable

0.5.1

wechat_ide(action='open') añade comprobación de salud de inicio de CDP: recopila automáticamente 5 segundos de registros de CDP para detectar errores fatales en la fase de inicio; si hay errores, devuelve fallo directamente para impedir operaciones posteriores

0.5.0

Optimización integral del SOP de Skill: nuevos SOP I/J; comprobación de AppID y validación de path; filtrado de ruido de CDP; corrección de coincidencia difusa en el mosaico de capturas

0.4.1

Reescritura del mosaico de capturas de páginas largas: detección de área fija, adaptación de DPR, cálculo dinámico de solapamiento

0.4.0

Mejora de registros de CDP, verificación automática de despliegue de funciones en la nube, diagnóstico inteligente de navigate, nuevos SOP G/H

0.3.0

Refactorización importante: 44 herramientas agregadas en 8 APIs; registros de CDP v2; nueva base de conocimiento SKILL.md

0.2.6

README añade instrucciones de configuración de OpenAI Codex

0.2.5

Nuevas instrucciones de configuración del editor Kiro

0.2.4

Corrección del mosaico de capturas con desplazamiento: sharp → jimp

0.2.3

Optimización del paquete de publicación: excluye el código fuente de scripts/, conserva solo los artefactos de compilación de dist/

0.2.2

Los scripts de Node.js pasan al modo solo-bundle

0.2.1

Actualización de versión y mejora de documentación

0.2.0

navigate pasa a usar recopilación de registros de CDP de alta definición

0.1.9

Corregido el texto ilegible por codificación UTF-8

0.1.8

Corregido UnicodeDecodeError con rutas chinas en Windows

0.1.7

Nuevos ajustes predefinidos de conjuntos de herramientas core/full; nuevo MCP_DOC.md

0.1.6

wechat_open(cdp_enabled=true) elimina automáticamente los procesos existentes

0.1.5

Corregido el problema de bloqueo de stdio en Windows

0.1.4

Añadidas funciones de registros de CDP, capturas de pantalla, automatización, etc.

0.1.3

Versión inicial