🥣 使用方法

如果仅需下载作品文件，选择直接运行或者源码运行均可，如果需要获取作品信息，则需要进行二次开发进行调用。

🖱 直接运行
前往 Releases 下载程序压缩包，解压后打开程序文件夹，双击运行 main.exe 即可使用。

⌨️ 源码运行

安装版本号不低于 3.10 的 Python 解释器
安装 requirements.txt 包含的第三方模块
下载本项目最新的源码或 Releases 发布的源码至本地
运行 main.py 即可使用
💻 二次开发
如果想要获取小红书图文/视频作品信息，可以根据 main.py 的注释提示进行代码调用。

#测试链接
error_demo = “https://github.com/JoeanAmier/XHS_Downloader"
image_demo = “https://www.xiaohongshu.com/explore/63b275a30000000019020185"
video_demo = “https://www.xiaohongshu.com/explore/64edb460000000001f03cadc"
#实例对象

path = ""  # 作品下载储存根路径，默认值：当前路径
folder = "Download"  # 作品下载文件夹名称（自动创建），默认值：Download
cookie = ""  # 小红书网页版 Cookie
proxies = None  # 网络代理
timeout = 5  # 网络请求超时限制，默认值：10
chunk = 1024 * 1024  # 下载文件时，每次从服务器获取的数据块大小，单位字节
xhs = XHS(
    path=path,
    folder=folder,
    cookie=cookie,
    proxies=proxies,
    timeout=timeout,
    chunk=chunk, )  # 使用自定义参数
# xhs = XHS()  # 使用默认参数
download = True  # 是否下载作品文件
# 返回作品详细信息，包括下载地址
print(xhs.extract(error_demo))  # 获取数据失败时返回空字典
print(xhs.extract(image_demo, download=download))
print(xhs.extract(video_demo, download=download))

⛓ 批量下载

在程序所在文件夹创建一个 xhs.txt 文本文件，然后将待处理的作品链接输入文件，每行输入一个作品链接，编辑完成后保存文件，然后运行程序，点击读取 xhs.txt 文件并批量下载作品按钮，程序会批量下载每个链接对应的作品文件。

⚙️ 配置文件

根目录下的 settings.json 文件，可以自定义部分运行参数。

参数类型含义默认值
path str 作品文件储存根路径项目根路径
folder str 作品文件储存文件夹名称 Download
cookie str 小红书网页版 Cookie，无需登录；建议自行设置内置 Cookie
proxies str 设置代理无
timeout int 请求数据超时限制，单位：秒 10
chunk int 下载文件时，每次从服务器获取的数据块大小，单位：字节 262144(256KB)

打开浏览器（可选无痕模式启动），访问小红书任意网页
按 F12 打开开发人员工具
选择控制台选项卡
输入 document.cookie 后回车确认
输出内容即为所需 Cookie