pixivflow 2.0.39 → 2.0.41

package/README.md

@@ -22,84 +22,15 @@
 [![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)
 [![Maintenance](https://img.shields.io/badge/Maintained-yes-green.svg?style=for-the-badge)](https://github.com/zoidberg-xgd/pixivflow/graphs/commit-activity)
 
-[功能特性](#功能特性) • [快速开始](#快速开始) • [CLI 命令](#cli-命令行工具) • [脚本工具](#脚本工具) • [使用场景](#使用场景)
-
 [📖 完整教程文档](https://zoidberg-xgd.github.io/PixivFlow/) | [English](README_EN.md) | [中文](README.md)
 
 </div>
 
 ---
 
-## 目录
-
-<details>
-<summary><b>点击展开完整目录</b></summary>
-
-<br>
-
-**入门指南**
-- [什么是 PixivFlow？](#什么是-pixivflow)
-  - [为什么选择 PixivFlow？](#为什么选择-pixivflow)
-  - [核心理念](#核心理念)
-- [功能特性](#功能特性)
-  - [核心功能](#核心功能)
-  - [额外优势](#额外优势)
-- [快速开始](#快速开始)
-  - [环境要求](#环境要求)
-  - [快速安装（推荐 ⭐）](#快速安装推荐)
-  - [安装方式说明](#安装方式说明)
-  - [WebUI 后端 API（可选）](#webui-后端-api可选)
-  - [Docker 部署（推荐）](#docker-部署推荐)
-
-**工具与文档**
-- [CLI 命令行工具](#cli-命令行工具)
-  - [核心命令](#核心命令)
-  - [配置管理](#配置管理)
-  - [监控与维护](#监控与维护)
-- [脚本工具](#脚本工具)
-  - [主控脚本（最常用）](#主控脚本最常用)
-  - [无图形界面服务器的登录方式（使用现有 refresh token）](#无图形界面服务器的登录方式使用现有-refresh-token)
-- [文档导航](#文档导航)
-  - [新手必读（按顺序阅读）](#新手必读按顺序阅读)
-  - [功能指南](#功能指南)
-  - [部署和环境](#部署和环境)
-  - [项目文档](#项目文档)
-
-**使用与配置**
-- [使用场景](#使用场景)
-  - [场景 1：每日自动收集灵感素材](#场景-1每日自动收集灵感素材)
-  - [场景 2：服务器定时收集特定标签](#场景-2服务器定时收集特定标签)
-  - [场景 3：快速体验 - 随机下载](#场景-3快速体验-随机下载)
-  - [场景 4：一次性批量下载](#场景-4一次性批量下载)
-- [项目结构](#项目结构)
-- [核心配置](#核心配置)
-  - [认证配置](#认证配置)
-  - [下载目标](#下载目标)
-  - [定时任务](#定时任务)
-  - [存储配置](#存储配置)
-
-**故障排除与进阶**
-- [常见问题](docs/USAGE.md)
-- [安全提示](docs/USAGE.md)
-- [下载记录管理](docs/USAGE.md)
-- [进阶使用](docs/USAGE.md)
-  - [服务器部署](docs/DOCKER.md)
-  - [配置多个下载任务](docs/CONFIG.md)
-  - [使用代理](docs/USAGE.md)
-
-**最佳实践**
-- [最佳实践](docs/USAGE.md)
-
-**项目信息**
-- [开源许可](#开源许可)
-- [致谢](#致谢)
-- [获取帮助](#获取帮助)
-- [项目统计](#项目统计)
-- [贡献](#贡献)
-- [更新日志](#更新日志)
-- [支持项目](#支持项目)
-
-</details>
+## 快速导航
+
+[功能特性](#功能特性) • [快速开始](#快速开始) • [使用指南](#cli-命令行工具) • [配置说明](#核心配置) • [完整文档](docs/README.md)
 
 ---
 
@@ -108,17 +39,7 @@
 
 **PixivFlow** 是一个**完全独立运行**的 Pixiv 作品批量下载工具，专为自动化设计。无需浏览器扩展，可在命令行或服务器上自动化运行，支持定时任务、智能去重、断点续传等功能。
 
-作为一款专业的 **Pixiv 下载器**，PixivFlow 支持以下核心功能：
-- 📥 **批量下载 Pixiv 插画和小说**：支持按标签、用户、收藏数等条件批量下载作品
-- 🔗 **URL 直接下载**：支持直接输入 Pixiv URL 进行下载，无需修改配置文件
-- 🎯 **单作品下载**：支持通过作品ID直接下载单个插画或小说
-- ⏰ **定时自动下载**：使用 Cron 表达式配置定时任务，实现自动化下载
-- 🐳 **Docker 部署**：支持 Docker 容器化部署，一键启动
-- 🔐 **安全认证**：采用 OAuth 2.0 PKCE 标准流程，保障账号安全
-- 💾 **智能去重**：自动记录下载历史，避免重复下载
-- 🔄 **断点续传**：下载中断后自动恢复，无需重新开始
-
-无论是个人使用还是服务器部署，PixivFlow 都能帮助你高效地收集和管理 Pixiv 作品。
+作为一款专业的 **Pixiv 下载器**，PixivFlow 提供批量下载、URL 直接下载、定时任务、Docker 部署等核心功能，无论是个人使用还是服务器部署，都能帮助你高效地收集和管理 Pixiv 作品。
 
 <a id="为什么选择-pixivflow"></a>
 ### 为什么选择 PixivFlow？
@@ -127,12 +48,12 @@
 
 | 优势 | 说明 |
 |------|------|
-| 🚀 **完全独立运行** | 无需浏览器扩展，纯命令行工具，可在任何环境运行（服务器、Docker、CI/CD） |
-| 🤖 **真正的自动化** | 设置一次，永久运行。支持 Cron 定时任务，无需人工干预 |
-| 🖥️ **服务器友好** | 专为服务器设计，支持后台运行、进程管理、日志轮转 |
-| 🔐 **安全可靠** | 采用 OAuth 2.0 PKCE 标准流程，保障账号安全，避免密码泄露风险 |
-| 📦 **轻量级部署** | 资源占用低，无需额外服务（如数据库、Redis），SQLite 即可 |
-| 🛠️ **开箱即用** | 丰富的脚本工具和配置向导，3 步即可开始使用 |
+| **完全独立运行** | 无需浏览器扩展，纯命令行工具，可在任何环境运行（服务器、Docker、CI/CD） |
+| **真正的自动化** | 设置一次，永久运行。支持 Cron 定时任务，无需人工干预 |
+| **服务器友好** | 专为服务器设计，支持后台运行、进程管理、日志轮转 |
+| **安全可靠** | 采用 OAuth 2.0 PKCE 标准流程，保障账号安全，避免密码泄露风险 |
+| **轻量级部署** | 资源占用低，无需额外服务（如数据库、Redis），SQLite 即可 |
+| **开箱即用** | 丰富的脚本工具和配置向导，3 步即可开始使用 |
 
 <a id="核心理念"></a>
 ### 核心理念
@@ -152,26 +73,26 @@
 
 | 功能 | 说明 |
 |------|------|
-| **📥 批量下载** | 支持插画和小说批量下载，可配置下载数量、筛选条件 |
-| **🏷️ 标签搜索** | 按标签搜索作品，支持精确匹配、部分匹配等多种模式 |
-| **🎲 随机下载** | 一键下载随机热门标签作品，快速体验工具功能 |
-| **⏰ 定时任务** | Cron 表达式配置，支持每天、每周、每月定时自动下载 |
-| **🔍 智能筛选** | 按收藏数、日期范围、作品类型等多维度筛选 |
-| **🌐 语言检测** | 自动检测小说语言，支持按语言过滤（仅中文/仅非中文） |
-| **💾 自动去重** | SQLite 数据库记录历史，自动跳过已下载作品 |
-| **🔄 断点续传** | 下载中断后自动恢复，无需重新开始 |
-| **🛡️ 错误处理** | 自动重试、错误恢复、智能跳过已删除/私有作品 |
-| **📊 统计报告** | 详细的运行日志和下载统计报告 |
+| **批量下载** | 支持插画和小说批量下载，可配置下载数量、筛选条件 |
+| **标签搜索** | 按标签搜索作品，支持精确匹配、部分匹配等多种模式 |
+| **随机下载** | 一键下载随机热门标签作品，快速体验工具功能 |
+| **定时任务** | Cron 表达式配置，支持每天、每周、每月定时自动下载 |
+| **智能筛选** | 按收藏数、日期范围、作品类型等多维度筛选 |
+| **语言检测** | 自动检测小说语言，支持按语言过滤（仅中文/仅非中文） |
+| **自动去重** | SQLite 数据库记录历史，自动跳过已下载作品 |
+| **断点续传** | 下载中断后自动恢复，无需重新开始 |
+| **错误处理** | 自动重试、错误恢复、智能跳过已删除/私有作品 |
+| **统计报告** | 详细的运行日志和下载统计报告 |
 
 <a id="额外优势"></a>
 ### 额外优势
 
-- ✅ **完全独立**：无需浏览器，纯命令行工具
-- ✅ **跨平台支持**：Windows / macOS / Linux，可在任何环境运行
-- ✅ **轻量级**：资源占用低，适合服务器长期运行
-- ✅ **开源免费**：GPL-3.0 许可证，可自由定制和分发
-- ✅ **类型安全**：TypeScript 编写，类型提示完善
-- ✅ **文档完善**：详细的中文文档和教程
+- **完全独立**：无需浏览器，纯命令行工具
+- **跨平台支持**：Windows / macOS / Linux，可在任何环境运行
+- **轻量级**：资源占用低，适合服务器长期运行
+- **开源免费**：GPL-3.0 许可证，可自由定制和分发
+- **类型安全**：TypeScript 编写，类型提示完善
+- **文档完善**：详细的中文文档和教程
 
 ---
 
@@ -195,7 +116,7 @@
 > **详细指南**：查看 [快速开始指南](docs/QUICKSTART.md)
 
 <a id="快速安装推荐"></a>
-### 快速安装（推荐 ⭐）
+### 快速安装（推荐）
 
 #### 方式 1：从 npm 安装（最简单）
 
@@ -311,16 +232,16 @@ docker-compose up -d             # 启动服务
 # 全局安装后使用
 pixivflow login                      # 登录 Pixiv 账号
 pixivflow download                   # 执行下载
-pixivflow download --url <url>       # 通过 URL 直接下载（支持插画/小说/系列）⭐
+pixivflow download --url <url>       # 通过 URL 直接下载（支持插画/小说/系列）
 pixivflow random                     # 随机下载
 pixivflow scheduler                  # 启动定时任务
 pixivflow normalize                  # 整理文件
 pixivflow migrate-config             # 迁移配置
-pixivflow health                     # 健康检查（推荐 ⭐）
+pixivflow health                     # 健康检查（推荐）
 pixivflow status                     # 查看下载统计和最近记录
 pixivflow logs                       # 查看运行日志
-pixivflow setup                      # 交互式配置向导（首次使用）⭐
-pixivflow dirs                       # 查看目录信息（文件保存位置）⭐
+pixivflow setup                      # 交互式配置向导（首次使用）
+pixivflow dirs                       # 查看目录信息（文件保存位置）
 ```
 
 **URL 下载示例**：
@@ -355,9 +276,9 @@ pixivflow set-token <your_refresh_token>
 ### 配置管理
 
 ```bash
-pixivflow config                     # 配置管理（查看/编辑/备份/恢复）⭐
+pixivflow config                     # 配置管理（查看/编辑/备份/恢复）
 pixivflow config show                # 查看配置
-pixivflow config set <key> <value>   # 设置配置项（如：storage.downloadDirectory）⭐
+pixivflow config set <key> <value>   # 设置配置项（如：storage.downloadDirectory）
 pixivflow config backup              # 备份配置
 pixivflow config restore             # 恢复配置
 pixivflow config validate            # 验证配置
@@ -380,9 +301,9 @@ pixivflow config set storage.novelDirectory ./my-novels
 ### 监控与维护
 
 ```bash
-pixivflow monitor                    # 实时监控进程状态和性能指标 ⭐
-pixivflow maintain                   # 自动维护（清理日志、优化数据库等）⭐
-pixivflow backup                     # 自动备份配置和数据 ⭐
+pixivflow monitor                    # 实时监控进程状态和性能指标
+pixivflow maintain                   # 自动维护（清理日志、优化数据库等）
+pixivflow backup                     # 自动备份配置和数据
 ```
 
 > 📖 **详细说明**：查看 [脚本使用指南](docs/SCRIPTS.md)
@@ -418,13 +339,13 @@ PixivFlow 提供了丰富的脚本工具，所有脚本直接调用内置 CLI，
 | `health` | 健康检查（检查配置、网络等）<br>**全局安装后使用**: `pixivflow health` |
 | `status` | 查看下载统计和最近记录<br>**全局安装后使用**: `pixivflow status`  |
 | `logs` | 查看运行日志<br>**全局安装后使用**: `pixivflow logs`  |
-| `config` | 配置管理工具（查看/编辑/备份/恢复）<br>**全局安装后使用**: `pixivflow config` ⭐ |
-| `backup` | 自动备份配置和数据<br>**全局安装后使用**: `pixivflow backup` ⭐ |
-| `maintain` | 自动维护（清理日志、优化数据库等）<br>**全局安装后使用**: `pixivflow maintain` ⭐ |
-| `monitor` | 实时监控进程状态和性能指标<br>**全局安装后使用**: `pixivflow monitor` ⭐ |
-| `setup` | 交互式配置向导（首次使用）<br>**全局安装后使用**: `pixivflow setup` ⭐ |
+| `config` | 配置管理工具（查看/编辑/备份/恢复）<br>**全局安装后使用**: `pixivflow config` |
+| `backup` | 自动备份配置和数据<br>**全局安装后使用**: `pixivflow backup` |
+| `maintain` | 自动维护（清理日志、优化数据库等）<br>**全局安装后使用**: `pixivflow maintain` |
+| `monitor` | 实时监控进程状态和性能指标<br>**全局安装后使用**: `pixivflow monitor` |
+| `setup` | 交互式配置向导（首次使用）<br>**全局安装后使用**: `pixivflow setup` |
 
-### ⚙️ 其他工具
+### 其他工具
 
 ```bash
 # 环境检查和修复
@@ -445,165 +366,48 @@ PixivFlow 提供了丰富的脚本工具，所有脚本直接调用内置 CLI，
 
 | 文档 | 说明 |
 |------|------|
-| [⚡ QUICKSTART](docs/QUICKSTART.md) | **3 分钟快速上手** - 最快开始使用 |
-| [🔐 LOGIN](docs/LOGIN.md) | **登录流程详解** - 登录问题解决方案 |
-| [📖 USAGE](docs/USAGE.md) | **使用指南** - 功能使用说明 |
+| [QUICKSTART](docs/QUICKSTART.md) | **3 分钟快速上手** - 最快开始使用 |
+| [LOGIN](docs/LOGIN.md) | **登录流程详解** - 登录问题解决方案 |
+| [USAGE](docs/USAGE.md) | **使用指南** - 功能使用说明 |
 
 ### 功能指南
 
 | 文档 | 说明 |
 |------|------|
-| [📋 CONFIG](docs/CONFIG.md) | **配置文件使用指南** - 所有配置选项详解 |
-| [🛠️ SCRIPTS](docs/SCRIPTS.md) | **脚本使用指南** - 所有脚本详细说明 |
+| [CONFIG](docs/CONFIG.md) | **配置文件使用指南** - 所有配置选项详解 |
+| [SCRIPTS](docs/SCRIPTS.md) | **脚本使用指南** - 所有脚本详细说明 |
 
 ### 部署和环境
 
 | 文档 | 说明 |
 |------|------|
-| [🐳 DOCKER](docs/DOCKER.md) | **Docker 使用指南** - Docker 部署和使用（包含常见问题解决方案） |
-| [📱 TERMUX](docs/TERMUX_INSTALL.md) | **Termux/Android 安装指南** - Android 设备上的安装和使用 |
+| [DOCKER](docs/DOCKER.md) | **Docker 使用指南** - Docker 部署和使用（包含常见问题解决方案） |
+| [TERMUX](docs/TERMUX_INSTALL.md) | **Termux/Android 安装指南** - Android 设备上的安装和使用 |
 
 ### 项目文档
 
 | 文档 | 说明 |
 |------|------|
-| [🏗️ ARCHITECTURE](docs/ARCHITECTURE.md) | **架构说明** - 项目架构和技术实现细节 |
-| [🔄 CLI_MIGRATION](docs/CLI_MIGRATION_SUMMARY.md) | **CLI 命令移植总结** - CLI 命令迁移和功能对照 |
-| [📝 CHANGELOG](docs/project/CHANGELOG.md) | 版本更新日志 |
-| [🤝 CONTRIBUTING](docs/project/CONTRIBUTING.md) | 贡献指南 |
+| [ARCHITECTURE](docs/ARCHITECTURE.md) | **架构说明** - 项目架构和技术实现细节 |
+| [CLI_MIGRATION](docs/CLI_MIGRATION_SUMMARY.md) | **CLI 命令移植总结** - CLI 命令迁移和功能对照 |
+| [CHANGELOG](docs/project/CHANGELOG.md) | 版本更新日志 |
+| [CONTRIBUTING](docs/project/CONTRIBUTING.md) | 贡献指南 |
 
 ---
 
 <a id="使用场景"></a>
 ## 使用场景
 
-<a id="场景-1每日自动收集灵感素材"></a>
-### 场景 1：每日自动收集灵感素材
-
-**需求**：每天自动下载风景、插画类高质量作品作为设计素材
-
-**配置示例**：
-
-```json
-{
-  "targets": [
-    {
-      "type": "illustration",
-      "tag": "風景",
-      "limit": 50,
-      "minBookmarks": 1000
-    },
-    {
-      "type": "illustration",
-      "tag": "イラスト",
-      "limit": 30,
-      "minBookmarks": 5000
-    }
-  ],
-  "scheduler": {
-    "enabled": true,
-    "cron": "0 2 * * *"
-  }
-}
-```
-
-> 提示：支持 `tagRelation: "or"`。当为 `or` 时，会将 `tag` 按空格拆分，逐个标签顺序检索、合并并去重，然后按 `sort` 排序并按 `limit` 截断。建议在该模式下将 `download.requestDelay` 调高（例如 1500~3000ms）以降低速率限制。
-
-**示例 1b：多标签 OR 搜索（逐个标签检索并合并）**
-```json
-{
-  "targets": [
-    {
-      "type": "novel",
-      "tag": "風景 イラスト オリジナル",
-      "tagRelation": "or",
-      "limit": 10,
-      "mode": "search",
-      "searchTarget": "partial_match_for_tags",
-      "sort": "popular_desc"
-    }
-  ]
-}
-```
-
-**运行方式**：
-
-```bash
-./scripts/pixiv.sh run
-```
-
----
-
-<a id="场景-2服务器定时收集特定标签"></a>
-### 场景 2：服务器定时收集特定标签
-
-**需求**：在服务器上每周收集特定标签的热门作品
-
-**配置示例**：
-
-```json
-{
-  "targets": [
-    {
-      "type": "illustration",
-      "tag": "原神",
-      "limit": 100,
-      "searchTarget": "partial_match_for_tags"
-    }
-  ],
-  "scheduler": {
-    "enabled": true,
-    "cron": "0 0 * * 0",
-    "timezone": "Asia/Shanghai"
-  }
-}
-```
-
-**部署方式**：
-
-```bash
-# 使用自动部署脚本
-./scripts/auto-deploy.sh
-
-# 或使用 PM2 管理进程
-pm2 start "npm run scheduler" --name pixivflow
-```
-
----
-
-<a id="场景-3快速体验-随机下载"></a>
-### 场景 3：快速体验 - 随机下载
-
-**需求**：快速体验工具，下载一个随机作品
-
-```bash
-# 随机下载插画（默认）
-npm run random
-# 或
-pixivflow random
-
-# 随机下载小说
-pixivflow random --novel
-```
-
-**功能说明**：
-- 🎲 从热门标签中随机选择（插画：風景、イラスト等；小说：小説、オリジナル等）
-- 🔍 从搜索结果中随机选择作品
-- 🔐 自动登录（如未登录）
-- 📥 快速体验：下载 1 个随机作品
+### 常见使用方式
 
----
-
-<a id="场景-4一次性批量下载"></a>
-### 场景 4：一次性批量下载
-
-**需求**：一次性下载指定标签的作品
-
-```bash
-./scripts/pixiv.sh once    # 或 npm run download
-```
+| 场景 | 命令 | 说明 |
+|------|------|------|
+| **快速体验** | `pixivflow random` | 随机下载热门作品，快速上手 |
+| **一次性下载** | `pixivflow download` | 按配置文件执行一次下载 |
+| **定时自动化** | `pixivflow scheduler` | 启动定时任务，自动化收集 |
+| **URL 下载** | `pixivflow download --url <url>` | 直接下载指定作品或用户 |
 
-> 💡 **提示**：所有下载任务通过配置文件实现，无需修改源代码。详细说明请查看 [配置文件使用指南](docs/CONFIG.md)。
+> 💡 **详细配置示例**：查看 [配置文件使用指南](docs/CONFIG.md) 了解各种使用场景的完整配置方法
 
 ---
 
@@ -611,355 +415,73 @@ pixivflow random --novel
 <a id="核心配置"></a>
 ## 核心配置
 
-配置文件位于 `config/standalone.config.json`。以下是关键配置项说明：
-
-<a id="认证配置"></a>
-### 认证配置
-
-```json
-{
-  "pixiv": {
-    "refreshToken": "your_refresh_token_here",
-    "clientId": "MOBrBDS8blbauoSck0ZfDbtuzpyT",
-    "clientSecret": "lsACyCD94FhDUtGTXi3QzcFE2uU1hqtDaKeqrdwj",
-    "deviceToken": "pixiv",
-    "userAgent": "PixivAndroidApp/5.0.234 (Android 11; Pixel 6)"
-  }
-}
-```
-
-> ⚠️ `refreshToken` 通过配置向导自动获取，无需手动填写  
-> ⚠️ `deviceToken` 默认值为 `"pixiv"`，通常不需要修改
+### 快速配置
 
-<a id="下载目标"></a>
-### 下载目标
-
-#### 基础配置
+```bash
+# 首次使用 - 交互式配置向导
+pixivflow setup
 
-```json
-{
-  "targets": [
-    {
-      "type": "illustration",        // illustration 或 novel
-      "tag": "風景",                 // 搜索标签（支持多标签，空格分隔）
-      "limit": 20,                   // 下载数量限制
-      "mode": "search"               // search（搜索）或 ranking（排行榜）
-    }
-  ]
-}
+# 或手动编辑配置文件
+pixivflow config edit
 ```
 
-#### 常用配置选项
-
-| 选项 | 说明 | 示例 |
-|------|------|------|
-| `type` | 内容类型 | `"illustration"` 或 `"novel"` |
-| `tag` | 搜索标签（支持多标签，空格分隔） | `"原神"` 或 `"明日方舟 アークナイツ"` |
-| `limit` | 下载数量限制 | `20` |
-| `mode` | 下载模式 | `"search"` 或 `"ranking"` |
-| `searchTarget` | 搜索范围 | `"partial_match_for_tags"`（部分匹配）<br>`"exact_match_for_tags"`（精确匹配） |
-| `sort` | 排序方式 | `"date_desc"`（最新）<br>`"popular_desc"`（最受欢迎）<br>`"date_asc"`（最旧） |
-| `minBookmarks` | 最低收藏数 | `500` |
-| `startDate` / `endDate` | 日期范围 | `"2024-01-01"` |
-| `random` | 随机选择 | `true` |
-| `seriesId` | 小说系列ID | `14690617`（仅 novel） |
-| `novelId` | 单篇小说ID | `26132156`（仅 novel） |
-| `languageFilter` | 语言过滤 | `"chinese"`（仅中文）<br>`"non-chinese"`（仅非中文） |
-| `detectLanguage` | 启用语言检测 | `true`（默认）或 `false`（仅 novel） |
-
-#### 配置示例
-
-**基础示例：按标签下载插画**
-```json
-{
-  "targets": [
-    {
-      "type": "illustration",
-      "tag": "風景",
-      "limit": 20,
-      "mode": "search"
-    }
-  ]
-}
-```
+### 基本配置结构
 
-**进阶示例：按收藏数筛选热门作品**
 ```json
 {
   "targets": [
     {
-      "type": "illustration",
-      "tag": "風景",
-      "limit": 50,
-      "mode": "search",
-      "minBookmarks": 1000,
-      "sort": "popular_desc"
+      "type": "illustration",     // 内容类型：illustration 或 novel
+      "tag": "風景",              // 搜索标签
+      "limit": 20,                // 下载数量
+      "minBookmarks": 500         // 最低收藏数（可选）
     }
-  ]
-}
-```
-
-> 💡 **提示**：
-> - 在 `tag` 字段中用空格分隔多个标签，表示作品必须同时包含所有标签（AND关系）
-> - 使用 `tagRelation: "or"` 可以实现标签并集（任意一个标签即可）
-> - `languageFilter` 仅对小说生效，支持 `"chinese"` 或 `"non-chinese"`
-> - 📚 **更多配置示例**：查看 [配置文件使用指南](docs/CONFIG.md) 了解所有配置选项和详细示例（多标签搜索、排行榜下载、小说系列下载、语言过滤等）
-
-> 💡 **日期占位符**：支持 `YESTERDAY`、`TODAY`、`LAST_7_DAYS`、`LAST_30_DAYS` 等，可用于 `startDate`、`endDate`、`rankingDate`  
-> 📚 **完整配置说明**：查看 [配置指南](docs/CONFIG.md) 了解所有配置选项、占位符和高级用法
-
-<a id="定时任务"></a>
-### 定时任务
-
-```json
-{
+  ],
   "scheduler": {
-    "enabled": true,
-    "cron": "0 3 * * *",           // Cron 表达式
-    "timezone": "Asia/Shanghai"     // 时区
-  }
-}
-```
-
-**Cron 表达式速查**：
-- `0 * * * *` - 每小时执行
-- `0 */6 * * *` - 每 6 小时执行
-- `0 2 * * *` - 每天 2:00 执行
-- `0 0 * * 0` - 每周日 0:00 执行
-- `0 0 1 * *` - 每月 1 号 0:00 执行
-
-<a id="存储配置"></a>
-### 存储配置
-
-```json
-{
-  "storage": {
-    "databasePath": "./data/pixiv-downloader.db",
-    "downloadDirectory": "./downloads",
-    "illustrationDirectory": "./downloads/illustrations",
-    "novelDirectory": "./downloads/novels",
-    "illustrationOrganization": "byAuthorAndTag",
-    "novelOrganization": "byDateAndAuthor"
+    "enabled": true,              // 启用定时任务
+    "cron": "0 2 * * *"          // 每天 2:00 执行
   }
 }
 ```
 
-**目录组织方式**：
-- `flat` - 扁平结构（默认）
-- `byAuthor` - 按作者组织
-- `byTag` - 按标签组织
-- `byDate` - 按日期组织（YYYY-MM）
-- `byDay` - 按日组织（YYYY-MM-DD）
-- `byAuthorAndTag` - 按作者和标签
-- `byDateAndAuthor` - 按日期和作者
-- `byDayAndAuthor` - 按日和作者
-
-> 💡 **提示**：路径支持自动修复，项目启动时会自动检测并修复路径问题。使用 `pixivflow migrate-config` 可手动迁移配置路径。  
-> 📚 **完整配置说明**：查看 [配置指南](docs/CONFIG.md)
-
----
-
-## ✅ 最佳实践
-
-- **明确配置路径**
-  - 优先使用 `--config <绝对路径>`，或设置环境变量 `PIXIV_DOWNLOADER_CONFIG`。
-- **排行榜 + 标签的替代方案**
-  - 若想“按标签抓取热门”，优先用 `mode: "search"` + `sort: "popular_desc"`，通常比“ranking + filterTag”更高效、可控。
-- **多标签组合**
-  - `tagRelation: "and"`（默认，必须同时包含所有标签）
-  - `tagRelation: "or"`（任意一个标签即可，结果会合并去重）
-- **时间与时区**
-  - 定时任务指定 `timezone`（如 `Asia/Shanghai`），避免跨时区偏差。
-- **登录与凭据**
-  - 使用 `pixivflow login --config <path>` 写入 `refreshToken`，勿手动粘贴到仓库。
-- **运行前检查**
-  - 执行 `pixivflow health` 或 `pixivflow config validate`，提前发现配置或网络问题。
-- **数据与备份**
-  - 关注 `storage.databasePath` 与下载目录，定期备份或使用 `pixivflow backup`。
-
----
-
-## 🐛 常见问题
-
-### ❓ 登录失败？
-
-```bash
-# 重新登录
-npm run login
-# 或
-./scripts/pixiv.sh login
-```
-
-**检查项**：确认用户名密码正确、网络连接正常、代理设置正确
-
----
-
-### ❓ 认证失败或 Token 过期？
-
-```bash
-npm run login  # 重新登录获取新 token
-```
-
----
-
-### ❓ 找不到匹配的作品？
-
-**可能原因**：标签拼写错误、筛选条件过严、网络问题
-
-**解决方法**：
-1. 尝试常见标签：`イラスト`、`風景`、`art`
-2. 降低 `minBookmarks` 值
-3. 检查网络和代理设置
-4. 使用 `partial_match_for_tags` 搜索模式，提高匹配率
-
----
-
-### ❓ 下载速度慢或经常失败？
-
-**解决方法**：
-1. 调整配置：减少 `download.concurrency`（1-2），增加 `download.requestDelay`（1000-2000ms）
-2. 保持 `download.dynamicConcurrency: true`（默认启用），系统会自动调整并发数
-3. 检查网络连接，必要时使用代理
-
-> 💡 **提示**：内置智能动态并发控制，检测到速率限制（429 错误）时自动降低并发数
+> 📚 **完整配置说明**：查看 [配置文件使用指南](docs/CONFIG.md) 了解所有配置选项和详细示例
 
 ---
 
-### ❓ 定时任务没有运行？
-
-```bash
-pixivflow status    # 查看状态
-pixivflow logs      # 查看日志
-```
-
-**确保程序持续运行**：
-```bash
-pm2 start "pixivflow scheduler" --name pixivflow
-pm2 save && pm2 startup
-```
-
----
+## 使用建议
 
-> 📖 **更多问题**：查看 [使用指南](docs/USAGE.md) 了解其他常见问题和解决方案（日期过滤、多标签搜索、Android 安装等）
+- 首次使用运行 `pixivflow setup` 进行配置
+- 使用 `pixivflow health` 检查配置和网络状态
+- 定期使用 `pixivflow backup` 备份数据
 
 ---
 
-## 🔒 安全提示
-
-> ⚠️ **重要**：配置文件包含敏感信息，请务必注意安全
-
-### 🛡️ 安全建议
-
-| 建议 | 说明 |
-|------|------|
-| ✅ **不要分享配置文件** | `config/standalone.config.json` 包含敏感认证信息 |
-| ✅ **不要提交到 Git** | 确保配置文件在 `.gitignore` 中（已默认排除） |
-| ✅ **定期备份** | 使用 `pixivflow backup` 备份配置和数据 |
-| ✅ **使用强密码** | 保护你的 Pixiv 账号 |
-| ✅ **HTTPS 加密** | 所有 API 请求均通过 HTTPS 安全传输 |
-| ✅ **定期更新 Token** | 定期重新运行配置向导更新认证信息 |
+## 🐛 常见问题
 
-### 🔐 关于 refresh_token
+遇到问题？试试这些快速解决方案：
 
-`refresh_token` 等同于你的账号密码，拥有它即可访问你的 Pixiv 账户。
+| 问题 | 解决方法 |
+|------|----------|
+| **登录失败** | `pixivflow login` 重新登录 |
+| **找不到作品** | 检查标签拼写，降低 `minBookmarks` 值 |
+| **下载失败** | `pixivflow health` 检查网络和配置 |
+| **定时任务异常** | `pixivflow status` 查看运行状态 |
 
-**如果 refresh_token 泄露：**
-1. 立即在 Pixiv 账户设置中撤销授权
-2. 修改 Pixiv 账户密码
-3. 重新运行配置向导获取新的 token
+> 📖 **详细故障排除**：查看 [使用指南](docs/USAGE.md) 了解完整的问题解决方案
 
 ---
 
-## 📊 下载记录管理
-
-所有下载记录保存在 SQLite 数据库中（`data/pixiv-downloader.db`），包括：
-
-- 作品 ID、标题、作者信息
-- 下载时间、文件路径
-- 作品统计（浏览量、收藏数等）
-
-### 查看下载记录
-
-```bash
-# 使用 SQLite 命令行工具
-sqlite3 data/pixiv-downloader.db "SELECT * FROM downloaded_artworks LIMIT 10;"
-
-# 或使用图形界面工具
-# - DB Browser for SQLite
-# - SQLiteStudio
-```
-
-### 清理下载记录
-
-```bash
-# 使用维护命令（推荐）
-pixivflow maintain
+## 安全提示
 
-# 或手动删除数据库（会重新下载所有作品）
-rm data/pixiv-downloader.db
-```
+⚠️ **重要**：配置文件包含敏感的认证信息，请勿分享或提交到代码仓库。如需帮助，请删除敏感信息后再分享配置内容。
 
 ---
 
-## 🚀 进阶使用
-
-### 服务器部署
-
-**方式 1：Docker（推荐）**
-```bash
-./scripts/pixiv.sh docker deploy
-```
-
-**方式 2：PM2**
-```bash
-npm install -g pm2
-pm2 start "npm run scheduler" --name pixivflow
-pm2 save && pm2 startup
-```
-
-**方式 3：systemd**
-创建 `/etc/systemd/system/pixivflow.service`，配置后启动：
-```bash
-sudo systemctl enable pixivflow && sudo systemctl start pixivflow
-```
-
-### 配置多个下载任务
-
-在 `targets` 数组中添加多个目标：
-
-```json
-{
-  "targets": [
-    { "type": "illustration", "tag": "風景", "limit": 50 },
-    { "type": "illustration", "tag": "イラスト", "limit": 30, "minBookmarks": 1000 },
-    { "type": "novel", "tag": "小説", "limit": 10 }
-  ]
-}
-```
-
-### 使用代理
-
-**方式 1：环境变量（推荐）**
-```bash
-export all_proxy=socks5://127.0.0.1:6153
-npm run download
-```
+## 进阶使用
 
-**方式 2：配置文件**
-```json
-{
-  "network": {
-    "proxy": {
-      "enabled": true,
-      "host": "127.0.0.1",
-      "port": 7890,
-      "protocol": "http"
-    }
-  }
-}
-```
+需要服务器部署、代理配置、多任务管理等高级功能？
 
-> 💡 **提示**：环境变量优先级：`all_proxy` > `https_proxy` > `http_proxy`
+> 📖 **完整指南**：查看 [使用指南](docs/USAGE.md) 和 [Docker 部署指南](docs/DOCKER.md) 了解详细的进阶使用方法
 
 ---