开始设置
用户首次打开实验室。他们不熟悉技术。最终,他们将完成所有安装,在自拍样片上选择喜欢的样式,并保存专属套件。然后,他们就可以开始制作第一个Reels视频了。
语气:亲切、简洁、循序渐进。在等待时告知进度。绝不粘贴原始工具输出。除了第一步中缺失Homebrew时的一条命令外,绝不要求用户运行任何命令。
从一句简短的消息开始:
欢迎来到 Reels 编辑实验室。设置大约需要10分钟:我会安装一些必要组件,问你3个简短问题,然后你可以在自己的视频上看到不同风格的效果并做出选择。我们开始吧。
1. 安装(约5分钟,主要是语音模型下载)
运行 python3 tools/doctor.py。它会打印一个检查清单和 DOCTOR=ok 或 DOCTOR=missing:<names>。按此顺序修复缺失项,最后重新运行医生脚本:
- mac / space: 如果两者之一失败,请友好地解释(需要Apple芯片的Mac;约6GB可用空间)。
- homebrew: 你无法替他们安装,因为需要在真实的终端中输入Mac密码。用一行话解释原因,然后给出医生修复建议中的准确命令,告诉他们打开 Terminal 应用(Cmd+Space,输入Terminal),粘贴命令,按回车,输入Mac密码(输入时不会显示任何字符,这是正常的)并按照提示操作。最后Homebrew会输出两行以
echo和eval开头的“下一步”步骤;请他们也粘贴这些命令。等待他们确认完成后,重新检查。 - apple-tools: 运行
xcode-select --install。会弹出一个Mac窗口;告诉他们点击 Install 并告知完成(需要几分钟)。通常Homebrew会事先安装好这些,所以先检查一下。 - ffmpeg:
brew install ffmpeg(如果brew还不在PATH中,则使用/opt/homebrew/bin/brew)。 - uv:
curl -LsSf https://astral.sh/uv/install.sh | sh,然后如果uv未找到,使用~/.local/bin/uv。 - python-tools:
uv sync - renderer:
uv run playwright install chromium - speech-model: 在后台运行
uv run tools/get_models.py(2.3 GB)。如果连接中断,它会自动恢复。启动后,继续进行访谈。在步骤3需要使用前,再回来检查。
在安装过程中,用一句话告诉他们每个组件的用途(医生脚本的描述就是为此设计的)。
2. 品牌访谈(3个问题,逐一提问)
以对话方式提问,每次一个消息。保留他们的确切措辞。
不要询问名称、标语或“你是做什么的”标签:实验室默认不会添加这些(请参见new-reel技能中的“标签”)。
- 能量。 “你在镜头前感觉如何:安静内敛、温暖亲切,还是高能活跃?” 这将决定剪辑的活跃程度(参见步骤4中的表格)。
- 品牌。 “你有品牌或设计文件、品牌色或字体吗?将你的设计文件(.md或PDF)拖到这里,我会从中构建你的风格。或者粘贴颜色代码,或者将3–6张你喜欢的Reels样式截图放入
inspiration文件夹。或者直接说'不,给我看看选项'。” - 禁忌。 “你的Reels中绝对不想要什么?例如全大写文本、某些表情符号、音效、你永远不会说的词。”
将答案保存到 brand/profile.md:
# 个人资料
- 能量:温暖亲切
- 品牌:颜色 #… / 字体 … / 截图在 inspiration/ / 无
- 禁忌:…
另外,将每个“禁忌”作为一条规则添加到 brand/preferences.md。
3. 在用户视频上查看样式
询问:“现在拖入一段你对着镜头说话的片段,最好20秒或更长。将它拖到这个聊天中或 inbox 文件夹。不一定非要拍得好;它只是用来预览样式的。”
当片段传入(且语音模型已完成下载)后:
-
uv run tools/transcribe.py "<片段>" --name welcome-sample -
读取
projects/welcome-sample/lines.md。使用 前3–5条清晰的台词,大约12–20秒 编写cut.json,遵循new-reel粗剪规则(最后一条干净的台词,无错误开头)。运行uv run tools/roughcut.py projects/welcome-sample --no-open和uv run tools/verify.py projects/welcome-sample,并修复其标记的任何问题。不要让他们审阅这个粗剪版本;它只是样本。 -
像new-reel技能一样编写
build.json:使用hooks技能根据他们的实际讲话内容编写一个钩子(这是他们对实验室的第一印象,所以要做好),1–2个突出词,1个缩放,以及一句对最强台词的陈述。使用visuals技能添加2–4个弹出提示(例如,如果他们提到一个列表,则添加标签;如果他们谈论提示词,则添加聊天窗口),让他们看到实验室的真实能力。不要添加背景时刻。 -
样式表:
uv run tools/build.py projects/welcome-sample --looks presets。它会打开一张图片,他们的片段以所有样式并排显示,顺序和LOOKS=之后打印的一致。自己先查看图片(读取它)并检查文字是否清晰可读以及是否遮挡面部。 -
按照打印的顺序,每个样式用一句简短的话介绍,使用每个套件的
description(packs/<名称>/kit.json)。顶部行显示钩子和字幕;底部行显示弹出提示。 然后明确说明 一个样式是起点,而非最终选择:选择你最喜欢其感觉的那个。之后一切都可以更改:“就这个,但要鼠尾草色和奶油色”、“用我的颜色:#…”、“柔和点的字体”、“不要粉色”。我会在你的片段上重做,以便你看到效果。
询问他们想看哪个 动态效果。
-
对于他们选择的每个样式:
uv run tools/build.py projects/welcome-sample --kit <名称> --out sample-<名称>。它会在QuickTime中打开。如果他们选了2个,则都构建并依次打开。
如果他们在步骤2中提供了品牌色、字体或截图,也要提供:“或者我可以从你的品牌中创建一个样式。” 参见步骤5。
4. 保存他们的套件
当他们选择后(例如“Editorial,但用鼠尾草色和奶油色”或“Playful,但更平静”):
-
将
packs/<预设>/kit.json复制到packs/<他们的小写名字>/kit.json。在副本中:"name": 他们的名字"preset": false"based_on": "<预设>"
-
应用他们的能量:
能量 intensity zoom jump / punch sfx volume_db statements 冷静内敛 clean 1.04 / 1.08 −17 最多1个 温暖亲切 signature 1.07 / 1.13 −13 最多1–2个 高能活跃 full 1.12 / 1.22 −10 最多2个 相应地更改
rules.intensity、zoom、sfx.volume_db和rules.statement的措辞。音效集 (
sfx.palette):- 冷静:
soft - 温暖:
soft或playful - 高能:
punchy - 科技或AI话题:考虑
clicky
提醒一次,他们可以在
sfx/sound-menu.mp4中听到所有声音,并通过提问(“使用俏皮的声音”)切换音效集。如果他们说“不要音效”,则设置"sfx": {}。如果他们说不要全大写,则设置style.caption_case、style.hook_case和style.statement_case为"none"。 - 冷静:
-
应用他们的颜色,无论是来自访谈还是他们当场要求(“改用这些颜色”):
- 从十六进制代码或普通名称: “sage”或“dusty pink”都可以;选择品味得当的十六进制代码并告知他们。
- 交换
colors中的值并保持角色:浅色用于卡片和字幕,深色用于陈述背景和墨水色,亮色用于高亮和visuals.rotate。 - 检查对比度: 文字在其背景上必须可读。
- 为其套件重新渲染样式表 (
--looks <他们的套件>),以便他们在制作完整样本前看到效果。 - 字体同理: 任何免费的Google字体(
fonts.py确认其存在)。
-
将套件的文件夹名称写入
brand/kit.txt。 -
使用其套件再次构建样本:
uv run tools/build.py projects/welcome-sample --out sample-mine。它会在QuickTime中打开。询问:“这是你的样式。想更改什么吗?” 将更改应用到他们的套件(而非预设)并重新构建,直到他们满意为止。像“字幕小一点”、“少点黄色”或“不要倾斜”这样的小改动在kit.json中都是一行编辑。
5. 根据品牌创建样式(当被要求时)
从设计文件(最佳方式)
如果他们有品牌或设计文档(.md、PDF或Google Doc导出文件,例如 BRAND-DESIGN.md):
-
获取文件。 要求他们将文件拖入聊天或放入
brand/文件夹,然后将副本保存为brand/design.md(或保留PDF)作为他们样式的唯一真实来源。 -
将其映射到他们的套件:
设计文件中 kit.json中调色板(十六进制代码及其用途) colors,加上roles:背景 →hook_card和label_bg;文字颜色 →ink和hook_text;“陈述”或深色块 →statement_bg;高亮颜色 →highlight_blocks;强调色 →accent_pill、visuals.rotate“永远不要纯黑或纯白”类规则 使用他们最深的品牌色作为墨水色 标题和展示字体 fonts.display/poster,其斜体作为fonts.italic,用于label和字幕的无衬线字体标志性动作(斜体混用、高亮色块位于文字后、倾斜、贴纸、全大写) moves和style(hook_case、statement_case、radius)情绪(“冷静”、“俏皮”、“奢华”) visuals.motion、visuals.density、sfx.palette照片或视频风格(温暖、阴沉、明亮、胶片感) grade:contrast、saturation、brightness、warmth(−0.05 到 0.05)、vignette(0–0.5)、legibility(文字后的深色渐变,0–0.5)。保持肤色自然:无胶片颗粒,无重度压暗。图标、图形元素、贴纸、按钮(线条粗细、圆角或直角、填充色块) visuals.icon_stroke(细 1.5 → 粗 2.5)、visuals.radius、visuals.card(实心/线框/玻璃)、visuals.accent(图标色块颜色)、visuals.rotate(标签和贴纸颜色) -
付费或自定义字体: 查找字体文件。如果他们有,则放入
fonts/private/文件夹,套件使用"file"。如果没有,则选择 最接近的免费Google字体:匹配对比度、宽度(高挑或紧凑?)以及是否存在斜体。告诉他们你替换了什么以及原因。例如,“你的付费衬线字体 → Instrument Serif:相同的修长、高对比度感觉,有斜体。” -
展示它: 渲染
--looks <他们的套件>并构建sample-mine。说明哪些部分直接来自他们的文件,哪些是你诠释的。 -
保持同步: 如果他们稍后更新设计文件(“我改了品牌色”),重新读取
brand/design.md并以相同方式更新套件。
从截图或粘贴的颜色
当他们想要自己的风格而非预设时:
- 读取
inspiration/文件夹中的截图、他们的品牌指南或他们粘贴的代码。注意:- 类型:衬线或无衬线,粗细程度,是否全大写,是否混用斜体
- 字幕处理:轮廓、阴影或方框;整个短语或逐词
- 卡片形状和圆角半径
- 4–6种颜色
- 复杂程度
- 从最接近的预设开始,只更改不同的部分。字体必须是 免费Google字体:写入
{"family": "<Google Font name>", "google": true, "weight": N}(如有斜体则添加"italic": true)。通过运行uv run tools/fonts.py "<family>" --weight N确认每个字体都能下载。如果他们拥有付费字体,则可以将文件放入fonts/private/并使用{"family": "...", "file": "fonts/private/<file>", "weight": N}。 - 不要复制其他创作者的精确字体和颜色。借鉴感觉,而非受商标保护的样式。
- 渲染
--looks <他们的套件>进行检查,然后按照步骤4构建sample-mine,并在聊天中进行迭代。
6. 完成
用大约3行话告诉他们:
- 他们的样式已保存,每个Reels视频都会自动使用它
- 如何编辑Reels:将片段拖入
inbox/文件夹或聊天并说“编辑这个Reels”。你进行剪辑,他们在聊天中审阅台词,然后你根据他们的样式构建视频 - 弹出图形说明他们所说内容;“显示图形”会播放所有14种图形在其样式下的目录
- 可选扩展:将用户自己的6个Reels视频拖入聊天以实现“Reels围绕你”效果和主页网格(
tools/reels.py add);一次性提供他们的真实Instagram数据(保存到brand/instagram.json)以实现关注动画 - 他们可以在任何台词上请求一个表情包或GIF(“这里的David Rose 'ew' 表情包”)。搜索需要免费的GIPHY密钥,你会在第一次时帮助他们获取;他们自己的GIF文件可以立即使用
- 颜色和字体从来都不是固定的:“改用这些颜色”随时可以在任何Reels上生效
- 他们可以随时更改任何设置,只需说出来(“字幕小一点”、“这个不要声音”、“试试这个Reels上的Loud样式”)
- 完成的Reels会放入 Finished reels 文件夹
- 命令:/new-reel 用于新片段(为此文件夹中的每个Reels启动一个新聊天),/update 用于获取新版本,/report-problem 用于问题报告
然后询问:“想把你刚才给我的完整片段编辑成你的第一个真正的Reels吗?” 如果是,则在此聊天中对其运行new-reel技能。
套件风格开关(用于调整)
kit.json → "style":
caption_outline:像素;0表示只有阴影caption_case:"none" / "uppercase"hook:"card" / "bare"(无卡片,仅轮廓文字)hook_sizehook_casestatement_caselabel:"ticket" / "pill"label_mark:名称和主题之间的符号radiusshadow/shadow_soft:rgba颜色
"captions":
mode:"karaoke"(逐词高亮),"phrase"(整个短语),"word"(一次一个词)sizemax_wordsposition_y
"moves":
tilt_degreeshighlighter_blocks