跳到主要内容

更新与 Agent 接入

应用自更新​

  1. 点击主界面顶部的版本号入口，打开更新面板。
  2. 在面板中点击 检查更新。
  3. 发现新版本时，面板会显示版本对比和更新内容摘要。
  4. 确认后点击 应用更新，服务会在后台下载并替换新的后端和前端资源。
  5. 更新完成后程序会自动重启；托盘模式下会通过托盘协助完成。

脚本运行设置​

在 系统配置 → 脚本运行设置 中，可以控制：

  • 运行前是否自动传输 XXTLanControl.lua
  • 运行 <设备端已选中> 时是否也传输 XXTLanControl.lua
  • 批量上传脚本到设备时是否也传输 XXTLanControl.lua
  • 把 脚本目录 中已存在的 XXTLanControl.lua 批量更新为当前服务器版本

这部分设置主要影响脚本运行链路和脚本资产维护。

Skill 安装面板​

在 系统配置 → Skill 安装 中，可以把内置的 xxtouch-script Skill 安装到支持 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 本地插件格式安装，插件内同时包含 xxtouch-script Skill 与 XXTLanControl MCP 连接配置，并依赖本机可用的 Node.js / npx。为了兼容 Claude 插件通道的工具名长度限制，插件内部标识使用 xxtlc，界面显示名仍为 XXTLanControl，MCP 服务名仍为 XXTLanControl。

MCP 安装面板​

在 系统配置 → MCP 安装 中，可以直接为常见 Agent 写入或清理配置。新安装默认写入当前后端的 /mcp Streamable HTTP 地址；指向本机当前中控的旧 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 安装会指向当前这台 XXTLanControl 的 /mcp 地址。
  • 如果想让本机 Agent 连接另一台中控，可以在面板中填入目标中控地址，面板会自动生成对应的 /mcp?toolProfile=...。
  • 当前仅支持远程 HTTP MCP 的 Agent 会开放一键安装；不支持的 Agent 会显示“暂不支持一键安装”，不会回退写入旧 xxtlancontrol-mcpserver。
  • 未出现在目标列表中的 Agent，可以直接复制面板下方提供的 JSON / TOML HTTP 模板。
  • 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。
  • 排查 Claude Desktop MCP 连接时，标准模式日志在 macOS ~/Library/Logs/Claude、Windows %APPDATA%\Claude\logs；Claude Desktop 3p 日志在 macOS ~/Library/Logs/Claude-3p，Windows 当前优先使用 %LOCALAPPDATA%\Claude-3p 下的日志目录。

使用前提​

  • 后端 /mcp 默认不需要访问密钥；能访问中控端口的 Agent 即可连接。
  • 如果后续不再需要 Agent 接入，建议回到同一面板先执行卸载。