douban-login/IMPLEMENTATION.md

登录脚本实现笔记

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

文件结构

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 体验：封装命令行参数解析，避免频繁依赖环境变量。

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