基本操作

快速开始

1. 在「基本设置」中点击「登录 / 注册」，通过官网完成登录或注册
2. 登录后设置端到端加密密钥和同步间隔；账号信息中可确认当前身份（多数情况使用默认身份即可）
3. 开启「启用插件」总开关
4. 添加需要同步的域名：在「域名管理」中手动输入，或访问目标网站时在插件弹窗中点击「添加监控」
5. 将作为数据源的设备切换为「上传模式」，其他设备保持「下载模式」
6. 添加域名后会自动触发一次同步，后续按设定间隔自动执行；也可随时点击「立即同步」

添加监控域名

使用 Cookie Plus 同步数据前，需要先添加要监控的域名。

方式一：设置页添加

1. 点击浏览器工具栏中的 Cookie Plus 图标
2. 在插件弹窗中点击「设置」，打开设置页面
3. 进入「域名管理」，在「添加域名」中输入域名（如 example.com）
4. 点击「添加」

方式二：弹窗快捷添加

访问目标网站后打开插件弹窗，点击「添加监控」即可。

提示

支持输入主域名，也支持直接粘贴完整 URL，插件会自动提取域名。例如监控 https://www.example.com/page，填写 example.com 或直接粘贴该 URL 均可。

添加二级域名时，会提示是否同时监控一级域名。许多站点的 Cookie 写在一级域名（如 .example.com）上，建议一并添加。

上传 / 下载模式

每个域名可独立设置为「上传模式」或「下载模式」，新添加的域名默认为下载模式。可在「域名管理」列表或插件弹窗中随时切换。

• 上传模式：将本地浏览器的 Cookie 加密上传到服务端，当前设备作为该域名的数据源。同一域名同一时间只允许一个客户端设为上传模式，切换时会顶替原有上传源
• 下载模式：从服务端下载 Cookie 写入本地浏览器，用于在其他设备上还原登录状态

多设备同步时：在源设备上将该域名设为上传模式，在其他设备上保持下载模式，并使用相同的加密密钥和身份。

下载写入策略

下载模式下，可为每个域名选择写入策略：

• 合并（默认）：远程数据合并到本地，同名项更新为远程值，本地独有项保留
• 覆盖：先清空本地该域名下的数据，再用远程数据完整填充

开启「同步 LocalStorage」后，合并 / 覆盖策略同样作用于 LocalStorage。

Cookie 保活

仅「上传模式」的域名可开启 Cookie 保活。开启后，插件会按设定间隔在后台请求该网站，模拟用户活跃，降低登录态过期的概率。

1. 将该域名切换为上传模式
2. 在「域名管理」或插件弹窗中打开「保活」开关
3. 设置保活间隔（默认 60 分钟，范围 1～1440 分钟）

关闭「启用插件」总开关后，保活也会停止。

LocalStorage 同步

在「基本设置 → 功能开关」中开启「同步 LocalStorage」后，上传或下载时会按当前方向一并同步该域名的 LocalStorage 数据。

注意

读取 / 写入 LocalStorage 需要对应网站的标签页处于打开状态，否则无法操作。

开启后，「域名管理」中的详情弹窗会新增 LocalStorage 标签页，也可通过「更多」菜单拷贝 LocalStorage。

身份管理

Cookie Plus 支持「多身份」功能，允许用户在同一个账号下创建多个身份，每个身份拥有独立的域名列表和同步数据。

什么是身份？

身份是一种数据隔离机制。不同身份下的监控域名、Cookie 数据和 LocalStorage 数据互相独立，互不影响。注册账号后会自动拥有一个默认身份，最多可创建 10 个身份。

适用场景

• 工作与个人分离：创建「工作」和「个人」两个身份，分别管理公司内网和个人网站的登录态，避免混淆
• 多环境管理：为开发、测试、预发、生产等不同环境创建独立身份，各环境的 Cookie 数据互不干扰
• 多账号隔离：同一网站有多个账号时，每个身份维护一套独立的 Cookie，实现多账号并行管理
• 团队协作分组：团队成员可通过不同身份区分项目或客户，各组数据清晰隔离

创建身份

1. 打开设置页面，在「基本设置 → 账号信息」中点击 新建
2. 填写身份名称（如「工作」「测试环境」）和备注信息
3. 确认创建

切换身份

在插件弹窗或「基本设置 → 账号信息」中可以切换当前使用的身份。切换身份后，域名列表和数据操作均作用于所选身份。

删除身份

不再需要的身份可以删除：

1. 切换到目标身份
2. 点击 删除 按钮
3. 确认删除操作

警告

删除身份后，该身份下的所有域名和云端数据也将被清除，此操作不可恢复。默认身份不可删除。

开放接口支持

身份功能同样适用于开放接口。在调用域名管理、Cookie、LocalStorage 等接口时，通过 identityId 参数指定操作的身份；不传则使用默认身份。详见 身份管理接口。

域名管理

完整的监控域名列表在设置页的「域名管理」中查看，而不是插件弹窗。弹窗只展示当前标签页对应的域名。

每个域名支持：

• 切换上传 / 下载模式
• 切换合并 / 覆盖策略（下载模式）
• Cookie 保活（上传模式）
• 查看详情、立即同步
• 拷贝 Cookie（标准格式 / JSON 格式）
• 删除域名

点击「刷新」可从云端拉取最新监控域名列表；点击「同步全部」可一次性同步所有已监控域名。登录后域名列表会与云端保持同步，在新设备登录同一账号和身份后会自动拉取已有监控域名。

删除域名

1. 在已监控域名列表中找到目标域名
2. 通过「更多」菜单点击 删除域名，或在插件弹窗中点击 删除监控
3. 确认删除操作

警告

删除域名后，该域名下的云端数据也会被清除，此操作不可恢复。

插件弹窗

点击浏览器工具栏的插件图标打开弹窗，显示当前标签页的域名信息。

• 可快捷开关插件总开关、切换当前身份、添加 / 移除当前域名的监控
• 已监控时，可切换上传 / 下载模式、调整合并 / 覆盖策略、设置 Cookie 保活，并立即同步当前域名
• 未登录时会提示前往设置页面登录；非 HTTP 页面（如扩展页、空白页）不支持操作

开发设置

登录后可在「开发设置」中管理开放接口，供自动化测试等场景通过 API 读写数据。

• 开启「开放接口」后，可使用 AccessKey / SecretKey 调用开放 API
• 可按需开启 IP 白名单，仅允许名单内 IP 调用；多个 IP 用英文分号 ; 分隔
• 创建密钥后，SecretKey 仅展示一次，关闭后无法再查看，请立即复制并妥善保存

详细接口说明见 接口概览。

常见问题

• 同步后没有效果？ — 请确认源设备为上传、目标设备为下载，两端使用相同加密密钥，并处于同一身份
• LocalStorage 为空？ — 需要先打开对应网站的标签页，插件才能读取 / 写入 LocalStorage
• 提示「上传客户端不匹配」？ — 该域名已在其他设备设为上传模式，当前设备会自动切换为下载模式
• 密钥不匹配怎么办？ — 使用「校验密码」确认密钥是否正确；如需更换密钥，可使用「重置密码」（会清空远程数据）
• 保活没有生效？ — 仅上传模式支持保活，且「启用插件」总开关需保持开启
• 切换身份后域名不见了？ — 这是正常现象，不同身份的域名列表相互隔离
• 提示登录已失效？ — 请重新登录后再继续使用