交付与交换 / X5 · CSV

CSV 交付比 ALE 多带什么、少带什么

CSV 明细表和 ALE 清单不是同一份数据换个后缀。CSV 面向人和表格工具逐列查看,ALE 则是给接收流程读取的交换清单;两者取值范围、缺值写法、编码和字段语义都不同。CSV 会带出更多机位与拍摄参数,但它仍然不是媒体清单,也不提供声道映射或声音时码。

格式不同,重要的不只是“多几列”,而是每一列从哪里来、准备给谁核对。

CSV 多带的是机位与拍摄明细

相较 ALE,CSV 会带出更多镜头与机位层信息。焦段、滤镜、感光度、光圈、快门、画幅、分辨率,以及景别、角度、运动等构图信息,都属于这份表格明细能够表达的范围。

它还会写入若干状态位,包括特效、底板、净景和参考等机位状态,并带拍摄日期。这里要保留一个重要边界:交付表里存在一列,不等于 App 当前就有对应的现场录入入口。某些声音状态列虽然出现在文件结构中,但不能据此宣传成已经可记录的能力。

条备注与机位备注也会分开进入不同列。生成 CSV 时,备注里的换行、回车和制表符会被压成空格,因此不能承诺“备注原样保留”。接收方看到的是经过表格化处理后的文本。

两列档位不能当成同一件事

CSV 里有一列文字档名,也有一列布尔 Circle。文字档名会写成 Circle、Keep、Hold、N/G;未标记时可以为空。布尔 Circle 列则只有当前文字档名为 Circle 对应的那一档才写 TRUE,其他情况写 FALSE。

这意味着,现场把一条标成 Keep 时,文字档名列会明确写 Keep,但布尔 Circle 仍然是 FALSE。因此不能把布尔列直接解释成“这条在现场有没有被圈过”的完整语义。它只是由特定档位条件派生出来的一个布尔值。

读 Rating 是在读文字档名;读 Circle 是在读一个更窄的派生条件。两列不能互相替代。

这也是接收方需要逐列建立映射的地方。如果自己的表格模板只看布尔列,就会漏掉文字档名中仍然有意义的其他状态;如果只看文字列,也不能假定它等于 App 内部其他状态字段。

CSV 仍然没有媒体位置和声音映射

字段更多,不等于这份文件承担了媒体关联的全部信息。当前 CSV 不写素材路径,也没有声道映射和声音时码。接收方如果需要知道媒体文件实际放在哪里、哪条声道对应什么声音来源,必须从素材与其他交接记录补齐。

同样,表格里出现 Filename、卷号或片段号,并不让它自动变成一份可直接定位全部媒体的清单。身份字段需要和实际素材文件名、卷号及现场记录交叉核对。

编码和清洗规则也与 ALE 不同

CSV 落盘时会带字节顺序标记,而 ALE 不带。两份文件都使用 LF 换行,但接收环境对编码与换行的处理需要实际验证。出现乱码或列错位时,应该先检查编码、分隔与文本清洗,不要先假定内容字段本身错了。

CSV 的每个数据值会经过自己的转义路径。换行和制表会被压平;包含逗号或双引号时会按当前规则加引号和转义。这个行为适合当前生成方式,但不应被扩大成对某个外部 CSV 规范的合规承诺。

日期也不是所有交付物一套口径

CSV 的日期列固定写成公历机器格式 yyyy-MM-dd。另一类报告的页眉日期则跟随设备环境的日期格式设置。两者服务不同阅读场景,因此不能写成“所有交付物里的日期一定逐字相同”。

如果接收方要做跨文件对表,应先把日期字段的格式差异当成预期条件,再核对它们是否指向同一天。字符串不同不必然表示日期不同;字符串相同也不能替代对源记录的确认。

FAQ

CSV 比 ALE 多出来的主要是什么?

主要是更细的机位、光学、构图、状态和日期明细,例如焦段、滤镜、感光度、光圈、快门、分辨率、景别、角度和运动等。

Rating 和 Circle 两列为什么可能看起来矛盾?

因为它们不是同一来源语义。Rating 写文字档名,而布尔 Circle 只在档名为 Circle 的那一档写 TRUE。一条 Keep 因此会同时出现 Rating=Keep 与 Circle=FALSE。

CSV 会把备注原样保留下来吗?

不会逐字符原样保留。换行、回车和制表符会在生成时压成空格,接收方看到的是适合表格行结构的处理结果。

CSV 有了更多字段后,能不能直接找到素材和声音声道?

不能。当前文件仍不包含素材路径、声道映射或声音时码。媒体位置与声音关系需要从素材和其他交接信息中核对。


上海智独教育科技有限公司 — SlateX。以上数字截至 2026-09-24。

沪ICP备2026001245号-1

上海智独教育科技有限公司

上海市嘉定区澄浏公路52号39幢2楼J

support@slateprotocol.com