Files

zhaojie 11eef49271 docs: 添加项目文档体系 + 修复租户创建模态框

- 新增 .agents/summary/ 完整文档（架构、组件、接口、数据模型、流程、依赖）
- 新增 AGENTS.md（AI 助手导航）
- 更新 README.md
- 修复 dashboard.html 租户模态框多余 </div> 导致保存按钮失效
- 更新 .gitignore 排除虚拟环境文件

2026-04-08 23:26:17 +08:00

2.1 KiB

Raw Blame History

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 排序

外部服务依赖

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

2.1 KiB Raw Blame History Unescape Escape

Dependencies / 外部依赖

核心依赖

LLM / NLP

飞书集成

数据处理

安全 / 认证

数据验证

监控 / 工具

可选依赖

开发依赖

外部服务依赖

2.1 KiB

Raw Blame History