# OfficeEcho

**Repository Path**: xbmt/officeecho

## Basic Information

- **Project Name**: OfficeEcho
- **Description**: 这是一个针对办公室场景的数字人大屏，使用一台闲置主机及一个竖着挂放的24寸显示器就可以打造出一个，兼顾人机交互、案例管理（展示、上传下载）、办公室监控、日程通知提醒，及三方mcp客户端消息广播的智能交互系统。让每个上门客户都得到回声！
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2026-01-20
- **Last Updated**: 2026-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OfficeEcho (办公回声)

> "让每个上门客户都得到回声"

智能办公接待系统 - 以访客为中心，数字人为媒介，构建的沉浸式客户互动系统。

## 交流群二维码

> ![交流群二维码](README/wechar.png)

## 📸 系统预览

**(截图: 屏幕端主页 - 数字人与功能按钮)**

> *屏幕端运行在竖屏设备上，提供数字人接待、媒体展示和快捷功能入口。*
> ![屏幕端预览](README/visitor.png)

**(截图: 管理端主页 - 手机H5界面)**

> *管理端采用类 App 的 H5 设计，方便管理员随时随地管理内容和响应请求。*
> ![管理端预览](README/admin.png)

## ✨ 核心功能

### 1. 数字人智能接待

* **全语音交互**: 集成 Fay 框架，支持自然语言对话。
* **状态同步**: 实时监控麦克风、WebSocket 连接及系统资源 (CPU/GPU)。
* **闲时自动推荐**: 无人互动时自动播放推荐的企业宣传媒体。

### 2. 智能媒体展示

* **语音唤起**: 访客说 "看看产品介绍"，AI 自动调用 MCP 工具展示对应视频/图片。
* **透明悬浮窗**: 媒体内容通过透明窗口悬浮展示，不遮挡数字人互动。
* **媒体库管理**: 管理员可通过 H5 端上传、标签化管理所有展示素材。

**(截图: 媒体播放界面 / 透明悬浮展示)**

### 3. 接待日程与提醒

* **日程管理**: 管理员设置接待计划（如：会议提醒、参观流程）。
* **智能提醒**: 点自动弹窗并由数字人播报提醒。
* **推迟/完成**: 访客可在屏幕端操作确认或推迟日程。

**(截图: 日程提醒弹窗)**

### 4. 实时呼叫管理员

* **一键呼叫**: 访客点击按钮即可发送通知给管理员。
* **多级告警**: 支持普通联系与紧急求助，管理端实时收到推送。

**(截图: 呼叫管理员确认界面)**

## 🚀 快速开始

### 0. 环境变量配置

在项目根目录复制一份配置文件并按需修改：

```bash
# Windows
copy .env.example .env

# macOS / Linux
cp .env.example .env
```

主要配置项（按需填写）：

* `FAY_HTTP_URL`：后端连接 Fay 的 HTTP 地址
* `VITE_FAY_WEBSOCKET_URL`：前端连接 Fay 的 WebSocket 地址
* `VITE_FAY_HTTP_URL`：前端连接 Fay 的 HTTP 地址
* `VITE_XMOV_APP_ID` / `VITE_XMOV_APP_SECRET`：Xmov SDK 凭证
* `VITE_XMOV_GATEWAY_SERVER`：Xmov 网关地址
  
  注：Xmov sdk 凭证的获取可以请进入官网https://c.c1nd.cn/9C9WW，暂时凭邀请码 JUCAEKF55F 注册可以免费试用

### 1. 启动后端服务

```bash
cd server
python app.py
# 服务运行在 :8000
```

### 2. 启动前端应用

```bash
# 同时启动屏幕端(visitor)和管理端(admin)
npm run dev

# 屏幕端访问: http://localhost:3001/visitor.html
# 管理端访问: http://localhost:3001/admin.html
```

### 3. 集成 Fay 数字人

Fay 仓库地址: https://github.com/xszyou/fay

确保 Fay 控制器已启动 (:5000)，OfficeEcho 会自动连接：

* **MCP 集成**: 已配置 `OfficeEcho` MCP Server，支持 AI 调用系统能力。
* **透传接口**: 数字人通过 `/transparent-pass` 接口接收指令。

## 🛠️ 技术栈

* **屏幕端**: React 18, TypeScript, TailwindCSS, Electron (支持 Kiosk 模式)
* **管理端**: React 18 (Mobile H5 Layout)
* **服务端**: Python Flask, SQLite, Socket.IO
* **AI/驱动**: Fay Framework, Xmov SDK, MCP Protocol

## 📂 目录结构

* `src/elderly`: 屏幕端代码 (Visitor UI)
* `src/admin`: 管端代码 (Admin UI)
* `server`: 后端 API 与数据库
* `mcp_server`: MCP 服务端实现

---

License: GLP3.0