SingleFile插件文件名命名规则变更解析

背景概述

SingleFile作为一款流行的网页保存工具，近期在文件名命名规则上进行了重要变更。最新版本中，时间戳的分隔符从下划线"_"变更为全角冒号"："（Unicode 0xFF1A），这一改动影响了使用{datetime-iso}变量的用户。

技术细节分析

命名规则变更

原版本使用标准ASCII字符作为分隔符：

2024-11-20T15_43_56.919Z

新版本改用全角Unicode字符：

2024-11-20T15：43：56.919Z

影响范围

这一变更主要影响：

1. 使用{datetime-iso}变量的模板
2. 依赖严格文件名匹配的系统
3. 跨平台文件共享场景

解决方案

官方推荐方案

在1.2.74版本中，用户可通过修改配置实现字符替换：

"filenameReplacementCharacters": ["_", "_", "_", "_", "_", "_", "_", "_", "_", "_", "_"]

模板级解决方案

用户可在命名模板中使用替换函数保持旧格式：

%replace<{datetime-iso}|:|_>--%if-empty<{url-last-segment}|no-title>.{filename-extension}

技术建议

1. 兼容性考虑：全角字符在某些旧系统或文件系统中可能存在兼容性问题
2. 一致性维护：建议团队项目统一命名规则配置
3. 文档更新：用户需注意官方文档可能尚未同步更新此变更

最佳实践

对于需要严格兼容性的用户，建议：

1. 明确指定替换规则
2. 在团队内部标准化命名配置
3. 测试生成的文件名在各目标平台的表现

此变更体现了SingleFile对国际化支持的改进，但同时也提醒用户在升级时需要注意此类细微但重要的变化。