智剧通（ZJT）文档中心 管理后台使用指南

管理后台使用说明

本文档介绍管理后台的功能和使用方法。

访问入口

  1. 顶部导航栏：管理员登录成功后，首页会立即刷新当前用户角色，并在顶部导航栏显示「管理后台」按钮
  2. 直接访问：访问 /admin 路径

权限要求

如何成为管理员

方式一：首个注册用户（推荐）

系统会自动将第一个注册的用户设置为管理员。

首次安装系统后，第一个注册的用户将自动：

  1. 获得 admin 角色
  2. 跳转到管理后台进行快速配置
  3. 配置完成后引导查看使用手册

方式二：现有管理员设置

已有管理员可以在「用户管理」页面将普通用户提升为管理员，或将管理员调整为普通用户。

功能模块

1. 仪表盘

显示系统概览数据：

指标说明
用户总数系统注册用户总数
3天活跃工作流最近3天有更新的工作流数量
月活用户当月活跃用户数量（需手动点击查询）

1.1 模型成功率分析

仪表盘下方展示模型成功率分析图表和表格：

2. 用户管理

2.1 用户列表

2.2 用户操作

操作说明
查看详情查看用户完整信息（ID、手机号、角色、状态、算力、邀请码、注册时间）
调整算力增加或扣减用户算力（需填写原因）
审批登录对状态为"待审核"的用户进行审批通过
启用/关闭智剧通Token开启或关闭用户的智剧通Token功能（非标准版）
调整有效期调整用户智剧通Token的过期时间（非标准版，需Token已启用）
禁用/启用切换用户状态
角色切换在用户详情弹窗中将普通用户提升为管理员，或将管理员调整为普通用户

2.3 算力调整

3. 系统配置

管理系统全局配置项。

3.1 配置列表

3.2 配置操作

操作说明
快速配置引导式配置向导，支持按分类（大模型/多媒体）选择服务商并填写API密钥
初始化配置初始化系统默认配置
刷新缓存刷新配置缓存使修改生效
编辑修改配置值（支持字符串、数字、布尔、JSON类型）
查看历史查看配置项的修改历史记录

3.3 快速配置弹窗

快速配置采用两栏模式：

3.4 敏感配置

4. 签到管理

管理用户每日签到功能的配置。

配置项说明
启用签到开关签到功能
基础奖励每次签到获得的算力值
连续签到奖励开关连续签到额外奖励
奖励阶梯配置连续签到天数与对应额外奖励

5. 模型服务管理

管理AI模型服务（服务商）的配置。

5.1 使用说明

5.2 分组展示

模型服务按服务类型标识分组展示（如图生视频、文生视频等），每组包含：

列说明
排序值数字越小优先级越高，可直接编辑
名称模型服务标识名
显示名称模型服务展示名称，标记"使用中"为当前默认
算力配置支持按时长配置不同算力值，可恢复默认值
描述模型服务功能描述

5.3 算力配置

6. 通知中心

展示系统通知和版本更新信息。

6.1 版本升级提示

当检测到新版本时，显示升级横幅：

6.2 二进制依赖提醒

6.3 通知列表

API 接口

所有管理接口需要在请求头中携带 Authorization: Bearer <token>，且用户角色必须为 admin。

仪表盘

GET /api/admin/dashboard

响应示例： 

{
    "code": 0,
    "data": {
        "total_users": 1234,
        "active_workflows_3d": 56
    }
}

月活用户查询

GET /api/admin/dashboard/monthly-active-users

响应示例： 

{
    "code": 0,
    "data": {
        "active_user_count": 89,
        "year": 2026,
        "month": 5
    }
}

模型成功率分析

GET /api/admin/dashboard/model-analysis?days=7&start_date=2026-06-03&end_date=2026-06-09

参数：

返回数据包含模型汇总 models 和每日聚合 daily。前端使用 daily[].models 渲染每日趋势折线图、每日堆积柱状图，并使用 models 渲染调用量玫瑰图和明细表格。

用户列表

GET /api/admin/users?page=1&page_size=20&keyword=138&status=1&role=user

参数：

用户详情

GET /api/admin/users/{user_id}

更新用户状态

PUT /api/admin/users/{user_id}/status
Content-Type: application/json

{
    "status": 0  // 0=禁用, 1=正常
}

更新用户角色

PUT /api/admin/users/{user_id}/role
Content-Type: application/json

{
    "role": "admin"  // user 或 admin
}

调整用户算力

POST /api/admin/users/{user_id}/power
Content-Type: application/json

{
    "amount": 100,      // 正数增加，负数扣减
    "reason": "系统补偿"  // 必填
}

响应示例： 

{
    "code": 0,
    "message": "算力调整成功",
    "data": {
        "old_power": 500,
        "new_power": 600
    }
}

审批用户登录

通过更新用户状态实现（将待审核用户 status=2 改为正常 status=1）： 

PUT /api/admin/users/{user_id}/status
Content-Type: application/json

{
    "status": 1  // 1=正常
}

切换智剧通Token

PUT /api/admin/users/{user_id}/zjt-token
Content-Type: application/json

{
    "enabled": true
}

获取智剧通Token状态

GET /api/admin/users/{user_id}/zjt-token

调整Token有效期

PUT /api/admin/users/{user_id}/zjt-token-expire
Content-Type: application/json

{
    "expire_at": "2027-01-01"  // 格式 YYYY-MM-DD；传 null 表示永不过期
}

系统配置列表

GET /api/admin/config?page=1&page_size=20&keyword=search

更新配置

PUT /api/admin/config/{config_key}
Content-Type: application/json

{
    "config_value": "new_value"
}

配置历史

GET /api/admin/config-history?config_key={config_key}

初始化配置

POST /api/admin/config/init

刷新配置缓存

POST /api/admin/config/reload

签到配置

签到配置通过通用的系统配置接口管理，配置键以 checkin. 为前缀： 

GET /api/admin/config?keyword=checkin    # 查看签到相关配置
PUT /api/admin/config/{config_key}       # 修改单个配置项
PUT /api/admin/config/batch              # 批量修改配置

相关配置键：

模型服务管理

GET /api/admin/implementation-configs           # 获取模型服务配置列表
GET /api/admin/implementation-powers            # 获取模型服务算力配置
PUT /api/admin/implementation-config            # 更新模型服务配置（排序、启用等）
POST /api/admin/implementation-power            # 设置模型服务算力
DELETE /api/admin/implementation-power          # 删除模型服务算力配置
POST /api/admin/implementation-configs/sort-order   # 批量更新排序

通知管理

GET /api/notifications/admin/list?page=1&page_size=20
DELETE /api/notifications/admin/{id}

安全说明

  1. 权限校验：所有 /api/admin/* 接口都会校验管理员权限
  2. 自我保护：管理员不能禁用自己、不能降级自己的权限
  3. 操作记录：算力调整会记录操作原因和管理员信息
  4. 敏感配置保护：敏感配置值默认脱敏显示，需手动点击查看完整值
  5. 标准版限制：部分功能（如智剧通Token管理、专业版服务商）在标准版中不可用

国际化支持

管理后台支持多语言切换：

文件结构

api/
├── __init__.py          # API 模块
├── admin.py             # 管理员 API 路由
└── notifications.py     # 通知 API 路由

web/
├── admin.html           # 管理后台主页面（Vue 3 单页应用）
├── css/
│   └── admin.css        # 管理后台样式
└── js/
    └── admin.js         # 管理后台逻辑（Vue 3 应用、服务商配置定义）

i18n/
├── i18n-core.js         # 国际化核心库
├── i18n-dom.js          # DOM 扫描翻译
└── i18n-switcher.js     # 语言切换器

server.py                # 主服务（通过 include_router 注册 admin 路由）

model/
├── users.py             # UsersModel 管理员方法
├── computing_power.py   # ComputingPowerModel.admin_adjust
├── video_workflow.py    # VideoWorkflowModel.count_active_recent_days
└── notifications.py     # 通知数据模型

services/
└── notification_service.py  # 通知拉取服务

config/
├── constant.py          # NotificationConstants 等常量定义
└── required_binaries.yml # 二进制依赖配置

alembic/versions/        # 数据库迁移脚本

后续扩展

以下功能暂未实现，可根据需要后续添加：