Version: 0.7.9.dev.260326

后端：
1.把最后一块拼图：schedule_refine也搬迁到了agent2，此时agent已经完全解耦。但是它没融入新架构，Codex只尝试把它调整了一部分，回退了一些错误的更改，保持着现在的可运行状态。下次继续改。
2.agent目录先保留，直到refine彻底融入新架构。
3.改善Codex主导的新史山结构:node文件夹里面大量文件，转而改成了module.go+module_tool.go的双文件格局，极大提升架构整洁度和代码可读性。
前端：
1.新开了日历界面，正在保持往前推进。做了很多更改，感觉越来越好了。

backend/service/agentsvc/agent_schedule_preview.go

@@ -7,21 +7,20 @@ import (
 	"strings"
 	"time"
 
-	"github.com/LoveLosita/smartflow/backend/agent/scheduleplan"
 	agentmodel "github.com/LoveLosita/smartflow/backend/agent2/model"
 	agentshared "github.com/LoveLosita/smartflow/backend/agent2/shared"
 	"github.com/LoveLosita/smartflow/backend/model"
 	"github.com/LoveLosita/smartflow/backend/respond"
 )
 
-// saveSchedulePlanPreview 把排程结果以结构化 JSON 快照写入 Redis。
+// saveSchedulePlanPreview 鎶婃帓绋嬬粨鏋滀互缁撴瀯鍖?JSON 蹇収鍐欏叆 Redis銆?
 //
-// 职责边界：
-// 1. 负责把 finalState 中的 summary + candidate_plans 收敛为缓存 DTO；
-// 2. 负责以“失败不阻断聊天主链路”的策略执行写入；
-// 3. 不负责 SSE 返回协议，不负责数据库落库。
-func (s *AgentService) saveSchedulePlanPreview(ctx context.Context, userID int, chatID string, finalState *scheduleplan.SchedulePlanState) {
-	// 1. 基础前置校验：state 为空时直接返回，避免写入半成品快照。
+// 鑱岃矗杈圭晫锛?
+// 1. 璐熻矗鎶?finalState 涓殑 summary + candidate_plans 鏀舵暃涓虹紦瀛?DTO锛?
+// 2. 璐熻矗浠モ€滃け璐ヤ笉闃绘柇鑱婂ぉ涓婚摼璺€濈殑绛栫暐鎵ц鍐欏叆锛?
+// 3. 涓嶈礋璐?SSE 杩斿洖鍗忚锛屼笉璐熻矗鏁版嵁搴撹惤搴撱€?
+func (s *AgentService) saveSchedulePlanPreview(ctx context.Context, userID int, chatID string, finalState *agentmodel.SchedulePlanState) {
+	// 1. 鍩虹鍓嶇疆鏍￠獙锛歴tate 涓虹┖鏃剁洿鎺ヨ繑鍥烇紝閬垮厤鍐欏叆鍗婃垚鍝佸揩鐓с€?
 	if s == nil || finalState == nil {
 		return
 	}
@@ -30,10 +29,10 @@ func (s *AgentService) saveSchedulePlanPreview(ctx context.Context, userID int,
 		return
 	}
 
-	// 2. 组装缓存快照：
-	// 2.1 summary 优先取 final summary，空值时使用统一兜底文案；
-	// 2.2 candidate_plans 做切片拷贝，避免后续引用共享导致意外覆盖；
-	// 2.3 generated_at 用于前端判断“当前预览的新鲜度”。
+	// 2. 缁勮缂撳瓨蹇収锛?
+	// 2.1 summary 浼樺厛鍙?final summary锛岀┖鍊兼椂浣跨敤缁熶竴鍏滃簳鏂囨锛?
+	// 2.2 candidate_plans 鍋氬垏鐗囨嫹璐濓紝閬垮厤鍚庣画寮曠敤鍏变韩瀵艰嚧鎰忓瑕嗙洊锛?
+	// 2.3 generated_at 鐢ㄤ簬鍓嶇鍒ゆ柇鈥滃綋鍓嶉瑙堢殑鏂伴矞搴︹€濄€?
 	summary := strings.TrimSpace(finalState.FinalSummary)
 	if summary == "" {
 		summary = "排程流程已完成，但未生成结果摘要。"
@@ -50,35 +49,35 @@ func (s *AgentService) saveSchedulePlanPreview(ctx context.Context, userID int,
 		GeneratedAt:    time.Now(),
 	}
 
-	// 3. 调用目的：先写 Redis 预览，保证前端查询接口能快速读取结构化结果。
-	// 3.1 Redis 是“快路径”；失败只记录日志，不中断主链路；
-	// 3.2 失败兜底由后续 MySQL 快照承接。
+	// 3. 璋冪敤鐩殑锛氬厛鍐?Redis 棰勮锛屼繚璇佸墠绔煡璇㈡帴鍙ｈ兘蹇€熻鍙栫粨鏋勫寲缁撴灉銆?
+	// 3.1 Redis 鏄€滃揩璺緞鈥濓紱澶辫触鍙褰曟棩蹇楋紝涓嶄腑鏂富閾捐矾锛?
+	// 3.2 澶辫触鍏滃簳鐢卞悗缁?MySQL 蹇収鎵挎帴銆?
 	if s.cacheDAO != nil {
 		if err := s.cacheDAO.SetSchedulePlanPreviewToCache(ctx, userID, normalizedChatID, preview); err != nil {
-			log.Printf("写入排程预览缓存失败 chat_id=%s: %v", normalizedChatID, err)
+			log.Printf("鍐欏叆鎺掔▼棰勮缂撳瓨澶辫触 chat_id=%s: %v", normalizedChatID, err)
 		}
 	}
 
-	// 4. 调用目的：同步写 MySQL 状态快照，保证 Redis 失效后仍可连续微调。
-	// 4.1 这里采用“同步写库”而不是 outbox：因为下一轮微调要强实时读取；
-	// 4.2 快照写入失败只打日志，不阻断本轮用户回复，避免体验抖动；
-	// 4.3 revision 自增由 DAO 的 upsert 冲突更新负责。
+	// 4. 璋冪敤鐩殑锛氬悓姝ュ啓 MySQL 鐘舵€佸揩鐓э紝淇濊瘉 Redis 澶辨晥鍚庝粛鍙繛缁井璋冦€?
+	// 4.1 杩欓噷閲囩敤鈥滃悓姝ュ啓搴撯€濊€屼笉鏄?outbox锛氬洜涓轰笅涓€杞井璋冭寮哄疄鏃惰鍙栵紱
+	// 4.2 蹇収鍐欏叆澶辫触鍙墦鏃ュ織锛屼笉闃绘柇鏈疆鐢ㄦ埛鍥炲锛岄伩鍏嶄綋楠屾姈鍔紱
+	// 4.3 revision 鑷鐢?DAO 鐨?upsert 鍐茬獊鏇存柊璐熻矗銆?
 	if s.repo != nil {
 		snapshot := buildSchedulePlanSnapshotFromState(userID, normalizedChatID, finalState)
 		if err := s.repo.UpsertScheduleStateSnapshot(ctx, snapshot); err != nil {
-			log.Printf("写入排程状态快照失败 chat_id=%s: %v", normalizedChatID, err)
+			log.Printf("鍐欏叆鎺掔▼鐘舵€佸揩鐓уけ璐?chat_id=%s: %v", normalizedChatID, err)
 		}
 	}
 }
 
-// saveSchedulePlanPreviewAgent2 把 agent2 的 schedule_plan 结果写入 Redis 预览与 MySQL 快照。
+// saveSchedulePlanPreviewAgent2 鎶?agent2 鐨?schedule_plan 缁撴灉鍐欏叆 Redis 棰勮涓?MySQL 蹇収銆?
 //
-// 职责边界：
-// 1. 负责承接“新 agent2 首次排程链路”的最终状态；
-// 2. 负责沿用现有预览缓存/状态快照协议，保证查询接口与 refine 读取逻辑不需要跟着重写；
-// 3. 不负责 refine 状态转换，refine 仍继续走旧链路的 saveSchedulePlanPreview。
+// 鑱岃矗杈圭晫锛?
+// 1. 璐熻矗鎵挎帴鈥滄柊 agent2 棣栨鎺掔▼閾捐矾鈥濈殑鏈€缁堢姸鎬侊紱
+// 2. 璐熻矗娌跨敤鐜版湁棰勮缂撳瓨/鐘舵€佸揩鐓у崗璁紝淇濊瘉鏌ヨ鎺ュ彛涓?refine 璇诲彇閫昏緫涓嶉渶瑕佽窡鐫€閲嶅啓锛?
+// 3. 涓嶈礋璐?refine 鐘舵€佽浆鎹紝refine 浠嶇户缁蛋鏃ч摼璺殑 saveSchedulePlanPreview銆?
 func (s *AgentService) saveSchedulePlanPreviewAgent2(ctx context.Context, userID int, chatID string, finalState *agentmodel.SchedulePlanState) {
-	// 1. 基础前置校验：state 为空时直接返回，避免写入半成品快照。
+	// 1. 鍩虹鍓嶇疆鏍￠獙锛歴tate 涓虹┖鏃剁洿鎺ヨ繑鍥烇紝閬垮厤鍐欏叆鍗婃垚鍝佸揩鐓с€?
 	if s == nil || finalState == nil {
 		return
 	}
@@ -87,10 +86,10 @@ func (s *AgentService) saveSchedulePlanPreviewAgent2(ctx context.Context, userID
 		return
 	}
 
-	// 2. 组装缓存快照。
-	// 2.1 summary 优先取 final summary，空值时使用统一兜底文案；
-	// 2.2 candidate_plans / hybrid_entries / allocated_items 统一深拷贝，避免缓存与 graph state 共用底层切片；
-	// 2.3 generated_at 用于前端判断“当前预览是否为最新方案”。
+	// 2. 缁勮缂撳瓨蹇収銆?
+	// 2.1 summary 浼樺厛鍙?final summary锛岀┖鍊兼椂浣跨敤缁熶竴鍏滃簳鏂囨锛?
+	// 2.2 candidate_plans / hybrid_entries / allocated_items 缁熶竴娣辨嫹璐濓紝閬垮厤缂撳瓨涓?graph state 鍏辩敤搴曞眰鍒囩墖锛?
+	// 2.3 generated_at 鐢ㄤ簬鍓嶇鍒ゆ柇鈥滃綋鍓嶉瑙堟槸鍚︿负鏈€鏂版柟妗堚€濄€?
 	summary := strings.TrimSpace(finalState.FinalSummary)
 	if summary == "" {
 		summary = "排程流程已完成，但未生成结果摘要。"
@@ -107,34 +106,34 @@ func (s *AgentService) saveSchedulePlanPreviewAgent2(ctx context.Context, userID
 		GeneratedAt:    time.Now(),
 	}
 
-	// 3. 先写 Redis 预览，保证前端查询接口能立即读取结构化结果。
-	// 3.1 Redis 是“快路径”；
-	// 3.2 失败只记录日志，不中断聊天主链路。
+	// 3. 鍏堝啓 Redis 棰勮锛屼繚璇佸墠绔煡璇㈡帴鍙ｈ兘绔嬪嵆璇诲彇缁撴瀯鍖栫粨鏋溿€?
+	// 3.1 Redis 鏄€滃揩璺緞鈥濓紱
+	// 3.2 澶辫触鍙褰曟棩蹇楋紝涓嶄腑鏂亰澶╀富閾捐矾銆?
 	if s.cacheDAO != nil {
 		if err := s.cacheDAO.SetSchedulePlanPreviewToCache(ctx, userID, normalizedChatID, preview); err != nil {
-			log.Printf("写入排程预览缓存失败 chat_id=%s: %v", normalizedChatID, err)
+			log.Printf("鍐欏叆鎺掔▼棰勮缂撳瓨澶辫触 chat_id=%s: %v", normalizedChatID, err)
 		}
 	}
 
-	// 4. 同步写 MySQL 快照，保证 Redis 失效后仍能恢复预览与连续微调上下文。
-	// 4.1 这里继续保持“同步写库”策略，因为下一轮微调对快照读取是强实时依赖；
-	// 4.2 写库失败只打日志，不阻断本轮给用户的文本回复。
+	// 4. 鍚屾鍐?MySQL 蹇収锛屼繚璇?Redis 澶辨晥鍚庝粛鑳芥仮澶嶉瑙堜笌杩炵画寰皟涓婁笅鏂囥€?
+	// 4.1 杩欓噷缁х画淇濇寔鈥滃悓姝ュ啓搴撯€濈瓥鐣ワ紝鍥犱负涓嬩竴杞井璋冨蹇収璇诲彇鏄己瀹炴椂渚濊禆锛?
+	// 4.2 鍐欏簱澶辫触鍙墦鏃ュ織锛屼笉闃绘柇鏈疆缁欑敤鎴风殑鏂囨湰鍥炲銆?
 	if s.repo != nil {
 		snapshot := buildSchedulePlanSnapshotFromAgent2State(userID, normalizedChatID, finalState)
 		if err := s.repo.UpsertScheduleStateSnapshot(ctx, snapshot); err != nil {
-			log.Printf("写入排程状态快照失败 chat_id=%s: %v", normalizedChatID, err)
+			log.Printf("鍐欏叆鎺掔▼鐘舵€佸揩鐓уけ璐?chat_id=%s: %v", normalizedChatID, err)
 		}
 	}
 }
 
-// GetSchedulePlanPreview 按 conversation_id 读取结构化排程预览。
+// GetSchedulePlanPreview 鎸?conversation_id 璇诲彇缁撴瀯鍖栨帓绋嬮瑙堛€?
 //
-// 职责边界：
-// 1. 负责参数归一化、缓存读取与会话归属校验；
-// 2. 负责把缓存 DTO 转成 API 响应 DTO；
-// 3. 不负责触发排程，不负责补算缓存。
+// 鑱岃矗杈圭晫锛?
+// 1. 璐熻矗鍙傛暟褰掍竴鍖栥€佺紦瀛樿鍙栦笌浼氳瘽褰掑睘鏍￠獙锛?
+// 2. 璐熻矗鎶婄紦瀛?DTO 杞垚 API 鍝嶅簲 DTO锛?
+// 3. 涓嶈礋璐ｈЕ鍙戞帓绋嬶紝涓嶈礋璐ｈˉ绠楃紦瀛樸€?
 func (s *AgentService) GetSchedulePlanPreview(ctx context.Context, userID int, chatID string) (*model.GetSchedulePlanPreviewResponse, error) {
-	// 1. 参数校验：conversation_id 为空直接返回参数错误，避免无效 Redis 请求。
+	// 1. 鍙傛暟鏍￠獙锛歝onversation_id 涓虹┖鐩存帴杩斿洖鍙傛暟閿欒锛岄伩鍏嶆棤鏁?Redis 璇锋眰銆?
 	normalizedChatID := strings.TrimSpace(chatID)
 	if normalizedChatID == "" {
 		return nil, respond.MissingParam
@@ -143,10 +142,10 @@ func (s *AgentService) GetSchedulePlanPreview(ctx context.Context, userID int, c
 		return nil, errors.New("agent service is not initialized")
 	}
 
-	// 2. 查询缓存并校验归属：
-	// 2.1 缓存未命中：统一返回“预览不存在/已过期”；
-	// 2.2 命中但 user_id 不一致：按未命中处理，避免泄露他人会话信息；
-	// 2.3 失败兜底：缓存读异常直接上抛，由 API 层统一错误处理。
+	// 2. 鏌ヨ缂撳瓨骞舵牎楠屽綊灞烇細
+	// 2.1 缂撳瓨鏈懡涓細缁熶竴杩斿洖鈥滈瑙堜笉瀛樺湪/宸茶繃鏈熲€濓紱
+	// 2.2 鍛戒腑浣?user_id 涓嶄竴鑷达細鎸夋湭鍛戒腑澶勭悊锛岄伩鍏嶆硠闇蹭粬浜轰細璇濅俊鎭紱
+	// 2.3 澶辫触鍏滃簳锛氱紦瀛樿寮傚父鐩存帴涓婃姏锛岀敱 API 灞傜粺涓€閿欒澶勭悊銆?
 	if s.cacheDAO != nil {
 		preview, err := s.cacheDAO.GetSchedulePlanPreviewFromCache(ctx, userID, normalizedChatID)
 		if err != nil {
@@ -170,10 +169,10 @@ func (s *AgentService) GetSchedulePlanPreview(ctx context.Context, userID int, c
 		}
 	}
 
-	// 3. Redis 未命中时回落 MySQL 快照：
-	// 3.1 读取成功后直接返回，避免用户看到“预览不存在”的假阴性；
-	// 3.2 若本次命中 DB 且缓存可用，则顺手回填 Redis，提升后续命中率；
-	// 3.3 DB 也未命中时再返回 not found。
+	// 3. Redis 鏈懡涓椂鍥炶惤 MySQL 蹇収锛?
+	// 3.1 璇诲彇鎴愬姛鍚庣洿鎺ヨ繑鍥烇紝閬垮厤鐢ㄦ埛鐪嬪埌鈥滈瑙堜笉瀛樺湪鈥濈殑鍋囬槾鎬э紱
+	// 3.2 鑻ユ湰娆″懡涓?DB 涓旂紦瀛樺彲鐢紝鍒欓『鎵嬪洖濉?Redis锛屾彁鍗囧悗缁懡涓巼锛?
+	// 3.3 DB 涔熸湭鍛戒腑鏃跺啀杩斿洖 not found銆?
 	if s.repo != nil {
 		snapshot, err := s.repo.GetScheduleStateSnapshot(ctx, userID, normalizedChatID)
 		if err != nil {
@@ -184,7 +183,7 @@ func (s *AgentService) GetSchedulePlanPreview(ctx context.Context, userID int, c
 			if s.cacheDAO != nil {
 				cachePreview := snapshotToSchedulePlanPreviewCache(snapshot)
 				if setErr := s.cacheDAO.SetSchedulePlanPreviewToCache(ctx, userID, normalizedChatID, cachePreview); setErr != nil {
-					log.Printf("回填排程预览缓存失败 chat_id=%s: %v", normalizedChatID, setErr)
+					log.Printf("鍥炲～鎺掔▼棰勮缂撳瓨澶辫触 chat_id=%s: %v", normalizedChatID, setErr)
 				}
 			}
 			return response, nil
@@ -193,28 +192,28 @@ func (s *AgentService) GetSchedulePlanPreview(ctx context.Context, userID int, c
 	return nil, respond.SchedulePlanPreviewNotFound
 }
 
-// cloneWeekSchedules 对周视图排程结果做深拷贝，避免切片引用共享。
+// cloneWeekSchedules 瀵瑰懆瑙嗗浘鎺掔▼缁撴灉鍋氭繁鎷疯礉锛岄伩鍏嶅垏鐗囧紩鐢ㄥ叡浜€?
 func cloneWeekSchedules(src []model.UserWeekSchedule) []model.UserWeekSchedule {
 	return agentshared.CloneWeekSchedules(src)
 }
 
-// cloneHybridEntries 深拷贝混合条目切片，避免缓存/状态之间相互污染。
+// cloneHybridEntries 娣辨嫹璐濇贩鍚堟潯鐩垏鐗囷紝閬垮厤缂撳瓨/鐘舵€佷箣闂寸浉浜掓薄鏌撱€?
 func cloneHybridEntries(src []model.HybridScheduleEntry) []model.HybridScheduleEntry {
 	return agentshared.CloneHybridEntries(src)
 }
 
-// cloneTaskClassItems 深拷贝任务块切片（包含指针字段），避免跨请求引用共享。
+// cloneTaskClassItems 娣辨嫹璐濅换鍔″潡鍒囩墖锛堝寘鍚寚閽堝瓧娈碉級锛岄伩鍏嶈法璇锋眰寮曠敤鍏变韩銆?
 func cloneTaskClassItems(src []model.TaskClassItem) []model.TaskClassItem {
 	return agentshared.CloneTaskClassItems(src)
 }
 
-// buildSchedulePlanSnapshotFromState 把 graph 运行结果映射成可持久化快照 DTO。
+// buildSchedulePlanSnapshotFromState 鎶?graph 杩愯缁撴灉鏄犲皠鎴愬彲鎸佷箙鍖栧揩鐓?DTO銆?
 //
-// 职责边界：
-// 1. 负责字段映射与深拷贝，避免跨层共享可变切片；
-// 2. 负责补齐 state_version 默认值；
-// 3. 不负责数据库写入（写入由 DAO 承担）。
-func buildSchedulePlanSnapshotFromState(userID int, conversationID string, st *scheduleplan.SchedulePlanState) *model.SchedulePlanStateSnapshot {
+// 鑱岃矗杈圭晫锛?
+// 1. 璐熻矗瀛楁鏄犲皠涓庢繁鎷疯礉锛岄伩鍏嶈法灞傚叡浜彲鍙樺垏鐗囷紱
+// 2. 璐熻矗琛ラ綈 state_version 榛樿鍊硷紱
+// 3. 涓嶈礋璐ｆ暟鎹簱鍐欏叆锛堝啓鍏ョ敱 DAO 鎵挎媴锛夈€?
+func buildSchedulePlanSnapshotFromState(userID int, conversationID string, st *agentmodel.SchedulePlanState) *model.SchedulePlanStateSnapshot {
 	if st == nil {
 		return nil
 	}
@@ -237,12 +236,12 @@ func buildSchedulePlanSnapshotFromState(userID int, conversationID string, st *s
 	}
 }
 
-// buildSchedulePlanSnapshotFromAgent2State 把 agent2 的排程状态映射成可持久化快照 DTO。
+// buildSchedulePlanSnapshotFromAgent2State 鎶?agent2 鐨勬帓绋嬬姸鎬佹槧灏勬垚鍙寔涔呭寲蹇収 DTO銆?
 //
-// 调用目的：
-// 1. 这轮只迁移 schedule_plan，不动 refine；
-// 2. 因此 preview/快照协议继续复用老结构，但要补一个“agent2 state -> snapshot DTO”的映射层；
-// 3. 这样可以做到：计划创建链路切到 agent2，而 refine / 预览查询链路暂时无需大改。
+// 璋冪敤鐩殑锛?
+// 1. 杩欒疆鍙縼绉?schedule_plan锛屼笉鍔?refine锛?
+// 2. 鍥犳 preview/蹇収鍗忚缁х画澶嶇敤鑰佺粨鏋勶紝浣嗚琛ヤ竴涓€渁gent2 state -> snapshot DTO鈥濈殑鏄犲皠灞傦紱
+// 3. 杩欐牱鍙互鍋氬埌锛氳鍒掑垱寤洪摼璺垏鍒?agent2锛岃€?refine / 棰勮鏌ヨ閾捐矾鏆傛椂鏃犻渶澶ф敼銆?
 func buildSchedulePlanSnapshotFromAgent2State(userID int, conversationID string, st *agentmodel.SchedulePlanState) *model.SchedulePlanStateSnapshot {
 	if st == nil {
 		return nil
@@ -266,7 +265,7 @@ func buildSchedulePlanSnapshotFromAgent2State(userID int, conversationID string,
 	}
 }
 
-// snapshotToSchedulePlanPreviewCache 把 MySQL 快照转换为 Redis 预览缓存结构。
+// snapshotToSchedulePlanPreviewCache 鎶?MySQL 蹇収杞崲涓?Redis 棰勮缂撳瓨缁撴瀯銆?
 func snapshotToSchedulePlanPreviewCache(snapshot *model.SchedulePlanStateSnapshot) *model.SchedulePlanPreviewCache {
 	if snapshot == nil {
 		return nil
@@ -292,7 +291,7 @@ func snapshotToSchedulePlanPreviewCache(snapshot *model.SchedulePlanStateSnapsho
 	}
 }
 
-// snapshotToSchedulePlanPreviewResponse 把 MySQL 快照转换为查询接口响应。
+// snapshotToSchedulePlanPreviewResponse 鎶?MySQL 蹇収杞崲涓烘煡璇㈡帴鍙ｅ搷搴斻€?
 func snapshotToSchedulePlanPreviewResponse(snapshot *model.SchedulePlanStateSnapshot) *model.GetSchedulePlanPreviewResponse {
 	if snapshot == nil {
 		return nil