关于 AgentGIF
面向开发者的 GIF 托管平台,采用双层架构: GIF 供人类查看,Cast 供代理解析.
什么是 AgentGIF?
AgentGIF 是专为终端演示 GIF 而构建的托管平台。上传到 AgentGIF 的每个 GIF 都包含两层:
- 视觉层 — 一张可在 GitHub README、文档网站和博客文章中内嵌播放的 GIF 动图,无需 JavaScript 播放器。
- 机器层 — 一个 asciinema v2 cast 文件,并附有纯文本转录,使 AI 代理可以读取命令、理解输出并引用具体步骤。
这种双层方式意味着一个 URL 同时服务两类受众:人类看到动态终端演示,AI 代理则获得可解析和推理的结构化数据。
为什么选择 AgentGIF?
终端演示 GIF 在开源文档中随处可见,但它们存在两个根本问题:
- GIF 图像对 AI 不透明 — 当 AI 代理在 README 中遇到 GIF 时,它只能看到二进制像素数据,无法提取命令、读取输出或解释步骤。AgentGIF 通过为每个 GIF 附加机器可读的 cast 文件和转录来解决这一问题。
- 缺乏专用托管 — 开发者将终端 GIF 上传到通用图片托管服务(如 Imgur、GitHub assets),这些服务会删除元数据、过度压缩,且不提供搜索或整理功能。AgentGIF 提供专用托管,支持标签、合集、终端主题、全文搜索和 REST API。
平台功能
| 功能 | 详情 |
|---|---|
| GIF 库 | 768+ 个公开终端 GIF,涵盖 911+ 个标签 |
| 终端主题 | 44 种 VHS 主题(Catppuccin、Dracula、Tokyo Night、Nord、Solarized 等) |
| 嵌入格式 | Markdown、HTML、iframe、Script 小部件、oEmbed、SVG Badge |
| CLI 工具 | Python、Node.js、Go、Rust、Ruby — 在终端中上传、录制、搜索 |
| REST API | 30+ 个端点,无需认证即可免费读取,提供 OpenAPI 3.1 规范 |
| 全文搜索 | 按标题、命令、标签和转录内容搜索 |
| 合集 | Curated groups of related GIFs (e.g., "Unix Essentials", "Git Workflows") |
| 徽章服务 | 适用于 PyPI、npm、crates.io 和 GitHub 的终端主题包徽章 |
| AI Tape 生成器 | 根据自然语言描述生成 VHS tape 文件 |
| .md 端点 | 在任意 URL 后附加 .md,获取针对 LLM 优化的 Markdown 输出 |
| 国际化 | 支持 15 种语言,附机器翻译元数据 |
为 AI 代理而生
AgentGIF 从底层设计上就面向 AI 代理使用。网站每个页面都有一个 .md 端点,返回整洁的 Markdown 内容。平台提供多种发现渠道:
| 渠道 | URL | 用途 |
|---|---|---|
| llms.txt | /llms.txt | 面向 AI 爬虫的网站结构摘要 |
| OpenAPI | /api/openapi.json | 完整 API 架构(OpenAPI 3.1) |
| RSS/Atom | /feed/ | 最新 GIF(供订阅阅读器使用) |
| 网站地图 | /sitemap.xml | 所有已索引的 URL |
| 搜索 API | /api/v1/search/?q=... | 程序化全文搜索 |
开源生态系统
AgentGIF 在 5 个包注册表中提供 CLI 工具和集成:
| 平台 | 包 | 安装 |
|---|---|---|
| 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 |
技术栈
| 层 | 技术栈 |
|---|---|
| 后端 | Django 6.0, Python 3.14, PostgreSQL |
| 前端 | Tailwind CSS, Alpine.js, xterm.js (终端回放) |
| CDN | Cloudflare R2 (双存储桶:静态资源 + 上传文件) |
| 搜索 | PostgreSQL 全文搜索,支持权重排名 |
| 录制 | Charm 出品的 VHS(44 种终端主题) |
| Cast 格式 | asciinema v2(JSON 头部 + 带时间戳的事件) |
联系我们
安全问题请参阅 security.txt。API 问题请查阅 API 参考文档。其他事宜请联系 [email protected]。