Aiff agent 使用文档 Windows v2.6.303 macOS v2.6.303

本文档面向普通用户，教你完成下载 → 运行 → 登录 → 连接号池 → 在 Cursor 中使用 AI，Windows 与 macOS 都有对应步骤。账号密码由运营提供，客户端与用户中心共用同一套密码。

产品简介

Aiff agent（以下简称「客户端」）是桌面程序，Windows 与 macOS 都支持，作用是把你的 Cursor 编辑器接入平台号池，使用 Pro 账号的 AI 能力，按实际用量从余额扣费。

当前正式版：Windows v2.6.303 · macOS v2.6.303（均持续热更新）。窗口标题栏会显示当前版本号，例如「Aiff agent v2.6.303」。请始终使用用户中心提供的最新包。

使用前准备

关于 WebView2

客户端界面依赖 Microsoft Edge WebView2 运行时。首次安装时若系统缺失，安装程序会自动下载并安装，一般无需手动操作。

用户中心：https://portal.aiff.chat
使用文档（本文）：https://portal.aiff.chat/guide

下载与运行

  1. 浏览器打开 用户中心 并登录
  2. 点击登录页的 「Aiff agent下载」，或侧边栏的 「版本更新」 图标
  3. Windows 下载安装包 CA-Client-Setup-2.6.303.exe（约 9 MB）；macOS 下载 CA-Client-macOS.zip（约 21 MB）
  4. 运行安装包完成安装后，打开 Aiff agent（首次安装若缺 WebView2 会自动补齐）
  5. 运行后即可打开 Aiff agent（可固定到任务栏 / 发送到桌面方便下次启动）
请始终从用户中心下载最新版。旧版本可能无法登录、无法连接或用量统计不准。客户端启动后会自动检查更新，发现新版本会提示并自动替换。

macOS 首次打开

Mac 版下载的是 CA-Client-macOS.zip，解压后得到两样东西：CA-Client.app（打开后在 Dock 和窗口标题里显示为 Aiff agent）和 一键打开.command。请先把 App 拖进「应用程序」文件夹再打开——留在「下载」里直接双击会导致配置保存和自动更新异常。

推荐：用「一键打开.command」，不用手动放行

右键点 一键打开.command → 选「打开」→ 弹窗里再点一次「打开」。必须走右键菜单，直接双击会被拦。

脚本会自动完成：装进「应用程序」→ 解除下载隔离标记 → 重做本机签名 → 打开 App，并在结尾打印一段状态自检（隔离标记、签名、芯片架构、本地服务是否就绪），有问题时把这段截图给客服即可。

脚本从 v2.6.303 起随包提供。如果你的包里没有它，说明版本较旧，请重新下载。

如果不想用脚本，也可以按下面的步骤手动放行。

首次打开会弹出「Apple 无法验证…是否包含可能危害 Mac 安全的恶意软件」，只有「完成」和「移到废纸篓」两个按钮。这是 macOS 对所有非商店应用的默认拦截，不是软件损坏。请点「完成」，不要点「移到废纸篓」，然后按下面的步骤放行。
  1. 双击 App，弹出提示后点 「完成」（这一步不能跳过）
  2. 点屏幕左上角苹果菜单 → 系统设置
  3. 左侧选 隐私与安全性，滚动到页面最底部的「安全性」区域
  4. 会看到一行「已阻止使用 CA-Client…」，点右侧 「仍要打开」
  5. 输入开机密码，再点一次 「仍要打开」，App 即可启动
「仍要打开」按钮只在尝试打开后约 1 小时内出现，所以必须先双击一次。
macOS 15（Sequoia）起，苹果已取消「右键 → 打开」的放行方式，网上的旧教程在新系统上无效。
放行只需做一次，之后双击就能直接打开。
更快的办法（会用终端的话）

把 App 拖进「应用程序」后，打开终端，粘贴执行下面这行，之后直接双击即可，无需去系统设置：

xattr -cr /Applications/CA-Client.app

自动热更新

客户端启动时读取服务端版本清单，若发现更新会自动下载、校验并替换自身，一般无需手动重装。你也可以随时在用户中心重新下载并安装最新安装包。

登录客户端

  1. 打开 Aiff agent
  2. 输入运营给你的 用户名
  3. 输入 密码（与用户中心登录密码相同）
  4. 点击登录，进入主界面即表示成功
密码说明

客户端和用户中心使用同一密码。若运营修改了密码，两边同步生效，无需分别设置。

连接与使用

登录成功后，按以下流程使用：

  1. 在主界面选择要使用的号池 / 套餐（只有一个时会自动选中）
  2. 点击 「连接」，等待状态变为「已连接」
  3. 打开 Cursor，在 Cursor 里选择模型并正常对话
  4. 使用结束后点击 「断开」，或直接关闭客户端（会自动清理并断开）
切换号池时一般不需要重启 Cursor：在客户端断开后再连另一个号池即可。若模型状态异常，再完全退出 Cursor 重开一次。
连接成功后，用量会按实际使用从余额扣除。可在用户中心「使用记录」查看每次请求的模型、Token 和扣费，记录约 6 秒内刷新显示。

使用时的注意事项

界面与模式

客户端默认进入极简模式，界面紧凑，适合日常使用。积分达到要求后可切换大老板模式（标准界面）。

模式说明解锁条件
极简模式默认界面，侧边栏快捷操作，窗口较小登录即可
大老板模式完整功能界面，更多信息展示积分 ≥ 1000

侧边栏常用功能：

用量与计费

扣费规则

模型识别

客户端会尽量识别你当前选中的模型（含 Fast、Max 等后缀），账单中会显示模型名，例如：

若你本地 Cursor 账号是 Free 版，连接号池后通常可解锁 Pro 模型选择。部分 AUTO 福利号池可能仅开放 Auto 和 Composer，属号池策略限制，非客户端故障。

用户中心能做什么

AUTO 号授权

若运营已开放 AUTO 号授权，可在用户中心侧栏进入「AUTO 号授权」页面：

  1. 查看当前资格状态（未购买 / 待授权 / 已激活）
  2. 有可用授权号时，点击购买并扫码支付
  3. 支付成功后系统自动分配 AUTO 号并完成授权（一般无需手动操作）
  4. 已激活用户可在有效期内续费延时；到期后需重新购买时同样依赖号池库存
无可用授权号时无法购买。页面会提示库存不足并禁用购买按钮，请稍后再试或联系运营。已有生效资格的续费不受「新号库存」影响。
AUTO 号授权与「连接号池按量扣费」是不同能力：前者是自助绑定 AUTO 号；后者是客户端连共享号池按积分计费。按运营开通情况使用即可。

AUTO 会员与签到

一键检测

在客户端内打开本文档时，可以直接点下面的按钮做一次自检。它会读取当前的连接状态与诊断信息，逐条告诉你哪里不对、对应本文档的哪一节。

连接状态自检

在普通浏览器里打开本页时，检测拿不到客户端状态，只会提示「需在客户端内运行」——这是正常的，请改从客户端侧边栏的「使用文档」进入。
检测结论基于本机状态，复杂个案仍建议通过故障上报或联系运营，并附上版本号与截图。

充值说明

卡密兑换

在用户中心「充值」页输入兑换码（格式如 ABCD-EFGH-JKLM-NPQR），点击兑换，积分即时到账。

在线充值

若运营已开启在线充值：

  1. 选择金额和支付方式（微信 / 支付宝）
  2. 按页面显示的精确金额扫码付款（如 10.37 元）
  3. 付款成功后通常 10 秒内自动到账
必须支付页面显示的精确金额，多付或少付都无法自动到账。超时未付需重新下单。

余额与自动断开

无法登录 · 排查步骤

1. 提示「用户名或密码错误」
  • 确认用户名、密码没有多余空格（建议复制粘贴）
  • 密码区分大小写
  • 先在用户中心网页用同一账号试登录 — 网页能登、客户端不能登，多半是版本过旧
  • 确认账号未被运营停用
2. 登录按钮无反应 / 一直转圈 / 提示无法连接服务器
  • 检查网络（浏览器能否打开 portal.aiff.chat）
  • 若本机开了系统代理 / Clash：可先保留代理再试（部分网络下代理比直连更快）；仍失败再切换直连对比
  • 暂时关闭防火墙或杀毒软件（Windows Defender 可能拦截）
  • 以管理员身份运行客户端
  • 从用户中心重新下载并安装最新客户端

无法连接 · 排查步骤

1. 提示余额不足
  • 在用户中心查看当前余额
  • 余额低于 10 积分时通常无法连接，请先充值
2. 点击连接后一直「连接中」或失败
  • 确认已成功登录客户端
  • 在用户中心确认所选号池/套餐可用（非「已满」或「维护」）
  • 关闭 TUN / 全局 VPN 隧道后重试（Clash 本体可保留，但请关 TUN）
  • 将客户端与 Cursor 加入杀毒/防火墙白名单后重试
  • 重启客户端后再点连接
3. 使用中突然断开
  • 最常见：余额耗尽 — 充值后重新连接
  • 网络波动 — 重新点击连接
  • 检测到 TUN 模式（全局 VPN 隧道）— 关闭 TUN 后重连

Cursor 相关问题

连接成功但 Cursor 里 AI 不可用
  • 确认客户端状态为已连接（不要关闭客户端）
  • 在 Cursor 中重新发起一次对话
  • 若仍不行，完全退出 Cursor 后重新打开
模型带锁 / 提示升级
  • 确认客户端已连接号池（未连接时 Cursor 显示的是你本地账号状态）
  • 连接成功后稍等几秒，让 Cursor 刷新会员状态
  • 若仍带锁，断开重连一次；或重启 Cursor
  • AUTO 福利号池可能只开放 Auto 和 Composer，其他模型带锁属正常
退出客户端后 Cursor 不能对话
  • 退出客户端时会自动还原 Cursor 配置
  • 若 Cursor 仍无法对话，手动完全退出 Cursor（任务管理器确认无残留进程）后重新打开
切换号池需要重启 Cursor 吗？

一般不需要。在客户端内断开当前号池、连接新号池即可。若模型带锁或状态异常，再完全退出 Cursor 重开一次。

提示流量被安全软件拦截 / 零流量
  • 将 Aiff agent与 Cursor 加入杀毒/防火墙白名单或信任区
  • 可暂时关闭实时防护后重试；加白后流量通常会恢复
  • 连接不一定会因此自动断开，但 AI 请求可能失败

其他常见问题

Mac 提示「Apple 无法验证…恶意软件」，打不开

这是 macOS 对非商店应用的默认拦截，不是安装包损坏，重新下载也没用。弹窗请点「完成」，切勿点「移到废纸篓」，然后按 下载与运行 → macOS 首次打开 的步骤在「系统设置 → 隐私与安全性」里放行一次即可。

如何查看使用记录？

登录用户中心 →「使用记录」，可查看每次请求的模型名、Token 数、扣费积分和时间。Auto 模型通常显示为 auto。

如何购买 / 续费 AUTO 号授权？
  • 用户中心 →「AUTO 号授权」查看状态并购买
  • 无可用授权号时无法下单，页面会提示库存不足
  • 已激活用户可续费延时；支付成功后系统自动分配/续期
如何更新客户端？

两种方式：

  • 自动热更新 — 启动客户端时自动检查，有新版会提示并自动替换
  • 手动下载 — 用户中心下载最新安装包，或侧边栏「版本更新」
怎么确认当前版本？

看客户端窗口标题栏，格式为「Aiff agent v2.6.303」。当前最新：Windows v2.6.303、macOS v2.6.303。旧版可能仍显示过时品牌名称或无版本号，请更新到最新版。

在线充值付了钱没到账？
  • 确认支付的是页面显示的精确金额
  • 等待 1~2 分钟刷新页面
  • 超过 10 分钟仍未到账，联系运营并提供支付截图 / 订单号
还是解决不了？

可先用本文档的一键检测自查；仍不行请联系运营（或加入 QQ 群），并提供：

  • 用户名
  • 问题发生时间
  • 客户端版本号（窗口标题栏）
  • 报错截图
  • 用户中心能否正常登录、当前余额
Aiff agent 使用文档 · Windows v2.6.303 · macOS v2.6.303 · 版本号随发版自动更新 · 网页访问：portal.aiff.chat/guide