# 登录页面配置功能说明

## 功能概述

现在可以通过配置文件来控制小红书登录时获取Cookie的来源页面，支持两种选项：
- **creator**: 创作者中心 (https://creator.xiaohongshu.com/login)
- **home**: 小红书首页 (https://www.xiaohongshu.com)

## 配置方法

### 1. 修改配置文件

在 `config.dev.yaml` 或 `config.prod.yaml` 中找到 `login` 配置节：

```yaml
# ========== 登录/绑定功能配置 ==========
login:
  headless: false  # 登录/绑定时的浏览器模式
  page: "creator"  # 登录页面类型: creator 或 home
```

将 `page` 的值修改为你想要的登录页面：
- `"creator"`: 使用创作者中心登录页
- `"home"`: 使用小红书首页登录

### 2. 重启服务

修改配置后需要重启Python后端服务使配置生效：

```bash
# Windows
cd backend
.\start.bat

# Linux
cd backend
./start.sh
```

## API参数覆盖

即使配置了默认值，API请求仍然可以通过 `login_page` 参数临时覆盖配置：

```javascript
// 发送验证码
POST /api/xhs/send-code
{
  "phone": "13800138000",
  "country_code": "+86",
  "login_page": "home"  // 可选，不传则使用配置文件默认值
}

// 登录
POST /api/xhs/login
{
  "phone": "13800138000",
  "code": "123456",
  "country_code": "+86",
  "login_page": "home",  // 可选，不传则使用配置文件默认值
  "session_id": "xxx"
}
```

## 优先级说明

1. **最高优先级**: API请求中的 `login_page` 参数
2. **默认值**: 配置文件中的 `login.page` 配置
3. **兜底值**: 如果都未配置，默认使用 `creator`

## 测试验证

运行测试脚本验证配置是否正确：

```bash
cd backend
python test_login_page_config.py
```

## 配置影响范围

修改 `login.page` 配置会影响以下功能：

1. **发送验证码接口** (`/api/xhs/send-code`)
2. **登录接口** (`/api/xhs/login`)
3. **浏览器池预热URL** (根据配置自动调整)

## 注意事项

1. 两个登录页面的HTML结构可能略有不同，如遇到问题请切换尝试
2. 建议在开发环境先测试再应用到生产环境
3. 配置修改后需要重启服务才能生效
4. 如果API明确传入了 `login_page` 参数，会优先使用API参数而不是配置文件

## 示例场景

### 场景1：全局使用创作者中心
```yaml
login:
  page: "creator"
```
不传API参数时，所有请求都使用创作者中心登录。

### 场景2：全局使用首页，但个别请求使用创作者中心
```yaml
login:
  page: "home"
```
大部分请求使用首页，但特殊情况下API可以传 `"login_page": "creator"` 临时切换。