pixivflow 2.0.40 → 2.0.42

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/README.md +119 -596
  2. package/README_EN.md +35 -35
  3. package/dist/package.json +1 -1
  4. package/dist/webui/package.json +1 -1
  5. package/package.json +6 -6
package/README.md CHANGED
@@ -8,98 +8,29 @@
8
8
 
9
9
  > 🎯 **PixivFlow** 是一个专业的 Pixiv 批量下载工具，支持插画和小说下载、定时任务、Docker 部署。适用于个人用户和服务器自动化场景。
10
10
 
11
- > 📖 **[查看完整教程文档](https://zoidberg-xgd.github.io/PixivFlow/)** - 包含详细的使用教程、配置说明、部署指南和最佳实践
11
+ > 📖 **[查看完整教程文档](https://redtidev1918.github.io/PixivFlow/)** - 包含详细的使用教程、配置说明、部署指南和最佳实践
12
12
 
13
13
  <!-- SEO Keywords: pixiv downloader, pixiv批量下载, pixiv自动化下载, pixiv批量下载工具, pixiv下载器, pixiv artwork downloader, pixiv novel downloader, pixiv cli tool, pixiv scheduler, pixiv automation, pixiv批量下载脚本, pixiv下载工具, pixiv作品下载, pixiv插画下载, pixiv小说下载, pixiv定时下载, pixiv爬虫, pixiv api client, pixiv命令行工具, pixiv服务器部署, pixiv docker, pixiv webui, pixiv管理界面 -->
14
14
 
15
- [![GitHub stars](https://img.shields.io/github/stars/zoidberg-xgd/pixivflow?style=for-the-badge&logo=github)](https://github.com/zoidberg-xgd/pixivflow/stargazers)
16
- [![GitHub forks](https://img.shields.io/github/forks/zoidberg-xgd/pixivflow?style=for-the-badge&logo=github)](https://github.com/zoidberg-xgd/pixivflow/network/members)
17
- [![GitHub issues](https://img.shields.io/github/issues/zoidberg-xgd/pixivflow?style=for-the-badge&logo=github)](https://github.com/zoidberg-xgd/pixivflow/issues)
15
+ [![GitHub stars](https://img.shields.io/github/stars/redtidev1918/pixivflow?style=for-the-badge&logo=github)](https://github.com/redtidev1918/PixivFlow/stargazers)
16
+ [![GitHub forks](https://img.shields.io/github/forks/redtidev1918/pixivflow?style=for-the-badge&logo=github)](https://github.com/redtidev1918/PixivFlow/network/members)
17
+ [![GitHub issues](https://img.shields.io/github/issues/redtidev1918/pixivflow?style=for-the-badge&logo=github)](https://github.com/redtidev1918/PixivFlow/issues)
18
18
  [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge)](https://www.gnu.org/licenses/gpl-3.0)
19
19
 
20
20
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.6+-blue.svg?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
21
21
  [![Node.js](https://img.shields.io/badge/Node.js-18%2B%20LTS-green.svg?style=flat-square&logo=node.js)](https://nodejs.org/)
22
- [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg?style=flat-square)](https://github.com/zoidberg-xgd/pixivflow)
23
- [![Maintenance](https://img.shields.io/badge/Maintained-yes-green.svg?style=for-the-badge)](https://github.com/zoidberg-xgd/pixivflow/graphs/commit-activity)
22
+ [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg?style=flat-square)](https://github.com/redtidev1918/PixivFlow)
23
+ [![Maintenance](https://img.shields.io/badge/Maintained-yes-green.svg?style=for-the-badge)](https://github.com/redtidev1918/PixivFlow/graphs/commit-activity)
24
24
 
25
- [功能特性](#功能特性) • [快速开始](#快速开始) • [CLI 命令](#cli-命令行工具) • [脚本工具](#脚本工具) • [使用场景](#使用场景)
26
-
27
- [📖 完整教程文档](https://zoidberg-xgd.github.io/PixivFlow/) | [English](README_EN.md) | [中文](README.md)
25
+ [📖 完整教程文档](https://redtidev1918.github.io/PixivFlow/) | [English](README_EN.md) | [中文](README.md)
28
26
 
29
27
  </div>
30
28
 
31
29
  ---
32
30
 
33
- ## 目录
34
-
35
- <details>
36
- <summary><b>点击展开完整目录</b></summary>
37
-
38
- <br>
39
-
40
- **入门指南**
41
- - [什么是 PixivFlow？](#什么是-pixivflow)
42
- - [为什么选择 PixivFlow？](#为什么选择-pixivflow)
43
- - [核心理念](#核心理念)
44
- - [功能特性](#功能特性)
45
- - [核心功能](#核心功能)
46
- - [额外优势](#额外优势)
47
- - [快速开始](#快速开始)
48
- - [环境要求](#环境要求)
49
- - [快速安装（推荐 ⭐）](#快速安装推荐)
50
- - [安装方式说明](#安装方式说明)
51
- - [WebUI 后端 API（可选）](#webui-后端-api可选)
52
- - [Docker 部署（推荐）](#docker-部署推荐)
53
-
54
- **工具与文档**
55
- - [CLI 命令行工具](#cli-命令行工具)
56
- - [核心命令](#核心命令)
57
- - [配置管理](#配置管理)
58
- - [监控与维护](#监控与维护)
59
- - [脚本工具](#脚本工具)
60
- - [主控脚本（最常用）](#主控脚本最常用)
61
- - [无图形界面服务器的登录方式（使用现有 refresh token）](#无图形界面服务器的登录方式使用现有-refresh-token)
62
- - [文档导航](#文档导航)
63
- - [新手必读（按顺序阅读）](#新手必读按顺序阅读)
64
- - [功能指南](#功能指南)
65
- - [部署和环境](#部署和环境)
66
- - [项目文档](#项目文档)
67
-
68
- **使用与配置**
69
- - [使用场景](#使用场景)
70
- - [场景 1：每日自动收集灵感素材](#场景-1每日自动收集灵感素材)
71
- - [场景 2：服务器定时收集特定标签](#场景-2服务器定时收集特定标签)
72
- - [场景 3：快速体验 - 随机下载](#场景-3快速体验-随机下载)
73
- - [场景 4：一次性批量下载](#场景-4一次性批量下载)
74
- - [项目结构](#项目结构)
75
- - [核心配置](#核心配置)
76
- - [认证配置](#认证配置)
77
- - [下载目标](#下载目标)
78
- - [定时任务](#定时任务)
79
- - [存储配置](#存储配置)
80
-
81
- **故障排除与进阶**
82
- - [常见问题](docs/USAGE.md)
83
- - [安全提示](docs/USAGE.md)
84
- - [下载记录管理](docs/USAGE.md)
85
- - [进阶使用](docs/USAGE.md)
86
- - [服务器部署](docs/DOCKER.md)
87
- - [配置多个下载任务](docs/CONFIG.md)
88
- - [使用代理](docs/USAGE.md)
89
-
90
- **最佳实践**
91
- - [最佳实践](docs/USAGE.md)
92
-
93
- **项目信息**
94
- - [开源许可](#开源许可)
95
- - [致谢](#致谢)
96
- - [获取帮助](#获取帮助)
97
- - [项目统计](#项目统计)
98
- - [贡献](#贡献)
99
- - [更新日志](#更新日志)
100
- - [支持项目](#支持项目)
101
-
102
- </details>
31
+ ## 快速导航
32
+
33
+ [功能特性](#功能特性) • [快速开始](#快速开始) • [使用指南](#cli-命令行工具) • [配置说明](#核心配置) • [完整文档](docs/README.md)
103
34
 
104
35
  ---
105
36
 
@@ -108,17 +39,7 @@
108
39
 
109
40
  **PixivFlow** 是一个**完全独立运行**的 Pixiv 作品批量下载工具，专为自动化设计。无需浏览器扩展，可在命令行或服务器上自动化运行，支持定时任务、智能去重、断点续传等功能。
110
41
 
111
- 作为一款专业的 **Pixiv 下载器**，PixivFlow 支持以下核心功能：
112
- - 📥 **批量下载 Pixiv 插画和小说**：支持按标签、用户、收藏数等条件批量下载作品
113
- - 🔗 **URL 直接下载**：支持直接输入 Pixiv URL 进行下载，无需修改配置文件
114
- - 🎯 **单作品下载**：支持通过作品ID直接下载单个插画或小说
115
- - ⏰ **定时自动下载**：使用 Cron 表达式配置定时任务，实现自动化下载
116
- - 🐳 **Docker 部署**：支持 Docker 容器化部署，一键启动
117
- - 🔐 **安全认证**：采用 OAuth 2.0 PKCE 标准流程，保障账号安全
118
- - 💾 **智能去重**：自动记录下载历史，避免重复下载
119
- - 🔄 **断点续传**：下载中断后自动恢复，无需重新开始
120
-
121
- 无论是个人使用还是服务器部署，PixivFlow 都能帮助你高效地收集和管理 Pixiv 作品。
42
+ 作为一款专业的 **Pixiv 下载器**，PixivFlow 提供批量下载、URL 直接下载、定时任务、Docker 部署等核心功能，无论是个人使用还是服务器部署，都能帮助你高效地收集和管理 Pixiv 作品。
122
43
 
123
44
  <a id="为什么选择-pixivflow"></a>
124
45
  ### 为什么选择 PixivFlow？
@@ -127,12 +48,12 @@
127
48
 
128
49
  | 优势 | 说明 |
129
50
  |------|------|
130
- | 🚀 **完全独立运行** | 无需浏览器扩展，纯命令行工具，可在任何环境运行（服务器、Docker、CI/CD） |
131
- | 🤖 **真正的自动化** | 设置一次，永久运行。支持 Cron 定时任务，无需人工干预 |
132
- | 🖥️ **服务器友好** | 专为服务器设计，支持后台运行、进程管理、日志轮转 |
133
- | 🔐 **安全可靠** | 采用 OAuth 2.0 PKCE 标准流程，保障账号安全，避免密码泄露风险 |
134
- | 📦 **轻量级部署** | 资源占用低，无需额外服务（如数据库、Redis），SQLite 即可 |
135
- | 🛠️ **开箱即用** | 丰富的脚本工具和配置向导，3 步即可开始使用 |
51
+ | **完全独立运行** | 无需浏览器扩展，纯命令行工具，可在任何环境运行（服务器、Docker、CI/CD） |
52
+ | **真正的自动化** | 设置一次，永久运行。支持 Cron 定时任务，无需人工干预 |
53
+ | **服务器友好** | 专为服务器设计，支持后台运行、进程管理、日志轮转 |
54
+ | **安全可靠** | 采用 OAuth 2.0 PKCE 标准流程，保障账号安全，避免密码泄露风险 |
55
+ | **轻量级部署** | 资源占用低，无需额外服务（如数据库、Redis），SQLite 即可 |
56
+ | **开箱即用** | 丰富的脚本工具和配置向导，3 步即可开始使用 |
136
57
 
137
58
  <a id="核心理念"></a>
138
59
  ### 核心理念
@@ -152,26 +73,26 @@
152
73
 
153
74
  | 功能 | 说明 |
154
75
  |------|------|
155
- | **📥 批量下载** | 支持插画和小说批量下载，可配置下载数量、筛选条件 |
156
- | **🏷️ 标签搜索** | 按标签搜索作品，支持精确匹配、部分匹配等多种模式 |
157
- | **🎲 随机下载** | 一键下载随机热门标签作品，快速体验工具功能 |
158
- | **⏰ 定时任务** | Cron 表达式配置，支持每天、每周、每月定时自动下载 |
159
- | **🔍 智能筛选** | 按收藏数、日期范围、作品类型等多维度筛选 |
160
- | **🌐 语言检测** | 自动检测小说语言，支持按语言过滤（仅中文/仅非中文） |
161
- | **💾 自动去重** | SQLite 数据库记录历史，自动跳过已下载作品 |
162
- | **🔄 断点续传** | 下载中断后自动恢复，无需重新开始 |
163
- | **🛡️ 错误处理** | 自动重试、错误恢复、智能跳过已删除/私有作品 |
164
- | **📊 统计报告** | 详细的运行日志和下载统计报告 |
76
+ | **批量下载** | 支持插画和小说批量下载，可配置下载数量、筛选条件 |
77
+ | **标签搜索** | 按标签搜索作品，支持精确匹配、部分匹配等多种模式 |
78
+ | **随机下载** | 一键下载随机热门标签作品，快速体验工具功能 |
79
+ | **定时任务** | Cron 表达式配置，支持每天、每周、每月定时自动下载 |
80
+ | **智能筛选** | 按收藏数、日期范围、作品类型等多维度筛选 |
81
+ | **语言检测** | 自动检测小说语言，支持按语言过滤（仅中文/仅非中文） |
82
+ | **自动去重** | SQLite 数据库记录历史，自动跳过已下载作品 |
83
+ | **断点续传** | 下载中断后自动恢复，无需重新开始 |
84
+ | **错误处理** | 自动重试、错误恢复、智能跳过已删除/私有作品 |
85
+ | **统计报告** | 详细的运行日志和下载统计报告 |
165
86
 
166
87
  <a id="额外优势"></a>
167
88
  ### 额外优势
168
89
 
169
- - ✅ **完全独立**：无需浏览器，纯命令行工具
170
- - ✅ **跨平台支持**：Windows / macOS / Linux，可在任何环境运行
171
- - ✅ **轻量级**：资源占用低，适合服务器长期运行
172
- - ✅ **开源免费**：GPL-3.0 许可证，可自由定制和分发
173
- - ✅ **类型安全**：TypeScript 编写，类型提示完善
174
- - ✅ **文档完善**：详细的中文文档和教程
90
+ - **完全独立**：无需浏览器，纯命令行工具
91
+ - **跨平台支持**：Windows / macOS / Linux，可在任何环境运行
92
+ - **轻量级**：资源占用低，适合服务器长期运行
93
+ - **开源免费**：GPL-3.0 许可证，可自由定制和分发
94
+ - **类型安全**：TypeScript 编写，类型提示完善
95
+ - **文档完善**：详细的中文文档和教程
175
96
 
176
97
  ---
177
98
 
@@ -195,7 +116,7 @@
195
116
  > **详细指南**：查看 [快速开始指南](docs/QUICKSTART.md)
196
117
 
197
118
  <a id="快速安装推荐"></a>
198
- ### 快速安装（推荐 ⭐）
119
+ ### 快速安装（推荐）
199
120
 
200
121
  #### 方式 1：从 npm 安装（最简单）
201
122
 
@@ -228,7 +149,7 @@ pixivflow download
228
149
 
229
150
  ```bash
230
151
  # 1. 克隆仓库
231
- git clone https://github.com/zoidberg-xgd/pixivflow.git
152
+ git clone https://github.com/redtidev1918/PixivFlow.git
232
153
  cd pixivflow
233
154
 
234
155
  # 2. 安装依赖
@@ -279,7 +200,7 @@ PORT=8080 pixivflow webui
279
200
 
280
201
  > **说明**：
281
202
  > - PixivFlow 只提供后端 API，不包含前端界面
282
- > - **前端项目**：现代化的 React 前端界面请查看 [pixivflow-webui](https://github.com/zoidberg-xgd/pixivflow-webui)
203
+ > - **前端项目**：现代化的 React 前端界面请查看 [pixivflow-webui](https://github.com/redtidev1918/PixivFlow-webui)
283
204
  > - 可以通过 API 直接调用，或连接其他前端项目
284
205
  > - **API 文档**：查看 [使用指南](docs/USAGE.md) 了解详细的 API 使用方法
285
206
 
@@ -311,16 +232,16 @@ docker-compose up -d # 启动服务
311
232
  # 全局安装后使用
312
233
  pixivflow login # 登录 Pixiv 账号
313
234
  pixivflow download # 执行下载
314
- pixivflow download --url <url> # 通过 URL 直接下载（支持插画/小说/系列）⭐
235
+ pixivflow download --url <url> # 通过 URL 直接下载（支持插画/小说/系列）
315
236
  pixivflow random # 随机下载
316
237
  pixivflow scheduler # 启动定时任务
317
238
  pixivflow normalize # 整理文件
318
239
  pixivflow migrate-config # 迁移配置
319
- pixivflow health # 健康检查（推荐 ⭐）
240
+ pixivflow health # 健康检查（推荐）
320
241
  pixivflow status # 查看下载统计和最近记录
321
242
  pixivflow logs # 查看运行日志
322
- pixivflow setup # 交互式配置向导（首次使用）⭐
323
- pixivflow dirs # 查看目录信息（文件保存位置）⭐
243
+ pixivflow setup # 交互式配置向导（首次使用）
244
+ pixivflow dirs # 查看目录信息（文件保存位置）
324
245
  ```
325
246
 
326
247
  **URL 下载示例**：
@@ -355,9 +276,9 @@ pixivflow set-token <your_refresh_token>
355
276
  ### 配置管理
356
277
 
357
278
  ```bash
358
- pixivflow config # 配置管理（查看/编辑/备份/恢复）⭐
279
+ pixivflow config # 配置管理（查看/编辑/备份/恢复）
359
280
  pixivflow config show # 查看配置
360
- pixivflow config set <key> <value> # 设置配置项（如：storage.downloadDirectory）⭐
281
+ pixivflow config set <key> <value> # 设置配置项（如：storage.downloadDirectory）
361
282
  pixivflow config backup # 备份配置
362
283
  pixivflow config restore # 恢复配置
363
284
  pixivflow config validate # 验证配置
@@ -380,9 +301,9 @@ pixivflow config set storage.novelDirectory ./my-novels
380
301
  ### 监控与维护
381
302
 
382
303
  ```bash
383
- pixivflow monitor # 实时监控进程状态和性能指标 ⭐
384
- pixivflow maintain # 自动维护（清理日志、优化数据库等）⭐
385
- pixivflow backup # 自动备份配置和数据 ⭐
304
+ pixivflow monitor # 实时监控进程状态和性能指标
305
+ pixivflow maintain # 自动维护（清理日志、优化数据库等）
306
+ pixivflow backup # 自动备份配置和数据
386
307
  ```
387
308
 
388
309
  > 📖 **详细说明**：查看 [脚本使用指南](docs/SCRIPTS.md)
@@ -418,13 +339,13 @@ PixivFlow 提供了丰富的脚本工具，所有脚本直接调用内置 CLI，
418
339
  | `health` | 健康检查（检查配置、网络等）<br>**全局安装后使用**: `pixivflow health` |
419
340
  | `status` | 查看下载统计和最近记录<br>**全局安装后使用**: `pixivflow status` |
420
341
  | `logs` | 查看运行日志<br>**全局安装后使用**: `pixivflow logs` |
421
- | `config` | 配置管理工具（查看/编辑/备份/恢复）<br>**全局安装后使用**: `pixivflow config` ⭐ |
422
- | `backup` | 自动备份配置和数据<br>**全局安装后使用**: `pixivflow backup` ⭐ |
423
- | `maintain` | 自动维护（清理日志、优化数据库等）<br>**全局安装后使用**: `pixivflow maintain` ⭐ |
424
- | `monitor` | 实时监控进程状态和性能指标<br>**全局安装后使用**: `pixivflow monitor` ⭐ |
425
- | `setup` | 交互式配置向导（首次使用）<br>**全局安装后使用**: `pixivflow setup` ⭐ |
342
+ | `config` | 配置管理工具（查看/编辑/备份/恢复）<br>**全局安装后使用**: `pixivflow config` |
343
+ | `backup` | 自动备份配置和数据<br>**全局安装后使用**: `pixivflow backup` |
344
+ | `maintain` | 自动维护（清理日志、优化数据库等）<br>**全局安装后使用**: `pixivflow maintain` |
345
+ | `monitor` | 实时监控进程状态和性能指标<br>**全局安装后使用**: `pixivflow monitor` |
346
+ | `setup` | 交互式配置向导（首次使用）<br>**全局安装后使用**: `pixivflow setup` |
426
347
 
427
- ### ⚙️ 其他工具
348
+ ### 其他工具
428
349
 
429
350
  ```bash
430
351
  # 环境检查和修复
@@ -445,165 +366,49 @@ PixivFlow 提供了丰富的脚本工具，所有脚本直接调用内置 CLI，
445
366
 
446
367
  | 文档 | 说明 |
447
368
  |------|------|
448
- | [⚡ QUICKSTART](docs/QUICKSTART.md) | **3 分钟快速上手** - 最快开始使用 |
449
- | [🔐 LOGIN](docs/LOGIN.md) | **登录流程详解** - 登录问题解决方案 |
450
- | [📖 USAGE](docs/USAGE.md) | **使用指南** - 功能使用说明 |
369
+ | [QUICKSTART](docs/QUICKSTART.md) | **3 分钟快速上手** - 最快开始使用 |
370
+ | [LOGIN](docs/LOGIN.md) | **登录流程详解** - 登录问题解决方案 |
371
+ | [USAGE](docs/USAGE.md) | **使用指南** - 功能使用说明 |
451
372
 
452
373
  ### 功能指南
453
374
 
454
375
  | 文档 | 说明 |
455
376
  |------|------|
456
- | [📋 CONFIG](docs/CONFIG.md) | **配置文件使用指南** - 所有配置选项详解 |
457
- | [🛠️ SCRIPTS](docs/SCRIPTS.md) | **脚本使用指南** - 所有脚本详细说明 |
377
+ | [CONFIG](docs/CONFIG.md) | **配置文件使用指南** - 所有配置选项详解 |
378
+ | [SCRIPTS](docs/SCRIPTS.md) | **脚本使用指南** - 所有脚本详细说明 |
458
379
 
459
380
  ### 部署和环境
460
381
 
461
382
  | 文档 | 说明 |
462
383
  |------|------|
463
- | [🐳 DOCKER](docs/DOCKER.md) | **Docker 使用指南** - Docker 部署和使用（包含常见问题解决方案） |
464
- | [📱 TERMUX](docs/TERMUX_INSTALL.md) | **Termux/Android 安装指南** - Android 设备上的安装和使用 |
384
+ | [DOCKER](docs/DOCKER.md) | **Docker 使用指南** - Docker 部署和使用（包含常见问题解决方案） |
385
+ | [TERMUX](docs/TERMUX_INSTALL.md) | **Termux/Android 安装指南** - Android 设备上的安装和使用 |
465
386
 
466
387
  ### 项目文档
467
388
 
468
389
  | 文档 | 说明 |
469
390
  |------|------|
470
- | [🏗️ ARCHITECTURE](docs/ARCHITECTURE.md) | **架构说明** - 项目架构和技术实现细节 |
471
- | [🔄 CLI_MIGRATION](docs/CLI_MIGRATION_SUMMARY.md) | **CLI 命令移植总结** - CLI 命令迁移和功能对照 |
472
- | [📝 CHANGELOG](docs/project/CHANGELOG.md) | 版本更新日志 |
473
- | [🤝 CONTRIBUTING](docs/project/CONTRIBUTING.md) | 贡献指南 |
391
+ | [ARCHITECTURE](docs/ARCHITECTURE.md) | **架构说明** - 项目架构和技术实现细节 |
392
+ | [CLI_MIGRATION](docs/CLI_MIGRATION_SUMMARY.md) | **CLI 命令移植总结** - CLI 命令迁移和功能对照 |
393
+ | [CHANGELOG](docs/project/CHANGELOG.md) | 版本更新日志 |
394
+ | [RELEASING](docs/RELEASING.md) | **npm 发版指南** - 打 tag 自动发布到 npm |
395
+ | [CONTRIBUTING](docs/project/CONTRIBUTING.md) | 贡献指南 |
474
396
 
475
397
  ---
476
398
 
477
399
  <a id="使用场景"></a>
478
400
  ## 使用场景
479
401
 
480
- <a id="场景-1每日自动收集灵感素材"></a>
481
- ### 场景 1：每日自动收集灵感素材
482
-
483
- **需求**：每天自动下载风景、插画类高质量作品作为设计素材
484
-
485
- **配置示例**：
486
-
487
- ```json
488
- {
489
- "targets": [
490
- {
491
- "type": "illustration",
492
- "tag": "風景",
493
- "limit": 50,
494
- "minBookmarks": 1000
495
- },
496
- {
497
- "type": "illustration",
498
- "tag": "イラスト",
499
- "limit": 30,
500
- "minBookmarks": 5000
501
- }
502
- ],
503
- "scheduler": {
504
- "enabled": true,
505
- "cron": "0 2 * * *"
506
- }
507
- }
508
- ```
509
-
510
- > 提示：支持 `tagRelation: "or"`。当为 `or` 时，会将 `tag` 按空格拆分，逐个标签顺序检索、合并并去重，然后按 `sort` 排序并按 `limit` 截断。建议在该模式下将 `download.requestDelay` 调高（例如 1500~3000ms）以降低速率限制。
511
-
512
- **示例 1b：多标签 OR 搜索（逐个标签检索并合并）**
513
- ```json
514
- {
515
- "targets": [
516
- {
517
- "type": "novel",
518
- "tag": "風景 イラスト オリジナル",
519
- "tagRelation": "or",
520
- "limit": 10,
521
- "mode": "search",
522
- "searchTarget": "partial_match_for_tags",
523
- "sort": "popular_desc"
524
- }
525
- ]
526
- }
527
- ```
528
-
529
- **运行方式**：
530
-
531
- ```bash
532
- ./scripts/pixiv.sh run
533
- ```
534
-
535
- ---
536
-
537
- <a id="场景-2服务器定时收集特定标签"></a>
538
- ### 场景 2：服务器定时收集特定标签
539
-
540
- **需求**：在服务器上每周收集特定标签的热门作品
541
-
542
- **配置示例**：
543
-
544
- ```json
545
- {
546
- "targets": [
547
- {
548
- "type": "illustration",
549
- "tag": "原神",
550
- "limit": 100,
551
- "searchTarget": "partial_match_for_tags"
552
- }
553
- ],
554
- "scheduler": {
555
- "enabled": true,
556
- "cron": "0 0 * * 0",
557
- "timezone": "Asia/Shanghai"
558
- }
559
- }
560
- ```
561
-
562
- **部署方式**：
563
-
564
- ```bash
565
- # 使用自动部署脚本
566
- ./scripts/auto-deploy.sh
567
-
568
- # 或使用 PM2 管理进程
569
- pm2 start "npm run scheduler" --name pixivflow
570
- ```
571
-
572
- ---
573
-
574
- <a id="场景-3快速体验-随机下载"></a>
575
- ### 场景 3：快速体验 - 随机下载
576
-
577
- **需求**：快速体验工具，下载一个随机作品
578
-
579
- ```bash
580
- # 随机下载插画（默认）
581
- npm run random
582
- # 或
583
- pixivflow random
584
-
585
- # 随机下载小说
586
- pixivflow random --novel
587
- ```
588
-
589
- **功能说明**：
590
- - 🎲 从热门标签中随机选择（插画：風景、イラスト等；小说：小説、オリジナル等）
591
- - 🔍 从搜索结果中随机选择作品
592
- - 🔐 自动登录（如未登录）
593
- - 📥 快速体验：下载 1 个随机作品
402
+ ### 常见使用方式
594
403
 
595
- ---
596
-
597
- <a id="场景-4一次性批量下载"></a>
598
- ### 场景 4：一次性批量下载
599
-
600
- **需求**：一次性下载指定标签的作品
601
-
602
- ```bash
603
- ./scripts/pixiv.sh once # 或 npm run download
604
- ```
404
+ | 场景 | 命令 | 说明 |
405
+ |------|------|------|
406
+ | **快速体验** | `pixivflow random` | 随机下载热门作品，快速上手 |
407
+ | **一次性下载** | `pixivflow download` | 按配置文件执行一次下载 |
408
+ | **定时自动化** | `pixivflow scheduler` | 启动定时任务，自动化收集 |
409
+ | **URL 下载** | `pixivflow download --url <url>` | 直接下载指定作品或用户 |
605
410
 
606
- > 💡 **提示**：所有下载任务通过配置文件实现，无需修改源代码。详细说明请查看 [配置文件使用指南](docs/CONFIG.md)。
411
+ > 💡 **详细配置示例**：查看 [配置文件使用指南](docs/CONFIG.md) 了解各种使用场景的完整配置方法
607
412
 
608
413
  ---
609
414
 
@@ -611,355 +416,73 @@ pixivflow random --novel
611
416
  <a id="核心配置"></a>
612
417
  ## 核心配置
613
418
 
614
- 配置文件位于 `config/standalone.config.json`。以下是关键配置项说明：
615
-
616
- <a id="认证配置"></a>
617
- ### 认证配置
618
-
619
- ```json
620
- {
621
- "pixiv": {
622
- "refreshToken": "your_refresh_token_here",
623
- "clientId": "MOBrBDS8blbauoSck0ZfDbtuzpyT",
624
- "clientSecret": "lsACyCD94FhDUtGTXi3QzcFE2uU1hqtDaKeqrdwj",
625
- "deviceToken": "pixiv",
626
- "userAgent": "PixivAndroidApp/5.0.234 (Android 11; Pixel 6)"
627
- }
628
- }
629
- ```
630
-
631
- > ⚠️ `refreshToken` 通过配置向导自动获取，无需手动填写
632
- > ⚠️ `deviceToken` 默认值为 `"pixiv"`，通常不需要修改
419
+ ### 快速配置
633
420
 
634
- <a id="下载目标"></a>
635
- ### 下载目标
636
-
637
- #### 基础配置
421
+ ```bash
422
+ # 首次使用 - 交互式配置向导
423
+ pixivflow setup
638
424
 
639
- ```json
640
- {
641
- "targets": [
642
- {
643
- "type": "illustration", // illustration 或 novel
644
- "tag": "風景", // 搜索标签（支持多标签，空格分隔）
645
- "limit": 20, // 下载数量限制
646
- "mode": "search" // search（搜索）或 ranking（排行榜）
647
- }
648
- ]
649
- }
425
+ # 或手动编辑配置文件
426
+ pixivflow config edit
650
427
  ```
651
428
 
652
- #### 常用配置选项
653
-
654
- | 选项 | 说明 | 示例 |
655
- |------|------|------|
656
- | `type` | 内容类型 | `"illustration"` 或 `"novel"` |
657
- | `tag` | 搜索标签（支持多标签，空格分隔） | `"原神"` 或 `"明日方舟 アークナイツ"` |
658
- | `limit` | 下载数量限制 | `20` |
659
- | `mode` | 下载模式 | `"search"` 或 `"ranking"` |
660
- | `searchTarget` | 搜索范围 | `"partial_match_for_tags"`（部分匹配）<br>`"exact_match_for_tags"`（精确匹配） |
661
- | `sort` | 排序方式 | `"date_desc"`（最新）<br>`"popular_desc"`（最受欢迎）<br>`"date_asc"`（最旧） |
662
- | `minBookmarks` | 最低收藏数 | `500` |
663
- | `startDate` / `endDate` | 日期范围 | `"2024-01-01"` |
664
- | `random` | 随机选择 | `true` |
665
- | `seriesId` | 小说系列ID | `14690617`（仅 novel） |
666
- | `novelId` | 单篇小说ID | `26132156`（仅 novel） |
667
- | `languageFilter` | 语言过滤 | `"chinese"`（仅中文）<br>`"non-chinese"`（仅非中文） |
668
- | `detectLanguage` | 启用语言检测 | `true`（默认）或 `false`（仅 novel） |
669
-
670
- #### 配置示例
671
-
672
- **基础示例：按标签下载插画**
673
- ```json
674
- {
675
- "targets": [
676
- {
677
- "type": "illustration",
678
- "tag": "風景",
679
- "limit": 20,
680
- "mode": "search"
681
- }
682
- ]
683
- }
684
- ```
429
+ ### 基本配置结构
685
430
 
686
- **进阶示例：按收藏数筛选热门作品**
687
431
  ```json
688
432
  {
689
433
  "targets": [
690
434
  {
691
- "type": "illustration",
692
- "tag": "風景",
693
- "limit": 50,
694
- "mode": "search",
695
- "minBookmarks": 1000,
696
- "sort": "popular_desc"
435
+ "type": "illustration", // 内容类型：illustration 或 novel
436
+ "tag": "風景", // 搜索标签
437
+ "limit": 20, // 下载数量
438
+ "minBookmarks": 500 // 最低收藏数（可选）
697
439
  }
698
- ]
699
- }
700
- ```
701
-
702
- > 💡 **提示**：
703
- > - 在 `tag` 字段中用空格分隔多个标签，表示作品必须同时包含所有标签（AND关系）
704
- > - 使用 `tagRelation: "or"` 可以实现标签并集（任意一个标签即可）
705
- > - `languageFilter` 仅对小说生效，支持 `"chinese"` 或 `"non-chinese"`
706
- > - 📚 **更多配置示例**：查看 [配置文件使用指南](docs/CONFIG.md) 了解所有配置选项和详细示例（多标签搜索、排行榜下载、小说系列下载、语言过滤等）
707
-
708
- > 💡 **日期占位符**：支持 `YESTERDAY`、`TODAY`、`LAST_7_DAYS`、`LAST_30_DAYS` 等，可用于 `startDate`、`endDate`、`rankingDate`
709
- > 📚 **完整配置说明**：查看 [配置指南](docs/CONFIG.md) 了解所有配置选项、占位符和高级用法
710
-
711
- <a id="定时任务"></a>
712
- ### 定时任务
713
-
714
- ```json
715
- {
440
+ ],
716
441
  "scheduler": {
717
- "enabled": true,
718
- "cron": "0 3 * * *", // Cron 表达式
719
- "timezone": "Asia/Shanghai" // 时区
720
- }
721
- }
722
- ```
723
-
724
- **Cron 表达式速查**：
725
- - `0 * * * *` - 每小时执行
726
- - `0 */6 * * *` - 每 6 小时执行
727
- - `0 2 * * *` - 每天 2:00 执行
728
- - `0 0 * * 0` - 每周日 0:00 执行
729
- - `0 0 1 * *` - 每月 1 号 0:00 执行
730
-
731
- <a id="存储配置"></a>
732
- ### 存储配置
733
-
734
- ```json
735
- {
736
- "storage": {
737
- "databasePath": "./data/pixiv-downloader.db",
738
- "downloadDirectory": "./downloads",
739
- "illustrationDirectory": "./downloads/illustrations",
740
- "novelDirectory": "./downloads/novels",
741
- "illustrationOrganization": "byAuthorAndTag",
742
- "novelOrganization": "byDateAndAuthor"
442
+ "enabled": true, // 启用定时任务
443
+ "cron": "0 2 * * *" // 每天 2:00 执行
743
444
  }
744
445
  }
745
446
  ```
746
447
 
747
- **目录组织方式**：
748
- - `flat` - 扁平结构（默认）
749
- - `byAuthor` - 按作者组织
750
- - `byTag` - 按标签组织
751
- - `byDate` - 按日期组织（YYYY-MM）
752
- - `byDay` - 按日组织（YYYY-MM-DD）
753
- - `byAuthorAndTag` - 按作者和标签
754
- - `byDateAndAuthor` - 按日期和作者
755
- - `byDayAndAuthor` - 按日和作者
756
-
757
- > 💡 **提示**：路径支持自动修复，项目启动时会自动检测并修复路径问题。使用 `pixivflow migrate-config` 可手动迁移配置路径。
758
- > 📚 **完整配置说明**：查看 [配置指南](docs/CONFIG.md)
759
-
760
- ---
761
-
762
- ## ✅ 最佳实践
763
-
764
- - **明确配置路径**
765
- - 优先使用 `--config <绝对路径>`，或设置环境变量 `PIXIV_DOWNLOADER_CONFIG`。
766
- - **排行榜 + 标签的替代方案**
767
- - 若想“按标签抓取热门”，优先用 `mode: "search"` + `sort: "popular_desc"`，通常比“ranking + filterTag”更高效、可控。
768
- - **多标签组合**
769
- - `tagRelation: "and"`（默认，必须同时包含所有标签）
770
- - `tagRelation: "or"`（任意一个标签即可，结果会合并去重）
771
- - **时间与时区**
772
- - 定时任务指定 `timezone`（如 `Asia/Shanghai`），避免跨时区偏差。
773
- - **登录与凭据**
774
- - 使用 `pixivflow login --config <path>` 写入 `refreshToken`，勿手动粘贴到仓库。
775
- - **运行前检查**
776
- - 执行 `pixivflow health` 或 `pixivflow config validate`，提前发现配置或网络问题。
777
- - **数据与备份**
778
- - 关注 `storage.databasePath` 与下载目录，定期备份或使用 `pixivflow backup`。
779
-
780
- ---
781
-
782
- ## 🐛 常见问题
783
-
784
- ### ❓ 登录失败？
785
-
786
- ```bash
787
- # 重新登录
788
- npm run login
789
- # 或
790
- ./scripts/pixiv.sh login
791
- ```
792
-
793
- **检查项**：确认用户名密码正确、网络连接正常、代理设置正确
794
-
795
- ---
796
-
797
- ### ❓ 认证失败或 Token 过期？
798
-
799
- ```bash
800
- npm run login # 重新登录获取新 token
801
- ```
802
-
803
- ---
804
-
805
- ### ❓ 找不到匹配的作品？
806
-
807
- **可能原因**：标签拼写错误、筛选条件过严、网络问题
808
-
809
- **解决方法**：
810
- 1. 尝试常见标签：`イラスト`、`風景`、`art`
811
- 2. 降低 `minBookmarks` 值
812
- 3. 检查网络和代理设置
813
- 4. 使用 `partial_match_for_tags` 搜索模式，提高匹配率
814
-
815
- ---
816
-
817
- ### ❓ 下载速度慢或经常失败？
818
-
819
- **解决方法**：
820
- 1. 调整配置：减少 `download.concurrency`（1-2），增加 `download.requestDelay`（1000-2000ms）
821
- 2. 保持 `download.dynamicConcurrency: true`（默认启用），系统会自动调整并发数
822
- 3. 检查网络连接，必要时使用代理
823
-
824
- > 💡 **提示**：内置智能动态并发控制，检测到速率限制（429 错误）时自动降低并发数
448
+ > 📚 **完整配置说明**：查看 [配置文件使用指南](docs/CONFIG.md) 了解所有配置选项和详细示例
825
449
 
826
450
  ---
827
451
 
828
- ### ❓ 定时任务没有运行？
829
-
830
- ```bash
831
- pixivflow status # 查看状态
832
- pixivflow logs # 查看日志
833
- ```
834
-
835
- **确保程序持续运行**：
836
- ```bash
837
- pm2 start "pixivflow scheduler" --name pixivflow
838
- pm2 save && pm2 startup
839
- ```
840
-
841
- ---
452
+ ## 使用建议
842
453
 
843
- > 📖 **更多问题**：查看 [使用指南](docs/USAGE.md) 了解其他常见问题和解决方案（日期过滤、多标签搜索、Android 安装等）
454
+ - 首次使用运行 `pixivflow setup` 进行配置
455
+ - 使用 `pixivflow health` 检查配置和网络状态
456
+ - 定期使用 `pixivflow backup` 备份数据
844
457
 
845
458
  ---
846
459
 
847
- ## 🔒 安全提示
848
-
849
- > ⚠️ **重要**：配置文件包含敏感信息，请务必注意安全
850
-
851
- ### 🛡️ 安全建议
852
-
853
- | 建议 | 说明 |
854
- |------|------|
855
- | ✅ **不要分享配置文件** | `config/standalone.config.json` 包含敏感认证信息 |
856
- | ✅ **不要提交到 Git** | 确保配置文件在 `.gitignore` 中（已默认排除） |
857
- | ✅ **定期备份** | 使用 `pixivflow backup` 备份配置和数据 |
858
- | ✅ **使用强密码** | 保护你的 Pixiv 账号 |
859
- | ✅ **HTTPS 加密** | 所有 API 请求均通过 HTTPS 安全传输 |
860
- | ✅ **定期更新 Token** | 定期重新运行配置向导更新认证信息 |
460
+ ## 🐛 常见问题
861
461
 
862
- ### 🔐 关于 refresh_token
462
+ 遇到问题？试试这些快速解决方案：
863
463
 
864
- `refresh_token` 等同于你的账号密码，拥有它即可访问你的 Pixiv 账户。
464
+ | 问题 | 解决方法 |
465
+ |------|----------|
466
+ | **登录失败** | `pixivflow login` 重新登录 |
467
+ | **找不到作品** | 检查标签拼写，降低 `minBookmarks` 值 |
468
+ | **下载失败** | `pixivflow health` 检查网络和配置 |
469
+ | **定时任务异常** | `pixivflow status` 查看运行状态 |
865
470
 
866
- **如果 refresh_token 泄露：**
867
- 1. 立即在 Pixiv 账户设置中撤销授权
868
- 2. 修改 Pixiv 账户密码
869
- 3. 重新运行配置向导获取新的 token
471
+ > 📖 **详细故障排除**：查看 [使用指南](docs/USAGE.md) 了解完整的问题解决方案
870
472
 
871
473
  ---
872
474
 
873
- ## 📊 下载记录管理
874
-
875
- 所有下载记录保存在 SQLite 数据库中（`data/pixiv-downloader.db`），包括：
876
-
877
- - 作品 ID、标题、作者信息
878
- - 下载时间、文件路径
879
- - 作品统计（浏览量、收藏数等）
880
-
881
- ### 查看下载记录
882
-
883
- ```bash
884
- # 使用 SQLite 命令行工具
885
- sqlite3 data/pixiv-downloader.db "SELECT * FROM downloaded_artworks LIMIT 10;"
886
-
887
- # 或使用图形界面工具
888
- # - DB Browser for SQLite
889
- # - SQLiteStudio
890
- ```
891
-
892
- ### 清理下载记录
893
-
894
- ```bash
895
- # 使用维护命令（推荐）
896
- pixivflow maintain
475
+ ## 安全提示
897
476
 
898
- # 或手动删除数据库（会重新下载所有作品）
899
- rm data/pixiv-downloader.db
900
- ```
477
+ ⚠️ **重要**：配置文件包含敏感的认证信息，请勿分享或提交到代码仓库。如需帮助，请删除敏感信息后再分享配置内容。
901
478
 
902
479
  ---
903
480
 
904
- ## 🚀 进阶使用
905
-
906
- ### 服务器部署
907
-
908
- **方式 1：Docker（推荐）**
909
- ```bash
910
- ./scripts/pixiv.sh docker deploy
911
- ```
912
-
913
- **方式 2：PM2**
914
- ```bash
915
- npm install -g pm2
916
- pm2 start "npm run scheduler" --name pixivflow
917
- pm2 save && pm2 startup
918
- ```
919
-
920
- **方式 3：systemd**
921
- 创建 `/etc/systemd/system/pixivflow.service`，配置后启动：
922
- ```bash
923
- sudo systemctl enable pixivflow && sudo systemctl start pixivflow
924
- ```
925
-
926
- ### 配置多个下载任务
927
-
928
- 在 `targets` 数组中添加多个目标：
929
-
930
- ```json
931
- {
932
- "targets": [
933
- { "type": "illustration", "tag": "風景", "limit": 50 },
934
- { "type": "illustration", "tag": "イラスト", "limit": 30, "minBookmarks": 1000 },
935
- { "type": "novel", "tag": "小説", "limit": 10 }
936
- ]
937
- }
938
- ```
939
-
940
- ### 使用代理
941
-
942
- **方式 1：环境变量（推荐）**
943
- ```bash
944
- export all_proxy=socks5://127.0.0.1:6153
945
- npm run download
946
- ```
481
+ ## 进阶使用
947
482
 
948
- **方式 2：配置文件**
949
- ```json
950
- {
951
- "network": {
952
- "proxy": {
953
- "enabled": true,
954
- "host": "127.0.0.1",
955
- "port": 7890,
956
- "protocol": "http"
957
- }
958
- }
959
- }
960
- ```
483
+ 需要服务器部署、代理配置、多任务管理等高级功能？
961
484
 
962
- > 💡 **提示**：环境变量优先级：`all_proxy` > `https_proxy` > `http_proxy`
485
+ > 📖 **完整指南**：查看 [使用指南](docs/USAGE.md) 和 [Docker 部署指南](docs/DOCKER.md) 了解详细的进阶使用方法
963
486
 
964
487
  ---
965
488
 
@@ -992,14 +515,14 @@ npm run download
992
515
 
993
516
  | 类型 | 渠道 | 说明 |
994
517
  |------|------|------|
995
- | 🐛 **Bug 反馈** | [GitHub Issues](https://github.com/zoidberg-xgd/pixivflow/issues) | 报告问题和错误 |
996
- | 💡 **功能建议** | [GitHub Discussions](https://github.com/zoidberg-xgd/pixivflow/discussions) | 提出新功能想法 |
518
+ | 🐛 **Bug 反馈** | [GitHub Issues](https://github.com/redtidev1918/PixivFlow/issues) | 报告问题和错误 |
519
+ | 💡 **功能建议** | [GitHub Discussions](https://github.com/redtidev1918/PixivFlow/discussions) | 提出新功能想法 |
997
520
  | 📖 **使用问题** | [查看文档](docs/README.md) | 查阅完整文档 |
998
521
  | ✅ **环境检查** | `./scripts/pixiv.sh health` | 运行健康检查 |
999
- | 💬 **社区交流** | [Discussions](https://github.com/zoidberg-xgd/pixivflow/discussions) | 与其他用户交流 |
522
+ | 💬 **社区交流** | [Discussions](https://github.com/redtidev1918/PixivFlow/discussions) | 与其他用户交流 |
1000
523
 
1001
524
  **提问前请先**：
1002
- 1. 🔍 查看 [常见问题](#常见问题) 章节
525
+ 1. 🔍 查看 [常见问题](#-常见问题) 章节
1003
526
  2. 📖 阅读相关文档
1004
527
  3. ✅ 运行健康检查 `./scripts/pixiv.sh health`
1005
528
  4. 📋 查看运行日志 `./scripts/pixiv.sh logs`
@@ -1013,10 +536,10 @@ npm run download
1013
536
 
1014
537
  ### 项目数据
1015
538
 
1016
- ![GitHub repo size](https://img.shields.io/github/repo-size/zoidberg-xgd/pixivflow?style=flat-square)
1017
- ![GitHub language count](https://img.shields.io/github/languages/count/zoidberg-xgd/pixivflow?style=flat-square)
1018
- ![GitHub top language](https://img.shields.io/github/languages/top/zoidberg-xgd/pixivflow?style=flat-square)
1019
- ![GitHub last commit](https://img.shields.io/github/last-commit/zoidberg-xgd/pixivflow?style=flat-square)
539
+ ![GitHub repo size](https://img.shields.io/github/repo-size/redtidev1918/pixivflow?style=flat-square)
540
+ ![GitHub language count](https://img.shields.io/github/languages/count/redtidev1918/pixivflow?style=flat-square)
541
+ ![GitHub top language](https://img.shields.io/github/languages/top/redtidev1918/pixivflow?style=flat-square)
542
+ ![GitHub last commit](https://img.shields.io/github/last-commit/redtidev1918/pixivflow?style=flat-square)
1020
543
 
1021
544
  </div>
1022
545
 
@@ -1077,24 +600,24 @@ npm run download
1077
600
 
1078
601
  ### ⭐ Star 这个项目
1079
602
 
1080
- **[⭐ Star on GitHub](https://github.com/zoidberg-xgd/pixivflow)** - 让更多人发现 PixivFlow！
603
+ **[⭐ Star on GitHub](https://github.com/redtidev1918/PixivFlow)** - 让更多人发现 PixivFlow！
1081
604
 
1082
605
  ---
1083
606
 
1084
- Made with ❤️ by [zoidberg-xgd](https://github.com/zoidberg-xgd)
607
+ Made with ❤️ by [redtidev1918](https://github.com/redtidev1918)
1085
608
 
1086
609
  **PixivFlow** - 让 Pixiv 作品收集变得优雅而高效
1087
610
 
1088
- [⬆ 回到顶部](#pixivflow)
611
+ [⬆ 回到顶部](#-pixivflow)
1089
612
 
1090
613
  ---
1091
614
 
1092
615
  **相关链接**：
1093
616
  - [npm 包](https://www.npmjs.com/package/pixivflow)
1094
- - [GitHub 仓库](https://github.com/zoidberg-xgd/PixivFlow)
1095
- - [前端项目 (pixivflow-webui)](https://github.com/zoidberg-xgd/pixivflow-webui)
617
+ - [GitHub 仓库](https://github.com/redtidev1918/PixivFlow)
618
+ - [前端项目 (pixivflow-webui)](https://github.com/redtidev1918/PixivFlow-webui)
1096
619
  - [完整文档](docs/README.md)
1097
- - [问题反馈](https://github.com/zoidberg-xgd/PixivFlow/issues)
1098
- - [讨论区](https://github.com/zoidberg-xgd/PixivFlow/discussions)
620
+ - [问题反馈](https://github.com/redtidev1918/PixivFlow/issues)
621
+ - [讨论区](https://github.com/redtidev1918/PixivFlow/discussions)
1099
622
 
1100
623
  </div>
package/README_EN.md CHANGED
@@ -6,19 +6,19 @@
6
6
 
7
7
  Make Pixiv artwork collection elegant and efficient | 让 Pixiv 作品收集变得优雅而高效
8
8
 
9
- [![GitHub stars](https://img.shields.io/github/stars/zoidberg-xgd/pixivflow?style=for-the-badge&logo=github)](https://github.com/zoidberg-xgd/pixivflow/stargazers)
10
- [![GitHub forks](https://img.shields.io/github/forks/zoidberg-xgd/pixivflow?style=for-the-badge&logo=github)](https://github.com/zoidberg-xgd/pixivflow/network/members)
11
- [![GitHub issues](https://img.shields.io/github/issues/zoidberg-xgd/pixivflow?style=for-the-badge&logo=github)](https://github.com/zoidberg-xgd/pixivflow/issues)
9
+ [![GitHub stars](https://img.shields.io/github/stars/redtidev1918/pixivflow?style=for-the-badge&logo=github)](https://github.com/redtidev1918/PixivFlow/stargazers)
10
+ [![GitHub forks](https://img.shields.io/github/forks/redtidev1918/pixivflow?style=for-the-badge&logo=github)](https://github.com/redtidev1918/PixivFlow/network/members)
11
+ [![GitHub issues](https://img.shields.io/github/issues/redtidev1918/pixivflow?style=for-the-badge&logo=github)](https://github.com/redtidev1918/PixivFlow/issues)
12
12
  [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg?style=for-the-badge)](https://www.gnu.org/licenses/gpl-3.0)
13
13
 
14
14
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.6+-blue.svg?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
15
15
  [![Node.js](https://img.shields.io/badge/Node.js-18%2B%20LTS-green.svg?style=flat-square&logo=node.js)](https://nodejs.org/)
16
- [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg?style=flat-square)](https://github.com/zoidberg-xgd/pixivflow)
17
- [![Maintenance](https://img.shields.io/badge/Maintained-yes-green.svg?style=flat-square)](https://github.com/zoidberg-xgd/pixivflow/graphs/commit-activity)
16
+ [![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg?style=flat-square)](https://github.com/redtidev1918/PixivFlow)
17
+ [![Maintenance](https://img.shields.io/badge/Maintained-yes-green.svg?style=flat-square)](https://github.com/redtidev1918/PixivFlow/graphs/commit-activity)
18
18
 
19
19
  [Features](#features) • [Quick Start](#quick-start) • [CLI Commands](#cli-commands) • [Scripts](#script-tools) • [Use Cases](#use-cases)
20
20
 
21
- [📖 Full Documentation](https://zoidberg-xgd.github.io/PixivFlow/) | [English](README_EN.md) | [中文](README.md)
21
+ [📖 Full Documentation](https://redtidev1918.github.io/PixivFlow/) | [English](README_EN.md) | [中文](README.md)
22
22
 
23
23
  </div>
24
24
 
@@ -42,14 +42,14 @@ Make Pixiv artwork collection elegant and efficient | 让 Pixiv 作品收集变
42
42
  - [🚀 Quick Start](#quick-start)
43
43
  - [📋 Requirements](#requirements)
44
44
  - [🎬 Quick Start (Recommended)](#quick-start-recommended)
45
- - [🎯 Manual Setup](#manual-setup)
45
+ - [🎯 Manual Setup](#-manual-setup)
46
46
  - [🌐 API Server (Optional)](#api-server-optional)
47
47
  - [🐳 Using Docker (Recommended)](#using-docker-recommended)
48
48
 
49
49
  **Tools & Documentation**
50
50
  - [🎨 CLI Commands](#cli-commands)
51
51
  - [🚀 Core Commands](#core-commands)
52
- - [⚙️ Configuration Management](#configuration-management)
52
+ - [⚙️ Configuration Management](#-configuration-management)
53
53
  - [📊 Monitoring and Maintenance](#monitoring-and-maintenance)
54
54
  - [🛠️ Script Tools](#script-tools)
55
55
  - [🎯 Main Control Script (Most Used)](#main-control-script-most-used)
@@ -57,8 +57,8 @@ Make Pixiv artwork collection elegant and efficient | 让 Pixiv 作品收集变
57
57
  - [🐳 Docker Management](#docker-management)
58
58
  - [📚 Documentation](#documentation)
59
59
  - [🌟 Must Read for Beginners](#must-read-for-beginners)
60
- - [📘 Advanced Documentation](#advanced-documentation)
61
- - [🐳 Docker Documentation](#docker-documentation)
60
+ - [📘 Advanced Docs](https://redtidev1918.github.io/PixivFlow/)
61
+ - [🐳 Docker Guide](docs/DOCKER.md)
62
62
  - [📄 Project Documentation](#project-documentation)
63
63
 
64
64
  **Usage & Configuration**
@@ -68,7 +68,7 @@ Make Pixiv artwork collection elegant and efficient | 让 Pixiv 作品收集变
68
68
  - [Scenario 3: Quick Experience](#scenario-3-quick-experience---random-download)
69
69
  - [Scenario 4: One-Time Batch Download](#scenario-4-onetime-batch-download)
70
70
  - [📁 Project Structure](#project-structure)
71
- - [⚙️ Core Configuration](#core-configuration)
71
+ - [⚙️ Core Configuration](#-core-configuration)
72
72
  - [Authentication Configuration](#authentication-configuration)
73
73
  - [Download Targets](#download-targets)
74
74
  - [Scheduled Tasks](#scheduled-tasks)
@@ -84,12 +84,12 @@ Make Pixiv artwork collection elegant and efficient | 让 Pixiv 作品收集变
84
84
  - [Using Proxy](docs/USAGE.md)
85
85
 
86
86
  **Project Information**
87
- - [📄 Open Source License](#open-source-license)
88
- - [🙏 Acknowledgments](#acknowledgments)
89
- - [📮 Get Help](#get-help)
90
- - [📈 Project Statistics](#project-statistics)
91
- - [🤝 Contributing](#contributing)
92
- - [📝 Changelog](#changelog)
87
+ - [📄 Open Source License](#-open-source-license)
88
+ - [🙏 Acknowledgments](#-acknowledgments)
89
+ - [📮 Get Help](#-get-help)
90
+ - [📈 Project Statistics](#-project-statistics)
91
+ - [🤝 Contributing](#-contributing)
92
+ - [📝 Changelog](#-changelog)
93
93
  - [Support the Project](#support-the-project)
94
94
 
95
95
  </details>
@@ -207,7 +207,7 @@ pixivflow download
207
207
 
208
208
  ```bash
209
209
  # 1. Clone the repository
210
- git clone https://github.com/zoidberg-xgd/pixivflow.git
210
+ git clone https://github.com/redtidev1918/PixivFlow.git
211
211
  cd pixivflow
212
212
 
213
213
  # 2. Install dependencies
@@ -243,7 +243,7 @@ npm install -g pixivflow
243
243
 
244
244
  ```bash
245
245
  # 1. Clone the repository
246
- git clone https://github.com/zoidberg-xgd/pixivflow.git
246
+ git clone https://github.com/redtidev1918/PixivFlow.git
247
247
  cd pixivflow
248
248
 
249
249
  # 2. Install dependencies
@@ -260,7 +260,7 @@ npm install -g .
260
260
 
261
261
  ```bash
262
262
  # Install globally from GitHub repository
263
- npm install -g git+https://github.com/zoidberg-xgd/pixivflow.git
263
+ npm install -g git+https://github.com/redtidev1918/PixivFlow.git
264
264
 
265
265
  # Note: After installation, you may need to build
266
266
  # Find the global installation directory (usually in npm root -g's parent directory/bin)
@@ -321,7 +321,7 @@ npm run build
321
321
  npm install -g .
322
322
 
323
323
  # Method 2: Update from GitHub
324
- npm install -g git+https://github.com/zoidberg-xgd/pixivflow.git
324
+ npm install -g git+https://github.com/redtidev1918/PixivFlow.git
325
325
  ```
326
326
 
327
327
  > **💡 Tips**:
@@ -418,7 +418,7 @@ PORT=8080 pixivflow webui
418
418
 
419
419
  > **Note**:
420
420
  > - PixivFlow only provides backend API, does not include frontend interface
421
- > - **Frontend Project**: Modern React frontend interface, see [pixivflow-webui](https://github.com/zoidberg-xgd/pixivflow-webui)
421
+ > - **Frontend Project**: Modern React frontend interface, see [pixivflow-webui](https://github.com/redtidev1918/PixivFlow-webui)
422
422
  > - Can be called directly via API, or connect to other frontend projects
423
423
  > - **API Documentation**: See [Usage Guide](docs/USAGE.md) for detailed API usage
424
424
 
@@ -1449,13 +1449,13 @@ Having issues? Here are multiple ways to get help:
1449
1449
 
1450
1450
  | Type | Channel | Description |
1451
1451
  |------|---------|-------------|
1452
- | 🐛 **Bug Report** | [GitHub Issues](https://github.com/zoidberg-xgd/pixivflow/issues) | Report issues and bugs |
1453
- | 💡 **Feature Suggestion** | [GitHub Discussions](https://github.com/zoidberg-xgd/pixivflow/discussions) | Propose new feature ideas |
1452
+ | 🐛 **Bug Report** | [GitHub Issues](https://github.com/redtidev1918/PixivFlow/issues) | Report issues and bugs |
1453
+ | 💡 **Feature Suggestion** | [GitHub Discussions](https://github.com/redtidev1918/PixivFlow/discussions) | Propose new feature ideas |
1454
1454
  | 📖 **Usage Questions** | [View Documentation](docs/README.md) | Read complete documentation |
1455
1455
  | 🔧 **Auto-Fix Issues** | `./scripts/pixiv.sh check --fix` | Auto-fix environment issues ⭐ New |
1456
1456
  | 🔄 **Update & Fix** | `./scripts/pixiv.sh update` | One-click update and fix ⭐ New |
1457
1457
  | ✅ **Environment Check** | `./scripts/pixiv.sh health` | Run health check |
1458
- | 💬 **Community Discussion** | [Discussions](https://github.com/zoidberg-xgd/pixivflow/discussions) | Discuss with other users |
1458
+ | 💬 **Community Discussion** | [Discussions](https://github.com/redtidev1918/PixivFlow/discussions) | Discuss with other users |
1459
1459
  | 🔍 **FAQ** | [FAQ](#-faq) | View FAQ |
1460
1460
 
1461
1461
  ### Search Keywords
@@ -1486,10 +1486,10 @@ If you're looking for similar tools, these keywords might help:
1486
1486
 
1487
1487
  ### Project Data
1488
1488
 
1489
- ![GitHub repo size](https://img.shields.io/github/repo-size/zoidberg-xgd/pixivflow?style=flat-square)
1490
- ![GitHub language count](https://img.shields.io/github/languages/count/zoidberg-xgd/pixivflow?style=flat-square)
1491
- ![GitHub top language](https://img.shields.io/github/languages/top/zoidberg-xgd/pixivflow?style=flat-square)
1492
- ![GitHub last commit](https://img.shields.io/github/last-commit/zoidberg-xgd/pixivflow?style=flat-square)
1489
+ ![GitHub repo size](https://img.shields.io/github/repo-size/redtidev1918/pixivflow?style=flat-square)
1490
+ ![GitHub language count](https://img.shields.io/github/languages/count/redtidev1918/pixivflow?style=flat-square)
1491
+ ![GitHub top language](https://img.shields.io/github/languages/top/redtidev1918/pixivflow?style=flat-square)
1492
+ ![GitHub last commit](https://img.shields.io/github/last-commit/redtidev1918/pixivflow?style=flat-square)
1493
1493
 
1494
1494
  </div>
1495
1495
 
@@ -1547,21 +1547,21 @@ If this project helps you, please consider:
1547
1547
 
1548
1548
  ### ⭐ Star This Project
1549
1549
 
1550
- **[⭐ Star on GitHub](https://github.com/zoidberg-xgd/pixivflow)** - Let more people discover PixivFlow!
1550
+ **[⭐ Star on GitHub](https://github.com/redtidev1918/PixivFlow)** - Let more people discover PixivFlow!
1551
1551
 
1552
1552
  ---
1553
1553
 
1554
1554
  **Related Links**:
1555
1555
  - [npm Package](https://www.npmjs.com/package/pixivflow)
1556
- - [GitHub Repository](https://github.com/zoidberg-xgd/PixivFlow)
1557
- - [Frontend Project (pixivflow-webui)](https://github.com/zoidberg-xgd/pixivflow-webui)
1556
+ - [GitHub Repository](https://github.com/redtidev1918/PixivFlow)
1557
+ - [Frontend Project (pixivflow-webui)](https://github.com/redtidev1918/PixivFlow-webui)
1558
1558
  - [Full Documentation](docs/README.md)
1559
- - [Issue Tracker](https://github.com/zoidberg-xgd/PixivFlow/issues)
1560
- - [Discussions](https://github.com/zoidberg-xgd/PixivFlow/discussions)
1559
+ - [Issue Tracker](https://github.com/redtidev1918/PixivFlow/issues)
1560
+ - [Discussions](https://github.com/redtidev1918/PixivFlow/discussions)
1561
1561
 
1562
1562
  ---
1563
1563
 
1564
- Made with ❤️ by [zoidberg-xgd](https://github.com/zoidberg-xgd)
1564
+ Made with ❤️ by [redtidev1918](https://github.com/redtidev1918)
1565
1565
 
1566
1566
  **PixivFlow** - Make Pixiv artwork collection elegant and efficient
1567
1567
 
package/dist/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "type": "commonjs",
3
3
  "name": "pixivflow",
4
- "version": "2.0.39",
4
+ "version": "2.0.42",
5
5
  "private": true
6
6
  }
package/dist/webui/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "type": "commonjs",
3
3
  "name": "pixivflow-webui-backend",
4
- "version": "2.0.39",
4
+ "version": "2.0.42",
5
5
  "description": "PixivFlow WebUI Backend - CommonJS module"
6
6
  }
package/package.json CHANGED
@@ -1,16 +1,16 @@
1
1
  {
2
2
  "name": "pixivflow",
3
- "version": "2.0.40",
3
+ "version": "2.0.42",
4
4
  "description": "🎨 智能的 Pixiv 自动化下载工具 - 支持批量下载插画和小说、定时任务、Docker部署 | Intelligent Pixiv Automation Downloader with batch download, scheduler, and Docker support",
5
5
  "repository": {
6
6
  "type": "git",
7
- "url": "git+https://github.com/zoidberg-xgd/PixivFlow.git"
7
+ "url": "git+https://github.com/redtidev1918/PixivFlow.git"
8
8
  },
9
- "homepage": "https://zoidberg-xgd.github.io/PixivFlow/",
9
+ "homepage": "https://redtidev1918.github.io/PixivFlow/",
10
10
  "bugs": {
11
- "url": "https://github.com/zoidberg-xgd/PixivFlow/issues"
11
+ "url": "https://github.com/redtidev1918/PixivFlow/issues"
12
12
  },
13
- "author": "zoidberg-xgd",
13
+ "author": "redtidev1918",
14
14
  "license": "GPL-3.0-or-later",
15
15
  "main": "dist/index.js",
16
16
  "bin": {
@@ -111,7 +111,7 @@
111
111
  "undici": "^6.19.8"
112
112
  },
113
113
  "engines": {
114
- "node": "^18.14.0 || ^20.0.0 || ^22.0.0 || ^23.0.0 || >=24.0.0",
114
+ "node": "^18.14.0 || ^20.0.0 || ^22.0.0",
115
115
  "npm": ">=9.0.0"
116
116
  },
117
117
  "overrides": {