# 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)。