快速开始
三步跑起来
全程不需要编辑任何配置文件
1
装依赖
克隆仓库，建虚拟环境，装依赖。
git clone https://github.com/vfaner/intelligent-customer-service.git
cd intelligent-customer-service/backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
2
启动
PyCharm 右键 run.py → Run，或者命令行：
python run.py
# 缺依赖时会提示当前解释器
# 对应的安装命令，也可以：
python run.py --install
启动后打印管理后台地址，直接点开即可。
3
网页上配置
访问 localhost:8000/admin/，用 admin / 123456 登录
# 1. 顶部横幅 → 点「一键初始化」
# 2. 模型配置 → 填 Key → 测试连接
# 3. 向量模型 → 复用 Key → 探测维度
# 4. 知识文档 → 拖入文件 → 自动入库
# 5. 聊天预览 → 提问验证
# 6. 用户信息 → 改掉默认密码
不需要编辑
.env 或执行 init_db.py。默认账号首次启动自动创建。
点击播放 · 哔哩哔哩在线视频（点击后才加载第三方播放器）
🪟 嵌入到你的网站
两行代码，把客服装到任意页面。
<script src="https://你的域名/widget/customer-service.js?v=1"></script>
<script>
CustomerService.init({
apiUrl: 'https://你的域名',
accent: '#4f46e5',
position: 'right',
});
</script>
客服名称、头像、欢迎语不用写在这里 —— 组件会自动读取后台「客服信息」的配置。
?v=1 是缓存版本号，更新组件后递增。
⚙️ 环境要求
门槛很低，不需要 GPU。
| 项目 | 要求 |
|---|---|
| Python | 3.11+（已在 3.14 验证） |
| 数据库 | SQLite（默认，零配置） |
| 向量库 | Chroma（默认，零部署） |
| 模型 | 任一厂商的 API Key |
| GPU | 不需要（推理在厂商侧） |
| Node.js | 仅前端自检需要 |
命令行参数
run.py 支持的参数
不改任何配置文件就能换端口、开放局域网、关掉热重载。
| 参数 | 作用 |
|---|---|
--port 9000 | 换端口（默认 8000） |
--host 0.0.0.0 | 允许局域网其他设备访问（默认只绑本机） |
--no-reload | 关闭热重载，部署时建议加上 |
--open | 启动后自动打开浏览器到管理后台 |
--install | 缺依赖时自动安装 |
也支持标准 uvicorn：uvicorn src.main:app --reload --port 8000
装依赖卡住 / 有多个 Python 环境？
确认依赖装进了运行项目的那个解释器：用 /你的/venv/bin/python -m pip install -r requirements.txt 最稳；PyCharm 用户检查 Run Configuration 里选的解释器。Python 3.14 上 langchain-text-splitters 装不上不影响使用 —— 切分器有内置实现，其余依赖均已在 3.14 验证通过。