帮助文档 / 快速开始
快速开始
我的 Mac 能运行吗? 每款 Apple Silicon Mac 的内存、芯片、磁盘和渲染时间,汇总在一页。
Phosphene 在你的 Mac 上制作视频、图片、歌曲和声音,不上传任何内容,也不用租用算力。你描述一个镜头,它进入队列,做好的文件会出现在“作品”里。
还没安装,或者磁盘空间不够?请看安装、更新与磁盘空间。
标签页
左栏顶部的一排标签页,用来选择你要做什么。⇧1-⇧7 可以用键盘在它们之间切换。
| 标签页 | 用来做什么 |
|---|---|
| 视频 | 由提示词生成片段,也可以从图片、首帧和尾帧、关键帧、要延长的片段,或你自己的素材(重制)出发。见视频。 |
| 一镜到底 | 30 秒到 2 分钟、中间不切镜的连续镜头。见一镜到底。 |
| 图片 | 静态图:编辑参考图,或用 Ideogram 4 把文字放进画面。见图片。 |
| 分镜 | 从一个想法规划整部影片,渲染每个镜头、调色、剪辑。见分镜。 |
| 编辑器 | 时间线:修剪、分割、移动声音、添加标题和音乐,再渲染影片。见编辑器。 |
| 音频 | 作曲用来写带人声或纯器乐的歌曲(Music Studio)。音乐视频根据一首歌和你的图片规划一部影片。对口型让原创角色对着你有权使用的音频说话或唱歌(音频)。 |
| 训练角色 | 用 15 到 500 张图片训练你自己的原创角色和风格。见训练角色。 |
引擎
顶部栏的引擎切换决定由哪个模型来渲染:LTX 或 Hailuo H3。它们是两个各有所长的不同引擎,不是一个主力加一个备用:
- LTX:所有视频模式、LoRA 和训练好的角色。
- Hailuo H3:画面、对白和声音一起生成:文字、图像、首尾帧、关键帧、延长、添加声音和对口型。它需要单独安装,约 75 GB,并且需要 16 GB 内存。见 Hailuo H3。
表单会随引擎变化:当前引擎用不到的控件会隐藏,“画质”和“时长”选项也会显示该引擎自己的规格。只有当这台 Mac 能运行不止一个引擎时,才会出现这个切换。两者的对比。
队列
你生成的所有内容都进入同一个队列,一次渲染一个任务。底部的面板有四个标签页:
- 进行中:正在渲染的任务,并带有镜头成形过程的实时预览。预览上的提前停止会先询问,再停止:“不会保存任何内容”,队列继续处理下一个任务。
- 队列:等待中的任务。卡片上的 × 会把它移除。
- 最近:已完成的内容,可按“全部 / 视频 / 照片 / 音频”筛选。
- 日志:渲染日志。见阅读日志。
在“生成”按钮下方:⊞ 批量可以一次粘贴多条提示词并全部加入队列;暂停队列会让队列暂停(按钮随后变成继续队列);清空会移除所有等待中的任务,正在运行的那个会继续。
作品
右侧的作品库显示你做过的内容。点击一张卡片,就会把它放到播放器里。
- 全部 / 视频 / 照片 / 音频用来筛选,搜索框可以按提示词里的词、模型、LoRA、尺寸或种子查找作品(⌘F 会跳到搜索框)。
- 显示全部会加载比最新 60 条更早的渲染。
- ← → 在作品库中逐个切换,Space 播放和暂停,F 把播放器展开到全屏。
- 播放器上方的操作行列出你接下来可以对这个片段做的事:延长它,对它运行超清放大与人脸修复,把它加入影片,让静态图生成动画,查看它的参数。
- 没有声音的片段,在作品库卡片上会带一个无声音 · 添加声音的标签(播放器里也会这样提示)。点一下,就会把这个片段放到播放器上,并打开 Hailuo H3 的添加声音,同时选中它。
- 分享(在片段的更多菜单和全屏查看器里)会复制一行带 Phosphene 链接的说明,并在访达中显示文件,方便你直接附上。不会上传任何内容。
- 眼睛图标会把片段从作品库中隐藏(目前界面里没有办法把它恢复,手动恢复的方法见视频)。卡片上的废纸篓按钮会在询问后,把文件移到 macOS 废纸篓,如果你改主意了,可以从访达恢复。⌘⌫ 对所选作品执行同样的操作。
文件存放在哪里
使用 Pinokio
| 内容 | 位置 |
|---|---|
| 你的渲染作品 | Phosphene 安装目录里的 mlx_outputs 文件夹。“作品”标题栏里的文件夹按钮会在访达中打开它,Pinokio 的 Outputs 项也能打开。 |
| 训练好的角色和下载的 LoRA | mlx_models/loras/ |
| 设置 | panel_settings.json |
使用 Mac 应用
| 内容 | 位置 |
|---|---|
| 你的渲染作品 | ~/Library/Application Support/Phosphene/outputs。“作品”标题栏里的文件夹按钮,或 Studio → Open Outputs Folder 都可以打开 |
| 训练好的角色和下载的 LoRA | ~/Library/Application Support/Phosphene/models/loras/ |
| 设置 | ~/Library/Application Support/Phosphene/state/panel_settings.json |
每次渲染都会在它旁边写入一个小的附属文件,记录它的设置。参数读取的就是它,“作品”也靠它来按 LoRA 或种子搜索。
首次启动
使用 Pinokio
运行环境准备好后,会出现启动按钮。应用打开之前不会下载任何模型。安装需要约 18 GB 可用空间,其中包括为你的作品保留的 15 GB。
要做视频,请点击下载视频模型。默认是 LTX-2.5 Q4,连同提示词编码器约 27.5 GB。有了它,你的第一个文字或图片视频就能做出来,不需要更大的 Q8 包。两部分会依次下载,面板里显示进度。停止下载会保留已下载的部分文件,再次点击下载按钮即可继续。
你也可以选择图片或音频。它们有各自的模型,不需要视频下载。优化、分镜规划器和可选的适配器,会在你用到它们时提供下载。除此之外,不会因为你打开应用就开始下载别的东西。
使用 Mac 应用
基础套件约 28 GB:LTX-2.5 引擎、它的文本编码器和预览解码器。下载开始前,应用会列出每一项及其大小、所需空间和你的可用空间。如果装得下 Studio 但装不下模型,你可以先安装 Studio,之后再在里面下载模型。
安装时还会问你模型放在哪里:这台 Mac,还是外置硬盘。见把模型放在外置硬盘上。
如果应用的模型下载中断,Studio 会自己获取视频模型,你的第一个片段会按这台 Mac 的能力来确定尺寸。如果安装没有完成,Studio 会显示一个完成设置按钮。
Gemma 3(优化和分镜规划器用的模型),以及超清放大与人脸修复、Control、Ingredients 和上色用的适配器,会在某个功能第一次需要时下载:该功能会给出提示,并提供立即下载。
更新已有的安装不会下载或删除任何东西。
更新
使用 Pinokio
- 顶部栏的版本标签会告诉你现在的状态:已是最新,或更新到更新的版本。有新版本时,会出现横幅,提供立即更新 / 稍后。
- 在 Pinokio 里,Phosphene 侧边栏的 Update 项会更新所有内容,包括 Python 依赖。更新会保留你的队列、设置和模型。如果更新中途停止,见安装中断时。
- 应用内更新之后,横幅会显示 “已更新到 … 重启以完成”:在 Pinokio 里先点 Stop,再点 Start。如果更新涉及依赖,它会提示你改用 Pinokio 的 Update。
- 如果从很旧的版本发起的更新看起来只动了面板,请再点一次更新,旧版本会先更新它自己的更新程序。
- 如果 Pinokio 的 Update 在开头一秒就停止(4.19.6 及更早版本可能出现),请改用 Phosphene 自己横幅或版本标签里的立即更新,然后重启。从 4.19.7 开始,Pinokio 的按钮恢复正常。见疑难解答。
使用 Mac 应用
- 版本标签显示你的版本和提交。点击它会复制你的构建信息,用于提交错误报告。
- 只有通过 Phosphene → 检查更新… 才会更新。你的队列、设置、模型和已完成的作品都会保留。
- 要修复音乐引擎,请打开音频 → 作曲,点击修复音乐引擎。要下载或完成 Hailuo H3,请使用它卡片上的下载 Hailuo H3或继续(见 Hailuo H3)。
感谢卡片
你完成第五次渲染之后,在你 30 秒没有操作 Phosphene 时,角落里会出现一张小卡片,请你在 GitHub 上点个 Star。它不会遮住你的片段,一旦你关掉它(× 或 Esc),就再也不会出现。
- 一键 GitHub Star:如果这台 Mac 已通过
gh命令登录了 GitHub,点击 Star on GitHub 就会直接给 Phosphene 点 Star,卡片会向你道谢。只有在你点击时,Phosphene 才会请gh去做这件事,它从不读取或保存你的 GitHub 登录信息。 - 否则,按钮会在浏览器中打开 Phosphene 的 GitHub 页面。
- 如果你已经点过 Star(通过顶部栏的星标、更新横幅,或在 GitHub 上直接点的,只要
gh能看到),就不会再看到这张卡片。
提示 在任何地方按 ? 都可以打开这些文档的快捷键页面,也可以用左侧的搜索框,按按钮上写的文字找到任何按钮。
来源:webapp/docs/getting-started.md,位于公开仓库。发布前已针对本网站审阅。译自英文原文。建议修改。