跳至主要內容

更新與 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 接入，建議回到同一面板先執行解除安裝。