# Dependencies / 外部依赖

## 核心依赖

| 包 | 版本 | 用途 |
|---|---|---|
| flask | 3.0.3 | Web 框架 |
| flask-cors | 5.0.0 | 跨域支持 |
| sqlalchemy | 2.0.32 | ORM |
| pymysql | 1.1.1 | MySQL 驱动 |
| websockets | 15.0.1 | WebSocket 服务器 |
| redis | 5.0.1 | 缓存客户端 |
| hiredis | 2.3.2 | Redis 高性能解析器 |

## LLM / NLP

| 包 | 版本 | 用途 |
|---|---|---|
| jieba | 0.42.1 | 中文分词 |
| scikit-learn | 1.4.2 | TF-IDF 向量化 |
| numpy | 1.26.4 | 数值计算 |

## 飞书集成

| 包 | 版本 | 用途 |
|---|---|---|
| lark-oapi | 1.3.5 | 飞书 SDK（事件订阅 2.0，长连接模式） |

## 数据处理

| 包 | 版本 | 用途 |
|---|---|---|
| pandas | 2.2.2 | 数据分析 |
| openpyxl | 3.1.5 | Excel 读写 |
| ujson | 5.10.0 | 高性能 JSON |

## 安全 / 认证

| 包 | 版本 | 用途 |
|---|---|---|
| pyjwt | 2.9.0 | JWT token |
| bcrypt | 4.2.1 | 密码哈希 |
| cryptography | 43.0.1 | 加密支持 |

## 数据验证

| 包 | 版本 | 用途 |
|---|---|---|
| pydantic | 2.9.2 | 数据验证 |
| marshmallow | 3.23.3 | 序列化/反序列化 |

## 监控 / 工具

| 包 | 版本 | 用途 |
|---|---|---|
| psutil | 5.9.8 | 系统监控 |
| python-dotenv | 1.0.1 | 环境变量加载 |
| structlog | 24.4.0 | 结构化日志 |
| aiohttp | 3.10.10 | 异步 HTTP |
| httpx | 0.27.2 | HTTP 客户端 |

## 可选依赖

| 包 | 用途 | 条件 |
|---|---|---|
| sentence-transformers | 本地 Embedding 模型 | `EMBEDDING_ENABLED=True` |
| torch | PyTorch（sentence-transformers 依赖） | `EMBEDDING_ENABLED=True` |

## 开发依赖

| 包 | 版本 | 用途 |
|---|---|---|
| pytest | 8.3.3 | 测试框架 |
| pytest-asyncio | 0.24.0 | 异步测试 |
| pytest-cov | 6.0.0 | 覆盖率 |
| black | 24.8.0 | 代码格式化 |
| flake8 | 7.1.1 | Linting |
| mypy | 1.11.1 | 类型检查 |
| isort | 5.13.2 | Import 排序 |

## 外部服务依赖

```mermaid
graph LR
    App["TSP Assistant"] --> Qwen["Qwen/DashScope API"]
    App --> FeishuAPI["飞书 Open API"]
    App --> Redis["Redis Server"]
    App --> DB["MySQL / SQLite"]
    App --> HF["HuggingFace (可选, 首次下载模型)"]
```