NegPy胶卷管理指南：如何批量处理、筛选并统一一整卷负片的色彩基准

NegPy 是一款专为胶片扫描设计的负片处理工具，它的核心工作单元是一卷（Roll）负片：把扫描文件按卷导入后，可以在整卷范围内筛选废片、批量套用裁剪与设置，并用 Roll Analysis 为全卷建立一个统一的密度与色彩基准，让同一卷的每一张片子看起来"一致"。本指南带你走完这条从导入到批量导出的完整路径。

1. 把一整卷负片导入 Library 🎞️

NegPy 的资料库（Library）是"卷"的列表：一卷可以是一个文件夹，也可以是你手工挑选的一组帧。

• Import Folder as a Roll…：把一个文件夹作为一卷导入并打开。如果文件夹名匹配了 Gear 库里的相机或胶卷名（比如 "penf" 匹配 "Pen F"），Roll Settings 会自动预填。
• Import Subfolders as Rolls…：把选定目录下的每个含图文件夹都作为一卷导入，适合按卷整理好的扫描目录。
• Save as Roll…：先通过搜索或拖拽收集若干帧，再把它们"存成一卷"（虚拟卷）。一张照片可以同时属于多卷。

导入只记录文件夹位置，不会改动任何文件；之后在磁盘上重新整理，再点 Library 的↻即可刷新帧数（详见 docs/USER_GUIDE.md 第 2 节）。

2. 快速筛选：Keep / Reject 与元数据过滤

整卷 36 张里总有废片。NegPy 用"挑选（Triage）"来处理：

• 右键缩略图 → Keep / Reject：打勾的是保留，打叉的会被批量导出跳过，文件本身不会变。
• Sheet filter：提供All Frames、Keepers Only、Hide Rejected、Unmarked Only四种视图，配合Advance After Marking可以快速过片。
• 过滤器支持field:value语法，例如film:portra、iso:>=400、keeper:、-rejected:（前缀-表示取反），多个词用 AND 组合。
• 标记完记得用工具栏的Update Thumbnails刷新过期的缩略图。

💡 小技巧：Ctrl+K打开 Find，可以直接搜到任意滑块、面板和动作，比逐层翻菜单快得多。

3. 批量处理：把设置"克隆"到整卷

单张精修完一张后，NegPy 支持把设置一键推给选中的帧或整卷：

每张卡片头部都有Frame / Roll这对小开关（琥珀色 / 红色），它标示当前数值是"按帧"还是"按卷"生效。把某张帧调好后点Roll，就能把该卡片推为全卷默认，新打开的帧会自动继承（Frame/Roll 作用域详见 docs/USER_GUIDE.md）。

4. 统一色彩基准：Roll Analysis ⚖️

这是让"一整卷负片色彩一致"的核心功能。Roll Analysis 只测量一次整卷，然后把结果（基准，Baseline）共享给所有帧，而不是每帧各自自动曝光。

在Roll 标签页 → Roll Analysis卡片中：

• Reanalyze：对当前加载的卷重新测一次平均密度和色彩平衡并保存基准。跑之前建议先Auto-crop all frames，保证每帧裁切一致。
• Use average: Luma：全卷共用同一个调性范围（亮度基准），色彩仍按帧计算。
• Use average: Color：全卷共用同一个色彩平衡，调性范围按帧计算。
• 两者都开：整卷的亮度和色温都一致；都关：回到逐张自动曝光。
• Use This Frame：不取平均，直接把某一张"标杆帧"的测量值保存为全卷基准——适合卷里有一张明显拍得最好的场景。
• Scenes（场景）：同一卷里如果混合了多种光线（比如白天外景 + 室内灯光），可以把同光线的帧右键Group as Scene…组成场景，再单独Analyze Scene…。场景成员只和场景内其他帧互相对齐，不与全卷混池。

底层逻辑：Roll Analysis 会用中位数把"离群帧"识别出来——离群帧（比如一张明显过曝或偏色的照片）保留自己的边界，不参与投票，避免坏帧拉偏全卷基准（算法说明见 docs/PIPELINE.md 第 75 行附近）。

⚠️ 改了Crosstalk、Single-Shot Narrowband Calibration或扫描设置后，记得重新跑一次 Roll Analysis，因为这些校正会改变测量读数（参见 docs/CROSSTALK.md）。

5. 批量导出：让全卷保持一致地输出

• Export 按钮的 ▾ 选择范围：当前帧、选中帧、或所有可见帧。被标记 Reject 的帧会自动跳过，所以先做 Triage 再批量导出最省心。
• Flat 输出（给其他编辑器用的 16 位中性主文件）：官方建议批导前先跑一次 Roll Analysis，这样每张主文件的基准一致。
• Contact Sheet：像暗房一样把整卷按拍摄顺序印在照片纸上，可选Straight Proof模式——用 Roll Analysis 基准统一曝光整卷，薄负片和厚负片都能正常出片，非常适合"出片前质检"。
• 批量导出时可勾选Save on Export写入.negpysidecar，编辑数据随文件走。

导出、文件名模板的细节见 docs/USER_GUIDE.md 第 13 节与 docs/TEMPLATING.md。

6. 推荐的工作流清单 ✅

1. 导入整卷 → 先Auto-crop all frames统一裁切；
2. Keep / Reject 挑片，用 Sheet filter 只看 Keepers；
3. 挑一张基准帧精修 →Use This Frame或Reanalyze建立全卷色彩基准；
4. Apply (clone)把精修设置推给整卷；
5. Contact Sheet 或Straight Proof质检一遍；
6. 批量导出全部可见帧。

整个过程不修改任何源文件：编辑保存在本地数据库中，源扫描文件始终原封不动。更多面板细节可在应用内点击各面板头部的 ⓘ 查看对应章节。