检查 Chrome 调试端口是否已就绪。

Check whether the Chrome debug port is available.

Two-step search: Step 1: Fetch search page HTML → get csrf_token cookie + searchToken Step 2: Call /search/api with token, pa

两步搜索流程： Step 1: 访问搜索页 HTML → 获取 csrf_token cookie + searchToken Step 2: 用 token 调 /search/api 获取 JSON 数据，支持分页

检查当前 Chrome 是否有机构全文访问权限。 返回 True 表示有权限，False 表示需要登录（含 CARSI 重定向情形）。

带重试、限速、浏览器导航头的 GET 请求。 若 curl_cffi 被 403 拦截，自动回退到 CDP（真实 Chrome）发请求。

GET request with retry, rate limiting, and browser navigation headers. Falls back to CDP (real Chrome) automatically on 403.

自动以调试模式启动 Chrome： 1. 把默认 Profile 的关键浏览器状态复制到临时目录 2. 用 --user-data-dir + --remote-debugging-port 启动 Chrome 3. 最多等待 40s

访问主页让服务器建立干净 session，收集服务器下发的 XSRF cookie。

Visit the homepage to establish a clean session and collect XSRF cookies.

检查 Chrome 远程调试端口是否就绪。

Launch Chrome in debug mode: 1. Copy key browser state from the default Profile to a temp directory 2. Start Chrome with --us

从本机 Chrome 读取 pubsonline.informs.org 的持久化 Cookie。 注意：browser_cookie3 只能读磁盘 cookie，不含 session cookie， 因此效果不如 CDP 提取（--chrome-l

Read persistent pubsonline.informs.org cookies from local Chrome. Note: browser_cookie3 only reads disk cookies, not session cookies.

生成 PDF 文件名：{序号}_{第一作者姓}_{年份}_{标题截断}.pdf

把 _cookie_dict 拼成 Cookie 请求头发送（比 session.cookies 更可靠）。

Check whether the current Chrome session has institutional full-text access. Returns True if access is confirmed.

Fetch the session cookie and searchToken required for the search API. Uses a clean session (no institutional cookies) to avoid sessio

用干净 session 访问搜索页面，获取： 1. 服务器下发的 session cookie（EUID、csrf_token 等） 2. searchToken（嵌入在页面 INITIAL_STATE 中） 注意：不带浏览器 co

从磁盘 Chrome Cookies 文件读取持久化 Cookie（备用，缺少 session cookies）。

从 CDP Chrome 上下文提取所有相关 Cookie（含 session cookies）。

从搜索结果页提取总结果数。

Extract total result count from a search page.

Generate filename: {index}_{first_author_surname}_{year}_{title}.pdf

从 BeautifulSoup Tag 解析单篇文章元数据。 优先使用 INFORMS PubsOnLine 的真实 class 名，备用通用选择器。

Parse a single article card from BeautifulSoup.

解析搜索结果页 HTML，返回文章列表。

Parse search result page HTML and return a list of article dicts.

解析期刊 TOC（目录）页 HTML。结构与搜索结果类似但略有不同。

Parse a journal TOC page HTML.

打开 ScienceDirect 文章页（触发 CARSI 自动重定向），提示用户完成机构登录， 等待用户在终端按 Enter 确认。

Download PDFs via Chrome DevTools Protocol (pure websocket-client). How it works: 1. Connect to a running Chrome debug insta

通过 Chrome DevTools Protocol 下载 PDF（纯 websocket-client，无需 Playwright）。 工作原理： 1. 连接已运行的 Chrome 调试实例（端口 9222） 2. 逐篇在新标签

Advanced search: combine multiple criteria.

高级搜索：组合多个条件。

Search by author name.

按作者姓名搜索。

Search by journal ISSN.

按期刊 ISSN 搜索。

Browse a journal by name.

按期刊名称浏览。

Search by keyword within a specific journal.

在指定期刊内按关键词搜索。

Search by keyword (supports Boolean operators AND / OR / NOT).

按关键词搜索（支持布尔运算符 AND / OR / NOT）。

通过 CDP 在调试 Chrome 里打开 url，等待 JS 渲染后返回完整 HTML。 策略：导航 → 等 loadEventFired → 再等 wait_seconds（JS 渲染）→ 取 HTML。 全程只维护一个消息循环，无嵌套轮询，逻

Open url in debug Chrome via CDP, wait for JS rendering, and return full HTML.

完整的 Chrome 登录流程： 1. 启动调试 Chrome（复用你的默认 Profile） 2. 打开 INFORMS 登录页 3. 等你手动登录，按 Enter 确认 4. 通过 CDP 提取 session c

Full Chrome login flow: 1. Launch debug Chrome (reuses your default Profile) 2. Open INFORMS login page 3. Wait for y

Navigate to url in an existing DevTools tab and capture PDF bytes via Network/Fetch interception. Returns (bytes | None, note_str). n

在已有 DevTools 标签页中导航到 url，通过 Network/Fetch 拦截捕获 PDF 字节。 返回 (bytes | None, note_str)。 note_str 以 "blocked:" 开头表示触发了反爬封锁页面。

通过 CDP websocket 从运行中的 Chrome 提取 pubsonline.informs.org 的所有 cookie。 返回拼好的 Cookie 请求头字符串。无需 Playwright。

Extract pubsonline.informs.org cookies from running Chrome via CDP websocket. Returns a formatted Cookie header string. No Playwright

curl_cffi 被 403 时的备用方案：让调试 Chrome 发请求，返回一个模拟 Response。 搜索结果页是 JS 渲染，传入 wait_selector 等待结果容器出现。 同时保存原始 HTML 到临时文件方便排查选择器问题。

Fallback when curl_cffi is blocked (403): let debug Chrome make the request. Returns a mock response object with .status_code and .te

交互式向导（无参数运行时启动）。

Interactive wizard (launched when no arguments are given).

以调试模式启动 Chrome，复用默认 Profile（带已保存的密码/书签/历史）。 返回 Popen 对象，失败返回 None。

Launch Chrome in debug mode, reusing the default Profile (saved passwords, bookmarks, history). Returns Popen object, or None

Read sciencedirect.com cookies directly from the local Chrome installation.

直接从本机 Chrome 读取 sciencedirect.com 的 cookie。

Load cookies from a JSON file.

从 JSON 文件加载 cookies。

从 JSON 文件（Netscape 或字典格式）加载 Cookie。

Load cookies from a JSON file (Netscape or dict format).

用会员账号密码登录 INFORMS PubsOnLine（Atypon 标准流程）。 步骤： 1. GET 登录页，提取 CSRF token 2. POST 凭证到 /action/doLogin 3.

Log in with member credentials via the standard Atypon flow: 1. GET login page, extract CSRF token 2. POST credentials to /ac

生成文件名：{序号}_{第一作者姓}_{年份}_{标题截断}.pdf

Generate filename: {index}_{first_author_surname}_{year}_{title}.pdf