定时任务：修复智能体执行 422、新增描述字段、公开页删除按钮等

- 定时任务执行时按 agent.id 解析智能体，老数据中存的中文显示名会回退按 name 查找，避免 422
- scheduled_tasks 表新增 description 字段（迁移 20260522_01），创建/编辑表单支持，公开页标题下显示
- 公开页（/public/scheduled-tasks/{id}）新增删除单次执行记录入口，使用样式化 Dialog 确认
- 公开页左侧标题区精简：去掉 schedule/timezone/最近状态两行；执行列表标题剥离尾部时间戳，"计划"改为"执行时间"
- 工作区定时任务列表：超长标题改为按字符换行不再截断；按 created_at 倒序（新建任务在前）
- 启动 Alembic 升级加超时与单独线程，MySQL 缺库时自动 CREATE DATABASE
- vite build 增加 8GB 内存上限

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

frontend-web/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "scripts": {
     "dev": "vite",
-    "build": "vite build",
+    "build": "node --max-old-space-size=8192 ./node_modules/vite/bin/vite.js build",
     "preview": "vite preview",
     "typecheck": "tsc --noEmit"
   },

frontend-web/src/core/scheduled-tasks/api.ts

@@ -46,6 +46,7 @@ export async function listScheduledTasks(params: ListScheduledTasksParams = {})
 
 export async function createScheduledTask(data: {
   name: string;
+  description?: string | null;
   prompt: string;
   schedule: string;
   timezone?: string | null;
@@ -203,6 +204,7 @@ export async function updateScheduledTask(
   taskId: string,
   data: Partial<{
     name: string;
+    description: string | null;
     prompt: string;
     schedule: string;
     timezone: string;
@@ -329,6 +331,7 @@ export async function adminUpdateScheduledTask(
   taskId: string,
   data: Partial<{
     name: string;
+    description: string | null;
     prompt: string;
     schedule: string;
     timezone: string;

frontend-web/src/core/scheduled-tasks/types.ts

@@ -14,6 +14,7 @@ export type ScheduledTaskSubscription = {
 export type ScheduledTask = {
   task_id: string;
   name: string;
+  description?: string | null;
   prompt: string;
   schedule_text: string;
   cron_expr: string;
@@ -27,6 +28,8 @@ export type ScheduledTask = {
   scheduler_thread_id: string;
   published?: boolean;
   published_at?: string | null;
+  created_at?: string | null;
+  updated_at?: string | null;
   role?: ScheduledTaskRole;
   _subscription?: ScheduledTaskSubscription | null;
   creator_user_id?: string | null;

frontend-web/src/pages/PublicScheduledTaskPage.tsx

@@ -7,6 +7,7 @@ import {
   FileText,
   Loader2,
   Pencil,
+  Trash2,
   X,
 } from "lucide-react";
 import { useCallback, useEffect, useMemo, useState } from "react";
@@ -16,6 +17,14 @@ import { toast } from "sonner";
 import { Badge } from "@/components/ui/badge";
 import { Button } from "@/components/ui/button";
 import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
 import { ScrollArea } from "@/components/ui/scroll-area";
 import { Tabs, TabsList, TabsTrigger } from "@/components/ui/tabs";
 import { Textarea } from "@/components/ui/textarea";
@@ -34,6 +43,7 @@ import { cn } from "@/lib/utils";
 type PublicTask = {
   task_id: string;
   name: string;
+  description?: string | null;
   schedule_text: string;
   cron_expr?: string;
   timezone: string;
@@ -142,6 +152,17 @@ async function updatePublicRunBody(runId: string, content: string): Promise<void
   );
 }
 
+async function deletePublicRun(runId: string): Promise<void> {
+  const response = await fetch(
+    `${publicBaseUrl()}/runs/${encodeURIComponent(runId)}`,
+    { method: "DELETE" },
+  );
+  if (!response.ok && response.status !== 204) {
+    const body = await response.json().catch(() => ({ detail: "Request failed" }));
+    throw new Error(typeof body.detail === "string" ? body.detail : "Request failed");
+  }
+}
+
 function publicRunFileDownloadUrl(runId: string, index: number): string {
   return `${publicBaseUrl()}/runs/${encodeURIComponent(runId)}/files/${index}/download`;
 }
@@ -196,6 +217,20 @@ function stripExtension(name: string): string {
   return name.slice(0, dot);
 }
 
+/**
+ * Strip a trailing ` - YYYY-MM-DD HH:MM[:SS]` (or `_YYYY-MM-DD ...`) suffix
+ * that the agent appends to run titles. The scheduled-for column is already
+ * displayed separately below the title, so the duplicated date looks like noise.
+ */
+function stripTimestampSuffix(title: string): string {
+  if (!title) return title;
+  const cleaned = title.replace(
+    /[\s_]*[-_]?\s*\d{4}-\d{1,2}-\d{1,2}[\sT]+\d{1,2}:\d{2}(?::\d{2})?\s*$/,
+    "",
+  );
+  return cleaned.trim() || title;
+}
+
 const BODY_TAB_VALUE = "__body__";
 
 /**
@@ -212,6 +247,8 @@ const BODY_TAB_VALUE = "__body__";
 export default function PublicScheduledTaskPage() {
   const { taskId } = useParams<{ taskId: string }>();
   const [selectedRunId, setSelectedRunId] = useState<string | null>(null);
+  const [pendingDeleteRun, setPendingDeleteRun] = useState<{ id: string; title: string } | null>(null);
+  const queryClient = useQueryClient();
 
   const { data, isLoading, isError, error } = useQuery({
     queryKey: ["public-scheduled-task", taskId],
@@ -222,6 +259,21 @@ export default function PublicScheduledTaskPage() {
     refetchInterval: 8000,
   });
 
+  const deleteRunMutation = useMutation({
+    mutationFn: (runId: string) => deletePublicRun(runId),
+    onSuccess: async (_data, runId) => {
+      toast.success("已删除");
+      if (selectedRunId === runId) {
+        setSelectedRunId(null);
+      }
+      setPendingDeleteRun(null);
+      await queryClient.invalidateQueries({ queryKey: ["public-scheduled-task", taskId] });
+    },
+    onError: (err) => {
+      toast.error(err instanceof Error ? err.message : "删除失败");
+    },
+  });
+
   // Public viewer only surfaces runs that have actual content to show:
   // pending/running/failed are hidden, and succeeded runs with neither a body
   // nor a Markdown attachment fall out too (nothing to render).
@@ -301,12 +353,11 @@ export default function PublicScheduledTaskPage() {
                 {task?.enabled ? "启用" : "暂停"}
               </Badge>
             </div>
-            <p className="text-muted-foreground truncate text-xs">
+            {task?.description && task.description.trim() && (
-              {task?.schedule_text} · {task?.timezone}
+              <p className="text-muted-foreground line-clamp-3 text-xs leading-relaxed break-all whitespace-pre-wrap">
-            </p>
+                {task.description.trim()}
-            <p className="text-muted-foreground text-xs">
+              </p>
-              最近状态：{statusLabel(task?.last_status)} · 上次：{formatDate(task?.last_run_at)}
+            )}
-            </p>
           </CardHeader>
           <CardContent className="min-h-0 flex-1 p-0">
             <ScrollArea className="size-full">
@@ -319,15 +370,27 @@ export default function PublicScheduledTaskPage() {
                 {runs.map((run) => {
                   const active = run.id === selectedRunId;
                   const runRunning = run.status === "running" || run.status === "pending";
-                  const runTitle = run.result?.title || formatDate(run.scheduled_for);
+                  const runTitle = stripTimestampSuffix(
+                    run.result?.title || formatDate(run.scheduled_for),
+                  );
+                  const isDeletingThis =
+                    deleteRunMutation.isPending && deleteRunMutation.variables === run.id;
                   return (
-                    <button
+                    <div
                       key={run.id}
+                      role="button"
+                      tabIndex={0}
                       className={cn(
-                        "bg-card hover:bg-accent/60 rounded-md border p-3 text-left transition-colors",
+                        "bg-card hover:bg-accent/60 group rounded-md border p-3 text-left transition-colors cursor-pointer focus:outline-none focus-visible:ring-2 focus-visible:ring-ring",
                         active && "border-primary bg-accent",
                       )}
                       onClick={() => setSelectedRunId(run.id)}
+                      onKeyDown={(event) => {
+                        if (event.key === "Enter" || event.key === " ") {
+                          event.preventDefault();
+                          setSelectedRunId(run.id);
+                        }
+                      }}
                     >
                       <div className="flex items-start justify-between gap-2">
                         <div className="min-w-0 flex-1">
@@ -345,21 +408,40 @@ export default function PublicScheduledTaskPage() {
                             </TooltipContent>
                           </Tooltip>
                           <div className="text-muted-foreground mt-1 text-xs">
-                            计划：{formatDate(run.scheduled_for)}
+                            执行时间：{formatDate(run.scheduled_for)}
                           </div>
                         </div>
-                        <Badge
+                        <div className="flex shrink-0 items-center gap-1">
-                          variant={statusVariant(run.status)}
+                          <Badge
-                          className={cn(
+                            variant={statusVariant(run.status)}
-                            "shrink-0",
+                            className={cn(
-                            runRunning && "border-primary/30 bg-primary/10 text-primary",
+                              "shrink-0",
-                          )}
+                              runRunning && "border-primary/30 bg-primary/10 text-primary",
-                        >
+                            )}
-                          {runRunning && <Loader2 className="size-3 animate-spin" />}
+                          >
-                          {statusLabel(run.status)}
+                            {runRunning && <Loader2 className="size-3 animate-spin" />}
-                        </Badge>
+                            {statusLabel(run.status)}
+                          </Badge>
+                          <Button
+                            size="icon"
+                            variant="ghost"
+                            className="text-muted-foreground hover:text-destructive size-7"
+                            disabled={isDeletingThis}
+                            onClick={(event) => {
+                              event.stopPropagation();
+                              setPendingDeleteRun({ id: run.id, title: runTitle });
+                            }}
+                            title="删除记录"
+                          >
+                            {isDeletingThis ? (
+                              <Loader2 className="size-3.5 animate-spin" />
+                            ) : (
+                              <Trash2 className="size-3.5" />
+                            )}
+                          </Button>
+                        </div>
                       </div>
-                    </button>
+                    </div>
                   );
                 })}
               </div>
@@ -377,6 +459,54 @@ export default function PublicScheduledTaskPage() {
           )}
         </Card>
       </div>
+
+      <Dialog
+        open={pendingDeleteRun !== null}
+        onOpenChange={(open) => {
+          if (!open && !deleteRunMutation.isPending) {
+            setPendingDeleteRun(null);
+          }
+        }}
+      >
+        <DialogContent className="sm:max-w-[420px]">
+          <DialogHeader>
+            <DialogTitle>删除执行记录</DialogTitle>
+            <DialogDescription>
+              确认删除这条执行记录吗？此操作不可恢复。
+            </DialogDescription>
+          </DialogHeader>
+          {pendingDeleteRun && (
+            <div className="bg-muted/40 text-foreground rounded-md border px-3 py-2 text-sm break-all">
+              {pendingDeleteRun.title}
+            </div>
+          )}
+          <DialogFooter>
+            <Button
+              variant="outline"
+              onClick={() => setPendingDeleteRun(null)}
+              disabled={deleteRunMutation.isPending}
+            >
+              取消
+            </Button>
+            <Button
+              variant="destructive"
+              onClick={() => {
+                if (pendingDeleteRun) {
+                  deleteRunMutation.mutate(pendingDeleteRun.id);
+                }
+              }}
+              disabled={deleteRunMutation.isPending}
+            >
+              {deleteRunMutation.isPending ? (
+                <Loader2 className="size-4 animate-spin" />
+              ) : (
+                <Trash2 className="size-4" />
+              )}
+              删除
+            </Button>
+          </DialogFooter>
+        </DialogContent>
+      </Dialog>
     </TooltipProvider>
   );
 }

frontend-web/src/pages/ScheduledTasksPage.tsx

@@ -78,6 +78,7 @@ function displayUsername(value?: string | null): string {
 
 const emptyForm = {
   name: "",
+  description: "",
   schedule: "",
   timezone: "Asia/Shanghai",
   prompt: "",
@@ -116,9 +117,13 @@ export default function ScheduledTasksPage() {
 
   const sortedTasks = useMemo(
     () =>
-      [...tasks].sort((a, b) =>
+      [...tasks].sort((a, b) => {
-        String(a.next_run_at ?? "").localeCompare(String(b.next_run_at ?? "")),
+        // Newest task first. Fall back to next_run_at so tasks that lack a
-      ),
+        // created_at (older rows / subscribed tasks) still order consistently.
+        const aKey = a.created_at ?? a.next_run_at ?? "";
+        const bKey = b.created_at ?? b.next_run_at ?? "";
+        return String(bKey).localeCompare(String(aKey));
+      }),
     [tasks],
   );
   const selectedTask = sortedTasks.find((task) => task.task_id === selectedTaskId) ?? null;
@@ -162,6 +167,7 @@ export default function ScheduledTasksPage() {
     setEditing(task);
     setForm({
       name: task.name,
+      description: task.description ?? "",
       schedule: task.schedule_text,
       timezone: task.timezone,
       prompt: task.prompt,
@@ -190,6 +196,7 @@ export default function ScheduledTasksPage() {
       if (creating) {
         const task = await actions.create.mutateAsync({
           name: form.name || "定时任务",
+          description: form.description.trim() || null,
           schedule: cronSchedule,
           timezone: form.timezone || "Asia/Shanghai",
           prompt: form.prompt,
@@ -202,6 +209,7 @@ export default function ScheduledTasksPage() {
           taskId: editing.task_id,
           data: {
             name: form.name,
+            description: form.description.trim() || null,
             schedule: cronSchedule,
             timezone: form.timezone,
             prompt: form.prompt,
@@ -324,9 +332,11 @@ export default function ScheduledTasksPage() {
                           onClick={() => setSelectedTaskId(task.task_id)}
                         >
                           <div className="flex items-start justify-between gap-3">
-                            <div className="min-w-0">
+                            <div className="min-w-0 flex-1">
-                              <div className="flex items-center gap-2">
+                              <div className="font-medium leading-snug break-all">
-                                <div className="truncate font-medium">{task.name}</div>
+                                {task.name}
+                              </div>
+                              <div className="mt-1 flex flex-wrap items-center gap-1">
                                 {isRunningNow && (
                                   <Badge
                                     variant="secondary"
@@ -351,7 +361,7 @@ export default function ScheduledTasksPage() {
                                 {task.schedule_text} · {task.timezone}
                               </div>
                             </div>
-                            <Badge variant={task.enabled ? "default" : "secondary"}>
+                            <Badge variant={task.enabled ? "default" : "secondary"} className="shrink-0">
                               {task.enabled ? "启用" : "暂停"}
                             </Badge>
                           </div>
@@ -760,6 +770,14 @@ export default function ScheduledTasksPage() {
               }
               placeholder="任务名称"
             />
+            <Textarea
+              className="min-h-16"
+              value={form.description}
+              onChange={(event) =>
+                setForm((value) => ({ ...value, description: event.target.value }))
+              }
+              placeholder="任务描述（可选，将显示在公开页标题下方）"
+            />
             <div className="flex flex-col gap-1">
               <p className="text-muted-foreground text-xs">执行频率</p>
               <ScheduleBuilder value={scheduleConfig} onChange={setScheduleConfig} />
@@ -786,7 +804,7 @@ export default function ScheduledTasksPage() {
               <SelectContent>
                 <SelectItem value="__default__">默认助手（不指定）</SelectItem>
                 {agents.map((agent) => (
-                  <SelectItem key={agent.name} value={agent.name}>
+                  <SelectItem key={agent.id} value={agent.id}>
                     {agent.name}
                     {agent.description ? ` — ${agent.description}` : ""}
                   </SelectItem>

offline-backend-20260512/backend/app/gateway/app.py

@@ -1,8 +1,10 @@
-import asyncio
+import asyncio
-import logging
+import logging
-import os
+import os
-import sys
+import queue
-from collections.abc import AsyncGenerator
+import sys
+import threading
+from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 
 from dotenv import load_dotenv
@@ -245,8 +247,7 @@ async def _migrate_orphaned_threads(store, admin_user_id: str) -> int:
 
 async def _run_db_migrations() -> None:
     """Run Alembic migrations at startup so schema changes are applied automatically."""
-    import asyncio
+    from pathlib import Path
-    from pathlib import Path
 
     from alembic import command
     from alembic.config import Config
@@ -259,18 +260,51 @@ async def _run_db_migrations() -> None:
         logger.info("Persistence backend=memory — skipping Alembic migrations")
         return
 
-    db_url = engine.url.render_as_string(hide_password=False).replace("%", "%%")
+    if os.getenv("DEER_FLOW_SKIP_ALEMBIC", "").lower() in {"1", "true", "yes"}:
-    migrations_dir = str(Path(_persistence_pkg.__file__).parent / "migrations")
+        logger.warning("DEER_FLOW_SKIP_ALEMBIC is set; skipping Alembic migrations")
-
+        return
-    def _run_sync() -> None:
+
-        cfg = Config()
+    db_url = engine.url.render_as_string(hide_password=False).replace("%", "%%")
-        cfg.set_main_option("script_location", migrations_dir)
+    migrations_dir = str(Path(_persistence_pkg.__file__).parent / "migrations")
-        cfg.set_main_option("sqlalchemy.url", db_url)
+    result_queue: queue.Queue[BaseException | None] = queue.Queue(maxsize=1)
-        command.upgrade(cfg, "head")
+
-
+    def _run_sync() -> None:
-    try:
+        try:
-        await asyncio.get_running_loop().run_in_executor(None, _run_sync)
+            cfg = Config()
-        logger.info("Database migrations applied (head)")
+            cfg.set_main_option("script_location", migrations_dir)
+            cfg.set_main_option("sqlalchemy.url", db_url)
+            command.upgrade(cfg, "head")
+        except BaseException as exc:
+            result_queue.put(exc)
+        else:
+            result_queue.put(None)
+
+    try:
+        try:
+            timeout_s = float(os.getenv("DEER_FLOW_ALEMBIC_TIMEOUT", "60"))
+        except ValueError:
+            timeout_s = 60.0
+
+        worker = threading.Thread(target=_run_sync, name="deerflow-alembic-upgrade", daemon=True)
+        worker.start()
+        try:
+            deadline = asyncio.get_running_loop().time() + timeout_s
+            while result_queue.empty():
+                if asyncio.get_running_loop().time() >= deadline:
+                    raise asyncio.TimeoutError
+                await asyncio.sleep(0.2)
+            result = result_queue.get_nowait()
+        except asyncio.TimeoutError:
+            logger.error(
+                "Database migration did not finish within %.0fs; continuing startup on create_all schema. "
+                "Likely cause: MySQL metadata-lock wait or a slow DDL. Set DEER_FLOW_SKIP_ALEMBIC=1 "
+                "to skip startup migrations, or inspect MySQL with SHOW FULL PROCESSLIST.",
+                timeout_s,
+            )
+            return
+        if result is not None:
+            raise result
+        logger.info("Database migrations applied (head)")
     except Exception:
         logger.exception("Database migration failed — schema may be out of date")
 

offline-backend-20260512/backend/app/gateway/routers/public_scheduled_tasks.py

@@ -15,6 +15,7 @@ Surface area:
 - ``PUT  /api/public/scheduled-tasks/runs/{run_id}/files/{i}``— overwrite an editable result file
 - ``PUT  /api/public/scheduled-tasks/runs/{run_id}/body``     — overwrite the inline Markdown body
 - ``GET  /api/public/scheduled-tasks/runs/{run_id}/download`` — zip / md download of result
+- ``DELETE /api/public/scheduled-tasks/runs/{run_id}``        — remove a single run (no auth)
 
 The PUT endpoints intentionally skip ownership checks so the anonymous public
 viewer at ``#/public/scheduled-tasks/<task_id>`` can fix typos in result MD
@@ -355,6 +356,20 @@ async def public_update_run_file(
         raise HTTPException(status_code=400, detail=str(exc))
 
 
+@router.delete("/runs/{run_id}", status_code=204)
+async def public_delete_run(run_id: str) -> Response:
+    """Remove a single run regardless of owner.
+
+    Anonymous — no ownership check, mirroring the existing public PUT endpoints.
+    Tighten this if the deployment requires read-only public sharing.
+    """
+    service = get_scheduled_task_service()
+    deleted = await service.admin_delete_run(run_id)
+    if not deleted:
+        raise HTTPException(status_code=404, detail=f"Run {run_id} not found")
+    return Response(status_code=204)
+
+
 @router.put("/runs/{run_id}/body")
 async def public_update_run_body(run_id: str, body: PublicRunBodyUpdateRequest) -> dict[str, Any]:
     """Overwrite the inline Markdown body (``result.content``) of a run.

offline-backend-20260512/backend/app/gateway/routers/scheduled_tasks.py

@@ -31,6 +31,7 @@ router = APIRouter(prefix="/api/scheduled-tasks", tags=["scheduled-tasks"])
 
 class ScheduledTaskCreateRequest(BaseModel):
     name: str = Field(default="Scheduled task")
+    description: str | None = None
     prompt: str
     schedule: str
     timezone: str | None = None
@@ -40,6 +41,7 @@ class ScheduledTaskCreateRequest(BaseModel):
 
 class ScheduledTaskUpdateRequest(BaseModel):
     name: str | None = None
+    description: str | None = None
     prompt: str | None = None
     schedule: str | None = None
     timezone: str | None = None
@@ -547,6 +549,7 @@ async def create_scheduled_task(body: ScheduledTaskCreateRequest, request: Reque
         task = await service.create_task(
             user_id=user_id,
             name=body.name,
+            description=body.description,
             prompt=body.prompt,
             schedule=body.schedule,
             timezone=body.timezone,

offline-backend-20260512/backend/packages/harness/deerflow/persistence/engine.py

@@ -11,14 +11,16 @@ None and fall back to in-memory implementations.
 from __future__ import annotations
 
 import asyncio
-import json
+import json
-import logging
+import logging
-import os
+import os
-import sys
+import sys
-from importlib.util import find_spec
+from importlib.util import find_spec
-from pathlib import Path
+from pathlib import Path
-
+
-from sqlalchemy.ext.asyncio import AsyncEngine, AsyncSession, async_sessionmaker, create_async_engine
+from sqlalchemy import text
+from sqlalchemy.engine import make_url
+from sqlalchemy.ext.asyncio import AsyncEngine, AsyncSession, async_sessionmaker, create_async_engine
 
 
 def _json_serializer(obj: object) -> str:
@@ -131,7 +133,7 @@ async def _run_alembic_upgrade(url: str) -> None:
         logger.exception("Auto-applying Alembic migrations failed; continuing with create_all schema")
 
 
-async def _auto_create_postgres_db(url: str) -> None:
+async def _auto_create_postgres_db(url: str) -> None:
     """Connect to the ``postgres`` maintenance DB and CREATE DATABASE.
 
     The target database name is extracted from *url*.  The connection is
@@ -154,11 +156,50 @@ async def _auto_create_postgres_db(url: str) -> None:
         async with maint_engine.connect() as conn:
             await conn.execute(text(f'CREATE DATABASE "{db_name}"'))
         logger.info("Auto-created PostgreSQL database: %s", db_name)
-    finally:
+    finally:
-        await maint_engine.dispose()
+        await maint_engine.dispose()
-
+
-
+
-async def init_engine(
+async def _auto_create_mysql_db(url: str) -> None:
+    """Create the target MySQL database when it is missing.
+
+    ``create_all`` can create tables, but MySQL requires the database/schema to
+    exist before the application URL can connect. We connect to the built-in
+    ``mysql`` maintenance database on the same server and issue a conservative
+    ``CREATE DATABASE IF NOT EXISTS``.
+    """
+
+    parsed = make_url(url)
+    db_name = parsed.database
+    if not db_name:
+        raise ValueError("Cannot auto-create MySQL database: no database name in URL")
+
+    maint_url = parsed.set(database="mysql")
+    maint_engine = create_async_engine(
+        maint_url.render_as_string(hide_password=False),
+        isolation_level="AUTOCOMMIT",
+        pool_pre_ping=True,
+    )
+    quoted = "`" + db_name.replace("`", "``") + "`"
+    try:
+        async with maint_engine.connect() as conn:
+            await conn.execute(
+                text(
+                    f"CREATE DATABASE IF NOT EXISTS {quoted} "
+                    "CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci"
+                )
+            )
+        logger.info("Auto-created MySQL database if missing: %s", db_name)
+    finally:
+        await maint_engine.dispose()
+
+
+def _is_mysql_unknown_database_error(exc: Exception) -> bool:
+    message = str(exc).lower()
+    return "unknown database" in message or "1049" in message
+
+
+async def init_engine(
     backend: str,
     *,
     url: str = "",
@@ -261,21 +302,37 @@ async def init_engine(
         # This is expected during initial scaffolding or minimal installs.
         logger.debug("deerflow.persistence.models not found; skipping auto-create tables")
 
-    try:
+    try:
-        async with _engine.begin() as conn:
+        async with _engine.begin() as conn:
-            await conn.run_sync(Base.metadata.create_all)
+            await conn.run_sync(Base.metadata.create_all)
-    except Exception as exc:
+    except Exception as exc:
-        if backend == "postgres" and "does not exist" in str(exc):
+        if backend == "postgres" and "does not exist" in str(exc):
             # Database not yet created — attempt to auto-create it, then retry.
             await _auto_create_postgres_db(url)
             # Rebuild engine against the now-existing database
             await _engine.dispose()
             _engine = create_async_engine(url, echo=echo, pool_size=pool_size, pool_pre_ping=True, json_serializer=_json_serializer)
-            _session_factory = async_sessionmaker(_engine, expire_on_commit=False)
+            _session_factory = async_sessionmaker(_engine, expire_on_commit=False)
-            async with _engine.begin() as conn:
+            async with _engine.begin() as conn:
-                await conn.run_sync(Base.metadata.create_all)
+                await conn.run_sync(Base.metadata.create_all)
-        else:
+        elif backend == "mysql" and _is_mysql_unknown_database_error(exc):
-            raise
+            # Database not yet created. Create it, rebuild the app engine
+            # against the target DB, then let SQLAlchemy create all tables.
+            await _auto_create_mysql_db(url)
+            await _engine.dispose()
+            _engine = create_async_engine(
+                url,
+                echo=echo,
+                pool_size=pool_size,
+                pool_pre_ping=True,
+                pool_recycle=1800,
+                json_serializer=_json_serializer,
+            )
+            _session_factory = async_sessionmaker(_engine, expire_on_commit=False)
+            async with _engine.begin() as conn:
+                await conn.run_sync(Base.metadata.create_all)
+        else:
+            raise
 
     # Apply in-place schema fixes (column widenings, etc.) that ``create_all``
     # cannot do on its own. Failures don't abort startup — see the helper.

offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260521_02_merge_agent_pins_and_memory_heads.py

@@ -0,0 +1,24 @@
+"""Merge agent pin/featured and user memory config migration heads.
+
+Revision ID: 20260521_02
+Revises: 20260520_03, 20260521_01
+Create Date: 2026-05-21
+"""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+
+
+revision: str = "20260521_02"
+down_revision: str | tuple[str, str] = ("20260520_03", "20260521_01")
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    pass
+
+
+def downgrade() -> None:
+    pass

offline-backend-20260512/backend/packages/harness/deerflow/persistence/migrations/versions/20260522_01_scheduled_task_description.py

@@ -0,0 +1,36 @@
+"""Add description column to scheduled_tasks.
+
+Revision ID: 20260522_01
+Revises: 20260521_02
+Create Date: 2026-05-22
+"""
+
+from __future__ import annotations
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy import inspect
+
+
+revision = "20260522_01"
+down_revision = "20260521_02"
+branch_labels = None
+depends_on = None
+
+
+def _has_column(table_name: str, column_name: str) -> bool:
+    inspector = inspect(op.get_bind())
+    return any(column["name"] == column_name for column in inspector.get_columns(table_name))
+
+
+def upgrade() -> None:
+    if not _has_column("scheduled_tasks", "description"):
+        op.add_column(
+            "scheduled_tasks",
+            sa.Column("description", sa.Text(), nullable=True),
+        )
+
+
+def downgrade() -> None:
+    if _has_column("scheduled_tasks", "description"):
+        op.drop_column("scheduled_tasks", "description")

offline-backend-20260512/backend/packages/harness/deerflow/persistence/scheduled_tasks/model.py

@@ -31,6 +31,7 @@ class ScheduledTaskRow(Base):
     source_agent_name: Mapped[str | None] = mapped_column(String(128), index=True)
     execution_agent_name: Mapped[str | None] = mapped_column(String(128), index=True)
     name: Mapped[str] = mapped_column(String(127))
+    description: Mapped[str | None] = mapped_column(Text)
     prompt: Mapped[str] = mapped_column(Text)
     schedule_text: Mapped[str] = mapped_column(String(256))
     cron_expr: Mapped[str] = mapped_column(String(128))

offline-backend-20260512/backend/packages/harness/deerflow/persistence/scheduled_tasks/sql.py

@@ -76,6 +76,7 @@ class ScheduledTaskRepository(ScheduledTaskStore):
             source_agent_name=data.get("source_agent_name"),
             execution_agent_name=data.get("execution_agent_name"),
             name=data["name"],
+            description=data.get("description"),
             prompt=data["prompt"],
             schedule_text=data["schedule_text"],
             cron_expr=data["cron_expr"],

offline-backend-20260512/backend/packages/harness/deerflow/runtime/scheduler/service.py

@@ -18,6 +18,7 @@ from zoneinfo import ZoneInfo
 from croniter import croniter
 from langgraph.checkpoint.base import empty_checkpoint
 
+from deerflow.config.agents_config import AGENT_ID_PATTERN
 from deerflow.config.paths import get_paths
 from deerflow.persistence.scheduled_tasks import ScheduledTaskStore
 from deerflow.runtime import serialize_channel_values
@@ -445,6 +446,7 @@ class ScheduledTaskService:
         prompt: str,
         schedule: str,
         timezone: str | None = None,
+        description: str | None = None,
         source_thread_id: str | None = None,
         source_agent_name: str | None = None,
         execution_agent_name: str | None = None,
@@ -459,6 +461,7 @@ class ScheduledTaskService:
         context = dict(execution_context or {})
         if execution_agent_name:
             context["agent_name"] = execution_agent_name
+        normalized_description = description.strip() if isinstance(description, str) else None
         task = await self.store.create_task(
             {
                 "task_id": str(uuid.uuid4()),
@@ -468,6 +471,7 @@ class ScheduledTaskService:
                 "source_agent_name": source_agent_name,
                 "execution_agent_name": execution_agent_name,
                 "name": final_name,
+                "description": normalized_description or None,
                 "prompt": prompt.strip(),
                 "schedule_text": schedule.strip(),
                 "cron_expr": cron_expr,
@@ -490,6 +494,15 @@ class ScheduledTaskService:
         for key in ("name", "prompt", "enabled", "execution_agent_name"):
             if key in data and data[key] is not None:
                 update_data[key] = data[key]
+        # Description is nullable — accept ``None`` (clear) and empty strings
+        # (also clear) explicitly, so the field can be removed via PATCH.
+        if "description" in data:
+            raw = data["description"]
+            if isinstance(raw, str):
+                trimmed = raw.strip()
+                update_data["description"] = trimmed or None
+            else:
+                update_data["description"] = None
         # Names are matched against the per-user uniqueness constraint, so keep
         # the stored value trimmed to match create_task's normalization.
         if isinstance(update_data.get("name"), str):
@@ -858,8 +871,17 @@ class ScheduledTaskService:
         try:
             request = SimpleNamespace(app=self.app)
             execution_context = dict(task.get("execution_context") or {})
-            if task.get("execution_agent_name"):
+            stored_agent_ref = task.get("execution_agent_name")
-                execution_context["agent_name"] = task["execution_agent_name"]
+            if stored_agent_ref:
+                resolved_agent_id = await self._resolve_agent_id(stored_agent_ref, task["user_id"])
+                if resolved_agent_id:
+                    execution_context["agent_name"] = resolved_agent_id
+                else:
+                    logger.warning(
+                        "Scheduled task %s references unknown agent %r; falling back to default lead agent",
+                        task.get("task_id"),
+                        stored_agent_ref,
+                    )
             execution_context.update(
                 {
                     "is_scheduled_run": True,
@@ -884,6 +906,35 @@ class ScheduledTaskService:
         finally:
             reset_current_user(token)
 
+    async def _resolve_agent_id(self, stored_ref: str, user_id: str) -> str | None:
+        """Resolve a scheduled task's ``execution_agent_name`` to a stable agent id.
+
+        Older tasks (created before the frontend was fixed) stored the agent's
+        Chinese **display name** here; the runtime validator only accepts ids
+        matching ``^[A-Za-z0-9_-]+$``, so those rows would 422 forever. We
+        gracefully recover by looking the stored value up first as an id, then
+        as a display name. Returns ``None`` when nothing visible matches — the
+        caller then falls back to the default lead agent rather than crashing.
+        """
+        store = getattr(self.app.state, "agent_store", None)
+        if store is None:
+            return stored_ref if AGENT_ID_PATTERN.fullmatch(stored_ref) else None
+        if AGENT_ID_PATTERN.fullmatch(stored_ref):
+            try:
+                row = await store.get_visible(stored_ref, user_id)
+            except Exception:
+                row = None
+            if row is not None:
+                return row["id"]
+        try:
+            agents = await store.list_visible(user_id)
+        except Exception:
+            return None
+        for agent in agents:
+            if agent.get("name") == stored_ref:
+                return agent.get("id")
+        return None
+
     async def _extract_latest_ai_text(self, thread_id: str) -> str | None:
         checkpointer = self.app.state.checkpointer
         config = {"configurable": {"thread_id": thread_id, "checkpoint_ns": ""}}