用途：在既有 Next.js App Router（Node 20+）项目中实现或修复 Kinde 认证。不适用于 Pages Router 或 Kinde SDK v1 示例，遇到此类项目应移交对应的迁移或 Pages Router 指引。
主要能力：安装并配置 Kinde SDK，创建认证路由，选择 proxy.ts（Next 16+）或 middleware.ts（Next 13–15）作为网络边界，进行路由保护、Server Action 与 Route Handler 授权检查，支持权限、受众、组织与门户链接，处理部署（Vercel 预览、自定义子域、Cloudflare/OpenNext 等非标准运行时）与故障排查。
使用方式：先只读检查项目，确认实际应用根、包管理器、Node/Next/React/Kinde 版本与兼容的稳定 SDK，定位已有 proxy/middleware 与认证路由，清点并分类路由策略；安装前查询：npm view @kinde-oss/kinde-auth-nextjs version peerDependencies --json。随后写出设置契约，再按依赖顺序实施。验证阶段运行：node scripts/validate-kinde-nextjs.mjs .，并执行项目已有的格式化、类型检查、测试与生产构建。
关键原则：KINDE_CLIENT_SECRET 仅限服务端，不得进入客户端代码、日志、next.config.* 或任何 NEXT_PUBLIC_* 变量。代理/中间件检查只作导航与令牌刷新辅助，授权需在每个 Route Handler、Server Action 和所有服务端数据操作中重新执行。共享导航栏默认用客户端小组件配合 useKindeBrowserClient，不要为渲染账户控件在根/共享布局调用 getKindeServerSession。合并而非替换已有认证路由与中间件，保留既有行为。
限制：仅面向既有 App Router 项目；Next 16+ 只用 proxy.ts，Next 13–15 只用 middleware.ts；Edge 运行时属例外，须按部署文档处理；登录后动态跳转需映射到内部路径白名单。其他细节资料未提供。