For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/web/admin.md (or send Accept: text/markdown).
管理控制台
平台检查、公告与功能标志。
初学者演练
先决条件：阅读下面的两个初学者指南，完成 Web 本地设置，并在编辑器的根目录中打开此 monorepo。网页设置属于apps/web/.env.local； Next.js不读取根.env。默认fake模式下的/dashboard是无数据库演示； /auth 需要迁移数据库。
简而言之：工作区是一个团队的单独用户、数据和设置。服务器是可信后端；让提供商密钥远离浏览器和电话代码。迁移是创建或更新表的版本化数据库更改。人工智能模型是回答的引擎；型号目录是服务器上可用型号 ID 和价格的列表。提供商是一种外部服务，例如人工智能、电子邮件或计费服务。权利是允许工作区使用某项功能的授权。 Webhook 是一个服务发送到另一个服务的 URL 的消息。
1. 在创建本地测试帐户之前，将您自己的地址添加到仅服务器 ADMIN_EMAILS 列表中并重新启动应用程序。
2. 注册迁移后的测试数据库并打开/admin；检查可用的用户和组织页面。
3. 这授予平台管理员权限，而不是工作区所有权。如果访问被拒绝，请验证确切的电子邮件和服务器配置；不要提升任意用户或针对生产进行测试。
对于自定义代码，请从提供的 prompts/README.md 开始，然后复制最接近的提示：对于应用程序屏幕为 prompts/new-app-screen.md，对于公共页面为 prompts/new-landing-page.md。对于服务器、数据库或提供商工作，请为您的编码代理提供本指南的任务，并要求其读取 AGENTS.md、.ai/PROJECT_CONTEXT.md 和匹配的 .ai/ 镜像；检查此处指定的确切源文件；列出文件并在编辑前进行检查；保留工作区所有权和仅限服务器的机密；并向您展示差异。告诉它您想要的行为、输入和输出字段、允许的角色、预期的成功和错误以及测试帐户、提供程序或设备。使用样本值；永远不要粘贴真正的秘密。
创建管理边界
ADMIN_EMAILS 是仅用于服务器的逗号分隔引导列表。列出的用户在注册时将获得平台管理员角色。如果没有它，则通过授权的数据库/管理路径授予访问权限；不要让第一个任意访问者成为管理员。
平台管理员与工作区所有者/管理员不同。 /admin及其用户、组织、旗帜、公告和候补名单页面检查平台角色。
使用已实施的控件
默认的Better Auth引擎提供管理员用户管理、禁止和模拟。该应用程序将平台视图与审计跟踪组合在一起。将模拟限制为经过验证的管理员访问权限，使其状态可见并在退出时恢复原始管理会话。
Auth.js 不会自动继承 Better Auth 管理插件。在切换引擎之前检查 admin.ts、admin-actions.ts 和身份验证提供者的行为。
验证特权操作
测试非管理员拒绝、管理员访问、禁止用户会话、模拟启动/停止以及您启用的操作。将所有管理路由保留在公共索引之外。
安装与配置
/admin 端面是运营者对工作区、成员和产品状态的检查视图。ADMIN_EMAILS(或消费产品中的 admin 插件配置)决定谁能进入;每个 admin 路由都会在服务器上重新检查授权。
功能标志(feature-flag-runtime.ts)默认禁用一切未配置的内容 —— 缺失的标志绝不可能悄悄启用某个端面 —— 按标志的覆盖存活在 featureFlagOverride 表中。
/admin operator dashboard
announcement-actions.ts broadcast in-app notices
resolveFeatureFlags(...) bulk flag resolution for a caller context实现流程
将 admin 操作用于检查和支持运营(工作区查询、成员管理、公告广播)。保持变更被审计,授权在操作边界而非导航中检查。
在标志后面推出功能:以暗模式交付代码,按工作区或全局启用,并在端面成为永久功能后移除标志。除非产品的 PRODUCT.md 明确授权,否则平台冒充保持冻结。
验证与排障
验证非管理员被拒绝、禁用的标志端到端隐藏其端面(导航、路由、操作)、覆盖只对目标解析,以及公告到达预期受众。admin 测试应首先覆盖拒绝路径。