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/service/agentsvc/agent_quick_note_route_test.go

@@ -4,28 +4,29 @@ import (
 	"strings"
 	"testing"
 
-	"github.com/LoveLosita/smartflow/backend/agent/quicknote"
-	"github.com/LoveLosita/smartflow/backend/agent/route"
+	agentmodel "github.com/LoveLosita/smartflow/backend/agent2/model"
+	agentrouter "github.com/LoveLosita/smartflow/backend/agent2/router"
 )
 
 // TestParseQuickNoteRouteControlTag_QuickNote
-// 目的：验证模型控制码在 action=quick_note 时可被稳定解析，
-// 并且会校验 nonce，避免历史脏内容或伪造片段误命中。
+// 目的：
+// 1. 验证旧 quick note 兼容入口仍然可以解析控制码；
+// 2. 验证旧 action=quick_note 会被统一映射到新动作 quick_note_create；
+// 3. 验证 reason 仍然会被保留下来，方便上层做阶段提示与排障。
 func TestParseQuickNoteRouteControlTag_QuickNote(t *testing.T) {
 	nonce := "abc123nonce"
 	raw := `<SMARTFLOW_ROUTE nonce="abc123nonce" action="quick_note"></SMARTFLOW_ROUTE>
 <SMARTFLOW_REASON>用户明确在请求未来提醒</SMARTFLOW_REASON>`
 
-	decision, err := route.ParseQuickNoteRouteControlTag(raw, nonce)
+	decision, err := agentrouter.ParseQuickNoteRouteControlTag(raw, nonce)
 	if err != nil {
 		t.Fatalf("解析失败: %v", err)
 	}
 	if decision == nil {
 		t.Fatalf("decision 不应为空")
 	}
-	// 兼容逻辑：历史 quick_note 会被统一映射到 quick_note_create。
-	if decision.Action != route.ActionQuickNoteCreate {
-		t.Fatalf("action 解析错误，期望=%s 实际=%s", route.ActionQuickNoteCreate, decision.Action)
+	if decision.Action != agentrouter.ActionQuickNoteCreate {
+		t.Fatalf("action 解析错误，期望=%s 实际=%s", agentrouter.ActionQuickNoteCreate, decision.Action)
 	}
 	if strings.TrimSpace(decision.Reason) == "" {
 		t.Fatalf("reason 不应为空")
@@ -33,37 +34,40 @@ func TestParseQuickNoteRouteControlTag_QuickNote(t *testing.T) {
 }
 
 // TestParseRouteControlTag_TaskQuery
-// 目的：验证通用分流中 action=task_query 的控制码可稳定解析。
+// 目的：验证通用分流控制码在 action=task_query 时可以被稳定解析。
 func TestParseRouteControlTag_TaskQuery(t *testing.T) {
 	nonce := "taskquerynonce"
 	raw := `<SMARTFLOW_ROUTE nonce="taskquerynonce" action="task_query"></SMARTFLOW_ROUTE>
 <SMARTFLOW_REASON>用户在查最紧急任务</SMARTFLOW_REASON>`
 
-	decision, err := route.ParseRouteControlTag(raw, nonce)
+	decision, err := agentrouter.ParseRouteControlTag(raw, nonce)
 	if err != nil {
 		t.Fatalf("解析失败: %v", err)
 	}
 	if decision == nil {
 		t.Fatalf("decision 不应为空")
 	}
-	if decision.Action != route.ActionTaskQuery {
-		t.Fatalf("action 解析错误，期望=%s 实际=%s", route.ActionTaskQuery, decision.Action)
+	if decision.Action != agentrouter.ActionTaskQuery {
+		t.Fatalf("action 解析错误，期望=%s 实际=%s", agentrouter.ActionTaskQuery, decision.Action)
 	}
 }
 
 // TestParseQuickNoteRouteControlTag_NonceMismatch
-// 目的：确保 nonce 不匹配时直接报错，避免把非本次请求的控制码当作有效路由。
+// 目的：确保 nonce 不匹配时直接报错，避免把别的请求控制码误判成当前请求。
 func TestParseQuickNoteRouteControlTag_NonceMismatch(t *testing.T) {
 	raw := `<SMARTFLOW_ROUTE nonce="wrongnonce" action="chat"></SMARTFLOW_ROUTE>`
-	if _, err := route.ParseQuickNoteRouteControlTag(raw, "expectednonce"); err == nil {
+	if _, err := agentrouter.ParseQuickNoteRouteControlTag(raw, "expectednonce"); err == nil {
 		t.Fatalf("期望 nonce 不匹配时报错，但未报错")
 	}
 }
 
 // TestBuildQuickNoteFinalReply_NoFalseSuccessWithoutTaskID
-// 目的：即使 state.Persisted 被错误置为 true，只要 task_id 无效，也不能返回“安排成功”文案。
+// 目的：
+// 1. 即使状态被错误标记为 Persisted=true；
+// 2. 只要没有有效 task_id，就不能回成功文案；
+// 3. 避免出现“回复成功但库里没数据”的假成功体验。
 func TestBuildQuickNoteFinalReply_NoFalseSuccessWithoutTaskID(t *testing.T) {
-	state := &quicknote.QuickNoteState{
+	state := &agentmodel.QuickNoteState{
 		Persisted:       true,
 		PersistedTaskID: 0,
 		ExtractedTitle:  "去下馆子",
@@ -76,9 +80,11 @@ func TestBuildQuickNoteFinalReply_NoFalseSuccessWithoutTaskID(t *testing.T) {
 }
 
 // TestBuildQuickNoteFinalReply_UseExtractedBanter
-// 目的：当聚合规划阶段已经产出 banter 时，最终回复应直接复用，避免再次调用润色模型。
+// 目的：
+// 1. 当聚合规划阶段已经产出 banter 时，最终回复应直接复用；
+// 2. 避免为了润色再次调用模型，增加不必要时延。
 func TestBuildQuickNoteFinalReply_UseExtractedBanter(t *testing.T) {
-	state := &quicknote.QuickNoteState{
+	state := &agentmodel.QuickNoteState{
 		Persisted:         true,
 		PersistedTaskID:   12,
 		ExtractedTitle:    "明天去取快递",