# 登录脚本实现笔记

本文记录当前版本豆瓣登录脚本的实现细节、关键函数以及后续可扩展点。滑块验证码相关逻辑已移除，若页面出现额外验证需人工完成。

## 文件结构

```
src/
└── login.ts          # Playwright 入口脚本
```

辅助文档位于项目根目录：

- `README.md`：使用说明与常见问题；
- `ARCHITECTURE.md`：整体架构与流程拆解；
- `login.md`：早期需求说明，可作为手动操作参考。

## 核心流程

1. **读取配置**  
   通过 `process.env.DOUBAN_PHONE` 获取手机号，缺失时直接退出。

2. **准备浏览器上下文** (`prepareContext`)  
   - 若存在 `~/douban-cookie.json`，以 `storageState` 形式加载；  
   - 打开登录页并调用 `isLoggedIn` 校验是否仍在登录态；  
   - 失效时关闭旧上下文并创建全新 session。

3. **执行短信登录** (`loginWithSms`)  
   - 输入手机号 → 点击「获取验证码」；  
   - 控制台提醒用户在浏览器中手动完成滑块等页面验证；  
   - 通过 `prompt` 等待用户输入短信验证码并提交；  
   - 等待 Playwright 检测到页面离开登录地址或抛出超时。

4. **确认状态并写入 Cookie 文件**  
   - `isLoggedIn` 再次判断是否登录成功；  
   - 调用 `context.storageState({ path })` 将状态写入 `~/douban-cookie.json`；  
   - 终端提示成功信息，方便用户确认文件路径。

## 关键函数

### `isLoggedIn(page: Page): Promise<boolean>`

检查 `dbcl2` Cookie 是否存在，并确认登录表单元素是否仍可见。该组合可较准确判断是否处于登录态，同时避免依赖豆瓣首页 DOM。

### `prepareContext(browser: Browser)`

负责上下文复用策略：优先尝试加载本地 Cookie 创建上下文，如果判定仍未登录则回退到全新会话并跳转登录页。函数返回 `{ context, page, usedCookies }`，调用方可据此判断是否需要重走登录流程。

### `loginWithSms(page: Page, phone: string)`

串联短信验证码登录的主要逻辑，所有用户交互点都通过控制台提示：

- 页面操作由脚本自动完成（填手机号、点击按钮）；
- 人机验证与短信输入由用户处理；
- 函数内部对提交过程设置合理的等待时间，避免过早关闭浏览器。

### `main()`

作为 CLI 入口，负责整体 orchestrate：校验配置 → 启动浏览器 → 调用上述函数 → 捕获异常并设置 `process.exitCode`。

## 错误处理与提示

- 打印清晰的步骤提示，例如“请等待短信验证码…”、“正在提交验证码…”；
- 捕获 Playwright 的超时异常，允许在页面未完全跳转时通过 `isLoggedIn` 再次确认；
- 如登录失败会输出明确日志并保持退出码非零，方便在 CI 或脚本中检测。

## 手动操作注意事项

- Playwright 会以非无头模式启动 Chromium，务必保持窗口前台以便人工处理滑块或图形验证码；
- 如短信验证码输入错误，可重新运行脚本并继续人工操作；
- 保存的 `douban-cookie.json` 与账号强绑定，若切换账号需手动删除或覆盖该文件。

## 后续拓展建议

1. **多账号支持**：通过配置文件或命令行参数管理多组手机号与存储路径；
2. **验证码服务集成**：接入外部短信/验证码平台以减少人工步骤；
3. **任务编排**：在登录后追加业务逻辑（例如抓取列表、导出数据），可在 `main` 函数成功分支追加调用；
4. **CLI 体验**：封装命令行参数解析，避免频繁依赖环境变量。

以上内容覆盖当前脚本主要实现。若后续重新引入滑块自动化，可在此文档扩展新的模块说明。