Little Mouse Pointer

English README

Este repositorio proporciona Little Mouse Pointer: un selector de contexto de UI para el escritorio de Windows orientado a agentes de IA. El usuario puede seleccionar ventanas, elementos de UI o áreas de la pantalla con el ratón, obtener el contexto mediante UI Automation, capturas de pantalla y OCR nativo, y, tras la confirmación, proporcionarlo a OpenAI Codex, DeepSeek Harness u otros clientes compatibles a través de MCP.

El directorio del plugin es plugins/little-mouse-pointer. La funcionalidad completa, el protocolo y las instrucciones de ejecución se describen en el README del directorio del plugin.

Navegación de documentación

• Tutorial para principiantes: proceso completo de primera instalación, primera selección y problemas comunes.

• Lista de verificación de instalación para principiantes: verificación elemento por elemento según los escenarios de Codex, DeepSeek Harness y ejecución manual.

• README completo del plugin: funcionalidad, flujo de uso, limitaciones de privacidad y límites de fallos.

• Instrucciones de ejecución: paquete de ejecución self-contained, run.ps1 y comportamiento de MCP stdio.

• Configuración de DeepSeek Harness: configuración manual de Cordis cuando el bundle no está disponible.

• Documentación del protocolo: campos de salida de la herramienta y flujo de confirmación.

Related MCP server: desktop-touch-mcp

Instalación desde GitHub en Codex

Ejecute el siguiente comando en PowerShell y reemplace OWNER/REPOSITORY con el repositorio real de GitHub:

codex plugin marketplace add OWNER/REPOSITORY --ref main
codex plugin add little-mouse-pointer@auto-mouse

Si solo necesita descargar el directorio del plugin, puede usar el zip de la release de GitHub o instalar localmente la capa plugins/little-mouse-pointer. No confunda la raíz del repositorio con el directorio raíz directo del plugin.

Integración con DeepSeek Harness

Copie la lista de verificación de instalación en chino o la English installation checklist y, a continuación, consulte la Configuración de DeepSeek Harness, cambiando las rutas al directorio real. MCP stdio debe iniciarse directamente:

plugins/little-mouse-pointer/app/MousePointer.Windows.exe

No use run.ps1 como bridge de MCP stdio; run.ps1 solo se utiliza para iniciar manualmente la GUI y la auto-prueba.

Instalación del bundle de Harness directamente desde GitHub

La raíz del repositorio también proporciona paquetes de instalación que cumplen con la especificación dsh.bundle de Harness. Se recomienda fijar la etiqueta de la versión de la release:

dsh plugin --profile demo add github:Fish121380/auto-mouse#v0.1.1
dsh --profile demo --dump-config

Este bundle localiza automáticamente el exe de Windows x64 que incluye y registra @deepseek-ai/dsh-mcp-client. Solo es compatible con Windows x64; el puerto se puede sobrescribir en cordis.patch.yml del perfil:

- replace:
    - id: little-mouse-pointer
      config:
        port: 49154

Comprobaciones antes de la instalación

• Windows 10/11 x64.

• No es necesario instalar .NET; el paquete de distribución ya es self-contained.

• Conserve todos los archivos de plugins/little-mouse-pointer/app.

• El puerto predeterminado es 49153; el endpoint y MOUSE_POINTER_HTTP_PORT deben coincidir.

• Cierre las instancias antiguas de Little Mouse Pointer antes de ejecutar Codex/Harness.

• Las herramientas MCP son ui_context_pick, ui_context_current, ui_context_clear.