跳到主要内容

# 更新与 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 接入，建议回到同一面板先执行卸载。