Version: 0.7.4.dev.260323

✨ feat(schedulerefine): 新增 refine 子路由，优先执行复合操作，失败后降级至禁复合 ReAct 兜底 ReAct 升级 - ♻️ 将原有链路升级为真正的 ReAct 执行模式，进一步增强整体调度过程的可靠性 Refine 子路由 - 🧭 在 refine 主链路中新增 `route` 节点，整体流程调整为 `contract -> plan -> slice -> route -> react -> hard_check -> summary` - ⚡ 当 `route` 命中全局复合目标时，优先尝试一次调用 `SpreadEven` / `MinContextSwitch`，失败后最多重试 2 次 - 🔀 `route` 成功后直接跳过 `ReAct`；若执行失败，则自动切换至 `fallback` 模式 - 🛡️ 在 `fallback` 模式下增加后端硬约束：禁用 `SpreadEven` / `MinContextSwitch` / `BatchMove`，仅允许使用 `Move` / `Swap` 逐任务处理 - 🧠 在 `ReAct` 的 prompt 与上下文中新增 `COMPOSITE_TOOLS_ALLOWED`，显式告知当前是否允许使用复合工具 - 🧩 扩展状态字段以承载路由与降级状态：`CompositeRetryMax` / `DisableCompositeTools` / `CompositeRouteTried` / `CompositeRouteSucceeded` - 👀 增加 `route` 相关阶段日志，便于排查命中、重试、收口与降级原因修复 - 🐛 修复 JWT Token 过期时间未按 `config.yaml` 配置生效的问题备注 - 🚧 当前 ReAct 逐步微排链路已趋于稳定，但两个复合操作函数仍未恢复可用，后续将继续排查
2026-03-23 23:14:19 +08:00
parent 525a8b32cb
commit e6941f98f2
13 changed files with 4924 additions and 1080 deletions
--- a/backend/agent/schedulerefine/composite_tools_test.go
+++ b/backend/agent/schedulerefine/composite_tools_test.go
@@ -0,0 +1,117 @@
+package schedulerefine
+
+import (
+	"sort"
+	"testing"
+
+	"github.com/LoveLosita/smartflow/backend/model"
+)
+
+func TestRefineToolSpreadEvenSuccess(t *testing.T) {
+	entries := []model.HybridScheduleEntry{
+		{TaskItemID: 1, Name: "任务1", Type: "task", Status: "suggested", Week: 16, DayOfWeek: 1, SectionFrom: 1, SectionTo: 2, ContextTag: "A"},
+		{TaskItemID: 2, Name: "任务2", Type: "task", Status: "suggested", Week: 16, DayOfWeek: 1, SectionFrom: 3, SectionTo: 4, ContextTag: "B"},
+		{TaskItemID: 99, Name: "课程", Type: "course", Status: "existing", Week: 12, DayOfWeek: 1, SectionFrom: 5, SectionTo: 6, BlockForSuggested: true},
+	}
+	params := map[string]any{
+		"task_item_ids": []any{1.0, 2.0},
+		"week":          12,
+		"day_of_week":   []any{1.0, 2.0, 3.0},
+		"allow_embed":   false,
+	}
+	policy := refineToolPolicy{OriginOrderMap: map[int]int{1: 1, 2: 2}}
+
+	nextEntries, result := refineToolSpreadEven(entries, params, planningWindow{Enabled: false}, policy)
+	if !result.Success {
+		t.Fatalf("SpreadEven 执行失败: %s", result.Result)
+	}
+	if result.Tool != "SpreadEven" {
+		t.Fatalf("工具名错误，期望 SpreadEven，实际=%s", result.Tool)
+	}
+
+	idx1 := findSuggestedByID(nextEntries, 1)
+	idx2 := findSuggestedByID(nextEntries, 2)
+	if idx1 < 0 || idx2 < 0 {
+		t.Fatalf("移动后未找到目标任务: idx1=%d idx2=%d", idx1, idx2)
+	}
+	task1 := nextEntries[idx1]
+	task2 := nextEntries[idx2]
+	if task1.Week != 12 || task2.Week != 12 {
+		t.Fatalf("期望任务被移动到 W12，实际 task1=%d task2=%d", task1.Week, task2.Week)
+	}
+	if task1.DayOfWeek < 1 || task1.DayOfWeek > 3 || task2.DayOfWeek < 1 || task2.DayOfWeek > 3 {
+		t.Fatalf("期望任务被移动到周一到周三，实际 task1=%d task2=%d", task1.DayOfWeek, task2.DayOfWeek)
+	}
+	if task1.DayOfWeek == task2.DayOfWeek && sectionsOverlap(task1.SectionFrom, task1.SectionTo, task2.SectionFrom, task2.SectionTo) {
+		t.Fatalf("复合工具不应产出重叠坑位: task1=%+v task2=%+v", task1, task2)
+	}
+}
+
+func TestRefineToolMinContextSwitchGroupsContext(t *testing.T) {
+	entries := []model.HybridScheduleEntry{
+		{TaskItemID: 11, Name: "任务11", Type: "task", Status: "suggested", Week: 16, DayOfWeek: 1, SectionFrom: 1, SectionTo: 2, ContextTag: "数学"},
+		{TaskItemID: 12, Name: "任务12", Type: "task", Status: "suggested", Week: 16, DayOfWeek: 1, SectionFrom: 3, SectionTo: 4, ContextTag: "算法"},
+		{TaskItemID: 13, Name: "任务13", Type: "task", Status: "suggested", Week: 16, DayOfWeek: 1, SectionFrom: 5, SectionTo: 6, ContextTag: "数学"},
+		{TaskItemID: 99, Name: "课程", Type: "course", Status: "existing", Week: 12, DayOfWeek: 1, SectionFrom: 11, SectionTo: 12, BlockForSuggested: true},
+	}
+	params := map[string]any{
+		"task_item_ids": []any{11.0, 12.0, 13.0},
+		"week":          12,
+		"day_of_week":   []any{1.0},
+	}
+	policy := refineToolPolicy{OriginOrderMap: map[int]int{11: 1, 12: 2, 13: 3}}
+
+	nextEntries, result := refineToolMinContextSwitch(entries, params, planningWindow{Enabled: false}, policy)
+	if !result.Success {
+		t.Fatalf("MinContextSwitch 执行失败: %s", result.Result)
+	}
+	if result.Tool != "MinContextSwitch" {
+		t.Fatalf("工具名错误，期望 MinContextSwitch，实际=%s", result.Tool)
+	}
+
+	selected := make([]model.HybridScheduleEntry, 0, 3)
+	for _, id := range []int{11, 12, 13} {
+		idx := findSuggestedByID(nextEntries, id)
+		if idx < 0 {
+			t.Fatalf("未找到任务 id=%d", id)
+		}
+		selected = append(selected, nextEntries[idx])
+	}
+	sort.SliceStable(selected, func(i, j int) bool {
+		if selected[i].Week != selected[j].Week {
+			return selected[i].Week < selected[j].Week
+		}
+		if selected[i].DayOfWeek != selected[j].DayOfWeek {
+			return selected[i].DayOfWeek < selected[j].DayOfWeek
+		}
+		return selected[i].SectionFrom < selected[j].SectionFrom
+	})
+
+	switches := 0
+	for i := 1; i < len(selected); i++ {
+		if selected[i].ContextTag != selected[i-1].ContextTag {
+			switches++
+		}
+	}
+	if switches > 1 {
+		t.Fatalf("期望最少上下文切换（<=1），实际 switches=%d, tasks=%+v", switches, selected)
+	}
+}
+
+func TestListTaskIDsFromToolCallComposite(t *testing.T) {
+	call := reactToolCall{
+		Tool: "SpreadEven",
+		Params: map[string]any{
+			"task_item_ids": []any{1.0, 2.0, 2.0},
+			"task_item_id":  3,
+		},
+	}
+	ids := listTaskIDsFromToolCall(call)
+	if len(ids) != 3 {
+		t.Fatalf("期望提取 3 个去重 ID，实际=%v", ids)
+	}
+	sort.Ints(ids)
+	if ids[0] != 1 || ids[1] != 2 || ids[2] != 3 {
+		t.Fatalf("提取结果错误，实际=%v", ids)
+	}
+}