Little Mouse Pointer

Englisches README

Dieses Repository stellt Little Mouse Pointer bereit: einen Windows-Desktop-UI-Context-Picker für KI-Agenten. Benutzer können mit der Maus Fenster, UI-Elemente oder Bildschirmbereiche auswählen und über UI Automation, Screenshots und lokale OCR Kontext abrufen. Nach Bestätigung wird der Kontext über MCP an OpenAI Codex, DeepSeek Harness oder andere kompatible Clients übergeben.

Das Plugin befindet sich unter plugins/little-mouse-pointer. Vollständige Funktions-, Protokoll- und Laufzeitbeschreibungen finden Sie in der README des Plugins.

Dokumentationsnavigation

• Einsteiger-Tutorial: Vollständiger Ablauf für Erstinstallation, erste Auswahl und häufige Probleme.

• Einsteiger-Checkliste: Schrittweise Bestätigung für Codex-, DeepSeek-Harness- und manuelle Ausführungsszenarien.

• Vollständige Plugin-README: Funktionen, Nutzungsablauf, Datenschutzgrenzen und Fehlerbehandlung.

• Laufzeitbeschreibung: Self-contained-Laufzeitpaket, run.ps1 und MCP-stdio-Verhalten.

• DeepSeek-Harness-Konfiguration: Manuelle Cordis-Konfiguration, wenn das Bundle nicht verfügbar ist.

• Protokollbeschreibung: Tool-Ausgabefelder und Bestätigungsablauf.

Related MCP server: desktop-touch-mcp

Installation von GitHub in Codex

Führen Sie in PowerShell den folgenden Befehl aus und ersetzen Sie OWNER/REPOSITORY durch das tatsächliche GitHub-Repository:

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

Wenn Sie nur das Plugin-Verzeichnis herunterladen möchten, können Sie das GitHub-Release-ZIP verwenden oder lokal die Ebene plugins/little-mouse-pointer installieren. Verwenden Sie nicht fälschlicherweise das Repository-Stammverzeichnis als Plugin-Stammverzeichnis.

Anbindung an DeepSeek Harness

Kopieren Sie die chinesische Installations-Checkliste oder die englische Installations-Checkliste und beziehen Sie sich auf die DeepSeek-Harness-Konfiguration. Passen Sie die Pfade an das tatsächliche Verzeichnis an. MCP stdio muss direkt gestartet werden:

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

Verwenden Sie run.ps1 nicht als MCP-stdio-Bridge; run.ps1 dient ausschließlich zum manuellen Starten der GUI und für Self-Tests.

Direkte Installation des Harness-Bundles von GitHub

Das Repository-Stammverzeichnis enthält außerdem ein Installationspaket gemäß der Harness-dsh.bundle-Spezifikation. Es wird empfohlen, ein festes Release-Tag zu verwenden:

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

Das Bundle lokalisiert automatisch das mitgelieferte Windows-x64-EXE und registriert @deepseek-ai/dsh-mcp-client. Es ist ausschließlich für Windows x64 geeignet; der Port kann in der cordis.patch.yml des Profils überschrieben werden:

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

Checkliste vor der Installation

• Windows 10/11 x64.

• Keine .NET-Installation erforderlich, das Release-Paket ist self-contained.

• Alle Dateien unter plugins/little-mouse-pointer/app müssen erhalten bleiben.

• Standardport ist 49153; Endpoint und MOUSE_POINTER_HTTP_PORT müssen übereinstimmen.

• Vor dem Start von Codex/Harness müssen alte Little-Mouse-Pointer-Instanzen beendet werden.

• MCP-Tools: ui_context_pick, ui_context_current, ui_context_clear.