agent-resource-management 1.3.0 → 1.4.1

package/dist//344/273/277/347/234/237/350/260/203/350/257/225/345/212/251/346/211/213/knowledges//345/244/251/350/275/246/350/260/203/345/272/246/347/263/273/347/273/237/351/207/215/347/273/204/346/216/245/345/217/243/350/260/203/347/224/250/344/270/216/346/227/245/345/277/227/345/210/206/346/236/220/346/226/271/346/263/225.md

@@ -1,137 +0,0 @@
-# 天车调度系统重组接口调用与日志分析
-
-## 问题背景
-天车调度系统调用重组接口后未生成调度结果，需要通过日志分析定位问题根因。
-
-## 接口信息
-
-### 1. 天车重组接口
-- **地址**: `http://192.168.58.22:8000/dcs_api_v1/world_schedule`
-- **方法**: POST
-- **参数**: 无
-- **返回**: 包含 `trace_id` 用于日志追踪
-
-### 2. 日志查询接口
-- **地址**: `http://192.168.58.22:8000/api/logs/search_trace/{trace_id}`
-- **方法**: GET
-- **参数**: trace_id（从重组接口返回的请求ID）
-
-## 问题分析方法
-
-### 步骤1：调用重组接口
-```bash
-curl -X POST http://192.168.58.22:8000/dcs_api_v1/world_schedule
-```
-
-获取返回的 `trace_id`，例如：`37113fad63f8`
-
-### 步骤2：查询过程日志
-```bash
-curl -X GET http://192.168.58.22:8000/api/logs/search_trace/37113fad63f8
-```
-
-### 步骤3：分析关键日志信息
-在日志中搜索以下关键词：
-
-#### 关键信息1：任务过滤情况
-```
-过滤前X个item,过滤后...
-```
-- 如果显示“过滤后没有任务item”，说明没有可调度的任务
-- 如果显示“过滤后没有isReady为true的任务item”，说明任务存在但未就绪
-
-#### 关键信息2：设备状态
-```
-设备ID, 设备类型, Weight: 当前载重/最大载重, onboard Tasks: 任务列表
-```
-- 检查所有设备是否空闲
-- 确认设备载重情况
-
-#### 关键信息3：移动记录
-```
-设备ID 第X次, 移动记录：[]
-```
-- 如果移动记录为空，说明没有生成调度方案
-
-## 常见问题与解决方案
-
-### 场景1：没有可调度的任务
-**症状**：
-```
-过滤前5个item,过滤后没有设备类型为FA_FLAT_WORK_AREA的任务item
-```
-
-**原因**：
-- 任务类型不匹配（系统只调度特定类型任务）
-- 所有任务已完成或未创建
-
-**解决方案**：
-```sql
--- 1. 检查任务表
-SELECT * FROM overhead_crane_tasks WHERE status = 'pending';
-
--- 2. 检查任务类型
-SELECT * FROM overhead_crane_tasks WHERE device_type = 'FA_FLAT_WORK_AREA';
-
--- 3. 创建测试任务（如需要）
-INSERT INTO overhead_crane_tasks (...) VALUES (...);
-```
-
-### 场景2：任务存在但未就绪（isReady=false）
-**症状**：
-```
-过滤前2个item,过滤后没有isReady为true的任务item
-```
-
-**原因**：
-- 前置条件未满足（如依赖任务未完成）
-- 任务状态异常
-- 时间窗口问题
-
-**解决方案**：
-```sql
--- 1. 查看任务详情
-SELECT * FROM overhead_crane_tasks WHERE is_ready = false;
-
--- 2. 检查任务创建流程
-SELECT * FROM overhead_crane_tasks ORDER BY created_at DESC LIMIT 10;
-
--- 3. 手动设置就绪（谨慎操作）
-UPDATE overhead_crane_tasks SET is_ready = true WHERE id = 'xxx';
-```
-
-### 场景3：所有设备空闲但无调度
-**症状**：
-```
-FA_A_01, DV_A_TC_R, Weight: 0/30000.0, onboard Tasks: None
-FA_A_01, DV_A_TC_L, Weight: 0/25000.0, onboard Tasks: None
-```
-
-**原因**：
-- 系统中确实没有待调度任务
-- 任务已被其他调度实例处理
-
-**解决方案**：
-1. 检查任务创建流程
-2. 确认是否有其他调度实例在运行
-3. 创建新测试任务验证
-
-## 排查清单
-
-- [ ] 调用重组接口并记录 trace_id
-- [ ] 查询日志获取执行过程
-- [ ] 检查任务过滤情况（过滤前/后数量）
-- [ ] 确认设备状态（是否空闲、载重情况）
-- [ ] 查看任务表数据
-- [ ] 检查任务类型是否匹配
-- [ ] 检查任务 isReady 状态
-- [ ] 分析任务创建和状态更新逻辑
-- [ ] 必要时创建测试任务验证
-
-## 最佳实践
-
-1. **保存 trace_id**：每次调用重组接口后保存 trace_id，便于后续追踪
-2. **定期检查日志**：关注“过滤前/后”任务数量变化
-3. **监控设备状态**：确认设备是否正常注册和在线
-4. **任务状态管理**：定期检查任务表，清理异常状态的任务
-5. **版本控制**：记录调度系统的版本变更，便于问题追溯