WorkBuddy-QMT Bridge

Puente de trading nativo, de fallo seguro, entre WorkBuddy/MCP y el Python integrado de QMT.

Aviso importante de riesgo

Este proyecto puede activar órdenes en cuentas de simulación o de fondos reales, no constituye asesoramiento de inversión ni garantiza rentabilidad. El modo predeterminado es OBSERVE_ONLY. Cualquier despliegue con fondos reales debe completar primero la aceptación en campo de la versión de QMT objetivo, el mostrador del bróker, los campos de cuenta, los retornos de órdenes, la cancelación de órdenes y los flujos de recuperación. Los mapeos de ejemplo del repositorio no pueden usarse directamente en operativa real.

Versión actual

• Versión: 0.3.0

• Fase: superficie de control de software P1 LIMITED_AUTO completada

• Herramientas MCP: 29

• Python: el Worker requiere 3.10 o superior

• Adaptador QMT: compatible con el entorno Python 3.6 integrado de QMT

• Límite de ejecución: solo se vincula a 127.0.0.1, no depende de xtquant

Página del proyecto: https://github.com/peppaboar95/workbuddy-qmt-bridge

"P1 completado" solo significa que la autorización estructurada, la reserva de límites, la máquina de estados, el disyuntor y la verificación del Adaptador del lado del software se han implementado y superado las pruebas locales; no significa que cualquier mostrador de fondos reales haya sido aceptado.

Related MCP server: lighter-mcp

Cuatro modos

SIM_SIGNAL no significa "solo genera señales pero no envía órdenes". Si se conecta erróneamente a un mostrador de fondos reales, aún puede invocar passorder, por lo que es obligatorio verificar manualmente la cuenta y el mostrador.

Diseño de seguridad

• Confirmación en dos fases con preview_trade y submit_trade_intent;

• Al enviar, se reejecutan todos los controles de riesgo duros y se comparan las huellas de decisión de riesgo;

• El Worker y el Adaptador QMT verifican en ambos extremos la cuenta, el modo, la firma, el TTL y la generación de autorización;

• El permiso LIMITED_AUTO está vinculado a cuenta, valor, acción, versión de estrategia/regla, ventana de negociación, tipo de orden y límites de múltiples capas;

• Reserva atómica de límites, restricción de monto por operación, monto acumulado, número de órdenes, frecuencia, concurrencia, exposición de posición, drawdown y fallos consecutivos;

• Los estados PRE_SUBMIT o SUBMIT_CALLED no se reenvían automáticamente; los resultados desconocidos permanecen como SUBMIT_UNKNOWN;

• Tras un disyuntor, solo se puede recuperar localmente y volver de forma segura a OBSERVE_ONLY;

• La negociación automática de crédito está desactivada por defecto; el nuevo pasivo de crédito requiere un permiso explícito adicional y aceptación en campo.

Instalación

Los usuarios normales deben descargar preferentemente desde GitHub Releases el ZIP de instalación, el hash individual del ZIP y la lista de hashes total:

• workbuddy-qmt-bridge-0.3.0.zip

• workbuddy-qmt-bridge-0.3.0.zip.sha256

• SHA256SUMS.txt

Tras verificar los hashes, descomprima el ZIP y haga doble clic en "首次安装与配置.cmd". Si necesita instalar el wheel manualmente, descargue:

• workbuddy_qmt_bridge-0.3.0-py3-none-any.whl

Windows PowerShell:

python -m pip install .\workbuddy_qmt_bridge-0.3.0-py3-none-any.whl
workbuddy-qmt setup

Instalación de desarrollo desde el código fuente:

git clone https://github.com/peppaboar95/workbuddy-qmt-bridge.git
cd workbuddy-qmt-bridge
python -m pip install -e .

De solo lectura a negociación

1. Ejecute setup para crear la configuración local, claves, token del Worker y directorios de aislamiento de cuentas;

2. Despliegue el qmt_adapter.py y qmt_adapter.json generados en la instancia de estrategia QMT correspondiente;

3. Mantenga OBSERVE_ONLY y complete la recopilación de campos de heartbeat, cuenta, posición, órdenes, ejecuciones y cotizaciones;

4. Complete la verificación de mapeo P0 en el mostrador de simulación objetivo y firme el Profile;

5. En SIM_SIGNAL, complete la verificación de cantidad mínima, envío de órdenes, ejecuciones, cancelación, reinicio y recuperación de resultados desconocidos;

6. Para escenarios de fondos reales, use primero MANUAL_LIVE con montos pequeños para la aceptación;

7. Solo cuando readiness no tenga bloqueos y los límites de la estrategia estén claros, cree un permiso LIMITED_AUTO P1.

La autorización temporal de 1 a 60 minutos de MANUAL_LIVE solo exime de la aprobación manual orden por orden; cada operación aún debe resincronizarse, previsualizarse y pasar los controles de riesgo duros. El permiso de LIMITED_AUTO dura como máximo 720 minutos, pero no puede cruzar días de negociación y está sujeto a los límites completos de la estrategia y al presupuesto acumulado.

Flujo de LIMITED_AUTO P1

1. Cambie localmente el Worker y el Adaptador correspondiente a LIMITED_AUTO;

2. Invoque check_limited_auto_readiness para confirmar que la cola, la instantánea, el heartbeat, la cola de mensajes fallidos y SUBMIT_UNKNOWN no tienen bloqueos;

3. Muestre al operador la política de permiso completa y, tras confirmación explícita, invoque authorize_limited_auto;

4. Las tareas automáticas continúan ejecutando sincronización, previsualización y envío para cada operación;

5. Use get_limited_auto_status para observar el tiempo restante, el número de órdenes, el presupuesto de monto y los motivos de pausa;

6. Cuando se active el guardián de salud, drawdown o fallos consecutivos, se pausa automáticamente; tras la recuperación de condiciones, solo se puede reanudar explícitamente con resume_limited_auto;

7. Al finalizar, invoque revoke_limited_auto. Revocar el permiso no cancela automáticamente las órdenes ya existentes en el lado del bróker.

Verificado y no verificado

Las pruebas incrementales locales de esta versión cubren:

• Migración de esquema v1 a v2;

• Permiso P1 estructurado;

• Previsualización, envío y ocupación atómica de límites;

• Vinculación de versión de estrategia;

• Pausa, reanudación y rotación de generación de autorización;

• Verificación anti-manipulación del Adaptador.

Aún queda por completar según el entorno objetivo:

• Matriz de capacidades de QMT real y bróker;

• Retornos de órdenes, ejecuciones, notas y cancelaciones en mostradores de fondos reales;

• Simulacros de ACL de Windows, copia de seguridad, recuperación y SUBMIT_UNKNOWN;

• Las seis categorías de acciones de cuentas de crédito, dimensiones de campos, elegibilidad, límites y reglas de pasivo;

• Aceptación manual en operativa real con montos pequeños.

Datos y privacidad

runtime, base de datos, WAL/SHM, registros, colas, registros de ejecución, Profile firmado, claves, token del Worker, números de cuenta y configuración local de MCP no deben enviarse al repositorio ni adjuntarse a Issues. El material de diagnóstico debe desidentificarse primero.

Documentación

• Publicación e instalación: docs/README-RELEASE.zh-CN.md

• Notas de validación P1: docs/P1-VALIDATION.zh-CN.md

• Ejemplos de configuración: examples/README.md

• Política de seguridad: SECURITY.md

Licencia

Este proyecto utiliza la Licencia MIT; consulte LICENSE para más detalles.