Chuyển tới nội dung chính

Cập nhật và tích hợp Agent

Tự cập nhật ứng dụng​

  1. Nhấp vào mục số phiên bản ở đầu giao diện chính để mở bảng cập nhật.
  2. Nhấp vào Kiểm tra cập nhật trong bảng.
  3. Khi phát hiện phiên bản mới, bảng sẽ hiển thị phần so sánh phiên bản và tóm tắt nội dung cập nhật.
  4. Sau khi xác nhận, nhấp vào Áp dụng cập nhật; dịch vụ sẽ tải xuống và thay thế tài nguyên backend và frontend mới ở chế độ nền.
  5. Sau khi cập nhật xong, chương trình sẽ tự động khởi động lại; ở chế độ khay hệ thống, ứng dụng khay sẽ hỗ trợ hoàn tất quá trình này.

Cài đặt chạy script​

Trong Cấu hình hệ thống → Cài đặt chạy script, có thể kiểm soát:

  • Có tự động truyền XXTLanControl.lua trước khi chạy hay không
  • Khi chạy <Đã chọn trên thiết bị>, có truyền cả XXTLanControl.lua hay không
  • Khi tải hàng loạt script lên thiết bị, có truyền cả XXTLanControl.lua hay không
  • Cập nhật hàng loạt các tệp XXTLanControl.lua hiện có trong Thư mục script thành phiên bản của máy chủ hiện tại

Các cài đặt này chủ yếu ảnh hưởng đến quy trình chạy script và việc bảo trì tài nguyên script.

Bảng cài đặt Skill​

Trong Cấu hình hệ thống → Cài đặt Skill, có thể cài đặt Skill xxtouch-script tích hợp sẵn vào các ứng dụng khách hỗ trợ Agent Skills. Các đích cài đặt tích hợp hiện gồm:

  • Claude Code
  • Codex
  • Claude Desktop (macOS / Windows, cài đặt plugin trên máy tính)
  • Claude Desktop 3p (macOS / Windows, cài đặt plugin trên máy tính)
  • GitHub Copilot
  • Cursor
  • Windsurf
  • Antigravity
  • Trae
  • Qoder

Claude Desktop và Claude Desktop 3p được cài đặt theo định dạng plugin cục bộ của Claude Desktop. Plugin đồng thời chứa Skill xxtouch-script và cấu hình kết nối MCP XXTLanControl, đồng thời phụ thuộc vào Node.js / npx khả dụng trên máy tính. Để tương thích với giới hạn độ dài tên công cụ của kênh plugin Claude, định danh nội bộ của plugin dùng xxtlc; tên hiển thị trên giao diện vẫn là XXTLanControl và tên dịch vụ MCP vẫn là XXTLanControl.

Bảng cài đặt MCP​

Trong Cấu hình hệ thống → Cài đặt MCP, có thể trực tiếp ghi hoặc xóa cấu hình cho các Agent thường dùng. Theo mặc định, bản cài đặt mới sẽ ghi địa chỉ Streamable HTTP /mcp của backend hiện tại; cấu hình xxtlancontrol-mcpserver cũ trỏ đến máy chủ điều khiển tập trung hiện tại trên cùng máy sẽ tự động được di chuyển sang cấu hình HTTP, còn cấu hình cũ trỏ đến máy chủ điều khiển tập trung khác sẽ không bị thay đổi. Các đích cài đặt tích hợp hiện gồm:

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

Chế độ bộ công cụ​

Bảng cài đặt cung cấp hai chế độ bộ công cụ:

  • Phát triển và kiểm thử: phù hợp với cách sử dụng tập trung vào gỡ lỗi và kiểm thử tích hợp
  • Đầy đủ: phù hợp khi muốn Agent trực tiếp sử dụng nhiều chức năng điều khiển tập trung hơn

Các nút cài đặt và mẫu cấu hình hiển thị bên dưới sẽ thay đổi theo chế độ bộ công cụ hiện được chọn tại đây.

Địa chỉ máy chủ điều khiển tập trung đích và mẫu​

  • Theo mặc định, cài đặt MCP sẽ trỏ đến địa chỉ /mcp của XXTLanControl hiện tại.
  • Nếu muốn Agent trên máy tính kết nối với một máy chủ điều khiển tập trung khác, có thể nhập địa chỉ máy chủ đích trong bảng; hệ thống sẽ tự động tạo /mcp?toolProfile=... tương ứng.
  • Chỉ những Agent hiện hỗ trợ MCP HTTP từ xa mới có thể cài đặt bằng một cú nhấp; Agent không hỗ trợ sẽ hiển thị “Tạm thời không hỗ trợ cài đặt bằng một cú nhấp” và hệ thống sẽ không chuyển sang ghi cấu hình xxtlancontrol-mcpserver cũ.
  • Với Agent không xuất hiện trong danh sách đích, có thể sao chép trực tiếp mẫu HTTP JSON / TOML được cung cấp bên dưới bảng.
  • Claude Desktop và Claude Desktop 3p sẽ dùng npx -y mcp-remote@latest trên máy tính làm cầu nối đến địa chỉ /mcp hiện tại, vì vậy máy tính phải có Node.js / npx khả dụng; sau khi ghi cấu hình, phải khởi động lại hoàn toàn Claude Desktop để tải lại MCP.
  • Cấu hình Claude Desktop thường nằm tại ~/Library/Application Support/Claude/claude_desktop_config.json hoặc %APPDATA%\Claude\claude_desktop_config.json; Claude Desktop 3p dùng thư mục riêng: trên macOS là ~/Library/Application Support/Claude-3p/claude_desktop_config.json, còn trên Windows hiện ưu tiên %LOCALAPPDATA%\Claude-3p\claude_desktop_config.json.
  • Khi chẩn đoán kết nối MCP của Claude Desktop, nhật ký chế độ tiêu chuẩn nằm tại ~/Library/Logs/Claude trên macOS và %APPDATA%\Claude\logs trên Windows; nhật ký Claude Desktop 3p nằm tại ~/Library/Logs/Claude-3p trên macOS, còn trên Windows hiện ưu tiên thư mục nhật ký bên dưới %LOCALAPPDATA%\Claude-3p.

Điều kiện sử dụng​

  • Theo mặc định, /mcp của backend không yêu cầu khóa truy cập; chỉ cần Agent truy cập được cổng của máy chủ điều khiển tập trung là có thể kết nối.
  • Nếu sau này không còn cần tích hợp Agent, nên quay lại cùng bảng này và thực hiện gỡ cài đặt trước.