99AI 后台管理文档
1. 系统配置
系统配置是 99AI 平台的基础设置，包含多个功能模块，用于自定义网站的基本信息、外观和行为。
1.1 网站基础配置
网站基础配置支持即时更新网站的主要视觉与功能元素。配置内容包括网站名称、备案号、版权信息、LOGO 与 ICO、默认 AI 头像与用户头像，以及首页设置等。
| 配置项 | 说明 | 备注 |
|---|---|---|
| 网站名称 | 显示在浏览器标签和页面上的网站名称 | 必填项，是网站的主要标识 |
| 网站地址 | 网站的完整 URL，用于系统内部链接和跳转 | 需包含协议前缀(http://或https😕/) |
| 公司/组织名称 | 网站所属公司或组织名称，用于显示版权信息 | 显示在网站底部，用于版权声明 |
| 网站备案号 | 网站 ICP 备案信息，合规要求展示 | 中国大陆地区网站需填写，其他地区可选 |
| 用户端 LOGO | 网站 LOGO 图片地址，展示在网站顶部和用户界面 | 支持上传PNG、JPEG、GIF、WebP和ICO格式，大小<3000KB |
| 网站 ico | 网站图标，显示在浏览器标签页 | 推荐使用ICO格式，支持直接上传或填写URL |
| AI 头像 | AI 助手的头像，为空将根据模型自动显示 | 可自定义上传，为空则使用模型默认头像 |
| 用户默认头像 | 新用户注册后的默认头像 | 用户可在个人设置中修改 |
图片上传说明
管理界面提供了便捷的图片上传功能，支持对LOGO、网站图标、AI头像和用户默认头像进行上传。系统会自动进行格式和大小验证，确保符合要求。上传后会即时显示预览图，上传成功后可通过保存按钮将更改应用到整个网站。如果需要更新已上传的图片，可以点击刷新图标重新上传。
1.2 显示设置
网站显示配置用于控制用户界面的各种元素和功能展示，包括积分显示、菜单选项、功能按钮等。合理配置这些选项可以优化用户体验，简化界面，突出核心功能。
1.2.1 性能与缓存设置
| 配置项 | 功能 | 详细说明 |
|---|---|---|
| 清除缓存 | 清除系统缓存数据，可在系统运行缓慢或数据更新不及时时使用 | 开启后，将启用缓存清除功能，有助于解决页面数据显示异常问题 |
| 流式对话缓存 | 启用/禁用流式对话缓存功能，影响对话响应速度和服务器负载 | 开启后会对AI对话进行缓存输出，优化输出平滑性，关闭则完全依赖API流式输出 |
流式对话缓存功能说明：启用此功能后，系统会将AI对话结果进行本地缓存，可以在网络波动时保持流畅的用户体验。对于高频使用的场景或服务器资源紧张的情况，建议开启此功能以减轻服务器负载。如果更注重实时性和数据安全，可以选择关闭此功能。
1.2.2 功能与界面设置
| 配置项 | 功能 | 详细说明 |
|---|---|---|
| 隐藏插件 | 控制是否在用户界面隐藏插件功能，可简化界面 | 开启后，将在用户界面隐藏所有插件功能入口，适合简化界面或禁用插件功能场景 |
| 插件优先显示 | 控制插件在界面上的显示优先级，影响用户对插件的发现和使用 | 开启后，对话页面将默认优先显示插件面板而非对话记录，增强插件功能的可见性 |
| 显示全局水印 | 启用/禁用全局水印显示，为内容添加版权保护 | 开启后将在对话页面显示用户名水印，增强内容安全性和版权保护 |
| 隐藏首页默认预设 | 控制是否隐藏首页默认预设，可自定义首页体验 | 开启后，首页将不显示默认预设提示，使界面更简洁，适合自定义首页内容的场景 |
| 隐藏朗读按钮 | 控制是否隐藏文本朗读功能按钮，可简化界面 | 开启后，用户界面将不显示文本朗读按钮，适合不需要语音功能或简化界面的场景 |
| 显示卡密兑换 | 控制是否显示卡密兑换功能，影响用户充值方式 | 开启后，在用户界面将显示卡密兑换功能入口，适合支持卡密销售模式的场景 |
| 首页欢迎提示 | 用户首次访问时显示的欢迎信息，提升用户体验 | 自定义欢迎提示内容，将在用户首次访问时显示，可加入使用引导或平台特色介绍 |
界面设置最佳实践：根据用户群体特点和平台定位选择适当的界面设置。对于新用户为主的平台，建议保留欢迎提示和默认预设；对于追求简洁的专业平台，可以隐藏非必要功能按钮；对于重视内容安全的平台，建议开启全局水印功能。
1.2.3 积分显示设置
| 配置项 | 功能 | 详细说明 |
|---|---|---|
| 隐藏普通积分 | 控制是否隐藏普通积分显示，可简化界面 | 开启后，普通积分不会显示在用户界面上，适合使用单一积分类型或采用会员制的商业模式 |
| 普通积分名称 | 自定义普通积分的显示名称，便于品牌化 | 可修改为任意文字，如"对话点数"、"智慧币"等，增强平台特色和品牌识别度 |
| 隐藏高级积分 | 控制是否隐藏高级积分显示，可简化界面 | 开启后，高级积分不会显示在用户界面上，适合不使用高级模型或使用其他计费方式的场景 |
| 高级积分名称 | 自定义高级积分的显示名称，便于品牌化 | 可修改为任意文字，如"高级点数"、"专业币"等，突出高级服务的价值 |
| 隐藏绘画积分 | 控制是否隐藏绘画积分显示，可简化界面 | 开启后，绘画积分不会显示在用户界面上，适合不提供绘画功能或将绘画集成到其他服务的场景 |
| 绘画积分名称 | 自定义绘画积分的显示名称，便于品牌化 | 可修改为任意文字，如"画图积分"、"创意币"等，突出绘画服务的创意属性 |
积分系统建议：清晰的积分体系有助于用户理解平台的商业模式。根据平台特点，可以选择显示全部积分类型，或者仅保留核心积分类型以简化用户体验。自定义积分名称时，建议选择与平台风格一致、易于记忆的名称，增强用户黏性。
1.3 公告设置
公告设置用于配置用户端显示的公告页面。支持使用 Markdown 语法或 HTML 标签来创建内容，为灵活的内容格式提供便利。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 公告标题 | 公告显示的标题，突出重要通知内容 | 显示在公告窗口顶部，应简洁明了地概括公告内容，建议控制在20个字符以内 |
| 自动打开公告 | 用户访问时是否自动显示公告，用于重要信息传达 | 设为自动打开则网站初始化会打开，用户可选择24小时内不再查看，适合重要更新或活动通知 |
| 公告信息 | 公告正文内容，支持 Markdown 和 HTML，可灵活展示富文本内容 | 支持图文混排、链接和各种富文本格式，便于创建生动的公告，建议不超过1000字以保持用户阅读体验 |
公告内容建议：
- 保持简洁明了，突出重点信息
- 使用适当的格式化元素（如标题、列表、粗体）增强可读性
- 对于重要通知，建议开启自动打开选项
- 定期更新公告内容，保持信息的时效性
- 可在公告中添加链接，引导用户访问详细说明页面或相关活动页面
1.4 用户协议设置
用户协议设置用于配置用户端显示的用户协议页面。支持使用 Markdown 语法或 HTML 标签来创建内容，为灵活的内容格式提供便利。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 用户协议标题 | 用户协议的标题，明确法律文件性质 | 显示在用户协议窗口顶部，通常为"用户服务协议"、"用户使用条款"或"用户隐私协议"等 |
| 开启用户协议 | 是否启用用户协议功能，用于合规要求 | 开启后，用户在注册时将会弹出用户协议页面，需要同意才能继续，满足法律合规要求 |
| 用户协议内容 | 协议正文，支持 Markdown 和 HTML，详细规定用户使用条款和隐私政策 | 应包含平台规则、用户权责、隐私政策等法律必要内容，建议咨询法律专业人士确保内容合法有效 |
用户协议必要内容：
- 服务条款：明确说明平台提供的服务内容和使用条件
- 用户责任：说明用户在使用平台时的行为规范和责任
- 知识产权：明确平台内容和用户生成内容的知识产权归属
- 隐私政策：说明平台如何收集、使用和保护用户数据
- 免责声明：明确平台责任边界和免责情况
- 修改条款：说明平台修改协议的权利和通知方式
- 争议解决：说明发生争议时的解决方式和适用法律
1.5 百度统计设置
百度统计主要用于展示，实际的统计数据将在网站首页显示。为获取更精确的数据分析，可配置百度统计接口信息，实现网站访问数据监控与分析。
百度统计提供的是一项免费服务，如果您选择不使用这项服务，只需将相关设置项留空即可。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| siteId | 百度统计站点 ID，用于标识您的网站 | 在百度统计平台创建网站后获取，唯一识别码，用于关联统计数据 |
| ApiKey | 百度统计 API 密钥，用于接口认证 | 用于授权API访问，在百度统计管理界面获取，请妥善保管避免泄露 |
| SecretKey | 百度统计安全密钥，用于数据加密和安全传输 | 用于安全传输，保证数据传输的安全性，在百度统计管理界面获取 |
| AccessToken | 百度统计访问令牌，用于接口调用授权 | 临时访问凭证，用于接口认证，有效期通常为一个月，需定期刷新 |
| RefreshToken | 百度统计刷新令牌，用于更新访问令牌 | 用于在访问令牌过期后获取新的访问令牌，有效期通常为一年，系统会自动处理刷新操作 |
| 统计代码 | 百度统计跟踪代码，嵌入网站以收集访问数据 | 由百度统计生成的JS代码片段，复制粘贴到此处即可，系统会自动将代码插入网站页面 |
百度统计使用说明：
- 需要先在百度统计官网注册账号并创建网站
- 获取相关配置信息后填入系统
- 配置完成后，百度统计会自动收集网站访问数据
- 可在后台首页查看访问统计数据，包括PV、UV、新用户数等核心指标
- 更详细的分析可前往百度统计官网查看
百度统计可以帮助管理员了解用户访问行为、来源渠道、地域分布等数据，为运营决策提供数据支持。对于商业网站，建议配置百度统计以便更好地优化用户体验和营销策略。
2. 访问管理
访问管理模块用于配置用户访问和认证相关功能，包括注册配置、邮件配置、微信配置和短信配置等。合理配置访问管理可以优化用户注册流程，增强用户体验，同时满足身份验证和安全需求。
2.1 注册配置
注册配置用于设置用户注册的规则和流程，可以控制注册方式、验证要求和默认设置。
2.1.1 注册赠送
注册赠送功能用于为新注册用户提供初始使用额度，鼓励用户尝试平台服务，提高留存率。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 是否开启注册赠送 | 控制是否为新注册用户赠送积分 | 开启后新用户注册会获得设定的积分额度，推荐开启以提高新用户活跃度 |
| 注册赠送基础模型对话额度 | 新用户注册时赠送的基础模型额度 | 设置为0则不赠送，推荐设置适当值（如10-20次）吸引用户体验基础对话 |
| 注册赠送高级模型对话额度 | 新用户注册时赠送的高级模型额度 | 设置为0则不赠送，可设置较少量（如1-3次）作为体验额度提升用户转化率 |
| 注册赠送绘画额度 | 新用户注册时赠送的绘画模型额度 | 设置为0则不赠送，建议设置少量（如1-2次）体验额度展示平台绘画能力 |
注册赠送策略建议：根据平台定位和用户特点设置合理的赠送额度。对于面向大众用户的平台，建议提供更慷慨的基础模型额度；对于专业用户平台，可适当增加高级模型额度。赠送额度应当足够让用户体验核心功能，但不宜过高，以鼓励用户后续充值。
2.1.2 限定注册赠送
限定注册赠送功能用于激励早期用户注册，通过额外奖励提高平台初期的用户增长速度。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 开启优先注册赠送 | 为平台早期用户提供额外奖励 | 可用于营销活动，激励用户尽早注册，提高平台初期的用户获取效率 |
| 前多少名获得奖励 | 限定获得优先注册奖励的用户数量 | 如设置100，则仅前100名注册用户可获得奖励，建议根据目标用户规模合理设置 |
| 优先赠基础模型送对话额度 | 优先注册用户额外获得的基础模型额度 | 在基本赠送基础上的额外奖励，建议设置为普通注册赠送的1.5-2倍，强化奖励感 |
| 优先赠高级模型送对话额度 | 优先注册用户额外获得的高级模型额度 | 在基本赠送基础上的额外奖励，可设置较慷慨额度作为独特优势 |
| 优先赠送绘画额度 | 优先注册用户额外获得的绘画额度 | 在基本赠送基础上的额外奖励，可适当提高以展示平台绘画特色 |
限定注册赠送最佳实践：此功能特别适合新平台上线初期，通过"稀缺性"心理提高用户注册积极性。建议在社交媒体或其他渠道预告此活动，设置合理的限定人数（通常为预期首月用户数的20%-30%），并提供有吸引力的额外奖励。活动结束后，可考虑转为邀请注册奖励模式，保持用户增长动力。
2.1.3 签到奖励
签到奖励功能用于鼓励用户每日访问平台，提高用户活跃度和留存率。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 开启签到奖励 | 是否启用每日签到奖励功能 | 开启后用户可通过每日签到获取额度，增强用户活跃度和平台粘性 |
| 赠送基础模型额度 | 每次签到赠送的基础模型额度 | 推荐设置适当值（如1-3次），鼓励用户每日签到，增强用户活跃度 |
| 赠送高级模型额度 | 每次签到赠送的高级模型额度 | 可设置较低值或0，作为签到额外奖励，如每周累计签到达到特定天数赠送 |
| 赠送绘画额度 | 每次签到赠送的绘画额度 | 可设置较低值或0，作为签到额外奖励，建议偶尔赠送以提高用户对绘画的兴趣 |
签到奖励建议：设计合理的签到奖励机制可以显著提高用户留存率。除了基本的每日奖励外，还可以考虑设置连续签到奖励和累计签到奖励，如连续签到7天额外奖励、累计签到30天获得特殊奖励等。奖励数量应控制在合理范围内，避免过度消耗平台资源或降低付费意愿。
2.1.4 访客设置
访客设置用于控制未注册用户的使用权限，平衡体验性和商业性。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 基础模型额度 | 访客可用基础模型额度 | 设置为0则不允许访客使用，推荐设置少量体验值（如1-3次）以吸引用户注册 |
| 高级模型额度 | 访客可用高级模型额度 | 设置为0则不允许访客使用，可设置极少量（如0-1次）或完全不开放，保留注册用户特权 |
| 绘画积分额度 | 访客可用绘画额度 | 设置为0则不允许访客使用，可设置极少量（如0-1次）或完全不开放，作为注册激励 |
访客策略建议：访客功能是展示平台能力和吸引用户注册的重要途径。建议提供有限但足够展示价值的访客额度，特别是基础模型的体验额度。可以考虑对高级功能（如高级模型和绘画）做更严格限制，突出注册用户的权益差异，增强注册动力。同时，确保访客看到清晰的注册引导信息，强调注册后可获得的额外权益。
2.2 邮件配置
邮件配置用于设置系统发送邮件的服务器信息和模板，支持用户注册验证、密码重置等功能的邮件通知。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用邮件服务 | 控制是否启用邮件发送功能 | 开启后系统可发送邮件通知，用于账号验证、密码重置等功能 |
| 邮件服务器地址 | SMTP服务器地址 | 如smtp.gmail.com、smtp.qq.com等，根据选择的邮件服务提供商填写 |
| SMTP端口 | 邮件服务器的SMTP端口 | 通常为25、465（SSL）或587（TLS），根据服务器要求和安全设置选择 |
| 是否启用SSL | 控制是否使用SSL加密连接 | 建议开启以提高邮件传输安全性，部分服务商强制要求使用SSL |
| 发件人邮箱 | 系统发送邮件的邮箱地址 | 建议使用专用的系统邮箱，确保可靠性和专业性 |
| 发件人名称 | 邮件显示的发件人名称 | 通常设置为网站名称或客服名称，增强用户体验和品牌一致性 |
| 邮箱密码/授权码 | 发件邮箱的密码或授权码 | 大多数邮件服务需要使用专用的应用授权码而非邮箱登录密码 |
| 邮件模板-验证 | 邮箱验证邮件的内容模板 | 支持HTML格式，需包含验证链接占位符{verify_url}和网站名称占位符 |
| 邮件模板-重置 | 密码重置邮件的内容模板 | 支持HTML格式，需包含重置链接占位符{reset_url}和网站名称占位符 |
邮件配置建议：
- 选择可靠的邮件服务提供商，如Gmail、QQ邮箱企业版、阿里云邮件等
- 确保SMTP设置正确，特别是端口和SSL设置，避免邮件发送失败
- 定制专业的邮件模板，包含网站LOGO、清晰的操作指引和联系方式
- 测试邮件发送功能，确保邮件不会被标记为垃圾邮件
- 定期更新邮箱授权码，保障安全性
2.3 微信配置
微信配置分为几个部分，用于实现用户通过微信登录、数据迁移和公众号菜单管理等功能。
2.3.1 微信登录配置
配置微信开放平台的应用信息，允许用户使用微信账号登录系统。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用微信登录 | 控制是否启用微信登录功能 | 开启后用户可以使用微信扫码或授权方式登录平台 |
| AppID | 微信开放平台应用ID | 在微信开放平台注册应用后获取，用于标识应用身份 |
| AppSecret | 微信开放平台应用密钥 | 在微信开放平台注册应用后获取，用于接口认证，请妥善保管 |
| 回调域名 | 微信授权回调的域名 | 必须与微信开放平台设置的域名一致，且必须使用HTTPS协议 |
| 登录按钮文本 | 微信登录按钮显示的文字 | 自定义文本，通常为"微信登录"或"使用微信账号登录" |
| 登录成功页面 | 登录成功后跳转的页面 | 可设置为首页或用户中心页面，提供良好的登录后体验 |
微信登录集成流程：
- 在微信开放平台注册开发者账号
- 创建网站应用并完成身份验证
- 设置应用的授权回调域名
- 获取AppID和AppSecret填入系统配置
- 测试微信登录功能，确保正常运行
2.3.2 微信迁移配置
配置微信账号数据迁移的相关设置，用于用户数据的平滑迁移。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用微信迁移 | 控制是否启用微信账号迁移功能 | 开启后用户可以将旧微信账号数据迁移到新微信账号 |
| 迁移验证方式 | 账号迁移的验证方式 | 可选择邮箱验证、手机验证或两者结合，确保迁移安全性 |
| 迁移次数限制 | 用户可执行迁移操作的最大次数 | 建议设置合理限制（如1-3次），防止滥用，保护用户数据安全 |
| 迁移冷却期 | 两次迁移操作之间的最小间隔时间 | 建议设置适当冷却期（如30-90天），减少频繁迁移带来的风险 |
| 迁移数据范围 | 迁移过程中包含的数据类型 | 可选择迁移积分、对话历史、个人设置等，根据平台特点设置 |
微信迁移功能说明：微信迁移功能主要用于解决用户更换微信号、微信号被盗或其他特殊情况下的账号数据转移需求。启用此功能需谨慎，并设置合理的安全验证措施，防止账号数据被非法获取。建议在迁移过程中保留详细日志，便于后续追溯和问题处理。
2.3.3 微信公众号菜单
配置微信公众号的自定义菜单，提升用户在微信环境中的交互体验。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用菜单管理 | 控制是否启用公众号菜单管理功能 | 开启后可通过后台配置公众号菜单，无需登录微信公众平台 |
| 公众号AppID | 微信公众号的应用ID | 在微信公众平台获取，用于标识公众号身份 |
| 公众号AppSecret | 微信公众号的应用密钥 | 在微信公众平台获取，用于接口认证，请妥善保管 |
| 菜单配置 | 公众号菜单的结构和内容 | 支持三级菜单结构，包括菜单名称、类型和关联内容 |
| 菜单点击事件 | 菜单项点击后触发的事件 | 可配置跳转网页、发送消息、跳转小程序等多种事件类型 |
| 个性化菜单 | 针对特定用户群体的定制菜单 | 可根据用户标签、地域等条件设置不同的菜单内容 |
微信公众号菜单最佳实践：
- 设计简洁清晰的菜单结构，避免过于复杂
- 主菜单数量控制在3-5个之间，符合用户使用习惯
- 将最常用功能放在主菜单，次要功能放在子菜单
- 菜单名称尽量简短，一般不超过4-5个字
- 定期分析菜单点击数据，优化菜单内容和结构
- 菜单跳转的页面应适配移动设备，保证良好体验
2.4 短信配置
配置短信服务接入信息，用于短信验证码发送和通知。目前系统支持阿里云短信服务。
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用短信服务 | 控制是否启用短信发送功能 | 开启后系统可发送短信验证码和通知，用于手机验证和重要提醒 |
| 阿里云AccessKey | 阿里云API访问密钥ID | 在阿里云控制台获取，用于接口认证 |
| 阿里云SecretKey | 阿里云API访问密钥 | 在阿里云控制台获取，用于接口认证，请妥善保管 |
| 短信签名 | 短信发送时使用的签名 | 需在阿里云短信服务中审核通过的签名，通常为公司或品牌名称 |
| 验证码模板代码 | 验证码短信的模板ID | 需在阿里云短信服务中审核通过的模板ID，用于发送验证码 |
| 通知模板代码 | 通知类短信的模板ID | 需在阿里云短信服务中审核通过的模板ID，用于发送通知信息 |
| 验证码有效期 | 短信验证码的有效时间 | 单位为分钟，通常设置为5-10分钟，平衡安全性和用户体验 |
| 短信发送间隔 | 两次短信发送之间的最小间隔 | 单位为秒，通常设置为60-120秒，防止频繁发送造成骚扰和资源浪费 |
| 每日发送限制 | 同一手机号每日可接收短信数 | 建议设置合理限制（如10-20条），防止滥用，控制成本 |
短信服务使用建议：
- 选择可靠的短信服务提供商，如阿里云、腾讯云等
- 设计专业的短信模板，内容简洁明了，避免敏感词
- 实施合理的发送频率限制和防刷机制，防止恶意攻击
- 监控短信发送量和成功率，及时发现异常
- 提供备用验证方式（如邮箱验证），应对短信发送故障
- 考虑国际用户需求，支持国际短信发送功能
3. 模型管理
模型管理模块用于配置和管理 AI 模型的接入和使用规则。通过合理设置模型参数和使用规则，可以优化用户体验，控制成本，提供多样化的 AI 服务能力。
3.1 基础配置
设置 AI 模型的基础参数和默认行为，影响所有模型的全局设置。这些设置将作为默认值，当具体模型未单独设置时会使用这些全局配置。
3.1.1 基础配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 全局地址 | AI 模型的基础请求地址 | 例如https://api.openai.com，未指定版本时自动添加/v1 |
| 全局 Key | 模型访问密钥 | 当具体模型未设置Key时，将使用此全局Key，用于API认证 |
| 全局模型 | 默认使用的模型标识符 | 如gpt-4o-mini，用于后台静默性赋能操作，包括标题生成、提示词翻译等 |
| 系统预设消息 | 添加到用户对话前的系统指令 | 用于定义AI行为规则和角色定位，适用于没有自定义预设的对话 |
| 是否生成提示词参考 | 控制是否生成提示词建议 | 开启后系统会在对话中生成提示词参考，帮助用户更好地使用AI |
| 是否继承模型 | 控制使用新模型时是否继承会话 | 开启后切换模型将保留对话历史，关闭则会开始新对话 |
| 默认Temperature | 模型创造性参数默认值 | 值为0-2之间，越高创造性越强，默认为1，影响回答多样性 |
3.1.2 联网配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 联网插件地址 | 联网搜索插件的API地址 | 用于模型联网搜索功能，需填写完整的API接口URL |
| 联网插件Key | 联网搜索插件的API密钥 | 用于联网插件的接口认证，如使用第三方服务则需获取对应Key |
联网搜索功能说明：联网搜索允许AI模型访问实时互联网信息，为用户提供最新数据和信息。此功能需要单独的插件支持，可以使用官方提供的插件或兼容的第三方插件。开启联网功能会增加API调用成本和响应时间，但能显著提升用户体验和回答准确性。
3.1.3 深度思考配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 深度思考地址 | 深度思考模型请求地址 | 支持官方及多种第三方API接口，可使用专用推理模型或强化现有模型的思考能力 |
| 深度思考 Key | 深度思考模型访问密钥 | 必要时可与全局Key不同，用于深度思考API的接口认证 |
| 深度思考模型 | 深度思考所用模型标识 | 默认为deepseek-reasoner，可根据需要更改为其他专注推理的模型 |
深度思考功能说明：深度思考是一项高级功能，允许AI模型进行更深入的分析和推理，特别适合解决复杂问题、数学计算和逻辑推理。此功能可以通过两种方式实现：
- 全局思考：使用专门的推理模型（如Deepseek-Reasoner）进行深度分析
- 自用思考：利用模型本身的思考能力，通过特殊提示引导模型进行更深入思考
启用深度思考功能可能会增加响应时间和API调用成本，但能显著提高复杂问题的解决质量。
3.1.4 向量模型配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 向量模型地址 | 向量嵌入模型请求地址 | 用于文档分析和语义检索，支持多种向量嵌入模型API |
| 向量模型 Key | 向量模型访问密钥 | 可单独设置或使用全局Key，用于向量模型API的接口认证 |
| 向量模型名称 | 向量嵌入模型的标识符 | 默认text-embedding-3-small，支持多种选项如text-embedding-3-large等 |
| 文件启用向量分析阈值 | 触发向量分析的文本长度 | 超过此长度的文本将使用向量分析提高理解能力，单位为字符，默认10000 |
| 文件最大字符限制 | 可处理的最大文本长度 | 限制单次处理文本量，防止系统过载，单位为字符，默认500000 |
向量模型应用说明：向量模型用于将文本转换为数学表示（向量），使AI能更好地理解文本语义和关系。主要应用场景包括：
- 长文档分析：分析长篇文档并提取关键信息
- 语义搜索：通过语义相似度而非关键词匹配进行搜索
- 知识库建设：构建企业或个人知识库，支持精准查询
- 文档对比：分析多个文档间的相似度和关系
选择合适的向量模型可以平衡处理效率和语义理解能力，较大的模型（如text-embedding-3-large）提供更高的语义理解精度，但处理速度较慢且成本更高。
3.1.5 工具调用配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 工具调用地址 | 工具调用模型请求地址 | 用于支持功能工具调用的API地址，如不配置则使用全局地址 |
| 工具调用Key | 工具调用模型访问密钥 | 用于工具调用API的接口认证，如不配置则使用全局Key |
| 工具调用模型 | 工具调用所用模型标识 | 指定支持工具调用的模型，通常需要使用具备函数调用能力的高级模型 |
工具调用功能说明：工具调用允许AI模型使用外部工具和API执行特定任务，如获取天气信息、执行计算、查询日历等。此功能需要使用支持工具调用的特定模型，如gpt-4-turbo或支持函数调用的其他模型。工具调用可以显著扩展AI的能力边界，使其能够执行更多实用任务。
3.1.6 图片解析配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 图片解析地址 | 图片解析模型请求地址 | 用于图像理解和分析的API地址，如不配置则使用全局地址 |
| 图片解析Key | 图片解析模型访问密钥 | 用于图片解析API的接口认证，如不配置则使用全局Key |
| 图片解析模型 | 图片解析所用模型标识 | 指定支持图像理解的模型，如gpt-4-vision-preview或其他支持图像分析的模型 |
图片解析功能说明：图片解析功能允许AI模型"看见"并理解图像内容，可以分析图像中的元素、场景、文字等信息。此功能特别适用于图像描述、图表分析、屏幕截图理解等场景。不同的图片解析模型有不同的特点和能力，选择合适的模型可以满足特定的图像理解需求。
3.2 高级配置
配置 AI 模型的高级功能和特殊行为，满足特定场景的需求。
3.2.1 绘画配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 不存储图片 | 控制是否保存绘图原图 | 开启后不保存原图到存储上，直接反代访问原始图片，节省空间但可能影响访问速度和稳定性 |
| 不使用代理 | 控制是否使用图片访问代理 | 开启后直接使用原始链接，国内可能无法访问某些资源，影响图片显示 |
| 反代地址 | 图片资源反向代理地址 | 当不使用代理设置为关闭时使用，为空则使用原链接，用于解决图片跨域和访问限制问题 |
| 提示词优化 | 控制是否优化绘图提示词 | 开启后使用全局模型进行翻译/联想，不单独扣费，可提升绘图质量和成功率 |
| 优化 Prompt | 提示词优化的具体指令 | 设置翻译/联想的具体提示词，用于引导模型优化，可自定义优化方向和风格 |
| 连续绘画 | 控制是否启用连续绘画 | 开启后在使用 Dalle 绘图时调用全局模型总结绘画要求，支持复杂绘画需求的分步处理 |
| 绘图风格显示 | 设置可选的绘图风格列表 | 添加常用风格关键词，便于用户快速选择，格式为多个风格词以逗号分隔 |
绘画功能优化建议：
- 提示词优化是提高绘图质量的关键，建议开启此功能并设置合理的优化指令
- 对于面向中文用户的平台，可以设置自动翻译英文提示词以提高绘图成功率
- 连续绘画功能适合需要精细控制绘图过程的高级用户，可根据用户群体特点决定是否开启
- 绘图风格列表应包含多样化的风格选项，如写实风格、插画风格、油画风格、动漫风格等
- 对于国内用户，建议配置可靠的反代地址以确保图片访问稳定性
3.2.2 其他配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 配置项 | 说明 | 详细说明 |
| ------------ | ------------------------ | -------------------------------------------------------------------------- |
| 不存储图片 | 控制是否保存绘图原图 | 开启后不保存原图到存储上，直接反代访问原始图片，节省空间但可能影响访问速度 |
| 不使用代理 | 控制是否使用图片访问代理 | 开启后直接使用原始链接，国内可能无法访问某些资源 |
| 反代地址 | 图片资源反向代理地址 | 当不使用代理设置为关闭时使用，为空则使用原链接 |
| 提示词优化 | 控制是否优化绘图提示词 | 开启后使用全局模型进行翻译/联想，不单独扣费 |
| 优化 Prompt | 提示词优化的具体指令 | 设置翻译/联想的具体提示词，用于引导模型优化 |
| 连续绘画 | 控制是否启用连续绘画 | 开启后在使用 Dalle 绘图时调用全局模型总结绘画要求 |
| 绘图风格显示 | 设置可选的绘图风格列表 | 添加常用风格关键词，便于用户快速选择 |
3.2.2 其他配置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| Base64 识图 | 控制图像识别的格式方式 | 开启后使用base64格式传输图像，适用于API无法直接访问本地链接的情况 |
| TTS 音色 | 文本转语音的默认音色 | 设置默认的语音合成发音人，如Alloy、Echo、Fable等 |
3.3 模型设置
管理各个 AI 模型的具体参数、API 密钥和使用限制等，决定平台可用的 AI 能力。
3.3.1 模型类型
平台支持三大类AI模型：
- 基础对话：用户可以在用户端选择的模型，用于对话、问答、聊天等功能，支持OpenAI Chat格式
- 创意模型：用户端不直接展示，包括Midjourney绘图、Dalle绘图、SDXL绘图、Suno音乐，用于插件调用
- 特殊模型：用户端不直接展示，包括TTS朗读、GPTs等功能性模型
3.3.2 模型配置项
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 模型名称 | 模型的显示名称 | 在用户界面展示的模型名称 |
| 模型头像 | 模型的头像图片 | 在对话中展示的AI头像，不填则使用系统默认 |
| 模型状态 | 控制模型是否启用 | 启用后用户可以使用，禁用则对用户不可见 |
| 模型序号 | 控制模型在列表中的排序 | 数值越小越靠前，影响用户界面中的显示顺序 |
| 模型调用频率 | 限制模型的使用频率 | 设置每小时可调用次数，防止滥用 |
| 指定代理地址 | 模型专用的API代理地址 | 不设置则使用全局地址 |
| 模型密钥 | 模型专用的API密钥 | 不设置则使用全局Key，可填写多个Key（换行分隔） |
| 账号关联模型 | 实际调用的模型标识符 | 如gpt-4-turbo、gpt-3.5-turbo等 |
| 模型扣费类型 | 模型使用的积分类型 | 普通积分或高级积分 |
| 单次扣除金额 | 每次使用扣除的积分数量 | 根据模型定价设置合理的扣费额度 |
| 深度思考 | 启用深度思考功能及模式 | 全局思考使用独立推理模型，自用思考使用模型本身思考能力 |
| 深度思考系数 | 深度思考的积分倍数 | 开启深度思考后，扣费等于基础积分乘以此系数 |
| 联网搜索 | 是否启用联网搜索功能 | 开启后模型可访问互联网，用户界面显示联网按钮 |
| MCP工具支持 | 是否支持模型控制面板工具 | 开启后模型将支持MCP工具功能 |
| 上下文限制 | 最大对话轮次限制 | 设置允许用户选择的最高上下文条数 |
| 上下文Tokens | 模型总Token限制 | 设置模型能处理的最大token数量 |
| 回复Tokens | 模型回复Token限制 | 限制模型单次回复的最大Token数量 |
| 调用超时时间 | API请求超时限制 | 设置等待API响应的最长时间，单位为秒 |
| 图片解析 | 模型的图像理解能力设置 | 不使用、逆向格式、GPT Vision或全局解析 |
| 文件解析 | 模型的文件处理能力设置 | 不使用、逆向格式、专用解析或全局解析 |
| 系统预设提示词 | 模型的系统层级提示词 | 为模型设置身份和行为规则的基础提示词 |
| 基于token计费 | 是否按token数量计费 | 开启后根据实际使用的token数量计费，更精确 |
| Token计费比例 | token计费的比例系数 | 当启用token计费时，计算积分消耗的比例参数 |
4. 数据管理
数据管理模块用于查看和管理系统中的用户数据和内容。
4.1 用户信息
查看和管理用户的基本信息、使用情况和权限设置。
4.2 对话记录
查看和管理用户与 AI 的对话历史，可用于审核和问题排查。
4.3 内容预设
管理系统的自动回复和预设内容，可用于常见问题的快速响应。
4.4 外链管理
管理系统中使用的外部链接，控制资源引用和安全性。
5. 插件应用
插件应用模块用于管理系统的功能扩展和应用集成。
5.1 插件列表
管理系统中安装的各类插件，控制其启用状态和配置。
5.2 分类列表
管理插件和应用的分类体系，便于用户查找和使用。
5.3 应用列表
管理系统中集成的应用，提供多样化的功能和服务。
5.4 MCP 管理
管理 MCP (模型控制面板) 的配置和行为，优化模型调用和资源分配。
6. 风控管理
风控管理模块用于保障系统安全和内容合规。通过合理配置风控规则，可以有效防范违规内容，保护平台安全，满足监管要求，同时为用户提供良好的使用体验。
6.1 风控安全配置
设置系统的安全策略和风险控制规则，预防滥用和攻击。风控安全配置是平台安全防护的第一道防线，包括用户身份验证和内容监控等多个方面。
6.1.1 认证设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 开启实名验证 | 控制是否启用用户实名认证功能 | 开启后用户需要进行实名认证才能使用特定功能，提高用户真实性和平台安全性 |
| appCode | 阿里云实名认证接口的应用代码 | 需从阿里云市场获取实名认证API的appCode，用于第三方实名认证服务的接口认证 |
| 开启手机号验证 | 控制是否启用手机号验证功能 | 开启后用户需要验证手机号才能使用特定功能，增强账号安全性和用户可追溯性 |
| 手机号验证阈值 | 触发手机号验证的消息数量 | 用户发送消息达到此数量后将要求进行手机号验证，平衡安全性和用户体验 |
| 实名认证阈值 | 触发实名认证的消息数量 | 用户发送消息达到此数量后将要求进行实名认证，适用于分级验证的安全策略 |
| 开启敏感词过滤 | 控制是否启用敏感词过滤功能 | 开启后将对用户发送和AI回复的消息进行敏感词过滤，防止违规内容传播 |
认证策略建议：
- 分级验证：可以采用渐进式的验证策略，新用户初始只需基本注册，使用一定量后要求手机验证，深度使用后再要求实名认证
- 场景差异：针对不同业务场景设置不同的验证要求，一般对话可以较为宽松，涉及敏感话题、付费功能或高风险操作时要求更严格的验证
- 阈值调整：根据实际用户反馈和使用数据，动态调整验证阈值，找到安全性和便捷性的平衡点
- 替代方案：如果不希望强制实名认证，可以通过提供额外权益（如额外积分、专属功能）鼓励用户自愿完成验证
6.1.2 内容安全设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 内容安全检测方式 | 选择内容审核的技术路径 | 可选本地敏感词、百度内容安全、自定义API或多种方式组合 |
| 检测用户输入 | 是否检测用户输入的内容 | 开启后对用户发送的所有消息进行安全检测，可有效防止违规提问 |
| 检测AI回复 | 是否检测AI回复的内容 | 开启后对AI生成的回复进行安全检测，防止模型生成不适当内容 |
| 检测超时时间 | 内容安全检测的最长等待时间 | 单位为秒，超过此时间未完成检测则默认通过，平衡安全性和响应速度 |
| 违规处理方式 | 检测到违规内容后的处理策略 | 可选拦截发送、替换敏感词、警告提示或记录不处理等多种策略 |
| 违规累计阈值 | 触发用户限制的违规次数 | 用户累计违规达到此次数后将被限制使用，防止恶意用户反复尝试 |
| 账号冻结时长 | 违规账号的冻结持续时间 | 单位为小时，违规达到阈值的用户将在此时间内无法使用系统 |
内容安全最佳实践：
- 多层防护：建议同时开启用户输入和AI回复的内容检测，形成双重防护
- 性能优化：合理设置检测超时时间，避免过长的检测时间影响用户体验
- 分级处理：对不同类型的违规内容采用不同的处理策略，轻微违规可警告提示，严重违规则直接拦截
- 透明公开：向用户明确说明内容审核标准和违规处理规则，提高平台透明度
- 定期更新：根据新出现的违规方式和监管要求，定期更新内容安全策略
6.2 违规检测记录
查看系统检测到的违规内容和处理记录，用于安全审计和政策优化。违规检测记录可以帮助管理员了解平台的安全状况，识别常见违规类型，优化风控策略。
6.2.1 违规记录列表
系统会记录所有触发敏感词过滤的对话内容，管理员可以查看这些记录，了解用户行为和系统响应。违规记录列表包含以下信息：
| 字段 | 说明 | 详细说明 |
|---|---|---|
| 用户信息 | 违规用户的基本信息 | 包括用户名、邮箱、头像等，帮助识别和管理违规用户 |
| 用户状态 | 用户当前的账号状态 | 显示用户是否已被限制或冻结，便于管理员了解处理进度 |
| 累计违规次数 | 用户的历史违规总数 | 反映用户的历史行为模式，帮助判断是否为恶意用户 |
| 违规类型 | 触发的违规内容分类 | 如政治敏感、色情低俗、暴力恐怖等分类，便于分析和统计 |
| 违规关键词 | 触发检测的具体词语 | 展示实际触发检测的敏感词，有助于了解具体违规内容 |
| 检测来源 | 违规检测的技术来源 | 标明是由本地敏感词、百度内容安全还是自定义API检测到 |
| 违规内容 | 完整的违规消息内容 | 记录原始违规内容，便于管理员审核判断是否为误判 |
| 违规时间 | 违规行为的发生时间 | 记录违规发生的确切时间，便于追踪和分析时间模式 |
| 操作 | 可执行的管理操作 | 包括变更用户状态等功能，允许管理员直接处理违规账号 |
违规记录管理建议：
- 定期审核：管理员应定期审核违规记录，特别关注高频违规用户和新型违规方式
- 识别误判：分析可能的误判情况，优化敏感词库和检测规则
- 分类处理：根据违规类型和严重程度采取不同处理措施，确保处罚与违规程度相匹配
- 数据分析：对违规记录进行统计分析，识别高风险时段、用户群体和内容类型
- 证据保存：妥善保存违规记录作为证据，以应对可能的争议和监管检查
6.3 百度云敏感词
配置百度云内容安全服务，实现专业的敏感词过滤。百度云内容安全服务提供了强大的文本、图片审核能力，能够识别多种类型的违规内容，适合需要高精度内容审核的平台。
6.3.1 百度文本审核设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 开启此敏感词设置 | 控制是否启用百度云敏感词过滤 | 开启后将使用百度云内容安全服务进行文本审核，提供专业的内容检测能力 |
| 文本审核ApiKey | 百度云文本审核服务的API密钥 | 需从百度云AI平台获取，用于接口认证，请妥善保管避免泄露 |
| 文本审核SecretKey | 百度云文本审核服务的安全密钥 | 需从百度云AI平台获取，用于接口认证，与ApiKey配对使用 |
| 审核标签 | 需要审核的内容类型 | 可选政治、暴恐、色情、违禁、广告等多种类型，根据平台性质选择需要的类型 |
| 置信度阈值 | 判定为违规的最低置信度 | 取值0-1之间，越高则审核越严格，建议设置在0.7-0.9之间平衡准确率和误判率 |
百度云内容安全使用说明：
- 需要先在百度云内容安全平台注册账号
- 创建文本审核应用并获取ApiKey和SecretKey
- 根据平台特点选择需要检测的内容类型
- 测试并调整置信度阈值，找到准确性和用户体验的平衡点
- 定期关注服务使用量和计费情况，避免超出预算
百度云敏感词检测的优势在于能够识别语义层面的违规内容，不仅限于简单的关键词匹配，能有效应对各种变形和隐晦表达，特别适合对内容安全要求较高的平台。
6.4 自定义敏感词
管理系统自定义的敏感词库，针对特定场景进行内容过滤。自定义敏感词库可以补充第三方内容审核服务的不足，尤其适合添加行业特定、平台特定的敏感词。
6.4.1 自定义敏感词配置
允许管理员配置自定义的敏感词列表，可以根据平台特性和用户群体特征设置针对性的敏感词过滤规则。如果同时配置了百度云敏感词和自定义敏感词，系统会先检测百度云后检测自定义敏感词。
7. 存储配置
存储配置模块用于管理系统的文件存储方式和位置。合理配置存储方式可以提高文件访问速度，降低存储成本，增强系统稳定性和可扩展性。
7.1 本地存储
配置系统使用本地服务器存储文件的相关参数。本地存储是最基本的存储方式，适合小型项目或测试环境，但在生产环境中可能面临空间限制和访问速度问题。
7.1.1 本地存储参数设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用状态 | 控制是否启用本地存储功能 | 开启后将优先使用本地存储方式保存数据，适合小型项目或本地开发环境 |
| 网站地址 | 网站的完整URL | 用于拼接本地存储的文件访问路径，确保外部能正确访问存储的文件 |
| 存储目录 | 文件存储的服务器路径 | 默认为/public/file目录，可根据服务器配置调整，需确保有足够的读写权限 |
| 文件大小限制 | 单个文件的大小上限 | 限制上传文件的最大大小，单位为MB，防止超大文件占用过多存储空间 |
| 允许的文件类型 | 允许上传的文件格式 | 设置允许上传的文件扩展名，用于过滤不安全或不需要的文件类型 |
本地存储将文件保存在服务器的 /public/file 目录中，某些场景可能需要开启跨域访问，使用本地存储时需注意文件目录的读写权限问题。在更新或迁移系统时，请做好数据维护和备份工作。
本地存储优缺点：
- 优点：
- 无需额外费用
- 配置简单
- 访问速度快（相对于同网络环境的用户）
- 完全控制数据安全
- 缺点：
- 受服务器存储空间限制
- 不支持负载均衡和分布式部署
- 对服务器带宽要求高
- 备份和恢复复杂度高
7.2 腾讯云 COS
配置腾讯云对象存储服务的接入参数，用于云端文件存储。腾讯云COS提供高可靠、低成本的云存储服务，适合有大量文件存储需求的生产环境。
7.2.1 腾讯云对象存储设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 服务启用状态 | 控制是否启用腾讯云对象存储 | 开启后会使用腾讯云COS服务存储文件，提供可靠的云端存储能力 |
| secretId | 腾讯云API的密钥ID | 需从腾讯云控制台获取，用于接口认证，建议使用子账号密钥增强安全性 |
| secretKey | 腾讯云API的密钥 | 需从腾讯云控制台获取，用于接口认证，请妥善保管避免泄露 |
| 存储桶名称 | COS存储桶的名称 | 在腾讯云COS控制台创建的存储桶名称，格式通常为bucket-appid |
| 所属地域 | COS存储桶所在的地理区域 | 如ap-shanghai（上海）、ap-guangzhou（广州），需与腾讯云控制台设置一致 |
| 加速域名 | 自定义的CDN加速域名 | 可选，设置后将使用该域名访问文件，提高访问速度和用户体验 |
| 目录前缀 | 文件存储的目录前缀 | 用于在存储桶内组织文件，如uploads/，可根据业务需求设置 |
| 防盗链设置 | 文件访问的防盗链配置 | 可设置Referer白名单、是否允许空Referer等，防止资源被盗用 |
当同时启用多个存储服务时，腾讯云COS的优先级高于阿里云OSS和本地存储。
腾讯云COS使用说明：
- 在腾讯云官网注册账号并开通COS服务
- 创建存储桶并设置访问权限（建议为公有读私有写）
- 创建用于API访问的子账号和密钥，授予必要的COS操作权限
- 将获取的相关信息填入系统配置
- 可选配置CDN加速，提高文件访问速度
腾讯云COS优缺点：
- 优点：
- 高可靠性（数据持久性达99.999999999%）
- 无容量限制，按需付费
- 支持CDN加速，访问速度快
- 完善的安全机制和防盗链功能
- 支持图片处理、音视频转码等增值功能
- 缺点：
- 需要额外付费
- 依赖腾讯云服务，存在供应商锁定风险
- 国际访问可能受限
7.3 阿里云 OSS
配置阿里云对象存储服务的接入参数，用于云端文件存储。阿里云OSS是国内使用广泛的云存储服务，提供安全、稳定、高效的存储能力。
7.3.1 阿里云对象存储设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 服务启用状态 | 控制是否启用阿里云对象存储 | 开启后会使用阿里云OSS服务存储文件，提供稳定可靠的文件存储服务 |
| accessKeyId | 阿里云API的访问密钥ID | 需从阿里云控制台获取，用于接口认证，建议使用RAM子账号密钥提高安全性 |
| keySecret | 阿里云API的访问密钥 | 需从阿里云控制台获取，用于接口认证，请妥善保管避免泄露 |
| 存储桶名称 | OSS存储桶的名称 | 在阿里云OSS控制台创建的存储桶名称，必须全局唯一 |
| 所属地域 | OSS存储桶所在的地理区域 | 如oss-cn-shanghai（上海）、oss-cn-beijing（北京），与OSS控制台设置保持一致 |
| 全球加速域名 | 阿里云OSS的全球加速域名 | 可选，国外服务器可开启以获得更快的响应速度，会产生额外的全球加速流量费用 |
| 访问域名 | 自定义绑定的域名 | 可选，设置后使用自定义域名访问OSS资源，需在阿里云控制台完成域名绑定 |
| 目录规则 | 文件存储的目录结构规则 | 用于定义文件在OSS中的组织方式，如按日期、用户ID或文件类型组织 |
阿里云OSS使用说明：
- 在阿里云官网注册账号并开通OSS服务
- 创建存储空间（Bucket）并设置合适的权限和读写策略
- 创建用于API访问的RAM子账号，并分配必要的OSS操作权限
- 将获取的AccessKey和Secret填入系统配置
- 可选配置CDN或自定义域名，优化访问体验
阿里云OSS优缺点：
- 优点：
- 高可靠性和数据持久性
- 可无限扩展的存储容量
- 与阿里云其他服务（如CDN、安全）深度集成
- 完善的权限控制和数据加密功能
- 国内访问速度优势
- 缺点：
- 需要额外付费
- 国际访问可能需要配置全球加速
- API变更可能需要适配
7.4 Chevereto 图床
配置 Chevereto 图床服务的接入参数，专用于图片存储和管理。Chevereto是一款专业的图片托管软件，提供强大的图片管理和分享功能，特别适合需要专门图片服务的平台。
7.4.1 Chevereto 图床设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用状态 | 控制是否启用Chevereto图床 | 开启后会使用Chevereto服务存储图片，提供专业的图片管理和展示功能 |
| 图床API地址 | Chevereto图床的API接口地址 | 需填写完整的API接口URL，如https://your-chevereto.com/api/1/upload |
| 图床APIKey | Chevereto图床的API密钥 | 需从Chevereto管理面板获取，用于接口认证和上传授权 |
| 水印设置 | 图片水印的控制选项 | 可设置是否添加水印、水印位置、透明度等，保护图片版权 |
| 图片质量 | 上传图片的质量设置 | 可设置图片压缩质量，平衡图片质量和存储空间 |
| 缩略图生成 | 是否自动生成多种尺寸缩略图 | 开启后自动生成不同尺寸的缩略图，适应不同场景需求 |
Chevereto图床使用说明：
- 需要先拥有Chevereto服务，可以自行搭建或使用第三方Chevereto服务
- 在Chevereto管理面板创建API密钥
- 将API地址和密钥填入系统配置
- 测试上传功能，确保连接正常
Chevereto图床优缺点：
- 优点：
- 专为图片管理设计，功能丰富
- 支持多种图片处理功能（水印、压缩、裁剪等）
- 提供美观的图片展示界面和分享功能
- 可与其他存储方式结合使用
- 缺点：
- 仅支持图片类型文件
- 需要单独维护Chevereto服务
- 可能需要额外的服务器资源
7.5 存储服务优先级和选择指南
当同时配置多种存储服务时，系统会按照以下优先级使用存储服务：
- Chevereto图床（仅用于图片）
- 腾讯云COS
- 阿里云OSS
- 本地存储
存储方案选择建议：
- 小型个人项目：使用本地存储即可，成本低，配置简单
- 中型项目：建议使用云存储（COS或OSS），提供更好的可靠性和性能
- 大型商业项目：推荐混合存储策略，比如：
- 图片使用Chevereto或CDN加速的云存储
- 用户上传文档使用带访问控制的云存储
- 临时文件可使用本地存储
- 特殊需求：
- 对图片处理需求高的项目可优先考虑Chevereto
- 国际用户较多的项目应考虑使用全球加速或国际区域的存储服务
- 对成本敏感的项目可配置存储生命周期，自动归档或删除长期不使用的文件
8. 套餐管理
套餐管理模块用于配置和管理系统的商业模式和用户权益。合理设计套餐体系是平台商业成功的关键，既需要满足用户多样化需求，又要确保平台的可持续发展。
8.1 订单列表
查看和管理用户的购买订单，跟踪交易状态和处理异常情况。订单管理是确保平台交易正常运行的重要环节，需要及时处理各类订单问题。
订单列表提供了对系统中所有充值订单的综合管理，包括订单查询、状态查看和必要的操作功能。管理员可以通过订单号、用户信息或时间范围等条件筛选订单，并查看每笔订单的详细信息。
| 字段 | 说明 | 详细说明 |
|---|---|---|
| 订单号 | 系统生成的唯一订单标识 | 自动生成的唯一标识符，用于跟踪和查询订单 |
| 用户信息 | 下单用户的账号信息 | 包括用户ID、用户名等，用于关联订单与用户 |
| 套餐名称 | 购买的套餐名称 | 显示用户购买的具体套餐类型，反映用户的需求和偏好 |
| 支付金额 | 订单的实际支付金额 | 显示用户实际支付的金额，包含可能的折扣或优惠 |
| 支付方式 | 用户选择的支付渠道 | 如微信支付、支付宝或其他第三方支付方式 |
| 订单状态 | 当前订单的处理状态 | 如待支付、支付成功、支付失败、已取消等 |
| 创建时间 | 订单的创建时间 | 记录订单初始生成的时间，用于跟踪订单时效 |
| 支付时间 | 订单的完成支付时间 | 记录实际支付成功的时间，成功订单才会有此记录 |
| 操作 | 可对订单执行的管理操作 | 如查看详情、手动完成、取消订单等功能按钮 |
订单管理最佳实践：
- 定期审核：每日检查异常订单，特别是支付状态与实际不符的情况
- 快速响应：及时处理用户支付问题，提高用户满意度
- 数据分析：基于订单数据分析销售趋势、用户偏好和转化率
- 退款处理：建立清晰的退款流程，妥善处理退款申请
- 异常处理：对于异常订单（如金额不符、重复支付等）制定标准处理流程
8.2 账户明细
查看用户的账户变动记录，包括充值、消费和赠送等操作。账户明细记录了用户账户余额变动的所有交易，为用户查询和平台核对提供依据。
账户明细记录了用户账户余额变动的所有交易，包括积分消费、充值、管理员赠送等，提供完整的交易历史记录，便于解决用户查询和投诉问题。
| 字段 | 说明 | 详细说明 |
|---|---|---|
| 用户信息 | 账户所属用户信息 | 包括用户ID、用户名、注册时间等，便于识别和查询特定用户的交易记录 |
| 交易类型 | 账户变动的业务类型 | 如充值、消费、赠送、退款等不同类型的交易 |
| 变动积分类型 | 变动的积分类别 | 如基础积分、高级积分或绘画积分，反映具体变动的积分种类 |
| 变动数量 | 积分的增减数量 | 显示具体增加或减少的积分数量，正数表示增加，负数表示减少 |
| 交易前余额 | 交易前账户的积分余额 | 记录变动前的原始积分余额，用于核对和追踪 |
| 交易后余额 | 交易后账户的积分余额 | 记录变动后的最终积分余额，确认变动是否正确执行 |
| 关联信息 | 相关的订单或业务信息 | 如关联订单号、充值套餐、消费对象（如模型对话ID）等 |
| 操作时间 | 账户变动的发生时间 | 记录具体变动的时间点，以时间倒序排列，方便查阅最近的交易 |
| 备注信息 | 交易的附加说明信息 | 可包含管理员操作原因、系统自动处理说明或其他相关信息 |
账户明细应用场景：
- 用户查询：当用户对积分变动有疑问时，可通过账户明细快速定位和解释
- 财务核对：定期核对充值与消费记录，确保系统计费准确无误
- 异常监控：识别异常的积分变动模式，及时发现并处理潜在问题
- 用户行为分析：了解用户的消费习惯和使用偏好，优化产品设计
- 问题追溯：在处理用户投诉时，通过交易记录还原完整的使用过程
8.3 套餐设置
配置系统提供的各类套餐，定义价格、包含内容和有效期等。套餐设置直接关系到平台的商业模式和用户体验，需要精心设计并定期优化。
8.3.1 套餐类型
平台支持两种类型的套餐：
- 不限时套餐：充值的积分永不过期，用户可长期使用，适合偶尔使用的用户
- 限时套餐：在规定时间内未使用完毕的积分将被清空，适合提供更优惠价格或促销活动
8.3.2 套餐规则
- 当用户充值的套餐等级高于或等于当前套餐等级时，系统会叠加充值额度并延长会员到期时间
- 当用户充值的套餐等级低于当前套餐等级时，系统只叠加充值额度，不延长会员到期时间，也不改变会员等级
这种规则设计鼓励用户选择更高等级的套餐，同时允许用户在保持当前等级的情况下灵活补充积分。
8.3.3 套餐配置项
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 套餐名称 | 套餐的名称 | 在用户界面展示的套餐名称，应简洁明了并能反映套餐特点，如"基础套餐"、"专业版" |
| 排序ID | 控制套餐在列表中的排序 | 数值越小越靠前，影响用户界面中的显示顺序，可将推荐套餐置于靠前位置 |
| 套餐应用 | 套餐可用的应用分类 | 选择套餐适用的应用分类，可多选，限定套餐使用范围，实现精细化定价 |
| 套餐价格 | 套餐的销售价格 | 用户购买套餐需支付的金额，单位为元，是套餐的核心属性 |
| 套餐等级 | 套餐的等级权重 | 用于判断套餐之间的高低级别关系，影响购买时的积分叠加和会员期限延长规则 |
| 套餐状态 | 控制套餐是否上架销售 | 启用状态的套餐会在用户界面显示并可购买，禁用状态则不可见，便于临时下架 |
| 套餐有效期 | 套餐中积分的有效使用期限 | 单位为天，设置为-1表示永久有效（不限时套餐），限时套餐通常设置30/90/365天 |
| 基础模型额度 | 套餐包含的基础模型使用额度 | 用户可使用基础模型的次数，是套餐价值的重要组成部分 |
| 高级模型额度 | 套餐包含的高级模型使用额度 | 用户可使用高级模型的次数，通常数量少于基础模型但价值更高 |
| 绘画额度 | 套餐包含的AI绘画使用额度 | 用户可使用AI绘画功能的次数，是区分不同套餐的特色功能之一 |
| 套餐描述 | 套餐的详细说明 | 在用户界面展示，用于说明套餐的特点和优势，可包含使用建议和适用场景 |
| 套餐标签 | 套餐的特性标签 | 如"热门"、"推荐"、"限时"等，增强套餐的吸引力和辨识度 |
| 折扣信息 | 套餐的折扣显示信息 | 显示优惠力度，如"8折优惠"、"立省xx元"等，增强促销效果 |
套餐设计策略：
- 差异化策略：确保不同套餐之间有明显差异，避免用户选择困难
- 价值阶梯：设计合理的价格阶梯，高价套餐应提供明显更高的性价比
- 核心价值：突出每个套餐的核心亮点，如基础套餐突出性价比，高级套餐突出独特功能
- 目标用户：针对不同用户群体设计套餐，如个人用户、团队用户、企业用户等
- 季节性调整：根据季节和节日调整套餐内容和促销策略，如开学季、双11等
8.4 卡密管理
管理系统的充值卡密，用于离线销售和促销活动。卡密系统适合特定销售场景，如线下推广、渠道分销或无在线支付条件的用户。
8.4.1 卡密功能
卡密系统提供了一种离线充值方式，管理员可以预先生成卡密，用户通过输入卡密码可以获得相应的积分或会员权益。这种方式特别适用于线下销售、促销活动或没有在线支付条件的场景。
| 功能 | 说明 | 详细说明 |
|---|---|---|
| 批量生成 | 一次生成多个卡密 | 可指定生成数量、面额和有效期，批量创建卡密用于促销或分销 |
| 导出卡密 | 将生成的卡密导出为文件 | 支持CSV/Excel格式导出，便于打印或分发给销售渠道 |
| 状态管理 | 管理卡密的使用状态 | 可查看卡密是否已使用、冻结或已过期，必要时手动调整状态 |
| 使用记录 | 查看卡密的兑换记录 | 记录卡密兑换的用户、时间和获得的具体权益，便于追踪使用情况 |
| 面额设置 | 设置卡密对应的价值 | 可灵活设置卡密金额或直接对应特定套餐，满足不同销售需求 |
| 批次管理 | 按批次组织管理卡密 | 可为不同活动或渠道创建不同批次，便于统计和跟踪销售效果 |
| 有效期控制 | 设置卡密的可用时间范围 | 可限制卡密的生效和失效时间，适用于限时促销活动 |
8.4.2 卡密配置项
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 卡密类型 | 卡密的类别 | 可设置为金额卡（充值指定金额）或套餐卡（直接兑换特定套餐） |
| 卡密面额 | 卡密对应的金额或套餐 | 金额卡设置充值金额，套餐卡关联特定套餐ID |
| 卡密前缀 | 卡密码的前缀字符 | 用于区分不同批次或类型的卡密，通常使用字母组合，如VIP-、PRO-等 |
| 卡密长度 | 卡密码的字符长度 | 不含前缀的卡密主体长度，通常设置12-16位，平衡安全性和易用性 |
| 有效期 | 卡密的有效使用期限 | 设置卡密自生成日起的有效天数，超过有效期将无法使用 |
| 使用限制 | 卡密的使用限制条件 | 可设置单个用户可使用的卡密数量限制，防止滥用 |
| 批次备注 | 当前批次卡密的说明信息 | 管理员可见的备注信息，记录批次用途、分发渠道等，便于后续管理 |
卡密管理最佳实践：
- 安全性考虑：生成足够复杂的卡密码，避免被猜测或破解
- 批次管理：不同活动或渠道使用不同批次和前缀，便于统计和分析
- 数量控制：根据实际需求生成适量卡密，避免过多闲置浪费
- 定期清理：定期清理过期未使用的卡密，保持系统整洁
- 销售追踪：记录卡密分发去向，便于追踪销售效果和渠道管理
9. 支付管理
支付管理模块用于配置系统的支付方式和支付接口。完善的支付系统是商业平台的核心，需要兼顾便捷性、安全性和多样性，满足不同用户的支付习惯。
9.1 微信支付
配置微信支付接口，支持用户通过微信完成支付。微信支付是国内最流行的支付方式之一，适合移动端用户和习惯使用微信的用户群体。
9.1.1 微信支付参数设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用状态 | 控制是否启用微信支付 | 开启后用户可以使用微信支付进行充值，显示微信支付选项 |
| 商户号(MchID) | 微信支付商户号 | 需从微信支付商户平台获取，唯一标识商户身份 |
| APPID | 微信公众号或小程序的应用ID | 需从微信公众平台获取，用于发起支付的应用标识 |
| 微信支付密钥(V2) | 微信支付API密钥 | 在微信支付商户平台设置的API密钥，用于V2版本接口的签名验证 |
| 微信支付密钥(V3) | 微信支付V3版API密钥 | 在微信支付商户平台设置的APIv3密钥，用于V3版本接口的签名和加密 |
| 序列号 | 微信支付API证书序列号 | 微信支付API证书的序列号，用于V3版接口的身份认证 |
| 微信证书文件路径 | API证书文件的存储路径 | 微信支付API证书文件在服务器上的路径，用于建立安全连接 |
| 微信私钥文件路径 | API私钥文件的存储路径 | 微信支付API私钥文件在服务器上的路径，用于数据签名 |
| 支付通知URL | 接收支付结果通知的地址 | 支付完成后微信服务器会向此地址发送通知，必须可公网访问且支持HTTPS |
| 支付类型 | 微信支付的接口类型 | 可选JSAPI支付（公众号）、Native支付（扫码）、H5支付（移动网页）等 |
| 支付超时时间 | 订单支付的有效期 | 超过此时间未完成支付的订单将自动关闭，单位为分钟，建议设置为5-15分钟 |
微信支付使用流程：
- 申请微信支付商户号并完成实名认证
- 在微信支付商户平台开通支付功能并获取相关参数
- 下载API证书并配置到系统中
- 设置支付通知URL并确保服务器能接收微信通知
- 测试支付功能，确认支付流程正常
9.2 嘟噜支付
配置嘟噜支付服务的接入参数，提供多样化的支付方式。嘟噜支付是第三方聚合支付平台，支持多种支付渠道，适合需要一站式支付解决方案的网站。
9.2.1 嘟噜支付参数设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用状态 | 控制是否启用嘟噜支付 | 开启后用户可以使用嘟噜支付进行充值，显示多种支付选项 |
| 商户ID | 嘟噜支付商户ID | 需从嘟噜支付平台获取，唯一标识商户身份 |
| 商户密钥 | 嘟噜支付商户密钥 | 需从嘟噜支付平台获取，用于接口认证和数据签名，请妥善保管 |
| 支付网关 | 嘟噜支付的接口网关地址 | 嘟噜支付的API接口地址，通常为官方提供的固定地址 |
| 异步回调地址 | 支付结果的异步通知地址 | 用于接收支付结果通知，需设置为可公网访问的URL，支付平台会向此地址发送支付结果 |
| 同步回调地址 | 支付完成后的跳转地址 | 用户支付完成后的跳转页面，通常为充值成功页面或用户中心 |
| 超时时间 | 支付订单的超时时间 | 单位为分钟，超过此时间未支付的订单将自动关闭，建议设置为5-30分钟 |
| 支付渠道 | 支持的支付方式选项 | 可选择开启的支付渠道，如支付宝、微信、QQ钱包等，根据平台实际支持情况选择 |
嘟噜支付特点：
- 集成多种支付方式，用户可自由选择
- 提供统一的接口和结算流程，简化管理
- 支持个人及企业商户，门槛较低
- 提供实时交易数据和对账功能
9.3 易支付
配置易支付服务的接入参数，接入更多支付渠道。易支付是另一种常见的第三方支付聚合平台，广泛应用于个人网站和小型商业平台。
9.3.1 易支付参数设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用状态 | 控制是否启用易支付 | 开启后用户可以使用易支付进行充值，提供多种支付选择 |
| 商户ID | 易支付商户ID | 需从易支付平台获取，唯一标识商户身份 |
| 商户密钥 | 易支付商户密钥 | 需从易支付平台获取，用于接口认证和数据签名，请妥善保管 |
| 支付网关 | 易支付的接口网关地址 | 易支付的API接口地址，根据选择的易支付服务商可能有所不同 |
| 异步回调地址 | 支付结果的异步通知地址 | 用于接收支付结果通知，需设置为可公网访问的URL，确保系统能接收支付状态更新 |
| 同步回调地址 | 支付完成后的跳转地址 | 用户支付完成后的跳转页面，通常为充值成功页面，提供良好的用户体验 |
| 支付方式 | 支持的支付方式 | 如支付宝、微信支付、QQ钱包等，多个方式用英文逗号分隔，根据实际支持情况选择 |
| 接口版本 | 易支付接口的版本号 | 根据易支付平台的接口版本设置，确保兼容性 |
| 风控设置 | 支付安全控制选项 | 如IP限制、订单金额限制等，增强支付安全性 |
易支付使用建议：
- 选择信誉良好、稳定可靠的易支付服务商
- 定期测试支付功能，确保接口正常
- 保持商户密钥安全，定期更新
- 设置合理的回调处理机制，确保不遗漏支付通知
9.4 码支付
配置码支付服务的接入参数，便于移动端扫码支付。码支付专注于扫码支付场景，提供简洁的支付体验，特别适合线下场景和桌面端用户。
9.4.1 码支付参数设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用状态 | 控制是否启用码支付 | 开启后用户可以使用码支付进行充值，提供扫码支付选项 |
| 商户ID | 码支付商户ID | 需从码支付平台获取，唯一标识商户身份 |
| 商户密钥 | 码支付商户密钥 | 需从码支付平台获取，用于接口认证和数据签名，请妥善保管 |
| 支付网关 | 码支付的接口网关地址 | 码支付的API接口地址，通常为官方提供的固定地址 |
| 异步回调地址 | 支付结果的异步通知地址 | 用于接收支付结果通知，需设置为可公网访问的URL，确保能接收支付状态更新 |
| 同步回调地址 | 支付完成后的跳转地址 | 用户支付完成后的跳转页面，通常为充值成功页面 |
| 支付通道 | 支持的扫码支付渠道 | 如支付宝扫码、微信扫码等，可根据需求选择开启相应渠道 |
| 二维码样式 | 支付二维码的显示样式 | 可定制二维码的大小、颜色、边距等，优化用户体验 |
| 订单超时 | 扫码支付的有效时间 | 单位为分钟，超过此时间未扫码支付的订单将失效，建议设置为3-5分钟 |
码支付特点与应用场景：
- 主要面向扫码支付场景，用户体验简单直接
- 特别适合PC端网站，用户可通过手机扫码完成支付
- 支持即时到账，交易确认速度快
- 可用于线上商城、会员充值、在线服务等多种场景
9.5 虎皮椒支付
配置虎皮椒支付服务的接入参数，提供稳定的支付通道。虎皮椒是专注于个人开发者和小型企业的支付服务，提供简单易用的接口和较低的接入门槛。
9.5.1 虎皮椒支付参数设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用状态 | 控制是否启用虎皮椒支付 | 开启后用户可以使用虎皮椒支付进行充值，增加支付选择 |
| 商户ID | 虎皮椒支付商户ID | 需从虎皮椒支付平台获取，唯一标识商户身份 |
| 商户密钥 | 虎皮椒支付商户密钥 | 需从虎皮椒支付平台获取，用于接口认证，请妥善保管 |
| 支付网关 | 虎皮椒支付的接口网关地址 | 虎皮椒支付的API接口地址，通常为官方提供的固定地址 |
| 异步回调地址 | 支付结果的异步通知地址 | 用于接收支付结果通知，需设置为可公网访问的URL，确保接收支付状态更新 |
| 同步回调地址 | 支付完成后的跳转地址 | 用户支付完成后的跳转页面，通常为充值成功页面 |
| 接口模式 | 接口的调用方式 | 可选直接跳转或API接入两种方式，影响支付流程和用户体验 |
| 支付渠道 | 启用的支付方式 | 如支付宝、微信、银联等，可根据平台实际支持情况和用户需求选择 |
| 手续费设置 | 支付手续费的处理方式 | 可选商户承担或用户承担，影响实际收款金额或用户支付金额 |
虎皮椒支付适用场景：
- 个人站长和小型网站，申请门槛低
- 需要稳定支付接口但交易量不大的项目
- 内容付费、会员订阅等小额高频场景
- 需要快速上线支付功能的临时项目
9.6 蓝兔支付
配置蓝兔支付服务的接入参数，扩展支付选择。蓝兔支付是另一个面向个人开发者和中小网站的支付服务，提供多样化的支付渠道和稳定的接口。
9.6.1 蓝兔支付参数设置
| 配置项 | 说明 | 详细说明 |
|---|---|---|
| 启用状态 | 控制是否启用蓝兔支付 | 开启后用户可以使用蓝兔支付进行充值，丰富支付选择 |
| 商户ID | 蓝兔支付商户ID | 需从蓝兔支付平台获取，唯一标识商户身份 |
| 商户密钥 | 蓝兔支付商户密钥 | 需从蓝兔支付平台获取，用于接口认证和数据验证，请妥善保管 |
| 支付网关 | 蓝兔支付的接口网关地址 | 蓝兔支付的API接口地址，根据平台提供的文档设置 |
| 异步回调地址 | 支付结果的异步通知地址 | 用于接收支付结果通知，需设置为可公网访问的URL，确保接收支付结果更新 |
| 同步回调地址 | 支付完成后的跳转地址 | 用户支付完成后的跳转页面，通常为充值成功页面 |
| 支付页面样式 | 支付界面的外观设置 | 可调整颜色、布局等，提升品牌一致性和用户体验 |
| 订单有效期 | 支付订单的保留时间 | 单位为分钟，未完成支付的订单保留的最长时间，建议设置为15-60分钟 |
| 支持的渠道 | 可使用的支付方式 | 选择开启的支付渠道，如支付宝、微信、QQ、京东等 |
9.7 支付系统选择与安全建议
9.7.1 支付方式选择指南
选择合适的支付服务应考虑以下因素：
- 用户群体：了解目标用户的支付习惯，中国大陆用户偏好微信和支付宝，国际用户可能需要信用卡和PayPal
- 业务规模：小型个人项目可选择第三方聚合支付，大型商业项目建议直接对接官方支付接口
- 合规要求：确保支付服务符合当地法规要求，特别是涉及跨境支付时
- 费率成本：比较不同支付服务的费率结构，选择最经济合适的方案
- 技术支持：评估支付服务的稳定性、文档质量和技术支持响应能力
9.7.2 支付安全最佳实践
保障支付安全是平台的核心责任，建议采取以下措施：
- 通信加密：确保所有支付相关页面使用HTTPS协议
- 参数验签：严格验证支付回调的签名，防止伪造通知
- 订单核对：支付回调时核对订单金额与商户订单记录是否一致
- 防重复处理：实施幂等性处理机制，防止重复通知导致重复充值
- 日志记录：详细记录支付流程的每个环节，便于问题排查
- 异常监控：设置金额异常、频次异常的预警机制
- 密钥保护：商户密钥妥善保管，定期更换，避免硬编码在代码中
- 账户对账：定期与支付平台进行对账，确保资金准确无误