XHS-Downloader

XHS-Downloader由开发者JoeanAmier维护，代码托管在GitHub上，采用GPLv3.0开源协议。它的定位很明确：帮你把小红书上的作品链接变成本地文件。和小红书官方保存功能不同，它下载的是无水印版本，图文可以自选PNG、WEBP、JPEG、HEIC格式，视频默认选分辨率。程序会记录已下载的作品ID，下次碰到同一个作品自动跳过，不用手动查重。整个项目从2023年8月开始公开，到现在已经迭代到2.8版本，功能相对成熟。

官网入口地址

https://github.com/JoeanAmier/XHS-Downloader

下载地址

程序的下载地址在GitHub的Releases页面。你提供的链接指向的是DiffSynth-Studio的仓库，和XHS-Downloader不是同一个项目，应该是信息有误。正确的获取方式是在XHS-Downloader的GitHub页面右侧点击Releases，下载对应系统的压缩包。Windows和macOS用户下载后解压，双击main就能运行。也可以用Docker拉取joeanamier/xhs-downloader镜像，或者克隆源码用Python跑。

功能介绍

作品信息采集与下载地址提取：输入作品链接后，程序会抓取标题、描述、作者、点赞收藏数等信息，同时把图文和视频的原始下载地址提取出来。

无水印下载：下载的图文和视频不带小红书的水印，适合需要干净素材的场景。

自动跳过已下载作品：下载过的作品ID会存进数据库，重复下载同一个作品时程序直接跳过，省去手动筛选的麻烦。

批量下载：支持单次输入多个链接，用空格隔开就行。配合浏览器脚本还能批量提取账号发布、收藏、点赞、专辑里的作品链接，再交给程序统一下载。

文件完整性处理与断点续传：下载过程中有完整性校验机制，支持断点续传，大文件下载中断后不用从头再来。

自定义文件命名与格式：文件名格式可以用作品标题、作者昵称、发布时间、点赞数等字段自由组合。图文格式可选AUTO、PNG、WEBP、JPEG、HEIC。

剪贴板监听：开启后程序在后台盯着剪贴板，复制小红书链接就自动开始下载，适合连续采集的场景。

视频封面与livePhoto下载：视频作品的封面图可以单独下载，图文里的livePhoto动图也能存下来。

持久化存储与API调用：作品信息可以存进SQLite数据库，方便后续查询。程序还提供API模式和MCP模式，方便开发者做二次开发或接入AI助手。

浏览器脚本：配合Tampermonkey使用用户脚本，不装程序也能在浏览器里直接下载作品，或者把链接推送给后台运行的程序。

应用场景

内容创作者整理素材：做小红书相关内容时，需要把竞品或参考账号的图文视频存下来研究，XHS-Downloader的批量提取和去重功能能省不少时间。

数据分析人员采集样本：研究小红书内容生态时，需要一定量的作品数据做分析。程序可以把作品信息和文件一起存下来，存进数据库方便后续处理。

营销人员做竞品存档：跟踪某个品牌或账号的发布内容，定期把新作品下载归档，避免对方删帖后找不到原始素材。

个人收藏备份：自己账号发布的作品想留个本地备份，或者收藏夹里的内容怕哪天失效，用脚本提取链接后批量下载就行。

使用方法

程序运行（推荐给普通用户）：去GitHubReleases下载对应系统的压缩包，解压后双击main。Windows和macOS10以上都能用。macOS首次运行被系统拦截，需要在终端执行xattr-cr项目文件夹路径移除安全标记。默认下载路径是程序目录下的Volume/Download。

源码运行（适合开发者）：装好Python3.12以上版本，克隆源码，用pip或uv安装依赖，运行pythonmain.py启动。想用图形界面就正常启动，想用命令行界面运行pythonmain.pyTUI。

Docker运行（适合隔离环境）：拉取镜像后创建容器，TUI模式、API模式、MCP模式都有对应的启动命令。注意Docker模式下不支持剪贴板监听和命令行调用。

浏览器脚本：在Tampermonkey里添加用户脚本，访问小红书作品页面时通过脚本菜单下载，或者把任务推送给后台运行的程序。脚本的自动滚动功能默认关闭，开启后被平台判定为自动化操作，需要自己权衡。

配置Cookie（可选）：不配Cookie也能用，但视频只能下到低分辨率。想要高画质的话，在浏览器开发者工具的网络选项卡里复制Cookie，填进程序的settings.json或界面里。不需要登录账号也能获取。

服务支持

定价：免费开源，没有付费版本，作者也明确表示不会提供任何商业服务。代码遵循GPLv3.0协议，可以自由查看和修改。

语言支持：程序界面目前支持简体中文和英文两种语言，在配置文件里设置language参数切换。

技术支持：作者提供了邮箱yonglelolu@foxmail.com、微信Downloader_Tools、QQ群和Discord社区作为反馈渠道。QQ群只讨论使用问题，不允许发广告或讨论账号交易之类的内容。

使用限制：工具依赖小红书网页端的数据接口，平台改版后需要等作者更新适配。作品链接带日期信息，用旧链接被风控，建议下载时用获取的链接。程序内置了请求延时机制，避免频繁请求影响平台服务器。

免责提醒：作者在免责声明里写得很清楚，使用风险由使用者自行承担，不得用工具侵犯知识产权。下载的内容建议仅用于个人学习研究，商业用途需要获得原作者授权。