告别混乱命名！E-Hentai-Downloader文件名自定义完全指南

你是否还在为下载的漫画文件夹名称混乱而烦恼？是否希望根据自己的习惯组织收藏的图片集？E-Hentai-Downloader（EHD）提供了强大的文件名自定义功能，让你彻底告别杂乱无章的文件管理。本文将深入解析这一功能的实现原理、使用方法和高级技巧，帮助你打造个性化的文件命名方案。

一、文件名自定义的核心价值

在数字收藏管理中，文件名是组织体系的基石。E-Hentai-Downloader的文件名自定义功能解决了三大核心痛点：

对于重度用户而言，合理的命名规则能使收藏管理效率提升数倍。例如通过{category}/{uploader}/{title}模板可自动构建三级分类体系，配合文件管理器的搜索功能实现秒级定位。

二、模板变量系统详解

EHD内置了强大的模板变量引擎，支持在文件名中嵌入多种动态信息。这些变量会在下载时被自动替换为实际内容，实现命名的自动化和个性化。

2.1 基础变量列表

代码示例：基础模板应用

// 模板字符串 const template = "{category} - {title} ({gid})"; // 实际生成的文件名 const fileName = "Doujinshi - Magical Girl Adventures (1234567)";

2.2 高级变量功能

EHD还提供了变量修饰符，可对原始值进行格式化处理：

• 大小写转换：{title:upper}将标题转为全大写
• 长度限制：{title:20}截取标题前20个字符
• 日期格式化：{posted:yyyyMMdd}按指定格式显示发布日期

这些修饰符可组合使用，例如{title:upper:30}表示将标题转为大写并限制30字符长度。

三、命名规则实现原理

EHD的文件名自定义功能通过getReplacedName函数实现，位于src/main.js中。该函数采用"模板解析-变量替换-安全过滤"的三步处理流程：

核心代码解析：

// 文件名模板替换核心函数 function getReplacedName(str) { return replaceHTMLEntites(str .replace(/\{gid\}/gi, unsafeWindow.gid) .replace(/\{token\}/gi, unsafeWindow.token) .replace(/\{title\}/gi, getSafeName(document.getElementById('gn').textContent)) .replace(/\{subtitle\}/gi, document.getElementById('gj').textContent || getSafeName(document.getElementById('gn').textContent)) .replace(/\{tag\}|\{category\}/gi, document.querySelector('#gdc .cs').textContent.trim().toUpperCase()) .replace(/\{uploader\}/gi, getSafeName(document.querySelector('#gdn').textContent))); } // 特殊字符处理函数 function getSafeName(str, ignoreSlash) { var replaceList = { ':': '：', '"': '＂', '*': '＊', '?': '？', '|': '｜', '<': '＜', '>': '＞', '/': '／', '\\': '＼', '~': '～', '\n': '-' }; return str.trim().replace(ehDownloadRegex.dangerChars, function(match) { if (ignoreSlash && (match === '/' || match === '\\')) return match; return setting['replace-with-full-width'] ? replaceList[match] : '-'; }); }

四、实战配置指南

4.1 基础配置步骤

1. 打开E-Hentai-Downloader设置面板
2. 切换到"高级设置"标签页
3. 在"文件名模板"输入框中输入自定义模板
4. 勾选"全角字符替换"（可选）
5. 点击"保存设置"应用更改

4.2 推荐模板方案

根据不同使用场景，我们推荐以下几种模板方案：

收藏管理型

[{category}] {title} ({uploader}) - {gid}

适用于需要按分类和作者整理的漫画收藏，示例结果：[Doujinshi] Magical Girl Adventures (ArtistName) - 1234567

简洁实用型

{title} - {gid}

适用于追求简洁文件名的用户，示例结果：Magical Girl Adventures - 1234567

高级分类型

{category}/{uploader}/{title}/{gid}_{page}

适用于需要深度分类的重度用户，会生成多级目录结构。

4.3 常见问题解决

Q: 文件名中出现乱码怎么办？
A: 确保勾选"全角字符替换"选项，或使用{title:20}限制长度避免编码问题

Q: 如何添加固定前缀/后缀？
A: 直接在模板中添加静态文本，如[EHD]{title}或{title}-2023

Q: 能否根据图片尺寸命名？
A: 可以使用{width}x{height}变量，如{title}_{width}x{height}.jpg

五、高级技巧与最佳实践

5.1 配合批量重命名工具

对于已下载的文件，可使用正则表达式批量调整：

# 正则表达式示例：提取GID 查找: .*\((\d+)\).* 替换: [$1]_$0

5.2 变量组合高级应用

通过变量组合实现复杂命名逻辑：

# 按上传日期和分类双重排序 {posted:yyyyMMdd}_{category}_{title}_{gid}

5.3 避免命名冲突的策略

1. 始终包含{gid}确保唯一性
2. 对系列作品使用{subtitle}区分卷册
3. 批量下载时启用{page}页码变量

六、功能演进与未来展望

E-Hentai-Downloader的文件名自定义功能已从最初的简单替换发展为强大的模板系统。根据开发计划，未来版本将加入：

• 自定义变量支持（允许用户添加自定义元数据）
• 条件判断模板（如{if:category=Doujinshi}同人{else}漫画{endif}）
• 文件名历史记录与版本管理
• 云端模板同步功能

通过持续优化命名系统，EHD致力于为用户提供更高效、更个性化的文件管理体验。

七、总结与资源推荐

文件名自定义功能是E-Hentai-Downloader提高用户体验的核心特性之一，通过灵活的模板系统和强大的变量引擎，让每个用户都能打造符合个人习惯的文件组织方案。

扩展资源：

• 官方文档：E-Hentai-Downloader Wiki
• 模板分享社区：EHD用户论坛"自定义模板"板块
• 正则表达式测试工具：Regex101（支持JavaScript语法）

掌握文件名自定义技巧，让你的数字收藏从此井井有条！如有任何问题或创意方案，欢迎在项目GitHub仓库提交issue或PR。

提示：本文档基于E-Hentai-Downloader v1.20.0版本编写，部分功能可能随版本更新有所变化。建议定期查看官方更新日志获取最新信息。

如果你觉得本文对你有帮助，请点赞、收藏并关注项目更新！下期我们将带来"高级搜索技巧"专题。