feat: 重大功能更新 v1.4.0 - 飞书集成、AI语义相似度、前端优化
主要更新内容: - 🚀 飞书多维表格集成，支持工单数据同步 - 🤖 AI建议与人工描述语义相似度计算 - 🎨 前端UI全面优化，现代化设计 - 📊 智能知识库入库策略（AI准确率<90%使用人工描述） - 🔧 代码重构，模块化架构优化 - 📚 完整文档整合和更新 - 🐛 修复配置导入和数据库字段问题 技术特性: - 使用sentence-transformers进行语义相似度计算 - 快速模式结合TF-IDF和语义方法 - 响应式设计，支持移动端 - 加载状态和动画效果 - 配置化AI准确率阈值
This commit is contained in:
赵杰 Jie Zhao （雄狮汽车科技）
243
新功能说明_v1.4.0.md
Normal file
243
新功能说明_v1.4.0.md
Normal file
@@ -0,0 +1,243 @@
|
||||
# TSP智能助手 v1.4.0 新功能说明
|
||||
|
||||
## 🎉 版本概述
|
||||
|
||||
TSP智能助手 v1.4.0 是一个重要的功能更新版本，主要包含飞书集成、页面功能合并、数据库架构优化和代码重构等重要改进。
|
||||
|
||||
## 🚀 主要新功能
|
||||
|
||||
### 1. 飞书多维表格集成 📱
|
||||
|
||||
#### 功能描述
|
||||
- **数据同步**: 支持从飞书多维表格自动同步工单数据
|
||||
- **字段映射**: 智能映射飞书字段到本地数据库结构
|
||||
- **实时更新**: 支持增量同步和全量同步
|
||||
- **数据预览**: 同步前可预览数据，确保准确性
|
||||
|
||||
#### 支持的飞书字段
|
||||
| 飞书字段 | 本地字段 | 类型 | 说明 |
|
||||
|---------|---------|------|------|
|
||||
| TR Number | order_id | String | 工单编号 |
|
||||
| TR Description | description | Text | 工单描述 |
|
||||
| Type of problem | category | String | 问题类型 |
|
||||
| TR Level | priority | String | 优先级 |
|
||||
| TR Status | status | String | 工单状态 |
|
||||
| Source | source | String | 来源 |
|
||||
| Created by | created_by | String | 创建人 |
|
||||
| Module（模块） | module | String | 模块 |
|
||||
| Wilfulness（责任人） | wilfulness | String | 责任人 |
|
||||
| Date of close TR | date_of_close | DateTime | 关闭日期 |
|
||||
| Vehicle Type01 | vehicle_type | String | 车型 |
|
||||
| VIN\|sim | vin_sim | String | 车架号/SIM |
|
||||
| App remote control version | app_remote_control_version | String | 应用远程控制版本 |
|
||||
| HMI SW | hmi_sw | String | HMI软件版本 |
|
||||
| 父记录 | parent_record | String | 父记录 |
|
||||
| Has it been updated on the same day | has_updated_same_day | String | 是否同日更新 |
|
||||
| Operating time | operating_time | String | 操作时间 |
|
||||
|
||||
#### 使用方法
|
||||
1. 在飞书开放平台创建企业自建应用
|
||||
2. 配置 `config/integrations_config.json` 文件
|
||||
3. 在主仪表板的"飞书同步"标签页进行数据同步
|
||||
4. 支持测试连接、预览数据、执行同步等操作
|
||||
|
||||
### 2. 页面功能合并 🎨
|
||||
|
||||
#### 改进内容
|
||||
- **统一界面**: 飞书同步功能已合并到主仪表板
|
||||
- **标签页设计**: 使用标签页组织不同功能模块
|
||||
- **用户体验**: 所有功能现在都在一个统一的界面中
|
||||
- **代码优化**: 删除了冗余的独立页面和蓝图
|
||||
|
||||
#### 界面变化
|
||||
- **原独立页面**: `http://localhost:5000/feishu-sync` (已删除)
|
||||
- **现集成位置**: 主仪表板的"飞书同步"标签页
|
||||
- **访问方式**: 访问 `http://localhost:5000` 即可使用所有功能
|
||||
|
||||
### 3. 数据库架构优化 🗄️
|
||||
|
||||
#### 工单表扩展
|
||||
为 `work_orders` 表新增了12个飞书相关字段：
|
||||
|
||||
```sql
|
||||
-- 飞书集成字段
|
||||
source VARCHAR(50) -- 来源
|
||||
module VARCHAR(100) -- 模块
|
||||
created_by VARCHAR(100) -- 创建人
|
||||
wilfulness VARCHAR(100) -- 责任人
|
||||
date_of_close DATETIME -- 关闭日期
|
||||
vehicle_type VARCHAR(100) -- 车型
|
||||
vin_sim VARCHAR(50) -- 车架号/SIM
|
||||
app_remote_control_version VARCHAR(100) -- 应用远程控制版本
|
||||
hmi_sw VARCHAR(100) -- HMI软件版本
|
||||
parent_record VARCHAR(100) -- 父记录
|
||||
has_updated_same_day VARCHAR(50) -- 是否同日更新
|
||||
operating_time VARCHAR(100) -- 操作时间
|
||||
```
|
||||
|
||||
#### 数据库初始化改进
|
||||
- **自动迁移**: 字段迁移已集成到数据库初始化流程
|
||||
- **智能检测**: 自动检测缺失字段并添加
|
||||
- **错误处理**: 改进的错误处理和日志记录
|
||||
- **兼容性**: 保持与现有数据的兼容性
|
||||
|
||||
### 4. 代码重构优化 🔧
|
||||
|
||||
#### 文件结构优化
|
||||
- **大文件拆分**: 将 `src/agent_assistant.py` 拆分为多个模块
|
||||
- **模块化设计**: 创建 `agent_assistant_core.py`、`agent_message_handler.py`、`agent_sample_actions.py`
|
||||
- **降低风险**: 减少单文件代码行数，降低运行风险
|
||||
- **维护性**: 提高代码的可维护性和可读性
|
||||
|
||||
#### 前端架构改进
|
||||
- **JavaScript类**: 使用类组织前端逻辑
|
||||
- **模块化**: `TSPDashboard`、`FeishuSyncManager` 等独立模块
|
||||
- **异步处理**: 改进的异步API调用处理
|
||||
- **错误处理**: 更好的错误处理和用户反馈
|
||||
|
||||
## 📋 配置说明
|
||||
|
||||
### 飞书集成配置
|
||||
|
||||
编辑 `config/integrations_config.json` 文件：
|
||||
|
||||
```json
|
||||
{
|
||||
"feishu": {
|
||||
"app_id": "cli_a8b50ec0eed1500d",
|
||||
"app_secret": "ccxkE7ZCFQZcwkkM1rLy0ccZRXYsT2xK",
|
||||
"app_token": "XXnEbiCmEaMblSs6FDJcFCqsnIg",
|
||||
"table_id": "tblnl3vJPpgMTSiP",
|
||||
"last_updated": "2025-09-19T18:27:40.579958",
|
||||
"status": "active"
|
||||
},
|
||||
"system": {
|
||||
"sync_limit": 10,
|
||||
"ai_suggestions_enabled": true,
|
||||
"auto_sync_interval": 0,
|
||||
"last_sync_time": null
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 环境变量支持
|
||||
|
||||
```bash
|
||||
# 飞书配置
|
||||
export FEISHU_APP_ID="your-app-id"
|
||||
export FEISHU_APP_SECRET="your-app-secret"
|
||||
export FEISHU_APP_TOKEN="your-app-token"
|
||||
export FEISHU_TABLE_ID="your-table-id"
|
||||
```
|
||||
|
||||
## 🚀 部署指南
|
||||
|
||||
### 部署前准备
|
||||
|
||||
1. **配置飞书应用**
|
||||
- 在飞书开放平台创建企业自建应用
|
||||
- 获取应用凭证和权限
|
||||
|
||||
2. **更新配置文件**
|
||||
- 配置 `config/integrations_config.json`
|
||||
- 设置正确的飞书应用信息
|
||||
|
||||
3. **初始化数据库**
|
||||
```bash
|
||||
python init_database.py
|
||||
```
|
||||
|
||||
4. **测试连接**
|
||||
- 启动服务后访问主仪表板
|
||||
- 在"飞书同步"标签页测试连接
|
||||
|
||||
### 部署步骤
|
||||
|
||||
```bash
|
||||
# 1. 备份当前版本
|
||||
python scripts/update_manager.py create-backup --environment production
|
||||
|
||||
# 2. 部署新版本
|
||||
python scripts/update_manager.py auto-update --source . --environment production
|
||||
|
||||
# 3. 验证功能
|
||||
# 访问 http://localhost:5000
|
||||
# 测试飞书同步功能
|
||||
```
|
||||
|
||||
## 🔍 使用指南
|
||||
|
||||
### 飞书数据同步
|
||||
|
||||
1. **访问功能**
|
||||
- 打开浏览器访问 `http://localhost:5000`
|
||||
- 点击"飞书同步"标签页
|
||||
|
||||
2. **测试连接**
|
||||
- 点击"测试连接"按钮
|
||||
- 验证飞书应用配置是否正确
|
||||
|
||||
3. **预览数据**
|
||||
- 点击"预览数据"按钮
|
||||
- 查看将要同步的数据内容
|
||||
|
||||
4. **执行同步**
|
||||
- 点击"同步数据"按钮
|
||||
- 等待同步完成
|
||||
|
||||
5. **查看结果**
|
||||
- 在工单管理页面查看同步的数据
|
||||
- 验证字段映射是否正确
|
||||
|
||||
### 工单管理增强
|
||||
|
||||
1. **查看飞书字段**
|
||||
- 在工单详情页面可以看到新的飞书字段
|
||||
- 包括来源、模块、责任人等信息
|
||||
|
||||
2. **数据关联**
|
||||
- 飞书数据与本地工单数据关联
|
||||
- 支持双向数据同步
|
||||
|
||||
## 🐛 故障排除
|
||||
|
||||
### 常见问题
|
||||
|
||||
1. **飞书连接失败**
|
||||
- 检查app_id和app_secret是否正确
|
||||
- 验证应用权限配置
|
||||
- 确认网络连接正常
|
||||
|
||||
2. **字段映射错误**
|
||||
- 检查飞书表格字段名称
|
||||
- 验证字段映射配置
|
||||
- 查看同步日志
|
||||
|
||||
3. **数据库迁移失败**
|
||||
- 检查数据库连接状态
|
||||
- 验证数据库权限
|
||||
- 查看初始化日志
|
||||
|
||||
4. **页面功能异常**
|
||||
- 清除浏览器缓存
|
||||
- 检查JavaScript控制台错误
|
||||
- 验证API接口状态
|
||||
|
||||
### 日志位置
|
||||
|
||||
- **应用日志**: `logs/tsp_assistant.log`
|
||||
- **数据库日志**: 数据库初始化输出
|
||||
- **飞书同步日志**: 在同步界面显示
|
||||
|
||||
## 📞 技术支持
|
||||
|
||||
如有问题，请：
|
||||
|
||||
1. 查看相关日志文件
|
||||
2. 检查配置文件设置
|
||||
3. 验证网络连接状态
|
||||
4. 联系技术支持团队
|
||||
|
||||
---
|
||||
|
||||
**TSP智能助手 v1.4.0** - 让车辆服务更智能，让数据管理更便捷！ 🚗✨
|
||||
Reference in New Issue
Block a user