管理员后台

用途

管理员后台只对管理员账号开放；普通用户访问时会返回个人页面或拒绝访问。后台操作影响全局内容和生产结果，应使用独立管理员账号并限制共享。

后台与客户端共用 VVICAT 品牌视觉：金色灵狐代表敏捷创作，尾部电路代表模型与生产流程的连接。暖金仅用于主操作、焦点和当前导航，业务成功、警告与错误仍使用各自语义颜色；键盘焦点、移动端触控区域和减少动态偏好均保持可用。

使用前准备

使用独立管理员账号登录，确认本次操作的用户、项目、环境和影响范围。涉及全局提示词、艺术风格、影视知识或队列操作时，先准备回滚与审计记录。

配图占位

• 页面：管理员后台总览与左侧导航
• 状态：可见用户、项目、任务、日志、通知、内容配置和影视知识入口
• 重点区域：模块导航、只读指标、刷新时间和环境标识
• 脱敏要求：隐藏邮箱、项目内容、任务输入输出、Token、余额和日志敏感字段

操作步骤

运营与审计

在“项目查询”中找到目标项目，点击“管理授权”，搜索并选择用户后保存。被授权用户会在自己的项目列表中看到该项目，并可进入现有工作区；项目所有者保持不变，也不需要加入授权列表。清空授权用户并保存即可撤销全部协作访问。

内容配置

提示词和系统艺术风格会直接影响生成质量。修改提示词时必须维护中英文磁盘源文件、国际化目录注册与数据库同步；不要只在数据库中临时修改后遗漏代码源。

提示词管理支持按提示词 ID、数据库名称与说明，以及页面显示的中文名称和功能说明搜索。例如输入“故事版分镜生图”可定位 np_panel_storyboard_image。故事版生视频使用独立的 np_panel_storyboard_video，不再与宫格生视频模板共用。画布 MiniMax H3 Ref2VA 模板为 canvas_panel_h3_video，用于把整张宫格或故事版参考图改写为 H3 的全参考视频提示词；模板要求六段英文输出、保留原文对白和画内文字，且不得把分格、标注或 UI 生成到成片中。

系统艺术风格属于全局初始化数据。发布前应验证名称、描述、可见范围和默认关系，避免删除仍被项目引用的条目。

影视知识库

知识后台包括条目、绑定、参考资料和标签。知识条目只有绑定到正确的“应用点”后，才会在相应提示词或生产流程中生效。

维护顺序：

1. 创建或更新知识条目及标签。
2. 检查参考资料和内容来源。
3. 绑定到正确应用点并设置作用范围。
4. 运行种子、初始化快照导出和回灌验证。
5. 使用受控样例验证生产结果，不直接在生产用户项目试错。

内置知识的默认绑定按生产语义收敛：镜头拆分只使用镜头角度、构图和转场知识，静态图片不使用运镜知识，分镜图片、项目封面和场景资产不使用人物造型知识。当前没有专用道具知识，因此道具提示词不预置默认绑定。

运行时匹配会忽略“构图、光影、摄影、运镜、表演”这类仅表示专业领域的宽泛标签，也不会把“高级、日常、发现、冲突、真实、自然、柔和、突出”等歧义短词单独作为命中证据；角色性别明确时，相反性别的造型知识会被排除。普通加权模式下，同一次解析每个知识类别最多选择一个知识条目，但会保留该条目的全部使用方式，避免丢失输出约束。强制包含不受类别去重限制。

“引用审计”区分三种状态：“零命中”表示流程已调用解析器但没有足够具体的标签；“已解析待确认”表示知识已命中，但生成链路尚未确认实际模型请求；“已确认注入”表示系统已记录实际发送给文本、图片或视频模型的最终提示词。文本模型步骤还会记录模型输出，便于核对输入与结果。

引用审计顶部按当前应用点和日期范围统计知识命中率、确认注入率、人工严格准确率和人工评审覆盖率。打开一条新版记录后，管理员可评价为“准确”“部分准确”或“不准确”，并记录误命中、漏命中或待调整规则。严格准确率只计算“准确”，部分准确仅进入可接受准确率；所有准确率只使用已人工评价样本，不能把命中率当作准确率。升级前产生的旧版记录无法证明提示词确实提交给模型，系统会标记为旧版、禁止评价并排除在指标之外；服务和 worker 重启后新产生的 v2 记录才进入统计。

影视知识还包含独立的“规范词汇”运营页。管理员可新增或编辑景别、视角和运镜的稳定代码、中英文名称、别名、专业说明、排序和启停状态；故事板规划、细化、插镜和镜头变体流程运行时统一读取该词表，不再在各提示词中分别维护完整枚举。显式停用的记录不会进入后续提示词，重新执行种子或项目初始化也不会覆盖运营人员设置的启停状态。升级新增但数据库尚未保存的规范术语会自动使用内置定义，避免部署顺序阻断生成。稳定代码创建后不可在后台修改；业务 API 的字段结构、必填项和降级规则仍由代码控制。

跨提示词复用的场景类型摄影风格、表演风格、可视化动作词汇、角色年龄性别和角色档案参考词汇由代码中的受控词表统一注入。提示词中的连续性、字段保留、特写限制、JSON 安全和输出结构仍保留为各任务自己的执行规则，不作为可运营枚举。

重新运行 npm run seed:cinema-knowledge 时，会以代码中的规则校准内置知识的全局默认绑定，并删除已经不再属于默认规则的旧绑定；项目级绑定不受影响。npm run project:init 只执行幂等 upsert，不负责删除旧绑定。需要长期保留的自定义关系应使用项目级绑定，或先把规则纳入代码和初始化快照。

总队列监控

模型配置

后台“模型配置”统一维护供应商实例、服务端凭据和模型目录。新建供应商时从项目内置预设中选择并自动带入推荐连接参数；编辑旧配置时可显式应用预设，API Key 不会被预设或空输入覆盖。已有供应商类型创建后不可修改；删除会停用并软删除供应商，使其从新任务配置中隐藏。Base URL、API 模式、网关路由和凭据轮换会影响尚未开始的任务。供应商和模型列表均支持筛选。

模型先保存草稿修订，再发布给用户。表单按文本、图片、视频、音频和口型同步类型，只显示该类型支持的协议、能力、用量指标与计价维度；协议、币种、推理强度、分辨率、时长、帧率和画面比例均使用受控选项。Token 固定按 100 万为计费单位，供应商成本直接填写币种金额并支持最多 6 位小数，保存时转换为整数微单位。后端会再次拒绝模型类型不支持的协议、指标和维度。

后台 API 不返回明文密钥。保存空密钥表示保持现值，清除密钥使用独立确认操作；连接测试只返回脱敏步骤和结果。

相关管理员接口位于 /api/admin/ai-providers 与 /api/admin/models。创建、修改、停用、清除密钥和发布修订均要求管理员身份并写入审计日志；已发布修订不可再次编辑。

后台“任务查询”页每 5 秒自动刷新数据库任务状态和 Redis 队列状态。顶部统计区展示排队、执行中、完成和失败的业务任务数，并汇总 Redis 中等待与执行中的任务；下方按图片、视频、语音和文本队列展示 Worker 数量、等待、执行、延迟、完成和失败数量，以及运行、暂停、无 Worker 或不可用状态。队列不可用时任务列表仍可用于排查数据库记录。

状态统计用于只读监控，不会在后台自动重试、清理或取消任务。数据库任务数与 Redis 任务数短暂不一致可能来自入队事务、Worker 状态回写延迟或历史任务清理；持续不一致时应结合任务错误和日志排查。

Bull Board

开发环境的 Bull Board 默认位于 http://localhost:3010/admin/queues。它用于观察等待、运行、完成和失败任务。清理或重试任务可能改变业务状态，执行前应结合数据库记录与应用日志判断。

[!WARNING] 管理员页面不是数据修复脚本的替代品。涉及批量删除、权限提升、初始化数据或账务类状态时，应先备份并走可审计流程。

结果与状态

后台页面展示数据库业务状态、全局配置和 Redis 队列健康度。短暂统计差异可能来自入队事务或 Worker 回写延迟；持续不一致时必须结合任务记录和日志判断。

权限和限制

• 只有管理员可访问；管理员权限不取消项目与用户数据的用途限制。
• 只有管理员可以增删项目授权用户；普通用户不能自行转授，项目所有者也不会因授权变化而改变。
• 任务监控默认只读，不自动重试、清理或取消任务。
• 提示词、系统艺术风格和影视知识属于全局初始化或运营数据，修改后需按对应同步与验证流程发布。
• 批量删除、权限提升和账务相关修复必须备份并留下可审计记录。

常见问题

数据库任务数与 Redis 数量为什么不同？

短暂差异通常来自事务、回写或历史清理延迟。若持续存在，按任务 ID 检查队列状态、Worker 和应用日志，不要直接批量重试。

普通账号为什么被送回个人页面？

管理员布局会校验角色。确认登录账号具有管理员权限，并检查会话是否仍有效。

相关文档

• 消息与异步任务
• 项目授权用户
• 影视知识评测
• 故障排查