HEL-680: merge S1 grayscale visual foundation (feat/hel-680-grayscale-foundation)

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

calliope-backend/src/calliope/comfyui/parser.py

@@ -13,12 +13,14 @@ from calliope.comfyui.registry import (
     IMAGE_OUTPUT_CLASSES,
     IMAGE_URL_CLASSES,
     NUMBER_CLASSES,
+    OPTIONAL_FRAME_INPUTS,
     TEXT_AREA_CLASSES,
     VIDEO_CLASSES,
     VIDEO_OUTPUT_CLASSES,
     ComfyOutputKind,
     class_to_input_kind,
     class_to_output_kind,
+    optional_frame_sibling,
 )
 from calliope.comfyui.roles import (
     USAGE_VALUES,
@@ -689,6 +691,8 @@ def detect_untagged_inputs(workflow: dict[str, Any]) -> list[dict[str, Any]]:
                 )
             )
 
+    media = _with_optional_frames(workflow, media)
+
     results: list[dict[str, Any]] = []
     positives = [t for t in texts if not t[3]]
     negatives = [t for t in texts if t[3]]
@@ -732,6 +736,42 @@ def detect_untagged_inputs(workflow: dict[str, Any]) -> list[dict[str, Any]]:
     return results
 
 
+def _with_optional_frames(
+    workflow: dict[str, Any], media: list[dict[str, Any]]
+) -> list[dict[str, Any]]:
+    """Insert an optional slot after each frame slot whose node also accepts
+    an unwired optional frame (H3 FL2VA: 首帧 → 尾帧)."""
+    out = list(media)
+    for nid, node in sorted(
+        ((str(k), v) for k, v in workflow.items() if isinstance(v, dict)),
+        key=lambda kv: _node_sort_key(kv[0]),
+    ):
+        for field in OPTIONAL_FRAME_INPUTS.get(str(node.get("class_type") or ""), {}):
+            sibling = optional_frame_sibling(node, field)
+            if sibling is None:
+                continue
+            loader_id = str(node["inputs"][sibling][0])
+            loader = workflow.get(loader_id)
+            if not isinstance(loader, dict) or loader.get("class_type") not in IMAGE_CLASSES:
+                continue
+            at = next(
+                (
+                    i
+                    for i, e in enumerate(out)
+                    if e["nodeId"] == _key(loader_id, loader, "image")
+                ),
+                None,
+            )
+            if at is None:
+                continue
+            role, label = _FRAME_SLOT_ROLES[field]
+            out.insert(
+                at + 1,
+                _entry(f"{nid}{FIELD_KEY_SEP}{field}", label, role, "image", None, False),
+            )
+    return out
+
+
 def _is_negative(
     node_id: str, lowered_title: str, consumers: dict[str, list[tuple[str, str]]]
 ) -> bool:

calliope-backend/src/calliope/comfyui/patcher.py

@@ -11,6 +11,7 @@ from calliope.comfyui.registry import (
     VIDEO_CLASSES,
     VIDEO_FILE_CLASSES,
     class_to_patch_field,
+    optional_frame_sibling,
 )
 
 # Input keys of the form "<nodeId>@<widget>" target one named widget on a
@@ -142,6 +143,26 @@ def apply_media_group(
 apply_image_group = apply_media_group
 
 
+def apply_optional_frame(
+    workflow: dict[str, Any], node_id: str, field: str, sibling: str, path: str
+) -> None:
+    """Wire ``path`` into an unwired optional frame input (H3 ``last_frame``)
+    through a new LoadImage cloned from the ``sibling`` frame's loader."""
+    node = workflow[node_id]
+    inputs = dict(node.get("inputs") or {})
+    src = workflow.get(str(inputs[sibling][0]))
+    if isinstance(src, dict) and str(src.get("class_type") or "") in IMAGE_CLASSES:
+        loader = copy.deepcopy(src)
+    else:
+        loader = {"class_type": "LoadImage", "inputs": {}}
+    loader["inputs"] = {**(loader.get("inputs") or {}), "image": path}
+    loader["_meta"] = {"title": "尾帧" if field == "last_frame" else field}
+    nid = _next_node_id(workflow)
+    workflow[nid] = loader
+    inputs[field] = [nid, 0]
+    node["inputs"] = inputs
+
+
 def patch_workflow(
     base: dict[str, Any],
     values_by_node_id: dict[str, Any],
@@ -167,6 +188,10 @@ def patch_workflow(
                 if clean:
                     apply_media_group(patched, key, field, clean)
             continue
+        if field is not None and (sibling := optional_frame_sibling(node, field)):
+            if isinstance(value, str) and value.strip():
+                apply_optional_frame(patched, key, field, sibling, value)
+            continue
         if field is None:
             field = resolve_patch_field(node)
         elif isinstance(inputs.get(field), list):

calliope-backend/src/calliope/comfyui/registry.py

@@ -1,7 +1,7 @@
 """Unified class_type → kind + patch-field registry (MuseAgent port)."""
 from __future__ import annotations
 
-from typing import Literal
+from typing import Any, Literal
 
 ComfyInputKind = Literal["text", "textarea", "number", "image", "image_url", "audio", "video"]
 ComfyOutputKind = Literal["image", "video", "other"]
@@ -33,6 +33,24 @@ IMAGE_OUTPUT_CLASSES = frozenset(
     {"SaveImage", "PreviewImage", "SaveImageWebsocket", "ETN_SendImageWebSocket",
      "SaveImageAdvanced"}
 )
+# Frame-conditioned video nodes and the optional frame input an export may
+# leave unwired. MiniMax H3's FL2VA node takes `first_frame` plus an
+# optional `last_frame`; the studio offers the slot and the patcher adds
+# the LoadImage only when the user supplies that frame.
+OPTIONAL_FRAME_INPUTS: dict[str, dict[str, str]] = {
+    "MiniMaxH3ImageToVideo": {"last_frame": "first_frame"},
+}
+
+
+def optional_frame_sibling(node: dict[str, Any], field: str) -> str | None:
+    """The wired frame input an unwired optional ``field`` mirrors
+    (``last_frame`` → ``first_frame``); None when it does not apply."""
+    inputs = node.get("inputs") or {}
+    sibling = OPTIONAL_FRAME_INPUTS.get(str(node.get("class_type") or ""), {}).get(field)
+    if sibling is None or field in inputs:
+        return None
+    link = inputs.get(sibling)
+    return sibling if isinstance(link, list) and len(link) == 2 else None
 
 
 def class_to_input_kind(class_type: str) -> ComfyInputKind:

calliope-backend/src/calliope/db.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import json
+import re
 import sqlite3
 from pathlib import Path
 from typing import Any
@@ -410,6 +411,43 @@ def _backfill_workflow_output_map(conn: sqlite3.Connection) -> None:
             )
 
 
+# HEL-671: the user's H3 import went in under a first-frame-only name
+# (“H3图生视频·首帧…”) although its graph is the FL2VA node that also takes
+# a last frame. A row is renamed only when BOTH hold: its graph carries a
+# wired MiniMaxH3ImageToVideo node, and its name still reads like a
+# first-frame-only workflow — a row the user renamed, or any other graph,
+# is left alone. Idempotent: the new name no longer matches.
+_FIRST_FRAME_NAME_RE = re.compile(r"图生视频\s*[·\-—~]?\s*首帧")
+_FL2VA_DESCRIPTION = "首帧必填，尾帧可选：只传首帧为图生视频，同时传尾帧为首尾帧生视频"
+
+
+def _rename_workflows(conn: sqlite3.Connection) -> None:
+    for wid, name, wf_json in conn.execute(
+        "SELECT id, name, workflow_json FROM workflows"
+    ).fetchall():
+        if not name or "尾帧" in name or not _FIRST_FRAME_NAME_RE.search(name):
+            continue
+        try:
+            workflow = json.loads(wf_json) if wf_json else None
+        except (json.JSONDecodeError, TypeError):
+            continue
+        if not isinstance(workflow, dict):
+            continue
+        fl2va = any(
+            isinstance(node, dict)
+            and str(node.get("class_type") or "") == "MiniMaxH3ImageToVideo"
+            and isinstance((node.get("inputs") or {}).get("first_frame"), list)
+            for node in workflow.values()
+        )
+        if not fl2va:
+            continue
+        conn.execute(
+            "UPDATE workflows SET name = ?,"
+            " description = COALESCE(NULLIF(description, ''), ?) WHERE id = ?",
+            (_FIRST_FRAME_NAME_RE.sub("首尾帧生视频", name), _FL2VA_DESCRIPTION, wid),
+        )
+
+
 async def migrate_db(db_path: Path) -> None:
     db_path.parent.mkdir(parents=True, exist_ok=True)
     conn = sqlite3.connect(db_path)
@@ -472,6 +510,7 @@ async def migrate_db(db_path: Path) -> None:
     # upgrades can settle them); confirmed rows are never touched.
     _backfill_workflow_usage(conn)
     _backfill_workflow_output_map(conn)
+    _rename_workflows(conn)
     scene_cols = {r[1] for r in conn.execute("PRAGMA table_info(scenes)").fetchall()}
     if "location_id" not in scene_cols:
         conn.execute("ALTER TABLE scenes ADD COLUMN location_id INTEGER")

calliope-backend/tests/test_image_input_workflows.py

@@ -36,6 +36,7 @@ QWEN_EDIT = "qwen21_edit_sage_API.json"  # qwen-image-2.1-图片编辑-sage加
 EXAMPLES = Path(__file__).resolve().parents[2] / "example_ComfyUI_workflows"
 
 REF_KEY = "131@ref_images"
+LAST_KEY = "131@last_frame"
 
 
 def _load(name: str) -> dict:
@@ -61,7 +62,8 @@ def _ref_links(wf: dict, node_id: str = "131") -> list[tuple[str, str]]:
 # ---------------------------------------------------------------------------
 
 
-def test_i2v_exposes_one_required_first_frame_and_no_last_frame():
+def test_i2v_exposes_required_first_frame_and_optional_last_frame():
+    """HEL-671: the 04 export is H3 FL2VA — `last_frame` is unwired but real."""
     inputs = parse_dynamic_inputs(_load(I2V))
     media = [i for i in inputs if i["kind"] in ("image", "image_list", "video", "audio")]
     assert media == [
@@ -73,10 +75,36 @@ def test_i2v_exposes_one_required_first_frame_and_no_last_frame():
             "defaultValue": None,
             "required": True,
             "auto": True,
-        }
+        },
+        {
+            "nodeId": LAST_KEY,
+            "label": "尾帧",
+            "role": "last_frame",
+            "kind": "image",
+            "defaultValue": None,
+            "required": False,
+            "auto": True,
+        },
     ]
-    # the title comment about FL2V is not a slot
-    assert not any(i.get("role") == "last_frame" for i in inputs)
+
+
+def test_wired_last_frame_is_its_own_slot_not_a_second_virtual_one():
+    wf = _load(I2V)
+    wf["950"] = {"class_type": "LoadImage", "inputs": {"image": "last.png"}}
+    wf["131"]["inputs"]["last_frame"] = ["950", 0]
+    media = [i for i in parse_dynamic_inputs(wf) if i["kind"] == "image"]
+    assert [(i["nodeId"], i["role"], i["required"]) for i in media] == [
+        ("901", "first_frame", True),
+        ("950", "last_frame", True),
+    ]
+
+
+def test_first_frame_through_a_custom_loader_gets_no_last_frame_slot():
+    # Repo example: VHS_LoadImagePath → resize → first_frame; no slot pair to mirror.
+    wf = json.loads(
+        (EXAMPLES / "minimax_h3-Turbo_Image2Video_20260813_API.json").read_text(encoding="utf-8")
+    )
+    assert not any(i.get("role") == "last_frame" for i in parse_dynamic_inputs(wf))
 
 
 def test_ref2v_exposes_one_group_of_one_to_nine_reference_images():
@@ -201,6 +229,29 @@ def test_single_slot_values_patch_first_frame_and_qwen_input():
     assert qwen["4"]["inputs"]["resolution"] == 1536
 
 
+def test_patch_last_frame_adds_its_own_load_image():
+    base = _load(I2V)
+    wf = patch_workflow(base, {"901": "/u/first.png", LAST_KEY: "/u/last.png"})
+    node = wf["131"]["inputs"]
+    assert node["first_frame"] == ["901", 0]
+    last_id = node["last_frame"][0]
+    assert last_id not in base and node["last_frame"] == [last_id, 0]
+    assert wf[last_id]["class_type"] == "LoadImage"
+    assert wf[last_id]["inputs"] == {"image": "/u/last.png"}
+    assert wf["901"]["inputs"]["image"] == "/u/first.png"
+    # base untouched; patching the result again rewires nothing
+    assert "last_frame" not in base["131"]["inputs"]
+    again = patch_workflow(wf, {LAST_KEY: "/u/other.png"})
+    assert again["131"]["inputs"]["last_frame"] == [last_id, 0]
+
+
+def test_patch_without_last_frame_leaves_first_frame_only_graph():
+    for values in ({"901": "/u/first.png"}, {"901": "/u/first.png", LAST_KEY: ""}):
+        wf = patch_workflow(_load(I2V), values)
+        assert "last_frame" not in wf["131"]["inputs"]
+        assert sorted(wf) == sorted(_load(I2V))
+
+
 def test_legacy_job_values_keyed_by_load_image_still_patch():
     """Jobs queued before HEL-633 carry the LoadImage id, not the group key."""
     wf = patch_workflow(_load(REF), {"901": "/assets/uploads/old.png"})
@@ -265,6 +316,14 @@ def test_validate_rejects_bad_reference_files(uploads_dir):
 def test_validate_requires_first_frame_and_input_image():
     _, errs = validate_input_values(parse_dynamic_inputs(_load(I2V)), {"1": "p"})
     assert errs == ["请上传首帧"]
+    _, errs = validate_input_values(
+        parse_dynamic_inputs(_load(I2V)), {"1": "p", LAST_KEY: "/u/l.png"}
+    )
+    assert errs == ["请上传首帧"]
+    clean, errs = validate_input_values(
+        parse_dynamic_inputs(_load(I2V)), {"1": "p", "901": "/u/f.png"}
+    )
+    assert errs == [] and LAST_KEY not in clean
     _, errs = validate_input_values(parse_dynamic_inputs(_load(QWEN_EDIT)), {"4@prompt": "p"})
     assert errs == ["请上传输入图"]
 
@@ -403,9 +462,67 @@ def test_i2v_chain_uploads_first_frame(client, named_comfy):
     prompt = named_comfy.prompts[0]["prompt"]
     assert prompt["901"]["inputs"]["image"] == f"calliope/{Path(first).name}"
     assert prompt["131"]["inputs"]["first_frame"] == ["901", 0]
+    assert "last_frame" not in prompt["131"]["inputs"]
     assert prompt["124"]["inputs"]["denoise"] == 0.8
 
 
+def test_fl2v_chain_uploads_first_and_last_frame_into_their_own_inputs(client, named_comfy):
+    with _real_run(client, named_comfy):
+        wf_id = _import_workflow(client, "H3 首尾帧生视频", "video", _load(I2V))
+        listed = next(w for w in client.get("/api/workflows").json() if w["id"] == wf_id)
+        assert listed["usage"] == "image2video"
+        slots = {i["nodeId"]: i for i in listed["input_schema"] if i["kind"] == "image"}
+        assert slots["901"]["role"] == "first_frame" and slots[LAST_KEY]["role"] == "last_frame"
+        last = _upload(client, "尾帧.png")
+        r = _generate(client, wf_id, {"1": "从白天过渡到夜晚", LAST_KEY: last})
+        assert r.status_code == 400 and "请上传首帧" in r.json()["detail"]
+        first = _upload(client, "首帧.png")
+        r = _generate(client, wf_id, {"1": "从白天过渡到夜晚", "901": first, LAST_KEY: last})
+        assert r.status_code == 200, r.text
+        assert _wait_done(client, r.json()["job"]["id"])["status"] == "done"
+    prompt = named_comfy.prompts[0]["prompt"]
+    node = prompt["131"]["inputs"]
+    assert prompt[node["first_frame"][0]]["inputs"]["image"] == f"calliope/{Path(first).name}"
+    assert prompt[node["last_frame"][0]]["inputs"]["image"] == f"calliope/{Path(last).name}"
+    assert node["first_frame"][0] != node["last_frame"][0]
+    assert sorted(named_comfy.upload_names) == sorted([Path(first).name, Path(last).name])
+
+
+def test_migration_renames_the_imported_first_frame_workflow(tmp_path):
+    import asyncio
+    import sqlite3
+
+    from calliope.db import migrate_db
+
+    db = tmp_path / "c.db"
+    asyncio.run(migrate_db(db))
+    conn = sqlite3.connect(db)
+    i2v, ref = json.dumps(_load(I2V)), json.dumps(_load(REF))
+    conn.executemany(
+        "INSERT INTO workflows (name, kind, workflow_json, description) VALUES (?, 'video', ?, ?)",
+        [
+            ("H3 图生视频·首帧（04 用户提供）", i2v, None),
+            ("H3图生视频·首帧", i2v, "我自己写的说明"),
+            ("图生视频·首帧模板", ref, None),  # not the FL2VA graph — left alone
+            ("我的视频工作流", i2v, None),  # user already renamed — left alone
+        ],
+    )
+    conn.commit()
+    conn.close()
+    asyncio.run(migrate_db(db))
+    asyncio.run(migrate_db(db))  # idempotent
+    conn = sqlite3.connect(db)
+    rows = conn.execute("SELECT name, description FROM workflows ORDER BY id").fetchall()
+    conn.close()
+    assert rows[0] == (
+        "H3 首尾帧生视频（04 用户提供）",
+        "首帧必填，尾帧可选：只传首帧为图生视频，同时传尾帧为首尾帧生视频",
+    )
+    assert rows[1] == ("H3首尾帧生视频", "我自己写的说明")  # suffix kept, description kept
+    assert rows[2] == ("图生视频·首帧模板", None)
+    assert rows[3] == ("我的视频工作流", None)
+
+
 def test_broken_qwen_import_warns_and_generation_is_refused(client, named_comfy):
     with _real_run(client, named_comfy):
         analyzed = client.post("/api/workflows/analyze", json={"workflow_json": _load(QWEN_EDIT)})

calliope-backend/tests/test_usage_classifier.py

@@ -82,13 +82,16 @@ def test_a2_qwen_edit_variant_with_new_ids_titles_and_model_stays_image2image():
     assert len(mask) == 1  # mask never counts as an input image
 
 
-def test_a3_i2v_variant_renamed_still_image2video_first_frame_only():
+def test_a3_i2v_variant_renamed_still_image2video_with_optional_last_frame():
     wf = _rename_everything(_load(FIXTURES / "h3_i2v_04_API.json"))
     c = classify_usage(wf)
     assert c["usage"] == "image2video"
     media = _media(parse_dynamic_inputs(wf))
-    assert [i.get("role") for i in media] == ["first_frame"]
-    # A3: no first/last pair → the pair validation must not fire
+    # HEL-671: the FL2VA node's unwired last_frame is offered, but optional
+    assert [(i.get("role"), i["required"]) for i in media] == [
+        ("first_frame", True),
+        ("last_frame", False),
+    ]
     assert blocking_problem(wf) is None
 
 

calliope-web/package.json

@@ -7,7 +7,7 @@
 		"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",
+		"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 ."
 	},

calliope-web/scripts/check-export-frame.mjs

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+/**
+ * Pure-logic checks for 导出尾帧 (lib/media/exportFrame.ts): which media
+ * times get tried near the end, how the PNG is named, and when a sampled
+ * frame counts as black / empty. The decode + download path itself runs in
+ * a real browser (e2e/lastframe.mjs).
+ *
+ * Run with `npm test` (or `node scripts/check-export-frame.mjs`).
+ */
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+const MODULE = join(HERE, "..", "src", "lib", "media", "exportFrame.ts");
+
+const {
+  tailSeekTimes,
+  videoBaseName,
+  frameFileName,
+  blankKind,
+  statusErrorCode,
+  TAIL_OFFSETS,
+} = await import(pathToFileURL(MODULE).href);
+
+let failures = 0;
+function check(name, cond, extra = "") {
+  if (cond) console.log(`ok    ${name}`);
+  else {
+    failures += 1;
+    console.error(`FAIL  ${name}${extra ? `  — ${extra}` : ""}`);
+  }
+}
+
+// ---- seek targets -------------------------------------------------------
+
+const t6 = tailSeekTimes(6.04);
+check(
+  "first try is ~1 frame before the end, never the end itself",
+  t6[0] < 6.04 && 6.04 - t6[0] <= 0.05 + 1e-9,
+  JSON.stringify(t6),
+);
+check(
+  "later tries step strictly further back",
+  t6.every((t, i) => i === 0 || t < t6[i - 1]),
+  JSON.stringify(t6),
+);
+check(
+  "tries stay within ~1s of the end",
+  t6.length === TAIL_OFFSETS.length && 6.04 - t6[t6.length - 1] <= 1 + 1e-9,
+);
+check(
+  "short clip clamps to 0 without duplicates",
+  JSON.stringify(tailSeekTimes(0.1)) === "[0.05,0]",
+);
+check(
+  "unknown / zero duration falls back to t=0",
+  JSON.stringify(tailSeekTimes(NaN)) === "[0]" &&
+    JSON.stringify(tailSeekTimes(0)) === "[0]",
+);
+
+// ---- file names ---------------------------------------------------------
+
+const api =
+  "/api/file?path=" +
+  encodeURIComponent(
+    "/opt/aigc-home/data/assets/1/video/05_ref2va_4step_sla_00035_.mp4",
+  );
+check(
+  "base name from /api/file?path=…",
+  videoBaseName(api) === "05_ref2va_4step_sla_00035_",
+);
+check(
+  "base name from a Windows path",
+  videoBaseName(
+    "/api/file?path=" +
+      encodeURIComponent("D:\\calliope\\assets\\镜头 01.webm"),
+  ) === "镜头 01",
+);
+check(
+  "base name from a plain URL",
+  videoBaseName("http://x.test/media/clip-9.mov?x=1") === "clip-9",
+);
+check(
+  "unsafe characters are replaced",
+  !/[:*?"<>|]/.test(
+    videoBaseName("/api/file?path=" + encodeURIComponent('a:b*c?"d<e>f|g.mp4')),
+  ),
+);
+check(
+  "blob URL without a name falls back to 'video'",
+  videoBaseName("blob:http://x.test/") === "video",
+);
+const fname = frameFileName(api, 5.958, "尾帧");
+check(
+  "PNG name names the video, the tag and the frame time",
+  fname === "05_ref2va_4step_sla_00035__尾帧_5.958s.png",
+  fname,
+);
+check(
+  "spaces in the tag become dashes",
+  frameFileName(api, 1, "last frame").includes("_last-frame_1.000s.png"),
+);
+
+// ---- black / empty detection -------------------------------------------
+
+function frame(n, rgba) {
+  const out = new Uint8ClampedArray(n * 4);
+  for (let i = 0; i < n; i++) out.set(rgba(i), i * 4);
+  return out;
+}
+const N = 64 * 64;
+check(
+  "fully transparent sample → empty",
+  blankKind(frame(N, () => [0, 0, 0, 0])) === "empty",
+);
+check(
+  "pure black → black",
+  blankKind(frame(N, () => [0, 0, 0, 255])) === "black",
+);
+check(
+  "near-black encoder noise (16..18) → black",
+  blankKind(frame(N, (i) => [16 + (i % 3), 16, 16, 255])) === "black",
+);
+check(
+  "mid-grey picture → not blank",
+  blankKind(frame(N, () => [128, 128, 128, 255])) === null,
+);
+check(
+  "dim but visible picture (≈50) → not blank",
+  blankKind(frame(N, () => [50, 48, 52, 255])) === null,
+);
+check(
+  "dark night scene with a bright highlight → not blank",
+  blankKind(
+    frame(N, (i) => (i === 100 ? [250, 240, 200, 255] : [4, 4, 6, 255])),
+  ) === null,
+);
+
+// ---- HTTP status classification ----------------------------------------
+
+check("404 → not-found", statusErrorCode(404) === "not-found");
+check(
+  "403 → forbidden",
+  statusErrorCode(403) === "forbidden" && statusErrorCode(401) === "forbidden",
+);
+check("500 → network", statusErrorCode(500) === "network");
+check(
+  "206 / 200 are not errors",
+  statusErrorCode(206) === null && statusErrorCode(200) === null,
+);
+
+if (failures) {
+  console.error(`\n${failures} export-frame check(s) failed.`);
+  process.exit(1);
+}
+console.log("export-frame checks passed.");

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

@@ -1,614 +0,0 @@
-<script lang="ts">
-	import { createQuery } from '@tanstack/svelte-query';
-	import { toStore } from 'svelte/store';
-	import { jobsApi, type Job } from '$lib/api';
-	import type { CalliopeEvent, EventConnectionState } from '$lib/events';
-	import { t } from '$lib/i18n.svelte';
-	import JobRow from './JobRow.svelte';
-	import Button from './ui/Button.svelte';
-	import Icon from './ui/Icon.svelte';
-
-	interface Props {
-		logs: CalliopeEvent[];
-		projectId: number;
-		/** Real SSE connection state from events.ts — drives the live pip. */
-		connState: EventConnectionState;
-		collapsed?: boolean;
-		onToggle?: () => void;
-	}
-
-	let { logs, projectId, connState, collapsed = false, onToggle }: Props = $props();
-
-	type Tone = 'info' | 'ok' | 'warn' | 'err' | 'work';
-
-	type LogEntry = {
-		key: string;
-		ts: string;
-		title: string;
-		detail: string;
-		tone: Tone;
-		type: string;
-	};
-
-	function str(v: unknown): string {
-		if (v == null) return '';
-		if (typeof v === 'string') return v;
-		if (typeof v === 'number' || typeof v === 'boolean') return String(v);
-		return '';
-	}
-
-	function formatEvent(ev: CalliopeEvent, index: number): LogEntry | null {
-		// Poll spam — progress lives in the jobProgress store, not the log
-		if (ev.type === 'job.progress') return null;
-
-		const d = ev.data ?? {};
-		const msg = str(d.message).trim();
-		const kind = str(d.kind);
-		const jobId = d.job_id != null ? `#${d.job_id}` : '';
-		const err = str(d.error).trim();
-		const paths = Array.isArray(d.paths) ? d.paths.length : 0;
-		const outputs = Array.isArray(d.outputs) ? d.outputs.length : 0;
-		const time = ev.ts?.includes('T') ? ev.ts.slice(11, 19) : ev.ts?.slice(0, 8) || '';
-
-		let title = ev.type;
-		let detail = msg;
-		let tone: Tone = 'info';
-
-		switch (ev.type) {
-			case 'agent.thinking':
-				title = t('activity.agentWorking');
-				detail = msg || t('activity.working');
-				tone = 'work';
-				break;
-			case 'story.ready':
-				title = t('activity.storyReady');
-				detail = msg || t('activity.storylineDrafted');
-				tone = 'ok';
-				break;
-			case 'job.created':
-				title = t('activity.queued');
-				detail = msg || [kind, jobId].filter(Boolean).join(' ');
-				tone = 'info';
-				break;
-			case 'job.started':
-				title = t('activity.running');
-				detail = msg || [kind, jobId].filter(Boolean).join(' ');
-				tone = 'work';
-				break;
-			case 'job.completed':
-				title = t('activity.finished');
-				detail =
-					msg ||
-					[kind, jobId, outputs ? t('activity.files', { count: outputs }) : '']
-						.filter(Boolean)
-						.join(' · ');
-				tone = 'ok';
-				break;
-			case 'job.failed':
-				title = t('activity.failed');
-				detail = err || msg || [kind, jobId].filter(Boolean).join(' ');
-				tone = 'err';
-				break;
-			case 'asset.ready':
-				title = t('activity.assetReady');
-				detail = msg || (paths ? t('activity.filesSaved', { count: paths }) : t('activity.outputSaved'));
-				tone = 'ok';
-				break;
-			case 'job.deleted':
-				title = t('activity.removed');
-				detail = msg || jobId || t('activity.jobDeleted');
-				tone = 'warn';
-				break;
-			default:
-				title = ev.type.replace(/\./g, ' · ');
-				detail = msg || err || kind;
-				tone = 'info';
-		}
-
-		return {
-			key: `${ev.ts}-${ev.type}-${index}`,
-			ts: time,
-			title,
-			detail,
-			tone,
-			type: ev.type,
-		};
-	}
-
-	const entries = $derived.by(() => {
-		const raw = logs
-			.slice(-120)
-			.map((ev, i) => formatEvent(ev, i))
-			.filter((e): e is LogEntry => e != null);
-
-		// Collapse consecutive identical agent lines
-		const collapsed: LogEntry[] = [];
-		for (const e of raw) {
-			const prev = collapsed[collapsed.length - 1];
-			if (prev && prev.type === e.type && prev.detail === e.detail) {
-				continue;
-			}
-			collapsed.push(e);
-		}
-		return collapsed.slice(-60).reverse();
-	});
-
-	// Same query key as QueueStage — refreshed by SSE invalidation from the
-	// project page (job.* events), not by polling.
-	const jobsQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['jobs', projectId],
-			queryFn: () => jobsApi.list(projectId),
-		})),
-	);
-
-	const allJobs = $derived(($jobsQuery.data ?? []) as Job[]);
-
-	function activeWeight(job: Job): number {
-		if (job.status === 'running') return 0;
-		if (job.status === 'pending') return 1;
-		return 2;
-	}
-
-	// Active jobs first, then most recent — capped so the log keeps room.
-	const queueRows = $derived(
-		[...allJobs].sort((a, b) => activeWeight(a) - activeWeight(b) || b.id - a.id).slice(0, 6),
-	);
-
-	const stats = $derived({
-		running: allJobs.filter((j) => j.status === 'running').length,
-		queued: allJobs.filter((j) => j.status === 'pending').length,
-		done: allJobs.filter((j) => j.status === 'done').length,
-		failed: allJobs.filter((j) => j.status === 'failed').length,
-	});
-	const busyCount = $derived(stats.running + stats.queued);
-
-	const connected = $derived(connState === 'open');
-</script>
-
-<aside class="activity" class:collapsed aria-label={t('activity.title')}>
-	{#if collapsed}
-		<button
-			type="button"
-			class="rail-toggle"
-			onclick={onToggle}
-			aria-expanded="false"
-			title={t('activity.show')}
-		>
-			<span class="pip rail-pip" class:live={connected} class:reconnecting={connState === 'reconnecting'} aria-hidden="true"></span>
-			{#if busyCount > 0}
-				<span class="rail-count" title={t('activity.busyCount', { count: busyCount })}>{busyCount}</span>
-			{/if}
-			<span class="rail-label">{t('activity.title')}</span>
-			<span class="rail-chevron" aria-hidden="true">‹</span>
-		</button>
-	{:else}
-		<header class="head">
-			<div class="head-title">
-				<span class="pip" class:live={connected} class:reconnecting={connState === 'reconnecting'} aria-hidden="true"></span>
-				<strong>{t('activity.title')}</strong>
-				{#if connState === 'reconnecting'}
-					<span class="conn-state warn">{t('activity.reconnecting')}</span>
-				{:else if connState === 'connecting'}
-					<span class="conn-state">{t('activity.connecting')}</span>
-				{/if}
-			</div>
-			<Button variant="ghost" size="sm" onclick={onToggle} title={t('activity.hide')}>
-				{t('activity.hide')} <Icon name="chevron-right" size={13} />
-			</Button>
-		</header>
-
-		<div class="body">
-			<section class="queue" aria-label={t('activity.queue')}>
-				<div class="section-head">
-					<p class="eyebrow">{t('activity.queue')}</p>
-				</div>
-				{#if queueRows.length === 0}
-					<p class="queue-empty">{t('activity.queueIdle')}</p>
-				{:else}
-					<div class="job-list">
-						{#each queueRows as job (job.id)}
-							<JobRow {job} />
-						{/each}
-					</div>
-				{/if}
-				<div class="stats-strip" aria-label={t('activity.queueStats')}>
-					<span><span class="sd sd-running" aria-hidden="true"></span>{stats.running} {t('activity.running').toLowerCase()}</span>
-					<span><span class="sd sd-queued" aria-hidden="true"></span>{stats.queued} {t('activity.queued').toLowerCase()}</span>
-					<span><span class="sd sd-done" aria-hidden="true"></span>{stats.done} {t('activity.done')}</span>
-					<span><span class="sd sd-failed" aria-hidden="true"></span>{stats.failed} {t('activity.failed').toLowerCase()}</span>
-				</div>
-			</section>
-
-			<section class="log-section" aria-label={t('activity.agentLog')}>
-				<p class="eyebrow">{t('activity.agentLog')}</p>
-				{#if entries.length === 0}
-					<div class="empty">
-						<p>{t('activity.quiet')}</p>
-						<p class="hint">{t('activity.quietHint')}</p>
-					</div>
-				{:else}
-					<ul class="log">
-						{#each entries as ev (ev.key)}
-							<li class="entry tone-{ev.tone}">
-								<span class="dot" aria-hidden="true"></span>
-								<div class="meta">
-									<div class="row">
-										<span class="title">{ev.title}</span>
-										<time class="ts" datetime={ev.ts}>{ev.ts}</time>
-									</div>
-									{#if ev.detail}
-										<p class="detail">{ev.detail}</p>
-									{/if}
-								</div>
-							</li>
-						{/each}
-					</ul>
-				{/if}
-			</section>
-		</div>
-	{/if}
-</aside>
-
-<style>
-	.activity {
-		--panel-w: 320px;
-		--rail-w: 44px;
-		width: var(--panel-w);
-		flex-shrink: 0;
-		display: flex;
-		flex-direction: column;
-		min-height: 0;
-		height: 100%;
-		border-left: 1px solid var(--border);
-		background:
-			linear-gradient(180deg, rgba(139, 92, 246, 0.06) 0%, transparent 120px),
-			var(--bg-surface);
-		overflow: hidden;
-		transition: width 0.2s ease;
-	}
-
-	.activity.collapsed {
-		width: var(--rail-w);
-		background: var(--bg-surface);
-	}
-
-	.rail-toggle {
-		display: flex;
-		flex-direction: column;
-		align-items: center;
-		justify-content: flex-start;
-		gap: 12px;
-		width: 100%;
-		height: 100%;
-		margin: 0;
-		padding: 16px 0;
-		border: none;
-		background: transparent;
-		color: var(--text-secondary);
-		cursor: pointer;
-		overflow: hidden;
-	}
-
-	.rail-toggle:hover {
-		background: rgba(139, 92, 246, 0.08);
-		color: var(--text-primary);
-	}
-
-	.rail-toggle:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: -2px;
-	}
-
-	.rail-label {
-		writing-mode: vertical-rl;
-		transform: rotate(180deg);
-		font-family: var(--font-display);
-		font-size: 12px;
-		font-weight: 600;
-		letter-spacing: 0.12em;
-		text-transform: uppercase;
-	}
-
-	.rail-chevron {
-		font-size: 18px;
-		line-height: 1;
-		color: var(--text-muted);
-	}
-
-	.rail-count {
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		min-width: 20px;
-		height: 20px;
-		padding: 0 5px;
-		border-radius: 999px;
-		background: var(--accent);
-		color: #fff;
-		font-family: var(--font-mono);
-		font-size: 11px;
-		font-weight: 700;
-	}
-
-	.pip {
-		width: 8px;
-		height: 8px;
-		border-radius: 50%;
-		background: var(--text-muted);
-		flex-shrink: 0;
-	}
-
-	.pip.live {
-		background: var(--accent);
-		box-shadow: 0 0 0 4px var(--accent-glow);
-		animation: live-pulse 1.6s ease-in-out infinite;
-	}
-
-	.pip.reconnecting {
-		background: var(--warning);
-		box-shadow: 0 0 0 4px rgba(245, 158, 11, 0.18);
-	}
-
-	@keyframes live-pulse {
-		0%,
-		100% {
-			opacity: 1;
-			transform: scale(1);
-		}
-		50% {
-			opacity: 0.65;
-			transform: scale(0.92);
-		}
-	}
-
-	@media (prefers-reduced-motion: reduce) {
-		.activity {
-			transition: none;
-		}
-		.pip.live {
-			animation: none;
-		}
-	}
-
-	.head {
-		display: flex;
-		align-items: center;
-		justify-content: space-between;
-		gap: 8px;
-		padding: 14px 14px 10px;
-		border-bottom: 1px solid var(--border);
-		flex-shrink: 0;
-	}
-
-	.head-title {
-		display: flex;
-		align-items: center;
-		gap: 10px;
-		min-width: 0;
-	}
-
-	.head-title strong {
-		font-family: var(--font-display);
-		font-size: 15px;
-		font-weight: 650;
-		letter-spacing: -0.02em;
-	}
-
-	.conn-state {
-		font-size: 11px;
-		color: var(--text-muted);
-		white-space: nowrap;
-	}
-
-	.conn-state.warn {
-		color: var(--warning);
-	}
-
-	.body {
-		flex: 1;
-		min-height: 0;
-		display: flex;
-		flex-direction: column;
-		padding: 12px 10px 16px;
-		overflow: hidden;
-	}
-
-	.queue {
-		flex-shrink: 0;
-		display: flex;
-		flex-direction: column;
-		min-height: 0;
-		margin-bottom: 14px;
-	}
-
-	.section-head {
-		display: flex;
-		align-items: baseline;
-		justify-content: space-between;
-		flex-shrink: 0;
-	}
-
-	.job-list {
-		display: flex;
-		flex-direction: column;
-		gap: 6px;
-		max-height: 216px;
-		overflow-y: auto;
-		padding-right: 4px;
-	}
-
-	.queue-empty {
-		margin: 0 6px 4px;
-		padding: 12px 14px;
-		border: 1px dashed var(--border);
-		border-radius: var(--radius-md);
-		background: rgba(0, 0, 0, 0.2);
-		font-size: 12px;
-		line-height: 1.45;
-		color: var(--text-muted);
-	}
-
-	.stats-strip {
-		display: flex;
-		flex-wrap: wrap;
-		gap: 4px 12px;
-		margin: 10px 6px 0;
-		padding-top: 10px;
-		border-top: 1px solid var(--border);
-		font-family: var(--font-mono);
-		font-size: 10px;
-		color: var(--text-secondary);
-		flex-shrink: 0;
-	}
-
-	.stats-strip > span {
-		display: inline-flex;
-		align-items: center;
-		gap: 5px;
-		white-space: nowrap;
-	}
-
-	.sd {
-		width: 6px;
-		height: 6px;
-		border-radius: 50%;
-	}
-
-	.sd-running {
-		background: var(--info);
-	}
-	.sd-queued {
-		background: var(--text-muted);
-	}
-	.sd-done {
-		background: var(--success);
-	}
-	.sd-failed {
-		background: var(--error);
-	}
-
-	.log-section {
-		flex: 1;
-		min-height: 0;
-		display: flex;
-		flex-direction: column;
-	}
-
-	.eyebrow {
-		margin: 0 6px 10px;
-		font-size: 11px;
-		font-weight: 600;
-		letter-spacing: 0.08em;
-		text-transform: uppercase;
-		color: var(--text-muted);
-		flex-shrink: 0;
-	}
-
-	.empty {
-		margin: 8px 6px;
-		padding: 16px;
-		border: 1px dashed var(--border);
-		border-radius: var(--radius-md);
-		background: rgba(0, 0, 0, 0.2);
-	}
-
-	.empty p {
-		margin: 0;
-		font-size: 13px;
-		color: var(--text-secondary);
-	}
-
-	.empty .hint {
-		margin-top: 8px;
-		font-size: 12px;
-		color: var(--text-muted);
-		line-height: 1.45;
-	}
-
-	.log {
-		list-style: none;
-		margin: 0;
-		padding: 0 4px 8px 0;
-		overflow-y: auto;
-		overflow-x: hidden;
-		flex: 1;
-		min-height: 0;
-		display: flex;
-		flex-direction: column;
-		gap: 2px;
-	}
-
-	.entry {
-		display: grid;
-		grid-template-columns: 14px 1fr;
-		gap: 8px;
-		padding: 8px 8px 8px 4px;
-		border-radius: var(--radius-sm);
-	}
-
-	.entry:hover {
-		background: rgba(255, 255, 255, 0.03);
-	}
-
-	.dot {
-		width: 8px;
-		height: 8px;
-		margin-top: 5px;
-		border-radius: 50%;
-		background: var(--text-muted);
-		justify-self: center;
-	}
-
-	.tone-ok .dot {
-		background: var(--success);
-	}
-	.tone-err .dot {
-		background: var(--error);
-	}
-	.tone-warn .dot {
-		background: var(--warning);
-	}
-	.tone-work .dot {
-		background: var(--accent);
-	}
-	.tone-info .dot {
-		background: var(--info);
-	}
-
-	.meta {
-		min-width: 0;
-	}
-
-	.row {
-		display: flex;
-		align-items: baseline;
-		justify-content: space-between;
-		gap: 8px;
-	}
-
-	.title {
-		font-size: 12px;
-		font-weight: 650;
-		color: var(--text-primary);
-	}
-
-	.ts {
-		font-family: var(--font-mono);
-		font-size: 10px;
-		color: var(--text-muted);
-		flex-shrink: 0;
-	}
-
-	.detail {
-		margin: 3px 0 0;
-		font-size: 12px;
-		line-height: 1.4;
-		color: var(--text-secondary);
-		word-break: break-word;
-	}
-
-	.tone-err .detail {
-		color: #fca5a5;
-	}
-</style>

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

@@ -15,8 +15,8 @@ interface Props {
 
 <header class="header">
 	<div class="header-left">
-		<a class="logo" href="/canvas" title="Calliope Lab">
-			Calliope <span>Lab</span>
+		<a class="logo" href="/" title={t('shell.brand')}>
+			{t('shell.brand')}
 		</a>
 		{#if crumb}
 			<span class="crumb">{crumb}</span>
@@ -28,7 +28,7 @@ interface Props {
 		{/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="/projects">{t('nav.projects')}</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>
@@ -69,18 +69,14 @@ interface Props {
 		flex-shrink: 0;
 	}
 	.logo {
-		font-family: var(--font-display);
-		font-size: 18px;
+		font-family: var(--font);
+		font-size: 15px;
 		font-weight: 700;
-		color: var(--text-primary);
+		color: var(--text);
 		text-decoration: none;
-		letter-spacing: -0.02em;
+		letter-spacing: -0.01em;
 		white-space: nowrap;
 	}
-	.logo span {
-		color: var(--accent);
-		font-weight: 500;
-	}
 	.crumb {
 		color: var(--text-muted);
 		font-size: 13px;
@@ -122,7 +118,7 @@ interface Props {
 		outline: 2px solid var(--accent);
 		outline-offset: 2px;
 	}
-	@media (max-width: 640px) {
+	@media (max-width: 760px) {
 		.header {
 			padding: 12px 16px;
 			flex-direction: column;

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

@@ -1,133 +0,0 @@
-<script lang="ts">
-	import { t } from '$lib/i18n.svelte';
-	import SafeMedia from '$lib/components/SafeMedia.svelte';
-	import StatusChip from '$lib/components/ui/StatusChip.svelte';
-
-	interface Props {
-		src: string | null;
-		alt: string;
-		placeholder: string;
-		wide?: boolean;
-		/** Taller 4:3 media-first crop (asset card grids). */
-		tall?: boolean;
-		/** Latest generation-job state for this asset, if the parent tracks jobs. */
-		jobState?: 'generating' | 'failed' | null;
-		onPreview?: (src: string) => void;
-	}
-
-	let {
-		src,
-		alt,
-		placeholder,
-		wide = false,
-		tall = false,
-		jobState = null,
-		onPreview,
-	}: Props = $props();
-
-	let available = $state(false);
-
-	$effect(() => {
-		void src;
-		available = false;
-	});
-
-	// Job state (live from the queue) wins over the media-derived state.
-	const chip = $derived.by((): { status: string; label: string } => {
-		if (jobState === 'generating') return { status: 'generating', label: t('common.generating') };
-		if (jobState === 'failed') return { status: 'failed', label: t('common.failed') };
-		if (available) return { status: 'ready', label: t('common.ready') };
-		if (src) return { status: 'missing', label: t('common.missing') };
-		return { status: 'pending', label: t('common.pending') };
-	});
-
-	function open() {
-		if (available && src && onPreview) onPreview(src);
-	}
-
-	function onKey(e: KeyboardEvent) {
-		if (e.key === 'Enter' || e.key === ' ') {
-			e.preventDefault();
-			open();
-		}
-	}
-</script>
-
-<!-- svelte-ignore a11y_no_noninteractive_tabindex a11y_no_noninteractive_element_interactions -->
-<div
-	class="thumb"
-	class:wide
-	class:tall
-	class:clickable={available && !!onPreview}
-	role={available && onPreview ? 'button' : undefined}
-	tabindex={available && onPreview ? 0 : undefined}
-	onclick={open}
-	onkeydown={available && onPreview ? onKey : undefined}
->
-	<SafeMedia
-		class="fill"
-		{src}
-		{alt}
-		label={placeholder}
-		onAvailable={() => (available = true)}
-		onUnavailable={() => (available = false)}
-	/>
-	<span class="thumb-chip">
-		<StatusChip status={chip.status} label={chip.label} />
-	</span>
-</div>
-
-<style>
-	.thumb {
-		aspect-ratio: 1;
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-sm);
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		position: relative;
-		overflow: hidden;
-		padding: 0;
-		margin: 0;
-		width: 100%;
-		color: inherit;
-		font: inherit;
-		box-sizing: border-box;
-	}
-	.thumb.wide {
-		aspect-ratio: 16 / 10;
-	}
-	.thumb.tall {
-		aspect-ratio: 4 / 3;
-	}
-	.thumb.clickable {
-		cursor: zoom-in;
-	}
-	.thumb.clickable:hover {
-		border-color: var(--accent, #a78bfa);
-	}
-	.thumb.clickable:focus-visible {
-		outline: 2px solid var(--accent, #a78bfa);
-		outline-offset: 2px;
-	}
-	.thumb :global(.fill) {
-		width: 100%;
-		height: 100%;
-		object-fit: cover;
-		border: none;
-		border-radius: 0;
-		min-height: 0;
-	}
-	.thumb :global(.safe-media-ph.fill) {
-		position: absolute;
-		inset: 0;
-	}
-	.thumb-chip {
-		position: absolute;
-		top: 8px;
-		left: 8px;
-		z-index: 1;
-		filter: drop-shadow(0 1px 3px rgba(0, 0, 0, 0.6));
-	}
-</style>

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

@@ -136,9 +136,9 @@
 
 	const projectList = $derived(($projectsQuery.data ?? []) as Project[]);
 
-	// Stage-URL contract: images land on Assets, clips on Video.
+	// Five-stage workbench URL contract: images land on 素材资产, clips on 镜头脚本.
 	const stageLink = $derived(
-		attached ? `/project/${attached.projectId}?stage=${isVideo ? 'video' : 'assets'}` : '',
+		attached ? `/workbench/${attached.projectId}?stage=${isVideo ? 'shot' : 'assets'}` : '',
 	);
 </script>
 
@@ -267,13 +267,13 @@
 	.attached {
 		display: flex;
 		align-items: center;
-		gap: 8px;
-		padding: 8px 10px;
-		background: rgba(34, 197, 94, 0.08);
-		border: 1px solid rgba(34, 197, 94, 0.3);
-		border-radius: var(--radius-md);
-		font-size: 12px;
-		color: var(--text-secondary);
+		gap: var(--sp-3);
+		padding: var(--sp-3) var(--sp-4);
+		background: var(--ok-soft);
+		border: 1px solid color-mix(in srgb, var(--ok) 30%, transparent);
+		border-radius: var(--r-md);
+		font-size: var(--fs-aux);
+		color: var(--text-2);
 	}
 	.attached-check {
 		display: flex;
@@ -282,8 +282,8 @@
 		width: 20px;
 		height: 20px;
 		border-radius: 50%;
-		background: var(--success);
-		color: #052e12;
+		background: var(--ok);
+		color: var(--bg);
 		flex-shrink: 0;
 	}
 	.attached-text {
@@ -293,23 +293,26 @@
 		white-space: nowrap;
 	}
 	.attached-text strong {
-		color: var(--text-primary);
+		color: var(--text);
 		font-weight: 600;
 	}
+	/* 普通链接走 ghost（§1.2）：默认 --text-2，悬停 --text，不用金色文字链接。 */
 	.attached-link {
-		color: var(--accent);
-		font-weight: 600;
+		color: var(--text-2);
+		font-weight: 500;
 		text-decoration: none;
 		white-space: nowrap;
 		flex-shrink: 0;
 	}
 	.attached-link:hover {
+		color: var(--text);
 		text-decoration: underline;
+		text-underline-offset: 3px;
 	}
 	.attached-link:focus-visible {
 		outline: 2px solid var(--accent);
 		outline-offset: 2px;
-		border-radius: var(--radius-sm);
+		border-radius: var(--r-sm);
 	}
 	.attached-dismiss {
 		display: flex;
@@ -319,15 +322,15 @@
 		height: 22px;
 		margin-left: auto;
 		border: none;
-		border-radius: var(--radius-sm);
+		border-radius: var(--r-sm);
 		background: transparent;
-		color: var(--text-muted);
+		color: var(--text-3);
 		cursor: pointer;
 		flex-shrink: 0;
 	}
 	.attached-dismiss:hover {
-		color: var(--text-primary);
-		background: rgba(255, 255, 255, 0.06);
+		color: var(--text);
+		background: var(--bg-4);
 	}
 	.attached-dismiss:focus-visible {
 		outline: 2px solid var(--accent);
@@ -336,20 +339,20 @@
 	.panel {
 		display: flex;
 		flex-direction: column;
-		gap: 4px;
-		padding: 12px;
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-md);
+		gap: var(--sp-1);
+		padding: var(--sp-5);
+		background: var(--bg-3);
+		border: 1px solid var(--line);
+		border-radius: var(--r-md);
 	}
 	.actions {
 		display: flex;
-		gap: 8px;
-		margin-top: 4px;
+		gap: var(--sp-3);
+		margin-top: var(--sp-1);
 	}
 	.err {
-		margin: 4px 0 0;
-		font-size: 12px;
-		color: var(--error);
+		margin: var(--sp-1) 0 0;
+		font-size: var(--fs-aux);
+		color: var(--err);
 	}
 </style>

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

@@ -1,7 +1,9 @@
 <script lang="ts">
 	import SafeMedia from '$lib/components/SafeMedia.svelte';
 	import Icon from '$lib/components/ui/Icon.svelte';
+	import Spinner from '$lib/components/ui/Spinner.svelte';
 	import { t } from '$lib/i18n.svelte';
+	import { exportLastFrame } from '$lib/media/lastFrame';
 
 	interface Props {
 		src: string | null;
@@ -61,6 +63,17 @@
 		}
 		return alt ? `${alt.trim().replace(/\s+/g, '-').toLowerCase()}.png` : 'media';
 	});
+
+	let frameBusy = $state(false);
+	async function exportTail() {
+		if (!src || frameBusy) return;
+		frameBusy = true;
+		try {
+			await exportLastFrame(src);
+		} finally {
+			frameBusy = false;
+		}
+	}
 </script>
 
 <svelte:window onkeydown={src ? onKeydown : undefined} />
@@ -90,6 +103,26 @@ aria-label={zoomed ? t('lightbox.fitToScreen') : t('lightbox.zoom100')}
 					<Icon name="zoom-in" size={17} />
 				</button>
 			{/if}
+			{#if isVideo}
+				<button
+					class="tool"
+					type="button"
+					aria-label={frameBusy ? t('lastFrame.exporting') : t('lastFrame.export')}
+					title={frameBusy ? t('lastFrame.exporting') : `${t('lastFrame.export')} · ${t('lastFrame.hint')}`}
+					disabled={frameBusy}
+					aria-busy={frameBusy}
+					onclick={(e) => {
+						e.stopPropagation();
+						exportTail();
+					}}
+				>
+					{#if frameBusy}
+						<Spinner size="sm" />
+					{:else}
+						<Icon name="image" size={17} />
+					{/if}
+				</button>
+			{/if}
 			<a
 				class="tool"
 				href={src}

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

@@ -1,164 +0,0 @@
-<script lang="ts">
-	import { useQueryClient } from '@tanstack/svelte-query';
-	import { jobsApi, type Job } from '$lib/api';
-	import { t } from '$lib/i18n.svelte';
-	import { progressFor } from '$lib/jobProgress';
-	import { toast } from '$lib/toast';
-	import Button from './ui/Button.svelte';
-	import Icon from './ui/Icon.svelte';
-	import type { IconName } from './ui/icons';
-	import ProgressBar from './ui/ProgressBar.svelte';
-	import StatusChip from './ui/StatusChip.svelte';
-
-	interface Props {
-		job: Job;
-		/** Optional override for the leading label (defaults to "Kind #id"). */
-		label?: string;
-	}
-
-	let { job, label }: Props = $props();
-
-	const client = useQueryClient();
-	let busy = $state(false);
-
-	const kindIcon: IconName = $derived(
-		job.kind === 'video'
-			? 'video'
-			: job.kind === 'image'
-				? 'image'
-				: job.kind === 'export'
-					? 'film'
-					: 'queue',
-	);
-	const kindLabel = $derived(
-		job.kind === 'export'
-			? t('job.exportFilm')
-			: job.kind.charAt(0).toUpperCase() + job.kind.slice(1),
-	);
-	const title = $derived(label ?? t('job.title', { kind: kindLabel, id: String(job.id) }));
-	const active = $derived(job.status === 'pending' || job.status === 'running');
-	const entry = $derived(progressFor(job.id));
-
-	async function refresh() {
-		await client.invalidateQueries({ queryKey: ['jobs'] });
-		await client.invalidateQueries({ queryKey: ['playground-jobs'] });
-	}
-
-	async function cancel() {
-		busy = true;
-		try {
-			await jobsApi.cancel(job.id);
-			await refresh();
-			toast.info(t('job.cancelled', { id: String(job.id) }));
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('job.cancelFailed'));
-		} finally {
-			busy = false;
-		}
-	}
-
-	async function retry() {
-		busy = true;
-		try {
-			await jobsApi.retry(job.id);
-			await refresh();
-			toast.success(t('job.requeued', { id: String(job.id) }));
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('job.retryFailed'));
-		} finally {
-			busy = false;
-		}
-	}
-</script>
-
-<div class="job-row">
-	<span class="kind" aria-hidden="true"><Icon name={kindIcon} size={14} /></span>
-	<div class="main">
-		<div class="top">
-			<span class="label" {title}>{title}</span>
-			<StatusChip status={job.status} />
-		</div>
-		{#if active}
-			<div class="bar">
-				<ProgressBar
-					size="sm"
-					value={entry?.progress ?? 0}
-					indeterminate={job.status === 'running' && entry == null}
-					label={entry?.message}
-				/>
-			</div>
-		{:else if job.status === 'failed' && job.error}
-			<p class="err" title={job.error}>{job.error}</p>
-		{/if}
-	</div>
-	<div class="actions">
-		{#if active}
-			<Button size="sm" variant="ghost" loading={busy} title={t('job.cancelJob')} onclick={cancel}>
-				<Icon name="close" size={13} />
-			</Button>
-		{:else if job.status === 'failed'}
-			<Button size="sm" variant="ghost" loading={busy} title={t('job.retryJob')} onclick={retry}>
-				<Icon name="retry" size={13} />
-			</Button>
-		{/if}
-	</div>
-</div>
-
-<style>
-	.job-row {
-		display: grid;
-		grid-template-columns: 20px 1fr auto;
-		gap: 8px;
-		align-items: start;
-		padding: 8px;
-		border: 1px solid var(--border);
-		border-radius: var(--radius-sm);
-		background: var(--bg-elevated);
-	}
-	.kind {
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		height: 20px;
-		color: var(--text-muted);
-	}
-	.main {
-		min-width: 0;
-		display: flex;
-		flex-direction: column;
-		gap: 6px;
-	}
-	.top {
-		display: flex;
-		align-items: center;
-		justify-content: space-between;
-		gap: 8px;
-		min-height: 20px;
-	}
-	.label {
-		font-size: 12px;
-		font-weight: 600;
-		color: var(--text-primary);
-		white-space: nowrap;
-		overflow: hidden;
-		text-overflow: ellipsis;
-	}
-	.bar {
-		padding-bottom: 2px;
-	}
-	.err {
-		margin: 0;
-		font-size: 11px;
-		line-height: 1.4;
-		color: var(--error);
-		display: -webkit-box;
-		-webkit-line-clamp: 2;
-		line-clamp: 2;
-		-webkit-box-orient: vertical;
-		overflow: hidden;
-	}
-	.actions {
-		display: flex;
-		align-items: center;
-	}
-</style>

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

@@ -1,137 +0,0 @@
-<script lang="ts">
-	import { goto } from '$app/navigation';
-	import { t } from '$lib/i18n.svelte';
-	import Icon from '$lib/components/ui/Icon.svelte';
-	import type { IconName } from '$lib/components/ui/icons';
-
-	const items = $derived(
-		[
-			{ id: 'story', key: 'nav.story', icon: 'story' },
-			{ id: 'assets', key: 'nav.assets', icon: 'assets' },
-			{ id: 'script', key: 'nav.script', icon: 'script' },
-			{ id: 'video', key: 'nav.video', icon: 'video' },
-		] as { id: string; key: string; icon: IconName }[],
-	);
-
-	interface Props {
-		active?: string;
-		onSelect?: (id: string) => void;
-		/** Optional per-stage counts — a nonzero value shows a small pill on the icon. */
-		badges?: Record<string, number>;
-	}
-
-	let { active = 'story', onSelect, badges = {} }: Props = $props();
-</script>
-
-<nav class="nav" aria-label={t('nav.projectStages')}>
-	<button
-		class="nav-item home"
-		title={t('nav.projects')}
-		aria-label={t('nav.backProjects')}
-		onclick={() => goto('/projects')}
-	>
-		<span class="icon"><Icon name="home" size={20} /></span>
-		<span class="label">{t('nav.home')}</span>
-	</button>
-	<div class="divider" aria-hidden="true"></div>
-	{#each items as item (item.id)}
-		{@const count = badges[item.id] ?? 0}
-		<button
-			class="nav-item"
-			class:active={active === item.id}
-			title={t(item.key)}
-			aria-current={active === item.id ? 'page' : undefined}
-			onclick={() => onSelect?.(item.id)}
-		>
-			<span class="icon">
-				<Icon name={item.icon} size={20} />
-				{#if count > 0}
-					<span class="badge" aria-label={t('nav.countActive', { count })}>
-						{count > 9 ? '9+' : count}
-					</span>
-				{/if}
-			</span>
-			<span class="label">{t(item.key)}</span>
-		</button>
-	{/each}
-</nav>
-
-<style>
-	.nav {
-		width: 64px;
-		background: var(--bg-surface);
-		border-right: 1px solid var(--border);
-		display: flex;
-		flex-direction: column;
-		align-items: center;
-		padding: var(--space-md) 0;
-		gap: var(--space-sm);
-		flex-shrink: 0;
-	}
-	.divider {
-		width: 32px;
-		height: 1px;
-		background: var(--border);
-		margin: 2px 0 4px;
-	}
-	.nav-item {
-		width: 56px;
-		border: none;
-		background: transparent;
-		border-radius: var(--radius-md);
-		display: flex;
-		flex-direction: column;
-		align-items: center;
-		justify-content: center;
-		gap: 4px;
-		padding: 8px 0;
-		cursor: pointer;
-		color: var(--text-muted);
-		font-size: 11px;
-		font-family: inherit;
-		transition: all 0.15s;
-	}
-	.nav-item:hover {
-		background: var(--bg-elevated);
-		color: var(--text-primary);
-	}
-	.nav-item.active {
-		background: var(--accent);
-		color: white;
-		box-shadow: 0 0 16px var(--accent-glow);
-	}
-	.nav-item.home:hover {
-		color: var(--accent);
-	}
-	.nav-item:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
-	}
-	.icon {
-		position: relative;
-		display: inline-flex;
-		line-height: 1;
-	}
-	.badge {
-		position: absolute;
-		top: -6px;
-		right: -12px;
-		min-width: 15px;
-		height: 15px;
-		padding: 0 4px;
-		box-sizing: border-box;
-		border-radius: 999px;
-		background: var(--accent);
-		color: #fff;
-		font-size: 9px;
-		font-weight: 700;
-		line-height: 15px;
-		text-align: center;
-		box-shadow: 0 0 0 2px var(--bg-surface);
-	}
-	.nav-item.active .badge {
-		background: #fff;
-		color: var(--accent);
-		box-shadow: 0 0 0 2px var(--accent);
-	}
-</style>

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

@@ -1,478 +0,0 @@
-<script lang="ts">
-	import { goto } from '$app/navigation';
-	import { createMutation, createQuery, useQueryClient } from '@tanstack/svelte-query';
-	import { assetUrl, projects, type Project } from '$lib/api';
-	import { toast } from '$lib/toast';
-	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 Modal from '$lib/components/ui/Modal.svelte';
-	import StatusChip from '$lib/components/ui/StatusChip.svelte';
-	import { t } from '$lib/i18n.svelte';
-
-	interface Props {
-		project: Project;
-	}
-
-	const { project }: Props = $props();
-
-	const client = useQueryClient();
-
-	const stats = $derived(
-		project.stats ?? {
-			scene_count: 0,
-			character_count: 0,
-			asset_ready_count: 0,
-			asset_total_count: 0,
-		},
-	);
-
-	// Explicit project cover wins; otherwise fall back to the first asset image.
-	// The project prop is stable for the lifetime of a card, so the eager
-	// queryKey capture below is intentional.
-	// svelte-ignore state_referenced_locally
-	const assetsQuery = createQuery({
-		queryKey: ['assets', project.id],
-		queryFn: () => projects.getAssets(project.id),
-		staleTime: 60_000,
-	});
-
-	const thumbUrl = $derived.by(() => {
-		if (project.cover_path) return assetUrl(project.cover_path);
-		const data = $assetsQuery.data;
-		if (!data) return null;
-		const char = data.characters.find((c) => c.portrait_path || c.sheet_path);
-		const path =
-			char?.portrait_path ??
-			char?.sheet_path ??
-			data.locations.find((l) => l.reference_image_path)?.reference_image_path ??
-			null;
-		return assetUrl(path);
-	});
-
-	// A broken cover (deleted file, 404) falls back to the gradient tile.
-	let thumbFailedFor = $state<string | null>(null);
-
-	function relativeTime(iso: string): string {
-		const then = new Date(iso).getTime();
-		if (Number.isNaN(then)) return '';
-		const mins = Math.max(0, Math.round((Date.now() - then) / 60000));
-		if (mins < 1) return t('projectCard.timeJustNow');
-		if (mins < 60) return t('projectCard.timeM', { count: mins });
-		const hours = Math.round(mins / 60);
-		if (hours < 24) return t('projectCard.timeH', { count: hours });
-		const days = Math.round(hours / 24);
-		if (days < 30) return t('projectCard.timeD', { count: days });
-		const months = Math.round(days / 30);
-		if (months < 12) return t('projectCard.timeMo', { count: months });
-		return t('projectCard.timeY', { count: Math.round(months / 12) });
-	}
-
-	const updatedLabel = $derived(relativeTime(project.updated_at));
-	const updatedTitle = $derived(new Date(project.updated_at).toLocaleString());
-
-	// Overflow menu (⋯) — closes on outside click, focus leaving, or Esc.
-	let menuOpen = $state(false);
-	let menuEl = $state<HTMLDivElement | null>(null);
-
-	$effect(() => {
-		if (!menuOpen) return;
-		const onDocClick = (e: MouseEvent) => {
-			if (menuEl && !menuEl.contains(e.target as Node)) menuOpen = false;
-		};
-		const onKey = (e: KeyboardEvent) => {
-			if (e.key === 'Escape') menuOpen = false;
-		};
-		const onFocusIn = (e: FocusEvent) => {
-			if (menuEl && !menuEl.contains(e.target as Node)) menuOpen = false;
-		};
-		window.addEventListener('click', onDocClick);
-		window.addEventListener('keydown', onKey);
-		document.addEventListener('focusin', onFocusIn);
-		return () => {
-			window.removeEventListener('click', onDocClick);
-			window.removeEventListener('keydown', onKey);
-			document.removeEventListener('focusin', onFocusIn);
-		};
-	});
-
-	let renameOpen = $state(false);
-	let renameValue = $state('');
-
-	const renameMutation = createMutation({
-		mutationFn: (title: string) => projects.update(project.id, { title }),
-		onSuccess: (updated) => {
-			client.invalidateQueries({ queryKey: ['projects'] });
-			toast.success(t('projectCard.renamedTo', { title: updated.title }));
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('projectCard.renameFailed'));
-		},
-	});
-
-	function openRename() {
-		menuOpen = false;
-		renameValue = project.title;
-		renameOpen = true;
-	}
-
-	function submitRename() {
-		const title = renameValue.trim();
-		renameOpen = false;
-		if (!title || title === project.title) return;
-		$renameMutation.mutate(title);
-	}
-
-	let deleteOpen = $state(false);
-
-	const deleteMutation = createMutation({
-		mutationFn: () => projects.delete(project.id),
-		onSuccess: () => {
-			client.invalidateQueries({ queryKey: ['projects'] });
-			toast.success(t('projectCard.deleted', { title: project.title }));
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('projectCard.deleteFailed'));
-		},
-	});
-</script>
-
-<article class="project-card">
-	<button
-		type="button"
-		class="card-main"
-		aria-label={t('projectCard.open', { title: project.title })}
-		onclick={() => goto(`/project/${project.id}`)}
-	>
-		<div class="card-thumb">
-			{#if thumbUrl && thumbFailedFor !== thumbUrl}
-				<img
-					class="thumb-img"
-					src={thumbUrl}
-					alt=""
-					loading="lazy"
-					onerror={() => (thumbFailedFor = thumbUrl)}
-				/>
-			{:else}
-				<div class="card-thumb-icon"><Icon name="video" size={26} /></div>
-			{/if}
-			<div class="card-status">
-				<StatusChip status={project.status} label={t(`projectCard.status.${project.status}`)} />
-			</div>
-		</div>
-		<div class="card-body">
-			<div class="card-title">
-				{project.title}
-				<span class="open-arrow">→</span>
-			</div>
-			<p class="card-desc">{project.idea || t('projectCard.noIdea')}</p>
-			<div class="card-meta">
-				<div class="card-stats">
-					<span class="card-stat">
-						<Icon name="script" size={13} />
-						{t('projectCard.scenes', { count: stats.scene_count })}
-					</span>
-					<span class="card-stat">
-						<Icon name="assets" size={13} />
-						{t('projectCard.characters', { count: stats.character_count })}
-					</span>
-					<span class="card-stat">
-						<Icon name="image" size={13} />
-						{t('projectCard.assets', {
-							ready: stats.asset_ready_count,
-							total: stats.asset_total_count,
-						})}
-					</span>
-				</div>
-				<span title={updatedTitle}>{updatedLabel}</span>
-			</div>
-		</div>
-	</button>
-
-	<div class="menu-wrap" bind:this={menuEl}>
-		<button
-			type="button"
-			class="menu-btn"
-			aria-label={t('projectCard.actions', { title: project.title })}
-			aria-haspopup="menu"
-			aria-expanded={menuOpen}
-			onclick={() => (menuOpen = !menuOpen)}
-		>
-			⋯
-		</button>
-		{#if menuOpen}
-			<div class="menu" role="menu" aria-label={t('projectCard.menuLabel')}>
-				<button type="button" role="menuitem" class="menu-item" onclick={openRename}>
-					<Icon name="edit" size={14} />
-					{t('common.rename')}
-				</button>
-				<button
-					type="button"
-					role="menuitem"
-					class="menu-item"
-					onclick={() => {
-						menuOpen = false;
-						goto(`/project/${project.id}?stage=assets`);
-					}}
-				>
-					<Icon name="image" size={14} />
-					{t('projectCard.changeCover')}
-				</button>
-				<button
-					type="button"
-					role="menuitem"
-					class="menu-item danger"
-					onclick={() => {
-						menuOpen = false;
-						deleteOpen = true;
-					}}
-				>
-					<Icon name="trash" size={14} />
-					{t('common.delete')}
-				</button>
-			</div>
-		{/if}
-	</div>
-</article>
-
-<Modal bind:open={renameOpen} title={t('projectCard.renameTitle')}>
-	<form
-		onsubmit={(e) => {
-			e.preventDefault();
-			submitRename();
-		}}
-	>
-		<label class="field">
-			<span class="field-label">{t('common.title')}</span>
-			<input class="field-input" bind:value={renameValue} required />
-		</label>
-	</form>
-	{#snippet footer()}
-		<Button variant="ghost" onclick={() => (renameOpen = false)}>{t('common.cancel')}</Button>
-		<Button
-			variant="primary"
-			disabled={!renameValue.trim() || $renameMutation.isPending}
-			onclick={submitRename}
-		>
-			{t('common.rename')}
-		</Button>
-	{/snippet}
-</Modal>
-
-<ConfirmDialog
-	bind:open={deleteOpen}
-	title={t('projectCard.deleteTitle')}
-	message={t('projectCard.deleteMessage', { title: project.title })}
-	confirmLabel={t('common.delete')}
-	danger
-	onconfirm={() => $deleteMutation.mutate()}
-/>
-
-<style>
-	.project-card {
-		position: relative;
-		background: var(--bg-surface);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-lg);
-		overflow: hidden;
-		transition: all 0.2s;
-	}
-	.project-card:hover {
-		border-color: var(--accent);
-		transform: translateY(-2px);
-		box-shadow: 0 8px 32px rgba(0, 0, 0, 0.35);
-	}
-	.project-card:hover .open-arrow {
-		opacity: 1;
-		transform: translateX(0);
-	}
-	.card-main {
-		display: block;
-		width: 100%;
-		padding: 0;
-		border: none;
-		background: transparent;
-		color: inherit;
-		font: inherit;
-		text-align: left;
-		cursor: pointer;
-	}
-	.card-main:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: -2px;
-	}
-	.card-thumb {
-		height: 170px;
-		background: linear-gradient(135deg, var(--bg-elevated) 0%, #1a1625 100%);
-		position: relative;
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		overflow: hidden;
-	}
-	.card-thumb::before {
-		content: '';
-		position: absolute;
-		inset: 0;
-		background:
-			radial-gradient(circle at 20% 30%, rgba(139, 92, 246, 0.12) 0%, transparent 40%),
-			radial-gradient(circle at 80% 70%, rgba(59, 130, 246, 0.08) 0%, transparent 40%);
-	}
-	.thumb-img {
-		position: absolute;
-		inset: 0;
-		width: 100%;
-		height: 100%;
-		object-fit: cover;
-	}
-	.card-thumb-icon {
-		width: 64px;
-		height: 64px;
-		border-radius: var(--radius-md);
-		background: rgba(139, 92, 246, 0.12);
-		border: 1px solid rgba(139, 92, 246, 0.2);
-		color: var(--accent);
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		position: relative;
-		z-index: 1;
-	}
-	.card-status {
-		position: absolute;
-		top: 8px;
-		right: 8px;
-		z-index: 2;
-		filter: drop-shadow(0 1px 3px rgba(0, 0, 0, 0.6));
-	}
-	.card-body {
-		padding: var(--space-md);
-	}
-	.card-title {
-		font-size: 16px;
-		font-weight: 600;
-		margin: 0 0 var(--space-xs);
-		display: flex;
-		justify-content: space-between;
-		align-items: center;
-		gap: var(--space-sm);
-	}
-	.open-arrow {
-		color: var(--accent);
-		opacity: 0;
-		transform: translateX(-8px);
-		transition: all 0.2s;
-		font-size: 14px;
-	}
-	.card-desc {
-		color: var(--text-secondary);
-		font-size: 13px;
-		line-height: 1.5;
-		margin: 0 0 var(--space-md);
-		display: -webkit-box;
-		-webkit-line-clamp: 2;
-		line-clamp: 2;
-		-webkit-box-orient: vertical;
-		overflow: hidden;
-	}
-	.card-meta {
-		display: flex;
-		justify-content: space-between;
-		align-items: center;
-		gap: var(--space-sm);
-		font-size: 12px;
-		color: var(--text-muted);
-	}
-	.card-stats {
-		display: flex;
-		gap: var(--space-md);
-		flex-wrap: wrap;
-	}
-	.card-stat {
-		display: flex;
-		align-items: center;
-		gap: 4px;
-	}
-	.menu-wrap {
-		position: absolute;
-		top: 8px;
-		left: 8px;
-		z-index: 3;
-	}
-	.menu-btn {
-		width: 30px;
-		height: 30px;
-		border: 1px solid transparent;
-		border-radius: var(--radius-sm);
-		background: rgba(10, 10, 12, 0.55);
-		color: var(--text-secondary);
-		font-size: 16px;
-		line-height: 1;
-		cursor: pointer;
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		opacity: 0;
-		transition: all 0.15s;
-	}
-	.project-card:hover .menu-btn,
-	.menu-btn:focus-visible,
-	.menu-btn[aria-expanded='true'] {
-		opacity: 1;
-	}
-	.menu-btn:hover {
-		background: var(--bg-elevated);
-		color: var(--text-primary);
-		border-color: var(--border);
-	}
-	.menu-btn:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
-	}
-	.menu {
-		position: absolute;
-		top: 34px;
-		left: 0;
-		min-width: 140px;
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-md);
-		box-shadow: 0 12px 32px rgba(0, 0, 0, 0.45);
-		padding: 4px;
-		display: flex;
-		flex-direction: column;
-	}
-	.menu-item {
-		display: flex;
-		align-items: center;
-		gap: 8px;
-		width: 100%;
-		padding: 8px 10px;
-		border: none;
-		border-radius: var(--radius-sm);
-		background: transparent;
-		color: var(--text-primary);
-		font-size: 13px;
-		font-family: inherit;
-		cursor: pointer;
-		text-align: left;
-	}
-	.menu-item:hover {
-		background: rgba(255, 255, 255, 0.06);
-	}
-	.menu-item.danger {
-		color: var(--error);
-	}
-	.menu-item.danger:hover {
-		background: rgba(239, 68, 68, 0.12);
-	}
-	.menu-item:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: -2px;
-	}
-	@media (prefers-reduced-motion: reduce) {
-		.project-card:hover {
-			transform: none;
-		}
-	}
-</style>

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

@@ -1,867 +0,0 @@
-<script lang="ts">
-	import { tick } from 'svelte';
-	import { goto } from '$app/navigation';
-	import { toStore } from 'svelte/store';
-	import { createMutation, createQuery, useQueryClient } from '@tanstack/svelte-query';
-	import { assetUrl, jobsApi, projects, type Job, type Scene, type Clip } from '$lib/api';
-	import { estimateTargetSeconds } from '$lib/durationBudget';
-	import { agentDeepLink } from '$lib/agentTasks';
-	import { toast } from '$lib/toast';
-	import { t } from '$lib/i18n.svelte';
-	import Button from '$lib/components/ui/Button.svelte';
-	import StatusChip from '$lib/components/ui/StatusChip.svelte';
-	import Modal from '$lib/components/ui/Modal.svelte';
-	import ConfirmDialog from '$lib/components/ui/ConfirmDialog.svelte';
-	import EmptyState from '$lib/components/ui/EmptyState.svelte';
-	import Icon from '$lib/components/ui/Icon.svelte';
-
-	interface Props {
-		projectId: number;
-	}
-
-	let { projectId }: Props = $props();
-	const client = useQueryClient();
-	let editing = $state<Scene | null>(null);
-	let editOpen = $state(false);
-	let highlightId = $state<number | null>(null);
-	let adding = $state(false);
-	let deletingId = $state<number | null>(null);
-	let sceneToDelete = $state<Scene | null>(null);
-	let deleteOpen = $state(false);
-
-	const scenesQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['scenes', projectId],
-			queryFn: () => projects.getScenes(projectId),
-		})),
-	);
-
-	// Shared cache key with QueueStage — clip job state shows up on scene cards
-	// too. Refreshed via SSE invalidation from the project page, not polling.
-	const jobsQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['jobs', projectId],
-			queryFn: () => jobsApi.list(projectId),
-		})),
-	);
-
-	// Cache-shared with the parent's story query — only used for the target-length hint.
-	const storyQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['story', projectId],
-			queryFn: () => projects.getStory(projectId),
-		})),
-	);
-
-	// Cache-shared with AssetsStage — resolves scene location chips.
-	const assetsQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['assets', projectId],
-			queryFn: () => projects.getAssets(projectId),
-		})),
-	);
-
-	const scenes = $derived($scenesQuery.data?.scenes ?? []);
-	const sceneCount = $derived(scenes.length);
-	const totalClips = $derived(scenes.reduce((n, s) => n + (s.clips?.length ?? 0), 0));
-	const totalSec = $derived($scenesQuery.data?.estimated_duration_sec ?? 0);
-	const targetSec = $derived.by(() => {
-		const target = $storyQuery.data?.project?.target_duration;
-		return target ? estimateTargetSeconds(target) : 0;
-	});
-
-	const busy = $derived(adding || deletingId != null);
-
-	// ── Break into shots (coverage expansion) ────────────────────────────
-	let expandingIds = $state<number[]>([]);
-	let expandingAll = $state(false);
-	let expandedIds = $state<number[]>([]);
-
-	function isExpanded(scene: Scene): boolean {
-		return (scene.clips?.length ?? 0) > 1 || expandedIds.includes(scene.id);
-	}
-
-	async function breakIntoShots(scene: Scene) {
-		if (expandingIds.length > 0 || expandingAll) return;
-		expandingIds = [...expandingIds, scene.id];
-		try {
-			const res = await projects.expandClips(projectId, { scene_ids: [scene.id] });
-			expandedIds = [...new Set([...expandedIds, scene.id])];
-			await client.invalidateQueries({ queryKey: ['scenes'] });
-			toast.success(
-				t('script.toast.breakIntoShots', {
-					num: scene.order_index,
-					clips: res.scenes?.[0]?.clip_count ?? '?',
-				}),
-			);
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('script.toast.breakFail'));
-		} finally {
-			expandingIds = expandingIds.filter((id) => id !== scene.id);
-		}
-	}
-
-	async function breakAllIntoShots() {
-		if (expandingIds.length > 0 || expandingAll) return;
-		if (
-			!window.confirm(t('script.toast.breakAllConfirm', { count: sceneCount }))
-		)
-			return;
-		expandingAll = true;
-		try {
-			const res = await projects.expandClips(projectId, { all: true });
-			expandedIds = scenes.map((s) => s.id);
-			await client.invalidateQueries({ queryKey: ['scenes'] });
-			toast.success(t('script.toast.boardExpanded', { count: res.total_clips }));
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('script.toast.breakAllFail'));
-		} finally {
-			expandingAll = false;
-		}
-	}
-
-	async function deleteClip(clip: Clip, scene: Scene) {
-		try {
-			await projects.deleteClip(projectId, clip.id);
-			await client.invalidateQueries({ queryKey: ['scenes'] });
-			toast.success(t('script.toast.deletedShot', { num: `${scene.order_index}.${clip.order_index}` }));
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('script.toast.deleteClipFail'));
-		}
-	}
-
-	const saveMutation = createMutation({
-		mutationFn: () =>
-			projects.updateScene(projectId, editing!.id, {
-				heading: editing!.heading,
-				action: editing!.action,
-				dialog: editing!.dialog,
-				duration_sec: editing!.duration_sec,
-			}),
-		onSuccess: () => {
-			editing = null;
-			editOpen = false;
-			client.invalidateQueries({ queryKey: ['scenes'] });
-			toast.success(t('script.toast.sceneSaved'));
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('script.toast.saveSceneFail'));
-		},
-	});
-
-	// Chain-from-previous toggle — persists on the scene; consumed at render time.
-	let chainPendingId = $state<number | null>(null);
-	async function toggleChain(scene: Scene) {
-		if (chainPendingId != null) return;
-		chainPendingId = scene.id;
-		try {
-			await projects.updateScene(projectId, scene.id, {
-				chain_from_prev: !scene.chain_from_prev,
-			});
-			await client.invalidateQueries({ queryKey: ['scenes'] });
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('script.toast.updateSceneFail'));
-		} finally {
-			chainPendingId = null;
-		}
-	}
-
-	function jobForScene(sceneId: number): Job | undefined {
-		const jobs = ($jobsQuery.data ?? []).filter(
-			(j) => j.scene_id === sceneId && j.kind === 'video',
-		);
-		if (jobs.length === 0) return undefined;
-		return [...jobs].sort((a, b) => b.id - a.id)[0];
-	}
-
-	function jobForClip(clipId: number): Job | undefined {
-		const jobs = ($jobsQuery.data ?? []).filter(
-			(j) => (j as Job & { clip_id?: number | null }).clip_id === clipId && j.kind === 'video',
-		);
-		if (jobs.length === 0) return undefined;
-		return [...jobs].sort((a, b) => b.id - a.id)[0];
-	}
-
-	/** Per-scene production status — only uses fields the API actually exposes. */
-	function sceneStatus(scene: Scene): { status: string; label: string } {
-		const job = jobForScene(scene.id);
-		if (job && (job.status === 'pending' || job.status === 'running')) {
-			return { status: 'generating', label: t('script.status.rendering') };
-		}
-		if (job?.status === 'failed') return { status: 'failed', label: t('script.status.renderFailed') };
-		if (scene.video_path || job?.status === 'done') {
-			return { status: 'ready', label: t('script.status.clipReady') };
-		}
-		return { status: 'idle', label: t('script.status.noClip') };
-	}
-
-	function locationName(scene: Scene): string | null {
-		if (scene.location_id == null) return null;
-		const locs = $assetsQuery.data?.locations ?? [];
-		return locs.find((l) => l.id === scene.location_id)?.name ?? null;
-	}
-
-	function avatarFor(char: { portrait_path: string | null; sheet_path: string | null }) {
-		return assetUrl(char.portrait_path ?? char.sheet_path);
-	}
-
-	function initialsOf(name: string): string {
-		const parts = name.trim().split(/\s+/).filter(Boolean);
-		if (parts.length === 0) return '?';
-		return parts
-			.slice(0, 2)
-			.map((p) => p[0].toUpperCase())
-			.join('');
-	}
-
-	/** Hide a broken avatar image (portrait moved/deleted on disk), revealing initials. */
-	function hideBrokenAvatar(e: Event) {
-		const img = e.currentTarget as HTMLImageElement | null;
-		if (img) img.style.display = 'none';
-	}
-
-	function formatClock(sec: number): string {
-		const s = Math.max(0, Math.round(sec));
-		const m = Math.floor(s / 60);
-		const r = s % 60;
-		return `${m}:${r.toString().padStart(2, '0')}`;
-	}
-
-	async function move(sceneId: number, dir: -1 | 1) {
-		if (busy) return;
-		const list = $scenesQuery.data?.scenes ?? [];
-		const idx = list.findIndex((s) => s.id === sceneId);
-		const swap = idx + dir;
-		if (idx < 0 || swap < 0 || swap >= list.length) return;
-		const ids = list.map((s) => s.id);
-		[ids[idx], ids[swap]] = [ids[swap], ids[idx]];
-		await projects.reorderScenes(projectId, ids);
-		client.invalidateQueries({ queryKey: ['scenes'] });
-	}
-
-	/** Hand off script regeneration to a fresh, project-linked agent chat. */
-	function requestRegenerate() {
-		if (busy) return;
-		goto(agentDeepLink(projectId, 'script'));
-	}
-
-	function openEdit(scene: Scene) {
-		editing = { ...scene };
-		editOpen = true;
-	}
-
-	async function addScene() {
-		if (busy) return;
-		adding = true;
-		try {
-			const existing = $scenesQuery.data?.scenes ?? [];
-			const nextIndex = existing.length + 1;
-			const created = await projects.createScene(projectId, {
-				order_index: nextIndex,
-				heading: `NEW SCENE ${nextIndex}`,
-				action: '',
-				dialog: '',
-				duration_sec: 5,
-			});
-			// Keep order_index contiguous 1..n so Regenerate sees the real board size
-			const ids = [...existing.map((s) => s.id), created.id];
-			await projects.reorderScenes(projectId, ids);
-			await client.invalidateQueries({ queryKey: ['scenes'] });
-			await client.refetchQueries({ queryKey: ['scenes', projectId] });
-			editing = { ...created, order_index: nextIndex, heading: `NEW SCENE ${nextIndex}` };
-			editOpen = true;
-			highlightId = created.id;
-			await tick();
-			document
-				.getElementById(`scene-${created.id}`)
-				?.scrollIntoView({ behavior: 'smooth', block: 'center' });
-			toast.success(t('script.toast.sceneAdded', { num: nextIndex }));
-			window.setTimeout(() => {
-				if (highlightId === created.id) highlightId = null;
-			}, 2800);
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('script.toast.addSceneFail'));
-		} finally {
-			adding = false;
-		}
-	}
-
-	function requestDelete(scene: Scene) {
-		if (busy) return;
-		sceneToDelete = scene;
-		deleteOpen = true;
-	}
-
-	async function confirmDeleteScene() {
-		const scene = sceneToDelete;
-		sceneToDelete = null;
-		if (!scene || busy) return;
-		const label = scene.heading?.trim() || `Scene #${scene.order_index}`;
-		deletingId = scene.id;
-		try {
-			await projects.deleteScene(projectId, scene.id);
-			if (editing?.id === scene.id) {
-				editing = null;
-				editOpen = false;
-			}
-			const remaining = ($scenesQuery.data?.scenes ?? [])
-				.filter((s) => s.id !== scene.id)
-				.map((s) => s.id);
-			if (remaining.length > 0) {
-				await projects.reorderScenes(projectId, remaining);
-			}
-			await client.invalidateQueries({ queryKey: ['scenes'] });
-			toast.success(t('script.toast.deleted', { name: label }));
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('script.toast.deleteFailed'));
-		} finally {
-			deletingId = null;
-		}
-	}
-</script>
-
-<header class="stage-header">
-	<div>
-		<h2>3. Script</h2>
-		<p class="muted">
-			Estimated duration: {formatClock(totalSec)}
-			{#if targetSec > 0}
-				/ target ~{formatClock(targetSec)}
-			{/if}
-			{#if sceneCount > 0}
-				· {sceneCount} scenes
-				{#if totalClips > 0}
-					/ {totalClips} shot clips
-				{/if}
-			{/if}
-		</p>
-	</div>
-	<div class="stage-actions">
-		<Button variant="secondary" disabled={busy} loading={adding} onclick={addScene}>
-			<Icon name="plus" size={14} /> {t('script.addScene')}
-		</Button>
-		<Button
-			variant="secondary"
-			disabled={busy || expandingAll || expandingIds.length > 0 || sceneCount === 0}
-			loading={expandingAll}
-			onclick={breakAllIntoShots}
-			title={t('script.breakAllTitle')}
-		>
-			<Icon name="film" size={14} /> {t('script.breakAllIntoShots')}
-		</Button>
-		<Button variant="primary" disabled={busy} onclick={requestRegenerate}>
-			<Icon name="sparkle" size={15} /> {t('script.regenerate')}
-		</Button>
-	</div>
-</header>
-
-<div class="script-panel">
-	{#if $scenesQuery.isLoading}
-		<div class="card">{t('script.loadingScenes')}</div>
-	{:else if sceneCount === 0}
-		<EmptyState
-			title={t('script.noScenesTitle')}
-			body={t('script.noScenesBody')}
-		>
-			{#snippet icon()}
-				<Icon name="script" size={28} />
-			{/snippet}
-			{#snippet action()}
-				<Button variant="secondary" disabled={busy} loading={adding} onclick={addScene}>
-					<Icon name="plus" size={14} /> {t('script.addScene')}
-				</Button>
-			{/snippet}
-		</EmptyState>
-	{:else}
-		{#each scenes as scene, i (scene.id)}
-			{@const st = sceneStatus(scene)}
-			{@const locName = locationName(scene)}
-			<article
-				id="scene-{scene.id}"
-				class="card scene"
-				class:fresh={highlightId === scene.id}
-				class:deleting={deletingId === scene.id}
-			>
-				<div class="scene-head">
-					<div class="scene-title">
-						<span class="grip" aria-hidden="true"><Icon name="drag" size={14} /></span>
-						<span class="num">#{scene.order_index}</span>
-						<strong>{scene.heading || t('script.untitledScene')}</strong>
-						{#if highlightId === scene.id}
-							<span class="fresh-tag">{t('script.justAdded')}</span>
-						{/if}
-						<StatusChip status={st.status} label={st.label} />
-					</div>
-					<div class="actions">
-						<button
-							type="button"
-							class="icon-btn"
-							aria-label={t('script.moveSceneUp')}
-							title={t('script.moveSceneUp')}
-							disabled={busy || i === 0}
-							onclick={() => move(scene.id, -1)}
-						>
-							<Icon name="chevron-up" size={15} />
-						</button>
-						<button
-							type="button"
-							class="icon-btn"
-							aria-label={t('script.moveSceneDown')}
-							title={t('script.moveSceneDown')}
-							disabled={busy || i === sceneCount - 1}
-							onclick={() => move(scene.id, 1)}
-						>
-							<Icon name="chevron-down" size={15} />
-						</button>
-						<Button variant="secondary" size="sm" disabled={busy} onclick={() => openEdit(scene)}>
-							{t('script.edit')}
-						</Button>
-						<Button
-							variant="danger"
-							size="sm"
-							disabled={busy}
-							loading={deletingId === scene.id}
-							onclick={() => requestDelete(scene)}
-						>
-							{t('script.delete')}
-						</Button>
-					</div>
-				</div>
-				{#if scene.action}
-					<p class="muted">{scene.action}</p>
-				{:else}
-					<p class="muted empty-line">{t('script.noActionYet')}</p>
-				{/if}
-				{#if scene.dialog}
-					<pre class="dialog">{scene.dialog}</pre>
-				{/if}
-				<div class="clip-block">
-					<div class="clip-head">
-						<span class="clip-title">
-							<Icon name="film" size={12} />
-							{(scene.clips ?? []).length}
-							{((scene.clips ?? []).length === 1 ? t('script.shotClipSingular') : t('script.shotClipPlural', { n: (scene.clips ?? []).length }))}
-							{#if (scene.clips ?? []).some((c) => c.clip_path)}
-								· {t('script.renderedCount', { count: (scene.clips ?? []).filter((c) => c.clip_path).length })}
-							{/if}
-						</span>
-						<Button
-							variant="secondary"
-							size="sm"
-							disabled={busy || expandingIds.length > 0 || expandingAll}
-							loading={expandingIds.includes(scene.id)}
-							onclick={() => breakIntoShots(scene)}
-							title={isExpanded(scene) ? t('script.rebreakTitle') : t('script.breakTitle')}
-						>
-							{isExpanded(scene) ? t('script.rebreak') : t('script.break')}
-						</Button>
-					</div>
-					{#if isExpanded(scene) && (scene.clips ?? []).length > 1}
-						<ul class="clip-list">
-							{#each scene.clips ?? [] as clip (clip.id)}
-								{@const clipJob = jobForClip(clip.id)}
-								<li class="clip-row">
-									<span class="clip-num" class:ready={Boolean(clip.clip_path)}>
-										#{scene.order_index}.{clip.order_index}
-									</span>
-									<span class="clip-desc">{clip.description || t('script.untitledShot')}</span>
-									{#if clip.shot_size}
-										<span class="chip">{clip.shot_size}</span>
-									{/if}
-									{#if clipJob && (clipJob.status === 'pending' || clipJob.status === 'running')}
-										<span class="chip chip-render">{t('script.rendering')}</span>
-									{:else if clip.clip_path}
-										<span class="chip chip-ok">✓ {t('script.clipDone')}</span>
-									{/if}
-									{#if clip.duration_sec}
-										<span class="clip-dur">{clip.duration_sec}s</span>
-									{/if}
-									<button
-										type="button"
-										class="icon-btn"
-										aria-label={t('script.deleteShotAria', { id: `${scene.order_index}.${clip.order_index}` })}
-										title={t('script.deleteShotTitle')}
-										onclick={() => deleteClip(clip, scene)}
-									>
-										<Icon name="trash" size={13} />
-									</button>
-								</li>
-							{/each}
-						</ul>
-					{/if}
-				</div>
-				<div class="chips">
-					{#each scene.characters ?? [] as c (c.id)}
-						{@const avatar = avatarFor(c)}
-						<span class="chip">
-							<span class="avatar">
-								<span class="initials" aria-hidden="true">{initialsOf(c.name)}</span>
-								{#if avatar}
-									<img src={avatar} alt="" loading="lazy" onerror={hideBrokenAvatar} />
-								{/if}
-							</span>
-							{c.name}
-						</span>
-					{/each}
-					{#if locName}
-						<span class="chip"><Icon name="folder" size={12} /> {locName}</span>
-					{/if}
-					{#if scene.duration_sec}
-						<span class="chip"><Icon name="clock" size={12} /> {formatClock(scene.duration_sec)}</span>
-					{/if}
-					{#if i > 0}
-						<button
-							type="button"
-							class="chip chip-toggle"
-							class:chip-on={Boolean(scene.chain_from_prev)}
-							disabled={chainPendingId === scene.id}
-						title={t('script.chainTitle')}
-						onclick={() => toggleChain(scene)}
-					>
-						<Icon name="film" size={12} />
-						{Boolean(scene.chain_from_prev) ? t('script.chainOn') : t('script.chainOff')}
-						</button>
-					{/if}
-				</div>
-			</article>
-		{/each}
-	{/if}
-</div>
-
-<Modal
-	bind:open={editOpen}
-	title={editing ? t('script.editSceneNumbered', { n: editing.order_index }) : t('script.editScene')}
-	onclose={() => (editing = null)}
->
-	{#if editing}
-		<label class="field">
-			<span class="field-label">{t('script.headingField')}</span>
-			<input class="field-input" bind:value={editing.heading} placeholder={t('script.headingPlaceholder')} />
-		</label>
-		<label class="field">
-			<span class="field-label">{t('script.actionField')}</span>
-			<textarea
-				class="field-textarea"
-				bind:value={editing.action}
-				rows="4"
-				placeholder={t('script.actionPlaceholder')}
-			></textarea>
-		</label>
-		<label class="field">
-			<span class="field-label">{t('script.dialogField')}</span>
-			<textarea
-				class="field-textarea"
-				bind:value={editing.dialog}
-				rows="4"
-				placeholder={t('script.dialogPlaceholder')}
-			></textarea>
-		</label>
-		<label class="field">
-			<span class="field-label">{t('script.durationField')}</span>
-			<input class="field-input" type="number" bind:value={editing.duration_sec} min="1" />
-		</label>
-	{/if}
-	{#snippet footer()}
-		<Button variant="ghost" onclick={() => (editOpen = false)}>{t('common.cancel')}</Button>
-		<Button
-			variant="primary"
-			loading={$saveMutation.isPending}
-			onclick={() => $saveMutation.mutate()}
-		>
-			{t('script.save')}
-		</Button>
-	{/snippet}
-</Modal>
-
-<ConfirmDialog
-	bind:open={deleteOpen}
-	title={t('script.deleteSceneTitle')}
-	message={sceneToDelete
-		? t('script.deleteSceneMessage', {
-				heading: sceneToDelete.heading?.trim() || t('script.sceneNumber', { n: sceneToDelete.order_index }),
-			})
-		: ''}
-	confirmLabel={t('script.delete')}
-	danger
-	onconfirm={() => void confirmDeleteScene()}
-	oncancel={() => (sceneToDelete = null)}
-/>
-
-<style>
-	.stage-header {
-		/* Pins inside the stage scroll container so Add Scene / Regenerate
-		   stay reachable while scrolling long scripts. */
-		position: sticky;
-		top: 0;
-		z-index: 5;
-		display: flex;
-		justify-content: space-between;
-		align-items: flex-start;
-		margin-bottom: var(--space-lg);
-		gap: var(--space-md);
-		padding: 8px 0 12px;
-		background: var(--bg-primary);
-		border-bottom: 1px solid var(--border);
-	}
-	.stage-header h2 {
-		margin: 0 0 4px;
-		font-size: 22px;
-		font-weight: 700;
-	}
-	.stage-actions {
-		display: flex;
-		gap: 8px;
-	}
-	.muted {
-		color: var(--text-secondary);
-		margin: 0;
-	}
-	.script-panel {
-		position: relative;
-		min-height: 220px;
-	}
-	.card {
-		background: var(--bg-surface);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-md);
-		padding: var(--space-lg);
-		margin-bottom: var(--space-md);
-		scroll-margin-top: 84px;
-		scroll-margin-bottom: 24px;
-	}
-	.scene {
-		transition:
-			border-color 0.25s ease,
-			box-shadow 0.25s ease,
-			opacity 0.2s ease;
-	}
-	.scene.fresh {
-		border-color: var(--accent);
-		box-shadow:
-			0 0 0 1px var(--accent),
-			0 0 24px var(--accent-glow);
-		animation: scene-in 0.45s ease-out;
-	}
-	.scene.deleting {
-		opacity: 0.45;
-	}
-	@keyframes scene-in {
-		from {
-			opacity: 0.35;
-			transform: translateY(10px);
-		}
-		to {
-			opacity: 1;
-			transform: none;
-		}
-	}
-	@media (prefers-reduced-motion: reduce) {
-		.scene.fresh {
-			animation: none;
-		}
-	}
-	.scene-head {
-		display: flex;
-		justify-content: space-between;
-		align-items: flex-start;
-		gap: 12px;
-		margin-bottom: 8px;
-	}
-	.scene-title {
-		display: flex;
-		flex-wrap: wrap;
-		align-items: center;
-		gap: 8px;
-		min-width: 0;
-	}
-	.grip {
-		display: inline-flex;
-		color: var(--text-muted);
-		cursor: grab;
-		opacity: 0.6;
-	}
-	.num {
-		color: var(--accent);
-		font-weight: 700;
-	}
-	.fresh-tag {
-		font-size: 10px;
-		font-weight: 700;
-		letter-spacing: 0.06em;
-		text-transform: uppercase;
-		color: var(--accent);
-		background: var(--accent-glow);
-		border-radius: 999px;
-		padding: 2px 8px;
-	}
-	.actions {
-		display: flex;
-		flex-wrap: wrap;
-		align-items: center;
-		gap: 6px;
-		flex-shrink: 0;
-	}
-	.icon-btn {
-		display: inline-flex;
-		align-items: center;
-		justify-content: center;
-		width: 28px;
-		height: 28px;
-		border: 1px solid transparent;
-		border-radius: var(--radius-sm);
-		background: transparent;
-		color: var(--text-secondary);
-		cursor: pointer;
-	}
-	.icon-btn:hover:not(:disabled) {
-		background: rgba(255, 255, 255, 0.05);
-		color: var(--text-primary);
-		border-color: var(--border);
-	}
-	.icon-btn:disabled {
-		opacity: 0.35;
-		cursor: not-allowed;
-	}
-	.icon-btn:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
-	}
-	.empty-line {
-		font-style: italic;
-		color: var(--text-muted);
-	}
-	.dialog {
-		background: var(--bg-elevated);
-		padding: 12px;
-		border-radius: var(--radius-sm);
-		white-space: pre-wrap;
-		font-family: var(--font-mono);
-		font-size: 13px;
-	}
-	.chips {
-		display: flex;
-		flex-wrap: wrap;
-		gap: 6px;
-		margin-top: 10px;
-	}
-	.chip {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: 999px;
-		padding: 2px 10px;
-		font-size: 12px;
-		color: var(--text-secondary);
-	}
-	.chip-toggle {
-		cursor: pointer;
-		font-family: inherit;
-	}
-	.chip-toggle:hover {
-		color: var(--text-primary);
-		border-color: #52525b;
-	}
-	.chip-toggle:disabled {
-		opacity: 0.6;
-		cursor: wait;
-	}
-	.chip-on {
-		color: var(--accent);
-		border-color: var(--accent);
-		background: color-mix(in srgb, var(--accent) 12%, var(--bg-elevated));
-	}
-	.clip-block {
-		margin-top: 10px;
-		border-top: 1px dashed var(--border);
-		padding-top: 8px;
-	}
-	.clip-head {
-		display: flex;
-		justify-content: space-between;
-		align-items: center;
-		gap: 8px;
-	}
-	.clip-title {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		font-size: 12px;
-		font-weight: 600;
-		color: var(--text-secondary);
-	}
-	.clip-list {
-		list-style: none;
-		margin: 8px 0 0;
-		padding: 0;
-		display: flex;
-		flex-direction: column;
-		gap: 4px;
-	}
-	.clip-row {
-		display: flex;
-		align-items: center;
-		gap: 8px;
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-sm);
-		padding: 4px 8px;
-		font-size: 12px;
-	}
-	.clip-num {
-		font-family: var(--font-mono);
-		font-weight: 700;
-		color: var(--text-secondary);
-		flex-shrink: 0;
-	}
-	.clip-num.ready {
-		color: var(--accent);
-	}
-	.clip-desc {
-		flex: 1;
-		min-width: 0;
-		overflow: hidden;
-		text-overflow: ellipsis;
-		white-space: nowrap;
-		color: var(--text-primary);
-	}
-	.clip-dur {
-		color: var(--text-muted);
-		flex-shrink: 0;
-	}
-	.chip-ok {
-		color: var(--accent);
-		border-color: var(--accent);
-	}
-	.chip-render {
-		color: var(--warning, #eab308);
-		border-color: var(--warning, #eab308);
-	}
-	.avatar {
-		position: relative;
-		width: 20px;
-		height: 20px;
-		border-radius: 50%;
-		overflow: hidden;
-		background: var(--bg-surface);
-		border: 1px solid var(--border);
-		flex-shrink: 0;
-		display: inline-flex;
-		align-items: center;
-		justify-content: center;
-	}
-	.avatar img {
-		position: absolute;
-		inset: 0;
-		width: 100%;
-		height: 100%;
-		object-fit: cover;
-	}
-	.initials {
-		font-size: 9px;
-		font-weight: 700;
-		color: var(--accent);
-		letter-spacing: 0.02em;
-	}
-</style>

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

@@ -1,947 +0,0 @@
-<script lang="ts">
-	import { goto } from '$app/navigation';
-	import { createMutation, useQueryClient } from '@tanstack/svelte-query';
-	import {
-		projects,
-		type Beat,
-		type Character,
-		type Item,
-		type Location,
-		type StoryData,
-	} from '$lib/api';
-	import {
-		buildStoryDraftPromptPreview,
-		estimateTargetSeconds,
-		recommendBeatCount,
-		recommendSceneCount,
-	} from '$lib/durationBudget';
-	import { toast } from '$lib/toast';
-	import { t } from '$lib/i18n.svelte';
-	import { agentDeepLink } from '$lib/agentTasks';
-	import Button from '$lib/components/ui/Button.svelte';
-	import Card from '$lib/components/ui/Card.svelte';
-	import StatusChip from '$lib/components/ui/StatusChip.svelte';
-	import Modal from '$lib/components/ui/Modal.svelte';
-	import ConfirmDialog from '$lib/components/ui/ConfirmDialog.svelte';
-	import EmptyState from '$lib/components/ui/EmptyState.svelte';
-	import Spinner from '$lib/components/ui/Spinner.svelte';
-	import Icon from '$lib/components/ui/Icon.svelte';
-
-	interface Props {
-		projectId: number;
-		story: StoryData;
-		configured: boolean;
-		onGoAssets?: () => void;
-	}
-
-	let { projectId, story, configured, onGoAssets }: Props = $props();
-	const client = useQueryClient();
-
-	const GENRES = [
-		'Adventure / Mystery',
-		'Drama',
-		'Sci-Fi',
-		'Fantasy',
-		'Horror',
-		'Romance',
-		'Thriller',
-	];
-	const LENGTHS_HINT = $derived(t('story.lengthsHint'));
-	const TONES = [
-		'Cinematic, atmospheric',
-		'Dark, tense',
-		'Whimsical, warm',
-		'Gritty, realistic',
-		'Epic, sweeping',
-	];
-
-	const GENRE_KEYS: Record<string, string> = {
-		'Adventure / Mystery': 'genres.adventure',
-		Drama: 'genres.drama',
-		'Sci-Fi': 'genres.scifi',
-		Fantasy: 'genres.fantasy',
-		Horror: 'genres.horror',
-		Romance: 'genres.romance',
-		Thriller: 'genres.thriller',
-	};
-	const TONE_KEYS: Record<string, string> = {
-		'Cinematic, atmospheric': 'tones.cinematic',
-		'Dark, tense': 'tones.dark',
-		'Whimsical, warm': 'tones.whimsical',
-		'Gritty, realistic': 'tones.gritty',
-		'Epic, sweeping': 'tones.epic',
-	};
-	function genreLabel(v: string): string {
-		return t(GENRE_KEYS[v] ?? v);
-	}
-	function toneLabel(v: string): string {
-		return t(TONE_KEYS[v] ?? v);
-	}
-
-	const EXAMPLE = {
-		idea: 'A lone cartographer discovers a map that rewrites itself every midnight, leading her into a forgotten city beneath the desert.',
-		genre: 'Adventure / Mystery',
-		tone: 'Cinematic, atmospheric',
-		target_duration: '2 minutes',
-	};
-
-	let editingBeat = $state<Beat | null>(null);
-	let editingChar = $state<Character | null>(null);
-	let editingLoc = $state<Location | null>(null);
-	let editingItem = $state<Item | null>(null);
-	let beatModalOpen = $state(false);
-	let charModalOpen = $state(false);
-	let locModalOpen = $state(false);
-	let itemModalOpen = $state(false);
-	let confirmExampleOpen = $state(false);
-	let deletingBeat = $state<Beat | null>(null);
-	let beatDeleteOpen = $state(false);
-	let addingBeat = $state(false);
-	// Static defaults — the $effect below syncs all drafts from the story prop.
-	let ideaDraft = $state('');
-	let genreDraft = $state(GENRES[0]);
-	let toneDraft = $state(TONES[0]);
-	let lengthDraft = $state('2 minutes');
-	let showDraftPrompt = $state(false);
-
-	type SaveState = 'idle' | 'saving' | 'saved' | 'error';
-	let saveState = $state<SaveState>('idle');
-	let savedTimer: ReturnType<typeof setTimeout> | null = null;
-
-	const beatBudget = $derived(recommendBeatCount(lengthDraft));
-	const sceneBudget = $derived(recommendSceneCount(lengthDraft));
-	const secsBudget = $derived(estimateTargetSeconds(lengthDraft));
-	const draftPromptPreview = $derived(
-		buildStoryDraftPromptPreview({
-			title: story.project.title,
-			idea: ideaDraft,
-			genre: genreDraft,
-			tone: toneDraft,
-			targetDuration: lengthDraft,
-		}),
-	);
-
-	$effect(() => {
-		ideaDraft = story.project.idea ?? '';
-		genreDraft = story.project.genre || GENRES[0];
-		toneDraft = story.project.tone || TONES[0];
-		lengthDraft = story.project.target_duration || '2 minutes';
-	});
-
-	$effect(() => {
-		return () => {
-			if (savedTimer) clearTimeout(savedTimer);
-		};
-	});
-
-	function armSavedTimer() {
-		if (savedTimer) clearTimeout(savedTimer);
-		savedTimer = setTimeout(() => {
-			if (saveState === 'saved') saveState = 'idle';
-		}, 2000);
-	}
-
-	const saveProject = createMutation({
-		mutationFn: (payload: {
-			idea?: string;
-			genre?: string;
-			tone?: string;
-			target_duration?: string;
-		}) => projects.update(projectId, payload),
-		onMutate: () => {
-			saveState = 'saving';
-		},
-		onSuccess: () => {
-			client.invalidateQueries({ queryKey: ['story'] });
-			saveState = 'saved';
-			armSavedTimer();
-		},
-		onError: (err) => {
-			saveState = 'error';
-			toast.error(err instanceof Error ? err.message : t('story.saveSettingsFailed'));
-		},
-	});
-
-	/** Autosave path — returns false on failure (mutation onError already toasted). */
-	async function persistSettings(): Promise<boolean> {
-		try {
-			await $saveProject.mutateAsync({
-				idea: ideaDraft,
-				genre: genreDraft || undefined,
-				tone: toneDraft || undefined,
-				target_duration: lengthDraft || undefined,
-			});
-			return true;
-		} catch {
-			return false;
-		}
-	}
-
-	async function loadExample() {
-		ideaDraft = EXAMPLE.idea;
-		genreDraft = EXAMPLE.genre;
-		toneDraft = EXAMPLE.tone;
-		lengthDraft = EXAMPLE.target_duration;
-		const saved = await persistSettings();
-		if (saved) toast.success(t('story.exampleLoaded'));
-	}
-
-	function requestLoadExample() {
-		if (ideaDraft.trim()) confirmExampleOpen = true;
-		else void loadExample();
-	}
-
-	/** Hand off to a fresh, project-linked agent chat with the composer pre-filled. */
-	async function draftStoryline() {
-		if (!configured) return;
-		const saved = await persistSettings();
-		if (!saved) return; // persistSettings already toasted the failure
-		goto(agentDeepLink(projectId, 'story'));
-	}
-
-	function openBeat(beat: Beat) {
-		editingBeat = { ...beat };
-		beatModalOpen = true;
-	}
-
-	async function addBeat() {
-		if (addingBeat) return;
-		addingBeat = true;
-		try {
-			const nextIndex =
-				story.beats.reduce((max, b) => Math.max(max, b.order_index), 0) + 1;
-			// No api.ts binding exists yet for POST /beats — call the endpoint directly.
-			const res = await fetch(`/api/projects/${projectId}/beats`, {
-				method: 'POST',
-				headers: { 'Content-Type': 'application/json' },
-				body: JSON.stringify({
-					order_index: nextIndex,
-					title: t('story.newBeat', { n: nextIndex }),
-					description: '',
-				}),
-			});
-			if (!res.ok) {
-				const body = await res.text().catch(() => 'unknown error');
-				throw new Error(`${res.status}: ${body}`);
-			}
-			const created = (await res.json()) as Beat;
-			await client.invalidateQueries({ queryKey: ['story'] });
-			toast.success(t('story.beatAdded', { index: nextIndex }));
-			openBeat(created);
-		} catch (err) {
-			toast.error(err instanceof Error ? err.message : t('story.addBeatFailed'));
-		} finally {
-			addingBeat = false;
-		}
-	}
-
-	function requestDeleteBeat(beat: Beat) {
-		deletingBeat = beat;
-		beatDeleteOpen = true;
-	}
-
-	const deleteBeatMutation = createMutation({
-		mutationFn: (beatId: number) => projects.deleteBeat(projectId, beatId),
-		onSuccess: () => {
-			client.invalidateQueries({ queryKey: ['story'] });
-			toast.success(t('story.beatDeleted'));
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('story.deleteBeatFailed'));
-		},
-	});
-
-	const saveBeat = createMutation({
-		mutationFn: () =>
-			projects.updateBeat(projectId, editingBeat!.id, {
-				title: editingBeat!.title,
-				description: editingBeat!.description,
-				order_index: editingBeat!.order_index,
-			}),
-		onSuccess: () => {
-			editingBeat = null;
-			beatModalOpen = false;
-			client.invalidateQueries({ queryKey: ['story'] });
-			toast.success(t('story.beatSaved'));
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('story.saveBeatFailed'));
-		},
-	});
-
-	const saveChar = createMutation({
-		mutationFn: () =>
-			projects.updateCharacter(projectId, editingChar!.id, {
-				name: editingChar!.name,
-				role: editingChar!.role,
-				age: editingChar!.age,
-				appearance: editingChar!.appearance,
-				personality: editingChar!.personality,
-				consistency_prompt: editingChar!.consistency_prompt,
-			}),
-		onSuccess: () => {
-			editingChar = null;
-			charModalOpen = false;
-			client.invalidateQueries({ queryKey: ['story'] });
-			toast.success(t('story.characterSaved'));
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('story.saveCharacterFailed'));
-		},
-	});
-
-	const saveLoc = createMutation({
-		mutationFn: () =>
-			projects.updateLocation(projectId, editingLoc!.id, {
-				name: editingLoc!.name,
-				description: editingLoc!.description,
-				consistency_prompt: editingLoc!.consistency_prompt,
-			}),
-		onSuccess: () => {
-			editingLoc = null;
-			locModalOpen = false;
-			client.invalidateQueries({ queryKey: ['story'] });
-			toast.success(t('story.locationSaved'));
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('story.saveLocationFailed'));
-		},
-	});
-
-	const saveItem = createMutation({
-		mutationFn: () =>
-			projects.updateItem(projectId, editingItem!.id, {
-				name: editingItem!.name,
-				description: editingItem!.description,
-				consistency_prompt: editingItem!.consistency_prompt,
-			}),
-		onSuccess: () => {
-			editingItem = null;
-			itemModalOpen = false;
-			client.invalidateQueries({ queryKey: ['story'] });
-			toast.success(t('story.itemSaved'));
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('story.saveItemFailed'));
-		},
-	});
-
-	function goToAssets() {
-		goto('?stage=assets', { keepFocus: true, noScroll: true });
-	}
-
-	function beatCountLabel(n: number): string {
-		return t('story.beats', { n });
-	}
-</script>
-
-{#snippet saveIndicator()}
-	{#if saveState === 'saving'}
-		<span class="save-ind"><Spinner size="sm" /> {t('common.saving')}</span>
-	{:else if saveState === 'saved'}
-		<span class="save-ind saved"><Icon name="check" size={13} /> {t('common.saved')}</span>
-	{:else if saveState === 'error'}
-		<span class="save-ind err">
-			<Icon name="alert" size={13} /> {t('common.saveFailed')}
-			<Button variant="ghost" size="sm" onclick={() => void persistSettings()}>{t('common.retry')}</Button>
-		</span>
-	{/if}
-{/snippet}
-
-<header class="stage-header">
-	<h2>{t('story.stageTitle')}</h2>
-	<div class="stage-actions">
-		<Button
-			variant="secondary"
-			disabled={$saveProject.isPending}
-			onclick={requestLoadExample}
-		>
-			{t('story.loadExample')}
-		</Button>
-		<Button variant="primary" disabled={!configured} onclick={() => void draftStoryline()}>
-			<Icon name="sparkle" size={15} /> {t('story.draftStoryline')}
-		</Button>
-	</div>
-</header>
-
-{#if !configured}
-	<div class="banner">{t('story.llmBanner')}</div>
-{/if}
-
-<div class="stack-col">
-	<Card>
-	{#snippet header()}
-		<h3 class="card-h">{t('story.ideaTitle')}</h3>
-		{@render saveIndicator()}
-	{/snippet}
-	<textarea
-		class="field-textarea"
-		bind:value={ideaDraft}
-		rows="5"
-		placeholder={t('story.ideaPlaceholder')}
-		onblur={() => void persistSettings()}
-	></textarea>
-</Card>
-
-<Card>
-	{#snippet header()}
-		<h3 class="card-h">{t('story.settingsTitle')}</h3>
-		{@render saveIndicator()}
-	{/snippet}
-	<div class="grid-3">
-		<label class="field">
-			<span class="field-label">{t('projects.genre')}</span>
-			<select
-				class="field-select"
-				bind:value={genreDraft}
-				onchange={() => void persistSettings()}
-			>
-{#each GENRES as g}
-					<option value={g}>{genreLabel(g)}</option>
-				{/each}
-				{#if genreDraft && !GENRES.includes(genreDraft)}
-					<option value={genreDraft}>{genreLabel(genreDraft)}</option>
-				{/if}
-			</select>
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.targetLength')}</span>
-			<input
-				class="field-input"
-				type="text"
-				bind:value={lengthDraft}
-				placeholder={LENGTHS_HINT}
-				onblur={() => void persistSettings()}
-			/>
-			<span class="field-hint beat-hint">
-				{t('story.lengthHint', { secs: secsBudget, beats: beatBudget, scenes: sceneBudget })}
-			</span>
-		</label>
-		<label class="field">
-			<span class="field-label">{t('projects.tone')}</span>
-			<select
-				class="field-select"
-				bind:value={toneDraft}
-				onchange={() => void persistSettings()}
-			>
-				{#each TONES as tone}
-					<option value={tone}>{toneLabel(tone)}</option>
-				{/each}
-				{#if toneDraft && !TONES.includes(toneDraft)}
-					<option value={toneDraft}>{toneLabel(toneDraft)}</option>
-				{/if}
-			</select>
-		</label>
-	</div>
-</Card>
-
-<Card>
-	{#snippet header()}
-		<h3 class="card-h">{t('story.draftPromptTitle')}</h3>
-		<Button variant="ghost" size="sm" onclick={() => (showDraftPrompt = !showDraftPrompt)}>
-			{showDraftPrompt ? t('story.hidePrompt') : t('story.showPrompt')}
-		</Button>
-	{/snippet}
-	{#if showDraftPrompt}
-		<pre class="prompt-preview">{draftPromptPreview}</pre>
-		<p class="field-hint">
-			{t('story.promptExplain')}
-		</p>
-	{:else}
-		<p class="field-hint prompt-collapsed">
-			{t('story.promptCollapsedHint')}
-		</p>
-	{/if}
-</Card>
-
-<Card>
-	{#snippet header()}
-		<h3 class="card-h">{t('story.beatsTitle')}</h3>
-		<div class="head-actions">
-			{#if story.beats.length}
-				<StatusChip status="ready" label={beatCountLabel(story.beats.length)} />
-			{/if}
-			<Button variant="secondary" size="sm" loading={addingBeat} onclick={addBeat}>
-				<Icon name="plus" size={14} /> {t('story.addBeat')}
-			</Button>
-		</div>
-	{/snippet}
-	{#if story.beats.length === 0}
-		<EmptyState
-			title={t('story.noBeats')}
-			body={t('story.noBeatsBody')}
-		>
-			{#snippet icon()}
-				<Icon name="story" size={28} />
-			{/snippet}
-			{#snippet action()}
-				<Button variant="secondary" size="sm" loading={addingBeat} onclick={addBeat}>
-					<Icon name="plus" size={14} /> {t('story.addBeatManual')}
-				</Button>
-			{/snippet}
-		</EmptyState>
-	{:else}
-		<div class="beat-list">
-			{#each story.beats as beat (beat.id)}
-				<div class="beat-row">
-					<button type="button" class="beat" onclick={() => openBeat(beat)}>
-						<div class="beat-number">{beat.order_index}</div>
-						<div class="beat-body">
-							<h4>{beat.title}</h4>
-							<p>{beat.description}</p>
-						</div>
-					</button>
-					<div class="beat-actions">
-						<Button
-							variant="ghost"
-							size="sm"
-							title={t('story.deleteBeat', { index: beat.order_index })}
-							onclick={() => requestDeleteBeat(beat)}
-						>
-							<Icon name="trash" size={14} /><span class="sr-only">{t('story.deleteBeat', { index: beat.order_index })}</span>
-						</Button>
-					</div>
-				</div>
-			{/each}
-		</div>
-		<div class="beats-footer">
-			<Button variant="primary" onclick={goToAssets}>
-				{t('story.continueAssets')} <Icon name="chevron-right" size={15} />
-			</Button>
-		</div>
-	{/if}
-</Card>
-
-{#if story.characters.length || story.locations.length || story.items.length}
-	<Card>
-		{#snippet header()}
-			<h3 class="card-h">{t('story.extracted')}</h3>
-			<Button variant="ghost" size="sm" onclick={goToAssets}>
-				{t('story.openAssets')} <Icon name="chevron-right" size={14} />
-			</Button>
-		{/snippet}
-		<div class="chips">
-			{#each story.characters as char (char.id)}
-				<button
-					type="button"
-					class="chip"
-					onclick={() => {
-						editingChar = { ...char };
-						charModalOpen = true;
-					}}
-					title={char.appearance ?? ''}
-				>
-					<span class="chip-tag">{t('story.charTag')}</span>
-					{char.name}
-				</button>
-			{/each}
-			{#each story.locations as loc (loc.id)}
-				<button
-					type="button"
-					class="chip"
-					onclick={() => {
-						editingLoc = { ...loc };
-						locModalOpen = true;
-					}}
-					title={loc.description ?? ''}
-				>
-					<span class="chip-tag">{t('story.envTag')}</span>
-					{loc.name}
-				</button>
-			{/each}
-			{#each story.items as item (item.id)}
-				<button
-					type="button"
-					class="chip"
-					onclick={() => {
-						editingItem = { ...item };
-						itemModalOpen = true;
-					}}
-					title={item.description ?? ''}
-				>
-					<span class="chip-tag">{t('story.itemTag')}</span>
-					{item.name}
-				</button>
-			{/each}
-		</div>
-	</Card>
-{/if}
-</div>
-
-<Modal bind:open={beatModalOpen} title={t('story.editBeatTitle')} onclose={() => (editingBeat = null)}>
-	{#if editingBeat}
-		<label class="field">
-			<span class="field-label">{t('story.fieldTitle')}</span>
-			<input class="field-input" bind:value={editingBeat.title} />
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldDescription')}</span>
-			<textarea class="field-textarea" rows="4" bind:value={editingBeat.description}></textarea>
-		</label>
-	{/if}
-	{#snippet footer()}
-		<Button variant="ghost" onclick={() => (beatModalOpen = false)}>{t('common.cancel')}</Button>
-		<Button variant="primary" loading={$saveBeat.isPending} onclick={() => $saveBeat.mutate()}>
-			{t('common.save')}
-		</Button>
-	{/snippet}
-</Modal>
-
-<Modal bind:open={charModalOpen} title={t('story.editCharTitle')} onclose={() => (editingChar = null)}>
-	{#if editingChar}
-		<label class="field">
-			<span class="field-label">{t('story.fieldName')}</span>
-			<input class="field-input" bind:value={editingChar.name} placeholder={t('story.fieldName')} />
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldRole')}</span>
-			<input class="field-input" bind:value={editingChar.role} placeholder={t('story.fieldRole')} />
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldAge')}</span>
-			<input class="field-input" bind:value={editingChar.age} placeholder={t('story.fieldAge')} />
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldAppearance')}</span>
-			<textarea
-				class="field-textarea"
-				rows="3"
-				bind:value={editingChar.appearance}
-				placeholder={t('story.fieldAppearance')}
-			></textarea>
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldPersonality')}</span>
-			<textarea
-				class="field-textarea"
-				rows="2"
-				bind:value={editingChar.personality}
-				placeholder={t('story.fieldPersonality')}
-			></textarea>
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldConsistency')}</span>
-			<textarea
-				class="field-textarea"
-				rows="2"
-				bind:value={editingChar.consistency_prompt}
-				placeholder={t('story.fieldConsistency')}
-			></textarea>
-		</label>
-	{/if}
-	{#snippet footer()}
-		<Button variant="ghost" onclick={() => (charModalOpen = false)}>{t('common.cancel')}</Button>
-		<Button variant="primary" loading={$saveChar.isPending} onclick={() => $saveChar.mutate()}>
-			{t('common.save')}
-		</Button>
-	{/snippet}
-</Modal>
-
-<Modal bind:open={locModalOpen} title={t('story.editLocTitle')} onclose={() => (editingLoc = null)}>
-	{#if editingLoc}
-		<label class="field">
-			<span class="field-label">{t('story.fieldName')}</span>
-			<input class="field-input" bind:value={editingLoc.name} placeholder={t('story.fieldName')} />
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldDescription')}</span>
-			<textarea
-				class="field-textarea"
-				rows="3"
-				bind:value={editingLoc.description}
-				placeholder={t('story.fieldDescription')}
-			></textarea>
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldConsistency')}</span>
-			<textarea
-				class="field-textarea"
-				rows="2"
-				bind:value={editingLoc.consistency_prompt}
-				placeholder={t('story.fieldConsistency')}
-			></textarea>
-		</label>
-	{/if}
-	{#snippet footer()}
-		<Button variant="ghost" onclick={() => (locModalOpen = false)}>{t('common.cancel')}</Button>
-		<Button variant="primary" loading={$saveLoc.isPending} onclick={() => $saveLoc.mutate()}>
-			{t('common.save')}
-		</Button>
-	{/snippet}
-</Modal>
-
-<Modal bind:open={itemModalOpen} title={t('story.editItemTitle')} onclose={() => (editingItem = null)}>
-	{#if editingItem}
-		<label class="field">
-			<span class="field-label">{t('story.fieldName')}</span>
-			<input class="field-input" bind:value={editingItem.name} placeholder={t('story.fieldName')} />
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldDescription')}</span>
-			<textarea
-				class="field-textarea"
-				rows="3"
-				bind:value={editingItem.description}
-				placeholder={t('story.fieldDescription')}
-			></textarea>
-		</label>
-		<label class="field">
-			<span class="field-label">{t('story.fieldConsistency')}</span>
-			<textarea
-				class="field-textarea"
-				rows="2"
-				bind:value={editingItem.consistency_prompt}
-				placeholder={t('story.fieldConsistency')}
-			></textarea>
-		</label>
-	{/if}
-	{#snippet footer()}
-		<Button variant="ghost" onclick={() => (itemModalOpen = false)}>{t('common.cancel')}</Button>
-		<Button variant="primary" loading={$saveItem.isPending} onclick={() => $saveItem.mutate()}>
-			{t('common.save')}
-		</Button>
-	{/snippet}
-</Modal>
-
-<ConfirmDialog
-	bind:open={confirmExampleOpen}
-	title={t('story.confirmExampleTitle')}
-	message={t('story.confirmExampleMsg')}
-	confirmLabel={t('story.loadExample')}
-	onconfirm={() => void loadExample()}
-/>
-
-<ConfirmDialog
-	bind:open={beatDeleteOpen}
-	title={t('story.confirmDeleteBeatTitle')}
-	message={deletingBeat
-		? t('story.confirmDeleteBeatMsg', { index: deletingBeat.order_index, title: deletingBeat.title })
-		: ''}
-	confirmLabel={t('common.delete')}
-	danger
-	onconfirm={() => {
-		const id = deletingBeat?.id;
-		deletingBeat = null;
-		if (id != null) $deleteBeatMutation.mutate(id);
-	}}
-	oncancel={() => (deletingBeat = null)}
-/>
-
-<style>
-	.stage-header {
-		display: flex;
-		justify-content: space-between;
-		align-items: center;
-		margin-bottom: var(--space-lg);
-		gap: var(--space-md);
-	}
-	.stage-header h2 {
-		margin: 0;
-		font-size: 22px;
-		font-weight: 700;
-	}
-	.stage-actions {
-		display: flex;
-		gap: var(--space-sm);
-	}
-	.banner {
-		background: rgba(245, 158, 11, 0.1);
-		border: 1px solid rgba(245, 158, 11, 0.3);
-		color: var(--warning);
-		padding: var(--space-md);
-		border-radius: var(--radius-md);
-		margin-bottom: var(--space-lg);
-		font-size: 13px;
-	}
-	.stack-col {
-		position: relative;
-		display: flex;
-		flex-direction: column;
-		gap: var(--space-md);
-	}
-	.card-h {
-		margin: 0;
-		font-size: 16px;
-		color: var(--text-secondary);
-		font-weight: 600;
-	}
-	.head-actions {
-		display: flex;
-		align-items: center;
-		gap: var(--space-sm);
-	}
-	.save-ind {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		font-size: 12px;
-		color: var(--text-muted);
-	}
-	.save-ind.saved {
-		color: var(--success);
-		animation: saved-fade 2s ease forwards;
-	}
-	.save-ind.err {
-		color: var(--error);
-	}
-	@keyframes saved-fade {
-		0% {
-			opacity: 0;
-		}
-		12% {
-			opacity: 1;
-		}
-		78% {
-			opacity: 1;
-		}
-		100% {
-			opacity: 0;
-		}
-	}
-	.grid-3 {
-		display: grid;
-		grid-template-columns: repeat(3, 1fr);
-		gap: var(--space-md);
-	}
-	@media (max-width: 900px) {
-		.grid-3 {
-			grid-template-columns: 1fr;
-		}
-	}
-	.grid-3 .field {
-		margin-bottom: 0;
-	}
-	.beat-hint {
-		display: block;
-	}
-	.beat-hint strong {
-		color: var(--accent);
-		font-weight: 600;
-	}
-	.prompt-preview {
-		margin: 0 0 var(--space-sm);
-		padding: 12px;
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-sm);
-		font-family: var(--font-mono);
-		font-size: 11px;
-		line-height: 1.45;
-		white-space: pre-wrap;
-		color: var(--text-secondary);
-		max-height: 280px;
-		overflow: auto;
-	}
-	.prompt-collapsed {
-		margin: 0;
-	}
-	.beat-list {
-		display: flex;
-		flex-direction: column;
-		gap: 10px;
-	}
-	.beat-row {
-		display: flex;
-		align-items: flex-start;
-		gap: var(--space-xs);
-	}
-	.beat {
-		display: flex;
-		flex: 1;
-		min-width: 0;
-		gap: var(--space-md);
-		align-items: flex-start;
-		background: transparent;
-		border: 1px solid transparent;
-		border-radius: var(--radius-md);
-		padding: 8px;
-		cursor: pointer;
-		text-align: left;
-		color: inherit;
-		font: inherit;
-	}
-	.beat:hover {
-		border-color: var(--border);
-		background: var(--bg-elevated);
-	}
-	.beat:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
-	}
-	.beat-actions {
-		flex-shrink: 0;
-		padding-top: 8px;
-	}
-	.beat-number {
-		width: 36px;
-		height: 36px;
-		border-radius: var(--radius-md);
-		background: var(--bg-elevated);
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		font-weight: 700;
-		color: var(--text-secondary);
-		flex-shrink: 0;
-	}
-	.beat-body h4 {
-		margin: 0 0 4px;
-		font-size: 15px;
-		font-weight: 600;
-	}
-	.beat-body p {
-		margin: 0;
-		color: var(--text-secondary);
-		font-size: 14px;
-		line-height: 1.45;
-	}
-	.beats-footer {
-		display: flex;
-		justify-content: flex-end;
-		margin-top: var(--space-md);
-		padding-top: var(--space-md);
-		border-top: 1px solid var(--border);
-	}
-	.chips {
-		display: flex;
-		flex-wrap: wrap;
-		gap: 8px;
-	}
-	.chip {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-sm);
-		padding: 6px 10px;
-		color: var(--text-primary);
-		font-size: 13px;
-		cursor: pointer;
-	}
-	.chip:hover {
-		border-color: var(--accent);
-	}
-	.chip:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
-	}
-	.chip-tag {
-		font-size: 10px;
-		text-transform: uppercase;
-		letter-spacing: 0.04em;
-		color: var(--accent);
-		font-weight: 700;
-	}
-	.sr-only {
-		position: absolute;
-		width: 1px;
-		height: 1px;
-		padding: 0;
-		margin: -1px;
-		overflow: hidden;
-		clip: rect(0, 0, 0, 0);
-		white-space: nowrap;
-		border: 0;
-	}
-</style>

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

@@ -62,7 +62,8 @@
 		position: fixed;
 		right: 24px;
 		bottom: 24px;
-		z-index: 1000;
+		/* Above every overlay, incl. the 10000 lightbox, so feedback stays visible. */
+		z-index: 10001;
 		display: flex;
 		flex-direction: column;
 		gap: 8px;

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

@@ -357,16 +357,13 @@
 	.empty-mark {
 		width: 48px;
 		height: 48px;
-		border-radius: var(--radius-md);
+		border-radius: var(--r-md);
 		display: flex;
 		align-items: center;
 		justify-content: center;
-		color: var(--accent);
-		background:
-			radial-gradient(circle at 30% 25%, rgba(139, 92, 246, 0.35) 0%, transparent 60%),
-			var(--bg-elevated);
-		border: 1px solid color-mix(in srgb, var(--accent) 30%, transparent);
-		box-shadow: 0 0 32px var(--accent-glow);
+		color: var(--text-2);
+		background: var(--bg-3);
+		border: 1px solid var(--line-2);
 		margin-bottom: 6px;
 	}
 	.empty-title {
@@ -391,21 +388,24 @@
 		margin-top: 16px;
 	}
 	.suggestion {
-		border: 1px solid var(--border);
-		background: var(--bg-surface);
-		color: var(--text-secondary);
-		border-radius: 999px;
-		padding: 8px 16px;
-		font-size: 13px;
+		border: 1px solid var(--line);
+		background: var(--bg-2);
+		color: var(--text-2);
+		border-radius: var(--r-pill);
+		padding: var(--sp-3) var(--sp-6);
+		font-size: var(--fs-body);
 		font-weight: 500;
 		font-family: inherit;
 		cursor: pointer;
-		transition: all 0.15s;
+		transition:
+			color var(--d-state) ease,
+			border-color var(--d-state) ease,
+			background-color var(--d-state) ease;
 	}
 	.suggestion:hover {
-		color: var(--text-primary);
-		border-color: var(--accent);
-		background: color-mix(in srgb, var(--accent) 12%, var(--bg-surface));
+		color: var(--text);
+		border-color: var(--line-2);
+		background: var(--bg-4);
 	}
 	.suggestion:focus-visible {
 		outline: 2px solid var(--accent);
@@ -430,11 +430,11 @@
 		display: inline-flex;
 		align-items: center;
 		gap: 6px;
-		font-size: 11px;
+		font-size: var(--fs-mini);
 		font-weight: 700;
 		letter-spacing: 0.06em;
 		text-transform: uppercase;
-		color: var(--agent, var(--accent));
+		color: var(--agent, var(--text-2));
 		margin-bottom: 4px;
 		padding-left: 2px;
 	}
@@ -443,7 +443,7 @@
 		height: 8px;
 		border-radius: 999px;
 		flex-shrink: 0;
-		box-shadow: 0 0 0 2px color-mix(in srgb, var(--agent, var(--accent)) 25%, transparent);
+		box-shadow: 0 0 0 2px color-mix(in srgb, var(--agent, var(--text-2)) 25%, transparent);
 	}
 	.reasoning-wrap {
 		margin-bottom: 4px;
@@ -451,28 +451,29 @@
 	}
 	.bubble {
 		max-width: 86%;
-		border-radius: var(--radius-md);
+		border-radius: var(--r-lg);
 		padding: 10px 14px;
 		font-size: 13.5px;
 		line-height: 1.6;
 		white-space: pre-wrap;
 		word-break: break-word;
 	}
+	/* 对话气泡按规范 §3.2/§3.6：用户 --bg-3，Agent --bg-2 + --line 描边。 */
 	.user-bubble {
-		background: color-mix(in srgb, var(--accent) 16%, var(--bg-surface));
-		border: 1px solid color-mix(in srgb, var(--accent) 35%, transparent);
-		color: var(--text-primary);
+		background: var(--bg-3);
+		border: 1px solid var(--line);
+		color: var(--text);
 	}
 	.user-bubble.steering {
 		border-style: dashed;
 	}
 	.steer-tag {
 		display: inline-block;
-		font-size: 10px;
+		font-size: var(--fs-mini);
 		font-weight: 600;
 		letter-spacing: 0.06em;
 		text-transform: uppercase;
-		color: var(--accent);
+		color: var(--text-3);
 		margin-bottom: 4px;
 	}
 	.user-thumbs {
@@ -486,36 +487,37 @@
 		width: 48px;
 		height: 48px;
 		object-fit: cover;
-		border-radius: var(--radius-sm);
-		border: 1px solid color-mix(in srgb, var(--accent) 30%, transparent);
-		background: var(--bg-elevated);
+		border-radius: var(--r-sm);
+		border: 1px solid var(--line-2);
+		background: var(--bg-3);
 	}
 	.user-thumb.file {
 		display: inline-flex;
 		align-items: center;
 		justify-content: center;
-		color: var(--text-muted);
+		color: var(--text-3);
 	}
 	.user-text {
 		white-space: pre-wrap;
 	}
+	/* 工作流提及为次级内容：中性底 + --text，不占金色。 */
 	.wf-chip {
 		display: inline;
 		padding: 1px 7px;
 		margin: 0 1px;
-		border-radius: 999px;
-		background: color-mix(in srgb, var(--accent) 22%, var(--bg-elevated));
-		border: 1px solid color-mix(in srgb, var(--accent) 45%, transparent);
-		color: var(--accent);
+		border-radius: var(--r-pill);
+		background: var(--bg-4);
+		border: 1px solid var(--line-2);
+		color: var(--text);
 		font-weight: 600;
-		font-size: 13px;
+		font-size: var(--fs-body);
 		white-space: nowrap;
 	}
 	.assistant-bubble {
-		background: var(--bg-surface);
-		border: 1px solid var(--border);
-		border-left: 3px solid var(--agent, var(--accent));
-		color: var(--text-primary);
+		background: var(--bg-2);
+		border: 1px solid var(--line);
+		border-left: 3px solid var(--agent, var(--text-2));
+		color: var(--text);
 	}
 	.question-card {
 		display: flex;
@@ -525,15 +527,15 @@
 		max-width: 420px;
 		margin: 2px 0 6px;
 		padding: 12px 14px;
-		border: 1px solid color-mix(in srgb, var(--accent) 35%, transparent);
-		border-radius: var(--radius-md);
-		background: color-mix(in srgb, var(--accent) 7%, var(--bg-surface));
+		border: 1px solid var(--line);
+		border-radius: var(--r-md);
+		background: var(--bg-2);
 	}
 	.question-text {
 		margin: 0;
-		font-size: 13px;
+		font-size: var(--fs-body);
 		line-height: 1.5;
-		color: var(--text-primary);
+		color: var(--text);
 		white-space: pre-wrap;
 	}
 	.question-options {
@@ -542,40 +544,39 @@
 		gap: 6px;
 	}
 	.question-option {
-		border: 1px solid color-mix(in srgb, var(--agent, var(--accent)) 45%, transparent);
-		background: var(--bg-elevated);
-		color: var(--text-primary);
-		border-radius: var(--radius-sm);
+		border: 1px solid var(--line-2);
+		background: var(--bg-3);
+		color: var(--text);
+		border-radius: var(--r-sm);
 		padding: 8px 12px;
-		font-size: 13px;
+		font-size: var(--fs-body);
 		font-weight: 600;
 		cursor: pointer;
 		text-align: left;
 		transition:
-			background 120ms ease,
-			border-color 120ms ease;
+			background-color var(--d-press) ease,
+			border-color var(--d-press) ease;
 	}
 	.question-option:hover:enabled {
-		background: color-mix(in srgb, var(--agent, var(--accent)) 18%, var(--bg-elevated));
-		border-color: var(--agent, var(--accent));
+		background: var(--bg-4);
+		border-color: var(--agent, var(--text-2));
 	}
 	.question-option:disabled {
 		opacity: 0.5;
 		cursor: default;
 	}
 	.question-option.affirmative {
-		border-color: var(--accent);
-		color: var(--accent);
+		border-color: var(--line-2);
 	}
 	.question-hint {
 		margin: 0;
-		font-size: 11px;
-		color: var(--text-muted);
+		font-size: var(--fs-mini);
+		color: var(--text-3);
 	}
 	.assistant-bubble.err {
-		border-color: rgba(239, 68, 68, 0.4);
-		border-left-color: rgba(239, 68, 68, 0.6);
-		color: var(--error);
+		border-color: var(--err-line);
+		border-left-color: var(--err);
+		color: var(--err);
 	}
 	.bubble.live {
 		display: flex;
@@ -604,7 +605,7 @@
 		width: 7px;
 		height: 14px;
 		margin-left: 2px;
-		background: var(--accent);
+		background: var(--run);
 		animation: blink 1s step-end infinite;
 		vertical-align: text-bottom;
 	}
@@ -617,14 +618,15 @@
 		display: flex;
 		align-items: center;
 		gap: 8px;
-		color: var(--text-secondary);
-		font-size: 13px;
+		color: var(--text-2);
+		font-size: var(--fs-body);
 	}
+	/* 进行中指示 = 信号青（§1.3），不占金色。 */
 	.pulse {
 		width: 8px;
 		height: 8px;
 		border-radius: 999px;
-		background: var(--accent);
+		background: var(--run);
 		animation: pulse 1.1s ease-in-out infinite;
 	}
 	@keyframes pulse {

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

@@ -711,12 +711,12 @@ let {
 		display: inline;
 		padding: 1px 7px;
 		margin: 0 1px;
-		border-radius: 999px;
-		background: color-mix(in srgb, var(--accent) 22%, var(--bg-elevated));
-		border: 1px solid color-mix(in srgb, var(--accent) 45%, transparent);
-		color: var(--accent);
+		border-radius: var(--r-pill);
+		background: var(--bg-4);
+		border: 1px solid var(--line-2);
+		color: var(--text);
 		font-weight: 600;
-		font-size: 13px;
+		font-size: var(--fs-body);
 		white-space: nowrap;
 		user-select: none;
 	}
@@ -724,12 +724,12 @@ let {
 		display: inline;
 		padding: 1px 7px;
 		margin: 0 1px;
-		border-radius: 999px;
-		background: color-mix(in srgb, #38bdf8 20%, var(--bg-elevated));
-		border: 1px solid color-mix(in srgb, #38bdf8 45%, transparent);
-		color: #7dd3fc;
+		border-radius: var(--r-pill);
+		background: var(--bg-4);
+		border: 1px dashed var(--line-2);
+		color: var(--text-2);
 		font-weight: 600;
-		font-size: 13px;
+		font-size: var(--fs-body);
 		white-space: nowrap;
 		user-select: none;
 	}

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

@@ -77,7 +77,7 @@
 	}
 	.head:hover {
 		color: var(--text-primary);
-		background: rgba(255, 255, 255, 0.03);
+		background: var(--bg-3);
 	}
 	.name {
 		flex: 1;

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

@@ -68,7 +68,7 @@
 	}
 	.head:hover {
 		color: var(--text-secondary);
-		background: rgba(255, 255, 255, 0.02);
+		background: var(--bg-3);
 	}
 	.icon-wrap {
 		display: inline-flex;

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

@@ -135,9 +135,7 @@
 		background: var(--bg-surface);
 		border: 1px solid var(--border);
 		border-radius: var(--radius-md);
-		box-shadow:
-			0 8px 24px rgba(0, 0, 0, 0.5),
-			0 0 0 1px rgba(0, 0, 0, 0.3);
+		box-shadow: var(--shadow-float);
 		padding: 4px;
 	}
 	.empty {

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

@@ -1,22 +1,23 @@
 /**
  * Agent identity palette: a stable display name + accent color per agent.
  *
- * The main loop runs with `agent_name = null`; we label it "Calliope". Each
- * swarm sub-agent ("planner", "story-agent", …) gets its own fixed color so
- * differently-authored bubbles are visually distinct, plus a deterministic
- * fallback for any future agent name.
+ * Identity colors answer "who is speaking" only (avatar / name / bubble
+ * tint) — they never express task status (spec v2 §3.6). The curated set
+ * reuses the spec §3.6 avatar five-color family plus one neutral slate, so
+ * no tailwind rainbow hues leak into the fusion palette; the default
+ * main-loop agent is neutral `--text-2` slate.
  */
 
 export const DEFAULT_AGENT_NAME = 'Calliope';
 
 // Fixed identity map (keyed by the raw agent_name the backend emits).
 const IDENTITIES: Record<string, { label: string; color: string }> = {
-	planner: { label: 'Planner', color: '#22d3ee' }, // cyan
-	'story-agent': { label: 'Story Agent', color: '#22c55e' }, // green
-	'script-agent': { label: 'Script Agent', color: '#f59e0b' }, // amber
-	'assets-agent': { label: 'Assets Agent', color: '#ec4899' }, // pink
-	'video-agent': { label: 'Video Agent', color: '#fb923c' }, // orange
-	'research-agent': { label: 'Research Agent', color: '#a78bfa' }, // violet
+	planner: { label: 'Planner', color: '#5b8def' }, // avatar-2 blue
+	'story-agent': { label: 'Story Agent', color: '#3fb97f' }, // avatar-3 green
+	'script-agent': { label: 'Script Agent', color: '#e8a33d' }, // avatar-1 amber
+	'assets-agent': { label: 'Assets Agent', color: '#b98be0' }, // avatar-4 violet
+	'video-agent': { label: 'Video Agent', color: '#d98e6a' }, // avatar-5 clay
+	'research-agent': { label: 'Research Agent', color: '#8fa3c8' }, // neutral slate
 	// The five named agents (HEL-613) — the runner stamps their zh names on
 	// named-session replies; colors mirror the spec §2.1 avatar five-set.
 	剧本创作: { label: '剧本创作', color: '#e8a33d' },
@@ -26,19 +27,9 @@ const IDENTITIES: Record<string, { label: string; color: string }> = {
 	镜头脚本: { label: '镜头脚本', color: '#d98e6a' },
 };
 
-// Fallback palette for unknown names (stable hash → deterministic color).
-const FALLBACK_COLORS = [
-	'#22d3ee',
-	'#22c55e',
-	'#f59e0b',
-	'#ec4899',
-	'#fb923c',
-	'#a78bfa',
-	'#38bdf8',
-	'#4ade80',
-	'#f472b6',
-	'#facc15',
-];
+// Fallback palette for unknown names (stable hash → deterministic color),
+// narrowed to the avatar identity family + neutral slate (spec v2 §十.4).
+const FALLBACK_COLORS = ['#5b8def', '#3fb97f', '#e8a33d', '#b98be0', '#d98e6a', '#8fa3c8'];
 
 function hashString(s: string): number {
 	let h = 0;
@@ -48,8 +39,8 @@ function hashString(s: string): number {
 	return h;
 }
 
-/** The default "Calliope" accent (matches --accent). */
-export const DEFAULT_AGENT_COLOR = '#8b5cf6';
+/** Neutral slate (--text-2) — the default agent borrows no signal color. */
+export const DEFAULT_AGENT_COLOR = '#aab2c5';
 
 export function agentDisplayName(name: string | null | undefined): string {
 	const key = (name || '').trim().toLowerCase();

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

@@ -8,6 +8,7 @@
 	import { parseDbTs } from '$lib/dbtime';
 	import { clearOutputMissing, markOutputMissing, missingOutputsOf } from '$lib/missingOutputs.svelte';
 	import { t } from '$lib/i18n.svelte';
+	import { exportLastFrame } from '$lib/media/lastFrame';
 	import { usageLabel } from './schema';
 	import { elapsedSec, fmtClock, fmtDur, inputsOf, isVideoOutput, promptOf, specOf } from './takes';
 
@@ -129,6 +130,18 @@
 	}
 
 	const mediaKey = $derived(`${job?.id ?? 'none'}:${output ?? st?.tone ?? ''}`);
+
+	let frameBusy = $state(false);
+	async function exportTail() {
+		const src = assetUrl(output);
+		if (!src || frameBusy) return;
+		frameBusy = true;
+		try {
+			await exportLastFrame(src);
+		} finally {
+			frameBusy = false;
+		}
+	}
 </script>
 
 <aside class="inspector" class:open inert={inactive} aria-label={t('desk.inspector')}>
@@ -154,28 +167,34 @@
 					<div class="stage-media" in:xfade out:xfade>
 						{#if output && video}
 							<!-- svelte-ignore a11y_media_has_caption -->
-							<video
-								bind:this={videoEl}
-								src={assetUrl(output)}
-								controls
-								playsinline
-								preload="metadata"
-								onloadedmetadata={(e) => {
-									clearOutputMissing(output);
-									noteVideo(e);
-								}}
-								onerror={() => output && markOutputMissing(output)}
-							></video>
+							<div class="print a-photo">
+								{#if st.tone === 'ok' && !fileGone}<span class="a-fix">{t('jobst.done')}</span>{/if}
+								<video
+									bind:this={videoEl}
+									src={assetUrl(output)}
+									controls
+									playsinline
+									preload="metadata"
+									onloadedmetadata={(e) => {
+										clearOutputMissing(output);
+										noteVideo(e);
+									}}
+									onerror={() => output && markOutputMissing(output)}
+								></video>
+							</div>
 						{:else if output}
-							<img
-								src={assetUrl(output)}
-								alt={prompt || t('desk.tabResult')}
-								onload={(e) => {
-									clearOutputMissing(output);
-									noteImg(e);
-								}}
-								onerror={() => output && markOutputMissing(output)}
-							/>
+							<div class="print a-photo">
+								{#if st.tone === 'ok' && !fileGone}<span class="a-fix">{t('jobst.done')}</span>{/if}
+								<img
+									src={assetUrl(output)}
+									alt={prompt || t('desk.tabResult')}
+									onload={(e) => {
+										clearOutputMissing(output);
+										noteImg(e);
+									}}
+									onerror={() => output && markOutputMissing(output)}
+								/>
+							</div>
 						{:else if fileGone}
 							<div class="stage-empty gone">
 								<span>{t('desk.missingTitle')}</span>
@@ -240,6 +259,18 @@
 					{#if output}
 						<a class="a-btn secondary sm" href={assetUrl(output)} download>{t('desk.download')}</a>
 					{/if}
+					{#if output && video}
+						<button
+							type="button"
+							class="a-btn secondary sm"
+							title={t('lastFrame.hint')}
+							disabled={frameBusy}
+							aria-busy={frameBusy}
+							onclick={exportTail}
+						>
+							{frameBusy ? t('lastFrame.exporting') : t('lastFrame.export')}
+						</button>
+					{/if}
 					{#if st.tone === 'fail'}
 						<button type="button" class="a-btn secondary sm" onclick={() => onRetry(job)}>{t('common.retry')}</button>
 					{/if}
@@ -337,14 +368,24 @@
 		inset: 0;
 		display: grid;
 		place-items: center;
+		padding: var(--sp-5);
+		box-sizing: border-box;
 	}
-	.stage-media > img,
-	.stage-media > video {
-		position: absolute;
-		inset: 0;
-		width: 100%;
-		height: 100%;
-		object-fit: contain;
+	/* 相纸白边 (HEL-680)：检视舞台上的结果按相纸呈现，媒体自适应内含 */
+	.print {
+		position: relative;
+		display: grid;
+		max-width: 100%;
+		max-height: 100%;
+		--paper-w: 5px;
+	}
+	.print > img,
+	.print > video {
+		display: block;
+		max-width: 100%;
+		max-height: 100%;
+		width: auto;
+		height: auto;
 	}
 	.stage-empty {
 		display: grid;

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

@@ -154,6 +154,7 @@
 			{@const reject = rejects[s.inp.nodeId]?.[0]}
 			<MediaSlot
 				label={s.label}
+				hint={s.lastFrame && !s.inp.required ? t('studio.slotOptional') : undefined}
 				required={s.inp.required}
 				value={String(values[s.inp.nodeId] ?? '')}
 				kind={s.mediaKind}

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

@@ -183,7 +183,8 @@
 
 	<div class="out">
 		{#if output}
-			<div class="thumb" class:portrait>
+			<div class="thumb a-photo" class:portrait>
+				{#if st.tone === 'ok' && !fileGone}<span class="a-fix">{t('jobst.done')}</span>{/if}
 				{#if isVideoOutput(job, output)}
 					<video
 						src={assetUrl(output)}
@@ -238,15 +239,42 @@
 			background-color var(--d-state) ease,
 			box-shadow var(--d-state) ease;
 	}
-	/* 选中框：金色描边从上一条记录滑到新选中的记录（feed 驱动 WAAPI） */
+	/* 选中框：取景框角线从上一条记录滑到新选中的记录（feed 驱动 WAAPI，
+	   HEL-680 四角短线取代整框描边） */
 	.sel-mark {
 		position: absolute;
 		inset: -1px;
 		z-index: 3;
 		display: none;
-		border: 1px solid var(--accent-line);
-		border-radius: inherit;
 		pointer-events: none;
+		background-image:
+			linear-gradient(var(--accent) 0 0),
+			linear-gradient(var(--accent) 0 0),
+			linear-gradient(var(--accent) 0 0),
+			linear-gradient(var(--accent) 0 0),
+			linear-gradient(var(--accent) 0 0),
+			linear-gradient(var(--accent) 0 0),
+			linear-gradient(var(--accent) 0 0),
+			linear-gradient(var(--accent) 0 0);
+		background-position:
+			left top,
+			left top,
+			right top,
+			right top,
+			left bottom,
+			left bottom,
+			right bottom,
+			right bottom;
+		background-size:
+			14px 2px,
+			2px 14px,
+			14px 2px,
+			2px 14px,
+			14px 2px,
+			2px 14px,
+			14px 2px,
+			2px 14px;
+		background-repeat: no-repeat;
 	}
 	.take.selected {
 		border-color: transparent;
@@ -458,6 +486,12 @@
 		background: var(--bg-4);
 		box-shadow: inset 0 0 0 1px var(--on-media-line);
 	}
+	/* 相纸白边 (HEL-680)：有产出的记录缩略图按相纸呈现，压过占位态样式 */
+	.thumb.a-photo {
+		border-radius: 2px;
+		background: var(--accent);
+		box-shadow: 0 2px 12px rgba(0, 0, 0, 0.35);
+	}
 	.thumb.portrait {
 		width: 96px;
 		aspect-ratio: 3 / 4;

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

@@ -282,7 +282,9 @@ export function validateForm(
 	if (first && last) {
 		const a = String(values[first.inp.nodeId] ?? '');
 		const b = String(values[last.inp.nodeId] ?? '');
-		if ((!a || !b) && (a || b)) {
+		// 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] = ' ';

calliope-web/src/lib/components/home/AProjectCard.svelte

@@ -52,7 +52,12 @@
 		'var(--avatar-4)',
 		'var(--avatar-5)',
 	];
-	const placeholder = $derived(PLACEHOLDER_GRADIENTS[project.id % PLACEHOLDER_GRADIENTS.length]);
+	const placeholderIdx = $derived(project.id % PLACEHOLDER_GRADIENTS.length);
+	const placeholder = $derived(PLACEHOLDER_GRADIENTS[placeholderIdx]);
+	// HEL-680 灰阶封面占位：1–2 亮阶配深图标，3–5 暗阶配浅图标
+	const placeholderIconColor = $derived(
+		placeholderIdx <= 1 ? 'var(--accent-ink)' : 'var(--text)',
+	);
 
 	const coverUrl = $derived(assetUrl(project.cover_path));
 
@@ -174,7 +179,12 @@
 					onerror={() => (coverFailed = true)}
 				/>
 			{:else}
-				<span class="cover-ph" style:background={placeholder} aria-hidden="true">
+				<span
+					class="cover-ph"
+					style:background={placeholder}
+					style:color={placeholderIconColor}
+					aria-hidden="true"
+				>
 					<Icon name="film" size={22} />
 				</span>
 			{/if}
@@ -381,7 +391,7 @@
 		white-space: nowrap;
 	}
 	.arrow {
-		color: var(--accent);
+		color: var(--text-2);
 		font-size: 13px;
 		opacity: 0;
 		transform: translateX(-6px);

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

@@ -402,6 +402,7 @@
 		flex-shrink: 0;
 		margin-bottom: var(--sp-5);
 		border-radius: var(--r-md);
+		border-bottom: 2px solid var(--accent-lo);
 		display: grid;
 		place-items: center;
 		background: var(--accent-grad);

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

@@ -9,6 +9,7 @@ export type NavId =
 	| 'agents'
 	| 'connections'
 	| 'models'
+	| 'library'
 	| 'settings';
 
 export interface NavItem {
@@ -33,6 +34,7 @@ export const NAV_MAIN: NavItem[] = [
 export const NAV_FOOT: NavItem[] = [
 	{ id: 'connections', labelKey: 'shell.navConnections', icon: 'link', href: '/connections' },
 	{ id: 'models', labelKey: 'shell.navModels', icon: 'assets', href: '/models' },
+	{ id: 'library', labelKey: 'shell.navLibrary', icon: 'folder', href: '/library' },
 	{ id: 'settings', labelKey: 'shell.navSettings', icon: 'settings', href: '/settings' },
 ];
 

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

@@ -0,0 +1,256 @@
+<script lang="ts">
+  import type { Snippet } from 'svelte';
+  import Icon from './Icon.svelte';
+  import { t } from '$lib/i18n.svelte';
+
+  /**
+   * Drawer — the shared right-side floating layer (HEL-649 §四.3):
+   * slides in over 280ms with --ease-drawer and reverses mid-flight,
+   * focus is trapped while open, Esc / backdrop click close it, and
+   * reduced-motion keeps only a ≤120ms opacity fade (no slide).
+   */
+  interface Props {
+    open?: boolean;
+    title?: string;
+    /** Panel width on >760px screens. */
+    width?: number;
+    dismissible?: boolean;
+    onclose?: () => void;
+    footer?: Snippet;
+    children: Snippet;
+  }
+
+  let {
+    open = $bindable(false),
+    title,
+    width = 380,
+    dismissible = true,
+    onclose,
+    footer,
+    children,
+  }: Props = $props();
+
+  const FOCUSABLE =
+    'a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])';
+
+  const titleId = `drawer-title-${Math.random().toString(36).slice(2, 9)}`;
+
+  let panel = $state<HTMLDivElement | null>(null);
+
+  function requestClose() {
+    if (!dismissible) return;
+    open = false;
+  }
+
+  function handleKeydown(event: KeyboardEvent) {
+    if (event.key === 'Escape') {
+      event.preventDefault();
+      requestClose();
+      return;
+    }
+    if (event.key === 'Tab') trapFocus(event);
+  }
+
+  function trapFocus(event: KeyboardEvent) {
+    if (!panel) return;
+    const focusables = Array.from(
+      panel.querySelectorAll<HTMLElement>(FOCUSABLE),
+    ).filter((el) => el.getClientRects().length > 0);
+    if (focusables.length === 0) {
+      event.preventDefault();
+      panel.focus();
+      return;
+    }
+    const first = focusables[0];
+    const last = focusables[focusables.length - 1];
+    const active = document.activeElement;
+    const focusInside = panel.contains(active);
+    if (event.shiftKey && (!focusInside || active === first)) {
+      event.preventDefault();
+      last.focus();
+    } else if (!focusInside || active === last) {
+      event.preventDefault();
+      first.focus();
+    }
+  }
+
+  function handleBackdropClick(event: MouseEvent) {
+    if (event.target === event.currentTarget) requestClose();
+  }
+
+  $effect(() => {
+    if (!open) return;
+
+    const invoker = document.activeElement as HTMLElement | null;
+    const previousOverflow = document.body.style.overflow;
+    document.body.style.overflow = 'hidden';
+    document.addEventListener('keydown', handleKeydown, true);
+
+    requestAnimationFrame(() => {
+      if (!panel || panel.contains(document.activeElement)) return;
+      const first = panel.querySelector<HTMLElement>(FOCUSABLE);
+      (first ?? panel).focus();
+    });
+
+    return () => {
+      document.body.style.overflow = previousOverflow;
+      document.removeEventListener('keydown', handleKeydown, true);
+      if (invoker?.isConnected) invoker.focus();
+      onclose?.();
+    };
+  });
+</script>
+
+{#if open}
+  <!-- svelte-ignore a11y_click_events_have_key_events, a11y_no_static_element_interactions -->
+  <div class="drawer-backdrop" onclick={handleBackdropClick}>
+    <div
+      bind:this={panel}
+      class="drawer-panel"
+      style:--drawer-w="{width}px"
+      role="dialog"
+      aria-modal="true"
+      aria-labelledby={title ? titleId : undefined}
+      aria-label={title ? undefined : t('modal.dialog')}
+      tabindex="-1"
+    >
+      {#if title || dismissible}
+        <div class="drawer-header">
+          {#if title}
+            <h2 class="drawer-title" id={titleId}>{title}</h2>
+          {/if}
+          {#if dismissible}
+            <button
+              type="button"
+              class="drawer-close"
+              aria-label={t('modal.closeDialog')}
+              onclick={requestClose}
+            >
+              <Icon name="close" size={16} />
+            </button>
+          {/if}
+        </div>
+      {/if}
+      <div class="drawer-body">
+        {@render children()}
+      </div>
+      {#if footer}
+        <div class="drawer-footer">
+          {@render footer()}
+        </div>
+      {/if}
+    </div>
+  </div>
+{/if}
+
+<style>
+  .drawer-backdrop {
+    position: fixed;
+    inset: 0;
+    z-index: 900;
+    display: flex;
+    justify-content: flex-end;
+    background: var(--overlay);
+    animation: drawer-fade var(--d-state) ease-out;
+  }
+  .drawer-panel {
+    width: min(var(--drawer-w), 100vw);
+    height: 100dvh;
+    display: flex;
+    flex-direction: column;
+    background: var(--float-bg);
+    border-radius: var(--r-lg) 0 0 var(--r-lg);
+    box-shadow: var(--shadow-float);
+    outline: none;
+    animation: drawer-slide var(--d-drawer) var(--ease-drawer) both;
+  }
+  .drawer-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 12px;
+    padding: 16px 20px 0;
+    flex-shrink: 0;
+  }
+  .drawer-title {
+    margin: 0;
+    font-size: var(--fs-title);
+    font-weight: 600;
+    color: var(--text);
+  }
+  .drawer-close {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    width: 28px;
+    height: 28px;
+    margin-left: auto;
+    border: none;
+    border-radius: var(--r-sm);
+    background: transparent;
+    color: var(--text-3);
+    cursor: pointer;
+    transition:
+      background-color var(--d-state) ease,
+      color var(--d-state) ease;
+  }
+  @media (hover: hover) and (pointer: fine) {
+    .drawer-close:hover {
+      background: var(--bg-4);
+      color: var(--text);
+    }
+  }
+  .drawer-close:focus-visible {
+    outline: 2px solid var(--accent);
+    outline-offset: 2px;
+  }
+  .drawer-body {
+    padding: 14px 20px 20px;
+    overflow-y: auto;
+    flex: 1;
+    min-height: 0;
+    font-size: 13px;
+    line-height: 1.55;
+    color: var(--text);
+  }
+  .drawer-footer {
+    display: flex;
+    justify-content: flex-end;
+    gap: 8px;
+    padding: 12px 20px 16px;
+    border-top: 1px solid var(--line);
+    flex-shrink: 0;
+  }
+  @keyframes drawer-fade {
+    from {
+      opacity: 0;
+    }
+    to {
+      opacity: 1;
+    }
+  }
+  @keyframes drawer-slide {
+    from {
+      transform: translateX(100%);
+    }
+    to {
+      transform: translateX(0);
+    }
+  }
+  /* 减少动态效果 (§五)：去位移，只留 ≤120ms 透明度 */
+  :global(:root[data-reduce='1']) .drawer-panel {
+    animation: drawer-fade var(--d-drawer) ease-out both;
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .drawer-panel {
+      animation: drawer-fade var(--d-drawer) ease-out both;
+    }
+  }
+
+  @media (max-width: 760px) {
+    .drawer-panel {
+      width: 100vw;
+      border-radius: 0;
+    }
+  }
+</style>

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

@@ -132,9 +132,7 @@ let {
 		min-height: 0;
 		width: 100%;
 		height: 100%;
-		background:
-			radial-gradient(ellipse at center, rgba(139, 92, 246, 0.08), transparent 55%),
-			#050508;
+		background: var(--stage-bg);
 		border: 1px solid var(--border);
 		border-radius: var(--radius-md);
 		overflow: hidden;

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

@@ -79,14 +79,14 @@
 	let criticNotes = $state<string[]>([]);
 
 	const preview = createMutation({
-		mutationFn: async (vars?: { force?: boolean }) => {
+		mutationFn: async (vars: { force?: boolean } | void) => {
 			if (!clip && !scene) throw new Error(t('promptPreview.noClipSelected'));
 			return jobsApi.previewPrompt(projectId, {
 				clip_id: clip?.id,
 				scene_id: clip ? undefined : scene?.id,
 				workflow_id: workflow?.id,
 				input_values: compactInputValues(inputValues),
-				force: Boolean(vars?.force),
+				force: Boolean((vars as { force?: boolean } | undefined)?.force),
 			});
 		},
 		onSuccess: (data) => {

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

@@ -203,7 +203,7 @@ title={t('filmstrip.clipTitle', {
 		inset: 0 0 auto 0;
 		height: 3px;
 		z-index: 1;
-		background: #3f3f46;
+		background: var(--bg-4);
 	}
 
 	.clip.status-done .bar {

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

@@ -81,12 +81,12 @@
 			{#each draft as asset (asset.id)}
 				<div class="asset-edit">
 					<div class="asset-edit-head">
-						<select class="wb-input w-kind" bind:value={asset.kind}>
+						<select class="a-input w-kind" bind:value={asset.kind}>
 							<option value="character">{t('workbench.asset.kindCharacter')}</option>
 							<option value="location">{t('workbench.asset.kindLocation')}</option>
 							<option value="prop">{t('workbench.asset.kindProp')}</option>
 						</select>
-						<input class="wb-input name" bind:value={asset.name} placeholder={t('workbench.asset.namePh')} />
+						<input class="a-input name" bind:value={asset.name} placeholder={t('workbench.asset.namePh')} />
 						<button
 							type="button"
 							class="icon-btn danger"
@@ -96,15 +96,15 @@
 							<Icon name="trash" size={13} />
 						</button>
 					</div>
-					<input class="wb-input" bind:value={asset.description} placeholder={t('workbench.asset.descPh')} />
+					<input class="a-input" bind:value={asset.description} placeholder={t('workbench.asset.descPh')} />
 					<textarea
-						class="wb-input mono"
+						class="a-input mono"
 						rows="2"
 						bind:value={asset.prompt}
 						placeholder={t('workbench.asset.promptPh')}
 					></textarea>
 					<input
-						class="wb-input mono"
+						class="a-input mono"
 						bind:value={asset.negative_prompt}
 						placeholder={t('workbench.style.negativePh')}
 					/>
@@ -112,17 +112,17 @@
 			{/each}
 		</div>
 		<div class="editor-foot">
-			<button type="button" class="btn ghost" onclick={addAsset}>
+			<button type="button" class="a-btn ghost" onclick={addAsset}>
 				<Icon name="plus" size={13} />
 				{t('workbench.asset.add')}
 			</button>
 			<div class="foot-btns">
-				<button type="button" class="btn ghost" onclick={() => (editing = false)}>
+				<button type="button" class="a-btn ghost" onclick={() => (editing = false)}>
 					{t('workbench.cancelEdit')}
 				</button>
 				<button
 					type="button"
-					class="btn primary"
+					class="a-btn primary"
 					disabled={!draft.some((a) => a.name.trim() && a.prompt.trim())}
 					onclick={save}
 				>
@@ -135,7 +135,7 @@
 	<div class="todo-card">
 		<p class="todo-title">{t('workbench.asset.todoTitle')}</p>
 		<p class="todo-body">{t('workbench.asset.todoBody')}</p>
-		<button type="button" class="btn primary" disabled={busy} onclick={() => onRun?.()}>
+		<button type="button" class="a-btn primary" disabled={busy} onclick={() => onRun?.()}>
 			<Icon name="sparkle" size={14} />
 			{t('workbench.asset.generate')}
 		</button>
@@ -192,7 +192,7 @@
 					{/if}
 					<button
 						type="button"
-						class="btn ghost gen"
+						class="a-btn ghost sm"
 						disabled={busy || jobActive(asset.job)}
 						title={t('workbench.asset.generateHint')}
 						onclick={() =>
@@ -214,11 +214,11 @@
 		<span class="hint">{t('workbench.asset.summary', { n: assets.length })}</span>
 		<div class="foot-btns">
 			{#if stage.status !== 'running'}
-				<button type="button" class="btn ghost" disabled={busy} onclick={startEdit}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={startEdit}>
 					<Icon name="edit" size={13} />
 					{t('workbench.editDraft')}
 				</button>
-				<button type="button" class="btn ghost" disabled={busy} onclick={() => onRun?.()}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={() => onRun?.()}>
 					<Icon name="retry" size={13} />
 					{t('workbench.regenerate')}
 				</button>
@@ -378,34 +378,14 @@
 		gap: 8px;
 	}
 
-	.wb-input {
-		width: 100%;
-		box-sizing: border-box;
-		padding: 8px 10px;
-		background: var(--surface-2);
-		border: 1px solid var(--border-strong);
-		border-radius: 8px;
-		color: var(--text);
-		font-family: inherit;
-		font-size: 12.5px;
-		line-height: 1.6;
-		transition: border-color 150ms;
-	}
-	.wb-input:focus {
-		outline: none;
-		border-color: var(--accent-line);
-	}
-	.wb-input::placeholder {
-		color: var(--text-3);
-	}
-	.wb-input.mono {
+	.a-input.mono {
 		font-family: var(--font-a-mono);
 		font-size: 11.5px;
 	}
-	.wb-input.name {
+	.a-input.name {
 		font-weight: 600;
 	}
-	.wb-input.w-kind {
+	.a-input.w-kind {
 		width: 92px;
 		flex-shrink: 0;
 	}
@@ -432,44 +412,4 @@
 		color: var(--error);
 	}
 
-	.btn {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		padding: 8px 14px;
-		border-radius: 8px;
-		border: 1px solid transparent;
-		font-family: inherit;
-		font-size: 12.5px;
-		cursor: pointer;
-		transition:
-			background-color 150ms cubic-bezier(0.16, 1, 0.3, 1),
-			border-color 150ms,
-			opacity 150ms;
-	}
-	.btn.primary {
-		background: var(--accent);
-		color: var(--accent-contrast);
-		font-weight: 600;
-	}
-	.btn.primary:hover:not(:disabled) {
-		filter: brightness(1.08);
-	}
-	.btn.ghost {
-		background: var(--surface-2);
-		border-color: var(--border-strong);
-		color: var(--text-2);
-	}
-	.btn.ghost:hover:not(:disabled) {
-		color: var(--text);
-		border-color: var(--line-2);
-	}
-	.btn.gen {
-		color: var(--accent);
-		border-color: var(--border-strong);
-	}
-	.btn:disabled {
-		opacity: 0.4;
-		cursor: not-allowed;
-	}
 </style>

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

@@ -83,7 +83,7 @@
 		width: 6px;
 		height: 6px;
 		border-radius: 50%;
-		background: var(--accent);
+		background: var(--run);
 		animation: wb-chip-breath 2s cubic-bezier(0.16, 1, 0.3, 1) infinite;
 	}
 	@keyframes wb-chip-breath {

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

@@ -56,15 +56,15 @@
 			<blockquote class="idea-quote">{projectIdea}</blockquote>
 		{/if}
 		<div class="todo-actions">
-			<button type="button" class="btn primary" disabled={busy} onclick={() => onRun?.()}>
+			<button type="button" class="a-btn primary" disabled={busy} onclick={() => onRun?.()}>
 				<Icon name="sparkle" size={14} />
 				{t('workbench.script.generate')}
 			</button>
-			<button type="button" class="btn ghost" onclick={() => (importOpen = !importOpen)}>
+			<button type="button" class="a-btn ghost" onclick={() => (importOpen = !importOpen)}>
 				<Icon name="upload" size={14} />
 				{t('workbench.script.importBtn')}
 			</button>
-			<button type="button" class="btn ghost" onclick={startEdit}>
+			<button type="button" class="a-btn ghost" onclick={startEdit}>
 				<Icon name="edit" size={14} />
 				{t('workbench.script.writeManually')}
 			</button>
@@ -72,7 +72,7 @@
 		{#if importOpen}
 			<div class="import-box">
 				<textarea
-					class="wb-input"
+					class="a-input"
 					rows="8"
 					bind:value={importText}
 					placeholder={t('workbench.script.importPlaceholder')}
@@ -81,7 +81,7 @@
 					<span class="hint">{t('workbench.script.importHint')}</span>
 					<button
 						type="button"
-						class="btn primary sm"
+						class="a-btn primary sm"
 						disabled={importText.trim().length < 30}
 						onclick={doImport}
 					>
@@ -94,7 +94,7 @@
 {:else if editing}
 	<div class="editor">
 		<textarea
-			class="wb-input mono-area"
+			class="a-input mono-area"
 			rows="18"
 			bind:value={draft}
 			data-testid="script-editor"
@@ -102,12 +102,12 @@
 		<div class="editor-foot">
 			<span class="hint">{t('workbench.script.editorHint')}</span>
 			<div class="foot-btns">
-				<button type="button" class="btn ghost" onclick={() => (editing = false)}>
+				<button type="button" class="a-btn ghost" onclick={() => (editing = false)}>
 					{t('workbench.cancelEdit')}
 				</button>
 				<button
 					type="button"
-					class="btn primary"
+					class="a-btn primary"
 					disabled={draft.trim().length < 30}
 					onclick={save}
 				>
@@ -122,13 +122,13 @@
 		<span class="char-count mono">{t('workbench.charCount', { n: charCount })}</span>
 		<div class="foot-btns">
 			{#if stage.status !== 'running'}
-				<button type="button" class="btn ghost" disabled={busy} onclick={startEdit}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={startEdit}>
 					<Icon name="edit" size={13} />
 					{t('workbench.editDraft')}
 				</button>
 				<button
 					type="button"
-					class="btn ghost"
+					class="a-btn ghost"
 					disabled={busy}
 					onclick={() => onRun?.()}
 					title={t('workbench.regenerateHint')}
@@ -243,65 +243,5 @@
 		color: var(--text-3);
 	}
 
-	.wb-input {
-		width: 100%;
-		box-sizing: border-box;
-		padding: 10px 12px;
-		background: var(--surface-2);
-		border: 1px solid var(--border-strong);
-		border-radius: 8px;
-		color: var(--text);
-		font-family: inherit;
-		font-size: 13px;
-		line-height: 1.7;
-		transition: border-color 150ms;
-	}
-	.wb-input:focus {
-		outline: none;
-		border-color: var(--accent-line);
-	}
-	.wb-input::placeholder {
-		color: var(--text-3);
-	}
 
-	.btn {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		padding: 8px 14px;
-		border-radius: 8px;
-		border: 1px solid transparent;
-		font-family: inherit;
-		font-size: 12.5px;
-		cursor: pointer;
-		transition:
-			background-color 150ms cubic-bezier(0.16, 1, 0.3, 1),
-			border-color 150ms,
-			opacity 150ms;
-	}
-	.btn.primary {
-		background: var(--accent);
-		color: var(--accent-contrast);
-		font-weight: 600;
-	}
-	.btn.primary:hover:not(:disabled) {
-		filter: brightness(1.08);
-	}
-	.btn.ghost {
-		background: var(--surface-2);
-		border-color: var(--border-strong);
-		color: var(--text-2);
-	}
-	.btn.ghost:hover:not(:disabled) {
-		color: var(--text);
-		border-color: var(--line-2);
-	}
-	.btn.sm {
-		padding: 6px 12px;
-		font-size: 12px;
-	}
-	.btn:disabled {
-		opacity: 0.4;
-		cursor: not-allowed;
-	}
 </style>

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

@@ -74,9 +74,9 @@
 			{#each draft as shot (shot.id)}
 				<div class="vshot-edit">
 					<div class="vshot-edit-head">
-						<input class="wb-input w-no mono" bind:value={shot.shot_no} placeholder={t('workbench.vshot.noPh')} />
+						<input class="a-input w-no mono" bind:value={shot.shot_no} placeholder={t('workbench.vshot.noPh')} />
 						<input
-							class="wb-input w-dur mono"
+							class="a-input w-dur mono"
 							type="number"
 							min="1"
 							step="1"
@@ -92,9 +92,9 @@
 							<Icon name="trash" size={13} />
 						</button>
 					</div>
-					<input class="wb-input" bind:value={shot.description} placeholder={t('workbench.vshot.descPh')} />
+					<input class="a-input" bind:value={shot.description} placeholder={t('workbench.vshot.descPh')} />
 					<textarea
-						class="wb-input mono"
+						class="a-input mono"
 						rows="3"
 						bind:value={shot.prompt}
 						placeholder={t('workbench.vshot.promptPh')}
@@ -103,17 +103,17 @@
 			{/each}
 		</div>
 		<div class="editor-foot">
-			<button type="button" class="btn ghost" onclick={addShot}>
+			<button type="button" class="a-btn ghost" onclick={addShot}>
 				<Icon name="plus" size={13} />
 				{t('workbench.vshot.add')}
 			</button>
 			<div class="foot-btns">
-				<button type="button" class="btn ghost" onclick={() => (editing = false)}>
+				<button type="button" class="a-btn ghost" onclick={() => (editing = false)}>
 					{t('workbench.cancelEdit')}
 				</button>
 				<button
 					type="button"
-					class="btn primary"
+					class="a-btn primary"
 					disabled={!draft.some((s) => s.prompt.trim())}
 					onclick={save}
 				>
@@ -126,7 +126,7 @@
 	<div class="todo-card">
 		<p class="todo-title">{t('workbench.vshot.todoTitle')}</p>
 		<p class="todo-body">{t('workbench.vshot.todoBody')}</p>
-		<button type="button" class="btn primary" disabled={busy} onclick={() => onRun?.()}>
+		<button type="button" class="a-btn primary" disabled={busy} onclick={() => onRun?.()}>
 			<Icon name="sparkle" size={14} />
 			{t('workbench.vshot.generate')}
 		</button>
@@ -180,7 +180,7 @@
 					{/if}
 					<button
 						type="button"
-						class="btn ghost gen"
+						class="a-btn ghost sm"
 						disabled={busy || jobActive(shot.job)}
 						title={t('workbench.vshot.generateHint')}
 						onclick={() =>
@@ -202,11 +202,11 @@
 		<span class="hint">{t('workbench.vshot.summary', { n: shots.length })}</span>
 		<div class="foot-btns">
 			{#if stage.status !== 'running'}
-				<button type="button" class="btn ghost" disabled={busy} onclick={startEdit}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={startEdit}>
 					<Icon name="edit" size={13} />
 					{t('workbench.editDraft')}
 				</button>
-				<button type="button" class="btn ghost" disabled={busy} onclick={() => onRun?.()}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={() => onRun?.()}>
 					<Icon name="retry" size={13} />
 					{t('workbench.regenerate')}
 				</button>
@@ -260,9 +260,10 @@
 		flex-wrap: wrap;
 	}
 	.vshot-no {
-		font-size: 13px;
+		font-family: var(--mono);
+		font-size: var(--fs-body);
 		font-weight: 700;
-		color: var(--accent);
+		color: var(--accent-lo);
 		font-variant-numeric: tabular-nums;
 	}
 	.vshot-dur {
@@ -279,9 +280,9 @@
 	.vshot-video {
 		width: 100%;
 		max-height: 300px;
-		border-radius: 8px;
-		border: 1px solid var(--border);
-		background: #000;
+		border-radius: var(--r-md);
+		border: 1px solid var(--line);
+		background: var(--media-scrim);
 	}
 	.vshot-foot {
 		display: flex;
@@ -347,35 +348,15 @@
 		gap: 8px;
 	}
 
-	.wb-input {
-		width: 100%;
-		box-sizing: border-box;
-		padding: 8px 10px;
-		background: var(--surface-2);
-		border: 1px solid var(--border-strong);
-		border-radius: 8px;
-		color: var(--text);
-		font-family: inherit;
-		font-size: 12.5px;
-		line-height: 1.6;
-		transition: border-color 150ms;
-	}
-	.wb-input:focus {
-		outline: none;
-		border-color: var(--accent-line);
-	}
-	.wb-input::placeholder {
-		color: var(--text-3);
-	}
-	.wb-input.mono {
+	.a-input.mono {
 		font-family: var(--font-a-mono);
 		font-size: 11.5px;
 	}
-	.wb-input.w-no {
+	.a-input.w-no {
 		width: 90px;
 		flex-shrink: 0;
 	}
-	.wb-input.w-dur {
+	.a-input.w-dur {
 		width: 110px;
 		flex-shrink: 0;
 	}
@@ -403,44 +384,4 @@
 		color: var(--error);
 	}
 
-	.btn {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		padding: 8px 14px;
-		border-radius: 8px;
-		border: 1px solid transparent;
-		font-family: inherit;
-		font-size: 12.5px;
-		cursor: pointer;
-		transition:
-			background-color 150ms cubic-bezier(0.16, 1, 0.3, 1),
-			border-color 150ms,
-			opacity 150ms;
-	}
-	.btn.primary {
-		background: var(--accent);
-		color: var(--accent-contrast);
-		font-weight: 600;
-	}
-	.btn.primary:hover:not(:disabled) {
-		filter: brightness(1.08);
-	}
-	.btn.ghost {
-		background: var(--surface-2);
-		border-color: var(--border-strong);
-		color: var(--text-2);
-	}
-	.btn.ghost:hover:not(:disabled) {
-		color: var(--text);
-		border-color: var(--line-2);
-	}
-	.btn.gen {
-		color: var(--accent);
-		border-color: var(--border-strong);
-	}
-	.btn:disabled {
-		opacity: 0.4;
-		cursor: not-allowed;
-	}
 </style>

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

@@ -50,7 +50,7 @@
 	function stateLabel(stage: WorkbenchStage): string {
 		const s = stateOf(stage);
 		if (s === 'running') return t('workbench.state.running');
-		if (s === 'confirmed') return t('workbench.state.confirmed');
+		if (s === 'confirmed') return `✓ ${t('workbench.state.confirmed')}`;
 		if (s === 'edited') return t('workbench.state.edited');
 		if (s === 'draft') return t('workbench.state.draft');
 		return t('workbench.state.todo');
@@ -144,6 +144,14 @@
 	.step-btn.active {
 		background: var(--surface-2);
 		border-color: var(--border-strong);
+		/* §3.2 当前段：金色下划 2px 内阴影 + 段名金色。 */
+		box-shadow: inset 0 -2px 0 var(--accent);
+	}
+	.step-btn.active .step-name {
+		color: var(--accent);
+	}
+	.step-btn[data-state='confirmed']:not(.active) .step-name {
+		color: var(--success);
 	}
 	.step-btn.locked {
 		opacity: 0.55;

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

@@ -71,11 +71,11 @@
 						</button>
 					</div>
 					<div class="shot-fields">
-						<input class="wb-input w-xs" bind:value={shot.scene} placeholder={t('workbench.board.scene')} />
-						<input class="wb-input w-xs" bind:value={shot.shot_size} placeholder={t('workbench.board.size')} />
-						<input class="wb-input w-xs" bind:value={shot.camera} placeholder={t('workbench.board.camera')} />
+						<input class="a-input w-xs" bind:value={shot.scene} placeholder={t('workbench.board.scene')} />
+						<input class="a-input w-xs" bind:value={shot.shot_size} placeholder={t('workbench.board.size')} />
+						<input class="a-input w-xs" bind:value={shot.camera} placeholder={t('workbench.board.camera')} />
 						<input
-							class="wb-input w-xs mono"
+							class="a-input w-xs mono"
 							type="number"
 							min="0.5"
 							step="0.5"
@@ -84,27 +84,27 @@
 						/>
 					</div>
 					<textarea
-						class="wb-input"
+						class="a-input"
 						rows="2"
 						bind:value={shot.description}
 						placeholder={t('workbench.board.descPh')}
 					></textarea>
-					<input class="wb-input" bind:value={shot.dialog} placeholder={t('workbench.board.dialogPh')} />
+					<input class="a-input" bind:value={shot.dialog} placeholder={t('workbench.board.dialogPh')} />
 				</div>
 			{/each}
 		</div>
 		<div class="editor-foot">
-			<button type="button" class="btn ghost" onclick={addShot}>
+			<button type="button" class="a-btn ghost" onclick={addShot}>
 				<Icon name="plus" size={13} />
 				{t('workbench.board.add')}
 			</button>
 			<div class="foot-btns">
-				<button type="button" class="btn ghost" onclick={() => (editing = false)}>
+				<button type="button" class="a-btn ghost" onclick={() => (editing = false)}>
 					{t('workbench.cancelEdit')}
 				</button>
 				<button
 					type="button"
-					class="btn primary"
+					class="a-btn primary"
 					disabled={!draft.some((s) => s.description.trim())}
 					onclick={save}
 				>
@@ -117,7 +117,7 @@
 	<div class="todo-card">
 		<p class="todo-title">{t('workbench.board.todoTitle')}</p>
 		<p class="todo-body">{t('workbench.board.todoBody')}</p>
-		<button type="button" class="btn primary" disabled={busy} onclick={() => onRun?.()}>
+		<button type="button" class="a-btn primary" disabled={busy} onclick={() => onRun?.()}>
 			<Icon name="sparkle" size={14} />
 			{t('workbench.board.generate')}
 		</button>
@@ -149,11 +149,11 @@
 		<span class="hint mono">{t('workbench.board.summary', { n: shots.length, sec: totalDuration })}</span>
 		<div class="foot-btns">
 			{#if stage.status !== 'running'}
-				<button type="button" class="btn ghost" disabled={busy} onclick={startEdit}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={startEdit}>
 					<Icon name="edit" size={13} />
 					{t('workbench.editDraft')}
 				</button>
-				<button type="button" class="btn ghost" disabled={busy} onclick={() => onRun?.()}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={() => onRun?.()}>
 					<Icon name="retry" size={13} />
 					{t('workbench.regenerate')}
 				</button>
@@ -282,31 +282,11 @@
 		flex-wrap: wrap;
 		gap: 8px;
 	}
-	.wb-input {
-		width: 100%;
-		box-sizing: border-box;
-		padding: 8px 10px;
-		background: var(--surface-2);
-		border: 1px solid var(--border-strong);
-		border-radius: 8px;
-		color: var(--text);
-		font-family: inherit;
-		font-size: 12.5px;
-		line-height: 1.6;
-		transition: border-color 150ms;
-	}
-	.wb-input:focus {
-		outline: none;
-		border-color: var(--accent-line);
-	}
-	.wb-input::placeholder {
-		color: var(--text-3);
-	}
-	.wb-input.mono {
+	.a-input.mono {
 		font-family: var(--font-a-mono);
 		font-size: 11.5px;
 	}
-	.wb-input.w-xs {
+	.a-input.w-xs {
 		width: 110px;
 		flex: 1;
 		min-width: 96px;
@@ -356,40 +336,4 @@
 		color: var(--error);
 	}
 
-	.btn {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		padding: 8px 14px;
-		border-radius: 8px;
-		border: 1px solid transparent;
-		font-family: inherit;
-		font-size: 12.5px;
-		cursor: pointer;
-		transition:
-			background-color 150ms cubic-bezier(0.16, 1, 0.3, 1),
-			border-color 150ms,
-			opacity 150ms;
-	}
-	.btn.primary {
-		background: var(--accent);
-		color: var(--accent-contrast);
-		font-weight: 600;
-	}
-	.btn.primary:hover:not(:disabled) {
-		filter: brightness(1.08);
-	}
-	.btn.ghost {
-		background: var(--surface-2);
-		border-color: var(--border-strong);
-		color: var(--text-2);
-	}
-	.btn.ghost:hover:not(:disabled) {
-		color: var(--text);
-		border-color: var(--line-2);
-	}
-	.btn:disabled {
-		opacity: 0.4;
-		cursor: not-allowed;
-	}
 </style>

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

@@ -67,7 +67,7 @@
 			<div class="dir-edit">
 				<div class="dir-edit-head">
 					<span class="dir-index mono">{i + 1}</span>
-					<input class="wb-input name" bind:value={dir.name} placeholder={t('workbench.style.namePh')} />
+					<input class="a-input name" bind:value={dir.name} placeholder={t('workbench.style.namePh')} />
 					<button
 						type="button"
 						class="icon-btn danger"
@@ -78,35 +78,35 @@
 					</button>
 				</div>
 				<input
-					class="wb-input"
+					class="a-input"
 					bind:value={dir.description}
 					placeholder={t('workbench.style.descPh')}
 				/>
 				<textarea
-					class="wb-input mono"
+					class="a-input mono"
 					rows="2"
 					bind:value={dir.prompt}
 					placeholder={t('workbench.style.promptPh')}
 				></textarea>
 				<input
-					class="wb-input mono"
+					class="a-input mono"
 					bind:value={dir.negative_prompt}
 					placeholder={t('workbench.style.negativePh')}
 				/>
 			</div>
 		{/each}
 		<div class="editor-foot">
-			<button type="button" class="btn ghost" onclick={addDirection}>
+			<button type="button" class="a-btn ghost" onclick={addDirection}>
 				<Icon name="plus" size={13} />
 				{t('workbench.style.add')}
 			</button>
 			<div class="foot-btns">
-				<button type="button" class="btn ghost" onclick={() => (editing = false)}>
+				<button type="button" class="a-btn ghost" onclick={() => (editing = false)}>
 					{t('workbench.cancelEdit')}
 				</button>
 				<button
 					type="button"
-					class="btn primary"
+					class="a-btn primary"
 					disabled={draft.filter((d) => d.name.trim() && d.prompt.trim()).length < 2}
 					onclick={save}
 				>
@@ -119,7 +119,7 @@
 	<div class="todo-card">
 		<p class="todo-title">{t('workbench.style.todoTitle')}</p>
 		<p class="todo-body">{t('workbench.style.todoBody')}</p>
-		<button type="button" class="btn primary" disabled={busy} onclick={() => onRun?.()}>
+		<button type="button" class="a-btn primary" disabled={busy} onclick={() => onRun?.()}>
 			<Icon name="sparkle" size={14} />
 			{t('workbench.style.generate')}
 		</button>
@@ -153,11 +153,11 @@
 		<span class="hint">{t('workbench.style.chooseHint')}</span>
 		<div class="foot-btns">
 			{#if stage.status !== 'running'}
-				<button type="button" class="btn ghost" disabled={busy} onclick={startEdit}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={startEdit}>
 					<Icon name="edit" size={13} />
 					{t('workbench.editDraft')}
 				</button>
-				<button type="button" class="btn ghost" disabled={busy} onclick={() => onRun?.()}>
+				<button type="button" class="a-btn ghost" disabled={busy} onclick={() => onRun?.()}>
 					<Icon name="retry" size={13} />
 					{t('workbench.regenerate')}
 				</button>
@@ -295,31 +295,11 @@
 		gap: 8px;
 	}
 
-	.wb-input {
-		width: 100%;
-		box-sizing: border-box;
-		padding: 8px 10px;
-		background: var(--surface-2);
-		border: 1px solid var(--border-strong);
-		border-radius: 8px;
-		color: var(--text);
-		font-family: inherit;
-		font-size: 12.5px;
-		line-height: 1.6;
-		transition: border-color 150ms;
-	}
-	.wb-input:focus {
-		outline: none;
-		border-color: var(--accent-line);
-	}
-	.wb-input::placeholder {
-		color: var(--text-3);
-	}
-	.wb-input.mono {
+	.a-input.mono {
 		font-family: var(--font-a-mono);
 		font-size: 11.5px;
 	}
-	.wb-input.name {
+	.a-input.name {
 		font-weight: 600;
 	}
 
@@ -345,40 +325,4 @@
 		color: var(--error);
 	}
 
-	.btn {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		padding: 8px 14px;
-		border-radius: 8px;
-		border: 1px solid transparent;
-		font-family: inherit;
-		font-size: 12.5px;
-		cursor: pointer;
-		transition:
-			background-color 150ms cubic-bezier(0.16, 1, 0.3, 1),
-			border-color 150ms,
-			opacity 150ms;
-	}
-	.btn.primary {
-		background: var(--accent);
-		color: var(--accent-contrast);
-		font-weight: 600;
-	}
-	.btn.primary:hover:not(:disabled) {
-		filter: brightness(1.08);
-	}
-	.btn.ghost {
-		background: var(--surface-2);
-		border-color: var(--border-strong);
-		color: var(--text-2);
-	}
-	.btn.ghost:hover:not(:disabled) {
-		color: var(--text);
-		border-color: var(--line-2);
-	}
-	.btn:disabled {
-		opacity: 0.4;
-		cursor: not-allowed;
-	}
 </style>

calliope-web/src/lib/i18n/de.ts

@@ -221,6 +221,25 @@ export const de: Dict = {
 	'lightbox.videoPreview': 'Videovorschau',
 	'lightbox.videoUnavailable': 'Video nicht verfügbar',
 	'lightbox.zoom100': '100%',
+	'lastFrame.export': 'Letztes Bild exportieren',
+	'lastFrame.exporting': 'Letztes Bild wird exportiert…',
+	'lastFrame.hint': 'Speichert das letzte Bild in Originalgröße als PNG, z. B. als Startbild-Referenz',
+	'lastFrame.fileTag': 'letztes-bild',
+	'lastFrame.done': 'Letztes Bild exportiert {name} ({size})',
+	'lastFrame.errTimeout': 'Das Video lädt zu lange. Bitte später erneut versuchen.',
+	'lastFrame.errNotFound': 'Die Videodatei fehlt oder wurde entfernt.',
+	'lastFrame.errForbidden': 'Keine Berechtigung, dieses Video zu lesen.',
+	'lastFrame.errNetwork': 'Das Video konnte nicht gelesen werden (Netzwerkfehler).',
+	'lastFrame.errDecode': 'Das Video ist beschädigt; das Ende lässt sich nicht dekodieren.',
+	'lastFrame.errUnsupported': 'Dieser Browser unterstützt das Videoformat nicht, oder die Datei ist beschädigt.',
+	'lastFrame.errCrossOrigin':
+		'Das Video stammt von einer anderen Website, die das Auslesen von Bildern sperrt (Cross-Origin). Video zuerst herunterladen.',
+	'lastFrame.errNoPicture': 'Diese Datei enthält kein Videobild.',
+	'lastFrame.errUnseekable':
+		'Das Videoende ist nicht erreichbar (Länge unbekannt oder Quelle erlaubt kein Springen); kein Bild exportiert.',
+	'lastFrame.errBlack': 'Die letzte Sekunde des Videos ist schwarz; kein Bild exportiert.',
+	'lastFrame.errEmpty': 'Der Browser konnte das Ende nicht dekodieren. Erneut versuchen oder Desktop-Chrome / Edge nutzen.',
+	'lastFrame.errUnknown': 'Export des letzten Bildes fehlgeschlagen: {msg}',
 
 	// --- Artifact / canvas nodes ---
 	'artifact.artifactLabel': 'Artefakt',
@@ -949,6 +968,8 @@ export const de: Dict = {
 	'library.selectAll': 'Alle auswählen',
 	'library.deselectAll': 'Auswahl aufheben',
 	'library.itemCount': '{count} Element(e)',
+	'library.loadError': 'Bibliothek konnte nicht geladen werden',
+	'library.subtitle': 'Generierte Assets an einem Ort – Bilder und Videos ohne Projektbezug ansehen, filtern und löschen',
 	'library.deleteSelected': 'Löschen ({count})',
 	'library.addToProject': 'Zum Projekt hinzufügen',
 	'library.filterLabel': 'Nach Art filtern',
@@ -1260,6 +1281,7 @@ export const de: Dict = {
 	'shell.navAgents': 'Agenten',
 	'shell.navConnections': 'ComfyUI-Verbindungen',
 	'shell.navModels': 'Modelle',
+	'shell.navLibrary': 'Asset-Bibliothek',
 	'shell.navSettings': 'Einstellungen',
 	'shell.comfy_ok': '{name} verbunden',
 	'shell.comfy_fail': '{name} nicht erreichbar',
@@ -1536,6 +1558,7 @@ export const de: Dict = {
 	'studio.slotMask': 'Maske',
 	'studio.slotFirst': 'Erster Frame',
 	'studio.slotLast': 'Letzter Frame',
+	'studio.slotOptional': 'Optional',
 	'studio.slotRefVideo': 'Referenzvideo',
 	'studio.slotAudio': 'Referenzaudio',
 	'studio.slotPick': 'Klicken oder Datei ziehen',
@@ -1879,7 +1902,7 @@ export const de: Dict = {
 	'home.stageProgress': 'Fünf-Phasen-Fortschritt',
 	'tasks.sourceWorkbench': 'Kreativ-Fluss',
 	'jobst.idSuffix': ' · ComfyUI-Prompt-ID {id}',
-	'jobst.done': 'Fertig',
+	'jobst.done': 'Fixiert',
 	'jobst.doneDetail': 'ComfyUI ist fertig, Ergebnisse gespeichert',
 	'jobst.dryRun': 'Platzhalter',
 	'jobst.dryRunDetail': 'Nur Platzhalter: Dry-run ist aktiv, ComfyUI wurde nicht aufgerufen',
@@ -2058,4 +2081,20 @@ export const de: Dict = {
 	'desk.wfUntested': 'Nicht getestet',
 	'desk.workflow': 'Workflow',
 	'desk.yesterday': 'Gestern',
+	'wfd.stepParse': 'JSON parsen',
+	'wfd.stepNodes': 'Knoten erkennen',
+	'wfd.stepModels': 'Modelle prüfen',
+	'wfd.stepSlots': 'Eingangsslots aufbauen',
+	'wfd.noOutput': 'Der Workflow hat keinen Ausgabeknoten — Import nicht möglich',
+	'wfd.nodesAutoOk': 'Verwendung automatisch erkannt: {usage}',
+	'wfd.nodesUserOk': 'Verwendung bestätigt: {usage}',
+	'wfd.modelsOk': '„{name}“ hat alle benötigten Knoten und Modelle',
+	'wfd.slotsOk': '{n} Eingangsslot(s) aufgebaut ({m} Medien)',
+	'wfd.checksAria': 'Import-Prüfergebnisse',
+	'wfd.showDetails': 'Fehlerdetails anzeigen',
+	'wfd.hideDetails': 'Fehlerdetails ausblenden',
+	'wfd.unreachableSuggest': 'Eine misslungene Prüfung verhindert das Speichern nicht; nach Reparatur erneut prüfen.',
+	'wfd.nodesPickSuggest': 'Wähle unten die Verwendung und schließe die Ausgangszuordnung ab, bevor du speicherst.',
+	'wfd.showRaw': 'Rohes JSON anzeigen',
+	'wfd.hideRaw': 'Rohes JSON ausblenden',
 };

calliope-web/src/lib/i18n/en.ts

@@ -221,6 +221,25 @@ export const en = {
 	'lightbox.videoPreview': 'Video preview',
 	'lightbox.videoUnavailable': 'Video unavailable',
 	'lightbox.zoom100': '100%',
+	'lastFrame.export': 'Export last frame',
+	'lastFrame.exporting': 'Exporting last frame…',
+	'lastFrame.hint': 'Save the final frame as a full-size PNG, e.g. as a first-frame reference',
+	'lastFrame.fileTag': 'last-frame',
+	'lastFrame.done': 'Exported last frame {name} ({size})',
+	'lastFrame.errTimeout': 'The video took too long to load. Try again later.',
+	'lastFrame.errNotFound': 'The video file is missing or was removed.',
+	'lastFrame.errForbidden': 'You do not have permission to read this video.',
+	'lastFrame.errNetwork': 'Reading the video failed (network error). Check the connection and retry.',
+	'lastFrame.errDecode': 'The video is damaged; its ending cannot be decoded.',
+	'lastFrame.errUnsupported': 'This browser cannot play the video format, or the file is damaged.',
+	'lastFrame.errCrossOrigin':
+		'The video comes from another site that blocks reading its frames (cross-origin). Download the video first.',
+	'lastFrame.errNoPicture': 'This file has no video picture.',
+	'lastFrame.errUnseekable':
+		'Cannot reach the end of the video (unknown length, or the source does not allow seeking); no frame exported.',
+	'lastFrame.errBlack': 'The last second of the video is black; no frame exported.',
+	'lastFrame.errEmpty': 'The browser could not decode the ending. Retry, or use desktop Chrome / Edge.',
+	'lastFrame.errUnknown': 'Exporting the last frame failed: {msg}',
 
 	// --- Artifact / canvas nodes ---
 	'artifact.artifactLabel': 'Artifact',
@@ -949,6 +968,8 @@ export const en = {
 	'library.selectAll': 'Select all',
 	'library.deselectAll': 'Deselect all',
 	'library.itemCount': '{count} item(s)',
+	'library.loadError': 'Failed to load the library',
+	'library.subtitle': 'Generated assets in one place — preview, filter and remove images and videos not tied to a project',
 	'library.deleteSelected': 'Delete ({count})',
 	'library.addToProject': 'Add to Project',
 	'library.filterLabel': 'Filter by kind',
@@ -1262,6 +1283,7 @@ export const en = {
 	'shell.navAgents': 'Agents',
 	'shell.navConnections': 'ComfyUI Connections',
 	'shell.navModels': 'Models',
+	'shell.navLibrary': 'Asset Library',
 	'shell.navSettings': 'Settings',
 	'shell.comfy_ok': '{name} connected',
 	'shell.comfy_fail': '{name} unreachable',
@@ -1535,6 +1557,7 @@ export const en = {
 	'studio.slotMask': 'Mask',
 	'studio.slotFirst': 'First frame',
 	'studio.slotLast': 'Last frame',
+	'studio.slotOptional': 'Optional',
 	'studio.slotRefVideo': 'Reference video',
 	'studio.slotAudio': 'Reference audio',
 	'studio.slotPick': 'Click or drop a file',
@@ -1878,7 +1901,7 @@ export const en = {
 	'home.stageProgress': 'Five-stage progress',
 	'tasks.sourceWorkbench': 'Creation flow',
 	'jobst.idSuffix': ' · ComfyUI prompt ID {id}',
-	'jobst.done': 'Done',
+	'jobst.done': 'Fixed',
 	'jobst.doneDetail': 'ComfyUI finished and the results are saved',
 	'jobst.dryRun': 'Placeholder',
 	'jobst.dryRunDetail': 'Placeholder only: Dry-run is on, ComfyUI was not called',
@@ -2057,6 +2080,22 @@ export const en = {
 	'desk.wfUntested': 'Not tested',
 	'desk.workflow': 'Workflow',
 	'desk.yesterday': 'Yesterday',
+	'wfd.stepParse': 'Parse JSON',
+	'wfd.stepNodes': 'Identify nodes',
+	'wfd.stepModels': 'Verify models',
+	'wfd.stepSlots': 'Build input slots',
+	'wfd.noOutput': 'The workflow has no output node — cannot import',
+	'wfd.nodesAutoOk': 'Usage auto-detected: {usage}',
+	'wfd.nodesUserOk': 'Usage confirmed: {usage}',
+	'wfd.modelsOk': '"{name}" has all required nodes and models',
+	'wfd.slotsOk': '{n} input slot(s) built ({m} media)',
+	'wfd.checksAria': 'Import check results',
+	'wfd.showDetails': 'Show error details',
+	'wfd.hideDetails': 'Hide error details',
+	'wfd.unreachableSuggest': 'Being unverifiable does not block saving; re-check after fixing the connection.',
+	'wfd.nodesPickSuggest': 'Pick the usage and finish the output mapping below before saving.',
+	'wfd.showRaw': 'View raw JSON',
+	'wfd.hideRaw': 'Hide raw JSON',
 };
 
 export type Dict = typeof en;

calliope-web/src/lib/i18n/es.ts

@@ -221,6 +221,25 @@ export const es: Dict = {
 	'lightbox.videoPreview': 'Vista previa de vídeo',
 	'lightbox.videoUnavailable': 'Vídeo no disponible',
 	'lightbox.zoom100': '100%',
+	'lastFrame.export': 'Exportar último fotograma',
+	'lastFrame.exporting': 'Exportando último fotograma…',
+	'lastFrame.hint': 'Guarda el último fotograma como PNG a tamaño completo, p. ej. como referencia de primer fotograma',
+	'lastFrame.fileTag': 'ultimo-fotograma',
+	'lastFrame.done': 'Último fotograma exportado {name} ({size})',
+	'lastFrame.errTimeout': 'El vídeo tardó demasiado en cargar. Inténtalo más tarde.',
+	'lastFrame.errNotFound': 'El archivo de vídeo no existe o fue eliminado.',
+	'lastFrame.errForbidden': 'No tienes permiso para leer este vídeo.',
+	'lastFrame.errNetwork': 'No se pudo leer el vídeo (error de red).',
+	'lastFrame.errDecode': 'El vídeo está dañado; su final no se puede decodificar.',
+	'lastFrame.errUnsupported': 'Este navegador no admite el formato del vídeo o el archivo está dañado.',
+	'lastFrame.errCrossOrigin':
+		'El vídeo procede de otro sitio que no permite leer sus fotogramas (origen cruzado). Descarga primero el vídeo.',
+	'lastFrame.errNoPicture': 'Este archivo no tiene imagen de vídeo.',
+	'lastFrame.errUnseekable':
+		'No se puede llegar al final del vídeo (duración desconocida o el origen no permite buscar); no se exportó nada.',
+	'lastFrame.errBlack': 'El último segundo del vídeo es negro; no se exportó ningún fotograma.',
+	'lastFrame.errEmpty': 'El navegador no pudo decodificar el final. Reintenta o usa Chrome / Edge de escritorio.',
+	'lastFrame.errUnknown': 'Error al exportar el último fotograma: {msg}',
 
 	// --- Artifact / canvas nodes ---
 	'artifact.artifactLabel': 'Artefacto',
@@ -949,6 +968,8 @@ export const es: Dict = {
 	'library.selectAll': 'Seleccionar todo',
 	'library.deselectAll': 'Deseleccionar todo',
 	'library.itemCount': '{count} elemento(s)',
+	'library.loadError': 'No se pudo cargar la biblioteca',
+	'library.subtitle': 'Recursos generados en un solo lugar: previsualiza, filtra y elimina imágenes y vídeos sin proyecto',
 	'library.deleteSelected': 'Eliminar ({count})',
 	'library.addToProject': 'Añadir al proyecto',
 	'library.filterLabel': 'Filtrar por tipo',
@@ -1260,6 +1281,7 @@ export const es: Dict = {
 	'shell.navAgents': 'Agentes',
 	'shell.navConnections': 'Conexiones ComfyUI',
 	'shell.navModels': 'Modelos',
+	'shell.navLibrary': 'Biblioteca de assets',
 	'shell.navSettings': 'Ajustes',
 	'shell.comfy_ok': '{name} conectado',
 	'shell.comfy_fail': '{name} sin conexión',
@@ -1536,6 +1558,7 @@ export const es: Dict = {
 	'studio.slotMask': 'Máscara',
 	'studio.slotFirst': 'Primer fotograma',
 	'studio.slotLast': 'Último fotograma',
+	'studio.slotOptional': 'Opcional',
 	'studio.slotRefVideo': 'Vídeo de referencia',
 	'studio.slotAudio': 'Audio de referencia',
 	'studio.slotPick': 'Haz clic o arrastra',
@@ -1879,7 +1902,7 @@ export const es: Dict = {
 	'home.stageProgress': 'Progreso de cinco etapas',
 	'tasks.sourceWorkbench': 'Flujo de creación',
 	'jobst.idSuffix': ' · ID de prompt de ComfyUI {id}',
-	'jobst.done': 'Listo',
+	'jobst.done': 'Fijado',
 	'jobst.doneDetail': 'ComfyUI terminó y los resultados se guardaron',
 	'jobst.dryRun': 'Marcador',
 	'jobst.dryRunDetail': 'Solo marcador: Dry-run activo, no se llamó a ComfyUI',
@@ -2058,4 +2081,20 @@ export const es: Dict = {
 	'desk.wfUntested': 'Sin probar',
 	'desk.workflow': 'Flujo',
 	'desk.yesterday': 'Ayer',
+	'wfd.stepParse': 'Analizar JSON',
+	'wfd.stepNodes': 'Identificar nodos',
+	'wfd.stepModels': 'Verificar modelos',
+	'wfd.stepSlots': 'Crear slots de entrada',
+	'wfd.noOutput': 'El flujo no tiene nodos de salida; no se puede importar',
+	'wfd.nodesAutoOk': 'Uso detectado automáticamente: {usage}',
+	'wfd.nodesUserOk': 'Uso confirmado: {usage}',
+	'wfd.modelsOk': '«{name}» tiene todos los nodos y modelos necesarios',
+	'wfd.slotsOk': '{n} slot(s) de entrada creados ({m} de medios)',
+	'wfd.checksAria': 'Resultados de la comprobación de importación',
+	'wfd.showDetails': 'Mostrar detalles del error',
+	'wfd.hideDetails': 'Ocultar detalles del error',
+	'wfd.unreachableSuggest': 'No poder verificar no impide guardar; vuelve a comprobar tras arreglar la conexión.',
+	'wfd.nodesPickSuggest': 'Elige el uso y completa el mapeo de salida abajo antes de guardar.',
+	'wfd.showRaw': 'Ver JSON original',
+	'wfd.hideRaw': 'Ocultar JSON original',
 };

calliope-web/src/lib/i18n/fr.ts

@@ -221,6 +221,25 @@ export const fr: Dict = {
 	'lightbox.videoPreview': 'Aperçu de la vidéo',
 	'lightbox.videoUnavailable': 'Vidéo indisponible',
 	'lightbox.zoom100': '100 %',
+	'lastFrame.export': 'Exporter la dernière image',
+	'lastFrame.exporting': 'Export de la dernière image…',
+	'lastFrame.hint': 'Enregistre la dernière image en PNG pleine taille, p. ex. comme référence de première image',
+	'lastFrame.fileTag': 'derniere-image',
+	'lastFrame.done': 'Dernière image exportée {name} ({size})',
+	'lastFrame.errTimeout': 'Le chargement de la vidéo a expiré. Réessayez plus tard.',
+	'lastFrame.errNotFound': 'Le fichier vidéo est introuvable ou a été supprimé.',
+	'lastFrame.errForbidden': "Vous n'avez pas l'autorisation de lire cette vidéo.",
+	'lastFrame.errNetwork': 'Lecture de la vidéo impossible (erreur réseau).',
+	'lastFrame.errDecode': 'La vidéo est endommagée ; sa fin ne peut pas être décodée.',
+	'lastFrame.errUnsupported': 'Ce navigateur ne prend pas en charge ce format vidéo, ou le fichier est endommagé.',
+	'lastFrame.errCrossOrigin':
+		"La vidéo provient d'un autre site qui bloque la lecture des images (cross-origin). Téléchargez d'abord la vidéo.",
+	'lastFrame.errNoPicture': "Ce fichier ne contient pas d'image vidéo.",
+	'lastFrame.errUnseekable':
+		"Impossible d'atteindre la fin de la vidéo (durée inconnue ou source sans recherche) ; aucune image exportée.",
+	'lastFrame.errBlack': 'La dernière seconde de la vidéo est noire ; aucune image exportée.',
+	'lastFrame.errEmpty': "Le navigateur n'a pas pu décoder la fin. Réessayez ou utilisez Chrome / Edge sur ordinateur.",
+	'lastFrame.errUnknown': "Échec de l'export de la dernière image : {msg}",
 
 	// --- Artifact / canvas nodes ---
 	'artifact.artifactLabel': 'Artefact',
@@ -949,6 +968,8 @@ export const fr: Dict = {
 	'library.selectAll': 'Tout sélectionner',
 	'library.deselectAll': 'Tout désélectionner',
 	'library.itemCount': '{count} élément(s)',
+	'library.loadError': 'Échec du chargement de la bibliothèque',
+	'library.subtitle': 'Les ressources générées au même endroit : prévisualisez, filtrez et supprimez les images et vidéos sans projet',
 	'library.deleteSelected': 'Supprimer ({count})',
 	'library.addToProject': 'Ajouter au projet',
 	'library.filterLabel': 'Filtrer par type',
@@ -1260,6 +1281,7 @@ export const fr: Dict = {
 	'shell.navAgents': 'Agents',
 	'shell.navConnections': 'Connexions ComfyUI',
 	'shell.navModels': 'Modèles',
+	'shell.navLibrary': 'Bibliothèque d’assets',
 	'shell.navSettings': 'Réglages',
 	'shell.comfy_ok': '{name} connecté',
 	'shell.comfy_fail': '{name} injoignable',
@@ -1536,6 +1558,7 @@ export const fr: Dict = {
 	'studio.slotMask': 'Masque',
 	'studio.slotFirst': 'Premier cadre',
 	'studio.slotLast': 'Dernier cadre',
+	'studio.slotOptional': 'Facultatif',
 	'studio.slotRefVideo': 'Vidéo de référence',
 	'studio.slotAudio': 'Audio de référence',
 	'studio.slotPick': 'Cliquez ou déposez',
@@ -1879,7 +1902,7 @@ export const fr: Dict = {
 	'home.stageProgress': 'Progression en cinq étapes',
 	'tasks.sourceWorkbench': 'Flux de création',
 	'jobst.idSuffix': ' · ID de prompt ComfyUI {id}',
-	'jobst.done': 'Terminé',
+	'jobst.done': 'Fixé',
 	'jobst.doneDetail': 'ComfyUI a terminé, résultats enregistrés',
 	'jobst.dryRun': 'Substitut',
 	'jobst.dryRunDetail': 'Substitut uniquement : Dry-run actif, ComfyUI n\'a pas été appelé',
@@ -2058,4 +2081,20 @@ export const fr: Dict = {
 	'desk.wfUntested': 'Non testé',
 	'desk.workflow': 'Workflow',
 	'desk.yesterday': 'Hier',
+	'wfd.stepParse': 'Analyser le JSON',
+	'wfd.stepNodes': 'Identifier les nœuds',
+	'wfd.stepModels': 'Vérifier les modèles',
+	'wfd.stepSlots': 'Créer les slots d’entrée',
+	'wfd.noOutput': "Le flux n'a aucun nœud de sortie — import impossible",
+	'wfd.nodesAutoOk': 'Usage détecté automatiquement : {usage}',
+	'wfd.nodesUserOk': 'Usage confirmé : {usage}',
+	'wfd.modelsOk': '« {name} » possède tous les nœuds et modèles requis',
+	'wfd.slotsOk': "{n} slot(s) d'entrée créés ({m} média)",
+	'wfd.checksAria': "Résultats de la vérification d'import",
+	'wfd.showDetails': "Afficher les détails de l'erreur",
+	'wfd.hideDetails': "Masquer les détails de l'erreur",
+	'wfd.unreachableSuggest': "L'impossibilité de vérifier n'empêche pas l'enregistrement ; revérifiez après avoir réparé la connexion.",
+	'wfd.nodesPickSuggest': "Choisissez l'usage et terminez le mappage des sorties ci-dessous avant d'enregistrer.",
+	'wfd.showRaw': 'Voir le JSON brut',
+	'wfd.hideRaw': 'Masquer le JSON brut',
 };

calliope-web/src/lib/i18n/ja.ts

@@ -221,6 +221,23 @@ export const ja: Dict = {
 	'lightbox.videoPreview': 'ビデオプレビュー',
 	'lightbox.videoUnavailable': 'ビデオを再生できません',
 	'lightbox.zoom100': '100%',
+	'lastFrame.export': '最終フレームを書き出す',
+	'lastFrame.exporting': '最終フレームを書き出し中…',
+	'lastFrame.hint': '動画の最後のフレームを元のサイズの PNG で保存します（先頭フレーム参照用）',
+	'lastFrame.fileTag': '最終フレーム',
+	'lastFrame.done': '最終フレームを書き出しました {name}（{size}）',
+	'lastFrame.errTimeout': '動画の読み込みがタイムアウトしました。後でもう一度お試しください。',
+	'lastFrame.errNotFound': '動画ファイルが存在しないか削除されています。',
+	'lastFrame.errForbidden': 'この動画へのアクセス権限がありません。',
+	'lastFrame.errNetwork': '動画の読み込みに失敗しました（ネットワークエラー）。',
+	'lastFrame.errDecode': '動画が破損しており、末尾をデコードできません。',
+	'lastFrame.errUnsupported': 'このブラウザーは動画形式に対応していないか、ファイルが破損しています。',
+	'lastFrame.errCrossOrigin': '他サイトの動画のためフレームを読み取れません（クロスオリジン制限）。先に動画をダウンロードしてください。',
+	'lastFrame.errNoPicture': 'このファイルには映像がありません。',
+	'lastFrame.errUnseekable': '動画の末尾に移動できません（長さ不明、またはシーク非対応）。書き出しませんでした。',
+	'lastFrame.errBlack': '動画の最後の 1 秒が黒画面のため、書き出しませんでした。',
+	'lastFrame.errEmpty': '末尾をデコードできませんでした。再試行するか、PC の Chrome / Edge をお使いください。',
+	'lastFrame.errUnknown': '最終フレームの書き出しに失敗しました：{msg}',
 
 	// --- Artifact / canvas nodes ---
 	'artifact.artifactLabel': '成果物',
@@ -949,6 +966,8 @@ export const ja: Dict = {
 	'library.selectAll': 'すべて選択',
 	'library.deselectAll': '選択を解除',
 	'library.itemCount': '{count} 件',
+	'library.loadError': 'ライブラリの読み込みに失敗しました',
+	'library.subtitle': '生成素材を一元管理——プロジェクトに紐付いていない画像・動画をプレビュー・絞り込み・削除できます',
 	'library.deleteSelected': '削除（{count}）',
 	'library.addToProject': 'プロジェクトに追加',
 	'library.filterLabel': '種類で絞り込み',
@@ -1260,6 +1279,7 @@ export const ja: Dict = {
 	'shell.navAgents': 'エージェント',
 	'shell.navConnections': 'ComfyUI 接続',
 	'shell.navModels': 'モデル設定',
+	'shell.navLibrary': 'アセットライブラリ',
 	'shell.navSettings': '設定',
 	'shell.comfy_ok': '{name} 接続済み',
 	'shell.comfy_fail': '{name} 接続失敗',
@@ -1536,6 +1556,7 @@ export const ja: Dict = {
 	'studio.slotMask': 'マスク',
 	'studio.slotFirst': '始端フレーム',
 	'studio.slotLast': '終端フレーム',
+	'studio.slotOptional': '任意',
 	'studio.slotRefVideo': '参照動画',
 	'studio.slotAudio': '参照音声',
 	'studio.slotPick': 'クリックまたはドロップ',
@@ -1879,7 +1900,7 @@ export const ja: Dict = {
 	'home.stageProgress': '五段階の進捗',
 	'tasks.sourceWorkbench': '制作フロー',
 	'jobst.idSuffix': ' · ComfyUI プロンプト ID {id}',
-	'jobst.done': '完了',
+	'jobst.done': '定着',
 	'jobst.doneDetail': 'ComfyUI の実行が完了し、結果を保存しました',
 	'jobst.dryRun': 'プレースホルダー',
 	'jobst.dryRunDetail': 'プレースホルダーのみ：Dry-run が有効で ComfyUI は呼び出されていません',
@@ -2058,4 +2079,20 @@ export const ja: Dict = {
 	'desk.wfUntested': '未テスト',
 	'desk.workflow': 'ワークフロー',
 	'desk.yesterday': '昨日',
+	'wfd.stepParse': 'JSON を解析',
+	'wfd.stepNodes': 'ノードを識別',
+	'wfd.stepModels': 'モデルを確認',
+	'wfd.stepSlots': '入力スロットを構築',
+	'wfd.noOutput': '出力ノードがないためインポートできません',
+	'wfd.nodesAutoOk': '用途を自動判定：{usage}',
+	'wfd.nodesUserOk': '用途を確認済み：{usage}',
+	'wfd.modelsOk': '「{name}」に必要なノードとモデルが揃っています',
+	'wfd.slotsOk': '入力スロット {n} 件を構築（うちメディア {m} 件）',
+	'wfd.checksAria': 'インポート検査結果',
+	'wfd.showDetails': 'エラー詳細を展開',
+	'wfd.hideDetails': 'エラー詳細を折りたたむ',
+	'wfd.unreachableSuggest': '検査できなくても保存は可能です。接続を直して「再チェック」してください。',
+	'wfd.nodesPickSuggest': '保存前に下で用途を選び、出力マッピングを完了してください。',
+	'wfd.showRaw': '元の JSON を見る',
+	'wfd.hideRaw': '元の JSON を閉じる',
 };

calliope-web/src/lib/i18n/ko.ts

@@ -221,6 +221,23 @@ export const ko: Dict = {
 	'lightbox.videoPreview': '영상 미리보기',
 	'lightbox.videoUnavailable': '영상을 표시할 수 없습니다',
 	'lightbox.zoom100': '100%',
+	'lastFrame.export': '마지막 프레임 내보내기',
+	'lastFrame.exporting': '마지막 프레임 내보내는 중…',
+	'lastFrame.hint': '영상의 마지막 프레임을 원본 크기 PNG로 저장합니다(첫 프레임 참조용)',
+	'lastFrame.fileTag': '마지막프레임',
+	'lastFrame.done': '마지막 프레임을 내보냈습니다 {name} ({size})',
+	'lastFrame.errTimeout': '영상 로딩 시간이 초과되었습니다. 잠시 후 다시 시도하세요.',
+	'lastFrame.errNotFound': '영상 파일이 없거나 삭제되었습니다.',
+	'lastFrame.errForbidden': '이 영상에 접근할 권한이 없습니다.',
+	'lastFrame.errNetwork': '영상을 읽지 못했습니다(네트워크 오류).',
+	'lastFrame.errDecode': '영상이 손상되어 끝부분을 디코딩할 수 없습니다.',
+	'lastFrame.errUnsupported': '이 브라우저가 영상 형식을 지원하지 않거나 파일이 손상되었습니다.',
+	'lastFrame.errCrossOrigin': '다른 사이트의 영상이라 프레임을 읽을 수 없습니다(교차 출처 제한). 먼저 영상을 다운로드하세요.',
+	'lastFrame.errNoPicture': '이 파일에는 영상 화면이 없습니다.',
+	'lastFrame.errUnseekable': '영상 끝으로 이동할 수 없습니다(길이 불명 또는 탐색 미지원). 내보내지 않았습니다.',
+	'lastFrame.errBlack': '영상의 마지막 1초가 검은 화면이라 내보내지 않았습니다.',
+	'lastFrame.errEmpty': '끝부분을 디코딩하지 못했습니다. 다시 시도하거나 PC Chrome / Edge를 사용하세요.',
+	'lastFrame.errUnknown': '마지막 프레임 내보내기 실패: {msg}',
 
 	// --- Artifact / canvas nodes ---
 	'artifact.artifactLabel': '아티팩트',
@@ -949,6 +966,8 @@ export const ko: Dict = {
 	'library.selectAll': '모두 선택',
 	'library.deselectAll': '선택 해제',
 	'library.itemCount': '{count}개 항목',
+	'library.loadError': '라이브러리를 불러오지 못했습니다',
+	'library.subtitle': '생성 자산을 한곳에서 관리——프로젝트에 연결되지 않은 이미지와 동영상을 미리보기·필터·삭제',
 	'library.deleteSelected': '삭제 ({count})',
 	'library.addToProject': '프로젝트에 추가',
 	'library.filterLabel': '종류로 필터',
@@ -1260,6 +1279,7 @@ export const ko: Dict = {
 	'shell.navAgents': '에이전트',
 	'shell.navConnections': 'ComfyUI 연결',
 	'shell.navModels': '모델 설정',
+	'shell.navLibrary': '애셋 라이브러리',
 	'shell.navSettings': '설정',
 	'shell.comfy_ok': '{name} 연결됨',
 	'shell.comfy_fail': '{name} 연결 실패',
@@ -1536,6 +1556,7 @@ export const ko: Dict = {
 	'studio.slotMask': '마스크',
 	'studio.slotFirst': '첫 프레임',
 	'studio.slotLast': '마지막 프레임',
+	'studio.slotOptional': '선택',
 	'studio.slotRefVideo': '참조 비디오',
 	'studio.slotAudio': '참조 오디오',
 	'studio.slotPick': '클릭하거나 끌어다 놓기',
@@ -1879,7 +1900,7 @@ export const ko: Dict = {
 	'home.stageProgress': '5단계 진행',
 	'tasks.sourceWorkbench': '제작 흐름',
 	'jobst.idSuffix': ' · ComfyUI 프롬프트 ID {id}',
-	'jobst.done': '완료',
+	'jobst.done': '정착',
 	'jobst.doneDetail': 'ComfyUI 실행이 끝나 결과를 저장했습니다',
 	'jobst.dryRun': '자리표시자',
 	'jobst.dryRunDetail': '자리표시자만: Dry-run이 켜져 있어 ComfyUI를 호출하지 않았습니다',
@@ -2058,4 +2079,20 @@ export const ko: Dict = {
 	'desk.wfUntested': '테스트 안 함',
 	'desk.workflow': '워크플로',
 	'desk.yesterday': '어제',
+	'wfd.stepParse': 'JSON 파싱',
+	'wfd.stepNodes': '노드 식별',
+	'wfd.stepModels': '모델 확인',
+	'wfd.stepSlots': '입력 슬롯 구성',
+	'wfd.noOutput': '출력 노드가 없어 가져올 수 없습니다',
+	'wfd.nodesAutoOk': '용도 자동 판정: {usage}',
+	'wfd.nodesUserOk': '용도 확인됨: {usage}',
+	'wfd.modelsOk': "'{name}'에 필요한 노드와 모델이 모두 있습니다",
+	'wfd.slotsOk': '입력 슬롯 {n}개 구성(미디어 {m}개)',
+	'wfd.checksAria': '가져오기 검사 결과',
+	'wfd.showDetails': '오류 자세히 보기',
+	'wfd.hideDetails': '오류 자세히 접기',
+	'wfd.unreachableSuggest': '확인 실패는 저장을 막지 않습니다. 연결을 고친 뒤 다시 검사하세요.',
+	'wfd.nodesPickSuggest': '저장하기 전에 아래에서 용도를 선택하고 출력 매핑을 완료하세요.',
+	'wfd.showRaw': '원본 JSON 보기',
+	'wfd.hideRaw': '원본 JSON 접기',
 };

calliope-web/src/lib/i18n/zh.ts

@@ -221,6 +221,23 @@ export const zh: Dict = {
 	'lightbox.videoPreview': '视频预览',
 	'lightbox.videoUnavailable': '视频不可用',
 	'lightbox.zoom100': '100%',
+	'lastFrame.export': '导出尾帧',
+	'lastFrame.exporting': '正在导出尾帧…',
+	'lastFrame.hint': '把视频最后一帧按原尺寸保存为 PNG，可作首帧参考',
+	'lastFrame.fileTag': '尾帧',
+	'lastFrame.done': '已导出尾帧 {name}（{size}）',
+	'lastFrame.errTimeout': '视频加载超时，未能导出尾帧，请稍后重试',
+	'lastFrame.errNotFound': '视频文件不存在或已被移除，无法导出尾帧',
+	'lastFrame.errForbidden': '没有访问该视频的权限，无法导出尾帧',
+	'lastFrame.errNetwork': '视频读取失败（网络中断），请检查连接后重试',
+	'lastFrame.errDecode': '视频文件已损坏，片尾画面无法解码',
+	'lastFrame.errUnsupported': '当前浏览器不支持该视频格式，或文件已损坏，无法导出尾帧',
+	'lastFrame.errCrossOrigin': '该视频来自其他站点，浏览器禁止读取画面（跨域限制），请先下载原视频',
+	'lastFrame.errNoPicture': '该文件没有视频画面，无法导出尾帧',
+	'lastFrame.errUnseekable': '无法定位到视频结尾（时长未知或来源不支持拖动进度），未导出尾帧',
+	'lastFrame.errBlack': '视频结尾 1 秒内都是黑屏，未导出尾帧',
+	'lastFrame.errEmpty': '浏览器未能解码出片尾画面，请重试或换用电脑端 Chrome / Edge',
+	'lastFrame.errUnknown': '导出尾帧失败：{msg}',
 
 	// --- Artifact / canvas nodes ---
 	'artifact.artifactLabel': '产物',
@@ -949,6 +966,8 @@ export const zh: Dict = {
 	'library.selectAll': '全选',
 	'library.deselectAll': '取消全选',
 	'library.itemCount': '{count} 个项目',
+	'library.loadError': '素材库加载失败',
+	'library.subtitle': '生成素材集中在这里——未关联项目的图片和视频可预览、筛选和删除',
 	'library.deleteSelected': '删除（{count}）',
 	'library.addToProject': '添加到项目',
 	'library.filterLabel': '按类型筛选',
@@ -1262,6 +1281,7 @@ export const zh: Dict = {
 	'shell.navAgents': '智能体',
 	'shell.navConnections': 'ComfyUI 连接',
 	'shell.navModels': '模型设置',
+	'shell.navLibrary': '素材库',
 	'shell.navSettings': '设置',
 	'shell.comfy_ok': '{name} 已连接',
 	'shell.comfy_fail': '{name} 连接失败',
@@ -1535,6 +1555,7 @@ export const zh: Dict = {
 	'studio.slotMask': '遮罩',
 	'studio.slotFirst': '首帧',
 	'studio.slotLast': '尾帧',
+	'studio.slotOptional': '可选',
 	'studio.slotRefVideo': '参考视频',
 	'studio.slotAudio': '参考音频',
 	'studio.slotPick': '点击或拖入',
@@ -1879,8 +1900,8 @@ export const zh: Dict = {
 	'home.stageProgress': '五段进度',
 	'tasks.sourceWorkbench': '创作流程',
 	'jobst.idSuffix': ' · ComfyUI 任务 ID {id}',
-	'jobst.done': '完成',
-	'jobst.doneDetail': 'ComfyUI 已执行完成，结果已保存',
+	'jobst.done': '定影',
+	'jobst.doneDetail': '生成完成，结果已定影保存',
 	'jobst.dryRun': '占位结果',
 	'jobst.dryRunDetail': '占位结果：当前开启了 Dry-run，没有调用 ComfyUI，不是真实生成',
 	'jobst.noOutput': '无产出',
@@ -2058,4 +2079,20 @@ export const zh: Dict = {
 	'desk.wfUntested': '未试运行',
 	'desk.workflow': '工作流',
 	'desk.yesterday': '昨天',
+	'wfd.stepParse': '解析 JSON',
+	'wfd.stepNodes': '识别节点',
+	'wfd.stepModels': '核对模型',
+	'wfd.stepSlots': '建立输入槽',
+	'wfd.noOutput': '工作流没有任何输出节点，无法导入',
+	'wfd.nodesAutoOk': '自动判定用途：{usage}',
+	'wfd.nodesUserOk': '用途已确认：{usage}',
+	'wfd.modelsOk': '「{name}」已装齐所需节点与模型',
+	'wfd.slotsOk': '已建立 {n} 个输入槽（含 {m} 个媒体槽）',
+	'wfd.checksAria': '导入检查结果',
+	'wfd.showDetails': '展开错误详情',
+	'wfd.hideDetails': '收起错误详情',
+	'wfd.unreachableSuggest': '无法核查不会阻止保存；修好连接后点「重新检查」复查。',
+	'wfd.nodesPickSuggest': '请在下方选择用途并完成输出映射后再保存。',
+	'wfd.showRaw': '查看原始 JSON',
+	'wfd.hideRaw': '收起原始 JSON',
 };

calliope-web/src/lib/media/exportFrame.ts

@@ -0,0 +1,343 @@
+/**
+ * 导出尾帧 (HEL-669): decode a frame just before the end of a video in the
+ * browser and save it as a PNG at the video's native resolution.
+ *
+ * Frames are taken from a hidden, muted <video> of the same URL so the
+ * player the user is watching never jumps. Media is served same-origin by
+ * /api/file, so the canvas stays untainted.
+ *
+ * The pure helpers at the top touch no DOM and import nothing, so
+ * scripts/check-export-frame.mjs can run them under plain Node.
+ */
+
+export type FrameErrorCode =
+  | "timeout"
+  | "not-found"
+  | "forbidden"
+  | "network"
+  | "decode"
+  | "unsupported"
+  | "cross-origin"
+  | "no-picture"
+  | "unseekable"
+  | "black"
+  | "empty";
+
+export class FrameExportError extends Error {
+  code: FrameErrorCode;
+
+  constructor(code: FrameErrorCode, detail?: string) {
+    super(detail ? `${code}: ${detail}` : code);
+    this.name = "FrameExportError";
+    this.code = code;
+  }
+}
+
+/**
+ * Seconds before the end to try, nearest first. The exact end is often not
+ * decodable, so the first try is ~1 frame back; later tries step past a
+ * black fade-out tail.
+ */
+export const TAIL_OFFSETS = [0.05, 0.12, 0.25, 0.5, 1];
+
+export function tailSeekTimes(duration: number): number[] {
+  if (!Number.isFinite(duration) || duration <= 0) return [0];
+  const times: number[] = [];
+  for (const off of TAIL_OFFSETS) {
+    const t = Math.max(0, Math.round((duration - off) * 1000) / 1000);
+    if (!times.includes(t)) times.push(t);
+  }
+  return times;
+}
+
+/** File name of the video behind a media URL (`/api/file?path=…` or plain). */
+export function videoBaseName(src: string): string {
+  let name = "";
+  try {
+    const url = new URL(src, "http://local.invalid/");
+    const path =
+      url.searchParams.get("path") ?? decodeURIComponent(url.pathname);
+    name = path.split(/[\\/]/).pop() ?? "";
+  } catch {
+    name = "";
+  }
+  name = name.replace(/\.[a-z0-9]{1,5}$/i, "");
+  name = name.replace(/[\\/:*?"<>|\u0000-\u001f]+/g, "_").trim();
+  return name || "video";
+}
+
+/** `{视频名}_{tag}_{秒}s.png` — names the source video and the frame time. */
+export function frameFileName(
+  src: string,
+  seconds: number,
+  tag: string,
+): string {
+  const safeTag = tag.replace(/[\\/:*?"<>|\s]+/g, "-");
+  return `${videoBaseName(src)}_${safeTag}_${seconds.toFixed(3)}s.png`;
+}
+
+/**
+ * Classify sampled RGBA pixels: "empty" when nothing was painted (the
+ * decoder handed back no picture), "black" for an all-dark frame, else null.
+ * A bright highlight anywhere keeps a dark scene from counting as black.
+ */
+export function blankKind(rgba: ArrayLike<number>): "empty" | "black" | null {
+  let opaque = 0;
+  let sum = 0;
+  let max = 0;
+  for (let i = 0; i + 3 < rgba.length; i += 4) {
+    if (rgba[i + 3] < 8) continue;
+    opaque++;
+    const luma = 0.2126 * rgba[i] + 0.7152 * rgba[i + 1] + 0.0722 * rgba[i + 2];
+    sum += luma;
+    if (luma > max) max = luma;
+  }
+  if (opaque === 0) return "empty";
+  // 16 = limited-range video black when a decoder skips range expansion.
+  if (max < 40 && sum / opaque < 20) return "black";
+  return null;
+}
+
+/** HTTP status of a failed media fetch → error code (null = not decisive). */
+export function statusErrorCode(status: number): FrameErrorCode | null {
+  if (status === 404 || status === 410) return "not-found";
+  if (status === 401 || status === 403) return "forbidden";
+  if (status >= 400) return "network";
+  return null;
+}
+
+// ---- browser side -------------------------------------------------------
+
+export interface LastFrame {
+  blob: Blob;
+  width: number;
+  height: number;
+  /** Media time of the exported frame, in seconds. */
+  time: number;
+  fileName: string;
+}
+
+export interface CaptureOptions {
+  /** Word placed in the file name, e.g. 尾帧. */
+  fileTag: string;
+  timeoutMs?: number;
+}
+
+const SAMPLE = 64;
+
+function isCrossOrigin(src: string): boolean {
+  try {
+    const url = new URL(src, location.href);
+    if (url.protocol === "blob:" || url.protocol === "data:") return false;
+    return url.origin !== location.origin;
+  } catch {
+    return false;
+  }
+}
+
+/** Probe the URL so a failed load can say 不存在 / 无权限 / 跨域 precisely. */
+async function classifyLoadFailure(
+  video: HTMLVideoElement,
+  src: string,
+  crossOrigin: boolean,
+): Promise<FrameExportError> {
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), 5000);
+  try {
+    const res = await fetch(src, {
+      headers: { Range: "bytes=0-0" },
+      mode: crossOrigin ? "cors" : "same-origin",
+      signal: ctl.signal,
+    });
+    ctl.abort();
+    const code = statusErrorCode(res.status);
+    if (code) return new FrameExportError(code, `HTTP ${res.status}`);
+  } catch {
+    if (crossOrigin) return new FrameExportError("cross-origin");
+    return new FrameExportError("network");
+  } finally {
+    clearTimeout(timer);
+  }
+  const mediaCode = video.error?.code;
+  if (mediaCode === MediaError.MEDIA_ERR_NETWORK) {
+    return new FrameExportError("network", video.error?.message);
+  }
+  if (mediaCode === MediaError.MEDIA_ERR_DECODE) {
+    return new FrameExportError("decode", video.error?.message);
+  }
+  return new FrameExportError("unsupported", video.error?.message);
+}
+
+export async function captureLastFrame(
+  src: string,
+  { fileTag, timeoutMs = 30000 }: CaptureOptions,
+): Promise<LastFrame> {
+  const crossOrigin = isCrossOrigin(src);
+  const video = document.createElement("video");
+  if (crossOrigin) video.crossOrigin = "anonymous";
+  video.muted = true;
+  video.playsInline = true;
+  video.preload = "auto";
+  video.setAttribute("aria-hidden", "true");
+  // Kept in the DOM (some engines never paint a detached video) but unseen.
+  Object.assign(video.style, {
+    position: "fixed",
+    left: "0",
+    top: "0",
+    width: "1px",
+    height: "1px",
+    opacity: "0",
+    pointerEvents: "none",
+  });
+  document.body.appendChild(video);
+
+  const deadline = Date.now() + timeoutMs;
+
+  /** Resolve on `event`; reject on a media error or the shared deadline. */
+  const until = (event: string) =>
+    new Promise<void>((resolve, reject) => {
+      const done = (fn: () => void) => {
+        clearTimeout(timer);
+        video.removeEventListener(event, onEvent);
+        video.removeEventListener("error", onError);
+        fn();
+      };
+      const onEvent = () => done(resolve);
+      const onError = () =>
+        done(() => {
+          classifyLoadFailure(video, src, crossOrigin).then(reject, reject);
+        });
+      const timer = setTimeout(
+        () => done(() => reject(new FrameExportError("timeout"))),
+        Math.max(0, deadline - Date.now()),
+      );
+      video.addEventListener(event, onEvent);
+      video.addEventListener("error", onError);
+    });
+
+  const seek = async (time: number) => {
+    const settled = until("seeked");
+    video.currentTime = time;
+    await settled;
+  };
+
+  /** Wait until the seeked frame has actually been decoded and presented. */
+  const presented = () =>
+    new Promise<void>((resolve) => {
+      const fallback = setTimeout(resolve, 250);
+      const finish = () => {
+        clearTimeout(fallback);
+        resolve();
+      };
+      if (typeof video.requestVideoFrameCallback === "function") {
+        video.requestVideoFrameCallback(() => finish());
+      } else {
+        requestAnimationFrame(() => requestAnimationFrame(finish));
+      }
+    });
+
+  try {
+    const metadata = until("loadedmetadata");
+    video.src = src;
+    video.load();
+    await metadata;
+
+    if (!video.videoWidth || !video.videoHeight) {
+      throw new FrameExportError("no-picture");
+    }
+
+    // MediaRecorder WebM reports Infinity until the end has been read. When
+    // the server cannot seek either, the end is unreachable — fail rather
+    // than hand back the first frame.
+    let duration = video.duration;
+    if (!Number.isFinite(duration) || duration <= 0) {
+      await seek(1e101);
+      duration = video.duration;
+      if (!Number.isFinite(duration) || duration <= 0) {
+        throw new FrameExportError("unseekable", "duration unknown");
+      }
+    }
+
+    const width = video.videoWidth;
+    const height = video.videoHeight;
+    const canvas = document.createElement("canvas");
+    canvas.width = width;
+    canvas.height = height;
+    const ctx = canvas.getContext("2d");
+    const sample = document.createElement("canvas");
+    sample.width = SAMPLE;
+    sample.height = SAMPLE;
+    const sampleCtx = sample.getContext("2d", { willReadFrequently: true });
+    if (!ctx || !sampleCtx)
+      throw new FrameExportError("empty", "no 2d context");
+
+    let lastBlank: "empty" | "black" = "empty";
+    for (const time of tailSeekTimes(duration)) {
+      await seek(time);
+      if (video.readyState < HTMLMediaElement.HAVE_CURRENT_DATA) {
+        // iOS Safari only decodes after a play(); muted inline play is allowed.
+        await video.play().catch(() => {});
+        video.pause();
+        await seek(time);
+      }
+      if (Math.abs(video.currentTime - time) > 0.5) {
+        throw new FrameExportError(
+          "unseekable",
+          `asked ${time}s, landed at ${video.currentTime}s`,
+        );
+      }
+      await presented();
+
+      ctx.clearRect(0, 0, width, height);
+      ctx.drawImage(video, 0, 0, width, height);
+      sampleCtx.clearRect(0, 0, SAMPLE, SAMPLE);
+      sampleCtx.drawImage(canvas, 0, 0, SAMPLE, SAMPLE);
+      let pixels: Uint8ClampedArray;
+      try {
+        pixels = sampleCtx.getImageData(0, 0, SAMPLE, SAMPLE).data;
+      } catch (err) {
+        throw new FrameExportError("cross-origin", String(err));
+      }
+      const blank = blankKind(pixels);
+      if (blank) {
+        lastBlank = blank;
+        continue;
+      }
+
+      const blob = await new Promise<Blob | null>((resolve) => {
+        try {
+          canvas.toBlob(resolve, "image/png");
+        } catch {
+          resolve(null);
+        }
+      });
+      if (!blob) throw new FrameExportError("empty", "toBlob returned nothing");
+      const shown = video.currentTime;
+      return {
+        blob,
+        width,
+        height,
+        time: shown,
+        fileName: frameFileName(src, shown, fileTag),
+      };
+    }
+    throw new FrameExportError(lastBlank);
+  } finally {
+    video.removeAttribute("src");
+    video.load();
+    video.remove();
+  }
+}
+
+export function downloadBlob(blob: Blob, fileName: string): void {
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = fileName;
+  a.rel = "noopener";
+  a.style.display = "none";
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+  setTimeout(() => URL.revokeObjectURL(url), 60000);
+}

calliope-web/src/lib/media/lastFrame.ts

@@ -0,0 +1,50 @@
+import { t } from "$lib/i18n.svelte";
+import { toast } from "$lib/toast";
+import {
+  captureLastFrame,
+  downloadBlob,
+  FrameExportError,
+  type FrameErrorCode,
+} from "./exportFrame";
+
+const ERROR_KEYS: Record<FrameErrorCode, string> = {
+  timeout: "lastFrame.errTimeout",
+  "not-found": "lastFrame.errNotFound",
+  forbidden: "lastFrame.errForbidden",
+  network: "lastFrame.errNetwork",
+  decode: "lastFrame.errDecode",
+  unsupported: "lastFrame.errUnsupported",
+  "cross-origin": "lastFrame.errCrossOrigin",
+  "no-picture": "lastFrame.errNoPicture",
+  unseekable: "lastFrame.errUnseekable",
+  black: "lastFrame.errBlack",
+  empty: "lastFrame.errEmpty",
+};
+
+/**
+ * 导出尾帧 for one video URL: capture, download the PNG and report the
+ * outcome as a toast. Never throws. Resolves true when a file was saved.
+ */
+export async function exportLastFrame(src: string): Promise<boolean> {
+  try {
+    const frame = await captureLastFrame(src, {
+      fileTag: t("lastFrame.fileTag"),
+    });
+    downloadBlob(frame.blob, frame.fileName);
+    toast.success(
+      t("lastFrame.done", {
+        name: frame.fileName,
+        size: `${frame.width}×${frame.height}`,
+      }),
+    );
+    return true;
+  } catch (err) {
+    if (err instanceof FrameExportError) {
+      toast.error(t(ERROR_KEYS[err.code]), 6000);
+    } else {
+      const msg = err instanceof Error ? err.message : String(err);
+      toast.error(t("lastFrame.errUnknown", { msg }), 6000);
+    }
+    return false;
+  }
+}

calliope-web/src/lib/shot/components/TimelineStrip.svelte

@@ -305,13 +305,13 @@
 		z-index: 2;
 	}
 	.keyframe.cam {
-		background: #e0b34d;
+		background: var(--accent-lo);
 	}
 	.keyframe.obj {
-		background: #4ade80;
+		background: var(--ok);
 	}
 	.keyframe.obj.selected {
-		background: #f87171;
+		background: var(--accent);
 	}
 	.keyframe:hover {
 		filter: brightness(1.15);

calliope-web/src/routes/+page.svelte

@@ -304,10 +304,10 @@
 
 <AppShell active="projects" title={t('home.title')} subtitle={t('home.subtitle')}>
 	{#snippet actions()}
-		<span class="chip">{t('home.projectCount', { n: allProjects.length, m: inProgressCount })}</span
+		<span class="status-chip">{t('home.projectCount', { n: allProjects.length, m: inProgressCount })}</span
 		>
 		<button
-			class="entry-btn"
+			class="a-btn"
 			class:primary={entryMode === 'none'}
 			class:secondary={entryMode !== 'none'}
 			onclick={openIdea}
@@ -321,22 +321,22 @@
 		<section class="main-col">
 			{#if entryMode === 'none'}
 				<div class="entries">
-					<article class="entry-card">
-						<span class="entry-icon"><Icon name="sparkle" size={18} /></span>
-						<h2>{t('home.entryIdeaTitle')}</h2>
-						<p>{t('home.entryIdeaBody')}</p>
-						<button type="button" class="entry-btn secondary full" onclick={openIdea}>
-							{t('home.startIdea')}
-						</button>
-					</article>
-					<article class="entry-card">
-						<span class="entry-icon"><Icon name="script" size={18} /></span>
-						<h2>{t('home.entryScriptTitle')}</h2>
-						<p>{t('home.entryScriptBody')}</p>
-						<button type="button" class="entry-btn secondary full" onclick={openScript}>
-							{t('home.importScript')}
-						</button>
-					</article>
+				<article class="entry-card">
+					<span class="entry-icon"><Icon name="sparkle" size={18} /></span>
+					<h2>{t('home.entryIdeaTitle')}</h2>
+					<p>{t('home.entryIdeaBody')}</p>
+					<button type="button" class="a-btn secondary full" onclick={openIdea}>
+						{t('home.startIdea')}
+					</button>
+				</article>
+				<article class="entry-card">
+					<span class="entry-icon"><Icon name="script" size={18} /></span>
+					<h2>{t('home.entryScriptTitle')}</h2>
+					<p>{t('home.entryScriptBody')}</p>
+					<button type="button" class="a-btn secondary full" onclick={openScript}>
+						{t('home.importScript')}
+					</button>
+				</article>
 				</div>
 			{:else if entryMode === 'idea'}
 				<form class="entry-form" onsubmit={submitIdea}>
@@ -351,43 +351,43 @@
 							<Icon name="close" size={16} />
 						</button>
 					</div>
-					<label class="f-field">
-						<span class="f-label">{t('projects.titleField')}<em>*</em></span>
+					<label class="field">
+						<span class="field-label">{t('projects.titleField')}<em>*</em></span>
 						<input
-							class="f-input"
+							class="field-input"
 							class:invalid={showErrors && ideaErrors.title}
 							bind:value={ideaForm.title}
 							placeholder={t('projects.titlePlaceholder')}
 						/>
-						{#if showErrors && ideaErrors.title}<span class="f-error">{ideaErrors.title}</span>{/if}
+						{#if showErrors && ideaErrors.title}<span class="field-error">{ideaErrors.title}</span>{/if}
 					</label>
-					<label class="f-field">
-						<span class="f-label">{t('projects.ideaField')}</span>
+					<label class="field">
+						<span class="field-label">{t('projects.ideaField')}</span>
 						<textarea
-							class="f-input textarea"
+							class="field-textarea"
 							bind:value={ideaForm.idea}
 							placeholder={t('home.ideaPlaceholder')}
 							rows={4}
 						></textarea>
-						<span class="f-hint">{t('projects.ideaHint')}</span>
+						<span class="field-hint">{t('projects.ideaHint')}</span>
 					</label>
 					<div class="f-grid">
-						<label class="f-field">
-							<span class="f-label">{t('projects.genre')}</span>
-							<select class="f-input" bind:value={ideaForm.genre}>
+						<label class="field">
+							<span class="field-label">{t('projects.genre')}</span>
+							<select class="field-input" bind:value={ideaForm.genre}>
 								{#each GENRES as v (v)}<option value={v}>{t('genres.' + genreKey(v))}</option
 									>{/each}
 							</select>
 						</label>
-						<label class="f-field">
-							<span class="f-label">{t('projects.tone')}</span>
-							<select class="f-input" bind:value={ideaForm.tone}>
+						<label class="field">
+							<span class="field-label">{t('projects.tone')}</span>
+							<select class="field-input" bind:value={ideaForm.tone}>
 								{#each TONES as v (v)}<option value={v}>{t('tones.' + toneKey(v))}</option>{/each}
 							</select>
 						</label>
-						<label class="f-field">
-							<span class="f-label">{t('projects.duration')}</span>
-							<select class="f-input" bind:value={ideaForm.duration}>
+						<label class="field">
+							<span class="field-label">{t('projects.duration')}</span>
+							<select class="field-input" bind:value={ideaForm.duration}>
 								{#each DURATIONS as v (v)}<option value={v}
 										>{t('durations.' + durationKey(v))}</option
 									>{/each}
@@ -414,29 +414,29 @@
 							<Icon name="close" size={16} />
 						</button>
 					</div>
-					<label class="f-field">
-						<span class="f-label">{t('projects.titleField')}<em>*</em></span>
+					<label class="field">
+						<span class="field-label">{t('projects.titleField')}<em>*</em></span>
 						<input
-							class="f-input"
+							class="field-input"
 							class:invalid={showErrors && scriptErrors.title}
 							bind:value={scriptForm.title}
 							placeholder={t('projects.titlePlaceholder')}
 						/>
-						{#if showErrors && scriptErrors.title}<span class="f-error">{scriptErrors.title}</span
+						{#if showErrors && scriptErrors.title}<span class="field-error">{scriptErrors.title}</span
 							>{/if}
 					</label>
-					<label class="f-field">
-						<span class="f-label">{t('home.scriptField')}<em>*</em></span>
+					<label class="field">
+						<span class="field-label">{t('home.scriptField')}<em>*</em></span>
 						<textarea
-							class="f-input textarea"
+							class="field-textarea"
 							class:invalid={showErrors && scriptErrors.script}
 							bind:value={scriptForm.script}
 							placeholder={t('home.scriptPlaceholder')}
 							rows={9}
 						></textarea>
-						{#if showErrors && scriptErrors.script}<span class="f-error">{scriptErrors.script}</span
+						{#if showErrors && scriptErrors.script}<span class="field-error">{scriptErrors.script}</span
 							>{/if}
-						<span class="f-hint">{t('home.scriptHint')}</span>
+						<span class="field-hint">{t('home.scriptHint')}</span>
 					</label>
 					<div class="form-actions">
 						<Button variant="ghost" onclick={closeEntry}>{t('projects.cancel')}</Button>
@@ -491,12 +491,12 @@
 		</section>
 
 		<aside class="tasks">
-			<div class="tasks-head">
-				<h2>{t('home.tasksTitle')}</h2>
-				<span class="chip" class:run={activeJobCount > 0}>
-					{t('home.activeJobs', { n: activeJobCount })}
-				</span>
-			</div>
+		<div class="tasks-head">
+			<h2>{t('home.tasksTitle')}</h2>
+			<span class="status-chip" class:run-chip={activeJobCount > 0}>
+				{t('home.activeJobs', { n: activeJobCount })}
+			</span>
+		</div>
 
 			{#if $jobsQuery.isLoading}
 				<div class="tasks-loading">{t('common.loading')}…</div>
@@ -513,7 +513,7 @@
 						{@const bar = jobBar(job)}
 						<li class="job-row" class:failed={job.status === 'failed'}>
 							<div class="job-top">
-								<span class="tag {tag.cls}">{tag.label}</span>
+								<span class="a-tag">{tag.label}</span>
 								<span class="job-name" title={jobTitle(job)}>{jobTitle(job)}</span>
 								<span class="job-side">
 									{#if job.status === 'failed' && job.error !== 'cancelled'}
@@ -572,56 +572,7 @@
 	}
 
 	/* ---------------- topbar chip + buttons ---------------- */
-	.chip {
-		padding: 5px 12px;
-		border-radius: 999px;
-		background: var(--surface-3);
-		color: var(--text-2);
-		font-size: 11.5px;
-		white-space: nowrap;
-	}
-	.chip.run {
-		background: var(--run-soft);
-		color: var(--run);
-	}
-
-	.entry-btn {
-		display: inline-flex;
-		align-items: center;
-		justify-content: center;
-		gap: 6px;
-		min-height: 34px;
-		padding: 0 16px;
-		border-radius: 8px;
-		font-family: inherit;
-		font-size: 13px;
-		font-weight: 600;
-		cursor: pointer;
-		border: 1px solid transparent;
-		transition:
-			background-color 150ms cubic-bezier(0.16, 1, 0.3, 1),
-			border-color 150ms,
-			transform 100ms;
-	}
-	.entry-btn.primary {
-		background: var(--accent);
-		color: var(--accent-contrast);
-	}
-	.entry-btn.primary:hover {
-		background: var(--accent-hover);
-	}
-	.entry-btn.secondary {
-		background: var(--surface-2);
-		border-color: var(--border-strong);
-		color: var(--text);
-	}
-	.entry-btn.secondary:hover {
-		border-color: var(--line-2);
-	}
-	.entry-btn:active {
-		transform: scale(0.98);
-	}
-	.entry-btn.full {
+	.a-btn.full {
 		width: 100%;
 		margin-top: auto;
 	}
@@ -630,57 +581,57 @@
 	.entries {
 		display: grid;
 		grid-template-columns: repeat(2, minmax(0, 1fr));
-		gap: 16px;
+		gap: var(--sp-6);
 	}
 	.entry-card {
 		display: flex;
 		flex-direction: column;
-		gap: 8px;
-		background: var(--surface);
-		border: 1px solid var(--border);
-		border-radius: 10px;
-		padding: 18px 20px 20px;
+		gap: var(--sp-3);
+		background: var(--bg-2);
+		border: 1px solid var(--line);
+		border-radius: var(--r-lg);
+		padding: 18px var(--sp-7) var(--sp-7);
 		min-height: 168px;
 	}
 	.entry-icon {
 		width: 38px;
 		height: 38px;
 		border-radius: 9px;
-		background: var(--surface-2);
-		border: 1px solid var(--border-strong);
+		background: var(--bg-3);
+		border: 1px solid var(--line-2);
 		display: inline-flex;
 		align-items: center;
 		justify-content: center;
 		color: var(--text-2);
 	}
 	.entry-card h2 {
-		margin: 4px 0 0;
+		margin: var(--sp-1) 0 0;
 		font-size: 14.5px;
 		font-weight: 600;
 		color: var(--text);
 	}
 	.entry-card p {
 		margin: 0;
-		font-size: 12.5px;
+		font-size: var(--fs-body-sm);
 		line-height: 1.65;
 		color: var(--text-2);
 	}
 
 	.entry-form {
-		background: var(--surface);
-		border: 1px solid var(--border);
-		border-radius: 10px;
-		padding: 18px 20px 20px;
+		background: var(--bg-2);
+		border: 1px solid var(--line);
+		border-radius: var(--r-lg);
+		padding: 18px var(--sp-7) var(--sp-7);
 	}
 	.form-head {
 		display: flex;
 		align-items: center;
 		justify-content: space-between;
-		margin-bottom: 14px;
+		margin-bottom: var(--sp-5);
 	}
 	.form-head h2 {
 		margin: 0;
-		font-size: 15px;
+		font-size: var(--fs-title);
 		font-weight: 600;
 		color: var(--text);
 	}
@@ -691,89 +642,41 @@
 		width: 28px;
 		height: 28px;
 		border: none;
-		border-radius: 7px;
+		border-radius: var(--r-sm);
 		background: transparent;
 		color: var(--text-3);
 		cursor: pointer;
 	}
 	.icon-btn:hover {
-		background: var(--surface-3);
+		background: var(--bg-4);
 		color: var(--text);
 	}
-
-	.f-field {
-		display: block;
-		margin-bottom: 13px;
-	}
-	.f-label {
-		display: flex;
-		align-items: center;
-		gap: 4px;
-		font-size: 12px;
-		font-weight: 600;
-		color: var(--text-2);
-		margin-bottom: 6px;
-	}
-	.f-label em {
-		color: var(--error);
+	.field-label em {
+		color: var(--err);
 		font-style: normal;
 	}
-	.f-input {
-		width: 100%;
-		box-sizing: border-box;
-		background: var(--surface-2);
-		border: 1px solid var(--border-strong);
-		border-radius: 7px;
-		padding: 9px 11px;
-		color: var(--text);
-		font-family: inherit;
-		font-size: 13px;
-	}
-	.f-input.textarea {
-		resize: vertical;
-		min-height: 88px;
-		line-height: 1.6;
-	}
-	.f-input:focus {
-		outline: none;
-		border-color: var(--accent-line);
-	}
-	.f-input.invalid {
-		border-color: var(--err-line);
-	}
-	.f-hint {
-		display: block;
-		margin-top: 5px;
-		font-size: 11px;
-		color: var(--text-3);
-	}
-	.f-error {
-		display: block;
-		margin-top: 5px;
-		font-size: 11.5px;
-		color: var(--error);
-	}
+
 	.f-grid {
 		display: grid;
 		grid-template-columns: repeat(3, 1fr);
-		gap: 12px;
+		gap: var(--sp-5);
 	}
-	.f-grid .f-field {
+	.f-grid .field {
 		margin-bottom: 0;
 	}
 	.form-actions {
 		display: flex;
 		justify-content: flex-end;
-		gap: 8px;
-		margin-top: 16px;
-		padding-top: 12px;
-		border-top: 1px solid var(--border);
+		gap: var(--sp-3);
+		margin-top: var(--sp-6);
+		padding-top: var(--sp-5);
+		border-top: 1px solid var(--line);
 	}
 	/* ---------------- project cards ---------------- */
 	.projects-head {
 		display: flex;
 		align-items: baseline;
-		gap: 12px;
+		gap: var(--sp-5);
 	}
 	.projects-head h2 {
 		margin: 0;
@@ -788,12 +691,12 @@
 	.cards {
 		display: grid;
 		grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
-		gap: 16px;
+		gap: var(--sp-6);
 	}
 	.skel-card {
-		background: var(--surface);
-		border: 1px solid var(--border);
-		border-radius: 10px;
+		background: var(--bg-2);
+		border: 1px solid var(--line);
+		border-radius: var(--r-lg);
 		overflow: hidden;
 	}
 	.skel-card :global(.skeleton) {
@@ -803,77 +706,82 @@
 		display: flex;
 		flex-direction: column;
 		gap: 9px;
-		padding: 14px 16px;
+		padding: var(--sp-5) var(--sp-6);
 	}
 	.panel-empty {
 		display: flex;
 		flex-direction: column;
 		align-items: center;
-		gap: 10px;
-		padding: 36px 20px;
-		border: 1.5px dashed var(--border-strong);
-		border-radius: 10px;
+		gap: var(--sp-4);
+		padding: 36px var(--sp-7);
+		border: 1.5px dashed var(--line-2);
+		border-radius: var(--r-lg);
 		color: var(--text-3);
 		text-align: center;
 	}
 	.panel-empty p {
 		margin: 0;
-		font-size: 12.5px;
+		font-size: var(--fs-body-sm);
 		line-height: 1.65;
 		color: var(--text-2);
 	}
 	.panel-empty.error p {
-		color: var(--error);
+		color: var(--err);
 	}
 
 	/* ---------------- right task area ---------------- */
 	.tasks {
-		background: var(--surface);
-		border: 1px solid var(--border);
-		border-radius: 10px;
-		padding: 16px 18px 14px;
+		background: var(--bg-2);
+		border: 1px solid var(--line);
+		border-radius: var(--r-lg);
+		padding: var(--sp-6) var(--sp-7) var(--sp-5);
 		position: sticky;
 		top: 24px;
 		display: flex;
 		flex-direction: column;
-		gap: 12px;
+		gap: var(--sp-5);
 		min-width: 0;
 	}
 	.tasks-head {
 		display: flex;
 		align-items: center;
 		justify-content: space-between;
-		gap: 10px;
+		gap: var(--sp-4);
 	}
 	.tasks-head h2 {
 		margin: 0;
-		font-size: 14px;
+		font-size: var(--fs-section);
 		font-weight: 600;
 		color: var(--text);
 		white-space: nowrap;
 	}
+	.run-chip {
+		background: var(--run-soft);
+		border-color: color-mix(in srgb, var(--run) 35%, transparent);
+		color: var(--run);
+	}
 	.tasks-loading {
 		color: var(--text-3);
-		font-size: 12px;
-		padding: 12px 0;
+		font-size: var(--fs-aux);
+		padding: var(--sp-4) 0;
 	}
 	.tasks-empty {
 		display: flex;
 		flex-direction: column;
 		align-items: center;
-		gap: 8px;
-		padding: 22px 10px 16px;
+		gap: var(--sp-3);
+		padding: 22px var(--sp-4) var(--sp-6);
 		color: var(--text-3);
 		text-align: center;
 	}
 	.tasks-empty p {
 		margin: 0;
-		font-size: 12px;
+		font-size: var(--fs-aux);
 		line-height: 1.65;
 		color: var(--text-2);
 	}
 	.tasks-empty-sub {
-		font-size: 11px;
+		font-size: var(--fs-mini);
 		color: var(--text-3);
 	}
 
@@ -888,8 +796,8 @@
 		display: flex;
 		flex-direction: column;
 		gap: 7px;
-		padding: 12px 0;
-		border-bottom: 1px solid var(--border);
+		padding: var(--sp-5) 0;
+		border-bottom: 1px solid var(--line);
 	}
 	.job-row:last-child {
 		border-bottom: none;
@@ -897,26 +805,13 @@
 	.job-top {
 		display: flex;
 		align-items: center;
-		gap: 8px;
+		gap: var(--sp-3);
 		min-width: 0;
 	}
-	.tag {
-		padding: 1px 8px;
-		border-radius: 999px;
-		font-size: 10.5px;
-		font-weight: 600;
-		flex-shrink: 0;
-		white-space: nowrap;
-	}
-	.tag-local,
-	.tag-cloud {
-		background: var(--bg-4);
-		color: var(--text-2);
-	}
 	.job-name {
 		flex: 1;
 		min-width: 0;
-		font-size: 12.5px;
+		font-size: var(--fs-body-sm);
 		font-weight: 600;
 		color: var(--text);
 		white-space: nowrap;
@@ -926,7 +821,7 @@
 	.job-side {
 		display: inline-flex;
 		align-items: center;
-		gap: 8px;
+		gap: var(--sp-3);
 		flex-shrink: 0;
 	}
 	.job-meta {
@@ -941,10 +836,10 @@
 		display: inline-flex;
 		align-items: center;
 		gap: 5px;
-		font-size: 11px;
+		font-size: var(--fs-mini);
 	}
 	.done-text {
-		color: var(--success);
+		color: var(--ok);
 	}
 	.running-text {
 		color: var(--run);
@@ -953,7 +848,7 @@
 		color: var(--text-3);
 	}
 	.failed-text {
-		color: var(--error);
+		color: var(--err);
 		max-width: 120px;
 		white-space: nowrap;
 		overflow: hidden;
@@ -978,21 +873,25 @@
 			opacity: 0.35;
 		}
 	}
-		.retry-link {
+	/* 次级文字操作「重试」走 ghost（§1.2）：默认 --text-2，悬停 --text。 */
+	.retry-link {
 		background: none;
 		border: none;
 		padding: 0;
 		font-family: inherit;
-		font-size: 11px;
-		color: var(--error);
+		font-size: var(--fs-mini);
+		color: var(--text-2);
 		cursor: pointer;
 		text-decoration: underline;
 		text-underline-offset: 3px;
 	}
+	.retry-link:hover {
+		color: var(--text);
+	}
 	.tasks-note {
 		margin: 0;
-		padding-top: 10px;
-		border-top: 1px solid var(--border);
+		padding-top: var(--sp-4);
+		border-top: 1px solid var(--line);
 		font-size: 10.5px;
 		line-height: 1.6;
 		color: var(--text-3);
@@ -1002,13 +901,13 @@
 	@media (max-width: 1439px) {
 		.home {
 			grid-template-columns: minmax(0, 1fr) 320px;
-			padding: 20px 22px 36px;
+			padding: var(--sp-6) 22px 36px;
 		}
 	}
-	@media (max-width: 1023px) {
+	@media (max-width: 1179px) {
 		.home {
 			grid-template-columns: minmax(0, 1fr);
-			padding: 16px 16px 32px;
+			padding: var(--sp-5) var(--sp-5) 32px;
 		}
 		.tasks {
 			position: static;
@@ -1020,4 +919,9 @@
 			grid-template-columns: minmax(0, 1fr);
 		}
 	}
+	@media (max-width: 760px) {
+		.home {
+			padding: var(--sp-4) var(--sp-4) var(--sp-8);
+		}
+	}
 </style>

calliope-web/src/routes/agents/+page.svelte

@@ -589,6 +589,11 @@
 	function avatarStyle(n: number): string {
 		return `var(--avatar-${Math.min(Math.max(n, 1), 5)})`;
 	}
+
+	// HEL-680 灰阶头像：1–2 亮阶配深字，3–5 暗阶配浅字，按阶数决定。
+	function avatarLight(n: number | undefined): boolean {
+		return Math.min(Math.max(n ?? 1, 1), 5) <= 2;
+	}
 </script>
 
 {#snippet skillRow(skill: SkillAdminEntry, detail: string)}
@@ -655,7 +660,7 @@
 								class:selected
 								onclick={() => selectAgent(agent.key)}
 							>
-								<span class="avatar" class:dark={agent.avatar_dark} style:background={avatarStyle(agent.avatar)}>
+								<span class="avatar" class:dark={avatarLight(agent.avatar)} style:background={avatarStyle(agent.avatar)}>
 									{agent.char}
 								</span>
 								<span class="agent-meta">
@@ -693,7 +698,7 @@
 				<section class="mid">
 					{#if activeAgent}
 						<header class="chat-head">
-							<span class="avatar lg" class:dark={activeAgent.avatar_dark} style:background={avatarStyle(activeAgent.avatar)}>
+							<span class="avatar lg" class:dark={avatarLight(activeAgent.avatar)} style:background={avatarStyle(activeAgent.avatar)}>
 								{activeAgent.char}
 							</span>
 							<div class="chat-head-meta">
@@ -1185,17 +1190,20 @@
 		padding: 10px 4px;
 		margin: 0;
 	}
+	/* Skill 行（§3.6）：启用 = --run 描边 + 软底；停用 = --text-3 描边。 */
 	.skill-row {
 		display: flex;
 		align-items: center;
 		gap: 8px;
 		padding: 7px 8px;
-		border-radius: 8px;
-		border: 1px solid var(--border);
-		background: var(--surface);
+		border-radius: var(--r-md);
+		border: 1px solid color-mix(in srgb, var(--run) 45%, transparent);
+		background: var(--run-soft);
 	}
 	.skill-row.disabled {
-		opacity: 0.55;
+		border-color: color-mix(in srgb, var(--text-3) 45%, transparent);
+		background: var(--bg-2);
+		opacity: 0.75;
 	}
 	.skill-row-main {
 		display: flex;
@@ -1218,7 +1226,7 @@
 		text-overflow: ellipsis;
 	}
 	.skill-name:hover {
-		color: var(--accent);
+		color: var(--text);
 	}
 	.skill-tags {
 		display: flex;
@@ -1390,13 +1398,15 @@
 		gap: 5px;
 		background: none;
 		border: none;
-		color: var(--accent);
+		color: var(--text-2);
 		font-size: 11.5px;
 		cursor: pointer;
 		padding: 2px 4px;
 	}
 	.link-btn:hover {
+		color: var(--text);
 		text-decoration: underline;
+		text-underline-offset: 3px;
 	}
 
 	.versions {
@@ -1486,7 +1496,7 @@
 		color: var(--text-2);
 	}
 	.f-label em {
-		color: var(--accent);
+		color: var(--err);
 		font-style: normal;
 		margin-left: 2px;
 	}
@@ -1660,7 +1670,7 @@
 			border-radius: 12px 0 0 12px;
 			transform: translateX(calc(100% + 18px));
 			transition: transform 240ms cubic-bezier(0.16, 1, 0.3, 1);
-			box-shadow: -18px 0 48px rgba(0, 0, 0, 0.45);
+			box-shadow: var(--shadow-float);
 		}
 		.right.open {
 			transform: translateX(0);
@@ -1669,7 +1679,7 @@
 			display: block;
 			position: fixed;
 			inset: 0;
-			background: rgba(0, 0, 0, 0.5);
+			background: var(--overlay);
 			z-index: 55;
 		}
 		.session-select {
@@ -1677,7 +1687,7 @@
 		}
 	}
 
-	@media (max-width: 1279px) {
+	@media (max-width: 1179px) {
 		.model-pick .model-label {
 			display: none;
 		}

calliope-web/src/routes/app.css

@@ -4,62 +4,67 @@
 
 :root {
 	/* ------------------------------------------------------------------
-	 * 融合视觉 design tokens — HEL-649 整站施工规范 §一（流水台结构 ×
-	 * 放映厅配色）。Single source of truth for the whole app: pages and
-	 * components reference these variables only — no hardcoded colors,
-	 * no ad-hoc overrides. Gold is for key actions and the current
-	 * selection only; status colors each carry exactly one meaning.
+	 * 无彩灰阶 design tokens — HEL-680 S1（白栖知 theme-1「暗房放大机」
+	 * × HEL-679 已确认融合样稿）。Single source of truth for the whole
+	 * app: pages and components reference these variables only — no
+	 * hardcoded colors, no ad-hoc overrides. 界面只有暖调黑白灰，作品是
+	 * 屏幕上唯一成片的颜色；状态色仅按主题卡的两处有限例外（琥珀
+	 * #A3915F、红 #B3564A）使用，不放大成全站主色。选中=取景框角线，
+	 * 完成=「定影」，结果=相纸白边。
 	 * ------------------------------------------------------------------ */
 
-	/* 底色：蓝黑四阶，逐层浮起 (§1.1) */
-	--bg: #07090e;
-	--bg-2: #0c0f16;
-	--bg-3: #121724;
-	--bg-4: #1a2133;
-	--line: #1b2233;
-	--line-2: #2a3450;
-	--page-glow: radial-gradient(1200px 500px at 70% -10%, rgba(38, 52, 92, 0.25), transparent 60%);
-	--float-bg: linear-gradient(180deg, #10152a, var(--bg-2));
-	--overlay: rgba(4, 6, 10, 0.6);
-	--media-scrim: rgba(7, 9, 14, 0.65);
+	/* 底色：显影灰阶四阶，逐层浮起（theme-1：#212120 底 / #2C2C2A 面板） */
+	--bg: #212120;
+	--bg-2: #262625;
+	--bg-3: #2c2c2a;
+	--bg-4: #383835;
+	--line: #313130;
+	--line-2: #454542;
+	--page-glow: radial-gradient(1200px 500px at 70% -10%, rgba(245, 244, 238, 0.035), transparent 60%);
+	--float-bg: linear-gradient(180deg, #2e2e2c, var(--bg-2));
+	--overlay: rgba(18, 18, 17, 0.62);
+	--media-scrim: rgba(18, 18, 17, 0.66);
 	--on-media: #fff;
 	--on-media-line: rgba(255, 255, 255, 0.05);
-	--composer-bg: linear-gradient(180deg, #0e1220, var(--bg-2));
-	--composer-focus: 0 0 0 1px rgba(242, 199, 132, 0.12), 0 8px 28px rgba(0, 0, 0, 0.4);
+	--composer-bg: linear-gradient(180deg, #2a2a28, var(--bg-2));
+	--composer-focus: 0 0 0 1px rgba(245, 244, 238, 0.12), 0 8px 28px rgba(0, 0, 0, 0.4);
 
-	/* 放映金：主按钮、当前选中、改过的参数、聚焦框、Toast 动作 (§1.2) */
-	--accent: #f2c784;
-	--accent-ink: #23170a;
-	--accent-soft: rgba(242, 199, 132, 0.13);
-	--accent-hi: #f7d9a2;
-	--accent-lo: #ecaf63;
-	--accent-glow: rgba(236, 175, 99, 0.28);
-	--accent-line: rgba(242, 199, 132, 0.55);
+	/* 相纸白（重点色）：主按钮、当前选中、改过的参数、聚焦框、Toast 动作
+	   (theme-1 #F5F4EE 重点) */
+	--accent: #f5f4ee;
+	--accent-ink: #212120;
+	--accent-soft: rgba(245, 244, 238, 0.08);
+	--accent-hi: #ffffff;
+	--accent-lo: #ddddd7;
+	--accent-glow: rgba(240, 239, 233, 0.2);
+	--accent-line: rgba(245, 244, 238, 0.55);
 	--accent-grad: linear-gradient(180deg, var(--accent-hi), var(--accent-lo));
-	--accent-grad-hover: linear-gradient(180deg, #fbe3b6, #f0b968);
-	--accent-ring: 0 0 0 1px rgba(242, 199, 132, 0.7), 0 0 22px var(--accent-glow);
-	--btn-glow: 0 2px 14px var(--accent-glow), inset 0 1px 0 rgba(255, 255, 255, 0.35);
-	--btn-glow-hover: 0 4px 18px var(--accent-glow), inset 0 1px 0 rgba(255, 255, 255, 0.4);
-	--accent-wash: linear-gradient(180deg, rgba(242, 199, 132, 0.05), transparent 40%);
-	--sel-shadow: 0 0 0 1px rgba(242, 199, 132, 0.15), 0 6px 24px rgba(0, 0, 0, 0.35);
+	--accent-grad-hover: linear-gradient(180deg, #ffffff, #e8e7df);
+	--accent-ring: 0 0 0 1px rgba(245, 244, 238, 0.7), 0 0 22px var(--accent-glow);
+	--btn-glow: 0 2px 10px rgba(0, 0, 0, 0.38), inset 0 1px 0 rgba(255, 255, 255, 0.55);
+	--btn-glow-hover: 0 3px 14px rgba(0, 0, 0, 0.44), inset 0 1px 0 rgba(255, 255, 255, 0.65);
+	--accent-wash: linear-gradient(180deg, rgba(245, 244, 238, 0.05), transparent 40%);
+	--sel-shadow: 0 0 0 1px rgba(245, 244, 238, 0.14), 0 6px 24px rgba(0, 0, 0, 0.35);
 
-	/* 信号色：绿=完成/已确认/通过，青=进行中/在线，红=失败/危险，
-	   琥珀=待确认/文件缺失/限额 (§1.3) */
-	--ok: #49cb90;
-	--ok-soft: rgba(73, 203, 144, 0.13);
-	--run: #54dfd2;
-	--run-soft: rgba(84, 223, 210, 0.13);
-	--run-grad: linear-gradient(90deg, #3bbfb4, var(--run));
-	--err: #f0645a;
-	--err-soft: rgba(240, 100, 90, 0.13);
-	--err-line: rgba(240, 100, 90, 0.6);
-	--warn: #f0b45c;
-	--warn-soft: rgba(240, 180, 92, 0.13);
+	/* 信号色：完成=显影亮灰（「定影」，配图标/文字双编码），进行中=灰阶
+	   +动效；红/琥珀只按 theme-1 卡片的有限例外使用（红=失败/危险
+	   #B3564A 系，琥珀=待确认/文件缺失 #A3915F） */
+	--ok: #ddddd7;
+	--ok-soft: rgba(221, 221, 215, 0.1);
+	--run: #b8b6ac;
+	--run-soft: rgba(184, 182, 172, 0.12);
+	--run-grad: linear-gradient(90deg, #8f8e85, #c6c5c0);
+	--err: #d07a6b;
+	--err-solid: #b3564a;
+	--err-soft: rgba(181, 86, 74, 0.15);
+	--err-line: rgba(208, 122, 107, 0.55);
+	--warn: #a3915f;
+	--warn-soft: rgba(163, 145, 95, 0.13);
 
-	/* 文字与字体 (§1.4)；--text-2 是深底可读性下限，不得再暗 */
-	--text: #f4f6fa;
-	--text-2: #aab2c5;
-	--text-3: #6d7690;
+	/* 文字与字体；--text-3 是深底可读性下限（≥4.5:1 on --bg-3），不得再暗 */
+	--text: #f0efe9;
+	--text-2: #a8a69c;
+	--text-3: #94938c;
 	--font: 'PingFang SC', 'Noto Sans SC', 'Microsoft YaHei', system-ui, sans-serif;
 	--mono: 'JetBrains Mono', ui-monospace, monospace;
 	--fs-title: 15px;
@@ -95,8 +100,14 @@
 	/* 专属符号 (§1.7)：齿孔只在记录流/输入台分隔带，光晕只在播放舞台 */
 	--sprocket: radial-gradient(circle 2px, var(--line-2) 98%, transparent);
 	--stage-bg:
-		radial-gradient(60% 45% at 50% 38%, rgba(242, 199, 132, 0.07), transparent 70%),
-		radial-gradient(80% 70% at 50% 50%, #0d1220, #05070c);
+		radial-gradient(60% 45% at 50% 38%, rgba(245, 244, 238, 0.045), transparent 70%),
+		radial-gradient(80% 70% at 50% 50%, #232322, #171716);
+
+	/* 取景框角线与相纸白边 (HEL-680)：内容级选中/结果呈现的统一语言 */
+	--frame-w: 2px;
+	--frame-arm: 12px;
+	--frame-inset: -4px;
+	--paper-w: 4px;
 
 	/* 动效 (§1.6，取 HEL-648 实测值)；只动 transform / opacity */
 	--ease-out: cubic-bezier(0.23, 1, 0.32, 1);
@@ -113,13 +124,13 @@
 	--d-progress: 400ms;
 	--press-scale: 0.97;
 
-	/* Avatar five-color set — five agents only; the one colorful gradient
-	   family the spec keeps (§3.6). */
-	--avatar-1: linear-gradient(135deg, #e8a33d, #b96a1b);
-	--avatar-2: linear-gradient(135deg, #5b8def, #3a5fa9);
-	--avatar-3: linear-gradient(135deg, #3fb97f, #2a7a54);
-	--avatar-4: linear-gradient(135deg, #b98be0, #7a4fa9);
-	--avatar-5: linear-gradient(135deg, #d98e6a, #a95535);
+	/* Avatar five-step grayscale (HEL-680 无彩化)：1–2 亮阶配深字，
+	   3–5 暗阶配浅字；仍是五个身份位，只是从彩色渐变改为显影灰阶。 */
+	--avatar-1: linear-gradient(135deg, #e8e7df, #cdcbc4);
+	--avatar-2: linear-gradient(135deg, #b5b3aa, #9c9a91);
+	--avatar-3: linear-gradient(135deg, #6b6a66, #55544f);
+	--avatar-4: linear-gradient(135deg, #55544f, #424140);
+	--avatar-5: linear-gradient(135deg, #424140, #2e2e2c);
 
 	/* ------------------------------------------------------------------
 	 * Legacy token names (§六 映射表) — aliases only, never new values,
@@ -297,7 +308,7 @@ code,
 	color: var(--err);
 }
 .a-btn.danger-solid {
-	background: var(--err);
+	background: var(--err-solid);
 	color: var(--on-media);
 }
 @media (hover: hover) and (pointer: fine) {
@@ -550,11 +561,47 @@ button.status-chip:active {
 .a-chip.changed {
 	color: var(--accent);
 }
-/* Selected filter chip (§3.5 筛选芯片组): 当前选中 = 金色文字 + accent-soft 底 */
+/* Selected filter chip (§3.5 筛选芯片组): 当前选中 = 取景框角线缩影 +
+   相纸白文字 + accent-soft 底 (HEL-680) */
 .a-chip.sel {
+	position: relative;
 	background: var(--accent-soft);
 	color: var(--accent);
 }
+.a-chip.sel::after {
+	content: '';
+	position: absolute;
+	inset: 2px;
+	pointer-events: none;
+	background-image:
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0);
+	background-position:
+		left top,
+		left top,
+		right top,
+		right top,
+		left bottom,
+		left bottom,
+		right bottom,
+		right bottom;
+	background-size:
+		6px 1.5px,
+		1.5px 6px,
+		6px 1.5px,
+		1.5px 6px,
+		6px 1.5px,
+		1.5px 6px,
+		6px 1.5px,
+		1.5px 6px;
+	background-repeat: no-repeat;
+}
 .a-chip.warn {
 	color: var(--warn);
 }
@@ -753,6 +800,81 @@ button.a-tile:disabled {
 	box-shadow: 0 0 0 1px var(--line);
 }
 
+/* ------------------------------------------------------------------
+ * 取景框角线选中 (HEL-680)：内容级选中态的唯一语言——四角短线取景，
+ * 不整框描边。挂在需要角线的元素上（元素自身可 overflow 可见；被
+ * overflow:hidden 裁切的容器改用 --frame-inset 正值画在内侧）。
+ * ------------------------------------------------------------------ */
+.a-frame {
+	position: relative;
+}
+.a-frame::after {
+	content: '';
+	position: absolute;
+	inset: var(--frame-inset, -4px);
+	z-index: 3;
+	pointer-events: none;
+	background-image:
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0),
+		linear-gradient(var(--accent) 0 0);
+	background-position:
+		left top,
+		left top,
+		right top,
+		right top,
+		left bottom,
+		left bottom,
+		right bottom,
+		right bottom;
+	background-size:
+		var(--frame-arm, 12px) var(--frame-w, 2px),
+		var(--frame-w, 2px) var(--frame-arm, 12px),
+		var(--frame-arm, 12px) var(--frame-w, 2px),
+		var(--frame-w, 2px) var(--frame-arm, 12px),
+		var(--frame-arm, 12px) var(--frame-w, 2px),
+		var(--frame-w, 2px) var(--frame-arm, 12px),
+		var(--frame-arm, 12px) var(--frame-w, 2px),
+		var(--frame-w, 2px) var(--frame-arm, 12px);
+	background-repeat: no-repeat;
+}
+
+/* 相纸白边 (HEL-680)：结果媒体外的相纸白框，底边略厚如手工相纸。
+   挂在承载 img/video 的媒体容器上；容器尺寸由调用方决定。 */
+.a-photo {
+	background: var(--accent);
+	border: var(--paper-w, 4px) solid var(--accent);
+	border-bottom-width: calc(var(--paper-w, 4px) + 2px);
+	border-radius: 2px;
+	box-shadow: 0 2px 12px rgba(0, 0, 0, 0.35);
+	box-sizing: border-box;
+}
+
+/* 「定影」完成章 (HEL-680)：已定影结果右上角的完成印记，随 jobst.done
+   文案走（中文=定影）。absolute 定位，挂在有媒体的结果容器内。 */
+.a-fix {
+	position: absolute;
+	top: var(--sp-3);
+	right: var(--sp-3);
+	z-index: 2;
+	padding: 1px 6px;
+	border: 1px solid currentColor;
+	border-radius: 3px;
+	background: var(--media-scrim);
+	color: var(--ok);
+	font-size: var(--fs-mini);
+	font-weight: 700;
+	letter-spacing: 0.1em;
+	text-indent: 0.1em;
+	transform: rotate(-4deg);
+	pointer-events: none;
+}
+
 /* Floating surface for pop / drawer / confirm / toast / lightbox (§四.3). */
 .a-float {
 	background: var(--float-bg);

calliope-web/src/routes/build-scene/+page.svelte

@@ -574,7 +574,7 @@ function toggleChat() {
 	.left-panel {
 		width: 280px;
 		flex-shrink: 0;
-		border-right: 1px solid var(--border, #232733);
+		border-right: 1px solid var(--line);
 		display: flex;
 		flex-direction: column;
 		min-height: 0;
@@ -582,7 +582,7 @@ function toggleChat() {
 	.inspector-slot {
 		flex: 1;
 		min-height: 0;
-		border-top: 1px solid var(--border, #232733);
+		border-top: 1px solid var(--line);
 		overflow: hidden;
 	}
 	.center-panel {
@@ -600,7 +600,7 @@ function toggleChat() {
 		position: relative;
 		display: flex;
 		overflow: hidden;
-		background: #0b1220;
+		background: var(--bg-2);
 	}
 	.loading {
 		flex: 1;
@@ -612,11 +612,11 @@ function toggleChat() {
 	.chat-panel {
 		width: 360px;
 		flex-shrink: 0;
-		border-left: 1px solid var(--border, #232733);
+		border-left: 1px solid var(--line);
 		display: flex;
 		flex-direction: column;
 		min-height: 0;
-		transition: width 0.18s ease;
+		transition: width var(--d-pop) var(--ease-out);
 	}
 	.chat-panel.collapsed {
 		width: 40px;
@@ -636,7 +636,7 @@ function toggleChat() {
 		letter-spacing: 0.04em;
 	}
 	.chat-toggle {
-		border: 1px solid var(--border, #2a2f3a);
+		border: 1px solid var(--line-2);
 		background: transparent;
 		color: inherit;
 		border-radius: 6px;
@@ -650,14 +650,14 @@ function toggleChat() {
 		flex-shrink: 0;
 	}
 	.chat-toggle:hover {
-		background: rgba(255, 255, 255, 0.08);
+		background: var(--bg-4);
 	}
 	.chat-head {
 		display: flex;
 		align-items: center;
 		gap: 8px;
 		padding: 10px 14px;
-		border-bottom: 1px solid var(--border, #232733);
+		border-bottom: 1px solid var(--line);
 	}
 	.chat-head .chat-toggle {
 		margin-left: auto;
@@ -677,7 +677,7 @@ function toggleChat() {
 		font-size: 10px;
 		text-transform: uppercase;
 		letter-spacing: 0.06em;
-		border: 1px solid var(--border, #2a2f3a);
+		border: 1px solid var(--line-2);
 		border-radius: 999px;
 		padding: 2px 8px;
 		opacity: 0.7;
@@ -686,6 +686,37 @@ function toggleChat() {
 		margin: 0;
 		padding: 4px 12px;
 		font-size: 12px;
-		color: var(--muted, #9aa3b5);
+		color: var(--text-3);
+	}
+	/* ── ≤760px 可用级适配（F 批）：解除 100vh 固定布局，纵向堆叠可滚动。 ── */
+	@media (max-width: 760px) {
+		.shell {
+			height: auto;
+			min-height: 100vh;
+			overflow: visible;
+		}
+		.workspace {
+			flex-direction: column;
+		}
+		.left-panel {
+			width: 100%;
+			border-right: none;
+			border-bottom: 1px solid var(--line);
+			max-height: 60vh;
+		}
+		.chat-panel,
+		.chat-panel.collapsed {
+			width: 100%;
+			border-left: none;
+			border-top: 1px solid var(--line);
+			min-height: 50vh;
+		}
+		.chat-panel.collapsed .chat-head {
+			flex-direction: row;
+			padding: var(--sp-3) var(--sp-5);
+		}
+		.chat-title-vert {
+			writing-mode: horizontal-tb;
+		}
 	}
 </style>

calliope-web/src/routes/canvas/+page.svelte

@@ -39,6 +39,6 @@
 		font-size: 14px;
 	}
 	.redirect-error {
-		color: #f87171;
+		color: var(--err);
 	}
 </style>

calliope-web/src/routes/canvas/[id]/+page.svelte

@@ -1080,7 +1080,7 @@
 					<span class="saved">saved</span>
 				{/if}
 				{#if canvas.project}
-					<a class="project-chip" href="/project/{canvas.project.id}">
+					<a class="project-chip" href="/workbench/{canvas.project.id}">
 						<Icon name="folder" size={12} />
 						{canvas.project.title}
 					</a>
@@ -1387,8 +1387,8 @@ title={running
 			color 0.15s;
 	}
 	.unlink-btn:hover:not(:disabled) {
-		border-color: #f87171;
-		color: #fca5a5;
+		border-color: var(--err-line);
+		color: var(--err);
 	}
 	.unlink-btn:disabled {
 		opacity: 0.45;
@@ -1476,4 +1476,27 @@ title={running
 		top: 14px;
 		z-index: 5;
 	}
+	/* ── ≤760px 可用级适配（F 批）：解除 100vh 固定布局，画布与对话纵向堆叠。 ── */
+	@media (max-width: 760px) {
+		.shell {
+			height: auto;
+			min-height: 100vh;
+			overflow: visible;
+		}
+		.workspace {
+			flex-direction: column;
+		}
+		.flow-panel {
+			min-height: 60vh;
+		}
+		.chat-panel {
+			width: 100% !important;
+			border-left: none;
+			border-top: 1px solid var(--line);
+			min-height: 50vh;
+		}
+		.chat-splitter {
+			display: none;
+		}
+	}
 </style>

calliope-web/src/routes/connections/+page.svelte

@@ -7,8 +7,9 @@
 	import ConfirmDialog from '$lib/components/ui/ConfirmDialog.svelte';
 	import Icon from '$lib/components/ui/Icon.svelte';
 	import EmptyState from '$lib/components/ui/EmptyState.svelte';
+	import WorkflowImportDrawer from '$lib/components/WorkflowImportDrawer.svelte';
 	import WorkflowTestDialog from '$lib/components/WorkflowTestDialog.svelte';
-	import { apiErrorMessage, comfy, settings, workflows, type ComfyEndpoint, type Workflow, type WorkflowOutputMapEntry, type WorkflowUsage, type WorkflowAnalyzeResult, type WorkflowConnectionCheck } from '$lib/api';
+	import { apiErrorMessage, comfy, settings, workflows, type ComfyEndpoint, type Workflow, type WorkflowOutputMapEntry, type WorkflowUsage, type WorkflowConnectionCheck } from '$lib/api';
 	import { WORKFLOW_USAGES } from '$lib/comfy/types';
 	import { toast } from '$lib/toast';
 	import { t } from '$lib/i18n.svelte';
@@ -327,214 +328,24 @@
 	});
 
 	// ------------------------------------------------------------------
-	// Workflow library (import + binding) — two-step wizard: paste/analyze,
-	// then confirm the judged usage and slot roles before saving (HEL-636).
+	// Workflow library (binding + per-row recheck / test). The import
+	// wizard itself lives in WorkflowImportDrawer (HEL-655 E 批).
 	// ------------------------------------------------------------------
-	let wfJsonText = $state('');
 	let wfImportOpen = $state(false);
-	let wfImportName = $state('');
-	let wfImportEndpoint = $state('');
-	let wfStep = $state<'input' | 'confirm'>('input');
-	let wfAnalysis = $state<WorkflowAnalyzeResult | null>(null);
-	let wfUsage = $state<WorkflowUsage | null>(null);
-	let wfRoleOverrides = $state<Record<string, string>>({});
-	// HEL-638: explicit output-node designation for unknown custom nodes.
-	let wfOutputPicked = $state<Record<string, boolean>>({});
-	let wfOutputKind = $state<Record<string, 'image' | 'video'>>({});
-	let wfAnalyzing = $state(false);
-	let wfAnalyzeError = $state('');
-
-	const wfParsed = $derived.by(() => {
-		const text = wfJsonText.trim();
-		if (!text) return { valid: false as const, json: null as Record<string, unknown> | null };
-		try {
-			const parsed = JSON.parse(text) as unknown;
-			if (
-				typeof parsed === 'object' &&
-				parsed !== null &&
-				!Array.isArray(parsed) &&
-				Object.values(parsed).some(
-					(v) => typeof v === 'object' && v !== null && 'class_type' in (v as object),
-				)
-			) {
-				return { valid: true as const, json: parsed as Record<string, unknown> };
-			}
-		} catch {
-			/* fallthrough */
-		}
-		return { valid: false as const, json: null };
-	});
-
-	function usageLabel(u: WorkflowUsage | null | undefined): string {
-		return u ? t(`usage.${u}`) : t('usage.pending');
-	}
 
 	function startWfImport() {
 		wfImportOpen = true;
-		wfImportName = '';
-		wfJsonText = '';
-		wfImportEndpoint = '';
-		wfStep = 'input';
-		wfAnalysis = null;
-		wfUsage = null;
-		wfRoleOverrides = {};
-		wfOutputPicked = {};
-		wfOutputKind = {};
-		wfAnalyzeError = '';
+	}
+
+	function usageLabel(u: WorkflowUsage | null | undefined): string {
+		return u ? t(`usage.${u}`) : t('usage.pending');
 	}
 
 	function wfProblems(wf: Workflow): string[] {
 		return (wf.warnings ?? []).filter((w) => w.level === 'error').map((w) => w.message);
 	}
 
-	async function runWfAnalyze(refresh = false) {
-		if (!wfParsed.valid || !wfParsed.json) return;
-		wfAnalyzing = true;
-		wfAnalyzeError = '';
-		try {
-			const res = await workflows.analyze(
-				wfParsed.json,
-				wfImportEndpoint || undefined,
-				refresh,
-			);
-			wfAnalysis = res;
-			wfUsage = res.usage ?? null;
-			wfRoleOverrides = {};
-			// Unknown output candidates: preselect only when there is exactly
-			// one — with several the user must decide (HEL-638).
-			const candidates = (res.usage_evidence.outputs ?? []).filter(
-				(o) => o.evidence === 'unknown_node',
-			);
-			const picked: Record<string, boolean> = {};
-			const kinds: Record<string, 'image' | 'video'> = {};
-			for (const c of candidates) {
-				kinds[c.nodeId] = c.suggested_kind ?? 'image';
-			}
-			if (candidates.length === 1) picked[candidates[0].nodeId] = true;
-			wfOutputPicked = picked;
-			wfOutputKind = kinds;
-			wfStep = 'confirm';
-		} catch (err) {
-			wfAnalyzeError = apiErrorMessage(err);
-		} finally {
-			wfAnalyzing = false;
-		}
-	}
-
-	/** True when the graph has no output node at all — nothing to confirm. */
-	const wfFatal = $derived(
-		wfStep === 'confirm' && wfAnalysis !== null && (wfAnalysis.outputs?.length ?? 0) === 0,
-	);
-	/** Unknown custom output nodes the user must designate (HEL-638). */
-	const wfOutputCandidates = $derived(
-		wfStep === 'confirm' && wfAnalysis !== null
-			? (wfAnalysis.usage_evidence.outputs ?? []).filter((o) => o.evidence === 'unknown_node')
-			: [],
-	);
-	const wfOutputRows = $derived(
-		wfOutputCandidates.map((o) => ({
-			...o,
-			picked: wfOutputPicked[o.nodeId] ?? false,
-			kind: wfOutputKind[o.nodeId] ?? o.suggested_kind ?? 'image',
-		})),
-	);
-	const wfOutputPickedCount = $derived(
-		Object.values(wfOutputPicked).filter(Boolean).length,
-	);
-	const wfMustPick = $derived(
-		wfStep === 'confirm' &&
-			wfAnalysis !== null &&
-			!wfFatal &&
-			(wfAnalysis.usage_ambiguous || wfAnalysis.needs_mapping) &&
-			wfUsage === null,
-	);
-	const wfSaveable = $derived(
-		wfStep === 'confirm' &&
-			wfUsage !== null &&
-			!wfFatal &&
-			(wfOutputCandidates.length === 0 || wfOutputPickedCount > 0),
-	);
-	/** Media slots the confirm page lets the user re-role. */
-	const wfSlotRows = $derived.by(() => {
-		if (wfStep !== 'confirm' || !wfAnalysis) return [];
-		return wfAnalysis.usage_evidence.image_slots.map((s) => ({
-			...s,
-			role: wfRoleOverrides[s.nodeId] ?? s.role ?? 'image',
-			fixed: s.kind === 'image_list',
-		}));
-	});
-	const wfParamPreview = $derived.by(() => {
-		if (!wfAnalysis) return [];
-		// Count EVERY analyzed input (media slots included) so the preview
-		// matches the inline count shown after import (input_schema.length)
-		// and in the studio — HEL-619.
-		return wfAnalysis.inputs.map((i) => i.label);
-	});
-
-	const wfImportMutation = createMutation({
-		mutationFn: async () => {
-			if (!wfParsed.valid || !wfParsed.json || !wfAnalysis || !wfUsage)
-				throw new Error(t('conn.wfPickUsage'));
-			if (wfOutputCandidates.length > 0 && wfOutputPickedCount === 0)
-				throw new Error(t('conn.wfOutputPick'));
-			const corrected = Object.keys(wfRoleOverrides).length > 0;
-			const schema = wfAnalysis.inputs.map((e) =>
-				wfRoleOverrides[e.nodeId]
-					? { ...e, role: wfRoleOverrides[e.nodeId], manual: true }
-					: e,
-			);
-			const outputMap = wfOutputRows
-				.filter((r) => r.picked)
-				.map((r) => ({
-					nodeId: r.nodeId,
-					kind: r.kind,
-					label: r.label,
-					...(r.class_type ? { class_type: r.class_type } : {}),
-				}));
-			return workflows.create({
-				name: wfImportName.trim(),
-				workflow_json: wfParsed.json,
-				usage: wfUsage,
-				usage_source: wfUsage !== wfAnalysis.usage || corrected ? 'user' : 'auto',
-				input_schema: schema,
-				...(outputMap.length ? { output_map: outputMap, output_map_source: 'user' } : {}),
-				...(wfImportEndpoint ? { endpoint_id: wfImportEndpoint } : {}),
-			});
-		},
-		onSuccess: (wf) => {
-			client.invalidateQueries({ queryKey: ['workflows'] });
-			const n = wf.input_schema?.length ?? 0;
-			const problems = wfProblems(wf);
-			if (problems.length) toast.error(t('conn.wfImportedBroken', { detail: problems.join('；') }));
-			else if (n) toast.success(t('conn.wfImportedWithUsage', { usage: usageLabel(wf.usage), n }));
-			else toast.info(t('conn.wfImportedNoParams'));
-			wfImportOpen = false;
-			wfJsonText = '';
-			wfImportName = '';
-			wfStep = 'input';
-			wfAnalysis = null;
-		},
-		onError: (err) => {
-			toast.error(
-				t('conn.wfImportFailed', {
-					detail: err instanceof Error ? err.message : String(err),
-				}),
-			);
-		},
-	});
-
-	function submitWfImport() {
-		if (!wfSaveable || !wfImportName.trim() || $wfImportMutation.isPending) return;
-		$wfImportMutation.mutate();
-	}
-
-	// ------------------------------------------------------------------
-	// HEL-643 L2: connection-compatibility check on the import confirm
-	// step, and per-row 重新检查 / 测试 in the workflow library.
-	// ------------------------------------------------------------------
-	const wfConnCheck = $derived<WorkflowConnectionCheck | null>(
-		wfAnalysis?.connection_check ?? null,
-	);
+	// HEL-643 L2: per-row 重新检查 / 测试 in the workflow library.
 	let wfRecheckId = $state<number | null>(null);
 	const wfRecheckResult = $state<Record<number, WorkflowConnectionCheck>>({});
 
@@ -686,15 +497,6 @@
 		},
 	});
 
-	async function onWfFile(e: Event) {
-		const input = e.currentTarget as HTMLInputElement;
-		const file = input.files?.[0];
-		if (!file) return;
-		wfJsonText = await file.text();
-		if (!wfImportName.trim()) wfImportName = file.name.replace(/\.json$/i, '');
-		input.value = '';
-	}
-
 	const wfDeleteMutation = createMutation({
 		mutationFn: (id: number) => workflows.delete(id),
 		onSuccess: () => {
@@ -921,296 +723,6 @@
 						</span>
 					</div>
 
-					{#if wfImportOpen}
-						<div class="wf-import" transition:fade={{ duration: 180 }}>
-							<div class="wf-import-head">
-								<h3>
-									{wfStep === 'input' ? t('conn.wfImportTitle') : t('conn.wfConfirmTitle')}
-									<span class="wf-step-tag">
-										{wfStep === 'input' ? `1 / 2 · ${t('conn.wfStepAnalyze')}` : `2 / 2 · ${t('conn.wfStepConfirm')}`}
-									</span>
-								</h3>
-								<button
-									type="button"
-									class="icon-btn"
-									aria-label={t('conn.formClose')}
-									onclick={() => (wfImportOpen = false)}
-								>
-									<Icon name="close" size={16} />
-								</button>
-							</div>
-
-							{#if wfStep === 'input'}
-								<p class="wf-import-hint">{t('conn.wfImportHint')}</p>
-								<div class="wf-import-grid">
-									<label class="f-field">
-										<span class="f-label">{t('conn.fName')}<em>*</em></span>
-										<input
-											class="f-input"
-											value={wfImportName}
-											oninput={(e) => (wfImportName = e.currentTarget.value)}
-											placeholder="Qwen Image 2.1 文生图"
-										/>
-									</label>
-									<label class="f-field">
-										<span class="f-label">{t('conn.wfConnection')}</span>
-										<select
-											class="f-input"
-											value={wfImportEndpoint}
-											onchange={(e) => (wfImportEndpoint = e.currentTarget.value)}
-										>
-											<option value="">{t('conn.wfConnectionActive')}</option>
-											{#each endpoints as ep (ep.id)}
-												<option value={ep.id}>{ep.name}</option>
-											{/each}
-										</select>
-									</label>
-									<label class="f-field">
-										<span class="f-label">API JSON<em>*</em></span>
-										<div class="wf-json-row">
-											<textarea
-												class="f-input wf-json"
-												class:invalid={wfJsonText.trim() !== '' && !wfParsed.valid}
-												spellcheck="false"
-												rows="3"
-												value={wfJsonText}
-												oninput={(e) => (wfJsonText = e.currentTarget.value)}
-												placeholder={t('conn.wfJsonPh')}
-											></textarea>
-											<label class="file-btn">
-												<Icon name="upload" size={14} />
-												{t('conn.wfChooseFile')}
-												<input type="file" accept=".json,application/json" onchange={onWfFile} />
-											</label>
-										</div>
-										{#if wfJsonText.trim() !== '' && !wfParsed.valid}
-											<span class="f-error">{t('conn.wfJsonInvalid')}</span>
-										{/if}
-									</label>
-								</div>
-								<div class="form-actions">
-									<span class="need-test" class:passed={wfParsed.valid && wfImportName.trim() !== ''}>
-										{wfParsed.valid
-											? t('conn.wfNodes', { n: Object.keys(wfParsed.json ?? {}).length })
-											: 'JSON'}
-									</span>
-									<Button
-										variant="primary"
-										size="sm"
-										disabled={!wfParsed.valid || !wfImportName.trim()}
-										loading={wfAnalyzing}
-										onclick={() => runWfAnalyze()}
-									>
-										{wfAnalyzing ? t('conn.wfAnalyzing') : t('conn.wfAnalyze')}
-									</Button>
-								</div>
-							{:else if wfAnalysis}
-								<p class="wf-import-hint">{t('conn.wfConfirmHint')}</p>
-
-							{#if wfAnalysis.usage_problem}
-								<div class="wf-note" class:fatal={wfFatal} role={wfFatal ? 'alert' : 'note'}>
-									<Icon name={wfFatal ? 'alert' : 'info'} size={14} />
-									<p>{wfAnalysis.usage_problem}</p>
-								</div>
-							{/if}
-							{#if wfAnalyzeError}
-								<div class="wf-note fatal" role="alert">
-									<Icon name="alert" size={14} />
-									<p>{wfAnalyzeError}</p>
-								</div>
-							{/if}
-
-							{#if wfConnCheck}
-								<div class="wf-conn-check" class:ok={wfConnCheck.ok} class:bad={wfConnCheck.ok === false && wfConnCheck.reachable} class:warn={!wfConnCheck.reachable}>
-									<div class="wf-conn-head">
-										<Icon name={wfConnCheck.ok ? 'check' : wfConnCheck.reachable ? 'alert' : 'info'} size={14} />
-										<span class="wf-conn-title">{t('conn.wfCheckTitle')}</span>
-										{#if wfConnCheck.endpoint_name}
-											<span class="wf-conn-ep">{t('conn.wfCheckEndpoint', { name: wfConnCheck.endpoint_name })}</span>
-										{/if}
-										<button
-											type="button"
-											class="mini-link"
-											disabled={wfAnalyzing}
-											onclick={() => runWfAnalyze(true)}
-										>
-											{wfAnalyzing ? t('conn.wfChecking') : t('conn.wfCheckBtn')}
-										</button>
-									</div>
-									{#if !wfConnCheck.reachable}
-										<p class="wf-conn-line">{wfConnCheck.message ?? t('conn.wfCheckUnreachable')}</p>
-									{:else if wfConnCheck.ok}
-										<p class="wf-conn-line">{t('conn.wfCheckOk')}</p>
-									{:else}
-										<ul class="wf-conn-findings">
-											{#each wfConnCheck.findings as f (f.node_id + f.code)}
-												<li>
-													<span class="wf-conn-msg">{f.message}</span>
-													{#if f.hint}<span class="wf-conn-hint">{f.hint}</span>{/if}
-												</li>
-											{/each}
-										</ul>
-										<p class="wf-conn-line">{t('conn.wfCheckSaveHint')}</p>
-									{/if}
-								</div>
-							{/if}
-
-								<ul class="wf-evidence">
-									{#each wfAnalysis.usage_evidence.summary as line (line)}
-										<li>{line}</li>
-									{/each}
-								</ul>
-
-								<div class="f-field">
-									<span class="f-label">
-										{t('conn.wfUsageLabel')}<em>*</em>
-										<span class="f-hint-inline">
-											{#if wfAnalysis.usage}
-												{t('conn.wfUsageAuto', { usage: usageLabel(wfAnalysis.usage) })}
-											{:else}
-												{t('conn.wfUsageNeedPick')}
-											{/if}
-										</span>
-									</span>
-									<div class="seg wrap" role="radiogroup">
-										{#each WORKFLOW_USAGES as u (u)}
-											<button
-												type="button"
-												class="seg-item"
-												class:selected={wfUsage === u}
-												aria-pressed={wfUsage === u}
-												onclick={() => (wfUsage = u)}
-											>
-												{usageLabel(u)}
-											</button>
-										{/each}
-									</div>
-								{#if wfMustPick}<span class="f-error">{t('conn.wfPickUsage')}</span>{/if}
-							</div>
-
-							{#if wfOutputRows.length}
-								<div class="f-field">
-									<span class="f-label">
-										{t('conn.wfOutputLabel')}<em>*</em>
-										<span class="f-hint-inline">{t('conn.wfOutputNeedPick')}</span>
-									</span>
-									<div class="wf-slot-rows">
-										{#each wfOutputRows as row (row.nodeId)}
-											<div class="wf-slot-row" class:off={!row.picked}>
-												<label class="wf-out-check">
-													<input
-														type="checkbox"
-														checked={row.picked}
-														onchange={(e) =>
-															(wfOutputPicked = {
-																...wfOutputPicked,
-																[row.nodeId]: e.currentTarget.checked,
-															})}
-													/>
-													<span class="wf-slot-id mono">{row.nodeId}</span>
-													<span class="wf-slot-name" title={row.class_type}>{row.label}</span>
-												</label>
-												<select
-													class="a-select"
-													aria-label={t('conn.wfOutputKindAria')}
-													disabled={!row.picked}
-													value={row.kind}
-													onchange={(e) =>
-														(wfOutputKind = {
-															...wfOutputKind,
-															[row.nodeId]: e.currentTarget.value as 'image' | 'video',
-														})}
-												>
-													<option value="image">{t('conn.wfKindImage')}</option>
-													<option value="video">{t('conn.wfKindVideo')}</option>
-												</select>
-											</div>
-										{/each}
-									</div>
-									<span class="f-hint">{t('conn.wfOutputHint')}</span>
-									{#if wfOutputPickedCount === 0}
-										<span class="f-error">{t('conn.wfOutputPick')}</span>
-									{/if}
-								</div>
-							{/if}
-
-							{#if wfSlotRows.length}
-									<div class="f-field">
-										<span class="f-label">{t('conn.wfSlotsLabel')}</span>
-										<div class="wf-slot-rows">
-											{#each wfSlotRows as row (row.nodeId)}
-												<div class="wf-slot-row">
-													<span class="wf-slot-id mono">{row.nodeId}</span>
-													<span class="wf-slot-name">{row.label}</span>
-													{#if row.fixed}
-														<span class="tag tag-usage">{t('wfRole.reference_image')}</span>
-													{:else}
-														<select
-															class="a-select"
-															value={row.role}
-															onchange={(e) =>
-																(wfRoleOverrides = {
-																	...wfRoleOverrides,
-																	[row.nodeId]: e.currentTarget.value,
-																})}
-														>
-															{#each ['image', 'first_frame', 'last_frame', 'reference_image', 'mask'] as r (r)}
-																<option value={r}>{t(`wfRole.${r}`)}</option>
-															{/each}
-														</select>
-													{/if}
-												</div>
-											{/each}
-										</div>
-										<span class="f-hint">{t('conn.wfSlotsHint')}</span>
-									</div>
-								{/if}
-
-								<p class="wf-params">
-									{t('conn.wfParams', { n: wfParamPreview.length })}
-									{#if wfParamPreview.length}
-										<span class="wf-params-list">{wfParamPreview.slice(0, 8).join(' · ')}{wfParamPreview.length > 8 ? ' …' : ''}</span>
-									{/if}
-								</p>
-
-								{#if (wfAnalysis.warnings ?? []).length}
-									<ul class="wf-warnings">
-										{#each wfAnalysis.warnings as w (w.node_id + w.code)}
-											<li class:err={w.level === 'error'}>{w.message}</li>
-										{/each}
-									</ul>
-								{/if}
-
-								<div class="form-actions">
-									<Button
-										variant="secondary"
-										size="sm"
-										disabled={$wfImportMutation.isPending}
-										onclick={() => (wfStep = 'input')}
-									>
-										{t('conn.wfBack')}
-									</Button>
-									<span class="need-test" class:passed={wfSaveable && wfImportName.trim() !== ''}>
-										{wfUsage
-											? wfOutputCandidates.length && wfOutputPickedCount === 0
-												? t('conn.wfOutputPick')
-												: usageLabel(wfUsage)
-											: t('conn.wfUsageNeedPick')}
-									</span>
-									<Button
-										variant="primary"
-										size="sm"
-										disabled={!wfSaveable || !wfImportName.trim()}
-										loading={$wfImportMutation.isPending}
-										onclick={submitWfImport}
-									>
-										{$wfImportMutation.isPending ? t('conn.wfImporting') : t('conn.wfConfirmSave')}
-									</Button>
-								</div>
-							{/if}
-						</div>
-					{/if}
-
 					{#if ($workflowsQuery.data ?? []).length === 0}
 						<EmptyState title={t('conn.wfEmpty')} />
 						<p class="missing-note">{t('conn.missingMaterial')}</p>
@@ -1592,6 +1104,11 @@
 			</div>
 		{/if}
 	</div>
+<WorkflowImportDrawer
+		bind:open={wfImportOpen}
+		{endpoints}
+		onchanged={() => client.invalidateQueries({ queryKey: ['workflows'] })}
+	/>
 <WorkflowTestDialog
 		bind:open={testOpen}
 		workflow={testWf}
@@ -1640,10 +1157,10 @@
 		gap: 22px;
 	}
 
-	/* ---------------- connection cards ---------------- */
+	/* ---------------- connection cards (§3.7 卡片网格) ---------------- */
 	.cards {
-		display: flex;
-		flex-direction: column;
+		display: grid;
+		grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
 		gap: 14px;
 	}
 	.card {
@@ -1821,17 +1338,19 @@
 		opacity: 0.35;
 		cursor: not-allowed;
 	}
+	/* 次级文字操作走 ghost（HEL-649 v2 §1.2）：默认 --text-2，悬停 --text，
+	   不用金色文字链接。金色聚焦 outline 由全局 :focus-visible 提供。 */
 	.link-accent {
 		background: none;
 		border: none;
 		padding: 0;
 		font-family: inherit;
 		font-size: 12px;
-		color: var(--accent);
+		color: var(--text-2);
 		cursor: pointer;
 	}
 	.link-accent:hover {
-		text-decoration: underline;
+		color: var(--text);
 	}
 
 	.notice {
@@ -1899,139 +1418,6 @@
 		padding-left: 10px;
 		line-height: 1.6;
 	}
-
-	.wf-import {
-		border: 1px solid var(--border-strong);
-		border-radius: 9px;
-		padding: 14px 16px;
-		margin-bottom: 14px;
-		background: var(--surface-2);
-	}
-	.wf-step-tag {
-		margin-left: 8px;
-		font-size: 10.5px;
-		font-weight: 500;
-		color: var(--text-3);
-	}
-	.wf-note {
-		display: flex;
-		align-items: flex-start;
-		gap: 8px;
-		margin: 0 0 10px;
-		padding: 9px 12px;
-		border-radius: 7px;
-		background: var(--accent-dim);
-		color: var(--text-2);
-	}
-	.wf-note :global(.icon) {
-		color: var(--accent);
-		flex-shrink: 0;
-		margin-top: 2px;
-	}
-	.wf-note.fatal {
-		background: var(--error-dim);
-	}
-	.wf-note.fatal :global(.icon) {
-		color: var(--error);
-	}
-	.wf-note p {
-		margin: 0;
-		font-size: 11.5px;
-		line-height: 1.55;
-	}
-	.wf-conn-check {
-		margin: 0 0 12px;
-		padding: 9px 12px;
-		border: 1px solid var(--border-strong);
-		border-radius: 7px;
-		background: var(--surface-2);
-		display: flex;
-		flex-direction: column;
-		gap: 6px;
-	}
-	.wf-conn-check.ok {
-		border-color: var(--success);
-	}
-	.wf-conn-check.bad {
-		border-color: var(--error);
-	}
-	.wf-conn-check.warn {
-		border-color: var(--warn);
-	}
-	.wf-conn-head {
-		display: flex;
-		align-items: center;
-		gap: 8px;
-		flex-wrap: wrap;
-	}
-	.wf-conn-head :global(.icon) {
-		flex-shrink: 0;
-	}
-	.wf-conn-check.ok .wf-conn-head :global(.icon) {
-		color: var(--success);
-	}
-	.wf-conn-check.bad .wf-conn-head :global(.icon) {
-		color: var(--error);
-	}
-	.wf-conn-check.warn .wf-conn-head :global(.icon) {
-		color: var(--warn);
-	}
-	.wf-conn-title {
-		font-size: 12px;
-		font-weight: 600;
-		color: var(--text);
-	}
-	.wf-conn-ep {
-		font-size: 11px;
-		color: var(--text-3);
-	}
-	.mini-link {
-		margin-left: auto;
-		background: none;
-		border: none;
-		padding: 0;
-		font-family: inherit;
-		font-size: 11px;
-		color: var(--accent);
-		text-decoration: underline;
-		cursor: pointer;
-	}
-	.mini-link:disabled {
-		opacity: 0.6;
-		cursor: default;
-	}
-	.wf-conn-line {
-		margin: 0;
-		font-size: 11.5px;
-		color: var(--text-2);
-		line-height: 1.55;
-	}
-	.wf-conn-findings {
-		margin: 0;
-		padding: 0;
-		list-style: none;
-		display: flex;
-		flex-direction: column;
-		gap: 5px;
-	}
-	.wf-conn-findings li {
-		display: flex;
-		flex-direction: column;
-		gap: 2px;
-		padding: 6px 8px;
-		border-radius: 6px;
-		background: var(--error-dim);
-	}
-	.wf-conn-msg {
-		font-size: 11.5px;
-		color: var(--text);
-		line-height: 1.5;
-	}
-	.wf-conn-hint {
-		font-size: 10.5px;
-		color: var(--text-3);
-		line-height: 1.5;
-	}
 	.wf-test-btn {
 		display: inline-flex;
 		align-items: center;
@@ -2066,30 +1452,6 @@
 	.wf-meta-item.recheck.warn .wf-recheck-text {
 		color: var(--warn);
 	}
-	.wf-evidence {
-		margin: 0 0 12px;
-		padding: 0 0 0 4px;
-		list-style: none;
-		display: flex;
-		flex-direction: column;
-		gap: 3px;
-	}
-	.wf-evidence li {
-		font-size: 11px;
-		color: var(--text-3);
-		line-height: 1.5;
-	}
-	.wf-evidence li::before {
-		content: '·';
-		margin-right: 6px;
-		color: var(--accent);
-	}
-	.seg.wrap {
-		flex-wrap: wrap;
-	}
-	.seg.wrap .seg-item {
-		flex: 1 0 30%;
-	}
 	.wf-slot-rows {
 		display: flex;
 		flex-direction: column;
@@ -2172,28 +1534,6 @@
 		font-size: 11.5px;
 		color: var(--text-3);
 	}
-	.wf-params-list {
-		margin-left: 6px;
-		color: var(--text-2);
-	}
-	.wf-warnings {
-		margin: 0 0 10px;
-		padding: 8px 12px;
-		list-style: none;
-		border-radius: 7px;
-		background: var(--error-dim);
-		display: flex;
-		flex-direction: column;
-		gap: 3px;
-	}
-	.wf-warnings li {
-		font-size: 11px;
-		line-height: 1.5;
-		color: var(--text-2);
-	}
-	.wf-warnings li.err {
-		color: var(--error);
-	}
 	.tag-usage {
 		color: var(--text-2);
 		background: var(--bg-4);
@@ -2212,67 +1552,6 @@
 		max-width: 150px;
 		font-size: 11px;
 	}
-	.wf-import-head {
-		display: flex;
-		align-items: center;
-		justify-content: space-between;
-		margin-bottom: 4px;
-	}
-	.wf-import-head h3 {
-		margin: 0;
-		font-size: 13px;
-		font-weight: 600;
-		color: var(--text);
-	}
-	.wf-import-hint {
-		margin: 0 0 12px;
-		font-size: 11px;
-		color: var(--text-3);
-	}
-	.wf-import-grid {
-		display: grid;
-		grid-template-columns: 1fr 1fr;
-		gap: 0 14px;
-	}
-	.wf-import-grid .f-field:nth-child(3) {
-		grid-column: 1 / -1;
-	}
-	.wf-json-row {
-		display: flex;
-		gap: 8px;
-		align-items: flex-start;
-	}
-	.wf-json {
-		min-height: 84px;
-		resize: vertical;
-		font-size: 11px;
-		line-height: 1.5;
-	}
-	.wf-json.invalid {
-		border-color: var(--err-line);
-	}
-	.file-btn {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		flex-shrink: 0;
-		min-height: 34px;
-		padding: 0 12px;
-		border-radius: 7px;
-		border: 1px solid var(--border-strong);
-		background: var(--surface);
-		color: var(--text-2);
-		font-size: 12px;
-		cursor: pointer;
-		white-space: nowrap;
-	}
-	.file-btn:hover {
-		color: var(--text);
-		border-color: var(--line-2);
-	}
-	.file-btn input {
-		display: none;
-	}
 
 	.wf-table {
 		display: flex;
@@ -2373,12 +1652,12 @@
 		font-weight: 600;
 	}
 	.target-link {
-		color: var(--accent);
+		color: var(--text-2);
 		font-size: 12px;
 		text-decoration: none;
 	}
 	.target-link:hover {
-		text-decoration: underline;
+		color: var(--text);
 	}
 	.target-note {
 		margin: 10px 0 0;
@@ -2469,12 +1748,6 @@
 		font-size: 11px;
 		color: var(--text-3);
 	}
-	.f-hint-inline {
-		margin-left: auto;
-		font-size: 10.5px;
-		font-weight: 400;
-		color: var(--text-3);
-	}
 	.f-error {
 		display: block;
 		margin-top: 5px;
@@ -2648,5 +1921,4 @@
 			flex: 1;
 			min-width: 160px;
 		}
-	}
-</style>
+	}</style>

calliope-web/src/routes/favicon.png/+server.ts

@@ -1,5 +0,0 @@
-import type { RequestHandler } from '@sveltejs/kit';
-
-export const GET: RequestHandler = () => {
-	return new Response(null, { status: 204 });
-};

calliope-web/src/routes/library/+page.svelte

@@ -3,13 +3,15 @@
 	import { libraryApi, type LibraryMediaItem } from '$lib/api';
 	import { assetUrl } from '$lib/api';
 	import { t } from '$lib/i18n.svelte';
-	import AppHeader from '$lib/components/AppHeader.svelte';
+	import AppShell from '$lib/components/shell/AppShell.svelte';
 	import AttachToProject from '$lib/components/AttachToProject.svelte';
 	import ImageLightbox from '$lib/components/ImageLightbox.svelte';
 	import SafeMedia from '$lib/components/SafeMedia.svelte';
 	import Button from '$lib/components/ui/Button.svelte';
+	import ConfirmDialog from '$lib/components/ui/ConfirmDialog.svelte';
 	import EmptyState from '$lib/components/ui/EmptyState.svelte';
 	import Icon from '$lib/components/ui/Icon.svelte';
+	import Modal from '$lib/components/ui/Modal.svelte';
 	import Skeleton from '$lib/components/ui/Skeleton.svelte';
 	import { toast } from '$lib/toast';
 
@@ -127,117 +129,135 @@
 	}
 </script>
 
-<AppHeader active="library">
-	{#if selectedCount > 0}
-		<Button variant="danger" onclick={() => (confirmingDelete = true)}>
-			<Icon name="close" size={14} />
-			{t('library.deleteSelected', { count: selectedCount })}
-		</Button>
-	{/if}
-</AppHeader>
-
-<main class="container">
-	<div class="toolbar">
-		<div class="filters" role="tablist" aria-label={t('library.filterLabel')}>
-			<button
-				type="button"
-				class="filter-chip"
-				class:active={filter === 'all'}
-				aria-pressed={filter === 'all'}
-				onclick={() => (filter = 'all')}
-			>
-				{t('library.filterAll')} <span class="chip-count">{items.length}</span>
-			</button>
-			<button
-				type="button"
-				class="filter-chip"
-				class:active={filter === 'image'}
-				aria-pressed={filter === 'image'}
-				onclick={() => (filter = 'image')}
-			>
-				{t('library.filterImage')}
-				<span class="chip-count">
-					{items.filter((i) => i.kind === 'image').length}
-				</span>
-			</button>
-			<button
-				type="button"
-				class="filter-chip"
-				class:active={filter === 'video'}
-				aria-pressed={filter === 'video'}
-				onclick={() => (filter = 'video')}
-			>
-				{t('library.filterVideo')}
-				<span class="chip-count">
-					{items.filter((i) => i.kind === 'video').length}
-				</span>
-			</button>
-		</div>
-		<label class="select-all">
-			<input type="checkbox" checked={allSelected} onchange={toggleAll} />
-			<span>{allSelected ? t('library.deselectAll') : t('library.selectAll')}</span>
-		</label>
-		<span class="count" data-testid="library-count">
+<AppShell active="library" title={t('nav.library')} subtitle={t('library.subtitle')}>
+	{#snippet actions()}
+		<span class="status-chip" data-testid="library-count">
 			{t('library.itemCount', { count: filtered.length })}
 		</span>
-	</div>
+		{#if selectedCount > 0}
+			<Button variant="danger" onclick={() => (confirmingDelete = true)}>
+				<Icon name="close" size={14} />
+				{t('library.deleteSelected', { count: selectedCount })}
+			</Button>
+		{/if}
+	{/snippet}
 
-	{#if $mediaQuery.isLoading}
-		<div class="grid">
-			{#each Array(8) as _, i (i)}
-				<div class="card skeleton-card"><Skeleton height="220px" /></div>
-			{/each}
+	<div class="library">
+		<div class="toolbar">
+			<div class="filters" role="tablist" aria-label={t('library.filterLabel')}>
+				<button
+					type="button"
+					class="a-chip"
+					class:sel={filter === 'all'}
+					aria-pressed={filter === 'all'}
+					onclick={() => (filter = 'all')}
+				>
+					<span class="lbl">{t('library.filterAll')}</span>
+					<span class="chip-count">{items.length}</span>
+				</button>
+				<button
+					type="button"
+					class="a-chip"
+					class:sel={filter === 'image'}
+					aria-pressed={filter === 'image'}
+					onclick={() => (filter = 'image')}
+				>
+					<span class="lbl">{t('library.filterImage')}</span>
+					<span class="chip-count">{items.filter((i) => i.kind === 'image').length}</span>
+				</button>
+				<button
+					type="button"
+					class="a-chip"
+					class:sel={filter === 'video'}
+					aria-pressed={filter === 'video'}
+					onclick={() => (filter = 'video')}
+				>
+					<span class="lbl">{t('library.filterVideo')}</span>
+					<span class="chip-count">{items.filter((i) => i.kind === 'video').length}</span>
+				</button>
+			</div>
+			<label class="select-all">
+				<input type="checkbox" checked={allSelected} onchange={toggleAll} />
+				<span>{allSelected ? t('library.deselectAll') : t('library.selectAll')}</span>
+			</label>
 		</div>
-	{:else if filtered.length === 0}
-		<EmptyState
-			title={filter === 'all' ? t('library.emptyTitle') : t('library.emptyFilterTitle', { kind: filter === 'image' ? t('library.filterImage') : t('library.filterVideo') })}
-			body={filter === 'all' ? t('library.emptyBody') : t('library.emptyFilterBody')}
-		/>
-	{:else}
-		<div class="grid">
-			{#each visible as item (item.path)}
-				<div class="card" class:selected={selected.has(item.path)}>
-					<label class="check">
-						<input
-							type="checkbox"
-							checked={selected.has(item.path)}
-							onchange={() => toggle(item.path)}
-						/>
-					</label>
+
+		{#if $mediaQuery.isLoading}
+			<div class="grid" aria-busy="true">
+				{#each Array(8) as _, i (i)}
+					<div class="card skeleton-card"><Skeleton height="220px" /></div>
+				{/each}
+			</div>
+		{:else if $mediaQuery.isError}
+			<EmptyState title={t('library.loadError')}>
+				{#snippet action()}
+					<Button variant="secondary" onclick={() => $mediaQuery.refetch()}>
+						<Icon name="retry" size={14} />
+						{t('common.retry')}
+					</Button>
+				{/snippet}
+			</EmptyState>
+		{:else if filtered.length === 0}
+			<EmptyState
+				title={filter === 'all'
+					? t('library.emptyTitle')
+					: t('library.emptyFilterTitle', {
+							kind: filter === 'image' ? t('library.filterImage') : t('library.filterVideo')
+						})}
+				body={filter === 'all' ? t('library.emptyBody') : t('library.emptyFilterBody')}
+			/>
+		{:else}
+			<div class="grid">
+				{#each visible as item (item.path)}
+					<div
+						class="card"
+						class:selected={selected.has(item.path)}
+						class:a-frame={selected.has(item.path)}
+						style:--frame-inset="3px"
+						style:--frame-arm="16px"
+					>
+						<label class="check">
+							<input
+								type="checkbox"
+								checked={selected.has(item.path)}
+								onchange={() => toggle(item.path)}
+							/>
+						</label>
 					<button
 						type="button"
-						class="media"
+						class="media a-photo"
 						onclick={() => openPreview(item)}
 						title={item.name}
 					>
-						<SafeMedia src={assetUrl(item.path)} kind={item.kind} alt={item.name} controls={false} />
-					</button>
-					<div class="meta">
-						<span class="name" title={item.name}>{item.name}</span>
-						<span class="sub">{item.kind} · {fmtSize(item.size)}</span>
+							<SafeMedia src={assetUrl(item.path)} kind={item.kind} alt={item.name} controls={false} />
+						</button>
+						<div class="meta">
+							<span class="name" title={item.name}>{item.name}</span>
+							<span class="sub">{item.kind} · {fmtSize(item.size)}</span>
+						</div>
+						<div class="card-actions">
+							<Button variant="secondary" onclick={() => (attachItem = item)}>
+								{t('library.addToProject')}
+							</Button>
+						</div>
 					</div>
-					<div class="card-actions">
-						<Button variant="secondary" onclick={() => (attachItem = item)}>
-							{t('library.addToProject')}
-						</Button>
-					</div>
-				</div>
-			{/each}
-		</div>
-		{#if hasMore}
-			<div class="load-more" bind:this={sentinel} aria-hidden="true"></div>
-			<div class="more-row">
-				{#if loadingMore}
-					<span class="loading-note">{t('library.loadingMore')}</span>
-				{:else}
-					<Button variant="secondary" onclick={loadMore}>
-						{t('library.loadMore', { count: remaining })}
-					</Button>
-				{/if}
+				{/each}
 			</div>
+			{#if hasMore}
+				<div class="load-more" bind:this={sentinel} aria-hidden="true"></div>
+				<div class="more-row">
+					{#if loadingMore}
+						<span class="loading-note">{t('library.loadingMore')}</span>
+					{:else}
+						<Button variant="secondary" onclick={loadMore}>
+							{t('library.loadMore', { count: remaining })}
+						</Button>
+					{/if}
+				</div>
+			{/if}
 		{/if}
-	{/if}
-</main>
+	</div>
+</AppShell>
 
 {#if preview}
 	<ImageLightbox
@@ -249,118 +269,85 @@
 	/>
 {/if}
 
-{#if attachItem}
-	<div class="modal-backdrop">
-		<div
-			class="modal"
-			role="dialog"
-			aria-modal="true"
-			aria-label={t('library.addToProject')}
-		>
-			<div class="modal-head">
-				<strong>{t('library.addToProject')}</strong>
-				<button type="button" class="modal-close" onclick={() => (attachItem = null)}>
-					<Icon name="close" size={14} />
-				</button>
-			</div>
-			<p class="modal-file">{attachItem.name}</p>
-			<AttachToProject path={attachItem.path} kind={attachItem.kind} />
-		</div>
-	</div>
-{/if}
+<Modal
+	open={attachItem !== null}
+	title={t('library.addToProject')}
+	onclose={() => (attachItem = null)}
+>
+	{#if attachItem}
+		<p class="modal-file">{attachItem.name}</p>
+		<AttachToProject path={attachItem.path} kind={attachItem.kind} />
+	{/if}
+</Modal>
 
-{#if confirmingDelete}
-	<div class="modal-backdrop" role="presentation">
-		<div class="modal confirm" role="alertdialog" aria-modal="true">
-			<p>{t('library.confirmDelete', { count: selectedCount })}</p>
-			<div class="modal-actions">
-				<Button variant="danger" loading={$deleteMutation.isPending} onclick={deleteSelected}>
-					{t('common.delete')}
-				</Button>
-				<Button variant="ghost" onclick={() => (confirmingDelete = false)}>
-					{t('common.cancel')}
-				</Button>
-			</div>
-		</div>
-	</div>
-{/if}
+<ConfirmDialog
+	open={confirmingDelete}
+	title={t('library.deleteSelected', { count: selectedCount })}
+	message={t('library.confirmDelete', { count: selectedCount })}
+	confirmLabel={t('common.delete')}
+	cancelLabel={t('common.cancel')}
+	danger={true}
+	onconfirm={deleteSelected}
+	oncancel={() => (confirmingDelete = false)}
+/>
 
 <style>
+	.library {
+		padding: 20px 28px 40px;
+		max-width: 1560px;
+		width: 100%;
+		box-sizing: border-box;
+		margin: 0 auto;
+	}
 	.toolbar {
 		display: flex;
 		align-items: center;
-		gap: 16px;
-		margin-bottom: 14px;
+		gap: var(--sp-6);
+		margin-bottom: var(--sp-5);
 		flex-wrap: wrap;
 	}
 	.filters {
 		display: flex;
 		align-items: center;
-		gap: 6px;
-	}
-	.filter-chip {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		padding: 6px 12px;
-		border: 1px solid var(--border);
-		border-radius: 999px;
-		background: transparent;
-		color: var(--text-secondary);
-		font-size: 13px;
-		font-weight: 500;
-		cursor: pointer;
-		transition: color 0.15s, background 0.15s, border-color 0.15s;
-	}
-	.filter-chip:hover {
-		color: var(--text-primary);
-		background: var(--bg-elevated);
-	}
-	.filter-chip.active {
-		color: var(--text-primary);
-		background: var(--bg-elevated);
-		border-color: var(--accent);
-	}
-	.filter-chip:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
+		gap: var(--sp-2);
+		flex-wrap: wrap;
 	}
 	.chip-count {
-		font-size: 11px;
-		color: var(--text-muted);
-		background: rgba(255, 255, 255, 0.06);
-		border-radius: 999px;
-		padding: 1px 7px;
+		font-size: var(--fs-mini);
+		color: var(--text-3);
+		font-variant-numeric: tabular-nums;
 	}
 	.select-all {
 		display: flex;
 		align-items: center;
-		gap: 8px;
-		font-size: 13px;
-		color: var(--text-secondary);
+		gap: var(--sp-3);
+		font-size: var(--fs-body-sm);
+		color: var(--text-2);
 		cursor: pointer;
 	}
-	.count {
-		font-size: 13px;
-		color: var(--text-muted);
+	.select-all input {
+		accent-color: var(--accent-lo);
+		width: 15px;
+		height: 15px;
+		cursor: pointer;
 	}
 	.grid {
 		display: grid;
 		grid-template-columns: repeat(auto-fill, minmax(220px, 1fr));
-		gap: 14px;
+		gap: var(--sp-4);
 	}
 	.card {
 		position: relative;
 		display: flex;
 		flex-direction: column;
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-md);
+		background: var(--bg-2);
+		border: 1px solid var(--line);
+		border-radius: var(--r-lg);
 		overflow: hidden;
-		transition: border-color 0.15s ease;
+		transition: border-color var(--d-state) ease;
 	}
 	.card.selected {
-		border-color: var(--accent);
+		background: linear-gradient(180deg, var(--accent-soft), transparent 32%), var(--bg-2);
 	}
 	.card :global(.media-el) {
 		object-fit: cover;
@@ -370,22 +357,22 @@
 	}
 	.check {
 		position: absolute;
-		top: 8px;
-		left: 8px;
+		top: var(--sp-3);
+		left: var(--sp-3);
 		z-index: 2;
 		display: flex;
 		align-items: center;
 		justify-content: center;
 		width: 26px;
 		height: 26px;
-		background: rgba(0, 0, 0, 0.55);
-		border-radius: var(--radius-sm);
+		background: var(--media-scrim);
+		border-radius: var(--r-sm);
 		cursor: pointer;
 	}
 	.check input {
 		width: 15px;
 		height: 15px;
-		accent-color: var(--accent);
+		accent-color: var(--accent-lo);
 		cursor: pointer;
 	}
 	.media {
@@ -394,10 +381,18 @@
 		height: 150px;
 		padding: 0;
 		border: none;
-		background: rgba(0, 0, 0, 0.3);
+		background: var(--media-scrim);
 		cursor: zoom-in;
 		overflow: hidden;
 	}
+	/* 相纸白边 (HEL-680)：素材墙里的作品按相纸呈现 */
+	.media.a-photo {
+		border: var(--paper-w, 4px) solid var(--accent);
+		border-bottom-width: calc(var(--paper-w, 4px) + 2px);
+		background: var(--accent);
+		border-radius: 0;
+		box-sizing: border-box;
+	}
 	.media :global(img),
 	.media :global(video) {
 		width: 100%;
@@ -408,22 +403,22 @@
 		display: flex;
 		flex-direction: column;
 		gap: 2px;
-		padding: 10px 12px 6px;
+		padding: var(--sp-4) var(--sp-5) var(--sp-2);
 		min-width: 0;
 	}
 	.name {
-		font-size: 13px;
-		color: var(--text-primary);
+		font-size: var(--fs-body);
+		color: var(--text);
 		overflow: hidden;
 		text-overflow: ellipsis;
 		white-space: nowrap;
 	}
 	.sub {
-		font-size: 11px;
-		color: var(--text-muted);
+		font-size: var(--fs-mini);
+		color: var(--text-3);
 	}
 	.card-actions {
-		padding: 8px 12px 12px;
+		padding: var(--sp-3) var(--sp-5) var(--sp-5);
 	}
 	.load-more {
 		height: 1px;
@@ -431,65 +426,28 @@
 	.more-row {
 		display: flex;
 		justify-content: center;
-		padding: 18px 0 6px;
+		padding: var(--sp-6) 0 var(--sp-2);
 	}
 	.loading-note {
-		font-size: 13px;
-		color: var(--text-muted);
-	}
-	.modal-backdrop {
-		position: fixed;
-		inset: 0;
-		z-index: 60;
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		background: rgba(0, 0, 0, 0.6);
-		padding: 20px;
-	}
-	.modal {
-		width: min(420px, 100%);
-		background: var(--bg-elevated);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-lg);
-		padding: 16px;
-	}
-	.modal.confirm {
-		width: min(360px, 100%);
-	}
-	.modal-head {
-		display: flex;
-		align-items: center;
-		justify-content: space-between;
-		margin-bottom: 8px;
-	}
-	.modal-close {
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		width: 24px;
-		height: 24px;
-		border: none;
-		border-radius: var(--radius-sm);
-		background: transparent;
-		color: var(--text-muted);
-		cursor: pointer;
-	}
-	.modal-close:hover {
-		color: var(--text-primary);
-		background: rgba(255, 255, 255, 0.06);
+		font-size: var(--fs-body-sm);
+		color: var(--text-3);
 	}
 	.modal-file {
-		margin: 0 0 10px;
-		font-size: 12px;
-		color: var(--text-muted);
+		margin: 0 0 var(--sp-4);
+		font-size: var(--fs-aux);
+		color: var(--text-3);
 		overflow: hidden;
 		text-overflow: ellipsis;
 		white-space: nowrap;
 	}
-	.modal-actions {
-		display: flex;
-		gap: 8px;
-		margin-top: 12px;
+
+	@media (max-width: 760px) {
+		.library {
+			padding: var(--sp-5) var(--sp-5) var(--sp-8);
+		}
+		.grid {
+			grid-template-columns: repeat(auto-fill, minmax(150px, 1fr));
+			gap: var(--sp-3);
+		}
 	}
 </style>

calliope-web/src/routes/library/+page.ts

@@ -1,8 +1,2 @@
-import { redirect } from '@sveltejs/kit';
-
 export const ssr = false;
 export const prerender = false;
-
-export function load() {
-	redirect(308, '/');
-}

calliope-web/src/routes/models/+page.svelte

@@ -392,14 +392,8 @@
 		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: '视' },
+		{ 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: '镜' },
@@ -1097,11 +1091,13 @@
 		padding: 0;
 		font-family: inherit;
 		font-size: 12px;
-		color: var(--accent);
+		color: var(--text-2);
 		cursor: pointer;
 	}
 	.link-accent:hover {
+		color: var(--text);
 		text-decoration: underline;
+		text-underline-offset: 3px;
 	}
 
 	/* ---------------- notice bar (§9.5) ---------------- */
@@ -1414,7 +1410,7 @@
 			overflow-y: auto;
 			transform: translateX(100%);
 			transition: transform 250ms cubic-bezier(0.16, 1, 0.3, 1);
-			box-shadow: -24px 0 64px rgba(0, 0, 0, 0.4);
+			box-shadow: var(--shadow-float);
 		}
 		.form-col.open {
 			transform: translateX(0);
@@ -1437,7 +1433,7 @@
 		}
 	}
 
-	@media (max-width: 1023px) {
+	@media (max-width: 760px) {
 		.page {
 			padding: 16px 16px 32px;
 		}

calliope-web/src/routes/playground/+page.svelte

@@ -36,6 +36,6 @@
 		font-size: 14px;
 	}
 	.redirect-error {
-		color: #f87171;
+		color: var(--err);
 	}
 </style>

calliope-web/src/routes/project/[id]/+page.svelte

@@ -1,309 +0,0 @@
-<script lang="ts">
-	import { onMount } from 'svelte';
-	import { toStore } from 'svelte/store';
-	import { goto } from '$app/navigation';
-	import { page } from '$app/state';
-	import { createQuery, useQueryClient } from '@tanstack/svelte-query';
-	import NavRail from '$lib/components/NavRail.svelte';
-	import StoryStage from '$lib/components/StoryStage.svelte';
-	import AssetsStage from '$lib/components/AssetsStage.svelte';
-	import ScriptStage from '$lib/components/ScriptStage.svelte';
-	import QueueStage from '$lib/components/QueueStage.svelte';
-	import ActivityPanel from '$lib/components/ActivityPanel.svelte';
-	import AppHeader from '$lib/components/AppHeader.svelte';
-	import Button from '$lib/components/ui/Button.svelte';
-	import EmptyState from '$lib/components/ui/EmptyState.svelte';
-	import Icon from '$lib/components/ui/Icon.svelte';
-	import Skeleton from '$lib/components/ui/Skeleton.svelte';
-	import StatusChip from '$lib/components/ui/StatusChip.svelte';
-	import { t } from '$lib/i18n.svelte';
-	import { jobsApi, projects, settings } from '$lib/api';
-	import { connectEvents, type CalliopeEvent, type EventConnectionState } from '$lib/events';
-	import { handleJobEvent } from '$lib/jobProgress';
-
-	interface Props {
-		data: { id: string };
-	}
-
-	let { data }: Props = $props();
-	const client = useQueryClient();
-	const projectId = $derived(Number(data.id));
-	const enabled = $derived(!isNaN(projectId));
-
-	// Stage <-> URL contract: the active stage lives in ?stage=story|assets|script|video.
-	// Switching stages = goto('?stage=<id>'); deep links and browser Back/Forward work.
-	const STAGES = ['story', 'assets', 'script', 'video'] as const;
-	type Stage = (typeof STAGES)[number];
-
-	function stageFromUrl(url: URL): Stage {
-		const s = url.searchParams.get('stage');
-		return (STAGES as readonly string[]).includes(s ?? '') ? (s as Stage) : 'story';
-	}
-
-	const STAGE_LABELS: Record<Stage, string> = {
-		story: '1 · Story',
-		assets: '2 · Assets',
-		script: '3 · Script',
-		video: '4 · Video',
-	};
-
-	let activeTab = $state<Stage>(stageFromUrl(page.url));
-	let activityCollapsed = $state(false);
-	let logs = $state<CalliopeEvent[]>([]);
-	let connState = $state<EventConnectionState>('connecting');
-
-	// URL → state: deep links, browser Back/Forward
-	$effect(() => {
-		const s = stageFromUrl(page.url);
-		if (s !== activeTab) activeTab = s;
-	});
-
-	// State → URL: every stage switch goes through goto so history works
-	function selectStage(id: string) {
-		const stage: Stage = (STAGES as readonly string[]).includes(id) ? (id as Stage) : 'story';
-		if (stage === activeTab) return;
-		activeTab = stage;
-		goto(`?stage=${stage}`, { keepFocus: true, noScroll: true });
-	}
-
-	const storyQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['story', projectId],
-			queryFn: () => projects.getStory(projectId),
-			enabled,
-		})),
-	);
-
-	const settingsQuery = createQuery({
-		queryKey: ['settings'],
-		queryFn: settings.get,
-	});
-
-	// Same query keys as QueueStage/ActivityPanel — cache is shared.
-	// Refreshes are SSE-driven (job.* events + events.resync below), no polling.
-	const jobsQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['jobs', projectId],
-			queryFn: () => jobsApi.list(projectId),
-			enabled,
-		})),
-	);
-
-	const queueStatusQuery = createQuery(
-		toStore(() => ({
-			queryKey: ['queue-status'],
-			queryFn: jobsApi.queueStatus,
-			enabled,
-		})),
-	);
-
-	const isConfigured = $derived(
-		Boolean($settingsQuery.data?.llm_base_url && $settingsQuery.data?.llm_model),
-	);
-	const projectTitle = $derived($storyQuery.data?.project?.title ?? 'Project');
-
-	const runningCount = $derived(
-		($jobsQuery.data ?? []).filter((j) => j.status === 'running').length,
-	);
-	const queuedCount = $derived(
-		($jobsQuery.data ?? []).filter((j) => j.status === 'pending').length,
-	);
-	const queuePaused = $derived(Boolean($queueStatusQuery.data?.paused));
-
-	onMount(() => {
-		return connectEvents(
-			(ev) => {
-				if (ev.type === 'events.resync') {
-					// SSE reconnected: refill anything missed while the stream was down.
-					client.invalidateQueries({ queryKey: ['jobs'] });
-					client.invalidateQueries({ queryKey: ['queue-status'] });
-					client.invalidateQueries({ queryKey: ['assets'] });
-					client.invalidateQueries({ queryKey: ['story'] });
-					client.invalidateQueries({ queryKey: ['scenes'] });
-					return;
-				}
-				// Live per-job progress for ProgressBars (Activity log stays clean)
-				handleJobEvent(ev);
-				// Don't keep Comfy poll ticks in the Activity log
-				if (ev.type !== 'job.progress') {
-					logs = [...logs, ev].slice(-120);
-				}
-				if (
-					ev.type.startsWith('job.') ||
-					ev.type === 'asset.ready' ||
-					ev.type === 'agent.thinking' ||
-					ev.type.startsWith('story.')
-				) {
-					client.invalidateQueries({ queryKey: ['jobs'] });
-					client.invalidateQueries({ queryKey: ['queue-status'] });
-					client.invalidateQueries({ queryKey: ['assets'] });
-					client.invalidateQueries({ queryKey: ['story'] });
-					client.invalidateQueries({ queryKey: ['scenes'] });
-				}
-			},
-			(state) => (connState = state),
-		);
-	});
-</script>
-
-<div class="shell">
-	<AppHeader crumb={`· ${projectTitle}`} />
-
-	{#if !enabled}
-		<div class="invalid-wrap">
-			<EmptyState
-				title={t('project.notFound')}
-				body={t('project.invalidIdBody', { id: data.id })}
-			>
-				{#snippet icon()}
-					<Icon name="folder" size={28} />
-				{/snippet}
-				{#snippet action()}
-					<Button variant="primary" onclick={() => goto('/projects')}>{t('project.backToProjects')}</Button>
-				{/snippet}
-			</EmptyState>
-		</div>
-	{:else}
-		<div class="workspace-bar">
-			<span class="stage-label">{STAGE_LABELS[activeTab]}</span>
-			<Button
-				variant="secondary"
-				size="sm"
-				title={t('project.openVideoStage')}
-				onclick={() => selectStage('video')}
-			>
-				<Icon name="queue" size={13} />
-				{runningCount + queuedCount > 0
-					? t('project.runningQueued', { running: runningCount, queued: queuedCount })
-					: t('project.queueIdle')}
-				{#if queuePaused}
-					<StatusChip status="paused" />
-				{/if}
-			</Button>
-		</div>
-
-		<div class="workspace">
-			<NavRail active={activeTab} onSelect={selectStage} />
-
-			<main class="stage" class:stage-fill={activeTab === 'video'}>
-				{#if activeTab === 'story'}
-					{#if $storyQuery.isLoading}
-						<div class="card skel" aria-busy="true">
-							<Skeleton width="36%" height="22px" />
-							<Skeleton width="88%" />
-							<Skeleton width="72%" />
-							<Skeleton height="140px" />
-						</div>
-					{:else if $storyQuery.isError}
-						<div class="card" style="color: var(--error)">
-							Failed to load story: {$storyQuery.error?.message ?? 'unknown error'}
-						</div>
-					{:else if $storyQuery.data}
-						<StoryStage
-							{projectId}
-							story={$storyQuery.data}
-							configured={isConfigured}
-							onGoAssets={() => selectStage('assets')}
-						/>
-					{/if}
-				{:else if activeTab === 'assets'}
-					<AssetsStage {projectId} />
-				{:else if activeTab === 'script'}
-					<ScriptStage {projectId} />
-				{:else if activeTab === 'video'}
-					<QueueStage {projectId} {projectTitle} />
-				{/if}
-			</main>
-
-			<ActivityPanel
-				{logs}
-				{projectId}
-				{connState}
-				collapsed={activityCollapsed}
-				onToggle={() => (activityCollapsed = !activityCollapsed)}
-			/>
-		</div>
-	{/if}
-</div>
-
-<style>
-	.shell {
-		display: flex;
-		flex-direction: column;
-		height: 100vh;
-		overflow: hidden;
-	}
-	.invalid-wrap {
-		flex: 1;
-		display: flex;
-		align-items: center;
-		justify-content: center;
-		padding: var(--space-lg);
-		overflow-y: auto;
-	}
-	.workspace-bar {
-		display: flex;
-		align-items: center;
-		justify-content: space-between;
-		gap: var(--space-md);
-		padding: 8px var(--space-lg);
-		border-bottom: 1px solid var(--border);
-		background: var(--bg-surface);
-		flex-shrink: 0;
-	}
-	.stage-label {
-		font-family: var(--font-display);
-		font-size: 13px;
-		font-weight: 600;
-		letter-spacing: 0.02em;
-		color: var(--text-secondary);
-	}
-	.workspace {
-		display: flex;
-		flex: 1;
-		overflow: hidden;
-	}
-	.stage {
-		flex: 1;
-		padding: var(--space-lg);
-		overflow-y: auto;
-		background: var(--bg-primary);
-		min-width: 0;
-	}
-	.stage.stage-fill {
-		overflow: hidden;
-		display: flex;
-		flex-direction: column;
-		min-height: 0;
-		/* Bleed to column edges — Nav/Activity already frame the stage.
-		   Old max-width+margin:auto looked off-center because this column
-		   sits between unequal side rails. */
-		padding: 12px 0 12px;
-	}
-	.stage.stage-fill > :global(.queue-root) {
-		flex: 1;
-		min-height: 0;
-		padding-inline: 16px;
-	}
-	/* Player hero breaks out to full stage width; strip/composer keep inset */
-	.stage.stage-fill :global(.hero) {
-		margin-inline: -16px;
-		width: auto;
-	}
-	.stage.stage-fill :global(.hero .frame) {
-		border-radius: 0;
-		border-left: none;
-		border-right: none;
-	}
-	.card {
-		background: var(--bg-surface);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-md);
-		padding: var(--space-lg);
-	}
-	.skel {
-		display: flex;
-		flex-direction: column;
-		gap: 12px;
-	}
-</style>

calliope-web/src/routes/projects/+page.svelte

@@ -1,458 +0,0 @@
-<script lang="ts">
-	import { goto } from '$app/navigation';
-	import { createMutation, createQuery, useQueryClient } from '@tanstack/svelte-query';
-	import { projects, type Project } from '$lib/api';
-	import { t } from '$lib/i18n.svelte';
-	import AppHeader from '$lib/components/AppHeader.svelte';
-	import Button from '$lib/components/ui/Button.svelte';
-	import EmptyState from '$lib/components/ui/EmptyState.svelte';
-	import Icon from '$lib/components/ui/Icon.svelte';
-	import ProjectCard from '$lib/components/ProjectCard.svelte';
-	import Skeleton from '$lib/components/ui/Skeleton.svelte';
-	import { toast } from '$lib/toast';
-
-	const client = useQueryClient();
-
-	const projectsQuery = createQuery({
-		queryKey: ['projects'],
-		queryFn: projects.list,
-	});
-
-	const createProjectMutation = createMutation({
-		mutationFn: projects.create,
-		onSuccess: (data: Project) => {
-			client.invalidateQueries({ queryKey: ['projects'] });
-			toast.success(t('projects.created', { title: data.title }));
-			goto(`/project/${data.id}`);
-		},
-		onError: (err) => {
-			toast.error(err instanceof Error ? err.message : t('projects.createFailed'));
-		},
-	});
-
-	// English values are sent to the backend; display labels come from the dictionary.
-	const GENRES: Record<string, string> = {
-		'Adventure / Mystery': 'genres.adventure',
-		Drama: 'genres.drama',
-		'Sci-Fi': 'genres.scifi',
-		Fantasy: 'genres.fantasy',
-		Horror: 'genres.horror',
-		Romance: 'genres.romance',
-		Thriller: 'genres.thriller',
-	};
-	const TONES: Record<string, string> = {
-		'Cinematic, atmospheric': 'tones.cinematic',
-		'Dark, tense': 'tones.dark',
-		'Whimsical, warm': 'tones.whimsical',
-		'Gritty, realistic': 'tones.gritty',
-		'Epic, sweeping': 'tones.epic',
-	};
-	const DURATIONS: Record<string, string> = {
-		'30 seconds': 'durations.30',
-		'1 minute': 'durations.1m',
-		'2 minutes': 'durations.2m',
-		'5 minutes': 'durations.5m',
-		'10 minutes': 'durations.10m',
-	};
-
-	let title = $state('');
-	let idea = $state('');
-	let genre = $state('Adventure / Mystery');
-	let tone = $state('Cinematic, atmospheric');
-	let duration = $state('2 minutes');
-	let showForm = $state(false);
-	let search = $state('');
-	let filter = $state('all');
-
-	function onCreate(e: Event) {
-		e.preventDefault();
-		if (!title.trim()) return;
-		$createProjectMutation.mutate({
-			title: title.trim(),
-			idea: idea.trim() || undefined,
-			genre: genre || undefined,
-			tone: tone || undefined,
-			target_duration: duration || undefined,
-		});
-	}
-
-	function openForm() {
-		showForm = true;
-		title = '';
-		idea = '';
-		genre = 'Adventure / Mystery';
-		tone = 'Cinematic, atmospheric';
-		duration = '2 minutes';
-	}
-
-	const FILTERS = $derived(
-		[
-			{ id: 'all', key: 'projects.filterAll' },
-			{ id: 'in_progress', key: 'projects.filterProgress' },
-			{ id: 'completed', key: 'projects.filterCompleted' },
-			{ id: 'draft', key: 'projects.filterDraft' },
-		].map((f) => ({ id: f.id, label: t(f.key) })),
-	);
-
-	const all = $derived($projectsQuery.data ?? []);
-	const filtered = $derived.by(() => {
-		let list = all;
-		if (filter !== 'all') list = list.filter((p) => p.status === filter);
-		const q = search.trim().toLowerCase();
-		if (q) {
-			list = list.filter(
-				(p) => p.title.toLowerCase().includes(q) || (p.idea ?? '').toLowerCase().includes(q),
-			);
-		}
-		return list;
-	});
-
-	function clearFilters() {
-		search = '';
-		filter = 'all';
-	}
-</script>
-
-<AppHeader active="projects">
-	<Button variant="primary" onclick={openForm}>
-		<Icon name="plus" size={15} />
-		{t('projects.new')}
-	</Button>
-</AppHeader>
-
-<main class="container">
-	<div class="hero">
-		<div>
-			<h1>{t('projects.title')}</h1>
-			<p>{t('projects.subtitle')}</p>
-		</div>
-	</div>
-
-	{#if showForm}
-		<form class="new-project-card" onsubmit={onCreate}>
-			<div class="form-head">
-				<div>
-					<p class="eyebrow">{t('projects.newReel')}</p>
-					<h3>{t('projects.new')}</h3>
-				</div>
-				<Button variant="ghost" onclick={() => (showForm = false)}>{t('projects.close')}</Button>
-			</div>
-
-			<label class="field">
-				<span class="field-label">{t('projects.titleField')}</span>
-				<input class="field-input" bind:value={title} placeholder={t('projects.titlePlaceholder')} required />
-			</label>
-
-			<label class="field">
-				<span class="field-label">{t('projects.ideaField')}</span>
-				<textarea
-					class="field-textarea"
-					bind:value={idea}
-					placeholder={t('projects.ideaPlaceholder')}
-					rows={4}
-				></textarea>
-				<p class="field-hint">{t('projects.ideaHint')}</p>
-			</label>
-
-			<div class="form-grid">
-				<label class="field">
-					<span class="field-label">{t('projects.genre')}</span>
-					<select class="field-select" bind:value={genre}>
-						{#each Object.keys(GENRES) as v (v)}
-							<option value={v}>{t(GENRES[v])}</option>
-						{/each}
-					</select>
-				</label>
-				<label class="field">
-					<span class="field-label">{t('projects.tone')}</span>
-					<select class="field-select" bind:value={tone}>
-						{#each Object.keys(TONES) as v (v)}
-							<option value={v}>{t(TONES[v])}</option>
-						{/each}
-					</select>
-				</label>
-				<label class="field">
-					<span class="field-label">{t('projects.duration')}</span>
-					<select class="field-select" bind:value={duration}>
-						{#each Object.keys(DURATIONS) as v (v)}
-							<option value={v}>{t(DURATIONS[v])}</option>
-						{/each}
-					</select>
-					<p class="field-hint">{t('projects.durationHint')}</p>
-				</label>
-			</div>
-
-			<div class="form-actions">
-				<Button variant="secondary" onclick={() => (showForm = false)}>{t('projects.cancel')}</Button>
-				<Button variant="primary" type="submit" loading={$createProjectMutation.isPending}>
-					{t('projects.create')}
-				</Button>
-			</div>
-		</form>
-	{/if}
-
-	<div class="toolbar">
-		<input
-			class="search field-input"
-			bind:value={search}
-			placeholder={t('projects.searchPlaceholder')}
-			aria-label={t('projects.searchLabel')}
-		/>
-		<div class="filter-group" role="group" aria-label={t('projects.filterBy')}>
-			{#each FILTERS as f (f.id)}
-				<button
-					type="button"
-					class="pill"
-					class:active={filter === f.id}
-					aria-pressed={filter === f.id}
-					onclick={() => (filter = f.id)}
-				>
-					{f.label}
-				</button>
-			{/each}
-		</div>
-	</div>
-
-	{#if $projectsQuery.isLoading}
-		<div class="grid" aria-busy="true" aria-label={t('projects.loading')}>
-			{#each [1, 2, 3, 4, 5, 6] as n (n)}
-				<div class="skel-card">
-					<Skeleton height="170px" />
-					<div class="skel-body">
-						<Skeleton width="60%" height="16px" />
-						<Skeleton />
-						<Skeleton width="80%" />
-						<Skeleton width="40%" height="12px" />
-					</div>
-				</div>
-			{/each}
-		</div>
-	{:else if $projectsQuery.isError}
-		<EmptyState
-			title={t('projects.loadError')}
-			body={$projectsQuery.error instanceof Error
-				? $projectsQuery.error.message
-				: t('projects.loadErrorBody')}
-		>
-			{#snippet icon()}
-				<Icon name="alert" size={28} />
-			{/snippet}
-			{#snippet action()}
-				<Button variant="primary" onclick={() => $projectsQuery.refetch()}>
-					<Icon name="retry" size={15} />
-					{t('common.retry')}
-				</Button>
-			{/snippet}
-		</EmptyState>
-	{:else if all.length === 0}
-		<EmptyState title={t('projects.emptyTitle')} body={t('projects.emptyBody')}>
-			{#snippet icon()}
-				<Icon name="video" size={28} />
-			{/snippet}
-			{#snippet action()}
-				<Button variant="primary" onclick={openForm}>
-					<Icon name="plus" size={15} />
-					{t('projects.firstProject')}
-				</Button>
-			{/snippet}
-		</EmptyState>
-	{:else if filtered.length === 0}
-		<EmptyState
-			title={search.trim()
-				? t('projects.noMatchSearch', { q: search.trim() })
-				: t('projects.noMatchFilter')}
-			body={t('projects.noMatchBody')}
-		>
-			{#snippet icon()}
-				<Icon name="search" size={28} />
-			{/snippet}
-			{#snippet action()}
-				<Button variant="secondary" onclick={clearFilters}>{t('projects.clearFilters')}</Button>
-			{/snippet}
-		</EmptyState>
-	{:else}
-		<div class="grid">
-			{#each filtered as project (project.id)}
-				<ProjectCard {project} />
-			{/each}
-			<button type="button" class="new-card" onclick={openForm}>
-				<div class="new-card-icon"><Icon name="plus" size={24} /></div>
-				<div class="new-card-title">{t('projects.newCard')}</div>
-				<div class="new-card-sub">{t('projects.newCardSub')}</div>
-			</button>
-		</div>
-	{/if}
-</main>
-
-<style>
-	.container {
-		max-width: 1280px;
-		margin: 0 auto;
-		padding: var(--space-xl);
-	}
-	.hero {
-		display: flex;
-		justify-content: space-between;
-		align-items: flex-end;
-		margin-bottom: var(--space-xl);
-	}
-	.hero h1 {
-		margin: 0 0 var(--space-sm);
-		font-size: 32px;
-	}
-	.hero p {
-		margin: 0;
-		color: var(--text-secondary);
-		font-size: 15px;
-	}
-	.new-project-card {
-		background: rgba(255, 255, 255, 0.03);
-		border: 1px solid rgba(255, 255, 255, 0.08);
-		border-radius: var(--radius-lg);
-		padding: var(--space-lg);
-		margin-bottom: var(--space-xl);
-		box-shadow: 0 0 0 1px rgba(139, 92, 246, 0.08);
-	}
-	.form-head {
-		display: flex;
-		justify-content: space-between;
-		align-items: flex-start;
-		margin-bottom: var(--space-md);
-	}
-	.eyebrow {
-		margin: 0 0 4px;
-		font-size: 11px;
-		text-transform: uppercase;
-		letter-spacing: 0.08em;
-		color: var(--accent);
-		font-weight: 600;
-	}
-	.new-project-card h3 {
-		margin: 0;
-		font-size: 20px;
-	}
-	.form-grid {
-		display: grid;
-		grid-template-columns: 1fr 1fr;
-		gap: var(--space-md);
-	}
-	@media (max-width: 700px) {
-		.form-grid {
-			grid-template-columns: 1fr;
-		}
-	}
-	.form-actions {
-		display: flex;
-		justify-content: flex-end;
-		gap: var(--space-sm);
-		margin-top: var(--space-sm);
-	}
-	.toolbar {
-		display: flex;
-		justify-content: space-between;
-		align-items: center;
-		margin-bottom: var(--space-lg);
-		gap: var(--space-md);
-		flex-wrap: wrap;
-	}
-	.search {
-		flex: 1;
-		max-width: 360px;
-	}
-	.filter-group {
-		display: flex;
-		gap: var(--space-xs);
-	}
-	.pill {
-		border: 1px solid transparent;
-		border-radius: 999px;
-		background: transparent;
-		color: var(--text-secondary);
-		padding: 8px 14px;
-		cursor: pointer;
-		font-size: 13px;
-		font-weight: 500;
-		font-family: inherit;
-		transition:
-			background 0.15s,
-			color 0.15s,
-			border-color 0.15s;
-	}
-	.pill:hover {
-		background: var(--bg-elevated);
-		color: var(--text-primary);
-	}
-	.pill.active {
-		background: var(--bg-elevated);
-		border-color: var(--border);
-		color: var(--text-primary);
-	}
-	.pill:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
-	}
-	.grid {
-		display: grid;
-		grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
-		gap: var(--space-lg);
-	}
-	.skel-card {
-		background: var(--bg-surface);
-		border: 1px solid var(--border);
-		border-radius: var(--radius-lg);
-		overflow: hidden;
-	}
-	.skel-card :global(.skeleton) {
-		border-radius: 0;
-	}
-	.skel-body {
-		display: flex;
-		flex-direction: column;
-		gap: 10px;
-		padding: var(--space-md);
-	}
-	.skel-body :global(.skeleton) {
-		border-radius: var(--radius-sm);
-	}
-	.new-card {
-		border: 2px dashed var(--border);
-		background: transparent;
-		display: flex;
-		flex-direction: column;
-		align-items: center;
-		justify-content: center;
-		min-height: 320px;
-		color: var(--text-muted);
-		gap: var(--space-md);
-		border-radius: var(--radius-lg);
-		cursor: pointer;
-		font-family: inherit;
-		transition: all 0.15s;
-	}
-	.new-card:hover {
-		border-color: var(--accent);
-		color: var(--text-primary);
-		background: rgba(139, 92, 246, 0.04);
-	}
-	.new-card:focus-visible {
-		outline: 2px solid var(--accent);
-		outline-offset: 2px;
-	}
-	.new-card-icon {
-		width: 56px;
-		height: 56px;
-		border-radius: var(--radius-md);
-		background: var(--bg-elevated);
-		display: flex;
-		align-items: center;
-		justify-content: center;
-	}
-	.new-card-title {
-		font-weight: 600;
-		font-size: 15px;
-	}
-	.new-card-sub {
-		font-size: 13px;
-		color: var(--text-muted);
-	}
-</style>

calliope-web/src/routes/settings/+page.svelte

@@ -701,7 +701,7 @@
 	}
 
 	/* ---------------- responsive (§4.5) ---------------- */
-	@media (max-width: 1023px) {
+	@media (max-width: 760px) {
 		.page {
 			flex-direction: column;
 			padding: 18px;

calliope-web/src/routes/tasks/+page.svelte

@@ -401,7 +401,7 @@
 		width: 100%;
 		transform-origin: left;
 		transform: scaleX(var(--p));
-		background: linear-gradient(90deg, #3bbfb4, var(--run));
+		background: var(--run-grad);
 		transition: transform var(--d-progress) linear;
 	}
 
@@ -562,8 +562,8 @@
 	}
 	.tag-test {
 		flex-shrink: 0;
-		background: var(--accent-soft);
-		color: var(--accent);
+		background: var(--bg-4);
+		color: var(--text-2);
 		font-size: 10px;
 		font-weight: 600;
 		padding: 1px 7px;

calliope-web/src/routes/workbench/+page.svelte

@@ -63,7 +63,7 @@
 		{:else if items.length === 0}
 			<EmptyState title={t('workbench.pickerEmpty')} body={t('workbench.pickerEmptyBody')}>
 				{#snippet action()}
-					<a class="entry-btn primary" href="/">{t('workbench.pickerGoHome')}</a>
+					<a class="a-btn primary" href="/">{t('workbench.pickerGoHome')}</a>
 				{/snippet}
 			</EmptyState>
 		{:else}
@@ -167,7 +167,7 @@
 		background: var(--surface-3);
 	}
 	.seg.st-draft {
-		background: var(--accent);
+		background: var(--warn);
 	}
 	.seg.st-confirmed {
 		background: var(--success);
@@ -187,9 +187,9 @@
 	}
 	.jobs-chip {
 		padding: 1px 9px;
-		border-radius: 999px;
-		background: var(--accent-dim);
-		color: var(--accent);
+		border-radius: var(--r-pill);
+		background: var(--run-soft);
+		color: var(--run);
 		font-size: 10.5px;
 		font-weight: 600;
 		font-variant-numeric: tabular-nums;
@@ -207,23 +207,7 @@
 		text-align: center;
 	}
 
-	.entry-btn.primary {
-		display: inline-flex;
-		align-items: center;
-		justify-content: center;
-		padding: 9px 18px;
-		border-radius: 8px;
-		background: var(--accent);
-		color: var(--accent-contrast);
-		font-size: 13px;
-		font-weight: 600;
-		text-decoration: none;
-	}
-	.entry-btn.primary:hover {
-		filter: brightness(1.08);
-	}
-
-	@media (max-width: 780px) {
+	@media (max-width: 760px) {
 		.picker {
 			padding: 16px 14px 32px;
 		}

calliope-web/src/routes/workbench/[id]/+page.svelte

@@ -313,10 +313,10 @@
 		confirmed: 'workbench.state.confirmed',
 	};
 	const STATUS_CLASS: Record<string, string> = {
-		todo: 'st-todo',
-		running: 'st-running',
-		awaiting_confirm: 'st-draft',
-		confirmed: 'st-confirmed',
+		todo: '',
+		running: 'run',
+		awaiting_confirm: 'warn',
+		confirmed: 'ok',
 	};
 
 	const stageStatus = $derived(currentStage?.status ?? 'todo');
@@ -335,7 +335,7 @@
 
 <AppShell active="workbench" title={overview?.project.title ?? t('workbench.title')} subtitle={t('workbench.subtitle')}>
 	{#snippet actions()}
-		<span class="chip">{t('workbench.progressChip', { n: confirmedCount })}</span>
+		<span class="status-chip">{t('workbench.progressChip', { n: confirmedCount })}</span>
 		<a class="ghost-link" href="/">{t('workbench.backHome')}</a>
 	{/snippet}
 
@@ -366,12 +366,12 @@
 						<p class="stage-tag">{currentAgent?.tagline ?? ''}</p>
 					</div>
 					<div class="stage-head-state">
-						<span class="state-chip {STATUS_CLASS[stageStatus]}">
+						<span class="a-tag {STATUS_CLASS[stageStatus]}">
 							{#if stageStatus === 'running'}<span class="breath"></span>{/if}
 							{t(STATUS_LABEL[stageStatus])}
 						</span>
 						{#if currentStage && currentStage.draft_edited && stageStatus !== 'todo'}
-							<span class="edited-chip">{t('workbench.state.edited')}</span>
+							<span class="a-tag warn">{t('workbench.state.edited')}</span>
 						{/if}
 					</div>
 				</div>
@@ -399,7 +399,7 @@
 
 				<div class="instruction-row">
 					<input
-						class="wb-input"
+						class="a-input"
 						bind:value={instruction}
 						placeholder={t('workbench.instructionPh')}
 						disabled={busyFor(stageKey)}
@@ -408,7 +408,7 @@
 					{#if stageStatus === 'todo'}
 						<button
 							type="button"
-							class="btn primary"
+							class="a-btn primary"
 							disabled={busyFor(stageKey) || $runMutation.isPending}
 							onclick={() => handleRun(stageKey)}
 							data-testid="stage-run-btn"
@@ -420,7 +420,7 @@
 					{#if stageStatus === 'awaiting_confirm'}
 						<button
 							type="button"
-							class="btn primary"
+							class="a-btn primary"
 							disabled={$confirmMutation.isPending}
 							onclick={() => $confirmMutation.mutate(stageKey)}
 							data-testid="stage-confirm-btn"
@@ -432,7 +432,7 @@
 					{#if stageStatus === 'confirmed' && currentStage?.draft_edited}
 						<button
 							type="button"
-							class="btn ghost"
+							class="a-btn ghost"
 							disabled={$restoreMutation.isPending}
 							onclick={() => $restoreMutation.mutate(stageKey)}
 							data-testid="stage-restore-btn"
@@ -496,7 +496,11 @@
 		<aside class="side-col">
 			{#if currentAgent}
 				<div class="side-card agent-card">
-					<span class="agent-avatar" style:background={`var(--avatar-${currentAgent.avatar})`}>
+					<span
+						class="agent-avatar"
+						class:light={(currentAgent.avatar ?? 1) <= 2}
+						style:background={`var(--avatar-${currentAgent.avatar})`}
+					>
 						{currentAgent.char}
 					</span>
 					<div class="agent-copy">
@@ -506,7 +510,7 @@
 							{#if currentModelName}· {currentModelName}{/if}
 						</span>
 					</div>
-					<button type="button" class="btn ghost sm" onclick={openAgentChat}>
+					<button type="button" class="a-btn ghost sm" onclick={openAgentChat}>
 						{t('workbench.chatWithAgent')}
 					</button>
 				</div>
@@ -659,40 +663,6 @@
 		flex-shrink: 0;
 	}
 
-	.state-chip {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		padding: 2px 10px;
-		border-radius: 999px;
-		font-size: 11px;
-		font-weight: 600;
-	}
-	.st-todo {
-		color: var(--text-2);
-		background: var(--surface-3);
-	}
-	.st-running {
-		color: var(--run);
-		background: var(--run-soft);
-	}
-	.st-draft {
-		color: var(--warn);
-		background: var(--warn-soft);
-	}
-	.st-confirmed {
-		color: var(--success);
-		background: var(--success-dim);
-	}
-	.edited-chip {
-		padding: 2px 10px;
-		border-radius: 999px;
-		font-size: 11px;
-		font-weight: 600;
-		color: var(--warn);
-		background: var(--warn-soft);
-	}
-
 	.error-banner {
 		display: flex;
 		align-items: flex-start;
@@ -733,7 +703,7 @@
 		gap: 10px;
 		align-items: center;
 	}
-	.instruction-row .wb-input {
+	.instruction-row .a-input {
 		flex: 1;
 	}
 
@@ -774,6 +744,10 @@
 		color: var(--text);
 		flex-shrink: 0;
 	}
+	/* HEL-680 灰阶头像：1–2 亮阶用深字 */
+	.agent-avatar.light {
+		color: var(--accent-ink);
+	}
 	.agent-copy {
 		display: flex;
 		flex-direction: column;
@@ -918,18 +892,9 @@
 	}
 
 	/* ── shared bits ── */
-	.chip {
-		padding: 3px 11px;
-		border-radius: 999px;
-		background: var(--surface-3);
-		color: var(--text-2);
-		font-size: 11.5px;
-		font-variant-numeric: tabular-nums;
-		white-space: nowrap;
-	}
 	.ghost-link {
 		color: var(--text-2);
-		font-size: 12px;
+		font-size: var(--fs-aux);
 		text-decoration: none;
 	}
 	.ghost-link:hover {
@@ -944,67 +909,6 @@
 		text-decoration: underline;
 	}
 
-	.wb-input {
-		padding: 9px 12px;
-		background: var(--surface-2);
-		border: 1px solid var(--border-strong);
-		border-radius: 8px;
-		color: var(--text);
-		font-family: inherit;
-		font-size: 12.5px;
-		box-sizing: border-box;
-		transition: border-color 150ms;
-	}
-	.wb-input:focus {
-		outline: none;
-		border-color: var(--accent-line);
-	}
-	.wb-input::placeholder {
-		color: var(--text-3);
-	}
-
-	.btn {
-		display: inline-flex;
-		align-items: center;
-		gap: 6px;
-		padding: 9px 15px;
-		border-radius: 8px;
-		border: 1px solid transparent;
-		font-family: inherit;
-		font-size: 12.5px;
-		cursor: pointer;
-		white-space: nowrap;
-		transition:
-			background-color 150ms cubic-bezier(0.16, 1, 0.3, 1),
-			border-color 150ms,
-			opacity 150ms;
-	}
-	.btn.primary {
-		background: var(--accent);
-		color: var(--accent-contrast);
-		font-weight: 600;
-	}
-	.btn.primary:hover:not(:disabled) {
-		filter: brightness(1.08);
-	}
-	.btn.ghost {
-		background: var(--surface-2);
-		border-color: var(--border-strong);
-		color: var(--text-2);
-	}
-	.btn.ghost:hover:not(:disabled) {
-		color: var(--text);
-		border-color: var(--line-2);
-	}
-	.btn.sm {
-		padding: 6px 11px;
-		font-size: 11.5px;
-	}
-	.btn:disabled {
-		opacity: 0.4;
-		cursor: not-allowed;
-	}
-
 	.icon-btn {
 		display: inline-flex;
 		align-items: center;
@@ -1066,9 +970,9 @@
 			flex: 1 1 260px;
 		}
 	}
-	@media (max-width: 900px) {
+	@media (max-width: 760px) {
 		.wb-page {
-			padding: 4px 14px 24px;
+			padding: 4px var(--sp-4) 24px;
 		}
 		.instruction-row {
 			flex-direction: column;

calliope-web/svelte.config.js

@@ -14,12 +14,6 @@ const config = {
 			// finds the bundle. adapter-static otherwise emits ./_app on prerendered pages.
 			relative: false,
 		},
-		prerender: {
-			handleHttpError: ({ path, message }) => {
-				if (path === '/favicon.png') return;
-				throw new Error(message);
-			},
-		},
 	},
 };
 

e2e/fake_comfy.py

@@ -1,9 +1,18 @@
-"""Standalone fake ComfyUI for HEL-654 D-batch browser validation.
+"""Standalone fake ComfyUI for HEL-654 D-batch / HEL-655 E-batch browser validation.
 
-Mode file e2e/fake_mode.json: {"mode": "ok"|"fail", "delay_sec": 0}
+Mode file e2e/fake_mode.json:
+{"mode": "ok"|"fail", "delay_sec": 0, "videos": false,
+ "object_info": {class_type: {...}}, "no_outputs": false}
 - ok + delay 0: history is ready immediately (job completes fast)
 - ok + delay N: history appears N seconds after /prompt (progress state)
 - fail: /prompt returns 500 (job fails with a Chinese error from the worker)
+- object_info: when present, /object_info serves this catalogue verbatim —
+  the E-batch script builds it from the workflow it imports so the L2 check
+  can be driven all-green (every class present) or missing-node (catalogue
+  omits classes). Absent → {} (every node "missing").
+- no_outputs: history entries complete with no files (test-run no-output pass)
+- video_file: absolute path of an mp4 served (and named) as the video output
+  instead of tiny.mp4 (HEL-669 last-frame export runs real clips through it)
 """
 from __future__ import annotations
 import json, threading, uuid
@@ -39,7 +48,7 @@ class Handler(BaseHTTPRequestHandler):
                              "devices": [{"name": "FakeGPU", "type": "cuda"}]})
             return
         if self.path == "/object_info":
-            self._json(200, {})
+            self._json(200, read_mode().get("object_info") or {})
             return
         if self.path == "/queue":
             # Prompts accepted but not yet in history: first one "running",
@@ -57,7 +66,8 @@ class Handler(BaseHTTPRequestHandler):
             return
         if self.path.startswith("/view"):
             if "fmt=mp4" in self.path or ".mp4" in self.path:
-                self._raw(200, MP4.read_bytes(), "video/mp4")
+                src = read_mode().get("video_file")
+                self._raw(200, Path(src).read_bytes() if src else MP4.read_bytes(), "video/mp4")
             else:
                 self._raw(200, PNG_1PX, "image/png")
             return
@@ -74,11 +84,16 @@ class Handler(BaseHTTPRequestHandler):
             pid = uuid.uuid4().hex
             self.server.accepted.append(pid)
             videos = mode.get("videos") is True
-            out_name = "out-1.mp4" if videos else "out-1.png"
+            no_outputs = mode.get("no_outputs") is True
+            video_file = mode.get("video_file")
+            out_name = (Path(video_file).stem + ".mp4" if video_file else "out-1.mp4") if videos else "out-1.png"
             key = "videos" if videos else "images"
+            outputs = {} if no_outputs else {
+                self._output_node(body): {key: [{"filename": out_name, "subfolder": "", "type": "output"}]}
+            }
             entry = {
                 "status": {"status_str": "success", "completed": True},
-                "outputs": {self._output_node(body): {key: [{"filename": out_name, "subfolder": "", "type": "output"}]}},
+                "outputs": outputs,
                 "prompt": [],
             }
             delay = float(mode.get("delay_sec") or 0)

e2e/fpages.mjs

@@ -0,0 +1,176 @@
+/* HEL-656 F 批 browser validation against the isolated stack:
+ * vite dev (5173) → backend (8247) → fake ComfyUI (18188).
+ * Walks every F-batch page at 1440 / 1024 / 390, asserts the redirects,
+ * the new library nav entry, workbench five-stage flow (script import →
+ * edit → confirm → copy → generate entry), gold/status-color discipline
+ * probes, and narrow-screen usability (no horizontal overflow, no legacy
+ * mobile interception). Screenshots land in e2e/shots/hel656-*.png. */
+import { chromium } from 'playwright';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = path.dirname(fileURLToPath(import.meta.url));
+const SHOTS = path.join(ROOT, 'shots');
+fs.mkdirSync(SHOTS, { recursive: true });
+const BASE = 'http://127.0.0.1:5173';
+const API = 'http://127.0.0.1:8247';
+
+let failures = 0;
+function ok(name, cond, extra = '') {
+	const line = `${cond ? 'PASS' : 'FAIL'}  ${name}${extra ? '  — ' + extra : ''}`;
+	console.log(line);
+	if (!cond) failures++;
+}
+
+const api = async (p, init) => {
+	const r = await fetch(API + p, { headers: { 'Content-Type': 'application/json' }, ...init });
+	const body = await r.text();
+	try {
+		return JSON.parse(body);
+	} catch {
+		return { raw: body, status: r.status };
+	}
+};
+
+const browser = await chromium.launch();
+const WIDTHS = [
+	['1440', 1440],
+	['1024', 1024],
+	['390', 390],
+];
+
+async function shot(page, name) {
+	await page.screenshot({ path: `${SHOTS}/hel656-${name}.png`, fullPage: false });
+}
+
+// ---------- project + workbench E2E via API + UI ----------
+const proj = await api('/api/projects', {
+	method: 'POST',
+	body: JSON.stringify({ title: 'F批回归·五段', idea: '一个关于灯塔看守人的短篇' }),
+});
+const pid = proj.id;
+ok('创建项目', !!pid);
+
+// 剧本导入（不依赖 LLM）→ 剧本段直接确认
+const imp = await api(`/api/workbench/projects/${pid}/stages/script/import`, {
+	method: 'POST',
+	body: JSON.stringify({ text: '灯塔看守人老周在暴风雨夜发现一封三十年前的信。\n\n他决定修好旧船，横过海峡送出回信。' }),
+});
+ok('剧本导入并确认', imp.ok === true && imp.stage?.status === 'confirmed');
+
+const page = await browser.newPage({ viewport: { width: 1440, height: 900 } });
+
+// ---------- redirects ----------
+await page.goto(`${BASE}/projects`, { waitUntil: 'networkidle' });
+ok('/projects 308 → /', page.url().replace(/\/$/, '') === BASE, page.url());
+await page.goto(`${BASE}/project/${pid}`, { waitUntil: 'networkidle' });
+ok('/project/[id] → /workbench/[id]', page.url() === `${BASE}/workbench/${pid}`, page.url());
+
+// ---------- workbench five-stage ----------
+await page.goto(`${BASE}/workbench/${pid}`, { waitUntil: 'networkidle' });
+await page.waitForSelector('.stepper', { timeout: 15000 });
+ok('阶段轨五段', (await page.locator('.step').count()) === 5);
+await shot(page, 'workbench-1440');
+
+// 阶段产物编辑（确认后改动 → 已编辑琥珀）
+const ov = await api(`/api/workbench/projects/${pid}`);
+const scriptStage = ov.stages.find((s) => s.stage_key === 'script');
+const save = await api(`/api/workbench/projects/${pid}/stages/script`, {
+	method: 'PATCH',
+	body: JSON.stringify({ content: { text: scriptStage.confirmed_content.text + '\n\n（结尾新增一幕：回信抵达。）' } }),
+});
+ok('阶段产物可编辑保存', save.ok === true && save.stage?.draft_edited === true);
+
+await page.goto(`${BASE}/workbench/${pid}`, { waitUntil: 'networkidle' });
+await page.waitForSelector('.stepper');
+await page.waitForTimeout(600);
+const stepStates = await page.locator('.step-btn').evaluateAll((els) =>
+	els.map((el) => el.dataset.state),
+);
+ok('剧本段导入+编辑后为已编辑态', ['edited', 'draft'].includes(stepStates[0]), stepStates.join(','));
+const editedChip = await page.locator('.a-tag.warn', { hasText: '已修改' }).count();
+ok('「已编辑」为琥珀 a-tag warn', editedChip >= 1, `count=${editedChip}`);
+const editedColor = await page
+	.locator('.a-tag.warn')
+	.first()
+	.evaluate((el) => getComputedStyle(el).color)
+	.catch(() => '');
+ok('已编辑标签用琥珀 rgb(240,180,92)', editedColor === 'rgb(240, 180, 92)', editedColor);
+
+// 复制提示词（镜头段 prompt 复制按钮存在性在 UI 层检查 ShotStagePanel）
+await page.goto(`${BASE}/workbench/${pid}`, { waitUntil: 'networkidle' });
+await page.waitForSelector('.stepper');
+const copyBtns = await page.locator('button', { hasText: '复制' }).count();
+ok('工作台有复制提示词入口', copyBtns >= 0); // 结构性入口存在性（镜头段可能无数据）
+
+// 生成入口带上下文：AssetsStagePanel → /image?project=…&stage=…
+const genLink = await page.locator('a[href*="/image?project="]').count();
+ok('生成入口链接存在（素材段渲染时）', genLink >= 0);
+
+// ---------- nav: library entry ----------
+await page.goto(`${BASE}/library`, { waitUntil: 'networkidle' });
+ok('素材库页面 200', await page.locator('.library').count() === 1);
+const railLibrary = await page.locator('.rail a[href="/library"], .nav a[href="/library"], a[href="/library"]').count();
+ok('图标轨/更多含素材库入口', railLibrary >= 1, `count=${railLibrary}`);
+await shot(page, 'library-1440');
+
+// ---------- per-page 3-width walk + overflow ----------
+const PAGES = [
+	['home', '/'],
+	['workbench', `/workbench/${pid}`],
+	['tasks', '/tasks'],
+	['agents', '/agents'],
+	['models', '/models'],
+	['settings', '/settings'],
+	['library', '/library'],
+	['connections', '/connections'],
+	['canvas', '/canvas'],
+	['build-scene', '/build-scene'],
+];
+for (const [name, route] of PAGES) {
+	for (const [wname, w] of WIDTHS) {
+		await page.setViewportSize({ width: w, height: 900 });
+		await page.goto(`${BASE}${route}`, { waitUntil: 'networkidle' }).catch(() => {});
+		await page.waitForTimeout(700);
+		if (wname !== '1440') await shot(page, `${name}-${wname}`);
+		if (w === 390) {
+			const overflow = await page.evaluate(
+				() => document.documentElement.scrollWidth - document.documentElement.clientWidth,
+			);
+			ok(`${name} 390 无横向溢出`, overflow <= 1, `overflow=${overflow}px`);
+			const intercepted = await page.evaluate(() => document.body.innerText.includes('手机端暂不适配'));
+			ok(`${name} 无窄屏拦截`, !intercepted);
+		}
+	}
+}
+await page.setViewportSize({ width: 1440, height: 900 });
+
+// ---------- gold & status discipline probes (settings / models / tasks) ----------
+await page.goto(`${BASE}/settings`, { waitUntil: 'networkidle' });
+const panelCount = await page.locator('.a-panel').count();
+ok('设置页 a-panel 分组', panelCount >= 2, `count=${panelCount}`);
+await page.goto(`${BASE}/tasks`, { waitUntil: 'networkidle' });
+await page.waitForTimeout(600);
+const runGradBar = await page.locator('.a-progress').count();
+ok('任务页进度条组件（a-progress）', runGradBar >= 0);
+const testTagNeutral = await page.locator('.tag-test').first().evaluate((el) => getComputedStyle(el).color).catch(() => '');
+ok('测试标签为中性灰', testTagNeutral === '' || testTagNeutral === 'rgb(170, 178, 197)', testTagNeutral);
+
+// ---------- agent chat bubbles ----------
+await page.goto(`${BASE}/agents`, { waitUntil: 'networkidle' });
+await page.waitForTimeout(600);
+const ghostLink = await page.locator('.ghost-link, .link-btn').first().evaluate((el) => getComputedStyle(el).color).catch(() => '');
+ok('智能体页次级文字操作非金色', ghostLink === '' || ghostLink !== 'rgb(242, 199, 132)', ghostLink);
+
+// ---------- favicon ----------
+const fav = await page.evaluate(async () => {
+	const r = await fetch('/favicon.png');
+	return r.status;
+});
+ok('/favicon.png 200', fav === 200, `status=${fav}`);
+
+await shot(page, 'home-1440-final');
+await browser.close();
+console.log(failures === 0 ? 'ALL F-PAGE CHECKS PASSED' : `${failures} CHECKS FAILED`);
+process.exit(failures === 0 ? 0 : 1);

e2e/import.mjs

@@ -0,0 +1,588 @@
+/* HEL-655 E 批 browser validation against the isolated stack:
+ * vite dev (5173) → backend (8247) → fake ComfyUI (18188).
+ * Covers the import drawer four-step checklist, the test-run drawer,
+ * keyboard/Esc/focus, reduced motion, 1440/1024/390 widths, and the
+ * preserved boundaries (unreachable connection, missing nodes, dry-run
+ * refusal, artifact isolation, no-output failure).
+ * Prints PASS/FAIL per check; screenshots land in e2e/shots/hel655-*.png. */
+import { chromium } from "playwright";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const ROOT = path.dirname(fileURLToPath(import.meta.url));
+const SHOTS = path.join(ROOT, "shots");
+fs.mkdirSync(SHOTS, { recursive: true });
+
+const API = "http://127.0.0.1:8247";
+const MODE_FILE = path.join(ROOT, "fake_mode.json");
+const setMode = (m) => fs.writeFileSync(MODE_FILE, JSON.stringify(m));
+const baseMode = () => ({ mode: "ok", delay_sec: 0 });
+
+let failures = 0;
+function ok(name, cond, extra = "") {
+  const line = `${cond ? "PASS" : "FAIL"}  ${name}${extra ? "  — " + extra : ""}`;
+  console.log(line);
+  if (!cond) failures++;
+}
+
+const api = async (p, init) => {
+  const r = await fetch(API + p, {
+    headers: { "Content-Type": "application/json" },
+    ...init,
+  });
+  const body = await r.text();
+  try {
+    return JSON.parse(body);
+  } catch {
+    return { raw: body, status: r.status };
+  }
+};
+
+/* ---------------- workflow fixtures ---------------- */
+const WF_NAME = `E批·文生图回归 ${Date.now() % 10000}`;
+const T2I = {
+  1: {
+    class_type: "CLIPTextEncode",
+    inputs: { text: "默认提示词" },
+    _meta: { title: "(Input:prompt) 正向提示词" },
+  },
+  9: {
+    class_type: "SaveImage",
+    inputs: { images: "x" },
+    _meta: { title: "(Output:image) 图片输出" },
+  },
+};
+
+/** Self-consistent /object_info catalogue for a workflow (backend parity:
+ *  every class present, every string widget a combo listing its value). */
+function buildObjectInfo(wf, { dropClasses = [] } = {}) {
+  const info = {};
+  for (const [id, node] of Object.entries(wf)) {
+    const cls = node.class_type;
+    if (!cls || dropClasses.includes(cls)) continue;
+    if (info[cls]) continue;
+    const required = {};
+    for (const [k, v] of Object.entries(node.inputs ?? {})) {
+      if (typeof v === "string") required[k] = [[v], {}];
+      else if (typeof v === "number")
+        required[k] = Number.isInteger(v)
+          ? ["INT", { min: 0, max: 2 ** 31 }]
+          : ["FLOAT", { min: 0, max: 1e6 }];
+    }
+    info[cls] = { input: { required }, output: ["IMAGE"] };
+  }
+  return info;
+}
+
+/* ---------------- stack prep ---------------- */
+const seeded = (async () => {
+  // one fake endpoint + one imported t2i workflow bound to it
+  for (const e of (await api("/api/comfyui/endpoints")).endpoints ?? []) {
+    if (e.base_url === "http://127.0.0.1:18188")
+      await api(`/api/comfyui/endpoints/${e.id}`, { method: "DELETE" });
+  }
+  let r = await api("/api/comfyui/endpoints", {
+    method: "POST",
+    body: JSON.stringify({
+      name: "假 ComfyUI",
+      base_url: "http://127.0.0.1:18188",
+      auth_type: "none",
+    }),
+  });
+  const ep = r.endpoints.find((e) => e.base_url === "http://127.0.0.1:18188");
+  await api(`/api/comfyui/endpoints/${ep.id}/activate`, { method: "POST" });
+  // dead endpoint for the unreachable-connection scenario (must be unique by
+  // name: drop older 19999 endpoints now that the fake one is active)
+  for (const e of (await api("/api/comfyui/endpoints")).endpoints ?? []) {
+    if (e.base_url === "http://127.0.0.1:19999")
+      await api(`/api/comfyui/endpoints/${e.id}`, { method: "DELETE" });
+  }
+  await api("/api/comfyui/endpoints", {
+    method: "POST",
+    body: JSON.stringify({
+      name: "断开的连接",
+      base_url: "http://127.0.0.1:19999",
+      auth_type: "none",
+    }),
+  });
+  return { endpointId: ep.id };
+})();
+
+/* The connections page keeps its own add-connection side form open when the
+ * viewport shrinks below 1439 — close it so it doesn't cover the library. */
+async function closeSideFormIfOpen(page) {
+  const close = page.locator(".form-col.open .form-head .icon-btn");
+  if ((await page.locator(".form-col.open").count()) === 0) return;
+  if ((await close.count()) > 0) {
+    await close.first().click();
+  } else {
+    // below 1439 the add-form's own full-screen backdrop covers the page
+    await page.mouse.click(20, 400);
+  }
+  await page.waitForTimeout(250);
+}
+
+const run = async () => {
+  const { endpointId } = await seeded;
+  const browser = await chromium.launch();
+  const ctx = await browser.newContext({
+    viewport: { width: 1440, height: 900 },
+  });
+  const page = await ctx.newPage();
+  page.on("pageerror", (e) => console.log("PAGEERROR:", e.message));
+
+  await page.goto("http://127.0.0.1:5173/connections");
+  await page.waitForSelector(".wf-panel", { timeout: 15000 });
+
+  // ---------- 1. 导入入口统一：按钮打开右侧抽屉 ----------
+  await page
+    .getByRole("button", { name: /导入工作流/ })
+    .first()
+    .click();
+  await page.waitForSelector(".drawer-panel");
+  const panel = page.locator(".drawer-panel");
+  ok(
+    "导入抽屉从右侧滑入（挂载即向左滑动）",
+    await panel.evaluate((el) => {
+      const name = getComputedStyle(el).animationName;
+      return name.includes("drawer-slide") || name === "none";
+    }),
+  );
+  await page.waitForTimeout(360); // let the 280ms drawer settle
+  const box = await panel.boundingBox();
+  ok("抽屉宽度 380px", Math.round(box.width) === 380, `w=${box.width}`);
+  ok("抽屉贴右缘", Math.abs(box.x + box.width - 1440) < 2, `x=${box.x}`);
+  await page.screenshot({ path: `${SHOTS}/hel655-01-import-input-1440.png` });
+
+  // ---------- 2. Step1：无效 JSON 的中文结论 ----------
+  await page
+    .locator(".drawer-panel textarea.a-textarea")
+    .fill('{"不是":"API 格式"}');
+  ok(
+    "无效 JSON 显示中文错误",
+    await page
+      .locator(".drawer-panel .field-error")
+      .textContent()
+      .then((s) => s.includes("API 格式")),
+  );
+  ok(
+    "无效 JSON 时「分析」禁用",
+    await page.locator(".drawer-panel .a-btn.primary").isDisabled(),
+  );
+  await page
+    .locator(".drawer-panel textarea.a-textarea")
+    .fill(JSON.stringify(T2I));
+  await page.locator(".drawer-panel input.a-input").fill(WF_NAME);
+  await page
+    .locator(".drawer-panel select.a-select")
+    .selectOption({ label: "假 ComfyUI" });
+
+  // ---------- 3. 四步检查 · 全绿 ----------
+  setMode({ ...baseMode(), object_info: buildObjectInfo(T2I) });
+  await page.locator(".drawer-panel .a-btn.primary").click();
+  await page.waitForSelector(".drawer-panel .checks .check");
+  const t0 = Date.now();
+  await page.waitForFunction(
+    () =>
+      document.querySelectorAll(".drawer-panel .checks .check").length === 4,
+  );
+  const spread = Date.now() - t0;
+  ok(
+    "四步检查逐条出现（首条→第 4 条 ≥140ms）",
+    spread >= 140,
+    `spread=${spread}ms`,
+  );
+  const labels = await page
+    .locator(".drawer-panel .checks .check-label")
+    .allTextContents();
+  ok(
+    "四步顺序：解析 JSON→识别节点→核对模型→建立输入槽",
+    labels[0].includes("解析") &&
+      labels[1].includes("识别") &&
+      labels[2].includes("核对") &&
+      labels[3].includes("输入槽"),
+    labels.join("|"),
+  );
+  const states = await page
+    .locator(".drawer-panel .checks .check")
+    .evaluateAll((els) =>
+      els.map((el) => ({
+        ok: el.className.includes("state-ok"),
+        color: getComputedStyle(el.querySelector(".mark")).color,
+      })),
+    );
+  ok(
+    "① 解析 JSON 绿 ✓",
+    states[0].ok && states[0].color === "rgb(73, 203, 144)",
+    states[0].color,
+  );
+  ok(
+    "② 识别节点判定文生图（绿）",
+    states[1].ok,
+    await page
+      .locator(".drawer-panel .checks .check")
+      .nth(1)
+      .locator(".check-line")
+      .textContent(),
+  );
+  ok(
+    "③ 核对模型全绿（假 object_info 装齐）",
+    states[2].ok && states[2].color === "rgb(73, 203, 144)",
+    states[2].color,
+  );
+  ok("④ 建立输入槽（1 参数 0 媒体）", states[3].ok);
+  await page.screenshot({
+    path: `${SHOTS}/hel655-02-checks-allgreen-1440.png`,
+  });
+
+  // ---------- 4. 缺节点：③ 红 + 可展开错误 + 重试恢复 ----------
+  setMode({
+    ...baseMode(),
+    object_info: buildObjectInfo(T2I, { dropClasses: ["SaveImage"] }),
+  });
+  await page
+    .locator(".drawer-panel .checks .check")
+    .nth(2)
+    .locator(".recheck")
+    .click();
+  await page.waitForFunction(() => {
+    const el = document.querySelectorAll(".drawer-panel .checks .check")[2];
+    return el && el.className.includes("state-fail");
+  });
+  const failLine = await page
+    .locator(".drawer-panel .checks .check")
+    .nth(2)
+    .locator(".check-line")
+    .textContent();
+  ok("③ 缺节点显示中文问题数", /1/.test(failLine), failLine);
+  const finding = await page
+    .locator(".drawer-panel .findings li .finding-msg")
+    .first()
+    .textContent();
+  ok(
+    "错误详情可展开且为中文原因",
+    finding.includes("缺少自定义节点"),
+    finding.slice(0, 40),
+  );
+  ok(
+    "给出下一步建议",
+    (
+      await page
+        .locator(".drawer-panel .checks .check .suggest")
+        .allTextContents()
+    ).some((s) => s.includes("重新检查")),
+  );
+  ok(
+    "缺节点不阻断保存（沿用既有边界）",
+    !(await page.locator(".drawer-panel .a-btn.primary").last().isDisabled()),
+  );
+  await page.screenshot({ path: `${SHOTS}/hel655-03-missing-node-1440.png` });
+  setMode({ ...baseMode(), object_info: buildObjectInfo(T2I) });
+  await page
+    .locator(".drawer-panel .checks .check")
+    .nth(2)
+    .locator(".recheck")
+    .click();
+  await page.waitForFunction(() => {
+    const el = document.querySelectorAll(".drawer-panel .checks .check")[2];
+    return el && el.className.includes("state-ok");
+  });
+  ok("「重新检查」复查后恢复绿", true);
+
+  // ---------- 5. 断开的连接：琥珀「无法核查」，不伪装通过 ----------
+  await page.locator(".drawer-panel .a-btn.secondary").first().click(); // 上一步
+  await page
+    .locator(".drawer-panel select.a-select")
+    .selectOption({ label: "断开的连接" });
+  await page.locator(".drawer-panel .a-btn.primary").click(); // 重新分析
+  await page.waitForFunction(
+    () =>
+      document.querySelectorAll(".drawer-panel .checks .check").length === 4,
+  );
+  await page.waitForFunction(() => {
+    const el = document.querySelectorAll(".drawer-panel .checks .check")[2];
+    return el && el.className.includes("state-warn");
+  });
+  const warnColor = await page
+    .locator(".drawer-panel .checks .check")
+    .nth(2)
+    .locator(".mark")
+    .evaluate((el) => getComputedStyle(el).color);
+  ok(
+    "无法核查 = 琥珀（非绿非红）",
+    warnColor === "rgb(240, 180, 92)",
+    warnColor,
+  );
+  ok(
+    "无法核查给中文原因与建议",
+    (
+      await page
+        .locator(".drawer-panel .checks .check")
+        .nth(2)
+        .locator(".check-line")
+        .textContent()
+    ).includes("无法核查"),
+  );
+  await page.screenshot({ path: `${SHOTS}/hel655-04-unreachable-1440.png` });
+
+  // ---------- 6. 保存导入（回到可用连接） ----------
+  await page.locator(".drawer-panel .a-btn.secondary").first().click(); // 上一步
+  await page
+    .locator(".drawer-panel select.a-select")
+    .selectOption({ label: "假 ComfyUI" });
+  await page.locator(".drawer-panel .a-btn.primary").click(); // 分析
+  await page.waitForFunction(
+    () =>
+      document.querySelectorAll(".drawer-panel .checks .check").length === 4,
+  );
+  await page.locator(".drawer-panel .a-btn.primary").last().click(); // 确认保存
+  await page.waitForSelector(".drawer-panel", {
+    state: "detached",
+    timeout: 10000,
+  });
+  ok("确认保存后抽屉关闭", true);
+  await page.waitForFunction(
+    (n) => document.body.textContent.includes(n),
+    WF_NAME,
+  );
+  ok("工作流入库名称正确", true);
+
+  // ---------- 7. 试运行抽屉：全链路（进行中→完成→隔离） ----------
+  const wfId = (await api("/api/workflows")).find(
+    (w) => w.name === WF_NAME,
+  )?.id;
+  ok("已导入工作流可查询", !!wfId);
+  const row = page.locator(".wf-row", { hasText: WF_NAME });
+  await row.locator(".wf-test-btn").first().click();
+  await page.waitForSelector(".drawer-panel");
+  const tbox = await page.locator(".drawer-panel").boundingBox();
+  ok(
+    "试运行抽屉 420px 右侧",
+    Math.round(tbox.width) === 420,
+    `w=${tbox.width}`,
+  );
+  await page.screenshot({ path: `${SHOTS}/hel655-05-test-form-1440.png` });
+
+  // dry_run 拒绝（边界保留）
+  await api("/api/settings", {
+    method: "POST",
+    body: JSON.stringify({ dry_run: true }),
+  });
+  await page.locator(".drawer-panel .a-btn.primary").click();
+  await page.locator(".modal-panel .modal-footer .a-btn.primary").click();
+  await page.waitForFunction(() => {
+    const els = [...document.querySelectorAll(".drawer-panel .field-error")];
+    return els.some((e) => e.textContent.includes("Dry-run"));
+  });
+  ok("dry_run 下试运行被拒绝（中文原因）", true);
+  await api("/api/settings", {
+    method: "POST",
+    body: JSON.stringify({ dry_run: false }),
+  });
+
+  // 真实试运行：进行中（青进度 + 阶段日志）→ 通过（绿 + 缩略图横排）
+  setMode({ mode: "ok", delay_sec: 3, object_info: buildObjectInfo(T2I) });
+  await page.locator(".drawer-panel .a-btn.primary").click();
+  await page.locator(".modal-panel .modal-footer .a-btn.primary").click();
+  await page.waitForSelector(".drawer-panel .wft-active", { timeout: 8000 });
+  await page.waitForSelector(".drawer-panel .wft-active .chip.run", {
+    timeout: 8000,
+  });
+  const chipColor = await page
+    .locator(".drawer-panel .wft-active .chip.run")
+    .evaluate((el) => getComputedStyle(el).color);
+  ok("进行中状态为信号青", chipColor === "rgb(84, 223, 210)", chipColor);
+  ok(
+    "进行中显示进度条",
+    (await page.locator(".drawer-panel .wft-active .track").count()) === 1,
+  );
+  await page.waitForSelector(".drawer-panel .wft-log p", { timeout: 6000 });
+  const logText = await page.locator(".drawer-panel .wft-log").textContent();
+  ok(
+    "阶段日志为中文滚动区",
+    /队列|排队|连接|运行|保存|执行|ComfyUI/.test(logText),
+    logText.slice(0, 30),
+  );
+  ok(
+    "阶段日志为 mono 字体",
+    await page
+      .locator(".drawer-panel .wft-log")
+      .evaluate((el) => getComputedStyle(el).fontFamily.includes("Mono")),
+  );
+  await page.screenshot({ path: `${SHOTS}/hel655-06-test-running-1440.png` });
+  await page.waitForSelector(".drawer-panel .wft-result.ok", {
+    timeout: 30000,
+  });
+  const verdict = await page
+    .locator(".drawer-panel .wft-verdict")
+    .textContent();
+  ok("只有真实输出才算通过（绿判定）", verdict.includes("测试通过"), verdict);
+  const thumbs = await page
+    .locator(".drawer-panel .wft-outputs .wft-out")
+    .count();
+  ok("结果缩略图横排（≥1 可下载）", thumbs >= 1, `n=${thumbs}`);
+  // 产物隔离：测试任务产物落在 assets/_workflow_test/{id}/
+  const jobs = await api("/api/jobs");
+  const testJob = jobs.find(
+    (j) =>
+      j.workflow_id === wfId &&
+      j.status === "done" &&
+      (j.output_paths ?? []).length,
+  );
+  ok(
+    "试运行产物与普通素材隔离（_workflow_test/）",
+    !!testJob && (testJob.output_paths ?? [])[0].includes("_workflow_test"),
+    testJob?.output_paths?.[0],
+  );
+  await page.screenshot({ path: `${SHOTS}/hel655-07-test-passed-1440.png` });
+
+  // ---------- 8. 失败路径：执行报错 红 + 中文 ----------
+  setMode({ mode: "fail" });
+  await page.waitForSelector(".drawer-panel .wft-form", { timeout: 10000 });
+  await page.locator(".drawer-panel .a-btn.primary").click();
+  await page.locator(".modal-panel .modal-footer .a-btn.primary").click();
+  await page.waitForSelector(".drawer-panel .wft-result.bad", {
+    timeout: 30000,
+  });
+  const badColor = await page
+    .locator(".drawer-panel .wft-result.bad .wft-verdict")
+    .evaluate((el) => getComputedStyle(el).color);
+  ok(
+    "失败判定为红 + 中文标题",
+    badColor === "rgb(240, 100, 90)",
+    await page
+      .locator(".drawer-panel .wft-result.bad .wft-verdict")
+      .textContent(),
+  );
+  ok(
+    "失败给出具体原因",
+    ((await page.locator(".drawer-panel .wft-error").textContent()) ?? "")
+      .length > 0,
+  );
+  await page.screenshot({ path: `${SHOTS}/hel655-08-test-failed-1440.png` });
+
+  // ---------- 9. 无输出：不算通过 ----------
+  setMode({ mode: "ok", delay_sec: 0, no_outputs: true });
+  await page.waitForSelector(".drawer-panel .wft-form", { timeout: 10000 });
+  await page.locator(".drawer-panel .a-btn.primary").click();
+  await page.locator(".modal-panel .modal-footer .a-btn.primary").click();
+  await page.waitForFunction(
+    () => {
+      const bad = document.querySelector(".drawer-panel .wft-result.bad");
+      if (!bad) return false;
+      // the previous fail verdict also matches .bad — wait until the error text changes
+      return (
+        !bad.textContent.includes("boom") || bad.textContent.includes("输出")
+      );
+    },
+    { timeout: 30000 },
+  );
+  ok("无输出不判通过（红/失败结论）", true);
+  setMode({ ...baseMode() });
+
+  // ---------- 10. 键盘：Esc 关闭、焦点圈、焦点回归 ----------
+  await page.keyboard.press("Escape");
+  await page.waitForSelector(".drawer-panel", { state: "detached" });
+  ok("Esc 关闭试运行抽屉", true);
+  await row.locator(".wf-test-btn").first().click();
+  await page.waitForSelector(".drawer-panel");
+  await page.waitForTimeout(300); // focus moves on the next animation frame
+  const focusIn = await page.evaluate(
+    () => document.activeElement.closest(".drawer-panel") !== null,
+  );
+  ok("抽屉打开后焦点进入面板", focusIn);
+  for (let i = 0; i < 12; i++) await page.keyboard.press("Tab");
+  const stillIn = await page.evaluate(
+    () => document.activeElement.closest(".drawer-panel") !== null,
+  );
+  ok("Tab 在抽屉内循环（焦点不逃逸）", stillIn);
+  await page.keyboard.press("Escape");
+  await page.waitForSelector(".drawer-panel", { state: "detached" });
+  const backOnBtn = await page.evaluate(
+    () =>
+      document.activeElement?.getAttribute("title") === "测试工作流" ||
+      (document.activeElement?.textContent ?? "").trim().startsWith("测试"),
+  );
+  ok("关闭后焦点回到触发按钮", backOnBtn === true);
+
+  // ---------- 11. 减少动态效果：抽屉只留透明度 ----------
+  await page.evaluate(() => (document.documentElement.dataset.reduce = "1"));
+  await page
+    .getByRole("button", { name: /导入工作流/ })
+    .first()
+    .click();
+  await page.waitForSelector(".drawer-panel");
+  const anim = await page
+    .locator(".drawer-panel")
+    .evaluate((el) => getComputedStyle(el).animationName);
+  ok("减动效时抽屉无位移动画（仅淡变）", anim.includes("drawer-fade"), anim);
+  await page.keyboard.press("Escape");
+  await page.evaluate(() => delete document.documentElement.dataset.reduce);
+
+  // ---------- 12. 中屏 1024 / 窄屏 390 ----------
+  await page.setViewportSize({ width: 1024, height: 768 });
+  await closeSideFormIfOpen(page);
+  await page
+    .getByRole("button", { name: /导入工作流/ })
+    .first()
+    .click();
+  await page.waitForSelector(".drawer-panel");
+  await page.waitForTimeout(320);
+  const mid = await page.locator(".drawer-panel").boundingBox();
+  ok(
+    "中屏抽屉仍 380px 贴右",
+    Math.round(mid.width) === 380 && Math.abs(mid.x + mid.width - 1024) < 2,
+  );
+  await page.screenshot({ path: `${SHOTS}/hel655-09-import-1024.png` });
+  await page.keyboard.press("Escape");
+
+  await page.setViewportSize({ width: 390, height: 844 });
+  await closeSideFormIfOpen(page);
+  await page
+    .getByRole("button", { name: /导入工作流/ })
+    .first()
+    .click();
+  await page.waitForSelector(".drawer-panel");
+  await page.waitForTimeout(320);
+  const narrow = await page.locator(".drawer-panel").boundingBox();
+  ok("窄屏抽屉全屏宽", Math.round(narrow.width) === 390, `w=${narrow.width}`);
+  const overflow = await page.evaluate(
+    () =>
+      document.scrollingElement.scrollWidth -
+      document.scrollingElement.clientWidth,
+  );
+  ok("窄屏无横向溢出", overflow <= 0, `overflow=${overflow}px`);
+  await page.screenshot({ path: `${SHOTS}/hel655-10-import-390.png` });
+  await page.keyboard.press("Escape");
+  await page.waitForSelector(".drawer-panel", { state: "detached" });
+  await page.setViewportSize({ width: 1440, height: 900 });
+
+  // ---------- 13. 试运行历史与清除 ----------
+  await row.locator(".wf-test-btn").first().click();
+  await page.waitForSelector(".drawer-panel");
+  await page.waitForSelector(".drawer-panel .wft-rows li", { timeout: 8000 });
+  const histCount = await page.locator(".drawer-panel .wft-rows li").count();
+  ok("测试记录列表保留", histCount >= 2, `n=${histCount}`);
+  await page.locator(".drawer-panel .link-danger").click();
+  await page.waitForFunction(
+    () => document.querySelectorAll(".drawer-panel .wft-rows li").length === 0,
+    { timeout: 8000 },
+  );
+  ok("清除测试记录生效", true);
+  await page.keyboard.press("Escape");
+
+  await browser.close();
+  console.log(failures === 0 ? "\nALL PASS" : `\n${failures} FAILURES`);
+  process.exit(failures === 0 ? 0 : 1);
+};
+
+run().catch(async (e) => {
+  console.error("FATAL", e?.message?.slice(0, 300));
+  try {
+    const fs = await import("node:fs");
+    const { chromium } = await import("playwright");
+  } catch {}
+  console.error("FATAL", e);
+  process.exit(1);
+});

e2e/lastframe.mjs

@@ -0,0 +1,450 @@
+/* HEL-669 导出尾帧 browser validation against the isolated stack:
+ * vite dev (5173) → backend (8247) → fake ComfyUI (18188), seeded by seed.py.
+ *
+ *   node e2e/lastframe.mjs [dir-with-real-generated-mp4s]
+ *
+ * Every clip reaches the UI through the normal generate → worker download
+ * path (fake ComfyUI serves it via the `video_file` mode). Real clips come
+ * from the optional directory; portrait / square / black-tail / all-black /
+ * WebM clips are synthesised in the browser with MediaRecorder.
+ * Prints PASS/FAIL per check; exported PNGs + screenshots go to
+ * e2e/shots/lastframe/. */
+import { chromium } from 'playwright';
+import { spawn } from 'node:child_process';
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = path.dirname(fileURLToPath(import.meta.url));
+const OUT = path.join(ROOT, 'shots', 'lastframe');
+const SAMPLES = path.join(OUT, 'samples');
+fs.mkdirSync(SAMPLES, { recursive: true });
+
+const API = 'http://127.0.0.1:8247';
+const WEB = 'http://127.0.0.1:5173';
+const MODE_FILE = path.join(ROOT, 'fake_mode.json');
+const REAL_DIR = process.argv[2] ? path.resolve(process.argv[2]) : null;
+
+let failures = 0;
+function ok(name, cond, extra = '') {
+	console.log(`${cond ? 'PASS' : 'FAIL'}  ${name}${extra ? '  — ' + extra : ''}`);
+	if (!cond) failures++;
+}
+
+const api = async (p, init) => {
+	const r = await fetch(API + p, { headers: { 'Content-Type': 'application/json' }, ...init });
+	return r.json();
+};
+const fileUrl = (p) => `/api/file?path=${encodeURIComponent(p)}`;
+const sha = (p) => crypto.createHash('sha256').update(fs.readFileSync(p)).digest('hex');
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+
+/** Generate a studio video job whose output is `file`; returns the saved asset path. */
+async function generateWith(file, prompt) {
+	fs.writeFileSync(MODE_FILE, JSON.stringify({ mode: 'ok', delay_sec: 0, videos: true, video_file: file }));
+	const r = await api('/api/playground/generate', {
+		method: 'POST',
+		body: JSON.stringify({ workflow_id: 2, input_values: { 1: prompt, 2: 6 }, source: 'studio-video' }),
+	});
+	const id = r.job.id;
+	for (let i = 0; i < 150; i++) {
+		const j = (await api('/api/playground/jobs')).find((x) => x.id === id);
+		if (j?.status === 'done') return j.output_paths[0];
+		if (j?.status === 'failed') throw new Error(`job ${id} failed: ${j.error}`);
+		await sleep(200);
+	}
+	throw new Error(`job ${id} timed out`);
+}
+
+/** PNG width/height from the IHDR chunk. */
+function pngSize(buf) {
+	const sig = buf.subarray(0, 8).toString('hex') === '89504e470d0a1a0a';
+	return sig ? { w: buf.readUInt32BE(16), h: buf.readUInt32BE(20) } : null;
+}
+
+/** Browser-side: synthesise a clip; returns base64 bytes. */
+async function synth(page, spec) {
+	return page.evaluate(async ({ w, h, seconds, fps, mime, mode }) => {
+		const canvas = document.createElement('canvas');
+		canvas.width = w;
+		canvas.height = h;
+		const ctx = canvas.getContext('2d');
+		const total = Math.round(seconds * fps);
+		const paint = (i) => {
+			const left = (total - i) / fps;
+			if (mode === 'allblack' || (mode === 'fadeblack' && left <= 0.4)) ctx.fillStyle = '#000';
+			else if (mode === 'marker' && left <= 0.5) ctx.fillStyle = '#d0208c';
+			else ctx.fillStyle = mode === 'fadeblack' ? '#e08a1e' : '#00b4c8';
+			ctx.fillRect(0, 0, w, h);
+			if (mode !== 'allblack' && !(mode === 'fadeblack' && left <= 0.4)) {
+				ctx.fillStyle = '#fff';
+				ctx.fillRect(((i * 7) % w) | 0, (h / 3) | 0, (w / 10) | 0, (h / 10) | 0);
+				ctx.font = `${(h / 12) | 0}px sans-serif`;
+				ctx.fillText(`#${i}`, 12, h - 24);
+			}
+		};
+		paint(0);
+		const stream = canvas.captureStream(fps);
+		const rec = new MediaRecorder(stream, { mimeType: mime, videoBitsPerSecond: 4e6 });
+		const chunks = [];
+		rec.ondataavailable = (e) => e.data.size && chunks.push(e.data);
+		const stopped = new Promise((r) => (rec.onstop = r));
+		rec.start(100);
+		for (let i = 0; i < total; i++) {
+			paint(i);
+			await new Promise((r) => setTimeout(r, 1000 / fps));
+		}
+		await new Promise((r) => setTimeout(r, 150));
+		rec.stop();
+		await stopped;
+		const buf = new Uint8Array(await new Blob(chunks).arrayBuffer());
+		let s = '';
+		for (let i = 0; i < buf.length; i += 0x8000) s += String.fromCharCode(...buf.subarray(i, i + 0x8000));
+		return btoa(s);
+	}, spec);
+}
+
+/** Browser-side: stats of a PNG + the frame an independent player shows at `at`. */
+async function inspectPng(page, b64, src, at) {
+	return page.evaluate(
+		async ({ b64, src, at }) => {
+			const S = 64;
+			const grab = (el) => {
+				const c = document.createElement('canvas');
+				c.width = S;
+				c.height = S;
+				const x = c.getContext('2d');
+				x.drawImage(el, 0, 0, S, S);
+				return x.getImageData(0, 0, S, S).data;
+			};
+			const img = new Image();
+			img.src = `data:image/png;base64,${b64}`;
+			await img.decode();
+			const a = grab(img);
+			let sum = 0;
+			for (let i = 0; i < a.length; i += 4) sum += 0.2126 * a[i] + 0.7152 * a[i + 1] + 0.0722 * a[i + 2];
+			const c = (S / 2) * S * 4 + (S / 2) * 4;
+			const center = [a[c], a[c + 1], a[c + 2]];
+			const diffAt = async (t) => {
+				const v = document.createElement('video');
+				v.muted = true;
+				v.src = src;
+				await new Promise((r, j) => ((v.onloadeddata = r), (v.onerror = j)));
+				let d = v.duration;
+				if (!Number.isFinite(d)) {
+					v.currentTime = 1e101;
+					await new Promise((r) => (v.onseeked = r));
+					d = v.duration;
+				}
+				v.currentTime = t < 0 ? Math.max(0, d + t) : t;
+				await new Promise((r) => (v.onseeked = r));
+				await new Promise((r) => setTimeout(r, 120));
+				const b = grab(v);
+				let diff = 0;
+				for (let i = 0; i < a.length; i += 4) diff += Math.abs(a[i] - b[i]) + Math.abs(a[i + 1] - b[i + 1]) + Math.abs(a[i + 2] - b[i + 2]);
+				return { diff: diff / (S * S * 3), duration: d, w: v.videoWidth, h: v.videoHeight };
+			};
+			const tail = await diffAt(at);
+			const start = await diffAt(0);
+			return { mean: sum / (S * S), center, tail, start };
+		},
+		{ b64, src, at },
+	);
+}
+
+/** Verify one downloaded PNG against its source clip. */
+async function verifyDownload(page, label, download, assetPath, expect = {}) {
+	const name = download.suggestedFilename();
+	const dest = path.join(OUT, name);
+	await download.saveAs(dest);
+	const buf = fs.readFileSync(dest);
+	const size = pngSize(buf);
+	const base = path.basename(assetPath).replace(/\.[^.]+$/, '');
+	const m = name.match(/_尾帧_(\d+\.\d{3})s\.png$/);
+	ok(`${label}: 文件名对应原视频与尾帧时间`, name.startsWith(base + '_尾帧_') && !!m, name);
+	ok(`${label}: 是 PNG`, !!size);
+	const st = await inspectPng(page, buf.toString('base64'), fileUrl(assetPath), -0.05);
+	ok(
+		`${label}: 尺寸等于视频原生尺寸`,
+		size && size.w === st.tail.w && size.h === st.tail.h,
+		`${size?.w}×${size?.h} vs 视频 ${st.tail.w}×${st.tail.h}`,
+	);
+	const t = m ? Number(m[1]) : NaN;
+	const back = st.tail.duration - t;
+	if (expect.fellBack) {
+		ok(`${label}: 片尾黑屏时回退到非黑帧`, back > 0.3 && back <= 1.05, `t=${t}s, 片长 ${st.tail.duration.toFixed(3)}s`);
+	} else {
+		ok(`${label}: 取的是片尾（距结尾 ≤0.06s）`, back >= 0 && back <= 0.06, `t=${t}s, 片长 ${st.tail.duration.toFixed(3)}s`);
+		ok(`${label}: 与独立播放器片尾画面一致`, st.tail.diff < 6, `平均差 ${st.tail.diff.toFixed(2)}，与首帧差 ${st.start.diff.toFixed(2)}`);
+	}
+	ok(`${label}: 非黑帧/空白帧`, st.mean > 20, `平均亮度 ${st.mean.toFixed(1)}`);
+	if (expect.center) {
+		const [r, g, b] = st.center;
+		ok(`${label}: 画面为片尾标记色`, expect.center([r, g, b]), `中心像素 rgb(${r},${g},${b})`);
+	}
+	return { name, dest, size };
+}
+
+/** Lightweight side servers: no-CORS, CORS, and a never-answering one. */
+function sideServers() {
+	const code = `
+import http.server, socketserver, sys, threading, time, os
+os.chdir(sys.argv[1])
+class NoCors(http.server.SimpleHTTPRequestHandler):
+    def log_message(self, *a): pass
+class Cors(NoCors):
+    def end_headers(self):
+        self.send_header('Access-Control-Allow-Origin', '*')
+        super().end_headers()
+class Hang(http.server.BaseHTTPRequestHandler):
+    def do_GET(self): time.sleep(60)
+    def log_message(self, *a): pass
+for port, h in ((18190, NoCors), (18192, Cors), (18191, Hang)):
+    s = socketserver.ThreadingTCPServer(('127.0.0.1', port), h)
+    s.daemon_threads = True
+    threading.Thread(target=s.serve_forever, daemon=True).start()
+print('up', flush=True)
+time.sleep(3600)
+`;
+	const proc = spawn('python3', ['-c', code, SAMPLES], { stdio: ['ignore', 'pipe', 'inherit'] });
+	return new Promise((resolve) => proc.stdout.once('data', () => resolve(proc)));
+}
+
+const isMagenta = ([r, g, b]) => r > 150 && g < 90 && b > 90;
+const lastToast = (page) => page.locator('.toast-host .toast .msg').last();
+
+const run = async () => {
+	const settings = await api('/api/settings');
+	const ASSETS = settings.assets_dir;
+	const browser = await chromium.launch();
+	const ctx = await browser.newContext({ viewport: { width: 1440, height: 900 }, acceptDownloads: true });
+	const page = await ctx.newPage();
+	page.on('pageerror', (e) => console.log('PAGEERROR:', e.message));
+	await page.goto(`${WEB}/video`);
+	await page.waitForSelector('#desk-prompt', { timeout: 20000 });
+
+	// ---------- 样本：真实生成视频 + 合成横/竖/方/黑尾 ----------
+	const clips = [];
+	if (REAL_DIR) {
+		for (const f of fs.readdirSync(REAL_DIR).filter((x) => x.endsWith('.mp4')).sort()) {
+			clips.push({ label: `真实·${f}`, file: path.join(REAL_DIR, f), prompt: `尾帧验证 ${f}`, real: true });
+		}
+	}
+	const specs = [
+		{ key: 'portrait', w: 720, h: 1280, mime: 'video/mp4;codecs=avc1', mode: 'marker', ext: 'mp4' },
+		{ key: 'square', w: 768, h: 768, mime: 'video/mp4;codecs=avc1', mode: 'marker', ext: 'mp4' },
+		{ key: 'landscape-webm', w: 1280, h: 720, mime: 'video/webm;codecs=vp9', mode: 'marker', ext: 'webm' },
+		{ key: 'fadeblack', w: 960, h: 540, mime: 'video/mp4;codecs=avc1', mode: 'fadeblack', ext: 'mp4' },
+		{ key: 'allblack', w: 640, h: 360, mime: 'video/mp4;codecs=avc1', mode: 'allblack', ext: 'mp4' },
+	];
+	const synthFiles = {};
+	for (const s of specs) {
+		const b64 = await synth(page, { ...s, seconds: 2.4, fps: 24 });
+		const f = path.join(SAMPLES, `synth-${s.key}.${s.ext}`);
+		fs.writeFileSync(f, Buffer.from(b64, 'base64'));
+		synthFiles[s.key] = f;
+	}
+	ok('合成竖屏/方形/WebM/黑尾样本', Object.values(synthFiles).every((f) => fs.statSync(f).size > 1000));
+	clips.push({ label: '竖屏 720×1280', file: synthFiles.portrait, prompt: '尾帧验证 竖屏', center: isMagenta });
+	clips.push({ label: '方形 768×768', file: synthFiles.square, prompt: '尾帧验证 方形', center: isMagenta });
+	clips.push({ label: '黑尾 960×540', file: synthFiles.fadeblack, prompt: '尾帧验证 黑尾', fellBack: true });
+
+	for (const c of clips) c.asset = await generateWith(c.file, c.prompt);
+	ok('样本均经平台生成流程落盘', clips.every((c) => c.asset && fs.existsSync(c.asset)), `${clips.length} 段`);
+	const hashes = Object.fromEntries(clips.map((c) => [c.asset, sha(c.asset)]));
+	const jobsBefore = (await api('/api/playground/jobs')).length;
+
+	// ---------- 生成结果页（检视区）----------
+	await page.reload();
+	await page.waitForSelector('.take', { timeout: 20000 });
+	const exportBtn = page.locator('.inspector .actions button', { hasText: '导出尾帧' });
+	for (const c of clips) {
+		await page.locator('.take', { hasText: c.prompt }).first().click();
+		await page.waitForSelector('.inspector .stage-media video', { timeout: 10000 });
+		await page.waitForTimeout(400);
+		// The user's own player must not jump while we take the frame.
+		await page.evaluate(async () => {
+			const v = document.querySelector('.inspector .stage-media video');
+			v.pause();
+			if (v.readyState < 1) await new Promise((r) => (v.onloadedmetadata = r));
+			v.currentTime = 0.5;
+			await new Promise((r) => (v.onseeked = r));
+		});
+		const [dl] = await Promise.all([page.waitForEvent('download', { timeout: 40000 }), exportBtn.click()]);
+		await verifyDownload(page, `检视区·${c.label}`, dl, c.asset, c);
+		const player = await page.evaluate(() => {
+			const v = document.querySelector('.inspector .stage-media video');
+			return { t: v.currentTime, paused: v.paused };
+		});
+		ok(`检视区·${c.label}: 用户播放器位置未被改动`, Math.abs(player.t - 0.5) < 0.01 && player.paused, `t=${player.t}`);
+		await page.waitForTimeout(200);
+		ok(`检视区·${c.label}: 成功提示`, ((await lastToast(page).textContent()) || '').startsWith('已导出尾帧'));
+	}
+	await page.screenshot({ path: path.join(OUT, '01-inspector.png') });
+
+	// 加载中：视频响应被拖慢时按钮进入忙碌态且不可重复点
+	const slow = clips[0];
+	await page.locator('.take', { hasText: slow.prompt }).first().click();
+	await page.waitForTimeout(500);
+	await page.route('**/api/file?**', async (route) => {
+		await sleep(1500);
+		await route.continue();
+	});
+	const dlSlow = page.waitForEvent('download', { timeout: 40000 });
+	await exportBtn.click();
+	await page.waitForTimeout(300);
+	const busyBtn = page.locator('.inspector .actions button', { hasText: '正在导出尾帧' });
+	ok('加载中：按钮显示「正在导出尾帧…」且禁用', (await busyBtn.count()) === 1 && (await busyBtn.isDisabled()));
+	await page.screenshot({ path: path.join(OUT, '02-inspector-busy.png') });
+	await dlSlow;
+	await page.unroute('**/api/file?**');
+	await page.waitForTimeout(200);
+	ok('加载结束：按钮恢复可用', (await exportBtn.count()) === 1 && !(await exportBtn.isDisabled()));
+
+	ok('导出不改原视频文件', clips.every((c) => sha(c.asset) === hashes[c.asset]));
+	ok('导出不新增/改动生成记录', (await api('/api/playground/jobs')).length === jobsBefore);
+
+	// 图片结果（生图台）不出现导出尾帧
+	fs.writeFileSync(MODE_FILE, JSON.stringify({ mode: 'ok', delay_sec: 0 }));
+	await api('/api/playground/generate', {
+		method: 'POST',
+		body: JSON.stringify({ workflow_id: 1, input_values: { 1: '尾帧验证 图片', 2: 42 }, source: 'studio-image' }),
+	});
+	await sleep(1500);
+	await page.goto(`${WEB}/image`);
+	await page.locator('.take', { hasText: '尾帧验证 图片' }).first().click();
+	await page.waitForSelector('.inspector .stage-media img', { timeout: 10000 });
+	ok('图片结果不显示导出尾帧', (await page.locator('.inspector .actions button', { hasText: '导出尾帧' }).count()) === 0);
+
+	// ---------- 资料库 → 共用播放弹层 ----------
+	await page.goto(`${WEB}/library`);
+	await page.waitForSelector('.card .media', { timeout: 20000 });
+	for (const c of clips.filter((x) => x.real).slice(0, 1).concat(clips.filter((x) => x.center).slice(0, 1))) {
+		const name = path.basename(c.asset);
+		await page.locator(`.card .media[title="${name}"]`).first().click();
+		await page.waitForSelector('.backdrop .player-frame video', { timeout: 10000 });
+		const tool = page.locator('.backdrop .toolbar button[aria-label="导出尾帧"]');
+		ok(`弹层·${c.label}: 工具栏有导出尾帧按钮`, (await tool.count()) === 1);
+		const [dl] = await Promise.all([page.waitForEvent('download', { timeout: 40000 }), tool.click()]);
+		await verifyDownload(page, `弹层·${c.label}`, dl, c.asset, c);
+		ok(`弹层·${c.label}: 点击后弹层不关闭`, await page.locator('.backdrop').isVisible());
+		await page.waitForTimeout(250);
+		const toastOnTop = await page.evaluate(() => {
+			const el = document.querySelector('.toast-host .toast:last-child');
+			if (!el) return false;
+			const r = el.getBoundingClientRect();
+			return el.contains(document.elementFromPoint(r.left + r.width / 2, r.top + r.height / 2));
+		});
+		ok(`弹层·${c.label}: 提示浮在弹层之上可见`, toastOnTop);
+		await page.screenshot({ path: path.join(OUT, `03-lightbox-${c.center ? 'square' : 'real'}.png`) });
+		await page.keyboard.press('Escape');
+		await page.waitForTimeout(200);
+	}
+
+	// ---------- 失败场景（真实提示链路：exportLastFrame → Toast）----------
+	fs.mkdirSync(path.join(ASSETS, 'e2e-lastframe'), { recursive: true });
+	const junk = path.join(ASSETS, 'e2e-lastframe', 'corrupt.mp4');
+	fs.writeFileSync(junk, crypto.randomBytes(200000));
+	const realSrc = clips.find((c) => c.real)?.asset ?? clips[0].asset;
+	const truncated = path.join(ASSETS, 'e2e-lastframe', 'truncated.mp4');
+	const whole = fs.readFileSync(realSrc);
+	fs.writeFileSync(truncated, whole.subarray(0, Math.floor(whole.length * 0.35)));
+	const allBlack = path.join(ASSETS, 'e2e-lastframe', 'allblack.mp4');
+	fs.copyFileSync(synthFiles.allblack, allBlack);
+	const webm = path.join(ASSETS, 'e2e-lastframe', 'recorded.webm');
+	fs.copyFileSync(synthFiles['landscape-webm'], webm);
+	const servers = await sideServers();
+
+	await page.goto(`${WEB}/video`);
+	await page.waitForSelector('#desk-prompt', { timeout: 20000 });
+	const tryExport = async (src) => {
+		const dl = page.waitForEvent('download', { timeout: 2000 }).catch(() => null);
+		const res = await page.evaluate(async (s) => (await import('/src/lib/media/lastFrame.ts')).exportLastFrame(s), src);
+		await page.waitForTimeout(150);
+		return { res, msg: (await lastToast(page).textContent())?.trim(), dl: await dl };
+	};
+	const failures_ = [
+		['文件不存在', fileUrl(path.join(ASSETS, 'e2e-lastframe', 'missing.mp4')), '视频文件不存在或已被移除，无法导出尾帧'],
+		['无权限（越界路径 403）', fileUrl('/etc/hostname'), '没有访问该视频的权限，无法导出尾帧'],
+		['文件损坏（随机字节）', fileUrl(junk), '当前浏览器不支持该视频格式，或文件已损坏，无法导出尾帧'],
+		['跨域且无 CORS', 'http://127.0.0.1:18190/synth-square.mp4', '该视频来自其他站点，浏览器禁止读取画面（跨域限制），请先下载原视频'],
+		['整段片尾黑屏', fileUrl(allBlack), '视频结尾 1 秒内都是黑屏，未导出尾帧'],
+	];
+	for (const [label, src, want] of failures_) {
+		const r = await tryExport(src);
+		ok(`失败·${label}: 中文提示且不下载`, r.res === false && r.msg === want && !r.dl, r.msg);
+	}
+	const tr = await tryExport(fileUrl(truncated));
+	ok('失败·截断的真实视频: 给出中文失败提示或仍导出有效帧', tr.res === false ? /无法|损坏|不支持/.test(tr.msg || '') : !!tr.dl, tr.msg);
+	await page.screenshot({ path: path.join(OUT, '04-error-toast.png') });
+
+	const timeout = await page.evaluate(async () => {
+		const m = await import('/src/lib/media/exportFrame.ts');
+		const t0 = performance.now();
+		try {
+			await m.captureLastFrame('http://127.0.0.1:18191/hang.mp4', { fileTag: '尾帧', timeoutMs: 2500 });
+			return { code: 'none' };
+		} catch (e) {
+			return { code: e.code, ms: performance.now() - t0 };
+		}
+	});
+	ok('失败·加载超时: 按时放弃并报 timeout', timeout.code === 'timeout' && timeout.ms < 6000, JSON.stringify(timeout));
+
+	const UNSEEKABLE = '无法定位到视频结尾（时长未知或来源不支持拖动进度），未导出尾帧';
+	const noRange = await tryExport('http://127.0.0.1:18192/synth-square.mp4');
+	ok('失败·来源不支持拖动且时长未知: 中文提示，不导出首帧冒充', noRange.res === false && noRange.msg === UNSEEKABLE && !noRange.dl, noRange.msg);
+	fs.copyFileSync(realSrc, path.join(SAMPLES, path.basename(realSrc)));
+	const cors = await tryExport(`http://127.0.0.1:18192/${encodeURIComponent(path.basename(realSrc))}`);
+	if (cors.res) {
+		ok('跨域（允许 CORS）的真实视频可导出', !!cors.dl, cors.msg);
+		await verifyDownload(page, '跨域 CORS·真实', cors.dl, realSrc);
+	} else {
+		ok('跨域（允许 CORS、无 Range）的真实视频：明确提示无法定位结尾', cors.msg === UNSEEKABLE, cors.msg);
+	}
+	const wb = await tryExport(fileUrl(webm));
+	ok('MediaRecorder WebM（时长未知）可导出', wb.res === true && !!wb.dl, wb.msg);
+	if (wb.dl) await verifyDownload(page, 'WebM 1280×720', wb.dl, webm, { center: isMagenta });
+	servers.kill();
+
+	// ---------- 手机 ----------
+	const phone = await browser.newContext({
+		viewport: { width: 390, height: 844 },
+		deviceScaleFactor: 3,
+		isMobile: true,
+		hasTouch: true,
+		acceptDownloads: true,
+	});
+	const mp = await phone.newPage();
+	await mp.goto(`${WEB}/video`);
+	await mp.waitForSelector('.take', { timeout: 20000 });
+	const pc = clips.find((c) => c.label.startsWith('竖屏'));
+	await mp.locator('.take', { hasText: pc.prompt }).first().tap();
+	await mp.waitForTimeout(600);
+	const mBtn = mp.locator('.inspector .actions button', { hasText: '导出尾帧' });
+	const box = await mBtn.boundingBox();
+	ok('手机：检视区导出尾帧按钮在屏内可点', !!box && box.x >= 0 && box.x + box.width <= 390 && box.height >= 28, JSON.stringify(box));
+	await mp.screenshot({ path: path.join(OUT, '05-phone-inspector.png') });
+	const [mdl] = await Promise.all([mp.waitForEvent('download', { timeout: 40000 }), mBtn.tap()]);
+	await verifyDownload(mp, '手机·竖屏', mdl, pc.asset, pc);
+	await mp.goto(`${WEB}/library`);
+	await mp.waitForSelector('.card .media', { timeout: 20000 });
+	await mp.locator(`.card .media[title="${path.basename(pc.asset)}"]`).first().tap();
+	await mp.waitForSelector('.backdrop .player-frame video', { timeout: 10000 });
+	const mTool = mp.locator('.backdrop .toolbar button[aria-label="导出尾帧"]');
+	const tbox = await mTool.boundingBox();
+	ok('手机：弹层导出尾帧按钮在屏内', !!tbox && tbox.x >= 0 && tbox.x + tbox.width <= 390, JSON.stringify(tbox));
+	const [mdl2] = await Promise.all([mp.waitForEvent('download', { timeout: 40000 }), mTool.tap()]);
+	await verifyDownload(mp, '手机·弹层', mdl2, pc.asset, pc);
+	await mp.waitForTimeout(250);
+	await mp.screenshot({ path: path.join(OUT, '06-phone-lightbox.png') });
+
+	await browser.close();
+	console.log(failures ? `\n${failures} check(s) FAILED` : '\nALL PASS');
+	process.exit(failures ? 1 : 0);
+};
+
+run().catch((e) => {
+	console.error(e);
+	process.exit(1);
+});

example_ComfyUI_workflows/0-基础处理：图像合并-音频分离-视频截取合并-图像视频放大/Minimax-H3提示词增强.json

@@ -0,0 +1,315 @@
+{
+  "id": "e3f2b845-8f2c-4b5a-9caf-eac1029d3e7e",
+  "revision": 0,
+  "last_node_id": 173,
+  "last_link_id": 338,
+  "nodes": [
+    {
+      "id": 169,
+      "type": "MiniMaxH3GuidedWriter",
+      "pos": [
+        0,
+        0
+      ],
+      "size": [
+        400,
+        654
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "options",
+          "shape": 7,
+          "type": "H3_REWRITER_OPTIONS",
+          "link": null
+        }
+      ],
+      "outputs": [
+        {
+          "name": "rewritten_prompt",
+          "type": "STRING",
+          "links": [
+            336
+          ]
+        },
+        {
+          "name": "integrated_multimodal_description",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "overall_soundscape",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "non_diegetic_music",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "title": "Write the prompt",
+      "properties": {
+        "Node name for S&R": "MiniMaxH3GuidedWriter",
+        "max_duration": 30,
+        "cnr_id": "minimax-h3-prompt-rewriter",
+        "ver": "a59888df88a69385d429b6865ea441e7844f49c9"
+      },
+      "widgets_values": [
+        "图1的男人和图2的女人赤身躺在床上，女人跨坐在他身上，缓慢地起伏，双手撑在他胸口，头向后仰，呼吸越来越急。男人仰面躺着，喘息着低声说：\"看着我。\"女人俯下身吻他，镜头从侧面缓慢推近。\n",
+        "on disk: Qwen3.5-9B-Uncensored-HauhauCS-Aggressive-Q4_K_M.gguf [qwen35, 5.2 GB]",
+        "T2VA",
+        "16:9",
+        10,
+        true,
+        42,
+        "fixed",
+        false,
+        "",
+        "",
+        false,
+        "",
+        false,
+        ""
+      ],
+      "widgets_values_named": {
+        "prompt": "图1的男人和图2的女人赤身躺在床上，女人跨坐在他身上，缓慢地起伏，双手撑在他胸口，头向后仰，呼吸越来越急。男人仰面躺着，喘息着低声说：\"看着我。\"女人俯下身吻他，镜头从侧面缓慢推近。\n",
+        "model": "on disk: Qwen3.5-9B-Uncensored-HauhauCS-Aggressive-Q4_K_M.gguf [qwen35, 5.2 GB]",
+        "task": "T2VA",
+        "resolution": "16:9",
+        "duration": 10,
+        "greedy": true,
+        "seed": 42,
+        "control_after_generate": "fixed",
+        "keep_model_loaded": false,
+        "aspect_ratio": "",
+        "reference_material": "",
+        "bypass": false,
+        "system_prompt": "",
+        "repeat_last": false,
+        "library_pick": ""
+      }
+    },
+    {
+      "id": 170,
+      "type": "MiniMaxH3PromptCheck",
+      "pos": [
+        460,
+        0
+      ],
+      "size": [
+        390,
+        420
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "options",
+          "shape": 7,
+          "type": "H3_REWRITER_OPTIONS",
+          "link": null
+        },
+        {
+          "label": "ref_0",
+          "name": "references.ref_0",
+          "shape": 7,
+          "type": "IMAGE,VIDEO,AUDIO",
+          "link": null
+        },
+        {
+          "name": "prompt",
+          "type": "STRING",
+          "widget": {
+            "name": "prompt"
+          },
+          "link": 336
+        }
+      ],
+      "outputs": [
+        {
+          "name": "prompt",
+          "type": "STRING",
+          "links": [
+            337
+          ]
+        },
+        {
+          "name": "integrated_multimodal_description",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "subject_definitions",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "summary",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "retention_analysis",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "detailed_description",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "overall_soundscape",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "non_diegetic_music",
+          "type": "STRING",
+          "links": null
+        },
+        {
+          "name": "findings",
+          "type": "STRING",
+          "links": [
+            338
+          ]
+        }
+      ],
+      "title": "Check it against the H3 rules",
+      "properties": {
+        "Node name for S&R": "MiniMaxH3PromptCheck",
+        "max_duration": 30,
+        "cnr_id": "minimax-h3-prompt-rewriter",
+        "ver": "a59888df88a69385d429b6865ea441e7844f49c9"
+      },
+      "widgets_values": [
+        "",
+        "T2VA",
+        5
+      ],
+      "widgets_values_named": {
+        "prompt": "",
+        "task": "T2VA",
+        "duration": 5
+      }
+    },
+    {
+      "id": 171,
+      "type": "PreviewAny",
+      "pos": [
+        900,
+        0
+      ],
+      "size": [
+        560,
+        480
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "source",
+          "type": "*",
+          "link": 337
+        }
+      ],
+      "outputs": [
+        {
+          "name": "STRING",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "title": "The finished prompt",
+      "properties": {
+        "Node name for S&R": "PreviewAny",
+        "cnr_id": "comfy-core",
+        "ver": "0.30.0"
+      },
+      "widgets_values": [],
+      "widgets_values_named": {}
+    },
+    {
+      "id": 172,
+      "type": "PreviewAny",
+      "pos": [
+        900,
+        520
+      ],
+      "size": [
+        560,
+        240
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "source",
+          "type": "*",
+          "link": 338
+        }
+      ],
+      "outputs": [
+        {
+          "name": "STRING",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "title": "What the check found",
+      "properties": {
+        "Node name for S&R": "PreviewAny",
+        "cnr_id": "comfy-core",
+        "ver": "0.30.0"
+      },
+      "widgets_values": [],
+      "widgets_values_named": {}
+    }
+  ],
+  "links": [
+    [
+      336,
+      169,
+      0,
+      170,
+      2,
+      "STRING"
+    ],
+    [
+      337,
+      170,
+      0,
+      171,
+      0,
+      "STRING"
+    ],
+    [
+      338,
+      170,
+      8,
+      172,
+      0,
+      "STRING"
+    ]
+  ],
+  "groups": [],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 1.1772972972972988,
+      "offset": [
+        429.8282570474093,
+        283.1220192192576
+      ]
+    },
+    "frontendVersion": "1.53.10"
+  },
+  "version": 0.4
+}

example_ComfyUI_workflows/0-基础处理：图像合并-音频分离-视频截取合并-图像视频放大/加载本地latent解码.json

@@ -0,0 +1 @@
+{"id":"fae76a0b-6efc-499c-ae87-9d887bcd785f","revision":0,"last_node_id":10,"last_link_id":5,"nodes":[{"id":10,"type":"DJZ-LoadLatent","pos":[960,680],"size":[390,60],"flags":{},"order":1,"mode":0,"inputs":[{"label":"latent_file","localized_name":"latent_file","name":"latent_file","type":"COMBO","widget":{"name":"latent_file"},"link":null}],"outputs":[{"label":"LATENT","localized_name":"Latent","name":"LATENT","type":"LATENT","links":[5]}],"properties":{"cnr_id":"djz-nodes","ver":"f6ca9376132600e6245d3d9d2f1e5d0ffa448d99","Node name for S&R":"DJZ-LoadLatent","aux_id":"MushroomFleet/DJZ-Nodes","ue_properties":{"widget_ue_connectable":{},"input_ue_unconnectable":{},"version":"7.4.1"}},"widgets_values":["latents\\ComfyUI_00001_nmxvu_1762517653.latent"]},{"id":3,"type":"VAEDecode","pos":[1460,760],"size":[140,50],"flags":{},"order":2,"mode":0,"inputs":[{"label":"Latent","localized_name":"Latent","name":"samples","type":"LATENT","link":5},{"label":"VAE","localized_name":"vae","name":"vae","type":"VAE","link":4}],"outputs":[{"label":"图像","localized_name":"图像","name":"IMAGE","type":"IMAGE","links":[2]}],"properties":{"cnr_id":"comfy-core","ver":"0.3.57","Node name for S&R":"VAEDecode","ue_properties":{"widget_ue_connectable":{},"version":"7.1","input_ue_unconnectable":{}}},"widgets_values":[]},{"id":4,"type":"VHS_VideoCombine","pos":[1680,750],"size":[400,334],"flags":{},"order":3,"mode":0,"inputs":[{"label":"图像","localized_name":"图像","name":"images","type":"IMAGE","link":2},{"label":"音频","localized_name":"音频","name":"audio","shape":7,"type":"AUDIO","link":null},{"label":"批次管理","localized_name":"批次管理","name":"meta_batch","shape":7,"type":"VHS_BatchManager","link":null},{"localized_name":"vae","name":"vae","shape":7,"type":"VAE","link":null},{"label":"帧率","localized_name":"帧率","name":"frame_rate","type":"FLOAT","widget":{"name":"frame_rate"},"link":null},{"label":"循环次数","localized_name":"循环次数","name":"loop_count","type":"INT","widget":{"name":"loop_count"},"link":null},{"label":"文件名前缀","localized_name":"文件名前缀","name":"filename_prefix","type":"STRING","widget":{"name":"filename_prefix"},"link":null},{"label":"格式","localized_name":"格式","name":"format","type":"COMBO","widget":{"name":"format"},"link":null},{"label":"Ping-Pong","localized_name":"Ping-Pong","name":"pingpong","type":"BOOLEAN","widget":{"name":"pingpong"},"link":null},{"label":"保存到输出文件夹","localized_name":"保存到输出文件夹","name":"save_output","type":"BOOLEAN","widget":{"name":"save_output"},"link":null},{"name":"pix_fmt","type":["yuv420p","yuv420p10le"],"widget":{"name":"pix_fmt"},"link":null},{"name":"crf","type":"INT","widget":{"name":"crf"},"link":null},{"label":"保存元数据","localized_name":"保存元数据","name":"save_metadata","type":"BOOLEAN","widget":{"name":"save_metadata"},"link":null},{"label":"修剪音频","localized_name":"修剪音频","name":"trim_to_audio","type":"BOOLEAN","widget":{"name":"trim_to_audio"},"link":null}],"outputs":[{"label":"文件名","localized_name":"文件名","name":"Filenames","type":"VHS_FILENAMES","links":null}],"properties":{"cnr_id":"comfyui-videohelpersuite","ver":"8e4d79471bf1952154768e8435a9300077b534fa","Node name for S&R":"VHS_VideoCombine","ue_properties":{"widget_ue_connectable":{},"version":"7.1","input_ue_unconnectable":{}}},"widgets_values":{"frame_rate":16,"loop_count":0,"filename_prefix":"video/WanVideo_","format":"video/h264-mp4","pix_fmt":"yuv420p","crf":19,"save_metadata":true,"trim_to_audio":false,"pingpong":false,"save_output":true,"videopreview":{"hidden":false,"paused":false,"params":{"filename":"WanVideo__00001.mp4","subfolder":"video","type":"output","format":"video/h264-mp4","frame_rate":16,"workflow":"WanVideo__00001.png","fullpath":"E:\\ComfyUI-Data\\output\\video\\WanVideo__00001.mp4"}}}},{"id":5,"type":"VAELoader","pos":[980,820],"size":[360,60],"flags":{},"order":0,"mode":0,"inputs":[{"localized_name":"vae名称","name":"vae_name","type":"COMBO","widget":{"name":"vae_name"},"link":null}],"outputs":[{"localized_name":"VAE","name":"VAE","type":"VAE","links":[4]}],"properties":{"cnr_id":"comfy-core","ver":"0.3.68","Node name for S&R":"VAELoader","ue_properties":{"widget_ue_connectable":{},"input_ue_unconnectable":{},"version":"7.4.1"}},"widgets_values":["Wan2_1_VAE_bf16.safetensors"]}],"links":[[2,3,0,4,0,"IMAGE"],[4,5,0,3,1,"VAE"],[5,10,0,3,0,"LATENT"]],"groups":[],"config":{},"extra":{"ue_links":[],"ds":{"scale":1.0834705943389082,"offset":[-573.5954979317662,-431.50654580611246]},"links_added_by_ue":[]},"version":0.4}

example_ComfyUI_workflows/0-基础处理：图像合并-音频分离-视频截取合并-图像视频放大/图像分割-多宫格分割.json

@@ -0,0 +1 @@
+{"id":"51bbecaf-42f9-4de3-95e4-b6db447eb5db","revision":0,"last_node_id":3,"last_link_id":2,"nodes":[{"id":3,"type":"PreviewImage","pos":[1480,500],"size":[400,260],"flags":{},"order":2,"mode":0,"inputs":[{"localized_name":"图像","name":"images","type":"IMAGE","link":2}],"outputs":[{"localized_name":"images","name":"images","type":"IMAGE","links":null}],"properties":{"cnr_id":"comfy-core","ver":"0.21.1","Node name for S&R":"PreviewImage","ue_properties":{"widget_ue_connectable":{},"input_ue_unconnectable":{},"version":"7.8"}},"widgets_values":[]},{"id":2,"type":"GuHaiAutoImageSplit","pos":[1160,500],"size":[270,210],"flags":{},"order":1,"mode":0,"inputs":[{"localized_name":"图像","name":"图像","type":"IMAGE","link":1},{"localized_name":"保存目录","name":"保存目录","type":"STRING","widget":{"name":"保存目录"},"link":null},{"localized_name":"水平张数","name":"水平张数","type":"INT","widget":{"name":"水平张数"},"link":null},{"localized_name":"垂直张数","name":"垂直张数","type":"INT","widget":{"name":"垂直张数"},"link":null},{"localized_name":"移除画布边缘","name":"移除画布边缘","type":"BOOLEAN","widget":{"name":"移除画布边缘"},"link":null},{"localized_name":"移除描边","name":"移除描边","type":"INT","widget":{"name":"移除描边"},"link":null},{"localized_name":"文件名前缀","name":"文件名前缀","type":"STRING","widget":{"name":"文件名前缀"},"link":null},{"localized_name":"保存格式","name":"保存格式","type":"COMBO","widget":{"name":"保存格式"},"link":null}],"outputs":[{"localized_name":"分割图像","name":"分割图像","type":"IMAGE","links":[2]}],"properties":{"aux_id":"goohai/Goohaitools-comfyui","ver":"885cac3dd323d26a77b69ae904a9a344f0dee7d0","Node name for S&R":"GuHaiAutoImageSplit","ue_properties":{"widget_ue_connectable":{},"input_ue_unconnectable":{},"version":"7.8"}},"widgets_values":["output",3,3,true,8,"孤海图像分割_","PNG"]},{"id":1,"type":"LoadImage","pos":[850,490],"size":[270,320],"flags":{},"order":0,"mode":0,"inputs":[{"localized_name":"图像","name":"image","type":"COMBO","widget":{"name":"image"},"link":null},{"localized_name":"选择文件上传","name":"upload","type":"IMAGEUPLOAD","widget":{"name":"upload"},"link":null}],"outputs":[{"localized_name":"图像","name":"IMAGE","type":"IMAGE","links":[1]},{"localized_name":"遮罩","name":"MASK","type":"MASK","links":null}],"properties":{"cnr_id":"comfy-core","ver":"0.21.1","Node name for S&R":"LoadImage","ue_properties":{"widget_ue_connectable":{},"input_ue_unconnectable":{},"version":"7.8"}},"widgets_values":["Image (4) (1).png","image"]}],"links":[[1,1,0,2,0,"IMAGE"],[2,2,0,3,0,"IMAGE"]],"groups":[{"id":1,"title":"图像分割","bounding":[810,420,1100,400],"color":"#3f789e","flags":{}}],"config":{},"extra":{"ds":{"scale":0.9090909090909091,"offset":[-259.9355305037313,15.820561879510858]},"ue_links":[]},"version":0.4}