@lingjingai/script-editor 0.1.28 → 0.2.0

package/dist/index.d.ts

@@ -11,9 +11,19 @@ interface SceneEnvironment {
     space?: "exterior" | "interior" | string;
     time?: "day" | "night" | "dawn" | "dusk" | string;
 }
+/** v3 inline dialogue speaker: an actor ref, OR a non-actor source (system / broadcast / …). */
+type V3Speaker = {
+    actor_id?: string;
+    state_id?: string | null;
+} | {
+    kind?: "system" | "broadcast" | "offscreen" | "group" | string;
+    label?: string;
+};
 interface ScriptItem {
     type?: ScriptContentType | string;
     content?: string;
+    /** v3: inline speaker object (actor ref or non-actor kind). */
+    speaker?: V3Speaker;
     actor_id?: string;
     speaker_id?: string;
     speakers?: Array<{
@@ -35,6 +45,8 @@ interface AssetState {
     description?: string;
 }
 type ScriptTargetKind = "actor" | "location" | "prop";
+/** v3 asset tier: featured = 主角/配角 (下游出资产 + 跟踪状态); background = 龙套/背景. */
+type Importance = "featured" | "background";
 interface StateChange {
     target_kind?: ScriptTargetKind | string;
     target_id?: string;
@@ -65,6 +77,11 @@ interface SceneContext {
 interface Scene {
     scene_id?: string;
     environment?: SceneEnvironment;
+    /** v3: single scene location (object), replaces the legacy location_ids[]. */
+    location?: {
+        location_id?: string;
+        state_id?: string | null;
+    } | null;
     location_ids?: string[];
     context?: SceneContext;
     actors?: Array<{
@@ -86,6 +103,7 @@ interface ScriptActor {
     actor_name?: string;
     name?: string;
     description?: string;
+    importance?: Importance;
     states?: AssetState[];
 }
 interface ScriptLocation {
@@ -93,6 +111,7 @@ interface ScriptLocation {
     location_name?: string;
     name?: string;
     description?: string;
+    importance?: Importance;
     states?: AssetState[];
 }
 interface ScriptProp {
@@ -100,6 +119,7 @@ interface ScriptProp {
     prop_name?: string;
     name?: string;
     description?: string;
+    importance?: Importance;
     states?: AssetState[];
 }
 interface ScriptEpisode {
@@ -703,6 +723,8 @@ declare function pickInheritedActorId(scene: Scene, beforeIndex: number): string
 
 type EntityKind = "actor" | "location" | "prop";
 declare function updateEntityName(data: ScriptProject, kind: EntityKind, id: string, name: string): ScriptProject;
+/** Flip an asset between featured (主要) and background (龙套/背景). */
+declare function setEntityImportance(data: ScriptProject, kind: EntityKind, id: string, importance: Importance): ScriptProject;
 declare function updateEntityDescription(data: ScriptProject, kind: EntityKind, id: string, description: string): ScriptProject;
 declare function updateEntityStateField(data: ScriptProject, kind: EntityKind, id: string, stateId: string, field: "state_name" | "description", value: string): ScriptProject;
 declare function addEntityState(data: ScriptProject, kind: EntityKind, id: string, state: AssetState): ScriptProject;
@@ -738,6 +760,7 @@ declare const index_nextEpisodeSceneId: typeof nextEpisodeSceneId;
 declare const index_pickInheritedActorId: typeof pickInheritedActorId;
 declare const index_removeEntityState: typeof removeEntityState;
 declare const index_replaceSceneItem: typeof replaceSceneItem;
+declare const index_setEntityImportance: typeof setEntityImportance;
 declare const index_splitScene: typeof splitScene;
 declare const index_updateEntityDescription: typeof updateEntityDescription;
 declare const index_updateEntityName: typeof updateEntityName;
@@ -752,7 +775,7 @@ declare const index_updateSceneItemType: typeof updateSceneItemType;
 declare const index_updateSceneLocationState: typeof updateSceneLocationState;
 declare const index_updateScenePropState: typeof updateScenePropState;
 declare namespace index {
-  export { type index_EntityKind as EntityKind, type index_ItemDraft as ItemDraft, type index_ItemLocation as ItemLocation, type index_SceneAssetStateBindingKind as SceneAssetStateBindingKind, type index_SceneAssetStateBindingTarget as SceneAssetStateBindingTarget, type index_SceneDraft as SceneDraft, index_addBlankScene as addBlankScene, index_addEntityState as addEntityState, index_addEpisode as addEpisode, index_buildNewScriptItem as buildNewScriptItem, index_buildSceneDraft as buildSceneDraft, index_createItemFromDraft as createItemFromDraft, index_createSceneFromDraft as createSceneFromDraft, index_decrementSceneId as decrementSceneId, index_deleteEpisode as deleteEpisode, index_deleteScene as deleteScene, index_deleteSceneItem as deleteSceneItem, index_getPrimarySceneLocationId as getPrimarySceneLocationId, index_getSceneActorsText as getSceneActorsText, index_incrementSceneId as incrementSceneId, index_insertScene as insertScene, index_insertSceneItem as insertSceneItem, index_mergeSceneIntoPrev as mergeSceneIntoPrev, index_moveSceneItem as moveSceneItem, index_moveScriptItem as moveScriptItem, index_nextAvailableSceneId as nextAvailableSceneId, index_nextEpisodeSceneId as nextEpisodeSceneId, index_pickInheritedActorId as pickInheritedActorId, index_removeEntityState as removeEntityState, index_replaceSceneItem as replaceSceneItem, index_splitScene as splitScene, index_updateEntityDescription as updateEntityDescription, index_updateEntityName as updateEntityName, index_updateEntityStateField as updateEntityStateField, index_updateSceneActorState as updateSceneActorState, index_updateSceneAssetStateBindings as updateSceneAssetStateBindings, index_updateSceneField as updateSceneField, index_updateSceneItemActor as updateSceneItemActor, index_updateSceneItemContent as updateSceneItemContent, index_updateSceneItemEmotion as updateSceneItemEmotion, index_updateSceneItemType as updateSceneItemType, index_updateSceneLocationState as updateSceneLocationState, index_updateScenePropState as updateScenePropState };
+  export { type index_EntityKind as EntityKind, type index_ItemDraft as ItemDraft, type index_ItemLocation as ItemLocation, type index_SceneAssetStateBindingKind as SceneAssetStateBindingKind, type index_SceneAssetStateBindingTarget as SceneAssetStateBindingTarget, type index_SceneDraft as SceneDraft, index_addBlankScene as addBlankScene, index_addEntityState as addEntityState, index_addEpisode as addEpisode, index_buildNewScriptItem as buildNewScriptItem, index_buildSceneDraft as buildSceneDraft, index_createItemFromDraft as createItemFromDraft, index_createSceneFromDraft as createSceneFromDraft, index_decrementSceneId as decrementSceneId, index_deleteEpisode as deleteEpisode, index_deleteScene as deleteScene, index_deleteSceneItem as deleteSceneItem, index_getPrimarySceneLocationId as getPrimarySceneLocationId, index_getSceneActorsText as getSceneActorsText, index_incrementSceneId as incrementSceneId, index_insertScene as insertScene, index_insertSceneItem as insertSceneItem, index_mergeSceneIntoPrev as mergeSceneIntoPrev, index_moveSceneItem as moveSceneItem, index_moveScriptItem as moveScriptItem, index_nextAvailableSceneId as nextAvailableSceneId, index_nextEpisodeSceneId as nextEpisodeSceneId, index_pickInheritedActorId as pickInheritedActorId, index_removeEntityState as removeEntityState, index_replaceSceneItem as replaceSceneItem, index_setEntityImportance as setEntityImportance, index_splitScene as splitScene, index_updateEntityDescription as updateEntityDescription, index_updateEntityName as updateEntityName, index_updateEntityStateField as updateEntityStateField, index_updateSceneActorState as updateSceneActorState, index_updateSceneAssetStateBindings as updateSceneAssetStateBindings, index_updateSceneField as updateSceneField, index_updateSceneItemActor as updateSceneItemActor, index_updateSceneItemContent as updateSceneItemContent, index_updateSceneItemEmotion as updateSceneItemEmotion, index_updateSceneItemType as updateSceneItemType, index_updateSceneLocationState as updateSceneLocationState, index_updateScenePropState as updateScenePropState };
 }
 
 /**
@@ -807,4 +830,4 @@ declare function DeleteConfirmButton({ onConfirm, disabled, targetScope, title,
     description?: string;
 }): react.JSX.Element;
 
-export { type AssetAdapter, type AssetDeleteRequest, type AssetState, type ChangeSet, type ChatReference, DeleteConfirmButton, type DiffActionMark, type DiffAdapter, type DiffSceneMark, EMPTY_SELECTION, EditableText, type EpisodeWorkspaceView, type FieldChange, Popover, type SaveStatus, type Scene, type SceneActionDiff, type SceneChangeKind, type SceneContext, type SceneEnvironment, type ScriptActor, ScriptContentType, type ScriptData, ScriptEditor, type ScriptEditorAdapters, type ScriptEditorProps, type ScriptEpisode, type ScriptFormat, type ScriptItem, type ScriptLocation, type ScriptNav, type ScriptNavEntity, type ScriptNavEpisode, type ScriptNavScene, type ScriptProject, type ScriptProp, type ScriptReferenceFocusRequest, type ScriptReferenceLocator, type ScriptSpeaker, type ScriptTargetKind, SelectField, type StateChange, type StudioSelection, type StudioSelectionFrom, type StudioSelectionOrigin, type TransitionPrompt, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildScriptNav, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, findBaselineScene, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, index as mutations, rejectActionToBaseline, rejectSceneToBaseline, sceneChangeKey, selectionFromScriptReference, selectionTargetKey, withOrigin };
+export { type AssetAdapter, type AssetDeleteRequest, type AssetState, type ChangeSet, type ChatReference, DeleteConfirmButton, type DiffActionMark, type DiffAdapter, type DiffSceneMark, EMPTY_SELECTION, EditableText, type EpisodeWorkspaceView, type FieldChange, type Importance, Popover, type SaveStatus, type Scene, type SceneActionDiff, type SceneChangeKind, type SceneContext, type SceneEnvironment, type ScriptActor, ScriptContentType, type ScriptData, ScriptEditor, type ScriptEditorAdapters, type ScriptEditorProps, type ScriptEpisode, type ScriptFormat, type ScriptItem, type ScriptLocation, type ScriptNav, type ScriptNavEntity, type ScriptNavEpisode, type ScriptNavScene, type ScriptProject, type ScriptProp, type ScriptReferenceFocusRequest, type ScriptReferenceLocator, type ScriptSpeaker, type ScriptTargetKind, SelectField, type StateChange, type StudioSelection, type StudioSelectionFrom, type StudioSelectionOrigin, type TransitionPrompt, type V3Speaker, acceptActionIntoBaseline, acceptSceneIntoBaseline, applyActionAccept, applyActionReject, buildActionDiff, buildDiffFromBaseline, buildScriptNav, buildSelectionFrom, changeSetToDiffScenes, computeChangeSet, computeSceneActionDiff, findBaselineScene, fromToSelection, getActorCueVar, getActorMap, getEpisodeTitle, getLocationMap, getPropMap, getSceneContext, getSelectionEpisodeIdx, getSpeakerMap, isClipSelected, isEpisodeOpen, isSameSelectionTarget, isSceneSelected, index as mutations, rejectActionToBaseline, rejectSceneToBaseline, sceneChangeKey, selectionFromScriptReference, selectionTargetKey, withOrigin };

package/dist/index.js

@@ -280,12 +280,31 @@ function getStateDisplayName(state) {
   return state?.state_name?.trim() || state?.name?.trim() || state?.state_id?.trim() || "";
 }
 function getSceneContext(scene) {
+  const v3Loc = scene.location?.location_id?.trim() ? [{ location_id: scene.location.location_id, state_id: scene.location.state_id ?? null }] : null;
   return {
     actors: (scene.context?.actors?.length ? scene.context.actors : scene.actors) ?? [],
-    locations: (scene.context?.locations?.length ? scene.context.locations : scene.locations) ?? [],
+    locations: (scene.context?.locations?.length ? scene.context.locations : scene.locations?.length ? scene.locations : v3Loc) ?? [],
     props: (scene.context?.props?.length ? scene.context.props : scene.props) ?? []
   };
 }
+function countAssetAppearances(data) {
+  const actors = /* @__PURE__ */ new Map();
+  const locations = /* @__PURE__ */ new Map();
+  const props = /* @__PURE__ */ new Map();
+  const bump = (m, id) => {
+    const k = id?.trim();
+    if (k) m.set(k, (m.get(k) ?? 0) + 1);
+  };
+  for (const ep of data.episodes ?? []) {
+    for (const scene of ep.scenes ?? []) {
+      const ctx = getSceneContext(scene);
+      for (const a of ctx.actors) bump(actors, a.actor_id);
+      for (const l of ctx.locations) bump(locations, l.location_id);
+      for (const p of ctx.props) bump(props, p.prop_id);
+    }
+  }
+  return { actors, locations, props };
+}
 function findState(states2, stateId) {
   const id = stateId?.trim();
   if (!id || !states2) return void 0;
@@ -411,7 +430,28 @@ function getSpeakerDisplayName(speakerId, speakerMap = /* @__PURE__ */ new Map()
   if (actorId && actorMap.has(actorId)) return getActorDisplayName(actorMap.get(actorId));
   return id;
 }
+var V3_SPEAKER_KIND_ZH = {
+  system: "\u7CFB\u7EDF",
+  broadcast: "\u5E7F\u64AD",
+  offscreen: "\u753B\u5916\u97F3",
+  group: "\u7FA4\u4F53"
+};
+function getV3Speaker(item) {
+  const s = item.speaker;
+  if (!s || typeof s !== "object") return null;
+  if ("actor_id" in s && s.actor_id?.trim()) return { actorId: s.actor_id.trim() };
+  if ("kind" in s && s.kind) {
+    const label = s.label?.trim();
+    return { label: label || V3_SPEAKER_KIND_ZH[s.kind] || s.kind };
+  }
+  return null;
+}
+function getItemActorId(item) {
+  return item.actor_id?.trim() || getV3Speaker(item)?.actorId || "";
+}
 function getDialogueSpeakerLabel(item, actorMap, speakerMap = /* @__PURE__ */ new Map()) {
+  const v3 = getV3Speaker(item);
+  if (v3) return v3.actorId ? getActorDisplayName(actorMap.get(v3.actorId)) || v3.actorId : v3.label ?? "";
   if (item.delivery === "overlap" && Array.isArray(item.lines) && item.lines.length > 0) {
     return item.lines.map((line) => getSpeakerDisplayName(line.speaker_id, speakerMap, actorMap)).filter(Boolean).join(" / ");
   }
@@ -478,6 +518,7 @@ function StudioToc({
   });
   const pick = (sel) => onSelect(withOrigin(sel, "sidebar"));
   const epHighlighted = selection.kind === "episode" || selection.kind === "scene" || selection.kind === "clip";
+  const counts = useMemo(() => countAssetAppearances(data), [data.episodes]);
   return /* @__PURE__ */ jsxs("nav", { className: "lj-se-toc", children: [
     /* @__PURE__ */ jsx(
       GroupHeader,
@@ -536,7 +577,10 @@ function StudioToc({
         icon: Users,
         label: "\u89D2\u8272",
         emptyText: "\u5C1A\u65E0\u89D2\u8272",
-        items: (data.actors ?? []).map((a) => ({ id: (a.actor_id ?? "").trim(), name: getActorDisplayName(a) })),
+        items: (data.actors ?? []).map((a) => {
+          const id = (a.actor_id ?? "").trim();
+          return { id, name: getActorDisplayName(a), importance: a.importance, count: counts.actors.get(id) ?? 0 };
+        }),
         highlighted: selection.kind === "actor",
         isActive: (id) => selection.kind === "actor" && selection.actorId === id,
         onPick: (id) => pick({ kind: "actor", actorId: id })
@@ -548,7 +592,10 @@ function StudioToc({
         icon: MapPin,
         label: "\u573A\u666F",
         emptyText: "\u5C1A\u65E0\u573A\u666F",
-        items: (data.locations ?? []).map((l) => ({ id: (l.location_id ?? "").trim(), name: getLocationDisplayName(l) })),
+        items: (data.locations ?? []).map((l) => {
+          const id = (l.location_id ?? "").trim();
+          return { id, name: getLocationDisplayName(l), importance: l.importance, count: counts.locations.get(id) ?? 0 };
+        }),
         highlighted: selection.kind === "location",
         isActive: (id) => selection.kind === "location" && selection.locationId === id,
         onPick: (id) => pick({ kind: "location", locationId: id })
@@ -560,7 +607,10 @@ function StudioToc({
         icon: Package,
         label: "\u9053\u5177",
         emptyText: "\u5C1A\u65E0\u9053\u5177",
-        items: (data.props ?? []).map((p) => ({ id: (p.prop_id ?? "").trim(), name: getPropDisplayName(p) })),
+        items: (data.props ?? []).map((p) => {
+          const id = (p.prop_id ?? "").trim();
+          return { id, name: getPropDisplayName(p), importance: p.importance, count: counts.props.get(id) ?? 0 };
+        }),
         highlighted: selection.kind === "prop",
         isActive: (id) => selection.kind === "prop" && selection.propId === id,
         onPick: (id) => pick({ kind: "prop", propId: id })
@@ -578,22 +628,42 @@ function EntityGroup({
   onPick
 }) {
   const [open, setOpen] = useState(true);
+  const [bgOpen, setBgOpen] = useState(false);
+  const byCount = (a, b) => b.count - a.count || a.name.localeCompare(b.name, "zh");
   const valid = items.filter((i) => i.id);
+  const featured = valid.filter((i) => i.importance !== "background").sort(byCount);
+  const background = valid.filter((i) => i.importance === "background").sort(byCount);
+  const row = (i) => /* @__PURE__ */ jsxs(
+    "button",
+    {
+      type: "button",
+      className: cn("lj-se-tocitem lj-se-toc-l1", isActive(i.id) && "is-active"),
+      onClick: () => onPick(i.id),
+      children: [
+        /* @__PURE__ */ jsx(Icon, { className: "lj-se-tocitem-icon lj-se-ic-3", strokeWidth: 1.5 }),
+        /* @__PURE__ */ jsx("span", { className: "lj-se-tocitem-label", children: i.name }),
+        i.count > 0 ? /* @__PURE__ */ jsx("span", { className: "lj-se-tocitem-meta", children: i.count }) : null
+      ]
+    },
+    i.id
+  );
   return /* @__PURE__ */ jsxs(Fragment$1, { children: [
     /* @__PURE__ */ jsx(GroupHeader, { icon: Icon, label, count: valid.length, open, highlighted, onToggle: () => setOpen((v) => !v) }),
-    open ? valid.length === 0 ? /* @__PURE__ */ jsx("div", { className: "lj-se-toc-empty", children: emptyText }) : valid.map((i) => /* @__PURE__ */ jsxs(
-      "button",
-      {
-        type: "button",
-        className: cn("lj-se-tocitem lj-se-toc-l1", isActive(i.id) && "is-active"),
-        onClick: () => onPick(i.id),
-        children: [
-          /* @__PURE__ */ jsx(Icon, { className: "lj-se-tocitem-icon lj-se-ic-3", strokeWidth: 1.5 }),
-          /* @__PURE__ */ jsx("span", { className: "lj-se-tocitem-label", children: i.name })
-        ]
-      },
-      i.id
-    )) : null
+    open ? valid.length === 0 ? /* @__PURE__ */ jsx("div", { className: "lj-se-toc-empty", children: emptyText }) : /* @__PURE__ */ jsxs(Fragment$1, { children: [
+      featured.map(row),
+      background.length > 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [
+        /* @__PURE__ */ jsxs("button", { type: "button", className: cn("lj-se-toc-fold", bgOpen && "is-open"), onClick: () => setBgOpen((v) => !v), children: [
+          /* @__PURE__ */ jsx(ChevronRight, { className: "lj-se-toc-fold-chev lj-se-ic-3", strokeWidth: 2 }),
+          /* @__PURE__ */ jsxs("span", { children: [
+            "\u80CC\u666F",
+            label,
+            " \xB7 ",
+            background.length
+          ] })
+        ] }),
+        bgOpen ? background.map(row) : null
+      ] }) : null
+    ] }) : null
   ] });
 }
 var HighlightContext = createContext("");
@@ -928,18 +998,20 @@ function normalizeCommaList(value) {
 }
 function setSceneContext(scene, patch) {
   const current = getSceneContext(scene);
-  const context = {
-    actors: patch.actors ?? current.actors,
-    locations: patch.locations ?? current.locations,
-    props: patch.props ?? current.props
-  };
-  return {
+  const actors = patch.actors ?? current.actors;
+  const props = patch.props ?? current.props;
+  const locations = patch.locations ?? current.locations;
+  const loc = locations[0];
+  const next = {
     ...scene,
-    context,
-    actors: context.actors,
-    locations: context.locations,
-    props: context.props
+    actors,
+    props,
+    location: loc?.location_id?.trim() ? { location_id: loc.location_id, state_id: loc.state_id ?? null } : null
   };
+  delete next.context;
+  delete next.locations;
+  delete next.location_ids;
+  return next;
 }
 function getSceneActorsText(scene) {
   return (getSceneContext(scene).actors || []).map((item) => item.actor_id?.trim() || "").filter(Boolean).join("\uFF0C");
@@ -1028,17 +1100,18 @@ function createSceneFromDraft(draft) {
       space: draft.space.trim() || "interior",
       time: draft.time.trim() || "day"
     },
-    location_ids: location ? [location] : [],
-    locations: location ? [{ location_id: location, state_id: null }] : [],
+    location: location ? { location_id: location, state_id: null } : null,
     actors: actors.map((actorId) => ({ actor_id: actorId, state_id: null })),
+    props: [],
     actions: []
   };
 }
 function createItemFromDraft(draft) {
   if (draft.kind === "dialogue") {
+    const actorId = draft.actorName.trim();
     return {
       type: "dialogue" /* Dialogue */,
-      actor_id: draft.actorName.trim(),
+      ...actorId ? { speaker: { actor_id: actorId } } : {},
       emotion: draft.emotion.trim(),
       content: draft.content.trim()
     };
@@ -1064,10 +1137,7 @@ function updateSceneField(data, episodeIndex, sceneIndex, field, value) {
     }
     if (field === "location") {
       const location = value.trim();
-      return setSceneContext({
-        ...scene,
-        location_ids: location ? [location] : []
-      }, { locations: location ? [{ location_id: location, state_id: null }] : [] });
+      return setSceneContext(scene, { locations: location ? [{ location_id: location, state_id: null }] : [] });
     }
     if (field === "props") {
       const propIds = normalizeCommaList(value);
@@ -1210,7 +1280,8 @@ function updateSceneItemActor(data, episodeIndex, sceneIndex, itemIndex, actorId
     const actions = [...scene.actions || []];
     const item = actions[itemIndex];
     if (!item) return scene;
-    const next = { ...item, actor_id: actorId.trim() };
+    const next = { ...item, speaker: { actor_id: actorId.trim() } };
+    delete next.actor_id;
     delete next.speaker_id;
     delete next.speakers;
     delete next.lines;
@@ -1437,7 +1508,7 @@ function buildActorDistribution(data, actorId) {
     (episode.scenes ?? []).forEach((scene, si) => {
       const ctx = getSceneContext(scene);
       const ref = (ctx.actors ?? []).find((i) => (i.actor_id ?? "").trim() === actorId);
-      const inActions = !ref && (scene.actions ?? []).some((i) => (i.actor_id ?? "").trim() === actorId);
+      const inActions = !ref && (scene.actions ?? []).some((i) => getItemActorId(i) === actorId);
       if (ref || inActions) {
         items.push({
           key: `actor-${actorId}-${ei}-${si}`,
@@ -1808,11 +1879,17 @@ function updateSceneItemType(data, episodeIndex, sceneIndex, itemIndex, type) {
     const current = actions[itemIndex];
     if (!current) return scene;
     const next = { ...current, type };
+    delete next.actor_id;
+    delete next.speaker_id;
+    delete next.speakers;
+    delete next.lines;
     if (!isActorBearingContentType(type)) {
-      delete next.actor_id;
+      delete next.speaker;
       delete next.emotion;
     } else {
-      next.actor_id = next.actor_id?.trim() || pickInheritedActorId(scene, itemIndex);
+      const actorId = getItemActorId(current) || pickInheritedActorId(scene, itemIndex);
+      if (actorId) next.speaker = { actor_id: actorId };
+      else delete next.speaker;
       if (type !== "dialogue" /* Dialogue */) {
         delete next.emotion;
       }
@@ -1823,9 +1900,10 @@ function updateSceneItemType(data, episodeIndex, sceneIndex, itemIndex, type) {
 }
 function buildNewScriptItem(type, inheritedActorId) {
   if (isActorBearingContentType(type)) {
+    const actorId = inheritedActorId?.trim();
     return {
       type,
-      actor_id: inheritedActorId?.trim() || "",
+      ...actorId ? { speaker: { actor_id: actorId } } : {},
       content: ""
     };
   }
@@ -1835,8 +1913,9 @@ function pickInheritedActorId(scene, beforeIndex) {
   const actions = scene.actions || [];
   for (let i = beforeIndex - 1; i >= 0; i -= 1) {
     const item = actions[i];
-    if (item && isActorBearingContentType(item.type) && item.actor_id?.trim()) {
-      return item.actor_id.trim();
+    if (item && isActorBearingContentType(item.type)) {
+      const actorId = getItemActorId(item);
+      if (actorId) return actorId;
     }
   }
   return "";
@@ -2346,8 +2425,9 @@ function SceneItemRowImpl({
   const actorId = item.actor_id?.trim() || "";
   const emotion = translateEmotionLabel(item.emotion);
   const stateLabels = formatStateChangeLabels(item, actorMap, locationMap, propMap);
-  const multiSpeaker = type === "dialogue" /* Dialogue */ && (item.delivery === "overlap" || (item.lines?.length ?? 0) > 0 || (item.speakers?.length ?? 0) > 1);
-  const resolvedActorId = actorId || (() => {
+  const v3Speaker = getV3Speaker(item);
+  const multiSpeaker = type === "dialogue" /* Dialogue */ && (item.delivery === "overlap" || (item.lines?.length ?? 0) > 0 || (item.speakers?.length ?? 0) > 1 || !!v3Speaker?.label);
+  const resolvedActorId = actorId || v3Speaker?.actorId || (() => {
     const spkId = item.speaker_id?.trim() || item.speakers?.[0]?.speaker_id?.trim() || "";
     if (!spkId) return "";
     const spk = speakerMap.get(spkId);
@@ -2869,6 +2949,9 @@ function mapEntity(data, kind, id, fn) {
 function updateEntityName(data, kind, id, name) {
   return mapEntity(data, kind, id, (e) => ({ ...e, [NAME_FIELD[kind]]: name }));
 }
+function setEntityImportance(data, kind, id, importance) {
+  return mapEntity(data, kind, id, (e) => ({ ...e, importance }));
+}
 function updateEntityDescription(data, kind, id, description) {
   return mapEntity(data, kind, id, (e) => ({ ...e, description }));
 }
@@ -2894,6 +2977,8 @@ var TIME_ZH = { day: "\u65E5", night: "\u591C", dawn: "\u6668", dusk: "\u66AE" }
 function resolveCueId(item, actorMap, speakerMap) {
   const actorId = item.actor_id?.trim();
   if (actorId) return actorId;
+  const v3 = getV3Speaker(item);
+  if (v3) return v3.actorId ?? "";
   const spkId = item.speaker_id?.trim() || item.speakers?.[0]?.speaker_id?.trim() || "";
   if (!spkId) return "";
   const spk = speakerMap.get(spkId);
@@ -3393,6 +3478,20 @@ function AssetCardImpl({
       /* @__PURE__ */ jsx("span", { className: "lj-se-assetcard-id", children: assetId }),
       /* @__PURE__ */ jsxs("span", { className: "lj-se-assetcard-actions", children: [
         /* @__PURE__ */ jsx("span", { className: "lj-se-assetcard-badge", children: assetGroupLabel(group) }),
+        (() => {
+          const isBg = entity.importance === "background";
+          return /* @__PURE__ */ jsx(
+            "button",
+            {
+              type: "button",
+              className: cn("lj-se-assetcard-imp", isBg && "is-bg"),
+              disabled,
+              title: isBg ? "\u80CC\u666F\uFF08\u9F99\u5957\uFF09\xB7 \u70B9\u51FB\u5347\u4E3A\u4E3B\u8981" : "\u4E3B\u8981 \xB7 \u70B9\u51FB\u964D\u4E3A\u80CC\u666F",
+              onClick: () => onEdit((p) => setEntityImportance(p, kind, assetId, isBg ? "featured" : "background")),
+              children: isBg ? "\u80CC\u666F" : "\u4E3B\u8981"
+            }
+          );
+        })(),
         /* @__PURE__ */ jsxs("span", { className: "lj-se-assetcard-badge", children: [
           sceneCount,
           " \u573A \xB7 ",
@@ -4812,6 +4911,7 @@ __export(mutations_exports, {
   pickInheritedActorId: () => pickInheritedActorId,
   removeEntityState: () => removeEntityState,
   replaceSceneItem: () => replaceSceneItem,
+  setEntityImportance: () => setEntityImportance,
   splitScene: () => splitScene,
   updateEntityDescription: () => updateEntityDescription,
   updateEntityName: () => updateEntityName,