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/schedule.go

@@ -97,6 +97,16 @@ type UserDeleteScheduleEvent struct {
 	DeleteEmbeddedTask bool `json:"delete_embedded_task"`
 }
 
+// UserSmartPlanningMultiRequest 是“多任务类智能粗排”接口的请求体。
+//
+// 设计说明：
+// 1. TaskClassIDs 至少包含 1 个任务类 ID；
+// 2. 实际业务建议传入 >=2 个，用于多任务类混排；
+// 3. 服务层会做去重与合法值过滤，接口层只做基础绑定校验。
+type UserSmartPlanningMultiRequest struct {
+	TaskClassIDs []int `json:"task_class_ids" binding:"required,min=1,dive,min=1"`
+}
+
 type UserRecentCompletedScheduleResponse struct {
 	Events []RecentCompletedEventBrief `json:"events"`
 }
@@ -137,6 +147,25 @@ type HybridScheduleEntry struct {
 	Status      string `json:"status"`                 // "existing" | "suggested"
 	TaskItemID  int    `json:"task_item_id,omitempty"` // 仅 suggested 的 task 有值
 	EventID     int    `json:"event_id,omitempty"`     // 仅 existing 有值
+	// CanBeEmbedded 表示该条 existing 课程块是否允许嵌入任务。
+	// 仅课程条目有意义，task 条目默认 false。
+	CanBeEmbedded bool `json:"can_be_embedded,omitempty"`
+	// BlockForSuggested 表示该条目是否应当阻塞 suggested 任务占位。
+	//
+	// 语义说明：
+	// 1. suggested 条目默认 true（任务之间不能重叠）；
+	// 2. existing 课程若是“可嵌入且当前格子未被嵌入任务占用”，则为 false；
+	// 3. existing 课程若不可嵌入，或该格子已有嵌入任务，则为 true。
+	//
+	// 该字段用于工具层冲突判断，避免把“可嵌入课位”误判为硬冲突。
+	BlockForSuggested bool `json:"block_for_suggested,omitempty"`
+	// ContextTag 是任务认知类型标签，仅在 suggested 任务中使用。
+	// 该标签用于日内优化时的“认知负荷分配”，例如：
+	// 1. High-Logic：数学、编程、逻辑推理；
+	// 2. Memory：记忆/背诵类；
+	// 3. Review：复习/回顾类；
+	// 4. General：通用任务。
+	ContextTag string `json:"context_tag,omitempty"`
 }
 
 func (ScheduleEvent) TableName() string { return "schedule_events" }