效果预览
每个界面都在解决一个具体问题
点击标签切换查看
进后台先登录
访问 /admin/ 下的任何页面都会先跳到登录页，登录后自动跳回你原本要去的地址。
- 默认账号
admin/123456，首次启动自动创建 - 登录页本身支持中 / 繁 / 日 / 英切换
- 仍在用默认密码时，后台顶部常驻提醒横幅
- 已做开放重定向防护，
?next=只认站内地址
一眼看清系统状态
当前模型、向量库、文档数全在首屏，还附了一份四步快速开始指引。
- 没配好的地方会直接给出黄色横幅和跳转
- 首次进入点「🚀 一键初始化」建表建目录写默认配置
- 后端状态每 15 秒自检，离线时悬停可看完整错误
- 桌面端侧栏和顶栏固定，只有内容区滚动
选厂商就自动填好
15 项厂商预设，选中后 Base URL 和默认模型自动填充，协议下拉按该厂商实际支持的协议动态生成。
- 填完 Key 点「测试连接」，直接看到模型真实回复
- 点「🔄」调厂商接口，拉取你账号能用的模型列表
- 向量模型可一键复用对话模型的 Key 和地址
- 自动探测维度并同步到向量库配置
参数不用猜，能预览
Top-K、相似度阈值、切分策略都在这里。关键是那个「🔍 预览切分效果」按钮。
- 选文档或粘贴文本，立刻看到切成多少片
- 显示每片长度分布和章节归属
- 不用真的入库，不消耗 embedding 配额
- 回答策略开关：严格 RAG / 允许自主回答
三选一，只显示相关字段
选中哪个向量库就只显示它需要的参数，不会让你对着一堆无关配置发愁。
- Chroma — 本地文件持久化，零部署
- Qdrant — Rust 实现，生产级
- Milvus — 填
.db路径即用 Lite 模式，无需 etcd/minio - 维度不匹配时页面会自动同步修正
拖进去，剩下自动做
支持 txt / md / docx / xlsx / pdf，单文件默认上限 20MB，上传后自动解析入库。
- 拖拽上传，实时显示入库进度和分片数
- 遇厂商配额限制会自动降批、退避重试
- 中断后进度保留，再点「入库」从上次位置继续
- 状态标记为就绪才会进入检索
改一次，所有站点生效
名称、头像、欢迎语、联系方式在这里配置。
- 所有已嵌入的组件启动时自动来读这份配置
- 不用去改每个站点的嵌入代码
- 头像支持图片 URL，加载失败自动退回首字
- 联系方式会显示在客服窗口头部
账号资料和密码
设计上就是单账号，不做多用户管理 —— 两张卡片，改资料和改密码。
- 用户名 / 昵称 / 邮箱，用户名 3~32 字符且不含空格
- 改密码立即让其他所有设备下线，当前设备不受影响
- 改用户名不会踢任何设备 —— token 认的是数字 id
- 忘了密码可以跑
reset_admin_password.py重置
后台里直接测
配完不用切页面，就在管理后台里提问验证效果。
- 用 iframe 内嵌真实组件，与线上表现一致
- Markdown 正常渲染：加粗、列表、代码块
- 文章链接是可点击的超链接
- SSE 流式输出，逐字显示
三种方式，一键复制
不管你的站点是什么技术栈，总有一种能接。
- <script> 标签 — 两行代码，最简单
- iframe — 完全隔离，样式互不影响
- 小程序 web-view — 微信/支付宝/抖音
- 代码里的域名会自动替换成你的实际地址
装到网站上是这样
右下角一个浮动按钮，点开就是聊天窗口。
- 浮动按钮位置可选左右
- 主题色可配，适配你的品牌
- 支持在聊天窗口里直接上传文件
- PC / 平板 / 手机响应式适配
