Version: 0.7.5.dev.260324

🐛 fix(agent/schedulerefine): 修复复合微调分支链路问题，并将 MinContextSwitch 重构为固定坑位重排语义

- 🔧 修复 `schedulerefine` 复合路由中参数透传不完整、缺少 deterministic objective 时错误降级，以及“复合工具执行成功”与“终审通过”语义混淆的问题
- ✅ 保证新的独立复合分支能够正确执行、正确出站，并统一交由 `hard_check` 裁决最终结果
- 🔍 排查时发现 `MinContextSwitch` 上游 `context_tag` 存在整体退化为 `General` 的风险，影响MinContextSwitch
- 🛡️ 为 `MinContextSwitch` 增加兜底策略：当标签整体退化时，按任务名关键词推断学科分组，避免分组能力失效
- ♻️ 将 `MinContextSwitch` 从“整周重新寻找新坑位”调整为“坑位不变，任务顺序改变”
- 🎯 将落地方式从顺序 `BatchMove` 改为固定坑位原子重写，避免出现远距离跳位、跨天错迁、异常嵌入课位及循环换位冲突
- 🧹 修复 `hard_check` 在 `MinContextSwitch` 成功后仍执行 `origin_rank` 顺序归位、并导致逆序终审误判的问题
- 🚦 命中该分支后跳过顺序归位与顺序硬校验，避免 `summary` / `hard_check` 将有效重排结果误判为失败

📈 当前连续微调规划涉及的全部功能已可以稳定运行；下一步将继续扩展能力边界，并进一步优化 `schedule_plan` 流程

♻️ refactor: 重整 agent2 架构，并迁移 quicknote/chat 新链路，目前还剩3个模块未迁移，后续迁移完成后会删除原agent并将此目录命名为agent

- 🏗️ 明确 `agent2` 采用“统一分层目录 + 文件分层 + 依赖注入”的重构方案，不再沿用模块目录多层嵌套结构
- 🧩 完善 `agent2` 基础骨架，统一收口 `entrance` / `router` / `llm` / `stream` / `shared` / `model` / `prompt` / `node` / `graph` 等层级职责
- 🚚 将通用路由能力迁移至 `agent2/router`，沉淀统一的 `Action`、`RoutingDecision`、控制码解析，以及 `Dispatcher` / `Resolver` 抽象
- 💬 将普通聊天链路迁移至 `agent2/chat`，复用 `stream` 的 OpenAI 兼容输出协议与 LLM usage 聚合能力
- 📝 将 `quicknote` 链路迁移到 `agent2` 新结构，拆分为 `model` / `prompt` / `llm` / `node` / `graph` 多层实现，替换对旧 `agent/quicknote` 的直接依赖
- 🔌 调整 `agentsvc` 对 `agent2` 的引用，普通聊天、通用分流与 `quicknote` 全部切换到新链路
- ✂️ 去除 graph 内部 `runner` 转接层，改为由 node 层直接持有请求级依赖，并向 graph 暴露节点方法
- 🧹 合并 `graph/quicknote` 与 `graph/quicknote_run`，删除冗余骨架文件，收敛为单一 `quicknote graph` 文件
- 📚 新增 `agent2`《通用能力接入文档》，明确公共能力边界、接入方式以及 graph/node 协作约定
- 📝 更新 `AGENTS.md`，要求后续扩展 `agent2` 通用能力时必须同步维护接入文档

♻️ refactor: 删除了现Agent目录内Chat模块的两条冗余Prompt

backend/agent/schedulerefine/composite_route_test.go

@@ -0,0 +1,85 @@
+package schedulerefine
+
+import (
+	"context"
+	"testing"
+
+	"github.com/LoveLosita/smartflow/backend/model"
+)
+
+func TestRefineToolSpreadEvenRespectsCanonicalRouteFilters(t *testing.T) {
+	entries := []model.HybridScheduleEntry{
+		{TaskItemID: 1, Name: "任务1", Type: "task", Status: "suggested", Week: 16, DayOfWeek: 1, SectionFrom: 1, SectionTo: 2, ContextTag: "A"},
+		// 1. 这里放一个更早周次的 existing 条目，用来把可查询窗口拉到 W11；
+		// 2. 若复合工具内部丢了 week_filter/day_of_week，就会优先落到更早的 W11D1，而不是目标 W12D3。
+		{TaskItemID: 99, Name: "课程", Type: "course", Status: "existing", Week: 11, DayOfWeek: 5, SectionFrom: 11, SectionTo: 12, BlockForSuggested: true},
+	}
+	params := map[string]any{
+		"task_item_ids": []int{1},
+		"week_filter":   []int{12},
+		"day_of_week":   []int{3},
+		"allow_embed":   false,
+	}
+
+	nextEntries, result := refineToolSpreadEven(entries, params, planningWindow{Enabled: false}, refineToolPolicy{
+		OriginOrderMap: map[int]int{1: 1},
+	})
+	if !result.Success {
+		t.Fatalf("SpreadEven 执行失败: %s", result.Result)
+	}
+
+	idx := findSuggestedByID(nextEntries, 1)
+	if idx < 0 {
+		t.Fatalf("未找到 task_item_id=1")
+	}
+	got := nextEntries[idx]
+	if got.Week != 12 || got.DayOfWeek != 3 {
+		t.Fatalf("期望复合工具严格遵守 week_filter/day_of_week，实际落点=W%dD%d", got.Week, got.DayOfWeek)
+	}
+}
+
+func TestRunCompositeRouteNodeAllowsHandoffWithoutDeterministicObjective(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: "数学"},
+	}
+	st := &ScheduleRefineState{
+		UserMessage:           "把这些任务按最少上下文切换整理一下",
+		HybridEntries:         cloneHybridEntries(entries),
+		InitialHybridEntries:  cloneHybridEntries(entries),
+		WorksetTaskIDs:        []int{11, 12, 13},
+		RequiredCompositeTool: "MinContextSwitch",
+		CompositeRetryMax:     0,
+		ExecuteMax:            4,
+		OriginOrderMap:        map[int]int{11: 1, 12: 2, 13: 3},
+		CompositeToolCalled: map[string]bool{
+			"SpreadEven":       false,
+			"MinContextSwitch": false,
+		},
+		CompositeToolSuccess: map[string]bool{
+			"SpreadEven":       false,
+			"MinContextSwitch": false,
+		},
+	}
+
+	stageLogs := make([]string, 0, 8)
+	nextState, err := runCompositeRouteNode(context.Background(), st, func(stage, detail string) {
+		stageLogs = append(stageLogs, stage+"|"+detail)
+	})
+	if err != nil {
+		t.Fatalf("runCompositeRouteNode 返回错误: %v", err)
+	}
+	if nextState == nil {
+		t.Fatalf("runCompositeRouteNode 返回 nil state")
+	}
+	if !nextState.CompositeRouteSucceeded {
+		t.Fatalf("期望复合分支在缺少 deterministic objective 时直接出站，实际 CompositeRouteSucceeded=false, stages=%v, action_logs=%v", stageLogs, nextState.ActionLogs)
+	}
+	if nextState.DisableCompositeTools {
+		t.Fatalf("期望复合分支直接进入终审，不应降级为禁复合 ReAct")
+	}
+	if !nextState.CompositeToolSuccess["MinContextSwitch"] {
+		t.Fatalf("期望 MinContextSwitch 成功状态被记录")
+	}
+}