---

标题：场记板 表情符号：🎬 SDK：docker 颜色从：灰色 颜色到：灰色 置顶：是 应用端口：3000 禁用嵌入：否 HF OAuth：否 标题：迷你 简短描述：🎬 场记板

简介

🎬 场记板是一个开源的AI故事可视化工具。

场记板一年前原型设计完成，它并非旨在替代传统视频编辑器或使用3D场景作为输入的现代AI编辑器。

场记板的理念是让任何人都能通过交互式、迭代式和直观的过程使用AI创建视频，无需外部工具、电影制作或AI工程技能。

在场记板中，你不直接编辑视频和音频文件序列，而是通过高级抽象概念（如角色、位置、天气、时代、风格等）来迭代你的故事（在AI助手的帮助下）。

为此，我还在开发导演模式，你可以将视频全屏显示，舒适地坐在导演椅（或沙发）上，对AI场务助理下达指令来制作你的电影。

公开Alpha测试版访问

场记板的公开实例目前托管在Hugging Face上，你可以在Clapper.app上试用

徽章

• 构建和测试状态：

• 赞助功能：（由于赏金提供商的问题暂时禁用）

赏金赞助商

这些慷慨的赞助商为代码赏金提供资金：

• Moon（GitHub，Twitter，网站）

想要贡献？

对于用户或公司

赞助特定功能

!! 注意：我们最初用于赏金的平台目前存在问题。我们正在寻找替代解决方案。!!

如果你希望赞助项目、帮助吸引新开发者或更快地推广特定功能，你可以为特定工单开放赏金（例如"修复音乐片段时长"、"添加Adobe Premiere Pro导出支持"、"完成.fbx集成"），开源社区成员将能够提交拉取请求来解决这些问题。

如果你提交（支付）或接受（赚取）赏金，请在GitHub线程和/或Discord上发布消息，以帮助大家协调。

我目前正在添加文档以帮助新开发者入门，这应该能帮助新人接受赏金任务。

对于开发者

许可证

场记板使用GPL v3许可证，详情请参阅许可证文件。这与ComfyUI或Blender等应用程序的许可类似。

安装

先决条件

作为先决条件，你需要安装git lfs（参见项目根目录的.gitattributes文件）：

git lfs install

你还需要安装Bun

场记板已在Node 20.15.1版本上测试过。

为确保使用此版本，你可以使用NVM来激活它：

nvm install
nvm use

如果你发现场记板可以在更新的（稳定）Node版本上运行，或有更好的版本管理建议，请开启一个工单。

安装

安装依赖项。

--include=optional是为了确保安装可选依赖项（与你的系统兼容的预构建本地模块）

bun i

你可以运行以下命令来构建应用程序，确保所有类型一致且设置正确：

npm run build

运行Web应用程序

然后运行实际的应用程序，在输入此命令后首次访问localhost:3000时，应用程序将进行编译，这可能需要一分钟（字面意思："Compiled / in 52.6s (6372 modules)"）

bun run dev

使用Electron运行应用程序

正在进行Electron构建。

仍有一些事情需要调试和解决，但如果你是开发者，可以尝试通过Electron启动场记板，如下所示：

cd packages/app
bun run electron:start

如果这对你不起作用（node-gyp、setuptools、distutils等问题），你可能需要运行：

python3 -m pip install --break-system-packages setuptools

你还可以通过输入以下命令为你的操作系统构建场记板：

cd packages/app
bun run electron:make

你可能会在最后看到一条用红色写的DeprecationWarning消息，但那只是一个警告，只需打开./out/make检查构建是否成功。

代码约定

我设置了Prettier和ESLint，它们使用一些基本规则（如果你想提出新规则，可以提出）

测试

要运行所有测试（单元和端到端），请运行：

bun run test

这不是瞬时的：playwright一开始可能看起来什么都不做。

@jbilcke-hf正在努力添加更多测试，并将担任"QA工程师"的角色。

单元测试

注意：我刚刚添加了Vitest，所以目前只有几个测试。

要在不观察的情况下运行测试，请输入：

cd packages/app
bun run test:unit:ci

要在观察模式下运行测试，请输入：

cd packages/app
bun run test:unit:watch

端到端测试

注意：我刚刚添加了Playwright，但我们还没有真正的测试。

请注意，由于应用程序需要30~60秒的构建时间（取决于你计算机的速度），运行这些测试可能需要一些时间。

bun run test:e2e

更多Playwright命令： bunx playwright test 运行端到端测试。

bunx playwright test --ui 启动交互式UI模式。

bunx playwright test --project=chromium 仅在桌面Chrome上运行测试。

bunx playwright test example 在特定文件中运行测试。

bunx playwright test --debug 在调试模式下运行测试。

bunx playwright codegen 使用Codegen自动生成测试。

我们建议你从以下命令开始：

`bunx playwright test`

架构

为方便起见，你可以在运行时通过在浏览器的JS控制台中输入useUI.getState(), useIO.getState()等来访问和检查任何服务