HelpUploadFiles （星空上传助手） 是一款 辅助上传 工具。我们知道，git 提供了 .gitignore 文件用于根据规则忽略某些文件的上传，但是这个功能仅限于 git，还有很多场景涉及文件的上传，比如我们可能需要将某些文件上传到网盘，但是大部分网盘并不具备 根据规则忽略指定文件 的功能，这十分不方便。另外，还存在着许许多多的上传文件的场景，此时，HelpUploadFiles 油然而生！

HelpUploadFiles is an auxiliary upload tool. We know that git provides a .gitignore file for ignoring certain files from being uploaded based on rules, but this feature is limited to git. There are many scenarios involving file uploads, such as when we might need to upload certain files to cloud storage. However, most cloud storage services do not have the capability to ignore specified files based on rules, which is quite inconvenient. Additionally, there are numerous scenarios for uploading files. At this point, HelpUploadFiles comes into play!

由于对于单个文件，不需要特别的规则进行忽略上传，故 HelpUploadFiles 主要是针对 文件夹 的上传场景。

Since there are no special rules required to ignore uploading for individual files, HelpUploadFiles is primarily aimed at scenarios involving folder uploads.

1. 可前往 Actions 区下载最新特性 HelpUploadFiles 包。
2. 可前往 Releases 区下载稳定版本的 HelpUploadFiles 包。

1. You can go to the Actions section to download the latest feature package HelpUploadFiles.
2. You can go to the Releases section to download the stable version of the HelpUploadFiles package.

HelpUploadFiles 涉及的文件上传并不仅仅局限于将本机文件上传到网盘这种场景，在 HelpUploadFiles 中，凡是需要 将某个文件夹发送到某一个接口 的操作均可推广为文件上传。

The file upload involved with HelpUploadFiles is not limited to scenarios of uploading local files to cloud storage. In HelpUploadFiles, any operation that involves sending a folder to a specific interface can be generalized as file uploading.

以下场景均可视文件上传概念的推广：

1. 将本机文件夹上传到网盘。
2. 将本机文件夹发送到另一台设备（如局域网内设备、服务器对象存储服务等）。
3. 将本机文件夹发送到压缩软件等接口。

The following scenarios can be considered as expanded concepts of file uploading:

1. Uploading a local folder to cloud storage.
2. Sending a local folder to another device (such as devices within a local area network, server object storage services, etc.).
3. Sending a local folder to interfaces of compression software, etc.

以下场景均已验证通过：

1. Chromium 浏览器 涉及的文件夹上传
2. Edge 浏览器 涉及的文件夹上传
3. 百度网盘客户端
4. 腾讯微云客户端
5. 阿里网盘
6. 天翼网盘客户端
7. **移动硬盘客户端
8. 联通网盘
9. 谷歌云端硬盘
10. 小飞机网盘
11. 奶牛快传
12. 123云盘
13. 华为云对象存储服务 OBS
14. 阿里云对象存储服务 OSS
15. 腾讯云对象存储服务 COS
16. LocalSend
17. Send Anywhere 客户端
18. WinSCP
19. 7z、Bandizip、360压缩等压缩软件

The following scenarios have been verified and are operational:

1. Folder uploads involving the Chromium browser.
2. Folder uploads involving the Edge browser.
3. Baidu Cloud client.
4. Tencent Weiyun client.
5. Alibaba Cloud Drive.
6. Tianyi Cloud client.
7. China Mobile Hard Disk client.
8. Unicom Cloud.
9. Google Cloud Storage.
10. Little Airplane Cloud.
11. Niuniu Express.
12. 123 Cloud Storage.
13. Huawei Cloud Object Storage Service OBS.
14. Alibaba Cloud Object Storage Service OSS.
15. Tencent Cloud Object Storage Service COS.
16. LocalSend.
17. Send Anywhere client.
18. WinSCP.
19. Compression software such as 7z, Bandizip, 360 Compression, etc.

1. HelpUploadFiles 分为 32位 与 64位 两个版本，需要根据不同的上传接口选择不同的版本，如目前百度网盘客户端是32位的，则需要使用32位版本的 HelpUploadFiles；而64位系统的Edge浏览器是64位程序，则需要使用64位版本的 HelpUploadFiles。
2. 目前版本(v1.0.3)仅支持同时拦截一个进程的文件上传行为，值得注意的是 32位 与 64位版本 加起来一共能同时拦截一个进程。且 添加/移除 忽略列表的操作 仅对当前拦截的进程有效，若切换进程，即使重新注入，也需要重新添加忽略列表（移除后重新添加），否则将无效。 这是由于目前采用的进程通信方案导致的。
3. 对于下方输入框手动输入的忽略规则，将采用 C++ 正则表达式规则。
4. 对于拖拽上传的文件，将自动进行转义使其符合 C++正则表达式规则。

1. HelpUploadFiles comes in two versions: 32-bit and 64-bit. You need to select the appropriate version based on the upload interface, such as using the 32-bit version of HelpUploadFiles for the 32-bit Baidu Cloud client, while the 64-bit Edge browser on a 64-bit system is a 64-bit program, requiring the 64-bit version of HelpUploadFiles.

2. The current version (v1.0.2) only supports intercepting the file upload behavior of one process at a time. It's important to note that the 32-bit and 64-bit versions combined can only intercept one process simultaneously. Additionally, operations to add/remove the ignore list only take effect for the currently intercepted process. If you switch processes, even with a re-injection, you will need to re-add the ignore list (remove and then re-add), otherwise, it will be ineffective. This is due to the process communication scheme currently in use.

3. For manual input of ignore rules in the input box below, C++ regular expression rules will be used.

4. For files uploaded by dragging and dropping, automatic escaping will be performed to conform to C++ regular expression rules.

1. 打开百度网盘。

   Open Baidu Cloud.

   

2. 🔑打开 HelpUploadFiles，长按鼠标左键，光标将改变表明程序进入捕获状态，此时将鼠标移动到百度网盘主窗口再松开鼠标左键，下图红框处的提示文字也随之改变为 将要捕获的窗口的标题（若标题为空则为窗口类名）。

   Open HelpUploadFiles, press and hold the left mouse button, the cursor will change indicating that the program has entered the capture state. Move the mouse to the main window of Baidu Cloud and release the left mouse button. The prompt text in the red box below will also change to the title of the window to be captured (if the title is empty, it will be the window class name).

   

3. 此时会提示是否注入赋能模块到百度网盘，点击确认，百度网盘将打开一个对话框告知 赋能模块注入成功（这个对话框是由百度网盘所在进程产生的，一个显然的提示是对话框的图标是百度网盘的图标），即表明模块注入成功。如果没有提示赋能模块注入成功，有以下两种可能：

   At this point, you will be prompted whether to inject the empowerment module into Baidu Cloud. Click confirm, and Baidu Cloud will open a dialog box informing you of the successful injection of the empowerment module (this dialog box is generated by the Baidu Cloud process, and an obvious indication is that the dialog box icon is the Baidu Cloud icon), indicating that the module injection is successful. If there is no prompt for a successful empowerment module injection, there are two possibilities:

   • 赋能模块在之前已经注入，此次注入为重复注入。

   • 赋能模块注入失败，这表明功能将不可用。

   • The empowerment module has already been injected before, and this injection is a repeat.

   • The empowerment module injection failed, which means the function will not be available. Please ensure that you click the "OK" button on the "Successful Empowerment Module Injection" message box before proceeding to the next step.

   

   

   请确保在进行下一步前点击 赋能模块注入成功 消息框的确定键。

   Please ensure that you click the OK button on the Successful Empowerment Module Injection message box before proceeding to the next step.

4. 添加忽略规则（基于C++正则表达式规则）

   Add ignore rules (based on C++ regular expression rules).

   有两种方式可以添加忽略规则：

   There are two ways to add ignore rules:

   • 可通过将文件拖拽到忽略文件列表。（拖拽文件会自动完成转义，以自动适配正则表达式规则）。

   • 在下方输入框手动输入正则表达式并点击 “忽略” 按钮添加（回车也可以）。

   • You can drag and drop files into the ignore file list. (Dragging files will automatically complete the escaping to automatically adapt to regular expression rules).

   • Manually enter the regular expression in the input box below and click the "Ignore" button to add (pressing Enter is also possible).

   如果需要移除忽略规则，可先选中忽略列表框中的忽略规则，然后点击按钮 "移除"即可。

   If you need to remove an ignore rule, select the ignore rule in the ignore list box and then click the "Remove" button.

   如下图，我添加了两条忽略规则用以忽略：

   As shown in the figure below, I have added two ignore rules to ignore:

   • .idea 文件夹

   • node_modules 文件夹

   • The .idea folder

   • The node_modules folder

   

5. 上传文件

   Upload file

将需要上传的文件夹拖拽到百度网盘（其它方式也可以）完成上传。匹配忽略规则的文件将不会被上传。

Upload files by dragging the folder you need to upload to Baidu Cloud (other methods are also possible) to complete the upload. Files that match the ignore rules will not be uploaded.

上述步骤的 第 2 步是关键步骤，决定了程序能否达到预期效果。

该步骤要考虑两个问题：

1. 使用哪个版本的HelpUploadFiles
2. 捕获哪个窗口（即鼠标移动到哪个窗口再松开）

Step 2 above is the key step, determining whether the program can achieve the expected results.

This step requires considering two issues:

1. Which version of HelpUploadFiles to use
2. Which window to capture (i.e., which window to move the mouse to and then release)

• 可通过任务管理器查看要拦截的程序（如百度网盘）是什么版本，然后采用对应版本的 HelpUploadFiles

• 但这也不是绝对的，有些 64位程序 需要使用 32位版本的 HelpUploadFiles，在64位方案不可行时可考虑验证此方案。(如下文的 WinSCP )

• You can check the version of the program you want to intercept (such as Baidu Cloud) through Task Manager, and then use the corresponding version of HelpUploadFiles.

• However, this is not absolute. Some 64-bit programs require the use of the 32-bit version of HelpUploadFiles. If the 64-bit solution is not feasible, you can consider verifying this scheme (as with WinSCP below).

正则表达式是一种用于描述字符串模式的工具，它可以帮助您在文本中进行搜索、匹配、替换等操作。以下是一些常用的正则表达式规则和符号：

1. 字符类别：
   • \d：匹配任意一个数字字符，相当于 [0-9]。
   • \D：匹配任意一个非数字字符，相当于 [^0-9]。
   • \w：匹配任意一个字母、数字或下划线字符，相当于 [a-zA-Z0-9_]。
   • \W：匹配任意一个非字母、数字或下划线字符，相当于 [^a-zA-Z0-9_]。
   • \s：匹配任意一个空白字符，包括空格、制表符、换行符等。
   • \S：匹配任意一个非空白字符。
2. 重复次数：
   • *：匹配前面的字符零次或多次。
   • +：匹配前面的字符一次或多次。
   • ?：匹配前面的字符零次或一次。
   • {n}：匹配前面的字符恰好 n 次。
   • {n,}：匹配前面的字符至少 n 次。
   • {n,m}：匹配前面的字符至少 n 次，最多 m 次。
3. 边界匹配：
   • ^：匹配字符串的开头。
   • $：匹配字符串的结尾。
   • \b：匹配单词边界。
4. 分组和引用：
   • ()：将其中的字符视为一个整体，可以用于分组操作。
   • \1, \2, ...：引用分组中的匹配结果。
5. 特殊字符转义：
   • \：用于转义特殊字符，例如 \. 表示匹配点字符 .。
6. 其他常用符号：
   • |：表示或操作，匹配两者之一。
   • .：匹配任意一个字符，除了换行符。

Regular expressions are tools used to describe string patterns that can help you perform operations such as search, match, and replace in text. Here are some common regular expression rules and symbols:

Character Categories:

• \d: Matches any digit character, equivalent to [0-9].
• \D: Matches any non-digit character, equivalent to [^0-9].
• \w: Matches any letter, digit, or underscore character, equivalent to [a-zA-Z0-9_].
• \W: Matches any non-letter, non-digit, or non-underscore character, equivalent to [^a-zA-Z0-9_].
• \s: Matches any whitespace character, including spaces, tabs, and newlines.
• \S: Matches any non-whitespace character.

Repeat Counts:

• *: Matches the preceding character zero or more times.
• +: Matches the preceding character one or more times.
• ?: Matches the preceding character zero or one time.
• {n}: Matches the preceding character exactly n times.
• {n,}: Matches the preceding character at least n times.
• {n,m}: Matches the preceding character at least n times, but no more than m times.

Boundary Matches:

• ^: Matches the beginning of a string.
• $: Matches the end of a string.
• \b: Matches a word boundary.

Grouping and Referencing:

• (): Treats the characters within as a group for operations.
• \1, \2, ...: Refer to the match results of the grouped matches.

Special Character Escaping:

• \: Used to escape special characters, for example, \. represents a match for the dot character.

Other Common Symbols:

• |: Represents an OR operation, matching either of the two.
• .: Matches any character except for a newline.

新版本增添了基于进程 id 注入赋能模块到进程的功能,主要可用于注入一些不存在可见窗口的进程。其中选择 32位还是 64 位版本 HelpUploadFiles 的策略与基于窗口捕获方案相同。

The new version has added the functionality to inject an empowerment module into a process based on the process ID, which can primarily be used for injecting into processes that do not have visible windows. The strategy for selecting whether to use the 32-bit or 64-bit version of HelpUploadFiles is the same as the one based on the window capture scheme.

通过任务管理器查看需要注入的进程 id号。

Use the Task Manager to view the process ID that needs to be injected.

选择合适版本 (x86/x64) 的 HelpUploadFiles 完成注入。

Choose the appropriate version (x86/x64) of HelpUploadFiles to complete the injection.

• 比特球网盘 未完全兼容，存在目录创建失败问题。
• BitBalloon Cloud Storage is not fully compatible, with issues such as directory creation failure.