PicList SFTP插件日期占位符转义问题分析与解决方案

问题背景

在PicList 2.9.3版本中，用户在使用内置SFTP插件时发现日期占位符未能正确转义。具体表现为：当用户在SFTP配置中设置了包含{year}、{month}等日期占位符的上传路径时，这些占位符未被解析为实际的日期值，而是直接作为字符串创建了目录结构。

问题现象

用户配置了如下的SFTP上传路径：

/web/fss/{year}/{month}/{fullName}

期望得到类似/web/fss/2024/08/example.jpg的实际路径，但实际创建了包含字面量占位符的目录结构：

/web/fss/{year}/{month}/example.jpg

技术分析

1. 占位符处理机制：

   • PicList支持多种占位符用于动态生成文件名和路径
   • 日期相关占位符包括{year}, {month}, {day}等
   • 这些占位符应在文件上传时被实时替换为当前日期值

2. 配置位置误区：

   • 用户误将路径配置直接放在SFTP插件的"uploadPath"设置中
   • 实际上PicList的占位符替换功能应在"高级重命名"设置中配置

3. 功能设计原理：

   • PicList的路径处理分为两个阶段：
     1. 文件名生成阶段（使用高级重命名）
     2. 路径组合阶段（使用各存储插件的路径配置）
   • 日期占位符应在第一阶段处理

正确配置方法

1. 启用高级重命名：

   • 进入PicList设置界面
   • 找到"高级重命名"选项（通常位于设置底部）
   • 启用自动重命名功能

2. 配置命名规则：

   • 使用{year}/{month}/{fullName}格式
   • 可结合其他占位符如{md5}, {timestamp}等

3. SFTP路径配置：

   • 在SFTP插件设置中，"uploadPath"应设置为目标基础路径
   • 例如：/web/fss/

4. 完整路径生成：

   • 系统会自动将高级重命名生成的路径与SFTP基础路径组合
   • 最终路径示例：/web/fss/2024/08/example.jpg

最佳实践建议

1. 对于日期分类存储：

   • 推荐命名规则：{year}/{month}/{fileName}.{extName}
   • 可添加{hour}-{minute}-{second}实现更细粒度分类

2. 避免文件名冲突：

   • 结合时间戳：{year}/{month}/{timestamp}.{extName}
   • 或使用哈希值：{year}/{month}/{md5}.{extName}

3. 测试验证：

   • 先使用测试文件验证路径生成效果
   • 检查服务器端实际创建的目录结构

总结

PicList的路径处理采用了模块化设计，日期占位符的正确使用需要注意配置位置。通过理解系统的工作原理和正确使用高级重命名功能，用户可以灵活实现各种复杂的文件存储组织结构。这一设计既保持了各存储插件的独立性，又通过统一的命名规则提供了强大的自定义能力。

对于需要按日期分类存储的场景，建议用户充分利用PicList提供的各种时间相关占位符，结合高级重命名功能，可以轻松实现自动化、规范化的文件存储管理。