60 lines
1.9 KiB
Markdown
60 lines
1.9 KiB
Markdown
|
# ReplyPier
|
||
|
|
|
||
|
|
ReplyPier 是面向个人与公司网站的 AI 客服系统，支持知识库问答、AI 转人工、多客服协作与服务评价。
|
||
|
|
|
||
|
|
## 使用与开发文档
|
||
|
|
|
||
|
|
- [本机使用与启停](LOCAL_DEPLOY.md)
|
||
|
|
- [开发与维护指引](AGENT_HANDOFF.md)
|
||
|
|
- [从零开发逐日计划：9 月 21 日—10 月 21 日](FROM_ZERO_PLAN.md)
|
||
|
|
|
||
|
|
## 核心能力
|
||
|
|
|
||
|
|
- 网站悬浮客服入口与嵌入式聊天窗口。
|
||
|
|
- 基于指定知识库的 AI 问答与会话上下文。
|
||
|
|
- 同一会话内转人工、客服接管与授权转交。
|
||
|
|
- 管理员与人工客服角色、客服分组和会话访问控制。
|
||
|
|
- 服务星级、文字评价、聊天记录与基础统计。
|
||
|
|
- 可配置的 Agent、知识处理任务与工作流。
|
||
|
|
|
||
|
|
## 技术结构
|
||
|
|
|
||
|
|
- 后端：Python、FastAPI、SQLAlchemy、Alembic。
|
||
|
|
- 前端：Vue 3、TypeScript、Vite。
|
||
|
|
- 实时通信：Socket.IO。
|
||
|
|
- 知识检索：FastEmbed、PostgreSQL/pgvector。
|
||
|
|
- 短期状态与事件分发：Redis。
|
||
|
|
- AI 编排：Agno。
|
||
|
|
|
||
|
|
```text
|
||
|
|
backend/app/ API、业务模型、Agent、知识处理与后台任务
|
||
|
|
backend/tests/ 后端测试
|
||
|
|
frontend/src/ 管理后台、客服工作台与嵌入 Widget
|
||
|
|
e2e/ 端到端测试
|
||
|
|
deploy/local/ 本机环境与启停脚本
|
||
|
|
```
|
||
|
|
|
||
|
|
## 本机使用
|
||
|
|
|
||
|
|
在项目根目录执行：
|
||
|
|
|
||
|
|
```bash
|
||
|
|
./deploy/local/local.sh up
|
||
|
|
./deploy/local/local.sh status
|
||
|
|
```
|
||
|
|
|
||
|
|
- [客服工作台](http://127.0.0.1:3018/)
|
||
|
|
- [悬浮客服演示页](http://127.0.0.1:3018/local-demo.html)
|
||
|
|
|
||
|
|
账号、构建、日志、数据恢复及公网接入条件见 [LOCAL_DEPLOY.md](LOCAL_DEPLOY.md)。
|
||
|
|
|
||
|
|
## 开发检查
|
||
|
|
|
||
|
|
- 后端测试位于 `backend/tests/`。
|
||
|
|
- 前端类型检查：在 `frontend/` 执行 `npm run type-check`。
|
||
|
|
- 前端单元测试：在 `frontend/` 执行 `npm run test:unit`。
|
||
|
|
- 端到端测试约定见 [e2e/AUTHORING.md](e2e/AUTHORING.md)。
|
||
|
|
|
||
|
|
## 许可与贡献
|
||
|
|
|
||
|
|
许可条款见 [LICENSE](LICENSE)，声明见 [NOTICE](NOTICE)，贡献约定见 [CONTRIBUTING.md](CONTRIBUTING.md)。
|