# 自动登录网站并管理Cookies项目开发文档

## 1. 项目概述

本项目使用Python语言和DrissionPage库开发一个自动化脚本，用于按顺序登录多个网站，保持登录状态一段时间后保存更新的cookies，并关闭网站。该应用支持配置多个网站、自定义保持登录时间、自动管理cookies以及完整的日志记录系统。

## 2. 功能需求

- 从配置文件读取网站地址和对应的cookies信息
- 按顺序登录每个网站
- 登录成功后依次打开多个网页（支持全局duration配置）
- 保存更新后的cookies信息到配置文件
- 关闭网站浏览器实例
- 完整的日志记录功能
- 支持自定义浏览器路径配置

## 3. 技术栈

- Python 3.8+
- DrissionPage库（用于浏览器自动化）
- JSON用于配置文件格式
- Python标准库logging（用于日志记录）

## 4. 项目结构

```
autoLogon/
├── main.py             # 应用主入口
├── login_manager.py    # 登录管理器
├── config.py           # 配置管理器
├── logger_config.py    # 日志配置
├── config.json         # 配置文件
├── requirements.txt    # 依赖列表
├── README.md           # 项目说明文档
└── log/                # 日志文件夹（自动创建）
```

## 5. 模块设计

### 5.1 配置管理器 (config.py)

**功能**：负责加载、保存和管理应用配置，包括网站列表、浏览器路径等信息。

**主要类和方法**：
- `ConfigManager`: 配置管理类
  - `__init__(config_file='config.json')`: 初始化配置管理器
  - `load_config()`: 加载配置文件，处理文件不存在或格式错误的情况
  - `save_config(config)`: 保存配置到文件
  - `get_sites()`: 获取所有网站配置
  - `add_site(site_config)`: 添加网站配置
  - `update_site(site_name, updated_config)`: 更新网站配置
  - `delete_site(site_name)`: 删除网站配置

### 5.2 登录管理器 (login_manager.py)

**功能**：负责浏览器的初始化、网站登录、cookies管理和会话维护。

**主要类和方法**：
- `LoginManager`: 登录管理类
  - `__init__()`: 初始化登录管理器
  - `login(site_url, cookies=None)`: 登录网站，支持设置cookies
  - `maintain_login(duration=120)`: 保持登录状态指定时间
  - `save_cookies()`: 获取所有页面的cookies
  - `close()`: 关闭浏览器页面

### 5.3 日志配置器 (logger_config.py)

**功能**：设置全局日志记录器，支持文件和控制台双重输出。

**主要类和方法**：
- `LoggerConfig`: 日志配置类
  - `setup_logger(log_level=logging.INFO)`: 设置日志记录器
- `global_logger`: 全局日志记录器实例

### 5.4 主程序模块 (main.py)

**功能**：应用主入口，协调各模块工作流程。

**主要类和方法**：
- `AutoLoginApp`: 自动登录应用主类
  - `__init__()`: 初始化自动登录应用
  - `run()`: 运行自动登录应用，执行完整的登录流程

**主要流程**：
1. 初始化配置管理器和登录管理器
2. 加载配置文件
3. 遍历处理每个网站配置
   - 获取网站URL和cookies信息
   - 登录网站
   - 保持登录状态指定时间
   - 获取并更新cookies
4. 保存更新后的配置到文件
5. 关闭浏览器资源

## 6. 配置文件格式 (JSON)

```json
{
  "duration": 30,
  "browser_path": "C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe",
  "sites": [
    {
          "name": "网站名称",
          "url": "网站URL",
          "cookies": [
        {
          "name": "cookie名称",
          "value": "cookie值",
          "domain": "域名",
          "path": "/",
          "expires": 0,
          "secure": false,
          "httpOnly": false
        }
      ]
    }
  ]
}
```

**配置项说明**：
- `duration`: 处理每个网站时的延时时间（秒），默认30秒
- `browser_path`: 浏览器可执行文件路径（可选）
- `sites`: 网站配置列表
  - `name`: 网站名称
  - `url`: 网站URL
  - `cookies`: cookies列表，每个cookie包含完整信息（name, value, domain等）
```

## 7. 依赖安装

```bash
pip install -r requirements.txt
```

requirements.txt内容：
```
drissionpage
```

## 8. 实现步骤

1. 创建项目目录结构
2. 编写日志配置模块 (logger_config.py)
3. 编写配置管理器模块 (config.py)
4. 编写登录管理器模块 (login_manager.py)
5. 编写主程序模块 (main.py)
6. 创建配置文件示例 (config.json)
7. 测试各个模块
8. 整合测试

## 9. 注意事项

- 确保使用正确的cookies格式，支持列表格式
- 处理可能的登录失败情况，程序有完整的异常处理
- 考虑网站的反爬机制，避免频繁操作
- 妥善保存配置文件，cookies可能包含敏感信息
- 处理网络异常和超时情况
- 确保正确配置浏览器路径，默认为Edge浏览器
- 程序运行时需要有足够权限启动浏览器

## 10. 扩展功能建议

- 实现登录失败重试机制
- 添加多线程或异步支持以提高效率
- 实现定时任务功能
- 添加GUI界面便于操作
- 添加cookies加密存储功能
- 实现更智能的登录验证机制
- 添加多浏览器支持
- 实现命令行参数解析功能