更新记录

1.0.2（2025-10-20）下载此版本

更新

1.0.1（2025-10-20）下载此版本

优化

1.0.0（2025-10-20）下载此版本

新版本上线

平台兼容性

云端兼容性

阿里云	腾讯云	支付宝云
√	√	√

uni-app(4.36)

Vue2	Vue3	Chrome	Safari	app-vue	app-nvue	Android	iOS	鸿蒙
√	×	√	√	√	×	×	×	×

微信小程序	支付宝小程序	抖音小程序	百度小程序	快手小程序	京东小程序	鸿蒙元服务	QQ小程序	飞书小程序	快应用-华为	快应用-联盟
×	×	×	×	×	×	×	×	×	×	×

其他

多语言	暗黑模式	宽屏模式
√	×	√

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

CSora AI 视频生成平台管理后台

项目名称：`csora-admin`

作者：CSora Team

项目简介

CSora 是一个基于 AI 的视频生成平台管理后台系统，支持通过文本描述和参考图片生成高质量的 AI 视频。

技术栈：uniapp + unicloud + vk-unicloud-admin + element-ui
适用场景：AI 视频生成平台的完整管理后台解决方案
核心功能：视频任务管理、用户管理、积分充值套餐管理、店铺配置等

⚠️ 重要提示

本插件无法独立运行，需要搭配 CSora 客户端使用！

📱 客户端购买传送门： CSora2 - AI 视频生成应用

CSora 是一个完整的 AI 视频生成平台解决方案：

客户端（csora2-ai-video）：用户端应用，用户可以通过客户端创建视频、查看作品、充值积分等

管理后台（csora-admin）：本项目，管理员用于管理用户、配置系统、查看数据等

云函数：统一部署在客户端项目中，管理后台通过绑定客户端的服务空间来使用

💡 建议部署顺序：

先购买并部署客户端项目

再部署本管理后台项目

管理后台绑定客户端的云服务空间

📸 系统截图演示

管理平台主页

管理后台主界面

主要功能模块

1. 视频任务管理

任务列表查看：查看所有用户提交的视频生成任务
任务状态管理：实时监控任务状态（排队中、生成中、已完成、失败）
任务详情查看：查看任务的详细参数（模型、提示词、参考图片、时长、清晰度等）
视频预览播放：在线预览已生成的视频
任务统计分析：统计各状态任务数量，分析平台使用情况

2. 用户管理

用户列表：查看所有注册用户信息
用户详情：查看用户详细信息和积分余额
用户积分管理：手动调整用户积分余额
积分流水记录：查看用户的积分充值、消费明细
用户权限管理：设置用户角色和权限

3. 积分充值套餐管理

套餐列表：管理平台的充值套餐
套餐配置：
- 设置充值金额（单位：分）
- 设置赠送积分数量
- 设置额外赠送积分（优惠活动）
- 套餐标签（如：推荐、热门等）
- 套餐排序
套餐上下架：控制套餐的可用状态

4. 店铺设置

积分配置：
- 标准模式所需积分
- 高清模式所需积分
- 新用户注册赠送积分
支付配置：
- 是否开启线上支付
- 线上支付关闭时引导用户联系客服
客服配置：
- 上传客服二维码
- 用户可扫码联系客服

5. 系统管理

角色管理：配置管理员角色和权限
权限管理：精确到每个功能的权限控制
菜单管理：配置后台菜单结构
操作日志：记录管理员的所有操作
登录日志：记录用户登录信息

技术特点

1. 基于 vk-unicloud-admin 框架

完美集成 vk-unicloud-router，拥有强大的云函数路由功能
完美集成 element-ui，提供丰富的 UI 组件
万能表格组件，快速实现数据的 CRUD 操作
万能表单组件，通过 JSON 配置即可渲染表单

2. 云开发优势

免运维：基于 uniCloud，无需购买和维护服务器
弹性伸缩：自动扩容，应对高并发场景
按量计费：用多少付多少，降低运营成本
数据安全：数据存储在云端，自动备份

3. 开箱即用

完整的权限管理系统
美观的 UI 界面
丰富的示例代码
详细的开发文档

快速上手

0. 前置条件

⚠️ 在开始之前，请确保：

✅ 已购买并成功部署 CSora2 客户端项目
✅ 客户端的云函数已成功上传部署
✅ 客户端的数据库已初始化完成

💡 为什么需要客户端？

因为云函数是统一部署在客户端项目中的，管理后台通过绑定客户端的云服务空间来调用这些云函数。如果客户端未部署，管理后台将无法正常工作。

1. 环境准备

必需工具：

HBuilderX 3.1.10 或更高版本
Node.js 环境（用于安装依赖）

2. 安装步骤

第一步：安装依赖

在项目根目录执行以下命令：

npm i

第二步：绑定云服务空间

⚠️ 重要：不要创建新的服务空间，而是绑定客户端的服务空间！

在 HBuilderX 中打开本项目（管理后台）
右键 uniCloud 目录
选择 绑定云服务空间（注意：不是"关联"，而是"绑定"）
选择客户端项目使用的服务空间（与客户端项目相同的服务空间）
确认绑定

绑定服务空间示意图

💡 为什么要绑定而不是创建新空间？

因为云函数已经部署在客户端的服务空间中，管理后台需要调用这些云函数，所以必须使用同一个服务空间。

第三步：导入管理后台的菜单和权限数据

⚠️ 注意：客户端的数据库初始化应该已经在客户端项目中完成，这里只需要导入管理后台特有的数据。

登录 uniCloud Web 控制台
进入绑定的服务空间
进入 云数据库 管理
导入 uniCloud/database/db_init/ 目录下的管理后台菜单和权限数据：
- uni-id-roles.json - 管理员角色表（如已存在则追加）
- uni-id-permissions.json - 管理后台权限表（如已存在则追加）
- opendb-admin-menus.json - 管理后台菜单表（如已存在则追加）

💡 提示：如果表中已有数据，建议使用"追加"而不是"覆盖"的方式导入。

第四步：运行项目

在 HBuilderX 中点击 运行 -> 运行到浏览器 -> Chrome
等待编译完成，自动打开浏览器
使用管理员账号登录

3. 默认账号密码

管理员账号： admin
密码： 123456

建议登录后立即修改密码

4. 强制重置管理员密码

如果忘记密码，可以通过以下步骤重置：

打开云函数 uniCloud/cloudfunctions/router/service/admin/system/sys.user.js
找到 resetPassword 方法
在 HBuilderX 中右键该方法，选择 运行-本地云函数
输入要重置的用户 ID
密码将被重置为 123456

项目结构

csora-admin/
├── common/                      # 公共资源
│   ├── css/                     # 全局样式
│   ├── function/                # 公共函数
│   └── theme/                   # 主题配置
├── components/                  # 公共组件
├── pages/                       # 页面目录
│   ├── index/                   # 首页
│   ├── login/                   # 登录页
│   ├── user/                    # 用户管理
│   ├── sora-task/              # 视频任务管理
│   ├── recharge-package/       # 充值套餐管理
│   └── shop/                   # 店铺设置
├── pages_plugs/                # 插件页面
│   └── system/                 # 系统管理页面
├── static/                     # 静态资源
├── store/                      # Vuex状态管理
├── uniCloud/                   # 云函数目录
│   └── cloudfunctions/
│       └── router/             # 云函数路由
│           ├── service/        # 业务逻辑
│           ├── middleware/     # 中间件
│           └── dao/           # 数据访问层
├── windows/                    # 窗口组件
├── App.vue                     # 应用入口
├── main.js                     # 入口文件
├── pages.json                  # 页面配置
├── manifest.json              # 应用配置
└── package.json               # 项目配置

核心功能说明

万能表格组件

通过 JSON 配置快速渲染表格，支持：

分页查询
多条件搜索
排序
批量操作
自定义操作按钮
导出 Excel
详情/编辑/删除等常用操作

示例代码：

columns: [
  { key: "nickname", title: "昵称", width: 150 },
  { key: "avatar", title: "头像", type: "avatar", width: 80 },
  { key: "mobile", title: "手机号", width: 120 },
  { key: "account_integral.balance", title: "积分余额", width: 100 },
  { key: "_add_time", title: "注册时间", type: "time", width: 160 },
];

万能表单组件

通过 JSON 配置快速渲染表单，支持：

自动表单验证
自动提交
防重复提交
字段显示规则
自定义字段渲染

示例代码：

columns: [
  { key: "amount", title: "充值金额", type: "money", required: true },
  { key: "integral", title: "赠送积分", type: "number", required: true },
  { key: "bonus", title: "额外赠送", type: "number", defaultValue: 0 },
  {
    key: "status",
    title: "状态",
    type: "radio",
    data: [
      { value: 1, label: "启用" },
      { value: 0, label: "停用" },
    ],
  },
];

数据库表结构

主要数据表

表名	说明
`uni-id-users`	用户表
`uni-id-roles`	角色表
`uni-id-permissions`	权限表
`opendb-admin-menus`	菜单表
`vk-sora-task`	视频任务表
`vk-recharge-package`	充值套餐表
`vk-integral-record`	积分流水表
`vk-shop-config`	店铺配置表

云函数 API

视频任务相关

client/sora/pub/generations - 创建视频生成任务
client/sora/kh/getTaskList - 获取任务列表
client/sora/pub/receiveHook - 接收视频生成回调

用户管理相关

admin/user/sys/getList - 获取用户列表
admin/user/sys/getById - 获取用户详情
admin/user/sys/updateIntegral - 修改用户积分

充值套餐相关

client/user/pub/rechargePackage.getList - 获取套餐列表
admin/rechargePackage/add - 添加套餐
admin/rechargePackage/update - 修改套餐

店铺设置相关

client/pub.getMchInfo - 获取店铺配置
admin/business/sys.mch.updateBaseSetting - 更新店铺配置

常见问题

1. 云函数上传失败？

解决方案：

检查 uniCloud/common 目录结构是否完整
确保已执行 npm i 安装依赖
检查网络连接是否正常
尝试重新绑定云服务空间

2. 新建用户登录提示用户不存在？

解决方案：

进入应用管理，添加或修改应用的 appid
进入用户管理，编辑用户，设置该用户可以登录的应用

3. 如何修改管理员密码？

解决方案：

登录后台，进入个人中心修改密码
或通过云函数强制重置密码（见上文）

4. 如何自定义主题颜色？

解决方案：

修改 common/theme/ 目录下的主题配置文件
在 App.vue 中切换主题

开发建议

1. 代码规范

遵循 ESLint 规范
使用有意义的变量和函数命名
添加必要的注释

2. 安全建议

定期修改管理员密码
严格配置权限，遵循最小权限原则
敏感操作需要二次确认
定期备份数据库

3. 性能优化

合理使用数据库索引
避免一次性查询大量数据
使用分页查询
合理使用缓存

更新日志

v1.0.0 (2025-01-20)

🎉 初始版本发布
✨ 支持视频任务管理
✨ 支持用户管理
✨ 支持积分充值套餐管理
✨ 支持店铺设置
✨ 完整的权限管理系统
✨ 美观的 UI 界面

技术支持

如有问题或建议，欢迎通过以下方式联系我们：

客户端项目：CSora2 - AI 视频生成应用
GitHub Issues：提交 Bug 或功能建议
文档中心：查看详细的开发文档
社区论坛：与其他开发者交流

开源协议

本项目采用 MIT 开源协议

致谢

感谢以下开源项目的支持：

如果这个项目对你有帮助，欢迎 Star ⭐

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.