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

Truy cập Bên ngoài (CLI và Clients AI)

Truy cập Bên ngoài cho phép các chương trình dòng lệnh cục bộ và clients AI tương thích MCP quản lý script trong ScriptCat thông qua sctl.

AI client ── stdio MCP ──▶ sctl mcp ── local control API ──▶ sctl serve ── WebSocket ──▶ ScriptCat
CLI ────────────────────────────────────────────────────────▲

sctl serve là một daemon cục bộ riêng biệt phải được khởi động rõ ràng.

Listener mặc định là cục bộ

sctl lắng nghe trên 127.0.0.1 theo mặc định. Chỉ lắng nghe trên giao diện khác khi truyền --listen-address rõ ràng.

1. Cài đặt sctl​

curl -fsSL https://raw.githubusercontent.com/scriptscat/sctl/main/scripts/install.sh | sh

hoặc Windows PowerShell:

irm https://raw.githubusercontent.com/scriptscat/sctl/main/scripts/install.ps1 | iex
sctl version

2. Khởi động daemon và đăng ký​

2.1 Chọn thư mục dữ liệu​

export SCTL_DATA_DIR=/absolute/path/to/sctl-data
sctl serve
sctl status
sctl mcp

2.2 Khởi động daemon​

sctl serve

2.3 Bật và ghép nối trong ScriptCat​

  1. Mở Cài đặt → Công cụ → Truy cập Bên ngoài trong ScriptCat và bật công tắc.

  2. Xác nhận địa chỉ sctl khớp với daemon.

  3. Thực hiện trong terminal khác:

    sctl connect

  4. Nhập mã terminal 8 ký tự.

  5. Xác minh kết nối:

    sctl status
Mã ghép nối chỉ dùng cho terminal

Mã trông giống A1B2-C3D4, hết hạn sau 2 phút và chỉ dùng một lần. Không bao giờ dán vào chat AI, issue, log hoặc cấu hình MCP.

3. Quyền hạn và xác nhận​

Khả năngHành vi mặc định
Liệt kê script và đọc metadataTrả về trực tiếp
Đọc hoặc tìm kiếm source scriptTheo chính sách đọc source
Cài đặt, chỉnh sửa, bật, tắt hoặc xóa scriptTheo chính sách ghi

4. Sử dụng dòng lệnh​

sctl get                         # Liệt kê script
sctl get <uuid>                  # Đọc metadata
sctl get <uuid> -o source        # In source đầy đủ
sctl get <uuid> -o source --lines 20-80
sctl grep <uuid> "fetch("         # Tìm kiếm literal
sctl grep <uuid> "pattern" -E    # Biểu thức chính tắc
sctl install <url|file>
sctl edit <uuid> --replace OLD --with NEW
sctl enable <uuid>
sctl disable <uuid>
sctl delete <uuid>
sctl status

5. Kết nối client AI (MCP)​

{
  "mcpServers": {
    "scriptcat": {
      "command": "/absolute/path/to/sctl",
      "env": {
        "SCTL_DATA_DIR": "/absolute/path/to/sctl-data"
      },
      "args": ["mcp", "--name", "my-ai-client"]
    }
  }
}

Công cụ hiện tại:

Công cụMục đíchChính sách xác nhận
scripts_listTóm tắt scriptKhông có
scripts_metadata_getĐọc metadata một scriptKhông có
scripts_source_getĐọc source theo UUIDChính sách đọc source
scripts_source_grepTìm kiếm trong sourceChính sách đọc source
scripts_install_requestYêu cầu cài đặtChính sách ghi
scripts_edit_requestYêu cầu chỉnh sửaChính sách ghi
scripts_toggle_requestYêu cầu bật/tắtChính sách ghi
scripts_delete_requestYêu cầu xóaChính sách ghi

6. Kiểm toán và thu hồi​

  • sctl status hiển thị phiên bản daemon, kết nối và sự kiện bảo mật gần đây.
  • "Dừng Truy cập Bên ngoài" ngắt kết nối, xóa trạng thái ghép nối và xóa quyền phiên.

7. Khắc phục sự cố​

Daemon không thể truy cập — Chạy sctl serve trước.

Xác thực kênh điều khiển thất bại — Xác nhận rằng serve, lệnh CLI và quy trình MCP giải nén cùng thư mục dữ liệu tuyệt đối.

Trạng thái nói "Kết nối thất bại" — Xác nhận daemon đang chạy và địa chỉ khớp.

Một lệnh không trả về — Kiểm tra trình duyệt để xem trang xác nhận ghi hoặc tiết lộ source.

Tìm nhật ký — Nhật ký nằm trong <data-dir>/logs/.

Nền tảngThư mục nhật ký
macOS~/Library/Application Support/sctl/logs/
Windows%LOCALAPPDATA%\sctl\logs\
Linux~/.config/sctl/logs/