Giới thiệu về AgentGIF
Lưu trữ GIF cho nhà phát triển với kiến trúc hai lớp: GIF cho con người, Cast cho tác nhân.
AgentGIF là gì?
AgentGIF là nền tảng lưu trữ được xây dựng đặc biệt cho các GIF demo terminal. Mỗi GIF được tải lên AgentGIF đều có hai lớp:
- Lớp hình ảnh — một hình ảnh GIF động phát trực tiếp trong README của GitHub, các trang tài liệu và bài đăng blog. Không cần trình phát JavaScript.
- Lớp máy — một tệp cast asciinema v2 được ghép với bản ghi chép văn bản thuần, để các tác nhân AI có thể đọc các lệnh, hiểu đầu ra và tham chiếu các bước cụ thể.
Cách tiếp cận hai lớp này có nghĩa là một URL duy nhất phục vụ cả hai đối tượng: con người nhìn thấy bản demo terminal hoạt hình, trong khi tác nhân AI nhận được dữ liệu có cấu trúc mà nó có thể phân tích và suy luận.
Tại sao chọn AgentGIF?
GIF demo terminal xuất hiện ở khắp nơi trong tài liệu mã nguồn mở. Nhưng chúng có hai vấn đề cơ bản:
- Hình ảnh GIF không trong suốt với AI — khi một tác nhân AI gặp GIF trong README, nó chỉ thấy dữ liệu pixel nhị phân. Nó không thể trích xuất các lệnh, đọc đầu ra hay giải thích các bước. AgentGIF giải quyết vấn đề này bằng cách đính kèm tệp cast và bản ghi chép có thể đọc bằng máy vào mỗi GIF.
- Không có lưu trữ chuyên dụng — các nhà phát triển tải GIF terminal lên các dịch vụ lưu trữ hình ảnh thông thường (Imgur, GitHub assets) vốn xóa metadata, nén mạnh tay và không có tính năng tìm kiếm hay tổ chức. AgentGIF cung cấp dịch vụ lưu trữ chuyên dụng với gắn thẻ, bộ sưu tập, theme terminal, tìm kiếm toàn văn và REST API.
Tính năng nền tảng
| Tính năng | Chi tiết |
|---|---|
| Thư viện GIF | 768+ GIF terminal công khai trên 911+ thẻ |
| Theme Terminal | 44 theme VHS (Catppuccin, Dracula, Tokyo Night, Nord, Solarized và nhiều theme khác) |
| Định dạng nhúng | Markdown, HTML, iframe, Script widget, oEmbed, SVG Badge |
| Công cụ CLI | Python, Node.js, Go, Rust, Ruby — tải lên, ghi hình, tìm kiếm từ terminal |
| REST API | 30+ endpoint, đọc miễn phí không cần xác thực, đặc tả OpenAPI 3.1 |
| Tìm kiếm toàn văn | Tìm kiếm theo tiêu đề, lệnh, thẻ và nội dung bản ghi chép |
| Bộ sưu tập | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| Dịch vụ Badge | Badge gói theo theme terminal cho PyPI, npm, crates.io và GitHub |
| Trình tạo VHS Tape bằng AI | Tạo tệp VHS tape từ mô tả ngôn ngữ tự nhiên |
| Endpoint .md | Thêm .md vào bất kỳ URL nào để nhận đầu ra Markdown tối ưu cho LLM |
| i18n | 15 ngôn ngữ với metadata được dịch tự động |
Xây dựng cho Tác nhân AI
AgentGIF được thiết kế từ đầu cho tác nhân AI sử dụng. Mỗi trang trên trang web đều có endpoint .md trả về Markdown sạch. Nền tảng cung cấp nhiều kênh khám phá:
| Kênh | URL | Mục đích |
|---|---|---|
| llms.txt | /llms.txt | Tóm tắt cấu trúc trang web cho trình thu thập AI |
| OpenAPI | /api/openapi.json | Schema API đầy đủ (OpenAPI 3.1) |
| RSS/Atom | /feed/ | GIF mới nhất cho trình đọc feed |
| Sitemap | /sitemap.xml | Tất cả URL được lập chỉ mục |
| API Tìm kiếm | /api/v1/search/?q=... | Tìm kiếm toàn văn theo chương trình |
Hệ sinh thái mã nguồn mở
AgentGIF cung cấp công cụ CLI và tích hợp trên 5 registry gói:
| Nền tảng | Gói | Cài đặt |
|---|---|---|
| PyPI | agentgif | pip install agentgif |
| npm | @agentgif/cli | npm install -g @agentgif/cli |
| Go | github.com/agentgif/cli | go install github.com/agentgif/cli@latest |
| Crates.io | agentgif | cargo install agentgif |
| RubyGems | agentgif | gem install agentgif |
Công nghệ
| Lớp | Stack |
|---|---|
| Backend | Django 6.0, Python 3.14, PostgreSQL |
| Frontend | Tailwind CSS, Alpine.js, xterm.js (phát lại terminal) |
| CDN | Cloudflare R2 (bucket kép: static + uploads) |
| Tìm kiếm | Tìm kiếm toàn văn PostgreSQL với xếp hạng có trọng số |
| Ghi hình | VHS by Charm (44 theme terminal) |
| Định dạng Cast | asciinema v2 (header JSON + sự kiện có dấu thời gian) |
Liên hệ
Về vấn đề bảo mật, xem security.txt. Về câu hỏi API, xem tài liệu API. Về mọi vấn đề khác, liên hệ tại [email protected].