网站快照存储与恢复助手 (Web Snapshot Manager)

一款专为 ScriptCat（脚本猫） 与 Tampermonkey（油猴） 开发的现代化网页快照凭证（Cookie / LocalStorage / SessionStorage）一键捕获、高强度对称加密存储、多账号切换管理与跨环境导入导出工具。

🌟 核心特性

1. 🔐 全维度快照捕获与恢复

• Cookie 全量支持：优先调用 GM_cookie API 获取全量（含 HttpOnly、SameSite、子域名及 Path 限制）Cookie，并在无权限时自动平滑降级为 document.cookie。
• Storage 完整还原：同步捕获当前站点的 localStorage 与 sessionStorage 完整键值对。
• 原子化数据切换：在恢复目标快照前，会自动彻底清空旧凭据的所有 Cookie 与 Storage，避免不同快照互相污染导致串号或异常。
• 智能跳转回保存页：保存快照时自动记录来源页面 URL（location.href），恢复成功后可智能跳转或刷新回保存时的页面。

2. 🛡️ 硬件级加密安全

• Web Crypto API 对称加密：采用现代密码学标准 AES-GCM (256-bit) + PBKDF2 密钥派生算法。
• 动态设备与域名绑定：基于当前设备与网站域名生成独立密钥，并在完成加解密后立即调用 wipeMemory 擦除内存中残留的明文。
• 跨域名解密兼容：备份数据中自包含加密上下文，即便跨站点导入或文件恢复也能智能兼容解密。

3. 🎨 现代化质感 UI 设计与移动端适配

• Shadow DOM 样式完全隔离：所有弹窗与组件运行在独立的 Shadow Root 中，与目标网站样式 100% 互不干扰。
• 快照实时搜索过滤：列表顶部支持按名称、保存时间与来源 URL 即时模糊筛选，并支持一键清空与友好空状态。
• 当前生效快照状态标识：自动识别并高亮标记当前网站正在生效/最近恢复的快照，展示 [✓ 当前生效] 翠绿徽章与微光边框。
• 悬浮球边缘吸附与呼吸透明度：拖拽松开后自动计算并平滑吸附到最近屏幕边缘；空闲时自动半透明（0.65），鼠标悬浮瞬间恢复清晰。
• 移动端与小屏响应式适配：专为手机、平板及小窗口进行自适应流式排版，按钮自动紧凑排布不折行错位。
• 精致毛玻璃与深色设计：
  • 曜石黑蓝渐变 Header，搭配半透明毛玻璃（backdrop-filter: blur）域名胶囊。
  • 科技蓝渐变悬浮球，支持平滑拖拽与多站点独立记忆位置。
  • 快照状态彩色 Chips 徽章（🍪 Cookie / 💾 Local / 📦 Session / 🔒 AES-GCM）。
  • 3 宫格凭证扫描指标预览抽屉。
• 双重滚动防穿透：通过 CSS overscroll-behavior: contain 与精确 JS 滚轮事件拦截，保证弹窗内滚动列表时绝不影响宿主网页。
• 高性能与高兼容底层：
  • PBKDF2 派生密钥内存池：避免高频操作下的 CPU 阻塞，加解密毫秒级响应。
  • 全属性 Cookie 同步：完整支持 SameSite（None / Lax / Strict）与 Secure 属性回写。
  • SPA 单页路由感知：动态捕获 Vue/React 等单页应用的无刷新 URL 路径。
  • 快照体积预估：保存时计算总大小并在超大时给出预警。

4. 📦 灵活的数据导入/导出与剪贴板极速流转

• 剪贴板免文件快速流转：支持单条快照一键复制至剪贴板，以及通过「从剪贴板恢复(免文件)」实现秒级跨浏览器/跨设备恢复。
• 智能去重导入：导入快照时自动比对加密数据指纹，已存在的重复记录自动跳过，提供清晰的状态反馈。
• 批量导出/导入：一键将当前站点的所有快照档案导出为结构化 JSON 文件或批量追加导入。
• 单条记录导出：可导出单条快照文件，便于与他人共享或跨浏览器迁移。
• 从文件恢复（不导入）：支持直接选取外部 JSON 文件立即还原快照并生效，无需将数据写入本地持久化存储。
• 跨站点智能提示：当导入或恢复非本网站的快照备份时，会自动提示来源站点并供用户二次确认。

⚙️ 脚本配置项 (Script Settings)

在 ScriptCat / 油猴脚本的「配置」或设置面板中，可自定义以下选项：

🚀 界面与交互指南

1. 悬浮球 (Floating Ball)

• 点击：快速展开「快照管理」主窗口。
• 拖拽：在页面任意位置按住拖动，松手后会自动持久化记忆当前站点的位置。
• 右上角 × 菜单：悬浮在悬浮球上会出现微型操作按钮，点击可弹出快捷操作：
  • 打开快照管理窗口
  • 一键加密保存当前快照
  • 临时隐藏悬浮球（本次会话隐藏，刷新后恢复）
  • 永久关闭（从显示白名单中移除当前站点）

2. 管理窗口工具栏

• 一键保存：弹出抽屉面板，实时扫描当前页面的 Cookie 与 Storage 数量，输入名称后即可加密保存（支持回车确认与自动聚焦）。
• 清空数据：一键清空当前站点的所有 Cookie 及 Local/SessionStorage，快速回到干净未登录状态。
• 刷新：快速刷新当前页面。
• 搜索过滤框：即时检索快照名称、创建时间或来源 URL。
• ⋮ 更多操作下拉菜单：
  • 批量导出记录：将当前站点所有记录打包导出为 .json 文件。
  • 批量导入记录：选择 JSON 文件批量追加到当前站点（智能去重）。
  • 从文件恢复(不导入)：选择 JSON 文件立即恢复到浏览器并刷新，不写入脚本管理器存储。
  • 从剪贴板恢复(免文件)：读取剪贴板快照 JSON 文本立即解密并恢复，跨端无缝流转。
  • 全局 Ctrl+V / Paste：在页面任意位置直接按 Ctrl+V 粘贴快照数据，脚本会自动识别并弹出快速恢复确认。

3. 凭据记录卡片

• 一键恢复：彻底清理旧数据后载入该记录的凭据，标记为当前生效，并自动刷新或跳转至保存时的页面。
• 复制：一键复制加密快照至剪贴板，方便跨设备/跨浏览器直接恢复。
• 导出：导出当前单条快照为独立的 .json 文件。
• 重命名：修改记录名称。
• 删除：移除单条记录。

4. 扩展菜单集成 (GM Menu)

点击浏览器扩展栏的 ScriptCat / 油猴图标，点击 「🔑 快照管理助手」：

• 若当前站点未激活（不在白名单中）：可选择「临时显示（仅本次）」或「永久开启（加入显示列表）」。
• 若当前站点已激活：可直接调出管理窗口，或进行临时/永久关闭配置。

🔒 备份数据格式 (JSON 结构规范)

单条记录结构 (Single Record)

{
  "type": "LSM_SINGLE_EXPORT",
  "version": "1.0",
  "domain": "example.com",
  "exportTime": 1771747200000,
  "record": {
    "id": "lsm_1771747200000_abc123",
    "name": "测试快照1",
    "createdAt": 1771747200000,
    "domain": "example.com",
    "url": "https://example.com/user/center",
    "summary": {
      "cookieCount": 8,
      "localCount": 15,
      "sessionCount": 2
    },
    "cipherData": {
      "encrypted": true,
      "iv": "base64...",
      "salt": "base64...",
      "ciphertext": "base64..."
    }
  }
}

批量记录结构 (Batch Records)

{
  "type": "LSM_BATCH_EXPORT",
  "version": "1.0",
  "domain": "example.com",
  "exportTime": 1771747200000,
  "count": 2,
  "records": [ ... ]
}

📋 脚本权限说明 (UserScript Metadata)

// @grant        GM_setValue           // 持久化存储记录与配置
// @grant        GM_getValue           // 读取记录与配置
// @grant        GM_deleteValue         // 清除旧存储数据
// @grant        GM_listValues         // 获取存储键列表
// @grant        GM_registerMenuCommand// 注册扩展插件菜单
// @grant        GM_cookie             // 获取/设置全量 Cookie（包括 HttpOnly）
// @grant        GM_setClipboard       // 剪贴板操作
// @license      MIT                   // 开源许可证
// @run-at       document-idle         // 在页面空闲时启动

📄 开源协议 (License)

本项目基于 MIT License 开源。