Перейти к основному содержимому

Обновление и подключение Agent

Автоматическое обновление приложения​

  1. Нажмите номер версии в верхней части главного экрана, чтобы открыть панель обновлений.
  2. Нажмите 检查更新 на панели.
  3. При обнаружении новой версии панель покажет сравнение версий и краткое описание изменений.
  4. Подтвердите и нажмите 应用更新; служба скачает и заменит ресурсы бэкенда и фронтенда в фоне.
  5. После обновления приложение перезапустится; в режиме трея перезапуск выполняется через трей.

Настройки запуска скриптов​

В 系统配置 → 脚本运行设置 можно управлять следующими параметрами:

  • передавать ли XXTLanControl.lua автоматически перед запуском
  • передавать ли при запуске <设备端已选中> файл XXTLanControl.lua
  • передавать ли XXTLanControl.lua при пакетной загрузке скриптов на устройства
  • пакетно обновлять имеющиеся в 脚本目录 файлы XXTLanControl.lua до версии текущего сервера

Эти настройки в основном влияют на запуск скриптов и обслуживание их файлов.

Панель установки Skill​

В 系统配置 → Skill 安装 встроенный Skill xxtouch-script можно установить в клиенты, поддерживающие Agent Skills. Сейчас доступны следующие цели:

  • Claude Code
  • Codex
  • Claude Desktop (macOS / Windows, установка локального плагина)
  • Claude Desktop 3p (macOS / Windows, установка локального плагина)
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Antigravity
  • Trae
  • Qoder

Claude Desktop и Claude Desktop 3p устанавливаются в формате локального плагина Claude Desktop. Плагин содержит Skill xxtouch-script и конфигурацию подключения MCP XXTLanControl и требует доступные в системе Node.js / npx. Для ограничения длины имён инструментов канала Claude внутри плагина используется идентификатор xxtlc, а отображаемое имя остаётся XXTLanControl, а имя сервиса MCP — XXTLanControl.

Панель установки MCP​

В 系统配置 → MCP 安装 можно записывать и очищать конфигурации распространённых Agent. Новая установка по умолчанию указывает на адрес Streamable HTTP /mcp текущего бэкенда; старая конфигурация xxtlancontrol-mcpserver, указывающая на локальную консоль, автоматически переносится в HTTP-конфигурацию, а конфигурации других консолей не изменяются. Сейчас доступны следующие цели:

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

Режим набора инструментов​

Панель установки предлагает два режима набора инструментов:

  • 开发测试: для отладки и совместного тестирования
  • 完整: позволяет Agent напрямую использовать больше возможностей консоли

Кнопка установки и показанные ниже шаблоны конфигурации меняются в соответствии с выбранным режимом.

Адрес целевой консоли и шаблоны​

  • По умолчанию установка MCP указывает на адрес /mcp текущего экземпляра XXTLanControl.
  • Чтобы локальный Agent подключался к другой консоли, введите её адрес на панели; панель автоматически создаст соответствующий /mcp?toolProfile=....
  • Для Agent, поддерживающих удалённый HTTP MCP, доступна установка одним нажатием; для остальных отображается «Установка одним нажатием пока не поддерживается», старая конфигурация xxtlancontrol-mcpserver не записывается.
  • Для Agent, отсутствующих в списке целей, можно скопировать расположенный ниже HTTP-шаблон JSON / TOML.
  • Claude Desktop и Claude Desktop 3p подключаются к текущему адресу npx -y mcp-remote@latest через локальный /mcp, поэтому нужны доступные Node.js / npx. После записи конфигурации Claude Desktop нужно полностью перезапустить, чтобы MCP загрузился заново.
  • Конфигурация Claude Desktop обычно находится в ~/Library/Application Support/Claude/claude_desktop_config.json или %APPDATA%\Claude\claude_desktop_config.json; Claude Desktop 3p использует отдельный каталог: в macOS ~/Library/Application Support/Claude-3p/claude_desktop_config.json, в Windows сейчас в первую очередь %LOCALAPPDATA%\Claude-3p\claude_desktop_config.json.
  • При диагностике подключения MCP Claude Desktop логи обычного режима находятся в macOS ~/Library/Logs/Claude и Windows %APPDATA%\Claude\logs; логи Claude Desktop 3p — в macOS ~/Library/Logs/Claude-3p, а в Windows сейчас в первую очередь в каталоге логов под %LOCALAPPDATA%\Claude-3p.

Условия использования​

  • Бэкенд /mcp по умолчанию не требует ключа доступа; подключиться может любой Agent, имеющий доступ к порту консоли.
  • Если подключение Agent больше не нужно, сначала удалите его на той же панели.