外观
浏览器管理后台总览
约 1601 字大约 5 分钟
本页是平台运营人员使用的浏览器管理后台说明，源码位于仓库根目录的 fronted_admin_web/。它与创作者使用的 PC 应用端和 Web 网站端职责不同：浏览器管理后台用于管理工作空间、用户额度、AI 网关、计费、订单与系统策略，不用于剪辑或制作视频。
当前线上主版本是 React 管理后台。仓库中同时保留 fronted_admin_web_vue/，它是旧版 Vue 对照实现，不应作为新的功能入口或发布目标。
访问与登录
本地运行 React 管理后台后，访问 http://127.0.0.1:5000/。根路径和 /admin 会自动跳转到工作空间页；未登录访问受保护页面会跳转到 /login，并在登录成功后回到原页面。
| 项目 | 当前行为 |
|---|---|
| 登录页 | /login，使用管理员账号和密码。 |
| 默认首页 | /admin/workspaces，用于查看工作空间与项目归属。 |
| 登录凭证 | 浏览器本地保存访问令牌；令牌失效或收到 401 时自动清除并回到登录页。 |
| 请求入口 | 浏览器请求经 /system-api 转发到 Gateway，不直接暴露内部服务端口。 |
| 页面主题 | 默认蓝白企业主题；顶部日/月图标可切换暗黑主题，选择保存在当前浏览器。 |
管理权限最终由后端校验。即使浏览器中能打开一个地址，也不代表当前账号拥有对应资源的读取或修改权限。
适用角色
| 角色 | 主要目标 | 常用模块 |
|---|---|---|
| 平台运营 | 处理用户、工作空间、订单和权益问题。 | 工作空间、用户与额度、订单中心、额度流水。 |
| AI 运营 | 上线模型、观察调用质量和成本。 | AI 提供商、模型、渠道、分组、任务中心、成本分析。 |
| 计费运营 | 管理商品、支付渠道、订单与积分规则。 | 商业化中心、商户配置、订单中心、AI 计费规则。 |
| 系统管理员 | 维护管理员账号与全局运行策略。 | 管理员、系统策略、生成策略中心。 |
导航与路由
左侧导航的每一项都对应一个可直达的前端路由。需要分享给已登录的同事或进行验收时，使用下表地址；生产环境必须配置 SPA 回退，详细配置见Web 开发与发布。
概览与账户资源
| 页面 | 地址 | 用途 |
|---|---|---|
| 工作空间 | /admin/workspaces | 查看、新建、编辑工作空间，并进入空间查看项目。 |
| 空间详情 | /admin/workspaces/:id | 查看单个空间的归属、额度、项目和画布统计。 |
| 素材库 | /admin/assets | 检索平台素材及生成资产。 |
| 用户与额度 | /admin/users | 查看用户、用户组、账号状态与额度信息。 |
| 额度流水 | /admin/credit-logs | 审计额度的消费、赠送或调整记录。 |
| 商业化中心 | /admin/billing | 维护会员、积分商品、价格和权益。 |
交易与结算
| 页面 | 地址 | 用途 |
|---|---|---|
| 商户配置 | /admin/payment-configs | 管理支付商户、校验配置、启停及设置默认渠道。 |
| 订单中心 | /admin/orders | 汇总查看会员与积分订单。 |
| 会员订单 | /admin/membership-orders | 只查看会员及团队会员购买订单。 |
| 积分充值订单 | /admin/credit-orders | 只查看积分充值和活动包订单。 |
| 支付流水 | /admin/payment-records | 查看支付渠道回传的交易流水。 |
AI 网关与系统配置
| 页面 | 地址 | 用途 |
|---|---|---|
| AI 提供商 | /admin/ai-providers | 维护第三方服务商的接入信息。 |
| AI 模型 | /admin/ai-models | 维护模型能力、类型和默认参数。 |
| AI 渠道 | /admin/ai-channels | 配置可调用渠道、凭证、权重和健康状态。 |
| AI 分组 | /admin/ai-groups | 将可用渠道编排为稳定的路由分组。 |
| 价格规则 | /admin/ai-prices | 设置模型成本与用户扣费关联规则。 |
| AI 任务中心 | /admin/ai-tasks | 检索任务队列、失败记录和任务详情。 |
| AI 成本分析 | /admin/ai-cost-logs | 分析渠道调用成本和用户扣费。 |
| 生成策略中心 | /admin/canvas-attribute-options | 管理可选生成属性、Skill 与绑定关系。 |
| AI 计费规则 | /admin/quota-formula | 配置图片/视频的积分计算公式和倍率。 |
| 管理员 | /admin/admin-users | 管理后台账号、角色和登录策略。 |
| 系统策略 | /admin/settings | 管理账号入口、免费额度与任务调度策略。 |
页面通用操作
- 先确认位置：通过左侧菜单或浏览器地址确认当前模块。切换页面时，移动端菜单会自动收起；桌面端可用侧栏收缩按钮腾出表格空间。
- 筛选后再操作：列表页面一般提供关键词、分页、刷新和状态筛选。先缩小到目标对象，打开详情核对 ID、所属用户、时间和状态。
- 区分保存与启用：保存只是写入配置；模型、渠道、商户等资源还可能需要单独启用、设为默认或校验。不要把“已保存”当作“已对用户可用”。
- 保留证据：涉及额度、订单、任务和渠道时，记录对象 ID、操作时间、操作者、前后状态和关联任务/订单号。
- 处理错误提示：页面会将服务端错误转换为可读提示。
401表示登录失效，403表示权限不足，409表示资源冲突，5xx表示后端暂不可用；不要绕过提示直接改数据库。