• 人工智能
• AI 应用
• AI Agent
• 媒体生成
• 音视频
• 桌面应用

BeefTV 是一款本地优先（Local-first）的 AI Native 视频创作工作台：在一张自由画布中连接创意、AI 模型与素材，即可生成文字、图片、AI 视频与音频，全程无需注册登录。本指南带你在 10 分钟内完成 BeefTV 安装、模型配置，并在画布中生成第一个 AI 视频。

为什么选 BeefTV：一张画布搞定完整创作链路

传统 AI 工具里，"生成"往往只是页面上的一个按钮；而在 BeefTV 中，AI 是工作台本身的一部分：

完整能力说明见 功能清单。

第一步：下载与安装 BeefTV 桌面版（约 2 分钟）

从官方发布页下载对应系统的安装包，三个平台安装方式如下：

💡 Mac 首次打开若提示「Apple 无法验证该应用」，请前往「系统设置 → 隐私与安全性」点击「仍要打开」即可，这是 macOS 对未公证应用的正常检查。

安装说明详见 docs/desktop-install.md 与 QUICKSTART.md。

数据保存在哪里？你的项目、画布、素材和设置默认保存在独立的用户目录（Windows 为%AppData%\BeefTV，macOS 为~/Library/Application Support/BeefTV），卸载不会删除数据，迁移方法见 docs/storage-settings.md。

第二步：首次打开并配置模型渠道（约 3 分钟）

启动 BeefTV 后不需要注册或登录，直接进入本地工作区。唯一的准备工作是告诉它"调用哪个 AI 模型"：

1. 打开左侧栏的「模型配置」。
2. 选择模型渠道：内置 BeefAPI 点「连接 BeefAPI」，在系统浏览器完成授权后即可拉取模型；其他渠道填写Base URL和API Key。
3. 保存后，可搜索、按用途筛选模型，也可手动添加服务商提供的模型 ID。

放心：密钥只保存在本地工作区，不会写入画布、素材或任务列表；只有执行生成时，才会按你配置的渠道请求外部模型服务。渠道接入与验证细节见 docs/model-provider-validation.md，官方已为大量模型服务预置了插件包，位于 plugin-packages/ 目录。

第三步：认识画布——节点、连线与素材（约 3 分钟）

进入项目后你会看到一张自由画布，这是 BeefTV 的核心工作区：

• 添加节点：底部工具栏的「+」可新建文本、图片、视频、音频、分镜、文件夹等节点，也可以直接上传文件或打开素材库。
• 建立关系：把节点用连线连起来，就形成"参考图 → 角色三视图 → 分镜 → 视频"这样的生成链路。
• 智能引用：在节点提示词面板输入图1、图片1等并按 Tab，即可把已连接素材插入提示词，无需手动复制描述。
• 批量创作：框选多个节点或打开批量创作表，可用全局提示词一次驱动多条生成任务。

画布还自带「版本记录」：右侧面板按日期展开历史树，点击版本可进入独立只读预览、恢复或下载，防止误操作覆盖内容：

第四步：生成第一个 AI 视频（约 2 分钟）

1. 在画布添加一个视频节点，在提示词面板描述你想要的画面，例如"霓虹雨夜的城市街头，镜头缓慢推进，赛博朋克风格"——BeefTV 内置了多种短剧风格参考，如：

2. 提示词写得不够好？点击「优化」，内置的 AI 提示词优化器会帮你把模糊想法扩展成包含主体、场景、构图、光线的完整提示词，确认「采用」即可回填。
3. 在节点右上角选择视频模型与参数（时长、比例等），点击生成。
4. 到任务中心查看异步任务进度，完成后视频节点直接播放，并自动进入个人资产库，可继续被后续节点引用。

生成结果示例（BeefTV 画布输出的 AI 视频帧）：

常见问题与数据保障

• 需要联网吗？工作台本身完全本地运行，仅在生成时按你的配置访问模型服务；项目数据不会被同步到任何 SaaS 存储。
• 画布能恢复吗？每次保存都核对版本，冲突时保留本地草稿；版本记录最长保留每个画布最近 20 份快照，支持一键恢复。
• 想换磁盘/迁移数据？在「存储设置」中可整体迁移本地目录，详见 docs/storage-settings.md。

参考文档

• 快速开始：QUICKSTART.md
• 安装指南：docs/desktop-install.md
• 功能清单：docs/content/docs/overview/features.mdx
• 模型验证：docs/model-provider-validation.md
• 本地架构：docs/local-first-architecture.md

到这里，你已经完成了从安装 BeefTV 到生成第一个 AI 视频的全部流程 🎉。接下来不妨试试"参考图 → 角色 → 分镜 → 视频"的完整链路，感受画布式创作的乐趣。

• 人工智能
• AI 应用
• AI Agent
• 媒体生成
• 音视频
• 桌面应用