fix(agent): retain daylight input focus border from sample

Co-authored-by: multica-agent <github@multica.ai>

calliope-backend/contracts.json

@@ -156,7 +156,8 @@
     "job.started",
     "shot.capture.saved",
     "shot.updated",
-    "story.ready"
+    "story.ready",
+    "workbench.stage.updated"
   ],
   "prompt_profiles": [
     "minimax_h3_ref",

calliope-backend/src/calliope/agent/deliverables.py

@@ -0,0 +1,52 @@
+"""Capture successful task replies without treating chat/errors as confirmed work."""
+
+from __future__ import annotations
+
+from calliope.config import settings
+from calliope.db import get_db
+
+
+def complete_task(session_id: int, final: str) -> None:
+    from calliope.agent.harness.plugins.interaction import latest_open_question
+
+    conn = get_db(settings.db_path)
+    try:
+        if latest_open_question(session_id):
+            conn.execute(
+                "UPDATE agent_sessions SET task_status='awaiting_input' WHERE id=?", (session_id,)
+            )
+        else:
+            session = conn.execute(
+                "SELECT * FROM agent_sessions WHERE id=?", (session_id,)
+            ).fetchone()
+            message = conn.execute(
+                "SELECT id FROM agent_messages WHERE session_id=? AND role='assistant' "
+                "AND content=? AND (status IS NULL OR status NOT IN ('error','cancelled')) "
+                "ORDER BY id DESC LIMIT 1",
+                (session_id, final),
+            ).fetchone()
+            if session and message and final.strip():
+                conn.execute(
+                    "INSERT OR IGNORE INTO agent_deliverables "
+                    "(session_id,source_message_id,project_id,stage_key,title,content) "
+                    "VALUES (?,?,?,?,?,?)",
+                    (
+                        session_id,
+                        message["id"],
+                        session["project_id"],
+                        session["agent_key"] or "script",
+                        session["title"][:200],
+                        final,
+                    ),
+                )
+                conn.execute(
+                    "UPDATE agent_sessions SET task_status='awaiting_confirm' WHERE id=?",
+                    (session_id,),
+                )
+            else:
+                conn.execute(
+                    "UPDATE agent_sessions SET task_status='completed' WHERE id=?", (session_id,)
+                )
+        conn.commit()
+    finally:
+        conn.close()

calliope-backend/src/calliope/agent/harness/runner.py

@@ -40,8 +40,10 @@ class AgentRunner:
         conn = self._db()
         try:
             conn.execute(
-                "UPDATE agent_sessions SET status = ?, updated_at = CURRENT_TIMESTAMP WHERE id = ?",
-                (status, session_id),
+                "UPDATE agent_sessions SET status = ?, task_status=CASE "
+                "WHEN ? = 'running' THEN 'running' WHEN ? = 'error' THEN 'error' "
+                "ELSE task_status END, updated_at = CURRENT_TIMESTAMP WHERE id = ?",
+                (status, status, status, session_id),
             )
             conn.commit()
         finally:
@@ -201,7 +203,8 @@ class AgentRunner:
             ).fetchall()]
             if stuck:
                 conn.execute(
-                    "UPDATE agent_sessions SET status = 'idle' WHERE status = 'running'"
+                    "UPDATE agent_sessions SET status = 'idle', task_status='interrupted' "
+                    "WHERE status = 'running'"
                 )
                 conn.commit()
                 logger.warning(
@@ -295,6 +298,15 @@ class AgentRunner:
                 finally:
                     conn.close()
 
+            conn = self._db()
+            try:
+                conn.execute(
+                    "UPDATE agent_sessions SET task_summary=? WHERE id=?",
+                    (user_message.strip()[:300], session_id),
+                )
+                conn.commit()
+            finally:
+                conn.close()
             self._set_status(session_id, "running")
             task = asyncio.create_task(
                 self._run_session(session_id), name=f"agent-session-{session_id}"
@@ -398,6 +410,9 @@ class AgentRunner:
                 session_id=session_id,
                 on_message=self._make_message_sink(session_id, default_agent_name),
             )
+            from calliope.agent.deliverables import complete_task
+
+            complete_task(session_id, final)
             # Final answer is persisted + broadcast by the loop's emit() call
             # (which goes through the message sink). Only set status here.
             self._set_status(session_id, "idle")
@@ -408,6 +423,14 @@ class AgentRunner:
                 content="— run cancelled —",
                 status="cancelled",
             )
+            conn = self._db()
+            try:
+                conn.execute(
+                    "UPDATE agent_sessions SET task_status='cancelled' WHERE id=?", (session_id,)
+                )
+                conn.commit()
+            finally:
+                conn.close()
             self._set_status(session_id, "idle")
             raise
         except Exception as exc:  # noqa: BLE001 — surfaced to the chat as the reply

calliope-backend/src/calliope/db.py

@@ -311,6 +311,36 @@ CREATE TABLE IF NOT EXISTS project_stages (
 );
 CREATE INDEX IF NOT EXISTS idx_project_stages_project ON project_stages(project_id);
 
+-- B4: immutable source identity, editable draft, optimistic concurrency.
+CREATE TABLE IF NOT EXISTS agent_deliverables (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id INTEGER NOT NULL REFERENCES agent_sessions(id) ON DELETE CASCADE,
+    source_message_id INTEGER NOT NULL,
+    project_id INTEGER REFERENCES projects(id) ON DELETE SET NULL,
+    stage_key TEXT NOT NULL CHECK(stage_key IN ('script','style','storyboard','assets','shot')),
+    title TEXT NOT NULL,
+    content TEXT NOT NULL,
+    revision INTEGER NOT NULL DEFAULT 1,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(session_id, source_message_id)
+);
+CREATE TABLE IF NOT EXISTS agent_deliverable_versions (
+    deliverable_id INTEGER NOT NULL REFERENCES agent_deliverables(id) ON DELETE CASCADE,
+    revision INTEGER NOT NULL,
+    content TEXT NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    PRIMARY KEY(deliverable_id, revision)
+);
+CREATE TABLE IF NOT EXISTS result_attachments (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    source_key TEXT NOT NULL,
+    project_id INTEGER NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
+    stage_key TEXT NOT NULL,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(source_key, project_id, stage_key)
+);
+
 -- Audit trail of agent runs inside the flow (HEL-614): instruction in,
 -- normalized JSON artifact out, or a Chinese-readable failure reason.
 CREATE TABLE IF NOT EXISTS stage_runs (
@@ -587,6 +617,13 @@ async def migrate_db(db_path: Path) -> None:
     # born ('chat' = user-created in AI Canvas, 'scene' = auto-created by the
     # Build Scene rail). The session list excludes origin='scene' so scene
     # sessions don't pollute the AI Canvas sidebar; Build Scene filters on it.
+    b4_cols = {r[1] for r in conn.execute("PRAGMA table_info(agent_sessions)")}
+    if "task_summary" not in b4_cols:
+        conn.execute("ALTER TABLE agent_sessions ADD COLUMN task_summary TEXT NOT NULL DEFAULT ''")
+    if "task_status" not in b4_cols:
+        conn.execute(
+            "ALTER TABLE agent_sessions ADD COLUMN task_status TEXT NOT NULL DEFAULT 'ready'"
+        )
     session_cols = {r[1] for r in conn.execute("PRAGMA table_info(agent_sessions)").fetchall()}
     if "origin" not in session_cols:
         conn.execute("ALTER TABLE agent_sessions ADD COLUMN origin TEXT NOT NULL DEFAULT 'chat'")

calliope-backend/src/calliope/main.py

@@ -20,19 +20,24 @@ from calliope.routers import (
     agent,
     assets,
     canvas,
-    comfyui as comfy,
     events,
     jobs,
     library,
     playground,
     projects,
+    results,
     scenes,
-    settings as settings_router,
     shots,
     story,
     workbench,
     workflows,
 )
+from calliope.routers import (
+    comfyui as comfy,
+)
+from calliope.routers import (
+    settings as settings_router,
+)
 
 logging.basicConfig(
     level=logging.INFO,
@@ -141,6 +146,7 @@ def create_app(static_dir: Path | None = None) -> FastAPI:
     app.include_router(library.router, prefix="/api/library", tags=["library"])
     app.include_router(canvas.router, prefix="/api/canvas", tags=["canvas"])
     app.include_router(shots.router, prefix="/api/shots", tags=["shots"])
+    app.include_router(results.router, prefix="/api/results", tags=["results"])
     app.include_router(agent.router, prefix="/api/agent", tags=["agent"])
     app.include_router(workbench.router, prefix="/api/workbench", tags=["workbench"])
     app.include_router(events.router, prefix="/api/events", tags=["events"])

calliope-backend/src/calliope/routers/results.py

@@ -0,0 +1,244 @@
+"""Editable task deliverables and explicit, idempotent result → stage drafts."""
+
+from __future__ import annotations
+
+import json
+from typing import Any
+
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel, Field, model_validator
+
+from calliope.config import settings
+from calliope.db import get_db, row_to_dict
+from calliope.events.bus import event_bus
+from calliope.routers.workbench import StageKey
+
+router = APIRouter()
+
+
+class DraftPatch(BaseModel):
+    revision: int = Field(ge=1)
+    content: str = Field(min_length=1, max_length=200_000)
+    project_id: int | None = None
+    stage_key: StageKey
+
+
+class StoreResult(BaseModel):
+    project_id: int = Field(gt=0)
+    stage_key: StageKey
+    deliverable_id: int | None = Field(default=None, gt=0)
+    revision: int | None = Field(default=None, gt=0)
+    job_id: int | None = Field(default=None, gt=0)
+
+    @model_validator(mode="after")
+    def one_source(self):
+        if (self.deliverable_id is None) == (self.job_id is None):
+            raise ValueError("Choose exactly one result source")
+        if self.deliverable_id is not None and self.revision is None:
+            raise ValueError("Deliverable revision is required")
+        return self
+
+
+def _public(row) -> dict[str, Any]:
+    return row_to_dict(row)
+
+
+@router.get("/deliverables")
+def list_deliverables(session_id: int | None = None) -> list[dict[str, Any]]:
+    conn = get_db(settings.db_path)
+    try:
+        sql = "SELECT * FROM agent_deliverables"
+        args = ()
+        if session_id is not None:
+            sql += " WHERE session_id=?"
+            args = (session_id,)
+        return [_public(r) for r in conn.execute(sql + " ORDER BY id DESC", args)]
+    finally:
+        conn.close()
+
+
+@router.get("/deliverables/{draft_id}/versions")
+def list_versions(draft_id: int) -> list[dict[str, Any]]:
+    conn = get_db(settings.db_path)
+    try:
+        if not conn.execute("SELECT id FROM agent_deliverables WHERE id=?", (draft_id,)).fetchone():
+            raise HTTPException(404, "成果不存在")
+        return [
+            _public(row)
+            for row in conn.execute(
+                "SELECT * FROM agent_deliverable_versions WHERE deliverable_id=? "
+                "ORDER BY revision DESC",
+                (draft_id,),
+            )
+        ]
+    finally:
+        conn.close()
+
+
+@router.patch("/deliverables/{draft_id}")
+def patch_deliverable(draft_id: int, payload: DraftPatch) -> dict[str, Any]:
+    conn = get_db(settings.db_path)
+    try:
+        conn.execute("BEGIN IMMEDIATE")
+        row = conn.execute("SELECT * FROM agent_deliverables WHERE id=?", (draft_id,)).fetchone()
+        if not row:
+            raise HTTPException(404, "成果不存在")
+        if payload.project_id is not None:
+            from calliope.routers.workbench import _get_project
+
+            _get_project(conn, payload.project_id)
+        if row["revision"] != payload.revision:
+            raise HTTPException(409, "草稿已更新，请刷新后重试")
+        # A linked session cannot silently move its work into another project.
+        session = conn.execute(
+            "SELECT project_id FROM agent_sessions WHERE id=?", (row["session_id"],)
+        ).fetchone()
+        if session["project_id"] is not None and payload.project_id != session["project_id"]:
+            raise HTTPException(409, "成果归属与原会话项目不一致")
+        if not payload.content.strip():
+            raise HTTPException(422, "成果内容不能为空")
+        conn.execute(
+            "INSERT INTO agent_deliverable_versions(deliverable_id,revision,content) "
+            "VALUES (?,?,?)",
+            (draft_id, row["revision"], row["content"]),
+        )
+        conn.execute(
+            "UPDATE agent_deliverables SET content=?,project_id=?,stage_key=?,revision=revision+1,"
+            "updated_at=CURRENT_TIMESTAMP WHERE id=?",
+            (payload.content, payload.project_id, payload.stage_key, draft_id),
+        )
+        conn.commit()
+        return _public(
+            conn.execute("SELECT * FROM agent_deliverables WHERE id=?", (draft_id,)).fetchone()
+        )
+    finally:
+        conn.close()
+
+
+@router.post("/store")
+async def store_result(payload: StoreResult) -> dict[str, Any]:
+    from calliope.agent.llm import extract_json
+    from calliope.routers.playground import _assert_path_in_assets
+    from calliope.routers.workbench import (
+        NORMALIZERS,
+        StageContentError,
+        _get_project,
+        _stage_or_404,
+        _stage_public,
+    )
+
+    conn = get_db(settings.db_path)
+    try:
+        conn.execute("BEGIN IMMEDIATE")
+        _get_project(conn, payload.project_id)
+        stage = _stage_or_404(conn, payload.project_id, payload.stage_key)
+        draft = None
+        if payload.deliverable_id is not None:
+            draft = conn.execute(
+                "SELECT * FROM agent_deliverables WHERE id=?", (payload.deliverable_id,)
+            ).fetchone()
+            if not draft:
+                raise HTTPException(404, "成果不存在")
+            if draft["revision"] != payload.revision:
+                raise HTTPException(409, "草稿版本已变化，请先保存并刷新")
+            if draft["project_id"] != payload.project_id or draft["stage_key"] != payload.stage_key:
+                raise HTTPException(409, "请先保存成果的项目与阶段归属")
+            session = conn.execute(
+                "SELECT project_id FROM agent_sessions WHERE id=?", (draft["session_id"],)
+            ).fetchone()
+            if session["project_id"] is not None and session["project_id"] != payload.project_id:
+                raise HTTPException(409, "会话项目已变化，请重新核对成果归属")
+            source_key = f"deliverable:{draft['id']}:{draft['revision']}"
+            result = {
+                "source_key": source_key,
+                "title": draft["title"],
+                "text": draft["content"],
+                "session_id": draft["session_id"],
+            }
+        else:
+            job = conn.execute("SELECT * FROM jobs WHERE id=?", (payload.job_id,)).fetchone()
+            if not job:
+                raise HTTPException(404, "生成结果不存在")
+            project = conn.execute(
+                "SELECT status FROM projects WHERE id=?", (job["project_id"],)
+            ).fetchone()
+            if job["project_id"] != payload.project_id and (
+                not project or project["status"] != "system"
+            ):
+                raise HTTPException(409, "此结果属于其他项目")
+            if job["status"] != "done" or job["kind"] not in ("image", "video"):
+                raise HTTPException(409, "仅可存入已完成的图片或视频")
+            paths = json.loads(job["output_paths_json"] or "[]")
+            if (
+                not paths
+                or not isinstance(paths, list)
+                or not all(isinstance(p, str) for p in paths)
+            ):
+                raise HTTPException(422, "结果没有产物")
+            for path in paths:
+                if not _assert_path_in_assets(path).is_file():
+                    raise HTTPException(410, "产物文件已不存在")
+            source_key = f"job:{job['id']}"
+            result = {
+                "source_key": source_key,
+                "title": f"生成结果 #{job['id']}",
+                "kind": job["kind"],
+                "paths": paths,
+                "job_id": job["id"],
+            }
+        existing = conn.execute(
+            "SELECT id FROM result_attachments WHERE source_key=? AND project_id=? AND stage_key=?",
+            (source_key, payload.project_id, payload.stage_key),
+        ).fetchone()
+        if existing:
+            return {"ok": True, "already_attached": True, "stage": _stage_public(stage)}
+        if stage["status"] == "running":
+            raise HTTPException(409, "本阶段正在生成，请稍后再存入")
+        content = json.loads(stage["content_json"] or "{}")
+        if draft:
+            text = draft["content"].strip()
+            # Valid structured artifacts replace only the working draft.
+            # Confirmed snapshots stay intact.
+            parsed = None
+            try:
+                parsed = extract_json(text)
+            except ValueError:
+                if payload.stage_key == "script":
+                    parsed = {"text": text}
+            if isinstance(parsed, dict):
+                try:
+                    normalized = NORMALIZERS[payload.stage_key](parsed)
+                    normalized["incoming_results"] = content.get("incoming_results", [])
+                    content = normalized
+                except StageContentError as exc:
+                    raise HTTPException(422, str(exc)) from exc
+        incoming = list(content.get("incoming_results") or [])
+        incoming.append(result)
+        content["incoming_results"] = incoming
+        conn.execute(
+            "UPDATE project_stages SET content_json=?,status='awaiting_confirm',draft_edited=1,"
+            "error=NULL,updated_at=CURRENT_TIMESTAMP WHERE project_id=? AND stage_key=?",
+            (json.dumps(content, ensure_ascii=False), payload.project_id, payload.stage_key),
+        )
+        conn.execute(
+            "INSERT INTO result_attachments(source_key,project_id,stage_key) VALUES (?,?,?)",
+            (source_key, payload.project_id, payload.stage_key),
+        )
+        if draft:
+            conn.execute(
+                "UPDATE agent_sessions SET task_status='returned' WHERE id=?",
+                (draft["session_id"],),
+            )
+        conn.execute(
+            "UPDATE projects SET updated_at=CURRENT_TIMESTAMP WHERE id=?", (payload.project_id,)
+        )
+        conn.commit()
+        row = _stage_or_404(conn, payload.project_id, payload.stage_key)
+        out = {"ok": True, "already_attached": False, "stage": _stage_public(row)}
+    finally:
+        conn.close()
+    await event_bus.publish(
+        "workbench.stage.updated",
+        {"project_id": payload.project_id, "stage_key": payload.stage_key},
+    )
+    return out

calliope-backend/src/calliope/routers/workbench.py

@@ -302,6 +302,7 @@ def _stage_public(row: dict[str, Any]) -> dict[str, Any]:
         "status": row["status"],
         "content": content,
         "assistant_note": (content or {}).get("assistant_note", ""),
+        "incoming_results": (content or {}).get("incoming_results", []),
         "confirmed_content": (
             json.loads(row["confirmed_content_json"]) if row["confirmed_content_json"] else None
         ),
@@ -692,6 +693,8 @@ async def patch_stage(project_id: int, stage_key: str, payload: StagePatch) -> d
         except StageContentError as exc:
             raise HTTPException(status_code=400, detail=str(exc)) from exc
         old_content = json.loads(stage["content_json"]) if stage["content_json"] else {}
+        if old_content.get("incoming_results"):
+            content["incoming_results"] = old_content["incoming_results"]
         if old_content.get("assistant_note"):
             content["assistant_note"] = old_content["assistant_note"]
         if content == (json.loads(stage["content_json"]) if stage["content_json"] else None):
@@ -820,6 +823,9 @@ async def confirm_stage(
             content = NORMALIZERS[stage_key](json.loads(stage["content_json"]))
         except StageContentError as exc:
             raise HTTPException(status_code=400, detail=str(exc)) from exc
+        raw_content = json.loads(stage["content_json"])
+        if raw_content.get("incoming_results"):
+            content["incoming_results"] = raw_content["incoming_results"]
         chosen = payload.chosen_style_id if payload else None
         if stage_key == "style":
             directions = content.get("directions") or []

calliope-backend/tests/test_results.py

@@ -0,0 +1,183 @@
+"""B4 draft persistence, concurrency, scope, confirmation and migration regression."""
+
+from __future__ import annotations
+
+import asyncio
+import json
+import sqlite3
+
+from calliope.agent.deliverables import complete_task
+from calliope.agent.harness.runner import runner
+from calliope.config import settings
+from calliope.db import get_db, migrate_db
+
+TEXT = (
+    "第一场，清晨海岸，女孩将纸船推向海面，等待父亲归来。"
+    "第二场，纸船带回树叶，女孩沿着灯塔的光继续前行。"
+)
+
+
+def setup(client, stage="script"):
+    project = client.post("/api/projects", json={"title": "B4 isolated"}).json()
+    session = client.post(
+        "/api/agent/sessions",
+        json={
+            "project_id": project["id"],
+            "agent_key": stage,
+        },
+    ).json()
+    runner._persist_message(session["id"], role="assistant", content=TEXT)
+    complete_task(session["id"], TEXT)
+    draft = client.get("/api/results/deliverables", params={"session_id": session["id"]}).json()[0]
+    return project["id"], session["id"], draft
+
+
+def store(client, pid, draft, stage="script"):
+    return client.post(
+        "/api/results/store",
+        json={
+            "project_id": pid,
+            "stage_key": stage,
+            "deliverable_id": draft["id"],
+            "revision": draft["revision"],
+        },
+    )
+
+
+def test_draft_save_refresh_conflict_and_scope(client):
+    pid, sid, draft = setup(client)
+    body = {"revision": 1, "content": TEXT + "新结尾。", "project_id": pid, "stage_key": "script"}
+    saved = client.patch(f"/api/results/deliverables/{draft['id']}", json=body)
+    assert saved.status_code == 200
+    assert saved.json()["revision"] == 2
+    versions = client.get(f"/api/results/deliverables/{draft['id']}/versions").json()
+    assert len(versions) == 1 and versions[0]["content"] == TEXT
+    assert (
+        client.get("/api/results/deliverables", params={"session_id": sid}).json()[0]
+        == saved.json()
+    )
+    assert client.patch(f"/api/results/deliverables/{draft['id']}", json=body).status_code == 409
+    assert store(client, pid, draft).status_code == 409
+    other = client.post("/api/projects", json={"title": "Other"}).json()["id"]
+    assert store(client, other, saved.json()).status_code == 409
+    body.update(revision=2, project_id=other)
+    assert client.patch(f"/api/results/deliverables/{draft['id']}", json=body).status_code == 409
+    assert client.get(f"/api/agent/sessions/{sid}").json()["task_status"] == "awaiting_confirm"
+
+
+def test_store_idempotency_confirm_restore_and_preserve_snapshot(client):
+    pid, sid, draft = setup(client)
+    url = f"/api/workbench/projects/{pid}/stages/script"
+    old = {"text": TEXT + "已确认的旧版。"}
+    assert client.patch(url, json={"content": old}).status_code == 200
+    snapshot = client.post(url + "/confirm", json={}).json()["stage"]["confirmed_content"]
+    res = store(client, pid, draft)
+    assert res.status_code == 200, res.text
+    stage = res.json()["stage"]
+    assert stage["status"] == "awaiting_confirm"
+    assert stage["confirmed_content"] == snapshot
+    assert stage["content"]["text"] == TEXT
+    assert len(stage["incoming_results"]) == 1
+    assert store(client, pid, draft).json()["already_attached"] is True
+    assert len(store(client, pid, draft).json()["stage"]["incoming_results"]) == 1
+    assert client.get(f"/api/agent/sessions/{sid}").json()["task_status"] == "returned"
+    assert client.post(url + "/restore", json={}).json()["stage"]["content"] == snapshot
+    # A newer source revision is a new explicit handoff, never an automatic update.
+    draft = client.patch(
+        f"/api/results/deliverables/{draft['id']}",
+        json={
+            "revision": 1,
+            "content": TEXT + "新版本。",
+            "project_id": pid,
+            "stage_key": "script",
+        },
+    ).json()
+    assert store(client, pid, draft).status_code == 200
+    confirmed = client.post(url + "/confirm", json={}).json()["stage"]["confirmed_content"]
+    assert confirmed["text"].endswith("新版本。")
+    assert len(confirmed["incoming_results"]) == 1
+    stages = client.get(f"/api/workbench/projects/{pid}").json()["stages"]
+    assert all(s["status"] == "todo" for s in stages if s["stage_key"] != "script")
+
+
+def test_capture_idempotency_and_no_error_artifact(client):
+    _, sid, _ = setup(client)
+    complete_task(sid, TEXT)
+    assert len(client.get("/api/results/deliverables", params={"session_id": sid}).json()) == 1
+    runner._persist_message(sid, role="assistant", content="error", status="error")
+    complete_task(sid, "error")
+    assert len(client.get("/api/results/deliverables", params={"session_id": sid}).json()) == 1
+
+
+def test_sandbox_assignment_and_running_stage(client):
+    pid, _, draft = setup(client)
+    conn = get_db(settings.db_path)
+    conn.execute("UPDATE project_stages SET status='running' WHERE project_id=?", (pid,))
+    conn.commit()
+    conn.close()
+    # Stage rows are created lazily; ensure they exist first.
+    client.get(f"/api/workbench/projects/{pid}")
+    conn = get_db(settings.db_path)
+    conn.execute("UPDATE project_stages SET status='running' WHERE project_id=?", (pid,))
+    conn.commit()
+    conn.close()
+    assert store(client, pid, draft).status_code == 409
+    assert client.get("/api/results/deliverables", params={"session_id": 99999}).json() == []
+
+
+def test_media_paths_scope_and_empty_errors(client):
+    pid, _, _ = setup(client)
+    other = client.post("/api/projects", json={"title": "other"}).json()["id"]
+    path = settings.assets_dir / "b4.txt"
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text("isolated")
+    conn = get_db(settings.db_path)
+    job = conn.execute(
+        "INSERT INTO jobs(project_id,kind,status,output_paths_json) VALUES (?,'image','done',?)",
+        (pid, json.dumps([str(path)])),
+    ).lastrowid
+    conn.commit()
+    conn.close()
+    body = {"job_id": job, "project_id": other, "stage_key": "assets"}
+    assert client.post("/api/results/store", json=body).status_code == 409
+    body["project_id"] = pid
+    result = client.post("/api/results/store", json=body)
+    assert result.status_code == 200, result.text
+    assert result.json()["stage"]["incoming_results"][0]["paths"] == [str(path)]
+    assert client.post("/api/results/store", json=body).json()["already_attached"]
+    assert (
+        client.post(
+            "/api/results/store", json={"project_id": pid, "stage_key": "bogus", "job_id": job}
+        ).status_code
+        == 422
+    )
+    assert (
+        client.post(
+            "/api/results/store", json={"project_id": pid, "stage_key": "assets"}
+        ).status_code
+        == 422
+    )
+    path.unlink()
+    assert client.post("/api/results/store", json=body).status_code == 404
+
+
+def test_migration_twice_and_sqlite_backup_rollback(client, tmp_path):
+    pid, sid, draft = setup(client)
+    conn = sqlite3.connect(settings.db_path)
+    backup = sqlite3.connect(tmp_path / "before-b4.db")
+    conn.backup(backup)
+    backup.close()
+    conn.close()
+    asyncio.run(migrate_db(settings.db_path))
+    asyncio.run(migrate_db(settings.db_path))
+    assert client.get("/api/results/deliverables").json()[0]["content"] == draft["content"]
+    conn = get_db(settings.db_path)
+    # Old-code SQL continues reading the original schema and rows.
+    assert (
+        conn.execute(
+            "SELECT title,status,project_id FROM agent_sessions WHERE id=?", (sid,)
+        ).fetchone()["project_id"]
+        == pid
+    )
+    assert conn.execute("PRAGMA integrity_check").fetchone()[0] == "ok"
+    conn.close()

calliope-web/eslint.config.js

@@ -0,0 +1,49 @@
+import js from "@eslint/js";
+import globals from "globals";
+import tsParser from "@typescript-eslint/parser";
+import tsPlugin from "@typescript-eslint/eslint-plugin";
+import svelte from "eslint-plugin-svelte";
+
+export default [
+  // SvelteKit sync and adapter-static output; these are not source files.
+  { ignores: [".svelte-kit/**", "build/**"] },
+  js.configs.recommended,
+  ...svelte.configs["flat/recommended"],
+  // v3 removed these from recommended; retain the previous checks explicitly.
+  {
+    rules: {
+      "svelte/valid-compile": "error",
+      "svelte/no-dynamic-slot-name": "error",
+    },
+  },
+  {
+    files: ["**/*.{ts,svelte}"],
+    plugins: { "@typescript-eslint": tsPlugin },
+    rules: {
+      ...tsPlugin.configs["eslint-recommended"].overrides[0].rules,
+      ...tsPlugin.configs.recommended.rules,
+    },
+  },
+  {
+    files: ["**/*.ts"],
+    ignores: ["**/*.svelte.ts"],
+    languageOptions: { parser: tsParser },
+  },
+  {
+    files: ["**/*.svelte", "**/*.svelte.ts", "**/*.svelte.js"],
+    languageOptions: { parserOptions: { parser: tsParser } },
+    rules: {
+      "prefer-const": "off",
+      "svelte/prefer-const": "error",
+    },
+  },
+  {
+    files: ["src/**/*.{js,ts,svelte}"],
+    ignores: ["src/hooks.server.ts"],
+    languageOptions: { globals: globals.browser },
+  },
+  {
+    files: ["*.{js,ts}", "scripts/**/*.mjs", "src/hooks.server.ts"],
+    languageOptions: { globals: globals.node },
+  },
+];

calliope-web/package.json

@@ -1,39 +1,41 @@
 {
-	"name": "calliope-web",
-	"version": "1.5.8",
-	"private": true,
-	"scripts": {
-		"dev": "vite dev",
-		"build": "vite build",
-		"preview": "vite preview",
-		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-		"test": "node scripts/check-storage-ssr.mjs && node scripts/check-random-uuid.mjs && node scripts/check-skill-frontmatter.mjs && node scripts/check-export-frame.mjs",
-		"lint": "prettier --check . && eslint .",
-		"format": "prettier --write ."
-	},
-	"devDependencies": {
-		"@sveltejs/adapter-static": "^3.0.8",
-		"@sveltejs/kit": "^2.70.3",
-		"@sveltejs/vite-plugin-svelte": "^5.0.0",
-		"@types/node": "^22.13.0",
-		"autoprefixer": "^10.4.20",
-		"eslint": "^9.20.0",
-		"eslint-plugin-svelte": "^2.46.0",
-		"postcss": "^8.5.0",
-		"prettier": "^3.5.0",
-		"prettier-plugin-svelte": "^3.3.0",
-		"svelte": "^5.20.0",
-		"svelte-check": "^4.1.0",
-		"tailwindcss": "^3.4.17",
-		"typescript": "^5.7.0",
-		"vite": "^6.1.0"
-	},
-	"dependencies": {
-		"@tanstack/svelte-query": "^5.66.0",
-		"@types/three": "0.185.0",
-		"@xyflow/svelte": "^1.6.5",
-		"mannequin-js": "5.2.3",
-		"three": "0.185.1"
-	},
-	"type": "module"
+  "name": "calliope-web",
+  "version": "1.5.8",
+  "private": true,
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build",
+    "preview": "vite preview",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "test": "node scripts/check-storage-ssr.mjs && node scripts/check-random-uuid.mjs && node scripts/check-skill-frontmatter.mjs && node scripts/check-export-frame.mjs",
+    "lint": "prettier --check . && eslint .",
+    "format": "prettier --write ."
+  },
+  "devDependencies": {
+    "@sveltejs/adapter-static": "^3.0.8",
+    "@sveltejs/kit": "^2.70.3",
+    "@sveltejs/vite-plugin-svelte": "^5.0.0",
+    "@types/node": "^22.13.0",
+    "@typescript-eslint/eslint-plugin": "8.46.2",
+    "@typescript-eslint/parser": "8.46.2",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^9.20.0",
+    "eslint-plugin-svelte": "3.23.1",
+    "postcss": "^8.5.0",
+    "prettier": "^3.5.0",
+    "prettier-plugin-svelte": "^3.3.0",
+    "svelte": "^5.20.0",
+    "svelte-check": "^4.1.0",
+    "tailwindcss": "^3.4.17",
+    "typescript": "^5.7.0",
+    "vite": "^6.1.0"
+  },
+  "dependencies": {
+    "@tanstack/svelte-query": "^5.66.0",
+    "@types/three": "0.185.0",
+    "@xyflow/svelte": "^1.6.5",
+    "mannequin-js": "5.2.3",
+    "three": "0.185.1"
+  },
+  "type": "module"
 }

calliope-web/scripts/check-skill-frontmatter.mjs

@@ -98,9 +98,9 @@ check(
   JSON.stringify(stripSkillFrontmatter(plain)),
 );
 
-// 5. Static: the page uses the shared helper; no `\A` regex remains.
+// 5. Static: the extracted skill editor uses the shared helper; no `\A` regex remains.
 const page = readFileSync(
-  join(ROOT, "src/routes/agents/+page.svelte"),
+  join(ROOT, "src/lib/components/agent/LegacyAgentWorkspace.svelte"),
   "utf-8",
 );
 check(

calliope-web/scripts/check-storage-ssr.mjs

@@ -16,51 +16,53 @@
  *
  * Run with `npm test` (or `node scripts/check-storage-ssr.mjs`).
  */
-import { readFileSync, readdirSync, statSync } from 'node:fs';
-import { dirname, join, relative } from 'node:path';
-import { fileURLToPath, pathToFileURL } from 'node:url';
+import { readFileSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const HERE = dirname(fileURLToPath(import.meta.url));
-const ROOT = join(HERE, '..');
-const SRC = join(ROOT, 'src');
-const HELPER = join(SRC, 'lib', 'storage.ts');
+const ROOT = join(HERE, "..");
+const SRC = join(ROOT, "src");
+const HELPER = join(SRC, "lib", "storage.ts");
 
 let failures = 0;
 
 function fail(message) {
-	failures += 1;
-	console.error(`FAIL  ${message}`);
+  failures += 1;
+  console.error(`FAIL  ${message}`);
 }
 
 function ok(message) {
-	console.log(`ok    ${message}`);
+  console.log(`ok    ${message}`);
 }
 
 /** Replace the global under test. Node's own binding may be getter-only. */
 function setGlobalStorage(value) {
-	Object.defineProperty(globalThis, 'localStorage', {
-		value,
-		configurable: true,
-		writable: true,
-	});
+  Object.defineProperty(globalThis, "localStorage", {
+    value,
+    configurable: true,
+    writable: true,
+  });
 }
 
 /** A Storage that behaves like a browser's. */
 function fakeStorage(initial = {}) {
-	const map = new Map(Object.entries(initial));
-	return {
-		getItem: (k) => (map.has(k) ? map.get(k) : null),
-		setItem: (k, v) => void map.set(k, String(v)),
-		removeItem: (k) => void map.delete(k),
-		clear: () => map.clear(),
-		key: (i) => [...map.keys()][i] ?? null,
-		get length() {
-			return map.size;
-		},
-	};
+  const map = new Map(Object.entries(initial));
+  return {
+    getItem: (k) => (map.has(k) ? map.get(k) : null),
+    setItem: (k, v) => void map.set(k, String(v)),
+    removeItem: (k) => void map.delete(k),
+    clear: () => map.clear(),
+    key: (i) => [...map.keys()][i] ?? null,
+    get length() {
+      return map.size;
+    },
+  };
 }
 
-const { storageGet, storageSet, storageRemove } = await import(pathToFileURL(HELPER).href);
+const { storageGet, storageSet, storageRemove } = await import(
+  pathToFileURL(HELPER).href
+);
 
 // ---- 1. behavioural ----------------------------------------------------
 
@@ -68,124 +70,133 @@ const { storageGet, storageSet, storageRemove } = await import(pathToFileURL(HEL
 // This is the configuration that produced the original crash.
 setGlobalStorage({});
 try {
-	if (storageGet('calliope-lang') !== null) fail('method-less localStorage: expected null');
-	else if (storageSet('calliope-lang', 'ja') !== undefined) fail('method-less localStorage: setItem should no-op');
-	else {
-		storageRemove('calliope-lang');
-		ok('method-less localStorage (Node SSR shape) degrades to null without throwing');
-	}
+  if (storageGet("calliope-lang") !== null)
+    fail("method-less localStorage: expected null");
+  else if (storageSet("calliope-lang", "ja") !== undefined)
+    fail("method-less localStorage: setItem should no-op");
+  else {
+    storageRemove("calliope-lang");
+    ok(
+      "method-less localStorage (Node SSR shape) degrades to null without throwing",
+    );
+  }
 } catch (err) {
-	fail(`method-less localStorage threw: ${err.message}`);
+  fail(`method-less localStorage threw: ${err.message}`);
 }
 
 // Absent entirely (the common server case).
 setGlobalStorage(undefined);
 try {
-	if (storageGet('k') !== null) fail('undefined localStorage: expected null');
-	else ok('absent localStorage degrades to null');
+  if (storageGet("k") !== null) fail("undefined localStorage: expected null");
+  else ok("absent localStorage degrades to null");
 } catch (err) {
-	fail(`undefined localStorage threw: ${err.message}`);
+  fail(`undefined localStorage threw: ${err.message}`);
 }
 
 // Access itself can throw (sandboxed frame / blocked third-party storage).
 setGlobalStorage(
-	new Proxy(
-		{},
-		{
-			get() {
-				throw new Error('SecurityError');
-			},
-		},
-	),
+  new Proxy(
+    {},
+    {
+      get() {
+        throw new Error("SecurityError");
+      },
+    },
+  ),
 );
 try {
-	if (storageGet('k') !== null) fail('throwing localStorage: expected null');
-	else ok('throwing localStorage access degrades to null');
+  if (storageGet("k") !== null) fail("throwing localStorage: expected null");
+  else ok("throwing localStorage access degrades to null");
 } catch (err) {
-	fail(`throwing localStorage access threw: ${err.message}`);
+  fail(`throwing localStorage access threw: ${err.message}`);
 }
 
 // Quota / private-mode errors on write must not escape.
 setGlobalStorage({
-	getItem: () => null,
-	setItem: () => {
-		throw new Error('QuotaExceededError');
-	},
-	removeItem: () => {},
+  getItem: () => null,
+  setItem: () => {
+    throw new Error("QuotaExceededError");
+  },
+  removeItem: () => {},
 });
 try {
-	storageSet('k', 'v');
-	ok('setItem failure is swallowed');
+  storageSet("k", "v");
+  ok("setItem failure is swallowed");
 } catch (err) {
-	fail(`setItem failure escaped: ${err.message}`);
+  fail(`setItem failure escaped: ${err.message}`);
 }
 
 // A real browser Storage must still work — guards against a helper that just
 // returns null unconditionally to satisfy the checks above.
 setGlobalStorage(fakeStorage());
 try {
-	storageSet('calliope-lang', 'ko');
-	const read = storageGet('calliope-lang');
-	if (read !== 'ko') fail(`working storage round-trip: expected "ko", got ${JSON.stringify(read)}`);
-	else {
-		storageRemove('calliope-lang');
-		if (storageGet('calliope-lang') !== null) fail('working storage remove: expected null');
-		else ok('working storage round-trips and removes');
-	}
+  storageSet("calliope-lang", "ko");
+  const read = storageGet("calliope-lang");
+  if (read !== "ko")
+    fail(
+      `working storage round-trip: expected "ko", got ${JSON.stringify(read)}`,
+    );
+  else {
+    storageRemove("calliope-lang");
+    if (storageGet("calliope-lang") !== null)
+      fail("working storage remove: expected null");
+    else ok("working storage round-trips and removes");
+  }
 } catch (err) {
-	fail(`working storage threw: ${err.message}`);
+  fail(`working storage threw: ${err.message}`);
 }
 
 // ---- 2. static ---------------------------------------------------------
 
 const UNSAFE = /typeof\s+localStorage/;
-const EXTENSIONS = ['.ts', '.js', '.svelte'];
+const EXTENSIONS = [".ts", ".js", ".svelte"];
 
 function walk(dir) {
-	const found = [];
-	for (const entry of readdirSync(dir, { withFileTypes: true })) {
-		const full = join(dir, entry.name);
-		if (entry.isDirectory()) {
-			if (entry.name === 'node_modules') continue;
-			found.push(...walk(full));
-		} else if (EXTENSIONS.some((ext) => entry.name.endsWith(ext))) {
-			found.push(full);
-		}
-	}
-	return found;
+  const found = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      if (entry.name === "node_modules") continue;
+      found.push(...walk(full));
+    } else if (EXTENSIONS.some((ext) => entry.name.endsWith(ext))) {
+      found.push(full);
+    }
+  }
+  return found;
 }
 
 function exists(p) {
-	try {
-		return statSync(p).isFile();
-	} catch {
-		return false;
-	}
+  try {
+    return statSync(p).isFile();
+  } catch {
+    return false;
+  }
 }
 
 const offenders = [];
 for (const file of walk(SRC)) {
-	if (file === HELPER) continue; // the one place allowed to probe the global
-	const lines = readFileSync(file, 'utf8').split('\n');
-	lines.forEach((line, i) => {
-		if (UNSAFE.test(line)) offenders.push(`${relative(ROOT, file)}:${i + 1}: ${line.trim()}`);
-	});
+  if (file === HELPER) continue; // the one place allowed to probe the global
+  const lines = readFileSync(file, "utf8").split("\n");
+  lines.forEach((line, i) => {
+    if (UNSAFE.test(line))
+      offenders.push(`${relative(ROOT, file)}:${i + 1}: ${line.trim()}`);
+  });
 }
 
 if (offenders.length) {
-	fail(
-		`unsafe \`typeof localStorage\` guard outside lib/storage.ts — use storageGet/storageSet instead:\n  ${offenders.join('\n  ')}`,
-	);
+  fail(
+    `unsafe \`typeof localStorage\` guard outside lib/storage.ts — use storageGet/storageSet instead:\n  ${offenders.join("\n  ")}`,
+  );
 } else {
-	ok('no unsafe `typeof localStorage` guards in src/');
+  ok("no unsafe `typeof localStorage` guards in src/");
 }
 
-if (!exists(HELPER)) fail('src/lib/storage.ts is missing');
+if (!exists(HELPER)) fail("src/lib/storage.ts is missing");
 
 // ---- result ------------------------------------------------------------
 
 if (failures) {
-	console.error(`\n${failures} storage/SSR check(s) failed.`);
-	process.exit(1);
+  console.error(`\n${failures} storage/SSR check(s) failed.`);
+  process.exit(1);
 }
-console.log('\nstorage SSR checks passed.');
+console.log("\nstorage SSR checks passed.");

calliope-web/src/app.html

@@ -1,19 +1,30 @@
-<!DOCTYPE html>
-<html lang="en">
-	<head>
-		<meta charset="utf-8" />
-		<link rel="icon" href="%sveltekit.assets%/favicon.png" />
-		<meta name="viewport" content="width=device-width, initial-scale=1" />
-		<title>影工坊</title>
-		<link rel="preconnect" href="https://fonts.googleapis.com" />
-		<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
-		<link
-			href="https://fonts.googleapis.com/css2?family=Outfit:wght@400;500;600;700&family=IBM+Plex+Sans:wght@400;500;600&family=JetBrains+Mono:wght@400;500&family=Noto+Sans+SC:wght@400;500;600&display=swap"
-			rel="stylesheet"
-		/>
-		%sveltekit.head%
-	</head>
-	<body data-sveltekit-preload-data="hover">
-		<div style="display: contents">%sveltekit.body%</div>
-	</body>
+<!doctype html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="utf-8" />
+    <script>
+      (function () {
+        var saved;
+        try {
+          saved = localStorage.getItem("aigc-theme");
+        } catch (_) {}
+        document.documentElement.dataset.theme =
+          /^(night|day|grade|bluehour)$/.test(saved || "") ? saved : "night";
+      })();
+    </script>
+    <link rel="stylesheet" href="%sveltekit.assets%/themes.css" />
+    <link rel="icon" href="%sveltekit.assets%/favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>影工坊</title>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Outfit:wght@400;500;600;700&family=IBM+Plex+Sans:wght@400;500;600&family=JetBrains+Mono:wght@400;500&family=Noto+Sans+SC:wght@400;500;600&display=swap"
+      rel="stylesheet"
+    />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
 </html>

calliope-web/src/hooks.client.ts

@@ -1,9 +1,9 @@
-import type { HandleClientError } from '@sveltejs/kit';
-import { t } from '$lib/i18n.svelte';
+import type { HandleClientError } from "@sveltejs/kit";
+import { t } from "$lib/i18n.svelte";
 
 export const handleError: HandleClientError = ({ error }) => {
-	console.error(error);
-	return {
-		message: t('global.somethingWentWrong'),
-	};
+  console.error(error);
+  return {
+    message: t("global.somethingWentWrong"),
+  };
 };

calliope-web/src/hooks.server.ts

@@ -1,4 +1,4 @@
 export async function handle({ event, resolve }) {
-	const response = await resolve(event);
-	return response;
+  const response = await resolve(event);
+  return response;
 }

calliope-web/src/lib/actions/spotlight.ts

@@ -1,17 +1,17 @@
-import type { Action } from 'svelte/action';
+import type { Action } from "svelte/action";
 
 /** A local honeycomb highlight follows the pointer, independent of selected state. */
 export const spotlight: Action<HTMLElement> = (node) => {
-	const move = (event: PointerEvent) => {
-		if (
-			document.documentElement.dataset.reduce === '1' ||
-			event.pointerType === 'touch'
-		)
-			return;
-		const rect = node.getBoundingClientRect();
-		node.style.setProperty('--pointer-x', `${event.clientX - rect.left}px`);
-		node.style.setProperty('--pointer-y', `${event.clientY - rect.top}px`);
-	};
-	node.addEventListener('pointermove', move);
-	return { destroy: () => node.removeEventListener('pointermove', move) };
+  const move = (event: PointerEvent) => {
+    if (
+      document.documentElement.dataset.reduce === "1" ||
+      event.pointerType === "touch"
+    )
+      return;
+    const rect = node.getBoundingClientRect();
+    node.style.setProperty("--pointer-x", `${event.clientX - rect.left}px`);
+    node.style.setProperty("--pointer-y", `${event.clientY - rect.top}px`);
+  };
+  node.addEventListener("pointermove", move);
+  return { destroy: () => node.removeEventListener("pointermove", move) };
 };

calliope-web/src/lib/agentComposer.ts

@@ -2,50 +2,50 @@
  * Shared types and helpers for the Agent composer (@workflow mentions + attachments).
  */
 
-export type WorkflowKind = 'image' | 'video';
-export type AttachmentKind = 'image' | 'video' | 'audio' | 'document';
+export type WorkflowKind = "image" | "video";
+export type AttachmentKind = "image" | "video" | "audio" | "document";
 
 export interface WorkflowMention {
-	type: 'workflow';
-	id: number;
-	name: string;
-	kind: WorkflowKind;
+  type: "workflow";
+  id: number;
+  name: string;
+  kind: WorkflowKind;
 }
 
 export interface AgentAttachment {
-	path: string;
-	name: string;
-	kind: AttachmentKind;
+  path: string;
+  name: string;
+  kind: AttachmentKind;
 }
 
 export interface AgentComposerPayload {
-	content: string;
-	mentions: (WorkflowMention | SkillMention)[];
-	attachments: AgentAttachment[];
-	/** question/asked seq this message answers (question-card click). */
-	answer_to?: number;
+  content: string;
+  mentions: (WorkflowMention | SkillMention)[];
+  attachments: AgentAttachment[];
+  /** question/asked seq this message answers (question-card click). */
+  answer_to?: number;
 }
 
 export interface WorkflowOption {
-	id: number;
-	name: string;
-	kind: WorkflowKind;
-	description?: string | null;
-	is_enabled?: boolean;
+  id: number;
+  name: string;
+  kind: WorkflowKind;
+  description?: string | null;
+  is_enabled?: boolean;
 }
 
 export interface SkillOption {
-	name: string;
-	description: string;
-	tags: string[];
+  name: string;
+  description: string;
+  tags: string[];
 }
 
 /** A `/skill` command inserted as a chip. Serialized into the message's
  * mentions payload so the backend can project it into the LLM context. */
 export interface SkillMention {
-	type: 'skill';
-	name: string;
-	description: string;
+  type: "skill";
+  name: string;
+  description: string;
 }
 
 export const MAX_WORKFLOW_MENTIONS = 1;
@@ -53,27 +53,36 @@ export const MAX_WORKFLOW_MENTIONS = 1;
 export const MENTION_LIMIT = 12;
 
 /** Case-insensitive name filter of enabled workflows, capped for the typeahead. */
-export function filterWorkflows(workflows: WorkflowOption[], query: string): WorkflowOption[] {
-	const q = query.trim().toLowerCase();
-	const enabled = workflows.filter((w) => w.is_enabled !== false);
-	const matched = q
-		? enabled.filter((w) => w.name.toLowerCase().includes(q))
-		: enabled;
-	return matched.slice(0, MENTION_LIMIT);
+export function filterWorkflows(
+  workflows: WorkflowOption[],
+  query: string,
+): WorkflowOption[] {
+  const q = query.trim().toLowerCase();
+  const enabled = workflows.filter((w) => w.is_enabled !== false);
+  const matched = q
+    ? enabled.filter((w) => w.name.toLowerCase().includes(q))
+    : enabled;
+  return matched.slice(0, MENTION_LIMIT);
 }
 
 /** Case-insensitive filter of skills for the `/` typeahead (name + description). */
-export function filterSkills(skills: SkillOption[], query: string): SkillOption[] {
-	const q = query.trim().toLowerCase();
-	const matched = q
-		? skills.filter(
-				(s) =>
-					s.name.toLowerCase().includes(q) || s.description.toLowerCase().includes(q),
-			)
-		: skills;
-	return matched.slice(0, MENTION_LIMIT);
+export function filterSkills(
+  skills: SkillOption[],
+  query: string,
+): SkillOption[] {
+  const q = query.trim().toLowerCase();
+  const matched = q
+    ? skills.filter(
+        (s) =>
+          s.name.toLowerCase().includes(q) ||
+          s.description.toLowerCase().includes(q),
+      )
+    : skills;
+  return matched.slice(0, MENTION_LIMIT);
 }
 
 export function payloadIsEmpty(p: AgentComposerPayload): boolean {
-	return !p.content.trim() && p.mentions.length === 0 && p.attachments.length === 0;
+  return (
+    !p.content.trim() && p.mentions.length === 0 && p.attachments.length === 0
+  );
 }

calliope-web/src/lib/agentTasks.ts

@@ -7,28 +7,30 @@
  * buttons stay dumb and the wording never drifts out of sync.
  */
 
-export type AgentTaskKind = 'story' | 'script';
+export type AgentTaskKind = "story" | "script";
 
 /** The pre-filled composer prompt for each task. */
 export const AGENT_TASK_PROMPTS: Record<AgentTaskKind, string> = {
-	story:
-		'Draft the storyline for this project — generate the beats, characters, environments, and any misc. items from the story idea.',
-	script:
-		'Regenerate the full script for this project — turn the storyline into ordered scenes with action and dialogue.',
+  story:
+    "Draft the storyline for this project — generate the beats, characters, environments, and any misc. items from the story idea.",
+  script:
+    "Regenerate the full script for this project — turn the storyline into ordered scenes with action and dialogue.",
 };
 
 /** i18n key for the auto-created session's sidebar title. */
 export const AGENT_TASK_TITLE_KEYS: Record<AgentTaskKind, string> = {
-	story: 'agent.task.story',
-	script: 'agent.task.script',
+  story: "agent.task.story",
+  script: "agent.task.script",
 };
 
-export function isAgentTaskKind(value: string | null | undefined): value is AgentTaskKind {
-	return value === 'story' || value === 'script';
+export function isAgentTaskKind(
+  value: string | null | undefined,
+): value is AgentTaskKind {
+  return value === "story" || value === "script";
 }
 
 /** Build the /agents deep-link URL for a project-scoped task. */
 export function agentDeepLink(projectId: number, task: AgentTaskKind): string {
-	const params = new URLSearchParams({ project: String(projectId), task });
-	return `/agents?${params.toString()}`;
+  const params = new URLSearchParams({ project: String(projectId), task });
+  return `/agents?${params.toString()}`;
 }

calliope-web/src/lib/api.ts

@@ -834,6 +834,7 @@ export interface VideoShot {
 }
 
 export interface WorkbenchStage {
+  incoming_results?: IncomingResult[];
   assistant_note?: string;
   stage_key: WorkbenchStageKey;
   status: WorkbenchStageStatus;
@@ -954,7 +955,65 @@ export const libraryApi = {
 
 // ── Agents (agentic harness) ────────────────────────────────────────────
 
+export interface AgentDeliverable {
+  id: number;
+  session_id: number;
+  source_message_id: number;
+  project_id: number | null;
+  stage_key: WorkbenchStageKey;
+  title: string;
+  content: string;
+  revision: number;
+  created_at: string;
+  updated_at: string;
+}
+export interface IncomingResult {
+  source_key: string;
+  title: string;
+  text?: string;
+  kind?: string;
+  paths?: string[];
+  session_id?: number;
+  job_id?: number;
+}
+export const resultsApi = {
+  versions: (id: number) =>
+    api<{ revision: number; content: string }[]>(
+      `/api/results/deliverables/${id}/versions`,
+    ),
+  list: (sessionId?: number) =>
+    api<AgentDeliverable[]>(
+      `/api/results/deliverables${sessionId == null ? "" : `?session_id=${sessionId}`}`,
+    ),
+  patch: (
+    id: number,
+    payload: {
+      revision: number;
+      content: string;
+      project_id: number | null;
+      stage_key: WorkbenchStageKey;
+    },
+  ) =>
+    api<AgentDeliverable>(`/api/results/deliverables/${id}`, {
+      method: "PATCH",
+      body: JSON.stringify(payload),
+    }),
+  store: (payload: {
+    project_id: number;
+    stage_key: WorkbenchStageKey;
+    deliverable_id?: number;
+    revision?: number;
+    job_id?: number;
+  }) =>
+    api<{ ok: boolean; already_attached: boolean; stage: WorkbenchStage }>(
+      "/api/results/store",
+      { method: "POST", body: JSON.stringify(payload) },
+    ),
+};
+
 export interface AgentSession {
+  task_summary?: string;
+  task_status?: string;
   id: number;
   project_id: number | null;
   title: string;

calliope-web/src/lib/assetPicker.ts

@@ -1,50 +1,60 @@
 /** Shared shape for Omni / video ref pickers. */
-export type AssetGroup = 'character' | 'location' | 'item' | 'upload' | 'clip' | 'shot';
+export type AssetGroup =
+  "character" | "location" | "item" | "upload" | "clip" | "shot";
 
 export interface AssetOption {
-	label: string;
-	path: string;
-	kind?: 'image' | 'video' | 'audio';
-	group?: AssetGroup;
+  label: string;
+  path: string;
+  kind?: "image" | "video" | "audio";
+  group?: AssetGroup;
 }
 
 const GROUP_FROM_SUFFIX: Array<{ re: RegExp; group: AssetGroup }> = [
-	{ re: /\s·\s*sheet$/i, group: 'character' },
-	{ re: /\s·\s*environment$/i, group: 'location' },
-	{ re: /\s·\s*item$/i, group: 'item' },
-	{ re: /\s·\s*upload$/i, group: 'upload' },
-	{ re: /\s·\s*blockout(\s+clip)?$/i, group: 'shot' },
-	{ re: /^clip\s*#/i, group: 'clip' },
+  { re: /\s·\s*sheet$/i, group: "character" },
+  { re: /\s·\s*environment$/i, group: "location" },
+  { re: /\s·\s*item$/i, group: "item" },
+  { re: /\s·\s*upload$/i, group: "upload" },
+  { re: /\s·\s*blockout(\s+clip)?$/i, group: "shot" },
+  { re: /^clip\s*#/i, group: "clip" },
 ];
 
 export function assetGroup(opt: AssetOption): AssetGroup {
-	if (opt.group) return opt.group;
-	for (const { re, group } of GROUP_FROM_SUFFIX) {
-		if (re.test(opt.label)) return group;
-	}
-	return 'upload';
+  if (opt.group) return opt.group;
+  for (const { re, group } of GROUP_FROM_SUFFIX) {
+    if (re.test(opt.label)) return group;
+  }
+  return "upload";
 }
 
 /** Strip the " · sheet" style suffix so the tab already names the type. */
 export function assetDisplayName(opt: AssetOption): string {
-	return opt.label.replace(/\s·\s*(sheet|environment|item|upload|blockout(\s+clip)?)\s*$/i, '').trim() || opt.label;
+  return (
+    opt.label
+      .replace(
+        /\s·\s*(sheet|environment|item|upload|blockout(\s+clip)?)\s*$/i,
+        "",
+      )
+      .trim() || opt.label
+  );
 }
 
 export const ASSET_GROUP_TABS: Array<{ id: AssetGroup; label: string }> = [
-	{ id: 'character', label: 'Characters' },
-	{ id: 'location', label: 'Environments' },
-	{ id: 'item', label: 'Misc. Items' },
-	{ id: 'shot', label: 'From Build Scene' },
-	{ id: 'clip', label: 'Clips' },
-	{ id: 'upload', label: 'Uploads' },
+  { id: "character", label: "Characters" },
+  { id: "location", label: "Environments" },
+  { id: "item", label: "Misc. Items" },
+  { id: "shot", label: "From Build Scene" },
+  { id: "clip", label: "Clips" },
+  { id: "upload", label: "Uploads" },
 ];
 
-export function tabsForMediaKind(kind: string | undefined): Array<{ id: AssetGroup; label: string }> {
-	const ids: AssetGroup[] =
-		kind === 'video'
-			? ['clip', 'upload']
-			: kind === 'audio'
-				? ['upload']
-				: ['character', 'location', 'item', 'shot', 'upload'];
-	return ASSET_GROUP_TABS.filter((t) => ids.includes(t.id));
+export function tabsForMediaKind(
+  kind: string | undefined,
+): Array<{ id: AssetGroup; label: string }> {
+  const ids: AssetGroup[] =
+    kind === "video"
+      ? ["clip", "upload"]
+      : kind === "audio"
+        ? ["upload"]
+        : ["character", "location", "item", "shot", "upload"];
+  return ASSET_GROUP_TABS.filter((t) => ids.includes(t.id));
 }

calliope-web/src/lib/canvas/ArtifactNode.svelte

@@ -47,14 +47,12 @@
 	</header>
 	<div class="media">
 		{#if videoSrc}
-			<!-- svelte-ignore a11y_click_events_have_key_events, a11y_no_static_element_interactions -->
 			<button
 				type="button"
 				class="media-btn"
 				onclick={openPreview}
 				title={t('canvas.openPreview')}
 			>
-				<!-- svelte-ignore a11y_media_has_caption -->
 				<video
 					class="media-el"
 					src={videoSrc}
@@ -64,7 +62,6 @@
 				></video>
 			</button>
 		{:else if mediaSrc}
-			<!-- svelte-ignore a11y_click_events_have_key_events, a11y_no_static_element_interactions -->
 			<button
 				type="button"
 				class="media-btn"

calliope-web/src/lib/canvas/EntityNode.svelte

@@ -76,7 +76,6 @@
 			<SafeMedia class="media-el" src={posterSrc} alt={data.title} kind="image" controls={false} />
 		{:else if videoSrc}
 			<!-- No poster available: #t=0.1 first-frame thumbnail. -->
-			<!-- svelte-ignore a11y_media_has_caption -->
 			<video
 				class="media-el"
 				src={videoSrc}

calliope-web/src/lib/comfy/classifyInput.ts

@@ -12,24 +12,25 @@
  *   control   → compact pills (resolution, duration, seed)
  *   advanced  → hidden inside an "Advanced" popover
  */
-import type { ComfyDynamicInput } from './types';
-import { normalizeInputRole } from './parser';
+import type { ComfyDynamicInput } from "./types";
+import { normalizeInputRole } from "./parser";
 
-export type InputZone = 'composer' | 'media' | 'control' | 'advanced' | 'hidden';
+export type InputZone =
+  "composer" | "media" | "control" | "advanced" | "hidden";
 
 export type OmniWidget =
-	| 'promptTextarea'
-	| 'negativeTextarea'
-	| 'uploadTile'
-	| 'assetTile'
-	| 'resolutionPill'
-	| 'numberPill'
-	| 'textPill';
+  | "promptTextarea"
+  | "negativeTextarea"
+  | "uploadTile"
+  | "assetTile"
+  | "resolutionPill"
+  | "numberPill"
+  | "textPill";
 
 export interface ClassifiedInput {
-	input: ComfyDynamicInput;
-	zone: InputZone;
-	widget: OmniWidget;
+  input: ComfyDynamicInput;
+  zone: InputZone;
+  widget: OmniWidget;
 }
 
 /**
@@ -39,49 +40,49 @@ export interface ClassifiedInput {
  * zone. Unknown roles fall to `advanced` so no field is ever hidden or lost.
  */
 export function classifyInput(inp: ComfyDynamicInput): ClassifiedInput {
-	const role = normalizeInputRole(inp.role);
+  const role = normalizeInputRole(inp.role);
 
-	// --- Composer ---
-	if (role === 'prompt' || role === 'positive') {
-		return { input: inp, zone: 'composer', widget: 'promptTextarea' };
-	}
-	if (role === 'negative') {
-		return { input: inp, zone: 'composer', widget: 'negativeTextarea' };
-	}
+  // --- Composer ---
+  if (role === "prompt" || role === "positive") {
+    return { input: inp, zone: "composer", widget: "promptTextarea" };
+  }
+  if (role === "negative") {
+    return { input: inp, zone: "composer", widget: "negativeTextarea" };
+  }
 
-	// --- Media tray ---
-	if (
-		role === 'character' ||
-		role === 'location' ||
-		role === 'image' ||
-		role === 'video' ||
-		role === 'audio'
-	) {
-		const isMediaKind =
-			inp.kind === 'image' ||
-			inp.kind === 'image_url' ||
-			inp.kind === 'audio' ||
-			inp.kind === 'video';
-		return {
-			input: inp,
-			zone: 'media',
-			widget: isMediaKind ? 'uploadTile' : 'assetTile',
-		};
-	}
+  // --- Media tray ---
+  if (
+    role === "character" ||
+    role === "location" ||
+    role === "image" ||
+    role === "video" ||
+    role === "audio"
+  ) {
+    const isMediaKind =
+      inp.kind === "image" ||
+      inp.kind === "image_url" ||
+      inp.kind === "audio" ||
+      inp.kind === "video";
+    return {
+      input: inp,
+      zone: "media",
+      widget: isMediaKind ? "uploadTile" : "assetTile",
+    };
+  }
 
-	// --- Control bar ---
-	if (role === 'width' || role === 'height') {
-		return { input: inp, zone: 'control', widget: 'resolutionPill' };
-	}
-	if (role === 'duration' || role === 'seed') {
-		return { input: inp, zone: 'control', widget: 'numberPill' };
-	}
+  // --- Control bar ---
+  if (role === "width" || role === "height") {
+    return { input: inp, zone: "control", widget: "resolutionPill" };
+  }
+  if (role === "duration" || role === "seed") {
+    return { input: inp, zone: "control", widget: "numberPill" };
+  }
 
-	// --- Advanced popover ---
-	if (inp.kind === 'number') {
-		return { input: inp, zone: 'advanced', widget: 'numberPill' };
-	}
-	return { input: inp, zone: 'advanced', widget: 'textPill' };
+  // --- Advanced popover ---
+  if (inp.kind === "number") {
+    return { input: inp, zone: "advanced", widget: "numberPill" };
+  }
+  return { input: inp, zone: "advanced", widget: "textPill" };
 }
 
 /**
@@ -92,57 +93,62 @@ export function classifyInput(inp: ComfyDynamicInput): ClassifiedInput {
  * nodeIds on change.
  */
 export function classifyAll(inputs: ComfyDynamicInput[]): {
-	prompt: ClassifiedInput | null;
-	negative: ClassifiedInput | null;
-	media: ClassifiedInput[];
-	control: ClassifiedInput[];
-	advanced: ClassifiedInput[];
-	/** Non-null when both width AND height are present → merge into one pill. */
-	resolutionPair: { width: ClassifiedInput; height: ClassifiedInput } | null;
+  prompt: ClassifiedInput | null;
+  negative: ClassifiedInput | null;
+  media: ClassifiedInput[];
+  control: ClassifiedInput[];
+  advanced: ClassifiedInput[];
+  /** Non-null when both width AND height are present → merge into one pill. */
+  resolutionPair: { width: ClassifiedInput; height: ClassifiedInput } | null;
 } {
-	const classified = inputs.map(classifyInput);
+  const classified = inputs.map(classifyInput);
 
-	const prompt = classified.find((c) => c.widget === 'promptTextarea') ?? null;
-	const negative = classified.find((c) => c.widget === 'negativeTextarea') ?? null;
-	const media = classified.filter((c) => c.zone === 'media');
-	const advanced = classified.filter((c) => c.zone === 'advanced');
+  const prompt = classified.find((c) => c.widget === "promptTextarea") ?? null;
+  const negative =
+    classified.find((c) => c.widget === "negativeTextarea") ?? null;
+  const media = classified.filter((c) => c.zone === "media");
+  const advanced = classified.filter((c) => c.zone === "advanced");
 
-	// Separate resolution from other control inputs
-	const controlNonRes = classified.filter(
-		(c) => c.zone === 'control' && c.widget !== 'resolutionPill',
-	);
-	const resInputs = classified.filter((c) => c.widget === 'resolutionPill');
+  // Separate resolution from other control inputs
+  const controlNonRes = classified.filter(
+    (c) => c.zone === "control" && c.widget !== "resolutionPill",
+  );
+  const resInputs = classified.filter((c) => c.widget === "resolutionPill");
 
-	// Detect width + height pair
-	const wInput = resInputs.find((c) => normalizeInputRole(c.input.role) === 'width');
-	const hInput = resInputs.find((c) => normalizeInputRole(c.input.role) === 'height');
-	const resolutionPair =
-		wInput && hInput ? { width: wInput, height: hInput } : null;
+  // Detect width + height pair
+  const wInput = resInputs.find(
+    (c) => normalizeInputRole(c.input.role) === "width",
+  );
+  const hInput = resInputs.find(
+    (c) => normalizeInputRole(c.input.role) === "height",
+  );
+  const resolutionPair =
+    wInput && hInput ? { width: wInput, height: hInput } : null;
 
-	// If only one of width/height exists, treat it as a standalone control number pill
-	const standaloneRes = resolutionPair ? [] : resInputs;
+  // If only one of width/height exists, treat it as a standalone control number pill
+  const standaloneRes = resolutionPair ? [] : resInputs;
 
-	return {
-		prompt,
-		negative,
-		media,
-		control: [...controlNonRes, ...standaloneRes],
-		advanced,
-		resolutionPair,
-	};
+  return {
+    prompt,
+    negative,
+    media,
+    control: [...controlNonRes, ...standaloneRes],
+    advanced,
+    resolutionPair,
+  };
 }
 
 // ── Resolution presets ────────────────────────────────────────────────────────
 
 export interface ResolutionPreset {
-	label: string;
-	width: number;
-	height: number;
+  label: string;
+  width: number;
+  height: number;
 }
 
 export const RESOLUTION_PRESETS: ResolutionPreset[] = [
-	{ label: '720p', width: 1280, height: 720 },
-	{ label: '1080p', width: 1920, height: 1080 },
+  { label: "720p", width: 1280, height: 720 },
+  { label: "1080p", width: 1920, height: 1080 },
 ];
 
 /**
@@ -150,12 +156,12 @@ export const RESOLUTION_PRESETS: ResolutionPreset[] = [
  * (or return null for custom / unset values).
  */
 export function resolutionLabel(
-	width: number | string | undefined,
-	height: number | string | undefined,
+  width: number | string | undefined,
+  height: number | string | undefined,
 ): string | null {
-	const w = Number(width);
-	const h = Number(height);
-	if (!w || !h) return null;
-	const match = RESOLUTION_PRESETS.find((p) => p.width === w && p.height === h);
-	return match?.label ?? `${w}×${h}`;
+  const w = Number(width);
+  const h = Number(height);
+  if (!w || !h) return null;
+  const match = RESOLUTION_PRESETS.find((p) => p.width === w && p.height === h);
+  return match?.label ?? `${w}×${h}`;
 }

calliope-web/src/lib/comfy/parser.ts

@@ -1,142 +1,192 @@
-import type { ComfyDynamicInput, ComfyDynamicOutput, WorkflowNode } from './types';
+import type {
+  ComfyDynamicInput,
+  ComfyDynamicOutput,
+  WorkflowNode,
+} from "./types";
 
 const TEXT_AREA = new Set([
-	'CLIPTextEncode',
-	'Note',
-	'ShowText',
-	'ImpactWildcardProcessor',
-	'PrimitiveStringMultiline',
-	'PrimitiveString',
+  "CLIPTextEncode",
+  "Note",
+  "ShowText",
+  "ImpactWildcardProcessor",
+  "PrimitiveStringMultiline",
+  "PrimitiveString",
+]);
+const NUMBER = new Set([
+  "INT",
+  "FLOAT",
+  "PrimitiveInt",
+  "PrimitiveFloat",
+  "KSampler",
+  "KSamplerAdvanced",
+]);
+const IMAGE = new Set([
+  "LoadImage",
+  "LoadImageMask",
+  "ImageLoader",
+  "ETN_LoadImageBase64",
+]);
+const IMAGE_URL = new Set(["Load Image From Url (mtb)"]);
+const AUDIO = new Set(["LoadAudio", "VHS_LoadAudio"]);
+const VIDEO = new Set(["LoadVideo", "VHS_LoadVideo", "VHS_LoadVideoPath"]);
+const VIDEO_OUT = new Set([
+  "VHS_VideoCombine",
+  "SaveVideo",
+  "VideoOutput",
+  "AnimateDiffCombine",
+]);
+const IMAGE_OUT = new Set([
+  "SaveImage",
+  "PreviewImage",
+  "SaveImageWebsocket",
+  "ETN_SendImageWebSocket",
 ]);
-const NUMBER = new Set(['INT', 'FLOAT', 'PrimitiveInt', 'PrimitiveFloat', 'KSampler', 'KSamplerAdvanced']);
-const IMAGE = new Set(['LoadImage', 'LoadImageMask', 'ImageLoader', 'ETN_LoadImageBase64']);
-const IMAGE_URL = new Set(['Load Image From Url (mtb)']);
-const AUDIO = new Set(['LoadAudio', 'VHS_LoadAudio']);
-const VIDEO = new Set(['LoadVideo', 'VHS_LoadVideo', 'VHS_LoadVideoPath']);
-const VIDEO_OUT = new Set(['VHS_VideoCombine', 'SaveVideo', 'VideoOutput', 'AnimateDiffCombine']);
-const IMAGE_OUT = new Set(['SaveImage', 'PreviewImage', 'SaveImageWebsocket', 'ETN_SendImageWebSocket']);
 
 /** Matches (Input), (Input:prompt), (Output:image), … */
 const TITLE_TAG_RE = /\((Input|Output)(?::([a-zA-Z0-9_-]+))?\)/i;
 
 const INPUT_ROLE_ALIASES: Record<string, string[]> = {
-	prompt: ['prompt', 'positive'],
-	negative: ['negative', 'neg'],
-	width: ['width', 'w'],
-	height: ['height', 'h'],
-	character: ['character', 'char', 'portrait', 'sheet', 'face', 'ref'],
-	location: ['location', 'loc', 'environment', 'env', 'background', 'scene'],
-	image: ['image', 'img'],
-	video: ['video', 'vid'],
-	audio: ['audio', 'sound', 'sfx'],
-	seed: ['seed'],
-	duration: ['duration', 'dur', 'length', 'seconds'],
+  prompt: ["prompt", "positive"],
+  negative: ["negative", "neg"],
+  width: ["width", "w"],
+  height: ["height", "h"],
+  character: ["character", "char", "portrait", "sheet", "face", "ref"],
+  location: ["location", "loc", "environment", "env", "background", "scene"],
+  image: ["image", "img"],
+  video: ["video", "vid"],
+  audio: ["audio", "sound", "sfx"],
+  seed: ["seed"],
+  duration: ["duration", "dur", "length", "seconds"],
 };
 
 const OUTPUT_ROLE_ALIASES: Record<string, string[]> = {
-	image: ['image', 'img'],
-	video: ['video', 'vid'],
+  image: ["image", "img"],
+  video: ["video", "vid"],
 };
 
 export function parseTitleTag(title: string): {
-	kind: 'input' | 'output' | null;
-	role: string | null;
-	label: string;
+  kind: "input" | "output" | null;
+  role: string | null;
+  label: string;
 } {
-	if (!title) return { kind: null, role: null, label: '' };
-	const match = TITLE_TAG_RE.exec(title);
-	if (!match) return { kind: null, role: null, label: title.trim() };
-	const kind = match[1].toLowerCase() as 'input' | 'output';
-	const role = match[2] ? match[2].toLowerCase() : null;
-	const stripped = title.replace(TITLE_TAG_RE, '').trim();
-	const label = stripped || role || kind;
-	return { kind, role, label };
+  if (!title) return { kind: null, role: null, label: "" };
+  const match = TITLE_TAG_RE.exec(title);
+  if (!match) return { kind: null, role: null, label: title.trim() };
+  const kind = match[1].toLowerCase() as "input" | "output";
+  const role = match[2] ? match[2].toLowerCase() : null;
+  const stripped = title.replace(TITLE_TAG_RE, "").trim();
+  const label = stripped || role || kind;
+  return { kind, role, label };
 }
 
-export function normalizeInputRole(role: string | null | undefined): string | null {
-	if (!role) return null;
-	const r = role.toLowerCase().trim();
-	for (const [canonical, aliases] of Object.entries(INPUT_ROLE_ALIASES)) {
-		if (r === canonical || aliases.includes(r)) return canonical;
-	}
-	return r;
+export function normalizeInputRole(
+  role: string | null | undefined,
+): string | null {
+  if (!role) return null;
+  const r = role.toLowerCase().trim();
+  for (const [canonical, aliases] of Object.entries(INPUT_ROLE_ALIASES)) {
+    if (r === canonical || aliases.includes(r)) return canonical;
+  }
+  return r;
 }
 
-export function normalizeOutputRole(role: string | null | undefined): string | null {
-	if (!role) return null;
-	const r = role.toLowerCase().trim();
-	for (const [canonical, aliases] of Object.entries(OUTPUT_ROLE_ALIASES)) {
-		if (r === canonical || aliases.includes(r)) return canonical;
-	}
-	return r;
+export function normalizeOutputRole(
+  role: string | null | undefined,
+): string | null {
+  if (!role) return null;
+  const r = role.toLowerCase().trim();
+  for (const [canonical, aliases] of Object.entries(OUTPUT_ROLE_ALIASES)) {
+    if (r === canonical || aliases.includes(r)) return canonical;
+  }
+  return r;
 }
 
-function classToInputKind(classType: string): ComfyDynamicInput['kind'] {
-	if (IMAGE.has(classType)) return 'image';
-	if (IMAGE_URL.has(classType)) return 'image_url';
-	if (AUDIO.has(classType)) return 'audio';
-	if (VIDEO.has(classType)) return 'video';
-	if (NUMBER.has(classType)) return 'number';
-	if (TEXT_AREA.has(classType)) return 'textarea';
-	const lower = classType.toLowerCase();
-	if (lower.includes('video')) return 'video';
-	if (lower.includes('audio')) return 'audio';
-	if (lower.includes('image') || lower.includes('load')) return 'image';
-	if (lower.includes('int') || lower.includes('float') || lower.includes('seed')) return 'number';
-	if (lower.includes('text') || lower.includes('clip') || lower.includes('prompt')) return 'textarea';
-	return 'text';
+function classToInputKind(classType: string): ComfyDynamicInput["kind"] {
+  if (IMAGE.has(classType)) return "image";
+  if (IMAGE_URL.has(classType)) return "image_url";
+  if (AUDIO.has(classType)) return "audio";
+  if (VIDEO.has(classType)) return "video";
+  if (NUMBER.has(classType)) return "number";
+  if (TEXT_AREA.has(classType)) return "textarea";
+  const lower = classType.toLowerCase();
+  if (lower.includes("video")) return "video";
+  if (lower.includes("audio")) return "audio";
+  if (lower.includes("image") || lower.includes("load")) return "image";
+  if (
+    lower.includes("int") ||
+    lower.includes("float") ||
+    lower.includes("seed")
+  )
+    return "number";
+  if (
+    lower.includes("text") ||
+    lower.includes("clip") ||
+    lower.includes("prompt")
+  )
+    return "textarea";
+  return "text";
 }
 
 function extractDefault(node: WorkflowNode): string | number | undefined {
-	const { inputs, class_type } = node;
-	if (IMAGE.has(class_type) || AUDIO.has(class_type) || VIDEO.has(class_type)) return undefined;
-	if (typeof inputs.text === 'string') return inputs.text;
-	if (typeof inputs.value === 'string' || typeof inputs.value === 'number') return inputs.value;
-	if (typeof inputs.int === 'number') return inputs.int;
-	if (typeof inputs.float === 'number') return inputs.float;
-	return undefined;
+  const { inputs, class_type } = node;
+  if (IMAGE.has(class_type) || AUDIO.has(class_type) || VIDEO.has(class_type))
+    return undefined;
+  if (typeof inputs.text === "string") return inputs.text;
+  if (typeof inputs.value === "string" || typeof inputs.value === "number")
+    return inputs.value;
+  if (typeof inputs.int === "number") return inputs.int;
+  if (typeof inputs.float === "number") return inputs.float;
+  return undefined;
 }
 
-export function parseDynamicInputs(workflow: Record<string, WorkflowNode>): ComfyDynamicInput[] {
-	const results: ComfyDynamicInput[] = [];
-	for (const [nodeId, node] of Object.entries(workflow)) {
-		const title = node._meta?.title ?? '';
-		const { kind, role, label } = parseTitleTag(title);
-		if (kind !== 'input') continue;
-		results.push({
-			nodeId,
-			label: label || node.class_type,
-			role: normalizeInputRole(role),
-			kind: classToInputKind(node.class_type),
-			defaultValue: extractDefault(node),
-			required: true,
-		});
-	}
-	return results;
+export function parseDynamicInputs(
+  workflow: Record<string, WorkflowNode>,
+): ComfyDynamicInput[] {
+  const results: ComfyDynamicInput[] = [];
+  for (const [nodeId, node] of Object.entries(workflow)) {
+    const title = node._meta?.title ?? "";
+    const { kind, role, label } = parseTitleTag(title);
+    if (kind !== "input") continue;
+    results.push({
+      nodeId,
+      label: label || node.class_type,
+      role: normalizeInputRole(role),
+      kind: classToInputKind(node.class_type),
+      defaultValue: extractDefault(node),
+      required: true,
+    });
+  }
+  return results;
 }
 
-export function parseDynamicOutputs(workflow: Record<string, WorkflowNode>): ComfyDynamicOutput[] {
-	const results: ComfyDynamicOutput[] = [];
-	for (const [nodeId, node] of Object.entries(workflow)) {
-		const title = node._meta?.title ?? '';
-		const { kind, role, label } = parseTitleTag(title);
-		if (kind !== 'output') continue;
-		const canon = normalizeOutputRole(role);
-		let outKind: ComfyDynamicOutput['kind'] = 'other';
-		if (canon === 'video' || VIDEO_OUT.has(node.class_type) || node.class_type.toLowerCase().includes('video'))
-			outKind = 'video';
-		else if (
-			canon === 'image' ||
-			IMAGE_OUT.has(node.class_type) ||
-			node.class_type.toLowerCase().includes('image')
-		)
-			outKind = 'image';
-		results.push({
-			nodeId,
-			label: label || node.class_type,
-			role: canon,
-			kind: outKind,
-		});
-	}
-	return results;
+export function parseDynamicOutputs(
+  workflow: Record<string, WorkflowNode>,
+): ComfyDynamicOutput[] {
+  const results: ComfyDynamicOutput[] = [];
+  for (const [nodeId, node] of Object.entries(workflow)) {
+    const title = node._meta?.title ?? "";
+    const { kind, role, label } = parseTitleTag(title);
+    if (kind !== "output") continue;
+    const canon = normalizeOutputRole(role);
+    let outKind: ComfyDynamicOutput["kind"] = "other";
+    if (
+      canon === "video" ||
+      VIDEO_OUT.has(node.class_type) ||
+      node.class_type.toLowerCase().includes("video")
+    )
+      outKind = "video";
+    else if (
+      canon === "image" ||
+      IMAGE_OUT.has(node.class_type) ||
+      node.class_type.toLowerCase().includes("image")
+    )
+      outKind = "image";
+    results.push({
+      nodeId,
+      label: label || node.class_type,
+      role: canon,
+      kind: outKind,
+    });
+  }
+  return results;
 }

calliope-web/src/lib/comfy/promptInput.ts

@@ -1,51 +1,55 @@
-import type { ComfyDynamicInput } from './types';
-import { normalizeInputRole } from './parser';
+import type { ComfyDynamicInput } from "./types";
+import { normalizeInputRole } from "./parser";
 
-const PROMPT_ROLES = new Set(['prompt', 'positive']);
+const PROMPT_ROLES = new Set(["prompt", "positive"]);
 
 function roleOf(inp: ComfyDynamicInput): string | null {
-	return normalizeInputRole(inp.role ?? null);
+  return normalizeInputRole(inp.role ?? null);
 }
 
 /** Positive prompt input — prefers (Input:prompt), legacy label fallback. */
 export function isPromptLikeInput(inp: ComfyDynamicInput): boolean {
-	const role = roleOf(inp);
-	if (role && PROMPT_ROLES.has(role)) return true;
-	if (role) return false; // other roles are never "the" prompt
-	if (inp.kind !== 'text' && inp.kind !== 'textarea') return false;
-	const label = (inp.label || '').toLowerCase();
-	if (label.includes('negative')) return false;
-	return (
-		label.includes('prompt') ||
-		label.includes('positive') ||
-		label.includes('text') ||
-		inp.kind === 'textarea'
-	);
+  const role = roleOf(inp);
+  if (role && PROMPT_ROLES.has(role)) return true;
+  if (role) return false; // other roles are never "the" prompt
+  if (inp.kind !== "text" && inp.kind !== "textarea") return false;
+  const label = (inp.label || "").toLowerCase();
+  if (label.includes("negative")) return false;
+  return (
+    label.includes("prompt") ||
+    label.includes("positive") ||
+    label.includes("text") ||
+    inp.kind === "textarea"
+  );
 }
 
 /** Drop prompt-role fields from shared workflow forms (entity Image prompt owns those). */
-export function withoutPromptInputs(inputs: ComfyDynamicInput[] | undefined | null): ComfyDynamicInput[] {
-	if (!inputs?.length) return [];
-	return inputs.filter((inp) => !isPromptLikeInput(inp));
+export function withoutPromptInputs(
+  inputs: ComfyDynamicInput[] | undefined | null,
+): ComfyDynamicInput[] {
+  if (!inputs?.length) return [];
+  return inputs.filter((inp) => !isPromptLikeInput(inp));
 }
 
 /** True if this workflow schema has a prompt-role (or legacy prompt-like) (Input). */
-export function workflowHasPromptInput(inputs: ComfyDynamicInput[] | undefined | null): boolean {
-	if (!inputs?.length) return false;
-	return inputs.some(isPromptLikeInput);
+export function workflowHasPromptInput(
+  inputs: ComfyDynamicInput[] | undefined | null,
+): boolean {
+  if (!inputs?.length) return false;
+  return inputs.some(isPromptLikeInput);
 }
 
 /** Strip blank strings so empty fields cannot wipe smart-fill. */
 export function compactInputValues(
-	values: Record<string, unknown> | undefined | null,
+  values: Record<string, unknown> | undefined | null,
 ): Record<string, unknown> {
-	if (!values) return {};
-	const out: Record<string, unknown> = {};
-	for (const [k, v] of Object.entries(values)) {
-		if (v === null || v === undefined) continue;
-		if (typeof v === 'string' && !v.trim()) continue;
-		if (Array.isArray(v) && !v.length) continue;
-		out[k] = v;
-	}
-	return out;
+  if (!values) return {};
+  const out: Record<string, unknown> = {};
+  for (const [k, v] of Object.entries(values)) {
+    if (v === null || v === undefined) continue;
+    if (typeof v === "string" && !v.trim()) continue;
+    if (Array.isArray(v) && !v.length) continue;
+    out[k] = v;
+  }
+  return out;
 }

calliope-web/src/lib/comfy/resolution.ts

@@ -3,39 +3,42 @@
  * ratios and rounding, so the size shown is the size ComfyUI renders.
  */
 const RATIOS: Record<string, [number, number]> = {
-	'1:1 (Square)': [1, 1],
-	'2:3 (Portrait Photo)': [2, 3],
-	'3:2 (Photo)': [3, 2],
-	'3:4 (Portrait Standard)': [3, 4],
-	'4:3 (Standard)': [4, 3],
-	'9:16 (Portrait Widescreen)': [9, 16],
-	'16:9 (Widescreen)': [16, 9],
-	'21:9 (Ultrawide)': [21, 9],
+  "1:1 (Square)": [1, 1],
+  "2:3 (Portrait Photo)": [2, 3],
+  "3:2 (Photo)": [3, 2],
+  "3:4 (Portrait Standard)": [3, 4],
+  "4:3 (Standard)": [4, 3],
+  "9:16 (Portrait Widescreen)": [9, 16],
+  "16:9 (Widescreen)": [16, 9],
+  "21:9 (Ultrawide)": [21, 9],
 };
 
 /** Python's round(): halves go to the even neighbour. */
 function roundHalfEven(x: number): number {
-	const f = Math.floor(x);
-	const diff = x - f;
-	if (diff > 0.5) return f + 1;
-	if (diff < 0.5) return f;
-	return f % 2 === 0 ? f : f + 1;
+  const f = Math.floor(x);
+  const diff = x - f;
+  if (diff > 0.5) return f + 1;
+  if (diff < 0.5) return f;
+  return f % 2 === 0 ? f : f + 1;
 }
 
 export function resolutionSelectorSize(
-	aspectRatio: string,
-	megapixels: number,
-	multiple: number,
+  aspectRatio: string,
+  megapixels: number,
+  multiple: number,
 ): { width: number; height: number } | null {
-	const ratio = RATIOS[aspectRatio];
-	if (!ratio || !Number.isFinite(megapixels) || megapixels <= 0) return null;
-	const [w, h] = ratio;
-	const m = Math.max(1, Math.floor(multiple) || 8);
-	const scale = Math.sqrt((megapixels * 1024 * 1024) / (w * h));
-	return { width: roundHalfEven((w * scale) / m) * m, height: roundHalfEven((h * scale) / m) * m };
+  const ratio = RATIOS[aspectRatio];
+  if (!ratio || !Number.isFinite(megapixels) || megapixels <= 0) return null;
+  const [w, h] = ratio;
+  const m = Math.max(1, Math.floor(multiple) || 8);
+  const scale = Math.sqrt((megapixels * 1024 * 1024) / (w * h));
+  return {
+    width: roundHalfEven((w * scale) / m) * m,
+    height: roundHalfEven((h * scale) / m) * m,
+  };
 }
 
 /** "16:9 (Widescreen)" → "16:9". */
 export function ratioShort(option: string): string {
-	return option.split(' ')[0] ?? option;
+  return option.split(" ")[0] ?? option;
 }

calliope-web/src/lib/comfy/types.ts

@@ -1,178 +1,184 @@
 export type ComfyInputKind =
-	| 'text'
-	| 'textarea'
-	| 'number'
-	| 'select'
-	| 'image'
-	| 'image_url'
-	| 'audio'
-	| 'video'
-	/** Ordered list of images for one Autogrow input (e.g. H3 ref_images, min…max). */
-	| 'image_list'
-	/** Ordered lists of videos / audios for Autogrow inputs (HEL-643). */
-	| 'video_list'
-	| 'audio_list';
-export type ComfyOutputKind = 'image' | 'video' | 'other';
+  | "text"
+  | "textarea"
+  | "number"
+  | "select"
+  | "image"
+  | "image_url"
+  | "audio"
+  | "video"
+  /** Ordered list of images for one Autogrow input (e.g. H3 ref_images, min…max). */
+  | "image_list"
+  /** Ordered lists of videos / audios for Autogrow inputs (HEL-643). */
+  | "video_list"
+  | "audio_list";
+export type ComfyOutputKind = "image" | "video" | "other";
 
 /** Structural finding on an imported workflow; `error` blocks generation. */
 export interface WorkflowWarning {
-	level: 'error' | 'warning';
-	code: string;
-	node_id: string;
-	message: string;
+  level: "error" | "warning";
+  code: string;
+  node_id: string;
+  message: string;
 }
 
 export interface ComfyDynamicInput {
-	nodeId: string;
-	label: string;
-	/** Role from title tag, e.g. (Input:prompt) → "prompt". Null for plain (Input). */
-	role?: string | null;
-	kind: ComfyInputKind;
-	defaultValue?: string | number;
-	required: boolean;
-	/** Inferred from node classes/wiring — the workflow carries no (Input) tags. */
-	auto?: boolean;
-	/** ComfyUI widget limits (number kind). */
-	min?: number;
-	max?: number;
-	step?: number;
-	integer?: boolean;
-	/** Allowed values (select kind). */
-	options?: string[];
-	/** On a ResolutionSelector aspect_ratio entry: its megapixels key and rounding multiple. */
-	resolution?: { megapixels: string; multiple: number };
-	/** Official usage-limits hint key for known media groups (HEL-643, e.g. 'minimax_h3_ref2va'). */
-	media_hint?: string;
+  nodeId: string;
+  label: string;
+  /** Role from title tag, e.g. (Input:prompt) → "prompt". Null for plain (Input). */
+  role?: string | null;
+  kind: ComfyInputKind;
+  defaultValue?: string | number;
+  required: boolean;
+  /** Inferred from node classes/wiring — the workflow carries no (Input) tags. */
+  auto?: boolean;
+  /** ComfyUI widget limits (number kind). */
+  min?: number;
+  max?: number;
+  step?: number;
+  integer?: boolean;
+  /** Allowed values (select kind). */
+  options?: string[];
+  /** On a ResolutionSelector aspect_ratio entry: its megapixels key and rounding multiple. */
+  resolution?: { megapixels: string; multiple: number };
+  /** Official usage-limits hint key for known media groups (HEL-643, e.g. 'minimax_h3_ref2va'). */
+  media_hint?: string;
 }
 
 export interface ComfyDynamicOutput {
-	nodeId: string;
-	label: string;
-	/** Role from title tag, e.g. (Output:image). */
-	role?: string | null;
-	/** Null while an unknown custom node awaits the user's media-type pick. */
-	kind: ComfyOutputKind | null;
-	/** Untagged detection: node class + which rule typed it. */
-	class_type?: string;
-	evidence?: 'registry' | 'class_name_match' | 'unknown_node';
-	/** Form default for unknown candidates — never auto-applied. */
-	suggested_kind?: 'image' | 'video' | null;
+  nodeId: string;
+  label: string;
+  /** Role from title tag, e.g. (Output:image). */
+  role?: string | null;
+  /** Null while an unknown custom node awaits the user's media-type pick. */
+  kind: ComfyOutputKind | null;
+  /** Untagged detection: node class + which rule typed it. */
+  class_type?: string;
+  evidence?: "registry" | "class_name_match" | "unknown_node";
+  /** Form default for unknown candidates — never auto-applied. */
+  suggested_kind?: "image" | "video" | null;
 }
 
 /** One entry of a workflow's confirmed output mapping (HEL-638). */
 export interface WorkflowOutputMapEntry {
-	nodeId: string;
-	kind: 'image' | 'video';
-	label?: string;
-	class_type?: string;
+  nodeId: string;
+  kind: "image" | "video";
+  label?: string;
+  class_type?: string;
 }
 
 /** The five workflow usages the studio distinguishes (HEL-636). */
 export type WorkflowUsage =
-	| 'text2image'
-	| 'image2image'
-	| 'text2video'
-	| 'image2video'
-	| 'ref2video';
+  "text2image" | "image2image" | "text2video" | "image2video" | "ref2video";
 
 export const WORKFLOW_USAGES: WorkflowUsage[] = [
-	'text2image',
-	'image2image',
-	'text2video',
-	'image2video',
-	'ref2video',
+  "text2image",
+  "image2image",
+  "text2video",
+  "image2video",
+  "ref2video",
 ];
 
 /** Which usages each generate page serves. */
-export const USAGE_BY_KIND: Record<'image' | 'video', WorkflowUsage[]> = {
-	image: ['text2image', 'image2image'],
-	video: ['text2video', 'image2video', 'ref2video'],
+export const USAGE_BY_KIND: Record<"image" | "video", WorkflowUsage[]> = {
+  image: ["text2image", "image2image"],
+  video: ["text2video", "image2video", "ref2video"],
 };
 
 /** One L2 connection-check finding against a live ComfyUI (HEL-643). */
 export interface PreflightFinding {
-	level: 'error' | 'warn' | 'info' | 'ok';
-	code: string;
-	node_id?: string;
-	node_title?: string | null;
-	message: string;
-	hint?: string | null;
+  level: "error" | "warn" | "info" | "ok";
+  code: string;
+  node_id?: string;
+  node_title?: string | null;
+  message: string;
+  hint?: string | null;
 }
 
 /** Result of checking a workflow against a target connection's /object_info. */
 export interface WorkflowConnectionCheck {
-	endpoint_id: string | null;
-	endpoint_name: string | null;
-	base_url?: string | null;
-	/** False when any error-level finding exists (or the server was unreachable). */
-	ok: boolean;
-	/** False → 无法核查 (server down): honest, non-blocking. */
-	reachable: boolean;
-	findings: PreflightFinding[];
-	message?: string | null;
+  endpoint_id: string | null;
+  endpoint_name: string | null;
+  base_url?: string | null;
+  /** False when any error-level finding exists (or the server was unreachable). */
+  ok: boolean;
+  /** False → 无法核查 (server down): honest, non-blocking. */
+  reachable: boolean;
+  findings: PreflightFinding[];
+  message?: string | null;
 }
 
 /** Slim live record of a workflow's latest test run (HEL-643). */
 export interface WorkflowLastTest {
-	id: number;
-	status: string;
-	phase: string | null;
-	error: string | null;
-	created_at: string;
-	completed_at: string | null;
-	output_count: number;
+  id: number;
+  status: string;
+  phase: string | null;
+  error: string | null;
+  created_at: string;
+  completed_at: string | null;
+  output_count: number;
 }
 
 /** Result of POST /api/workflows/analyze (import confirm step 1). */
 export interface WorkflowAnalyzeResult {
-	inputs: ComfyDynamicInput[];
-	outputs: ComfyDynamicOutput[];
-	suggested_profile?: string;
-	warnings?: WorkflowWarning[];
-	usage: WorkflowUsage | null;
-	usage_ambiguous: boolean;
-	needs_mapping: boolean;
-	usage_problem: string | null;
-	usage_evidence: {
-		outputs: ComfyDynamicOutput[];
-		image_slots: Array<{ nodeId: string; label: string; kind: string; role: string | null }>;
-		video_slots: Array<{ nodeId: string; label: string; kind: string; role: string | null }>;
-		summary: string[];
-	};
-	usable_usage: WorkflowUsage[];
-	/** Present when analyze was called with a target endpoint (HEL-643 L2). */
-	connection_check?: WorkflowConnectionCheck;
+  inputs: ComfyDynamicInput[];
+  outputs: ComfyDynamicOutput[];
+  suggested_profile?: string;
+  warnings?: WorkflowWarning[];
+  usage: WorkflowUsage | null;
+  usage_ambiguous: boolean;
+  needs_mapping: boolean;
+  usage_problem: string | null;
+  usage_evidence: {
+    outputs: ComfyDynamicOutput[];
+    image_slots: Array<{
+      nodeId: string;
+      label: string;
+      kind: string;
+      role: string | null;
+    }>;
+    video_slots: Array<{
+      nodeId: string;
+      label: string;
+      kind: string;
+      role: string | null;
+    }>;
+    summary: string[];
+  };
+  usable_usage: WorkflowUsage[];
+  /** Present when analyze was called with a target endpoint (HEL-643 L2). */
+  connection_check?: WorkflowConnectionCheck;
 }
 
 export interface WorkflowNode {
-	class_type: string;
-	inputs: Record<string, unknown>;
-	_meta?: { title?: string };
+  class_type: string;
+  inputs: Record<string, unknown>;
+  _meta?: { title?: string };
 }
 
 export interface Workflow {
-	id: number;
-	name: string;
-	kind: 'image' | 'video';
-	/** Five-way usage (HEL-636); null = pending human confirmation. */
-	usage?: WorkflowUsage | null;
-	usage_source?: 'auto' | 'user' | null;
-	workflow_json: Record<string, WorkflowNode>;
-	input_schema: ComfyDynamicInput[];
-	output_schema: ComfyDynamicOutput[];
-	description: string | null;
-	prompt_profile: string;
-	is_enabled: boolean;
-	/** Bound ComfyUI connection id (settings.comfyui_endpoints); null = active. */
-	endpoint_id?: string | null;
-	warnings?: WorkflowWarning[];
-	/** HEL-638: confirmed output mapping ({nodeId, kind}); null/empty = pending. */
-	output_map?: WorkflowOutputMapEntry[] | null;
-	output_map_source?: 'auto' | 'user' | null;
-	/** True when the graph has unknown output nodes needing designation. */
-	needs_mapping?: boolean;
-	/** Latest test-run record, queried live (HEL-643); null = never tested. */
-	last_test?: WorkflowLastTest | null;
+  id: number;
+  name: string;
+  kind: "image" | "video";
+  /** Five-way usage (HEL-636); null = pending human confirmation. */
+  usage?: WorkflowUsage | null;
+  usage_source?: "auto" | "user" | null;
+  workflow_json: Record<string, WorkflowNode>;
+  input_schema: ComfyDynamicInput[];
+  output_schema: ComfyDynamicOutput[];
+  description: string | null;
+  prompt_profile: string;
+  is_enabled: boolean;
+  /** Bound ComfyUI connection id (settings.comfyui_endpoints); null = active. */
+  endpoint_id?: string | null;
+  warnings?: WorkflowWarning[];
+  /** HEL-638: confirmed output mapping ({nodeId, kind}); null/empty = pending. */
+  output_map?: WorkflowOutputMapEntry[] | null;
+  output_map_source?: "auto" | "user" | null;
+  /** True when the graph has unknown output nodes needing designation. */
+  needs_mapping?: boolean;
+  /** Latest test-run record, queried live (HEL-643); null = never tested. */
+  last_test?: WorkflowLastTest | null;
 }
 
 /**
@@ -180,195 +186,199 @@ export interface Workflow {
  * point is browsing 150+ workflows without downloading workflow_json.
  */
 export interface WorkflowMediaIO {
-	in: string[];
-	out: string[];
+  in: string[];
+  out: string[];
 }
 
 export interface WorkflowMeta {
-	id: number;
-	name: string;
-	kind: 'image' | 'video';
-	usage: WorkflowUsage | null;
-	usage_source: 'auto' | 'user' | null;
-	is_enabled: boolean;
-	category: string | null;
-	model_family: string | null;
-	media_io: WorkflowMediaIO;
-	tags: string[];
-	favorite: boolean;
-	last_used_at: string | null;
-	description: string | null;
-	source: string | null;
-	source_path: string | null;
-	prompt_profile: string;
-	created_at: string;
-	endpoint_id: string | null;
-	output_map_source: 'auto' | 'user' | null;
-	/** Cheap pending check: usage or output mapping not settled yet. */
-	needs_mapping: boolean;
+  id: number;
+  name: string;
+  kind: "image" | "video";
+  usage: WorkflowUsage | null;
+  usage_source: "auto" | "user" | null;
+  is_enabled: boolean;
+  category: string | null;
+  model_family: string | null;
+  media_io: WorkflowMediaIO;
+  tags: string[];
+  favorite: boolean;
+  last_used_at: string | null;
+  description: string | null;
+  source: string | null;
+  source_path: string | null;
+  prompt_profile: string;
+  created_at: string;
+  endpoint_id: string | null;
+  output_map_source: "auto" | "user" | null;
+  /** Cheap pending check: usage or output mapping not settled yet. */
+  needs_mapping: boolean;
 }
 
 /** One UI-format file submitted to the batch convert/import pipeline. */
 export interface WorkflowUIFileInput {
-	name?: string;
-	source_path?: string;
-	workflow_json: Record<string, unknown>;
-	usage?: WorkflowUsage;
-	description?: string;
-	tags?: string[];
+  name?: string;
+  source_path?: string;
+  workflow_json: Record<string, unknown>;
+  usage?: WorkflowUsage;
+  description?: string;
+  tags?: string[];
 }
 
 export interface WorkflowConvertIssue {
-	node_id: string;
-	code: string;
-	level: 'error' | 'warning';
-	message: string;
+  node_id: string;
+  code: string;
+  level: "error" | "warning";
+  message: string;
 }
 
 export interface WorkflowConvertSuggested {
-	kind: 'image' | 'video';
-	usage: WorkflowUsage | null;
-	usage_ambiguous: boolean;
-	category: string | null;
-	category_label: string | null;
-	model_family: string | null;
-	media_in: string[];
-	media_out: string[];
-	description: string | null;
+  kind: "image" | "video";
+  usage: WorkflowUsage | null;
+  usage_ambiguous: boolean;
+  category: string | null;
+  category_label: string | null;
+  model_family: string | null;
+  media_in: string[];
+  media_out: string[];
+  description: string | null;
 }
 
 export interface WorkflowPreflightFinding {
-	level: string;
-	code: string;
-	node_id?: string;
-	node_title?: string;
-	message: string;
-	hint?: string;
+  level: string;
+  code: string;
+  node_id?: string;
+  node_title?: string;
+  message: string;
+  hint?: string;
 }
 
 export interface WorkflowConvertFileReport {
-	name: string;
-	source_path: string | null;
-	status: 'ok' | 'warn' | 'fail';
-	needs_confirmation: boolean;
-	issues: WorkflowConvertIssue[];
-	importable: boolean;
-	skip_reason?: string | null;
-	suggested?: WorkflowConvertSuggested;
-	preflight?: {
-		endpoint_id: string | null;
-		ok: boolean;
-		findings: WorkflowPreflightFinding[];
-	};
+  name: string;
+  source_path: string | null;
+  status: "ok" | "warn" | "fail";
+  needs_confirmation: boolean;
+  issues: WorkflowConvertIssue[];
+  importable: boolean;
+  skip_reason?: string | null;
+  suggested?: WorkflowConvertSuggested;
+  preflight?: {
+    endpoint_id: string | null;
+    ok: boolean;
+    findings: WorkflowPreflightFinding[];
+  };
 }
 
 /** Dry-run report (POST /convert, POST /import-scan with dry_run). */
 export interface WorkflowConvertReport {
-	total: number;
-	ok: number;
-	warn: number;
-	fail: number;
-	needs_confirmation: number;
-	importable: number;
-	files: WorkflowConvertFileReport[];
+  total: number;
+  ok: number;
+  warn: number;
+  fail: number;
+  needs_confirmation: number;
+  importable: number;
+  files: WorkflowConvertFileReport[];
 }
 
 export interface WorkflowImportFileReport extends WorkflowConvertFileReport {
-	result?: 'imported' | 'skipped' | 'failed';
-	id?: number;
-	existing_id?: number;
+  result?: "imported" | "skipped" | "failed";
+  id?: number;
+  existing_id?: number;
 }
 
 /** Commit result (POST /import-batch, POST /import-scan without dry_run). */
 export interface WorkflowImportResult {
-	total: number;
-	imported: number;
-	skipped: number;
-	imported_ids: number[];
-	skipped_files: { name: string; source_path: string | null; reason: string | null }[];
-	files: WorkflowImportFileReport[];
+  total: number;
+  imported: number;
+  skipped: number;
+  imported_ids: number[];
+  skipped_files: {
+    name: string;
+    source_path: string | null;
+    reason: string | null;
+  }[];
+  files: WorkflowImportFileReport[];
 }
 
 export interface Job {
-	id: number;
-	project_id: number;
-	scene_id: number | null;
-	/** Render unit — video jobs are clip jobs (scene_id stays for grouping). */
-	clip_id: number | null;
-	kind: string;
-	workflow_id: number | null;
-	status: string;
-	payload: Record<string, unknown>;
-	output_paths: string[];
-	error: string | null;
-	created_at: string;
-	started_at: string | null;
-	completed_at: string | null;
-	retry_count: number;
-	/** Prompt id ComfyUI accepted this job under (null until /prompt succeeds). */
-	comfy_prompt_id?: string | null;
-	/** connecting · comfy_queued · comfy_running · saving · finished · dry_run */
-	phase?: string | null;
-	/** 'user' (normal generation) or 'workflow_test' (HEL-643 test run). */
-	origin?: string;
-	/** HEL-684: present when this take has been flowed back to its
-	 * workbench source row (link job id on the source project). */
-	workbench_attach?: {
-		job_id: number;
-		stage: string;
-		target_id: string;
-	};
+  id: number;
+  project_id: number;
+  scene_id: number | null;
+  /** Render unit — video jobs are clip jobs (scene_id stays for grouping). */
+  clip_id: number | null;
+  kind: string;
+  workflow_id: number | null;
+  status: string;
+  payload: Record<string, unknown>;
+  output_paths: string[];
+  error: string | null;
+  created_at: string;
+  started_at: string | null;
+  completed_at: string | null;
+  retry_count: number;
+  /** Prompt id ComfyUI accepted this job under (null until /prompt succeeds). */
+  comfy_prompt_id?: string | null;
+  /** connecting · comfy_queued · comfy_running · saving · finished · dry_run */
+  phase?: string | null;
+  /** 'user' (normal generation) or 'workflow_test' (HEL-643 test run). */
+  origin?: string;
+  /** HEL-684: present when this take has been flowed back to its
+   * workbench source row (link job id on the source project). */
+  workbench_attach?: {
+    job_id: number;
+    stage: string;
+    target_id: string;
+  };
 }
 
 export interface SceneVideoSettings {
-	input_values?: Record<string, string | number>;
-	/** 'auto' | 'upload' | target scene id as string. */
-	clip_source?: string;
-	form_workflow_id?: number;
-	prompt_draft?: string;
-	prompt_draft_meta?: { based_on?: string; saved_at?: string };
-	[key: string]: unknown;
+  input_values?: Record<string, string | number>;
+  /** 'auto' | 'upload' | target scene id as string. */
+  clip_source?: string;
+  form_workflow_id?: number;
+  prompt_draft?: string;
+  prompt_draft_meta?: { based_on?: string; saved_at?: string };
+  [key: string]: unknown;
 }
 
 export interface Scene {
-	id: number;
-	project_id: number;
-	order_index: number;
-	heading: string | null;
-	action: string | null;
-	dialog: string | null;
-	duration_sec: number | null;
-	workflow_id: number | null;
-	env_image_path: string | null;
-	location_id: number | null;
-	video_path: string | null;
-	chain_from_prev?: number | boolean | null;
-	video_settings?: SceneVideoSettings | null;
-	character_ids: number[];
-	characters: Array<{
-		id: number;
-		name: string;
-		role: string | null;
-		portrait_path: string | null;
-		sheet_path: string | null;
-	}>;
-	clips: Clip[];
+  id: number;
+  project_id: number;
+  order_index: number;
+  heading: string | null;
+  action: string | null;
+  dialog: string | null;
+  duration_sec: number | null;
+  workflow_id: number | null;
+  env_image_path: string | null;
+  location_id: number | null;
+  video_path: string | null;
+  chain_from_prev?: number | boolean | null;
+  video_settings?: SceneVideoSettings | null;
+  character_ids: number[];
+  characters: Array<{
+    id: number;
+    name: string;
+    role: string | null;
+    portrait_path: string | null;
+    sheet_path: string | null;
+  }>;
+  clips: Clip[];
 }
 
 /** Shot unit: one scene expands into 1+ clips; each renders one ~5-10s video. */
 export interface Clip {
-	id: number;
-	scene_id: number;
-	project_id: number;
-	order_index: number;
-	description: string | null;
-	shot_size: string | null;
-	dialog_lines_covered: number[] | null;
-	duration_sec: number | null;
-	workflow_id: number | null;
-	clip_path: string | null;
-	chain_from_prev?: number | boolean | null;
-	video_settings?: SceneVideoSettings | null;
-	/** '#3.2' — scene 3, clip 2 (display label). */
-	label?: string;
+  id: number;
+  scene_id: number;
+  project_id: number;
+  order_index: number;
+  description: string | null;
+  shot_size: string | null;
+  dialog_lines_covered: number[] | null;
+  duration_sec: number | null;
+  workflow_id: number | null;
+  clip_path: string | null;
+  chain_from_prev?: number | boolean | null;
+  video_settings?: SceneVideoSettings | null;
+  /** '#3.2' — scene 3, clip 2 (display label). */
+  label?: string;
 }

calliope-web/src/lib/comfy/useUpload.svelte.ts

@@ -8,92 +8,96 @@
  *   - upload progress per nodeId
  *   - metadata (name, kind) for uploaded files
  */
-import { playgroundApi, type UploadKind } from '$lib/api';
-	import { toast } from '$lib/toast';
-	import { t } from '$lib/i18n.svelte';
+import { playgroundApi, type UploadKind } from "$lib/api";
+import { toast } from "$lib/toast";
+import { t } from "$lib/i18n.svelte";
 
 export interface UploadState {
-	/** nodeId → uploading filename (present while upload is in-flight) */
-	uploading: Record<string, string>;
-	/** path → { name, kind } for previously uploaded files */
-	uploadedMeta: Record<string, { name: string; kind: UploadKind }>;
+  /** nodeId → uploading filename (present while upload is in-flight) */
+  uploading: Record<string, string>;
+  /** path → { name, kind } for previously uploaded files */
+  uploadedMeta: Record<string, { name: string; kind: UploadKind }>;
 }
 
 export function createUploadManager() {
-	let uploading = $state<Record<string, string>>({});
-	let uploadedMeta = $state<Record<string, { name: string; kind: UploadKind }>>({});
+  let uploading = $state<Record<string, string>>({});
+  let uploadedMeta = $state<Record<string, { name: string; kind: UploadKind }>>(
+    {},
+  );
 
-	return {
-		get uploading() {
-			return uploading;
-		},
-		get uploadedMeta() {
-			return uploadedMeta;
-		},
+  return {
+    get uploading() {
+      return uploading;
+    },
+    get uploadedMeta() {
+      return uploadedMeta;
+    },
 
-		isUploading(nodeId: string): boolean {
-			return !!uploading[nodeId];
-		},
+    isUploading(nodeId: string): boolean {
+      return !!uploading[nodeId];
+    },
 
-		uploadMetaFor(path: string): { name: string; kind: UploadKind } {
-			const meta = uploadedMeta[path];
-			if (meta) return meta;
-			const base = path.split(/[/\\]/).pop() ?? path;
-			const ext = base.slice(base.lastIndexOf('.')).toLowerCase();
-			if (['.mp4', '.webm', '.mov', '.mkv'].includes(ext))
-				return { name: base, kind: 'video' };
-			if (['.mp3', '.wav', '.flac', '.ogg', '.m4a'].includes(ext))
-				return { name: base, kind: 'audio' };
-			return { name: base, kind: 'image' };
-		},
+    uploadMetaFor(path: string): { name: string; kind: UploadKind } {
+      const meta = uploadedMeta[path];
+      if (meta) return meta;
+      const base = path.split(/[/\\]/).pop() ?? path;
+      const ext = base.slice(base.lastIndexOf(".")).toLowerCase();
+      if ([".mp4", ".webm", ".mov", ".mkv"].includes(ext))
+        return { name: base, kind: "video" };
+      if ([".mp3", ".wav", ".flac", ".ogg", ".m4a"].includes(ext))
+        return { name: base, kind: "audio" };
+      return { name: base, kind: "image" };
+    },
 
-		/**
-		 * Upload a file and return the server path.
-		 * Manages uploading state and metadata internally.
-		 * Throws on failure (caller handles toast if needed).
-		 */
-		async upload(nodeId: string, file: File): Promise<string> {
-			uploading = { ...uploading, [nodeId]: file.name };
-			try {
-				const res = await playgroundApi.upload(file);
-				uploadedMeta = {
-					...uploadedMeta,
-					[res.path]: { name: res.name, kind: res.kind },
-				};
-				return res.path;
-			} finally {
-				const next = { ...uploading };
-				delete next[nodeId];
-				uploading = next;
-			}
-		},
+    /**
+     * Upload a file and return the server path.
+     * Manages uploading state and metadata internally.
+     * Throws on failure (caller handles toast if needed).
+     */
+    async upload(nodeId: string, file: File): Promise<string> {
+      uploading = { ...uploading, [nodeId]: file.name };
+      try {
+        const res = await playgroundApi.upload(file);
+        uploadedMeta = {
+          ...uploadedMeta,
+          [res.path]: { name: res.name, kind: res.kind },
+        };
+        return res.path;
+      } finally {
+        const next = { ...uploading };
+        delete next[nodeId];
+        uploading = next;
+      }
+    },
 
-		/**
-		 * Convenience: upload + toast on error, return path or null.
-		 */
-		async uploadSafe(nodeId: string, file: File): Promise<string | null> {
-			try {
-				return await this.upload(nodeId, file);
-			} catch (err) {
-				toast.error(err instanceof Error ? err.message : t('toast.uploadFailed'));
-				return null;
-			}
-		},
-	};
+    /**
+     * Convenience: upload + toast on error, return path or null.
+     */
+    async uploadSafe(nodeId: string, file: File): Promise<string | null> {
+      try {
+        return await this.upload(nodeId, file);
+      } catch (err) {
+        toast.error(
+          err instanceof Error ? err.message : t("toast.uploadFailed"),
+        );
+        return null;
+      }
+    },
+  };
 }
 
 export type UploadManager = ReturnType<typeof createUploadManager>;
 
 export function truncateMiddle(name: string, max = 32): string {
-	if (name.length <= max) return name;
-	const head = Math.ceil((max - 1) / 2);
-	const tail = Math.floor((max - 1) / 2);
-	return `${name.slice(0, head)}…${name.slice(name.length - tail)}`;
+  if (name.length <= max) return name;
+  const head = Math.ceil((max - 1) / 2);
+  const tail = Math.floor((max - 1) / 2);
+  return `${name.slice(0, head)}…${name.slice(name.length - tail)}`;
 }
 
 export function acceptForKind(kind: string): string {
-	if (kind === 'audio') return 'audio/*';
-	if (kind === 'video') return 'video/*,.mp4,.webm,.mov,.mkv';
-	if (kind === 'document') return '.txt,.md,.docx';
-	return 'image/*';
+  if (kind === "audio") return "audio/*";
+  if (kind === "video") return "video/*,.mp4,.webm,.mov,.mkv";
+  if (kind === "document") return ".txt,.md,.docx";
+  return "image/*";
 }

calliope-web/src/lib/components/AppHeader.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import LanguageSwitcher from '$lib/components/LanguageSwitcher.svelte';
 	import { t } from '$lib/i18n.svelte';
 
@@ -15,7 +16,7 @@ interface Props {
 
 <header class="header">
 	<div class="header-left">
-		<a class="logo" href="/" title={t('shell.brand')}>
+		<a class="logo" href={resolve('/')} title={t('shell.brand')}>
 			{t('shell.brand')}
 		</a>
 		{#if crumb}
@@ -27,13 +28,13 @@ interface Props {
 			</div>
 		{/if}
 		<nav class="top-nav" aria-label={t('nav.primary')}>
-			<a class="nav-link" class:active={active === 'canvas'} href="/canvas">{t('nav.canvas')}</a>
-			<a class="nav-link" class:active={active === 'projects'} href="/">{t('nav.projects')}</a>
-			<a class="nav-link" class:active={active === 'build-scene'} href="/build-scene">{t('nav.buildScene')}</a>
-			<a class="nav-link" class:active={active === 'library'} href="/library">{t('nav.library')}</a>
-			<a class="nav-link" class:active={active === 'agents'} href="/agents">{t('nav.agents')}</a>
-			<a class="nav-link" class:active={active === 'models'} href="/models">{t('nav.models')}</a>
-			<a class="nav-link" class:active={active === 'settings'} href="/settings">{t('nav.settings')}</a>
+			<a class="nav-link" class:active={active === 'canvas'} href={resolve('/canvas')}>{t('nav.canvas')}</a>
+			<a class="nav-link" class:active={active === 'projects'} href={resolve('/')}>{t('nav.projects')}</a>
+			<a class="nav-link" class:active={active === 'build-scene'} href={resolve('/build-scene')}>{t('nav.buildScene')}</a>
+			<a class="nav-link" class:active={active === 'library'} href={resolve('/library')}>{t('nav.library')}</a>
+			<a class="nav-link" class:active={active === 'agents'} href={resolve('/agents')}>{t('nav.agents')}</a>
+			<a class="nav-link" class:active={active === 'models'} href={resolve('/models')}>{t('nav.models')}</a>
+			<a class="nav-link" class:active={active === 'settings'} href={resolve('/settings')}>{t('nav.settings')}</a>
 		</nav>
 	</div>
 	<div class="header-right">

calliope-web/src/lib/components/AttachToProject.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import { createMutation, createQuery } from '@tanstack/svelte-query';
 	import {
 		playgroundApi,
@@ -137,9 +138,6 @@
 	const projectList = $derived(($projectsQuery.data ?? []) as Project[]);
 
 	// Five-stage workbench URL contract: images land on 素材资产, clips on 镜头脚本.
-	const stageLink = $derived(
-		attached ? `/workbench/${attached.projectId}?stage=${isVideo ? 'shot' : 'assets'}` : '',
-	);
 </script>
 
 <div class="attach">
@@ -147,7 +145,7 @@
 		<div class="attached" role="status">
 			<span class="attached-check" aria-hidden="true"><Icon name="check" size={14} /></span>
 			<span class="attached-text">{t('attach.addedTo')} <strong>{attached.title}</strong></span>
-			<a class="attached-link" href={stageLink}>{t('attach.viewInProject')}</a>
+			<a class="attached-link" href={resolve(`/workbench/${attached.projectId}?stage=${isVideo ? 'shot' : 'assets'}`)}>{t('attach.viewInProject')}</a>
 			<button
 				class="attached-dismiss"
 				type="button"
@@ -173,7 +171,7 @@
 				<span class="field-label">{t('attach.projectField')}</span>
 				<select class="field-select" bind:value={projectId}>
 					<option value="">{t('attach.selectProject')}</option>
-					{#each projectList as p}
+					{#each projectList as p (p.id)}
 						<option value={p.id}>{p.title}</option>
 					{/each}
 				</select>
@@ -194,7 +192,7 @@
 						<span class="field-label">{t('attach.characterField')}</span>
 						<select class="field-select" bind:value={characterId} disabled={projectId === '' || loadingTargets}>
 							<option value="">{t('attach.selectCharacter')}</option>
-							{#each characters as c}
+							{#each characters as c (c.id)}
 								<option value={c.id}>{c.name}</option>
 							{/each}
 						</select>
@@ -207,7 +205,7 @@
 						<span class="field-label">{t('attach.locationField')}</span>
 						<select class="field-select" bind:value={locationId} disabled={projectId === '' || loadingTargets}>
 							<option value="">{t('attach.selectLocation')}</option>
-							{#each locations as loc}
+							{#each locations as loc (loc.id)}
 								<option value={loc.id}>{loc.name}</option>
 							{/each}
 						</select>
@@ -232,7 +230,7 @@
 					<span class="field-label">{t('attach.sceneField')}</span>
 					<select class="field-select" bind:value={sceneId} disabled={projectId === '' || loadingTargets}>
 						<option value="">{t('attach.selectScene')}</option>
-						{#each scenes as s}
+						{#each scenes as s (s.id)}
 							<option value={s.id}>#{s.order_index} {s.heading || t('attach.scene')}</option>
 						{/each}
 					</select>

calliope-web/src/lib/components/ComfyDynamicForm.svelte

@@ -229,6 +229,7 @@
 
 {#if inputs.length === 0}
 	<p class="muted">
+		<!-- eslint-disable-next-line svelte/no-at-html-tags -- This fixed key comes only from the seven bundled translation dictionaries, without interpolation or remote overrides. Retain the existing HTML-capable translation contract. -->
 		{@html t('cdf.noInputs')}
 	</p>
 {:else}
@@ -381,7 +382,8 @@
 									}}
 								>
 									<option value="">{t('cdf.chooseAsset')}</option>
-									{#each assetOptions as opt}
+									<!-- Asset paths may repeat; option selection belongs to the parent value. Keep positional reuse. -->
+									{#each assetOptions as opt, i (i)}
 										<option value={opt.path}>{opt.label}</option>
 									{/each}
 								</select>
@@ -422,7 +424,8 @@
 								}}
 							>
 								<option value="">{t('cdf.chooseAsset')}</option>
-								{#each assetOptions as opt}
+								<!-- Asset paths may repeat; option selection belongs to the parent value. Keep positional reuse. -->
+								{#each assetOptions as opt, i (i)}
 									<option value={opt.path}>{opt.label}</option>
 								{/each}
 							</select>
@@ -453,7 +456,8 @@
 							}}
 						>
 							<option value="">{t('cdf.chooseAsset')}</option>
-							{#each assetOptions as opt}
+							<!-- Asset paths may repeat; option selection belongs to the parent value. Keep positional reuse. -->
+							{#each assetOptions as opt, i (i)}
 								<option value={opt.path}>{opt.label}</option>
 							{/each}
 						</select>

calliope-web/src/lib/components/ImageLightbox.svelte

@@ -129,6 +129,7 @@
 				class="tool"
 				href={src}
 				download={downloadName}
+				rel="external"
 				aria-label={t('lightbox.downloadMedia')}
 				title={t('lightbox.download')}
 				onclick={(e) => e.stopPropagation()}
@@ -208,7 +209,7 @@
 			{:else}
 				{t('lightbox.clickToZoom')} · {t('lightbox.closeHint')} ·
 			{/if}
-			<a href={src} target="_blank" rel="noopener" onclick={(e) => e.stopPropagation()}
+			<a href={src} target="_blank" rel="noopener external" onclick={(e) => e.stopPropagation()}
 				>{t('lightbox.openOriginal')}</a
 			>
 		</p>

calliope-web/src/lib/components/LanguageSwitcher.svelte

@@ -1,37 +1,56 @@
 <script lang="ts">
-	import { language, setLanguage, type Language } from '$lib/i18n.svelte';
-	import { t } from '$lib/i18n.svelte';
+  import { language, setLanguage, type Language } from "$lib/i18n.svelte";
+  import { t } from "$lib/i18n.svelte";
+  let { segmented = false }: { segmented?: boolean } = $props();
+  const languages: [Language, string][] = [
+    ["zh", "中文"],
+    ["en", "English"],
+    ["ja", "日本語"],
+    ["ko", "한국어"],
+    ["de", "Deutsch"],
+    ["es", "Español"],
+    ["fr", "Français"],
+  ];
 </script>
 
-<select
-	class="lang-switcher"
-	value={language.current}
-	aria-label={t('common.language')}
-	onchange={(e) => setLanguage(e.currentTarget.value as Language)}
->
-	<option value="de">Deutsch</option>
-	<option value="en">English</option>
-	<option value="es">Español</option>
-	<option value="fr">Français</option>
-	<option value="ja">日本語</option>
-	<option value="ko">한국어</option>
-	<option value="zh">中文</option>
-</select>
+{#if segmented}<div class="mg-options" aria-label={t("common.language")}>
+    {#each languages as [code, label] (code)}<button
+        class="mg-option"
+        class:on={language.current === code}
+        aria-pressed={language.current === code}
+        onclick={() => setLanguage(code)}>{label}</button
+      >{/each}
+  </div>{:else}
+  <select
+    class="lang-switcher"
+    value={language.current}
+    aria-label={t("common.language")}
+    onchange={(e) => setLanguage(e.currentTarget.value as Language)}
+  >
+    <option value="de">Deutsch</option>
+    <option value="en">English</option>
+    <option value="es">Español</option>
+    <option value="fr">Français</option>
+    <option value="ja">日本語</option>
+    <option value="ko">한국어</option>
+    <option value="zh">中文</option>
+  </select>
+{/if}
 
 <style>
-	.lang-switcher {
-		background: var(--bg-elevated);
-		color: var(--text-primary);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-sm);
-		padding: 6px 8px;
-		font-size: 12px;
-		font-family: inherit;
-		cursor: pointer;
-		min-height: 34px;
-	}
-	.lang-switcher:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
-	}
-</style>
+  .lang-switcher {
+    background: var(--bg-elevated);
+    color: var(--text-primary);
+    border: 1px solid var(--border);
+    border-radius: var(--radius-sm);
+    padding: 6px 8px;
+    font-size: 12px;
+    font-family: inherit;
+    cursor: pointer;
+    min-height: 34px;
+  }
+  .lang-switcher:focus-visible {
+    outline: 2px solid var(--accent);
+    outline-offset: 2px;
+  }
+</style>

calliope-web/src/lib/components/OmniComposer.svelte

@@ -18,7 +18,7 @@
 	import { createUploadManager } from '$lib/comfy/useUpload.svelte';
 	import { normalizeInputRole } from '$lib/comfy/parser';
 	import type { AssetOption } from '$lib/assetPicker';
-	import { assetUrl } from '$lib/api';
+	import '$lib/api';
 	import Icon from '$lib/components/ui/Icon.svelte';
 	import { t } from '$lib/i18n.svelte';
 	import PillSelect from './omni/PillSelect.svelte';

calliope-web/src/lib/components/ToastHost.svelte

@@ -61,7 +61,7 @@
 	.toast-host {
 		position: fixed;
 		right: 24px;
-		bottom: 24px;
+		bottom: var(--toast-bottom, 24px);
 		/* Above every overlay, incl. the 10000 lightbox, so feedback stays visible. */
 		z-index: 10001;
 		display: flex;

calliope-web/src/lib/components/WorkflowTestDialog.svelte

@@ -48,7 +48,7 @@
     onchanged,
   }: Props = $props();
 
-  const client = useQueryClient();
+  useQueryClient();
 
   let endpointId = $state('');
   let values = $state<Record<string, string | number>>({});
@@ -146,7 +146,7 @@
     if (stageLog[stageLog.length - 1] !== line) stageLog = [...stageLog, line];
   });
   $effect(() => {
-    stageLog.length;
+    void stageLog.length;
     if (logBox) logBox.scrollTop = logBox.scrollHeight;
   });
 
@@ -447,7 +447,7 @@
                 href={assetUrl(path)}
                 download
                 target="_blank"
-                rel="noreferrer"
+                rel="noreferrer external"
                 title={t('wft.download')}
               >
                 <SafeMedia

calliope-web/src/lib/components/agent/AgentChat.svelte

@@ -10,6 +10,7 @@
 	import { t } from '$lib/i18n.svelte';
 
 	interface Props {
+        studio?: boolean;
 		messages: AgentMessage[];
 		/** In-flight tool calls for the current turn (from agent.tool SSE). */
 		liveTools: { tool: string; args?: Record<string, unknown> | null; result?: unknown; phase: 'running' | 'done' | 'error' }[];
@@ -31,6 +32,7 @@
 	}
 
 	let {
+        studio = false,
 		messages,
 		liveTools,
 		streaming,
@@ -46,6 +48,21 @@
 	let listEl = $state<HTMLDivElement | null>(null);
 	let pinned = $state(true);
 
+    // A user message starts a turn; keep different named assistants distinct.
+    const studioGroups = $derived.by(() => {
+        const groups: AgentMessage[][] = [];
+        for (const message of messages) {
+            if (!['user', 'assistant', 'tool'].includes(message.role)) continue;
+            const previous = groups.at(-1);
+            const author = previous?.find(m => m.role === 'assistant')?.agent_name;
+            if (!previous || message.role === 'user' || previous[0].role === 'user' ||
+                (message.role === 'assistant' && author !== undefined && message.agent_name !== author)) {
+                groups.push([message]);
+            } else previous.push(message);
+        }
+        return groups;
+    });
+
 	// Derived tool rows carry no status — infer failure from the result shape,
 	// same as the live SSE path does.
 	function toolPhase(m: AgentMessage): 'done' | 'error' {
@@ -61,6 +78,7 @@
 
 	/** Later tool results (wait_for_jobs) often have the finished status + paths. */
 	const trailJobsById = $derived.by(() => {
+		// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Each derivation rebuilds this tool-result lookup from messages; only the completed Map escapes, with no later mutation.
 		const map = new Map<number, ArtifactJob>();
 		for (const row of messages) {
 			if (row.role !== 'tool' || !row.tool_result || typeof row.tool_result !== 'object') continue;
@@ -188,6 +206,35 @@
 </script>
 
 <div class="chat" bind:this={listEl} onscroll={onScroll}>
+    {#if studio}
+      {#if loading}<p class="studio-empty">{t('agentChat.loading')}</p>{/if}
+      {#each studioGroups as group (group[0].id)}
+          <div class="studio-msg" class:me={group[0].role==='user'}>
+            <div class="studio-avatar" title={group[0].role==='user'?'我':agentDisplayName(group[0].agent_name)}>{#if group[0].role==='user'}我{:else}<Icon name="project-agent" size={14}/>{/if}</div>
+            <div class="studio-message-body">
+              {#each group as m (m.id)}
+                {#if m.role==='tool'}
+                  <AgentToolCard studio name={m.tool_name??'tool'} args={m.tool_args} result={m.tool_result} phase={toolPhase(m)}/>
+                  {#each artifactJobs(m) as job(job.id)}<AgentArtifactCard {job}/>{/each}
+                {:else}
+                  {#if m.reasoning}<ReasoningPanel reasoning={m.reasoning}/>{/if}
+<div class="studio-bubble" data-message-id={m.id} class:failed={m.status==='error'||m.status==='cancelled'}>{#if m.status==='steering'}<small>{t('agentChat.steering')}</small>{/if}{#each m.attachments??[] as a (a.path)}<a href={assetUrl(a.path)??'#'} target="_blank" rel="noopener external">{a.name}</a>{/each}{#each bubbleParts(m.content,(m.mentions??[]) as WorkflowMention[]) as part,i (`${i}-${part.type}`)}{#if part.type==='chip'}<span class="wf-chip">{part.text}</span>{:else}{part.text}{/if}{/each}</div>
+                {/if}
+              {/each}
+            </div>
+          </div>
+      {/each}
+      {#if lastQuestion && !running}<div class="question-card"><p>{lastQuestion.question}</p><div class="question-options">{#each lastQuestion.options as opt(opt)}<button type="button" class="question-option" onclick={()=>onAnswer?.(opt,lastQuestion.scope,lastQuestion.questionSeq)}>{opt}</button>{/each}</div></div>{/if}
+      {#if running && (liveTools.length || streamingReasoning || streaming)}
+        <div class="studio-msg"><div class="studio-avatar"><Icon name="project-agent" size={14}/></div><div class="studio-message-body">
+          {#each liveTools as tool,i(i)}<AgentToolCard studio name={tool.tool} args={tool.args} result={tool.result} phase={tool.phase}/>{/each}
+          {#if streamingReasoning}<ReasoningPanel reasoning={streamingReasoning}/>{/if}
+          {#if streaming}<div class="studio-bubble">{streaming}</div>{/if}
+        </div></div>
+      {/if}
+      {#if !loading&&!messages.length&&!running}<p class="studio-empty">{t('agentChat.emptyHint')}</p>{/if}
+    {:else}
+
 	{#if loading}
 		<div class="empty">
 			<p class="empty-hint">{t('agentChat.loading')}</p>
@@ -328,9 +375,20 @@
 			</div>
 		</div>
 	{/if}
+    {/if}
 </div>
 
 <style>
+    .studio-msg {display:flex;gap:10px;max-width:760px;}
+    .studio-msg.me {align-self:flex-end;flex-direction:row-reverse;}
+    .studio-avatar {width:28px;height:28px;border-radius:var(--agent-radius-8);flex:none;display:grid;place-items:center;background:color-mix(in srgb,var(--sc-agent) 18%,transparent);color:var(--sc-agent);}
+    .studio-msg.me .studio-avatar {background:var(--bg-3);color:var(--tx-2);}
+    .studio-message-body {flex:var(--agent-message-flex);display:flex;flex-direction:column;gap:10px;min-width:0;}
+    .studio-bubble {padding:10px 13px;border-radius:var(--agent-bubble-radius);background:var(--bg-2);border:1px solid var(--line);font-size:13px;line-height:1.65;white-space:pre-wrap;word-break:break-word;}
+    .studio-msg.me .studio-bubble {background:color-mix(in srgb,var(--gold) 10%,transparent);border-color:color-mix(in srgb,var(--gold) 25%,transparent);}
+    .studio-bubble.failed {color:var(--err);border-color:var(--err);}
+    .studio-empty {color:var(--tx-3);font-size:12px;}
+
 	.chat {
 		flex: 1;
 		min-height: 0;
@@ -341,7 +399,7 @@
 		display: flex;
 		flex-direction: column;
 		gap: 14px;
-		padding: 4px 4px 12px;
+		padding: var(--chat-padding, 4px 4px 12px);
 	}
 	.empty {
 		margin: auto;

calliope-web/src/lib/components/agent/AgentComposer.svelte

@@ -20,6 +20,7 @@
 	import { t } from '$lib/i18n.svelte';
 
 interface Props {
+	studio?: boolean;
 	running: boolean;
 	onSend: (payload: AgentComposerPayload) => void;
 	onCancel: () => void;
@@ -34,6 +35,7 @@ interface Props {
 }
 
 let {
+	studio = false,
 	running,
 	onSend,
 	onCancel,
@@ -76,6 +78,7 @@ let {
 		void draftNonce;
 		if (draftNonce === 0) return;
 		if (!editorEl) return;
+		// eslint-disable-next-line svelte/no-dom-manipulating -- Template owns the empty editor shell; its user-editable subtree is imperative. Restore draft text before caret placement/focus and serialization.
 		editorEl.textContent = draft;
 		placeCaretAtEnd(editorEl);
 		editorEl.focus();
@@ -161,6 +164,7 @@ let {
 			attachments: [...attachments],
 		};
 		if (payloadIsEmpty(payload)) return;
+		// eslint-disable-next-line svelte/no-dom-manipulating -- Template does not render editor children; after serializing text/chips, clear the user-owned subtree before onSend, preserving submit/reset behavior.
 		if (editorEl) editorEl.innerHTML = '';
 		attachments = [];
 		mentionOpen = false;
@@ -291,8 +295,10 @@ let {
 			chip.after(space);
 			placeCaretAfter(space);
 		} else {
+			// eslint-disable-next-line svelte/no-dom-manipulating -- Editor owns its children: fallback appends a noneditable workflow chip whose dataset serialize reads; keep template shell and caret logic intact.
 			editorEl.appendChild(makeChip(wf));
 			const space = document.createTextNode('\u00a0');
+			// eslint-disable-next-line svelte/no-dom-manipulating -- Editor-owned trailing space provides a text caret after the workflow chip; placeCaretAfter uses this exact node.
 			editorEl.appendChild(space);
 			placeCaretAfter(space);
 		}
@@ -327,8 +333,10 @@ let {
 			chip.after(space);
 			placeCaretAfter(space);
 		} else {
+			// eslint-disable-next-line svelte/no-dom-manipulating -- Editor owns its children: fallback appends a noneditable skill chip whose dataset serialize reads; keep template shell and caret logic intact.
 			editorEl.appendChild(makeSkillChip(skill));
 			const space = document.createTextNode('\u00a0');
+			// eslint-disable-next-line svelte/no-dom-manipulating -- Editor-owned trailing space provides a text caret after the skill chip; placeCaretAfter uses this exact node.
 			editorEl.appendChild(space);
 			placeCaretAfter(space);
 		}
@@ -543,6 +551,7 @@ let {
 			onpaste={onPaste}
 		></div>
 		<div class="actions">
+            {#if studio}<button type="button" class="b4-chip workflow-shortcut" disabled={busy} onclick={()=>{editorEl?.focus();mentionQuery='';mentionIndex=0;mentionAnchor=caretAnchor();mentionLocked=false;mentionOpen=true;}}>@ 工作流</button>{/if}
 			<input
 				bind:this={fileInput}
 				type="file"
@@ -553,29 +562,31 @@ let {
 			/>
 			<button
 				type="button"
-				class="attach"
+				class={studio ? "b4-chip" : "attach"}
 				title={t('agentComposer.attach')}
 				disabled={busy}
 				onclick={() => fileInput?.click()}
 			>
-				<Icon name="paperclip" size={16} />
+				{#if studio}+ 参考材料{:else}<Icon name="paperclip" size={16} />{/if}
 			</button>
+			{#if studio}<span class="b4-grow"></span>{/if}
 			{#if running}
-				<button type="button" class="send stop" onclick={onCancel} title={t('agentComposer.stopTitle')}>
-					<Icon name="stop" size={14} />
+				<button type="button" class={studio ? "a-btn sm ghost stop" : "send stop"} onclick={onCancel} title={t('agentComposer.stopTitle')}>
+					{#if !studio}<Icon name="stop" size={14} />{/if}
 					{t('common.stop')}
 				</button>
 			{/if}
 			<button
 				type="button"
-				class="send"
+				class={studio ? "a-btn sm primary" : "send"}
 				class:steer={running}
 				onclick={submit}
 				disabled={!sendable}
 				title={running ? t('agentComposer.steerTitle') : t('agentComposer.sendTitle')}
 			>
+				{#if studio}<Icon name="agent-send" size={14} />{/if}
 				{running ? t('agentComposer.steer') : t('common.send')}
-				<Icon name="chevron-right" size={14} />
+				{#if !studio}<Icon name="chevron-right" size={14} />{/if}
 			</button>
 		</div>
 	</div>
@@ -611,8 +622,8 @@ let {
 		gap: 8px;
 		width: 100%;
 		min-width: 0;
-		padding-top: 10px;
-		border-top: 1px solid var(--border);
+		padding-top: var(--composer-top-padding, 10px);
+		border-top: var(--composer-top-border, 1px) solid var(--border);
 	}
 	.composer.drag-over .box {
 		border-color: var(--accent);
@@ -680,18 +691,19 @@ let {
 	}
 	.box {
 		display: flex;
-		align-items: flex-end;
+		align-items: var(--composer-box-align, flex-end);
+		flex-direction: var(--composer-box-direction, row);
 		gap: 8px;
 		min-width: 0;
-		background: var(--bg-surface);
-		border: 1px solid var(--border);
+		background: var(--composer-box-bg, var(--bg-surface));
+		border: var(--composer-box-border, 1px) solid var(--border);
 		border-radius: var(--radius-md);
-		padding: 8px 8px 8px 12px;
+		padding: var(--composer-box-padding, 8px 8px 8px 12px);
 	}
 	.editor {
 		flex: 1;
 		min-width: 0;
-		min-height: 28px;
+		min-height: var(--composer-editor-height, 28px);
 		max-height: 160px;
 		overflow-y: auto;
 		color: var(--text-primary);
@@ -735,22 +747,26 @@ let {
 	}
 	.actions {
 		display: flex;
+		justify-content:var(--composer-actions-justify,normal);
 		align-items: center;
-		gap: 6px;
+		gap: var(--composer-actions-gap, 6px);
 		flex-shrink: 0;
 	}
 	.attach {
 		display: inline-flex;
 		align-items: center;
 		justify-content: center;
-		width: 36px;
-		height: 36px;
+		width: var(--composer-attach-width,36px);
+		height: var(--composer-attach-height,36px);
+		padding:var(--composer-attach-padding,0px);
+		margin-right:var(--composer-attach-margin,0px);
 		border: none;
 		border-radius: var(--radius-md);
 		background: transparent;
 		color: var(--text-secondary);
 		cursor: pointer;
 	}
+	.workflow-shortcut {font-size:12px;white-space:nowrap;flex:none;}
 	.attach:hover:not(:disabled) {
 		color: var(--text-primary);
 		background: var(--bg-elevated);
@@ -767,11 +783,11 @@ let {
 		display: inline-flex;
 		align-items: center;
 		gap: 6px;
-		height: 36px;
+		height: var(--composer-send-height, 36px);
 		padding: 0 14px;
 		border-radius: var(--radius-md);
 		border: 1px solid var(--accent);
-		background: var(--accent);
+		background: var(--composer-send-bg, var(--accent));
 		color: var(--accent-ink);
 		font-size: 13px;
 		font-weight: 600;

calliope-web/src/lib/components/agent/AgentSessionSidebar.svelte

@@ -28,6 +28,7 @@
 
 	const sandbox = $derived(sessions.filter((s) => s.project_id == null));
 	const grouped = $derived.by(() => {
+		// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Local grouping accumulator is consumed as an array in this derivation; sessions drive recomputation, not Map writes.
 		const map = new Map<number, { project: AgentSession['project']; items: AgentSession[] }>();
 		for (const s of sessions) {
 			if (s.project_id == null) continue;

calliope-web/src/lib/components/agent/AgentToolCard.svelte

@@ -3,13 +3,14 @@
 	import { t } from '$lib/i18n.svelte';
 
 	interface Props {
+		studio?: boolean;
 		name: string;
 		args?: Record<string, unknown> | null;
 		result?: unknown;
 		phase: 'running' | 'done' | 'error';
 	}
 
-	let { name, args = null, result = null, phase }: Props = $props();
+	let { studio = false, name, args = null, result = null, phase }: Props = $props();
 	let open = $state(false);
 
 	function fmt(value: unknown): string {
@@ -21,18 +22,19 @@
 	}
 </script>
 
-<div class="tool-card" class:error={phase === 'error'}>
+<div class="tool-card" class:done={studio && phase === 'done'} class:error={phase === 'error'}>
 	<button type="button" class="head" onclick={() => (open = !open)} aria-expanded={open}>
-		<span class="dot" class:running={phase === 'running'}></span>
+		{#if studio}<Icon name="nav-flow" size={14} /><span>调用</span>{:else}<span class="dot" class:running={phase === 'running'}></span>{/if}
 		<span class="name mono">{name}</span>
+        {#if studio && args && Object.keys(args).length}<span class="summary">· {Object.entries(args).map(([key, value]) => `${key}=${JSON.stringify(value)}`).join(' · ')}</span>{/if}
 		{#if phase === 'running'}
-			<span class="state">{t('agentTool.running')}</span>
+			<span class={studio ? "state a-tag" : "state"}>{t('agentTool.running')}</span>
 		{:else if phase === 'error'}
-			<span class="state err-text">{t('agentTool.failed')}</span>
+			<span class={studio ? "state a-tag err-text" : "state err-text"}>{t('agentTool.failed')}</span>
 		{:else}
-			<span class="state ok-text">{t('agentTool.done')}</span>
+			<span class={studio ? "state a-tag ok-text" : "state ok-text"}>{t('agentTool.done')}</span>
 		{/if}
-		<span class="chev"><Icon name="chevron-down" size={13} /></span>
+		{#if !studio}<span class="chev"><Icon name="chevron-down" size={13} /></span>{/if}
 	</button>
 	{#if open}
 		<div class="body">
@@ -54,9 +56,10 @@
 
 <style>
 	.tool-card {
-		border: 1px solid var(--border);
-		border-radius: var(--radius-sm);
-		background: var(--bg-elevated);
+        font-size: var(--tool-font, inherit);
+		border: 1px solid var(--tool-border, var(--border));
+		border-radius: var(--tool-card-radius, var(--radius-sm));
+		background: var(--tool-card-bg, var(--bg-elevated));
 		overflow: hidden;
 	}
 	.tool-card.error {
@@ -67,12 +70,12 @@
 		align-items: center;
 		gap: 8px;
 		width: 100%;
-		padding: 7px 10px;
+		padding: var(--tool-head-padding, 7px 10px);
 		background: transparent;
 		border: none;
 		cursor: pointer;
-		color: var(--text-secondary);
-		font-size: 12px;
+		color: var(--tool-head-color, var(--text-secondary));
+		font-size: var(--tool-head-font, 12px);
 		text-align: left;
 	}
 	.head:hover {
@@ -80,14 +83,20 @@
 		background: var(--bg-3);
 	}
 	.name {
-		flex: 1;
+		flex: var(--tool-name-flex, 1);
 		min-width: 0;
-		font-size: 12px;
-		color: var(--text-primary);
+		font-size: var(--tool-name-font, 12px);
+		color: var(--tool-name-color, var(--text-primary));
 		overflow: hidden;
 		text-overflow: ellipsis;
 		white-space: nowrap;
 	}
+	.summary {
+        min-width: 0;
+        overflow: hidden;
+        text-overflow: ellipsis;
+        white-space: nowrap;
+    }
 	.dot {
 		width: 7px;
 		height: 7px;
@@ -115,10 +124,10 @@
 		flex-shrink: 0;
 	}
 	.ok-text {
-		color: var(--success);
+		color: var(--tool-ok-color, var(--success));
 	}
 	.err-text {
-		color: var(--error);
+		color: var(--tool-error-color, var(--error));
 	}
 	.chev {
 		display: inline-flex;

calliope-web/src/lib/components/agent/AgentWorkspace.svelte

@@ -0,0 +1,982 @@
+<script lang="ts">
+  import "./workspace.css";
+  import { onMount, untrack } from "svelte";
+  import { page } from "$app/state";
+  import { goto } from "$app/navigation";
+  import { resolve } from "$app/paths";
+  import { createQuery, useQueryClient } from "@tanstack/svelte-query";
+  import { toStore } from "svelte/store";
+  import AppShell from "$lib/components/shell/AppShell.svelte";
+  import type { IconName } from "$lib/components/ui/icons";
+  import Icon from "$lib/components/ui/Icon.svelte";
+  import AgentChat from "./AgentChat.svelte";
+  import AgentPlanPanel from "./AgentPlanPanel.svelte";
+  import Modal from "$lib/components/ui/Modal.svelte";
+  import AgentComposer from "./AgentComposer.svelte";
+  import {
+    agentApi,
+    resultsApi,
+    jobsApi,
+    assetUrl,
+    settings,
+    workflows,
+    workbenchApi,
+    type AgentDeliverable,
+    type AgentSession,
+    type WorkbenchStageKey,
+  } from "$lib/api";
+  import { createUploadManager } from "$lib/comfy/useUpload.svelte";
+  import type { AgentAttachment } from "$lib/agentComposer";
+  import type { AgentComposerPayload } from "$lib/agentComposer";
+  import { connectEvents } from "$lib/events";
+  import { toast } from "$lib/toast";
+
+  const client = useQueryClient();
+  const stageNames: Record<WorkbenchStageKey, string> = {
+    script: "剧本创作",
+    style: "视觉设计",
+    storyboard: "分镜设计",
+    assets: "素材资产",
+    shot: "镜头脚本",
+  };
+  const assistantIcons: Record<string, IconName> = {
+    script: "project-book",
+    style: "nav-palette",
+    storyboard: "project-grid",
+    assets: "project-image",
+    shot: "project-film",
+  };
+  const assistantColors: Record<string, string> = {
+    script: "var(--sc-agent)",
+    style: "var(--gold)",
+    storyboard: "var(--sc-image)",
+    assets: "var(--sc-asset)",
+    shot: "var(--sc-video)",
+  };
+  const assistantDescriptions: Record<string, string> = {
+    script: "故事、人物、场次与台词",
+    style: "风格板、色彩与参考图",
+    storyboard: "镜头拆分、景别与时长",
+    assets: "角色、场景、道具出图",
+    shot: "逐镜视频提示词与生成",
+  };
+  const keys = Object.keys(stageNames) as WorkbenchStageKey[];
+  const registry = createQuery({
+    queryKey: ["agents-registry"],
+    queryFn: agentApi.listNamedAgents,
+  });
+  const config = createQuery({ queryKey: ["settings"], queryFn: settings.get });
+  const skills = createQuery({
+    queryKey: ["b4-skills"],
+    queryFn: () => agentApi.listSkillsAdmin(),
+  });
+  const wfQuery = createQuery({
+    queryKey: ["b4-workflows"],
+    queryFn: workflows.list,
+  });
+  const projects = createQuery({
+    queryKey: ["b4-projects"],
+    queryFn: agentApi.listLinkableProjects,
+  });
+  const sessions = createQuery({
+    queryKey: ["b4-sessions"],
+    queryFn: async () =>
+      (
+        await Promise.all([
+          agentApi.listSessions(),
+          ...keys.map(agentApi.listAgentSessions),
+        ])
+      )
+        .flat()
+        .sort((a, b) => b.updated_at.localeCompare(a.updated_at)),
+  });
+  const allResults = createQuery({
+    queryKey: ["b4-results"],
+    queryFn: () => resultsApi.list(),
+  });
+  const activeId = $derived(
+    Number(page.url.searchParams.get("session")) || null,
+  );
+  const session = createQuery(
+    toStore(() => ({
+      queryKey: ["agent-session", activeId],
+      queryFn: () => agentApi.getSession(activeId!),
+      enabled: activeId != null,
+    })),
+  );
+  const taskResults = $derived(
+    ($allResults.data ?? []).filter((r) => r.session_id === activeId),
+  );
+  let filter = $state("all");
+  let agentKey = $state<WorkbenchStageKey | "">("");
+  let projectId = $state<number | null>(null);
+  let draft = $state("");
+  let busy = $state(false);
+  let error = $state("");
+  let streaming = $state("");
+  let reasoning = $state("");
+  let particles = $state<HTMLCanvasElement | null>(null);
+  let liveTools = $state<
+    {
+      tool: string;
+      args?: Record<string, unknown>;
+      result?: unknown;
+      phase: "running" | "done" | "error";
+    }[]
+  >([]);
+  const running = $derived($session.data?.running === true);
+  let editing = $state<AgentDeliverable | null>(null);
+  let text = $state("");
+  let targetProject = $state<number | null>(null);
+  let targetStage = $state<WorkbenchStageKey>("script");
+  let saving = $state(false);
+  let dirty = $state(false);
+  let artifactTab = $state("shots");
+  let compareOpen = $state(false);
+  let previousText = $state("");
+  async function comparePrevious() {
+    if (!editing) return;
+    try {
+      const versions = await resultsApi.versions(editing.id);
+      previousText = versions[0]?.content ?? "";
+      compareOpen = true;
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+    }
+  }
+  function parseContent(value: string): Record<string, unknown> | null {
+    try {
+      const start = value.indexOf("{");
+      const end = value.lastIndexOf("}");
+      return JSON.parse(value.slice(start, end + 1));
+    } catch {
+      return null;
+    }
+  }
+  function editShot(index: number, key: string, value: string | number) {
+    const data = parseContent(text);
+    if (!data || !Array.isArray(data.shots)) return;
+    data.shots[index] = { ...data.shots[index], [key]: value };
+    text = JSON.stringify(data, null, 2);
+    dirty = true;
+  }
+
+  let selectedSkill = $state("");
+  let uploadInput = $state<HTMLInputElement | null>(null);
+  let attachments = $state<AgentAttachment[]>([]);
+  const uploads = createUploadManager();
+  let uploadBusy = $state(false);
+  async function upload(event: Event) {
+    const files = Array.from((event.target as HTMLInputElement).files ?? []);
+    uploadBusy = true;
+    try {
+      for (const file of files.slice(0, 8 - attachments.length)) {
+        const path = await uploads.upload("b4-reference", file);
+        const meta = uploads.uploadMetaFor(path);
+        attachments.push({ path, name: meta.name, kind: meta.kind });
+      }
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+    } finally {
+      uploadBusy = false;
+      (event.target as HTMLInputElement).value = "";
+    }
+  }
+  async function assignModel(id: string) {
+    busy = true;
+    try {
+      await settings.update({
+        agent_llm_assignments: {
+          [activeAgent?.llm_role ?? "main"]: id || null,
+        },
+      });
+      await client.invalidateQueries({ queryKey: ["settings"] });
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+    } finally {
+      busy = false;
+    }
+  }
+
+  const shownTasks = $derived(
+    ($sessions.data ?? []).filter(
+      (s) =>
+        filter === "all" ||
+        (filter === "sandbox"
+          ? s.project_id == null
+          : s.running ||
+            s.task_status === "awaiting_confirm" ||
+            s.task_status === "awaiting_input"),
+    ),
+  );
+  const activeAgent = $derived(
+    ($registry.data ?? []).find(
+      (a) => a.key === ($session.data?.agent_key || agentKey),
+    ),
+  );
+  const enabledSkills = $derived(
+    ($skills.data ?? []).filter(
+      (s) => s.is_enabled && (!agentKey || s.bindings?.[agentKey]),
+    ),
+  );
+  const profiles = $derived($config.data?.llm_profiles ?? []);
+  function modelName(key?: string | null) {
+    const a = ($registry.data ?? []).find((a) => a.key === key);
+    const id =
+      (a && $config.data?.agent_llm_assignments?.[a.llm_role]) ||
+      $config.data?.llm_active_id;
+    return (
+      profiles.find((p) => p.id === id)?.name ||
+      $config.data?.llm_model ||
+      "未配置模型"
+    );
+  }
+  function status(s: AgentSession) {
+    return s.running
+      ? "运行中"
+      : ({
+          ready: "未开始",
+          awaiting_confirm: "待你确认",
+          returned: "已带回项目",
+          completed: "已完成",
+          error: "失败",
+          cancelled: "已停止",
+          interrupted: "运行中断",
+          awaiting_input: "等待回答",
+        }[s.task_status ?? "ready"] ?? "未开始");
+  }
+  function openResult(r: AgentDeliverable) {
+    editing = r;
+    text = r.content;
+    targetProject = r.project_id;
+    targetStage = r.stage_key;
+    dirty = false;
+    error = "";
+  }
+  async function openTask(id: number) {
+    if (dirty) {
+      error = "请先保存成果草稿，再切换任务。";
+      return false;
+    }
+    streaming = "";
+    reasoning = "";
+    liveTools = [];
+    await goto(resolve(`/agents?session=${id}`));
+    return true;
+  }
+  async function launchAssistant(key: WorkbenchStageKey) {
+    if (busy || uploadBusy) return;
+    agentKey = key;
+    if (draft.trim()) {
+      await send({
+        content: draft,
+        mentions: [],
+        attachments: [...attachments],
+      });
+      return;
+    }
+    busy = true;
+    try {
+      const s = await agentApi.createSession({
+        agent_key: key,
+        project_id: projectId,
+      });
+      await openTask(s.id);
+      await refresh();
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+    } finally {
+      busy = false;
+    }
+  }
+  async function home() {
+    if (dirty) {
+      error = "请先保存成果草稿，再新建任务。";
+      return;
+    }
+    editing = null;
+    error = "";
+    agentKey = "";
+    await goto(resolve("/agents"));
+  }
+  $effect(() => {
+    const id = activeId,
+      results = taskResults;
+    untrack(() => {
+      if (editing?.session_id !== id) {
+        editing = null;
+        dirty = false;
+      }
+      if (!editing && results.length) openResult(results[0]);
+    });
+  });
+  onMount(() => {
+    if (!particles) return;
+    const canvas = particles,
+      ctx = canvas.getContext("2d");
+    if (!ctx) return;
+    const points = Array.from({ length: 46 }, () => ({
+      x: Math.random(),
+      y: Math.random(),
+      v: 0.15 + Math.random() * 0.35,
+      s: Math.random() * 1.6 + 0.4,
+      a: Math.random() * 0.5 + 0.15,
+    }));
+    const resize = () => {
+      canvas.width = canvas.clientWidth;
+      canvas.height = canvas.clientHeight;
+    };
+    resize();
+    const observer = new ResizeObserver(resize);
+    observer.observe(canvas);
+    let raf = 0;
+    const frame = () => {
+      ctx.clearRect(0, 0, canvas.width, canvas.height);
+      if (
+        !activeId &&
+        document.documentElement.dataset.reduce !== "1" &&
+        !matchMedia("(prefers-reduced-motion: reduce)").matches
+      ) {
+        const color =
+          getComputedStyle(document.documentElement)
+            .getPropertyValue("--particle")
+            .trim() || "168,121,255";
+        for (const point of points) {
+          point.y -= point.v / Math.max(1, canvas.height);
+          point.x +=
+            (Math.sin((point.y * canvas.height) / 60) * 0.2) /
+            Math.max(1, canvas.width);
+          if (point.y < 0) {
+            point.y = 1;
+            point.x = Math.random();
+          }
+          ctx.beginPath();
+          ctx.arc(
+            point.x * canvas.width,
+            point.y * canvas.height,
+            point.s,
+            0,
+            7,
+          );
+          ctx.fillStyle = `rgba(${color},${point.a})`;
+          ctx.fill();
+        }
+      }
+      raf = requestAnimationFrame(frame);
+    };
+    frame();
+    return () => {
+      cancelAnimationFrame(raf);
+      observer.disconnect();
+    };
+  });
+  async function refresh() {
+    await Promise.all([
+      client.invalidateQueries({ queryKey: ["b4-sessions"] }),
+      client.invalidateQueries({ queryKey: ["b4-results"] }),
+      client.invalidateQueries({ queryKey: ["agent-session"] }),
+    ]);
+  }
+  onMount(() =>
+    connectEvents((ev) => {
+      if (ev.type.startsWith("job."))
+        void client.invalidateQueries({ queryKey: ["b4-jobs"] });
+      if (ev.type === "events.resync" || ev.type === "agent.session.updated") {
+        void refresh();
+        return;
+      }
+      if (
+        ev.data?.session_id !== activeId &&
+        (ev.data?.message as { session_id?: number } | undefined)
+          ?.session_id !== activeId
+      )
+        return;
+      if (ev.type === "agent.token")
+        streaming += String(ev.data?.content ?? "");
+      if (ev.type === "agent.thinking")
+        reasoning += String(ev.data?.content ?? "");
+      if (ev.type === "agent.message") {
+        streaming = "";
+        void client.invalidateQueries({
+          queryKey: ["agent-session", activeId],
+        });
+      }
+      if (ev.type === "agent.plan" || ev.type === "agent.task")
+        void client.invalidateQueries({
+          queryKey: ["agent-session", activeId],
+        });
+      if (ev.type === "agent.tool") {
+        const tool = String(ev.data?.tool ?? "");
+        if (ev.data?.phase === "start")
+          liveTools.push({
+            tool,
+            args: ev.data?.args as Record<string, unknown>,
+            phase: "running",
+          });
+        else {
+          const index = liveTools
+            .map((t) => t.tool === tool && t.phase === "running")
+            .lastIndexOf(true);
+          if (index >= 0)
+            liveTools[index] = {
+              ...liveTools[index],
+              result: ev.data?.result,
+              phase:
+                (ev.data?.result as { ok?: boolean })?.ok === false
+                  ? "error"
+                  : "done",
+            };
+        }
+      }
+    }),
+  );
+  async function send(payload: AgentComposerPayload) {
+    if (busy || uploadBusy) return;
+    busy = true;
+    error = "";
+    try {
+      let sid = activeId;
+      if (!sid) {
+        const s = await agentApi.createSession({
+          project_id: projectId,
+          agent_key: agentKey || null,
+        });
+        sid = s.id;
+        await goto(resolve(`/agents?session=${sid}`));
+      }
+      const skill = enabledSkills.find((s) => s.dir === selectedSkill);
+      if (
+        skill &&
+        payload.mentions.filter((m) => m.type === "skill").length < 4 &&
+        !payload.mentions.some(
+          (m) => m.type === "skill" && m.name === skill.dir,
+        )
+      )
+        payload.mentions.push({
+          type: "skill",
+          name: skill.dir,
+          description: skill.description,
+        });
+      await agentApi.postMessage(sid, payload);
+      draft = "";
+      attachments = [];
+      await refresh();
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+    } finally {
+      busy = false;
+    }
+  }
+  async function save() {
+    if (!editing || saving) return null;
+    saving = true;
+    error = "";
+    try {
+      const r = await resultsApi.patch(editing.id, {
+        revision: editing.revision,
+        content: text,
+        project_id: targetProject,
+        stage_key: targetStage,
+      });
+      openResult(r);
+      await client.invalidateQueries({ queryKey: ["b4-results"] });
+      toast.success("草稿已保存");
+      return r;
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+      return null;
+    } finally {
+      saving = false;
+    }
+  }
+  async function returnToProject() {
+    if (!editing || !targetProject || saving) return;
+    const r = dirty ? await save() : editing;
+    if (!r) return;
+    saving = true;
+    error = "";
+    try {
+      const res = await resultsApi.store({
+        deliverable_id: r.id,
+        revision: r.revision,
+        project_id: targetProject,
+        stage_key: targetStage,
+      });
+      toast.success(
+        res.already_attached ? "该版本已带回项目" : "已带回项目，等待确认",
+      );
+      await refresh();
+      await goto(resolve(`/workbench/${targetProject}?stage=${targetStage}`));
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+    } finally {
+      saving = false;
+    }
+  }
+  const projectJobs = createQuery(
+    toStore(() => ({
+      queryKey: ["b4-jobs", targetProject],
+      queryFn: () => jobsApi.list(targetProject!),
+      enabled: targetProject != null,
+    })),
+  );
+  function shotJob(id: string) {
+    return ($projectJobs.data ?? []).find(
+      (j) =>
+        j.payload?.stage_key === targetStage &&
+        j.payload?.target_id === id &&
+        j.status === "done" &&
+        j.output_paths?.length,
+    );
+  }
+  const structuredShots = $derived.by(() => {
+    const data = parseContent(text);
+    return Array.isArray(data?.shots)
+      ? (data.shots as {
+          id: string;
+          description?: string;
+          prompt?: string;
+          duration_sec?: number;
+        }[])
+      : [];
+  });
+  async function redraw(shot: {
+    id: string;
+    description?: string;
+    prompt?: string;
+    duration_sec?: number;
+  }) {
+    if (!targetProject || saving || !shot.id) return;
+    saving = true;
+    error = "";
+    try {
+      await workbenchApi.generate(targetProject, {
+        kind: targetStage === "shot" ? "video" : "image",
+        stage_key: targetStage,
+        target_id: shot.id,
+        prompt: shot.prompt || shot.description || "",
+        duration_sec: shot.duration_sec,
+      });
+      toast.success(`仅镜头 ${shot.id} 已入队`);
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+    } finally {
+      saving = false;
+    }
+  }
+</script>
+
+{#snippet header()}
+  <header class="b4-header">
+    {#if activeId}<div class="b4-crumb"><button onclick={home}>智能体</button>/<b>{$session.data?.title ?? "加载任务…"}</b></div><span class="a-tag sc">{$session.data ? status($session.data) : "加载中"}</span>{:else}<div class="b4-crumb"><button onclick={home}><b>智能体</b></button></div><span class="b4-subtitle">把创作任务交给助手，成果回到项目等你确认</span>{/if}<span class="b4-grow"></span>{#if activeId}<span class="b4-chip"
+        ><Icon name="agent-cpu" size={14}/><b>{modelName($session.data?.agent_key)}</b></span
+      >{/if}<a class="a-btn secondary sm" href={resolve("/agents?legacy=1")}
+      >原会话与技能管理</a
+    >
+  </header>
+{/snippet}
+{#snippet shellHeader()}{/snippet}
+<AppShell active="agents" title="智能体" workspace pageHeader={shellHeader}>
+  <div class="b4" class:task-view={activeId != null}>
+    {@render header()}
+    <div class="aurora fx-only"><i></i><i></i><i></i></div>
+    <canvas class="particles fx-only" bind:this={particles} aria-hidden="true"
+    ></canvas>
+    <div class={activeId ? "atask" : "agent-grid"}>
+      <aside class="tasklist">
+        <div class="tl-h">
+          <button class="a-btn scene" onclick={home}
+            ><Icon name="plus" size={14} />新任务</button
+          >{#if !activeId}<div class="b4-seg">
+              {#each [["active", "进行中"], ["all", "全部"], ["sandbox", "沙盒"]] as [value, label] (value)}<button
+                  class:on={filter === value}
+                  onclick={() => (filter = value)}>{label}</button
+                >{/each}
+            </div>{/if}
+        </div>
+        <div class="tl-b">
+          {#each shownTasks as s (s.id)}<button
+              class="titem"
+              data-session-id={s.id}
+              class:on={s.id === activeId}
+              onclick={() => openTask(s.id)}
+              title={s.task_summary || s.title}
+              ><b>{s.title}</b><span class="meta"
+                ><i class="dot" style:--agent-task-dot={s.running ? "var(--agent-task-running)" : s.task_status === "returned" ? "var(--agent-task-returned)" : s.task_status === "awaiting_confirm" ? "var(--agent-task-confirm)" : "var(--agent-task-idle)"}></i>{status(s)}<span class="b4-grow"></span>{s
+                  .project?.title ?? "沙盒"}</span
+              ></button
+            >{:else}<p class="b4-empty">
+              {$sessions.isPending ? "加载任务…" : "暂无任务"}
+            </p>{/each}
+        </div>
+      </aside>
+      {#if !activeId}
+        <div class="agent-home">
+          <div class="ahero">
+            <div class="hero-copy">
+              <span class="eyebrow">主创智能体 · 统筹五个阶段助手</span>
+              <h2>从一个想法，到一组能直接开拍的镜头</h2>
+              <p class="muted">
+                它会先列计划，再调用剧本、视觉、分镜、素材与镜头助手；每一步的成果都是可编辑草稿，你确认后才写入项目。
+              </p>
+              <div class="steps">
+                {#each ["说出想法", "确认计划", "编辑成果", "带回项目"] as label, i (label)}<span
+                    ><i>{i + 1}</i>{label}</span
+                  >{/each}
+              </div>
+              <div class="big-input">
+                <textarea
+                  aria-label="任务想法"
+                  bind:value={draft}
+                  placeholder="描述你的创作想法、目标与要求…"
+                ></textarea>
+                <div class="b4-row">
+                  <label class="b4-chip"
+                    ><Icon name="nav-project" size={14} />绑定：<select
+                      aria-label="绑定项目"
+                      bind:value={projectId}
+                      ><option value={null}>沙盒</option
+                      >{#each $projects.data ?? [] as p (p.id)}<option
+                          value={p.id}>{p.title}</option
+                        >{/each}</select
+                    ></label
+                  ><label class="b4-chip"
+                    ><Icon name="agent-cpu" size={14} /><select
+                      aria-label="任务模型"
+                      disabled={busy}
+                      value={$config.data?.agent_llm_assignments?.[
+                        activeAgent?.llm_role ?? "main"
+                      ] ?? ""}
+                      onchange={(e) => assignModel(e.currentTarget.value)}
+                      ><option value="">{modelName(agentKey)}</option
+                      >{#each profiles as p (p.id)}<option value={p.id}
+                          >{p.name}</option
+                        >{/each}</select
+                    ></label
+                  ><label class="b4-chip"
+                    ><Icon name="project-book" size={14} />技能
+                    <select aria-label="任务技能" bind:value={selectedSkill}
+                      ><option value="">不指定</option
+                      >{#each enabledSkills as s (s.dir)}<option value={s.dir}
+                          >{s.name}</option
+                        >{/each}</select
+                    ></label
+                  ><input
+                    hidden
+                    type="file"
+                    bind:this={uploadInput}
+                    multiple
+                    accept="image/*,video/*,audio/*,.txt,.md,.docx"
+                    onchange={upload}
+                  /><button
+                    class="b4-chip"
+                    disabled={uploadBusy || busy}
+                    onclick={() => uploadInput?.click()}
+                    ><Icon name="upload" size={14} />参考材料{attachments.length
+                      ? ` · ${attachments.length}`
+                      : ""}</button
+                  ><span class="b4-grow"></span><button
+                    class="a-btn primary"
+                    disabled={busy || uploadBusy || !draft.trim()}
+                    onclick={() =>
+                      send({
+                        content: draft,
+                        mentions: [],
+                        attachments: [...attachments],
+                      })}><Icon name="agent-send" size={14} />开始任务</button
+                  >
+                </div>
+              </div>
+            </div>
+            <div class="orb fx-only">
+              <div class="ring r2"></div>
+              <div class="ring"></div>
+              <div class="core"></div>
+            </div>
+          </div>
+          <div>
+            <div class="sec-h">
+              <h2>阶段助手</h2>
+              <span class="dim">每个助手对应项目的一个阶段，也可以单独调用</span
+              >
+            </div>
+            <div class="roster">
+              {#each $registry.data ?? [] as a, i (a.key)}<button
+                  class="acard"
+                  style:--c={assistantColors[a.key]}
+                  disabled={busy || uploadBusy}
+                  onclick={() => launchAssistant(a.key as WorkbenchStageKey)}
+                  ><span class="num">0{i + 1}</span><span class="ic"
+                    ><Icon name={assistantIcons[a.key]} size={18} /></span
+                  >
+                  <div class="tx">
+                    <b>{stageNames[a.key as WorkbenchStageKey]}</b>
+                    <p>{assistantDescriptions[a.key]}</p>
+                    <div class="b4-row">
+                      <span class="a-tag">{a.skill_count} 个技能</span><span
+                        class="b4-grow"
+                      ></span><span class="dim">{modelName(a.key)}</span>
+                    </div>
+                  </div></button
+                >{/each}
+            </div>
+          </div>
+          <div class="mini-row">
+            <div class="panel">
+              <h3>最近成果<span class="dim">点开即可编辑，再带回项目</span></h3>
+              <div class="outrow">
+                {#each ($allResults.data ?? []).slice(0, 4) as r (r.id)}<button
+                    class="outcard"
+                    data-deliverable-id={r.id}
+                    onclick={async () => {
+                      if (await openTask(r.session_id)) openResult(r);
+                    }}
+                    ><div class="t"><Icon name="file" size={24} /></div>
+                    <div class="d">
+                      <b>{r.title}</b><span class="dim"
+                        >{stageNames[r.stage_key]} · 草稿 v{r.revision}</span
+                      >
+                    </div></button
+                  >{:else}<p class="b4-empty">
+                    暂无成果，完成任务后将在这里显示。
+                  </p>{/each}
+              </div>
+            </div>
+            <div class="panel">
+              <h3>
+                技能库<span class="a-tag">{($skills.data ?? []).length}</span
+                ><span class="b4-grow"></span><a
+                  class="a-btn sm ghost"
+                  href={resolve("/agents?legacy=1")}>管理</a
+                >
+              </h3>
+              <div class="skills">
+                {#each ($skills.data ?? [])
+                  .filter((s) => s.is_enabled)
+                  .slice(0, 7) as s (s.dir)}<button
+                    class="skill"
+                    title={s.description}
+                    onclick={() => {
+                      selectedSkill = s.dir;
+                      agentKey = "";
+                    }}><i></i>{s.name}</button
+                  >{:else}<span class="dim">尚未添加技能</span>{/each}<a
+                  class="skill dim"
+                  href={resolve("/agents?legacy=1")}>+ 学习新技能</a
+                >
+              </div>
+              <p class="dim">
+                技能 = 可复用的规则 +
+                示例。可从对话中“记住这个做法”生成，也可导入 Markdown。
+              </p>
+            </div>
+          </div>
+        </div>
+      {:else}
+        <div class="convo">
+          <div class="convo-b">
+            {#if $session.data?.plan}<AgentPlanPanel
+                plan={$session.data.plan}
+              />{/if}<AgentChat
+              studio
+              messages={$session.data?.messages ?? []}
+              {liveTools}
+              {streaming}
+              streamingReasoning={reasoning}
+              {running}
+              loading={$session.isPending}
+              onAnswer={(option, _scope, seq) =>
+                send({
+                  content: option,
+                  mentions: [],
+                  attachments: [],
+                  answer_to: seq,
+                })}
+            />
+          </div>
+          <div class="convo-in">
+            <AgentComposer
+              studio
+              {running}
+              onSend={send}
+              onCancel={() => {
+                if (activeId) void agentApi.cancel(activeId);
+              }}
+              workflows={($wfQuery.data ?? [])
+                .filter((w) => w.is_enabled)
+                .map((w) => ({
+                  id: w.id,
+                  name: w.name,
+                  kind: w.kind as "image" | "video",
+                }))}
+              skills={($skills.data ?? [])
+                .filter((s) => s.is_enabled)
+                .map((s) => ({
+                  name: s.dir,
+                  description: s.description,
+                  tags: s.tags,
+                }))}
+            />
+          </div>
+        </div>
+        <aside class="artifact">
+          <div class="art-h">
+            <div class="b4-row">
+              <b>{editing ? stageNames[editing.stage_key] : "成果"} · 草稿</b
+              ><span class="a-tag sc">未确认</span><span class="b4-grow"
+              ></span><span class="dim mono art-meta"
+                >{structuredShots.length
+                  ? `${structuredShots.length} 镜 · ${structuredShots.reduce((sum, shot) => sum + (Number(shot.duration_sec) || 0), 0)}s`
+                  : editing
+                    ? `v${editing.revision}`
+                    : ""}</span
+              >
+            </div>
+            {#if taskResults.length > 1}<div class="b4-seg">
+                {#each taskResults as r (r.id)}<button
+                    class:on={editing?.id === r.id}
+                    onclick={() => {
+                      if (!dirty) openResult(r);
+                      else error = "请先保存当前成果";
+                    }}>成果 {r.id}</button
+                  >{/each}
+              </div>{/if}
+            <div class="b4-seg art-tabs">
+              <button
+                class:on={artifactTab === "shots"}
+                onclick={() => (artifactTab = "shots")}>镜头</button
+              >
+              <button disabled title="当前成果没有角色数据">角色</button>
+              <button
+                class:on={artifactTab === "text"}
+                onclick={() => (artifactTab = "text")}>原文</button
+              >
+              <button onclick={comparePrevious} disabled={!editing}
+                >对比上一版</button
+              >
+            </div>
+          </div>
+          <div class="art-b">
+            {#if editing}
+              {#if structuredShots.length && artifactTab === "shots"}
+                {#each structuredShots as shot, i (shot.id)}
+                  <div class="shot">
+                    <div class="th">
+                      <span>{String(i + 1).padStart(2, "0")}</span
+                      >{#if shotJob(shot.id)?.kind === "video"}<video
+                          src={assetUrl(shotJob(shot.id)!.output_paths![0]) ??
+                            ""}
+                          controls
+                          muted
+                          preload="metadata"
+                          aria-label={`镜头 ${shot.id} 视频`}
+
+                        ></video>{:else if shotJob(shot.id)?.output_paths?.[0]}<img
+                          src={assetUrl(shotJob(shot.id)!.output_paths![0]) ??
+                            ""}
+                          alt={`镜头 ${shot.id} 草图`}
+                        />{:else}<small class="dim">暂无草图</small>{/if}
+                    </div>
+                    <div class="shot-copy">
+                      <textarea
+                        aria-label={`镜头 ${shot.id} 描述`}
+                        value={shot.description || shot.prompt || ""}
+                        oninput={(e) =>
+                          editShot(
+                            i,
+                            shot.description != null ? "description" : "prompt",
+                            e.currentTarget.value,
+                          )}
+                      ></textarea>
+                      <div class="b4-row">
+                        <label class="a-tag mono"
+                          ><input
+                            aria-label={`镜头 ${shot.id} 时长`}
+                            type="number"
+                            min="0.1"
+                            step="0.1"
+                            value={shot.duration_sec ?? 3}
+                            oninput={(e) =>
+                              editShot(
+                                i,
+                                "duration_sec",
+                                Number(e.currentTarget.value),
+                              )}
+                          />s</label
+                        ><span class="b4-grow"></span><button
+                          class="a-btn sm ghost"
+                          disabled={saving || !targetProject || dirty}
+                          onclick={() => redraw(shot)}><Icon name="project-refresh" size={14}/>重画</button
+                        >
+                      </div>
+                    </div>
+                  </div>
+                {/each}
+              {:else}<textarea
+                  class="draft-editor"
+                  aria-label="成果草稿"
+                  bind:value={text}
+                  oninput={() => (dirty = true)}
+                ></textarea>{/if}
+            {:else}<p class="b4-empty">
+                暂无成果。任务完成后，真实回复将在这里形成可编辑草稿。
+              </p>{/if}
+          </div>
+          <div class="art-f">
+            <label class="b4-row dim"
+              >带回到<span class="b4-chip"><select
+                aria-label="成果项目"
+                bind:value={targetProject}
+                onchange={() => (dirty = true)}
+                disabled={!editing}
+                ><option value={null}>选择项目</option
+                >{#each $projects.data ?? [] as p (p.id)}<option value={p.id}
+                    >{p.title}</option
+                  >{/each}</select
+              > · <select
+                class="stage-select"
+                aria-label="成果阶段"
+                bind:value={targetStage}
+                onchange={() => (dirty = true)}
+                disabled={!editing}
+                >{#each keys as key (key)}<option value={key}
+                    >{stageNames[key]}</option
+                  >{/each}</select
+              ></span></label
+            >
+            <div class="b4-row">
+              <button
+                class="a-btn secondary"
+                disabled={!editing || saving}
+                onclick={save}>保存草稿</button
+              ><button
+                class="a-btn primary"
+                disabled={!editing || !targetProject || saving}
+                onclick={returnToProject}
+                ><Icon name="arrow-right" size={14} />带回项目待确认</button
+              >
+            </div>
+          </div>
+        </aside>
+      {/if}
+    </div>
+    {#if error}<div class="b4-error" role="alert">
+        {error}<button class="a-btn sm ghost" onclick={() => (error = "")}
+          >关闭</button
+        >
+      </div>{/if}
+  </div>
+</AppShell>
+
+<Modal bind:open={compareOpen} title="对比上一版" size="lg">
+  <div class="b4-compare">
+    <section>
+      <h3>上一保存版本</h3>
+      <pre>{previousText || "尚无上一保存版本"}</pre>
+    </section>
+    <section>
+      <h3>当前草稿{dirty ? " · 未保存" : ""}</h3>
+      <pre>{text}</pre>
+    </section>
+  </div>
+</Modal>

calliope-web/src/lib/components/agent/WorkflowMentionMenu.svelte

@@ -1,16 +1,9 @@
-<script lang="ts">
+<script lang="ts" generics="Item extends { id?: number; name: string; kind?: string; description?: string | null }">
 	import { t } from '$lib/i18n.svelte';
 
-	interface MenuItem {
-		id?: number;
-		name: string;
-		kind?: string;
-		description?: string | null;
-	}
-
 	interface Props {
 		open: boolean;
-		items: MenuItem[];
+		items: Item[];
 		activeIndex: number;
 		/** Caret / `@` viewport box — menu opens above this (composer is bottom-docked). */
 		anchor: { top: number; bottom: number; left: number };
@@ -18,7 +11,7 @@
 		lockReason?: string | null;
 		/** Skill mode: rows show `/name` + a description subtitle, no kind chip. */
 		skillMode?: boolean;
-		onSelect: (item: any) => void;
+		onSelect: (item: Item) => void;
 		onHover: (index: number) => void;
 	}
 
@@ -62,6 +55,7 @@
 		if (!open || !menuEl) return;
 		document.body.appendChild(menuEl);
 		return () => {
+			// eslint-disable-next-line svelte/no-dom-manipulating -- Template creates menu contents; this effect moves the root to body and owns portal teardown on close/unmount. Remove that moved root to avoid residue.
 			menuEl?.remove();
 		};
 	});

calliope-web/src/lib/components/agent/agentPalette.ts

@@ -7,68 +7,68 @@
  * 不再使用彩色身份色；默认主循环智能体保持中性 --id-4。
  */
 
-export const DEFAULT_AGENT_NAME = 'Calliope';
+export const DEFAULT_AGENT_NAME = "Calliope";
 
 // Fixed identity map (keyed by the raw agent_name the backend emits).
 // Step numbers mirror the avatar five-set used across the app
 // (models/agents/home project cards).
 const IDENTITIES: Record<string, { label: string; color: string }> = {
-	planner: { label: 'Planner', color: 'var(--id-2)' },
-	'story-agent': { label: 'Story Agent', color: 'var(--id-3)' },
-	'script-agent': { label: 'Script Agent', color: 'var(--id-1)' },
-	'assets-agent': { label: 'Assets Agent', color: 'var(--id-4)' },
-	'video-agent': { label: 'Video Agent', color: 'var(--id-5)' },
-	'research-agent': { label: 'Research Agent', color: 'var(--id-4)' },
-	// The five named agents (HEL-613) — the runner stamps their zh names on
-	// named-session replies; steps mirror the avatar five-set.
-	剧本创作: { label: '剧本创作', color: 'var(--id-1)' },
-	视觉设计: { label: '视觉设计', color: 'var(--id-2)' },
-	分镜设计: { label: '分镜设计', color: 'var(--id-3)' },
-	素材资产: { label: '素材资产', color: 'var(--id-4)' },
-	镜头脚本: { label: '镜头脚本', color: 'var(--id-5)' },
+  planner: { label: "Planner", color: "var(--id-2)" },
+  "story-agent": { label: "Story Agent", color: "var(--id-3)" },
+  "script-agent": { label: "Script Agent", color: "var(--id-1)" },
+  "assets-agent": { label: "Assets Agent", color: "var(--id-4)" },
+  "video-agent": { label: "Video Agent", color: "var(--id-5)" },
+  "research-agent": { label: "Research Agent", color: "var(--id-4)" },
+  // The five named agents (HEL-613) — the runner stamps their zh names on
+  // named-session replies; steps mirror the avatar five-set.
+  剧本创作: { label: "剧本创作", color: "var(--id-1)" },
+  视觉设计: { label: "视觉设计", color: "var(--id-2)" },
+  分镜设计: { label: "分镜设计", color: "var(--id-3)" },
+  素材资产: { label: "素材资产", color: "var(--id-4)" },
+  镜头脚本: { label: "镜头脚本", color: "var(--id-5)" },
 };
 
 // Fallback palette for unknown names (stable hash → deterministic step),
 // spanning the same five grayscale identity steps.
 const FALLBACK_COLORS = [
-	'var(--id-1)',
-	'var(--id-2)',
-	'var(--id-3)',
-	'var(--id-4)',
-	'var(--id-5)',
+  "var(--id-1)",
+  "var(--id-2)",
+  "var(--id-3)",
+  "var(--id-4)",
+  "var(--id-5)",
 ];
 
 function hashString(s: string): number {
-	let h = 0;
-	for (let i = 0; i < s.length; i++) {
-		h = (h * 31 + s.charCodeAt(i)) >>> 0;
-	}
-	return h;
+  let h = 0;
+  for (let i = 0; i < s.length; i++) {
+    h = (h * 31 + s.charCodeAt(i)) >>> 0;
+  }
+  return h;
 }
 
 /** Neutral step (--id-4) — the default agent borrows no signal color. */
-export const DEFAULT_AGENT_COLOR = 'var(--id-4)';
+export const DEFAULT_AGENT_COLOR = "var(--id-4)";
 
 export function agentDisplayName(name: string | null | undefined): string {
-	const key = (name || '').trim().toLowerCase();
-	if (!key) return DEFAULT_AGENT_NAME;
-	return IDENTITIES[key]?.label ?? prettyName(name!);
+  const key = (name || "").trim().toLowerCase();
+  if (!key) return DEFAULT_AGENT_NAME;
+  return IDENTITIES[key]?.label ?? prettyName(name!);
 }
 
 export function agentColor(name: string | null | undefined): string {
-	const key = (name || '').trim().toLowerCase();
-	if (!key) return DEFAULT_AGENT_COLOR;
-	const identity = IDENTITIES[key];
-	if (identity) return identity.color;
-	return FALLBACK_COLORS[hashString(key) % FALLBACK_COLORS.length];
+  const key = (name || "").trim().toLowerCase();
+  if (!key) return DEFAULT_AGENT_COLOR;
+  const identity = IDENTITIES[key];
+  if (identity) return identity.color;
+  return FALLBACK_COLORS[hashString(key) % FALLBACK_COLORS.length];
 }
 
 function prettyName(raw: string): string {
-	// "story-agent" → "Story Agent", "assets-agent" → "Assets Agent"
-	const title = raw
-		.split(/[-_\s]+/)
-		.filter(Boolean)
-		.map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-		.join(' ');
-	return title || DEFAULT_AGENT_NAME;
+  // "story-agent" → "Story Agent", "assets-agent" → "Assets Agent"
+  const title = raw
+    .split(/[-_\s]+/)
+    .filter(Boolean)
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+    .join(" ");
+  return title || DEFAULT_AGENT_NAME;
 }

calliope-web/src/lib/components/desk/Artboard.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import { untrack, type Snippet } from 'svelte';
 	import Modal from '$lib/components/ui/Modal.svelte';
 	import ImageLightbox from '$lib/components/ImageLightbox.svelte';
@@ -59,6 +60,9 @@
 		onCancel: (job: Job) => void;
 		onSendToSlot: (path: string) => void;
 		onDelete: (job: Job) => void;
+		canAttach?: boolean;
+		attachBusy?: boolean;
+		onAttach?: () => void;
 	}
 
 	let {
@@ -68,21 +72,20 @@
 		job,
 		wf,
 		nowMs,
-		open,
-		inactive,
 		canSendToSlot,
-		crossfade,
 		videoEl = $bindable(null),
-		params,
-		onClose,
 		onReuse,
 		onRetry,
 		onCancel,
 		onSendToSlot,
 		onDelete,
+		canAttach = false,
+		attachBusy = false,
+		onAttach,
 	}: Props = $props();
 
 	let detailsOpen = $state(false);
+	let deleteOpen = $state(false);
 	let outIndex = $state(0);
 	let compare = $state(false),
 		compareAt = $state(50),
@@ -90,6 +93,7 @@
 	$effect(() => {
 		void job?.id;
 		detailsOpen = false;
+		deleteOpen = false;
 		compare = false;
 		lightbox = false;
 	});
@@ -111,7 +115,6 @@
 	const output = $derived(
 		outputs[Math.min(outIndex, outputs.length - 1)] ?? null,
 	);
-	const allOutputs = $derived(job && st?.tone === 'ok' ? job.output_paths : []);
 	const video = $derived(!!job && !!output && isVideoOutput(job, output));
 	const wfDeleted = $derived(!!job && job.workflow_id == null);
 	const prompt = $derived(job ? promptOf(job, wf) : '');
@@ -132,16 +135,27 @@
 		return live?.progress ?? 3;
 	});
 	let dims = $state('');
+	let naturalWidth = $state(1),
+		naturalHeight = $state(1);
+	let stageWidth = $state(0),
+		stageHeight = $state(0);
+	const fitted = $derived(
+		Math.min(stageWidth / naturalWidth, stageHeight / naturalHeight),
+	);
 	$effect.pre(() => {
 		void output;
 		dims = '';
 	});
 	function noteImg(e: Event) {
 		const img = e.currentTarget as HTMLImageElement;
+		naturalWidth = img.naturalWidth;
+		naturalHeight = img.naturalHeight;
 		dims = `${img.naturalWidth}×${img.naturalHeight}`;
 	}
 	function noteVideo(e: Event) {
 		const v = e.currentTarget as HTMLVideoElement;
+		naturalWidth = v.videoWidth;
+		naturalHeight = v.videoHeight;
 		dims = `${v.videoWidth}×${v.videoHeight}`;
 	}
 
@@ -175,40 +189,29 @@
 </script>
 
 <div class="artboard" aria-label="生成结果">
-	<header class="artboard-toolbar">
+	<button
+		class="artboard-toolbar"
+		aria-label="作品详情与操作"
+		onclick={() => (detailsOpen = true)}
+	>
 		<div class="result-title">
 			<span>第 {job?.id} 次生成</span><small>{wf?.name ?? '历史作品'}</small>
 		</div>
-		<div class="canvas-actions">
-			{#if output && !video}<button
-					class="canvas-btn"
-					onclick={() => (lightbox = true)}
-					aria-label="放大查看">⤢</button
-				>
-				{#if compareSource && compareSource !== output}<button
-						class="canvas-btn"
-						aria-pressed={compare}
-						onclick={() => (compare = !compare)}
-						>◫ {compare ? '结束对比' : '对比'}</button
-					>{/if}
-			{/if}
-			{#if output}<a
-					class="canvas-btn"
-					href={assetUrl(output)}
-					download
-					aria-label="下载生成结果">↓ 下载</a
-				>{/if}
-			<button class="canvas-btn" onclick={() => (detailsOpen = true)}
-				>详情与操作</button
-			>
-		</div>
-	</header>
+	</button>
 	<div class="stage" class:comparing={compare}>
 		{#if job && st}{#key mediaKey}
-				<div class="stage-media">
+				<div
+					class="stage-media"
+					bind:clientWidth={stageWidth}
+					bind:clientHeight={stageHeight}
+				>
 					{#if output && video}
 						<!-- svelte-ignore a11y_media_has_caption -->
-						<div class="print a-photo">
+						<div
+							class="print a-photo"
+							style:width={fitted > 0 ? `${naturalWidth * fitted}px` : '100%'}
+							style:height={fitted > 0 ? `${naturalHeight * fitted}px` : '100%'}
+						>
 							{#if st.tone === 'ok' && !fileGone}<span class="a-fix"
 									>{t('jobst.done')}</span
 								>{/if}
@@ -217,6 +220,12 @@
 								src={assetUrl(output)}
 								controls
 								aria-label="生成的视频，使用播放按钮开始播放"
+								onkeydown={(e) => {
+									if (e.code === 'Space' && e.target === e.currentTarget) {
+										e.preventDefault();
+										togglePlayback();
+									}
+								}}
 								onplay={() => (paused = false)}
 								onpause={() => (paused = true)}
 								onended={() => (paused = true)}
@@ -228,9 +237,21 @@
 								}}
 								onerror={() => output && markOutputMissing(output)}
 							></video>
+							{#if paused}<button
+									class="big-play"
+									aria-label="播放此视频"
+									onclick={() => {
+										videoEl?.focus();
+										togglePlayback();
+									}}>▶</button
+								>{/if}
 						</div>
 					{:else if output}
-						<div class="print a-photo">
+						<div
+							class="print a-photo"
+							style:width={fitted > 0 ? `${naturalWidth * fitted}px` : '100%'}
+							style:height={fitted > 0 ? `${naturalHeight * fitted}px` : '100%'}
+						>
 							{#if st.tone === 'ok' && !fileGone}<span class="a-fix"
 									>{t('jobst.done')}</span
 								>{/if}
@@ -279,7 +300,8 @@
 				role="group"
 				aria-label="本次生成的作品"
 			>
-				{#each outputs as p, i}<button
+				<!-- Output paths may repeat; the button number and outIndex refer to this position. -->
+				{#each outputs as p, i (i)}<button
 						aria-pressed={output === p}
 						onclick={() => (outIndex = i)}
 						aria-label={'查看第 ' + (i + 1) + ' 件作品'}>{i + 1}</button
@@ -287,19 +309,73 @@
 			</div>{/if}
 	</div>
 	<footer class="artboard-footer">
-		{#if video}<button
-				class="canvas-btn play-button"
-				onclick={togglePlayback}
-				aria-label={paused ? '播放视频' : '暂停视频'}
-				>{paused ? '▶ 播放' : 'Ⅱ 暂停'}</button
-			><button
-				class="canvas-btn"
-				onclick={() => videoEl?.requestFullscreen().catch(() => {})}
-				>全屏</button
-			>{/if}
-		<span class="result-spec"
-			>{dims || st?.label} · {job ? fmtDur(elapsedSec(job, nowMs)) : ''}</span
+		<button
+			class="canvas-btn"
+			disabled={!output}
+			onclick={() =>
+				video
+					? videoEl?.requestFullscreen().catch(() => {})
+					: (lightbox = true)}
+			aria-label="放大查看"><Icon name="zoom-in" size={14} />放大</button
 		>
+		<a
+			class="canvas-btn"
+			href={output ? assetUrl(output) : undefined}
+			aria-disabled={!output}
+			download
+			rel="external"
+			aria-label="下载生成结果"><Icon name="download" size={14} />下载</a
+		>
+		<span class="action-separator" aria-hidden="true"></span>
+		<button
+			class="canvas-btn"
+			disabled={!job || !output}
+			onclick={() => job && onReuse(job)}
+			><Icon name="retry" size={14} />复用参数</button
+		>
+		<button
+			class="canvas-btn"
+			disabled={!output || video || !canSendToSlot}
+			title={canSendToSlot
+				? '放入当前工作流图片输入'
+				: '当前工作流没有图片输入'}
+			onclick={() => output && onSendToSlot(output)}
+			><Icon name="image" size={14} />作为参考图</button
+		>
+		<button
+			class="canvas-btn"
+			disabled
+			title="跨工作流送图尚未具备，请选择生视频工作流后从已有结果选取"
+			><Icon name="film" size={14} />送去生视频</button
+		>
+		<span class="action-separator" aria-hidden="true"></span>
+		<button
+			class="canvas-btn"
+			disabled={!canAttach || attachBusy}
+			title={canAttach
+				? '保存到来源项目'
+				: '通用选择项目与阶段将在后续批次提供'}
+			onclick={onAttach}><Icon name="folder" size={14} />存入项目</button
+		>
+		<a class="canvas-btn" href={resolve('/library')}
+			><Icon name="assets" size={14} />素材库</a
+		>
+		<button
+			class="canvas-btn delete-output"
+			aria-label="删除作品记录"
+			title="删除作品记录"
+			disabled={!job || job.status === 'pending' || job.status === 'running'}
+			onclick={() => (deleteOpen = true)}
+			><Icon name="close" size={14} /></button
+		>
+		{#if job?.status === 'pending' || job?.status === 'running'}<button
+				class="canvas-btn"
+				onclick={() => job && onCancel(job)}>取消生成</button
+			>{/if}
+		{#if st?.tone === 'fail'}<button
+				class="canvas-btn"
+				onclick={() => job && onRetry(job)}>重试</button
+			>{/if}
 		{#if compare && output && !video}<label class="compare-slider"
 				>参考<input
 					type="range"
@@ -309,19 +385,41 @@
 					aria-label="拖动对比画面"
 				/>结果</label
 			>{/if}
-		{#if job?.status === 'pending' || job?.status === 'running'}<button
-				class="canvas-btn"
-				onclick={() => job && onCancel(job)}>取消生成</button
-			>{/if}
-		{#if st?.tone === 'fail'}<button
-				class="canvas-btn"
-				onclick={() => job && onRetry(job)}>重试</button
-			>{/if}
 	</footer>
 </div>
 <Modal bind:open={detailsOpen} size="lg" title="作品详情与操作">
 	{#if job && st}
 		<div class="detail-actions">
+			{#if video}<button
+					class="canvas-btn play-button"
+					onclick={togglePlayback}
+					aria-label={paused ? '播放视频' : '暂停视频'}
+					>{paused ? '▶ 播放' : 'Ⅱ 暂停'}</button
+				><button
+					class="canvas-btn"
+					onclick={() => videoEl?.requestFullscreen().catch(() => {})}
+					>全屏</button
+				>{/if}
+			<span class="result-spec"
+				>{dims || st?.label} · {job ? fmtDur(elapsedSec(job, nowMs)) : ''}</span
+			>
+			{#if compare && output && !video}<label class="compare-slider"
+					>参考<input
+						type="range"
+						min="0"
+						max="100"
+						bind:value={compareAt}
+						aria-label="拖动对比画面"
+					/>结果</label
+				>{/if}
+			{#if output && !video && compareSource && compareSource !== output}<button
+					class="canvas-btn"
+					aria-pressed={compare}
+					onclick={() => {
+						compare = !compare;
+						detailsOpen = false;
+					}}>◫ {compare ? '结束对比' : '对比'}</button
+				>{/if}
 			<button
 				class="a-btn secondary sm"
 				onclick={() => {
@@ -348,7 +446,7 @@
 			{#if job.status !== 'pending' && job.status !== 'running'}<button
 					class="a-btn danger sm"
 					onclick={() => {
-						onDelete(job);
+						deleteOpen = true;
 						detailsOpen = false;
 					}}>移除记录</button
 				>{/if}
@@ -357,7 +455,8 @@
 				{fileGone ? t('jobst.missingDetail') : st.detail}
 			</p>{/if}
 		<div class="detail-meta">
-			{#each spec as s}<span>{s.label} · {s.value}</span
+			<!-- Display-only spec rows have no local state; preserve their existing positional reuse. -->
+			{#each spec as s, i (i)}<span>{s.label} · {s.value}</span
 				>{/each}{#if endpoint}<span>{endpoint}</span>{/if}
 		</div>
 		{#if inputs.length || prompt}
@@ -409,6 +508,23 @@
 		</dl>
 	{/if}
 </Modal>
+<Modal bind:open={deleteOpen} title="删除作品记录" size="md">
+	<p>
+		确认移除这条生成记录及生成文件？关联项目中的回流记录也会移除。确认后有 5
+		秒可撤销，提交后无法恢复。
+	</p>
+	{#snippet footer()}<button
+			class="a-btn secondary"
+			onclick={() => (deleteOpen = false)}>取消</button
+		>
+		<button
+			class="a-btn danger"
+			onclick={() => {
+				if (job) onDelete(job);
+				deleteOpen = false;
+			}}>确认移除</button
+		>{/snippet}
+</Modal>
 {#if lightbox && output && !video}<ImageLightbox
 		src={assetUrl(output) ?? ''}
 		alt={prompt || '创作结果'}
@@ -417,13 +533,14 @@
 
 <style>
 	.artboard {
+		position: relative;
 		display: grid;
-		grid-template-rows: 38px minmax(0, 1fr) 32px;
+		grid-template-rows: 0 minmax(0, 1fr) 40px;
 		height: 100%;
 		min-height: 0;
-		border: 1px solid #ffffff0d;
-		border-radius: 12px;
-		background: radial-gradient(ellipse at 50% 20%, #202028, #131316 70%);
+		border: 0;
+		border-radius: 0;
+		background: transparent;
 		overflow: hidden;
 	}
 	.artboard-toolbar,
@@ -431,10 +548,24 @@
 		display: flex;
 		align-items: center;
 		justify-content: space-between;
-		gap: 8px;
+		gap: 6px;
 		padding: 0 12px;
 		min-width: 0;
 	}
+	.artboard-toolbar {
+		position: absolute;
+		top: 10px;
+		left: 10px;
+		z-index: 2;
+		border-radius: 4px;
+		background: var(--media-scrim);
+		color: var(--on-media);
+		padding: 2px 6px;
+		max-width: calc(100% - 20px);
+		border: 0;
+		cursor: pointer;
+		text-align: left;
+	}
 	.result-title {
 		display: flex;
 		align-items: center;
@@ -451,25 +582,46 @@
 		text-overflow: ellipsis;
 		max-width: 220px;
 	}
-	.canvas-actions {
-		display: flex;
-		gap: 4px;
-		flex-shrink: 0;
-	}
 	.canvas-btn {
-		background: #ffffff04;
+		display: inline-flex;
+		align-items: center;
+		gap: 6px;
+		height: 26px;
+		box-sizing: border-box;
+		background: var(--bg-2);
 		color: var(--text-2);
-		border: 1px solid #ffffff0a;
-		border-radius: 6px;
-		padding: 5px 8px;
-		font-size: 10px;
+		border: 1px solid var(--line);
+		border-radius: var(--desk-action-radius);
+		padding: 0 9px;
+		font-size: 12px;
+		font-weight: 500;
 		cursor: pointer;
 		text-decoration: none;
 		white-space: nowrap;
 	}
+	.action-separator {
+		width: 1px;
+		height: 18px;
+		flex-shrink: 0;
+		margin: 0 4px;
+		background: var(--line-2);
+	}
+	.delete-output {
+		width: 26px;
+		padding: 0;
+		justify-content: center;
+		color: var(--err);
+		background: transparent;
+		border-color: transparent;
+	}
+	.canvas-btn:disabled,
+	.canvas-btn[aria-disabled='true'] {
+		opacity: 0.45;
+		cursor: not-allowed;
+	}
 	.canvas-btn:hover {
 		color: var(--text);
-		background: #ffffff0a;
+		background: var(--bg-3);
 	}
 	.canvas-btn[aria-pressed='true'],
 	.play-button {
@@ -477,6 +629,7 @@
 		border-color: var(--accent-line);
 	}
 	.stage {
+		grid-row: 2;
 		min-height: 0;
 		min-width: 0;
 		position: relative;
@@ -485,7 +638,7 @@
 	.stage-media {
 		position: absolute;
 		inset: 0;
-		padding: 8px 20px;
+		padding: 0;
 		display: grid;
 		place-items: center;
 		min-height: 0;
@@ -503,6 +656,20 @@
 		background: none;
 		box-shadow: none;
 	}
+	.big-play {
+		position: absolute;
+		left: 50%;
+		top: 50%;
+		transform: translate(-50%, -50%);
+		width: 64px;
+		height: 64px;
+		border-radius: 50%;
+		border: 1px solid var(--on-media-line);
+		color: var(--on-media);
+		background: var(--media-scrim);
+		font-size: 26px;
+		cursor: pointer;
+	}
 	.print img,
 	.print video {
 		width: 100%;
@@ -540,7 +707,7 @@
 	.comparison-layer {
 		position: absolute;
 		inset: 0;
-		background: #17171d;
+		background: var(--bg-0);
 		pointer-events: none;
 	}
 	.comparison-divider {
@@ -552,7 +719,10 @@
 		pointer-events: none;
 	}
 	.artboard-footer {
-		justify-content: flex-start;
+		grid-row: 3;
+		justify-content: center;
+		gap: 6px;
+		padding: 0;
 		font-size: 10px;
 		color: var(--text-3);
 	}
@@ -578,7 +748,7 @@
 		gap: 4px;
 		max-width: 90%;
 		overflow: auto;
-		background: #101015d9;
+		background: var(--media-scrim);
 		border: 1px solid var(--line);
 		padding: 4px;
 		border-radius: 8px;

calliope-web/src/lib/components/desk/DeskWorkflowRail.svelte

@@ -1,13 +1,18 @@
 <script lang="ts">
-	import { onMount } from 'svelte';
+	import { resolve } from '$app/paths';
+ import { isWorkflowRunnable } from '$lib/workflowState';
+	import { onMount, untrack } from 'svelte';
+	import { goto } from '$app/navigation';
 	import { createMutation, useQueryClient } from '@tanstack/svelte-query';
 	import { workflows, apiErrorMessage } from '$lib/api';
 	import type { WorkflowMeta } from '$lib/comfy/types';
 	import { usageLabel } from '$lib/components/generate/schema';
 	import { spotlight } from '$lib/actions/spotlight';
 	import { toast } from '$lib/toast';
+	import Icon from '$lib/components/ui/Icon.svelte';
 	let {
 		kind,
+		initialUsage = 'all',
 		metas,
 		selectedId,
 		pendingCount,
@@ -15,9 +20,14 @@
 		onKind,
 		onDetails,
 		disabled = false,
+		historyCollapsed = false,
+		onToggleHistory,
 	}: {
 		disabled?: boolean;
+		historyCollapsed?: boolean;
+		onToggleHistory: () => void;
 		kind: 'image' | 'video';
+		initialUsage?: string;
 		metas: WorkflowMeta[];
 		selectedId: number | null;
 		pendingCount: number;
@@ -25,11 +35,47 @@
 		onKind: (kind: 'image' | 'video') => void;
 		onDetails: () => void;
 	} = $props();
+	let searchInput: HTMLInputElement;
+	let searchOrigin: HTMLElement | null = null;
+	function searchKeydown(e: KeyboardEvent) {
+		if (e.defaultPrevented || e.isComposing || e.keyCode === 229) return;
+		if (
+			[
+				...document.querySelectorAll('.shell-pop, .modal, [role="dialog"]'),
+			].some((el) => el.getClientRects().length)
+		)
+			return;
+		if (e.key === 'Escape' && e.target === searchInput) {
+			e.preventDefault();
+			const origin = searchOrigin?.isConnected
+				? searchOrigin
+				: searchInput.closest('aside')?.querySelector('button');
+			if (origin instanceof HTMLElement) origin.focus();
+			else searchInput.blur();
+			return;
+		}
+		const el = e.target instanceof HTMLElement ? e.target : null;
+		if (
+			e.key !== '/' ||
+			e.ctrlKey ||
+			e.metaKey ||
+			e.altKey ||
+			el?.isContentEditable ||
+			el?.closest(
+				'input, textarea, select, [contenteditable]:not([contenteditable="false"])',
+			) ||
+			!searchInput?.getClientRects().length
+		)
+			return;
+		e.preventDefault();
+		searchInput.focus();
+	}
 	const client = useQueryClient();
 	let search = $state(''),
-		usage = $state('all'),
+		usage = $state(untrack(() => initialUsage)),
 		family = $state('all'),
 		favOnly = $state(false),
+		runnableOnly = $state(true),
 		limit = $state(48),
 		pins = $state<number[]>([]);
 	onMount(() => {
@@ -51,10 +97,18 @@
 		metas
 			.filter(
 				(m) =>
+					(!runnableOnly || runnable(m)) &&
 					(!favOnly || m.favorite) &&
 					(usage === 'all' || m.usage === usage) &&
 					(family === 'all' || m.model_family === family) &&
-					[m.name, m.description, m.model_family, ...(m.tags ?? [])]
+					[
+						m.name,
+						m.description,
+						m.source_path,
+						m.usage ? usageLabel(m.usage) : null,
+						m.model_family,
+						...(m.tags ?? []),
+					]
 						.join(' ')
 						.toLowerCase()
 						.includes(search.trim().toLowerCase()),
@@ -63,6 +117,10 @@
 				(a, b) =>
 					Number(pins.includes(b.id)) - Number(pins.includes(a.id)) ||
 					Number(b.favorite) - Number(a.favorite) ||
+					(a.model_family ?? '本地工作流').localeCompare(
+						b.model_family ?? '本地工作流',
+						'zh',
+					) ||
 					a.name.localeCompare(b.name, 'zh'),
 			),
 	);
@@ -77,12 +135,23 @@
 		const index = filtered.findIndex((m) => m.id === selectedId);
 		if (index >= limit) limit = index + 24;
 	});
+	function runnable(m: WorkflowMeta) {
+		return isWorkflowRunnable(m);
+	}
+	function choose(m: WorkflowMeta) {
+		if (runnable(m)) onPick(m.id);
+		else void goto(resolve(`/workflows?manage=1&wf=${m.id}`));
+	}
 	function pin(id: number) {
 		pins = pins.includes(id) ? pins.filter((p) => p !== id) : [...pins, id];
-		localStorage.setItem(
-			'calliope.reference.workflowPins',
-			JSON.stringify(pins),
-		);
+		try {
+			localStorage.setItem(
+				'calliope.reference.workflowPins',
+				JSON.stringify(pins),
+			);
+		} catch {
+			/* Pins remain usable this visit. */
+		}
 	}
 	const favorite = createMutation({
 		mutationFn: (m: WorkflowMeta) =>
@@ -92,50 +161,89 @@
 	});
 </script>
 
+<svelte:window onkeydown={searchKeydown} />
+
 <aside class="workflow-rail" aria-label="创作工作流列表">
 	<header>
-		<div><strong>创作台</strong><small>选择工作流，开始创作</small></div>
+		<strong>创作台</strong><button
+			class="history-toggle a-btn ghost sm"
+			onclick={onToggleHistory}
+			aria-label={historyCollapsed ? '展开历史栏' : '收起历史栏'}
+			aria-expanded={!historyCollapsed}>◫</button
+		>
 	</header>
 	<div class="rail-tools">
 		<div class="kind-tabs" role="tablist" aria-label="创作类型">
 			<button
 				role="tab"
-				{disabled}
 				aria-selected={kind === 'image'}
-				onclick={() => onKind('image')}>图片</button
-			><button
-				role="tab"
 				{disabled}
+				onclick={() => onKind('image')}>图片</button
+			>
+			<button
+				role="tab"
 				aria-selected={kind === 'video'}
+				{disabled}
 				onclick={() => onKind('video')}>视频</button
 			>
 		</div>
-		<input
-			type="search"
-			bind:value={search}
-			aria-label="搜索工作流"
-			placeholder="搜索工作流或用途…"
-		/>
-		<div class="filters">
-			<select aria-label="筛选工作流用途" bind:value={usage}
-				><option value="all">所有用途</option>{#each usages as u}<option
-						value={u!}>{usageLabel(u!)}</option
-					>{/each}</select
-			><select aria-label="筛选模型家族" bind:value={family}
-				><option value="all">全部模型</option>{#each families as f}<option
-						value={f!}>{f}</option
-					>{/each}</select
+		<div class="rail-search">
+			<Icon name="search" size={14} />
+			<input
+				type="search"
+				bind:this={searchInput}
+				onfocus={(e) => {
+					searchOrigin =
+						e.relatedTarget instanceof HTMLElement ? e.relatedTarget : null;
+				}}
+				bind:value={search}
+				aria-label="搜索工作流"
+				placeholder="搜用途、模型或文件名"
+			/>
+			<kbd>/</kbd>
+		</div>
+		<div class="filters" role="group" aria-label="筛选工作流用途">
+			<button aria-pressed={usage === 'all'} onclick={() => (usage = 'all')}
+				>全部</button
+			>
+			{#each usages as u (u)}<button
+					aria-pressed={usage === u}
+					onclick={() => (usage = u!)}>{usageLabel(u!)}</button
+				>{/each}
+			<button aria-pressed={favOnly} onclick={() => (favOnly = !favOnly)}
+				>☆ 收藏</button
+			>
+		</div>
+		{#if families.length}<div
+				class="filters"
+				role="group"
+				aria-label="筛选模型家族"
+			>
+				<button aria-pressed={family === 'all'} onclick={() => (family = 'all')}
+					>全部模型</button
+				>
+				{#each families as f (f)}<button
+						aria-pressed={family === f}
+						onclick={() => (family = f!)}>{f}</button
+					>{/each}
+			</div>{/if}
+		<div class="list-meta">
+			<span title="目录接口不提供仓库文件总数"
+				>{filtered.length} 个 · 仓库文件数未知</span
+			>
+			<label class="runnable-filter"
+				><input type="checkbox" bind:checked={runnableOnly} />仅可运行</label
 			>
 		</div>
 	</div>
-	<div class="list-meta">
-		<span>{filtered.length} 个可用工作流</span><button
-			aria-pressed={favOnly}
-			onclick={() => (favOnly = !favOnly)}>{favOnly ? '★' : '☆'} 收藏</button
-		>
-	</div>
 	<div class="rail-list">
-		{#each filtered.slice(0, limit) as m (m.id)}<div
+		{#each filtered.slice(0, limit) as m, index (m.id)}
+			{#if index === 0 || pins.includes(m.id) !== pins.includes(filtered[index - 1].id) || (!pins.includes(m.id) && m.model_family !== filtered[index - 1].model_family)}<div
+					class="family-label"
+				>
+					{pins.includes(m.id) ? '置顶工作流' : m.model_family || '本地工作流'}
+				</div>{/if}
+			<div
 				class="workflow-row reference-option"
 				use:spotlight
 				class:selected={selectedId === m.id}
@@ -143,12 +251,15 @@
 				<button
 					class="workflow-pick"
 					{disabled}
-					onclick={() => onPick(m.id)}
+					onclick={() => choose(m)}
 					aria-pressed={selectedId === m.id}
 					title={m.name}
-					><i class:video={kind === 'video'}>{kind === 'image' ? '◈' : '▷'}</i
+					><i class:video={kind === 'video'}
+						>{m.model_family?.slice(0, 3) || (kind === 'image' ? '◈' : '▷')}</i
 					><span
-						><b>{m.name}</b><small
+						><b>{m.name}</b>{#if !runnable(m)}<small class="pending"
+								>待配置 · 映射 / 测试 →</small
+							>{/if}<small
 							>{m.description ||
 								(m.usage ? usageLabel(m.usage) : '本地 ComfyUI')}</small
 						></span
@@ -178,108 +289,184 @@
 			>{/if}
 	</div>
 	<footer>
-		{#if pendingCount}<a href="/workflows?manage=1"
+		{#if pendingCount}<a href={resolve('/workflows?manage=1')}
 				>{pendingCount} 个工作流待配置 →</a
-			>{/if}<button class="manage" onclick={onDetails}
+			>{/if}<button class="manage" data-workflow-details onclick={onDetails}
 			><span>＋</span>
 			<div>工作流说明与管理<small>输入要求 / 导入 / 分类</small></div>
 			<b>›</b></button
-		><a href="/models">云端模型与接口 ↗</a>
+		><a href={resolve('/models')}>云端模型与接口 ↗</a>
 	</footer>
 </aside>
 
 <style>
 	.workflow-rail {
-		width: 232px;
+		box-sizing: border-box;
+		width: var(--list);
 		flex-shrink: 0;
 		display: flex;
 		flex-direction: column;
 		min-height: 0;
-		background: #121216;
+		background: var(--bg-1);
 		border-right: 1px solid var(--line);
 	}
 	.workflow-rail > header {
-		padding: 21px 18px 16px;
-		border-bottom: 1px solid var(--line);
+		padding: 12px 12px 0;
+		height: var(--desk-rail-title-height);
+		box-sizing: border-box;
+		flex-shrink: 0;
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
 	}
 	header strong {
-		font-size: 18px;
+		font-size: 14px;
 		font-weight: 600;
 		display: block;
 	}
-	header small {
-		display: block;
-		font-size: 11px;
-		color: var(--text-3);
-		margin-top: 6px;
-	}
 	.rail-tools {
-		padding: 14px 12px 7px;
+		padding: var(--desk-rail-gap) 12px;
+		border-bottom: 1px solid var(--line);
 	}
 	.kind-tabs {
 		display: flex;
-		gap: 3px;
-		background: #09090c;
-		border: 1px solid var(--line);
-		border-radius: 9px;
+		gap: 2px;
 		padding: 3px;
+		height: 36px;
+		box-sizing: border-box;
+		border: 1px solid var(--line);
+		border-radius: var(--desk-seg-radius);
+		background: var(--well);
 	}
 	.kind-tabs button {
 		flex: 1;
+		height: 28px;
+		padding: 0 12px;
+		font-size: 12.5px;
 		border: 0;
-		padding: 7px 3px;
-		background: none;
-		color: var(--text-3);
-		font-size: 12px;
-		border-radius: 6px;
+		border-radius: var(--desk-seg-selected-radius);
+		background: transparent;
+		color: var(--tx-2);
 		cursor: pointer;
 	}
 	.kind-tabs [aria-selected='true'] {
-		color: #062f35;
-		background: var(--accent);
-		font-weight: 600;
+		background: var(--bg-3);
+		box-shadow: var(--sh-1);
+		color: var(--tx-1);
 	}
-	.rail-tools input {
-		width: 100%;
-		margin-top: 10px;
-		font-size: 11px;
-		padding: 9px 10px;
-		background: #1d1b16;
-		border: 1px solid #f5b04228;
-		border-radius: 8px;
+	.kind-tabs button:disabled {
+		cursor: wait;
+	}
+	.rail-search {
+		display: flex;
+		align-items: center;
+		gap: 8px;
+		margin-top: var(--desk-rail-gap);
+		height: var(--desk-search-height);
+		box-sizing: border-box;
+		font-size: var(--desk-search-size);
+		padding: 0 10px;
+		background: var(--well);
+		border: 1px solid var(--line-2);
+		border-radius: var(--desk-search-radius);
 		color: var(--text);
 	}
+	.rail-search input {
+		min-width: 0;
+		flex: 1;
+		padding: 0;
+		border: 0;
+		background: none;
+		color: inherit;
+		font: inherit;
+		outline: none;
+	}
+	.rail-search kbd {
+		font: var(--desk-search-key-font);
+		padding: var(--desk-search-key-padding);
+		border-radius: var(--desk-search-key-radius);
+		border: 1px solid var(--line-2);
+		color: var(--tx-3);
+		background: var(--bg-1);
+	}
+	.rail-search:focus-within {
+		border-color: var(--scene);
+	}
 	.filters {
 		display: flex;
-		gap: 5px;
+		flex-wrap: wrap;
+		gap: 6px;
 		margin-top: 8px;
 	}
-	.filters select {
-		width: 50%;
-		min-width: 0;
+	.filters button {
+		height: var(--desk-filter-height);
+		padding: 0 9px;
+		font-size: var(--desk-filter-size);
+		border-radius: var(--desk-filter-radius);
 		border: 1px solid var(--line);
-		background: var(--bg-3);
-		border-radius: 5px;
-		padding: 5px;
-		font-size: 10px;
-		color: var(--text-3);
+		background: var(--bg-2);
+		color: var(--tx-2);
+		cursor: pointer;
+	}
+	.filters button[aria-pressed='true'] {
+		color: var(--tx-1);
+		border-color: color-mix(in srgb, var(--scene) 60%, transparent);
+		background: color-mix(in srgb, var(--scene) 13%, var(--bg-2));
+	}
+	.runnable-filter {
+		display: flex;
+		align-items: center;
+		gap: 6px;
+		white-space: nowrap;
+		cursor: pointer;
+	}
+	.runnable-filter input {
+		margin: 0;
+		appearance: none;
+		width: var(--desk-switch-width);
+		height: var(--desk-switch-height);
+		border: 0;
+		border-radius: var(--r-pill);
+		background: var(--bg-4);
+		position: relative;
+		cursor: pointer;
+		flex-shrink: 0;
+	}
+	.runnable-filter input::after {
+		content: '';
+		position: absolute;
+		left: 2px;
+		top: 2px;
+		width: var(--desk-switch-knob);
+		height: var(--desk-switch-knob);
+		border-radius: 50%;
+		background: var(--tx-2);
+		transition: transform var(--t-base);
+	}
+	.runnable-filter input:checked {
+		background: color-mix(in srgb, var(--scene) 55%, var(--bg-4));
+	}
+	.runnable-filter input:checked::after {
+		transform: translateX(11px);
+		background: var(--on-media);
+	}
+	.pending {
+		color: var(--warn);
 	}
 	.list-meta {
 		display: flex;
+		flex-wrap: wrap;
+		align-items: center;
 		justify-content: space-between;
-		padding: 8px 16px;
-		font-size: 10px;
-		color: var(--text-3);
+		gap: 6px;
+		padding: 8px 2px 0;
+		font-size: var(--desk-filter-size);
+		color: var(--tx-3);
 	}
-	.list-meta button {
-		border: 0;
-		background: none;
-		color: var(--text-3);
-		font-size: 10px;
-		cursor: pointer;
-	}
-	.list-meta button[aria-pressed='true'] {
-		color: var(--warn);
+	.family-label {
+		font-size: 11px;
+		color: var(--tx-3);
+		padding: 8px;
 	}
 	.rail-list {
 		flex: 1;
@@ -297,8 +484,12 @@
 		margin: 2px 0;
 	}
 	.workflow-row.selected {
-		border-color: #00cae039;
-		background: linear-gradient(120deg, #00cae016, #00cae003);
+		border-color: color-mix(in srgb, var(--scene) 35%, transparent);
+		background: linear-gradient(
+			90deg,
+			color-mix(in srgb, var(--scene) 12%, var(--bg-3)),
+			var(--bg-3)
+		);
 	}
 	.workflow-row.selected::before {
 		content: '';
@@ -306,7 +497,7 @@
 		height: 22px;
 		position: absolute;
 		left: 0;
-		background: var(--accent);
+		background: var(--scene);
 		border-radius: 3px;
 	}
 	.workflow-pick {
@@ -330,9 +521,9 @@
 		height: 32px;
 		flex-shrink: 0;
 		border-radius: 9px;
-		border: 1px solid #00cae01f;
-		color: var(--accent);
-		background: #00cae008;
+		border: 1px solid var(--line-2);
+		color: var(--scene);
+		background: var(--bg-3);
 		font-size: 16px;
 		font-style: normal;
 	}
@@ -383,7 +574,7 @@
 		opacity: 1;
 	}
 	.workflow-row:hover {
-		background-color: #ffffff05;
+		background-color: var(--bg-2);
 	}
 	.empty {
 		color: var(--text-3);
@@ -434,7 +625,7 @@
 	}
 	@media (max-width: 1100px) {
 		.workflow-rail {
-			width: 210px;
+			width: var(--list);
 		}
 	}
 </style>

calliope-web/src/lib/components/desk/HistoryRail.svelte

@@ -0,0 +1,157 @@
+<script lang="ts">
+	import { assetUrl } from '$lib/api';
+	import { jobStatusInfo } from '$lib/jobStatus';
+	import { isVideoOutput } from '../generate/takes';
+	import type { Job } from '$lib/comfy/types';
+	let {
+		jobs,
+		selectedId,
+		onSelect,
+		onExpand,
+		collapsed = false,
+	}: {
+		collapsed?: boolean;
+		jobs: Job[];
+		selectedId: number | null;
+		onSelect: (job: Job) => void;
+		onExpand: () => void;
+	} = $props();
+	const sorted = $derived([...jobs].sort((a, b) => b.id - a.id));
+</script>
+
+<aside class="history-rail" class:collapsed aria-label="生成历史">
+	<header>历史</header>
+	{#if !collapsed}
+		<div class="history-list">
+			{#each sorted as job (job.id)}
+				{@const status = jobStatusInfo(job)}
+				<button
+					class="history-take"
+					class:selected={selectedId === job.id}
+					onclick={() => onSelect(job)}
+					aria-label={'查看历史 #' + job.id + ' · ' + status.label}
+					aria-pressed={selectedId === job.id}
+				>
+					<div class="thumb">
+						{#if job.output_paths[0] && status.tone === 'ok'}
+							{#if isVideoOutput(job, job.output_paths[0])}<span
+									class="video-mark">▷</span
+								><video
+									src={assetUrl(job.output_paths[0])}
+									muted
+									preload="metadata"
+									aria-label="视频缩略图"
+								></video>
+							{:else}<img
+									src={assetUrl(job.output_paths[0])}
+									alt=""
+									loading="lazy"
+								/>{/if}
+						{:else}<span class:failed={status.tone === 'fail'}
+								>{status.label}</span
+							>{/if}
+					</div>
+					<small>#{job.id}</small>
+				</button>
+			{/each}
+			{#if !sorted.length}<p>生成后<br />记录留在这里</p>{/if}
+		</div>
+		<footer><button onclick={onExpand}>全部记录</button></footer>
+	{/if}
+</aside>
+
+<style>
+	.history-rail {
+		box-sizing: border-box;
+		width: var(--hist);
+		flex-shrink: 0;
+		display: flex;
+		flex-direction: column;
+		min-height: 0;
+		border-left: 1px solid var(--line);
+		background: var(--bg-1);
+	}
+	.history-rail.collapsed {
+		width: 0;
+		border: 0;
+		overflow: hidden;
+		visibility: hidden;
+	}
+	header {
+		height: var(--head);
+		display: grid;
+		place-items: center;
+		flex-shrink: 0;
+		border-bottom: 1px solid var(--line);
+	}
+	button {
+		font: inherit;
+		font-size: 11px;
+		background: none;
+		color: var(--tx-2);
+		border: 0;
+		cursor: pointer;
+	}
+	.history-list {
+		flex: 1;
+		min-height: 0;
+		overflow: auto;
+		padding: 8px 6px;
+	}
+	.history-take {
+		display: block;
+		width: 100%;
+		padding: 3px;
+		margin-bottom: 8px;
+		border: 1px solid transparent;
+		border-radius: var(--r-sm);
+	}
+	.history-take.selected {
+		border-color: var(--scene);
+		background: color-mix(in srgb, var(--scene) 10%, transparent);
+	}
+	.thumb {
+		position: relative;
+		aspect-ratio: 1;
+		display: grid;
+		place-items: center;
+		background: var(--bg-0);
+		border-radius: var(--r-xs);
+		overflow: hidden;
+		font-size: 10px;
+	}
+	img,
+	video {
+		width: 100%;
+		height: 100%;
+		object-fit: contain;
+		position: absolute;
+		inset: 0;
+	}
+	.video-mark {
+		position: absolute;
+		z-index: 1;
+		color: var(--on-media);
+		font-size: 24px;
+		text-shadow: 0 1px 6px var(--media-scrim);
+	}
+	.failed {
+		color: var(--err);
+	}
+	small {
+		font-family: var(--mono);
+		font-size: 10px;
+		color: var(--tx-3);
+	}
+	p {
+		text-align: center;
+		font-size: 10px;
+		color: var(--tx-3);
+		line-height: 1.7;
+	}
+	footer {
+		padding: 10px 2px;
+		text-align: center;
+		border-top: 1px solid var(--line);
+	}
+</style>

calliope-web/src/lib/components/desk/StudioDesk.svelte

@@ -1,11 +1,16 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
+	import { createHref } from '$lib/createHref';
+ import { isWorkflowRunnable } from '$lib/workflowState';
+	import { readDeskDraft, writeDeskDraft } from './draftCache';
+	import HistoryRail from './HistoryRail.svelte';
 	import { createQuery, useQueryClient } from '@tanstack/svelte-query';
 	import { toStore } from 'svelte/store';
 	import { tick, untrack } from 'svelte';
-	import { SvelteMap, SvelteSet } from 'svelte/reactivity';
+	import { SvelteMap, SvelteSet, SvelteURL } from 'svelte/reactivity';
 	import { page } from '$app/state';
 	import { goto } from '$app/navigation';
-	import Icon from '$lib/components/ui/Icon.svelte';
+	import '$lib/components/ui/Icon.svelte';
 	import Modal from '$lib/components/ui/Modal.svelte';
 	import AppShell from '$lib/components/shell/AppShell.svelte';
 	import Composer from '$lib/components/generate/Composer.svelte';
@@ -36,8 +41,9 @@
 		workbenchCtxOf,
 		type FeedFilter,
 	} from '$lib/components/generate/takes';
-	import InputRequirementBadge from './InputRequirementBadge.svelte';
+	import './InputRequirementBadge.svelte';
 	import WorkflowBay from './WorkflowBay.svelte';
+	import StoreResultModal from '$lib/components/generate/StoreResultModal.svelte';
 	import DeskWorkflowRail from './DeskWorkflowRail.svelte';
 	import {
 		apiErrorMessage,
@@ -121,7 +127,7 @@
 	const deskMetas = $derived(
 		allMetas.filter(
 			(m) =>
-				m.is_enabled && m.usage !== null && !m.needs_mapping && m.kind === kind,
+				isWorkflowRunnable(m) && m.kind === kind,
 		),
 	);
 	const pendingCount = $derived(
@@ -131,6 +137,7 @@
 	// Full records, lazily fetched per id (selected workflow, feed jobs'
 	// workflows, the bay's preview row) and cached until invalidated.
 	const details = new SvelteMap<number, Workflow>();
+	// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Nonreactive request gate: ensureDetail reads has synchronously in the effect; reactive delete on failure would re-arm requests without a cached detail.
 	const inflight = new Set<number>();
 
 	async function ensureDetail(id: number): Promise<Workflow | null> {
@@ -150,6 +157,7 @@
 	}
 
 	const neededIds = $derived.by(() => {
+		// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Rebuilt from workflowId, bay selection and jobs on each derivation; this completed ID set is never mutated by consumers.
 		const ids = new Set<number>();
 		if (workflowId != null) ids.add(workflowId);
 		if (bayOpen && bayActiveId != null) ids.add(bayActiveId);
@@ -194,7 +202,7 @@
 
 	// Jobs enqueued from this desk — a fast failure can land before the
 	// jobs list refetch knows about them.
-	const submittedIds = new Set<number>();
+	const submittedIds = new SvelteSet<number>();
 
 	// D 批: one-shot completion flash / failure shake (SSE-driven) and the
 	// 5-second undo window for record deletes.
@@ -249,7 +257,7 @@
 	// Bay (挑选台) state — mode, deep links, open/collapse
 	// ------------------------------------------------------------------
 	type TaskMode = WorkflowUsage | 'all';
-	let mode = $state<TaskMode>(untrack(initMode));
+	const mode = $state<TaskMode>(untrack(initMode));
 	function initMode(): TaskMode {
 		const q = page.url.searchParams.get('mode');
 		return q && USAGE_BY_KIND[kind].includes(q as WorkflowUsage)
@@ -263,6 +271,8 @@
 	let paramEndpoint = $state('');
 	let paramShowErrors = $state(false);
 	let historyOpen = $state(false);
+	let historyCollapsed = $state(false);
+	let dockAnchor = $state<HTMLElement | null>(null);
 	let focusMode = $state(false);
 	let bayActiveId = $state<number | null>(null);
 	let bay = $state<WorkflowBay | null>(null);
@@ -276,7 +286,9 @@
 	function closeBay() {
 		bayOpen = false;
 		void tick().then(() =>
-			document.querySelector<HTMLButtonElement>('.model-selector')?.focus(),
+			document
+				.querySelector<HTMLButtonElement>('[data-workflow-details]')
+				?.focus(),
 		);
 	}
 
@@ -286,6 +298,7 @@
 		if (slotBusy || submitting) return;
 		actionRevision++;
 		selectedJobId = workflowResults.get(id) ?? null;
+		historyJobId = null;
 		if (id !== workflowId) workflowId = id;
 		void tick().then(() => promptEl?.focus());
 	}
@@ -308,18 +321,12 @@
 			workflowId = restoredWorkflowId;
 			return;
 		}
-		if (deskMetas.some((m) => m.id === raw)) workflowId = raw;
+		if (deskMetas.some((m) => m.id === raw)) {
+			if (pendingDraft?.workflowId !== raw) pendingDraft = null;
+			workflowId = raw;
+		}
 	});
 
-	async function toggleFavorite(id: number, fav: boolean) {
-		try {
-			await workflows.update(id, { favorite: fav });
-			await client.invalidateQueries({ queryKey: ['workflows-meta'] });
-			await client.invalidateQueries({ queryKey: ['workflows'] });
-		} catch (err) {
-			toast.error(apiErrorMessage(err));
-		}
-	}
 
 	// ------------------------------------------------------------------
 	// Form state
@@ -335,7 +342,6 @@
 				draftContext?.projectId,
 				draftContext?.stage,
 				draftContext?.sourceId ?? draftContext?.label,
-				page.url.searchParams.get('wf'),
 			]),
 	);
 	const sourceFingerprint = JSON.stringify([
@@ -343,9 +349,13 @@
 		draftContext?.negative,
 		draftContext?.durationSec,
 	]);
-	function readDraft(): { workflowId: number; values: FormValues } | null {
+	function readDraft(): {
+		workflowId: number;
+		values: FormValues;
+		requestId?: string | null;
+	} | null {
 		try {
-			const d = JSON.parse(window.sessionStorage.getItem(draftKey) ?? 'null');
+			const d = JSON.parse(readDeskDraft(draftKey) ?? 'null');
 			if (
 				!d ||
 				d.source !== sourceFingerprint ||
@@ -367,19 +377,27 @@
 				)
 					clean[key] = value;
 			}
-			return { workflowId: d.workflowId, values: clean };
+			return {
+				workflowId: d.workflowId,
+				values: clean,
+				requestId: d.requestId,
+			};
 		} catch {
 			return null;
 		}
 	}
 	let pendingDraft = untrack(readDraft);
+	// Keep the reload decision stable while detail and metadata queries arrive in either order.
+	const restoredWorkflowId = untrack(() =>
+		pendingDraft?.requestId === page.url.searchParams.get('wf')
+			? pendingDraft?.workflowId
+			: null,
+	);
 	const workflowDrafts = new SvelteMap<number, FormValues>();
 	const workflowEndpoints = new SvelteMap<number, string>();
 	const workflowResults = new SvelteMap<number, number>();
 	try {
-		const saved = JSON.parse(
-			window.sessionStorage.getItem(draftKey + ':workflows') ?? 'null',
-		);
+		const saved = JSON.parse(readDeskDraft(draftKey + ':workflows') ?? 'null');
 		if (saved?.source === sourceFingerprint) {
 			for (const [id, draft] of Object.entries(saved.drafts ?? {}))
 				if (Number.isInteger(Number(id)) && draft && typeof draft === 'object')
@@ -390,7 +408,7 @@
 	} catch {
 		/* The form works without storage. */
 	}
-	const restoredWorkflowId = pendingDraft?.workflowId ?? null;
+
 	let workflowId = $state<number | null>(pendingDraft?.workflowId ?? null);
 	let values = $state<FormValues>({});
 	let showErrors = $state(false);
@@ -456,6 +474,16 @@
 				...schemaDefaults(wf.input_schema ?? []),
 				...(workflowDrafts.get(wf.id) ?? {}),
 			};
+			if (lastWf && !workflowDrafts.has(wf.id)) {
+				const previous = classifySchema(lastWf.input_schema ?? [], lastWf.kind);
+				const incoming = classifySchema(wf.input_schema ?? [], wf.kind);
+				for (const role of ['prompt', 'negative'] as const) {
+					const oldInput = previous[role],
+						newInput = incoming[role];
+					if (oldInput && newInput && values[oldInput.nodeId] !== undefined)
+						next[newInput.nodeId] = values[oldInput.nodeId];
+				}
+			}
 			endpointTouched = true;
 			endpointId =
 				workflowEndpoints.get(wf.id) ?? wf.endpoint_id ?? activeId ?? '';
@@ -484,7 +512,7 @@
 			try {
 				workflowDrafts.set(wf.id, structuredClone($state.snapshot(inputs)));
 				workflowEndpoints.set(wf.id, ep);
-				window.sessionStorage.setItem(
+				writeDeskDraft(
 					draftKey + ':workflows',
 					JSON.stringify({
 						source: sourceFingerprint,
@@ -492,10 +520,11 @@
 						endpoints: Object.fromEntries(workflowEndpoints),
 					}),
 				);
-				window.sessionStorage.setItem(
+				writeDeskDraft(
 					draftKey,
 					JSON.stringify({
 						workflowId: wf.id,
+						requestId: page.url.searchParams.get('wf'),
 						values: inputs,
 						source: sourceFingerprint,
 					}),
@@ -671,6 +700,7 @@
 			return;
 		}
 		const wf = currentWorkflow!;
+		historyJobId = null;
 		submitting = true;
 		try {
 			const res = await playgroundApi.generate({
@@ -690,8 +720,6 @@
 			sentTimer = setTimeout(() => (sent = false), 900);
 			// C 批审核:从「参数」页提交后自动切到「结果」页，进行中进度可见。
 			tab = 'result';
-			if (wide) inspOff = false;
-			else if (!narrow) inspOpen = true;
 			await client.invalidateQueries({ queryKey: ['playground-jobs'] });
 			await client.invalidateQueries({ queryKey: ['jobs'] });
 			// 最近使用由后端在入队时记录 (queue/manager)；这里只刷新轻量列表。
@@ -710,30 +738,12 @@
 	// ------------------------------------------------------------------
 	let filter = $state<FeedFilter>(untrack(() => kind));
 	let selectedJobId = $state<number | null>(null);
+	let historyJobId = $state<number | null>(null);
 	let busyId = $state<number | null>(null);
 	let tab = $state<'result' | 'params'>('result');
-	let inspOff = $state(false);
-	let inspOpen = $state(false);
-	let wide = $state(true);
-	let narrow = $state(false);
 	let crossfade = $state(false);
 	let videoEl = $state<HTMLVideoElement | null>(null);
 
-	$effect(() => {
-		const mq = window.matchMedia('(min-width: 1180px)');
-		const mq2 = window.matchMedia('(max-width: 760px)');
-		const sync = () => {
-			wide = mq.matches;
-			narrow = mq2.matches;
-		};
-		sync();
-		mq.addEventListener('change', sync);
-		mq2.addEventListener('change', sync);
-		return () => {
-			mq.removeEventListener('change', sync);
-			mq2.removeEventListener('change', sync);
-		};
-	});
 
 	let nowMs = $state(Date.now());
 	const anyActive = $derived(
@@ -747,7 +757,8 @@
 
 	/** Picked take, else the newest finished one in view (undo-pending rows don't count). */
 	const selectedJob = $derived(
-		allJobs.find((j) => j.id === selectedJobId && !pendingIds.has(j.id)) ??
+		allJobs.find((j) => j.id === historyJobId && !pendingIds.has(j.id)) ??
+			allJobs.find((j) => j.id === selectedJobId && !pendingIds.has(j.id)) ??
 			allJobs
 				.filter(
 					(j) =>
@@ -766,13 +777,11 @@
 	 */
 	function selectTake(job: Job, via: 'pointer' | 'keyboard' = 'pointer') {
 		const from = via === 'pointer' ? (feed?.markRect() ?? null) : null;
-		selectedJobId = job.id;
-		if (workflowId != null && job.workflow_id === workflowId)
-			workflowResults.set(workflowId, job.id);
+		historyJobId = job.id;
+
 		tab = 'result';
 		crossfade = via === 'pointer';
 		if (via === 'pointer') {
-			if (!wide) inspOpen = true;
 			void tick().then(() => feed?.slideFrom(from));
 		} else {
 			feed?.scrollToJob(job.id);
@@ -842,11 +851,12 @@
 	);
 	function mediumLink(next: DeskKind) {
 		if (slotBusy || submitting) return;
-		const url = new URL(page.url);
-		url.pathname = '/' + next;
+		const url = new SvelteURL(page.url);
+		url.pathname = '/create';
+		url.searchParams.set('kind', next);
 		url.searchParams.delete('wf');
 		url.searchParams.delete('mode');
-		goto(url.pathname + url.search);
+		goto(resolve(createHref(url)));
 	}
 
 	const imageSlotTarget = $derived(
@@ -898,15 +908,60 @@
 				next[k] = v as string[];
 		}
 		if (slotBusy || submitting || revision !== actionRevision) return;
+		const stampedEndpoint = job.payload?.endpoint_id;
+		const reuseEndpoint =
+			typeof stampedEndpoint === 'string' &&
+			endpoints.some((ep) => ep.id === stampedEndpoint)
+				? stampedEndpoint
+				: (wf.endpoint_id ?? activeId ?? '');
+		if (wf.kind !== kind) {
+			const parts = JSON.parse(draftKey.slice('creative-draft:'.length));
+			parts[0] = wf.kind;
+			const targetKey = 'creative-draft:' + JSON.stringify(parts);
+			let saved: {
+				source?: string;
+				drafts?: Record<string, FormValues>;
+				endpoints?: Record<string, string>;
+			} = {};
+			try {
+				saved =
+					JSON.parse(readDeskDraft(targetKey + ':workflows') ?? '{}') ?? {};
+			} catch {
+				/* No prior draft. */
+			}
+			if (saved.source !== sourceFingerprint) saved = {};
+			writeDeskDraft(
+				targetKey + ':workflows',
+				JSON.stringify({
+					source: sourceFingerprint,
+					drafts: { ...saved.drafts, [wf.id]: next },
+					endpoints: { ...saved.endpoints, [wf.id]: reuseEndpoint },
+				}),
+			);
+			writeDeskDraft(
+				targetKey,
+				JSON.stringify({
+					workflowId: wf.id,
+					requestId: String(wf.id),
+					values: next,
+					source: sourceFingerprint,
+				}),
+			);
+			const url = new URL(page.url);
+			url.searchParams.set('kind', wf.kind);
+			url.searchParams.set('wf', String(wf.id));
+			await goto(resolve(createHref(url)));
+			return;
+		}
 		if (lastWf) workflowEndpoints.set(lastWf.id, endpointId);
 		endpointTouched = true;
-		endpointId =
-			workflowEndpoints.get(wf.id) ?? wf.endpoint_id ?? activeId ?? '';
+		endpointId = reuseEndpoint;
 		if (lastWf && lastWf.id !== wf.id)
 			workflowDrafts.set(lastWf.id, structuredClone($state.snapshot(values)));
 		workflowDrafts.set(wf.id, next);
 		workflowId = wf.id;
 		selectedJobId = job.id;
+		historyJobId = null;
 		workflowResults.set(wf.id, job.id);
 		lastWf = wf;
 		values = next;
@@ -980,8 +1035,10 @@
 	// stale rows — the toast just reports what happened.
 	// ------------------------------------------------------------------
 	let attachBusyId = $state<number | null>(null);
+	let storeJobId = $state<number | null>(null);
 
 	async function attachToProject(job: Job) {
+		if (!workbenchCtxOf(job)) { storeJobId = job.id; return; }
 		if (attachBusyId != null) return;
 		attachBusyId = job.id;
 		try {
@@ -1030,14 +1087,6 @@
 	// 键盘 (§四.8): Ctrl/⌘+Enter 生成 · / 聚焦搜索/提示词 · ↑↓/J/K 切换
 	// Ctrl/⌘+Enter 仅在创作输入区提交；Esc 退出选工具。媒体与记录使用显式控件。
 	// ------------------------------------------------------------------
-	function typing(target: EventTarget | null): boolean {
-		const el = target as HTMLElement | null;
-		return (
-			!!el &&
-			(el.isContentEditable ||
-				['INPUT', 'TEXTAREA', 'SELECT'].includes(el.tagName))
-		);
-	}
 
 	function inLayer(target: EventTarget | null): boolean {
 		const el = target instanceof Element ? target : null;
@@ -1104,10 +1153,17 @@
 {/snippet}
 
 <AppShell active={kind} title="创作台" workspace>
-	<div class="reference-desk" class:focused={focusMode}>
+	<div
+		class="reference-desk"
+		class:focused={focusMode}
+		style:--scene={kind === 'image' ? 'var(--sc-image)' : 'var(--sc-video)'}
+	>
 		<DeskWorkflowRail
 			{kind}
-			metas={deskMetas}
+			initialUsage={mode}
+			{historyCollapsed}
+			onToggleHistory={() => (historyCollapsed = !historyCollapsed)}
+			metas={allMetas.filter((m) => m.kind === kind)}
 			selectedId={workflowId}
 			{pendingCount}
 			onPick={pickWorkflow}
@@ -1117,28 +1173,53 @@
 		/>
 		<div class="refract-studio">
 			<header class="studio-heading">
-				<div class="heading-actions">
-					<button class="a-btn ghost sm" onclick={() => (historyOpen = true)}
-						>◷ 生成历史</button
-					><button id="desk-wf" class="model-selector" onclick={openBay}
-						>{currentWorkflow?.name ?? currentMeta?.name ?? '选择工作流'} ⌄</button
+				<div class="heading-actions workflow-identity">
+					<span class="fam-dot"
+						>{currentMeta?.model_family?.slice(0, 3) ??
+							(kind === 'image' ? '◈' : '▷')}</span
 					>
-				</div>
-				<div class="heading-actions">
-					{#if selectedJob && workbenchCtxOf(selectedJob) && selectedJob.status === 'done'}<button
-							class="a-btn secondary sm"
-							disabled={attachBusyId === selectedJob.id}
-							onclick={() => selectedJob && attachToProject(selectedJob)}
-							>保存到来源项目 ↗</button
+					<b id="desk-wf" class="model-selector"
+						>{currentWorkflow?.name ?? currentMeta?.name ?? '选择工作流'}</b
+					>
+					{#if currentMeta?.usage}<span class="a-tag"
+							>{usageLabel(currentMeta.usage)}</span
 						>{/if}
-					<button class="a-btn secondary sm" onclick={openParams}
-						>创作设置</button
-					><button class="a-btn ghost sm" onclick={toggleInspector}
-						>{focusMode ? '退出专注' : '专注创作'} ⤢</button
+				</div>
+				<span
+					class="workflow-file"
+					title={currentMeta?.source_path ?? '此工作流未记录源文件名'}
+					>{currentMeta?.source_path?.replaceAll('\\', '/').split('/').pop() ??
+						'源文件名未知'}</span
+				>
+				<div class="heading-actions">
+					<span
+						class="connection-status"
+						class:failed={connState.state === 'fail'}
 					>
+						<i class:connected={connState.state === 'ok'}></i>
+						{endpoints.find((e) => e.id === endpointId)?.name ?? '未选择连接'} · {connState.state ===
+							'ok' && connState.ms != null
+							? `${connState.ms}ms`
+							: connState.state === 'fail'
+								? '连接失败'
+								: '延迟未知'}
+					</span>
 				</div>
 			</header>
 			{@render ctxBanner()}
+			{#if historyJobId != null && selectedJob?.id === historyJobId}<div
+					class="history-banner"
+					role="status"
+				>
+					<span>正在查看历史 #{historyJobId} · 当前输入保持不变</span><button
+						class="a-btn ghost sm"
+						onclick={() => (historyJobId = null)}>返回当前创作</button
+					><button
+						class="a-btn secondary sm"
+						onclick={() => selectedJob && reuse(selectedJob)}
+						>复用到输入区</button
+					>
+				</div>{/if}
 			<div class="studio-layout">
 				<section class="viewer" aria-label="查看生成结果">
 					<div class="preview-area">
@@ -1157,6 +1238,10 @@
 								open={true}
 								inactive={false}
 								canSendToSlot={!!imageSlotTarget || !!imageList}
+								canAttach={!!selectedJob &&
+									selectedJob.status === 'done'}
+								attachBusy={attachBusyId === selectedJob?.id}
+								onAttach={() => selectedJob && attachToProject(selectedJob)}
 								{crossfade}
 								bind:videoEl
 								params={paramsTab}
@@ -1186,7 +1271,11 @@
 							</div>{/if}
 					</div>
 				</section>
-				<aside class="studio-form" aria-label="提示词、素材与参数">
+				<aside
+					bind:this={dockAnchor}
+					class="studio-form"
+					aria-label="提示词、素材与参数"
+				>
 					<Composer
 						bind:this={composer}
 						dock
@@ -1219,6 +1308,13 @@
 				</aside>
 			</div>
 		</div>
+		<HistoryRail
+			collapsed={historyCollapsed}
+			jobs={allJobs.filter((j) => j.kind === kind && !pendingIds.has(j.id))}
+			selectedId={selectedJob?.id ?? null}
+			onSelect={selectTake}
+			onExpand={() => (historyOpen = true)}
+		/>
 	</div>
 </AppShell>
 <Modal bind:open={bayOpen} size="xl" title="工作流说明与管理"
@@ -1264,9 +1360,9 @@
 							<ul>
 								{#if inputs.prompt}<li>
 										画面描述 · {inputs.prompt.required ? '必填' : '可选'}
-									</li>{/if}{#each inputs.slots as slot}<li>
+									</li>{/if}{#each inputs.slots as slot (slot.inp.nodeId)}<li>
 										{slot.label} · {slot.inp.required ? '必填' : '可选'}
-									</li>{/each}{#each inputs.lists as list}<li>
+									</li>{/each}{#each inputs.lists as list (list.nodeId)}<li>
 										{list.label} · {list.required ? '必填' : '可选'}{list.max
 											? '，最多 ' + list.max + ' 个'
 											: ''}
@@ -1332,26 +1428,34 @@
 </Modal>
 <Modal
 	bind:open={paramsOpen}
+	anchor={dockAnchor}
 	size="lg"
 	title="创作设置"
 	onclose={() => (paramDraft = null)}
 >
+	{#snippet headerActions()}<button
+			class="a-btn ghost sm"
+			onclick={resetParamDraft}>恢复工作流默认</button
+		>{/snippet}
 	{#snippet footer()}<div class="param-actions">
 			<span>保存后应用到当前工作流</span><button
 				class="a-btn secondary"
 				onclick={() => (paramsOpen = false)}>取消</button
-			><button class="a-btn purple" onclick={saveParams}>保存设置</button>
+			><button class="a-btn primary" onclick={saveParams}>保存设置</button>
 		</div>{/snippet}
 	<div class="reference-preferences">
+		<button class="a-btn ghost sm" onclick={toggleInspector}
+			>{focusMode ? '退出专注' : '专注创作'} ⤢</button
+		>
 		<div class="runtime-setting">
 			<label for="comfy-endpoint">使用哪台 ComfyUI</label><select
 				class="a-select"
 				id="comfy-endpoint"
 				bind:value={paramEndpoint}
 				>{#if !endpoints.length}<option value="">尚未配置服务</option
-					>{/if}{#each endpoints as ep}<option value={ep.id}>{ep.name}</option
+					>{/if}{#each endpoints as ep (ep.id)}<option value={ep.id}>{ep.name}</option
 					>{/each}</select
-			><a href="/connections">配置或检查连接 ↗</a>
+			><a href={resolve('/connections')}>配置或检查连接 ↗</a>
 		</div>
 		{@render paramsTab()}
 	</div>
@@ -1407,9 +1511,40 @@
 		justify-content: space-between;
 		align-items: center;
 		gap: 8px;
-		height: 44px;
+		height: var(--desk-head-height);
+		margin: 0 calc(-1 * var(--desk-head-inset));
+		padding: 0 var(--desk-head-inset);
+		box-sizing: border-box;
+		border-bottom: 1px solid var(--line);
+		background: var(--desk-head-bg);
+		backdrop-filter: blur(10px);
 		flex-shrink: 0;
 	}
+	@media (max-width: 1366px) {
+		.workflow-file {
+			display: none;
+		}
+	}
+	.history-banner {
+		display: flex;
+		align-items: center;
+		gap: 8px;
+		flex-shrink: 0;
+		padding: 6px 8px;
+		border: 1px solid var(--info);
+		border-radius: var(--r-pill);
+		color: var(--info);
+		font-size: 12.5px;
+		background: color-mix(in srgb, var(--bg-2) 92%, transparent);
+		backdrop-filter: blur(8px);
+		box-shadow: var(--sh-2);
+		align-self: center;
+		max-width: 100%;
+		box-sizing: border-box;
+	}
+	.history-banner span {
+		margin-right: auto;
+	}
 	.heading-actions {
 		display: flex;
 		align-items: center;
@@ -1420,22 +1555,71 @@
 		border: 0;
 		background: none;
 		color: var(--text-2);
-		padding: 6px 8px;
-		font-size: 12px;
-		cursor: pointer;
+		padding: 0;
+		font-size: var(--desk-head-name-size);
+		font-weight: var(--desk-head-name-weight);
+		line-height: var(--desk-head-name-line);
 		max-width: 320px;
 		white-space: nowrap;
 		overflow: hidden;
 		text-overflow: ellipsis;
 	}
-	.studio-heading :global(.a-btn) {
-		min-height: 28px;
-		font-size: 11px;
-		padding: 4px 8px;
+	.workflow-identity {
+		flex-shrink: 1;
+	}
+	.fam-dot {
+		width: 22px;
+		height: 22px;
+		flex-shrink: 0;
+		border-radius: var(--desk-search-radius);
+		display: grid;
+		place-items: center;
+		font: 700 9px var(--mono);
+		color: var(--bg-1);
+		background: var(--scene);
+	}
+	.workflow-file {
+		font: 11px var(--mono);
+		color: var(--tx-3);
+		max-width: 260px;
+		min-width: 0;
+		overflow: hidden;
+		text-overflow: ellipsis;
+		white-space: nowrap;
+		margin-right: auto;
+	}
+	.connection-status {
+		display: inline-flex;
+		align-items: center;
+		gap: 6px;
+		font-size: 12px;
+		height: 26px;
+		padding: 0 10px;
+		border-radius: var(--desk-connection-radius);
+		border: 1px solid var(--line);
+		background: var(--bg-2);
+		color: var(--tx-2);
+		white-space: nowrap;
+		max-width: 260px;
+		overflow: hidden;
+		text-overflow: ellipsis;
+	}
+	.connection-status i {
+		width: 6px;
+		height: 6px;
+		border-radius: 50%;
+		background: var(--tx-3);
+		flex-shrink: 0;
+	}
+	.connection-status i.connected {
+		background: var(--ok);
+	}
+	.connection-status.failed i {
+		background: var(--err);
 	}
 	.studio-layout {
 		display: grid;
-		grid-template-rows: minmax(0, 1fr) 190px;
+		grid-template-rows: minmax(0, 1fr) auto;
 		gap: 12px;
 		flex: 1;
 		min-height: 0;
@@ -1462,7 +1646,7 @@
 		gap: 12px;
 		border: 1px solid var(--line);
 		border-radius: 12px;
-		background: radial-gradient(ellipse at 50% 20%, #202028, #131316 70%);
+		background: var(--bg-1);
 	}
 	.desk-welcome h1 {
 		font-size: 24px;
@@ -1542,12 +1726,9 @@
 	}
 	@media (max-height: 740px) {
 		.studio-layout {
-			grid-template-rows: minmax(0, 1fr) 172px;
+			grid-template-rows: minmax(0, 1fr) auto;
 			gap: 10px;
 		}
-		.refract-studio {
-			padding-bottom: 10px;
-		}
 	}
 	@media (max-width: 1100px) {
 		.refract-studio {
@@ -1675,3 +1856,5 @@
 		color: var(--text-3);
 	}
 </style>
+
+<StoreResultModal jobId={storeJobId} onclose={()=>storeJobId=null} />

calliope-web/src/lib/components/desk/TaskModeRail.svelte

@@ -18,11 +18,8 @@
 
 	let { kind, metas, active, onSelect, onPickWorkflow }: Props = $props();
 
-	interface ModeEntry {
-		usage: WorkflowUsage;
-		count: number;
-	}
 	const modes = $derived.by(() => {
+		// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Local counting accumulator is consumed synchronously into mode rows; metas/kind drive the derivation.
 		const counts = new Map<WorkflowUsage, number>();
 		for (const m of metas) {
 			if (!m.usage) continue;

calliope-web/src/lib/components/desk/WorkflowBay.svelte

@@ -1,4 +1,6 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
+ import { isWorkflowRunnable } from '$lib/workflowState';
 	import { tick } from 'svelte';
 	import { createQuery, useQueryClient } from '@tanstack/svelte-query';
 	import { workflows, settings, apiErrorMessage } from '$lib/api';
@@ -25,7 +27,6 @@
 		pendingCount,
 		selectedId,
 		activeId = $bindable(null),
-		endpoints,
 		onPick,
 		onClose,
 		catalogue = false,
@@ -127,7 +128,7 @@
 	}
 	function pick(m: WorkflowMeta) {
 		if (onPreview) onPreview(m.id);
-		else if (m.is_enabled && !m.needs_mapping && m.usage) onPick(m.id);
+		else if (isWorkflowRunnable(m)) onPick(m.id);
 	}
 	function move(delta: number) {
 		const i = Math.max(
@@ -173,7 +174,7 @@
 				recentOnly = false;
 			}}><span>全部工具</span><small>{metas.length}</small></button
 		>
-		{#each categories as cat}<button
+		{#each categories as cat (cat)}<button
 				class:active={category === cat}
 				onclick={() => {
 					category = cat;
@@ -217,9 +218,9 @@
 				>{/if}{#if source === 'local'}<select aria-label="筛选创作任务" bind:value={usage}
 					><option value="all">所有创作任务</option>{#each [...new Set(metas
 								.map((m) => m.usage)
-								.filter(Boolean))] as u}<option value={u!}>{usageLabel(u!)}</option>{/each}</select
+								.filter(Boolean))] as u (u)}<option value={u!}>{usageLabel(u!)}</option>{/each}</select
 				><select aria-label="筛选模型家族" bind:value={family}
-					><option value="all">全部模型</option>{#each families as f}<option value={f}>{f}</option
+					><option value="all">全部模型</option>{#each families as f (f)}<option value={f}>{f}</option
 						>{/each}</select
 				>{/if}<span>{source === 'local' ? filtered.length : cloudModels.length} 个结果</span>
 		</div>
@@ -228,14 +229,14 @@
 				<div class="cloud-context">
 					<h3>让专业搭档加入创作。</h3>
 					<p>使用已配置模型，在智能体或画布中创作。自定义多媒体接口与技能可在设置中管理。</p>
-					<a href="/canvas" class="a-btn primary">打开创作画布 ↗</a>
+					<a href={resolve('/canvas')} class="a-btn primary">打开创作画布 ↗</a>
 				</div>
-				{#each cloudModels as profile}<article class="workflow-card">
+				{#each cloudModels as profile (profile.id)}<article class="workflow-card">
 						<div class="family">{profile.model}<span>已配置模型</span></div>
 						<h3>{profile.name}</h3>
-						<a href="/agents" class="tool-link">交给智能体创作 ↗</a>
+						<a href={resolve('/agents')} class="tool-link">交给智能体创作 ↗</a>
 					</article>{:else}<p class="empty">
-						还没有匹配的模型。<a href="/models">配置模型 ↗</a>
+						还没有匹配的模型。<a href={resolve('/models')}>配置模型 ↗</a>
 					</p>{/each}
 			{:else}
 				{#each visible as m (m.id)}<article
@@ -272,7 +273,7 @@
 							onclick={() => favorite(m)}>{m.favorite ? '★' : '☆'}</button
 						>
 						{#if m.needs_mapping || !m.is_enabled || !m.usage}<a
-								href="/workflows?manage=1"
+								href={resolve('/workflows?manage=1')}
 								class="tool-link">{m.needs_mapping ? '完成映射' : '管理工作流'} ↗</a
 							>{/if}
 					</article>{:else}<p class="empty">没有找到匹配的工作流，试试更短的关键词。</p>{/each}
@@ -284,7 +285,7 @@
 			{/if}
 		</div>
 		{#if pendingCount > 0}<p class="pending">
-				另有 {pendingCount} 个工作流待映射。<a href="/workflows?manage=1">去整理 ↗</a>
+				另有 {pendingCount} 个工作流待映射。<a href={resolve('/workflows?manage=1')}>去整理 ↗</a>
 			</p>{/if}
 	</section>
 </div>

calliope-web/src/lib/components/desk/draftCache.ts

@@ -0,0 +1,17 @@
+// Same-tab fallback for browsers that deny session storage. No user data leaves the browser.
+const drafts = new Map<string, string>();
+export function readDeskDraft(key: string): string | null {
+  try {
+    return sessionStorage.getItem(key) ?? drafts.get(key) ?? null;
+  } catch {
+    return drafts.get(key) ?? null;
+  }
+}
+export function writeDeskDraft(key: string, value: string) {
+  drafts.set(key, value);
+  try {
+    sessionStorage.setItem(key, value);
+  } catch {
+    /* In-memory switching still works. */
+  }
+}

calliope-web/src/lib/components/generate/Composer.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import Modal from '$lib/components/ui/Modal.svelte';
 	import { tick } from 'svelte';
 	import { assetUrl } from '$lib/api';
@@ -63,7 +64,6 @@
 		slotBusy = $bindable(false),
 		promptEl = $bindable(null),
 		onSet,
-		onOpenBay,
 		onPickEndpoint,
 		onSubmit,
 		onReveal,
@@ -73,6 +73,7 @@
 	}: Props = $props();
 
 	let mediaOpen = $state(false);
+	let expanded = $state(false);
 	let popoverInputs = $state<ComfyDynamicInput[]>([]);
 	let popoverAnchor = $state<HTMLElement | null>(null);
 	export function openMedia() {
@@ -138,7 +139,7 @@
 	}
 </script>
 
-<div class="composer-wrap" class:dock>
+<div class="composer-wrap" class:dock class:expanded>
 	<!-- svelte-ignore a11y_no_static_element_interactions -->
 	<div
 		bind:this={root}
@@ -157,10 +158,14 @@
 		<div class="composer-scroll" aria-label="创作输入">
 			{@render header?.()}
 			{#if current}
-				<section class="input-section prompt-section">
+				<section
+					class="input-section prompt-section"
+					class:has-slots={dock && hasSlots}
+				>
 					<h3>2 · 准备这次创作</h3>
 					{#if hasSlots && !dock}<div class="slots">
 							<SlotTray
+				allowScene={current?.kind === 'video'}
 								bind:this={tray}
 								bind:busy={slotBusy}
 								{ds}
@@ -171,9 +176,9 @@
 								{onFromResults}
 							/>
 						</div>{/if}
-					{#if dock}<div class="media-summary">
+					{#if dock}<div class="media-summary" class:has-slots={hasSlots}>
 							{#if hasSlots}
-								{#each ds.slots.slice(0, 4) as slot}<button
+								{#each ds.slots.slice(0, 3) as slot (slot.inp.nodeId)}<button
 										class="media-token"
 										onclick={openMedia}
 										aria-label={'设置' + slot.label}
@@ -186,20 +191,36 @@
 									</button>{/each}
 								{#if ds.lists.length}<button
 										class="media-token"
-										onclick={openMedia}>＋ 参考材料</button
+										onclick={openMedia}
+										>＋ 参考材料 {ds.lists.reduce(
+											(n, g) =>
+												n +
+												(Array.isArray(values[g.nodeId])
+													? (values[g.nodeId] as string[]).length
+													: 0),
+											0,
+										)}</button
 									>{/if}
-								<button class="media-token" onclick={openMedia}
+								<button class="expand-prompt manage-media" onclick={openMedia}
 									>{slotBusy ? '正在上传…' : '管理素材'}</button
 								>
-							{:else}<small>描述你的画面</small>{/if}
-							<small class="input-shortcut">Ctrl + Enter 生成</small>
+							{/if}
 						</div>{/if}
 					<div class="prompt-pair" class:dual={dock && !!ds.negative}>
 						{#if ds.prompt}<div class="prompt-field">
-								<label for="desk-prompt"
-									>{ds.negative ? '正向提示词' : '提示词'}
-									{#if ds.prompt.required}<span>必填</span>{/if}</label
-								><textarea
+								<div class="prompt-label">
+									<label for="desk-prompt"
+										>{ds.negative ? '正向提示词' : '提示词'}
+										{#if ds.prompt.required}<span>必填</span>{/if}</label
+									>
+									<button
+										class="expand-prompt"
+										aria-expanded={expanded}
+										onclick={() => (expanded = !expanded)}
+										>{expanded ? '收起提示词' : '展开提示词'}</button
+									>
+								</div>
+								<textarea
 									bind:this={promptEl}
 									id="desk-prompt"
 									class="prompt"
@@ -293,9 +314,9 @@
 						onchange={(e) => onPickEndpoint(e.currentTarget.value)}
 					>
 						{#if !endpoints.length}<option value="">尚未配置服务</option>{/if}
-						{#each endpoints as ep}<option value={ep.id}>{ep.name}</option
+						{#each endpoints as ep (ep.id)}<option value={ep.id}>{ep.name}</option
 							>{/each}
-					</select><a href="/connections" target="_blank" rel="noreferrer"
+					</select><a href={resolve('/connections')} target="_blank" rel="noreferrer"
 						>配置或检查连接 ↗</a
 					>
 				</details>{/if}
@@ -306,7 +327,7 @@
 						>✦ {endpointName}⌄</button
 					>{#each commonInputs
 						.filter((i) => i !== ds.height)
-						.slice(0, 3) as inp}<button
+						.slice(0, 3) as inp (inp.nodeId)}<button
 							class="parameter"
 							onclick={(e) => openParameter(inp, e.currentTarget)}
 							>{inp.label}: {String(
@@ -333,7 +354,7 @@
 				disabled={!!block || submitting || slotBusy}
 				onclick={onSubmit}
 			>
-				<Icon name="sparkle" size={16} />{submitting
+				<Icon name="sparkle" size={14} />{submitting
 					? '正在提交…'
 					: slotBusy
 						? '正在上传素材…'
@@ -354,6 +375,7 @@
 	>
 		<div class="media-editor">
 			<SlotTray
+				allowScene={current?.kind === 'video'}
 				bind:this={tray}
 				bind:busy={slotBusy}
 				{ds}
@@ -482,7 +504,7 @@
 		background: var(--surface);
 		display: grid;
 		gap: 10px;
-		box-shadow: 0 -8px 20px #292a2d05;
+		box-shadow: var(--sh-1);
 	}
 	.gen {
 		width: 100%;
@@ -520,24 +542,26 @@
 	}
 
 	.dock {
-		height: 100%;
+		height: auto;
 		min-height: 0;
 	}
 	.dock .composer {
-		height: 100%;
+		height: auto;
 		min-height: 0;
-		border: 1px solid #f5b04246;
-		border-radius: 16px;
-		background: linear-gradient(125deg, #1b1a1d, #17161a);
+		border: 1px solid var(--line-2);
+		border-radius: var(--desk-dock-radius);
+		background: var(--composer-bg);
 		overflow: hidden;
-		box-shadow: inset 0 0 0 1px #f5b04206;
+		box-shadow: var(--desk-dock-shadow);
 	}
 	.dock .composer:focus-within {
-		border-color: #f5b04280;
+		border-color: color-mix(in srgb, var(--gold) 45%, transparent);
+		box-shadow: var(--desk-dock-focus);
 	}
 	.dock .composer-scroll {
-		padding: 9px 14px 4px;
-		overflow: hidden;
+		scrollbar-gutter: auto;
+		padding: 0;
+		overflow: auto;
 		display: flex;
 		flex-direction: column;
 	}
@@ -557,50 +581,65 @@
 		display: flex;
 		align-items: center;
 		gap: 6px;
-		height: 28px;
-		margin-bottom: 6px;
+		min-height: 0;
+		margin: 0;
 		flex-shrink: 0;
 		overflow: auto;
 	}
-	.media-summary > small {
-		color: var(--text-3);
-		font-size: 10px;
-		white-space: nowrap;
+
+	.dock .input-section.has-slots {
+		display: grid;
+		grid-template-columns: minmax(0, var(--desk-slot-column)) minmax(0, 1fr);
+		gap: 0;
+	}
+	.has-slots .media-summary {
+		align-self: start;
+		flex-wrap: wrap;
+		margin: 0;
+		padding: 10px 12px 8px;
+		border-right: 1px solid var(--line);
 	}
 	.media-token {
 		display: flex;
 		align-items: center;
 		gap: 5px;
-		background: #ffffff04;
-		border: 1px dashed #ffffff25;
+		background: var(--bg-2);
+		border: 1px dashed var(--line-3);
 		border-radius: 6px;
 		padding: 3px 7px;
 		font-size: 10px;
 		color: var(--text-2);
 		cursor: pointer;
 		white-space: nowrap;
-		height: 26px;
+		height: var(--slot-size);
 	}
 	.media-token img {
-		height: 20px;
-		width: 20px;
+		height: 36px;
+		width: 36px;
 		object-fit: cover;
 		border-radius: 3px;
 	}
-	.input-shortcut {
+	.expand-prompt {
 		margin-left: auto;
+		flex-shrink: 0;
+		border: 0;
+		background: none;
+		color: var(--tx-2);
+		font-size: 11px;
+		cursor: pointer;
 	}
 	.dock .prompt-pair {
 		display: grid;
 		grid-template-columns: minmax(0, 1fr);
 		min-height: 0;
 		flex: 1;
-		gap: 18px;
+		gap: 0;
 	}
 	.dock .prompt-pair.dual {
-		grid-template-columns: minmax(0, 1fr) minmax(0, 0.65fr);
+		grid-template-columns: minmax(0, 1.35fr) minmax(0, 1fr);
 	}
 	.dock .prompt-field {
+		padding: 10px 14px 6px;
 		display: flex;
 		flex-direction: column;
 		min-height: 0;
@@ -608,32 +647,41 @@
 	}
 	.dock .negative {
 		border-left: 1px solid var(--line);
-		padding-left: 18px;
 	}
 	.dock .prompt-field label {
-		font-size: 10px;
+		font-size: 11.5px;
+		height: 20px;
 		color: var(--text-3);
-		margin: 0 0 4px;
+		margin: 0;
 		display: flex;
 		gap: 6px;
 	}
+	.prompt-label {
+		display: flex;
+		align-items: center;
+		justify-content: space-between;
+		height: 20px;
+	}
 	.dock .prompt-field:first-child label {
-		color: #d0b37d;
+		color: var(--tx-2);
 	}
 	.dock .prompt {
 		background: none;
 		border: 0;
 		border-radius: 0;
 		padding: 0;
-		font-size: 12px;
+		font-size: var(--fs-body);
 		line-height: 1.6;
 		resize: none;
 		min-height: 0;
 		max-height: none;
-		height: 100%;
-		flex: 1;
+		height: var(--prompt-height);
+		flex: none;
 		overflow: auto;
 	}
+	.dock.expanded .prompt {
+		height: var(--prompt-expanded);
+	}
 	.dock .prompt:focus {
 		outline: 0;
 	}
@@ -645,15 +693,18 @@
 		margin-top: 3px;
 	}
 	.dock .prompt-counter {
-		display: none;
+		height: 22px;
+		align-items: center;
+		font-size: 11px;
+		margin-top: 4px;
 	}
 	.dock .submit {
 		display: flex;
 		flex-wrap: nowrap;
 		align-items: center;
 		gap: 8px;
-		padding: 7px 14px;
-		height: 45px;
+		padding: 8px 10px 10px 12px;
+		height: 57px;
 		box-sizing: border-box;
 		background: none;
 		border-top: 1px solid var(--line);
@@ -668,12 +719,12 @@
 		overflow: auto;
 	}
 	.parameter {
-		background: #25242a;
-		border: 1px solid #ffffff07;
+		background: var(--bg-3);
+		border: 1px solid var(--line);
 		border-radius: 7px;
 		padding: 5px 8px;
 		font-size: 10px;
-		color: #c4c2cb;
+		color: var(--tx-2);
 		cursor: pointer;
 		white-space: nowrap;
 		max-width: 180px;
@@ -682,20 +733,18 @@
 		flex-shrink: 0;
 	}
 	.parameter:hover {
-		border-color: #f5b04255;
+		border-color: var(--line-3);
 	}
 	.dock .gen {
-		width: auto;
-		min-height: 32px;
-		font-size: 11px;
-		padding: 7px 18px;
-		border-radius: 20px;
+		width: var(--desk-gen-width);
+		height: var(--desk-gen-height);
+		min-height: var(--desk-gen-height);
+		font-size: 14px;
+		font-weight: var(--desk-gen-weight);
+		padding: 0 16px;
+		border-radius: var(--desk-gen-radius);
 		margin-left: auto;
 		flex-shrink: 0;
-		background: linear-gradient(140deg, #ffc65e, #f5b042);
-		color: #30210c;
-		border-color: #edb458;
-		box-shadow: 0 3px 12px #f5b04217;
 	}
 	.dock .why {
 		position: absolute;
@@ -704,14 +753,14 @@
 		max-width: 65%;
 		padding: 3px 8px;
 		border-radius: 5px;
-		background: #241e17;
+		background: var(--bg-2);
 		font-size: 10px;
 		color: var(--warn);
 		z-index: 1;
 	}
 	.dock .why.err {
 		color: var(--err);
-		background: #241717;
+		background: var(--bg-2);
 	}
 	.dock .ready {
 		display: none;

calliope-web/src/lib/components/generate/ContextBar.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import Icon from '$lib/components/ui/Icon.svelte';
 	import { t } from '$lib/i18n.svelte';
 	import { backHref, type DeskContext } from './context';
@@ -29,7 +30,7 @@
 	<span class="note">
 		{canFlowBack ? t('desk.ctxBackfill', { stage: stageName }) : t('desk.ctxNoBackfill', { stage: stageName })}
 	</span>
-	<a class="a-btn ghost xs back" href={backHref(ctx)}>{t('desk.ctxBack', { stage: stageName })}</a>
+	<a class="a-btn ghost xs back" href={resolve(backHref(ctx))}>{t('desk.ctxBack', { stage: stageName })}</a>
 	<button type="button" class="a-btn ghost xs" aria-label={t('desk.ctxDismiss')} onclick={onDismiss}>
 		<Icon name="close" size={12} />
 	</button>

calliope-web/src/lib/components/generate/Inspector.svelte

@@ -62,7 +62,6 @@
 		open,
 		inactive,
 		canSendToSlot,
-		crossfade,
 		videoEl = $bindable(null),
 		params,
 		onClose,
@@ -337,7 +336,7 @@
 						</button>
 					{/if}
 					{#if output}
-						<a class="a-btn secondary sm" href={assetUrl(output)} download>{t('desk.download')}</a>
+						<a class="a-btn secondary sm" href={assetUrl(output)} download rel="external">{t('desk.download')}</a>
 					{/if}
 					{#if output && video}
 						<button

calliope-web/src/lib/components/generate/SceneCapturePicker.svelte

@@ -0,0 +1,110 @@
+<script lang="ts">
+  import { resolve } from "$app/paths";
+  import { assetUrl } from "$lib/api";
+  import { shotApi, type Capture } from "$lib/shot/api";
+  import Modal from "$lib/components/ui/Modal.svelte";
+  import { toast } from "$lib/toast";
+
+  let {
+    open = $bindable(false),
+    onPick,
+  }: { open?: boolean; onPick: (path: string) => void } = $props();
+  let compositions = $state<Array<{ id: number; title: string }>>([]);
+  let compositionId = $state("");
+  let captures = $state<Capture[]>([]);
+  let loading = $state(false);
+  let request = 0;
+  $effect(() => {
+    if (!open) {
+      request++;
+      return;
+    }
+    const version = ++request;
+    loading = true;
+    shotApi
+      .listCompositions()
+      .then((rows) => {
+        if (version !== request) return;
+        compositions = rows;
+        compositionId = rows.length ? String(rows[0].id) : "";
+      })
+      .catch((error) => toast.error(String(error)))
+      .finally(() => {
+        if (version === request) loading = false;
+      });
+  });
+  $effect(() => {
+    if (!open || !compositionId) {
+      captures = [];
+      return;
+    }
+    const id = Number(compositionId);
+    let active = true;
+    captures = [];
+    shotApi.listCaptures(id).then((rows) => {
+      if (active)
+        captures = rows.filter((c) => c.kind === "image" && c.file_path);
+    });
+    return () => {
+      active = false;
+    };
+  });
+</script>
+
+<Modal bind:open title="从三维搭景截取">
+  <p>选择已保存的搭景截图，填入当前工作流声明的图片槽。</p>
+  <a
+    class="a-btn secondary sm"
+    href={resolve("/build-scene")}
+    target="_blank"
+    rel="noopener">打开三维搭景</a
+  >
+  {#if loading}<p>正在读取截图…</p>{:else if !compositions.length}<p>
+      暂无搭景，请先保存截图。
+    </p>{:else}
+    <label class="field"
+      ><span class="field-label">场景</span><select
+        class="field-input"
+        bind:value={compositionId}
+        >{#each compositions as comp (comp.id)}<option value={String(comp.id)}
+            >{comp.title}</option
+          >{/each}</select
+      ></label
+    >
+    <div class="capture-choices">
+      {#each captures as capture (capture.id)}<button
+          class="a-btn secondary"
+          onclick={() => {
+            if (capture.file_path) {
+              onPick(capture.file_path);
+              open = false;
+            }
+          }}
+          ><img
+            src={assetUrl(capture.file_path) ?? ""}
+            alt={capture.label ?? "搭景截图"}
+          /><span>{capture.label ?? `截图 ${capture.id}`}</span></button
+        >{:else}<p>该场景暂无图片截图。</p>{/each}
+    </div>{/if}
+</Modal>
+
+<style>
+  .capture-choices {
+    display: grid;
+    grid-template-columns: repeat(3, minmax(0, 1fr));
+    gap: var(--sp-4);
+    margin-top: var(--sp-5);
+  }
+  .capture-choices button {
+    display: flex;
+    flex-direction: column;
+    padding: var(--sp-3);
+    height: auto;
+    white-space: normal;
+  }
+  .capture-choices img {
+    width: 100%;
+    aspect-ratio: 16/9;
+    object-fit: contain;
+  }
+</style>

calliope-web/src/lib/components/generate/SlotTray.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import SceneCapturePicker from './SceneCapturePicker.svelte';
 	import MediaSlot from '$lib/components/studio/MediaSlot.svelte';
 	import RefImageGrid from '$lib/components/studio/RefImageGrid.svelte';
 	import { mediaFileProblem } from '$lib/comfy/imageFile';
@@ -16,6 +17,7 @@
 	 */
 	interface Props {
 		ds: DeskSchema;
+		allowScene?: boolean;
 		values: FormValues;
 		showErrors: boolean;
 		errors: Record<string, string>;
@@ -25,7 +27,34 @@
 		onFromResults: (nodeId: string) => void;
 	}
 
-	let { ds, values, showErrors, errors, busy = $bindable(false), onSet, onFromResults }: Props = $props();
+	let { ds, allowScene = false, values, showErrors, errors, busy = $bindable(false), onSet, onFromResults }: Props = $props();
+
+  let sceneOpen = $state(false);
+  let sceneNode = $state("");
+  $effect(() => {
+    void ds;
+    sceneOpen = false;
+    sceneNode = "";
+  });
+  function pickScene(path: string) {
+    const slot = ds.slots.find(
+      (s) => s.inp.nodeId === sceneNode && s.mediaKind === "image" && !s.mask,
+    );
+    const list = ds.lists.find(
+      (g) => g.nodeId === sceneNode && g.kind === "image_list",
+    );
+    if (!allowScene) return;
+    if (slot) onSet(sceneNode, path);
+    else if (list) {
+      const paths = listPaths(values, list);
+      if (paths.length >= (list.max ?? 9)) {
+        toast.error("参考图数量已达上限");
+        return;
+      }
+      onSet(sceneNode, [...paths, path]);
+    }
+  }
+
 
 	const uploads = createUploadManager();
 	type Reject = { name: string; message: string };
@@ -116,7 +145,9 @@
 
 	/** Composer-wide drop: each file goes to the first wired slot of its kind with room. */
 	export function dropFiles(files: File[]) {
+		// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Per-drop allocation buffer, synchronously consumed into groupAdd calls; no collection state survives this invocation.
 		const pending = new Map<string, File[]>();
+		// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Per-drop reservation set prevents assigning two files to one slot before async upload completes; never used as render state.
 		const taken = new Set<string>();
 		let unplaced = 0;
 		for (const f of files) {
@@ -147,6 +178,7 @@
 		if (unplaced) toast.error(t('desk.dropNoSlot', { n: unplaced }));
 	}
 </script>
+<SceneCapturePicker bind:open={sceneOpen} onPick={pickScene}/>
 
 {#if ds.slots.length || ds.lists.length}
 	<div class="tray">
@@ -167,6 +199,7 @@
 				anchorId={`slot-${s.inp.nodeId}`}
 				onFile={(f) => slotFile(s, f)}
 				onFromResults={() => onFromResults(s.inp.nodeId)}
+				onFromScene={allowScene && s.mediaKind === "image" && !s.mask ? () => { sceneNode = s.inp.nodeId; sceneOpen = true; } : undefined}
 				onClear={() => {
 					setRejects(s.inp.nodeId, []);
 					onSet(s.inp.nodeId, '');
@@ -191,6 +224,7 @@
 				onReplace={(i, file) => groupReplace(entry, i, file)}
 				onRemove={(i) => onSet(entry.nodeId, listPaths(values, entry).filter((_, j) => j !== i))}
 				onDismissReject={(i) => setRejects(entry.nodeId, (rejects[entry.nodeId] ?? []).filter((_, j) => j !== i))}
+				onFromScene={allowScene && entry.kind === "image_list" ? () => { sceneNode = entry.nodeId; sceneOpen = true; } : undefined}
 				onFromResults={entry.kind === 'image_list' ? () => onFromResults(entry.nodeId) : undefined}
 			/>
 		{/each}

calliope-web/src/lib/components/generate/StoreResultModal.svelte

@@ -0,0 +1,65 @@
+<script lang="ts">
+  import { createQuery, useQueryClient } from "@tanstack/svelte-query";
+  import Modal from "$lib/components/ui/Modal.svelte";
+  import { agentApi, resultsApi, type WorkbenchStageKey } from "$lib/api";
+  import { toast } from "$lib/toast";
+  let { jobId, onclose }: { jobId: number | null; onclose: () => void } =
+    $props();
+  const client = useQueryClient();
+  const projects = createQuery({
+    queryKey: ["b4-projects"],
+    queryFn: agentApi.listLinkableProjects,
+  });
+  let projectId = $state<number | null>(null);
+  let stage = $state<WorkbenchStageKey>("assets");
+  let busy = $state(false),
+    error = $state("");
+  async function store() {
+    if (!jobId || !projectId || busy) return;
+    busy = true;
+    error = "";
+    try {
+      const res = await resultsApi.store({
+        job_id: jobId,
+        project_id: projectId,
+        stage_key: stage,
+      });
+      await client.invalidateQueries({ queryKey: ["workbench", projectId] });
+      toast.success(
+        res.already_attached
+          ? "该结果已存入此阶段"
+          : "已存入项目草稿，等待确认",
+      );
+      onclose();
+    } catch (e) {
+      error = e instanceof Error ? e.message : String(e);
+    } finally {
+      busy = false;
+    }
+  }
+</script>
+
+<Modal open={jobId != null} title="存入项目草稿" {onclose} dismissible={!busy}>
+  <p>选择项目和阶段，结果将在该阶段等待确认。</p>
+  <label class="field"
+    >项目<select aria-label="存入项目" bind:value={projectId}
+      ><option value={null}>选择项目</option
+      >{#each $projects.data ?? [] as p (p.id)}<option value={p.id}
+          >{p.title}</option
+        >{/each}</select
+    ></label
+  >
+  <label class="field"
+    >阶段<select aria-label="存入阶段" bind:value={stage}
+      >{#each [["script", "剧本创作"], ["style", "视觉设计"], ["storyboard", "分镜设计"], ["assets", "素材资产"], ["shot", "镜头脚本"]] as [value, label] (value)}<option
+          {value}>{label}</option
+        >{/each}</select
+    ></label
+  >
+  {#if error}<p role="alert">{error}</p>{/if}
+  {#snippet footer()}<button class="a-btn" disabled={busy} onclick={onclose}
+      >取消</button
+    ><button class="a-btn primary" disabled={!projectId || busy} onclick={store}
+      >存入待确认草稿</button
+    >{/snippet}
+</Modal>

calliope-web/src/lib/components/generate/TakeCard.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import Icon from '$lib/components/ui/Icon.svelte';
 	import { assetUrl } from '$lib/api';
 	import type { Job, Workflow } from '$lib/comfy/types';
@@ -104,7 +105,7 @@
 		!!job.workbench_attach && !!wbCtx && job.workbench_attach.target_id === wbCtx.sourceId,
 	);
 	const canAttach = $derived(
-		!!onAttach && !!wbCtx && !attached && st.tone === 'ok' && !fileGone && !!output,
+		!!onAttach && !attached && st.tone === 'ok' && !fileGone && !!output,
 	);
 
 	let portrait = $state(false);
@@ -205,7 +206,7 @@
 					<span class="a-tag ok" title={t('desk.attachHint', { label: wbCtx.label ?? '' })}>
 						{t('desk.attachedTag')}
 					</span>
-					<a class="a-btn ghost xs" href={`/workbench/${wbCtx.projectId}?stage=${wbCtx.stage}`}>
+					<a class="a-btn ghost xs" href={resolve(`/workbench/${wbCtx.projectId}?stage=${wbCtx.stage}`)}>
 						{t('desk.attachBack')}
 					</a>
 				{/if}
@@ -217,7 +218,7 @@
 					<button type="button" class="a-btn ghost xs" disabled={busy} onclick={onCancel}>{t('common.cancel')}</button>
 				{/if}
 				{#if output}
-					<a class="a-btn ghost xs" href={assetUrl(output)} download>{t('desk.download')}</a>
+					<a class="a-btn ghost xs" href={assetUrl(output)} download rel="external">{t('desk.download')}</a>
 				{/if}
 				{#if !active}
 					<button type="button" class="a-btn danger xs" onclick={onDelete}>{t('studio.deleteBtn')}</button>

calliope-web/src/lib/components/generate/TakeFeed.svelte

@@ -125,6 +125,7 @@
 	// Entrance bookkeeping: only takes that appear AFTER the first fill
 	// (or come back from an undo) play the 220ms rise.
 	// ------------------------------------------------------------------
+	// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Nonreactive entrance ledger read/written in the jobs effect and markEnter; keep bookkeeping outside effect dependencies, with animateIds driving classes.
 	const seenIds = new Set<number>();
 	const animateIds = new SvelteSet<number>();
 	let hydrated = false;

calliope-web/src/lib/components/generate/context.ts

@@ -1,5 +1,5 @@
-import type { WorkbenchStageKey } from '$lib/api';
-import type { DeskKind } from './schema';
+import type { WorkbenchStageKey } from "$lib/api";
+import type { DeskKind } from "./schema";
 
 /**
  * 五段创作 → 生成台 handoff, carried in the URL so a reload keeps it.
@@ -8,100 +8,119 @@ import type { DeskKind } from './schema';
  * finished take can be flowed back to its source row (HEL-684).
  */
 export interface DeskContext {
-	kind: DeskKind;
-	projectId: number;
-	stage: WorkbenchStageKey;
-	/** Human label of the source row, e.g. 镜头 S1 / 角色「林夏」. */
-	label: string;
-	prompt?: string;
-	negative?: string;
-	durationSec?: number;
-	/** Real source row identity — only present on links the workbench
-	 * stamped with it; without it no flow-back is offered (nothing guessed). */
-	sourceKind?: 'asset' | 'shot';
-	sourceId?: string;
+  kind: DeskKind;
+  projectId: number;
+  stage: WorkbenchStageKey;
+  /** Human label of the source row, e.g. 镜头 S1 / 角色「林夏」. */
+  label: string;
+  prompt?: string;
+  negative?: string;
+  durationSec?: number;
+  /** Real source row identity — only present on links the workbench
+   * stamped with it; without it no flow-back is offered (nothing guessed). */
+  sourceKind?: "asset" | "shot";
+  sourceId?: string;
 }
 
 /** The generate-request context payload shape (HEL-684). */
 export interface DeskWorkbenchContext {
-	project_id: number;
-	stage: 'assets' | 'shot';
-	source_kind: 'asset' | 'shot';
-	source_id: string;
-	label?: string;
+  project_id: number;
+  stage: "assets" | "shot";
+  source_kind: "asset" | "shot";
+  source_id: string;
+  label?: string;
 }
 
-const STAGES: WorkbenchStageKey[] = ['script', 'style', 'storyboard', 'assets', 'shot'];
+const STAGES: WorkbenchStageKey[] = [
+  "script",
+  "style",
+  "storyboard",
+  "assets",
+  "shot",
+];
 
 /** Stage ↔ desk kind pairing the workbench rows render (assets → image,
  * shot → video). Anything else cannot display a flowed-back take. */
 const KIND_BY_STAGE: Partial<Record<WorkbenchStageKey, DeskKind>> = {
-	assets: 'image',
-	shot: 'video',
+  assets: "image",
+  shot: "video",
 };
 
-export function deskHref(ctx: DeskContext): string {
-	const q = new URLSearchParams({
-		from: 'workbench',
-		project: String(ctx.projectId),
-		stage: ctx.stage,
-		label: ctx.label,
-	});
-	if (ctx.prompt) q.set('prompt', ctx.prompt);
-	if (ctx.negative) q.set('negative', ctx.negative);
-	if (ctx.durationSec != null) q.set('duration', String(ctx.durationSec));
-	if (ctx.sourceKind && ctx.sourceId) {
-		q.set('source_kind', ctx.sourceKind);
-		q.set('source_id', ctx.sourceId);
-	}
-	return `/${ctx.kind}?${q.toString()}`;
+export function deskHref(ctx: DeskContext): `/${DeskKind}?${string}` {
+  const q = new URLSearchParams({
+    from: "workbench",
+    project: String(ctx.projectId),
+    stage: ctx.stage,
+    label: ctx.label,
+  });
+  if (ctx.prompt) q.set("prompt", ctx.prompt);
+  if (ctx.negative) q.set("negative", ctx.negative);
+  if (ctx.durationSec != null) q.set("duration", String(ctx.durationSec));
+  if (ctx.sourceKind && ctx.sourceId) {
+    q.set("source_kind", ctx.sourceKind);
+    q.set("source_id", ctx.sourceId);
+  }
+  return `/${ctx.kind}?${q.toString()}`;
 }
 
 export function readDeskContext(url: URL, kind: DeskKind): DeskContext | null {
-	const q = url.searchParams;
-	if (q.get('from') !== 'workbench') return null;
-	const projectId = Number(q.get('project'));
-	const stage = q.get('stage') as WorkbenchStageKey | null;
-	if (!Number.isInteger(projectId) || projectId <= 0 || !stage || !STAGES.includes(stage)) return null;
-	const duration = Number(q.get('duration'));
-	const rawKind = q.get('source_kind');
-	const rawId = q.get('source_id') ?? '';
-	// Source identity is only kept when it is complete and self-consistent;
-	// old/hand-made links keep today's prefill-only behavior.
-	const expectedKind = stage === 'assets' ? 'asset' : stage === 'shot' ? 'shot' : null;
-	const sourceKind = rawKind === 'asset' || rawKind === 'shot' ? rawKind : null;
-	const hasSource = sourceKind !== null && sourceKind === expectedKind && rawId.trim() !== '';
-	return {
-		kind,
-		projectId,
-		stage,
-		label: q.get('label') ?? '',
-		prompt: q.get('prompt') ?? undefined,
-		negative: q.get('negative') ?? undefined,
-		durationSec: Number.isFinite(duration) && duration > 0 ? duration : undefined,
-		sourceKind: hasSource ? (sourceKind as 'asset' | 'shot') : undefined,
-		sourceId: hasSource ? rawId : undefined,
-	};
+  const q = url.searchParams;
+  if (q.get("from") !== "workbench") return null;
+  const projectId = Number(q.get("project"));
+  const stage = q.get("stage") as WorkbenchStageKey | null;
+  if (
+    !Number.isInteger(projectId) ||
+    projectId <= 0 ||
+    !stage ||
+    !STAGES.includes(stage)
+  )
+    return null;
+  const duration = Number(q.get("duration"));
+  const rawKind = q.get("source_kind");
+  const rawId = q.get("source_id") ?? "";
+  // Source identity is only kept when it is complete and self-consistent;
+  // old/hand-made links keep today's prefill-only behavior.
+  const expectedKind =
+    stage === "assets" ? "asset" : stage === "shot" ? "shot" : null;
+  const sourceKind = rawKind === "asset" || rawKind === "shot" ? rawKind : null;
+  const hasSource =
+    sourceKind !== null && sourceKind === expectedKind && rawId.trim() !== "";
+  return {
+    kind,
+    projectId,
+    stage,
+    label: q.get("label") ?? "",
+    prompt: q.get("prompt") ?? undefined,
+    negative: q.get("negative") ?? undefined,
+    durationSec:
+      Number.isFinite(duration) && duration > 0 ? duration : undefined,
+    sourceKind: hasSource ? (sourceKind as "asset" | "shot") : undefined,
+    sourceId: hasSource ? rawId : undefined,
+  };
 }
 
 /**
  * The context a generate request carries: only when the full, real source
  * identity is present AND the desk kind matches what that stage renders.
  */
-export function workbenchContextOf(ctx: DeskContext | null): DeskWorkbenchContext | undefined {
-	if (!ctx?.sourceId || !ctx.sourceKind) return undefined;
-	if (ctx.stage !== 'assets' && ctx.stage !== 'shot') return undefined;
-	if (KIND_BY_STAGE[ctx.stage] !== ctx.kind) return undefined;
-	const out: DeskWorkbenchContext = {
-		project_id: ctx.projectId,
-		stage: ctx.stage,
-		source_kind: ctx.sourceKind,
-		source_id: ctx.sourceId,
-	};
-	if (ctx.label.trim()) out.label = ctx.label;
-	return out;
+export function workbenchContextOf(
+  ctx: DeskContext | null,
+): DeskWorkbenchContext | undefined {
+  if (!ctx?.sourceId || !ctx.sourceKind) return undefined;
+  if (ctx.stage !== "assets" && ctx.stage !== "shot") return undefined;
+  if (KIND_BY_STAGE[ctx.stage] !== ctx.kind) return undefined;
+  const out: DeskWorkbenchContext = {
+    project_id: ctx.projectId,
+    stage: ctx.stage,
+    source_kind: ctx.sourceKind,
+    source_id: ctx.sourceId,
+  };
+  if (ctx.label.trim()) out.label = ctx.label;
+  return out;
 }
 
-export function backHref(ctx: DeskContext): string {
-	return `/workbench/${ctx.projectId}?stage=${ctx.stage}`;
+export function backHref(
+  ctx: DeskContext,
+): `/workbench/${string}?stage=${string}` {
+  return `/workbench/${ctx.projectId}?stage=${ctx.stage}`;
 }

calliope-web/src/lib/components/generate/schema.ts

@@ -1,7 +1,11 @@
-import type { ComfyDynamicInput, Workflow, WorkflowUsage } from '$lib/comfy/types';
-import { normalizeInputRole } from '$lib/comfy/parser';
-import { ratioShort, resolutionSelectorSize } from '$lib/comfy/resolution';
-import { t } from '$lib/i18n.svelte';
+import type {
+  ComfyDynamicInput,
+  Workflow,
+  WorkflowUsage,
+} from "$lib/comfy/types";
+import { normalizeInputRole } from "$lib/comfy/parser";
+import { ratioShort, resolutionSelectorSize } from "$lib/comfy/resolution";
+import { t } from "$lib/i18n.svelte";
 
 /**
  * 生成台表单识别 (HEL-653, moved verbatim from StudioGenerate): slots and
@@ -9,366 +13,477 @@ import { t } from '$lib/i18n.svelte';
  * never from model names. No wiring → no slot.
  */
 
-export type DeskKind = 'image' | 'video';
+export type DeskKind = "image" | "video";
 export type FormValue = string | number | string[];
 export type FormValues = Record<string, FormValue>;
 
 export interface SlotDef {
-	inp: ComfyDynamicInput;
-	label: string;
-	mediaKind: 'image' | 'video' | 'audio';
-	fromResults: boolean;
-	/** Required-slot message when left empty (ref-upload-spec §3). */
-	missing: string;
-	firstFrame: boolean;
-	lastFrame: boolean;
-	mask: boolean;
+  inp: ComfyDynamicInput;
+  label: string;
+  mediaKind: "image" | "video" | "audio";
+  fromResults: boolean;
+  /** Required-slot message when left empty (ref-upload-spec §3). */
+  missing: string;
+  firstFrame: boolean;
+  lastFrame: boolean;
+  mask: boolean;
 }
 
 /** Why 生成 is disabled — the line next to the button (spec-v2 §1.2). */
 export interface BlockReason {
-	text: string;
-	tone: 'warn' | 'err';
-	/** Element id to focus when the reason is clicked. */
-	target?: string;
-	/** Open the params tab instead of focusing. */
-	params?: boolean;
+  text: string;
+  tone: "warn" | "err";
+  /** Element id to focus when the reason is clicked. */
+  target?: string;
+  /** Open the params tab instead of focusing. */
+  params?: boolean;
 }
 
 export interface DeskSchema {
-	prompt: ComfyDynamicInput | null;
-	negative: ComfyDynamicInput | null;
-	seed: ComfyDynamicInput | null;
-	width: ComfyDynamicInput | null;
-	height: ComfyDynamicInput | null;
-	resolution: ComfyDynamicInput | null;
-	duration: ComfyDynamicInput | null;
-	batch: ComfyDynamicInput | null;
-	/** ComfyUI ResolutionSelector: the ratio + megapixels pair decides width/height. */
-	ratio: ComfyDynamicInput | null;
-	megapixels: ComfyDynamicInput | null;
-	/** Single media inputs (input image, first/last frame, mask, ref video/audio). */
-	slots: SlotDef[];
-	/** Autogrow media lists actually wired (image / video / audio). */
-	lists: ComfyDynamicInput[];
-	/** Parameters shown as composer chips (比例 / 尺寸 / 分辨率 / 时长 / 种子). */
-	common: ComfyDynamicInput[];
-	/** Everything else that is not media and not the prompt — folded. */
-	advanced: ComfyDynamicInput[];
-	hasH3Hint: boolean;
+  prompt: ComfyDynamicInput | null;
+  negative: ComfyDynamicInput | null;
+  seed: ComfyDynamicInput | null;
+  width: ComfyDynamicInput | null;
+  height: ComfyDynamicInput | null;
+  resolution: ComfyDynamicInput | null;
+  duration: ComfyDynamicInput | null;
+  batch: ComfyDynamicInput | null;
+  /** ComfyUI ResolutionSelector: the ratio + megapixels pair decides width/height. */
+  ratio: ComfyDynamicInput | null;
+  megapixels: ComfyDynamicInput | null;
+  /** Single media inputs (input image, first/last frame, mask, ref video/audio). */
+  slots: SlotDef[];
+  /** Autogrow media lists actually wired (image / video / audio). */
+  lists: ComfyDynamicInput[];
+  /** Parameters shown as composer chips (比例 / 尺寸 / 分辨率 / 时长 / 种子). */
+  common: ComfyDynamicInput[];
+  /** Everything else that is not media and not the prompt — folded. */
+  advanced: ComfyDynamicInput[];
+  hasH3Hint: boolean;
 }
 
 export function inputRole(inp: ComfyDynamicInput): string | null {
-	return normalizeInputRole(inp.role ?? null);
+  return normalizeInputRole(inp.role ?? null);
 }
 
 function hay(inp: ComfyDynamicInput): string {
-	return `${inp.role ?? ''} ${inp.label}`.toLowerCase();
+  return `${inp.role ?? ""} ${inp.label}`.toLowerCase();
 }
 
 export function isMedia(inp: ComfyDynamicInput): boolean {
-	return (
-		inp.kind === 'image' ||
-		inp.kind === 'image_url' ||
-		inp.kind === 'video' ||
-		inp.kind === 'audio' ||
-		inp.kind === 'image_list' ||
-		inp.kind === 'video_list' ||
-		inp.kind === 'audio_list'
-	);
+  return (
+    inp.kind === "image" ||
+    inp.kind === "image_url" ||
+    inp.kind === "video" ||
+    inp.kind === "audio" ||
+    inp.kind === "image_list" ||
+    inp.kind === "video_list" ||
+    inp.kind === "audio_list"
+  );
 }
 
 function isList(inp: ComfyDynamicInput): boolean {
-	return inp.kind === 'image_list' || inp.kind === 'video_list' || inp.kind === 'audio_list';
+  return (
+    inp.kind === "image_list" ||
+    inp.kind === "video_list" ||
+    inp.kind === "audio_list"
+  );
 }
 
 function isMask(inp: ComfyDynamicInput): boolean {
-	return inputRole(inp) === 'mask' || /mask|遮罩/.test(hay(inp));
+  return inputRole(inp) === "mask" || /mask|遮罩/.test(hay(inp));
 }
 
 // Auto-detected slots carry their role from the wiring; tagged (Input:…)
 // workflows still name frames only in the title.
 export function isFirstFrame(inp: ComfyDynamicInput, kind: DeskKind): boolean {
-	return inputRole(inp) === 'first_frame' || (!inp.auto && kind === 'video' && /first|start|首帧/.test(hay(inp)));
+  return (
+    inputRole(inp) === "first_frame" ||
+    (!inp.auto && kind === "video" && /first|start|首帧/.test(hay(inp)))
+  );
 }
 export function isLastFrame(inp: ComfyDynamicInput, kind: DeskKind): boolean {
-	return inputRole(inp) === 'last_frame' || (!inp.auto && kind === 'video' && /last|end|尾帧/.test(hay(inp)));
+  return (
+    inputRole(inp) === "last_frame" ||
+    (!inp.auto && kind === "video" && /last|end|尾帧/.test(hay(inp)))
+  );
 }
 
-export function listKind(entry: ComfyDynamicInput): 'image' | 'video' | 'audio' {
-	if (entry.kind === 'video_list') return 'video';
-	if (entry.kind === 'audio_list') return 'audio';
-	return 'image';
+export function listKind(
+  entry: ComfyDynamicInput,
+): "image" | "video" | "audio" {
+  if (entry.kind === "video_list") return "video";
+  if (entry.kind === "audio_list") return "audio";
+  return "image";
 }
 
-export function listPaths(values: FormValues, entry: ComfyDynamicInput): string[] {
-	const v = values[entry.nodeId];
-	if (Array.isArray(v)) return v;
-	return typeof v === 'string' && v ? [v] : [];
+export function listPaths(
+  values: FormValues,
+  entry: ComfyDynamicInput,
+): string[] {
+  const v = values[entry.nodeId];
+  if (Array.isArray(v)) return v;
+  return typeof v === "string" && v ? [v] : [];
 }
 
-export function classifySchema(schema: ComfyDynamicInput[], kind: DeskKind): DeskSchema {
-	const plain = (pred: (i: ComfyDynamicInput) => boolean) =>
-		schema.find((i) => !isMedia(i) && pred(i)) ?? null;
-	const byRole = (r: string) => plain((i) => inputRole(i) === r);
+export function classifySchema(
+  schema: ComfyDynamicInput[],
+  kind: DeskKind,
+): DeskSchema {
+  const plain = (pred: (i: ComfyDynamicInput) => boolean) =>
+    schema.find((i) => !isMedia(i) && pred(i)) ?? null;
+  const byRole = (r: string) => plain((i) => inputRole(i) === r);
 
-	const prompt = byRole('prompt');
-	const negative = byRole('negative');
-	const seed = byRole('seed');
-	const width = byRole('width');
-	const height = byRole('height');
-	const resolution = byRole('resolution');
-	const duration = byRole('duration');
-	const batch = plain((i) => /批次|batch/.test(hay(i)));
-	const ratio =
-		schema.find((i) => i.kind === 'select' && inputRole(i) === 'aspect_ratio' && i.resolution) ?? null;
-	const megapixels = ratio ? (schema.find((i) => i.nodeId === ratio.resolution!.megapixels) ?? null) : null;
+  const prompt = byRole("prompt");
+  const negative = byRole("negative");
+  const seed = byRole("seed");
+  const width = byRole("width");
+  const height = byRole("height");
+  const resolution = byRole("resolution");
+  const duration = byRole("duration");
+  const batch = plain((i) => /批次|batch/.test(hay(i)));
+  const ratio =
+    schema.find(
+      (i) =>
+        i.kind === "select" && inputRole(i) === "aspect_ratio" && i.resolution,
+    ) ?? null;
+  const megapixels = ratio
+    ? (schema.find((i) => i.nodeId === ratio.resolution!.megapixels) ?? null)
+    : null;
 
-	const media = schema.filter((i) => isMedia(i) && !isList(i));
-	const plainImages = media.filter(
-		(i) => i.kind === 'image' && !isMask(i) && !isFirstFrame(i, kind) && !isLastFrame(i, kind),
-	);
-	const editInput = kind === 'image' && plainImages.length === 1 ? plainImages[0] : null;
-	const slots: SlotDef[] = [];
-	let refIdx = 0;
-	for (const inp of media) {
-		const base = { inp, missing: '', firstFrame: false, lastFrame: false, mask: false };
-		if (inp.kind === 'video') {
-			slots.push({ ...base, label: t('studio.slotRefVideo'), mediaKind: 'video', fromResults: false });
-		} else if (inp.kind === 'audio') {
-			slots.push({ ...base, label: t('studio.slotAudio'), mediaKind: 'audio', fromResults: false });
-		} else if (isMask(inp)) {
-			slots.push({ ...base, mask: true, label: t('studio.slotMask'), mediaKind: 'image', fromResults: false });
-		} else if (isFirstFrame(inp, kind)) {
-			slots.push({
-				...base,
-				firstFrame: true,
-				label: t('studio.slotFirst'),
-				mediaKind: 'image',
-				fromResults: true,
-				missing: t('studio.errNeedFirstFrame'),
-			});
-		} else if (isLastFrame(inp, kind)) {
-			slots.push({ ...base, lastFrame: true, label: t('studio.slotLast'), mediaKind: 'image', fromResults: true });
-		} else if (inp === editInput) {
-			slots.push({
-				...base,
-				label: t('studio.slotInput'),
-				mediaKind: 'image',
-				fromResults: true,
-				missing: t('studio.errNeedInputImage'),
-			});
-		} else {
-			refIdx += 1;
-			const label = inp.auto
-				? inp.label
-				: refIdx === 1 && media.length === 1
-					? t('studio.slotRef')
-					: t('studio.slotRefN', { n: refIdx });
-			slots.push({
-				...base,
-				label,
-				mediaKind: 'image',
-				fromResults: true,
-				missing: t('studio.errUpload', { label }),
-			});
-		}
-	}
+  const media = schema.filter((i) => isMedia(i) && !isList(i));
+  const plainImages = media.filter(
+    (i) =>
+      i.kind === "image" &&
+      !isMask(i) &&
+      !isFirstFrame(i, kind) &&
+      !isLastFrame(i, kind),
+  );
+  const editInput =
+    kind === "image" && plainImages.length === 1 ? plainImages[0] : null;
+  const slots: SlotDef[] = [];
+  let refIdx = 0;
+  for (const inp of media) {
+    const base = {
+      inp,
+      missing: "",
+      firstFrame: false,
+      lastFrame: false,
+      mask: false,
+    };
+    if (inp.kind === "video") {
+      slots.push({
+        ...base,
+        label: t("studio.slotRefVideo"),
+        mediaKind: "video",
+        fromResults: false,
+      });
+    } else if (inp.kind === "audio") {
+      slots.push({
+        ...base,
+        label: t("studio.slotAudio"),
+        mediaKind: "audio",
+        fromResults: false,
+      });
+    } else if (isMask(inp)) {
+      slots.push({
+        ...base,
+        mask: true,
+        label: t("studio.slotMask"),
+        mediaKind: "image",
+        fromResults: false,
+      });
+    } else if (isFirstFrame(inp, kind)) {
+      slots.push({
+        ...base,
+        firstFrame: true,
+        label: t("studio.slotFirst"),
+        mediaKind: "image",
+        fromResults: true,
+        missing: t("studio.errNeedFirstFrame"),
+      });
+    } else if (isLastFrame(inp, kind)) {
+      slots.push({
+        ...base,
+        lastFrame: true,
+        label: t("studio.slotLast"),
+        mediaKind: "image",
+        fromResults: true,
+      });
+    } else if (inp === editInput) {
+      slots.push({
+        ...base,
+        label: t("studio.slotInput"),
+        mediaKind: "image",
+        fromResults: true,
+        missing: t("studio.errNeedInputImage"),
+      });
+    } else {
+      refIdx += 1;
+      const label = inp.auto
+        ? inp.label
+        : refIdx === 1 && media.length === 1
+          ? t("studio.slotRef")
+          : t("studio.slotRefN", { n: refIdx });
+      slots.push({
+        ...base,
+        label,
+        mediaKind: "image",
+        fromResults: true,
+        missing: t("studio.errUpload", { label }),
+      });
+    }
+  }
 
-	const lists = schema.filter(isList);
-	const common = [ratio, width, height, resolution, duration, seed].filter(
-		(i): i is ComfyDynamicInput => !!i,
-	);
-	const commonIds = new Set(common.map((i) => i.nodeId));
-	const advanced = schema.filter((i) => !isMedia(i) && i !== prompt && !commonIds.has(i.nodeId));
+  const lists = schema.filter(isList);
+  const common = [ratio, width, height, resolution, duration, seed].filter(
+    (i): i is ComfyDynamicInput => !!i,
+  );
+  const commonIds = new Set(common.map((i) => i.nodeId));
+  const advanced = schema.filter(
+    (i) => !isMedia(i) && i !== prompt && !commonIds.has(i.nodeId),
+  );
 
-	return {
-		prompt,
-		negative,
-		seed,
-		width,
-		height,
-		resolution,
-		duration,
-		batch,
-		ratio,
-		megapixels,
-		slots,
-		lists,
-		common,
-		advanced,
-		hasH3Hint: lists.some((e) => e.media_hint === 'minimax_h3_ref2va'),
-	};
+  return {
+    prompt,
+    negative,
+    seed,
+    width,
+    height,
+    resolution,
+    duration,
+    batch,
+    ratio,
+    megapixels,
+    slots,
+    lists,
+    common,
+    advanced,
+    hasH3Hint: lists.some((e) => e.media_hint === "minimax_h3_ref2va"),
+  };
 }
 
 /** Workflow JSON defaults — the 原值 every parameter falls back to. */
 export function schemaDefaults(schema: ComfyDynamicInput[]): FormValues {
-	const out: FormValues = {};
-	for (const inp of schema) {
-		if (inp.defaultValue !== undefined && inp.defaultValue !== '') out[inp.nodeId] = inp.defaultValue;
-	}
-	return out;
+  const out: FormValues = {};
+  for (const inp of schema) {
+    if (inp.defaultValue !== undefined && inp.defaultValue !== "")
+      out[inp.nodeId] = inp.defaultValue;
+  }
+  return out;
 }
 
 export function isChanged(inp: ComfyDynamicInput, values: FormValues): boolean {
-	const v = values[inp.nodeId];
-	const orig = inp.defaultValue;
-	if (v === undefined || v === '') return orig !== undefined && orig !== '';
-	if (orig === undefined || orig === '') return true;
-	return String(v) !== String(orig);
+  const v = values[inp.nodeId];
+  const orig = inp.defaultValue;
+  if (v === undefined || v === "") return orig !== undefined && orig !== "";
+  if (orig === undefined || orig === "") return true;
+  return String(v) !== String(orig);
 }
 
-export function changedParams(ds: DeskSchema, values: FormValues): ComfyDynamicInput[] {
-	return [...ds.common, ...ds.advanced].filter((i) => isChanged(i, values));
+export function changedParams(
+  ds: DeskSchema,
+  values: FormValues,
+): ComfyDynamicInput[] {
+  return [...ds.common, ...ds.advanced].filter((i) => isChanged(i, values));
 }
 
-export function outputSize(ds: DeskSchema, values: FormValues): { width: number; height: number } | null {
-	if (!ds.ratio?.resolution) return null;
-	const mp = Number(values[ds.megapixels?.nodeId ?? ''] ?? ds.megapixels?.defaultValue);
-	return resolutionSelectorSize(
-		String(values[ds.ratio.nodeId] ?? ds.ratio.defaultValue ?? ''),
-		mp,
-		ds.ratio.resolution.multiple,
-	);
+export function outputSize(
+  ds: DeskSchema,
+  values: FormValues,
+): { width: number; height: number } | null {
+  if (!ds.ratio?.resolution) return null;
+  const mp = Number(
+    values[ds.megapixels?.nodeId ?? ""] ?? ds.megapixels?.defaultValue,
+  );
+  return resolutionSelectorSize(
+    String(values[ds.ratio.nodeId] ?? ds.ratio.defaultValue ?? ""),
+    mp,
+    ds.ratio.resolution.multiple,
+  );
 }
 
 export function batchCount(ds: DeskSchema, values: FormValues): number {
-	if (!ds.batch) return 1;
-	const n = Number(values[ds.batch.nodeId]);
-	return Number.isFinite(n) && n > 0 ? Math.floor(n) : 1;
+  if (!ds.batch) return 1;
+  const n = Number(values[ds.batch.nodeId]);
+  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 1;
 }
 
 /** H3 Ref2VA official limits (soft hint, keyed off the node class only). */
 export function h3Warnings(ds: DeskSchema, values: FormValues): string[] {
-	if (!ds.hasH3Hint) return [];
-	const warns: string[] = [];
-	const counts = { image: 0, video: 0, audio: 0 };
-	for (const g of ds.lists) counts[listKind(g)] += listPaths(values, g).length;
-	const total = counts.image + counts.video + counts.audio;
-	if (total > 12) warns.push(t('wfMedia.h3TotalOver', { n: total }));
-	if (counts.audio > 0 && counts.image === 0 && counts.video === 0) warns.push(t('wfMedia.h3AudioAlone'));
-	return warns;
+  if (!ds.hasH3Hint) return [];
+  const warns: string[] = [];
+  const counts = { image: 0, video: 0, audio: 0 };
+  for (const g of ds.lists) counts[listKind(g)] += listPaths(values, g).length;
+  const total = counts.image + counts.video + counts.audio;
+  if (total > 12) warns.push(t("wfMedia.h3TotalOver", { n: total }));
+  if (counts.audio > 0 && counts.image === 0 && counts.video === 0)
+    warns.push(t("wfMedia.h3AudioAlone"));
+  return warns;
 }
 
 /** Same rules the backend enforces before queueing (comfyui/validate.py). */
-export function valueError(inp: ComfyDynamicInput, raw: string | number): string | null {
-	const label = inp.label;
-	if (inp.kind === 'select') {
-		return inp.options?.length && !inp.options.includes(String(raw)) ? t('studio.errOption', { label }) : null;
-	}
-	if (inp.kind !== 'number') return null;
-	const n = Number(raw);
-	if (!Number.isFinite(n)) return t('studio.errNumber', { label });
-	if (inp.integer && !Number.isInteger(n)) return t('studio.errInteger', { label });
-	if (inp.min != null && n < inp.min) return t('studio.errMin', { label, v: inp.min });
-	if (inp.max != null && n > inp.max) return t('studio.errMax', { label, v: inp.max });
-	return null;
+export function valueError(
+  inp: ComfyDynamicInput,
+  raw: string | number,
+): string | null {
+  const label = inp.label;
+  if (inp.kind === "select") {
+    return inp.options?.length && !inp.options.includes(String(raw))
+      ? t("studio.errOption", { label })
+      : null;
+  }
+  if (inp.kind !== "number") return null;
+  const n = Number(raw);
+  if (!Number.isFinite(n)) return t("studio.errNumber", { label });
+  if (inp.integer && !Number.isInteger(n))
+    return t("studio.errInteger", { label });
+  if (inp.min != null && n < inp.min)
+    return t("studio.errMin", { label, v: inp.min });
+  if (inp.max != null && n > inp.max)
+    return t("studio.errMax", { label, v: inp.max });
+  return null;
 }
 
 /** Field errors keyed by nodeId (spec §6.2 wording); '' keys never block. */
 export function validateForm(
-	schema: ComfyDynamicInput[],
-	ds: DeskSchema,
-	values: FormValues,
+  schema: ComfyDynamicInput[],
+  ds: DeskSchema,
+  values: FormValues,
 ): Record<string, string> {
-	const errs: Record<string, string> = {};
-	if (ds.prompt?.required) {
-		const v = String(values[ds.prompt.nodeId] ?? '');
-		if (!v.trim()) errs[ds.prompt.nodeId] = t('studio.errPrompt');
-		else if (v.length > 2000) errs[ds.prompt.nodeId] = t('studio.errPromptLong');
-	}
-	const first = ds.slots.find((s) => s.firstFrame);
-	const last = ds.slots.find((s) => s.lastFrame);
-	if (first && last) {
-		const a = String(values[first.inp.nodeId] ?? '');
-		const b = String(values[last.inp.nodeId] ?? '');
-		// An optional last frame (H3 FL2VA) may stay empty; it never goes without a first frame.
-		const unpaired = last.inp.required ? (!a || !b) && (a || b) : !a && !!b;
-		if (unpaired) {
-			errs.firstLast = t('studio.errFirstLast');
-			if (!a) errs[first.inp.nodeId] = ' ';
-			if (!b) errs[last.inp.nodeId] = ' ';
-		}
-	}
-	for (const s of ds.slots) {
-		if (!s.inp.required) continue;
-		if (!String(values[s.inp.nodeId] ?? '').trim()) {
-			errs[s.inp.nodeId] = s.missing || t('studio.errUpload', { label: s.label });
-		}
-	}
-	for (const g of ds.lists) {
-		const n = listPaths(values, g).length;
-		const max = g.max ?? 9;
-		if (n < (g.min ?? 1)) {
-			errs[g.nodeId] =
-				g.kind === 'image_list'
-					? t('studio.errNeedRef')
-					: t('studio.errNeedRefMedia', { n: g.min ?? 1, label: g.label });
-		} else if (n > max) {
-			errs[g.nodeId] = t('studio.errRefMax', { max, n, k: n - max });
-		}
-	}
-	for (const inp of [...ds.common, ...ds.advanced]) {
-		if (inp.required && !String(values[inp.nodeId] ?? '').trim()) {
-			errs[inp.nodeId] = t('studio.errFill', { label: inp.label });
-		}
-	}
-	for (const inp of schema) {
-		const raw = values[inp.nodeId];
-		if (raw === undefined || Array.isArray(raw) || String(raw).trim() === '' || errs[inp.nodeId]) continue;
-		const msg = valueError(inp, raw);
-		if (msg) errs[inp.nodeId] = msg;
-	}
-	return errs;
+  const errs: Record<string, string> = {};
+  if (ds.prompt?.required) {
+    const v = String(values[ds.prompt.nodeId] ?? "");
+    if (!v.trim()) errs[ds.prompt.nodeId] = t("studio.errPrompt");
+    else if (v.length > 2000)
+      errs[ds.prompt.nodeId] = t("studio.errPromptLong");
+  }
+  const first = ds.slots.find((s) => s.firstFrame);
+  const last = ds.slots.find((s) => s.lastFrame);
+  if (first && last) {
+    const a = String(values[first.inp.nodeId] ?? "");
+    const b = String(values[last.inp.nodeId] ?? "");
+    // An optional last frame (H3 FL2VA) may stay empty; it never goes without a first frame.
+    const unpaired = last.inp.required ? (!a || !b) && (a || b) : !a && !!b;
+    if (unpaired) {
+      errs.firstLast = t("studio.errFirstLast");
+      if (!a) errs[first.inp.nodeId] = " ";
+      if (!b) errs[last.inp.nodeId] = " ";
+    }
+  }
+  for (const s of ds.slots) {
+    if (!s.inp.required) continue;
+    if (!String(values[s.inp.nodeId] ?? "").trim()) {
+      errs[s.inp.nodeId] =
+        s.missing || t("studio.errUpload", { label: s.label });
+    }
+  }
+  for (const g of ds.lists) {
+    const n = listPaths(values, g).length;
+    const max = g.max ?? 9;
+    if (n < (g.min ?? 1)) {
+      errs[g.nodeId] =
+        g.kind === "image_list"
+          ? t("studio.errNeedRef")
+          : t("studio.errNeedRefMedia", { n: g.min ?? 1, label: g.label });
+    } else if (n > max) {
+      errs[g.nodeId] = t("studio.errRefMax", { max, n, k: n - max });
+    }
+  }
+  for (const inp of [...ds.common, ...ds.advanced]) {
+    if (inp.required && !String(values[inp.nodeId] ?? "").trim()) {
+      errs[inp.nodeId] = t("studio.errFill", { label: inp.label });
+    }
+  }
+  for (const inp of schema) {
+    const raw = values[inp.nodeId];
+    if (
+      raw === undefined ||
+      Array.isArray(raw) ||
+      String(raw).trim() === "" ||
+      errs[inp.nodeId]
+    )
+      continue;
+    const msg = valueError(inp, raw);
+    if (msg) errs[inp.nodeId] = msg;
+  }
+  return errs;
 }
 
 /** Media a slot still waits for — the 「还缺：…」 hint next to 生成. */
-export function missingMedia(ds: DeskSchema, values: FormValues): Array<{ nodeId: string; label: string }> {
-	const out: Array<{ nodeId: string; label: string }> = [];
-	for (const s of ds.slots) {
-		if (s.inp.required && !String(values[s.inp.nodeId] ?? '').trim()) out.push({ nodeId: s.inp.nodeId, label: s.label });
-	}
-	for (const g of ds.lists) {
-		if (listPaths(values, g).length < (g.min ?? 1)) out.push({ nodeId: g.nodeId, label: g.label });
-	}
-	return out;
+export function missingMedia(
+  ds: DeskSchema,
+  values: FormValues,
+): Array<{ nodeId: string; label: string }> {
+  const out: Array<{ nodeId: string; label: string }> = [];
+  for (const s of ds.slots) {
+    if (s.inp.required && !String(values[s.inp.nodeId] ?? "").trim())
+      out.push({ nodeId: s.inp.nodeId, label: s.label });
+  }
+  for (const g of ds.lists) {
+    if (listPaths(values, g).length < (g.min ?? 1))
+      out.push({ nodeId: g.nodeId, label: g.label });
+  }
+  return out;
 }
 
 export function usageLabel(u: WorkflowUsage): string {
-	return t(`usage.${u}`);
+  return t(`usage.${u}`);
 }
 
 /** Mode badge: the stored usage when we have one, else the wiring shape. */
-export function modeLabel(wf: Workflow | null, ds: DeskSchema, kind: DeskKind): string {
-	if (wf?.usage) return usageLabel(wf.usage);
-	if (ds.lists.some((g) => g.kind === 'image_list')) return t('studio.modeRefToVideo');
-	if (ds.slots.some((s) => s.firstFrame)) return t('studio.modeImageToVideo');
-	if (kind === 'image' && ds.slots.some((s) => s.mediaKind === 'image' && !s.mask))
-		return t('studio.modeImageEdit');
-	if (ds.slots.length) return ds.slots.map((s) => s.label).join(' · ');
-	return kind === 'image' ? t('studio.modeTextToImage') : t('studio.modeTextToVideo');
+export function modeLabel(
+  wf: Workflow | null,
+  ds: DeskSchema,
+  kind: DeskKind,
+): string {
+  if (wf?.usage) return usageLabel(wf.usage);
+  if (ds.lists.some((g) => g.kind === "image_list"))
+    return t("studio.modeRefToVideo");
+  if (ds.slots.some((s) => s.firstFrame)) return t("studio.modeImageToVideo");
+  if (
+    kind === "image" &&
+    ds.slots.some((s) => s.mediaKind === "image" && !s.mask)
+  )
+    return t("studio.modeImageEdit");
+  if (ds.slots.length) return ds.slots.map((s) => s.label).join(" · ");
+  return kind === "image"
+    ? t("studio.modeTextToImage")
+    : t("studio.modeTextToVideo");
 }
 
 /** Picker row summary of a workflow's real media inputs, e.g. 参考图 1–9 张. */
 export function slotSummary(wf: Workflow): string {
-	const ds = classifySchema(wf.input_schema ?? [], wf.kind);
-	const parts = [
-		...ds.slots.map((s) => t('desk.slotOne', { label: s.label })),
-		...ds.lists.map((g) => t('desk.slotRange', { label: g.label, min: g.min ?? 1, max: g.max ?? 9 })),
-	];
-	return parts.length ? parts.join(' · ') : t('desk.promptOnly');
+  const ds = classifySchema(wf.input_schema ?? [], wf.kind);
+  const parts = [
+    ...ds.slots.map((s) => t("desk.slotOne", { label: s.label })),
+    ...ds.lists.map((g) =>
+      t("desk.slotRange", { label: g.label, min: g.min ?? 1, max: g.max ?? 9 }),
+    ),
+  ];
+  return parts.length ? parts.join(" · ") : t("desk.promptOnly");
 }
 
 /** Short chip text for one common parameter value. */
-export function chipValue(inp: ComfyDynamicInput, values: FormValues, ds: DeskSchema): string {
-	const raw = values[inp.nodeId] ?? inp.defaultValue ?? '';
-	const v = Array.isArray(raw) ? raw.join(',') : String(raw);
-	if (inp === ds.ratio) {
-		const size = outputSize(ds, values);
-		return size ? `${ratioShort(v)} · ${size.width}×${size.height}` : ratioShort(v);
-	}
-	if (inp === ds.duration) return v ? t('desk.chipSeconds', { v }) : t('studio.durationLabel');
-	if (inp === ds.seed) return t('desk.chipSeed', { v: v.length > 8 ? `${v.slice(0, 8)}…` : v || '—' });
-	if (inp === ds.resolution) return t('desk.chipResolution', { v: v || '—' });
-	return v || inp.label;
+export function chipValue(
+  inp: ComfyDynamicInput,
+  values: FormValues,
+  ds: DeskSchema,
+): string {
+  const raw = values[inp.nodeId] ?? inp.defaultValue ?? "";
+  const v = Array.isArray(raw) ? raw.join(",") : String(raw);
+  if (inp === ds.ratio) {
+    const size = outputSize(ds, values);
+    return size
+      ? `${ratioShort(v)} · ${size.width}×${size.height}`
+      : ratioShort(v);
+  }
+  if (inp === ds.duration)
+    return v ? t("desk.chipSeconds", { v }) : t("studio.durationLabel");
+  if (inp === ds.seed)
+    return t("desk.chipSeed", {
+      v: v.length > 8 ? `${v.slice(0, 8)}…` : v || "—",
+    });
+  if (inp === ds.resolution) return t("desk.chipResolution", { v: v || "—" });
+  return v || inp.label;
 }

calliope-web/src/lib/components/generate/takeDelete.svelte.ts

@@ -1,120 +1,120 @@
-import { SvelteSet } from 'svelte/reactivity';
-import type { QueryClient } from '@tanstack/svelte-query';
-import { apiErrorMessage, playgroundApi } from '$lib/api';
-import type { Job } from '$lib/comfy/types';
-import { showToast } from '$lib/toast';
-import { t } from '$lib/i18n.svelte';
+import { SvelteMap, SvelteSet } from "svelte/reactivity";
+import type { QueryClient } from "@tanstack/svelte-query";
+import { apiErrorMessage, playgroundApi } from "$lib/api";
+import type { Job } from "$lib/comfy/types";
+import { showToast } from "$lib/toast";
+import { t } from "$lib/i18n.svelte";
 
 /**
-* 撤销删除 (spec-v2 §四.4 删除两级制 · HEL-654 D 批): deleting a single
-* take/task never opens a dialog. The row leaves the view right away, a
-* 5-second Toast offers 撤销, and the backend DELETE is only sent when
-* that window closes without an undo — the backend removes result files,
-* so an undo after the call would be impossible. Leaving the page (SPA
-* route change or hard unload) flushes pending deletes instead of
-* dropping them.
-*/
+ * 撤销删除 (spec-v2 §四.4 删除两级制 · HEL-654 D 批): deleting a single
+ * take/task never opens a dialog. The row leaves the view right away, a
+ * 5-second Toast offers 撤销, and the backend DELETE is only sent when
+ * that window closes without an undo — the backend removes result files,
+ * so an undo after the call would be impossible. Leaving the page (SPA
+ * route change or hard unload) flushes pending deletes instead of
+ * dropping them.
+ */
 
 export interface TakeDeleteHandlers {
-	/** Localized toast message for this take. */
-	message: (job: Job) => string;
-	/** Undo: the row comes back — reselect / replay its entrance here. */
-	onUndo?: (job: Job) => void;
-	/** Called after the delete really hit the backend. */
-	onCommitted?: (job: Job) => void;
+  /** Localized toast message for this take. */
+  message: (job: Job) => string;
+  /** Undo: the row comes back — reselect / replay its entrance here. */
+  onUndo?: (job: Job) => void;
+  /** Called after the delete really hit the backend. */
+  onCommitted?: (job: Job) => void;
 }
 
 export interface TakeDeleteQueue {
-	/** Ids whose rows should be hidden (commit pending). */
-	readonly pending: SvelteSet<number>;
-	request: (job: Job, handlers: TakeDeleteHandlers) => void;
-	destroy: () => void;
+  /** Ids whose rows should be hidden (commit pending). */
+  readonly pending: SvelteSet<number>;
+  request: (job: Job, handlers: TakeDeleteHandlers) => void;
+  destroy: () => void;
 }
 
 const UNDO_MS = 5000;
 
 export function createTakeDeleteQueue(client: QueryClient): TakeDeleteQueue {
-	const pending = new SvelteSet<number>();
-	const entries = new Map<
-		number,
-		{
-			job: Job;
-			handlers: TakeDeleteHandlers;
-			timer: ReturnType<typeof setTimeout>;
-		}
-	>();
-	let destroyed = false;
+  const pending = new SvelteSet<number>();
+  const entries = new SvelteMap<
+    number,
+    {
+      job: Job;
+      handlers: TakeDeleteHandlers;
+      timer: ReturnType<typeof setTimeout>;
+    }
+  >();
+  let destroyed = false;
 
-	async function invalidate() {
-		await Promise.allSettled([
-			client.invalidateQueries({ queryKey: ['playground-jobs'] }),
-			client.invalidateQueries({ queryKey: ['jobs'] }),
-		]);
-	}
+  async function invalidate() {
+    await Promise.allSettled([
+      client.invalidateQueries({ queryKey: ["playground-jobs"] }),
+      client.invalidateQueries({ queryKey: ["jobs"] }),
+    ]);
+  }
 
-	async function commit(id: number) {
-		const entry = entries.get(id);
-		if (!entry) return;
-		entries.delete(id);
-		try {
-			await playgroundApi.deleteJob(id);
-			pending.delete(id);
-			entry.handlers.onCommitted?.(entry.job);
-		} catch (err) {
-			// Delete failed: the take stays — bring the row back honestly.
-			pending.delete(id);
-			showToast(
-				t('studio.deleteFailedToast', { detail: apiErrorMessage(err) }),
-				'error',
-			);
-		}
-		await invalidate();
-	}
+  async function commit(id: number) {
+    const entry = entries.get(id);
+    if (!entry) return;
+    entries.delete(id);
+    try {
+      await playgroundApi.deleteJob(id);
+      pending.delete(id);
+      entry.handlers.onCommitted?.(entry.job);
+    } catch (err) {
+      // Delete failed: the take stays — bring the row back honestly.
+      pending.delete(id);
+      showToast(
+        t("studio.deleteFailedToast", { detail: apiErrorMessage(err) }),
+        "error",
+      );
+    }
+    await invalidate();
+  }
 
-	/** Hard unload (tab close / external nav): fire-and-forget with keepalive. */
-	function onPageHide() {
-		for (const [id] of entries) {
-			void fetch(`/api/playground/jobs/${id}`, {
-				method: 'DELETE',
-				keepalive: true,
-			});
-		}
-	}
+  /** Hard unload (tab close / external nav): fire-and-forget with keepalive. */
+  function onPageHide() {
+    for (const [id] of entries) {
+      void fetch(`/api/playground/jobs/${id}`, {
+        method: "DELETE",
+        keepalive: true,
+      });
+    }
+  }
 
-	function destroy() {
-		if (destroyed) return;
-		destroyed = true;
-		if (inBrowser) window.removeEventListener('pagehide', onPageHide);
-		// SPA route change: the JS context survives, normal commits are fine.
-		for (const [id] of entries) {
-			const entry = entries.get(id)!;
-			clearTimeout(entry.timer);
-			void commit(id);
-		}
-	}
+  function destroy() {
+    if (destroyed) return;
+    destroyed = true;
+    if (inBrowser) window.removeEventListener("pagehide", onPageHide);
+    // SPA route change: the JS context survives, normal commits are fine.
+    for (const [id] of entries) {
+      const entry = entries.get(id)!;
+      clearTimeout(entry.timer);
+      void commit(id);
+    }
+  }
 
-	const inBrowser = typeof window !== 'undefined';
-	if (inBrowser) window.addEventListener('pagehide', onPageHide);
+  const inBrowser = typeof window !== "undefined";
+  if (inBrowser) window.addEventListener("pagehide", onPageHide);
 
-	return {
-		pending,
-		request(job, handlers) {
-			if (destroyed || pending.has(job.id)) return;
-			pending.add(job.id);
-			const timer = setTimeout(() => void commit(job.id), UNDO_MS);
-			entries.set(job.id, { job, handlers, timer });
-			showToast(handlers.message(job), 'info', UNDO_MS, {
-				label: t('toast.undo'),
-				run: () => {
-					const e = entries.get(job.id);
-					if (!e) return;
-					clearTimeout(e.timer);
-					entries.delete(job.id);
-					pending.delete(job.id);
-					handlers.onUndo?.(job);
-				},
-			});
-		},
-		destroy,
-	};
+  return {
+    pending,
+    request(job, handlers) {
+      if (destroyed || pending.has(job.id)) return;
+      pending.add(job.id);
+      const timer = setTimeout(() => void commit(job.id), UNDO_MS);
+      entries.set(job.id, { job, handlers, timer });
+      showToast(handlers.message(job), "info", UNDO_MS, {
+        label: t("toast.undo"),
+        run: () => {
+          const e = entries.get(job.id);
+          if (!e) return;
+          clearTimeout(e.timer);
+          entries.delete(job.id);
+          pending.delete(job.id);
+          handlers.onUndo?.(job);
+        },
+      });
+    },
+    destroy,
+  };
 }

calliope-web/src/lib/components/generate/takes.ts

@@ -1,157 +1,194 @@
-import type { Job, Workflow } from '$lib/comfy/types';
-import { parseDbTs } from '$lib/dbtime';
-import { jobStatusInfo } from '$lib/jobStatus';
-import { resolutionSelectorSize } from '$lib/comfy/resolution';
-import { t } from '$lib/i18n.svelte';
-import { classifySchema, inputRole, isFirstFrame, isLastFrame, isMedia } from './schema';
+import type { Job, Workflow } from "$lib/comfy/types";
+import { parseDbTs } from "$lib/dbtime";
+import { jobStatusInfo } from "$lib/jobStatus";
+import { resolutionSelectorSize } from "$lib/comfy/resolution";
+import { t } from "$lib/i18n.svelte";
+import {
+  classifySchema,
+  inputRole,
+  isFirstFrame,
+  isLastFrame,
+  isMedia,
+} from "./schema";
 
 /** Read-only views of a finished / running take (one playground job). */
 
-export type FeedFilter = 'all' | 'image' | 'video' | 'failed';
+export type FeedFilter = "all" | "image" | "video" | "failed";
 
 /** The workbench source a take was generated with, if any (HEL-684). */
 export interface TakeWorkbenchCtx {
-	projectId: number;
-	stage: string;
-	sourceKind: 'asset' | 'shot';
-	sourceId: string;
-	label?: string;
+  projectId: number;
+  stage: string;
+  sourceKind: "asset" | "shot";
+  sourceId: string;
+  label?: string;
 }
 
 export function workbenchCtxOf(job: Job): TakeWorkbenchCtx | null {
-	const stamp = job.payload?.workbench;
-	if (!stamp || typeof stamp !== 'object') return null;
-	const s = stamp as Record<string, unknown>;
-	const projectId = s.project_id;
-	const stage = typeof s.stage === 'string' ? s.stage : '';
-	const sourceKind = s.source_kind === 'asset' || s.source_kind === 'shot' ? s.source_kind : null;
-	const sourceId = typeof s.source_id === 'string' ? s.source_id : '';
-	if (typeof projectId !== 'number' || !stage || !sourceKind || !sourceId) return null;
-	const label = typeof s.label === 'string' && s.label.trim() ? s.label : undefined;
-	return {
-		projectId,
-		stage,
-		sourceKind,
-		sourceId,
-		label,
-	};
+  const stamp = job.payload?.workbench;
+  if (!stamp || typeof stamp !== "object") return null;
+  const s = stamp as Record<string, unknown>;
+  const projectId = s.project_id;
+  const stage = typeof s.stage === "string" ? s.stage : "";
+  const sourceKind =
+    s.source_kind === "asset" || s.source_kind === "shot"
+      ? s.source_kind
+      : null;
+  const sourceId = typeof s.source_id === "string" ? s.source_id : "";
+  if (typeof projectId !== "number" || !stage || !sourceKind || !sourceId)
+    return null;
+  const label =
+    typeof s.label === "string" && s.label.trim() ? s.label : undefined;
+  return {
+    projectId,
+    stage,
+    sourceKind,
+    sourceId,
+    label,
+  };
 }
 
 export function jobValues(job: Job): Record<string, unknown> {
-	return (job.payload?.input_values ?? {}) as Record<string, unknown>;
+  return (job.payload?.input_values ?? {}) as Record<string, unknown>;
 }
 
-export function jobValueByRole(job: Job, wf: Workflow | undefined, ...roles: string[]): string | null {
-	if (!wf) return null;
-	const vals = jobValues(job);
-	for (const inp of wf.input_schema ?? []) {
-		const r = inputRole(inp);
-		if (r && roles.includes(r)) {
-			const v = vals[inp.nodeId];
-			if (v !== undefined && v !== null && String(v).trim() !== '') return String(v);
-		}
-	}
-	return null;
+export function jobValueByRole(
+  job: Job,
+  wf: Workflow | undefined,
+  ...roles: string[]
+): string | null {
+  if (!wf) return null;
+  const vals = jobValues(job);
+  for (const inp of wf.input_schema ?? []) {
+    const r = inputRole(inp);
+    if (r && roles.includes(r)) {
+      const v = vals[inp.nodeId];
+      if (v !== undefined && v !== null && String(v).trim() !== "")
+        return String(v);
+    }
+  }
+  return null;
 }
 
 export function promptOf(job: Job, wf: Workflow | undefined): string {
-	return jobValueByRole(job, wf, 'prompt') ?? '';
+  return jobValueByRole(job, wf, "prompt") ?? "";
 }
 
 export interface TakeInput {
-	label: string;
-	path: string;
-	kind: 'image' | 'video' | 'audio';
+  label: string;
+  path: string;
+  kind: "image" | "video" | "audio";
 }
 
 /** Media the take was generated from, in workflow order. */
 export function inputsOf(job: Job, wf: Workflow | undefined): TakeInput[] {
-	if (!wf) return [];
-	const kind = wf.kind;
-	const vals = jobValues(job);
-	const out: TakeInput[] = [];
-	let refIdx = 0;
-	for (const inp of wf.input_schema ?? []) {
-		if (!isMedia(inp)) continue;
-		const v = vals[inp.nodeId];
-		const list = Array.isArray(v) ? v : typeof v === 'string' && v ? [v] : [];
-		const mk = inp.kind.startsWith('video') ? 'video' : inp.kind.startsWith('audio') ? 'audio' : 'image';
-		list.forEach((p, i) => {
-			if (typeof p !== 'string' || !p) return;
-			let label = inp.label;
-			if (inp.kind === 'image_list') label = t('studio.slotRefN', { n: i + 1 });
-			else if (isFirstFrame(inp, kind)) label = t('studio.slotFirst');
-			else if (isLastFrame(inp, kind)) label = t('studio.slotLast');
-			else if (inp.kind === 'image' && inputRole(inp) !== 'mask') label = t('studio.slotRefN', { n: ++refIdx });
-			out.push({ label, path: p, kind: mk });
-		});
-	}
-	return out;
+  if (!wf) return [];
+  const kind = wf.kind;
+  const vals = jobValues(job);
+  const out: TakeInput[] = [];
+  let refIdx = 0;
+  for (const inp of wf.input_schema ?? []) {
+    if (!isMedia(inp)) continue;
+    const v = vals[inp.nodeId];
+    const list = Array.isArray(v) ? v : typeof v === "string" && v ? [v] : [];
+    const mk = inp.kind.startsWith("video")
+      ? "video"
+      : inp.kind.startsWith("audio")
+        ? "audio"
+        : "image";
+    list.forEach((p, i) => {
+      if (typeof p !== "string" || !p) return;
+      let label = inp.label;
+      if (inp.kind === "image_list") label = t("studio.slotRefN", { n: i + 1 });
+      else if (isFirstFrame(inp, kind)) label = t("studio.slotFirst");
+      else if (isLastFrame(inp, kind)) label = t("studio.slotLast");
+      else if (inp.kind === "image" && inputRole(inp) !== "mask")
+        label = t("studio.slotRefN", { n: ++refIdx });
+      out.push({ label, path: p, kind: mk });
+    });
+  }
+  return out;
 }
 
 /** 888×1184 · 种子 42 · 5 秒 — values that differ per take. */
-export function specOf(job: Job, wf: Workflow | undefined): Array<{ label: string; value: string }> {
-	const out: Array<{ label: string; value: string }> = [];
-	if (!wf) return out;
-	const w = jobValueByRole(job, wf, 'width');
-	const h = jobValueByRole(job, wf, 'height');
-	if (w && h) out.push({ label: t('desk.specSize'), value: `${w}×${h}` });
-	else {
-		const ds = classifySchema(wf.input_schema ?? [], wf.kind);
-		if (ds.ratio?.resolution) {
-			const vals = jobValues(job);
-			const size = resolutionSelectorSize(
-				String(vals[ds.ratio.nodeId] ?? ds.ratio.defaultValue ?? ''),
-				Number(vals[ds.ratio.resolution.megapixels] ?? ds.megapixels?.defaultValue),
-				ds.ratio.resolution.multiple,
-			);
-			if (size) out.push({ label: t('desk.specSize'), value: `${size.width}×${size.height}` });
-		}
-	}
-	const seed = jobValueByRole(job, wf, 'seed');
-	if (seed) out.push({ label: t('studio.seedLabel'), value: seed });
-	const dur = jobValueByRole(job, wf, 'duration');
-	if (dur) out.push({ label: t('studio.durationLabel'), value: t('desk.chipSeconds', { v: dur }) });
-	return out;
+export function specOf(
+  job: Job,
+  wf: Workflow | undefined,
+): Array<{ label: string; value: string }> {
+  const out: Array<{ label: string; value: string }> = [];
+  if (!wf) return out;
+  const w = jobValueByRole(job, wf, "width");
+  const h = jobValueByRole(job, wf, "height");
+  if (w && h) out.push({ label: t("desk.specSize"), value: `${w}×${h}` });
+  else {
+    const ds = classifySchema(wf.input_schema ?? [], wf.kind);
+    if (ds.ratio?.resolution) {
+      const vals = jobValues(job);
+      const size = resolutionSelectorSize(
+        String(vals[ds.ratio.nodeId] ?? ds.ratio.defaultValue ?? ""),
+        Number(
+          vals[ds.ratio.resolution.megapixels] ?? ds.megapixels?.defaultValue,
+        ),
+        ds.ratio.resolution.multiple,
+      );
+      if (size)
+        out.push({
+          label: t("desk.specSize"),
+          value: `${size.width}×${size.height}`,
+        });
+    }
+  }
+  const seed = jobValueByRole(job, wf, "seed");
+  if (seed) out.push({ label: t("studio.seedLabel"), value: seed });
+  const dur = jobValueByRole(job, wf, "duration");
+  if (dur)
+    out.push({
+      label: t("studio.durationLabel"),
+      value: t("desk.chipSeconds", { v: dur }),
+    });
+  return out;
 }
 
 export function isVideoOutput(job: Job, path: string): boolean {
-	return job.kind === 'video' && !/\.(png|jpe?g|webp)$/i.test(path);
+  return job.kind === "video" && !/\.(png|jpe?g|webp)$/i.test(path);
 }
 
 export function elapsedSec(job: Job, nowMs: number): number | null {
-	const from = job.started_at ? parseDbTs(job.started_at) : parseDbTs(job.created_at);
-	if (!Number.isFinite(from)) return null;
-	const to = job.completed_at ? parseDbTs(job.completed_at) : nowMs;
-	return Math.max(0, (to - from) / 1000);
+  const from = job.started_at
+    ? parseDbTs(job.started_at)
+    : parseDbTs(job.created_at);
+  if (!Number.isFinite(from)) return null;
+  const to = job.completed_at ? parseDbTs(job.completed_at) : nowMs;
+  return Math.max(0, (to - from) / 1000);
 }
 
 export function fmtDur(sec: number | null): string {
-	if (sec == null) return '—';
-	if (sec < 60) return t('desk.durSec', { s: Math.floor(sec) });
-	const m = Math.floor(sec / 60);
-	const s = Math.floor(sec % 60);
-	return t('desk.durMin', { m, s: String(s).padStart(2, '0') });
+  if (sec == null) return "—";
+  if (sec < 60) return t("desk.durSec", { s: Math.floor(sec) });
+  const m = Math.floor(sec / 60);
+  const s = Math.floor(sec % 60);
+  return t("desk.durMin", { m, s: String(s).padStart(2, "0") });
 }
 
 export function fmtClock(ms: number): string {
-	const d = new Date(ms);
-	return `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+  const d = new Date(ms);
+  return `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}`;
 }
 
 /** 今天 / 昨天 / 9月28日 heading for the feed. */
 export function dayLabel(ms: number, nowMs: number): string {
-	const d = new Date(ms);
-	const today = new Date(nowMs);
-	const startOf = (x: Date) => new Date(x.getFullYear(), x.getMonth(), x.getDate()).getTime();
-	const diff = Math.round((startOf(today) - startOf(d)) / 86_400_000);
-	if (diff === 0) return t('desk.today');
-	if (diff === 1) return t('desk.yesterday');
-	return t('desk.dayDate', { m: d.getMonth() + 1, d: d.getDate() });
+  const d = new Date(ms);
+  const today = new Date(nowMs);
+  const startOf = (x: Date) =>
+    new Date(x.getFullYear(), x.getMonth(), x.getDate()).getTime();
+  const diff = Math.round((startOf(today) - startOf(d)) / 86_400_000);
+  if (diff === 0) return t("desk.today");
+  if (diff === 1) return t("desk.yesterday");
+  return t("desk.dayDate", { m: d.getMonth() + 1, d: d.getDate() });
 }
 
 export function matchesFilter(job: Job, filter: FeedFilter): boolean {
-	if (filter === 'all') return true;
-	if (filter === 'failed') return jobStatusInfo(job).tone === 'fail';
-	return job.kind === filter;
+  if (filter === "all") return true;
+  if (filter === "failed") return jobStatusInfo(job).tone === "fail";
+  return job.kind === filter;
 }

calliope-web/src/lib/components/manage/CloudModels.svelte

@@ -0,0 +1,24 @@
+<script lang="ts">
+  import Button from "$lib/components/ui/Button.svelte";
+  let { kind = "all" }: { kind?: "all" | "image" | "video" } = $props();
+  const pending = [
+    { kind: "image", name: "云端 · 聚合 API（GPT-Image-2 · Nano Banana Pro）" },
+    { kind: "video", name: "云端 · 可灵" },
+    { kind: "video", name: "云端 · 即梦 CLI" },
+  ];
+</script>
+
+{#each pending.filter((item) => kind === "all" || item.kind === kind) as item (item.name)}<article
+    class="mg-card pending"
+  >
+    <div class="mg-row">
+      <span class="mg-dot"></span><b>{item.name}</b><span class="mg-grow"
+      ></span><span class="mg-tag">未接入</span>
+    </div>
+    <div class="mg-mono">尚未接入</div>
+    <div class="mg-muted">后续接入批次 · 当前不可用于生成</div>
+    <div class="mg-row">
+      <span class="mg-tag">0 个工作流使用</span><span class="mg-grow"
+      ></span><Button size="sm" disabled>等待接入</Button>
+    </div>
+  </article>{/each}

calliope-web/src/lib/components/manage/ComfyConnections.svelte

@@ -0,0 +1,646 @@
+<script lang="ts">
+  import CloudModels from "./CloudModels.svelte";
+  import {
+    createMutation,
+    createQuery,
+    useQueryClient,
+  } from "@tanstack/svelte-query";
+  import { untrack } from "svelte";
+  import { SvelteSet } from "svelte/reactivity";
+  import { fade } from "svelte/transition";
+
+  import Modal from "$lib/components/ui/Modal.svelte";
+  import Button from "$lib/components/ui/Button.svelte";
+  import ConfirmDialog from "$lib/components/ui/ConfirmDialog.svelte";
+  import Icon from "$lib/components/ui/Icon.svelte";
+
+  import { comfy, settings, workflows, type ComfyEndpoint } from "$lib/api";
+  import { toast } from "$lib/toast";
+  import { t } from "$lib/i18n.svelte";
+
+  const client = useQueryClient();
+
+  // ------------------------------------------------------------------
+  // Data
+  // ------------------------------------------------------------------
+  const settingsQuery = createQuery({
+    queryKey: ["settings"],
+    queryFn: settings.get,
+  });
+  // HEL-682: the library browses metadata only (view=meta) — the heavy
+  // workflow_json payloads are fetched per-row inside WorkflowLibrary
+  // exactly when an action needs them.
+  const wfMetaQuery = createQuery({
+    queryKey: ["workflows", "meta"],
+    queryFn: workflows.listMeta,
+  });
+
+  const endpoints = $derived($settingsQuery.data?.comfyui_endpoints ?? []);
+  const activeId = $derived(
+    $settingsQuery.data?.comfyui_active_id ?? endpoints[0]?.id ?? "",
+  );
+
+  // ------------------------------------------------------------------
+  // Local test records — presentational only; the connectivity facts
+  // always come from the server-side probe.
+  // ------------------------------------------------------------------
+  type TestRec = {
+    ok: boolean;
+    ms?: number;
+    version?: string;
+    at: number;
+    reason?: string;
+  };
+  const TESTS_KEY = "calliope.connections.tests";
+  let tests = $state<Record<string, TestRec>>({});
+  let pendingTests = $state<Record<string, boolean>>({});
+
+  function loadTests() {
+    try {
+      const raw = localStorage.getItem(TESTS_KEY);
+      if (raw) tests = JSON.parse(raw) as Record<string, TestRec>;
+    } catch {
+      tests = {};
+    }
+  }
+  function saveTests(map: Record<string, TestRec>) {
+    tests = map;
+    try {
+      localStorage.setItem(TESTS_KEY, JSON.stringify(map));
+    } catch {
+      /* storage disabled — the page still works without persistence */
+    }
+  }
+  function recordTest(id: string, rec: TestRec) {
+    saveTests({ ...tests, [id]: rec });
+  }
+
+  // ------------------------------------------------------------------
+  // Connection form (a6: right column, add / edit)
+  // ------------------------------------------------------------------
+  type FormMode = "idle" | "add" | "edit";
+  let formMode = $state<FormMode>("idle");
+  let editingId = $state<string | null>(null);
+  let form = $state({
+    name: "",
+    baseUrl: "",
+    authType: "none" as "none" | "bearer" | "header",
+    token: "",
+    headerName: "",
+    notes: "",
+  });
+  let formTest = $state<{ ok: boolean; ms?: number; version?: string } | null>(
+    null,
+  );
+  let formTestFailure = $state<{ message: string; detail: string } | null>(
+    null,
+  );
+  let formPending = $state(false);
+  let showErrors = $state(false);
+
+  function resetForm() {
+    formMode = "idle";
+    editingId = null;
+    form = {
+      name: "",
+      baseUrl: "",
+      authType: "none",
+      token: "",
+      headerName: "",
+      notes: "",
+    };
+    formTest = null;
+    formTestFailure = null;
+    showErrors = false;
+  }
+
+  export function startAdd() {
+    resetForm();
+    formMode = "add";
+  }
+
+  function startEdit(ep: ComfyEndpoint) {
+    resetForm();
+    formMode = "edit";
+    editingId = ep.id;
+    form = {
+      name: ep.name,
+      baseUrl: ep.base_url,
+      authType: ep.auth_type,
+      token: "",
+      headerName: ep.header_name ?? "",
+      notes: ep.notes ?? "",
+    };
+  }
+
+  function touchFormConnectivity() {
+    formTest = null;
+    formTestFailure = null;
+  }
+
+  const urlValid = $derived.by(() => {
+    try {
+      const u = new URL(form.baseUrl.trim());
+      return u.protocol === "http:" || u.protocol === "https:";
+    } catch {
+      return false;
+    }
+  });
+
+  const formErrors = $derived.by(() => {
+    const errs: Record<string, string> = {};
+    if (!form.name.trim()) errs.name = t("conn.errName");
+    if (!urlValid) errs.baseUrl = t("conn.errUrl");
+    if (form.authType === "header" && !form.headerName.trim())
+      errs.headerName = t("conn.errHeaderName");
+    return errs;
+  });
+  const formValid = $derived(Object.keys(formErrors).length === 0);
+
+  const editingEndpoint = $derived.by(() => {
+    if (formMode !== "edit" || !editingId) return null;
+    return endpoints.find((ep) => ep.id === editingId) ?? null;
+  });
+
+  async function runTest() {
+    showErrors = true;
+    if (!formValid) return;
+    formPending = true;
+    formTest = null;
+    formTestFailure = null;
+    try {
+      const res = await comfy.testEndpoint({
+        ...(formMode === "edit" && editingId ? { endpoint_id: editingId } : {}),
+        base_url: form.baseUrl.trim(),
+        auth_type: form.authType,
+        ...(form.authType !== "none" && form.token.trim()
+          ? { auth_token: form.token.trim() }
+          : {}),
+        ...(form.authType === "header" && form.headerName.trim()
+          ? { header_name: form.headerName.trim() }
+          : {}),
+        timeout_sec: 5,
+      });
+      if (res.ok) {
+        formTest = {
+          ok: true,
+          ms: res.elapsed_ms,
+          version: res.comfyui_version,
+        };
+      } else {
+        formTest = { ok: false };
+        formTestFailure = {
+          message: res.message ?? res.detail ?? res.error ?? "",
+          detail: res.detail ?? "",
+        };
+      }
+    } catch (err) {
+      formTest = { ok: false };
+      formTestFailure = {
+        message: err instanceof Error ? err.message : String(err),
+        detail: "",
+      };
+    } finally {
+      formPending = false;
+    }
+  }
+
+  const saveMutation = createMutation({
+    mutationFn: async () => {
+      const payload: Record<string, unknown> = {
+        name: form.name.trim(),
+        base_url: form.baseUrl.trim(),
+        auth_type: form.authType,
+        notes: form.notes.trim() || null,
+      };
+      if (form.authType !== "none" && form.token.trim()) {
+        payload["auth_token"] = form.token.trim();
+      }
+      if (form.authType === "header")
+        payload["header_name"] = form.headerName.trim();
+      if (formMode === "edit" && editingId) {
+        return comfy.updateEndpoint(editingId, payload);
+      }
+      return comfy.createEndpoint(
+        payload as Parameters<typeof comfy.createEndpoint>[0],
+      );
+    },
+    onSuccess: (res) => {
+      client.invalidateQueries({ queryKey: ["settings"] });
+      if (formTest?.ok && editingId) {
+        recordTest(editingId, {
+          ok: true,
+          ms: formTest.ms,
+          version: formTest.version,
+          at: Date.now(),
+        });
+      } else if (formTest?.ok && res.endpoints.length) {
+        // newest is the one we just created when adding
+        const created = res.endpoints.find(
+          (ep) => ep.base_url === form.baseUrl.trim(),
+        );
+        if (created)
+          recordTest(created.id, {
+            ok: true,
+            ms: formTest.ms,
+            version: formTest.version,
+            at: Date.now(),
+          });
+      }
+      toast.success(t("conn.saved"));
+      resetForm();
+    },
+    onError: (err) => {
+      toast.error(
+        t("conn.saveFailed", {
+          detail: err instanceof Error ? err.message : String(err),
+        }),
+      );
+    },
+  });
+
+  function submitSave() {
+    showErrors = true;
+    if (!formValid || !formTest?.ok || $saveMutation.isPending) return;
+    $saveMutation.mutate();
+  }
+
+  // ------------------------------------------------------------------
+  // Card actions
+  // ------------------------------------------------------------------
+  async function testEndpoint(ep: ComfyEndpoint) {
+    pendingTests = { ...pendingTests, [ep.id]: true };
+    try {
+      const res = await comfy.testEndpoint({
+        endpoint_id: ep.id,
+        timeout_sec: 10,
+      });
+      if (res.ok) {
+        recordTest(ep.id, {
+          ok: true,
+          ms: res.elapsed_ms,
+          version: res.comfyui_version,
+          at: Date.now(),
+        });
+      } else {
+        recordTest(ep.id, {
+          ok: false,
+          at: Date.now(),
+          reason: res.message ?? res.detail ?? res.error ?? "unknown",
+        });
+      }
+    } catch (err) {
+      recordTest(ep.id, {
+        ok: false,
+        at: Date.now(),
+        reason: err instanceof Error ? err.message : String(err),
+      });
+    } finally {
+      const next = { ...pendingTests };
+      delete next[ep.id];
+      pendingTests = next;
+    }
+  }
+
+  let deleteOpen = $state(false);
+  let deleteTarget = $state<ComfyEndpoint | null>(null);
+
+  function requestDelete(ep: ComfyEndpoint) {
+    deleteTarget = ep;
+    deleteOpen = true;
+  }
+
+  function workflowsBound(id: string): number {
+    return ($wfMetaQuery.data ?? []).filter(
+      (wf) => wf.endpoint_id === id || (!wf.endpoint_id && id === activeId),
+    ).length;
+  }
+
+  const deleteMessage = $derived.by(() => {
+    if (!deleteTarget) return "";
+    const n = workflowsBound(deleteTarget.id);
+    return n > 0
+      ? t("conn.delConfirmUsed", { name: deleteTarget.name })
+      : t("conn.delConfirmFree", { name: deleteTarget.name });
+  });
+
+  const deleteMutation = createMutation({
+    mutationFn: () => {
+      if (!deleteTarget) throw new Error("no target");
+      return comfy.deleteEndpoint(deleteTarget.id);
+    },
+    onSuccess: () => {
+      if (deleteTarget) {
+        const next = { ...tests };
+        delete next[deleteTarget.id];
+        saveTests(next);
+        if (editingId === deleteTarget.id) resetForm();
+      }
+      client.invalidateQueries({ queryKey: ["settings"] });
+      toast.success(t("conn.deleted"));
+    },
+    onError: (err) => {
+      toast.error(
+        t("conn.saveFailed", {
+          detail: err instanceof Error ? err.message : String(err),
+        }),
+      );
+    },
+  });
+
+  const defaultMutation = createMutation({
+    mutationFn: (id: string) => comfy.activateEndpoint(id),
+    onSuccess: () => {
+      client.invalidateQueries({ queryKey: ["settings"] });
+      toast.success(t("conn.defaultSetToast"));
+    },
+    onError: (err) => {
+      toast.error(
+        t("conn.saveFailed", {
+          detail: err instanceof Error ? err.message : String(err),
+        }),
+      );
+    },
+  });
+
+  function tokenTail(ep: ComfyEndpoint): string {
+    const tail = ep.token_tail ?? "";
+    return tail ? `****${tail}` : "";
+  }
+
+  loadTests();
+  $effect(() => {
+    // prune stale test records once the endpoint list is known
+    const data = $settingsQuery.data;
+    if (data) {
+      const keep = new Set(data.comfyui_endpoints.map((ep) => ep.id));
+      let changed = false;
+      const next: Record<string, TestRec> = {};
+      for (const [k, v] of Object.entries(tests)) {
+        if (keep.has(k)) next[k] = v;
+        else changed = true;
+      }
+      if (changed) saveTests(next);
+    }
+  });
+
+  // Probe every connection once per visit so the cards show real state
+  // instead of 「未测试」; results younger than a minute are reused.
+  const autoProbed = new SvelteSet<string>();
+  $effect(() => {
+    const list = endpoints;
+    untrack(() => {
+      const now = Date.now();
+      for (const ep of list) {
+        if (autoProbed.has(ep.id)) continue;
+        autoProbed.add(ep.id);
+        const rec = tests[ep.id];
+        if (!rec || now - rec.at > 60_000) void testEndpoint(ep);
+      }
+    });
+  });
+</script>
+
+{#if $settingsQuery.isLoading}<p class="mg-empty">
+    正在读取连接…
+  </p>{:else if $settingsQuery.isError}<p class="mg-empty" role="alert">
+    连接加载失败<Button onclick={() => $settingsQuery.refetch()}>重试</Button>
+  </p>{:else}
+  <div class="mg-cards">
+    {#each endpoints as ep (ep.id)}{@const rec = tests[ep.id]}
+      <article class="mg-card">
+        <div class="mg-row">
+          <span
+            class="mg-dot"
+            class:ok={rec?.ok === true}
+            class:err={rec?.ok === false}
+          ></span><b>{ep.name}</b><span class="mg-grow"></span><span
+            class="mg-latency"
+            >{rec?.ms != null ? Math.round(rec.ms) + "ms" : "—"}</span
+          >
+        </div>
+        <div class="mg-mono">{ep.base_url}</div>
+        <div class="mg-muted">
+          {rec?.ok === false
+            ? "连接失败 · " + (rec.reason ?? "原因未知")
+            : rec?.ok
+              ? "连接测试通过"
+              : "尚未测试"} · 队列未知 · 显存未知
+        </div>
+        <div class="mg-row">
+          <span class="mg-tag">{workflowsBound(ep.id)} 个工作流使用</span><span
+            class="mg-grow"
+          ></span><Button
+            size="sm"
+            loading={pendingTests[ep.id]}
+            onclick={() => testEndpoint(ep)}>测试连接</Button
+          ><Button variant="ghost" size="sm" onclick={() => startEdit(ep)}
+            >编辑</Button
+          >
+        </div>
+      </article>
+    {/each}
+    <CloudModels />
+    <button class="mg-card pending mg-add" onclick={startAdd}
+      ><Icon name="plus" size={22} />添加连接</button
+    >
+  </div>{/if}
+<Modal
+  open={formMode !== "idle"}
+  title={formMode === "add" ? t("conn.formTitleAdd") : t("conn.formTitleEdit")}
+  dismissible={!formPending && !$saveMutation.isPending}
+  onclose={resetForm}
+>
+  <aside
+    class="form-col"
+    class:open={formMode !== "idle"}
+    aria-label={t("conn.formTitleAdd")}
+  >
+    {#if formMode !== "idle"}
+      <div class="form-head">
+        <h2>
+          {formMode === "add"
+            ? t("conn.formTitleAdd")
+            : t("conn.formTitleEdit")}
+        </h2>
+      </div>
+
+      <label class="f-field">
+        <span class="f-label">{t("conn.fName")}<em>*</em></span>
+        <input
+          class="f-input"
+          class:invalid={showErrors && formErrors.name}
+          value={form.name}
+          disabled={formPending}
+          oninput={(e) => (form.name = e.currentTarget.value)}
+          placeholder={t("conn.fNamePh")}
+        />
+        {#if showErrors && formErrors.name}<span class="f-error"
+            >{formErrors.name}</span
+          >{/if}
+      </label>
+
+      <label class="f-field">
+        <span class="f-label">{t("conn.fBaseUrl")}<em>*</em></span>
+        <input
+          class="f-input mono"
+          class:invalid={showErrors && formErrors.baseUrl}
+          value={form.baseUrl}
+          disabled={formPending}
+          spellcheck="false"
+          oninput={(e) => {
+            form.baseUrl = e.currentTarget.value;
+            touchFormConnectivity();
+          }}
+          placeholder={t("conn.fBaseUrlPh")}
+        />
+        {#if showErrors && formErrors.baseUrl}
+          <span class="f-error">{formErrors.baseUrl}</span>
+        {/if}
+        <span class="f-hint">{t("conn.baseUrlHelp")}</span>
+      </label>
+
+      <div class="f-field">
+        <span class="f-label">{t("conn.fAuth")}</span>
+        <div class="mg-seg" role="radiogroup" aria-label={t("conn.fAuth")}>
+          {#each [["none", t("conn.authNone")], ["bearer", t("conn.authBearer")], ["header", t("conn.authHeader")]] as [value, label] (value)}
+            <button
+              type="button"
+              class="seg-item"
+              class:on={form.authType === value}
+              aria-pressed={form.authType === value}
+              onclick={() => {
+                form.authType = value as typeof form.authType;
+                touchFormConnectivity();
+              }}
+            >
+              {label}
+            </button>
+          {/each}
+        </div>
+        <span class="f-hint">{t("conn.authHelp")}</span>
+      </div>
+
+      {#if form.authType !== "none"}
+        {#if form.authType === "header"}
+          <label class="f-field">
+            <span class="f-label">{t("conn.fHeaderName")}<em>*</em></span>
+            <input
+              class="f-input mono"
+              class:invalid={showErrors && formErrors.headerName}
+              value={form.headerName}
+              disabled={formPending}
+              spellcheck="false"
+              oninput={(e) => {
+                form.headerName = e.currentTarget.value;
+                touchFormConnectivity();
+              }}
+              placeholder={t("conn.fHeaderNamePh")}
+            />
+            {#if showErrors && formErrors.headerName}
+              <span class="f-error">{formErrors.headerName}</span>
+            {/if}
+          </label>
+        {/if}
+        <label class="f-field">
+          <span class="f-label">
+            {t("conn.fToken")}
+            <span class="kh-inline mono">{t("conn.keyNoEcho")}</span>
+          </span>
+          <span class="key-wrap">
+            <input
+              class="f-input key-input"
+              type="password"
+              value={form.token}
+              disabled={formPending}
+              autocomplete="off"
+              oninput={(e) => {
+                form.token = e.currentTarget.value;
+                touchFormConnectivity();
+              }}
+              placeholder={formMode === "edit" && editingEndpoint?.has_token
+                ? t("conn.tokenSaved")
+                : "…"}
+            />
+            {#if formMode === "edit" && editingEndpoint?.has_token && tokenTail(editingEndpoint)}
+              <span class="kh mono">{tokenTail(editingEndpoint)}</span>
+            {/if}
+          </span>
+          <span class="f-hint">{t("conn.keyHelp")}</span>
+        </label>
+      {/if}
+
+      <label class="f-field">
+        <span class="f-label">{t("conn.fNotes")}</span>
+        <input
+          class="f-input"
+          value={form.notes}
+          disabled={formPending}
+          oninput={(e) => (form.notes = e.currentTarget.value)}
+          placeholder={t("conn.fNotesPh")}
+        />
+      </label>
+
+      {#if formTest?.ok}
+        <div class="result-bar ok" transition:fade={{ duration: 250 }}>
+          {t("conn.testOk", {
+            ms: formTest.ms ?? "?",
+            v: formTest.version ?? "?",
+          })}
+        </div>
+      {:else if formTest?.ok === false && formTestFailure}
+        <div class="result-bar err" transition:fade={{ duration: 250 }}>
+          <p>{t("conn.testFail", { reason: formTestFailure.message })}</p>
+          {#if formTestFailure.detail}
+            <p class="mono detail">{formTestFailure.detail}</p>
+          {/if}
+        </div>
+      {/if}
+
+      <div class="form-actions">
+        <span class="need-test" class:passed={formTest?.ok}
+          >{t("conn.needTest")}</span
+        >
+        <Button
+          variant="secondary"
+          size="sm"
+          loading={formPending}
+          onclick={runTest}
+        >
+          {formPending ? t("conn.testing") : t("conn.testBtn")}
+        </Button>
+        <Button
+          variant="primary"
+          size="sm"
+          disabled={!formValid || !formTest?.ok}
+          loading={$saveMutation.isPending}
+          onclick={submitSave}
+        >
+          {t("conn.save")}
+        </Button>
+      </div>
+    {/if}
+    {#if formMode === "edit" && editingId}<div class="mg-row">
+        {#if editingId !== activeId}<Button
+            size="sm"
+            onclick={() => $defaultMutation.mutate(editingId!)}>设为默认</Button
+          >{/if}<Button
+          size="sm"
+          variant="danger"
+          onclick={() => {
+            const target = editingEndpoint;
+            if (target) requestDelete(target);
+          }}>删除</Button
+        >
+      </div>{/if}
+  </aside></Modal
+>
+<ConfirmDialog
+  bind:open={deleteOpen}
+  title={t("conn.delTitle")}
+  message={deleteMessage}
+  confirmLabel={t("conn.delete")}
+  danger
+  onconfirm={() => $deleteMutation.mutate()}
+  oncancel={() => (deleteTarget = null)}
+/>

calliope-web/src/lib/components/manage/FamilyBadge.svelte

@@ -0,0 +1,54 @@
+<script lang="ts">
+  let {
+    model,
+    muted = false,
+    large = false,
+  }: { model: string | null; muted?: boolean; large?: boolean } = $props();
+  const family = $derived.by(() => {
+    const value = (model ?? "").toLowerCase();
+    const known: [string, string, string][] = [
+      ["qwen", "qwen", "Qwen"],
+      ["krea", "krea", "Kr2"],
+      ["flux", "flux", "FLX"],
+      ["z-image", "zimg", "Z"],
+      ["minimax", "h3", "H3"],
+      ["wan", "wan", "Wan"],
+      ["anima", "anima", "Ani"],
+    ];
+    const hit = known.find(([prefix]) => value.includes(prefix));
+    return hit
+      ? { color: `var(--family-${hit[1]})`, label: hit[2] }
+      : { color: "var(--tx-3)", label: model?.slice(0, 3) ?? "本地" };
+  });
+</script>
+
+<span
+  class="family-badge"
+  class:muted
+  class:large
+  style:--family-color={family.color}
+  aria-hidden="true">{family.label}</span
+>
+
+<style>
+  .family-badge {
+    width: 26px;
+    height: 26px;
+    border-radius: 7px;
+    display: grid;
+    place-items: center;
+    flex: none;
+    font: 700 9px var(--mono);
+    color: var(--family-ink);
+    background: var(--family-color);
+  }
+  .muted {
+    filter: grayscale(1) brightness(0.55);
+  }
+  .large {
+    width: 36px;
+    height: 36px;
+    border-radius: 9px;
+    font-size: 11px;
+  }
+</style>

calliope-web/src/lib/components/manage/LlmModels.svelte

@@ -0,0 +1,834 @@
+<script lang="ts">
+  import {
+    createMutation,
+    createQuery,
+    useQueryClient,
+  } from "@tanstack/svelte-query";
+  import { untrack } from "svelte";
+  import { SvelteSet } from "svelte/reactivity";
+  import { fade } from "svelte/transition";
+  import Modal from "$lib/components/ui/Modal.svelte";
+
+  import Button from "$lib/components/ui/Button.svelte";
+  import ConfirmDialog from "$lib/components/ui/ConfirmDialog.svelte";
+  import Icon from "$lib/components/ui/Icon.svelte";
+  import { settings, type LlmProfile, type Settings } from "$lib/api";
+  import { randomId } from "$lib/ids";
+  import { toast } from "$lib/toast";
+  import { t } from "$lib/i18n.svelte";
+
+  const client = useQueryClient();
+
+  const settingsQuery = createQuery({
+    queryKey: ["settings"],
+    queryFn: settings.get,
+  });
+
+  // A profile while being edited here: `api_key` is the public boolean,
+  // except for a freshly typed key waiting to be sent to the server.
+  type WorkingProfile = Omit<LlmProfile, "api_key"> & {
+    api_key: boolean | string;
+  };
+
+  // ------------------------------------------------------------------
+  // Local test-state persistence (last result / time / consecutive
+  // failures per profile). Purely presentational; connectivity facts
+  // always come from the server-side probe.
+  // ------------------------------------------------------------------
+  type TestRec = {
+    ok: boolean;
+    ms?: number;
+    at: number;
+    fails: number;
+    reason?: string;
+  };
+  const TESTS_KEY = "calliope.models.tests";
+  let tests = $state<Record<string, TestRec>>({});
+  let pendingTests = $state<Record<string, boolean>>({});
+
+  function loadTests() {
+    try {
+      const raw = localStorage.getItem(TESTS_KEY);
+      if (raw) tests = JSON.parse(raw) as Record<string, TestRec>;
+    } catch {
+      tests = {};
+    }
+  }
+  function saveTests(map: Record<string, TestRec>) {
+    tests = map;
+    try {
+      localStorage.setItem(TESTS_KEY, JSON.stringify(map));
+    } catch {
+      /* storage full / disabled — the page still works without persistence */
+    }
+  }
+  function recordTest(id: string, rec: TestRec) {
+    saveTests({ ...tests, [id]: rec });
+  }
+  function pruneTests(ids: string[]) {
+    const keep = new Set(ids);
+    const next: Record<string, TestRec> = {};
+    let changed = false;
+    for (const [k, v] of Object.entries(tests)) {
+      if (keep.has(k)) next[k] = v;
+      else changed = true;
+    }
+    if (changed) saveTests(next);
+  }
+
+  // ------------------------------------------------------------------
+  // Form state — add / edit custom LLM (spec §9.3)
+  // ------------------------------------------------------------------
+  type FormMode = "idle" | "add" | "edit";
+  let formMode = $state<FormMode>("idle");
+  let editingId = $state<string | null>(null);
+  let form = $state({
+    name: "",
+    baseUrl: "",
+    model: "",
+    apiKey: "",
+    timeout: 10,
+  });
+  let formTest = $state<{ ok: boolean; ms?: number } | null>(null);
+  let formTestFailure = $state<{ text: string; detail: string } | null>(null);
+  let formPending = $state(false);
+  let showErrors = $state(false);
+
+  const TIMEOUT_OPTIONS = [5, 10, 15, 30, 60];
+
+  function resetForm() {
+    formMode = "idle";
+    editingId = null;
+    form = { name: "", baseUrl: "", model: "", apiKey: "", timeout: 10 };
+    formTest = null;
+    formTestFailure = null;
+    showErrors = false;
+  }
+
+  export function startAdd() {
+    resetForm();
+    formMode = "add";
+  }
+
+  function startEdit(profile: LlmProfile) {
+    resetForm();
+    formMode = "edit";
+    editingId = profile.id;
+    form = {
+      name: profile.name,
+      baseUrl: profile.base_url,
+      model: profile.model,
+      apiKey: "",
+      timeout: 10,
+    };
+  }
+
+  // A connectivity-relevant edit invalidates the previous passing test.
+  function touchFormConnectivity() {
+    formTest = null;
+    formTestFailure = null;
+  }
+
+  const urlValid = $derived.by(() => {
+    try {
+      const u = new URL(form.baseUrl.trim());
+      return u.protocol === "http:" || u.protocol === "https:";
+    } catch {
+      return false;
+    }
+  });
+
+  const formErrors = $derived.by(() => {
+    const errs: Record<string, string> = {};
+    if (!form.name.trim()) errs.name = t("models.errName");
+    if (!urlValid) errs.baseUrl = t("models.errUrl");
+    if (!form.model.trim()) errs.model = t("models.errModel");
+    // Key is required when creating; on edit an empty field keeps the
+    // stored key (masked tail placeholder covers the affordance).
+    if (formMode === "add" && !form.apiKey.trim())
+      errs.apiKey = t("models.errKey");
+    return errs;
+  });
+  const formValid = $derived(Object.keys(formErrors).length === 0);
+
+  const editingProfile = $derived.by(() => {
+    if (formMode !== "edit" || !editingId || !$settingsQuery.data) return null;
+    return (
+      $settingsQuery.data.llm_profiles.find((p) => p.id === editingId) ?? null
+    );
+  });
+
+  // ------------------------------------------------------------------
+  // Failure classification → spec §9.6 copy (primary sentence) with the
+  // server-provided detail as a mono secondary line where it adds info.
+  // ------------------------------------------------------------------
+  function classifyFailure(
+    res: { error?: string; detail?: string; timeout_sec?: number },
+    fallbackSec: number,
+  ): { text: string; detail: string } {
+    const detail = res.detail ?? "";
+    switch (res.error) {
+      case "timeout":
+        return {
+          text: t("models.failTimeout", {
+            sec: res.timeout_sec ?? fallbackSec,
+          }),
+          detail,
+        };
+      case "auth":
+        return { text: t("models.failAuth"), detail };
+      case "not_found":
+        return { text: t("models.failNotFound"), detail };
+      case "http": {
+        if (detail.startsWith("HTTP 404"))
+          return { text: t("models.failNotOpenai"), detail };
+        const status = detail.split(":")[0].replace("HTTP ", "").trim();
+        return {
+          text: t("models.failHttp", { status: status || detail }),
+          detail,
+        };
+      }
+      case "connect":
+      default:
+        return { text: t("models.failConnect"), detail };
+    }
+  }
+
+  async function runTest() {
+    showErrors = true;
+    if (!urlValid || !form.model.trim()) return;
+    // On add the key is required before anything can be probed.
+    if (formMode === "add" && !form.apiKey.trim()) return;
+    formPending = true;
+    formTest = null;
+    formTestFailure = null;
+    try {
+      const res = await settings.testLlm({
+        ...(formMode === "edit" && editingId ? { profile_id: editingId } : {}),
+        base_url: form.baseUrl.trim(),
+        model: form.model.trim(),
+        ...(form.apiKey.trim() ? { api_key: form.apiKey.trim() } : {}),
+        timeout_sec: form.timeout,
+      });
+      if (res.ok) {
+        formTest = { ok: true, ms: res.elapsed_ms };
+      } else {
+        formTest = { ok: false };
+        formTestFailure = classifyFailure(res, form.timeout);
+      }
+    } catch (err) {
+      formTest = { ok: false };
+      formTestFailure = {
+        text: t("models.failConnect"),
+        detail: err instanceof Error ? err.message : String(err),
+      };
+    } finally {
+      formPending = false;
+    }
+  }
+
+  function llmProfilesFromSettings(s: Settings): WorkingProfile[] {
+    if (s.llm_profiles?.length) return s.llm_profiles.map((p) => ({ ...p }));
+    return [
+      {
+        id: s.llm_active_id || "legacy",
+        name: s.llm_model || "LLM",
+        base_url: s.llm_base_url,
+        model: s.llm_model,
+        api_key: s.llm_api_key,
+      },
+    ];
+  }
+
+  const saveMutation = createMutation({
+    mutationFn: async () => {
+      const s = $settingsQuery.data;
+      if (!s) throw new Error("settings unavailable");
+      const base = llmProfilesFromSettings(s);
+      const typedKey = form.apiKey.trim();
+      let list: WorkingProfile[];
+      if (formMode === "edit" && editingId) {
+        list = base.map((p) =>
+          p.id === editingId
+            ? {
+                ...p,
+                name: form.name.trim(),
+                base_url: form.baseUrl.trim(),
+                model: form.model.trim(),
+                ...(typedKey ? { api_key: typedKey } : {}),
+              }
+            : p,
+        );
+      } else {
+        list = [
+          ...base,
+          {
+            id: randomId(),
+            name: form.name.trim(),
+            base_url: form.baseUrl.trim(),
+            model: form.model.trim(),
+            api_key: typedKey,
+          },
+        ];
+      }
+      return settings.update({
+        llm_profiles: list.map((p) => ({
+          id: p.id,
+          name: p.name.trim(),
+          base_url: p.base_url.trim(),
+          model: p.model.trim(),
+          ...(typeof p.api_key === "string" && p.api_key.trim()
+            ? { api_key: p.api_key.trim() }
+            : {}),
+        })),
+      });
+    },
+    onSuccess: (saved) => {
+      client.invalidateQueries({ queryKey: ["settings"] });
+      // Carry the passing test over so the new card shows 已连接.
+      if (formTest?.ok) {
+        const id =
+          formMode === "edit" && editingId
+            ? editingId
+            : (saved.llm_profiles.at(-1)?.id ?? "");
+        if (id)
+          recordTest(id, {
+            ok: true,
+            ms: formTest.ms,
+            at: Date.now(),
+            fails: 0,
+          });
+      }
+      toast.success(t("models.saved"));
+      resetForm();
+    },
+    onError: (err) => {
+      toast.error(
+        t("models.saveFailed", {
+          detail: err instanceof Error ? err.message : String(err),
+        }),
+      );
+    },
+  });
+
+  function submitSave() {
+    showErrors = true;
+    if (!formValid || !formTest?.ok || $saveMutation.isPending) return;
+    $saveMutation.mutate();
+  }
+
+  // ------------------------------------------------------------------
+  // Card actions: per-profile test / delete / set default
+  // ------------------------------------------------------------------
+  async function testProfile(profile: LlmProfile) {
+    pendingTests = { ...pendingTests, [profile.id]: true };
+    try {
+      const res = await settings.testLlm({
+        profile_id: profile.id,
+        base_url: profile.base_url.trim(),
+        model: profile.model.trim(),
+        timeout_sec: 10,
+      });
+      const prev = tests[profile.id];
+      if (res.ok) {
+        recordTest(profile.id, {
+          ok: true,
+          ms: res.elapsed_ms,
+          at: Date.now(),
+          fails: 0,
+        });
+      } else {
+        const cls = classifyFailure(res, 10);
+        recordTest(profile.id, {
+          ok: false,
+          at: Date.now(),
+          fails: (prev?.fails ?? 0) + 1,
+          reason: cls.text + (cls.detail ? `（${cls.detail}）` : ""),
+        });
+      }
+    } catch (err) {
+      const prev = tests[profile.id];
+      recordTest(profile.id, {
+        ok: false,
+        at: Date.now(),
+        fails: (prev?.fails ?? 0) + 1,
+        reason: err instanceof Error ? err.message : String(err),
+      });
+    } finally {
+      const next = { ...pendingTests };
+      delete next[profile.id];
+      pendingTests = next;
+    }
+  }
+
+  let deleteOpen = $state(false);
+  let deleteTarget = $state<LlmProfile | null>(null);
+
+  function requestDelete(profile: LlmProfile) {
+    deleteTarget = profile;
+    deleteOpen = true;
+  }
+
+  function agentsUsing(s: Settings, profileId: string): number {
+    return Object.values(s.agent_llm_assignments ?? {}).filter(
+      (v) => v === profileId,
+    ).length;
+  }
+
+  const deleteMessage = $derived.by(() => {
+    const s = $settingsQuery.data;
+    if (!deleteTarget || !s) return "";
+    const n = agentsUsing(s, deleteTarget.id);
+    return n > 0
+      ? t("models.delConfirmUsed", { n })
+      : t("models.delConfirmFree");
+  });
+
+  const deleteMutation = createMutation({
+    mutationFn: async () => {
+      const s = $settingsQuery.data;
+      const target = deleteTarget;
+      if (!s || !target) throw new Error("no target");
+      const list = llmProfilesFromSettings(s).filter((p) => p.id !== target.id);
+      return settings.update({
+        llm_profiles: list.map((p) => ({
+          id: p.id,
+          name: p.name.trim(),
+          base_url: p.base_url.trim(),
+          model: p.model.trim(),
+        })),
+      });
+    },
+    onSuccess: () => {
+      if (deleteTarget) {
+        const next = { ...tests };
+        delete next[deleteTarget.id];
+        saveTests(next);
+        if (editingId === deleteTarget.id) resetForm();
+      }
+      client.invalidateQueries({ queryKey: ["settings"] });
+      toast.success(t("models.deleted"));
+    },
+    onError: (err) => {
+      toast.error(
+        t("models.saveFailed", {
+          detail: err instanceof Error ? err.message : String(err),
+        }),
+      );
+    },
+  });
+
+  const defaultMutation = createMutation({
+    mutationFn: (id: string) => settings.update({ llm_active_id: id }),
+    onSuccess: () => {
+      client.invalidateQueries({ queryKey: ["settings"] });
+      toast.success(t("models.defaultSetToast"));
+    },
+    onError: (err) => {
+      toast.error(
+        t("models.saveFailed", {
+          detail: err instanceof Error ? err.message : String(err),
+        }),
+      );
+    },
+  });
+
+  // ------------------------------------------------------------------
+  // Agent default-model panel (spec §9.4). The five AIGC agents; 视觉设计
+  // binds to the `style` role added for the upcoming style agent.
+  // ------------------------------------------------------------------
+  const AGENTS: {
+    role: string;
+    labelKey: string;
+    color: string;
+    char: string;
+    dark?: boolean;
+  }[] = [
+    {
+      role: "story",
+      labelKey: "models.agentStory",
+      color: "var(--avatar-1)",
+      char: "剧",
+      dark: true,
+    },
+    {
+      role: "style",
+      labelKey: "models.agentStyle",
+      color: "var(--avatar-2)",
+      char: "视",
+      dark: true,
+    },
+    {
+      role: "script",
+      labelKey: "models.agentScript",
+      color: "var(--avatar-3)",
+      char: "分",
+    },
+    {
+      role: "assets",
+      labelKey: "models.agentAssets",
+      color: "var(--avatar-4)",
+      char: "素",
+    },
+    {
+      role: "video",
+      labelKey: "models.agentVideo",
+      color: "var(--avatar-5)",
+      char: "镜",
+    },
+  ];
+
+  const assignMutation = createMutation({
+    mutationFn: (payload: Record<string, string | null>) =>
+      settings.update({ agent_llm_assignments: payload }),
+    onSuccess: () => {
+      client.invalidateQueries({ queryKey: ["settings"] });
+      toast.success(t("models.assignSaved"));
+    },
+    onError: (err) => {
+      client.invalidateQueries({ queryKey: ["settings"] });
+      toast.error(
+        t("models.saveFailed", {
+          detail: err instanceof Error ? err.message : String(err),
+        }),
+      );
+    },
+  });
+
+  function setAssignment(role: string, value: string) {
+    // Single-role delta only (HEL-619): replaying the whole cached
+    // snapshot races concurrent dropdown switches — an older snapshot
+    // could overwrite a newer choice. The server merges per role.
+    $assignMutation.mutate({ [role]: value === "" ? null : value });
+  }
+
+  function keyTail(profile: LlmProfile): string {
+    const tail = profile.api_key_tail ?? "";
+    return tail ? `sk-****${tail}` : "";
+  }
+
+  loadTests();
+  // Prune stale test records once the profile list is known.
+  $effect(() => {
+    const data = $settingsQuery.data;
+    if (data) pruneTests(data.llm_profiles.map((p) => p.id));
+  });
+
+  // Test each model once per visit (1-token probe) so the cards show real
+  // state instead of 「未测试」; results younger than 10 minutes are reused.
+  const autoProbed = new SvelteSet<string>();
+  $effect(() => {
+    const list = $settingsQuery.data?.llm_profiles ?? [];
+    untrack(() => {
+      const now = Date.now();
+      for (const p of list) {
+        if (autoProbed.has(p.id)) continue;
+        autoProbed.add(p.id);
+        const rec = tests[p.id];
+        if (!rec || now - rec.at > 600_000) void testProfile(p);
+      }
+    });
+  });
+</script>
+
+{#if $settingsQuery.isLoading}<p class="mg-empty">
+    正在读取模型…
+  </p>{:else if !$settingsQuery.data}<p class="mg-empty" role="alert">
+    模型加载失败<Button onclick={() => $settingsQuery.refetch()}>重试</Button>
+  </p>{:else}{@const s = $settingsQuery.data}{@const profiles = s.llm_profiles}
+  <div class="mg-cards">
+    {#each profiles as profile (profile.id)}{@const rec = tests[profile.id]}
+      <article class="mg-card">
+        <div class="mg-row">
+          <span
+            class="mg-dot"
+            class:ok={rec?.ok === true}
+            class:err={rec?.ok === false}
+          ></span><b>{profile.name}</b><span class="mg-grow"></span><span
+            class="mg-latency"
+            >{rec?.ms != null ? Math.round(rec.ms) + "ms" : "—"}</span
+          >
+        </div>
+        <div class="mg-mono">{profile.base_url}</div>
+        <div class="mg-muted">{profile.model}</div>
+        <div class="mg-dim">
+          {rec?.ok === false
+            ? (rec.reason ?? "连接失败")
+            : rec?.ok
+              ? "连接测试通过"
+              : "尚未测试"}
+        </div>
+        <div class="mg-row">
+          <span class="mg-tag">{agentsUsing(s, profile.id)} 个智能体使用</span
+          ><span class="mg-grow"></span><Button
+            size="sm"
+            loading={pendingTests[profile.id]}
+            onclick={() => testProfile(profile)}>测试连接</Button
+          ><Button size="sm" variant="ghost" onclick={() => startEdit(profile)}
+            >编辑</Button
+          >
+        </div>
+      </article>{/each}<button class="mg-card pending mg-add" onclick={startAdd}
+      ><Icon name="plus" size={22} />添加大语言模型</button
+    >
+    <div class="model-assignments">
+      <section class="mg-field">
+        <div class="mg-row">
+          <h2>{t("models.agentsTitle")}</h2>
+          <span class="panel-hint">{t("models.agentsHint")}</span>
+        </div>
+        <div class="mg-assignments">
+          {#each AGENTS as agent (agent.role)}
+            <label class="agent-cell">
+              <span
+                class="avatar"
+                style:background={agent.color}
+                class:dark={agent.dark}
+              >
+                {agent.char}
+              </span>
+              <span class="agent-name">{t(agent.labelKey)}</span>
+              <select
+                class="a-select"
+                value={s.agent_llm_assignments?.[agent.role] ?? ""}
+                onchange={(e) =>
+                  setAssignment(agent.role, e.currentTarget.value)}
+              >
+                <option value="">{t("models.agentDefault")}</option>
+                {#each profiles as p (p.id)}
+                  <option
+                    value={p.id}
+                    class:unavailable={tests[p.id]?.ok === false}
+                  >
+                    {p.name} — {p.model}{tests[p.id]?.ok === false
+                      ? t("models.unavailable")
+                      : ""}
+                  </option>
+                {/each}
+              </select>
+            </label>
+          {/each}
+        </div>
+      </section>
+    </div>
+  </div>{/if}
+<Modal
+  open={formMode !== "idle"}
+  title={formMode === "edit"
+    ? t("models.formTitleEdit")
+    : t("models.formTitleAdd")}
+  dismissible={!formPending}
+  onclose={resetForm}
+  size="md"
+  ><aside
+    class="form-col"
+    class:open={formMode !== "idle"}
+    aria-label={t("models.formTitleAdd")}
+  >
+    {#if formMode === "idle"}
+      <div class="form-idle">
+        <Icon name="sparkle" size={20} />
+        <p>{t("models.idleFormHint")}</p>
+      </div>
+    {:else}
+      <div class="form-head">
+        <h2>
+          {formMode === "add"
+            ? t("models.formTitleAdd")
+            : t("models.formTitleEdit")}
+        </h2>
+
+        <button
+          type="button"
+          class="icon-btn"
+          aria-label={t("models.formClose")}
+          onclick={resetForm}
+        >
+          <Icon name="close" size={16} />
+        </button>
+      </div>
+
+      <label class="f-field">
+        <span class="f-label">{t("models.fName")}<em>*</em></span>
+        <input
+          class="f-input"
+          class:invalid={showErrors && formErrors.name}
+          value={form.name}
+          disabled={formPending}
+          oninput={(e) => (form.name = e.currentTarget.value)}
+          placeholder={t("models.fNamePh")}
+        />
+        {#if showErrors && formErrors.name}<span class="f-error"
+            >{formErrors.name}</span
+          >{/if}
+      </label>
+
+      <div class="f-field">
+        <span class="f-label">{t("models.fApiType")}</span>
+        <div class="seg" role="radiogroup" aria-label={t("models.fApiType")}>
+          <span class="seg-item selected" role="radio" aria-checked="true">
+            {t("models.apiOpenai")}
+          </span>
+          <span class="seg-item disabled" aria-disabled="true">
+            {t("models.apiAnthropic")}
+          </span>
+          <span class="seg-item disabled" aria-disabled="true"
+            >{t("models.apiOther")}</span
+          >
+        </div>
+        <span class="f-hint">{t("models.apiTypeHelp")}</span>
+      </div>
+
+      <label class="f-field">
+        <span class="f-label">{t("models.fBaseUrl")}<em>*</em></span>
+        <input
+          class="f-input mono"
+          class:invalid={showErrors && formErrors.baseUrl}
+          value={form.baseUrl}
+          disabled={formPending}
+          spellcheck="false"
+          oninput={(e) => {
+            form.baseUrl = e.currentTarget.value;
+            touchFormConnectivity();
+          }}
+          placeholder="http://192.168.200.18:11434/v1"
+        />
+        {#if showErrors && formErrors.baseUrl}
+          <span class="f-error">{formErrors.baseUrl}</span>
+        {/if}
+        <span class="f-hint">{t("models.baseUrlHelp")}</span>
+      </label>
+
+      <label class="f-field">
+        <span class="f-label">{t("models.fModel")}<em>*</em></span>
+        <input
+          class="f-input mono"
+          class:invalid={showErrors && formErrors.model}
+          value={form.model}
+          disabled={formPending}
+          spellcheck="false"
+          oninput={(e) => {
+            form.model = e.currentTarget.value;
+            touchFormConnectivity();
+          }}
+          placeholder="deepseek-chat"
+        />
+        {#if showErrors && formErrors.model}
+          <span class="f-error">{formErrors.model}</span>
+        {/if}
+        <span class="f-hint">{t("models.modelHelp")}</span>
+      </label>
+
+      <label class="f-field">
+        <span class="f-label">
+          {t("models.fApiKey")}<em>*</em>
+          <span class="kh-inline mono">{t("models.keyNoEcho")}</span>
+        </span>
+        <span class="key-wrap">
+          <input
+            class="f-input key-input"
+            type="password"
+            class:invalid={showErrors && formErrors.apiKey}
+            value={form.apiKey}
+            disabled={formPending}
+            autocomplete="off"
+            oninput={(e) => {
+              form.apiKey = e.currentTarget.value;
+              touchFormConnectivity();
+            }}
+            placeholder={formMode === "edit" && editingProfile?.api_key
+              ? t("models.keyKeepHint")
+              : "sk-…"}
+          />
+          {#if formMode === "edit" && editingProfile?.api_key && keyTail(editingProfile)}
+            <span class="kh mono">{keyTail(editingProfile)}</span>
+          {/if}
+        </span>
+        {#if showErrors && formErrors.apiKey}
+          <span class="f-error">{formErrors.apiKey}</span>
+        {/if}
+        <span class="f-hint">{t("models.keyHelp")}</span>
+      </label>
+
+      <label class="f-field">
+        <span class="f-label">{t("models.fTimeout")}</span>
+        <select
+          class="f-input"
+          value={form.timeout}
+          disabled={formPending}
+          onchange={(e) => {
+            form.timeout = Number(e.currentTarget.value);
+            touchFormConnectivity();
+          }}
+        >
+          {#each TIMEOUT_OPTIONS as sec (sec)}
+            <option value={sec}>{t("models.timeoutSec", { n: sec })}</option>
+          {/each}
+        </select>
+      </label>
+
+      {#if formTest?.ok}
+        <div class="result-bar ok" transition:fade={{ duration: 250 }}>
+          {t("models.testOk", {
+            ms: formTest.ms ?? "?",
+            model: form.model.trim(),
+          })}
+        </div>
+      {:else if formTest?.ok === false && formTestFailure}
+        <div class="result-bar err" transition:fade={{ duration: 250 }}>
+          <p>
+            {t("models.testFail", { reason: formTestFailure.text })}
+          </p>
+          {#if formTestFailure.detail}
+            <p class="mono detail">{formTestFailure.detail}</p>
+          {/if}
+        </div>
+      {/if}
+
+      <div class="form-actions">
+        <span class="need-test" class:passed={formTest?.ok}
+          >{t("models.needTest")}</span
+        >
+        <Button
+          variant="secondary"
+          size="sm"
+          loading={formPending}
+          onclick={runTest}
+        >
+          {formPending ? t("models.testing") : t("models.testBtn")}
+        </Button>
+        <Button
+          variant="primary"
+          size="sm"
+          disabled={!formValid || !formTest?.ok}
+          loading={$saveMutation.isPending}
+          onclick={submitSave}
+        >
+          {t("models.save")}
+        </Button>
+      </div>
+    {/if}
+    {#if formMode === "edit" && editingId}<div class="mg-row">
+        {#if editingId !== $settingsQuery.data?.llm_active_id}<Button
+            size="sm"
+            onclick={() => $defaultMutation.mutate(editingId!)}>设为默认</Button
+          >{/if}<Button
+          size="sm"
+          variant="danger"
+          onclick={() => {
+            const target = editingProfile;
+            if (target) requestDelete(target);
+          }}>删除</Button
+        >
+      </div>{/if}
+  </aside></Modal
+>
+<ConfirmDialog
+  bind:open={deleteOpen}
+  title={t("models.delTitle")}
+  message={deleteMessage}
+  confirmLabel={t("models.delete")}
+  danger
+  onconfirm={() => $deleteMutation.mutate()}
+  oncancel={() => (deleteTarget = null)}
+/>

calliope-web/src/lib/components/manage/ManagementPage.svelte

@@ -0,0 +1,44 @@
+<script lang="ts">
+  import type { Snippet } from "svelte";
+  import AppShell from "$lib/components/shell/AppShell.svelte";
+  import type { NavId } from "$lib/components/shell/nav";
+  import "./management.css";
+  let {
+    title,
+    active,
+    tools,
+    actions,
+    children,
+    scene = "manage",
+  }: {
+    scene?: "manage" | "gold";
+    title: string;
+    active: NavId;
+    tools?: Snippet;
+    actions?: Snippet;
+    children: Snippet;
+  } = $props();
+</script>
+
+<AppShell {title} {active} workspace>
+  {#snippet pageHeader()}
+    <header
+      class="management-header"
+      style:--scene={scene === "gold" ? "var(--gold)" : "var(--sc-manage)"}
+    >
+      <b>{title}</b>{@render tools?.()}<span class="mg-grow"
+      ></span>{@render actions?.()}
+      <!-- The approved header reserves this inline width independently of demo copy. -->
+      <span class="mg-header-reserve" aria-hidden="true"
+        ><span></span><span>&emsp;&emsp;&emsp;&emsp;</span></span
+      >
+    </header>
+  {/snippet}
+  <section
+    class="management-page"
+    aria-label={title}
+    style:--scene={scene === "gold" ? "var(--gold)" : "var(--sc-manage)"}
+  >
+    {@render children()}
+  </section>
+</AppShell>

calliope-web/src/lib/components/manage/management.css

@@ -0,0 +1,854 @@
+/* HEL-726 approved management primitives. Geometry and colours use theme tokens. */
+.management-header {
+  --icon-stroke: var(--manage-icon-stroke);
+  letter-spacing: var(--manage-header-letter-spacing);
+  box-sizing: border-box;
+  --button-weight: var(--manage-control-weight);
+  --button-primary-weight: var(--manage-control-weight);
+  --button-height: var(--manage-control-height);
+  --button-font-size: var(--manage-control-size);
+  --button-radius: var(--manage-control-radius);
+  --button-secondary-bg: var(--bg-3);
+  --button-sm-height: var(--manage-button-height);
+  --button-sm-padding: var(--manage-button-padding);
+  --button-secondary-radius: var(--manage-button-radius);
+  height: var(--head);
+  flex: none;
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 0 16px;
+  border-bottom: 1px solid var(--line);
+  background: var(--glass);
+  backdrop-filter: blur(10px);
+  position: relative;
+  z-index: 3;
+  min-width: 0;
+  color: var(--tx-1);
+}
+.management-header > b {
+  font-size: 14px;
+  font-weight: 600;
+  white-space: nowrap;
+}
+.management-page {
+  --icon-stroke: var(--manage-icon-stroke);
+  box-sizing: border-box;
+  --button-weight: var(--manage-control-weight);
+  --button-primary-weight: var(--manage-control-weight);
+  --button-height: var(--manage-control-height);
+  --button-font-size: var(--manage-control-size);
+  --button-radius: var(--manage-control-radius);
+  --button-secondary-bg: var(--bg-3);
+  animation: management-enter var(--t-slow) var(--ease-out);
+  --button-sm-height: var(--manage-button-height);
+  --button-sm-padding: var(--manage-button-padding);
+  --button-sm-radius: var(--manage-button-radius);
+  --button-primary-height: var(--manage-control-height);
+  --button-primary-padding: 12px;
+  --button-primary-radius: var(--manage-control-radius);
+  --button-secondary-radius: var(--manage-button-radius);
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  min-height: 0;
+  color: var(--tx-1);
+  font-size: 13px;
+  overflow: hidden;
+}
+.mg-grow {
+  flex: 1;
+  min-width: 0;
+}
+.manage {
+  --scene: var(--sc-manage);
+}
+.mg-layout {
+  box-sizing: border-box;
+  flex: 1;
+  display: grid;
+  grid-template-columns: var(--manage-filter-width) minmax(0, 1fr) var(
+      --manage-detail-width
+    );
+  min-height: 0;
+}
+.mg-side {
+  box-sizing: border-box;
+  border-right: 1px solid var(--line);
+  background: var(--manage-panel-background);
+  padding: 12px 10px;
+  overflow: auto;
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
+.mg-side .mg-label {
+  font-size: 11px;
+  color: var(--tx-3);
+  padding: 10px 8px 4px;
+  letter-spacing: 0.5px;
+}
+.mg-filter {
+  border: 0;
+  background: none;
+  text-align: left;
+  flex: none;
+  font-family: inherit;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  height: 32px;
+  padding: 0 10px;
+  border-radius: 8px;
+  font-size: 12.5px;
+  color: var(--tx-2);
+  cursor: pointer;
+}
+.mg-filter:hover {
+  background: rgb(var(--ink) / 0.04);
+  color: var(--tx-1);
+}
+.mg-filter.on {
+  background: var(--bg-3);
+  color: var(--tx-1);
+}
+.mg-filter .n {
+  margin-left: auto;
+  font: 500 11px var(--mono);
+  color: var(--tx-3);
+}
+.mg-main {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  min-width: 0;
+  overflow: hidden;
+}
+.mg-tools {
+  box-sizing: border-box;
+  flex: none;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 12px 16px;
+  border-bottom: 1px solid var(--line);
+}
+.mg-table {
+  flex: 1;
+  overflow: auto;
+}
+.mg-table table {
+  table-layout: var(--manage-table-layout, fixed);
+  width: 100%;
+  border-collapse: collapse;
+  font-size: 12.5px;
+}
+.mg-table th {
+  position: sticky;
+  top: 0;
+  background: var(--bg-0);
+  z-index: 1;
+  box-sizing: var(--manage-cell-box, content-box);
+  text-align: left;
+  font-weight: 500;
+  color: var(--tx-3);
+  font-size: 11.5px;
+  padding: 8px 12px;
+  border-bottom: 1px solid var(--line);
+}
+.mg-table td {
+  box-sizing: var(--manage-cell-box, content-box);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  padding: 8px 12px;
+  border-bottom: 1px solid var(--line);
+  vertical-align: middle;
+}
+.mg-table tr {
+  cursor: pointer;
+  transition: background var(--t-fast);
+}
+.mg-table tbody tr:hover {
+  background: rgb(var(--ink) / 0.025);
+}
+.mg-table tr.on {
+  background: color-mix(in srgb, var(--sc-manage) 10%, transparent);
+}
+.mg-table .nm b {
+  font-weight: 500;
+  display: block;
+}
+.mg-table .nm small {
+  font: 11px var(--mono);
+  color: var(--tx-3);
+}
+.mg-detail {
+  box-sizing: border-box;
+  min-width: 0;
+  border-left: 1px solid var(--line);
+  background: var(--manage-panel-background);
+  overflow: auto;
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.mg-map {
+  display: grid;
+  grid-template-columns: 1fr 18px 1fr;
+  gap: 6px;
+  align-items: center;
+  font-size: 12px;
+}
+.mg-map .a {
+  padding: 6px 8px;
+  border-radius: 6px;
+  background: var(--bg-0);
+  border: 1px solid var(--line);
+  font-family: var(--mono);
+  font-size: 11px;
+  color: var(--tx-2);
+}
+.mg-map .b {
+  padding: 6px 8px;
+  border-radius: 6px;
+  background: color-mix(in srgb, var(--sc-image) 8%, transparent);
+  border: 1px solid color-mix(in srgb, var(--sc-image) 30%, transparent);
+}
+.mg-media {
+  flex: 1;
+  overflow: auto;
+  padding: 14px 16px;
+  columns: 5 200px;
+  column-gap: 10px;
+}
+.mg-media > article {
+  break-inside: avoid;
+  margin-bottom: 10px;
+  border-radius: var(--manage-media-radius);
+  overflow: hidden;
+  border: 1px solid var(--line);
+  position: relative;
+}
+.mg-media img {
+  display: block;
+  width: 100%;
+}
+.mg-cards {
+  flex: 1;
+  overflow: auto;
+  padding: 16px;
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(var(--manage-card-min), 1fr));
+  gap: 12px;
+  align-content: start;
+  grid-auto-rows: max-content;
+}
+.mg-card {
+  box-sizing: border-box;
+  min-width: 0;
+  border-radius: var(--manage-card-radius);
+  border: 1px solid var(--line-2);
+  background: var(--bg-2);
+  padding: var(--manage-card-padding);
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.mg-card .mg-row b {
+  font-size: 13.5px;
+}
+.mg-latency {
+  font: 600 11px var(--mono);
+  color: var(--ok);
+}
+
+.mg-filter small {
+  margin-left: auto;
+  font: 500 11px var(--mono);
+  color: var(--tx-3);
+}
+.mg-search {
+  height: 34px;
+  border-radius: var(--r-sm);
+  background: var(--well);
+  border: 1px solid var(--line-2);
+  padding: 0 10px;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  color: var(--tx-3);
+  min-width: 0;
+  box-sizing: border-box;
+}
+.mg-search input {
+  min-width: 0;
+  width: 100%;
+  background: transparent;
+  border: 0;
+  outline: 0;
+  color: var(--tx-1);
+  font: inherit;
+  font-size: 13px;
+  padding: 0;
+}
+.mg-search:focus-within {
+  border-color: var(--scene);
+}
+.mg-search kbd {
+  font: 10px var(--mono);
+  color: var(--tx-3);
+}
+.mg-seg {
+  box-sizing: border-box;
+  display: flex;
+  padding: 3px;
+  border-radius: var(--manage-segment-radius);
+  background: var(--well);
+  border: 1px solid var(--line);
+  gap: 2px;
+}
+.mg-seg button {
+  flex: 1;
+  white-space: nowrap;
+  height: 28px;
+  border: 0;
+  border-radius: var(--manage-segment-option-radius);
+  background: transparent;
+  color: var(--tx-2);
+  font: inherit;
+  font-size: 12.5px;
+  padding: 0;
+  cursor: pointer;
+  transition: all var(--t-base) var(--ease-out);
+}
+.mg-seg button.on {
+  background: var(--bg-3);
+  color: var(--tx-1);
+  box-shadow: var(--sh-1);
+}
+.mg-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+  flex-wrap: wrap;
+}
+.mg-muted {
+  color: var(--tx-2);
+}
+.mg-dim {
+  color: var(--tx-3);
+  font-size: 12px;
+}
+.mg-mono {
+  font: 11px/var(--lh-body) var(--mono);
+  color: var(--tx-3);
+  overflow-wrap: anywhere;
+}
+.mg-tag {
+  box-sizing: border-box;
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  white-space: nowrap;
+  height: 18px;
+  padding: 0 6px;
+  border-radius: 4px;
+  border: 1px solid var(--line);
+  background: rgb(var(--ink) / 0.05);
+  font-size: 11px;
+  color: var(--tx-2);
+}
+.mg-tag.ok {
+  color: var(--ok);
+  border-color: color-mix(in srgb, var(--ok) 30%, transparent);
+  background: color-mix(in srgb, var(--ok) 7%, transparent);
+}
+.mg-tag.warn {
+  color: var(--warn);
+  border-color: color-mix(in srgb, var(--warn) 30%, transparent);
+  background: color-mix(in srgb, var(--warn) 7%, transparent);
+}
+.mg-tag.err {
+  color: var(--err);
+  border-color: color-mix(in srgb, var(--err) 30%, transparent);
+  background: color-mix(in srgb, var(--err) 7%, transparent);
+}
+.mg-field {
+  box-sizing: border-box;
+  background: var(--bg-2);
+  border: 1px solid var(--line);
+  border-radius: var(--manage-field-radius);
+  padding: 10px 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.mg-field h3 {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 12px;
+  font-weight: 700;
+  color: var(--tx-2);
+  margin: 0;
+}
+.mg-detail h2 {
+  font-size: 14px;
+  margin: 0;
+  font-weight: 600;
+}
+.mg-name {
+  min-width: 0;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+.mg-name b {
+  font-size: 12.5px;
+  font-weight: 500;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.mg-name small {
+  font: 11px var(--mono);
+  color: var(--tx-3);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.mg-empty {
+  padding: 40px 16px;
+  text-align: center;
+  color: var(--tx-3);
+  font-size: 12px;
+}
+.mg-card.pending {
+  border-style: dashed;
+  background: transparent;
+}
+.mg-add {
+  min-height: var(--manage-add-min-height);
+  display: grid;
+  place-items: center;
+  color: var(--tx-3);
+  cursor: pointer;
+  font: inherit;
+}
+.mg-dot {
+  height: 7px;
+  width: 7px;
+  border-radius: 50%;
+  background: var(--tx-3);
+  flex: none;
+}
+.mg-dot.ok {
+  background: var(--ok);
+}
+.mg-dot.err {
+  background: var(--err);
+}
+.mg-click {
+  border: 0;
+  background: none;
+  text-align: left;
+  color: inherit;
+  font: inherit;
+  cursor: pointer;
+  padding: 0;
+  display: flex;
+  gap: 8px;
+  align-items: center;
+  min-width: 0;
+  width: 100%;
+}
+.management-page button:focus-visible,
+.management-header button:focus-visible {
+  outline: 2px solid var(--scene, var(--info));
+  outline-offset: 2px;
+}
+
+/* Shared connection/model edit form, hosted by the existing focus-trapping Modal. */
+.form-col {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  min-width: 0;
+}
+.form-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.form-head h2 {
+  font-size: 14px;
+  margin: 0;
+}
+.f-field {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+  font-size: 12px;
+  color: var(--tx-2);
+}
+.f-label {
+  font-weight: 500;
+  display: flex;
+  gap: 4px;
+}
+.f-label em {
+  color: var(--err);
+}
+.f-input {
+  height: 34px;
+  border: 1px solid var(--line-2);
+  border-radius: var(--r-sm);
+  background: var(--well);
+  padding: 0 10px;
+  color: var(--tx-1);
+  font: inherit;
+  width: 100%;
+  box-sizing: border-box;
+}
+textarea.f-input {
+  height: 70px;
+  padding: 8px 10px;
+  resize: vertical;
+}
+.f-input.invalid {
+  border-color: var(--err);
+}
+.f-input:focus {
+  outline: 2px solid var(--info);
+  outline-offset: 1px;
+}
+.f-error {
+  color: var(--err);
+  font-size: 11px;
+}
+.f-hint,
+.need-test {
+  color: var(--tx-3);
+  font-size: 11px;
+}
+.need-test.passed {
+  color: var(--ok);
+}
+.form-actions {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 8px;
+  flex-wrap: wrap;
+  padding-top: 10px;
+  border-top: 1px solid var(--line);
+}
+.form-test-result,
+.form-test-failure {
+  padding: 10px;
+  border: 1px solid var(--line);
+  border-radius: var(--r-sm);
+  font-size: 12px;
+}
+.form-test-failure {
+  color: var(--err);
+}
+.form-col pre {
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  font: 11px var(--mono);
+}
+.mg-assignments {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 10px;
+}
+.agent-cell {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  min-width: 0;
+  font-size: 12px;
+}
+.agent-cell .avatar {
+  display: none;
+}
+.model-assignments {
+  grid-column: 1/-1;
+}
+.wf-map-editor {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  padding: 10px 12px;
+  border: 1px dashed var(--line-2);
+  border-radius: var(--r-sm);
+}
+.wf-slot-row {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+.wf-out-check {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  min-width: 0;
+  flex: 1;
+}
+.wf-slot-name {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  font-size: 12px;
+}
+.wf-slot-id,
+.wf-map-hint {
+  font-size: 11px;
+  color: var(--tx-3);
+}
+.wf-slot-row select {
+  width: 90px;
+}
+
+.result-bar {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  font-size: 12px;
+}
+.result-bar.ok {
+  color: var(--ok);
+}
+.result-bar.err {
+  color: var(--err);
+}
+.result-bar .detail {
+  font-size: 11px;
+  overflow-wrap: anywhere;
+}
+.key-wrap {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.kh,
+.kh-inline {
+  font: 11px var(--mono);
+  color: var(--tx-3);
+}
+
+.mg-table .mg-row {
+  flex-wrap: nowrap;
+}
+
+.mg-field p {
+  margin: 0;
+}
+.mg-card > .mg-row {
+  flex-wrap: nowrap;
+}
+.mg-card > .mg-row > b {
+  min-width: 0;
+}
+.mg-options {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  flex-wrap: wrap;
+}
+.mg-option {
+  box-sizing: border-box;
+  height: 28px;
+  padding: 0 10px;
+  border-radius: var(--r-sm);
+  border: 1px solid var(--line-2);
+  font: inherit;
+  font-size: 12px;
+  color: var(--tx-2);
+  background: transparent;
+  cursor: pointer;
+  transition: all var(--t-fast);
+}
+.mg-option.on {
+  background: color-mix(in srgb, var(--sc-manage) 12%, var(--bg-3));
+  border-color: color-mix(in srgb, var(--sc-manage) 60%, transparent);
+  color: var(--tx-1);
+}
+.mg-option:disabled {
+  opacity: 0.45;
+  cursor: not-allowed;
+}
+.mg-step {
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  gap: 4px;
+  width: 114px;
+  height: 28px;
+  border: 1px solid var(--line-2);
+  border-radius: var(--r-sm);
+  background: var(--bg-0);
+}
+.mg-step button {
+  width: 24px;
+  height: 26px;
+  border: 0;
+  color: var(--tx-2);
+  background: transparent;
+  cursor: pointer;
+}
+.mg-step input {
+  width: 50px;
+  padding: 0;
+  border: 0;
+  background: transparent;
+  color: var(--tx-1);
+  font: 600 12px var(--mono);
+  text-align: center;
+  appearance: textfield;
+  -moz-appearance: textfield;
+}
+.mg-step input::-webkit-inner-spin-button {
+  appearance: none;
+}
+@keyframes management-enter {
+  from {
+    opacity: 0;
+    transform: translateY(6px);
+  }
+  to {
+    opacity: 1;
+    transform: none;
+  }
+}
+
+.mg-card .mg-muted {
+  font-size: 12px;
+}
+
+.mg-pin {
+  width: var(--manage-pin-size);
+  height: var(--manage-pin-size);
+  padding: 0;
+  border: 0;
+  border-radius: var(--manage-pin-radius);
+  display: grid;
+  place-items: center;
+  color: var(--tx-3);
+  background: transparent;
+  cursor: pointer;
+  transition:
+    color var(--t-fast),
+    background var(--t-fast);
+}
+.mg-pin:hover {
+  background: rgb(var(--ink) / 0.08);
+  color: var(--tx-1);
+}
+.mg-pin[aria-pressed="true"] {
+  color: var(--gold);
+}
+.mg-pin[aria-pressed="true"] svg {
+  fill: currentColor;
+}
+
+/* Confirmed full-width task table. Shared table/controls remain the single source. */
+.task-table {
+  --manage-table-layout: var(--task-table-layout);
+  --manage-cell-box: border-box;
+}
+.task-thumbnail-column {
+  width: var(--task-thumbnail-column);
+}
+.task-progress-column {
+  width: var(--task-progress-column);
+}
+.task-tabs {
+  width: var(--task-tabs-width);
+  margin-left: var(--task-tabs-offset);
+}
+.task-search {
+  width: var(--task-search-width);
+}
+.task-thumbnail {
+  display: grid;
+  place-items: center;
+  width: var(--task-thumbnail-width);
+  height: var(--task-thumbnail-height);
+  border-radius: var(--task-thumbnail-radius);
+  border: 0;
+  padding: 0;
+  overflow: hidden;
+  color: var(--tx-3);
+  background: var(--bg-2);
+  cursor: pointer;
+}
+.task-thumbnail img {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+.task-name {
+  font-weight: 500;
+}
+.task-progress {
+  height: var(--task-progress-height);
+  margin-top: var(--task-progress-gap);
+  border-radius: var(--task-progress-radius);
+  background: rgb(var(--ink) / 0.1);
+  overflow: hidden;
+}
+.task-progress i {
+  display: block;
+  height: 100%;
+  background: var(--task-progress-fill);
+  box-shadow: var(--task-progress-shadow);
+  transition: width var(--task-progress-duration) linear;
+}
+.task-progress-unknown {
+  color: var(--tx-3);
+  margin-left: var(--task-progress-gap);
+}
+.task-table .mg-tag.run,
+.task-dialog .mg-tag.run {
+  color: var(--task-running-color);
+  border-color: var(--task-running-border);
+  background: var(--task-running-background);
+}
+.task-dialog {
+  height: auto;
+  overflow: visible;
+  gap: 12px;
+}
+.task-output {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+.task-output img,
+.task-output video {
+  width: 100%;
+  max-height: var(--task-preview-height);
+  object-fit: contain;
+  background: var(--media-bg);
+}
+
+.mg-header-reserve {
+  display: inline-flex;
+  flex: none;
+  align-items: center;
+  gap: 6px;
+  padding: 0 var(--manage-header-reserve-padding);
+  border: 1px solid transparent;
+  font: var(--manage-header-reserve-font);
+  letter-spacing: inherit;
+}
+.mg-header-reserve > :first-child {
+  width: var(--manage-header-reserve-dot);
+}
+.mg-header-reserve > :last-child {
+  white-space: pre;
+}

calliope-web/src/lib/components/omni/AssetPickerModal.svelte

@@ -166,7 +166,6 @@
 						>
 							<div class="thumb">
 								{#if isVideo}
-									<!-- svelte-ignore a11y_media_has_caption -->
 									<video src={src} muted playsinline preload="metadata" onerror={hideBroken}></video>
 								{:else if (opt.kind ?? kind) === 'audio'}
 									<Icon name="music" size={28} />

calliope-web/src/lib/components/omni/MediaTile.svelte

@@ -78,6 +78,7 @@
 		// The same path can arrive twice (e.g. a scene clip that was also
 		// uploaded to the playground). Duplicate keys crash the keyed each
 		// in the picker grid, so dedupe by path first.
+		// eslint-disable-next-line svelte/prefer-svelte-reactivity -- Local path deduplication scratch set for one filter pass; only the filtered asset array escapes.
 		const seen = new Set<string>();
 		return assetOptions.filter((o) => {
 			const match =
@@ -144,7 +145,6 @@
 		{:else if value && thumbSrc && isImageKind}
 			<img class="tile-thumb" src={thumbSrc} alt={displayLabel} onerror={hideBrokenThumb} />
 		{:else if value && isVideoKind && thumbSrc}
-			<!-- svelte-ignore a11y_media_has_caption -->
 			<video class="tile-thumb" src={thumbSrc} muted playsinline></video>
 		{:else if value}
 			<div class="tile-file">

calliope-web/src/lib/components/omni/PillPopover.svelte

@@ -63,6 +63,7 @@
 		if (!open || !panelEl) return;
 		document.body.appendChild(panelEl);
 		return () => {
+			// eslint-disable-next-line svelte/no-dom-manipulating -- Template creates panel contents; effect owns body portal placement and teardown. Remove the moved root on close/unmount; listener cleanup stays separate.
 			panelEl?.remove();
 		};
 	});

calliope-web/src/lib/components/omni/PillSelect.svelte

@@ -85,6 +85,7 @@
 		if (!open || !menuEl) return;
 		document.body.appendChild(menuEl);
 		return () => {
+			// eslint-disable-next-line svelte/no-dom-manipulating -- Template creates menu contents; effect owns body portal placement and teardown. Remove the moved root on close/unmount; selection and listener cleanup stay intact.
 			menuEl?.remove();
 		};
 	});

calliope-web/src/lib/components/shell/CommandPalette.svelte

@@ -1,218 +1,234 @@
 <script lang="ts">
-	import { goto } from '$app/navigation';
-	import { createQuery } from '@tanstack/svelte-query';
-	import { toStore } from 'svelte/store';
-	import { projects } from '$lib/api';
-	import { t } from '$lib/i18n.svelte';
-	import Icon from '$lib/components/ui/Icon.svelte';
-	import Modal from '$lib/components/ui/Modal.svelte';
-	import type { IconName } from '$lib/components/ui/icons';
-	import { NAV } from './nav';
+  import type { Pathname } from "$app/types";
+  import { resolve } from "$app/paths";
+  import { goto } from "$app/navigation";
+  import { createQuery } from "@tanstack/svelte-query";
+  import { toStore } from "svelte/store";
+  import { projects } from "$lib/api";
+  import { t } from "$lib/i18n.svelte";
+  import Icon from "$lib/components/ui/Icon.svelte";
+  import Modal from "$lib/components/ui/Modal.svelte";
+  import type { IconName } from "$lib/components/ui/icons";
+  import { NAV } from "./nav";
 
-	/** Ctrl/⌘K 搜索：跳到任一页面或项目（↑↓ 选择，Enter 打开，Esc 关闭）. */
-	let { open = $bindable(false) }: { open?: boolean } = $props();
+  /** Ctrl/⌘K 搜索：跳到任一页面或项目（↑↓ 选择，Enter 打开，Esc 关闭）. */
+  let { open = $bindable(false) }: { open?: boolean } = $props();
 
-	interface Entry {
-		key: string;
-		group: 'pages' | 'projects';
-		label: string;
-		icon: IconName;
-		href: string;
-	}
+  interface Entry {
+    key: string;
+    group: "pages" | "projects";
+    label: string;
+    icon: IconName;
+    href: Pathname;
+  }
 
-	const listId = `palette-${Math.random().toString(36).slice(2, 9)}`;
-	let query = $state('');
-	let activeIndex = $state(0);
-	let list = $state<HTMLDivElement | null>(null);
+  const listId = `palette-${Math.random().toString(36).slice(2, 9)}`;
+  let query = $state("");
+  let activeIndex = $state(0);
+  let list = $state<HTMLDivElement | null>(null);
 
-	const projectsQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['projects'],
-			queryFn: projects.list,
-			enabled: open,
-			staleTime: 30_000,
-		})),
-	);
+  const projectsQuery = createQuery(
+    toStore(() => ({
+      queryKey: ["projects"],
+      queryFn: projects.list,
+      enabled: open,
+      staleTime: 30_000,
+    })),
+  );
 
-	const entries = $derived.by<Entry[]>(() => {
-		const pages: Entry[] = NAV.map((item) => ({
-			key: `page-${item.id}`,
-			group: 'pages',
-			label: t(item.labelKey),
-			icon: item.icon,
-			href: item.href,
-		}));
-		const projectEntries: Entry[] = ($projectsQuery.data ?? []).map((p) => ({
-			key: `project-${p.id}`,
-			group: 'projects',
-			label: p.title,
-			icon: 'story',
-			href: `/workbench/${p.id}`,
-		}));
-		const q = query.trim().toLowerCase();
-		const all = [...pages, ...projectEntries];
-		return q ? all.filter((e) => e.label.toLowerCase().includes(q)) : all;
-	});
+  const entries = $derived.by<Entry[]>(() => {
+    const pages: Entry[] = NAV.map((item) => ({
+      key: `page-${item.href}`,
+      group: "pages",
+      label: item.label,
+      icon: item.icon,
+      href: item.href,
+    }));
+    const projectEntries: Entry[] = ($projectsQuery.data ?? []).map((p) => ({
+      key: `project-${p.id}`,
+      group: "projects",
+      label: p.title,
+      icon: "story",
+      href: `/workbench/${p.id}`,
+    }));
+    const q = query.trim().toLowerCase();
+    const all = [...pages, ...projectEntries];
+    return q ? all.filter((e) => e.label.toLowerCase().includes(q)) : all;
+  });
 
-	$effect(() => {
-		void query;
-		activeIndex = 0;
-	});
+  $effect(() => {
+    void query;
+    activeIndex = 0;
+  });
 
-	$effect(() => {
-		if (!open) query = '';
-	});
+  $effect(() => {
+    if (!open) query = "";
+  });
 
-	function optionId(index: number) {
-		return `${listId}-${index}`;
-	}
+  function optionId(index: number) {
+    return `${listId}-${index}`;
+  }
 
-	function go(entry: Entry) {
-		open = false;
-		void goto(entry.href);
-	}
+  function go(entry: Entry) {
+    open = false;
+    void goto(resolve(entry.href));
+  }
 
-	function move(step: number) {
-		if (entries.length === 0) return;
-		activeIndex = (activeIndex + step + entries.length) % entries.length;
-		list?.querySelector(`#${optionId(activeIndex)}`)?.scrollIntoView({ block: 'nearest' });
-	}
+  function move(step: number) {
+    if (entries.length === 0) return;
+    activeIndex = (activeIndex + step + entries.length) % entries.length;
+    list
+      ?.querySelector(`#${optionId(activeIndex)}`)
+      ?.scrollIntoView({ block: "nearest" });
+  }
 
-	function handleKeydown(event: KeyboardEvent) {
-		if (event.key === 'ArrowDown') {
-			event.preventDefault();
-			move(1);
-		} else if (event.key === 'ArrowUp') {
-			event.preventDefault();
-			move(-1);
-		} else if (event.key === 'Enter') {
-			const entry = entries[activeIndex];
-			if (entry) {
-				event.preventDefault();
-				go(entry);
-			}
-		}
-	}
+  function handleKeydown(event: KeyboardEvent) {
+    if (event.key === "ArrowDown") {
+      event.preventDefault();
+      move(1);
+    } else if (event.key === "ArrowUp") {
+      event.preventDefault();
+      move(-1);
+    } else if (event.key === "Enter") {
+      const entry = entries[activeIndex];
+      if (entry) {
+        event.preventDefault();
+        go(entry);
+      }
+    }
+  }
 
-	function focusOnMount(node: HTMLInputElement) {
-		requestAnimationFrame(() => node.focus());
-	}
+  function focusOnMount(node: HTMLInputElement) {
+    requestAnimationFrame(() => node.focus());
+  }
 </script>
 
-<Modal bind:open title={t('shell.searchTitle')}>
-	<div class="palette">
-		<div class="palette-search">
-			<Icon name="search" size={16} />
-			<input
-				use:focusOnMount
-				class="palette-input"
-				type="text"
-				bind:value={query}
-				placeholder={t('shell.searchPlaceholder')}
-				role="combobox"
-				aria-expanded="true"
-				aria-controls={listId}
-				aria-autocomplete="list"
-				aria-activedescendant={entries.length ? optionId(activeIndex) : undefined}
-				aria-label={t('shell.searchTitle')}
-				onkeydown={handleKeydown}
-			/>
-		</div>
-		<div class="palette-list" id={listId} role="listbox" bind:this={list} aria-label={t('shell.searchTitle')}>
-			{#if entries.length === 0}
-				<p class="palette-empty">{t('shell.searchEmpty', { q: query.trim() })}</p>
-			{/if}
-			{#each entries as entry, i (entry.key)}
-				{#if i === 0 || entries[i - 1].group !== entry.group}
-					<div class="a-menu-group" role="presentation">
-						{entry.group === 'pages' ? t('shell.searchGroupPages') : t('shell.searchGroupProjects')}
-					</div>
-				{/if}
-				<div
-					id={optionId(i)}
-					class="a-menu-item"
-					class:active={i === activeIndex}
-					role="option"
-					tabindex="-1"
-					aria-selected={i === activeIndex}
-					onpointermove={() => (activeIndex = i)}
-					onmousedown={(e) => e.preventDefault()}
-					onclick={() => go(entry)}
-					onkeydown={handleKeydown}
-				>
-					<Icon name={entry.icon} size={15} />
-					<span class="a-menu-label">{entry.label}</span>
-					<span class="a-menu-meta mono">{entry.href}</span>
-				</div>
-			{/each}
-		</div>
-		<p class="palette-hint">
-			<span class="a-kbd">↑↓</span>{t('shell.searchHintMove')}
-			<span class="a-kbd">Enter</span>{t('shell.searchHintOpen')}
-			<span class="a-kbd">Esc</span>{t('shell.searchHintClose')}
-		</p>
-	</div>
+<Modal bind:open title={t("shell.searchTitle")}>
+  <div class="palette">
+    <div class="palette-search">
+      <Icon name="search" size={16} />
+      <input
+        use:focusOnMount
+        class="palette-input"
+        type="text"
+        bind:value={query}
+        placeholder={t("shell.searchPlaceholder")}
+        role="combobox"
+        aria-expanded="true"
+        aria-controls={listId}
+        aria-autocomplete="list"
+        aria-activedescendant={entries.length
+          ? optionId(activeIndex)
+          : undefined}
+        aria-label={t("shell.searchTitle")}
+        onkeydown={handleKeydown}
+      />
+    </div>
+    <div
+      class="palette-list"
+      id={listId}
+      role="listbox"
+      bind:this={list}
+      aria-label={t("shell.searchTitle")}
+    >
+      {#if entries.length === 0}
+        <p class="palette-empty">
+          {t("shell.searchEmpty", { q: query.trim() })}
+        </p>
+      {/if}
+      {#each entries as entry, i (entry.key)}
+        {#if i === 0 || entries[i - 1].group !== entry.group}
+          <div class="a-menu-group" role="presentation">
+            {entry.group === "pages"
+              ? t("shell.searchGroupPages")
+              : t("shell.searchGroupProjects")}
+          </div>
+        {/if}
+        <div
+          id={optionId(i)}
+          class="a-menu-item"
+          class:active={i === activeIndex}
+          role="option"
+          tabindex="-1"
+          aria-selected={i === activeIndex}
+          onpointermove={() => (activeIndex = i)}
+          onmousedown={(e) => e.preventDefault()}
+          onclick={() => go(entry)}
+          onkeydown={handleKeydown}
+        >
+          <Icon name={entry.icon} size={15} />
+          <span class="a-menu-label">{entry.label}</span>
+          <span class="a-menu-meta mono">{entry.href}</span>
+        </div>
+      {/each}
+    </div>
+    <p class="palette-hint">
+      <span class="a-kbd">↑↓</span>{t("shell.searchHintMove")}
+      <span class="a-kbd">Enter</span>{t("shell.searchHintOpen")}
+      <span class="a-kbd">Esc</span>{t("shell.searchHintClose")}
+    </p>
+  </div>
 </Modal>
 
 <style>
-	.palette {
-		display: flex;
-		flex-direction: column;
-		gap: var(--sp-3);
-	}
-	.palette-search {
-		display: flex;
-		align-items: center;
-		gap: var(--sp-3);
-		padding: 0 var(--sp-5);
-		border: 1px solid var(--line);
-		border-radius: var(--r-md);
-		background: var(--bg-3);
-		color: var(--text-3);
-		transition: border-color var(--d-state) ease;
-	}
-	.palette-search:focus-within {
-		border-color: var(--accent-line);
-	}
-	.palette-input {
-		flex: 1;
-		min-width: 0;
-		height: 40px;
-		border: 0;
-		outline: 0;
-		background: transparent;
-		color: var(--text);
-		font-family: inherit;
-		font-size: var(--fs-section);
-	}
-	.palette-input::placeholder {
-		color: var(--text-3);
-	}
-	.palette-list {
-		max-height: min(360px, 50vh);
-		overflow-y: auto;
-	}
-	.palette-empty {
-		margin: 0;
-		padding: var(--sp-6) var(--sp-4);
-		font-size: var(--fs-aux);
-		color: var(--text-3);
-		text-align: center;
-	}
-	.palette-hint {
-		display: flex;
-		align-items: center;
-		gap: var(--sp-2);
-		margin: 0;
-		font-size: var(--fs-mini);
-		color: var(--text-3);
-	}
-	.palette-hint .a-kbd:not(:first-child) {
-		margin-left: var(--sp-3);
-	}
-	@media (hover: none) {
-		.palette-hint {
-			display: none;
-		}
-	}
+  .palette {
+    display: flex;
+    flex-direction: column;
+    gap: var(--sp-3);
+  }
+  .palette-search {
+    display: flex;
+    align-items: center;
+    gap: var(--sp-3);
+    padding: 0 var(--sp-5);
+    border: 1px solid var(--line);
+    border-radius: var(--r-md);
+    background: var(--bg-3);
+    color: var(--text-3);
+    transition: border-color var(--d-state) ease;
+  }
+  .palette-search:focus-within {
+    border-color: var(--accent-line);
+  }
+  .palette-input {
+    flex: 1;
+    min-width: 0;
+    height: 40px;
+    border: 0;
+    outline: 0;
+    background: transparent;
+    color: var(--text);
+    font-family: inherit;
+    font-size: var(--fs-section);
+  }
+  .palette-input::placeholder {
+    color: var(--text-3);
+  }
+  .palette-list {
+    max-height: min(360px, 50vh);
+    overflow-y: auto;
+  }
+  .palette-empty {
+    margin: 0;
+    padding: var(--sp-6) var(--sp-4);
+    font-size: var(--fs-aux);
+    color: var(--text-3);
+    text-align: center;
+  }
+  .palette-hint {
+    display: flex;
+    align-items: center;
+    gap: var(--sp-2);
+    margin: 0;
+    font-size: var(--fs-mini);
+    color: var(--text-3);
+  }
+  .palette-hint .a-kbd:not(:first-child) {
+    margin-left: var(--sp-3);
+  }
+  @media (hover: none) {
+    .palette-hint {
+      display: none;
+    }
+  }
 </style>

calliope-web/src/lib/components/shell/ProjectScope.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import { createQuery } from '@tanstack/svelte-query';
 	import { toStore } from 'svelte/store';
 	import { projects } from '$lib/api';
@@ -56,7 +57,7 @@
 	<ShellPop bind:open label={t('shell.scopeHint')} width="300px">
 		<a
 			class="a-menu-item"
-			href="/"
+			href={resolve('/')}
 			aria-current={onProjectsList ? 'page' : undefined}
 			onclick={() => (open = false)}
 		>
@@ -70,7 +71,7 @@
 		{:else if $projectsQuery.isError}
 			<p class="scope-note err">{t('shell.scopeLoadFailed')}</p>
 		{:else if recent.length === 0}
-			<a class="a-menu-item" href="/" onclick={() => (open = false)}>
+			<a class="a-menu-item" href={resolve('/')} onclick={() => (open = false)}>
 				<Icon name="plus" size={15} />
 				<span class="a-menu-label">{t('shell.scopeEmpty')}</span>
 			</a>
@@ -78,7 +79,7 @@
 			{#each recent as project (project.id)}
 				<a
 					class="a-menu-item"
-					href="/workbench/{project.id}"
+					href={resolve(`/workbench/${project.id}`)}
 					aria-current={project.id === projectId ? 'true' : undefined}
 					onclick={() => (open = false)}
 				>

calliope-web/src/lib/components/shell/QueueTray.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import { createQuery } from '@tanstack/svelte-query';
 	import { toStore } from 'svelte/store';
 	import { workflows, type Job } from '$lib/api';
@@ -93,7 +94,7 @@
 		{:else}
 			{#each recent as job (job.id)}
 				{@const info = jobStatusInfo(job)}
-				<a class="a-menu-item tray-row" href="/tasks" title={info.detail} onclick={() => (open = false)}>
+				<a class="a-menu-item tray-row" href={resolve('/tasks')} title={info.detail} onclick={() => (open = false)}>
 					<span class="tray-copy">
 						<span class="a-menu-label">{workflowName(job)}</span>
 						<span class="tray-meta">{jobSourceLabel(job)} · <span class="mono">{timeOf(job)}</span></span>
@@ -102,7 +103,7 @@
 				</a>
 			{/each}
 		{/if}
-		<a class="a-menu-item tray-all" href="/tasks" onclick={() => (open = false)}>
+		<a class="a-menu-item tray-all" href={resolve('/tasks')} onclick={() => (open = false)}>
 			<span class="a-menu-label">{t('shell.trayAll')}</span>
 		</a>
 	</ShellPop>

calliope-web/src/lib/components/shell/ShellPop.svelte

@@ -103,7 +103,8 @@
 		return Number.isFinite(ms) ? ms : fallback;
 	}
 
-	function popIn(_node: Element) {
+	function popIn(node: Element) {
+		void node;
 		const reduced = document.documentElement.dataset.reduce === '1';
 		const sheet = window.matchMedia(SHEET_QUERY).matches;
 		if (reduced) {
@@ -123,7 +124,8 @@
 		};
 	}
 
-	function fadeScrim(_node: Element) {
+	function fadeScrim(node: Element) {
+		void node;
 		return { duration: cssMs('--d-pop', 180), css: (t: number) => `opacity: ${t}` };
 	}
 </script>

calliope-web/src/lib/components/shell/ThemeChoices.svelte

@@ -0,0 +1,274 @@
+<script lang="ts">
+  import { THEMES, theme, setTheme, themeStorageUnavailable } from "$lib/theme";
+  let {
+    compact = false,
+    tiles = false,
+  }: { compact?: boolean; tiles?: boolean } = $props();
+  function move(event: KeyboardEvent) {
+    const steps: Record<string, number> = {
+      ArrowRight: 1,
+      ArrowDown: 1,
+      ArrowLeft: -1,
+      ArrowUp: -1,
+    };
+    const step = steps[event.key];
+    if (!step && event.key !== "Home" && event.key !== "End") return;
+    event.preventDefault();
+    const group = (event.currentTarget as HTMLElement).closest(
+      ".choices",
+    ) as HTMLElement;
+    const buttons = [...group.querySelectorAll<HTMLButtonElement>("button")];
+    const current = buttons.indexOf(
+      document.activeElement as HTMLButtonElement,
+    );
+    const next =
+      event.key === "Home"
+        ? 0
+        : event.key === "End"
+          ? buttons.length - 1
+          : (current + step + buttons.length) % buttons.length;
+    buttons[next]?.focus();
+  }
+</script>
+
+<div
+  class="choices"
+  class:compact
+  class:tiles
+  role="group"
+  aria-label="外观主题"
+>
+  {#each THEMES as item (item.id)}
+    <button
+      class="choice"
+      class:selected={$theme === item.id}
+      aria-pressed={$theme === item.id}
+      onkeydown={move}
+      onclick={(event) => setTheme(item.id, event)}
+    >
+      <span class="preview" data-theme={item.id} aria-hidden="true"
+        ><span class="rail"></span><span class="list"
+          ><i></i><i></i><i></i>{#if tiles}<i></i>{/if}</span
+        ><span class="stage"
+          ><i></i><b
+            >{#if tiles}<em></em>{/if}</b
+          ></span
+        >{#if tiles}<span class="preview-text"></span>{/if}</span
+      >
+      <span class="copy"
+        ><strong
+          >{tiles && item.id === "night"
+            ? item.name + " "
+            : item.name}{#if tiles && item.id === "night"}<span
+              class="mg-tag theme-default">默认</span
+            >{/if}</strong
+        ><small>{tiles ? item.tone : item.english}</small>{#if !tiles}<span
+            >{item.description}</span
+          >{/if}</span
+      >
+      <span class="check" class:tile-check={tiles} aria-hidden="true"
+        >{$theme === item.id ? "✓" : ""}</span
+      >
+    </button>
+  {/each}
+</div>
+{#if $themeStorageUnavailable}<p class="notice" role="status">
+    浏览器禁止本地存储：本次有效，其他操作不受影响
+  </p>{/if}
+
+<style>
+  .choices {
+    display: grid;
+    grid-template-columns: repeat(4, minmax(0, 1fr));
+    gap: 10px;
+  }
+  .choices.tiles {
+    --choice-check-width: 0px;
+    --choice-hover-background: var(--bg-2);
+    --choice-display: flex;
+    --choice-box-sizing: border-box;
+    --choice-gap: 6px;
+    --choice-copy-gap: 6px;
+    --choice-tone-align: stretch;
+    --choice-preview-art: var(--theme-preview-art);
+    --choice-preview-radius: 8px;
+    --choice-art-border: 0;
+    --choice-dock-radius: 3px;
+    --choice-dock-width: 100%;
+    --choice-radius: 12px;
+    --choice-name-size: var(--manage-theme-name-size);
+    --choice-name-line: var(--manage-theme-line);
+    --choice-tone-font: var(--manage-theme-tone-size)/var(--manage-theme-line)
+      var(--font);
+    --choice-selected: color-mix(in srgb, var(--gold) 60%, transparent);
+    --choice-shadow: 0 0 0 3px color-mix(in srgb, var(--gold) 14%, transparent);
+  }
+  .tiles .preview {
+    --choice-art-shadow: 0 0 0 1px var(--line-2);
+    --choice-dock-border: 1px solid var(--line-2);
+    --choice-dock-background: var(--bg-3);
+    color: var(--tx-1);
+  }
+  .tile-check {
+    display: none;
+  }
+  .tiles .copy {
+    flex-direction: column;
+  }
+  .choices.compact {
+    grid-template-columns: 1fr;
+  }
+  .choice {
+    box-sizing: var(--choice-box-sizing, content-box);
+    display: var(--choice-display, grid);
+    flex-direction: column;
+    grid-template-columns: minmax(0, 1fr) var(--choice-check-width, 18px);
+    gap: var(--choice-gap, 8px);
+    padding: 8px;
+    border: 1px solid var(--line-2);
+    border-radius: var(--choice-radius, var(--r-md));
+    background: var(--bg-2);
+    color: var(--tx-1);
+    text-align: left;
+    cursor: pointer;
+  }
+  .choice:hover {
+    border-color: var(--line-3);
+    background: var(--choice-hover-background, var(--bg-3));
+  }
+  .choice.selected {
+    border-color: var(--choice-selected, var(--gold));
+    box-shadow: var(--choice-shadow, none);
+  }
+  .choice:focus-visible {
+    outline: 2px solid var(--info);
+    outline-offset: 2px;
+  }
+  .compact .choice {
+    grid-template-columns: 76px minmax(0, 1fr) 18px;
+    align-items: center;
+  }
+  .preview {
+    box-sizing: var(--choice-box-sizing, content-box);
+    grid-column: 1 / -1;
+    height: 64px;
+    border-radius: var(--choice-preview-radius, var(--r-sm));
+    position: relative;
+    overflow: hidden;
+    display: grid;
+    grid-template-columns: 12px 22px 1fr;
+    background: var(--bg-0);
+    border: 1px solid var(--line-2);
+  }
+  .compact .preview {
+    grid-column: auto;
+    height: 48px;
+  }
+  .rail,
+  .list {
+    background: var(--bg-1);
+    border-right: 1px solid var(--line);
+  }
+  .rail::before {
+    content: "";
+    display: block;
+    width: 4px;
+    height: 4px;
+    margin: 6px auto;
+    border-radius: 50%;
+    background: var(--gold);
+  }
+  .list {
+    display: flex;
+    flex-direction: column;
+    gap: 3px;
+    padding: 6px 3px;
+  }
+  .list i {
+    height: 4px;
+    border-radius: 2px;
+    background: var(--line-3);
+  }
+  .list i:first-child {
+    background: var(--sc-image);
+  }
+  .stage {
+    position: relative;
+    padding: 5px 6px;
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+  }
+  .stage i {
+    flex: 1;
+    border-radius: 3px;
+    background: var(--choice-preview-art, var(--bg-3));
+    border: var(--choice-art-border, 1px solid var(--line-2));
+    box-shadow: var(--choice-art-shadow, none);
+  }
+  .stage b {
+    box-sizing: var(--choice-box-sizing, content-box);
+    border: var(--choice-dock-border, 0);
+    height: 9px;
+    width: var(--choice-dock-width, 18px);
+    align-self: end;
+    border-radius: var(--choice-dock-radius, 2px);
+    background: var(--choice-dock-background, var(--grad-gold));
+    display: flex;
+    justify-content: flex-end;
+    padding: 1px;
+  }
+  .stage em {
+    width: 14px;
+    border-radius: 2px;
+    background: var(--grad-gold);
+  }
+  .preview-text {
+    position: absolute;
+    left: 40px;
+    top: 6px;
+    width: 20px;
+    height: 3px;
+    border-radius: 2px;
+    background: var(--tx-1);
+    opacity: 0.85;
+  }
+  .copy {
+    display: flex;
+    flex-wrap: wrap;
+    gap: var(--choice-copy-gap, 2px) 6px;
+    min-width: 0;
+  }
+  .copy strong {
+    font-size: var(--choice-name-size, 13px);
+    line-height: var(--choice-name-line, inherit);
+  }
+  .copy small {
+    font: var(--choice-tone-font, 10px var(--mono));
+    color: var(--tx-3);
+    align-self: var(--choice-tone-align, center);
+  }
+  .copy > span {
+    width: 100%;
+    font-size: 11px;
+    color: var(--tx-2);
+  }
+  .check {
+    color: var(--gold);
+  }
+  .notice {
+    font-size: 12px;
+    color: var(--tx-2);
+    margin: 12px 0 0;
+  }
+  @media (max-width: 1366px) {
+    .choices:not(.compact):not(.tiles) {
+      grid-template-columns: repeat(2, minmax(0, 1fr));
+    }
+  }
+  .theme-default {
+    box-sizing: border-box;
+    height: 16px;
+    font-size: 10px;
+  }
+</style>

calliope-web/src/lib/components/shell/nav.ts

@@ -1,123 +1,131 @@
-import type { IconName } from '$lib/components/ui/icons';
+import type { Pathname } from "$app/types";
+import type { IconName } from "$lib/components/ui/icons";
 
+// IDs are retained for the existing page contracts while B1–B4 replace layouts.
 export type NavId =
-	| 'projects'
-	| 'workbench'
-	| 'image'
-	| 'video'
-	| 'tasks'
-	| 'agents'
-	| 'connections'
-	| 'models'
-	| 'library'
-	| 'settings'
-	| 'canvas'
-	| 'workflows';
-
+  | "projects"
+  | "workbench"
+  | "image"
+  | "video"
+  | "tasks"
+  | "agents"
+  | "connections"
+  | "models"
+  | "library"
+  | "settings"
+  | "canvas"
+  | "workflows";
 export interface NavItem {
-	id: NavId;
-	labelKey: string;
-	icon: IconName;
-	href: string;
+  id: NavId;
+  label: string;
+  icon: IconName;
+  href: Pathname;
+  scene: "project" | "image" | "agent" | "manage" | "asset" | "gold";
+  matches: (path: string) => boolean;
 }
-
-// Order is fixed by spec-v2 §3: 项目 / 创作工作台 / 生图 / 生视频 / 生成任务 /
-// 智能体 / ComfyUI 连接 / 模型设置 / 设置. HEL-649 §二 puts the connection
-// and settings entries at the foot of the 60px rail.
 export const NAV_MAIN: NavItem[] = [
-	{ id: 'projects', labelKey: 'shell.navProjects', icon: 'home', href: '/' },
-	{
-		id: 'workbench',
-		labelKey: 'shell.navWorkbench',
-		icon: 'story',
-		href: '/workbench',
-	},
-	{ id: 'image', labelKey: 'shell.navImage', icon: 'image', href: '/image' },
-	{ id: 'video', labelKey: 'shell.navVideo', icon: 'film', href: '/video' },
-	{ id: 'tasks', labelKey: 'shell.navTasks', icon: 'queue', href: '/tasks' },
-	{ id: 'canvas', labelKey: 'nav.canvas', icon: 'story', href: '/canvas' },
-	{
-		id: 'agents',
-		labelKey: 'shell.navAgents',
-		icon: 'sparkle',
-		href: '/agents',
-	},
+  {
+    id: "projects",
+    label: "工作室",
+    icon: "nav-home",
+    href: "/",
+    scene: "gold",
+    matches: (p) => p === "/",
+  },
+  {
+    id: "workbench",
+    label: "项目",
+    icon: "nav-project",
+    href: "/workbench",
+    scene: "project",
+    matches: (p) => /^\/(workbench|project)(\/|$)/.test(p),
+  },
+  {
+    id: "image",
+    label: "创作台",
+    icon: "nav-create",
+    href: "/create",
+    scene: "image",
+    matches: (p) =>
+      ["/create", "/image", "/video", "/playground", "/build-scene"].includes(
+        p,
+      ),
+  },
+  {
+    id: "agents",
+    label: "智能体",
+    icon: "nav-agent",
+    href: "/agents",
+    scene: "agent",
+    matches: (p) => p === "/agents",
+  },
+  {
+    id: "canvas",
+    label: "画布",
+    icon: "nav-canvas",
+    href: "/canvas",
+    scene: "image",
+    matches: (p) => p.startsWith("/canvas"),
+  },
+  {
+    id: "library",
+    label: "素材库",
+    icon: "nav-lib",
+    href: "/library",
+    scene: "gold",
+    matches: (p) => p === "/library",
+  },
+];
+export const NAV_MANAGE: NavItem[] = [
+  {
+    id: "tasks",
+    label: "任务",
+    icon: "nav-queue",
+    href: "/tasks",
+    scene: "manage",
+    matches: (p) => p === "/tasks",
+  },
+  {
+    id: "workflows",
+    label: "工作流",
+    icon: "nav-flow",
+    href: "/workflows",
+    scene: "manage",
+    matches: (p) => p === "/workflows",
+  },
+  {
+    id: "connections",
+    label: "模型连接",
+    icon: "nav-plug",
+    href: "/model-connections",
+    scene: "manage",
+    matches: (p) =>
+      ["/connections", "/models", "/model-connections"].includes(p),
+  },
 ];
-
 export const NAV_FOOT: NavItem[] = [
-	{
-		id: 'connections',
-		labelKey: 'shell.navConnections',
-		icon: 'link',
-		href: '/connections',
-	},
-	{
-		id: 'models',
-		labelKey: 'shell.navModels',
-		icon: 'assets',
-		href: '/models',
-	},
-	{
-		id: 'workflows',
-		labelKey: 'connections.wfTitle',
-		icon: 'playground',
-		href: '/workflows',
-	},
-	{
-		id: 'library',
-		labelKey: 'shell.navLibrary',
-		icon: 'folder',
-		href: '/library',
-	},
-	{
-		id: 'settings',
-		labelKey: 'shell.navSettings',
-		icon: 'settings',
-		href: '/settings',
-	},
+  {
+    id: "settings",
+    label: "设置",
+    icon: "nav-gear",
+    href: "/settings",
+    scene: "manage",
+    matches: (p) => p === "/settings",
+  },
 ];
-
-export const NAV: NavItem[] = [...NAV_MAIN, ...NAV_FOOT];
-
-export interface TabItem {
-	id: 'projects' | 'workbench' | 'generate';
-	labelKey: string;
-	icon: IconName;
-	href: string;
-	/** Pages that light this tab up. */
-	covers: NavId[];
-}
-
-/** ≤760px bottom tab bar (§二): 项目 / 创作 / 生成 / 更多. */
-export const TABS: TabItem[] = [
-	{
-		id: 'projects',
-		labelKey: 'shell.tabProjects',
-		icon: 'home',
-		href: '/',
-		covers: ['projects'],
-	},
-	{
-		id: 'workbench',
-		labelKey: 'shell.tabCreate',
-		icon: 'story',
-		href: '/workbench',
-		covers: ['workbench'],
-	},
-	{
-		id: 'generate',
-		labelKey: 'shell.tabGenerate',
-		icon: 'image',
-		href: '/image',
-		covers: ['image', 'video'],
-	},
-];
-
-/**
- * Every page a tab does not link to directly lives in the 更多 sheet. 生视频
- * is still its own route, so it is listed there too until the two
- * generation pages merge.
- */
-export const MORE_ITEMS: NavItem[] = NAV.filter(
-	(item) => !TABS.some((tab) => tab.href === item.href),
-);
+// Tools awaiting their replacement keep reachable entries in global search.
+export const NAV = [
+  ...NAV_MAIN,
+  ...NAV_MANAGE,
+  ...NAV_FOOT,
+  { id: "video", label: "视频创作", icon: "film", href: "/video" },
+  { id: "models", label: "大语言模型", icon: "assets", href: "/models" },
+  {
+    id: "connections",
+    label: "ComfyUI 连接",
+    icon: "link",
+    href: "/connections",
+  },
+  { id: "image", label: "试验台", icon: "playground", href: "/playground" },
+  { id: "video", label: "三维搭景", icon: "story", href: "/build-scene" },
+] as const;

calliope-web/src/lib/components/studio/MediaSlot.svelte

@@ -30,6 +30,7 @@
 		anchorId?: string;
 		onFile: (file: File) => void;
 		onFromResults?: () => void;
+		onFromScene?: () => void;
 		onClear: () => void;
 	}
 
@@ -48,6 +49,7 @@
 		anchorId,
 		onFile,
 		onFromResults,
+		onFromScene,
 		onClear,
 	}: Props = $props();
 
@@ -108,6 +110,7 @@
 		<span>{label}</span>
 		{#if required}<span class="req" aria-hidden="true">*</span>{/if}
 		{#if hint}<span>{hint}</span>{/if}
+		{#if onFromScene}<button type="button" class="a-btn ghost xs" onclick={onFromScene}>从三维搭景截取</button>{/if}
 		{#if allowFromResults && onFromResults}
 			<button type="button" class="a-btn ghost xs" onclick={onFromResults}>
 				{t('studio.slotFromResultsShort')}

calliope-web/src/lib/components/studio/RefImageGrid.svelte

@@ -44,6 +44,7 @@
 		onRemove: (index: number) => void;
 		onDismissReject: (index: number) => void;
 		onFromResults?: () => void;
+		onFromScene?: () => void;
 	}
 
 	let {
@@ -64,6 +65,7 @@
 		onRemove,
 		onDismissReject,
 		onFromResults,
+		onFromScene,
 	}: Props = $props();
 
 	let addInput = $state<HTMLInputElement | null>(null);
@@ -133,6 +135,7 @@
 		<span>{label}</span>
 		<span class="req" aria-hidden="true">*</span>
 		<span class="mono">{hintLabel}</span>
+		{#if onFromScene}<button type="button" class="a-btn ghost xs" onclick={onFromScene}>从三维搭景截取</button>{/if}
 		{#if allowFromResults && onFromResults && remaining > 0}
 			<button type="button" class="a-btn ghost xs" onclick={onFromResults}>
 				{t('studio.slotFromResultsShort')}

calliope-web/src/lib/components/ui/Icon.svelte

@@ -1,37 +1,38 @@
 <script lang="ts">
-	import { icons, type IconName } from './icons';
+  import { icons, type IconName } from "./icons";
 
-	interface Props {
-		name: IconName;
-		size?: number;
-	}
+  interface Props {
+    name: IconName;
+    size?: number;
+  }
 
-	let { name, size = 18 }: Props = $props();
+  let { name, size = 18 }: Props = $props();
 
-	const content = $derived(icons[name] ?? '');
+  const content = $derived(icons[name] ?? "");
 </script>
 
 {#if content}
-	<svg
-		class="icon"
-		width={size}
-		height={size}
-		viewBox="0 0 24 24"
-		fill="none"
-		stroke="currentColor"
-		stroke-width="1.5"
-		stroke-linecap="round"
-		stroke-linejoin="round"
-		aria-hidden="true"
-	>
-		{@html content}
-	</svg>
+  <svg
+    class="icon"
+    width={size}
+    height={size}
+    viewBox="0 0 24 24"
+    fill="none"
+    stroke="currentColor"
+    style:stroke-width="var(--icon-stroke, 1.5)"
+    stroke-linecap="round"
+    stroke-linejoin="round"
+    aria-hidden="true"
+  >
+    <!-- eslint-disable-next-line svelte/no-at-html-tags -- content is selected only from the bundled icons.ts SVG registry; no API/user strings enter it. HTML preserves the authored SVG child elements. -->
+    {@html content}
+  </svg>
 {/if}
 
 <style>
-	.icon {
-		display: inline-block;
-		vertical-align: -0.125em;
-		flex-shrink: 0;
-	}
+  .icon {
+    display: inline-block;
+    vertical-align: -0.125em;
+    flex-shrink: 0;
+  }
 </style>

calliope-web/src/lib/components/ui/Modal.svelte

@@ -12,6 +12,9 @@
 		onclose?: () => void;
 		footer?: Snippet;
 		children: Snippet;
+		/** Open above a dock, retaining the shared dialog focus and keyboard behavior. */
+		anchor?: HTMLElement | null;
+		headerActions?: Snippet;
 	}
 
 	let {
@@ -22,6 +25,8 @@
 		onclose,
 		footer,
 		children,
+		anchor = null,
+		headerActions,
 	}: Props = $props();
 
 	const FOCUSABLE =
@@ -30,6 +35,28 @@
 	const titleId = `modal-title-${Math.random().toString(36).slice(2, 9)}`;
 
 	let panel = $state<HTMLDivElement | null>(null);
+	let anchorBox = $state({ left: 0, bottom: 0, width: 620, available: 560 });
+	$effect(() => {
+		if (!open || !anchor) return;
+		const source = anchor;
+		const place = () => {
+			const r = source.getBoundingClientRect();
+			anchorBox = {
+				left: r.left + 12,
+				bottom: innerHeight - r.top + 8,
+				width: r.width - 24,
+				available: Math.max(100, r.top - 64),
+			};
+		};
+		place();
+		const observer = new ResizeObserver(place);
+		observer.observe(source);
+		window.addEventListener('resize', place);
+		return () => {
+			observer.disconnect();
+			window.removeEventListener('resize', place);
+		};
+	});
 	const layer = Symbol('dialog');
 
 	function requestClose() {
@@ -100,10 +127,20 @@
 
 {#if open}
 	<!-- svelte-ignore a11y_click_events_have_key_events, a11y_no_static_element_interactions -->
-	<div class="modal-backdrop" onclick={handleBackdropClick}>
+	<div
+		class="modal-backdrop"
+		class:anchored={!!anchor}
+		onclick={handleBackdropClick}
+	>
 		<div
 			bind:this={panel}
 			class="modal-panel size-{size}"
+			style:left={anchor ? `${anchorBox.left}px` : undefined}
+			style:bottom={anchor ? `${anchorBox.bottom}px` : undefined}
+			style:width={anchor
+				? `min(var(--desk-pop-width), ${anchorBox.width}px)`
+				: undefined}
+			style:--anchor-available={`${anchorBox.available}px`}
 			role="dialog"
 			aria-modal="true"
 			aria-labelledby={title ? titleId : undefined}
@@ -115,6 +152,7 @@
 					{#if title}
 						<h2 class="modal-title" id={titleId}>{title}</h2>
 					{/if}
+					{@render headerActions?.()}
 					{#if dismissible}
 						<button
 							type="button"
@@ -168,6 +206,38 @@
 	.modal-panel.size-xl {
 		width: min(1180px, 100%);
 	}
+	.anchored {
+		background: transparent;
+		padding: 0;
+	}
+	.anchored .modal-panel {
+		box-sizing: border-box;
+		position: absolute;
+		height: var(--desk-pop-height);
+		max-height: min(64vh, var(--anchor-available));
+		border: 1px solid var(--line-2);
+		border-radius: var(--desk-dock-radius);
+		background: var(--desk-pop-bg);
+		box-shadow: var(--desk-pop-shadow);
+		backdrop-filter: blur(14px);
+		transform-origin: bottom left;
+	}
+	.anchored .modal-header {
+		padding: 12px 14px;
+		border-bottom: 1px solid var(--line);
+	}
+	.anchored .modal-title {
+		font-size: var(--fs-body);
+	}
+	.anchored .modal-body {
+		flex: 1;
+		min-height: 0;
+		padding: 12px 14px;
+	}
+	.anchored .modal-footer {
+		padding: 10px 14px;
+		border-top: 1px solid var(--line);
+	}
 	.modal-header {
 		display: flex;
 		align-items: center;

calliope-web/src/lib/components/ui/README.md

@@ -92,14 +92,14 @@ Status → color mapping (unknown strings fall back to muted and show the raw st
 
 `import ProgressBar from '$lib/components/ui/ProgressBar.svelte';`
 
-| Prop            | Type           | Default | Notes                                     |
-| --------------- | -------------- | ------- | ----------------------------------------- |
-| `value`         | `number`       | `0`     | clamped to 0–100                          |
-| `indeterminate` | `boolean`      | `false` | sliding accent gradient, no % readout     |
-| `label`         | `string`       | —       | text above the track, also the aria-label |
-| `size`          | `'sm' \| 'md'` | `'md'`  | sm = 4px, md = 6px track                  |
-| `tone`          | `'accent' \| 'success' \| 'error'` | `'accent'` | done = success, failed = error (§5) |
-| `bare`          | `boolean`      | `false` | track only, no label / % row              |
+| Prop            | Type                               | Default    | Notes                                     |
+| --------------- | ---------------------------------- | ---------- | ----------------------------------------- |
+| `value`         | `number`                           | `0`        | clamped to 0–100                          |
+| `indeterminate` | `boolean`                          | `false`    | sliding accent gradient, no % readout     |
+| `label`         | `string`                           | —          | text above the track, also the aria-label |
+| `size`          | `'sm' \| 'md'`                     | `'md'`     | sm = 4px, md = 6px track                  |
+| `tone`          | `'accent' \| 'success' \| 'error'` | `'accent'` | done = success, failed = error (§5)       |
+| `bare`          | `boolean`                          | `false`    | track only, no label / % row              |
 
 ```svelte
 <ProgressBar value={job.progress} label={job.name} />
@@ -126,14 +126,16 @@ Status → color mapping (unknown strings fall back to muted and show the raw st
 
 `import Modal from '$lib/components/ui/Modal.svelte';`
 
-| Prop          | Type         | Default  | Notes                                                                       |
-| ------------- | ------------ | -------- | --------------------------------------------------------------------------- |
-| `open`        | `boolean`    | `false`  | **bindable** — use `bind:open`                                              |
-| `title`       | `string`     | —        | wired to `aria-labelledby`; falls back to `aria-label="Dialog"`             |
-| `dismissible` | `boolean`    | `true`   | gates Esc, backdrop click, and the close button                             |
-| `onclose`     | `() => void` | —        | fires once when the modal closes (any cause, incl. external `open = false`) |
-| `footer`      | `Snippet`    | —        | right-aligned action row                                                    |
-| `children`    | `Snippet`    | required | body content                                                                |
+| Prop            | Type                  | Default  | Notes                                                                                        |
+| --------------- | --------------------- | -------- | -------------------------------------------------------------------------------------------- |
+| `open`          | `boolean`             | `false`  | **bindable** — use `bind:open`                                                               |
+| `title`         | `string`              | —        | wired to `aria-labelledby`; falls back to `aria-label="Dialog"`                              |
+| `dismissible`   | `boolean`             | `true`   | gates Esc, backdrop click, and the close button                                              |
+| `onclose`       | `() => void`          | —        | fires once when the modal closes (any cause, incl. external `open = false`)                  |
+| `anchor`        | `HTMLElement \| null` | `null`   | Optional dock anchor: opens above it, clamps to viewport, retains the dialog focus behavior. |
+| `headerActions` | `Snippet`             | —        | Optional controls beside the title (for example restore workflow defaults).                  |
+| `footer`        | `Snippet`             | —        | right-aligned action row                                                                     |
+| `children`      | `Snippet`             | required | body content                                                                                 |
 
 Behavior: Esc and backdrop click close when dismissible; focus is trapped while
 open; initial focus goes to the first focusable element (or the panel); focus is

calliope-web/src/lib/components/ui/icons.ts

@@ -4,76 +4,131 @@
  * Each entry is SVG inner content rendered by Icon.svelte via {@html}.
  */
 export const icons = {
-	// Navigation
-	home: '<path d="m3 10 9-7 9 7v10a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2Z"/><path d="M9 22V12h6v10"/>',
-	story:
-		'<path d="M2 4h6a4 4 0 0 1 4 4v12a3 3 0 0 0-3-3H2z"/><path d="M22 4h-6a4 4 0 0 0-4 4v12a3 3 0 0 1 3-3h7z"/>',
-	assets:
-		'<path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M22 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/>',
-	script:
-		'<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><path d="M14 2v6h6"/><path d="M16 13H8"/><path d="M16 17H8"/><path d="M10 9H8"/>',
-	video:
-		'<rect x="2" y="2" width="20" height="20" rx="2.18"/><path d="M7 2v20"/><path d="M17 2v20"/><path d="M2 12h20"/><path d="M2 7h5"/><path d="M2 17h5"/><path d="M17 17h5"/><path d="M17 7h5"/>',
-	queue:
-		'<path d="M8 6h13"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M3 6h.01"/><path d="M3 12h.01"/><path d="M3 18h.01"/>',
-	settings:
-		'<path d="M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z"/><circle cx="12" cy="12" r="3"/>',
-	playground:
-		'<path d="M10 2v7.53a2 2 0 0 1-.21.9L4.72 20.55a1 1 0 0 0 .9 1.45h12.76a1 1 0 0 0 .9-1.45L14.21 10.4a2 2 0 0 1-.21-.9V2"/><path d="M8.5 2h7"/><path d="M7 16h10"/>',
-	// Actions
-	plus: '<path d="M5 12h14"/><path d="M12 5v14"/>',
-	link: '<path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/>',
-	'link-off':
-		'<path d="M9 17H7A5 5 0 0 1 7 7h2"/><path d="M15 7h2a5 5 0 0 1 2 8"/><path d="m8 8 8 8"/>',
-	trash:
-		'<path d="M3 6h18"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6"/><path d="M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/><path d="M10 11v6"/><path d="M14 11v6"/>',
-	edit: '<path d="M17 3a2.85 2.83 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5Z"/><path d="m15 5 4 4"/>',
-	retry:
-		'<path d="M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8"/><path d="M21 3v5h-5"/><path d="M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16"/><path d="M3 21v-5h5"/>',
-	close: '<path d="M18 6 6 18"/><path d="m6 6 12 12"/>',
-	download:
-		'<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m7 10 5 5 5-5"/><path d="M12 15V3"/>',
-	upload:
-		'<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m17 8-5-5-5 5"/><path d="M12 3v12"/>',
-	paperclip:
-		'<path d="m21.44 11.05-9.19 9.19a6 6 0 0 1-8.49-8.49l8.57-8.57A4 4 0 1 1 18 8.84l-8.59 8.57a2 2 0 0 1-2.83-2.83l8.49-8.48"/>',
-	copy:
-		'<rect x="8" y="8" width="14" height="14" rx="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/>',
-	search: '<circle cx="11" cy="11" r="8"/><path d="m21 21-4.35-4.35"/>',
-	'external-link':
-		'<path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><path d="M15 3h6v6"/><path d="M10 14 21 3"/>',
-	'zoom-in':
-		'<circle cx="11" cy="11" r="8"/><path d="m21 21-4.35-4.35"/><path d="M11 8v6"/><path d="M8 11h6"/>',
-	// Media transport
-	play: '<polygon points="6 3 20 12 6 21 6 3"/>',
-	pause:
-		'<rect x="6" y="4" width="4" height="16" rx="1"/><rect x="14" y="4" width="4" height="16" rx="1"/>',
-	stop: '<rect x="5" y="5" width="14" height="14" rx="2"/>',
-	// Status
-	check: '<path d="M20 6 9 17l-5-5"/>',
-	star: '<polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/>',
-	alert:
-		'<path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z"/><path d="M12 9v4"/><path d="M12 17h.01"/>',
-	info: '<circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/>',
-	clock: '<circle cx="12" cy="12" r="10"/><path d="M12 6v6l4 2"/>',
-	sparkle:
-		'<path d="M12 3l1.9 5.76a2 2 0 0 0 1.24 1.24L21 12l-5.86 1.9a2 2 0 0 0-1.24 1.24L12 21l-1.9-5.86a2 2 0 0 0-1.24-1.24L3 12l5.86-1.9a2 2 0 0 0 1.24-1.24Z"/>',
-	// Media
-	image:
-		'<rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-3.09-3.09a2 2 0 0 0-2.82 0L6 21"/>',
-	film: '<rect x="2" y="4" width="20" height="16" rx="2"/><path d="M2 8h20"/><path d="M2 16h20"/><path d="M9 8v8"/><path d="M15 8v8"/>',
-	music:
-		'<path d="M9 18V5l12-2v13"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="16" r="3"/>',
-	folder:
-		'<path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/>',
-	file: '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/>',
-	// Chevrons
-	'chevron-left': '<path d="m15 18-6-6 6-6"/>',
-	'chevron-right': '<path d="m9 18 6-6-6-6"/>',
-	'chevron-up': '<path d="m18 15-6-6-6 6"/>',
-	'chevron-down': '<path d="m6 9 6 6 6-6"/>',
-	// Misc
-	drag: '<circle cx="9" cy="6" r="1"/><circle cx="9" cy="12" r="1"/><circle cx="9" cy="18" r="1"/><circle cx="15" cy="6" r="1"/><circle cx="15" cy="12" r="1"/><circle cx="15" cy="18" r="1"/>',
+  "agent-cpu":
+    '<rect x="6" y="6" width="12" height="12" rx="2"/><path d="M9 2v4M15 2v4M9 18v4M15 18v4M2 9h4M2 15h4M18 9h4M18 15h4"/>',
+  "agent-send": '<path d="M4 12 20 4l-6 16-3-7z"/>',
+  // Approved B3 sample geometry; retain existing tool icon contracts.
+  "project-check": '<path d="M5 12.5 10 17l9-10"/>',
+  "project-grid":
+    '<rect x="3" y="3" width="7" height="7"/><rect x="14" y="3" width="7" height="7"/><rect x="3" y="14" width="7" height="7"/><rect x="14" y="14" width="7" height="7"/>',
+  "project-book":
+    '<path d="M4 4h6a3 3 0 0 1 3 3v13a2 2 0 0 0-2-2H4zM20 4h-5a3 3 0 0 0-3 3"/><path d="M20 4v14h-6"/>',
+  "project-folder-in":
+    '<path d="M3 6a2 2 0 0 1 2-2h4l2 2h8a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/><path d="M12 10v6M9 13l3 3 3-3"/>',
+  "project-film":
+    '<rect x="2" y="4" width="20" height="16" rx="2"/><path d="M7 4v16M17 4v16M2 9h5M2 15h5M17 9h5M17 15h5"/>',
+  "project-image":
+    '<rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="8.5" cy="8.5" r="1.5"/><path d="m21 15-5-5L5 21"/>',
+  "project-refresh": '<path d="M20 11a8 8 0 1 0-2.3 5.7M20 4v7h-7"/>',
+  "project-cube":
+    '<path d="M12 2 3 7v10l9 5 9-5V7z"/><path d="M3 7l9 5 9-5M12 12v10"/>',
+  "project-search": '<circle cx="11" cy="11" r="7"/><path d="m20 20-3.5-3.5"/>',
+  "project-arrow": '<path d="M5 12h14M13 6l6 6-6 6"/>',
+  "project-agent":
+    '<path d="M12 3l1.8 4.6L18.5 9l-4.7 1.4L12 15l-1.8-4.6L5.5 9l4.7-1.4z"/><path d="M18.5 15l.9 2.1 2.1.9-2.1.9-.9 2.1-.9-2.1-2.1-.9 2.1-.9z"/>',
+  "project-lib":
+    '<rect x="3" y="5" width="18" height="15" rx="2"/><circle cx="9" cy="10" r="2"/><path d="m21 16-5-5-9 9"/>',
+  "project-canvas":
+    '<rect x="3" y="3" width="7" height="7" rx="1.5"/><rect x="14" y="3" width="7" height="5" rx="1.5"/><rect x="14" y="12" width="7" height="9" rx="1.5"/><rect x="3" y="14" width="7" height="7" rx="1.5"/>',
+  "project-queue":
+    '<path d="M4 6h16M4 12h10M4 18h7"/><circle cx="18" cy="16" r="3"/>',
+  "search-manage": '<circle cx="11" cy="11" r="7"/><path d="m20 20-3.5-3.5"/>',
+  "upload-manage": '<path d="M12 16V4M6 9l6-6 6 6M4 20h16"/>',
+  "film-manage":
+    '<rect x="2" y="4" width="20" height="16" rx="2"/><path d="M7 4v16M17 4v16M2 9h5M2 15h5M17 9h5M17 15h5"/>',
+  "arrow-right": '<path d="M5 12h14M13 6l6 6-6 6"/>',
+  pin: '<path d="M12 17v5M5 17h14l-2-4V5a2 2 0 0 0-2-2H9a2 2 0 0 0-2 2v8z"/>',
+  // Approved HEL-726 rail geometry; existing tool icons retain their contracts.
+  "nav-home":
+    '<path d="M3 10.5 12 3l9 7.5V20a1 1 0 0 1-1 1h-5v-6H9v6H4a1 1 0 0 1-1-1z"/>',
+  "nav-project":
+    '<rect x="3" y="4" width="18" height="16" rx="2"/><path d="M3 9h18M8 4v5M13 4v5"/>',
+  "nav-create":
+    '<path d="M12 3v3M12 18v3M3 12h3M18 12h3M5.6 5.6l2.1 2.1M16.3 16.3l2.1 2.1M5.6 18.4l2.1-2.1M16.3 7.7l2.1-2.1"/><circle cx="12" cy="12" r="3"/>',
+  "nav-agent":
+    '<path d="M12 3l1.8 4.6L18.5 9l-4.7 1.4L12 15l-1.8-4.6L5.5 9l4.7-1.4z"/><path d="M18.5 15l.9 2.1 2.1.9-2.1.9-.9 2.1-.9-2.1-2.1-.9 2.1-.9z"/>',
+  "nav-canvas":
+    '<rect x="3" y="3" width="7" height="7" rx="1.5"/><rect x="14" y="3" width="7" height="5" rx="1.5"/><rect x="14" y="12" width="7" height="9" rx="1.5"/><rect x="3" y="14" width="7" height="7" rx="1.5"/>',
+  "nav-lib":
+    '<rect x="3" y="5" width="18" height="15" rx="2"/><circle cx="9" cy="10" r="2"/><path d="m21 16-5-5-9 9"/>',
+  "nav-queue":
+    '<path d="M4 6h16M4 12h10M4 18h7"/><circle cx="18" cy="16" r="3"/>',
+  "nav-flow":
+    '<rect x="3" y="3" width="6" height="6" rx="1.5"/><rect x="15" y="15" width="6" height="6" rx="1.5"/><path d="M9 6h4a2 2 0 0 1 2 2v7"/>',
+  "nav-plug": '<path d="M9 2v5M15 2v5M6 7h12v4a6 6 0 0 1-12 0zM12 17v5"/>',
+  "nav-gear":
+    '<circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.7 1.7 0 0 0 .3 1.8l.1.1a2 2 0 1 1-2.8 2.8l-.1-.1a1.7 1.7 0 0 0-1.8-.3 1.7 1.7 0 0 0-1 1.5V21a2 2 0 1 1-4 0v-.1a1.7 1.7 0 0 0-1.1-1.5 1.7 1.7 0 0 0-1.8.3l-.1.1a2 2 0 1 1-2.8-2.8l.1-.1a1.7 1.7 0 0 0 .3-1.8 1.7 1.7 0 0 0-1.5-1H3a2 2 0 1 1 0-4h.1a1.7 1.7 0 0 0 1.5-1.1 1.7 1.7 0 0 0-.3-1.8l-.1-.1a2 2 0 1 1 2.8-2.8l.1.1a1.7 1.7 0 0 0 1.8.3H9a1.7 1.7 0 0 0 1-1.5V3a2 2 0 1 1 4 0v.1a1.7 1.7 0 0 0 1 1.5 1.7 1.7 0 0 0 1.8-.3l.1-.1a2 2 0 1 1 2.8 2.8l-.1.1a1.7 1.7 0 0 0-.3 1.8V9a1.7 1.7 0 0 0 1.5 1H21a2 2 0 1 1 0 4h-.1a1.7 1.7 0 0 0-1.5 1z"/>',
+  "nav-palette":
+    '<path d="M12 3a9 9 0 1 0 0 18c1 0 1.5-.8 1.2-1.6-.4-1 .3-2.4 1.6-2.4H17a4 4 0 0 0 4-4c0-5.5-4-10-9-10z"/><circle cx="7.5" cy="11" r="1"/><circle cx="10" cy="7" r="1"/><circle cx="15" cy="7.5" r="1"/>',
+  // Navigation
+  home: '<path d="m3 10 9-7 9 7v10a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2Z"/><path d="M9 22V12h6v10"/>',
+  story:
+    '<path d="M2 4h6a4 4 0 0 1 4 4v12a3 3 0 0 0-3-3H2z"/><path d="M22 4h-6a4 4 0 0 0-4 4v12a3 3 0 0 1 3-3h7z"/>',
+  assets:
+    '<path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M22 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/>',
+  script:
+    '<path d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"/><path d="M14 2v6h6"/><path d="M16 13H8"/><path d="M16 17H8"/><path d="M10 9H8"/>',
+  video:
+    '<rect x="2" y="2" width="20" height="20" rx="2.18"/><path d="M7 2v20"/><path d="M17 2v20"/><path d="M2 12h20"/><path d="M2 7h5"/><path d="M2 17h5"/><path d="M17 17h5"/><path d="M17 7h5"/>',
+  queue:
+    '<path d="M8 6h13"/><path d="M8 12h13"/><path d="M8 18h13"/><path d="M3 6h.01"/><path d="M3 12h.01"/><path d="M3 18h.01"/>',
+  settings:
+    '<path d="M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.1a2 2 0 0 1 1 1.72v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.39a2 2 0 0 0-.73-2.73l-.15-.08a2 2 0 0 1-1-1.74v-.5a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z"/><circle cx="12" cy="12" r="3"/>',
+  playground:
+    '<path d="M10 2v7.53a2 2 0 0 1-.21.9L4.72 20.55a1 1 0 0 0 .9 1.45h12.76a1 1 0 0 0 .9-1.45L14.21 10.4a2 2 0 0 1-.21-.9V2"/><path d="M8.5 2h7"/><path d="M7 16h10"/>',
+  // Actions
+  plus: '<path d="M5 12h14"/><path d="M12 5v14"/>',
+  link: '<path d="M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71"/><path d="M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"/>',
+  "link-off":
+    '<path d="M9 17H7A5 5 0 0 1 7 7h2"/><path d="M15 7h2a5 5 0 0 1 2 8"/><path d="m8 8 8 8"/>',
+  trash:
+    '<path d="M3 6h18"/><path d="M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6"/><path d="M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2"/><path d="M10 11v6"/><path d="M14 11v6"/>',
+  edit: '<path d="M17 3a2.85 2.83 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5Z"/><path d="m15 5 4 4"/>',
+  retry:
+    '<path d="M3 12a9 9 0 0 1 9-9 9.75 9.75 0 0 1 6.74 2.74L21 8"/><path d="M21 3v5h-5"/><path d="M21 12a9 9 0 0 1-9 9 9.75 9.75 0 0 1-6.74-2.74L3 16"/><path d="M3 21v-5h5"/>',
+  close: '<path d="M18 6 6 18"/><path d="m6 6 12 12"/>',
+  download:
+    '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m7 10 5 5 5-5"/><path d="M12 15V3"/>',
+  upload:
+    '<path d="M21 15v4a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-4"/><path d="m17 8-5-5-5 5"/><path d="M12 3v12"/>',
+  paperclip:
+    '<path d="m21.44 11.05-9.19 9.19a6 6 0 0 1-8.49-8.49l8.57-8.57A4 4 0 1 1 18 8.84l-8.59 8.57a2 2 0 0 1-2.83-2.83l8.49-8.48"/>',
+  copy: '<rect x="8" y="8" width="14" height="14" rx="2"/><path d="M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"/>',
+  search: '<circle cx="11" cy="11" r="8"/><path d="m21 21-4.35-4.35"/>',
+  "external-link":
+    '<path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><path d="M15 3h6v6"/><path d="M10 14 21 3"/>',
+  "zoom-in":
+    '<circle cx="11" cy="11" r="8"/><path d="m21 21-4.35-4.35"/><path d="M11 8v6"/><path d="M8 11h6"/>',
+  // Media transport
+  play: '<polygon points="6 3 20 12 6 21 6 3"/>',
+  pause:
+    '<rect x="6" y="4" width="4" height="16" rx="1"/><rect x="14" y="4" width="4" height="16" rx="1"/>',
+  stop: '<rect x="5" y="5" width="14" height="14" rx="2"/>',
+  // Status
+  check: '<path d="M20 6 9 17l-5-5"/>',
+  star: '<polygon points="12 2 15.09 8.26 22 9.27 17 14.14 18.18 21.02 12 17.77 5.82 21.02 7 14.14 2 9.27 8.91 8.26 12 2"/>',
+  alert:
+    '<path d="m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3Z"/><path d="M12 9v4"/><path d="M12 17h.01"/>',
+  info: '<circle cx="12" cy="12" r="10"/><path d="M12 16v-4"/><path d="M12 8h.01"/>',
+  clock: '<circle cx="12" cy="12" r="10"/><path d="M12 6v6l4 2"/>',
+  sparkle:
+    '<path d="M12 3l1.9 5.76a2 2 0 0 0 1.24 1.24L21 12l-5.86 1.9a2 2 0 0 0-1.24 1.24L12 21l-1.9-5.86a2 2 0 0 0-1.24-1.24L3 12l5.86-1.9a2 2 0 0 0 1.24-1.24Z"/>',
+  // Media
+  image:
+    '<rect x="3" y="3" width="18" height="18" rx="2"/><circle cx="9" cy="9" r="2"/><path d="m21 15-3.09-3.09a2 2 0 0 0-2.82 0L6 21"/>',
+  film: '<rect x="2" y="4" width="20" height="16" rx="2"/><path d="M2 8h20"/><path d="M2 16h20"/><path d="M9 8v8"/><path d="M15 8v8"/>',
+  music:
+    '<path d="M9 18V5l12-2v13"/><circle cx="6" cy="18" r="3"/><circle cx="18" cy="16" r="3"/>',
+  folder:
+    '<path d="M20 20a2 2 0 0 0 2-2V8a2 2 0 0 0-2-2h-7.9a2 2 0 0 1-1.69-.9L9.6 3.9A2 2 0 0 0 7.93 3H4a2 2 0 0 0-2 2v13a2 2 0 0 0 2 2Z"/>',
+  file: '<path d="M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7Z"/><path d="M14 2v4a2 2 0 0 0 2 2h4"/>',
+  // Chevrons
+  "chevron-left": '<path d="m15 18-6-6 6-6"/>',
+  "chevron-right": '<path d="m9 18 6-6-6-6"/>',
+  "chevron-up": '<path d="m18 15-6-6-6 6"/>',
+  "chevron-down": '<path d="m6 9 6 6 6-6"/>',
+  // Misc
+  drag: '<circle cx="9" cy="6" r="1"/><circle cx="9" cy="12" r="1"/><circle cx="9" cy="18" r="1"/><circle cx="15" cy="6" r="1"/><circle cx="15" cy="12" r="1"/><circle cx="15" cy="18" r="1"/>',
 } as const satisfies Record<string, string>;
 
 export type IconName = keyof typeof icons;

calliope-web/src/lib/components/ui/modalLayers.ts

@@ -1,17 +1,17 @@
 // Only the uppermost dialog handles the keyboard. Nested dialogs keep the
 // original body overflow until the final layer closes.
 const layers: symbol[] = [];
-let bodyOverflow = '';
+let bodyOverflow = "";
 export function enterModal(token: symbol) {
-	if (!layers.length) bodyOverflow = document.body.style.overflow;
-	layers.push(token);
-	document.body.style.overflow = 'hidden';
+  if (!layers.length) bodyOverflow = document.body.style.overflow;
+  layers.push(token);
+  document.body.style.overflow = "hidden";
 }
 export function topModal(token: symbol) {
-	return layers.at(-1) === token;
+  return layers.at(-1) === token;
 }
 export function leaveModal(token: symbol) {
-	const index = layers.indexOf(token);
-	if (index >= 0) layers.splice(index, 1);
-	document.body.style.overflow = layers.length ? 'hidden' : bodyOverflow;
+  const index = layers.indexOf(token);
+  if (index >= 0) layers.splice(index, 1);
+  document.body.style.overflow = layers.length ? "hidden" : bodyOverflow;
 }

calliope-web/src/lib/components/video/ClipMonitor.svelte

@@ -111,7 +111,7 @@ let {
 	</div>
 	{#if previewUrl}
 		<div class="foot">
-			<a class="dl" href={previewUrl} download>
+			<a class="dl" href={previewUrl} download rel="external">
 				<Icon name="download" size={14} /> {t('clipMonitor.downloadClip')}
 			</a>
 		</div>

calliope-web/src/lib/components/video/ClipSourceModal.svelte

@@ -98,7 +98,6 @@
 					>
 						<div class="thumb">
 							{#if opt.path}
-								<!-- svelte-ignore a11y_media_has_caption -->
 								<video
 									src={assetUrl(opt.path)}
 									muted

calliope-web/src/lib/components/video/JobInputsDrawer.svelte

@@ -11,7 +11,7 @@
 	import Button from '$lib/components/ui/Button.svelte';
 	import Icon from '$lib/components/ui/Icon.svelte';
 	import Modal from '$lib/components/ui/Modal.svelte';
-	import SafeMedia from '$lib/components/SafeMedia.svelte';
+	import '$lib/components/SafeMedia.svelte';
 	import { assetUrl } from '$lib/api';
 	import { t } from '$lib/i18n.svelte';
 

calliope-web/src/lib/components/video/SceneFilmstrip.svelte

@@ -100,7 +100,6 @@ title={t('filmstrip.clipTitle', {
 					{#if thumb?.kind === 'image'}
 						<img class="thumb-media" src={thumb.src} alt="" loading="lazy" />
 					{:else if thumb?.kind === 'video'}
-						<!-- svelte-ignore a11y_media_has_caption -->
 						<video class="thumb-media" src={thumb.src + '#t=0.1'} muted playsinline preload="metadata"></video>
 					{:else}
 						<span class="thumb-slate">{entry.label}</span>

calliope-web/src/lib/components/video/SceneScriptDrawer.svelte

@@ -66,7 +66,7 @@
 				<div class="block">
 					<span class="k">{t('scriptDrawer.characters')}</span>
 					<div class="chips">
-						{#each scene.characters as c}
+						{#each scene.characters as c (c.id)}
 							<span class="chip">{c.name}</span>
 						{/each}
 					</div>

calliope-web/src/lib/components/video/VideoEditWorkspace.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	/**
 	 * VideoEditWorkspace — modern Edit layout for Project → Video.
 	 * Hero monitor + filmstrip + meta strip + docked Omni composer.
@@ -11,7 +12,7 @@
 	import ClipMonitor from './ClipMonitor.svelte';
 	import ClipSourceModal from './ClipSourceModal.svelte';
 	import JobInputsDrawer from './JobInputsDrawer.svelte';
-	import PromptPreviewModal from './PromptPreviewModal.svelte';
+	import './PromptPreviewModal.svelte';
 	import SceneFilmstrip, { type FilmstripClip } from './SceneFilmstrip.svelte';
 	import SceneScriptDrawer from './SceneScriptDrawer.svelte';
 import { t } from '$lib/i18n.svelte';
@@ -87,7 +88,6 @@ import { t } from '$lib/i18n.svelte';
 	}
 
 	let {
-		scenes,
 		filmClips,
 		selectedClip,
 		selectedClipId,
@@ -266,7 +266,7 @@ import { t } from '$lib/i18n.svelte';
 			<div class="no-wf">
 				<p class="empty-title">{t('videoEdit.noWf')}</p>
 				<p class="muted">
-					{t('videoEdit.enableWfPre')} <a href="/settings?tab=workflows">{t('videoEdit.wfLink')}</a>{t('videoEdit.enableWfPost')}
+					{t('videoEdit.enableWfPre')} <a href={resolve('/settings?tab=workflows')}>{t('videoEdit.wfLink')}</a>{t('videoEdit.enableWfPost')}
 				</p>
 			</div>
 		{/if}

calliope-web/src/lib/components/workbench/AssetsStagePanel.svelte

@@ -1,4 +1,5 @@
 <script lang="ts">
+	import { resolve } from '$app/paths';
 	import type { WorkbenchAsset, WorkbenchStage } from '$lib/api';
 	import { assetUrl } from '$lib/api';
 	import Icon from '$lib/components/ui/Icon.svelte';
@@ -73,6 +74,12 @@
 	function jobActive(job: WorkbenchAsset['job']): boolean {
 		return !!job && (job.status === 'pending' || job.status === 'running');
 	}
+
+ export function saveDraft() {
+   if (editing) save();
+   else if (stage.content) onSave?.(stage.content);
+ }
+ export function hasUnsavedDraft() { return editing; }
 </script>
 
 {#if editing}
@@ -162,7 +169,7 @@
 				</div>
 				{#if asset.description}<p class="asset-desc">{asset.description}</p>{/if}
 				{#if asset.job?.status === 'done' && asset.job.output}
-					<a class="asset-shot" href={assetUrl(asset.job.output) ?? '#'} target="_blank" rel="noopener">
+					<a class="asset-shot" href={assetUrl(asset.job.output) ?? '#'} target="_blank" rel="noopener external">
 						<img src={assetUrl(asset.job.output) ?? ''} alt={asset.name} loading="lazy" />
 					</a>
 				{/if}
@@ -174,7 +181,7 @@
 					{#if projectId}
 						<a
 							class="a-btn ghost sm"
-							href={deskHref({
+							href={resolve(deskHref({
 								kind: 'image',
 								projectId,
 								stage: 'assets',
@@ -186,7 +193,7 @@
 							negative: asset.negative_prompt || undefined,
 							sourceKind: 'asset',
 							sourceId: asset.id,
-						})}
+						}))}
 							title={t('desk.openInDeskHint')}
 						>
 							{t('desk.openInDesk')}

calliope-web/src/lib/components/workbench/IncomingResults.svelte

@@ -0,0 +1,23 @@
+<script lang="ts">
+  import { assetUrl, type IncomingResult } from "$lib/api";
+  import { resolve } from "$app/paths";
+  let { results }: { results: IncomingResult[] } = $props();
+</script>
+
+{#each results as result (result.source_key)}
+  <details class="stage-note" open data-testid="incoming-result">
+    <summary>{result.title} · 待整理成果</summary>
+    {#if result.text}<p>{result.text}</p>{/if}
+    {#each result.paths ?? [] as path (path)}<a
+        class="a-btn sm"
+        href={assetUrl(path) ?? "#"}
+        target="_blank"
+        rel="noopener external"
+        >查看{result.kind === "video" ? "视频" : "图片"}产物</a
+      >{/each}
+    {#if result.session_id}<a
+        class="a-btn sm ghost"
+        href={resolve(`/agents?session=${result.session_id}`)}>回智能体编辑</a
+      >{/if}
+  </details>
+{/each}

calliope-web/src/lib/components/workbench/ProjectWorkbench.svelte

@@ -0,0 +1,730 @@
+<script lang="ts">
+  import "$lib/components/workbench/project.css";
+  import IncomingResults from "./IncomingResults.svelte";
+  import Modal from "$lib/components/ui/Modal.svelte";
+  import StudioHeader from "$lib/components/workbench/StudioHeader.svelte";
+  import { resolve } from "$app/paths";
+  import { goto } from "$app/navigation";
+  import { untrack } from "svelte";
+  import { page as pageStore } from "$app/state";
+  import {
+    createMutation,
+    createQuery,
+    useQueryClient,
+  } from "@tanstack/svelte-query";
+  import {
+    agentApi,
+    assetUrl,
+    jobsApi,
+    settings,
+    workbenchApi,
+    type WorkbenchStageKey,
+  } from "$lib/api";
+  import { connectEvents } from "$lib/events";
+  import { parseDbTs } from "$lib/dbtime";
+  import { handleJobEvent, progressFor } from "$lib/jobProgress";
+  import { storageSet } from "$lib/storage";
+  import { toast } from "$lib/toast";
+  import AppShell from "$lib/components/shell/AppShell.svelte";
+  import Icon from "$lib/components/ui/Icon.svelte";
+  import Skeleton from "$lib/components/ui/Skeleton.svelte";
+  import StageStepper from "$lib/components/workbench/StageStepper.svelte";
+  import ScriptStagePanel from "$lib/components/workbench/ScriptStagePanel.svelte";
+  import StyleStagePanel from "$lib/components/workbench/StyleStagePanel.svelte";
+  import StoryboardStagePanel from "$lib/components/workbench/StoryboardStagePanel.svelte";
+  import AssetsStagePanel from "$lib/components/workbench/AssetsStagePanel.svelte";
+  import ShotStagePanel from "$lib/components/workbench/ShotStagePanel.svelte";
+  import { t } from "$lib/i18n.svelte";
+
+  /**
+   * 五段创作工作台 (a2): stepper + stage artifact panel + agent/task side
+   * column. Only confirmed snapshots flow downstream; drafts are clearly
+   * flagged and never treated as final. In-flow generation rides the shared
+   * queue (HEL-612) so tasks and results come back to this project.
+   */
+
+  const client = useQueryClient();
+  let { projectId: suppliedId }: { projectId: number } = $props();
+  const projectId = untrack(() => suppliedId);
+  let editor = $state<{saveDraft:()=>void;hasUnsavedDraft:()=>boolean}|null>(null);
+  let compareOpen = $state(false);
+
+  const STAGE_ORDER: WorkbenchStageKey[] = [
+    "script",
+    "style",
+    "storyboard",
+    "assets",
+    "shot",
+  ];
+
+  const overviewQuery = createQuery({
+    queryKey: ["workbench", projectId],
+    queryFn: () => workbenchApi.overview(projectId),
+    refetchInterval: 2500,
+  });
+  const jobsQuery = createQuery({
+    queryKey: ["jobs", projectId],
+    queryFn: () => jobsApi.list(projectId),
+    refetchInterval: 5000,
+  });
+  const agentsQuery = createQuery({
+    queryKey: ["agents-registry"],
+    queryFn: agentApi.listNamedAgents,
+    staleTime: 60_000,
+  });
+  const settingsQuery = createQuery({
+    queryKey: ["settings"],
+    queryFn: settings.get,
+    staleTime: 60_000,
+  });
+
+  const overview = $derived($overviewQuery.data);
+  const stages = $derived(overview?.stages ?? []);
+
+  // ?stage= selects the open stage; default = first not-confirmed one.
+  const urlStage = $derived(
+    pageStore.url.searchParams.get("stage") as WorkbenchStageKey | null,
+  );
+  const fallbackStage = $derived.by(() => {
+    for (const key of STAGE_ORDER) {
+      const s = stages.find((x) => x.stage_key === key);
+      if (!s || s.status !== "confirmed") return key;
+    }
+    return "shot";
+  });
+  const stageKey = $derived(
+    urlStage && STAGE_ORDER.includes(urlStage) ? urlStage : fallbackStage,
+  );
+  const currentStage = $derived(stages.find((s) => s.stage_key === stageKey));
+
+  function selectStage(key: string) {
+    if (Number(pageStore.params.id) !== projectId) return;
+    noteOpen = false;
+    const url = new URL(pageStore.url);
+    url.searchParams.set("stage", key);
+    goto(resolve(`/workbench/${pageStore.params.id}${url.search}${url.hash}`), {
+      keepFocus: true,
+      noScroll: true,
+    });
+  }
+
+  function advanceAfterConfirm(key: WorkbenchStageKey) {
+    const idx = STAGE_ORDER.indexOf(key);
+    if (idx >= 0 && idx < STAGE_ORDER.length - 1) {
+      selectStage(STAGE_ORDER[idx + 1]);
+    }
+  }
+
+  // ── Live job feed (shared queue) ───────────────────────────────────
+  $effect(() => {
+    const off = connectEvents((ev) => {
+      handleJobEvent(ev);
+      if (ev.type.startsWith("job.")) {
+        client.invalidateQueries({ queryKey: ["jobs", projectId] });
+        if (ev.type === "job.completed" || ev.type === "job.failed") {
+          client.invalidateQueries({ queryKey: ["workbench", projectId] });
+          client.invalidateQueries({ queryKey: ["projects"] });
+        }
+      }
+    });
+    return off;
+  });
+
+  // ── Stage mutations ────────────────────────────────────────────────
+  const instructions = $state<Record<string,string>>({});
+  let runWatchKey = $state<WorkbenchStageKey | null>(null);
+  let chosenStyleId = $state<string | null>(null);
+
+  let noteOpen = $state(false),
+    noteText = $state(""),
+    noteBusy = $state(false);
+  $effect(() => {
+    void stageKey;
+    noteOpen = false;
+    noteText = '';
+    compareOpen = false;
+  });
+  async function saveNote() {
+    noteBusy = true;
+    try {
+      await workbenchApi.saveNote(projectId, stageKey, noteText);
+      await client.invalidateQueries({ queryKey: ["workbench", projectId] });
+      noteOpen = false;
+      toast.success("助手建议已保存");
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : String(e));
+    } finally {
+      noteBusy = false;
+    }
+  }
+
+  // Keep the chosen style selector in sync with the stage payload.
+  let lastStyleSync = $state("");
+  $effect(() => {
+    const styleStage = stages.find((s) => s.stage_key === "style");
+    if (!styleStage) return;
+    const directions = (
+      styleStage.content as unknown as { directions?: { id: string }[] } | null
+    )?.directions;
+    const stamp = JSON.stringify(directions ?? []) + styleStage.chosen_style_id;
+    if (stamp === lastStyleSync) return;
+    lastStyleSync = stamp;
+    const ids = (directions ?? []).map((d) => d.id);
+    chosenStyleId =
+      styleStage.chosen_style_id && ids.includes(styleStage.chosen_style_id)
+        ? styleStage.chosen_style_id
+        : (ids[0] ?? null);
+  });
+
+  // Toast once a watched run finishes (success or Chinese failure reason).
+  $effect(() => {
+    if (!runWatchKey) return;
+    const stage = stages.find((s) => s.stage_key === runWatchKey);
+    if (!stage || stage.status === "running") return;
+    if (stage.status === "awaiting_confirm") {
+      toast.success(t("workbench.runDone", { agent: agentName(runWatchKey) }));
+    } else if (stage.last_run?.status === "failed" && stage.last_run.error) {
+      toast.error(stage.last_run.error);
+    }
+    runWatchKey = null;
+  });
+
+  function agentName(key: string): string {
+    const agent = ($agentsQuery.data ?? []).find((a) => a.key === key);
+    return agent ? agent.name : key;
+  }
+
+  function busyFor(key: WorkbenchStageKey): boolean {
+    const stage = stages.find((s) => s.stage_key === key);
+    return stage?.status === "running";
+  }
+
+  const runMutation = createMutation({
+    mutationFn: (args: {key: WorkbenchStageKey; instruction: string}) =>
+      workbenchApi.runStage(projectId, args.key, args.instruction || undefined),
+    onSuccess: (_data, args) => {
+      runWatchKey = args.key;
+      if ((instructions[args.key] ?? '').trim() === args.instruction) instructions[args.key] = '';
+      client.invalidateQueries({ queryKey: ["workbench", projectId] });
+    },
+    onError: (err) => {
+      toast.error(
+        err instanceof Error ? err.message : t("workbench.runFailed"),
+      );
+    },
+  });
+
+  const saveMutation = createMutation({
+    mutationFn: (args: {
+      key: WorkbenchStageKey;
+      content: Record<string, unknown>;
+    }) =>
+      workbenchApi.patchStage(projectId, args.key, { content: args.content }),
+    onSuccess: () => {
+      toast.success(t("workbench.draftSaved"));
+      client.invalidateQueries({ queryKey: ["workbench", projectId] });
+      client.invalidateQueries({ queryKey: ["projects"] });
+    },
+    onError: (err) => {
+      toast.error(
+        err instanceof Error ? err.message : t("workbench.saveFailed"),
+      );
+    },
+  });
+
+  const confirmMutation = createMutation({
+    mutationFn: (key: WorkbenchStageKey) =>
+      workbenchApi.confirmStage(
+        projectId,
+        key,
+        key === "style" ? chosenStyleId : undefined,
+      ),
+    onSuccess: (_data, key) => {
+      toast.success(t("workbench.confirmed", { agent: agentName(key) }));
+      client.invalidateQueries({ queryKey: ["workbench", projectId] });
+      client.invalidateQueries({ queryKey: ["projects"] });
+      advanceAfterConfirm(key);
+    },
+    onError: (err) => {
+      toast.error(
+        err instanceof Error ? err.message : t("workbench.confirmFailed"),
+      );
+    },
+  });
+
+  const restoreMutation = createMutation({
+    mutationFn: (key: WorkbenchStageKey) =>
+      workbenchApi.restoreStage(projectId, key),
+    onSuccess: () => {
+      toast.success(t("workbench.restored"));
+      client.invalidateQueries({ queryKey: ["workbench", projectId] });
+    },
+    onError: (err) => {
+      toast.error(
+        err instanceof Error ? err.message : t("workbench.restoreFailed"),
+      );
+    },
+  });
+
+  const importMutation = createMutation({
+    mutationFn: (text: string) => workbenchApi.importScript(projectId, text),
+    onSuccess: () => {
+      toast.success(t("workbench.script.importDone"));
+      client.invalidateQueries({ queryKey: ["workbench", projectId] });
+      client.invalidateQueries({ queryKey: ["projects"] });
+      selectStage("style");
+    },
+    onError: (err) => {
+      toast.error(
+        err instanceof Error ? err.message : t("workbench.script.importFailed"),
+      );
+    },
+  });
+
+  const generateMutation = createMutation({
+    mutationFn: (payload: {
+      kind: "image" | "video";
+      stage_key: WorkbenchStageKey;
+      target_id?: string;
+      prompt: string;
+      negative_prompt?: string;
+      duration_sec?: number;
+    }) => workbenchApi.generate(projectId, payload),
+    onSuccess: (data) => {
+      toast.success(t("workbench.jobSubmitted"));
+      client.invalidateQueries({ queryKey: ["workbench", projectId] });
+      client.invalidateQueries({ queryKey: ["jobs", projectId] });
+      void data;
+    },
+    onError: (err) => {
+      toast.error(
+        err instanceof Error ? err.message : t("workbench.jobSubmitFailed"),
+      );
+    },
+  });
+
+  const retryMutation = createMutation({
+    mutationFn: (jobId: number) => jobsApi.retry(jobId),
+    onSuccess: () => {
+      toast.success(t("workbench.jobRequeued"));
+      client.invalidateQueries({ queryKey: ["workbench", projectId] });
+      client.invalidateQueries({ queryKey: ["jobs", projectId] });
+    },
+  });
+
+  const cancelMutation = createMutation({
+    mutationFn: (jobId: number) => jobsApi.cancel(jobId),
+    onSuccess: () => {
+      client.invalidateQueries({ queryKey: ["jobs", projectId] });
+      client.invalidateQueries({ queryKey: ["workbench", projectId] });
+    },
+  });
+
+  function onGenerate(payload: {
+    kind: "image" | "video";
+    targetId: string;
+    prompt: string;
+    negativePrompt?: string;
+    durationSec?: number;
+  }) {
+    $generateMutation.mutate({
+      kind: payload.kind,
+      stage_key: stageKey,
+      target_id: payload.targetId,
+      prompt: payload.prompt,
+      negative_prompt: payload.negativePrompt,
+      duration_sec: payload.durationSec,
+    });
+  }
+
+  // ── Sidebar: agent + tasks ─────────────────────────────────────────
+  const currentAgent = $derived(
+    ($agentsQuery.data ?? []).find((a) => a.key === stageKey) ?? null,
+  );
+  const currentModelName = $derived.by(() => {
+    const agent = currentAgent;
+    const s = $settingsQuery.data;
+    if (!agent || !s) return null;
+    const pid = s.agent_llm_assignments?.[agent.llm_role];
+    const profile = (s.llm_profiles ?? []).find((p) => p.id === pid);
+    return profile?.name ?? null;
+  });
+
+  function openAgentChat() {
+    if (!currentAgent) return;
+    storageSet("calliope.agents.activeKey", currentAgent.key);
+    goto(resolve("/agents"));
+  }
+
+  const projectJobs = $derived(
+    ($jobsQuery.data ?? []).filter(
+      (j) => j.project_id === projectId &&
+        (j.kind === "image" || j.kind === "video") &&
+        (j.payload?.stage_key ?? (j.payload?.workbench as {stage?:string}|undefined)?.stage) === stageKey,
+    ),
+  );
+
+  function jobTime(raw: string | null | undefined): string {
+    const ts = parseDbTs(raw);
+    if (!Number.isFinite(ts)) return "";
+    return new Date(ts).toLocaleTimeString([], {
+      hour: "2-digit",
+      minute: "2-digit",
+    });
+  }
+
+  function jobProgressPct(id: number): number | null {
+    const entry = progressFor(id);
+    return entry?.progress ?? null;
+  }
+
+  // ── Header state helpers ───────────────────────────────────────────
+
+  const STAGE_LABEL: Record<string, string> = {
+    script: "故事",
+    style: "风格",
+    storyboard: "分镜",
+    assets: "素材",
+    shot: "镜头脚本",
+  };
+  const STATUS_LABEL: Record<string, string> = {
+    todo: "workbench.state.todo",
+    running: "workbench.state.running",
+    awaiting_confirm: "workbench.state.draft",
+    confirmed: "workbench.state.confirmed",
+  };
+  const STATUS_CLASS: Record<string, string> = {
+    todo: "",
+    running: "run",
+    awaiting_confirm: "warn",
+    confirmed: "ok",
+  };
+
+  const stageStatus = $derived(currentStage?.status ?? "todo");
+  const isLastStage = $derived(stageKey === "shot");
+
+  const panelProps = $derived.by(() => {
+    const stage = currentStage;
+    if (!stage) return null;
+    return { stage };
+  });
+
+  function handleRun(key: WorkbenchStageKey) {
+    $runMutation.mutate({key,instruction:(instructions[key] ?? '').trim()});
+  }
+</script>
+
+<AppShell
+  active="workbench"
+  title={overview?.project.title ?? "项目"}
+  workspace
+>
+  {#snippet pageHeader({ openSearch })}<StudioHeader
+      title={overview?.project.title ?? "项目"}
+      project
+      onSearch={openSearch}
+    />{/snippet}
+  {#if !$overviewQuery.data && $overviewQuery.isLoading}<div class="project-load-pad">
+      <Skeleton height="64px" /><Skeleton height="280px" />
+    </div>
+  {:else if !overview}<div class="project-load-pad">
+      <p class="load-error">
+        {t("workbench.loadFailed")}<button
+          class="a-btn ghost"
+          onclick={() => $overviewQuery.refetch()}
+          >{t("workbench.retryLoad")}</button
+        >
+      </p>
+    </div>
+  {:else}
+    <div class="project-workspace" data-testid="workbench-page">
+      <StageStepper {stages} activeKey={stageKey} onSelect={selectStage} />
+      <div class="project-body">
+        <section class="project-main">
+          {#if currentStage?.error || (currentStage?.last_run?.status === "failed" && currentStage?.last_run?.error)}<div
+              class="error-banner"
+              data-testid="stage-error"
+            >
+              {currentStage.last_run?.error ?? currentStage.error}
+            </div>{/if}
+          {#if stageStatus === "awaiting_confirm"}<div
+              class="project-draftbar"
+              data-testid="draft-banner"
+            >
+              <Icon name="project-agent" size={18} /><span
+                ><b>{currentAgent?.name ?? STAGE_LABEL[stageKey] + "助手"}</b
+                >交回了本阶段草稿。确认后才会交给下一阶段使用。</span
+              ><span class="b3-grow"></span><button
+                class="a-btn ghost sm"
+                onclick={openAgentChat}>在智能体中打开</button
+              ><button
+                class="a-btn secondary sm"
+                disabled={!currentStage?.confirmed_content}
+                onclick={() => (compareOpen = true)}>对比已确认版</button
+              >
+            </div>{/if}
+          {#if stageStatus === "running"}<div
+              class="project-draftbar"
+              data-testid="running-banner"
+            >
+              <span class="breath"></span>{t("workbench.runningHint", {
+                agent: agentName(stageKey),
+              })}
+            </div>{/if}
+          <div class="project-content">
+            {#if panelProps}
+              <div class="stage-panel">
+                <IncomingResults results={currentStage?.incoming_results??[]} />
+                {#if currentStage?.assistant_note || noteOpen}<details
+                    class="stage-note"
+                    open
+                  >
+                    <summary>助手建议 · 待整理到阶段内容</summary>
+                    {#if noteOpen}<textarea
+                        class="a-input"
+                        aria-label="编辑阶段助手建议"
+                        bind:value={noteText}
+                      ></textarea>
+                      <div class="note-actions">
+                        <button
+                          class="a-btn ghost sm"
+                          disabled={noteBusy}
+                          onclick={() => (noteOpen = false)}>取消</button
+                        ><button
+                          class="a-btn secondary sm"
+                          disabled={noteBusy}
+                          onclick={saveNote}>保存建议</button
+                        >
+                      </div>
+                    {:else}<p>{currentStage?.assistant_note}</p>
+                      <button
+                        class="a-btn ghost sm"
+                        disabled={busyFor(stageKey)}
+                        onclick={() => {
+                          noteText = currentStage?.assistant_note ?? "";
+                          noteOpen = true;
+                        }}>编辑建议</button
+                      >{/if}
+                  </details>{/if}
+                {#if stageKey === "script"}
+                  <ScriptStagePanel
+ bind:this={editor}
+                    stage={panelProps.stage}
+                    projectIdea={overview.project.idea}
+                    busy={busyFor("script")}
+                    onSave={(content) =>
+                      $saveMutation.mutate({ key: "script", content })}
+                    onImport={(text) => $importMutation.mutate(text)}
+                    onRun={() => handleRun("script")}
+                  />
+                {:else if stageKey === "style"}
+                  <StyleStagePanel
+ bind:this={editor}
+                    stage={panelProps.stage}
+                    bind:chosenStyleId
+                    busy={busyFor("style")}
+                    onSave={(content) =>
+                      $saveMutation.mutate({ key: "style", content })}
+                    onRun={() => handleRun("style")}
+                  />
+                {:else if stageKey === "storyboard"}
+                  <StoryboardStagePanel
+ bind:this={editor}
+                    {projectId}
+                    stage={panelProps.stage}
+                    busy={busyFor("storyboard")}
+                    onSave={(content) =>
+                      $saveMutation.mutate({ key: "storyboard", content })}
+                    onRun={() => handleRun("storyboard")}
+                  />
+                {:else if stageKey === "assets"}
+                  <AssetsStagePanel
+ bind:this={editor}
+                    stage={panelProps.stage}
+                    {projectId}
+                    busy={busyFor("assets")}
+                    onSave={(content) =>
+                      $saveMutation.mutate({ key: "assets", content })}
+                    onRun={() => handleRun("assets")}
+                    {onGenerate}
+                    onRetryJob={(jobId) => $retryMutation.mutate(jobId)}
+                  />
+                {:else}
+                  <ShotStagePanel
+ bind:this={editor}
+                    stage={panelProps.stage}
+                    {projectId}
+                    busy={busyFor("shot")}
+                    onSave={(content) =>
+                      $saveMutation.mutate({ key: "shot", content })}
+                    onRun={() => handleRun("shot")}
+                    {onGenerate}
+                    onRetryJob={(jobId) => $retryMutation.mutate(jobId)}
+                  />
+                {/if}
+              </div>
+            {/if}
+          </div>
+        </section>
+        <aside class="project-side">
+          <section class="project-assistant">
+            <h3>本阶段助手</h3>
+            <div class="project-agent">
+              <span class="agent-icon"><Icon name="project-grid" size={20} /></span>
+              <div class="b3-grow">
+                <b>{currentAgent?.name ?? STAGE_LABEL[stageKey] + "助手"}</b
+                ><small
+                  >{currentModelName ?? "未配置模型"} · {currentAgent?.skill_count ??
+                    0} 个技能</small
+                >
+              </div>
+              <button
+                class="a-btn ghost sm"
+                disabled={!currentAgent}
+                onclick={openAgentChat}>对话</button
+              >
+            </div>
+            <div class="stage-input-wrap"><textarea
+              class="stage-instruction"
+              bind:value={instructions[stageKey]}
+              placeholder="补充要求（可选）：节奏更慢、第 3 镜改俯拍…"
+              disabled={busyFor(stageKey)}
+              data-testid="stage-instruction"
+            ></textarea></div>
+            <div class="b3-row">
+              <button
+                class="a-btn secondary sm b3-grow"
+                disabled={busyFor(stageKey) || $runMutation.isPending}
+                onclick={() => handleRun(stageKey)}
+                data-testid="stage-run-btn"
+                ><Icon name="project-refresh" size={14} />{stageStatus === "todo"
+                  ? "生成本阶段"
+                  : "重新生成本阶段"}</button
+              ><button
+                class="a-btn ghost sm"
+                disabled={!currentStage?.confirmed_content ||
+                  busyFor(stageKey) ||
+                  $restoreMutation.isPending}
+                onclick={() => $restoreMutation.mutate(stageKey)}
+                data-testid="stage-restore-btn">恢复已确认版</button
+              >
+            </div>
+            {#if stageKey === "shot"}<a
+                class="a-btn secondary sm"
+                href={resolve("/build-scene")}>三维搭景 · 截取参考图</a
+              >{/if}
+          </section>
+          <section class="project-task-heading">
+            <h3>阶段任务 <span class="a-tag">{projectJobs.length}</span></h3>
+            <span class="b3-grow"></span><a
+              class="a-btn ghost sm"
+              href={resolve("/tasks")}>全部</a
+            >
+          </section>
+          <div class="project-tasks">
+            {#if projectJobs.length === 0}
+              <p class="jobs-empty">{t("workbench.tasksEmpty")}</p>
+            {:else}
+              <ul class="jobs-list" data-testid="workbench-jobs">
+                {#each projectJobs.slice(0, 8) as job (job.id)}
+                  {@const live = jobProgressPct(job.id)}
+                  <li class="job-row">
+                    <span class="job-kind kind-{job.kind}">
+                      <Icon
+                        name={job.kind === "image" ? "image" : "film"}
+                        size={12}
+                      />
+                    </span>
+                    <span class="job-body">
+                      <span class="job-prompt"
+                        >{job.payload?.prompt ??
+                          job.payload?.source ??
+                          `#${job.id}`}</span
+                      >
+                      <span class="job-time mono"
+                        >{jobTime(job.created_at)}</span
+                      >
+                    </span>
+                    <span class="job-state st-{job.status}">
+                      {#if job.status === "running"}
+                        <span class="breath"></span>
+                        {#if live != null}{Math.round(live)}%{:else}{t(
+                            "workbench.jobRunning",
+                          )}{/if}
+                      {:else if job.status === "pending"}
+                        {t("workbench.jobQueued")}
+                      {:else if job.status === "done"}
+                        {t("workbench.jobDone")}
+                      {:else}
+                        {t("workbench.jobFailed")}
+                      {/if}
+                    </span>
+                    {#if job.status === "pending" || job.status === "running"}
+                      <button
+                        type="button"
+                        class="icon-btn"
+                        title={t("workbench.cancelJob")}
+                        onclick={() => $cancelMutation.mutate(job.id)}
+                      >
+                        <Icon name="stop" size={12} />
+                      </button>
+                    {:else if job.status === "failed"}
+                      <button
+                        type="button"
+                        class="icon-btn"
+                        title={t("workbench.retryJob")}
+                        onclick={() => $retryMutation.mutate(job.id)}
+                      >
+                        <Icon name="project-refresh" size={12} />
+                      </button>
+                    {:else if job.output_paths?.[0]}
+                      <a
+                        class="icon-btn"
+                        href={assetUrl(job.output_paths[0]) ?? "#"}
+                        target="_blank"
+                        rel="noopener external"
+                        title={t("workbench.openOutput")}
+                      >
+                        <Icon name="external-link" size={12} />
+                      </a>
+                    {/if}
+                  </li>
+                {/each}
+              </ul>
+            {/if}
+          </div>
+        </aside>
+      </div>
+      <footer class="project-footer">
+        <span class="a-tag {STATUS_CLASS[stageStatus]}"
+          >{t(STATUS_LABEL[stageStatus])}</span
+        ><span class="project-save-state"
+          >{currentStage?.draft_edited
+            ? "已编辑 · 草稿待确认"
+            : "确认后才会交给下一阶段使用"}</span
+        ><span class="b3-grow"></span><button class="a-btn secondary" disabled={busyFor(stageKey) || !currentStage?.content || $saveMutation.isPending} onclick={() => editor?.saveDraft()} data-testid="stage-save-btn">保存草稿</button><button
+          class="a-btn primary"
+          disabled={stageStatus !== "awaiting_confirm" ||
+            $confirmMutation.isPending || !!editor?.hasUnsavedDraft()}
+          onclick={() => $confirmMutation.mutate(stageKey)}
+          data-testid="stage-confirm-btn"
+          ><Icon name="project-check" size={14} />{isLastStage
+            ? "确认镜头脚本"
+            : `确认${STAGE_LABEL[stageKey]}，进入${STAGE_LABEL[STAGE_ORDER[STAGE_ORDER.indexOf(stageKey) + 1]]}阶段`}</button
+        >
+      </footer>
+    </div>{/if}
+</AppShell>
+<Modal bind:open={compareOpen} title="对比已确认版"
+  ><div class="project-compare">
+    <section>
+      <h3>已确认版</h3>
+      <pre>{JSON.stringify(currentStage?.confirmed_content, null, 2)}</pre>
+    </section>
+    <section>
+      <h3>当前草稿</h3>
+      <pre>{JSON.stringify(currentStage?.content, null, 2)}</pre>
+    </section>
+  </div></Modal
+>
+

calliope-web/src/lib/components/workbench/ScriptStagePanel.svelte

@@ -46,6 +46,12 @@
 		importOpen = false;
 		importText = '';
 	}
+
+ export function saveDraft() {
+   if (editing) save();
+   else if (stage.content) onSave?.(stage.content);
+ }
+ export function hasUnsavedDraft() { return editing; }
 </script>
 
 {#if stage.status === 'todo' && !text}