2026-10-22 18:13:46 +08:00
|
|
|
|
<div align="center">
|
2026-10-22 18:40:26 +08:00
|
|
|
|
<img src="frontend/src/assets/logo.svg" width="64" height="48" alt="ReplyPier 纸舟标志" />
|
2026-10-22 18:13:46 +08:00
|
|
|
|
<h1>ReplyPier</h1>
|
|
|
|
|
|
<p><strong>AI 先答疑，人工接得住；一段会话，服务有始有终。</strong></p>
|
2026-10-22 18:40:26 +08:00
|
|
|
|
<p>面向个人与公司网站的 AI 客服，把知识问答、人工协作和服务评价连在一起。</p>
|
2026-10-22 18:13:46 +08:00
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
<a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache--2.0-2E6A5C?style=flat-square&logo=apache&logoColor=white" alt="Apache 2.0 License" /></a>
|
|
|
|
|
|
<a href="backend/requirements.txt"><img src="https://img.shields.io/badge/Python-FastAPI-2E6A5C?style=flat-square&logo=fastapi&logoColor=white" alt="Python and FastAPI" /></a>
|
|
|
|
|
|
<a href="frontend/package.json"><img src="https://img.shields.io/badge/Vue_3-TypeScript-568B73?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3 and TypeScript" /></a>
|
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
<a href="#产品预览">产品预览</a> ·
|
|
|
|
|
|
<a href="#核心能力">核心能力</a> ·
|
|
|
|
|
|
<a href="#本机使用">本机使用</a> ·
|
|
|
|
|
|
<a href="#技术结构">技术结构</a> ·
|
|
|
|
|
|
<a href="AGENT_HANDOFF.md">开发指引</a>
|
|
|
|
|
|
</p>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
## 产品预览
|
|
|
|
|
|
|
2026-10-22 18:40:26 +08:00
|
|
|
|
先在工作台调整客服外观，再看右侧即时预览；访客侧窗口使用纸舟标志展示同一段对话。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<p align="center"><strong>访客看到的聊天窗口</strong></p>
|
2026-10-22 18:13:46 +08:00
|
|
|
|
|
|
|
|
|
|
<p align="center">
|
2026-10-22 18:40:26 +08:00
|
|
|
|
<img src=".github/readme-assets/replypier-visitor-chat.png" width="480" alt="ReplyPier 网站客服聊天窗口，纸舟标志显示在客服头像与页脚图标处" />
|
2026-10-22 18:13:46 +08:00
|
|
|
|
</p>
|
|
|
|
|
|
|
2026-10-21 21:40:00 +08:00
|
|
|
|
## 核心能力
|
|
|
|
|
|
|
2026-10-22 18:40:26 +08:00
|
|
|
|
- **知识库问答**：为 AI 客服关联知识资料，并在 Widget 中展示回答来源。
|
|
|
|
|
|
- **同会话转人工**：保留聊天上下文，支持客服组接待、人工接管与授权转交。
|
|
|
|
|
|
- **评价与回看**：收集星级和文字反馈，管理员可查看完整会话与接待情况。
|
|
|
|
|
|
- **多客服协作**：按角色、组织、分组和会话可见范围控制访问。
|
|
|
|
|
|
- **可配置 Agent 与 Widget**：管理 AI 客服、知识关联、外观和网站嵌入。
|
|
|
|
|
|
- **知识任务与工作流**：处理知识导入，并编排客服消息处理步骤。
|
2026-10-21 21:40:00 +08:00
|
|
|
|
|
|
|
|
|
|
## 技术结构
|
|
|
|
|
|
|
2026-10-22 18:13:46 +08:00
|
|
|
|
- **后端**：Python、FastAPI、SQLAlchemy、Alembic。
|
|
|
|
|
|
- **前端**：Vue 3、TypeScript、Vite。
|
|
|
|
|
|
- **实时通信**：Socket.IO。
|
|
|
|
|
|
- **知识检索**：FastEmbed、PostgreSQL/pgvector。
|
|
|
|
|
|
- **短期状态与事件分发**：Redis。
|
|
|
|
|
|
- **AI 编排**：Agno。
|
2026-10-21 21:40:00 +08:00
|
|
|
|
|
|
|
|
|
|
```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)。
|
|
|
|
|
|
|
|
|
|
|
|
## 许可与贡献
|
|
|
|
|
|
|
2026-10-22 18:13:46 +08:00
|
|
|
|
本项目使用 [Apache License 2.0](LICENSE)，声明见 [NOTICE](NOTICE)，贡献约定见 [CONTRIBUTING.md](CONTRIBUTING.md)。
|
