Ir para o conteúdo principal

Atualizações e integração com Agent

Atualização do aplicativo​

  1. Clique no número da versão no topo da interface principal para abrir o painel de atualização.
  2. Clique em 检查更新 no painel.
  3. Quando uma nova versão for encontrada, o painel exibirá uma comparação das versões e um resumo das alterações.
  4. Depois de confirmar, clique em 应用更新; o serviço baixará e substituirá os novos recursos de back-end e front-end em segundo plano.
  5. O programa reiniciará automaticamente quando a atualização terminar; no modo de bandeja, a bandeja ajudará a concluir o processo.

Configurações de execução de scripts​

Em 系统配置 → 脚本运行设置, você pode controlar:

  • se XXTLanControl.lua deve ser transferido automaticamente antes da execução
  • se XXTLanControl.lua também deve ser transferido ao executar <设备端已选中>
  • se XXTLanControl.lua também deve ser transferido ao enviar scripts para os dispositivos em lote
  • atualizar em lote os arquivos XXTLanControl.lua existentes em 脚本目录 para a versão atual do servidor

Essas configurações afetam principalmente o fluxo de execução e a manutenção dos ativos de scripts.

Painel de instalação de Skill​

Em 系统配置 → Skill 安装, você pode instalar a Skill integrada xxtouch-script em clientes compatíveis com Agent Skills. Os destinos de instalação integrados atualmente são:

  • Claude Code
  • Codex
  • Claude Desktop (macOS / Windows, instalação de plugin local)
  • Claude Desktop 3p (macOS / Windows, instalação de plugin local)
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Antigravity
  • Trae
  • Qoder

Claude Desktop e Claude Desktop 3p são instalados no formato de plugin local do Claude Desktop. O plugin inclui a Skill xxtouch-script e a configuração de conexão MCP do XXTLanControl e depende de Node.js / npx disponível no computador local. Para respeitar o limite de comprimento dos nomes de ferramentas no canal de plugins do Claude, o identificador interno do plugin é xxtlc; o nome exibido na interface continua sendo XXTLanControl, e o nome do serviço MCP continua sendo XXTLanControl.

Painel de instalação do MCP​

Em 系统配置 → MCP 安装, você pode gravar ou limpar diretamente as configurações dos Agents mais comuns. Uma nova instalação grava por padrão o endereço /mcp Streamable HTTP do back-end atual; uma configuração antiga de xxtlancontrol-mcpserver que aponte para o controle central local atual é migrada automaticamente para uma configuração HTTP, enquanto configurações antigas que apontem para outro controle central não são alteradas. Os destinos de instalação integrados atualmente são:

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

Modos de conjunto de ferramentas​

O painel de instalação oferece dois modos de conjunto de ferramentas:

  • 开发测试: adequado para uso focado em depuração e integração
  • 完整: adequado para permitir que o Agent use diretamente mais recursos do controle central

O botão de instalação e o modelo de configuração exibido abaixo acompanham o modo de conjunto de ferramentas selecionado aqui.

Endereço do controle central de destino e modelos​

  • Por padrão, a instalação do MCP aponta para o endereço /mcp desta instância do XXTLanControl.
  • Para conectar o Agent local a outro controle central, informe o endereço do controle central de destino no painel; ele gerará automaticamente o /mcp?toolProfile=... correspondente.
  • A instalação com um clique é oferecida apenas para Agents que atualmente aceitam MCP HTTP remoto; os Agents incompatíveis exibem "instalação com um clique indisponível" e não voltam a gravar a configuração antiga de xxtlancontrol-mcpserver.
  • Para um Agent que não aparece na lista de destinos, copie diretamente o modelo HTTP JSON / TOML fornecido abaixo do painel.
  • Claude Desktop e Claude Desktop 3p fazem a ponte para o endereço /mcp atual por meio do npx -y mcp-remote@latest local; por isso, Node.js / npx precisa estar disponível localmente. Depois de gravar a configuração, reinicie completamente o Claude Desktop para que o MCP seja carregado novamente.
  • A configuração do Claude Desktop normalmente fica em ~/Library/Application Support/Claude/claude_desktop_config.json ou %APPDATA%\Claude\claude_desktop_config.json; o Claude Desktop 3p usa um diretório separado: no macOS, ~/Library/Application Support/Claude-3p/claude_desktop_config.json; no Windows, atualmente prioriza %LOCALAPPDATA%\Claude-3p\claude_desktop_config.json.
  • Ao investigar a conexão MCP do Claude Desktop, os logs do modo padrão ficam em ~/Library/Logs/Claude no macOS e em %APPDATA%\Claude\logs no Windows; os logs do Claude Desktop 3p ficam em ~/Library/Logs/Claude-3p no macOS e, no Windows, atualmente priorizam o diretório de logs em %LOCALAPPDATA%\Claude-3p.

Pré-requisitos​

  • O back-end /mcp não exige uma chave de acesso por padrão; qualquer Agent que consiga acessar a porta do controle central poderá se conectar.
  • Se você deixar de precisar da integração com Agent, recomendamos voltar ao mesmo painel e executar a desinstalação primeiro.