darktable模块顺序必须严格遵循raw物理管线：rawprepare=0→demosaic=1→colorin=2→exposure=3→contrast=4→haze_removal=5→filmicrgb=6→colorout=7→sharpen=8→denoiseprofile=9，错乱将导致色彩失真、细节丢失或色偏；可通过重置darktablerc索引、lua脚本、cli预设或--debug pixelpipe实时诊断修复。
如果您在darktable中发现调整顺序错乱导致色彩失真、细节丢失或去雾后出现色偏，则可能是由于模块执行顺序不符合RAW处理管线的物理逻辑。以下是优化模块排序的实操步骤：
一、理解darktable默认模块执行顺序
darktable严格遵循RAW图像物理成像链路执行模块，任何手动拖动导致的顺序错误都会破坏数据完整性。原始处理流程固定为：rawprepare → demosaic → colorin → 基础调整（曝光/对比度）→ 高级调整（去雾/Filmic RGB）→ 输出模块（colorout/sharpen/noise reduction）。该顺序由src/develop/pixelpipe.c硬编码保障，不可跳过或颠倒核心环节。
1、rawprepare模块必须位于最前端，负责白平衡系数注入与黑电平校正；
2、demosaic模块紧随其后，执行拜耳阵列解马赛克，若置于colorin之后将导致色彩空间错位；
3、colorin模块必须在所有色彩相关调整（如去雾、Filmic RGB）之前运行，否则透射率计算基于错误色域；
4、去雾模块需位于colorin之后、Filmic RGB之前，因Filmic RGB会压缩动态范围，提前去雾可保留更多雾气区域原始梯度信息；
5、最终锐化与降噪必须置于pipeline末端，避免在高光/阴影重建前引入伪影。
二、强制重置模块顺序至标准管线
当界面中模块被误拖导致顺序异常时，可通过底层配置强制恢复官方推荐顺序。此操作绕过GUI限制，直接写入模块启用状态与索引值。
1、关闭darktable程序，进入用户配置目录：~/.config/darktable/（Linux/macOS）或 %APPDATA%\darktable\（Windows）；
2、备份当前darktablerc文件以防意外；
3、用文本编辑器打开darktablerc，定位到[plugins]节区；
4、查找所有以iop_order_开头的键值对，例如iop_order_colorin=2；
5、将以下标准索引值全部覆盖写入（数字越小优先级越高）：rawprepare=0, demosaic=1, colorin=2, exposure=3, contrast=4, haze_removal=5, filmicrgb=6, colorout=7, sharpen=8, denoiseprofile=9；
6、保存文件并重启darktable，模块列表将按新索引自动重排。
三、使用Lua脚本动态管理模块启用状态
针对不同拍摄场景（如星空摄影需禁用demosaic、建筑摄影需前置lens correction），可通过Lua脚本按需激活/停用模块并锁定顺序，避免手动干预风险。
1、创建脚本文件module_order_control.lua，置于~/.config/darktable/lua/；
2、写入以下核心逻辑：local dt = require"darktable"; dt.register_event("image-loaded", function(img) dt.gui.libs.image.set_module_enabled("haze_removal", true); dt.gui.libs.image.set_module_enabled("filmicrgb", true); end)；
3、在darktablerc中启用该脚本：lua_scripts=module_order_control.lua；
4、重启后，每次加载图像时脚本自动确保去雾与Filmic RGB模块处于启用状态且顺序固定；
5、扩展逻辑可加入EXIF判断：if img.exif.focal_length > 100 then dt.gui.libs.image.set_module_enabled("lens_correction", true) end。
四、通过CLI导出时覆盖模块顺序
在批量导出场景中，CLI可强制指定处理链顺序，完全脱离GUI状态影响，适用于渲染一致性要求极高的输出任务。
1、准备XMP元数据文件standard_order.xmp，其中包含已校准的模块启用标记；
2、执行命令：darktable-cli input.CR2 output.jpg --style "standard_pipeline" --hq true --verbose；
3、确保预设standard_pipeline已在darktable GUI中按标准顺序配置并保存；
4、CLI调用时自动加载该预设的模块启用状态与索引值，忽略当前lighttable中任意手动排序；
5、验证输出日志中是否出现pixelpipe: using iop order from style 'standard_pipeline'确认生效。
五、调试模块顺序冲突的实时检测方法
当怀疑模块顺序引发异常时，无需反复试错，可启用内置诊断模式获取精确执行链快照。
1、启动darktable时添加参数：darktable --debug pixelpipe；
2、在darkroom中加载问题图像，触发一次预览刷新；
3、查看终端输出的完整模块执行序列，格式为：[pixelpipe] module 'colorin' executed at position 2；
4、比对实际位置编号与标准顺序表，定位偏离模块；
5、若发现haze_removal位置编号为1，则说明它被错误前置，需执行方法二重置索引。
