Version: 0.9.0.dev.260405

后端：
1.新建tools/write_helpers.go：写工具专用辅助函数（冲突检测、范围校验、嵌入宿主查找、锁定检查、格式化）
2.新建tools/write_tools.go：实现5个写工具（Place/Move/Swap/BatchMove/Unplace），含嵌入逻辑、原子性批量操作、双向嵌入关系清理，26个单元测试全部通过
3.新建tools/registry.go：工具注册表（ToolRegistry），统一管理10个工具的注册/查找/执行，支持读写工具区分和参数解析
4.更新model/graph_run_state.go：
新增 ScheduleStateProvider 接口和 ToolRegistry 依赖注入，AgentGraphState 支持按需加载ScheduleState
5.更新 node/execute.go：接入 ToolRegistry 实现真实工具调用，替换原骨架实现
6.更新 AGENTS.md
前端：无
仓库：无

backend/newAgent/tools/write_helpers.go

@@ -0,0 +1,167 @@
+package newagenttools
+
+import (
+	"fmt"
+	"strings"
+)
+
+// ==================== 写工具专用辅助函数 ====================
+// 复用 read_helpers.go 中的：formatSlotRange, formatTaskLabel, slotOccupiedBy,
+// findFreeRangesOnDay, getTasksOnDay, countDayOccupied, taskOnDay, freeRange
+
+// ==================== 校验函数 ====================
+
+// validateDay 校验 day 是否在规划窗口范围内。
+func validateDay(state *ScheduleState, day int) error {
+	if day < 1 || day > state.Window.TotalDays {
+		return fmt.Errorf("第%d天不在规划窗口范围内（1-%d）", day, state.Window.TotalDays)
+	}
+	return nil
+}
+
+// validateSlotRange 校验时段范围是否合法（1-12，start <= end）。
+func validateSlotRange(start, end int) error {
+	if start < 1 {
+		return fmt.Errorf("起始时段 %d 不能小于1", start)
+	}
+	if end > 12 {
+		return fmt.Errorf("结束时段 %d 不能大于12", end)
+	}
+	if start > end {
+		return fmt.Errorf("起始时段 %d 不能大于结束时段 %d", start, end)
+	}
+	return nil
+}
+
+// checkLocked 检查任务是否被锁定。锁定任务不可移动/交换/移除。
+func checkLocked(task ScheduleTask) error {
+	if task.Locked {
+		return fmt.Errorf("[%d]%s 是固定课程，不可操作", task.StateID, task.Name)
+	}
+	return nil
+}
+
+// ==================== 冲突检测 ====================
+
+// findConflict 查找指定范围 [start, end] 内是否有冲突。
+// 排除 excludeStateIDs 中的任务（用于 move/swap 排除自身旧位置）。
+// 可嵌入宿主（can_embed=true）不算冲突——嵌入场景由 place 单独处理。
+// 返回第一个冲突任务，无冲突返回 nil。
+func findConflict(state *ScheduleState, day, start, end int, excludeStateIDs ...int) *ScheduleTask {
+	// 构建排除集合
+	exclude := make(map[int]bool, len(excludeStateIDs))
+	for _, id := range excludeStateIDs {
+		exclude[id] = true
+	}
+
+	for i := range state.Tasks {
+		t := &state.Tasks[i]
+		// 排除指定任务
+		if exclude[t.StateID] {
+			continue
+		}
+		// 可嵌入宿主不算冲突
+		if t.CanEmbed {
+			continue
+		}
+		// 嵌入任务与宿主共享时段，不算独立冲突
+		if t.EmbedHost != nil {
+			continue
+		}
+		// 只检查已安排的任务
+		if len(t.Slots) == 0 {
+			continue
+		}
+		for _, slot := range t.Slots {
+			if slot.Day == day {
+				// 检查范围是否有交集：[start,end] ∩ [slot.SlotStart,slot.SlotEnd]
+				if start <= slot.SlotEnd && end >= slot.SlotStart {
+					return t
+				}
+			}
+		}
+	}
+	return nil
+}
+
+// findEmbedHost 查找指定范围 [start, end] 内是否有可嵌入的宿主。
+// 条件：can_embed=true 且未被嵌入（embedded_by == nil）。
+// 返回第一个匹配的宿主，无匹配返回 nil。
+func findEmbedHost(state *ScheduleState, day, start, end int) *ScheduleTask {
+	for i := range state.Tasks {
+		t := &state.Tasks[i]
+		if !t.CanEmbed || t.EmbeddedBy != nil {
+			continue
+		}
+		for _, slot := range t.Slots {
+			if slot.Day == day {
+				// 完全包含在宿主时段内才能嵌入
+				if start >= slot.SlotStart && end <= slot.SlotEnd {
+					return t
+				}
+			}
+		}
+	}
+	return nil
+}
+
+// ==================== 计算辅助 ====================
+
+// taskDuration 计算任务所有 Slots 的总时段数。
+// 如 Slots = [{1,1,2}, {3,1,2}] → 总时长 = 2+2 = 4。
+// 用于 swap 时比较两个任务的时长是否一致。
+func taskDuration(task ScheduleTask) int {
+	total := 0
+	for _, slot := range task.Slots {
+		total += slot.SlotEnd - slot.SlotStart + 1
+	}
+	return total
+}
+
+// countPending 统计当前 state 中待安排任务数量。
+func countPending(state *ScheduleState) int {
+	count := 0
+	for i := range state.Tasks {
+		if state.Tasks[i].Status == "pending" {
+			count++
+		}
+	}
+	return count
+}
+
+// ==================== 输出格式化 ====================
+
+// formatDayOccupancy 格式化某天的占用摘要。
+// 如 "第5天当前占用：[3]复习线代(1-3节)，占用3/12。"
+// 如 "第4天当前占用：0/12。"（空天）
+func formatDayOccupancy(state *ScheduleState, day int) string {
+	tasks := getTasksOnDay(state, day)
+	occupied := countDayOccupied(state, day)
+
+	if len(tasks) == 0 {
+		return fmt.Sprintf("第%d天当前占用：0/12。", day)
+	}
+
+	parts := make([]string, 0, len(tasks))
+	for _, td := range tasks {
+		label := formatTaskLabel(*td.task)
+		parts = append(parts, fmt.Sprintf("%s(%s)", label, formatSlotRange(td.slotStart, td.slotEnd)))
+	}
+
+	return fmt.Sprintf("第%d天当前占用：%s，占用%d/12。", day, strings.Join(parts, " "), occupied)
+}
+
+// formatFreeHint 格式化某天的空闲时段提示。
+// 如 "空闲时段：第5-12节。"
+// 无空闲时返回空字符串。
+func formatFreeHint(state *ScheduleState, day int) string {
+	ranges := findFreeRangesOnDay(state, day)
+	if len(ranges) == 0 {
+		return ""
+	}
+	parts := make([]string, 0, len(ranges))
+	for _, r := range ranges {
+		parts = append(parts, formatSlotRange(r.slotStart, r.slotEnd))
+	}
+	return fmt.Sprintf("空闲时段：%s。", strings.Join(parts, "、"))
+}