Session Cookie Online

概述

当网站会话需要保持活跃，但无需构建完整的浏览器自动化系统时，可使用此技能。

运行时脚本将命名的会话配置文件存储在 SQLite 中，重放一次确定的 HTTP keepalive 请求，将 Set-Cookie 更新合并回数据库，并将当前 Cookie 暴露给下游程序。

快速开始

1. 选择一个数据库名称。默认值为 default，解析为 ~/.cookie_alive/default.db。
2. 将当前 Cookie 捕获为 Cookie 标头字符串或 JSON 对象。
3. 使用 python {baseDir}/scripts/cookie_alive.py upsert ... 存储或更新一个命名的配置文件。
4. 使用 python {baseDir}/scripts/cookie_alive.py get --profile <profile> 验证存储的 Cookie。
5. 使用 python {baseDir}/scripts/cookie_alive.py refresh --profile <profile> 一次性刷新 Cookie。
6. 使用 python {baseDir}/scripts/cookie_alive.py run --profile <profile> 保持 Cookie 活跃。

工作流规则

• 优先为 --refresh-url 使用轻量级的身份验证端点，例如 /ping、/me 或低成本页面加载。当存在更便宜的端点时，避免使用重页面。
• 当来源是浏览器开发者工具或其他 HTTP 客户端时，使用 --cookie-header 存储 Cookie。当来源已经是结构化数据时，使用 --cookie-json 存储。
• 当其他程序需要字面的 Cookie 标头值时，使用 get --format header。
• 当其他程序需要元数据（如 interval_seconds、last_status_code 或 last_refreshed_at）时，使用 get --format record 或 list。
• 如果目标网站需要 JavaScript 计时器、WebSocket 流量或仅限浏览器的活动才能保持登录状态，请使用外部浏览器自动化来更新 Cookie，并通过 upsert 将更新的 Cookie 写回。此技能仅执行确定的 HTTP 请求。

脚本

• scripts/cookie_alive.py

使用此 CLI 进行配置文件 CRUD、一次性刷新和重复的保持活跃循环。

参考

• references/commands.md

加载此文件以获取确切的 CLI 格式、存储路径规则以及可复制粘贴的示例。