assist/README.md

TSP 智能助手

AI 驱动的多租户客服与工单管理系统，支持飞书机器人、WebSocket 实时对话、知识库语义搜索。

功能概览

• 智能对话 — WebSocket 实时聊天 + 飞书机器人（长连接模式），按租户隔离知识库
• 工单管理 — 创建、编辑、删除、飞书多维表格双向同步，AI 生成处理建议
• 知识库 — TF-IDF + 可选 Embedding 语义搜索，支持文件导入、人工验证
• 多租户 — 数据按 tenant_id 隔离，每个租户独立的系统提示词和飞书群绑定
• 数据分析 — 工单趋势、预警统计、满意度分析，支持按租户筛选
• 预警系统 — 自定义规则、多级别预警、批量管理
• 系统管理 — 模块权限控制、流量/成本/安全配置、Token 监控

快速开始

pip install -r requirements.txt
cp .env.example .env   # 编辑填入 LLM API Key、飞书凭证等
python init_database.py
python start_dashboard.py

访问 http://localhost:5000，默认账号 admin / admin123。

项目结构

src/
├── config/              # 配置管理（unified_config + config_service）
├── core/                # 基础设施（数据库、LLM、缓存、认证）
├── dialogue/            # 对话管理（realtime_chat、message_pipeline）
├── knowledge_base/      # 知识库（搜索、导入、验证）
├── repositories/        # 数据访问层（自动 tenant_id 过滤）
├── analytics/           # 监控与分析（预警、Token、AI 成功率）
├── integrations/        # 外部集成（飞书客户端、工单同步）
├── agent/               # ReAct Agent（工具调度）
└── web/                 # Web 层
    ├── app.py           # Flask 应用
    ├── blueprints/      # API 蓝图（每个领域一个文件）
    ├── service_manager.py
    ├── static/js/       # 前端模块
    │   ├── dashboard.js # 核心
    │   └── modules/     # 功能模块
    └── templates/       # Jinja2 模板

环境变量

变量	说明	默认值
SECRET_KEY	Flask session 密钥	随机生成
LLM_BASE_URL	LLM API 地址	DashScope
LLM_API_KEY	LLM API 密钥	-
LLM_MODEL	模型名称	qwen-plus-latest
FEISHU_APP_ID	飞书应用 ID	-
FEISHU_APP_SECRET	飞书应用密钥	-
REDIS_HOST	Redis 地址	localhost
ADMIN_PASSWORD	默认管理员密码	admin123

完整变量列表见 .env.example。