# 快手 CK 登录助手（运营安装说明）

## 一次安装

1. 下载并解压 `kuaishou-ck-login-plugin.zip`。
2. Edge 打开 `edge://extensions/`（Chrome 打开 `chrome://extensions/`）。
3. 打开右上角“开发人员模式”。
4. 点击“加载解压缩的扩展”，选择解压后的 `kuaishou-ck-login-plugin` 文件夹。
5. 将“快手 CK 登录助手”固定到浏览器工具栏。
6. 首次点击插件，在“首次安装设置”中填写管理员提供的**插件专用 Key**，点击“保存并连接”。该 Key 只能读取插件账户列表和更新快手 CK，不能访问其他管理接口。

## 日常更新 CK

1. 点击插件里的“打开快手代理商后台”。
2. 在插件的“代理商监控账户”中选择一种操作：
   - 已有代理商：选择对应账户，更新该代理商 CK。
   - 新代理商：选择“＋ 新增当前登录的代理商”；内部备注可选，留空会自动使用快手代理商名称。
3. 运营在快手页面正常登录对应的代理商账户（有验证码时人工完成）。
4. 登录完成后打开插件：插件只读取**当前活动的快手标签页**中的 `__staffId__`，不会拿其他旧标签页的员工 ID。安装/升级插件后需刷新一次已打开的快手页面，让新版页面校验组件生效。
5. 若同一登录账号可访问多个代理商，必须在“代理商身份”下拉框中按“代理商名称 + 代理商 ID + 员工 ID”明确选择目标代理商；插件不会默认沿用已有账户身份。
6. 点击更新按钮：插件会先在当前快手页面内核对页面实际代理商 ID 与所选代理商 ID；只有二者一致才采集并提交 CK。若提示“页面未完成切换”，请在快手页面切到目标代理商并等待加载完成后再试。
   - 已有代理商会校验身份后更新 CK；若登录身份不同，会拒绝覆盖，防止串号。
   - 新代理商会按快手返回的代理商 ID 去重并新增，然后自动分页同步其全部子媒体/广告账户。
7. 看到“快手已校验有效”即完成；新增时还会显示同步到的子账户数量。

### 两个独立快手登录账户并行使用

- 插件可以安装在运营自己的电脑上，无需在监控服务器或 Hermes 所在电脑登录快手。
- 运营登录任意一个快手账户后打开插件，选择“＋ 新增当前登录的代理商”并提交；服务端会用该 CK 校验真实代理商 ID。
- 若代理商 ID 尚未登记，自动创建为新的并行监控账户；若已经登记，只更新该代理商自己的 CK。不同代理商 ID 不会互相覆盖。
- 同一浏览器资料的普通标签页仍共享快手 Cookie；需要同时保持两个快手账号在线时，可使用不同浏览器资料或普通/InPrivate 窗口。插件只读取当前活动标签页所属的 Cookie Store。

## 安全说明

- 插件只读取 `*.kuaishou.com` 的 Cookie，只提交到 `https://kuaishou-ads.longxiaqifei.com`。
- Cookie 不显示、不复制到剪贴板、不写日志，也不持久化在插件存储中。
- 插件专用 Key 仅保存在本机插件页面的 `localStorage`；该配置不会同步到其他浏览器设备，且不能访问监控系统其他管理接口，请勿转发插件配置或密钥。
- 如果显示“未检测到完整快手登录态”，先确认当前浏览器已登录快手代理商后台。
- 如果校验失败，重新登录快手，并确认选择了正确的监控账户和 staff-id 后再试。