rasanai：AI Agent 工具实践指南

如果把rasanai放进候选清单，不能只看热度；它的定位是AI 克劳德·代码 (Claude Code) 的视频导演：选择三部完整影片中的一部，克劳德对其进行设计、动画和渲染，从您的镜头、动态图形中推出影片、讲解员、卷轴。从视频制作的使用方式看，素材、节奏、编码和最终画面容易不一致是采用前必须回答的问题。短测时我会拿一组已有素材完成一段短样片，并保留素材路径、渲染结果、音画同步和导出格式的结果，方便团队复盘。编辑判断上，有真实素材并需要稳定视频产出的创作者可以优先研究它；其他团队不必为了热门标签勉强接入。

选择电影。 Claude 成功了。 rasanai 是 Claude Code 的 AI 视频导演，基于 HyperFrames 构建：启动影片、解说、PR 视频、品牌影片、音乐视频、从您自己的素材文件夹中剪切的卷轴、带字幕的头像和短片。

Rasa（Rasa）是观众感受的作品；rasanai（RaceNai）是泰米尔语，爱思性敏感）当时每30个人制作AI视频，就会得到30个内容不同、电影相同部分的视频：明显的故事、默认的出场、一下子在灯光下放松、45秒的电影下30秒、声音和音乐的循环每个剪辑上都有发光文字。 rasanai是一种中文代码技术，它使用一个决策来替换所有默认值，并基于它构建一个检查。

网址： https://sibhimanyu.github.io/rasanai/

五次通话，每次都能看到您的电影

你说/rasanai make a 45s launch film for tally.app。 导演控制台会在您的浏览器中打开：一个黑暗的审查室，实时显示克劳德正在做的事情，并且只会让您停下来五次。故事和外观是分开的：首先根据文字和时间来判断剧本，然后选择外观以使故事变得最有力。

克劳德决定工艺，就像高级动作设计师一样，根据量化的剧本：故事装置、场景及其时间安排、动作语言、过渡、音乐编辑、每种音效、灯光和等级。每个电话都在 决策 抽屉中，并附有其原因，您可以通过告诉 Claude (⌘K) 来更改其中任何一个。

是什么让电影与众不同

• 一个故事，而不是故事。 在任何概念之前，Claude 会根据您的产品写下一份事实表（真正改变的是什么，为谁而改变，用产品自己的文字和数字）。一份由精彩的首发影片和广告中的 66 种叙事手段组成的目录（博物馆标签、倒计时、一次拍摄、物体的视角……）给出了至少在五个轴上不同的三种推介，并且一个标题拒绝了默认的弧线（挂钩、问题、“引入 X”、三个功能、号召性用语）以及适用于任何产品的任何推介。
• 403 个设计系统。 20 个系列的命名动态图形风格库：编辑、大胆、柔和、俏皮、立体、奢华、复古、未来、数据、电影、产品、遗产（包豪斯、建构主义、波兰海报学派……）、广播、科学、印刷、界面、自然和材料、音乐场景、地点和寻路。每个都是一堆分类术语、控制台根据您的话实时绘制的配方、动议合同以及完整的 DESIGN.md，您可以下载并用于其他任何用途。
• 根据图片编辑音乐。 音轨足够长，适合电影，只用 Node 和 FFmpeg（节拍、小节、段落、真正的结局）进行分析，剪切小节线，这样它就不会循环播放，并以强拍显示和徽标。声音效果只针对您可以看到的事情发生，但预算有限。混合至−14 LUFS。
• 防倾斜门。 在任何内容到达您之前，slop.mjs 检查副本（“无缝”、“解锁”、“不是 X，是 Y”、破折号）、外观（霓虹灯发光文本、紫蓝色渐变、粒子填充物、角落时间码、Inter 无处不在）、运动（空闲循环、所有内容以相同方式进入）、时间（不可读的文本、统一的镜头长度、无结束保持）和声音（循环床、每次切割时的嗖嗖声、响度、死气沉沉）。
• 运动合同。所选样式的运动语言变为 motion.md，并且 obey.mjs 加载无头 Chrome 中的每个构建场景并检查每个补间。
• 克劳德制作动画。 样式样本存在，因此您可以通过眼睛进行选择。 Claude 通过匹配的 HyperFrames 工作流程（product-launch-video、faceless-explainer、pr-to-video、general-video、 music-to-video、talking-head-recut、embedded-captions、motion-graphics）。

素材卷轴添加素材（每个剪辑都带有联系表和单词级转录）和剪切（作为可编辑列表进行编辑：带有入点和出点的剪辑、它们之间的卡片、覆盖、标题）。克劳德亲自起草剪裁并设计每张卡片。

带上你的 DESIGN.md。 rasanai 读取常见形状（design.md 规范 frontmatter 与 oklch 颜色、无可挑剔、gstack、Stitch 风格的散文、CSS 自定义属性、标记表），为每种颜色分配一个角色，将平台字体映射到已发布的等效项并绘制所有三部电影在您的品牌中。 示例。

安装

要求：克劳德代码，Node.js≥20（如果没有，rasanai在第一次运行时找到或获取私人副本），HyperFrames技能（npx hyperframes skills update），和 FFmpeg 用于素材卷轴。用于预览和检查的 Chrome 来自 npx hyperframes browser ensure。语音样本和音乐使用HyperFrames的媒体工具（heygen CLI，已登录）；如果没有它们，将使用工作流程的默认语音，您可以带自己的曲目或不带曲目。

克劳德代码插件（推荐）

/plugin marketplace add Sibhimanyu/rasanai
/plugin install rasanai@rasanai

技能CLI

npx skills add Sibhimanyu/rasanai --skill rasanai

单行安装程序（将 ~/.claude/skills/rasanai 链接到 ~/.rasanai/src 中的签出；再次运行以更新，--uninstall 以删除）

curl -fsSL https://raw.githubusercontent.com/Sibhimanyu/rasanai/master/install.sh | bash

手工

git clone https://github.com/Sibhimanyu/rasanai.git
ln -s "$PWD/rasanai/skills/rasanai" ~/.claude/skills/rasanai

来自 Rasa 导演

rasanai 在 1.0 之前被称为 Rasa Director。您无需执行任何操作：下次加载时，它会按照您安装 Rasa Director 的方式安装 rasanai，将您的历史记录移至 ~/.rasanai 并移交。从此使用/rasanai（使用该插件，重新启动一次Claude Code即可看到）。

更新中

从 0.6.1 开始，rasanai 会自我更新：每次加载技能时，它都会检查是否有新版本（最多 2 秒，静默离线），按照您安装 rasanai 的方式进行安装，并在同一运行中继续使用新版本，一行告诉您有哪些新内容。设置 RASANAI_AUTO_UPDATE=0 来代替被告知，或 RASANAI_NO_UPDATE_CHECK=1 关闭检查。 git checkout 仅在 master 上更新自身。手工：

或者运行 node <skill dir>/scripts/update.mjs apply，它会找出其中哪一个适用。 0.6.1之前的版本不会自行更新（0.4.2–0.6.0只告诉你）；手动更新一次，从那时起它们就保持最新状态。

检查安装：node ~/.claude/skills/rasanai/scripts/selftest.mjs（85 个检查，几分钟，无需网络）。安装插件后，技能位于 ~/.claude/plugins/cache/rasanai/ 下；从那里运行相同的脚本。

使用插件安装 Claude Code 命名空间的技能：将其调用为 /rasanai:rasanai （或者只是描述您想要的视频；它会在视频请求时触发）。

使用

/rasanai make a 45s launch film for https://tally.app
/rasanai a 60s explainer on how DNS works, vertical, no voiceover. Just make it.
/rasanai turn PR #482 into a 30s changelog video
/rasanai a lyric video for song.mp3, you decide the rest
/rasanai cut ~/Footage/lisbon-trip into a 30s reel: best moments, a title card, captions
/rasanai add bold captions to interview.mp4 for Reels
/rasanai a 6s title sting for "Ship it in an afternoon", neo-brutalist, springy
/rasanai a product film for our app using our DESIGN.md, like these references: ref1.png ref2.png
/rasanai revise videos/tally-launch: calmer motion, swap the music
/rasanai export the Swiss grid style as a DESIGN.md

它是如何运作的

skills/rasanai/
  SKILL.md                    the flow the agent follows: Brief · Story · Look · Animatic · Final
  console/index.html          the Director's Console; console/presets.js draws any style live
  taxonomy/                   the vocabulary: 32 dimensions (dimensions/*.json), 66 story devices (devices.json),
                              403 styles in 20 families (presets/*.json), type pairings; schemas
  scripts/
    story.mjs                 truth sheet, three distinct story devices, the pitch rubric
    presets.mjs               the style library: validate, list, suggest, gallery, pick, stills, site
    design-system.mjs         any style as a complete DESIGN.md (export, export-all)
    sound.mjs, music.mjs      track analysis (beats, bars, sections, endings), the edit to picture, SFX plan,
                              mix check; music candidates long enough for the film
    slop.mjs                  the anti-slop gate: copy, look, motion, timing, sound, the rendered video
    obey.mjs                  checks built compositions obey motion.md; waive
    console.mjs               the console server + push / wait / ask / reply / activity / resolve / record
    taxonomy.mjs, direction.mjs, design.mjs, brand.mjs, motion-md.mjs, scenes.mjs, voice.mjs,
    reel.mjs, video.mjs, handoff.mjs, tasting.mjs, transition-menu.mjs, board.mjs, pick.mjs,
    memory.mjs, update.mjs, setup.sh, selftest.mjs
    lib/                      audio analysis, the DESIGN.md adapter, looks, direction, fonts, engine, common
    vendor/gsap.min.js        GSAP 3.14.2
  references/                 craft (the playbook), vocabulary (film terms → code), script (the writer's brief), story, sound, direction,
                              brand, video, reel, console, motion.md contract, board, handoff, personalities

• 术语就是数据。每种风格、故事装置和决定都是一个分类条目，对构建者的提示都是从中编译出来的，references/vocabulary.md 将每个胶片术语（机架焦点、漂白旁路等级、J 型切割）转换为带有数字的 HTML/CSS/GSAP 配方。
• 检查器 (obey.mjs) 使用 GSAP 在无头 Chrome 中加载每个合成，在每个补间中行走，对其真实的开始值和结束值进行采样，并标记超出范围的持续时间、设置之外的缓动、隐式默认缓动、禁止模式（所有形式的淡出幻灯片、反弹、过冲、模糊、缩放弹出……），非 GSAP 运动和短暂保持。 “无法运行”永远不会被报告为干净。
• 仅限本地。 控制台绑定到 127.0.0.1，拒绝外部主机标头，并且每个路由都需要每个会话令牌（然后是 HttpOnly cookie）；它仅提供来自您的工作区和已安装技能的文件，而不是其自己的令牌文件，并且拒绝以您的主目录作为根目录运行。语音样本、音乐和现场采集均通过HyperFrames自己的工具进行；没有其他东西离开你的机器。

详情：SKILL.md · 工艺 · 词汇 · 故事 · 声音 · 样式 · 方向和分类 · DESIGN.md · 整个视频 · 素材卷轴 · 控制台 · motion.md 合约 · 关键帧板 · 交接 · 个性 · 设计文档

已知限制

• 风格样本是从标记和文本中提取的预览；真实的框架（产品照片、徽标、数据、插图）由克劳德在构建时作为关键帧设计。
• DESIGN.md适配器读取常见格式，但品牌文档差异很大；它会报告找不到的内容（字体、口音），而品牌板会在构建任何内容之前显示它所理解的内容。
• 镜头卷轴在 Whisper 转录本的单词边界和检测到的镜头变化上进行剪切；除了克劳德从联系表和文字记录中阅读的内容之外，没有自动的最佳镜头或视觉内容排名。卡片和覆盖层至少运行其运动的最小长度（进入、所需保持、退出）；较短的请求会被延长并带有警告。
• 预览使用 Google 字体；离线时，它们会回退到系统字体。
• 检查器验证 GSAP 运动（motion.md 需要 GSAP 构建）。
• 每个工作流程（计划文件、数据包注入、音乐锁）的交接均在真实项目中进行了测试；尚未针对每条路线运行通过每个工作流程的完整渲染影片。