SuperAPI AI 工具集

starchild-auth

通用与其它

查看项目

更新于 10-16 09:57

技能介绍

用途:把 Starchild OAuth 登录接入第三方 Web 应用,并通过同一套 SDK 调用 Agent、Credits 等 API。需在 iamstarchild.com → More → OAuth Apps 注册应用,填写名称、Allowed Origin(只允许 origin,非 localhost 必须 https)、Scopes,可选 System Prompt;仅 profile 自动通过,chat/credit:read/credit:write 需管理员审核后才生成 Client ID。

主要能力:SDK 处理 OAuth popup 登录登出、token 自动刷新、统一 StarchildAuthError、命名空间方法(auth.chat / auth.credit 等),覆盖对话 SSE 流、线程与消息、容器、WebSocket(指标/文件同步/终端)、技能、媒体、分享反馈、钱包及 Credits。Scope:profile 查看用户名头像 ID;chat 对话线程容器技能媒体定时任务钱包读取计费 WebSocket;credit:read 查余额与账户;credit:write 充值兑换 Points(隐含 read)。容器删除对所有 OAuth token 均返回 403。

使用方式:npm install starchild-auth-sdk(或 yarn/pnpm),也可用 UMD script(unpkg 或 npmmirror)。初始化 new StarchildAuth({ clientId, scope, onLogin, ... });token 的 access token 15 分钟有效、约每 12 分钟自动刷新,refresh token 7 天存于 localStorage 的 starchild_rt_{clientId}。Guest 与正式账号同走 auth.login() 主站 popup,绑定须在主站 Linked accounts 完成,可用 bindAccount()/getBindAccountUrl()。clawd 端点需 fly-force-instance-id,SDK 会自动解析注入,手动请求需显式携带。

适用场景:为 React 等 Web 应用添加 Starchild 登录,或集成对话流、容器管理、Credits 充值查询等。限制:文档未提供完整方法清单与所有参数细节(原文在 charges.pagination 处截断);Guest 无自建登录;容器删除不可用。具体版本与计费细节暂未提供完整说明。