极光 Aurora 使用文档

v0.3.0 · 让你在桌面端与 Cursor 里的 AI 进行持久、多会话对话，不用一直盯着 Cursor 窗口。

一、系统要求

  • Windows 10 / 11（64 位）。
  • 安装包很小（约 1.4MB）：界面运行所需的 WebView2 由系统提供，Win10/11 一般自带；若缺失，安装时会自动下载。
  • 需要本机已安装 Cursor（用于实际跑 AI 对话）。

二、下载与安装

  1. 前往 GitHub Releases 下载安装包 Aurora_0.3.0_x64-setup.exe。
  2. 双击运行，按提示完成安装。

如果弹出「Windows 已保护你的电脑 / 未知发布者」

这是因为安装包暂未做数字签名，属正常现象，不是病毒。在蓝色提示框里点击左侧的 「更多信息」，再点下方出现的 「仍要运行」 即可继续。

安装完成后会在桌面 / 开始菜单生成「Aurora（极光MCP）」图标。

三、首次激活（输入卡密）

  1. 打开极光 Aurora，首次启动会出现激活页。
  2. 把购买得到的卡密粘贴进去，点击「激活」。
  3. 激活成功后即可进入主界面；顶栏会显示「已授权 · 到期 M/D」。
  • 一张卡密只绑定一台电脑（按机器码绑定），请勿多机共享。
  • 左下角是本机机器码（点击可复制），换机 / 售后时可能需要提供。
  • 联网后约每 6 小时自动续期一次；断网时按本地令牌有效期宽限若干天，超期需联网续期。

还没有卡密？前往购买 →（天卡 ¥9.9 / 周卡 ¥58.8 / 永久 ¥199）

四、连接 Cursor（一键部署）

激活进入后，把极光接到 Cursor 上：

  1. 在极光里点击 「一键部署」（会写入 Cursor 的 MCP 桥接脚本、合并 mcp.json、可写入工作区规则）。
  2. 重启 / 刷新 Cursor 的 MCP。
  3. 在 Cursor 里新建一个 Agent 对话，随便发一句话即可触发；Cursor 会显示「Wait For User Input in aurora」，此后这条对话就由极光接管，可在桌面端持续收发。

五、（可选）增强补丁

以下功能需要给 Cursor 打补丁，安装后需重启 Cursor 生效；在极光的「设置 → 系统设置」里开关。

自动重试补丁

在 Cursor 里加一个「极光环」按钮，自动越过用量 / 额度限流弹窗、自动处理回滚对话框。

批量会话补丁

一键批量起 N 个 Cursor 对话并各自后台并发重试，规模化跑多个持久会话；也是「离线守护 / 独立重试」等功能的基础。

打 / 卸补丁会重启 Cursor，会中断当前正在进行的对话，建议挑空闲时操作。Cursor 升级后补丁可能被覆盖，重新安装一次即可。

六、功能使用指南

持久对话与等待卡片

AI 每轮结束都会调用 wait_for_user_input 停在「等待你的回复」状态——等待卡片会显示续期倒计时、间隔与 ♻ 续期次数。直接在输入框打字、按 Enter 发送（Shift+Enter 换行），对话就继续。30s 心跳 + 自动重连，绕过 Cursor ~60s 工具超时。

多会话管理

  • 左侧栏集中展示全部会话，支持搜索（ID / 标题）。
  • 右键菜单：置顶 / 重命名 / 删除；左下角输入 sessionId 可恢复已删会话。
  • 发送队列：非等待态时输入会进队列，轮到 wait 时自动发出，可增删改。
  • 每个会话可设备注与附加内容，自动附加到 AI 载荷。

群发指令

顶栏广播按钮，多选会话一次性下发同一内容。可全选 / 仅等待中 / 清除；等待中的立即送达，否则进各会话队列。

批量会话 Auto-Chat

右侧抽屉：设置数量、话术（支持 {n} 占位）、启动间隔，一键批量起 N 个 Cursor Agent，后台并发、全局连续编号（Aurora-{n}）防重名，各自自动重试越过超额。（需先安装批量会话补丁）

离线守护

右键会话 →「离线守护」布防。掉线被判死后（默认 30s 确认期防误判）自动重开 N 条接力，按 composerId 匹配先复活者胜出，停其余并把上文「交接」过去，随后自动撤防。可暂停 / 恢复。

会话转移 / 交接

把源会话完整历史导出为 Markdown 存档，并以 handoff 形式注入目标会话，源会话留「↪ 已转移→X」标记。存档会自动去内联大图、自包含合并历代记录。

多模态与导出

  • 图片：粘贴 / 拖拽 / 选文件，作为 Markdown data: URL 发送，Cursor 可见图。
  • 导出 Markdown：整段对话一键导出到下载目录并打开文件夹（手动导出保留原图）。
  • 快捷指令、明暗主题、新消息提示音、回到最新消息 等体验细节随手可用。

七、推荐 Cursor 版本 & 兼容性

  • 推荐使用较新的正式版 Cursor（实测：基于 VSCode 1.105.1 内核的 Cursor 正常工作）。
  • 核心的持久对话（MCP）对 Cursor 版本不敏感，一般都能用。
  • 批量会话 / 自动重试 / 离线守护依赖 Cursor 内部接口，对版本较敏感：大版本更新后若失效，通常重装补丁即可；个别情况需等待适配。遇到问题先记下 Cursor 版本号便于排查。

八、常见问题（FAQ）

  • 装不上 / 打不开：先确认是 Win10/11 64 位；被 SmartScreen 拦时按第二节「更多信息 → 仍要运行」。
  • 激活失败：检查卡密是否输错、是否已在另一台电脑用过（一卡一机）、本机是否能联网。
  • Cursor 里不触发：确认已「一键部署」并刷新 / 重启了 Cursor 的 MCP，且是在新开的 Agent 对话里发消息。
  • 对话显示「已结束 / 离线」：多为对应的 Cursor 窗口已关或对话已断；新开对话或用「独立重试 / 离线守护」即可。
  • 批量 / 重试不工作：确认对应补丁已安装且重启过 Cursor；Cursor 刚升级过的话重装补丁。

九、卸载 / 换机

  • 卸载：从「设置」里先停用各补丁（会还原 Cursor 文件），再正常卸载极光。
  • 换机：新机器机器码不同，原卡密无法直接迁移，请联系售后处理换绑。

十、数据目录

个人配置与会话数据保存在 %APPDATA%\com.aurora.desktop\ 目录下。

准备好了吗？

下载仅 1.4MB，激活即用。

⬇ 免费下载 购买卡密