KayTool项目中CustomSaveImage节点的文件名变量支持详解

KayTool项目中CustomSaveImage节点的文件名变量支持详解

在KayTool项目的图像处理流程中，CustomSaveImage节点是一个功能强大的图像保存组件。最新版本中，该节点增加了对动态变量的支持，使得用户能够更加灵活地自定义输出文件的命名规则。本文将详细介绍这些变量的使用方法和应用场景。

日期时间变量

CustomSaveImage节点支持使用标准的日期时间格式化字符串来生成包含时间戳的文件名：

• %date:yyyy-MM-dd% 会输出当前日期，例如"2023-10-05"
• %time:HH-mm-ss% 会输出当前时间，例如"14-30-45"

这些变量特别适合需要按时间归档生成结果的场景，用户可以轻松创建如"生成结果_2023-10-05_14-30-45.png"这样的文件名。

KSampler参数变量

对于使用KSampler节点的用户，现在可以直接在文件名中引用采样参数：

• %KSampler.seed% - 当前采样使用的随机种子值
• %KSampler.steps% - 采样步数设置
• %KSampler.cfg% - CFG(Classifier-Free Guidance)参数值
• %KSampler.sampler_name% - 使用的采样器名称
• %KSampler.scheduler% - 调度器类型
• %KSampler.denoise% - 去噪强度参数

当工作流中包含多个KSampler节点时，系统会自动为变量添加序号后缀(如_1, _2)以区分不同节点的参数。

图像属性变量

除了上述变量外，还可以直接引用图像本身的属性：

• %width% - 图像宽度(像素)
• %height% - 图像高度(像素)

这些变量对于需要记录生成图像分辨率的场景特别有用。

使用注意事项

1. 变量名大小写敏感：所有变量名必须严格按照指定的大小写格式输入，例如%KSampler.seed%不能写成%ksampler.seed%

2. 多节点环境：当工作流中包含多个同类节点时，系统会自动添加序号区分，用户无需手动处理

3. 路径组合：变量可以与其他固定文本组合使用，例如：

   /output/生成结果_%date:yyyy-MM-dd%_%KSampler.seed%.png
   

4. 日期格式灵活：日期格式可以根据需要调整，如%date:yyMMdd%会生成更简洁的日期格式

通过合理使用这些变量，用户可以创建出既包含关键参数信息又便于管理的文件名体系，大大提升了生成结果的组织效率和可追溯性。