# 站点维护

## 新增站点

### 基本配置
```yaml
site_url: "/attendance.php"  # 建议设为签到页面
cookie: "xxxxxx"            # 通过F12开发者工具获取
user_agent: "Mozilla/5.0"   # 需与Cookie同时配置
```

### 馒头(M-Team)特殊配置
1. **User-Agent配置**
   ℹ️ 设置User-Agent

2. **令牌获取步骤**
   - 登录馒头站点
   - 进入控制台 > 实验室 > 存取令牌
   - 点击"建立存取令牌"生成新令牌
   - 复制生成的令牌

3. **请求头配置**
   在[站点维护](/site/list)中添加请求头参数，格式为：
   ```json
   {"x-api-key": "你的令牌"}
   ```

### 肉丝(Rousi)特殊配置
1. **Passkey 获取步骤**
   - 登录肉丝站点
   - 进入「账户设置」
   - 复制「Passkey」

2. **请求头配置**
   在[站点维护](/site/list)中添加请求头参数，格式为：
   ```json
   {"Authorization": "Bearer 你的Passkey"}
   ```
   ⚠️ 注意：Passkey 需要包含 `Bearer ` 前缀

3. **签到配置（可选）**
   - 如果需要自动签到功能，需要在请求头中额外添加签到专用 token：
   ```json
   {"x-sign-token": "你的签到令牌"}
   ```
   - 或者通过 CookieCloud 同步 local_storage 中的 token 数据

### 功能设置
| 选项 | 说明 |
|------|------|
| 订阅 | 启用后可用于RSS订阅 |
| 刷流 | 启用后可用于刷流任务 |
| 数据统计 | 启用后收集站点数据 |
| 站点搜索 | 需在内建索引器中单独设置 |

### 高级配置
- **RSS订阅地址**
  ℹ️ 用于[电影订阅](/rss/movie)/[电视剧订阅](/rss/tv)和刷流
  ⚠️ 解析种子详情会增加站点压力

- **浏览器自动化**
  ℹ️ 需要拉取含浏览器内核的镜像
  ⚠️ 大幅增加数据获取耗时

- **代理服务器**
  ℹ️ 需先在[代理设置](/system/basic)中配置

## 更新站点Cookie

- 点击站点卡片的`圆点图标`打开更新站点Cookie对话框（当前环境无浏览器内核时该图标不可见）。
- 输入用户名、密码后，自动调用浏览器模拟人工登录操作，获取Cookie和UA并更新到站点中。
- 可选择自动识别验证码或手工输入验证码，自动识别验证码成功率在90%左右。

## 站点连通性测试

- 通过该功能测试站点是否连通，根据报错信息调整站点设置和网络环境，错误排查参考：[站点无法连通](#常见问题)。

# 数据统计

数据统计页面位于 [/site/statistics](/site/statistics)。

## 自动刷新

- 在[基础设置 > 服务配置](/system/basic)中配置自动刷新数据周期，打开`站点消息`后将发送当日增量数据情况。

## 手动刷新

- 点击`站点数据`栏的刷新按钮，可立即刷新所有站点数据。
- 点击`站点图标`，可立即刷新该站点数据。

## 数据分享

- 点击`站点数据`栏的分享按钮，可生成站点统计数据图片，并自动对敏感信息进行模糊处理，用于分享求邀等。

# 刷流规则

刷流规则页面位于 [/brush/rules](/brush/rules)。

刷流规则是模板化的规则配置，包含选种规则、删种规则和停种规则，供刷流任务引用。

## 新增刷流规则

- **规则名称**：规则模板名称，便于在任务中选择引用。
- **选种规则**：配置筛选条件，如站点、促销类型、体积范围、做种人数等。
- **删种规则**：配置自动删除条件，如分享率、做种时间、上传量/下载量阈值等。
- **停种规则**：配置暂停条件，如达到指定分享率或做种时间后停止做种。

> 规则本身不会执行，需要在[刷流任务](/brush)中引用后才能生效。
{.is-info}

# 刷流任务

刷流任务页面位于 [/brush](/brush)。

## 新增刷流任务

⚠️ **安全警告**
刷流功能存在风险，极端情况可能导致保种丢失！
✅ 建议方案：使用独立的下载器专门处理刷流任务

- **执行周期**：支持`5位cron`表达式。
- **引用规则**：选择已创建的[刷流规则](/brush/rules)，任务将按照规则中的选种/删种/停种逻辑执行。
- **促销**：选`全部`即不过滤，会下载到非促销的种子；免费包括2X免费。促销选项没有`FREE`选项时，说明当前不支持该站点的刷流，请谨慎使用。
- **Hit&Run**：过滤`HR`，没有HR选项时，说明当前不支持该站点的刷流，请谨慎使用。
- **同时下载任务数**：当前任务允许下载器中有多少个任务同时下载（全局），超过时不添加下载。需要优先保障刷流的任务可以设置更大的同时下载任务数。

> **下载器版本要求**：QB版本要求`>=4.3.9`，TR版本要求`>=3.0`，其它版本可能存在适配问题，导致无法正常管理种子。
{.is-success}

> `促销`选择`全部`时，会下载到非FREE的种子，只有状态为**绿色**图标时才是只下载FREE种子状态。
{.is-warning}

## 查看刷流种子清单

- 点击刷流任务的 <kbd>预览</kbd> 按钮，可以查看当前刷流任务管理的种子列表；手动在下载器删除的种子将在下一个同步周期后在此处显示。
- 如种子清单与下载器实际任务不一致，请检查下载器版本以及下载器是否连接稳定。

## 启动与暂停

- 点击刷流任务的`闪电图标`可以立即运行一次任务。
- 选中刷流任务后可`批量开始`和`批量停止`选中任务，未选中时默认全部任务。
- `停止下载新种状态`：设置为该状态后不会下载新的种子，但已下载的种子会继续维护，正常统计下载上传量以及删种。

# 站点配置热更新

站点配置（各站点的解析规则、API 定义等）支持远程热更新，无需等待后端发版。

## 自动更新

容器启动时会自动检查 `nexus-media-sites` 仓库的最新 release：
- 发现新版本时自动下载并替换本地配置
- 更新失败时保留当前配置，不影响正常使用

## 手动更新

在 **设置 > 基础设置** 页面顶部，点击「更新站点配置」按钮可手动触发：
- 显示当前版本和远程版本
- 有新版本时按钮变为高亮状态
- 更新后即时生效，无需重启

## 工作原理

1. 站点配置从镜像内置的 `config/sites/` 解耦
2. 持久化存储在 `/config/sites/` 目录（Docker 卷挂载）
3. `SiteEngine` 优先加载 `/config/sites/`，不存在时回退到内置配置

# 站点资源

站点资源页面位于 [/site/resources](/site/resources)。

- 在[站点维护](/site/list)中维护好站点后，只要被本工具支持，就会在这里显示站点卡片，点击卡片可以显示站点首页的资源。
- 如无法正常显示站点资源，请检查cookie和站点连通性。

## 批量下载

- 选中站点资源，点击`一键下载`按钮，可批量添加任务至下载器。

# 附录

## 常见问题
❓ **站点无法连通**
✅ 检查项：
1. Cookie是否有效
2. 网络连接是否正常
3. 是否配置了正确的代理

❓ **自动签到失败**
✅ 排查步骤：
1. 确认站点地址是否为签到页面
2. 检查Cookie和UA是否匹配
3. 验证浏览器自动化是否必要