Scripts API

Scripts API cung cấp lưu trữ cố định cho script tái sử dụng. Script được đặt tên và đánh phiên bản trong một mind, có thể lấy dưới dạng văn bản thuần — hoàn hảo cho mẫu curl | bash.

Các endpoint

POST /script

Lưu hoặc cập nhật một script.

curl -X POST https://synapse.schaefer.zone/script \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "deploy-synapse",
    "content": "#!/bin/bash\nset -euo pipefail\ngit pull\nnpm ci\nnpm run build\ndocker compose up -d",
    "description": "Deploy Synapse to production",
    "language": "bash"
  }'

GET /script/:name

Lấy nội dung script dưới dạng text/plain. Hoàn hảo để pipe vào bash.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse | bash

GET /script/:name/info

Lấy metadata script mà không có nội dung.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse/info

Phản hồi:

{
  "name": "deploy-synapse",
  "description": "Deploy Synapse to production",
  "language": "bash",
  "size_bytes": 142,
  "created_at": "2026-06-27T...",
  "updated_at": "2026-06-27T..."
}

GET /scripts

Liệt kê tất cả script trong mind hiện tại.

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/scripts

DELETE /script/:name

Xóa một script.

curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/script/deploy-synapse

Trường hợp sử dụng phổ biến

Script triển khai

Lưu quy trình triển khai chuẩn để LLM có thể chạy mà không cần suy luận lại các bước mỗi lần:

# LLM stores this once
curl -X POST .../script -d '{
  "name": "deploy-vps1",
  "content": "#!/bin/bash\nssh vps1 \"cd /opt/synapse && git pull && docker compose up -d --build\"",
  "language": "bash"
}'

# Later sessions just run it
curl -H "Authorization: ..." .../script/deploy-vps1 | bash

Đoạn mã khắc phục sự cố

Lưu các lệnh chẩn đoán cho các vấn đề phổ biến:

curl -X POST .../script -d '{
  "name": "check-docker",
  "content": "#!/bin/bash\ndocker ps\ndocker stats --no-stream\ndocker system df",
  "description": "Quick Docker health check",
  "language": "bash"
}'

Trình tạo cấu hình

Lưu các script tạo cấu hình:

curl -X POST .../script -d '{
  "name": "gen-nginx-conf",
  "content": "#!/usr/bin/env python3\nimport sys\n# ... generate nginx config from template ...",
  "language": "python"
}'

Bước tiếp theo

• Variables API
• Cron & Scheduler