账号与云端存储

应用登录

await gemigo.auth.login({
  scopes: ['identity:basic', 'storage:rw', 'points:use'],
  persist: 'local',
});

平台账号在每个应用映射为独立 appUserId。应用可获得本应用令牌，不能获得平台 Session Cookie。local 使登录跨刷新恢复；session 限本页会话；memory 不落盘。

const loggedIn = !!gemigo.auth.getAccessToken();
gemigo.auth.logout();

令牌过期或缺少授权时，让用户重新点击登录，不能在背景循环弹窗。

保存练习进度

await gemigo.cloud.kv.set('progress', {lesson: 3});
const saved = await gemigo.cloud.kv.get('progress');

Cloud 数据在应用与账号范围内隔离。付费权益由 gemigo.points.grants() 查询，不能通过 Cloud 写入或本地变量自行授予。

需要更多 Cloud API 时参考完整 API Markdown。部分文件、Shell 或扩展接口需要对应宿主；网页能力以实际支持为准。默认 gemigo.ai 不等于已配置模型服务；当前点数 AI 使用登记的受控服务，见点数接口。