@musnows/scriverse 1.0.11 → 1.1.0

package/dist/public/app.js

@@ -21,6 +21,13 @@ import { aiRequestTargetsState, createAiRequestAbortError, createAiRequestManage
 import { calculateLineNumberTextOffset, calculateLineNumberTop } from "/line-number-layout.js?v=20260713-row-box-alignment";
 import { buildChapterLineMirror, findChapterLineWindow } from "/chapter-editor-virtualization.js?v=20260810-visible-lines-v1";
 import { CHAPTER_PARAGRAPH_INDENT, calculateChapterCaretScroll, chapterLineIndexAtOffset, insertIndentedParagraph } from "/chapter-editor-behavior.js?v=20260828-centered-scroll-v1";
+import {
+  calculateChapterEditorContentHeight,
+  chapterLineNumberLayerTransform,
+  needsChapterLineVirtualWindowRefresh,
+  readChapterEditorScrollMetrics,
+  transferNestedEditorScroll
+} from "/chapter-editor-scroll.js?v=20260916-line-scroll-bind-v1";
 import {
   FORESHADOW_REMINDER_SNOOZE_STORAGE_KEY,
   foreshadowReminderRequestTargetsState,
@@ -32,7 +39,18 @@ import {
 import { buildVditorLineNumberRows } from "/vditor-line-number-layout.js?v=20260729-vditor-line-numbers-v3";
 import { MIN_MODEL_CONTEXT_WINDOW, MODEL_PURPOSE_OPTIONS, MODEL_THINKING_EFFORT_OPTIONS, isKimiModelId, modelContextWindowGuidance, modelFormValues, modelOptionLabel, modelPayload, modelThinkingEffortLabel, supportsMultimodalModelProtocol } from "/model-config.js?v=20260822-ai-model-thinking-label-v3&feature=ai-provider-responses-v1&feature=semantic-search-v6";
 import { connectivityConfigurationSavedToast, connectivityTestErrorToast, connectivityTestResultToast } from "/ai-connectivity-test.js?v=20260822-private-ai-endpoint-hint-v1";
-import { shouldSendAiPrompt } from "/ai-prompt-keyboard.js?v=20260713-enter-to-send";
+import { shouldActivateAiSendControl, shouldSendAiPrompt } from "/ai-prompt-keyboard.js?v=20260919-ai-send-mode-v2";
+import { aiSendModeAction, normalizeAiSendMode, readStoredAiSendMode, writeStoredAiSendMode } from "/ai-send-mode.js?v=20260919-ai-send-mode-v2";
+import {
+  aiPromptQueueDragPayload,
+  aiPromptQueuePreview,
+  canSendQueuedPromptAsSteer,
+  createAiPromptQueue,
+  parseAiPromptQueueDragPayload,
+  queuedPromptEditContent,
+  queuedPromptEditPatch,
+  queuedPromptSteerContent
+} from "/ai-prompt-queue.js?v=20260919-ai-prompt-queue-v2";
 import { estimateAiMessageTokens, formatAiMessageMeta } from "/ai-message-meta.js?v=20260814-ai-model-lock-v1";
 import { createStreamTypewriter, createStreamTypewriterSpeedController } from "/stream-typewriter.js?v=20260912-stream-render-v2";
 import { assertAiStreamCompleted, readAiEventStream } from "/ai-stream-protocol.js?v=20260812-ai-stream-complete-v1";
@@ -62,7 +80,7 @@ import { AI_CHAT_IMAGE_ATTACHMENT_MAX_COUNT, aiChatImageAttachmentIds, isAiChatI
 import { findTextMatches, replaceTextMatches } from "/chapter-search.js?v=20260818-chapter-search-replace-v1";
 import { MAX_CHAPTER_LINE_IDS, normalizeChapterLineIdDraft, reconcileChapterLineIdDraft, remapChapterLineCounts } from "/chapter-line-id-tracker.js?v=20260829-live-annotation-anchors-v1";
 import { THEME_STORAGE_KEY, nextTheme, normalizeTheme, themeToggleLabel } from "/theme.js?v=20260713-dark-mode";
-import { buildCharacterDetails, buildCharacterState, characterStateEntries, normalizeCharacterDetails, normalizeCharacterSections } from "/character-profile.js?v=20260713-character-editor";
+import { buildCharacterDetails, buildCharacterState, characterStateEntries, normalizeCharacterAttributes, normalizeCharacterDetails, normalizeCharacterSections } from "/character-profile.js?v=20260919-character-attributes-prune-v1";
 import { characterVersionSourceLabel, describeCharacterVersionChanges } from "/character-version.js?v=20260816-character-gender-v1";
 import { chapterDiffSummary, diffChapterLines } from "/chapter-version-diff.js?v=20260812-chapter-version-diff-v1";
 import { VERSIONED_ENTITY_LABELS, entityVersionSnapshotSummary, entityVersionSourceLabel } from "/entity-version.js?v=20260809-global-replace-v1";
@@ -202,6 +220,7 @@ function isSelectableModel(model) {
 const state = {
   user: null,
   csrfToken: null,
+  registrationMode: "disabled",
   works: [],
   work: null,
   chapter: null,
@@ -243,6 +262,11 @@ const state = {
 let platformAiProtocolOptions = [];
 
 const aiRequestManager = createAiRequestManager();
+const aiPromptQueue = createAiPromptQueue();
+let pendingQueuedComposer = null;
+let aiPromptQueueDidDrag = false;
+let aiPromptQueueEditorState = null;
+let aiPromptQueueEditorBlurTimer = 0;
 const aiChatTabManager = createAiChatTabManager(() => createAiIdempotencyKey());
 const moduleRequestCache = createModuleRequestCache();
 const cachedWorkModules = new Set([
@@ -501,6 +525,7 @@ function applyWorkAccessMode() {
   $("#module-nav [data-module=\"comments\"]").classList.toggle("permission-hidden", Boolean(state.work) && !canReadModule("comments"));
   $("#module-nav [data-work-settings]").classList.toggle("permission-hidden", Boolean(state.work) && !canManageWork());
   $("#reader-open-button").classList.toggle("permission-hidden", proseHidden);
+  $("#writing-progress-button").classList.toggle("permission-hidden", Boolean(state.work) && !canReadModule("editor"));
   $("#ai-assistant-entry").classList.toggle("permission-hidden", !state.work || aiHidden);
   $("#new-volume-button").classList.toggle("permission-hidden", Boolean(state.work) && proseReadOnly);
   $("#chapter-batch-button").classList.toggle("permission-hidden", Boolean(state.work) && proseReadOnly);
@@ -524,6 +549,7 @@ function applyWorkAccessMode() {
     state.dirty = false;
   }
   applyChapterEditorMode();
+  syncAiSendModeControl();
 }
 
 const $ = (selector) => document.querySelector(selector);
@@ -665,28 +691,77 @@ function aiInteractionBusy() {
 }
 
 function aiSendButtonIconMarkup(stateName) {
+  if (stateName === "queue") {
+    return '<svg class="ai-send-button-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M5 7h11M5 12h8M5 17h11"></path><path d="M16 10v7M12.5 13.5H19.5"></path></svg>';
+  }
   return stateName === "stop"
     ? '<svg class="ai-send-button-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><rect x="6" y="6" width="12" height="12" rx="1.5"></rect></svg>'
     : '<svg class="ai-send-button-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M21 3 9.5 14.5M21 3l-7 18-4.5-6.5L3 10l18-7Z"></path></svg>';
 }
 
+function applyAiSendModeFromStorage() {
+  const select = $("#ai-send-mode");
+  if (!select) return;
+  select.value = readStoredAiSendMode(localStorage);
+  syncAiSendModeControl();
+}
+
+function aiComposerSendMode() {
+  return normalizeAiSendMode($("#ai-send-mode")?.value);
+}
+
+function syncAiSendModeControl() {
+  const select = $("#ai-send-mode");
+  if (!select) return;
+  const mode = normalizeAiSendMode(select.value);
+  if (select.value !== mode) select.value = mode;
+  const aiReadOnly = Boolean(state.work) && !canWritePermissionModule(state.work, "ai-chat");
+  select.disabled = aiReadOnly;
+  select.title = mode === "steer"
+    ? "引导发送：生成中再发送会立即作用于当前执行流，不会打断本轮。空输入时发送键用于终止"
+    : "排队发送：生成中再发送会加入队列，当前回复结束后按顺序发送，不会打断正在执行的回复。空输入时发送键用于终止";
+}
+
+function aiComposerHasSendablePrompt() {
+  return Boolean(queuedPromptSteerContent(captureAiPromptComposer()));
+}
+
 function syncAiRequestControls() {
   const activeTabId = activeAiChatTab()?.id;
   const continuingQuestion = activeTabId ? aiQuestionContinuationTabIds.has(activeTabId) : false;
   const sending = aiRequestManager.hasActive(activeTabId) && !continuingQuestion;
   const switching = aiConversationNavigationPending !== null;
   const button = $("#ai-send");
-  const stateName = sending ? "stop" : (switching || continuingQuestion) ? "switching" : "send";
-  const label = sending ? "终止当前回复" : continuingQuestion ? "AI 正在根据回答继续处理" : switching ? "正在切换对话" : "发送消息";
+  const sendAction = aiSendModeAction(aiComposerSendMode(), sending, aiComposerHasSendablePrompt());
+  const stateName = sendAction === "queue" || sendAction === "steer" || sendAction === "stop"
+    ? sendAction
+    : (switching || continuingQuestion) ? "switching" : "send";
+  const label = sendAction === "stop"
+    ? "终止当前回复"
+    : sendAction === "queue"
+      ? "排队发送"
+      : sendAction === "steer" ? "引导发送"
+        : continuingQuestion ? "AI 正在根据回答继续处理"
+          : switching ? "正在切换对话" : "发送消息";
   button.disabled = switching || continuingQuestion;
   button.dataset.state = stateName;
-  button.classList.toggle("is-stop", sending);
+  button.classList.toggle("is-stop", sendAction === "stop");
+  button.classList.toggle("is-queue", sendAction === "queue");
   button.setAttribute("aria-label", label);
-  button.title = label;
-  button.innerHTML = aiSendButtonIconMarkup(stateName);
+  button.title = sendAction === "stop"
+    ? "终止当前回复，排队 Prompt 仍会保留"
+    : sendAction === "queue"
+      ? "排队发送，当前回复结束后按顺序发送，不会打断正在执行的回复"
+      : sendAction === "steer"
+        ? "引导发送，立即作用于当前执行流，不会打断本轮"
+        : label;
+  button.innerHTML = aiSendButtonIconMarkup(stateName === "steer" ? "send" : stateName);
+  $(".prompt-composer")?.classList.toggle("is-streaming", sending);
+  syncAiSendModeControl();
   syncAiTaskOptions();
   renderAiRoleplayCharacterSelect();
   syncAiImageAttachmentControl();
+  renderAiPromptQueue();
 }
 
 function cancelActiveAiRequest(reason) {
@@ -695,18 +770,388 @@ function cancelActiveAiRequest(reason) {
   return cancelled;
 }
 
-function activateAiSendControl() {
+function submitAiComposerPrompt() {
   const tab = activeAiChatTab();
   if (aiRequestManager.hasActive(tab?.id)) {
-    if (cancelActiveAiRequest("用户已终止当前回复")) {
-      toast("已终止当前回复，可以重新发送");
-      $("#ai-prompt").focus();
+    if (aiComposerSendMode() === "steer") {
+      void sendActiveComposerAsSteer();
+      return;
     }
+    queueActiveComposerPrompt();
     return;
   }
   void sendAi();
 }
 
+function activateAiSendControl() {
+  const tab = activeAiChatTab();
+  if (aiRequestManager.hasActive(tab?.id) && !aiComposerHasSendablePrompt()) {
+    activateAiStopControl();
+    return;
+  }
+  submitAiComposerPrompt();
+}
+
+function activateAiStopControl() {
+  if (cancelActiveAiRequest("用户已终止当前回复")) {
+    toast("已终止当前回复，排队 Prompt 仍会保留");
+    $("#ai-prompt").focus();
+  }
+}
+
+function activeAiConversationId(tab = activeAiChatTab()) {
+  return String(tab?.conversationId ?? state.aiConversationId ?? "").trim();
+}
+
+function queueActiveComposerPrompt() {
+  const tab = activeAiChatTab();
+  if (!tab) return toast("Agent 对话页签尚未就绪", "error");
+  const snapshot = captureAiPromptComposer();
+  try {
+    aiPromptQueue.enqueue(tab.id, snapshot);
+  } catch (error) {
+    return toast(error.message, "error");
+  }
+  clearAiPromptComposer({ collapseScenePanel: Boolean(snapshot.sceneDirection) });
+  persistActiveAiChatTab();
+  syncAiRequestControls();
+  toast("已加入排队，当前回复结束后发送");
+  $("#ai-prompt").focus();
+}
+
+async function postAiConversationSteer(conversationId, content) {
+  const id = String(conversationId ?? "").trim();
+  if (!id) throw new Error("当前对话尚未开始，无法发送引导");
+  return api(`/api/ai-conversations/${encodeURIComponent(id)}/steer`, {
+    method: "POST",
+    body: { content }
+  });
+}
+
+async function sendActiveComposerAsSteer() {
+  const tab = activeAiChatTab();
+  if (!tab) return toast("Agent 对话页签尚未就绪", "error");
+  if (!aiRequestManager.hasActive(tab.id)) return toast("当前没有正在执行的回复，无法发送引导", "error");
+  const snapshot = captureAiPromptComposer();
+  const content = queuedPromptSteerContent(snapshot);
+  if (!content) {
+    return toast($("#ai-task").value === "roleplay" ? "请输入台词或场景旁白" : "请输入引导内容", "error");
+  }
+  try {
+    await postAiConversationSteer(activeAiConversationId(tab), content);
+  } catch (error) {
+    return toast(error.message, "error");
+  }
+  clearAiPromptComposer({ collapseScenePanel: Boolean(snapshot.sceneDirection) });
+  syncAiRequestControls();
+  toast("已发送执行流引导");
+  $("#ai-prompt").focus();
+}
+
+async function sendQueuedPromptAsSteer(itemId) {
+  const tab = activeAiChatTab();
+  if (!tab) return;
+  const item = aiPromptQueue.list(tab.id).find((entry) => entry.id === itemId);
+  if (!canSendQueuedPromptAsSteer(item, aiRequestManager.hasActive(tab.id))) {
+    return toast("当前没有正在执行的回复，无法发送引导", "error");
+  }
+  try {
+    await postAiConversationSteer(activeAiConversationId(tab), queuedPromptSteerContent(item));
+  } catch (error) {
+    return toast(error.message, "error");
+  }
+  aiPromptQueue.remove(tab.id, itemId);
+  renderAiPromptQueue();
+  toast("已将排队 Prompt 立即引导");
+}
+
+function sendQueuedPromptNow(itemId) {
+  const tab = activeAiChatTab();
+  if (!tab || aiRequestManager.hasActive(tab.id)) return;
+  const item = aiPromptQueue.list(tab.id).find((entry) => entry.id === itemId);
+  if (!item) return;
+  pendingQueuedComposer = item;
+  void sendAiWithOptions();
+}
+
+function flushNextQueuedPrompt(tab) {
+  if (!tab || !isActiveAiChatTab(tab) || aiRequestManager.hasActive(tab.id) || aiQuestionContinuationTabIds.has(tab.id)) {
+    renderAiPromptQueue();
+    return;
+  }
+  const next = aiPromptQueue.list(tab.id)[0];
+  renderAiPromptQueue();
+  if (!next) return;
+  pendingQueuedComposer = next;
+  void sendAiWithOptions();
+}
+
+function clearAiPromptQueueEditorState(itemId = null) {
+  if (!itemId || aiPromptQueueEditorState?.itemId === itemId) aiPromptQueueEditorState = null;
+  if (aiPromptQueueEditorBlurTimer) {
+    window.clearTimeout(aiPromptQueueEditorBlurTimer);
+    aiPromptQueueEditorBlurTimer = 0;
+  }
+}
+
+function captureAiPromptQueueEditorState() {
+  if (!aiPromptQueueEditorState) return null;
+  const editor = document.querySelector("#ai-prompt-queue-list .ai-prompt-queue-editor");
+  if (!(editor instanceof HTMLTextAreaElement)) return aiPromptQueueEditorState;
+  const itemId = editor.closest("[data-queue-id]")?.dataset.queueId;
+  if (!itemId || itemId !== aiPromptQueueEditorState.itemId) return aiPromptQueueEditorState;
+  return {
+    itemId,
+    value: editor.value,
+    selectionStart: editor.selectionStart,
+    selectionEnd: editor.selectionEnd
+  };
+}
+
+function commitAiPromptQueueEdit(itemId, nextValue = null, { render = true } = {}) {
+  const tab = activeAiChatTab();
+  if (!tab || !itemId) return false;
+  const item = aiPromptQueue.list(tab.id).find((entry) => entry.id === itemId);
+  if (!item) {
+    clearAiPromptQueueEditorState(itemId);
+    return false;
+  }
+  const value = nextValue == null ? queuedPromptEditContent(item) : nextValue;
+  if (value === queuedPromptEditContent(item)) {
+    clearAiPromptQueueEditorState(itemId);
+    if (render) renderAiPromptQueue();
+    return true;
+  }
+  try {
+    aiPromptQueue.update(tab.id, itemId, queuedPromptEditPatch(item, value));
+  } catch (error) {
+    toast(error.message, "error");
+    return false;
+  }
+  clearAiPromptQueueEditorState(itemId);
+  if (render) renderAiPromptQueue();
+  return true;
+}
+
+function beginAiPromptQueueEdit(item) {
+  const tab = activeAiChatTab();
+  if (!tab || !item || (state.work && !canWritePermissionModule(state.work, "ai-chat"))) return;
+  if (aiPromptQueueEditorState && aiPromptQueueEditorState.itemId !== item.id) {
+    const previous = document.querySelector("#ai-prompt-queue-list .ai-prompt-queue-editor");
+    const previousValue = previous instanceof HTMLTextAreaElement ? previous.value : aiPromptQueueEditorState.value;
+    if (!commitAiPromptQueueEdit(aiPromptQueueEditorState.itemId, previousValue)) return;
+  }
+  aiPromptQueueEditorState = {
+    itemId: item.id,
+    value: queuedPromptEditContent(item),
+    selectionStart: 0,
+    selectionEnd: queuedPromptEditContent(item).length
+  };
+  renderAiPromptQueue();
+  const editor = document.querySelector(`#ai-prompt-queue-list [data-queue-id="${CSS.escape(item.id)}"] .ai-prompt-queue-editor`);
+  if (editor instanceof HTMLTextAreaElement) {
+    editor.focus();
+    editor.setSelectionRange(0, editor.value.length);
+  }
+}
+
+function moveAiPromptQueueItem(sourceId, targetId, placeAfter) {
+  const tab = activeAiChatTab();
+  if (!tab || !sourceId || !targetId) return;
+  aiPromptQueue.move(tab.id, sourceId, targetId, placeAfter);
+  renderAiPromptQueue();
+}
+
+function moveAiPromptQueueItemByOffset(itemId, offset) {
+  const tab = activeAiChatTab();
+  if (!tab || !itemId) return;
+  aiPromptQueue.moveByOffset(tab.id, itemId, offset);
+  renderAiPromptQueue();
+}
+
+function bindAiPromptQueueItemDrag(row, item, aiReadOnly, editing) {
+  if (aiReadOnly || editing) {
+    row.draggable = false;
+    row.removeAttribute("aria-grabbed");
+    return;
+  }
+  row.draggable = true;
+  row.setAttribute("aria-grabbed", "false");
+  row.addEventListener("dragstart", (event) => {
+    if (event.target.closest("button, textarea, .ai-prompt-queue-editor")) {
+      event.preventDefault();
+      return;
+    }
+    aiPromptQueueDidDrag = true;
+    event.dataTransfer?.setData("text/plain", aiPromptQueueDragPayload(item.id));
+    if (event.dataTransfer) event.dataTransfer.effectAllowed = "move";
+    row.classList.add("is-dragging");
+    row.setAttribute("aria-grabbed", "true");
+  });
+  row.addEventListener("dragend", () => {
+    row.classList.remove("is-dragging");
+    row.setAttribute("aria-grabbed", "false");
+    listAiPromptQueueDropTargets().forEach((node) => node.classList.remove("is-drag-over", "drop-after"));
+    window.setTimeout(() => { aiPromptQueueDidDrag = false; }, 0);
+  });
+  row.addEventListener("dragover", (event) => {
+    if (!event.dataTransfer?.types.includes("text/plain")) return;
+    event.preventDefault();
+    if (event.dataTransfer) event.dataTransfer.dropEffect = "move";
+    const after = event.clientY >= row.getBoundingClientRect().top + row.offsetHeight / 2;
+    listAiPromptQueueDropTargets().forEach((node) => {
+      if (node !== row) node.classList.remove("is-drag-over", "drop-after");
+    });
+    row.classList.toggle("drop-after", after);
+    row.classList.add("is-drag-over");
+  });
+  row.addEventListener("dragleave", (event) => {
+    if (row.contains(event.relatedTarget)) return;
+    row.classList.remove("is-drag-over", "drop-after");
+  });
+  row.addEventListener("drop", (event) => {
+    event.preventDefault();
+    event.stopPropagation();
+    const sourceId = parseAiPromptQueueDragPayload(event.dataTransfer?.getData("text/plain"));
+    const after = row.classList.contains("drop-after");
+    row.classList.remove("is-drag-over", "drop-after");
+        if (!sourceId || sourceId === item.id) return;
+    moveAiPromptQueueItem(sourceId, item.id, after);
+  });
+}
+
+function listAiPromptQueueDropTargets() {
+  return [...document.querySelectorAll("#ai-prompt-queue-list .ai-prompt-queue-item")];
+}
+
+function renderAiPromptQueue() {
+  const tab = activeAiChatTab();
+  const panel = $("#ai-prompt-queue");
+  const list = $("#ai-prompt-queue-list");
+  if (!panel || !list) return;
+  const items = tab ? aiPromptQueue.list(tab.id) : [];
+  const streaming = Boolean(tab && aiRequestManager.hasActive(tab.id));
+  const aiReadOnly = Boolean(state.work) && !canWritePermissionModule(state.work, "ai-chat");
+  const editorState = captureAiPromptQueueEditorState();
+  if (editorState && !items.some((item) => item.id === editorState.itemId)) clearAiPromptQueueEditorState(editorState.itemId);
+  const activeEditor = items.some((item) => item.id === (editorState?.itemId ?? aiPromptQueueEditorState?.itemId))
+    ? editorState ?? aiPromptQueueEditorState
+    : null;
+  if (activeEditor) aiPromptQueueEditorState = activeEditor;
+  else if (!items.length) clearAiPromptQueueEditorState();
+  panel.classList.toggle("hidden", items.length === 0);
+  list.replaceChildren(...items.map((item) => {
+    const editing = Boolean(!aiReadOnly && activeEditor?.itemId === item.id);
+    const row = document.createElement("li");
+    row.className = `ai-prompt-queue-item${editing ? " is-editing" : ""}`;
+    row.dataset.queueId = item.id;
+    row.title = aiReadOnly ? "" : "拖拽调整顺序；点击文字可编辑";
+    const previewText = aiPromptQueuePreview(queuedPromptSteerContent(item) || item.text);
+    const fullText = queuedPromptSteerContent(item) || item.text;
+    let preview;
+    if (editing) {
+      preview = document.createElement("textarea");
+      preview.className = "ai-prompt-queue-editor";
+      preview.value = activeEditor.value ?? queuedPromptEditContent(item);
+      preview.rows = Math.min(6, Math.max(1, preview.value.split("\n").length));
+      preview.setAttribute("aria-label", `编辑排队 Prompt：${previewText}`);
+      preview.addEventListener("click", (event) => event.stopPropagation());
+      preview.addEventListener("pointerdown", (event) => event.stopPropagation());
+      preview.addEventListener("keydown", (event) => {
+        event.stopPropagation();
+        if (event.key === "Escape") {
+          event.preventDefault();
+          clearAiPromptQueueEditorState(item.id);
+          renderAiPromptQueue();
+          return;
+        }
+        if (shouldSendAiPrompt(event)) {
+          event.preventDefault();
+          commitAiPromptQueueEdit(item.id, preview.value);
+        }
+      });
+      preview.addEventListener("blur", () => {
+        aiPromptQueueEditorBlurTimer = window.setTimeout(() => {
+          aiPromptQueueEditorBlurTimer = 0;
+          if (aiPromptQueueEditorState?.itemId !== item.id) return;
+          if (document.activeElement?.classList.contains("ai-prompt-queue-editor")) return;
+          commitAiPromptQueueEdit(item.id, preview.value);
+        }, 0);
+      });
+    } else {
+      preview = document.createElement("p");
+      preview.className = "ai-prompt-queue-preview";
+      preview.textContent = previewText;
+      preview.title = aiReadOnly ? fullText : `${fullText}\n点击编辑`;
+      preview.tabIndex = aiReadOnly ? -1 : 0;
+      preview.setAttribute("role", "button");
+      preview.setAttribute("aria-label", `编辑排队 Prompt：${previewText}`);
+      const startEdit = (event) => {
+        if (aiReadOnly || aiPromptQueueDidDrag) return;
+        event.preventDefault();
+        beginAiPromptQueueEdit(item);
+      };
+      preview.addEventListener("click", startEdit);
+      preview.addEventListener("keydown", (event) => {
+        if (event.altKey && ["ArrowUp", "ArrowDown"].includes(event.key)) {
+          event.preventDefault();
+          moveAiPromptQueueItemByOffset(item.id, event.key === "ArrowDown" ? 1 : -1);
+          return;
+        }
+        if (event.key === "Enter" || event.key === " ") {
+          startEdit(event);
+        }
+      });
+    }
+    const actions = document.createElement("div");
+    actions.className = "ai-prompt-queue-actions";
+    const primary = document.createElement("button");
+    primary.type = "button";
+    const flushEditorBeforeAction = () => {
+      if (!(preview instanceof HTMLTextAreaElement)) return;
+      commitAiPromptQueueEdit(item.id, preview.value, { render: false });
+    };
+    if (streaming) {
+      primary.className = "ai-prompt-queue-steer";
+      primary.textContent = "立即引导";
+      primary.disabled = aiReadOnly || !canSendQueuedPromptAsSteer(item, true);
+      primary.setAttribute("aria-label", `立即引导排队 Prompt：${previewText}`);
+      primary.addEventListener("pointerdown", flushEditorBeforeAction);
+      primary.addEventListener("click", () => { void sendQueuedPromptAsSteer(item.id); });
+    } else {
+      primary.className = "ai-prompt-queue-send";
+      primary.textContent = "现在发送";
+      primary.disabled = aiReadOnly;
+      primary.setAttribute("aria-label", `现在发送排队 Prompt：${previewText}`);
+      primary.addEventListener("pointerdown", flushEditorBeforeAction);
+      primary.addEventListener("click", () => sendQueuedPromptNow(item.id));
+    }
+    const remove = document.createElement("button");
+    remove.type = "button";
+    remove.className = "ai-prompt-queue-remove";
+    remove.setAttribute("aria-label", `移除排队 Prompt：${previewText}`);
+    remove.textContent = "×";
+    remove.addEventListener("click", () => {
+      aiPromptQueue.remove(tab.id, item.id);
+      clearAiPromptQueueEditorState(item.id);
+      renderAiPromptQueue();
+    });
+    actions.append(primary, remove);
+    row.append(preview, actions);
+    bindAiPromptQueueItemDrag(row, item, aiReadOnly, editing);
+    return row;
+  }));
+  if (activeEditor) {
+    const editor = list.querySelector(`[data-queue-id="${CSS.escape(activeEditor.itemId)}"] .ai-prompt-queue-editor`);
+    if (editor instanceof HTMLTextAreaElement) {
+      const start = Number.isInteger(activeEditor.selectionStart) ? activeEditor.selectionStart : editor.value.length;
+      const end = Number.isInteger(activeEditor.selectionEnd) ? activeEditor.selectionEnd : editor.value.length;
+      editor.focus();
+      editor.setSelectionRange(start, end);
+    }
+  }
+}
+
 function beginAiConversationNavigation(reason, action = "切换会话") {
   aiConversationNavigationGeneration += 1;
   aiConversationNavigationPending = aiConversationNavigationGeneration;
@@ -827,6 +1272,7 @@ let chapterSelectionRequestGeneration = 0;
 let aiConversationNavigationGeneration = 0;
 let aiConversationNavigationPending = null;
 let aiChatTabLimit = 5;
+let chapterAnnotationNoteMaxLength = 6000;
 let aiConversationWorkspaceOpen = false;
 const loadedVolumeChapterIds = new Set();
 const volumeChapterLoadingIds = new Set();
@@ -1739,24 +2185,27 @@ function setModuleNavExpanded(expanded) {
   $("#module-nav").querySelectorAll(".module-nav-secondary").forEach((button) => button.classList.toggle("hidden", !expanded));
 }
 
+function getChapterEditorScroller() {
+  // 行号与正文只允许这个容器滚动。
+  return $("#chapter-editor-scroll");
+}
+
 function syncChapterLineNumberScroll() {
+  const scroller = getChapterEditorScroller();
   const input = $("#chapter-content");
   const inner = $("#chapter-line-numbers-inner");
   const whitespace = $("#chapter-whitespace-inner");
-  if (!input || !inner) return;
-  inner.style.transform = `translateY(${-input.scrollTop}px)`;
-  inner.dataset.scrollTop = String(input.scrollTop);
+  if (!scroller || !inner) return;
+  if (input) transferNestedEditorScroll(input, scroller);
+  const metrics = readChapterEditorScrollMetrics(scroller);
+  const layerTransform = chapterLineNumberLayerTransform();
+  inner.style.transform = layerTransform;
+  inner.dataset.scrollTop = String(metrics.scrollTop);
   if (whitespace) {
-    whitespace.style.transform = `translate(${-input.scrollLeft}px, ${-input.scrollTop}px)`;
-    whitespace.dataset.scrollTop = String(input.scrollTop);
+    whitespace.style.transform = layerTransform;
+    whitespace.dataset.scrollTop = String(metrics.scrollTop);
   }
-  if (!chapterLineVirtualWindow) return;
-  const buffer = input.clientHeight * 0.35;
-  const viewportBottom = input.scrollTop + input.clientHeight;
-  const needsPreviousLines = chapterLineVirtualWindow.start > 0 && input.scrollTop < chapterLineVirtualWindow.top + buffer;
-  const needsNextLines = chapterLineVirtualWindow.end < chapterLineVirtualWindow.lineCount
-    && viewportBottom > chapterLineVirtualWindow.bottom - buffer;
-  if (needsPreviousLines || needsNextLines) scheduleChapterLineNumbers();
+  if (needsChapterLineVirtualWindowRefresh(chapterLineVirtualWindow, metrics)) scheduleChapterLineNumbers();
 }
 
 function syncChapterWhitespaceControls() {
@@ -1908,7 +2357,8 @@ function renderChapterLineNumbers({ targetLineIndex = null } = {}) {
   const input = $("#chapter-content");
   const inner = $("#chapter-line-numbers-inner");
   const measure = $("#chapter-line-measure");
-  if (!input || !inner || !measure || input.clientWidth === 0) return;
+  const scroller = getChapterEditorScroller();
+  if (!input || !inner || !measure || !scroller || input.clientWidth === 0) return;
   const style = getComputedStyle(input);
   const contentWidth = Math.max(1, input.clientWidth - parseFloat(style.paddingLeft) - parseFloat(style.paddingRight));
   const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.55;
@@ -1919,20 +2369,31 @@ function renderChapterLineNumbers({ targetLineIndex = null } = {}) {
   const numberTextOffset = calculateLineNumberTextOffset(lineHeight, numberLineHeight);
   const layout = prepareChapterLineLayout(input, measure, style, contentWidth);
   const paddingBottom = parseFloat(style.paddingBottom) || 0;
-  const scrollContentHeight = input.scrollHeight - paddingTop - paddingBottom;
-  const targetHeight = input.scrollHeight > input.clientHeight + 1 ? scrollContentHeight : null;
-  const { getLineBounds, measureHeight } = createChapterLineBoundsGetter(layout, measure, lineHeight, targetHeight);
+  const { getLineBounds, measureHeight } = createChapterLineBoundsGetter(layout, measure, lineHeight);
+  const nextHeight = calculateChapterEditorContentHeight({
+    measureHeight,
+    paddingTop,
+    paddingBottom,
+    viewportHeight: scroller.clientHeight
+  });
+  const nextHeightPx = `${nextHeight}px`;
+  if (input.style.height !== nextHeightPx) {
+    const savedScrollTop = scroller.scrollTop;
+    input.style.height = nextHeightPx;
+    scroller.scrollTop = savedScrollTop;
+  }
+  const metrics = readChapterEditorScrollMetrics(scroller);
   if (Number.isInteger(targetLineIndex)) {
     const safeTarget = Math.max(0, Math.min(targetLineIndex, layout.lines.length - 1));
-    input.scrollTop = Math.max(0, getLineBounds(safeTarget).top + paddingTop - input.clientHeight / 3);
+    scroller.scrollTop = Math.max(0, getLineBounds(safeTarget).top + paddingTop - metrics.clientHeight / 3);
   }
-  const viewportTop = Math.max(0, input.scrollTop - paddingTop);
-  const overscan = Math.max(input.clientHeight, lineHeight * 8);
+  const viewportTop = Math.max(0, scroller.scrollTop - paddingTop);
+  const overscan = Math.max(metrics.clientHeight, lineHeight * 8);
   const lineWindow = findChapterLineWindow(
     layout.lines.length,
     getLineBounds,
     viewportTop - overscan,
-    viewportTop + input.clientHeight + overscan
+    viewportTop + metrics.clientHeight + overscan
   );
   const numbers = document.createDocumentFragment();
   for (let index = lineWindow.start; index < lineWindow.end; index += 1) {
@@ -2018,26 +2479,25 @@ function scheduleChapterCaretScroll() {
     chapterCaretScrollFrame = null;
     const input = $("#chapter-content");
     const measure = $("#chapter-line-measure");
-    if (!state.work?.editorTypewriterModeEnabled || document.activeElement !== input || input.readOnly || input.clientWidth === 0 || input.clientHeight === 0) return;
+    const scroller = getChapterEditorScroller();
+    if (!state.work?.editorTypewriterModeEnabled || document.activeElement !== input || !scroller || input.readOnly || input.clientWidth === 0 || scroller.clientHeight === 0) return;
     const style = getComputedStyle(input);
     const paddingTop = parseFloat(style.paddingTop) || 0;
-    const paddingBottom = parseFloat(style.paddingBottom) || 0;
     const contentWidth = Math.max(1, input.clientWidth - parseFloat(style.paddingLeft) - parseFloat(style.paddingRight));
     const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.55;
     const layout = prepareChapterLineLayout(input, measure, style, contentWidth);
-    const scrollContentHeight = input.scrollHeight - paddingTop - paddingBottom;
-    const targetHeight = input.scrollHeight > input.clientHeight + 1 ? scrollContentHeight : null;
-    const { getLineBounds } = createChapterLineBoundsGetter(layout, measure, lineHeight, targetHeight);
+    const { getLineBounds } = createChapterLineBoundsGetter(layout, measure, lineHeight);
     const lineIndex = Math.min(layout.lines.length - 1, chapterLineIndexAtOffset(input.value, input.selectionEnd));
     const caretBottom = getLineBounds(lineIndex).bottom + paddingTop;
+    const metrics = readChapterEditorScrollMetrics(scroller);
     const nextScrollTop = calculateChapterCaretScroll({
       caretBottom,
-      scrollTop: input.scrollTop,
-      clientHeight: input.clientHeight,
-      scrollHeight: input.scrollHeight
+      scrollTop: metrics.scrollTop,
+      clientHeight: metrics.clientHeight,
+      scrollHeight: metrics.scrollHeight
     });
-    if (nextScrollTop === input.scrollTop) return;
-    input.scrollTop = nextScrollTop;
+    if (nextScrollTop === metrics.scrollTop) return;
+    scroller.scrollTop = nextScrollTop;
     syncChapterLineNumberScroll();
     scheduleChapterLineNumbers();
   });
@@ -2769,6 +3229,12 @@ function applyAiChatTabLimit(value) {
   renderAiChatTabs();
 }
 
+function applyChapterAnnotationNoteMaxLength(value) {
+  const parsed = Number(value);
+  if (!Number.isSafeInteger(parsed)) return;
+  chapterAnnotationNoteMaxLength = Math.min(20000, Math.max(2000, parsed));
+}
+
 function renderAiChatTabs() {
   const host = $("#ai-chat-tabs");
   if (!host) return;
@@ -5624,7 +6090,7 @@ async function createSelectedLineAnnotation(kind) {
     title: kind === "todo" ? "添加正文待办" : "添加正文评论",
     inputLabel: kind === "todo" ? "待办内容" : "评论内容",
     confirmLabel: "添加",
-    maxLength: 2000
+    maxLength: chapterAnnotationNoteMaxLength
   });
   if (!note) return;
   try {
@@ -5693,7 +6159,7 @@ function bindChapterAnnotationCards(host, annotations, { refresh, locate, overla
         inputLabel: annotation.kind === "todo" ? "待办内容" : "评论内容",
         value: annotation.note,
         confirmLabel: "保存",
-        maxLength: 2000
+        maxLength: chapterAnnotationNoteMaxLength
       });
       if (!note) return resumeOverlay();
       try {
@@ -6061,6 +6527,7 @@ async function api(path, options = {}) {
   if (path === "/api/health") {
     applyImageUploadLimits(payload.data?.uploadLimits);
     applyAiChatTabLimit(payload.data?.aiChatTabLimit);
+    applyChapterAnnotationNoteMaxLength(payload.data?.chapterAnnotationNoteMaxLength);
     updateSystemHealth({
       status: payload.data?.status === "ok" ? "ready" : "degraded",
       version: payload.data?.version
@@ -6524,7 +6991,7 @@ function invalidateAuthentication() {
   showAuth(false);
 }
 
-function showAuth(setupRequired, registrationOpen = false, setupTokenRequired = false) {
+function showAuth(setupRequired, registrationOpen = false, setupTokenRequired = false, registrationMode = "disabled") {
   if (state.user) return;
   document.documentElement.classList.remove("dev-auth-bypass");
   document.documentElement.classList.add("login-route");
@@ -6533,14 +7000,17 @@ function showAuth(setupRequired, registrationOpen = false, setupTokenRequired =
   document.body.classList.add("auth-pending");
   $("#auth-view").classList.remove("hidden");
   const canRegister = registrationOpen === true;
+  const inviteRequired = registrationMode === "invite" && setupRequired !== true;
   $("#auth-title").textContent = setupRequired
     ? canRegister ? "创建首个管理员账户" : "注册已禁用"
     : "登录后继续创作";
   $("#auth-description").textContent = setupRequired
     ? canRegister
       ? "这是首次启动。首个注册用户会成为系统管理员，并接管现有作品。"
-      : "请将 APP_ALLOW_REGISTRATION 设置为 true 后创建首个管理员账户。"
-    : "你的作品、协作权限和每一次修改都会绑定到账户。";
+      : "请将 APP_ALLOW_REGISTRATION 设置为 true 或 invite 后创建首个管理员账户。"
+    : inviteRequired
+      ? "当前部署需要邀请码才能注册。请向系统管理员获取一次性邀请码。"
+      : "你的作品、协作权限和每一次修改都会绑定到账户。";
   const registerTab = $("#auth-register-tab");
   registerTab.disabled = !canRegister;
   registerTab.setAttribute("aria-disabled", String(!canRegister));
@@ -6549,12 +7019,19 @@ function showAuth(setupRequired, registrationOpen = false, setupTokenRequired =
   const setupTokenInput = setupTokenField.querySelector('input[name="setupToken"]');
   setupTokenField.classList.toggle("hidden", !setupTokenRequired);
   setupTokenInput.required = setupTokenRequired;
+  const inviteField = $("#register-invite-code-field");
+  const inviteInput = inviteField.querySelector('input[name="inviteCode"]');
+  inviteField.classList.toggle("hidden", !inviteRequired);
+  inviteInput.required = inviteRequired;
   selectAuthMode(setupRequired && canRegister ? "register" : "login");
 }
 
 function applyAuthenticatedUser(session) {
   state.user = session.user;
   state.csrfToken = session.csrfToken;
+  state.registrationMode = session.registrationMode === "invite" || session.registrationMode === "open"
+    ? session.registrationMode
+    : "disabled";
   const isSystemAdmin = session.user.isSystemAdmin === true;
   const accountButton = $("#account-button");
   $("#account-name").textContent = session.user.displayName;
@@ -6637,7 +7114,7 @@ async function initializeAuthentication() {
   if (!session.authenticated) {
     // 未登录时一律转到登录页路由；登录页本身则保持原样
     if (route.view !== "login") window.history.replaceState(null, "", serializePageRoute({ view: "login" }));
-    showAuth(session.setupRequired, session.registrationOpen === true, session.setupTokenRequired === true);
+    showAuth(session.setupRequired, session.registrationOpen === true, session.setupTokenRequired === true, session.registrationMode);
     return false;
   }
   // 已登录却停在登录页路由时，回到书架首页
@@ -7736,9 +8213,61 @@ async function openUsersDialog() {
     return;
   }
   $("#users-list").innerHTML = '<p class="empty-state">正在读取用户……</p>';
+  $("#invite-codes-list").innerHTML = '<p class="empty-state">正在读取邀请码……</p>';
+  $("#invite-code-latest").classList.add("hidden");
   $("#users-dialog").showModal();
-  try { renderUsers((await apiPage("/api/users")).items); }
-  catch (error) { $("#users-dialog").close(); toast(error.message, "error"); }
+  try {
+    const [usersPage] = await Promise.all([apiPage("/api/users"), loadRegistrationInvites()]);
+    renderUsers(usersPage.items);
+  } catch (error) { $("#users-dialog").close(); toast(error.message, "error"); }
+}
+
+function registrationModeLabel(mode) {
+  if (mode === "invite") return "需要邀请码才能注册";
+  if (mode === "open") return "完全开放注册";
+  return "彻底禁止注册";
+}
+
+function renderRegistrationInvites(payload) {
+  const mode = payload?.registrationMode === "invite" || payload?.registrationMode === "open"
+    ? payload.registrationMode
+    : "disabled";
+  state.registrationMode = mode;
+  $("#invite-codes-mode").textContent = `当前注册策略：${registrationModeLabel(mode)}。邀请码由系统管理员生成，每个只能使用一次。`;
+  const invites = Array.isArray(payload?.items) ? payload.items : [];
+  $("#invite-codes-list").innerHTML = invites.length
+    ? invites.map((invite) => {
+      const used = Boolean(invite.usedAt);
+      const usedBy = invite.usedBy ? `${invite.usedBy.displayName} · @${invite.usedBy.username}` : "已失效";
+      return `<article class="access-row invite-code-row">
+        <div class="access-person-copy"><strong>${used ? "已使用" : "未使用"}</strong><small>${esc(formatDateTime(invite.createdAt))} 由 ${esc(invite.createdBy.displayName)} 生成${used ? ` · ${esc(usedBy)} 于 ${esc(formatDateTime(invite.usedAt))}` : ""}</small></div>
+        <span>${used ? "已核销" : "待使用"}</span>
+      </article>`;
+    }).join("")
+    : '<p class="empty-state">还没有邀请码。需要邀请码注册时，请先生成。</p>';
+}
+
+async function loadRegistrationInvites() {
+  const payload = await api("/api/registration-invites");
+  renderRegistrationInvites(payload);
+  return payload;
+}
+
+async function generateRegistrationInvite() {
+  const button = $("#invite-code-generate");
+  button.disabled = true;
+  try {
+    const created = await api("/api/registration-invites", { method: "POST", body: {} });
+    const latest = $("#invite-code-latest");
+    latest.innerHTML = `新邀请码（请立即复制，页面不会再次完整显示）：<strong>${esc(created.code)}</strong>`;
+    latest.classList.remove("hidden");
+    await loadRegistrationInvites();
+    toast("邀请码已生成");
+  } catch (error) {
+    toast(error.message, "error");
+  } finally {
+    button.disabled = false;
+  }
 }
 
 function renderAdminAiConversationFilterOptions(works, users) {
@@ -11267,11 +11796,12 @@ async function renderCharacters(page = characterListPage) {
     ? `<span class="character-lock-badge" aria-label="${item.lockedFields.length} 个锁定字段" title="锁定字段：${esc(item.lockedFields.join("、"))}"><svg viewBox="0 0 24 24" aria-hidden="true"><rect x="5" y="10" width="14" height="10" rx="2"></rect><path d="M8 10V7a4 4 0 0 1 8 0v3"></path></svg><span>${item.lockedFields.length}</span></span>`
     : "";
   const characterCards = () => `<div class="card-grid">${pageCharacters.map((item) => {
-    const details = normalizeCharacterDetails(item.attributes?.details);
+    const attributes = normalizeCharacterAttributes(item.attributes);
+    const details = attributes.details ?? [];
     return `
     <article class="record-card character-card preview-record-card has-card-edit has-pin-control" data-open-character="${esc(item.id)}" role="button" tabindex="0" aria-label="查看角色 ${esc(item.name)}">${characterPinButton(item)}${characterFavoriteButton(item)}${recordCardEditButton("edit-character", item.id, `角色“${item.name}”`)}
     <div class="character-card-heading">${characterAvatarHtml(item)}<h3>${esc(item.name)}</h3>${entityLifecycleBadge(item.isDead, "已死亡")}${characterLockBadge(item)}</div>
-    ${item.attributes?.identity ? `<p class="character-identity">${esc(item.attributes.identity)}</p>` : ""}
+    ${attributes.identity ? `<p class="character-identity">${esc(attributes.identity)}</p>` : ""}
     <div class="character-gender"><b>性别</b><span class="pill">${esc(characterGenderLabel(item.gender))}</span></div>
     ${item.aliases.length ? `<div class="character-aliases"><b>别名</b>${item.aliases.map((alias) => `<span class="pill">${esc(alias)}</span>`).join("")}</div>` : ""}
     ${item.code ? `<div class="character-code"><b>编号</b><span class="pill">${esc(item.code)}</span></div>` : ""}
@@ -11283,7 +11813,7 @@ async function renderCharacters(page = characterListPage) {
     </article>`;
   }).join("")}</div>`;
   const characterRows = () => `<div class="module-row-list">${pageCharacters.map((item) => {
-    const preview = moduleRowPreview(item.profile?.summary || item.attributes?.identity || Object.entries(item.currentState).map(([key, value]) => `${characterStateFieldLabel(key)}：${value}`).join(" ") || "尚未记录当前状态");
+    const preview = moduleRowPreview(item.profile?.summary || normalizeCharacterAttributes(item.attributes).identity || Object.entries(item.currentState).map(([key, value]) => `${characterStateFieldLabel(key)}：${value}`).join(" ") || "尚未记录当前状态");
     const meta = [
       item.code ? `编号 ${item.code}` : "",
       `性别 ${characterGenderLabel(item.gender)}`,
@@ -13142,7 +13672,7 @@ async function openRelationshipIdentityRepairDialog(task, failure) {
   const character = await api(`/api/characters/${encodeURIComponent(details.characterId)}`);
   const anchors = [
     character.code,
-    character.attributes?.identity,
+    normalizeCharacterAttributes(character.attributes).identity,
     character.race?.name || character.species,
     ...(Array.isArray(character.organizations) ? character.organizations.map((organization) => organization.name) : [])
   ].map((value) => String(value ?? "").trim()).filter(Boolean);
@@ -13161,7 +13691,7 @@ async function openRelationshipIdentityRepairDialog(task, failure) {
     <label>角色标准名<input type="text" value="${esc(character.name)}" readonly></label>
     ${field("aliases", "确认别名", "item-list", character.aliases ?? [])}
     ${field("code", "人物编号或代号", "text", character.code)}
-    ${field("identity", "身份与定位", "text", character.attributes?.identity)}
+    ${field("identity", "身份与定位", "text", normalizeCharacterAttributes(character.attributes).identity)}
     <button class="ghost-button relationship-identity-full-profile" type="button" data-open-identity-character-profile>打开完整人物档案</button>`,
     async (form) => {
       const aliases = form.getAll("aliases").map((value) => String(value).trim()).filter(Boolean);
@@ -13172,7 +13702,7 @@ async function openRelationshipIdentityRepairDialog(task, failure) {
         body: {
           aliases,
           code,
-          attributes: { ...(character.attributes ?? {}), identity },
+          attributes: normalizeCharacterAttributes({ ...(character.attributes ?? {}), identity }),
           expectedVersionNo: character.versionNo,
           changeNote: `修复人物关系来源匹配：${failure.message}`.slice(0, 500)
         }
@@ -16840,6 +17370,7 @@ function renderCharacterEditorFields(item) {
   const organizationOptions = state.organizations.map((organization) => [organization.id, organization.name]);
   const chapterOptions = [["", "未指定"], ...(state.work?.volumes ?? []).flatMap((volume) => volume.chapters.map((chapter) => [chapter.id, `${volume.title} / ${chapter.title}`]))];
   const stateEntries = characterStateEntries(item?.currentState ?? {});
+  const attributes = normalizeCharacterAttributes(item?.attributes);
   const raceField = !canReadModule("races")
     ? '<div class="character-editor-empty-field"><b>种族</b><span>当前账户没有种族模块读取权限，原有绑定不会被修改。</span></div>'
     : state.races.length
@@ -16861,12 +17392,12 @@ function renderCharacterEditorFields(item) {
         : '<div class="character-editor-empty-field"><b>首次登场章节</b><span>当前账户没有正文读取权限，原有绑定不会被修改。</span></div>')),
     characterEditorSection("profile", "人物档案", "记录人物定位、行为动力、公开人设和便于创作时快速理解的简介。",
       field("code", "编号", "text", item?.code) +
-      field("identity", "身份与定位", "text", item?.attributes?.identity) +
+      field("identity", "身份与定位", "text", attributes.identity) +
       field("motivation", "核心动机", "textarea", item?.profile?.motivation) +
       field("summary", "人物简介", "textarea", item?.profile?.summary) +
       '<div class="form-field"><span>人设摘要</span><small>关系扮演时作为公开人设注入对方可见的角色卡，不会包含私密档案或 Markdown 章节。</small><textarea name="personaSummary" maxlength="20000" aria-label="人设摘要">' + esc(item?.profile?.personaSummary ?? "") + "</textarea></div>"),
     characterEditorSection("settings", "扩展设定", "可用短属性和 Markdown 长章节承载形态、能力、生态、经历与研究记录。",
-      field("details", "扩展属性", "key-value-list", item?.attributes?.details, { multilineValue: true }) +
+      field("details", "扩展属性", "key-value-list", attributes.details, { multilineValue: true }) +
       '<div id="character-markdown-sections" class="character-markdown-sections"></div>'),
     characterEditorSection("state", "状态与约束", "维护任意当前状态，并明确禁止 AI 自行覆盖的字段。",
       field("isDead", "标记为已死亡", "checkbox", item?.isDead ?? false) +
@@ -16909,11 +17440,11 @@ function collectCharacterBody(form) {
     isDead: form.has("isDead"),
     code: String(form.get("code") ?? "").trim(),
     aliases: form.getAll("aliases").map((value) => String(value).trim()).filter(Boolean),
-    attributes: {
-      ...(item?.attributes ?? {}),
+    attributes: normalizeCharacterAttributes({
+      species: typeof item?.attributes?.species === "string" ? item.attributes.species : "",
       identity: String(form.get("identity") ?? "").trim(),
       details: buildCharacterDetails(form.getAll("detailLabel"), form.getAll("detailValue"))
-    },
+    }),
     profile: {
       ...profile,
       motivation: String(form.get("motivation") ?? "").trim(),
@@ -18420,6 +18951,8 @@ async function sendAiWithOptions({ ignoreContextWarning = false, retry = null }
   if (!tab) return toast("Agent 对话页签尚未就绪", "error");
   if (aiRequestManager.hasActive(tab.id)) return;
   if (aiQuestionContinuationTabIds.has(tab.id)) return toast("AI 正在根据你的回答继续处理，请稍候");
+  const queuedComposer = pendingQueuedComposer;
+  pendingQueuedComposer = null;
   const composerSnapshot = captureAiPromptComposer();
   const requestComposerSnapshot = retry
     ? {
@@ -18431,7 +18964,7 @@ async function sendAiWithOptions({ ignoreContextWarning = false, retry = null }
       sceneDirection: retry.sceneDirection ?? "",
       scenePin: captureAiScenePin()
     }
-    : composerSnapshot;
+    : queuedComposer ?? composerSnapshot;
   const instruction = String(requestComposerSnapshot.markup ?? requestComposerSnapshot.text).trim();
   const instructionText = String(requestComposerSnapshot.text ?? "").trim();
   const sceneDirection = $("#ai-task").value === "roleplay"
@@ -18446,6 +18979,10 @@ async function sendAiWithOptions({ ignoreContextWarning = false, retry = null }
   if ($("#ai-task").value === "roleplay" && !state.aiRoleplayCharacter) return toast("请先选择角色卡", "error");
   const requestScope = currentAiRequestScope();
   if (!requestScope) return toast("请先选择章节", "error");
+  if (queuedComposer) {
+    aiPromptQueue.remove(tab.id, queuedComposer.id);
+    renderAiPromptQueue();
+  }
   const { scope } = requestScope;
   const citations = requestComposerSnapshot.citations.map(({ chapterId, chapterTitle, startLine, endLine, text }) => ({ chapterId, chapterTitle, startLine, endLine, text }));
   const selectedTaskType = $("#ai-task").value;
@@ -18456,7 +18993,8 @@ async function sendAiWithOptions({ ignoreContextWarning = false, retry = null }
       tabId: tab.id,
       workId: state.work.id,
       conversationId: state.aiConversationId
-    })
+    }),
+    preserveComposer: Boolean(queuedComposer)
   };
   if (retry?.userMessageId) {
     requestHolder.snapshot = aiRequestManager.bind(requestHolder.snapshot, { userMessageId: retry.userMessageId });
@@ -18464,6 +19002,7 @@ async function sendAiWithOptions({ ignoreContextWarning = false, retry = null }
   setAiChatTabStatus(tab, "streaming");
   syncAiRequestControls();
   scrollAiFeedToBottom(tab.feed, { force: true });
+  let shouldFlushQueuedPrompt = false;
   try {
     try {
       await ensureAiModelsLoaded();
@@ -18508,6 +19047,7 @@ async function sendAiWithOptions({ ignoreContextWarning = false, retry = null }
     const streamedRequest = assertAiRequestCurrent(requestHolder.snapshot);
     if (streamed.action === "warn") return;
     assistantContent = streamed.content;
+    shouldFlushQueuedPrompt = true;
     assistantMessage = streamed.message;
     assistantMetadata = streamed.metadata;
     persistedStreamMessage = streamed.messageId ? { id: streamed.messageId, createdAt: streamed.createdAt } : null;
@@ -18638,6 +19178,18 @@ async function sendAiWithOptions({ ignoreContextWarning = false, retry = null }
     if (tab.status === "streaming") setAiChatTabStatus(tab, "ready");
     else renderAiChatTabs();
     if (isActiveAiChatTab(tab)) syncAiRequestControls();
+    if (queuedComposer && !shouldFlushQueuedPrompt) {
+      const stillQueued = aiPromptQueue.list(tab.id).some((item) => item.id === queuedComposer.id);
+      if (!stillQueued) {
+        try {
+          aiPromptQueue.restore(tab.id, queuedComposer, 0);
+        } catch {
+          /* 失败时尽量把未发出的排队 Prompt 放回队首，超限则保留当前队列。 */
+        }
+        renderAiPromptQueue();
+      }
+    }
+    if (shouldFlushQueuedPrompt) flushNextQueuedPrompt(tab);
   }
 }
 
@@ -18657,13 +19209,13 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
   const tab = aiChatTabForRequest(requestHolder.snapshot);
   if (!tab) throw createAiRequestAbortError("Agent 对话页签已关闭");
   const feed = tab.feed;
-  const message = document.createElement("div");
+  let message = document.createElement("div");
   message.className = "assistant-message is-streaming";
   message.dataset.testid = "ai-stream-message";
   const streamConnectionStartedAt = Date.now();
   message.innerHTML = '<div class="message-body" data-testid="ai-stream-content" aria-live="polite" aria-busy="true"></div><div class="message-meta">正在连接模型流…… <span class="ai-stream-connection-seconds" data-testid="ai-stream-connection-seconds"></span> 秒</div>';
-  const content = message.querySelector(".message-body");
-  const meta = message.querySelector(".message-meta");
+  let content = message.querySelector(".message-body");
+  let meta = message.querySelector(".message-meta");
   const connectionSeconds = message.querySelector(".ai-stream-connection-seconds");
   const renderStreamConnectionElapsed = () => {
     const elapsedSeconds = Math.max(0, Math.floor((Date.now() - streamConnectionStartedAt) / 1000));
@@ -18688,7 +19240,7 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
     scrollAiFeedToBottom(feed);
     return true;
   };
-  const typewriter = createStreamTypewriter({
+  const createAssistantTypewriter = () => createStreamTypewriter({
     speedController: streamSpeedController,
     shouldAnimate: () => aiStreamTargetVisible(feed),
     onRender: (text, progress) => {
@@ -18701,6 +19253,7 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
       });
     }
   });
+  let typewriter = createAssistantTypewriter();
   let streamedText = "";
   let streamedPendingText = "";
   let generatedMetadata = {};
@@ -18721,8 +19274,9 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
   const processStepVisibleContents = new Map();
   const renderStreamingProcessSteps = (completed, durationMs = elapsedProcessTime()) => {
     if (!aiRequestTargetsCurrentState(requestHolder.snapshot)) return;
-    aiStreamRenders.enqueue(message, () => {
-      renderAiProcessSteps(message, processSteps, completed, durationMs, processStepVisibleContents);
+    const target = message;
+    aiStreamRenders.enqueue(target, () => {
+      renderAiProcessSteps(target, processSteps, completed, durationMs, processStepVisibleContents);
       scrollAiFeedToBottom(feed);
     });
   };
@@ -18747,6 +19301,45 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
   const revealProcessStepTypewriters = () => {
     for (const typewriter of processStepTypewriters.values()) typewriter.reveal();
   };
+  const beginSteeredAssistantSegment = async (steerPayload) => {
+    await Promise.all([typewriter.finish(), finishProcessStepTypewriters()]);
+    if (messageMounted) {
+      message.classList.remove("is-streaming");
+      content.setAttribute("aria-busy", "false");
+      const headingRole = message.querySelector(".message-heading > span");
+      if (headingRole) headingRole.textContent = aiAssistantLabel("", tab.roleplayCharacter);
+      renderStreamingProcessSteps(true);
+      if (streamedText) attachAssistantCopyAction(message, streamedText);
+    }
+    const steerMessage = steerPayload?.message;
+    if (steerMessage?.id) {
+      updateAiConversationSummaryFromMessage(steerMessage);
+      const existingSteerMessage = [...tab.feed.querySelectorAll(".user-message[data-message-id]")]
+        .find((candidate) => candidate.dataset.messageId === String(steerMessage.id));
+      if (!existingSteerMessage) {
+        appendMessage("user", steerMessage.content, steerMessage.citations, steerMessage.createdAt, {
+          ...steerMessage.metadata,
+          kind: "steer"
+        }, steerMessage.id, { tab });
+      }
+    }
+    streamedText = "";
+    streamedPendingText = "";
+    toolCalls = [];
+    processSteps = [];
+    processStepTypewriters.clear();
+    processStepVisibleContents.clear();
+    message = document.createElement("div");
+    message.className = "assistant-message is-streaming";
+    message.dataset.testid = "ai-stream-message";
+    message.innerHTML = '<div class="message-body" data-testid="ai-stream-content" aria-live="polite" aria-busy="true"></div><div class="message-meta">已收到执行流引导，正在继续生成</div>';
+    content = message.querySelector(".message-body");
+    meta = message.querySelector(".message-meta");
+    messageMounted = false;
+    typewriter = createAssistantTypewriter();
+    mountAssistantMessage();
+    scrollAiFeedToBottom(feed);
+  };
   try {
     const request = assertAiRequestCurrent(requestHolder.snapshot);
     const response = await fetch(endpoint ?? `/api/works/${encodeURIComponent(request.workId)}/chat/stream`, {
@@ -18763,7 +19356,7 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
     let streamError = null;
     const consume = async (eventName, payload) => {
       assertAiRequestCurrent(requestHolder.snapshot);
-      if (streamConnectionEstablishedEvents.has(eventName)) stopStreamConnectionTimer();
+      if (streamConnectionEstablishedEvents.has(eventName) || eventName === "steer") stopStreamConnectionTimer();
       if (eventName === "continuation") {
         if (String(payload.conversationId ?? "") !== requestHolder.snapshot.conversationId) throw new Error("流式续接返回了其他对话");
         toolCalls = Array.isArray(payload.toolCalls) ? payload.toolCalls : [];
@@ -18813,7 +19406,7 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
           tab.hasImageAttachments = tab.hasImageAttachments === true || aiConversationMessageHasImages(persistedUserMessage);
           tab.selectedModelId = lockedModelId;
           tab.promptSent = true;
-          clearAiChatTabComposer(tab);
+          if (!requestHolder.preserveComposer) clearAiChatTabComposer(tab);
           const existingUserMessage = [...tab.feed.querySelectorAll(".user-message[data-message-id]")]
             .find((candidate) => candidate.dataset.messageId === String(persistedUserMessage.id));
           if (!existingUserMessage) {
@@ -18826,10 +19419,14 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
             syncAiTaskOptions();
             renderAiRoleplayCharacterSelect();
             renderAiQuickActions();
-            clearAiPromptComposer({ collapseScenePanel: Boolean(String(body.sceneDirection ?? "").trim()) });
+            if (!requestHolder.preserveComposer) {
+              clearAiPromptComposer({ collapseScenePanel: Boolean(String(body.sceneDirection ?? "").trim()) });
+            }
           }
           mountAssistantMessage();
         }
+      } else if (eventName === "steer") {
+        await beginSteeredAssistantSegment(payload);
       } else if (eventName === "delta") {
         mountAssistantMessage();
         const delta = typeof payload.delta === "string" ? payload.delta : "";
@@ -19041,6 +19638,14 @@ function appendMessage(role, text, citations = [], createdAt = null, metadata =
     failureBadge.setAttribute("aria-label", `消息状态：${isInterrupted ? aiStreamInterruptionLabel(interruptionCode) : "失败"}`);
     heading.firstElementChild?.append(failureBadge);
   }
+  if (role === "user" && metadata?.kind === "steer") {
+    message.classList.add("is-steer");
+    const steerBadge = document.createElement("strong");
+    steerBadge.className = "ai-message-status is-steer";
+    steerBadge.textContent = "引导";
+    steerBadge.setAttribute("aria-label", "消息类型：执行流引导");
+    heading.firstElementChild?.append(steerBadge);
+  }
   if (parsedUserTurn?.hasMarkup && parsedUserTurn.sceneDirection) {
     const scene = document.createElement("div");
     scene.className = "user-message-scene";
@@ -20333,6 +20938,7 @@ $("#register-form").addEventListener("submit", async (event) => {
         password: form.get("password"),
         passwordConfirmation: form.get("passwordConfirmation"),
         setupToken: form.get("setupToken") || undefined,
+        inviteCode: form.get("inviteCode") || undefined,
         captchaId: form.get("captchaId"),
         captchaAnswer: form.get("captchaAnswer")
       }
@@ -20375,6 +20981,7 @@ $("#platform-usage-pricing-refresh").addEventListener("click", async () => {
   }
 });
 $("#user-management-button").addEventListener("click", openUsersDialog);
+$("#invite-code-generate").addEventListener("click", () => generateRegistrationInvite().catch((error) => toast(error.message, "error")));
 $("#admin-ai-conversations-button").addEventListener("click", () => openAdminAiConversationsDialog().catch((error) => toast(error.message, "error")));
 $("#writing-progress-button").addEventListener("click", () => {
   void openWritingProgressDialog().catch((error) => toast(error.message, "error"));
@@ -20765,6 +21372,7 @@ $("#chapter-content").addEventListener("input", (event) => {
 });
 $("#chapter-content").addEventListener("select", () => setAiContextMeter(null));
 $("#chapter-content").addEventListener("scroll", syncChapterLineNumberScroll);
+$("#chapter-editor-scroll").addEventListener("scroll", syncChapterLineNumberScroll, { passive: true });
 $("#chapter-content").addEventListener("contextmenu", (event) => {
   if (!state.chapter) return;
   showLineCitationMenu(event, lineIndexAtPointer(event.clientY));
@@ -20856,7 +21464,7 @@ $("#ai-semantic-query").addEventListener("keydown", (event) => {
 $("#ai-semantic-inject").addEventListener("click", () => { void injectAiSemanticSelection(); });
 setupPanelResize($("#left-panel-resize"), "left");
 setupPanelResize($("#ai-panel-resize"), "ai");
-if (typeof ResizeObserver !== "undefined") new ResizeObserver(scheduleChapterLineNumbers).observe($("#chapter-content"));
+if (typeof ResizeObserver !== "undefined") new ResizeObserver(scheduleChapterLineNumbers).observe($("#chapter-editor-scroll"));
 if (typeof ResizeObserver !== "undefined") new ResizeObserver(syncMobileAiPanelSafeTop).observe($("#chapter-foreshadow-reminder"));
 window.addEventListener("resize", () => {
   if (isMobileViewport() && $("#onboarding-dialog").open) completeOnboarding();
@@ -20921,6 +21529,7 @@ $("#module-create-button").addEventListener("click", () => ({ drafts: openDraftD
     $(field)?.addEventListener("input", () => {
       syncAiSceneComposer();
       persistActiveAiChatTab();
+      syncAiRequestControls();
     });
   }
   $("#ai-attachment-input").addEventListener("change", (event) => {
@@ -20930,6 +21539,7 @@ $("#module-create-button").addEventListener("click", () => ({ drafts: openDraftD
 $("#ai-prompt").addEventListener("input", async () => {
   updateAiMentionMenu();
   setAiContextMeter(null);
+  syncAiRequestControls();
   const textBeforeCursor = aiPromptTextBeforeCursor();
   if ($("#ai-task").value !== "roleplay" && findAiSkillCommand(textBeforeCursor)) return;
   if (!findAiMention(textBeforeCursor)) return;
@@ -21338,6 +21948,11 @@ $("#ai-context-meter").addEventListener("click", () => {
 $("#ai-context-popover-close").addEventListener("click", () => setAiContextDistributionVisible(false));
 $("#ai-citation-popover-close").addEventListener("click", () => closeAiCitationPopover({ restoreFocus: true }));
 $("#ai-send").addEventListener("click", activateAiSendControl);
+$("#ai-send-mode").addEventListener("change", (event) => {
+  writeStoredAiSendMode(localStorage, event.currentTarget.value);
+  syncAiRequestControls();
+});
+applyAiSendModeFromStorage();
 $("#ai-conversation-switcher").addEventListener("click", () => {
   setAiConversationSwitcherVisible($("#ai-conversation-switcher-menu").classList.contains("hidden"));
 });
@@ -21681,9 +22296,9 @@ $("#ai-prompt").addEventListener("keydown", (event) => {
       return;
     }
   }
-  if (shouldSendAiPrompt(event)) {
+  if (shouldActivateAiSendControl(event)) {
     event.preventDefault();
-    if (!$("#ai-send").disabled && !aiRequestManager.hasActive(activeAiChatTab()?.id)) void sendAi();
+    if (!$("#ai-send").disabled) submitAiComposerPrompt();
   }
 });
 $(".quick-actions").addEventListener("click", (event) => {