SparkAi系统完整手册（部署+后台配置文档）

一、项目介绍

🖥️快速体验

官方演示站【唯一官方演示站点（其他地址均为非官方）】

💼 系统技术架构

前端： Vite + vue3 + ts + NaiveUI + Tailwindcss

管理端：Vite4 + Vue3 + Element-Plus

服务端（后端）：Nodejs + NestJs

数据支持： Mysql5.7(+) + Redis

运行环境：Linux、Windows、MacOs（推荐使用Linux）

数据存储：本地存储 | 阿里云oss | 腾讯云cos | chevereto图床

💬 联系我们（系统授权）

QQ： 501439094

微信：DjiMain

📮 邮箱：501439094@qq.com

官方作者VX | QQ交流群【目前不开放】

🗂️ 交付及授权内容

交付内容

授权方式

域名绑定授权码在线授权 授权一个域名 赠送一个www域名

域名授权享有不限制次数的免费更换机会、但是一月最多三次

🔔 你需要准备的内容？

域名 | IP

服务器：最低1c1h（1CPU核心 + 1G内存）即可启动（根据必要软件安装情况增减配置，SparkAI系统运

行占用0.5G左右内存），建议2C4G配置起步

存储服务：（可选： 可以存储到本机、为了更好的体验支持 建议存储到 阿里云OSS、 腾讯云COS、Chevereto图床）

云服务器数量：AI系统部署国内国外服务器都可以，由于MJ绘画是海外服务需要中转，如MJ绘画功能 故海外服务器必需1台，用于搭建绘画API系统（推荐使用阿里香港轻量应用级服务器2C4G起，性价比高），国内服务器可有可无

邮箱服务（可选）：用于系统用户邮箱注册验证模块、可使用 163邮箱、QQ邮箱、阿里云邮箱等具有SMTP发信的邮箱……

短信服务：本系统使用阿里云短信服务、当您配置并开启后则表示开启用户端手机号注册的行为

AI模型API：系统支持官方API和中转API（若无API不了解或者无中转API，提供中转API渠道）

微信登录（可选）：需要一个官方的公众号【必须是服务号】不使用则不开启微信登录功能

支付模块（可选）：系统支持4种支付接口（微信官方支付、易支付、码支付、虎皮椒支付）任选其一，建议使用微信官方支付

百度统计账号（可选）：百度统计提供了免费的统计服务、我们只需要申请服务即可享受免费的流量统计，你可以自行前往百度统计官方平台申请、将用于首页的统计量访问图表展示、这是免费的服务、百度就可以找到很全面的教程、申请入口是这里：百度统计申请地址

其他准备内容：根据版本更新及自身所需

二、功能介绍

🌟 系统能力

三、系统授权

系统（私有化独立部署）授权价格

套餐一：【系统源码授权】 ：适合技术人员

限时优惠售价1588，日常售价（~1888~），【您将获得】

SparkAi系统永久授权

永久免费更新特权、后续的更新将不需要任何费用

不限量域名换绑、随时换绑服务器或域名

提供一份部署文档 （提供代部署服务（不免费））

套餐二：【私有化独立部署搭建一条龙服务】

限时优惠售价2688【您将获得】，后续售价（32~88~）

套餐一包含内容

一条龙搭建好，如不会更新可后期帮系统更新

系统部署：服务器环境安装、AI系统部署

系统对接配置：后台支付对接配置、微信公众号对接配置、MJ对接、COS存储桶对接、API key池配置、数据库数据自动备份等等

系统相关配置和系统讲解、作者vip服务、作者专属vip指导

适合不会任何技术但节省时间想使用此网站的人群。只需要管理和使用即可，搭建配置技术全包！

赠送GPT4官网原生API KEY 10刀额度，永不过期，可续费

（部署需要自备服务器、域名、微信公众号（服务号）、支付商户接口等）：不会可协助申请指导！

注：部署配置为一次性搭建和配置好

四、SparkAi系统更新日志

【V6.4.0】更新功能（2024.04.08号更新）

🚀 Feat

放开模型最大上下文Token配置

新增提问模型单次回复Token限制以及后台配置（设为0则自适应不限制）

新增微信登录情况下不显示用户端密码更改（微信登录唯一凭证为微信号，没有密码，因此不显示）

支持超长上下文模型使用（例如写小说、超长文案资料修改）

去除模型提问每条回复都显示回复补全token(用户容易造成歧义)

用户端分销新增银行卡提现渠道以及后台获取，优化提示内容（微信、支付宝、银行卡）

修改AI声明显示提示

调整后台可视化网站访客统计为line折线图

优化授权授权逻辑

🔨 Fix

修复后台应用图标修改无效的问题

修复绘画操作扣除积分问题，绘画只扣2积分，后台设置的数值无效问题

修复输入文字多的情况下卡住问题（例如Claude3模型2万字以上测试卡住问题）

【V6.3.1】更新功能（2024.03.28号更新）

🚀 Feat

重构语音对话逻辑以修复大部分时候无法使用语音输入的问题

优化画廊页面，增加图片大小比例，由scaleWidth* 2 改为 scaleWidth * 3

优化绘画promp，使用中文翻译为英文导致的其他内容提交

🔨 Fix

修复移动端无法语音输入的问题

【V6.3.0】更新功能（2024.03.26号更新）

🚀 Feat

新增公安备案号显示和后台配置项（需要后台配置后显示）

新增ICP备案号和公安网备案标准图标显示

去除低版本不再使用的数据库不必要表的查询

修复MJ局部编辑重绘不显示图的问题

🔨 Fix

兼容SparkAi v5系统版本升级V6版本，已在代码上做了最大优化兼容处理，最大程度上保留旧系统版本数据

其他页面优化

【V6.2.0】更新功能（2024.03.22号更新）

🚀 Feat

新增MJ绘画后台可设置默认使用通道（Fast快速通道、Relax休闲通道、默认栓通道规则）

新增支持对接转接系统的微信公众号（需要修改微信api回调地址，需配置.env文件WX_API_BASE=和WX_OPEN_API_BASE=的参数

修改菜单栏样式（调整菜单占比、选中样式）

修改系统UI主题色

🔨 Fix

修复文档上传格式或请求方式导致提问无效的问题

其他问题修复

【V6.1.0】更新功能（2024.03.18号更新）

🚀 Feat

修复微信支付金额问题

修复自定义的应用不能取消收藏 不能编辑

新增管理员登录用户端 全站搜索后可以选择将GPTS添加到系统当做系统应用

新增应用使用添加积分消耗显示

新增绘画窗口翻译改为持久化修改

新增绘画窗口优化改为持久化修改

新增MJ绘画通道双通道(支持Fast模式和Relax放松模式)

支持对双通道单独设置扣费额度

支持对双通道单独设置并发 双通道互相独立

虎皮椒支付支持微信环境调用微信支付

🔨 Fix

gpt对话 上传文件失败的问题 文件传参格式错误修复、导致无法识别文档

应用中心分类顶部定位修复、搜索错位修复

绘画加载下拉偶发跳动问题、绘画部分逻辑优化处理

应用的示例内容多次重复问题修复

微信支付依赖包版本不一致导致返回值改变的问题兼容

购买会员套餐会额外增送一些额度问题处理

解决垫图部分场景配置下无法生效问题

虎皮椒支付增加h5参数

【V6.0】SparkAi v6 大版本

V6 版本大面积重构、全新的版本与其他系统合并，系统大版本更新升级

🚀 Feat

新增模型分类、支持自定义模型名称、自定义排序、模型配置、支持单个模型设置上下文Token限制、轮次限制、可以允许当前模型上传文件、允许开启当前模型联网！

🔥 新增tts语音、支持语音模式对话、支持自动播放回复语音、支持六种音色的选择、实时读取、不占用存储空间！

🔥 新增插件系统、多个内置插件、通过配置即可启用、支持识图、支持PDF文档分析、支持对话版本Midjourney、SD绘画等功能、支持自定义插件接入知识库！

新增本地存储、文件可以直接上传到服务器而不需要再上传到cos、为了性能考虑、我们只对非核心文件开放了存储到本地、例如聊天对话中产生的文档、pdf、图片、语音等素材将存储在本地、一些优先级较低的logo、icon、和系统预设也放入本地、对于一些重要属于依然选择存储云上。

新增列表布局、两种布局方式自定义切换！

🔥 新增GPTS应用、支持全网搜索、可以获取所有官方已有的GPTS直接加入系统使用！

应用支持绑定模型了、绑定模型的应用不可以切换模型、未绑定的可以切换、gpts只支持gpt-4-gizmo模型！

ui更新：整体风格改为卡片风格、 公告版更新、新增顶部栏、对话|Gpts分组隔离、应用中心改动、合并GPTS、增加全网搜素

侧边栏更新、支持双SVG图标配置对应选中和未选中、支持双图片配置、可以使用图片链接了。

布局改变、积分剩余额度独立、清空对话组分组、工作台位置迁移。

初始化欢迎页面变动、九宫格改为随机应用与gpts、并支持随机更换。

工具栏合并、多种场景多种联动设置。

输入框支持粘贴上传文件！

登录窗口背景图变更、增加弹窗背景图配置、支持背景图自定义了！

增加发送图片和文档、在发送栏目可以下载

增加语音发送、可以暂停继续连续组织语言、支持在录制过程中直接点击发送

🔨 Fix

修复用户创建的应用管理员拒绝会通过问题

修复客户端如果网络不稳定导致会漏字的情况

解决了新生成的对话最后两条不能删除问题

授权全面升级、新的授权将绑定域名、单授权码同时仅支持一个域名或IP

修复上下文设置错误导致的假死或无响应问题

修复邀请人的显示错误问题、仅显示自己问题

修复推广链接在微信无法被识别问题

🔨 Improvement

重新发送最近两条消息时会删除当前两条内容继续上次的内容进行对话而不是新打开一行重复问！

对话流输出速度控制、匀速输出、感官更流畅!

用户端消息加载、对话组加载新增loading骨架屏！

翻译联想不准确的问题、部分场景无法正常翻译和联想！

管理端模型允许设置为0系统自动处理上下文、防止填过大token造成的假死和无响应问题！

移除掉九宫格、改为随机应用推荐！

移除全局模型配置、防止部分人不理解混淆、全部模型在添加key的时候配置代理地址！

由于提议、移除掉公众号ai自动回复、暂时关闭此功能！

ui美化、移动端适配、针对聊天窗口的美化

对话组配置修改统一到弹窗、可同时修改多项配置信息

【V5.2.0】更新功能（2024.03.17号更新）

适配更新微信官方支付依赖版本升级问题，可能出现支付二维码显示失败无法支付的问题

恢复V5.0版本的手机端签到功能

快捷提问预设优化

【V5.1.0】更新功能（2024.03.14号更新）

新增用户端忘记密码功能

新增支持gpt-4-All模型

新增多功能插件：文生图+图生文+图生图多模态插件；优化显示当前使用插件

新增模型扩展配置（自定义修改模型显示名称）：菜单路径[对话系统]->[模型扩展配置]；其他模型扩展配置逐步开放

调整dall-e-3和dall-e-2文生图插件为独立计费（扣除增强额度)

优化语音对话功能，增加暂停、播放、停止、主动发送等操作

对话模型增加上下文条数限制配置

绘画增加单用户任务数量限制配置（默认为3）；优化绘画提示词太长时为省略显示

新增用户端显示对话扣费信息

修复图生图苹果手机生成失败的问题，需要升级到最新的绘画API系统

新增OpenAl模型gpt-4-turbo-preview (指向gpt-4-0125-preview)

更新OpenAl模型gpt-3.5-turbo (指向gpt-3.5-turbo-0125)

升级适配Azure OpenAl服务api的版本到2023-12-01-preview（20240402前旧版本官方）

升级科大讯飞星火大模型到最新的V3.5版本，apiKey配置不动

新增清华智谱大模型GLM-4和后台配置，扣费增强额度，需要新增apiKey配置

修复用户绘画失败退还额度可能多退的问题

修复Azure模型多次输出会报错，需要刷新的问题

【V5.0.0】更新功能（2024.01.18号更新）

重构Midjourney绘画功能，新增支持MJ动态全功能

新增支持绘画Pan调整:上、下、左、右全方向偏移调整图片

新增支持绘画提升功能：Upscale(Creative)、Upscale(Subtle)、Upscale(4x)、Upscale(2x)等图片调整动作

新增支持同步MJ图片外延、图片放大、自定义缩放功能：Zoom Out 1.5x、Zoom Out 2x、Make Square

新增绘画过程中实时预览缩略图以及同步实时进度显示

调整按钮为根据当前图片状态全动态显示，兼容未来MJ官方可能新增的功能

新增绘制命令显示，绘画状态跟踪、连续大量绘画时方便追踪串联上下级

修复适配MJ官方更新导致V5版本局部重绘功能失效的问题

新增PC浏览器功能菜单栏默认名称显示、调整前端UI主题为紫色以及UI美化、管理后台菜单栏UI优化

调整应用工作台为对话模式，支持持续使用

调整单用户可以同时进行5个任务

优化提交绘画时检查是否有返回错误，避免空等超时；优化绘图失败时，可能未退还余额的问题

优化PDF文档总结对话上传文档时校验额度并扣费，避免恶意上传;上传失败消息提示

优化拉黑和锁定用户时强制用户登出

【V4.3.0】更新功能（2023.12.26号更新）

新增用户端聊天对话插件：ChatFile文档上传对话功能以及总结对话

优化TTS请求api支持三方中转代理接口

新增支持MJ最新V6绘画模型（V6模型：能够处理更长的提示词，人物效果更加真实，构图、色调、光影更加细腻）

调整对话请求超时机制，避免插件调用时间太长报错（DallE-3聊天绘画），如何配置请看部署文档

其他优化

【V4.2.0】更新功能（2023.12.14号更新）

修复腾讯混元大模型签名错误的问题导致无法对话

修复极个别机型无法调用手机录音导致不能语音对话的问题

修复百度千帆4.0新建的API KEY无法连接问题

优化对话框UI布局

【V4.1.0】更新功能（2023.12.12号更新）

新增OpenAI的TTS语音对话功能，支持电脑PC浏览器和手机端使用（调整用户端语音交互，语音输入则语音回复，文本输入则文本回复）

新增后台dall-e-3和dall-e-2模型独立配置apiKey，扩展更多apiKey来源轮训调用，增强多源配置，提高系统稳定性

新增支持所有微软Azure OpenAl模型，支持Azure OpenAl dall-e-3

新增后台知识库接入（对接百度千帆知识库），用户端动态显示知识库插件并通过插件的方式选择与知识库对话，可自定义训练内容回答和文档总结，上传文档作为知识库内容用于特定场景对话回答，比如企业文化规章制度、产品说明文档、客服等等各行业知识库等

优化分享和代理推广链接，代理邀请链接在安卓手机里可能被截断导致邀请失败

新增用户列表显示手机号字段并增加手机号搜索查询用户功能

新增邮箱注册校验规则，过滤临时邮箱注册（防止使用非本人邮箱刷免费额度等）

新增后台配置APIKey选择厂商时动态显示模型列表,避免模型与厂商不匹配导致调用报错的问题

UI布局样式优化：公告栏样式修改、MJ绘画比例显示适用场景、AI画廊页面优化以及默认显示比例调整

【V3.3.1】更新功能（2023.11.24号更新）

新增支持GPT-4-Turbo-Vision插件

新增已支持GPT-4图片对话能力（上传图片并识图理解对话）可同时支持5张图同时上传对话

OpenAI DALL-E3文生图对话形式及图片大小占比优化，效果与OpenAI PLUS一致

优化合并DALL-E3和GPT-4-Turbo-Vision的计费方式为GPT-4-Turbo，只需配置gpt-4-1106-Preview模型即可

新增MJ绘画系统并发执行数量设置，可后台设置系统并发数量

新增阿里云OSS存储可配置自定义域名，实现用户可以直接预览图片

新增大模型Agent代理多插件调用处理任务并总结返回结果

修复GPT联网提问失效和不稳定问题（后期将开发新的联网功能，可控制联网模块）

优化MJ单次绘画查询的超时时间为4分钟，应对MJ官方慢速绘画太慢可能导致绘画失败的问题

修复绘画存储不走绘画池Discord-CND代理，导致部分时候存储失败问题

新增DALL-E3文生图连续对话可对同一张图提出修改意见，DALL-E3文生图插件的调用时机由大模型理解用户提问动态择机调用。与OpenAI同步，支持gpt-4、gpt-4-1106-preview、gpt-4-0613、gpt-3.5-turbo、gpt-3.5-turbo-1106、gpt-3.5-turbo-0613模型调用。

【V3.2.0】更新功能（2023.11.13号更新）

新增支持最新GPT-4多模态模型、OpenAI GPT-4-Turbo-With-Vision-128K模型（后续支持对话识图功能）

新增支持最新OpenAI GPT-3.5-Turbo-1106、GPT-4-1106-Preview模型

新增支持对话插件系统，后续逐步增加插件功能，扩展AI能力

新增支持OpenAI DALL-E3文生图插件，可直接对话文生图，搭配GPT4-Turbo使用（官网20231107发布）

新增KEY支持单独配置消耗费率，比如GPT4-32K比GPT4成本更高应该消耗更多的额度次数

新增后台配置指定用户端默认使用大模型

【V3.1.0】更新功能（2023.10.29号更新）

【已支持 OpenAI GPT全模型 + 国内AI全模型 + 绘画池系统】

新增 Midjourney局部重绘（Vary Region）在线编辑功能

新增 Midjourney绘画账号池系统，可实现万级用户高并发

支持手机端 Midjourney局部重绘功能(Vary Region 局部重绘)

首页AI提问UI更新，侧边栏样式更新，对话框工具更新

提问模型：新增支持腾讯混元大模型

提问模型：新增支持讯飞星火认知大模型V3.0版本（20231024发布评论超越GPT）

提问模型：新增支持百度文心4.0版本（对标OpenAI-GPT4.0）

移除后台Midjourney绘画代理配置，将转由绘画池一并处理，优化速度

用户端大模型列表点击切换后允许自动关闭，且列表支持滑动选择查看

修复开启百度敏感词检测，因为以图生图提示词包含了图片链接地址，百度都检测触发推广敏感词导致无法提交绘图的问题

【V2.6.4】更新功能（2023.10.17号更新）

新增阿里通义千问大模型qwen-turbo、qwen-plus

导航侧边栏UI布局及样式修改

应用Prompt预设已支持国内AI大模型（开启GPT之外的大模型预设插入变量 SAI_USER_QUESTION_CONTENT 即可！）

新增公安网备案号及标准图标配置显示

【V2.6.3】更新功能（2023.10.06号更新）

重写AI对话系统：新增 国内AI全模型，已支持OpenAI GPT全模型+国内AI全模型，已支持国内AI模型 百度文心一言、微软Azure、阿里云通义千问模型、清华智谱AIChatGLM、科大讯飞星火大模型等！

新增AI工具插件：开通会员、连续对话、一键清屏、导出对话功能

分销代理新增银行卡提现渠道（微信、支付宝、银行卡）

新增Midjourney专业绘画提示词参考功能

去除游客功能：修复游客指纹ID导致后台账户明细变动查询失败和购买套餐导致一系列BUG

修复不是超级管理员（Super）可以删除订单记录的问题，即管理员(Admin)删除订单记录

UI界面更新等其他优化

【V2.6.2】更新功能（2023.09.17号更新）

新增MJ提交绘画，中文自动翻译英文功能

修复非会员用户开通限时会员，会员次数为：原永久次数+会员次数 BUG

优化思维导图生成逻辑，防止只生成两级

修复后台关闭签到功能，手机端仍然显示bug

【V2.6.1】更新功能（2023.09.06号更新）

增加访客体验功能、可配置每日未登录使用额度、注册账号可同步访客使用数据。用户端设置 -> 访客设置

增加后台底部自定义配置版权信息。系统设置 -> 版权信息

增加虎皮椒支付自定义网关。支付管理 -> 虎皮椒支付

增加违规敏感词检测记录功能。风控管理 -> 违规检测记录

【V2.6.0】更新功能（2023.08.26号更新）

优化key池额度耗尽锁定逻辑

优化MJ绘画连接、优化CSS、部分页面样式修改

【V2.5.9】更新功能（2023.08.10号更新）

增加手机端签到领取免费次数功能

优化后台总计绘画数量逻辑！

【V2.5.8】更新功能（2023.08.05号更新）

新增MJ 官方图片重新生成指令功能

新增官方 Vary 指令 单张图片对比加强 Vary(Strong) | Vary(Subtle)

新增官方 Zoom 指令 单张图片无限缩放 Zoom out 2x | Zoom out 1.5x

【V2.5.7】更新功能（2023.07.29号更新）

新增GPT联网提问功能、手机号注册登录、签到功能、管理后台功能更新等

优化MJ首次绘画无上级ID显示问题、优化内置MJ代理

其他页面优化

【低版本不做记录】……

五、部署教程

如果您已经准备好了我们需要的东西、那么我们可以开始正式部署了、如果您还不知道需要什么内容、请移步至SparkAi准备文档查阅详细的内容！

（一）、宝塔部署方式

当你进入这个栏目的时候说明你已经想要使用宝塔面板部署了、如果你不知道什么是宝塔、那么请前往宝塔官网进行简单的了解、我们默认你已经安装了宝塔面板、这是最基础的需要。

我们不推荐第三方平台服务器，也不接任何广告，服务器建议安装Centos 7.9或者7.6的版本，纯净系统再安装宝塔运维面板。推荐使用阿里香港轻量应用级服务器2C4G起，性价比高（仅仅对于一般）。

5.1 环境安装

宝塔需要安装的环境

初始安装环境推荐使用LNMP一键环境套件

注意①：

使用mysql8.0版本，需要重置root密码才能创建数据库

注意②：

同步服务器端口刀宝塔运维面板（重要）

5.2 Node版本选择

使用PM2切换Node版本（必须）

切换Node版本为：大于等于v16.14.1（这里为v16.19.1）

5.3 安装pnpm模块

如果安装不上pnpm，是宝塔默认淘宝源已经无法使用，打开命令控制台，切换为官方源，单独安装pnpm模块

先设置npm为官方源：

单独安装pnpm：

此时再次打开终端、确定我们需要是否有node相关环境

分别执行以下命令，出现版本号说明已经安装成功

如果出现“-bash: pnpm: 未找到命令”就执行以下命令（前面都出现版本号无须以下操作）

如无法安装换用运行以下命令

5.4 安装Redis

5.5 部署跑起来

5.5.1 新建站点

宝塔 - 网站 - 添加站点

5.5.2 配置SSL证书

如果自己没用商业SSL证书，就使用宝塔免费证书，申请Let’s Encrypt 证书

开启强制HTTPS并保存

5.5.3 上传SparkAi系统源码

进入网站站点根目录

删除新建站点的原始文件

将系统程序上传并解压到网站根目录下

解压源码包

5.5.4 配置.env文件

复制一份.env.example文件，并重命名为 .env 文件

修改.env 配置文件为自己站点信息

5.5.5 启动项目

5.5.5.1 开启端口

宝塔面板安全开启9520端口（如果在配置文件自定义了其他端口，开启对应端口即可，不要和系统一些端口冲突，建议默认9520端口）

5.5.5.2 安装依赖

直接在网站根目录打开ssh终端

如果打开不在网站根目录请切换为网站根目录

宝塔默认为淘宝旧源，请切换淘宝最新源：

使用 pnpm i 命令 回车安装依赖

使用 pnpm start命令启动项目

5.5.5.3 查看启动日志

输入pm2 log 查看详细日志、看到下图表示成功！

初始化创建super用户成功、用户名为[super]、初始密码为[sparkai]

5.5.6 添加反向代理

添加站点9520 端口，宝塔安全需要开启该端口，不然无法访问

目标url:http://127.0.0.1:9520

5.5.7 搭建完成

搭建完成，访问域名，输入域名授权码即可

5.6 授权激活系统

访问你自己的系统前台域名：
本例中即为：demo.sparkaigf.com

5.6.1 未授权激活

5.6.2 激活成功示例

（二）、Docker部署方式

部署教程：https://blog.chenjian.xyz/blog/sparkai4docker（用户教程）

六、系统更新

🔥🔥🔥 更新必看

由于6.0之后新增了本地存储 部分文件会存储到项目目录、在升级过程中请保留此目录public/files与public/core文件夹、core保留了项目的核心文件、系统中部分默认上传地址是这个地址、files目录则是日常文件、比如聊天对话中上传的文件、平时不重要的可以手动清理、其他的升级和老版本相同！

6.1 下载最新源码（当前最新v6.3）

SparkAi系统源码（v6以上版本）下载地址：

https://www.123pan.com/s/2N7pjv-1a6Ch.html

6.2 更新操作

pm2 delete all # 删掉所有正在运行的项目

保留或备份.env文件，删除其他所有文件

（以下更新操作和部署操作类似）

备份public/files、public/core文件夹到本地（如果使用的为COS存储则可以不备份）

上传最新系统版本源码并解压

将上述备份public/files、public/core文件夹的压缩包解压至/public文件夹下

宝塔默认为淘宝旧源，请切换淘宝最新源：

使用 pnpm i 命令安装依赖

使用 pnpm start 命令启动项目

可输入pm2 log 查看详细日志。

重启项目命令（一般不需要执行改该操作）

进入网站更目录下输入pm2 list 查看服务序号，本例中序号为29，请替换实际自己的项目服务序号

使用 pm2 restart 服务序号重启系统

输入pm2 log查看日志

七、系统配置教程

7.1 邮件注册配置

7.1.1 配置.env文件

邮箱服务（可选）：用于系统用户邮箱注册验证模块、可使用 163邮箱、QQ邮箱、阿里云邮箱等具有SMTP发信的邮箱

其中邮箱发信密钥怎么获取？

这里以163邮箱为例，其他邮箱类似：

浏览器登录163邮箱：https://mail.163.com/

点击设置，进入POP3/SMTP/IMAP

开启POP3/SMTP服务

按照提示即可获取到邮箱发信授权密钥

7.1.2 配置后台[邮件注册登录]

后台开启邮件注册登录配置，其他根据需要自定义邮件模板内容。

其中后端服务BASE_URL为网站域名：

示例地址: http://ai.xxxx.com 后端服务地址（没有最后的/）

7.2 微信登录配置

系统微信登录通过关联公众号实现[请务必注册为服务号、个人公众号没有二维码等此类权限]、以便于后期联动小程序、开发文档前往微信公众平台https://mp.weixin.qq.com/ 、拿到开发者配置信息即可、如果用户对公众号发送消息、我们将会从自定义回复管理当中的内容进行匹配自动回复、如果没有匹配到结果则回复下面设置的自定义回复默认信息、同时别忘记在微信公众号平台将自己的ip加为ip白名单、其中Token对应自己后台设置的Token、加密秘钥随机即可、当设置不指定首页并且配置了微信登录即可默认打开静默登录！

获取微信公众号参数

管理后台填写对应参数

其中Token为自己后台设置的Token，字母数字随便设置即可，最后保存，如果失败则微信公众号未添加服务器白名单。

微信公众号自定义菜单栏设置

公众号后台 -> 内容与互动 -> 自定义菜单

设置自己的自定义菜单栏，发布。

启用微信服务器配置

配置位置为 公众号后台 -> 基本配置

配置完成后开启服务即可。

由于浏览器缓存，启用后需要至少刷新浏览器3-5次，连续3次以上一直显示为服务器配置(已启用)才算开启成功！

7.3 为什么微信公众号没有菜单栏？

微信公众号对接第三放系统后（开发者通过接口修改了菜单配置）当前菜单配置就会失效。

那如何同时开启呢？

进入微信公众号自定义菜单页面，点击右上角 [菜单管理 ]

选择开启

由于浏览器缓存，启用后需要至少刷新浏览器3-5次，连续3次以上一直显示为(已启用)才算成功！

7.4 微信静默登录功能

微信官方规则，此功能权限域名需要备案才能使用。

如您后台启用静默登录、则用户在微信环境打开则直接自动登录（即手机微信中打开系统不需要扫码）

下载微信公众号的验证文件到服务器网站根目录（其中/public下的文件才能被外部网络访问）

添加域名

微信公众号验证文件上传完成后，再分别将网站域名添加到业务域名、JS接口安全域名、网页授权域名，最后一步为开启后台静默登录。

7.5 短信验证登录

官方规则，此功能权限域名需要备案才能使用。

此处采用阿里云短信服务、请先申请好个人的签名模板以及获取到您的秘钥信息

详细申请地址为：https://dysms.console.aliyun.com/overview

当您配置并开启后则表示开启用户端手机号注册的行为！

进入阿里云短信控制台

选择国内消息，添加资质，资质个人为个人实名，企业为企业执照相关信息，请按照要求认证。

域名备案主体尽量和登录的阿里云账户认证主体一致。

添加签名

资质审核通过后，便可以申请签名了

点击新增签名、进入填写页面，点击新增应用场景

类似于备注，场景内容填写自己网站域名或其他

填写选择其他信息

添加模板

其中模板名称为备注可自定义内容

后台配置

短信模板ID为模板CODE

阿里AccessKeyId、AccessKeySecret获取

进入后创建AccessKey即可。

购买短信套餐包

进入国内通用短信套餐包进行自由选择

7.6 对象存储（数据存储）

使用其中一个对象存储COS即可，不需要都配置开启。

7.6.1 腾讯云COS

前往腾讯云申请对象存储服务、申请服务前往 https://console.cloud.tencent.com/cos

进入到腾讯云搜索对象存储、我们需要配置四个参数、在秘钥管理里面可以拿到SecretId和SecretKey。

如果还没有存储桶、请创建存储桶、权限选择公有读私有写即可、其他不限制。

创建存储桶

获取桶的参数

示例中所属地域为：ap-shanghai

腾讯SecretId、SecretKey获取

点击左侧导航栏 -> 常用工具 -> 密钥管理进行新增创建

7.6.2 阿里云COS

阿里云的对象存储oss服务、前往阿里云申请oss服务 https://oss.console.aliyun.com/ 、如果同时开启多个存储服务、腾讯云高于阿里云优先级！

创建存储桶

获取桶的参数

示例中所属地域为：oss-cn-shanghai

腾讯keySecret、SecretKey获取

选择账户登录头像，进入后创建AccessKey即可。

7.6.3 chevereto图床（不建议使用）

chevereto图床官方文档 https://v4-docs.chevereto.com/developer/api/api-v1.html

同时开启多个存储会以菜单排序优先级开启使用

详情请查看官方文档搭建

7.7 如何使用本地存储

本地存储我们会将文件存储到本地项目当中、所以如果你需要使用这个功能请确保在后台注册管理/邮件登录注册此处设置后端服务BASE_URL。这个参数是必须的、否则上传文件会找不到准确目录位置！

其中后端服务BASE_URL为网站域名：

示例地址: http://ai.xxxx.com 后端服务地址（没有最后的/）

7.8 支付配置

7.8.1 官方微信支付

官方微信支付参数说明

官方微信支付设置、同时开启多个支付、我们以微信支付优先级为最高、在pc端我们会调用native支付、在微信环境内、我们将调用Jsapi支付、请确认您的微信支付已经申请了支付权限、所有的支付通知地址统一为 https://域名/api/pay/notify 将域名修改为您的域名即可。

需要获取的配置参数

商户秘钥获取（设置APIV3密钥）

微信支付商户 -> API安全 -> 设置APIv3密钥

公钥地址、私钥地址获取

微信支付商户 -> API安全 -> 申请API证书

安装“下载证书工具”

生成证书

填写相关信息

获取证书内容

解压证书压缩包

打开证书内容，配置到系统后台保存即可

开通支付接口产品

配置JSAPI支付授权目录和Native支付回调链接

和系统后台支付通知地址一致！

7.8.2 易支付

通用易支付渠道、同时开启多种支付、我们会以菜单顺序为优先级使用、仅mpay支持非跳转支付、所有的支付通知地址统一为 https://域名/api/pay/notify 将域名修改为您的域名即可！

开启跳转支付（一般易支付使用跳转支付）

7.8.3 码支付

和易支付相同的配置方式

7.8.4 虎皮椒支付

虎皮椒支付为三方支付、接入请购买微信渠道、详细参数参照 https://www.xunhupay.com/

目前优先开通微信支付渠道、同时开启开启多种支付、我们将优先按照菜单顺序调用、所有的支付通知地址统一为 https://域名/api/pay/notify 将域名修改为您的域名即可

7.9 【API模型配置】

7.9.1 关于国内模型接入

模型在v3移除了国内版本模型、所有模型走openai的输入格式、这如果需要国内模型、请使用中转API，市面上很多超低价的中转可供选择、内置几十种模型完美适配系统、如果你想要接入国内模型、请选择合适的中转。

使用中转API好处：

如果你没有，本系统提供推荐渠道，目前仅对系统用户提供

7.9.2 中转API推荐

7.9.3 模型分类配置

关于参数说明：

7.9.4 快速自动化模型分类配置

本系统支持满足和openai请求和输入的大模型，想一键导入演示站做好的模型分类配置，可使用以下sql导入自己的系统中

下载演示站模型分类配置sql(点击前往下载):

models_type.sql

首先自己没有配置模型分类和模型key才是一键导入

7.9.5 如何开启对话dall-e4绘画

gpt-4-dalle模型：结合了GPT4和DALL-E的模型，能够理解和生成创意图像。Chat格式

用于对话模型的dalle绘画功能，需要中转或者key支持gpt-4-dalle模型、勾选此选项的时候、勾选的模型可以忽略、系统最终都会调用gpt-4-dalle

7.9.6 卡池列表-添加API KEY

当添加设置好模型分类后，模型选择可一键选择多个模型分类使用到一个API KEY。

绑定模型

添加API key

7.10 【插件开启配置（特殊模型）】

我们内置了插件系统、由于不同插件需要不同的模型支持、所以模型是在设置了对应模型并且卡池有key的时候才回启用、下面是各个模型对应的模型：

注意上述模型、当你在模型中的关联模型配置了如上模型（并且卡池中至少有一个key）、那么对应的插件将会自动开启！

7.11 如何使用tts语音（语音对话功能）

tts语音调用的官方的文字转语音以及语音转文字模型、为了节约空间、我们并不会存储文件到本地或者云端、我们会通过实时流读取的方式、您需要在模型中的关联模型手动填入 tts名称以便于同时开启语音互转的双方文字、可以参考演示站的配置、请确定你的key或者中转支持tts模型、配置后语音即可正常访问！

7.12 【如何使用GPTs全站搜索和使用GPTs】

我们推荐的中转中模型支持search-gpts 、gpt-4-gizmo模型、添加此模型并配置key即可使用。

7.13 GPTs配置（APP应用）

7.13.1 演示站GPTs数据导入

仅首次成功运行启动项目后导入一次，更新系统再次无需导入

系统必须先成功运行启动

使用宝塔的phpmyadmin导入或其他sql导入工具

数据导入步骤

app_cats.sql：应用分类数据

app.sql：APP应用数据

先导入app_cats.sql文件

再导入app.sql

7.13.2 普通预设应用

配置你的预设词，无需配置为GPTs

7.13.3 GPTs应用

如何添加除演示站额外的GPTs应用？

方法一（推荐）：

系统前台使用超级管理员账户登录 -> 进入APP应用 -> 切换为全网搜索 -> 输入关键词回车 -> 加入系统

方法二（手动添加）：

主要为找到找到GPTs的ID，其他内容可自定义

首先需要找到你需要的gpts，如何寻找呢？随便找一个搜索引擎，这里以bing为例子

例如我想找到翻译相关的gpts，搜索输入 site:chat.openai.com/g 翻译, 即可看到搜索结果中一堆gpts插件搜索翻译

找到你需要的gpts，点击进入

看到地址栏的地址，找到g-xxxxxxx，例如https://chat.openai.com/g/g-IZb9C11iR-ying-wen-fan-yi-zhuan-jia中的g-IZb9C11iR，即为gpts的id

此时得到模型名称就是 gpt-4-gizmo-g-IZb9C11iR ,那么 gizmo_id就是 g-IZb9C11iR

7.14 如何使用联网搜索模型

开启联网搜索后、调用模型会在model前加上 net- 系统内置中转已经支持、如果自己的key不支持 前往官方推荐的中转购买即可、市面上超低价、接入系统后价格更低！

7.15 【MJ绘图模块配置】

MJ绘画功能：

7.15.1 快速（Fast）通道API配置

7.15.2 普通（慢速Relax）通道API配置

7.16 绘画扣费设置

按照自身定义规则（推荐演示站配置规则）

7.17 套餐设置

新版本套餐分为不限时套餐和限时套餐、不限时充值次数永不过期、限时套餐在规定时间未使用完毕将清空、套餐等级为套餐优先级、等级越高价值越高、充值非永久套餐的限时套餐将成为会员、当已经是会员资格的情况下、充值低于自身等级的套餐仅添加自身余额不更新日期、充值大于等于自生等级的套餐的时候、将叠加余额与时间（请仔细阅读）,套餐有效时间设为-1即为永久不过期！

可参照演示站配置和调整。

八、其他问题和教程

待完善…..