XHS-Downloader14 个命名变量 断点续传让批量下载的文件自己排好队【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader凌晨三点你刚批量下完 50 个小红书作品打开下载文件夹download(12).mp4、Screenshot 2025-06-19.jpg分不清哪个文件来自哪个作者。手动重命名到一半浏览器卡死还得从头再来。XHS-Downloader 的自定义命名、按作者归档批量下载和断点续传一次解决这三个问题。能力点一句话说明适用场景自定义文件命名从发布时间、作者昵称、作品标题、作品ID 等 14 个变量里自由组合按发布时间或作者检索文件按作者归档自动为每位作者创建独立文件夹长期追更固定作者按序号选图一篇图文 8 张图只下第 2、4 张只收藏特定封面断点续传中断后从 Temp 缓存继续写入不重头下载弱网环境、大视频魔数识别后缀读文件头判断真实格式扩展名自动修正下载文件打不开时核心配置详解所有配置集中在Volume/settings.json程序首次运行自动生成改完点保存或直接重启生效。也可以打开 TUI 按S键在界面里改命名变量与默认格式改什么settings.json里的name_format。怎么改name_format: 作者昵称 发布时间 作品标题默认值是发布时间 作者昵称 作品标题各变量用空格分隔生成文件名时统一转成下划线连接。支持的变量按用途分三类变量类别可用变量典型用法时间类发布时间、最后更新时间按下载顺序检索作者类作者昵称、作者ID按作者归类作品类作品标题、作品ID、作品描述、作品标签、作品类型按内容检索数据类点赞数量、收藏数量、评论数量、分享数量按热度筛选改完效果2026-08-10_12.27.54_May_钓系小猫_2.mp4。三条内置规则标题为空时自动回退用作品ID 填充作品标题超过 64 字符自动截断文件名总长上限 128 字符。作者归档与文件夹模式改什么settings.json里的author_archive和folder_mode。两个开关都默认关闭开启后目录结构自动变化Download/ ├── May_钓系小猫/ │ ├── 2026-08-10_12.27.54_May_钓系小猫_2.mp4 │ └── 2026-08-10_12.27.54_May_钓系小猫_4.png └── 旅行博主阿凯/ └── 2026-08-11_09.02.11_海岛徒步路线_1.pngfolder_mode则把每篇作品的文件放进以作品名命名的子文件夹适合图文作品图很多、想和作品信息文件放在一起的情况。作品类型开关与图文格式改什么image_download、video_download、live_download三个开关和image_format。图文默认输出 JPEG可选值image_format输出格式说明auto跟随源文件源文件什么格式就下什么png / webp / jpeg指定格式按值输出heic / avif高压缩格式手机存储、体积敏感场景live_download默认关闭动态图片GIF 类需要手动开启。另外无论扩展名写成什么程序都会读取文件头魔数确认真实格式识别结果直接决定最终后缀对应源码在 source/application/download.py。实战工作流批量下载只保留指定图片一篇 8 图的作品只想留第 2 和第 4 张。TUI 主页粘贴作品链接多个链接用空格分隔。输入下载序号例如2 4仅对图文/图集作品生效。按回车开始其余 6 张自动跳过。已存在的文件显示文件已存在跳过下载不重复占空间。预期结果文件夹里只多出_2和_4结尾的两个文件。按作者建立归档库长期追更 3 个作者想一人一个文件夹。settings.json里把author_archive改为true。粘贴作品链接支持一次粘贴多个链接空格分隔。按R随时查看已记录的作品重复链接不会二次下载。退出程序后空文件夹自动清理。预期结果Download/下按作者昵称分目录重名作者用作者ID 区分。命令行临时覆盖配置不改配置文件一次性换个命名规则批量下载。安装依赖后执行git clone https://link.gitcode.com/i/2c7607aaae1d3750f3b3f5ab1de24671后uv run main.py。用-u传链接、-nf传命名格式-u 链接1 链接2 -nf 作者昵称 作品标题。用-aa临时开启作者归档-i 2 4选图。完整参数表随时-h查看。预期结果本次任务用新规则命名settings.json保持原样。性能与效率调优参数默认值建议值适用场景chunk2 MB4 MB大视频文件、千兆宽带max_retry510网络波动频繁的晚高峰timeout10 秒20 秒弱网、跨地区访问并发数 MAX_WORKERS44不建议改批量任务稳定推进并发上限写死在 source/module/static.py 的MAX_WORKERS由信号量控制改配置无效批量大任务时耐心排队比改代码更稳。chunk调大只影响内存占用和吞吐不改变总耗时别为更快盲目加到 16 MB。timeout和max_retry建议成对调整超时拉长后重试次数可保持默认避免单次失败卡太久。排障与边界现象重跑同一批链接全部显示跳过下载。原因同名文件已存在于目标目录程序按名判重。解法确认name_format足够唯一加作品ID最稳或删掉旧文件后重跑。现象name_format填了自定义格式文件名却还是默认样式。原因包含未识别的变量词整个格式回退为默认值。解法变量只能从上表 14 个里选用发布时间 作者昵称 作品ID这类组合测试确认无误再叠加。现象文件名中间出现连续下划线或末尾带_。原因作品标题里的#、空格等特殊字符被清洗成_空值拼接后残留。解法程序会合并连续下划线并去掉首尾_属正常现象介意的话把发布时间放格式最前肉眼定位更快。现象程序启动时提示代理测试超时任务无法开始。原因proxy配置的地址当前不可达启动自检未通过。解法先把proxy改回null跑通下载再单独验证代理地址公司内网代理需填完整http://host:port。延伸方向想给作品额外生成信息文件txt/md看 source/module/note_info.py 的note_format实现。想在文件名之外做二级分类参考 source/expansion/file_folder.py 的目录生成逻辑。命名规则本体在 source/application/app.py 的__naming_rules改动前先看 128 字符截断逻辑。项目源码XHS-Downloader【免费下载链接】XHS-Downloader小红书XiaoHongShu、RedNote链接提取/作品采集工具提取账号发布、收藏、点赞、专辑作品链接提取搜索结果作品、用户链接采集小红书作品信息提取小红书作品下载地址下载小红书作品文件项目地址: https://gitcode.com/gh_mirrors/xh/XHS-Downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考