用途:为生成、修改、审查或调试 Make App 的认证与已认证 Make API 访问提供规范,涵盖 @qfeius/make-app-auth SDK 集成、统一登录(默认模式)、OAuth、SSO、ngrok、cookie、退出与回调测试,以及 /api/make/** 直连网关请求和服务前置型已发布 App 的 /api/make/auth/** 代理。
主要能力:统一登录默认配置 unifiedLogin: true、apiAuthRedirect: true 与 auth.init({ redirect: true });auth.api 封装普通业务请求;401、403、会话过期与退出的处理;当前上下文身份归一化;cookie、会话、重定向与回调排障。
使用方式:认证逻辑集中使用 @qfeius/make-app-auth,不另行分叉实现;Make 后端业务请求统一走 auth.api 下的 /api/make/;服务前置 App 保持 UI → Service → make-gateway 链路,UI 业务调用为 auth.api("/app/"),认证与 OAuth 回调位于 /api/make/auth/** 与 /api/make/oauth/**;gatewayBaseUrl 推荐 /api/make。可用 scripts/audit-auth-contract.mjs 做契约审计: node skills/make-app-auth/scripts/audit-auth-contract.mjs <project-root> --published 服务前置模式加 --mode service-fronted --published。修改生成代码时应补充或更新相关认证路径测试。参考文档包括 references/sdk-integration.md、request-adapter.md、unified-login-mode.md、service-fronted-mode.md、logout-and-401.md、troubleshooting.md。
适用场景:生成的 Make App 认证接入与审查、统一登录与回调排障、受保护 Make 业务请求、服务前置已发布 App 的认证代理配置。
限制:不负责 UI 布局或页面结构(用 makeui)、服务构建与发布运行时就绪(用 make-app-runtime)、DSL 建模(用 makedsl)、makecli 命令执行(用 makecli)、单应用权限(用 make-app-permission)。仅支持统一登录,不支持浏览器 token 模式、mock 模式或免登录绕过;缺失统一登录前置条件应作为阻塞上报。不得手写 Authorization、不得在 App 代码读写 zs_session 或 make_app_session、不得自行构造 Org OAuth 或退出 URL。本地预览例外仅通过临时环境变量 MAKE_APP_LOCAL_PREVIEW=true 启用,不得持久化到 env 文件或文档。具体收费、价格与平台支持情况暂未提供。