Version: 0.7.1.dev.260321

feat(agent): ✨ 重构智能排程分流与双通道交付，补齐周级预算并接入连续微调复用

- 🔀 通用路由升级为 action 分流（chat/quick_note_create/task_query/schedule_plan），路由失败直接返回内部错误，不再回落聊天
- 🧭 智能排程链路重构：统一图编排与节点职责，完善日级/周级调优协作与提示词约束
- 📊 周级预算改为“有效周保底 + 负载加权分配”，避免有效周零预算并提升资源利用率
- ⚙️ 日级并发优化细化：按天拆分 DayGroup 并发执行，低收益天（suggested<=2）跳过，单天失败仅回退该天结果并继续全局
- 🧵 周级并发优化细化：按周并发 worker 执行，单周“单步动作”循环（每轮仅 1 个 Move/Swap 或 done），失败周保留原方案不影响其它周
- 🛰️ 新增排程预览双通道：聊天主链路输出终审文本，结构化 candidate_plans 通过 /api/v1/agent/schedule-preview 拉取
- 🗃️ 增补 Redis 预览缓存读写与清理逻辑，新增对应 API、路由、模型与错误码支持
- ♻️ 接入连续对话微调复用：命中同会话历史预览时复用上轮 HybridEntries，避免每轮重跑粗排
- 🛡️ 增加复用保护：仅当本轮与上轮 task_class_ids 集合一致才复用；不一致回退全量粗排
- 🧰 扩展预览缓存字段（task_class_ids/hybrid_entries/allocated_items），支撑微调承接链路
- 🗺️ 更新 README 5.4 Mermaid（总分流图 + 智能排程流转图）并补充决策文档

- ⚠️ 新增“连续微调复用”链路我尚未完成测试，且文档状态目前较为混乱，待连续对话微调功能真正测试完成后再统一更新

backend/model/agent.go

@@ -82,6 +82,52 @@ type GetConversationListResponse struct {
 	HasMore  bool                      `json:"has_more"`
 }
 
+// SchedulePlanPreviewCache 是“排程预览”在 Redis 中的缓存结构。
+//
+// 职责边界：
+// 1. 负责承载排程完成后的结构化预览快照（summary + candidate_plans）；
+// 2. 通过 user_id 做查询归属校验，避免跨用户越权读取；
+// 3. 仅用于缓存层读写，不表示已落库或已应用到正式日程；
+// 4. 通过 trace_id 标识本次预览来源，便于排查链路问题。
+type SchedulePlanPreviewCache struct {
+	UserID         int                `json:"user_id"`
+	ConversationID string             `json:"conversation_id"`
+	TraceID        string             `json:"trace_id,omitempty"`
+	Summary        string             `json:"summary"`
+	CandidatePlans []UserWeekSchedule `json:"candidate_plans"`
+	// TaskClassIDs 记录本次预览对应的任务类集合。
+	// 作用：
+	// 1. 连续对话微调时，若本轮请求未显式传 task_class_ids，可用该字段兜底；
+	// 2. 仅用于会话内上下文承接，不表示用户最终确认后的持久化状态。
+	TaskClassIDs []int `json:"task_class_ids,omitempty"`
+	// HybridEntries 保存“可优化的混合日程底板”。
+	// 作用：
+	// 1. 连续对话微调时复用上轮结果作为起点，避免每轮都从粗排重算；
+	// 2. 仅缓存态，生命周期受 Redis TTL 控制。
+	HybridEntries []HybridScheduleEntry `json:"hybrid_entries,omitempty"`
+	// AllocatedItems 保存建议任务块的当前分配状态。
+	// 作用：
+	// 1. 保证 final_check 的数量核对口径在连续微调场景下可持续；
+	// 2. return_preview 节点可继续回填 embedded_time。
+	AllocatedItems []TaskClassItem `json:"allocated_items,omitempty"`
+	GeneratedAt    time.Time       `json:"generated_at"`
+}
+
+// GetSchedulePlanPreviewResponse 是“按会话查询排程预览”接口返回结构。
+//
+// 职责边界：
+// 1. conversation_id：标识该预览属于哪个会话；
+// 2. summary：给用户展示的终审自然语言总结；
+// 3. candidate_plans：给前端渲染课表/时间轴用的结构化 JSON；
+// 4. generated_at：预览生成时间，便于前端判断是否是最新结果。
+type GetSchedulePlanPreviewResponse struct {
+	ConversationID string             `json:"conversation_id"`
+	TraceID        string             `json:"trace_id,omitempty"`
+	Summary        string             `json:"summary"`
+	CandidatePlans []UserWeekSchedule `json:"candidate_plans"`
+	GeneratedAt    time.Time          `json:"generated_at"`
+}
+
 type SSEResponse struct {
 	Event string         `json:"event"`
 	ID    int            `json:"id,omitempty"`