zhaojie
11eef49271
- 新增 .agents/summary/ 完整文档（架构、组件、接口、数据模型、流程、依赖） - 新增 AGENTS.md（AI 助手导航） - 更新 README.md - 修复 dashboard.html 租户模态框多余 </div> 导致保存按钮失效 - 更新 .gitignore 排除虚拟环境文件
91 lines
2.1 KiB
Markdown
91 lines
2.1 KiB
Markdown
# 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 (可选, 首次下载模型)"]
|
||
```
|