From fcb58e3c44a9d93935a4a777a739f26e4e6186b1 Mon Sep 17 00:00:00 2001 From: Quan Date: Sat, 31 Jan 2026 15:02:07 +0800 Subject: [PATCH] =?UTF-8?q?feat(app):=20=E6=96=B0=E5=A2=9E=E8=A7=86?= =?UTF-8?q?=E9=A2=91=E4=B8=8B=E8=BD=BD=E5=81=8F=E5=A5=BD=E8=AE=BE=E7=BD=AE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes #262 --- README.md | 6 ++ README_EN.md | 128 +++++++++++++++++++----------------- source/CLI/main.py | 5 ++ source/TUI/setting.py | 13 +++- source/application/app.py | 3 + source/application/video.py | 4 +- source/module/manager.py | 8 +++ source/module/settings.py | 1 + uv.lock | 4 +- 9 files changed, 106 insertions(+), 66 deletions(-) diff --git a/README.md b/README.md index 14b45d4..00b6169 100644 --- a/README.md +++ b/README.md @@ -458,6 +458,12 @@ async def example(): false +video_preference +str +视频作品文件下载偏好；含义：resolution：分辨率优先；bitrate：码率优先；size：文件大小优先 +resolution + + folder_mode bool 是否将每个作品的文件储存至单独的文件夹；文件夹名称与文件名称保持一致 diff --git a/README_EN.md b/README_EN.md index ef235c3..cbde0fa 100644 --- a/README_EN.md +++ b/README_EN.md @@ -17,42 +17,42 @@ GitHub all releases
-

🔥 RedNote Link Extraction/Content Collection Tool：Extract account-published, favorites, and liked works links; extract search result works links and user links; collect RedNote works information; extract RedNote works download addresses; download RedNote watermark-free works files!

+

🔥 RedNote Link Extraction/Content Collection Tool：Extract account-published, favorites, and liked notes links; extract search result notes links and user links; collect RedNote notes information; extract RedNote notes download addresses; download RedNote watermark-free notes files!

🔥 "RedNote", "XiaoHongShu" and "小红书" have the same meaning, and this project is collectively referred to as "RedNote".

⭐ Due to the author's limited energy, I was unable to update the English document in a timely manner, and the content may have become outdated, partial translation is machine translation, the translation result may be incorrect, Suggest referring to Chinese documentation. If you want to contribute to translation, we warmly welcome you.

📑 Project Features

Program Features and User Script Features (Click to Expand)
@@ -65,17 +65,17 @@

🔗 Supported Links

🪟 About the Terminal

⭐ It is recommended to use the Windows Terminal (default terminal for Windows 11) to run the program for the best display effect!

🥣 Usage

-

If you only need to download watermark-free works files, it is recommended to choose Program Run; if you have other needs, it is recommended to choose Source Code Run!

+

If you only need to download watermark-free notes files, it is recommended to choose Program Run; if you have other needs, it is recommended to choose Source Code Run!

Starting from version 2.2, if there are no abnormalities in project functionality, there is no need to handle cookies separately!

🖱 Program Run

⭐ Mac OS, Windows 10 and above users can go to Releases or Actions to download the program package, unzip it, open the program folder, and double-click to run main to use.

@@ -124,10 +124,10 @@ -

When running the project via Docker, the command line call mode is not supported. The clipboard reading and clipboard monitoring functions are unavailable, but pasting content works fine. Please provide feedback if other features are not functioning properly!

+

When running the project via Docker, the command line call mode is not supported. The clipboard reading and clipboard monitoring functions are unavailable, but pasting content notes fine. Please provide feedback if other features are not functioning properly!

🛠 Command Line Mode

-

The project supports command line mode. If you want to download specific images from a text and image works, you can use this mode to set the image sequence number you want to download!

-

Note: When the --index parameter is not set, multiple works links can be passed in. All links must be enclosed in quotation marks and separated by spaces. When the --index parameter is set, multiple works links are not supported. Even if multiple links are passed in, the program will only process the first link!

+

The project supports command line mode. If you want to download specific images from a text and image notes, you can use this mode to set the image sequence number you want to download!

+

Note: When the --index parameter is not set, multiple notes links can be passed in. All links must be enclosed in quotation marks and separated by spaces. When the --index parameter is set, multiple notes links are not supported. Even if multiple links are passed in, the program will only process the first link!

The bool type parameters support setting with true, false, 1, 0, yes, no, on or off (case insensitive).

Read Browser Cookies

This feature is no longer available. Please refer to the Obtain Cookie tutorial!

@@ -164,19 +164,19 @@ url str -RedNote works link, auto-extraction, does not support multiple links; Required parameter +RedNote notes link, auto-extraction, does not support multiple links; Required parameter None download bool -Whether to download the works file; set to true will take more time; Optional parameter +Whether to download the notes file; set to true will take more time; Optional parameter false index list[int] -Download specific image files by index, only effective for text and image works; not effective when the download parameter is set to false; Optional parameter +Download specific image files by index, only effective for text and image notes; not effective when the download parameter is set to false; Optional parameter null @@ -194,7 +194,7 @@ skip bool -Whether to skip works with download records; set to true will not return works data with download records; Optional parameter +Whether to skip notes with download records; set to true will not return notes data with download records; Optional parameter false @@ -229,10 +229,10 @@ async def example_api():

MCP Invocation Example

MCP Function and Call Example (Click to Expand) -

Retrieve RedNote Works Information

+

Retrieve RedNote Notes Information

MCP Data Retrieval
-

Download RedNote Works Files

+

Download RedNote Notes Files

When downloading images, you can specify the sequence numbers of the images to download. By default, post information is not returned. If you need the post information, please explicitly state so during the conversation.

MCP File Download
@@ -240,9 +240,9 @@ async def example_api():

📜 Others

@@ -261,7 +261,7 @@ async def example_api():
-

Note: Using the XHS-Downloader user script to batch extract works links, in combination with the XHS-Downloader program, can achieve batch downloading of watermark-free works files!

+

Note: Using the XHS-Downloader user script to batch extract notes links, in combination with the XHS-Downloader program, can achieve batch downloading of watermark-free notes files!

Modify user script language

切换语言

🌐 Connect to Server

@@ -274,12 +274,12 @@ async def example_api():

📜 Script Instructions