diff --git a/.github/workflows/docker-image.yml b/.github/workflows/docker-image.yml
index 8928912..3f648ad 100644
--- a/.github/workflows/docker-image.yml
+++ b/.github/workflows/docker-image.yml
@@ -3,7 +3,7 @@ name: Build and Push Docker Image
on:
release:
types: [published]
- workflow_dispatch: # 允许手动触发工作流
+ workflow_dispatch:
jobs:
publish-docker:
diff --git a/.github/workflows/executable_build.yml b/.github/workflows/executable_build.yml
index 20b0f62..457d24c 100644
--- a/.github/workflows/executable_build.yml
+++ b/.github/workflows/executable_build.yml
@@ -9,7 +9,7 @@ jobs:
runs-on: ${{ matrix.os }}
strategy:
matrix:
- os: [ubuntu-latest, macos-latest, windows-latest]
+ os: [macos-latest, windows-latest]
python-version: [3.12]
steps:
@@ -28,12 +28,15 @@ jobs:
pip install pyinstaller
- name: 构建可执行文件
+ if: runner.os == 'Windows'
run: |
- if [ "$RUNNER_OS" = "Windows" ]; then
- pyinstaller --icon=./static/XHS-Downloader.ico --add-data "static;static" --add-data "locale;locale" .\main.py
- else
- pyinstaller --icon=./static/XHS-Downloader.ico --add-data "static:static" --add-data "locale:locale" main.py
- fi
+ pyinstaller --icon=./static/XHS-Downloader.ico --add-data "static;static" --add-data "locale;locale" .\main.py
+ shell: pwsh
+
+ - name: Build executable on macOS
+ if: runner.os == 'macOS'
+ run: |
+ pyinstaller --icon=./static/XHS-Downloader.ico --add-data "static:static" --add-data "locale:locale" main.py
- name: 上传文件
uses: actions/upload-artifact@v4
diff --git a/README.md b/README.md
index cc6babc..ea9439f 100644
--- a/README.md
+++ b/README.md
@@ -30,6 +30,7 @@
✅ 从浏览器读取 Cookie
✅ 自定义文件名称格式
✅ 支持 API 调用功能
+✅ 支持文件断点续传下载
脚本功能
- ✅ 下载小红书无水印作品文件
@@ -62,7 +63,7 @@
如果仅需下载无水印作品文件，建议选择 程序运行 或 Docker 运行；如果有其他需求，建议选择 源码运行！
建议自行设置 cookie 参数，若不设置该参数，程序功能可能无法正常使用！
🖱 程序运行
-Windows 10 及以上用户可前往 Releases 下载程序压缩包，解压后打开程序文件夹，双击运行 main.exe 即可使用。
+Mac OS(尚未测试)、Windows 10 及以上用户可前往 Releases 下载程序压缩包，解压后打开程序文件夹，双击运行 main 即可使用。
若通过此方式使用程序，文件默认下载路径为：.\_internal\Download；配置文件路径为：.\_internal\settings.json
⌨️ Docker 运行
@@ -81,8 +82,9 @@
⌨️ 源码运行
- 安装版本号不低于
3.12 的 Python 解释器
-- 运行
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt 命令安装程序所需模块
- 下载本项目最新的源码或 Releases 发布的源码至本地
+- 打开终端，切换至项目根路径
+- 运行
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt 命令安装程序所需模块
- 运行
main.py 即可使用
🛠 命令行模式
@@ -185,8 +187,8 @@ async def example():
record_data = False # 是否保存作品数据至文件
image_format = "WEBP" # 图文作品文件下载格式，支持：PNG、WEBP
folder_mode = False # 是否将每个作品的文件储存至单独的文件夹
- async with XHS() as xhs:
- pass # 使用默认参数
+ # async with XHS() as xhs:
+ # pass # 使用默认参数
async with XHS(work_path=work_path,
folder_name=folder_name,
name_format=name_format,
diff --git a/README_EN.md b/README_EN.md
index 4d9dade..aad8d42 100644
--- a/README_EN.md
+++ b/README_EN.md
@@ -31,6 +31,7 @@
- ✅ Read cookies from browser
- ✅ Customizable file name format
- ✅ Support API call functionality
+- ✅ Support file breakpoint resume download
Script Features
- ✅ Download Xiaohongshu watermark-free content files
@@ -63,7 +64,7 @@
If you only need to download watermark-free content files, it is recommended to choose Program Run; if you have other needs, it is recommended to choose Source Code Run!
It is recommended to set the cookie parameter manually; if this parameter is not set, the program functions may not work properly!
🖱 Program Run
-Windows 10 and above users can go to Releases to download the program package, unzip it, open the program folder, and double-click to run main.exe to use.
+Mac OS, Windows 10 and above users can go to Releases to download the program package, unzip it, open the program folder, and double-click to run main to use.
If you use the program in this way, the default download path for files is: .\_internal\Download; the configuration file path is: .\_internal\settings.json
⌨️ Docker Run
@@ -82,8 +83,9 @@
⌨️ Source Code Run
- Install the Python interpreter with a version no lower than
3.12
-- Run the command
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt to install the required modules
- Download the latest source code of this project or the source code released in Releases to your local machine
+- Open the terminal and switch to the root path of the project
+- Run the command
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt to install the required modules
- Run
main.py to use
🛠 Command Line Mode
@@ -189,8 +191,8 @@ async def example():
record_data = False # 是否保存作品数据至文件
image_format = "WEBP" # 图文作品文件下载格式，支持：PNG、WEBP
folder_mode = False # 是否将每个作品的文件储存至单独的文件夹
- async with XHS() as xhs:
- pass # 使用默认参数
+ # async with XHS() as xhs:
+ # pass # 使用默认参数
async with XHS(work_path=work_path,
folder_name=folder_name,
name_format=name_format,