Version: 0.9.45.dev.260427

后端：
1. execute 主链路重构为“上下文工具域 + 主动优化候选闭环”——移除 order_guard，粗排后默认进入主动微调，先诊断再从后端候选中选择 move/swap，避免 LLM 自由全局乱搜
2. 工具体系升级为动态注入协议——新增 context_tools_add / remove、工具域与二级包映射、主动优化白名单；schedule / taskclass / web 工具按域按包暴露，msg0 规则包与 execute 上下文同步重写
3. analyze_health 升级为主动优化唯一裁判入口——补齐 rhythm / tightness / profile / feasibility 指标、候选扫描与复诊打分、停滞信号、forced imperfection 判定，并把连续优化状态写回运行态
4. 任务类能力并入新 Agent 执行链——新增 upsert_task_class 写工具与启动注入事务写入；任务类模型补充学科画像与整天屏蔽配置，粗排支持 excluded_days_of_week，steady 策略改为基于目标位置/单日负载/分散度/缓冲的候选打分
5. 运行态与路由补齐优化模式语义——新增 active tool domain/packs、pending context hook、active optimize only、taskclass 写入回盘快照；区分 first_full / global_reopt / local_adjust，并完善首次粗排后默认 refine 的判定

前端：
6. 助手时间线渲染细化——推理内容改为独立 reasoning block，支持与工具/状态/正文按时序交错展示，自动收口折叠，修正 confirm reject 恢复动作

仓库：
7. newAgent 文档整体迁入 docs/backend，补充主动优化执行规划与顺序约束拆解文档，删除旧调试日志文件

PS:这次科研了2天，总算是有些进展了——LLM永远只适合做选择题、判断题，不适合做开放创新题。

backend/cmd/start.go

@@ -5,6 +5,7 @@ import (
 	"fmt"
 	"log"
 	"os"
+	"strings"
 	"time"
 
 	"github.com/LoveLosita/smartflow/backend/api"
@@ -197,6 +198,78 @@ func Start() {
 	agentService.SetToolRegistry(newagenttools.NewDefaultRegistryWithDeps(newagenttools.DefaultRegistryDeps{
 		RAGRuntime:        ragRuntime,
 		WebSearchProvider: webSearchProvider,
+		TaskClassWriteDeps: newagenttools.TaskClassWriteDeps{
+			UpsertTaskClass: func(userID int, input newagenttools.TaskClassUpsertInput) (newagenttools.TaskClassUpsertPersistResult, error) {
+				req := input.Request
+				taskClassID := 0
+				created := input.ID == 0
+
+				err := taskClassRepo.Transaction(func(txDAO *dao.TaskClassDAO) error {
+					// 1. 先构造任务类主体，保持与现有 AddOrUpdateTaskClass 口径一致。
+					taskClass := &model.TaskClass{
+						ID:                 input.ID,
+						Name:               &req.Name,
+						Mode:               &req.Mode,
+						SubjectType:        stringPtrOrNil(req.SubjectType),
+						DifficultyLevel:    stringPtrOrNil(req.DifficultyLevel),
+						CognitiveIntensity: stringPtrOrNil(req.CognitiveIntensity),
+						TotalSlots:         &req.Config.TotalSlots,
+						Strategy:           &req.Config.Strategy,
+						ExcludedSlots:      req.Config.ExcludedSlots,
+						ExcludedDaysOfWeek: req.Config.ExcludedDaysOfWeek,
+					}
+					taskClass.AllowFillerCourse = &req.Config.AllowFillerCourse
+
+					// 2. 自动模式下写入日期范围；手动模式允许为空。
+					if req.StartDate != "" {
+						startDate, parseErr := time.ParseInLocation("2006-01-02", req.StartDate, time.Local)
+						if parseErr != nil {
+							return parseErr
+						}
+						taskClass.StartDate = &startDate
+					}
+					if req.EndDate != "" {
+						endDate, parseErr := time.ParseInLocation("2006-01-02", req.EndDate, time.Local)
+						if parseErr != nil {
+							return parseErr
+						}
+						taskClass.EndDate = &endDate
+					}
+
+					// 3. upsert 主体后拿到稳定 task_class_id，供 items 绑定 category_id。
+					updatedID, upsertErr := txDAO.AddOrUpdateTaskClass(userID, taskClass)
+					if upsertErr != nil {
+						return upsertErr
+					}
+					taskClassID = updatedID
+
+					// 4. 构造任务块并批量 upsert。
+					items := make([]model.TaskClassItem, 0, len(req.Items))
+					for _, itemReq := range req.Items {
+						categoryID := taskClassID
+						order := itemReq.Order
+						content := itemReq.Content
+						status := model.TaskItemStatusUnscheduled
+						items = append(items, model.TaskClassItem{
+							ID:           itemReq.ID,
+							CategoryID:   &categoryID,
+							Order:        &order,
+							Content:      &content,
+							EmbeddedTime: itemReq.EmbeddedTime,
+							Status:       &status,
+						})
+					}
+					return txDAO.AddOrUpdateTaskClassItems(userID, items)
+				})
+				if err != nil {
+					return newagenttools.TaskClassUpsertPersistResult{}, err
+				}
+				return newagenttools.TaskClassUpsertPersistResult{
+					TaskClassID: taskClassID,
+					Created:     created,
+				}, nil
+			},
+		},
 	}))
 	agentService.SetScheduleProvider(newagentconv.NewScheduleProvider(scheduleRepo, taskClassRepo))
 	agentService.SetCompactionStore(agentRepo)
@@ -271,3 +344,11 @@ func Start() {
 	r := routers.RegisterRouters(handlers, cacheRepo, userRepo, limiter)
 	routers.StartEngine(r)
 }
+
+func stringPtrOrNil(value string) *string {
+	trimmed := strings.TrimSpace(value)
+	if trimmed == "" {
+		return nil
+	}
+	return &trimmed
+}