109 lines
2.6 KiB
Markdown
109 lines
2.6 KiB
Markdown
# 登录页面配置功能说明
|
||
|
||
## 功能概述
|
||
|
||
现在可以通过配置文件来控制小红书登录时获取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"` 临时切换。
|