Agent Skills
返回列表
💻

CloudBase Web 身份认证

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-auth-web-cloudbase。

技能介绍

要解决什么问题

在 CloudBase 环境里做 Web 前端登录、注册、会话保持或受保护路由时,容易在服务商是否开启、accessKey 是否正确、以及 SDK 3.x 的会话语义上踩坑。本技能面向已用或计划用 @cloudbase/js-sdk 的页面与 SPA,把「先确认后台再写前端」的顺序写清楚,避免用旧版 getLoginState() 误判已登录、或在未建立真实会话就去调 NoSQL 接口导致 401。

技能如何工作

激活前提通常是:登录方式已在控制台 / MCP 侧核对过(配合 auth-tool-cloudbase 的 queryAppAuth、manageAppAuth)。在此基础上,技能指导你:

  • 用 Supabase 风格的 { data, error } 调用:signInWithPassword、signInWithOtp、signUp、signOut、getSession、onAuthStateChange 等
  • 区分 邮箱 / 手机 / 用户名密码 / 匿名 / OAuth:例如纯 admin 类账号走 signInWithPassword({ username, password }),写代码前用 listProviders 确认对应方式为 On
  • 用 auth.getSession() 做路由守卫;data.session === undefined 才表示未登录
  • 在 SDK 3.x 下,对数据库读写前需 signInAnonymously() 或其它真实登录(若环境已开启匿名登录)

页面结构、部署可与同插件下的 web-development 技能衔接;服务商配置细节以 auth-tool-cloudbase 为准。

适用边界与注意点

  • 不适用:小程序、原生 App、纯服务端鉴权搭建
  • 不要在未确认 provider 前直接写 signInWithPassword / signUp;邮件注册还需确认 SMTP
  • 不要把登录框仍设 type="email" 而业务账号是用户名;也不要用云函数登录逻辑替换内置 Web Auth
  • 兄弟技能缺失时,应提示安装完整 CloudBase 插件,而非远程拉取 SKILL 内容

使用场景

  • React/Vite 项目需要登录页,并在路由层用 getSession 拦截未登录用户
  • 控制台已开用户名密码登录,要把表单提交接到 signInWithPassword 而非空壳 helper
  • 邮箱或手机 OTP 注册流程:signUp/signInWithOtp 后在前端调用 data.verifyOtp
  • SPA 初始化 SDK 后要先 signInAnonymously 再读写 NoSQL,避免网关返回 401

适合人员

  • 用 CloudBase 托管后端的 Web 前端,要在现有表单上接通官方 Auth 而非自写云函数登录
  • 维护管理后台(admin/editor 用户名账号),需区分用户名登录与邮箱字段的集成工程师
  • 从 Supabase Auth 迁移到 CloudBase,希望沿用 signInWithPassword、getSession 心智模型的全栈开发者
  • 负责 CloudBase 控制台登录方式与 publishable key,再交给 AI 生成页面集成代码的技术负责人