1. 首次准备
- 确认已启动 gateway-api(默认
http://127.0.0.1:3000)与本管理台(3100)。建议同时开着 worker(用量同步、IDE token 健康、换号抽检)。
- 侧栏 接口地址 填网关地址,一般不用改。
- 侧栏 API Key:打开项目里的
data/bootstrap-api-key.txt,复制 cgw_… 那一行,粘贴后点击别处保存。
- 侧栏下方鉴权提示变为「已配置 API Key」后,再操作其它页面。
Key 只保存在浏览器本地,不会上传。运维页可创建/禁用新 Key。
2. 登入入库
方式 A · 邮箱验证码(推荐)
- 填真实邮箱(Outlook / QQ 等)。
- 点 发送验证码,到邮箱收 6 位码;请求编号一般会自动填入。
- 填验证码 → 提交并保存。成功后账号进入「账号详情」列表。
方式 B · 一键产号
- 选临时邮箱提供方(自动 / Cloudflare / mail.tm)。
- 点 一键产号 / 登入。新域名可能被 Cursor 拦截;若要求手机验证,需配置豪猪接码环境变量。
- 可选「建档后写入本机 IDE」(一般更推荐到账号详情里用无感换号)。
方式 C · 导入已有会话
到 账号详情 页下方「导入会话」:填邮箱 + Access Token 和/或 WorkOS Cookie → 可先试活再保存。也支持每行一个邮箱批量建档(无会话)。
3. 账号详情
- 用搜索框、状态 / 健康 / 半价筛选缩小范围。
- 勾选账号:可用 全选(只作用于当前列表结果)。
- 批量刷新 = 刷新会话 + 校验是否有效 + 同步用量(一次做完)。
- 批量删除会永久删号,需确认。
- 点卡片「详情」或双击:可校验、同步用量、无感换号、软重启换号、断开(标失效)、永久删除。
「断开」只清会话、卡片还在;「永久删除」才从列表消失。
4. 无感换号(核心)
- 先到 本机 Cursor 确认桥接在线(或至少 Cursor 在跑)。建议点一次「安装 / 重装桥接」。
- 在账号详情打开目标账号 → 点 无感换号。
- 系统会:先旋转/交换 IDE token → 只更新邮箱到库 → 用
cursor://cursorAuth 热登录(不退出、不重载窗口)。
- 成功后会在 1 / 5 / 15 分钟自动抽检 IDE 是否仍登录(需 worker 在跑)。
- 若热登录失败:弹窗可选 软重启换号(退出 → 写库 → 再启动),或手动点详情里的「软重启换号」。
不要用「仅写本机库」当无感:运行中的 IDE 可能仍用旧号,也容易把旧 token 写回去导致掉线。
5. 本机 Cursor
- 刷新 / 校验登录:看当前 IDE 邮箱、桥接、Token 是否有效。
- 启动 / 退出:控制本机 Cursor 进程。
- 安装桥接:安装无感热登录扩展;离线时换号会回退系统协议。
- 重置机器码:会备份后改机器标识,一般换号不必点;可勾选跳过 MachineGuid。
仅 Windows 生效。路径与原始 JSON 在页面底部可展开查看。
9. 常见问题
- 列表刷新失败 / 401
- 侧栏 API Key 错误或未填。重新从
data/bootstrap-api-key.txt 复制。
- 无感换号后用着用着掉线
- 确认走的是「无感换号」不是「仅写本机库」;保持 worker 运行;账号若显示「需重登」先重新登入再换。
- 桥接离线
- 本机页点「安装 / 重装桥接」,或重开 Cursor 窗口后再刷新状态。
- 换号报无法准备 IDE token
- 该号会话已废,用验证码或导入 Cookie 重新入库。
- 聊天记录好像没了
- 一般没删盘上数据;多半是当前会话选空了。历史仍在 Cursor 项目目录与 globalStorage。
- 产号总失败
- 临时邮箱被拒就用真实邮箱验证码;手机挑战需配接码;Turnstile 需打码 Key 或本地 Chrome 兜底。
更偏运维的说明也写在仓库 docs/OPERATOR.md。