系统文件与路径：修订间差异

2026年9月3日 (四) 16:09的最新版本

程序将数据存储在三个不同的位置:项目文件夹(project folder)中存放您构建的一切;程序文档文件夹(program documents folder)中存放库、工作区(workspace)和工作日志;而Windows 系统本身则存放程序设置和许可证。了解这一点在三种情况下很有必要:将项目转移到另一台计算机时、在转移或重新安装后项目中找不到图片和视频时,以及技术支持要求您发送工作日志时。

程序文档文件夹是当前用户系统文档(Documents)文件夹中的 Light Stream 文件夹;程序在首次启动时会自行创建它。项目文件夹是您在创建项目时自己选择的,而安装文件夹则是在安装向导中选择的。在复制或删除任何内容之前,请先打开这些文件夹,核实其中实际存放的内容。

简而言之:各类内容存放位置

内容	位置	是否随项目一起转移
固定装置(fixtures)、地址分配(patching)、合成(compositions)、效果(effects)、3D 场景	项目文件夹中的项目文件 `*.ls`	是,这就是项目本身
图片、视频、音频、模型贴图	存放在您获取它们的原始位置;项目中只记录了引用路径	仅当将项目收集到一个文件夹中时
导入的视频序列(video sequence)的帧	项目文件夹内的 `Import\Video` 子文件夹	是,前提是整体转移项目文件夹
导出的动画 `*.cue`	Export(导出)窗口中路径(Path)字段指定的文件夹(新项目中默认是项目旁边的 `Export` 子文件夹)	否,导出需要重新进行
自定义固定装置、效果库、工作区、日志	程序文档文件夹	否,需单独复制
程序设置、最近项目列表、许可证	Windows 系统中,当前用户配置文件内	否,需要重新设置

项目文件夹

它是如何生成的

选择File(文件) → New Project(新建项目)(Ctrl+N),或在Welcome to Light Stream(欢迎使用 Light Stream)欢迎窗口中点击Create(创建)。
在Create Project(创建项目)窗口中设置Project Name(项目名称)——文件和文件夹都将以此命名。
在Path(路径)字段中指定在何处创建该文件夹:手动输入,或使用Open(打开)按钮。首次使用时,程序会建议使用程序文档文件夹中的 Scenes 子文件夹,之后则会建议您上次选择的文件夹。将项目保存在存放场地工作资料的位置会更方便。
如有需要,修改Frames Per Second for Project(项目的每秒帧数)——新建的合成将以此帧率创建。
点击Create(创建)。

程序会在指定位置创建一个以项目命名的文件夹,将扩展名为 .ls 的项目文件放入其中,并同时在旁边创建一个 Export 子文件夹——该文件夹会立即填入Export(导出)窗口的Path(路径)字段中。

如果无法写入所选位置,程序会以No write access(无写入权限)的提示进行警告。系统盘根目录和Program Files文件夹通常会出现这种情况——请选择其他位置,例如Documents(文档)。

接下来,不妨把这个文件夹当作场地文件夹:将项目中使用的所有图片、视频、音频和模型都放入其中。程序能够在项目文件夹内部(而非整个磁盘)搜索丢失的文件。

项目文件内部存放的内容

.ls 文件是一个单一文件,汇集了您构建的一切:

映射(mapping)上的固定装置及其尺寸、地址和名称;
设备(Player、转换器、端口)及地址分配(patching);
合成、布局(layout)、效果及其关键帧;
整个 3D 场景,包括导入模型的几何体:导入后,原始模型文件 *.obj 或 *.fbx 已不再需要,项目在没有它的情况下也能打开;
项目中使用过的固定装置——因此即使在没有您自定义固定装置库的计算机上,项目也能正常打开;
导出文件夹以及标记了哪些合成需要导出的信息。

项目文件中没有的是媒体文件本身。图片、视频、视频序列、音轨、模型贴图以及布局的背景图片仍保存在磁盘上,项目中只记录了指向它们的路径。如果此类文件被重命名、删除,或留在了旧计算机上,项目中的相应效果就会失去图片。

视频序列的帧

作为视频序列(video sequence)导入项目的视频,程序会预先将其拆分为单独的帧——否则将无法流畅播放。这些帧被写入项目文件夹内的 Import\Video 子文件夹:每个视频都会生成一个以视频文件名命名的文件夹,里面存放编号文件 00000000.png、00000001.png,依此类推。

由此可得出以下几点:

导入视频后,项目文件夹会成倍增大——解包后的帧比原始视频占用的空间大得多。请提前规划磁盘空间;
这些帧就是序列本身:删除该文件夹,效果将不再显示任何内容,必须重新导入;
转移项目时必须连同 Import 子文件夹一起转移,否则在新计算机上必须重新导入视频;
如果第二次导入同一个视频,程序不会覆盖旧的帧,而是在旁边新建一个名称中带编号的文件夹。

项目备份副本

每次保存时,程序都会先将项目的上一个状态另存为一个副本:项目文件旁会出现一个同名文件,末尾附加 .backup。

如果项目在一次保存失败后无法再打开:

关闭程序。
将损坏的 .ls 文件另存到别处——以防日后还有用。
复制带 .backup 后缀的文件,并从副本文件名中去掉 .backup,使其成为普通的 .ls 文件。
在程序中打开该文件。

这样您将得到项目在上一次保存时的状态。备份副本只有一份,并且每次保存时都会被覆盖,因此不能把它当作存档来依赖:重要的工作阶段请通过File(文件) → Save As…(另存为…)以单独的名称保存。

程序如何查找丢失的文件

如果按照项目中记录的路径找不到文件,程序不会立即放弃,而是会自行搜索:

在项目文件夹及其所有子文件夹中查找同名文件;
对视频序列文件夹,还会在项目文件夹内的 Import\Video 子文件夹中查找。

如果那里也没有找到,该效果将保持为空,其在时间轴(timeline)上的名称会变为红色。这样可以立即看出哪些效果丢失了文件:选中该效果,并在Properties(属性)窗口中重新指定文件。

由此可得出一条简单的规则:将媒体文件保存在项目文件夹内。这样一来,无论重命名文件夹还是迁移到另一个磁盘,项目都能正常使用——程序会自动找到所有文件。而如果图片存放在桌面或 U 盘上,迁移后就必须手动重新选择。

将项目转移到另一台计算机

要将项目连同所有外部文件一起收集起来,请使用File(文件) → Collect Project(收集项目):

打开项目并选择File(文件) → Collect Project(收集项目)。项目未打开时,该菜单项不可用。
指定要收集到的文件夹。最好选择空文件夹:程序会将项目文件及其使用的所有文件都放入其中。
等待完成——对于带有视频的大型项目,这需要一些时间,在此期间光标会一直显示等待状态。

具体过程如下:项目文件的副本会写入所选文件夹,所有外部文件则会被复制到 CollectProjectFiles 子文件夹中,并按照它们在磁盘上原来的位置分布到相应的嵌套子文件夹里。收集后的项目内部路径会相对于新文件夹重新构建,因此必须转移整个文件夹,而不是单独的 .ls 文件。

会被收集的内容包括:效果中的图片和视频、视频序列、音轨、布局背景图片,以及导入模型的贴图。

需要了解的信息:

如果无法写入所选文件夹,程序会以No write access(无写入权限)提示进行警告,且不会收集任何内容——请选择其他位置;
收集完成后,您仍然在原项目中继续工作,收集得到的副本只是单独存放在磁盘上;
程序设置、工作区和许可证不会随项目一起转移——需要在新计算机上重新设置。

导出文件

合成的导出会将文件放入Export(导出)窗口中Path(路径)字段指定的文件夹。新项目中,该字段默认设置为项目旁边的 Export 子文件夹;可以通过Open(打开)按钮更改。所选文件夹会被记录在项目中。

文件	命名方式
用于 Light Stream Player 的动画	取自Export(导出)窗口中File Name(文件名)列的名称;默认情况下是合成名称加 `.cue` 扩展名
用于展示的视频(Video Render(视频渲染)模式)	合成名称加扩展名,扩展名取决于所选编解码器:`.mp4`、`.mov` 或 `.avi`
PNG Sequence(PNG 序列)模式下的帧	以合成名称命名并带 VideoSequence 后缀的文件夹,内部为 `000000.png`、`000001.png` 等文件
固定装置遮罩(mask)	保存时您指定名称的 `*.png` 文件

默认文件名取自合成名称,因此程序会自动从合成名称中移除 Windows 不允许出现在文件名中的保留字符——\ / : * ? " < > | 等。合成名称长度限制为 40 个字符。

如果项目中有多台 Light Stream Player 设备,程序会在导出文件夹中为每台设备创建单独的子文件夹,并将 *.cue 文件分别放入对应文件夹——这样可以一目了然地看出哪些动画应加载到哪台播放器上。关于导出的更多内容,请参见文章导出合成。

程序文档文件夹

程序首次启动时,会在系统Documents(文档)文件夹中创建自己的 Light Stream 文件夹,并将所有与工作场所(而非单个项目)相关的内容保存在其中。

内容	存放位置
默认为新项目建议的文件夹。程序首次启动时,会根据其中找到的内容填充欢迎窗口中的项目列表:该文件夹及其子文件夹中找到的所有 `*.ls` 文件都会被列出	`Scenes` 子文件夹
固定装置库:出厂自带的 `fixtures.lslib`、您的自定义 `UserFixtures.lslib`,以及位于 `Images` 子文件夹中的固定装置和制造商图片	`Fixtures` 子文件夹
效果库——Effects(效果)窗口的内容,连同您保存的效果(`LightStream.effects` 文件)	`Effects` 子文件夹
工作区(workspace)——已保存的窗口布局(`ls.workspace` 文件)	程序文档文件夹根目录
程序工作日志(`ls.log` 文件)	`logs` 子文件夹

迁移到新计算机时,以下内容值得复制:

UserFixtures.lslib 及 Images 子文件夹——如果您制作过自己的固定装置,并希望在新项目中继续使用;
LightStream.effects——如果您对效果库做过自定义调整。保存效果库时,程序会在旁边保留上一版本的副本,并附加 .backup 后缀;
ls.workspace——如果您珍视自己的窗口布局。

复制该文件夹中的文件时应先关闭程序,否则部分更改会在程序退出时被覆盖写入:例如,工作区就是在程序关闭时才被保存的。

程序安装文件夹

安装路径在安装向导中设置;默认是Program Files内的一个文件夹。程序本身就存放在这里——例如,在 NVIDIA 控制面板中配置性能时选择的可执行文件就在此处(参见 Light Stream - 快速开始)。

不需要把自己的文件放在这里:普通用户对Program Files没有写入权限,而且程序更新时该文件夹的内容会被覆盖。请将项目、媒体和导出内容保存在项目文件夹中。

设置、最近项目与许可证

Settings(设置)窗口中的设置、File(文件) → Recent Files(最近文件)列表以及许可证数据既不保存在项目中,也不保存在可以复制的单独文件中:它们记录在 Windows 系统中,并与本机的用户账户绑定。由此可知:

无法通过复制文件夹将设置转移到另一台计算机——语言、网卡、音频设备等都需要重新设置;
同一台计算机上的每个 Windows 用户都有各自的设置和各自的最近项目列表;
最近项目列表最多保存十条记录——无论是在File(文件) → Recent Files(最近文件)菜单中,还是在欢迎窗口中都是如此。多余的条目可通过右键(right-click) → Remove from this list(从此列表中删除)移除;右键 → Show in Explorer(在资源管理器中显示)可帮助在磁盘上找到项目文件夹;
许可证与计算机绑定。将程序转移到另一台机器之前,必须先在Activation(激活)窗口(Help(帮助) → Activation(激活))中停用它——否则许可证密钥仍会处于占用状态;
从很旧的版本更新程序后,窗口布局可能会恢复为默认状态。这是正常现象,您自己的工作区会重新保存。

程序工作日志

程序会记录日志:位于程序文档文件夹中的 logs 子文件夹,文件为 ls.log。当文件增长到大约一兆字节时,会被移入 archives 子文件夹,记录则继续写入新文件;最多保留十个存档,旧的存档会自动删除。

联系技术支持时需要用到日志:如果程序自行关闭、卡死,或给出了不明原因的错误,请在提交请求时附上 logs 文件夹的内容,并说明此前的操作。无需单独开启日志记录——它始终在运行。

值得备份的内容

备份的最低限度内容:

整个项目文件夹——.ls 文件连同媒体文件及 Import 子文件夹。如果媒体文件分散存放在各处,请先执行File(文件) → Collect Project(收集项目),然后备份收集得到的文件夹。
导出的 *.cue 文件——如果不想在现场重新进行导出。
程序文档文件夹中的:带 Images 子文件夹的 UserFixtures.lslib、LightStream.effects、ls.workspace。

程序设置和许可证无法复制——需要手动恢复设置,许可证则通过停用后重新激活来转移。

参见