浏览器后台操作手册

约 2282 字大约 8 分钟

本手册对应当前的 React 浏览器管理后台 fronted_admin_web/，不是创作者使用的 Web 网站端。页面名称和菜单顺序以现有实现为准。进行影响用户、费用或生产流量的操作前，请先阅读对象详情并确认当前环境。

登录与全局控制

登录

打开 /login，输入管理员账号和密码。
仅在受控设备勾选“记住账号”；该选项只保留账号名，登录令牌由浏览器会话管理。
登录成功后默认进入“工作空间”。若是从特定地址跳转到登录页，系统会返回原目标地址。
右上角点击刷新图标可重新加载当前页面；点击主题图标在蓝白和暗黑主题间切换；头像菜单可退出登录。

列表与弹窗

控件	推荐用法
搜索框	输入关键词后执行搜索；清除条件后回到完整列表。
刷新	用于重新读取服务端状态，不会撤销未保存的弹窗表单。
分页	总数较大时通过页码和每页条数定位目标，操作前始终核对 ID。
编辑弹窗	先阅读提示、补全必填字段，再保存。保存后刷新列表核实最终状态。
启用/停用	只在已核对关联关系、替代资源和影响范围后使用。
删除确认	删除通常影响关联记录；确认前先导出或记录必要的业务标识。

工作空间、素材与用户

工作空间

工作空间是用户创作项目的管理边界。进入“工作空间”后可搜索、刷新、新建、编辑或删除空间。

查看用户项目的标准步骤：

在 /admin/workspaces 用空间名或用户线索搜索。
核对空间的所属用户、用户状态、当前额度和项目数量。
点击“进入空间”，进入 /admin/workspaces/:id。
在空间详情中继续按项目名称搜索，查看项目的节点、连线、对话和素材统计。
需要定位具体问题时，记录空间 ID、项目 ID 和更新时间，再到 AI 任务中心、素材库或用户页交叉检查。

删除工作空间前，先确认该空间下项目的归属与关联是否允许失效。删除不是普通的清理按钮，不能用来处理单个任务失败。

素材库与用户额度

素材库：按资源线索定位素材或生成资产，核对归属、创建时间、状态与关联任务后再处理。素材问题优先沿着资源 ID 和任务 ID 排查。
用户与额度：核对账号、用户组、状态和余额。用户投诉扣费或余额异常时，不先改余额，先到“额度流水”和“订单中心”找出原始记录。
额度流水：按用户、时间和业务单号查询额度变化，记录发生时间、变化方向、关联任务/订单和余额结果，用于后续审计。

商业化、订单与支付

商业化中心

在 /admin/billing 管理会员、积分商品、定价和权益。一个商品发布前至少完成以下核对：

商品名称、展示文案、金额、积分或会员权益一致。
生效范围、启停状态和用户可见条件符合当前运营方案。
对应支付商户已通过校验且存在一个可用默认渠道。
使用测试账号完成下单，并回查订单状态、支付流水及额度/权益到账。

商户配置

“商户配置”是支付配置的唯一浏览器入口。敏感凭证只应由有权限的管理员在受控环境填写，绝不能复制到截图、表格、工单或浏览器地址中。

新建或切换默认商户：

进入 /admin/payment-configs，点击“新建商户”。
按支付平台要求填写基础信息、回调相关信息和受控凭证；确认回调地址为公网 HTTPS，且已加入商户平台白名单。
保存后点击“校验”，先解决校验错误再启用。
启用已校验的商户；只有启用状态的商户才可设为默认。
设置默认商户后，用测试订单验证下单、回调、订单成功和权益到账。
切换完成且新商户稳定后，再停用旧商户。默认商户不能直接删除。

订单与支付流水

订单中心可按场景拆分为全部订单、会员订单、积分充值订单和支付流水。处理订单问题的顺序是：

使用订单号、用户标识或时间范围搜索订单。
比较订单金额、商品、支付状态和完成时间。
进入支付流水确认第三方支付的结果与回调时间。
若订单已成功，继续检查会员权益或额度流水是否已经入账。
记录订单号、支付交易号、用户 ID 和时间后再发起后端排障；不要用浏览器直接伪造成功状态。

AI 网关

AI 能力上线有明确依赖顺序：提供商 -> 模型 -> 渠道 -> 分组 -> 价格/计费 -> 用户侧验证。配置一处后看不到用户可用模型时，按这个顺序回查。

页面	日常动作	验收要点
AI 提供商	创建或维护第三方服务商信息。	不在名称、备注或日志中泄露密钥。
AI 模型	声明模型代码、类型、能力和默认参数。	模型类型与实际图片/视频能力相符。
AI 渠道	绑定提供商和模型，配置凭证、权重和启停状态。	渠道校验通过，启用状态与上游可用性一致。
AI 分组	将多个渠道组织为稳定路由池。	分组包含可用渠道，故障渠道有替代路径。
价格规则	维护成本、面向用户的扣费规则及生效范围。	与商品、积分规则和模型能力一致。
AI 任务中心	搜索任务，查看状态、输入、错误和关联信息。	使用任务 ID 能追溯模型、渠道与时间。
AI 成本分析	观察模型/渠道调用成本与用户扣费。	异常峰值可以定位到具体任务或渠道。

涉及完整上线流程时，按案例：上线一个 AI 渠道执行；该教程包括准备信息、逐步配置、用户侧验证和回滚检查。

系统配置

生成策略中心

生成策略中心提供“生成属性选项”和“Skill 库”两个标签页：

在生成属性选项中维护角色、场景、商品或镜头可用的属性分组、选项值与补充提示词。
在 Skill 库中创建可复用的 Prompt、Workflow、Reference 或 File 型规则，可保存内容、链接、标签和描述。
通过“绑定 Skill”关联选项和规则，保存后检查启用状态。
用对应用户端/画布的一个最小请求验证最终编排结果；仅在列表存在不代表服务端已按预期使用。

AI 计费规则

在 /admin/quota-formula 分别维护图片和视频规则。规则包括基础积分、最低/最高扣费、渠道倍率、模型倍率以及关联素材倍率。

先选择图片或视频标签，确认页面读取的启用渠道与可用模型数量正确。
调整基础积分、边界值和需要生效的倍率。
保存后，以一组固定输入运行测试任务，核对预期公式与实际扣费。
修改倍率时记录旧值、新值和生效时间；计费变更应有复核记录。

管理员与系统策略

管理员：管理后台账号、角色与多端登录策略。新账号先分配最小必要权限，再由实际工作验证可访问范围。
系统策略：按分类维护账号入口、免费额度和任务调度。保存栏会显示“等待保存”“已保存”或需修正状态；存在校验错误时先修正，再保存。

操作后的验收清单

刷新页面后，配置、状态和列表数据仍然与预期一致。
新配置确实被用户端或测试账号读取到，不只存在于后台列表。
订单、任务和额度类操作能通过 ID 回查到对应流水。
关闭或替换资源后，仍有经过验证的可用替代路径。
变更记录包含操作者、时间、对象 ID、前后状态、验证结果和回滚方式。