Zum Hauptinhalt springen

Updates und Agent-Anbindung

App-Updates​

  1. Klicken Sie oben im Hauptfenster auf die Versionsnummer, um das Updatefenster zu öffnen.
  2. Klicken Sie im Fenster auf 检查更新.
  3. Bei einer neuen Version zeigt das Fenster den Versionsvergleich und eine Zusammenfassung der Änderungen.
  4. Klicken Sie nach der Bestätigung auf 应用更新; der Dienst lädt Backend- und Frontend-Ressourcen im Hintergrund herunter und ersetzt sie.
  5. Nach dem Update startet das Programm automatisch neu; im Tray-Modus unterstützt der Tray den Vorgang.

Skriptausführungseinstellungen​

Unter 系统配置 → 脚本运行设置 können Sie steuern:

  • ob XXTLanControl.lua vor dem Lauf automatisch übertragen wird
  • ob bei <设备端已选中> auch XXTLanControl.lua übertragen wird
  • ob XXTLanControl.lua beim stapelweisen Hochladen von Skripten übertragen wird
  • 脚本目录 mit vorhandener XXTLanControl.lua stapelweise auf die aktuelle Serverversion aktualisieren

Diese Einstellungen betreffen hauptsächlich den Ausführungspfad und die Pflege der Skriptressourcen.

Skill-Installationsfenster​

Unter 系统配置 → Skill 安装 können Sie den integrierten Skill xxtouch-script in Clients mit Agent-Skills-Unterstützung installieren. Die integrierten Ziele sind:

  • Claude Code
  • Codex
  • Claude Desktop (macOS / Windows, lokale Plugininstallation)
  • Claude Desktop 3p (macOS / Windows, lokale Plugininstallation)
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Antigravity
  • Trae
  • Qoder

Claude Desktop und Claude Desktop 3p werden im lokalen Claude-Desktop-Pluginformat installiert. Das Plugin enthält den xxtouch-script-Skill und die XXTLanControl-MCP-Verbindung und benötigt lokal verfügbares Node.js/npx. Wegen der Längenbeschränkung für Toolnamen verwendet die interne Plugin-ID xxtlc; der Anzeigename bleibt XXTLanControl, und der MCP-Dienstname bleibt ebenfalls XXTLanControl.

MCP-Installationsfenster​

Unter 系统配置 → MCP 安装 können Sie Konfigurationen für gängige Agents schreiben oder bereinigen. Neue Installationen verwenden standardmäßig die Streamable-HTTP-Adresse /mcp des aktuellen Backends. Alte xxtlancontrol-mcpserver-Konfigurationen für die lokale Zentrale werden automatisch in HTTP konvertiert; Konfigurationen für andere Zentralen bleiben unverändert. Integrierte Ziele sind:

  • Claude Code
  • Codex
  • Claude Desktop
  • Claude Desktop 3p
  • VS Code
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Antigravity
  • Trae
  • TRAE CN
  • TRAE SOLO
  • Qoder

Toolset-Modi​

Das Installationsfenster bietet zwei Toolset-Modi:

  • 开发测试: für Tests und Debugging
  • 完整: wenn der Agent direkt mehr Zentralenfunktionen verwenden soll

Installationsschaltflächen und angezeigte Konfigurationsvorlagen folgen dem hier ausgewählten Toolset-Modus.

Zieladresse der Zentrale und Vorlagen​

  • Standardmäßig zeigt die MCP-Installation auf die /mcp-Adresse dieser XXTLanControl-Instanz.
  • Für die Verbindung eines lokalen Agents mit einer anderen Zentrale geben Sie deren Adresse ein; das Fenster erzeugt automatisch die passende /mcp?toolProfile=...-URL.
  • Die Ein-Klick-Installation ist nur für Agents mit Remote-HTTP-MCP verfügbar. Nicht unterstützte Agents zeigen „Ein-Klick-Installation derzeit nicht unterstützt“ und fallen nicht auf xxtlancontrol-mcpserver zurück.
  • Für Agents außerhalb der Zielliste können Sie die JSON-/TOML-HTTP-Vorlagen unter dem Fenster kopieren.
  • Claude Desktop und Claude Desktop 3p verwenden die lokale Brücke npx -y mcp-remote@latest zur aktuellen /mcp-Adresse. Node.js/npx muss verfügbar sein; nach dem Schreiben der Konfiguration muss Claude Desktop vollständig neu gestartet werden, damit MCP neu geladen wird.
  • Die Claude-Desktop-Konfiguration liegt meist unter ~/Library/Application Support/Claude/claude_desktop_config.json oder %APPDATA%\Claude\claude_desktop_config.json. Claude Desktop 3p verwendet eigene Verzeichnisse: macOS ~/Library/Application Support/Claude-3p/claude_desktop_config.json, Windows derzeit bevorzugt %LOCALAPPDATA%\Claude-3p\claude_desktop_config.json.
  • Bei der Fehlersuche für Claude-Desktop-MCP-Verbindungen liegen Standardprotokolle unter macOS ~/Library/Logs/Claude und Windows %APPDATA%\Claude\logs. Claude Desktop 3p verwendet macOS ~/Library/Logs/Claude-3p und unter Windows derzeit bevorzugt ein Protokollverzeichnis unter %LOCALAPPDATA%\Claude-3p.

Voraussetzungen​

  • Das Backend /mcp benötigt standardmäßig keinen Zugriffsschlüssel; jeder Agent, der den Zentralenport erreichen kann, kann sich verbinden.
  • Wenn die Agent-Anbindung später nicht mehr benötigt wird, deinstallieren Sie sie zuerst in demselben Fenster.