CK 登录器使用教程
从下载、安装、登录、导出，到购买、卡密激活与后台管理，一篇讲完。
一、安装插件
- 下载 免费版 或 付费版 zip，解压到固定目录（不要放在临时目录，删除后插件会失效）。
- Chrome 地址栏打开 chrome://extensions（Edge 为 edge://extensions）。
- 打开右上角「开发者模式」。
- 点击「加载已解压的扩展程序」，选择解压后的 ck-free 或 ck-paid 目录（里面应直接看到 manifest.json）。
- 建议把 CK 登录器固定到工具栏；快捷键 Alt+Shift+C 可打开独立窗口。
二、用 Cookie 登录
- 在目标网站按 F12 → Application/应用 → Cookies，或使用 Cookie-Editor 扩展，复制整段 Cookie。
- 点击 CK 登录器图标，在「登录」页粘贴。插件会自动识别格式并补全域名。
- 确认「登录到」的域名正确；需要覆盖子域名时保持「包含子域名」开启。
- 点击「应用 Cookie 并登录」，插件会写入 Cookie 并按设置刷新页面或打开网址。
- 勾选「存入账号库」可保存本次登录态，下次在「账号库」一键切换。
三、导出给第三方工具
在「站点 Cookie」页点击「导出」，或在账号卡片菜单中选择导出。免费版开放前 3 种，付费版开放全部 9 种。
| 格式 | 适用工具 | 免费版 |
|---|---|---|
| Cookie 请求头 | curl、Postman、任意 HTTP 客户端 | 有 |
| JSON | 自定义脚本、Cookie-Editor 回导 | 有 |
| curl 命令 | 命令行复现请求 | 有 |
| cookies.txt（Netscape） | yt-dlp、wget、curl -b | 付费 |
| Playwright storageState | Playwright / Puppeteer | 付费 |
| Python requests | requests / Selenium | 付费 |
| Node fetch | Node 18+ / undici | 付费 |
| HTTPie | httpie 命令行 | 付费 |
| wget | wget 命令行 | 付费 |
四、免费版与付费版差异
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 账号库 | 3 个 | 不限数量 |
| 导出 | 3 种 | 9 种 |
| 批量导入 | 最多 3 个 | 不限，自动去重 |
| Cookie 到期监控 | — | 7 天内标记与筛选 |
| 备份 / 恢复 | 有 | 有 |
| 支持 | 常规 | 优先 |
从免费版升级不会丢失数据：在免费版「账号库」点备份，安装付费版后导入同一个 JSON 即可。免费版最多导入 3 个账号，付费版没有这个限制。
五、购买付费版
- 打开 购买页，选择支付宝或微信支付，金额 ¥5。
- 付款页域名为 classcode.grzdt.com（支付平台已备案域名），支付完成后自动跳回本站订单页，显示 CK-XXXX-XXXX-XXXX-XXXX 格式的卡密。
- 请立即保存卡密；同一订单的卡密可随时在订单页再次查看（请保留订单链接）。
六、激活付费版
- 安装 付费版 zip。
- 首次打开插件会显示授权界面，粘贴卡密，点击「激活」。
- 激活成功后卡密与本机设备绑定，插件全部功能解锁；重装浏览器后如设备标识变化，需要联系客服解绑。
- 插件会定期在线校验授权；离线时保留 7 天宽限期，联网后自动恢复。
七、后台管理（管理员）
后台地址 /admin，仅限部署者本人使用；管理入口不提供注册、找回或公开说明。
批量生成卡密
- 进入「卡密」页，填写数量（1–500）与备注（如：淘宝批次 / 老用户补偿）。
- 点击「批量生成」，生成结果会显示在页面上，可一键复制或下载 CSV。
- 卡密状态：未使用 / 已激活 / 已停用。可对单张卡密执行停用、启用、解绑设备。
调整价格
进入「设置」页修改售价（单位：元），保存后购买页与支付金额立即生效。修改后请确认金额不低于支付平台的最低限额。
订单与发卡
「订单」页可查看全部订单与支付状态。支付回调成功会自动发卡；如遇掉单，可在订单页手动标记已支付并补发卡密。
支付配置
支付参数位于服务器 /etc/ck-login/pay.json（复用 ClassCode 的 cetsteam 商户）：
{
"payPid": "1080",
"payBase": "https://pay.cetsteam.com",
"payPrivateKey": "-----BEGIN PRIVATE KEY-----",
"payPlatformPublicKey": "-----BEGIN PUBLIC KEY-----",
"payNotifyUrl": "https://classcode.grzdt.com/ck-pay/notify",
"payReturnUrl": "https://classcode.grzdt.com/ck-pay/return"
}
修改后执行 systemctl restart ck-login。回调地址必须公网可访问且与支付平台配置一致。
也可删除 pay.json 中的 notify/return 两项，或在 /etc/ck-login/ck.env 设置 PAY_ORIGIN=https://classcode.grzdt.com、PAY_PATH=/ck-pay，服务端会使用 classcode 域名的默认回调；pay.json 里的旧值优先级更高，迁移时务必一并更新。
八、常见问题
免费版和付费版有什么区别？
核心登录与站点 Cookie 管理完全一致。免费版 3 个账号、3 种导出（Header/JSON/curl）；付费版不限账号、9 种导出、批量导入不限量、Cookie 到期监控和优先支持。查看对比表。
点击支付后没有跳转 / 提示 429？
429 是短时间创建订单过多触发的保护。我们已加入待支付订单复用：同一网络、同一支付方式、同一金额在 30 分钟内会直接回到原订单，不再新建；超过限额也会尽量跳回最近的待支付订单。若仍停住，请回到订单页点「支付宝支付 / 微信支付」重试，或等 10 分钟后再试。
支付页一直停在「正在跳转」？
支付平台需要 1–3 秒生成收银台；超过 10 秒页面会显示「返回订单页重试」。请不要重复提交同一订单，先回订单页确认状态；已扣款但未发卡时，保留支付凭证联系客服补单。
粘贴后提示「无法识别」？
请确认复制的是完整 Cookie，而不是仅一段值；支持 name=value; name2=value2 或 JSON 数组。若 Cookie 含换行，可先尝试「Set-Cookie」格式。
登录成功但网站仍显示未登录？
检查域名是否一致（www 与裸域不同），尝试开启「包含子域名」并勾选「先清空本站」后重试；部分站点还校验 UA 或 localStorage，仅 Cookie 无法完全复刻。
付费版提示卡密已绑定其他设备？
一机一码限制。请在后台「卡密」页对该卡密执行「解绑」，或联系客服处理；解绑后可在新设备重新激活。
换电脑/重装系统怎么办？
先解绑旧设备，再在新设备激活。浏览器清除扩展数据会导致设备标识变化，建议激活后不要清理该扩展的存储。
为什么网页上不能一键安装？
Chrome / Edge 出于安全限制，禁止网页直接安装扩展或静默开启开发者模式。官网只能检测浏览器并给出对应步骤；加载一次后即可长期使用。若需要真正的一键安装，需上架 Chrome 应用商店或 Edge 加载项商店。
Cookie 会被上传吗？
不会。Cookie 与账号库仅保存在浏览器本地；付费版联网只发送卡密、设备随机标识与授权令牌。
站点使用的字体可以商用吗？
可以。本站只用系统字体栈；ClassCode 使用自托管 KaTeX 字体（SIL OFL 1.1）与 codicon（MIT / CC-BY-4.0，已保留署名）；LinkHop 使用系统字体。详见 字体许可。
九、接口说明（开发者）
POST /api/activate {"key":"CK-...","deviceId":"...","deviceName":"Chrome"}
→ {"ok":true,"token":"...","code":"CK-..."}
POST /api/verify {"token":"...","deviceId":"..."}
→ {"ok":true,"valid":true}
GET /api/version → 免费版 / 付费版版本、价格与下载地址
GET /api/order/:no → 订单状态（轮询用）
激活与校验接口有频率限制；请勿在客户端硬编码管理员令牌。