站点登录状态与密钥备份
pt-tools 可配合 PT Tools Helper 同步站点 Cookie，并周期探测站点提供的 last_access / last_login 信息，在账号接近不活跃期限时通过已配置的通知通道提醒。
使用流程
- 在站点 → 站点列表中启用目标站点，并配置好认证信息。Cookie 认证的站点可以安装 PT Tools Helper，在浏览器中登录站点后一键同步 Cookie；API Key 和 Passkey 站点在 Web UI 中手动填写。
- 站点列表的「剩余天数」列显示距离封号阈值还有几天，负数表示已经超过阈值；「判定活跃」列是用于提醒判定的活跃时间，优先采用站点返回的
last_access，不是网页登录时间。 - 点击行内的「保号配置」按钮，按站点设置封号判定天数、提前提醒天数、提醒 cron、通知通道和探测模式。
- 行内的「立即探测」按钮马上探测一次登录状态，「测试提醒」按钮向通知通道发送一条测试消息；列表上方的「探测已启用」对所有已启用站点各探测一次，最多 3 个并发。
- 收到提醒后正常访问站点。Cookie 失效时重新同步，再点「立即探测」确认状态已经刷新。
说明
探测能刷新多数站点的 last_access（最近动向）。少数站点按 last_login（实际登录）或做种活跃度判断是否清理账号，这类站点仍需定期手动登录，不能只看剩余天数。
每站点配置
「保号配置」对话框中的各项：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 封号判定天数 | 30 | 不活跃超过这个天数，站点就可能封号 |
| 提前提醒天数 | 10 | 距离封号还剩多少天开始提醒 |
| 提醒 cron | 0 10,22 * * * | 标准 5 字段 cron（分 时 日 月 周），默认每天 10:00 与 22:00 |
| 通知通道 | 空 | 选择后只发送到选中且已启用的通道；留空则发送到所有已启用通道 |
| 探测模式 | 自动 | 自动：跟随定时探测；手动：只在点击「立即探测」时执行；禁用：不探测 |
定时探测约每 6 小时一次，每个站点带随机抖动。连续探测失败超过 24 小时会发送一条「Cookie 可能已失效」的提醒。站点没有提供可靠的最后访问字段时，页面结果仅供参考。
备份加密密钥
~/.pt-tools/secret.key 用于 AES-256-GCM 加密站点 Cookie 等凭证。密钥丢失后，已存储凭证无法解密，只能重新同步。
导出备份：
bash
pt-tools secret export > ~/secret.key.backup
chmod 600 ~/secret.key.backup恢复备份：
bash
pt-tools secret import --force < ~/secret.key.backup警告
密钥备份具备与原始密钥相同的敏感性。请存入密码管理器、加密介质或受控备份系统，不要提交到代码仓库或明文云盘。
Docker 持久化
容器部署必须把 /app/.pt-tools 挂载到宿主机或受管卷。该目录同时包含 secret.key、数据库、日志和临时种子文件；重建容器前应确认挂载存在且备份可用。
yaml
volumes:
- ./data:/app/.pt-tools删除 ./data 会同时丢失数据库与密钥。备份时请把密钥与数据库作为一个一致性单元保存。
合规边界
此功能使用用户自己的 Cookie 或 API Key 周期访问站点页面或 profile API。启用前请确认站点规则允许自动化访问，并根据个人风险偏好设置探测频率：
- 部分站点可能把频繁脚本访问视为违规。
- 登录状态字段由站点提供，可能缺失、延迟或语义不同。
- pt-tools 不保证该功能可以避免封号，也不承担因自动化访问导致的警告、降级或封禁。
认证信息获取与同步方法见获取 Cookie / API Key。