Version: 0.9.59.dev.260430

后端：
1. 主动调度预览确认主链路落地——新增主动调度数据模型、DAO 与事件契约；接入 dry-run pipeline 与任务触发的 job upsert/cancel；新增 preview 查询与 confirm API，支持 apply_id 幂等确认并同步写入 task_pool 日程
2. 同步更新主动调度实施文档的阶段状态与验收记录

前端：
3. AssistantPanel 脚本层继续解耦——私有类型迁移到独立类型文件，并抽离会话、工具轨迹、思考摘要、任务表单等纯函数辅助逻辑；保持助手面板模板与样式不变，降低表现层回归风险

backend/api/active_schedule.go

@@ -0,0 +1,181 @@
+package api
+
+import (
+	"context"
+	"fmt"
+	"net/http"
+	"time"
+
+	activeapply "github.com/LoveLosita/smartflow/backend/active_scheduler/apply"
+	activepreview "github.com/LoveLosita/smartflow/backend/active_scheduler/preview"
+	activesvc "github.com/LoveLosita/smartflow/backend/active_scheduler/service"
+	"github.com/LoveLosita/smartflow/backend/active_scheduler/trigger"
+	"github.com/LoveLosita/smartflow/backend/respond"
+	"github.com/gin-gonic/gin"
+)
+
+// ActiveScheduleAPI 承载主动调度开发期和验收期 API。
+//
+// 职责边界：
+// 1. 只负责鉴权用户、绑定请求和调用主动调度 service；
+// 2. 不直接读取 DAO、不生成候选、不写 preview；
+// 3. 阶段 1-2 只开放 dry-run，正式 trigger/preview/confirm 后续阶段再接入。
+type ActiveScheduleAPI struct {
+	dryRunService         *activesvc.DryRunService
+	previewConfirmService *activesvc.PreviewConfirmService
+}
+
+func NewActiveScheduleAPI(dryRunService *activesvc.DryRunService, previewConfirmService *activesvc.PreviewConfirmService) *ActiveScheduleAPI {
+	return &ActiveScheduleAPI{
+		dryRunService:         dryRunService,
+		previewConfirmService: previewConfirmService,
+	}
+}
+
+type ActiveScheduleDryRunRequest struct {
+	TriggerType    string     `json:"trigger_type" binding:"required"`
+	TargetType     string     `json:"target_type" binding:"required"`
+	TargetID       int        `json:"target_id"`
+	FeedbackID     string     `json:"feedback_id"`
+	IdempotencyKey string     `json:"idempotency_key"`
+	MockNow        *time.Time `json:"mock_now"`
+}
+
+// DryRun 同步执行主动调度诊断，不写 preview、不发通知、不修改正式日程。
+func (api *ActiveScheduleAPI) DryRun(c *gin.Context) {
+	if api == nil || api.dryRunService == nil {
+		c.JSON(http.StatusInternalServerError, respond.InternalError(nilServiceError("主动调度 dry-run service 未初始化")))
+		return
+	}
+
+	var req ActiveScheduleDryRunRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, respond.WrongParamType)
+		return
+	}
+
+	userID := c.GetInt("user_id")
+	now := time.Now()
+	isMockTime := req.MockNow != nil
+	trig := trigger.ActiveScheduleTrigger{
+		UserID:         userID,
+		TriggerType:    trigger.TriggerType(req.TriggerType),
+		Source:         trigger.SourceAPIDryRun,
+		TargetType:     trigger.TargetType(req.TargetType),
+		TargetID:       req.TargetID,
+		FeedbackID:     req.FeedbackID,
+		IdempotencyKey: req.IdempotencyKey,
+		MockNow:        req.MockNow,
+		IsMockTime:     isMockTime,
+		RequestedAt:    now,
+	}
+
+	ctx, cancel := context.WithTimeout(c.Request.Context(), 3*time.Second)
+	defer cancel()
+	result, err := api.dryRunService.DryRun(ctx, trig)
+	if err != nil {
+		respond.DealWithError(c, err)
+		return
+	}
+
+	c.JSON(http.StatusOK, respond.RespWithData(respond.Ok, result))
+}
+
+// CreatePreview 先同步 dry-run，再把 top1 候选固化为待确认预览。
+func (api *ActiveScheduleAPI) CreatePreview(c *gin.Context) {
+	if api == nil || api.dryRunService == nil || api.previewConfirmService == nil {
+		c.JSON(http.StatusInternalServerError, respond.InternalError(nilServiceError("主动调度 preview service 未初始化")))
+		return
+	}
+
+	var req ActiveScheduleDryRunRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, respond.WrongParamType)
+		return
+	}
+
+	userID := c.GetInt("user_id")
+	now := time.Now()
+	trig := trigger.ActiveScheduleTrigger{
+		TriggerID:      fmt.Sprintf("ast_api_%d_%d", userID, now.UnixNano()),
+		UserID:         userID,
+		TriggerType:    trigger.TriggerType(req.TriggerType),
+		Source:         trigger.SourceAPIDryRun,
+		TargetType:     trigger.TargetType(req.TargetType),
+		TargetID:       req.TargetID,
+		FeedbackID:     req.FeedbackID,
+		IdempotencyKey: req.IdempotencyKey,
+		MockNow:        req.MockNow,
+		IsMockTime:     req.MockNow != nil,
+		RequestedAt:    now,
+		TraceID:        fmt.Sprintf("trace_api_preview_%d_%d", userID, now.UnixNano()),
+	}
+
+	ctx, cancel := context.WithTimeout(c.Request.Context(), 5*time.Second)
+	defer cancel()
+	dryRunResult, err := api.dryRunService.DryRun(ctx, trig)
+	if err != nil {
+		respond.DealWithError(c, err)
+		return
+	}
+	previewResp, err := api.previewConfirmService.CreatePreviewFromDryRun(ctx, activepreview.CreatePreviewRequest{
+		ActiveContext: dryRunResult.Context,
+		Observation:   dryRunResult.Observation,
+		Candidates:    dryRunResult.Candidates,
+		TriggerID:     trig.TriggerID,
+		GeneratedAt:   now,
+	})
+	if err != nil {
+		respond.DealWithError(c, err)
+		return
+	}
+	c.JSON(http.StatusOK, respond.RespWithData(respond.Ok, previewResp.Detail))
+}
+
+// GetPreview 查询主动调度预览详情。
+func (api *ActiveScheduleAPI) GetPreview(c *gin.Context) {
+	if api == nil || api.previewConfirmService == nil {
+		c.JSON(http.StatusInternalServerError, respond.InternalError(nilServiceError("主动调度 preview service 未初始化")))
+		return
+	}
+	ctx, cancel := context.WithTimeout(c.Request.Context(), 3*time.Second)
+	defer cancel()
+	detail, err := api.previewConfirmService.GetPreview(ctx, c.GetInt("user_id"), c.Param("preview_id"))
+	if err != nil {
+		respond.DealWithError(c, err)
+		return
+	}
+	c.JSON(http.StatusOK, respond.RespWithData(respond.Ok, detail))
+}
+
+// ConfirmPreview 同步确认并正式应用主动调度预览。
+func (api *ActiveScheduleAPI) ConfirmPreview(c *gin.Context) {
+	if api == nil || api.previewConfirmService == nil {
+		c.JSON(http.StatusInternalServerError, respond.InternalError(nilServiceError("主动调度 confirm service 未初始化")))
+		return
+	}
+	var req activeapply.ConfirmRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, respond.WrongParamType)
+		return
+	}
+	req.PreviewID = c.Param("preview_id")
+	req.UserID = c.GetInt("user_id")
+	if req.RequestedAt.IsZero() {
+		req.RequestedAt = time.Now()
+	}
+	ctx, cancel := context.WithTimeout(c.Request.Context(), 5*time.Second)
+	defer cancel()
+	result, err := api.previewConfirmService.ConfirmPreview(ctx, req)
+	if err != nil {
+		respond.DealWithError(c, err)
+		return
+	}
+	c.JSON(http.StatusOK, respond.RespWithData(respond.Ok, result))
+}
+
+type nilServiceError string
+
+func (e nilServiceError) Error() string {
+	return string(e)
+}