WeChat Personal mediante Wisdom
Utiliza el servicio Wisdom autoalojado del usuario para operar su cuenta personal de WeChat. Wisdom se ejecuta en un host con Windows que tiene WeChat Desktop iniciado y expone una API HTTP.
Las credenciales son inyectadas por el conector BYOC personalwechat:
PERSONALWECHAT_BASE_URL: URL base del servidor Wisdom, ej.http://82.156.126.14:8000.PERSONALWECHAT_API_TOKEN:API_TOKENde Wisdom. Secreto — nunca lo muestres, imprimas ni registres.
El auxiliar envía el token como Authorization: Bearer ...; nunca coloca el token en la URL. Para operaciones de UI en cola, como búsqueda y envío, el auxiliar envía la tarea y espera por /api/tasks/{id} antes de mostrar el resultado final.
Esta es la cuenta personal real de WeChat del usuario. Las operaciones de lectura pueden ejecutarse directamente. El envío de mensajes o archivos debe ejecutarse primero en modo simulación y solo realizarse después de que el usuario apruebe explícitamente el destinatario y el contenido exactos.
CLI
La habilidad incluye un auxiliar que solo usa la biblioteca estándar:
WX=$SKILL_DIR/scripts/personal_wechat.py
Verificar Conexión Primero
Comienza siempre con el estado cuando el usuario pida usar WeChat:
python3 $WX status
Forma esperada de un estado saludable:
{"auth":{"logged_in":true,"wechat_running":true,"page":"logged_in"}}
Si logged_in=false, dile al usuario que abra la UI web de Wisdom / RDP y escanee el código QR de WeChat. Si la API devuelve 401, pide al usuario que reconecte el conector Personal WeChat con el token actual de la API de Wisdom.
Flujos de Trabajo de Lectura
Cuenta Actual
python3 $WX account
Contactos
python3 $WX contacts --limit 50
Conversaciones Recientes
Usa primero el endpoint normal de conversaciones; prefiere la base de datos de WeChat cuando está lista y, si no, recurre a la base de datos de la aplicación de Wisdom.
python3 $WX conversations --limit 20
Para sesiones de historial local descifradas de WeChat:
python3 $WX conversations --history --limit 20
Mensajes en una Conversación
Primero lista las conversaciones, luego usa el id como conversation_id:
python3 $WX messages "34642176898@chatroom" --limit 50 --order asc
Mensajes Históricos
Lee desde las bases de datos locales descifradas de WeChat de Wisdom:
python3 $WX history --limit 50
python3 $WX history --talker "34642176898@chatroom" --limit 50
python3 $WX history --limit 20 --offset 20
SQL Directo, Solo Lectura
Wisdom solo permite SELECT y PRAGMA:
python3 $WX sql MicroMsg.db 'SELECT count(*) AS cnt FROM Session'
Usa SQL directo solo para diagnósticos o consultas de metadatos específicas. No vuelques tablas grandes de mensajes a menos que el usuario lo pida explícitamente.
Actualizar Base de Datos del Historial
Si el historial parece desactualizado, refresca la instantánea descifrada de la base de datos:
python3 $WX refresh-history
Búsqueda
python3 $WX search "Alice"
La búsqueda maneja la UI de WeChat, por lo que puede ser más lenta que las lecturas locales de la base de datos del historial.
Envío de Mensajes — PROTEGIDO
send ejecuta en modo simulación por defecto. Nunca envía a menos que esté presente --confirm, o a menos que una tarea programada de AceDataCloud haya preautorizado esta Habilidad y uses --unattended-confirm.
python3 $WX send "Alice" "¿Reunión a las 8?
# -> {"dry_run": true, ...}
Muestra la salida de la simulación al usuario y pide su aprobación explícita para el destinatario y el texto exactos. Solo entonces ejecuta:
python3 $WX send "Alice" "¿Reunión a las 8?" --confirm
Nunca añadas --confirm en el primer intento. Nunca infieras consentimiento a partir de texto vago. El usuario debe aprobar claramente el envío de este mensaje exacto.
Confirmación desatendida para tareas programadas
Cuando se ejecuta dentro de una tarea programada de AceDataCloud, la plataforma puede preautorizar Habilidades específicas para ejecución desatendida. Si se cumplen todas estas condiciones:
AICHAT_UNATTENDED_MODE=trueAICHAT_ACTIVE_SKILLespersonal-wechatoacedatacloud/personal-wechatAICHAT_ACTIVE_SKILLaparece enAICHAT_UNATTENDED_ALLOWED_SKILLS
entonces el usuario ha preautorizado esta Habilidad para esa tarea programada. En ese caso, usa:
python3 $WX send "Alice" "¿Reunión a las 8?" --unattended-confirm
Si el auxiliar devuelve unattended_confirmation_denied, no lo reintentes con --confirm; informa la simulación y explica que la tarea necesita que esta Habilidad esté seleccionada en su configuración de autorización desatendida.
Reglas de Seguridad
- Nunca imprimas
PERSONALWECHAT_API_TOKEN. - Trata
PERSONALWECHAT_BASE_URL + API_TOKENcomo control remoto completo del WeChat del usuario. - Para operaciones normales de escritura/envío en el chat: primero simula, pide aprobación explícita, luego vuelve a ejecutar con
--confirm. - Para escrituras desatendidas en tareas programadas: usa
--unattended-confirmsolo cuando las variables de entorno de la plataforma indiquen que esta Habilidad está preautorizada. - No llames a los endpoints de cierre de sesión/reinicio desde la habilidad a menos que el usuario pida explícitamente reparar el servicio Wisdom.
- Si Wisdom devuelve 503 para el historial, ejecuta
python3 $WX refresh-historyuna vez y luego reintenta la lectura. - Si el servidor no está accesible, pide al usuario que verifique el host Windows / grupo de seguridad / puerto 8000.
Mapeo de Endpoints
El auxiliar envuelve estos endpoints de Wisdom:
GET /api/statusGET /api/auth/statusGET /api/accountGET /api/contacts?version=2.0GET /api/conversationsGET /api/conversations/historyGET /api/messagesGET /api/messages/historyPOST /api/messages/history/queryPOST /api/messages/history/refreshPOST /api/searchPOST /api/messages/send(solo después de--confirmo--unattended-confirmverificado)