零基础玩转PatreonDownloader：从配置到下载全攻略

🌟 工具简介：PatreonDownloader能做什么？

PatreonDownloader是一款专为创作者内容下载设计的工具，支持从Patreon平台及外部链接（需插件）获取订阅内容。无论是免费公开帖子还是付费订阅内容，只要你的账户有权访问，它都能帮你轻松下载。

💡 核心能力：

• 支持Windows/Linux多平台运行
• 自动解析帖子中的文件附件与外部链接
• 可保存帖子HTML内容、嵌入元数据及API响应
• 内置Google Drive、Mega.nz等第三方下载插件

⚠️ 重要声明：使用前需拥有有效的Patreon账户，付费内容仅对已订阅用户开放下载权限。

📂 核心文件速查表

文件/目录	功能说明	重要程度
PatreonDownloader.App/Program.cs	程序入口点，处理命令行参数	⭐⭐⭐
settings.json	配置文件，包含链接黑名单等设置	⭐⭐⭐
PatreonDownloader.sln	Visual Studio解决方案文件	⭐⭐
docs/BUILDING.md	编译构建详细指南	⭐
submodules/	依赖的通用下载平台模块	🔧

💡 小提示：开发人员可重点关注PatreonDownloader.Implementation目录下的PatreonPageCrawler.cs（页面爬取逻辑）和PatreonWebDownloader.cs（下载核心实现）。

🛠️ 环境准备：三步上手

1️⃣ 安装必要工具

• .NET SDK 9.0：所有平台必备的开发运行环境
• Git：用于克隆代码仓库
• Visual Studio 2022（可选）：Windows用户图形化开发工具

2️⃣ 获取源代码

git clone --recurse-submodules https://gitcode.com/gh_mirrors/pa/PatreonDownloader

⚠️ 注意：必须添加--recurse-submodules参数，否则会缺少核心依赖模块！

3️⃣ 构建可执行文件

根据你的系统选择对应命令：

Windows用户：

cd PatreonDownloader.App
dotnet publish -c Release -r win-x64 --self-contained -f net9.0 -o bin\publish\win-release

Linux用户：

cd PatreonDownloader.App
dotnet publish -c Release -r linux-x64 --self-contained -f net9.0 -o bin/publish/linux-release

⚙️ 核心配置详解

配置文件设置

程序使用settings.json文件进行基础配置，目前主要包含链接黑名单设置：

{
  "UrlBlackList": "patreon.com/posts/|tmblr.co/|t.umblr.com/redirect|..."
}

💡 配置技巧：如需添加新的屏蔽链接，只需在字符串中用|分隔添加即可，例如："UrlBlackList": "原内容|newhost.com"

命令行参数大全

参数	示例	说明
--url	--url https://www.patreon.com/user/posts?u=12345	指定要下载的创作者页面URL
--download-directory	--download-directory ./my_downloads	设置下载文件保存路径
--descriptions	-	保存帖子HTML内容
--embeds	-	保存嵌入内容的元数据
--campaign-images	-	下载创作者头像和封面图
--json	-	保存API响应数据（用于调试）
--help	-	显示所有可用参数说明

🚀 实战操作：下载你的第一个内容

基础下载流程

1. 准备目标URL
   支持以下格式的Patreon页面链接：

   • https://www.patreon.com/m/12345678/posts
   • https://www.patreon.com/user?u=12345678
   • https://www.patreon.com/creatorname/posts

2. 执行下载命令

   # Windows示例
   PatreonDownloader.App.exe --url "https://www.patreon.com/user/posts?u=12345" --download-directory "D:\PatreonDownloads" --descriptions
   
   # Linux示例
   ./PatreonDownloader.App --url "https://www.patreon.com/user/posts?u=12345" --download-directory ~/PatreonDownloads --descriptions
   

3. 查看结果
   下载文件会按创作者ID和帖子日期自动组织到指定目录中，HTML格式的帖子内容也会一同保存。

高级用法：启用第三方下载

要下载Google Drive或Mega.nz链接内容，需将对应插件文件复制到程序目录的plugins文件夹：

• Google Drive支持：需复制Google.Apis.*.dll系列文件和UniversalDownloaderPlatform.GoogleDriveDownloader.dll
• Mega.nz支持：需复制MegaApiClient.dll和UniversalDownloaderPlatform.MegaDownloader.dll

❓ 常见问题解答

Q1：程序提示"无法访问页面"怎么办？

A：检查以下几点：

1. 确保Patreon账户已登录（可通过浏览器验证会话）
2. 确认URL格式正确且包含posts路径
3. 检查网络代理设置是否干扰连接

Q2：下载速度慢或频繁失败如何解决？

A：尝试添加--delay-between-requests 2000参数（单位毫秒）增加请求间隔，避免触发反爬机制。

Q3：如何更新到最新版本？

A：进入项目目录执行：

git pull
git submodule update --init --recursive

然后重新编译发布程序。

Q4：支持下载哪些类型的文件？

A：目前已测试支持图片、文档、压缩包等常规文件类型，音频文件和部分视频链接（如YouTube）暂不支持。

📚 进阶资源

• 编译指南：详细构建步骤参见docs/BUILDING.md
• 插件开发：可参考PatreonDefaultPlugin.cs实现自定义下载器
• 故障排查：启用--json参数保存API响应，便于分析下载问题

💡 开发者提示：项目使用NLog进行日志记录，配置文件为NlogManager.cs，可通过修改日志级别获取更详细的调试信息。

---

祝愉快使用PatreonDownloader！如有功能需求或bug反馈，欢迎参与项目改进。记得遵守Patreon用户协议，尊重创作者知识产权哦~ 🎉