OGRAF HTML 动画OGRAF HTML 动画

使用AI 开发与发布 OGRAF 动画

支持任意 AI Agent 开发 ograf 动画,比如 Codex、Claude Code、WorkBuddy、Qoder 等

ograf.json 规范下载 Skill查看 Skill 仓库
01

在 AI Agent 中安装 ograf-creator-skill

选择你使用的 AI Agent,打开用于动画创作的本地工作目录。下面提供 Codex 和 WorkBuddy 两个安装示例,复制对应指令发送即可。

Codex

在 Codex 对话中发送以下指令,使用 skill-installer 从 GitHub 安装。

发送给 Codex
$skill-installer 安装 https://github.com/minghe36/ograf-creator-skill

安装完成后,直接说“使用 ograf-creator-skill 创建动画”。如果技能未出现,重启 Codex 后再检查。

Codex 官方文档

WorkBuddy

在 WorkBuddy 中选择本地工作目录,新建任务并发送以下指令。

发送给 WorkBuddy
请安装 Skill:https://github.com/minghe36/ograf-creator-skill

安装完成后,在任务中说“使用 ograf-creator-skill 创建动画”,让 WorkBuddy 确认已读取对应 SKILL.md。

WorkBuddy 官方文档

GitHub 无法访问?

让 AI Agent 从 CDN 下载 ZIP,解压后安装 Skill。Codex 和 WorkBuddy 都可以使用下面的指令。

发送给 AI Agent
请从 https://cdn.haoai.pro/assets/ograf-creator-skill.zip 下载并解压,然后安装 ograf-creator-skill。

如果已下载到本地,可将 ograf-creator-skill 目录路径提供给 AI Agent,请它完成安装。登录与上传需要使用包含 scripts/ograf_auth.py 的完整版本。

02

创建第一个动画

在 Codex 中打开用于存放动画的本地文件夹。描述名称、用途、视觉与动效,并明确横屏和竖屏支持;可以同时附上参考图片。创建、预览和校验都在本地完成,不需要登录 ograf.app。

发送给 Codex
使用 ograf-creator-skill 创建一个简单的标题动画:文字“你好,OGRAF”居中,白色文字、透明背景,缓慢淡入后停留,总时长 3 秒。支持 1920×1080 横屏,可修改标题、颜色和字号。

创建后打开本地预览,先不上传。
  • Codex 会在工作目录中创建组件文件。名称、描述与横竖屏支持应与你的需求一致。
  • 先看实际预览,再检查可编辑参数是否能即时改变画面。
03

用 AI 迭代开发动画

在同一个 Codex 对话中继续提出修改。说清楚改哪个元素、目标效果和需要保留的内容;参考图、颜色值与时长都可以直接提供。

发送给 Codex
把刚才的标题改成“我的第一个动画”,文字颜色改为紫色,淡入时间改为 1 秒。修改后重新预览。
  • 一次集中修改一组问题,更容易判断效果。需要时让 Codex提供截图或打开本地预览。
  • 参数、动效和画面都确认后,再让 Codex校验并打包。预览通过不等于已经发布。
04

登录 ograf.app

创建和迭代都只在本地进行,不需要账号。只有上传或发布作品时才需要 ograf.app 账号:在 Codex 中发送下面的指令,按打开的浏览器页面完成 HaoAI 登录。Codex 的登录与 ograf.app 的登录是两件事。

发送给 Codex
使用 OGRAF Creator Skill 登录 ograf.app。请运行 Skill 中的 scripts/ograf_auth.py login,打开登录页面,并在完成后检查登录状态。
  • 浏览器登录完成后,返回 Codex,确认登录成功。Skill 会将上传凭据保存在本地,后续上传、同步和修改都可以复用。
  • 如果需要确认当前账号是否已登录,让 Codex 运行 scripts/ograf_auth.py status;凭据失效或上传返回 401 时重新登录即可。
05

打包并发布到社区

确认动画满意后,在 Codex 中明确要求上传并发布。上传会先创建工作区草稿;还需要完成社区发布,作品才会出现在公开页面。

发送给 Codex
预览已确认。请使用 OGRAF Creator Skill 校验并打包当前动画,然后上传到我的 ograf.app 工作区并发布到社区。

保留已确认的名称、描述、可编辑参数和横竖屏支持。检查上传及发布的返回结果,完成后给我公开作品链接;如果只上传成草稿,请说明尚未发布,并继续完成发布。
  • 上传限制:压缩包不超过 500 KB,JS 单文件不超过 500 KB,图片单文件不超过 1 MB,最多 200 个文件,解压总量不超过 2 MB。禁止视频;请使用包内资源,脚本扫描会拒绝动态执行代码、敏感 API 和外部资源。
  • 首次上传按提示登录;已登录时复用本地凭据。若上传失败,保留本地组件和文件包,修复后重试。
  • 打开返回的公开链接,核对预览、标题、配置和下载。之后修改作品时,请让 Codex更新已有作品,避免重复创建。