用途：在实现、升级或审查 WorkOS 集成时，先了解迁移风险，再只加载与当前产品面和语言相关的参考内容，避免盲目改动。
主要能力：提供参考索引，涵盖 Node SDK 迁移、AuthKit Next.js、AuthKit React、API 与 SDK 契约、认证与会话、授权与特性、SSO 目录与嵌入组件、平台产品等主题。
必要用法：先确认 SDK 语言、包版本、框架和所用 WorkOS 产品，再应用破坏性迁移，然后加载匹配的参考；保留原始载荷、安全状态与内部响应头；核对仪表板侧的重定向 URI、登出 URI、允许来源、域名、提供方与认证端点。
迁移要点：Node SDK v9 需 Node.js 22.11+，移除旧 FGA 包，客户端访问从 portal 改名为 adminPortal；v10 中 Group.createdAt/updatedAt 为 Date，webhook 用 new Webhooks(workos) 构造，listResources 移除 search，vault.listObjects 为可自动分页集合；事件处理需改用 api_key.revoked 等。AuthKit Next.js v3 移除 WORKOS_ENABLE_PKCE，始终启用 PKCE 与密封 OAuth state，需保留 wos-auth-verifier cookie。Next.js 16+ 用 proxy.ts 配 authkitProxy，更早版本用 middleware.ts 配 authkitMiddleware。
典型用法：App Router 回调使用 handleAuth；服务端用 withAuth，客户端从 @workos-inc/authkit-nextjs/components 引入 AuthKitProvider 与 useAuth；公共客户端 PKCE 用 getAuthorizationUrlWithPKCE 与 authenticateWithCode，并安全保存 codeVerifier。Webhook 需对原始请求字节验签，不得先解码或重新序列化。
限制：资料未提供价格、平台覆盖范围或性能数据。部分产品选择与配置细节需结合官方文档与仪表板设置确认。