企业官网建设流程全解析

PRINTFILM管理后台实操指南：用户、订单、模型路由与任务中心一文讲透

【免费下载链接】printfilmPRINTFILM：AI 视频获客与 AI短剧创作平台项目地址: https://gitcode.com/gh_mirrors/pr/printfilm

PRINTFILM 是面向 AI 视频获客与 AI 短剧创作的开源平台，它的管理后台（默认端口 8081）是运营者的"驾驶舱"：用户与余额、充值订单、钱包流水、模型路由、任务中心都在这里集中管理，无需改一行代码。

本文按新手视角走一遍后台核心页面，看完即可独立完成日常运营。

一、快速认识管理后台：入口与导航布局

启动服务后，用管理员账号登录http://localhost:8081（需先在用户端用该邮箱注册，再通过ADMIN_BOOTSTRAP_EMAILS提权，见 README.md）。登录页之后，界面统一为"深色侧边栏 + 内容区"布局，侧边栏分成五组：

路由定义集中在 admin/src/App.tsx，所有页面都受RequireAdmin守卫保护——没有 JWT 或角色不是 admin 会被直接弹回登录页，安全性不用操心。

二、用户管理：搜索、调角色、改余额一步到位

进入「用户管理」，顶部统计条实时给出总用户数、本月调用、累计调用三个关键指标，配合筛选栏即可快速定位目标用户。

常用操作只有三步：

1. 搜索：支持按邮箱 / 昵称 / 账号 ID 模糊搜索，还可以按角色（user / admin）过滤；
2. 查看：点开"查看"，右侧抽屉展示该用户的详细情况；
3. 编辑：弹窗里可修改角色、余额（元）并填写调账备注（可选），保存后列表即时刷新。

余额以"元"输入、以"分"存储（见 UsersPage.tsx 的转换逻辑），给某用户赠送 10 元体验金时直接填10并写上备注即可，后台会记入钱包流水，事后可审计。

三、订单与流水：三个页签看懂钱从哪来、花到哪去

「订单流水」页把资金相关的数据拆成三个页签（见 OrdersPage.tsx），运营时基本按这个顺序看：

充值订单：核对每一笔到账

• 筛选状态（待支付 / 已支付 / 已关闭）与用户；
• 表格列出商户单号、SKU、金额、入账金额、支付方式、渠道单号与支付时间；
• 点击行打开订单明细弹窗，可一键复制商户单号，方便与支付渠道对账。

钱包流水：追踪每分钱的进出

流水类型覆盖充值、赠送、调账、冻结、解冻、结算、退款七种，金额变动正负着色，"关联"列可以直接跳转回对应的订单或用户，排查"用户说余额不对"时非常高效。

用量明细：AI 调用扣费的显微镜

这是平台"可选计费"模式下最重要的页签：按用户、任务 ID、领域（科普 / 漫剧 / 工作室 / 开放 API）、能力（LLM 文本 / 生图 / 视频 / 配音）、billing_key、日期区间组合筛选，还能看到每条记录的 Tokens、扣费金额、上游成本，以及计费依据（估算 / 上游实测 token / 实测费用）——用户问"这一条视频为什么扣了这些钱"，来这里就有答案。

财务列表：一张表算清利润

「财务列表」按日汇总本地扣费、本地成本、Token 消耗、官方实际成本与利润（FinanceListPage.tsx），支持 7 / 14 / 30 / 90 日区间切换；点「刷新官方成本」会同步 TokenFree New API 侧的真实账单，利润列正绿负红，月底算账不用再手工拼表。

四、模型路由与支付计费：一处配置，全平台生效

「系统设置」包含五个页签：模型、运行参数、存储 OSS、支付计费、站点工具。对新手最关键的是前两个和支付页签。

模型路由：填 Key、选默认模型，保存即生效

• 上游渠道已锁定为 TokenFree New API，只需粘贴API Key（已保存时留空不修改，密钥加密存库，不会以明文落盘）；
• 下方"默认模型"提供文本 / 图像 / 视频 / 配音四个预设下拉，仅设置站点默认值，用户在端侧仍可选择全部预设；
• 页面顶部的"配置就绪"指示条会逐项点亮：API Key、四类模型全部就绪后即可真实出片；
• 若历史默认值不在预设里，会提示"已映射到预设"，保存前先确认（见 RoutingSettingsPanel.tsx）。

改完模型不必动.env、不必重启，保存后即时生效——这是管理后台相比环境变量的最大优势。

运行参数与支付计费：并发、Mock、易支付

• 运行参数页调节生成质量与吞吐：出图尺寸、视频分辨率 / 比例、Seedance 时长范围、图 / 视频 / 音频流水线并发、任务运行时最大并发、轮询间隔，还有ARK_MOCK开关（无 Key 时用它看界面）；
• 支付计费页配置易支付（商户号、API 地址、Key、通知 / 回跳地址）、计费总开关与各类模型费率，并支持查询上游余额（见 PaymentSettingsPanel.tsx）；
• 计费细节可延伸阅读 docs/BILLING.md。

五、任务中心：所有 AI 生成任务尽收眼底

「任务中心」是整个平台的统一任务平台监控页（QueuesPage.tsx），科普短视频、漫剧、开放 API 的任务都在同一张列表里：

• 四张统计卡：排队中、进行中（执行 + 轮询）、运行时槽位（当前并发 / 上限）、终态统计（成功 / 失败 / 取消）；
• 各领域任务卡片按领域拆分排队与成功数，一眼看出哪条产品线在"堵车"；
• 页面每 15 秒自动刷新，也可手动点刷新；
• 列表支持按领域、状态（排队中 / 已租约 / 执行中 / 等待轮询 / 已成功 / 失败 / 已取消）、用户、任务类型、关键词筛选；
• 每行可看提交参数与结果摘要（截断预览，悬停看更多）与费用（实扣或预扣）；
• 对仍在执行的任务可一键取消，取消请求确认后进入"取消中"状态。

排查"用户的视频卡住了吗"时，这里就是第一现场。

六、漫剧与模板管理：内容侧的日常运营

• 漫剧分组（项目 / 资产库 / 分集 / 分镜）提供只读明细：可以查看用户创建的每个短剧项目、角色场景资产与分镜进度，配合用量明细快速定位高价值内容。漫剧分集规则详见 docs/EPISODE_RULES.md。
• 模板管理负责 AI 短视频的 20+ 内置风格模板（获客、科普、口播、国潮等），模板种子定义在 backend/app/services/templates_seed.py，封面与预览图见 backend/static/templates/covers/ 目录。

小结：运营闭环怎么走

日常运营可以形成一条清晰动线：仪表盘看大盘 → 用户管理处理调账与角色 → 订单流水核对资金 → 任务中心盯生成 → 系统设置调模型与费率。PRINTFILM 管理后台把用户、订单、模型路由与任务中心收敛在同一入口，配合可选计费与加密密钥存储，让自托管运营既省心又可控。

更多规范与专题文档，可继续查阅 docs/ 目录（工程规范、计费说明、Seedance 参数等）。

【免费下载链接】printfilmPRINTFILM：AI 视频获客与 AI短剧创作平台项目地址: https://gitcode.com/gh_mirrors/pr/printfilm