MiragenFlow/admin/README.md

元境幻生管理台

admin/ 是 MiragenFlow（元境幻生）V1 的管理员前端，基于 React、Vite 和 TDesign UI 组件构建。它只承载 /admin/ 管理页面，不保存供应商密钥，不直接调用模型供应商接口。

本地开发

npm install
npm run dev:linux -- --port 3003

通常使用仓库根目录的 node scripts/dev-all.mjs 同时启动前台、管理台和 API 网关。生产环境由同一公网 origin 提供 /、/admin/、/api/ 和 WebSocket。

管理范围

• 管理员独立登录、MFA、RBAC 和会话退出
• 用户、认证消息和风控策略
• 模型产品、分辨率、价格、渠道、渠道组和健康状态
• 任务、attempt、队列、余额账本、充值订单、套餐和审批
• WebDAV/临时存储策略、消息 outbox、审计日志

所有写请求必须经过服务端 /api/v1/admin/* 鉴权、幂等校验、版本校验和审计。页面展示的渠道凭证始终是脱敏状态；support 角色不能读取原始提示词、文件或密钥。

构建与检查

npm run build
npm run lint

管理台通过 packages/contracts 与前台共享公开 DTO、错误码和 WebSocket 事件类型。模板输入目录 docs/design-reference/MiragenFlow-front/ 不属于管理台运行时依赖。