@musnows/scriverse 1.1.3 → 1.1.5

package/dist/public/app.js

@@ -259,7 +259,8 @@ const state = {
   relationshipExpandedMap: null,
   collapsedVolumeIds: new Set(),
   collapsedRaceIds: new Set(),
-  contextChapterId: null
+  contextChapterId: null,
+  contextVolumeId: null
 };
 
 let platformAiProtocolOptions = [];
@@ -1274,6 +1275,7 @@ let latestAiContextUsage = null;
 const aiConversationHistoryPageLimit = 20;
 let aiConversationHistoryPage = { page: 1, limit: aiConversationHistoryPageLimit, hasMore: false, nextPage: null };
 let workScopedUiGeneration = 0;
+let workDirectoryRevision = 0;
 let workSelectionRequestGeneration = 0;
 let initialWorkDetail = null;
 let initialReaderChapterRequest = null;
@@ -1975,6 +1977,8 @@ let chapterDraftLineIdState = null;
 let chapterBeforeInputState = null;
 let chapterSearchMatchIndex = -1;
 let chapterSelectionRequestId = 0;
+let chapterBodyAbort = null;
+let chapterContentReadyId = null;
 let chapterForeshadowReminderRequestId = 0;
 let chapterForeshadowReminders = [];
 let chapterForeshadowReminderIndex = 0;
@@ -2080,9 +2084,12 @@ function applyChapterEditorMode() {
   $("#chapter-content").readOnly = viewOnly;
   $("#chapter-title").setAttribute("aria-readonly", String(viewOnly));
   $("#chapter-content").setAttribute("aria-readonly", String(viewOnly));
+  const waitingForChapter = chapterEditingLocked();
   editButton.classList.toggle("hidden", permissionBlocked || !state.chapter);
   editButton.classList.toggle("primary-button", chapterEditorReadOnly);
   editButton.classList.toggle("ghost-button", !chapterEditorReadOnly);
+  editButton.disabled = waitingForChapter;
+  editButton.setAttribute("aria-disabled", String(waitingForChapter));
   editButton.textContent = chapterEditorReadOnly ? "编辑" : "预览";
   editButton.setAttribute("aria-pressed", String(!chapterEditorReadOnly));
   editButton.setAttribute("aria-label", chapterEditorReadOnly ? "切换到编辑模式" : "切换到预览模式");
@@ -2093,6 +2100,8 @@ function applyChapterEditorMode() {
 }
 
 function enterChapterEditMode() {
+  // 缓存或占位正文还没被本次请求确认前，编辑按钮不进入编辑。
+  if (chapterEditingLocked()) return;
   if (!state.chapter || !canEditProse()) return;
   chapterEditorReadOnly = false;
   applyChapterEditorMode();
@@ -2103,6 +2112,7 @@ function enterChapterEditMode() {
 }
 
 function toggleChapterEditPreviewMode() {
+  if (chapterEditingLocked()) return;
   if (!state.chapter || !canEditProse()) return;
   if (chapterEditorReadOnly) {
     enterChapterEditMode();
@@ -6533,6 +6543,7 @@ async function api(path, options = {}) {
       body: body && typeof body !== "string" ? JSON.stringify(body) : body
     });
   } catch (error) {
+    if (error?.name === "AbortError") throw error;
     if (mobileOfflineRuntime.enabled) {
       const offlineSession = await mobileOfflineRuntime.activateOffline();
       if (offlineSession) return mobileOfflineRuntime.request(path, { method, body });
@@ -7658,6 +7669,7 @@ async function persistChapter({ automatic = false } = {}) {
     const saved = await request;
     if (state.work?.id !== workId || state.chapter?.id !== draft.chapterId) return saved.chapter;
     state.chapter = saved.chapter;
+    chapterContentReadyId = saved.chapter.id;
     state.work = saved.work;
     resetChapterDraftLineIds(state.chapter);
     lastSavedChapterSnapshot = draft;
@@ -9372,6 +9384,9 @@ function renderShelf() {
 
 function resetWorkScopedUiCaches() {
   chapterSelectionRequestId += 1;
+  chapterContentReadyId = null;
+  chapterBodyAbort?.abort();
+  chapterBodyAbort = null;
   clearChapterForeshadowReminders({ invalidateRequest: true });
   invalidateAiConversationNavigation("已切换作品");
   stopBackgroundTaskCenter();
@@ -9471,6 +9486,7 @@ async function selectWork(workId, preferredChapterId = null) {
   chapterEditorReadOnly = true;
   if (!canReadModule(state.module)) state.module = firstReadableUiModule(state.work) ?? "editor";
   applyWorkAccessMode();
+  void refreshChapterTitleFormat();
   startBackgroundTaskCenter(nextWork.id);
   updateDocumentTitle(state.work);
   $("#work-meta").textContent = `${state.work.title}${state.work.author ? ` · ${state.work.author}` : ""} · ${Number(state.work.wordCount ?? 0).toLocaleString("zh-CN")} 字`;
@@ -9490,26 +9506,27 @@ async function loadVolumeChapters(volumeId) {
   if (existingRequest) return existingRequest;
   const workId = state.work.id;
   const generation = workScopedUiGeneration;
+  const directoryRevision = workDirectoryRevision;
   volumeChapterLoadingIds.add(volumeId);
   renderTree([volumeId]);
   const request = (async () => {
     try {
       const chapters = await apiAllPages(`/api/volumes/${encodeURIComponent(volumeId)}/chapters`, 100);
-      if (state.work?.id !== workId || generation !== workScopedUiGeneration) return;
+      if (state.work?.id !== workId || generation !== workScopedUiGeneration || directoryRevision !== workDirectoryRevision) return;
       const volume = state.work.volumes.find((item) => item.id === volumeId);
       if (!volume) return;
       volume.chapters = chapters;
       volume.chapterCount = chapters.length;
       loadedVolumeChapterIds.add(volumeId);
     } catch (error) {
-      if (state.work?.id === workId && generation === workScopedUiGeneration) {
+      if (state.work?.id === workId && generation === workScopedUiGeneration && directoryRevision === workDirectoryRevision) {
         toast(`加载分卷章节失败：${error.message}`, "error");
       }
     } finally {
       if (volumeChapterRequests.get(volumeId) === request) {
         volumeChapterLoadingIds.delete(volumeId);
         volumeChapterRequests.delete(volumeId);
-        if (state.work?.id === workId && generation === workScopedUiGeneration) renderTree([volumeId]);
+        if (state.work?.id === workId && generation === workScopedUiGeneration && directoryRevision === workDirectoryRevision) renderTree([volumeId]);
       }
     }
   })();
@@ -9616,7 +9633,7 @@ function renderTree(volumeIds = null) {
     return `
     <div class="volume-node ${collapsed ? "is-collapsed" : ""}" data-volume-id="${esc(volume.id)}">
       <div class="volume-title">
-        <button class="volume-toggle" type="button" data-volume-toggle="${esc(volume.id)}" aria-expanded="${collapsed ? "false" : "true"}" title="左键展开或折叠；右键打开分卷详情；可将章节拖到这里追加"><span>${esc(volume.title)}</span><span class="volume-chapter-count"><span class="volume-chapter-count-number">${Number(volume.chapterCount ?? chapters.length)}</span><span class="volume-chapter-count-unit"> 章</span></span></button>
+        <button class="volume-toggle" type="button" data-volume-toggle="${esc(volume.id)}" aria-expanded="${collapsed ? "false" : "true"}" title="左键展开或折叠；右键打开分卷菜单；可将章节拖到这里追加"><span>${esc(volume.title)}</span><span class="volume-chapter-count"><span class="volume-chapter-count-number">${Number(volume.chapterCount ?? chapters.length)}</span><span class="volume-chapter-count-unit"> 章</span></span></button>
         ${proseEditable ? `<button class="ghost-button volume-detail-button" type="button" data-volume-detail="${esc(volume.id)}" aria-label="打开“${esc(volume.title)}”分卷详情" title="打开“${esc(volume.title)}”分卷详情"><svg class="volume-detail-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><circle cx="12" cy="12" r="8.5"></circle><path d="M12 10.5v5.5M12 7.5h.01"></path></svg></button>` : ""}
         ${proseEditable ? `<button class="add-button chapter-add-button" type="button" data-new-chapter-volume="${esc(volume.id)}" aria-label="在“${esc(volume.title)}”中新建章节" title="在“${esc(volume.title)}”中新建章节">+</button>` : ""}
       </div>
@@ -9650,12 +9667,13 @@ function renderTree(volumeIds = null) {
     button.addEventListener("contextmenu", (event) => {
       if (!canEditProse()) return;
       event.preventDefault();
-      openVolumeDialog(state.work.volumes.find((volume) => volume.id === button.dataset.volumeToggle));
+      openVolumeContextMenu(button.dataset.volumeToggle, event.clientX, event.clientY);
     });
     button.addEventListener("keydown", (event) => {
       if (!canEditProse() || (event.key !== "ContextMenu" && !(event.shiftKey && event.key === "F10"))) return;
       event.preventDefault();
-      openVolumeDialog(state.work.volumes.find((volume) => volume.id === button.dataset.volumeToggle));
+      const rect = button.getBoundingClientRect();
+      openVolumeContextMenu(button.dataset.volumeToggle, rect.left, rect.bottom);
     });
     if (proseEditable) {
       button.addEventListener("dragover", (event) => {
@@ -9856,7 +9874,10 @@ async function submitChapterBatch(event) {
     state.work = await api(`/api/works/${encodeURIComponent(workId)}`);
     const currentEditorVisible = state.module === "editor";
     const currentStillExists = state.chapter && state.work.volumes.some((volume) => volume.chapters.some((chapter) => chapter.id === state.chapter.id));
-    if (state.chapter && currentStillExists) state.chapter = await api(`/api/chapters/${encodeURIComponent(state.chapter.id)}`);
+    if (state.chapter && currentStillExists) {
+      state.chapter = await api(`/api/chapters/${encodeURIComponent(state.chapter.id)}`);
+      chapterContentReadyId = state.chapter.id;
+    }
     if (state.chapter && !currentStillExists) {
       state.chapter = null;
       showWelcome(true);
@@ -9940,6 +9961,7 @@ function closeChapterTypeMenu() {
 }
 
 function openChapterTypeMenu(chapterId, clientX, clientY) {
+  closeVolumeContextMenu();
   const chapter = state.work?.volumes.flatMap((volume) => volume.chapters).find((item) => item.id === chapterId);
   if (!chapter) return;
   state.contextChapterId = chapterId;
@@ -9947,9 +9969,10 @@ function openChapterTypeMenu(chapterId, clientX, clientY) {
   const canManageChapter = canEditProse();
   const canAddAiReference = canWritePermissionModule(state.work, "ai-chat");
   menu.querySelector("strong").textContent = `操作“${chapter.title}”`;
-  menu.querySelectorAll("[data-chapter-type], [data-delete-chapter]").forEach((button) => button.classList.toggle("hidden", !canManageChapter));
+  menu.querySelectorAll("[data-chapter-type], [data-delete-chapter], [data-insert-chapter-before], [data-insert-chapter-after]").forEach((button) => button.classList.toggle("hidden", !canManageChapter));
   menu.querySelector("[data-add-chapter-ai-reference]")?.classList.toggle("hidden", !canAddAiReference);
   menu.querySelector("#chapter-type-ai-reference-separator")?.classList.toggle("hidden", !(canManageChapter && canAddAiReference));
+  menu.querySelector("#chapter-insert-separator")?.classList.toggle("hidden", !canManageChapter);
   menu.querySelectorAll("[data-chapter-type]").forEach((button) => {
     button.classList.toggle("active", button.dataset.chapterType === (chapter.chapterType || "正文"));
     button.setAttribute("aria-checked", String(button.classList.contains("active")));
@@ -9990,6 +10013,7 @@ async function deleteChapter(chapterId) {
     const deletingSelectedChapter = state.chapter?.id === chapterId;
     const expectedVersionNo = deletingSelectedChapter ? state.chapter.versionNo : chapter.versionNo;
     await api(`/api/chapters/${chapterId}`, { method: "DELETE", body: { expectedVersionNo } });
+    if (String(chapterContentReadyId ?? "") === String(chapterId)) chapterContentReadyId = null;
     const workId = state.work.id;
     state.work = await api(`/api/works/${workId}`);
     if (deletingSelectedChapter) {
@@ -10208,33 +10232,47 @@ async function resolveCurrentChapterForeshadowReminder() {
   }
 }
 
-async function selectChapter(chapterId, { editMode = false } = {}) {
-  imWorkspace.close();
-  const workId = state.work?.id;
-  if (!workId) return false;
-  const selectionGeneration = ++chapterSelectionRequestGeneration;
-  const selectionRequestId = ++chapterSelectionRequestId;
-  clearChapterForeshadowReminders({ invalidateRequest: true });
-  if (state.chapter?.id !== chapterId && !(await confirmDiscardChanges("当前章节有未保存修改，仍要切换吗？"))) {
-    if (selectionRequestId === chapterSelectionRequestId) void loadChapterForeshadowReminders();
-    return false;
+function setChapterContentSkeleton(visible) {
+  const skeleton = $("#chapter-content-skeleton");
+  skeleton.classList.toggle("hidden", !visible);
+  skeleton.setAttribute("aria-busy", String(visible));
+  $("#editor-view").setAttribute("aria-busy", String(visible));
+  if (!visible) return;
+  $("#chapter-line-numbers-inner").replaceChildren();
+  $("#chapter-whitespace-inner").replaceChildren();
+}
+
+function chapterEditingLocked() {
+  return !state.chapter || String(chapterContentReadyId ?? "") !== String(state.chapter.id);
+}
+
+function directoryChapterEntry(chapterId) {
+  for (const volume of state.work?.volumes ?? []) {
+    const chapter = volume.chapters?.find((item) => String(item.id) === String(chapterId));
+    if (chapter) return chapter;
   }
-  resetChapterSearchPanel();
-  dismissDeleteToasts();
-  if (selectionGeneration !== chapterSelectionRequestGeneration || selectionRequestId !== chapterSelectionRequestId || state.work?.id !== workId) return false;
-  cancelChapterAutoSave();
-  let selectedChapter = state.chapter;
-  if (state.chapter?.id !== chapterId) {
-    selectedChapter = await api(`/api/chapters/${encodeURIComponent(chapterId)}`);
-    if (selectionGeneration !== chapterSelectionRequestGeneration || selectionRequestId !== chapterSelectionRequestId || state.work?.id !== workId) return false;
-    if (String(selectedChapter?.id ?? "") !== String(chapterId) || String(selectedChapter?.workId ?? "") !== String(workId)) return false;
-  }
-  if (!selectedChapter || selectionGeneration !== chapterSelectionRequestGeneration || selectionRequestId !== chapterSelectionRequestId || state.work?.id !== workId) return false;
-  state.chapter = selectedChapter;
-  mergeChapterDirectoryEntry(state.chapter);
-  state.collapsedVolumeIds.delete(state.chapter.volumeId);
-  lastSavedChapterSnapshot = { chapterId: state.chapter.id, title: state.chapter.title, content: state.chapter.content };
-  chapterEditorReadOnly = !canEditProse() || !editMode;
+  return null;
+}
+
+function chapterRequestStillCurrent(workId, selectionGeneration, selectionRequestId) {
+  return selectionGeneration === chapterSelectionRequestGeneration
+    && selectionRequestId === chapterSelectionRequestId
+    && state.work?.id === workId;
+}
+
+function presentChapter(chapter, { editMode = false, contentReady = false, syncRoute = true } = {}) {
+  state.chapter = chapter;
+  if (chapter?.volumeId && typeof chapter.content === "string" && (contentReady || chapter.content.length > 0)) {
+    mergeChapterDirectoryEntry(state.chapter);
+  }
+  if (chapter?.volumeId) state.collapsedVolumeIds.delete(chapter.volumeId);
+  lastSavedChapterSnapshot = {
+    chapterId: state.chapter.id,
+    title: state.chapter.title ?? "",
+    content: state.chapter.content ?? ""
+  };
+  chapterContentReadyId = contentReady ? state.chapter.id : null;
+  chapterEditorReadOnly = !contentReady || !editMode;
   state.module = "editor";
   applyWorkAccessMode();
   markActiveModule("editor");
@@ -10242,22 +10280,77 @@ async function selectChapter(chapterId, { editMode = false } = {}) {
   $("#module-view").classList.add("hidden");
   $("#editor-view").classList.remove("hidden");
   updateChapterPath();
-  $("#chapter-title").value = state.chapter.title;
-  $("#chapter-content").value = state.chapter.content;
+  const titleInput = $("#chapter-title");
+  const contentInput = $("#chapter-content");
+  const nextTitle = state.chapter.title ?? "";
+  const nextContent = state.chapter.content ?? "";
+  if (titleInput.value !== nextTitle) titleInput.value = nextTitle;
+  if (contentInput.value !== nextContent) contentInput.value = nextContent;
   resetChapterDraftLineIds(state.chapter);
   chapterAnnotationCounts = new Map();
   clearChapterLineSelection();
   scheduleChapterLineNumbers();
-  void loadChapterAnnotationCounts(state.chapter.id).catch((error) => {
-    if (String(state.chapter?.id ?? "") === String(chapterId)) toast("正文评论数量读取失败，请稍后重试", "error");
-  });
   dismissChapterInsightToast();
   updateChapterStats();
+  if (!contentReady) $("#chapter-stats").textContent = "正在载入";
   if (!canEditProse()) setSaveState("正文只读");
+  else if (!contentReady) setSaveState("正在同步正文");
   else if (chapterEditorReadOnly) setSaveState("阅读模式");
   else setSaveState("已保存");
+  setChapterContentSkeleton(!contentReady);
   syncChapterTreeSelection();
-  replacePageRoute({ view: "editor", workId: state.work.id, chapterId: state.chapter.id });
+  if (syncRoute) replacePageRoute({ view: "editor", workId: state.work.id, chapterId: state.chapter.id });
+}
+
+async function selectChapter(chapterId, { editMode = false } = {}) {
+  imWorkspace.close();
+  const workId = state.work?.id;
+  if (!workId) return false;
+  const sameChapter = String(state.chapter?.id ?? "") === String(chapterId);
+  if (sameChapter && chapterEditingLocked() && chapterBodyAbort && !chapterBodyAbort.signal.aborted) return true;
+  const selectionGeneration = ++chapterSelectionRequestGeneration;
+  const selectionRequestId = ++chapterSelectionRequestId;
+  if (!sameChapter) clearChapterForeshadowReminders({ invalidateRequest: true });
+  if (!sameChapter && !(await confirmDiscardChanges("当前章节有未保存修改，仍要切换吗？"))) {
+    if (selectionRequestId === chapterSelectionRequestId) void loadChapterForeshadowReminders();
+    return false;
+  }
+  resetChapterSearchPanel();
+  dismissDeleteToasts();
+  if (!chapterRequestStillCurrent(workId, selectionGeneration, selectionRequestId)) return false;
+  cancelChapterAutoSave();
+  if (sameChapter && String(chapterContentReadyId ?? "") === String(chapterId) && state.chapter) {
+    presentChapter(state.chapter, { editMode, contentReady: true });
+    syncChapterTreeSelection();
+    return true;
+  }
+  const directoryEntry = directoryChapterEntry(chapterId);
+  const previewChapter = directoryEntry
+    ? { ...directoryEntry, content: "", lineIds: [] }
+    : { id: chapterId, workId, volumeId: "", title: "", content: "", wordCount: 0, versionNo: 0, chapterType: "正文", lineIds: [] };
+  presentChapter(previewChapter, { editMode: false, contentReady: false });
+  syncChapterTreeSelection();
+  chapterBodyAbort?.abort();
+  const chapterBodyController = new AbortController();
+  chapterBodyAbort = chapterBodyController;
+  let selectedChapter = null;
+  try {
+    selectedChapter = await api(`/api/chapters/${encodeURIComponent(chapterId)}`, { signal: chapterBodyController.signal });
+  } catch (error) {
+    if (chapterBodyAbort === chapterBodyController) chapterBodyAbort = null;
+    if (error?.name === "AbortError" || !chapterRequestStillCurrent(workId, selectionGeneration, selectionRequestId)) return false;
+    if (String(state.chapter?.id ?? "") === String(chapterId)) setSaveState("正文载入失败", true);
+    toast(error.message || "章节读取失败", "error");
+    return false;
+  }
+  if (chapterBodyAbort === chapterBodyController) chapterBodyAbort = null;
+  if (!chapterRequestStillCurrent(workId, selectionGeneration, selectionRequestId)) return false;
+  if (String(selectedChapter?.id ?? "") !== String(chapterId) || String(selectedChapter?.workId ?? "") !== String(workId)) return false;
+  presentChapter(selectedChapter, { editMode, contentReady: true, syncRoute: false });
+  syncChapterTreeSelection();
+  void loadChapterAnnotationCounts(state.chapter.id).catch(() => {
+    if (String(state.chapter?.id ?? "") === String(chapterId)) toast("正文评论数量读取失败，请稍后重试", "error");
+  });
   void loadChapterForeshadowReminders();
   return true;
 }
@@ -10829,6 +10922,8 @@ async function showModule(module) {
   state.module = module;
   if (module !== "editor") {
     chapterSelectionRequestId += 1;
+    chapterBodyAbort?.abort();
+    chapterBodyAbort = null;
     clearChapterForeshadowReminders({ invalidateRequest: true });
   }
   if (module !== "tasks") stopTaskProgressRefresh();
@@ -11890,12 +11985,13 @@ async function renderCharacters(page = characterListPage) {
     || characterFilters.genderValues.length > 0
     || characterFilters.deathState !== "all";
   const pageSize = pageSizeFor("characters");
+  const needsCharacterFilterCatalog = hasCharacterFilters || characterFiltersPanelOpen;
   const [characterSource, races, organizations] = await Promise.all([
     hasCharacterFilters
       ? moduleApiAllPages("characters", `/api/works/${state.work.id}/characters`)
       : moduleApiPage("characters", `/api/works/${state.work.id}/characters`, page, pageSize),
-    canReadModule("races") ? moduleApi("characters", `/api/works/${state.work.id}/races`) : Promise.resolve([]),
-    canReadModule("organizations") ? moduleApiAllPages("characters", `/api/works/${state.work.id}/organizations`) : Promise.resolve([])
+    needsCharacterFilterCatalog && canReadModule("races") ? moduleApi("characters", `/api/works/${state.work.id}/races`) : Promise.resolve([]),
+    needsCharacterFilterCatalog && canReadModule("organizations") ? moduleApiAllPages("characters", `/api/works/${state.work.id}/organizations`) : Promise.resolve([])
   ]);
   const characterPage = hasCharacterFilters
     ? paginateCharacters(filterCharacters(characterSource, characterFilters), page, pageSize)
@@ -11903,7 +11999,7 @@ async function renderCharacters(page = characterListPage) {
   if (!characterPage.items.length && page > 1) return renderCharacters(page - 1);
   characterListPage = characterPage.page;
   const pageCharacters = characterPage.items;
-  [state.races, state.organizations] = [races, organizations];
+  if (needsCharacterFilterCatalog) [state.races, state.organizations] = [races, organizations];
   mountModuleCount(characterPage.total);
   const layout = readModuleLayout();
   const characterActions = (item) => `${characterPinButton(item)}${characterFavoriteButton(item)}${recordCardEditButton("edit-character", item.id, `角色“${item.name}”`)}`;
@@ -14157,10 +14253,7 @@ function updateBackgroundTaskCenterVisibility() {
     $("#background-task-count")?.classList.add("hidden");
     return;
   }
-  const activityCount = backgroundTaskActivityCount(
-    backgroundTaskCenterSnapshot.taskPage,
-    backgroundTaskCenterSnapshot.relationshipIndex
-  ) + (productUpdateChecking ? 1 : 0);
+  const activityCount = backgroundTaskActivityCount(backgroundTaskCenterSnapshot.taskPage) + (productUpdateChecking ? 1 : 0);
   const badge = $("#background-task-count");
   badge.textContent = activityCount > 99 ? "99+" : String(activityCount);
   badge.classList.toggle("hidden", activityCount === 0);
@@ -14244,7 +14337,7 @@ function backgroundIndexMarkup(relationshipIndex, error) {
   const editable = canEditModule("ai-settings");
   return `<section class="background-task-section">
     <div class="background-task-section-heading">
-      <div><strong>人物关系拼音索引</strong><small>可在任何模块查看增量同步状态</small></div>
+      <div><strong>人物关系拼音索引</strong><small>打开本窗口时显示当前索引状态</small></div>
       <div class="background-index-actions ${editable ? "" : "hidden"}">
         <button class="primary-button" type="button" data-background-index-action="sync">同步增量队列</button>
         <button class="ghost-button" type="button" data-background-index-action="rebuild">完整重建</button>
@@ -14315,10 +14408,7 @@ function scheduleBackgroundTaskCenterRefresh() {
   if (backgroundTaskCenterTimer !== null) window.clearTimeout(backgroundTaskCenterTimer);
   backgroundTaskCenterTimer = null;
   if (!backgroundTaskCenterWorkId) return;
-  const activityCount = backgroundTaskActivityCount(
-    backgroundTaskCenterSnapshot.taskPage,
-    backgroundTaskCenterSnapshot.relationshipIndex
-  );
+  const activityCount = backgroundTaskActivityCount(backgroundTaskCenterSnapshot.taskPage);
   const delay = backgroundTaskPollDelay(activityCount, Boolean($("#background-task-dialog")?.open));
   backgroundTaskCenterTimer = window.setTimeout(() => {
     backgroundTaskCenterTimer = null;
@@ -14332,8 +14422,9 @@ async function refreshBackgroundTaskCenter({ announce = true } = {}) {
   if (backgroundTaskCenterTimer !== null) window.clearTimeout(backgroundTaskCenterTimer);
   backgroundTaskCenterTimer = null;
   const requestId = ++backgroundTaskCenterRequest;
+  const dialogOpen = Boolean($("#background-task-dialog")?.open);
   const readTasks = canReadModule("tasks");
-  const readIndex = canReadModule("ai-settings");
+  const readIndex = dialogOpen && canReadModule("ai-settings");
   const [taskResult, indexResult] = await Promise.all([
     readTasks
       ? api(`/api/works/${encodeURIComponent(workId)}/tasks?page=1&limit=30`)
@@ -16285,19 +16376,159 @@ async function deleteWork(work) {
   }
 }
 
+const chapterTitleFormatLabels = {
+  off: "不自动编号",
+  auto: "自动识别",
+  dot: "N. 标题",
+  "chapter-arabic": "第N章 标题",
+  "chapter-chinese": "第N章（中文数字）",
+  enumeration: "N、标题",
+  english: "Chapter N:"
+};
+let chapterTitleFormatStatus = null;
+let chapterTitleOnFocus = "";
+
+function chapterTitleHasNumber(title) {
+  const source = String(title ?? "").trim();
+  return /^(?:第\s*(?:[0-9０-９]+|[〇零一二三四五六七八九十百千万两]+)\s*章|chap(?:ter)?\.?\s*[0-9０-９]+|[0-9０-９]+\s*[.．、])/iu.test(source);
+}
+
+function currentChapterTitleFormatStatus() {
+  if (!chapterTitleFormatStatus || chapterTitleFormatStatus.workId !== state.work?.id) return null;
+  return chapterTitleFormatStatus;
+}
+
+function currentChapterTitlePreference() {
+  const preference = state.work?.chapterTitleFormat || currentChapterTitleFormatStatus()?.preference || "off";
+  return chapterTitleFormatLabels[preference] ? preference : "off";
+}
+
+function describeChapterTitleFormatNote(preference, status) {
+  if (!state.work) return "选择作品后，可以识别已有标题格式，或指定一种常见格式。";
+  if (preference === "off") return "关闭后，新建和插入章节保持手写标题。需要整理某一卷时，再打开该卷的标题编号并重新编号。";
+  if (preference === "auto") {
+    if (status?.detected) return `已识别为「${chapterTitleFormatLabels[status.detected]}」。插入章节时按此格式编号，并只后移本卷后面的序号。`;
+    return "现有标题还没有压倒性的同一种格式。请选择一种常见格式，或重新编号本卷。";
+  }
+  const label = chapterTitleFormatLabels[preference] ?? preference;
+  return `新插入的章节使用「${label}」。切换格式不会改写已有标题；只有重新编号本卷才会改写这一卷。`;
+}
+
+function syncVolumeTitleNumberingNote() {
+  const note = $("#volume-title-number-note");
+  const select = $("#dialog-fields select[name='chapterTitleFormat']");
+  if (!note || !select) return;
+  const preference = currentChapterTitlePreference();
+  if (document.activeElement !== select && chapterTitleFormatLabels[preference]) select.value = preference;
+  note.textContent = describeChapterTitleFormatNote(select.value || preference, currentChapterTitleFormatStatus());
+}
+
+async function refreshChapterTitleFormat() {
+  const workId = state.work?.id;
+  if (!workId) {
+    chapterTitleFormatStatus = null;
+    syncVolumeTitleNumberingNote();
+    return;
+  }
+  const requestId = ++refreshChapterTitleFormat.requestId;
+  try {
+    const status = await api(`/api/works/${encodeURIComponent(workId)}/chapter-title-format`);
+    if (requestId !== refreshChapterTitleFormat.requestId || state.work?.id !== workId) return;
+    chapterTitleFormatStatus = { ...status, workId };
+    state.work.chapterTitleFormat = status.preference;
+    syncVolumeTitleNumberingNote();
+  } catch (error) {
+    if (requestId === refreshChapterTitleFormat.requestId && state.work?.id === workId) syncVolumeTitleNumberingNote();
+  }
+}
+refreshChapterTitleFormat.requestId = 0;
+
+async function reloadWorkDirectory(workId) {
+  const revision = ++workDirectoryRevision;
+  const directory = await api(`/api/works/${encodeURIComponent(workId)}`);
+  if (state.work?.id !== workId || revision !== workDirectoryRevision) return null;
+  const collapsed = state.collapsedVolumeIds;
+  state.work = {
+    ...directory,
+    volumes: (directory.volumes ?? []).map((volume) => ({
+      ...volume,
+      chapters: Array.isArray(volume.chapters) ? volume.chapters : [],
+      chapterCount: Array.isArray(volume.chapters) ? volume.chapters.length : Number(volume.chapterCount ?? 0)
+    }))
+  };
+  state.collapsedVolumeIds = collapsed;
+  loadedVolumeChapterIds.clear();
+  for (const volume of state.work.volumes) loadedVolumeChapterIds.add(volume.id);
+  renderTree();
+  if (state.chapter) {
+    const fresh = state.work.volumes.flatMap((volume) => volume.chapters).find((item) => item.id === state.chapter.id);
+    // 插入或重排会改写已打开章节的序号。目录已经是新标题，但内存中的当前章节仍可能是旧标题；先对齐再同步，避免把旧序号写回目录节点。
+    if (fresh && fresh.title !== state.chapter.title) {
+      const previousTitle = state.chapter.title;
+      state.chapter = {
+        ...state.chapter,
+        title: fresh.title,
+        sortOrder: fresh.sortOrder,
+        versionNo: fresh.versionNo,
+        wordCount: fresh.wordCount,
+        chapterType: fresh.chapterType ?? state.chapter.chapterType
+      };
+      const titleInput = $("#chapter-title");
+      if (titleInput.value.trim() === previousTitle) {
+        titleInput.value = fresh.title;
+        chapterTitleOnFocus = fresh.title;
+        if (lastSavedChapterSnapshot?.chapterId === state.chapter.id) {
+          lastSavedChapterSnapshot = { ...lastSavedChapterSnapshot, title: fresh.title };
+        }
+      }
+    }
+    syncChapterTreeSelection();
+  }
+  return state.work;
+}
+
+function rememberWorkVersion(work) {
+  if (!work?.id) return;
+  const listed = state.works.find((item) => item.id === work.id);
+  if (listed) listed.versionNo = work.versionNo;
+}
+
 async function openChapterDialog(volumeId = null) {
+  const insertAfterChapterId = openChapterDialog.insertAfterChapterId ?? null;
+  const insertBeforeChapterId = openChapterDialog.insertBeforeChapterId ?? null;
+  openChapterDialog.insertAfterChapterId = null;
+  openChapterDialog.insertBeforeChapterId = null;
   if (!state.work) return openWorkDialog();
   if (!canEditProse()) return toast("当前权限只能编辑设定资料，正文为只读", "error");
   if (!state.work.volumes.length) {
     await api(`/api/works/${state.work.id}/volumes`, { method: "POST", body: { title: "正文", kind: "main" } });
-    state.work = await api(`/api/works/${state.work.id}`);
-    renderTree();
-  }
-  const selectedVolumeId = state.work.volumes.some((volume) => volume.id === volumeId) ? volumeId : state.work.volumes[0].id;
-  openDialog("新建章节", field("title", "章节标题") + field("volumeId", "所属卷", "select", selectedVolumeId, state.work.volumes.map((volume) => [volume.id, volume.title])) + field("chapterType", "章节类型", "select", "正文", chapterTypes.map((value) => [value, value])), async (form) => {
-    const chapter = await api(`/api/works/${state.work.id}/chapters`, { method: "POST", body: { title: form.get("title"), volumeId: form.get("volumeId"), chapterType: form.get("chapterType"), content: "" } });
-    state.work = await api(`/api/works/${state.work.id}`);
+    await reloadWorkDirectory(state.work.id);
+  }
+  const anchorId = insertBeforeChapterId ?? insertAfterChapterId;
+  const anchorLocation = anchorId ? findChapterLocation(anchorId) : null;
+  const anchor = anchorLocation?.chapter ?? null;
+  const insertBefore = Boolean(anchor && insertBeforeChapterId);
+  const preferredVolumeId = anchorLocation?.volume.id ?? volumeId;
+  const selectedVolumeId = state.work.volumes.some((volume) => volume.id === preferredVolumeId) ? preferredVolumeId : state.work.volumes[0].id;
+  const volumeField = anchor
+    ? `<input type="hidden" name="volumeId" value="${esc(selectedVolumeId)}"><p class="form-field-note">插入到“${esc(anchor.title)}”${insertBefore ? "之前" : "之后"}。开启标题编号时，只为本卷补序号并后移本卷后续章节，其他分卷保持不变。</p>`
+    : field("volumeId", "所属卷", "select", selectedVolumeId, state.work.volumes.map((volume) => [volume.id, volume.title]));
+  openDialog(anchor ? "插入章节" : "新建章节", field("title", "章节标题") + volumeField + field("chapterType", "章节类型", "select", "正文", chapterTypes.map((value) => [value, value])), async (form) => {
+    const preference = currentChapterTitlePreference();
+    const body = {
+      title: form.get("title"),
+      volumeId: form.get("volumeId"),
+      chapterType: form.get("chapterType"),
+      content: ""
+    };
+    if (anchor && insertBefore) body.insertBeforeChapterId = anchor.id;
+    else if (anchor) body.insertAfterChapterId = anchor.id;
+    if (preference !== "off") body.numberTitle = true;
+    const chapter = await api(`/api/works/${state.work.id}/chapters`, { method: "POST", body });
+    await reloadWorkDirectory(state.work.id);
     await selectChapter(chapter.id, { editMode: true });
+    if (state.chapter?.id === chapter.id) $("#chapter-title").value = state.chapter.title;
+    void refreshChapterTitleFormat();
   });
 }
 
@@ -16340,6 +16571,145 @@ function openVolumeDialog(item) {
   });
 }
 
+function closeVolumeContextMenu() {
+  state.contextVolumeId = null;
+  $("#volume-context-menu")?.classList.add("hidden");
+}
+
+function openVolumeContextMenu(volumeId, clientX, clientY) {
+  const volume = state.work?.volumes.find((item) => item.id === volumeId);
+  if (!volume || !canEditProse()) return;
+  closeChapterTypeMenu();
+  state.contextVolumeId = volumeId;
+  const menu = $("#volume-context-menu");
+  menu.querySelector("strong").textContent = `操作“${volume.title}”`;
+  menu.classList.remove("hidden");
+  const rect = menu.getBoundingClientRect();
+  menu.style.left = `${Math.max(8, Math.min(clientX, window.innerWidth - rect.width - 8))}px`;
+  menu.style.top = `${Math.max(8, Math.min(clientY, window.innerHeight - rect.height - 8))}px`;
+}
+
+let chapterTitleFormatSave = null;
+
+async function saveChapterTitleFormat(next, select = null) {
+  const run = () => saveChapterTitleFormatNow(next, select);
+  const pending = (chapterTitleFormatSave ?? Promise.resolve()).then(run, run);
+  chapterTitleFormatSave = pending.finally(() => {
+    if (chapterTitleFormatSave === pending) chapterTitleFormatSave = null;
+  });
+  return chapterTitleFormatSave;
+}
+
+async function saveChapterTitleFormatNow(next, select = null) {
+  const previous = currentChapterTitlePreference();
+  if (!state.work || !chapterTitleFormatLabels[next] || next === previous) {
+    syncVolumeTitleNumberingNote();
+    return next === previous;
+  }
+  if (!canEditProse()) {
+    if (select) select.value = previous;
+    toast("当前权限不能修改正文目录", "error");
+    return false;
+  }
+  if (select) select.disabled = true;
+  try {
+    const status = await api(`/api/works/${encodeURIComponent(state.work.id)}/chapter-title-format`, {
+      method: "PATCH",
+      body: { chapterTitleFormat: next, expectedVersionNo: state.work.versionNo }
+    });
+    if (state.work?.id) {
+      state.work.chapterTitleFormat = status.preference;
+      state.work.versionNo = status.versionNo;
+      rememberWorkVersion(state.work);
+      chapterTitleFormatStatus = { ...status, workId: state.work.id };
+    }
+    syncVolumeTitleNumberingNote();
+    toast(next === "off"
+      ? "已关闭自动编号，已有章节标题保持不变"
+      : `标题编号已改为「${chapterTitleFormatLabels[next]}」。已有章节不会立刻改写，可在该卷的标题编号里重新编号。`);
+    return true;
+  } catch (error) {
+    if (select) select.value = previous;
+    toast(error.message, "error");
+    return false;
+  } finally {
+    if (select?.isConnected) select.disabled = false;
+    syncVolumeTitleNumberingNote();
+  }
+}
+
+function openVolumeTitleNumberingDialog(item) {
+  if (!state.work || !item || !canEditProse()) return toast("当前权限不能修改分卷", "error");
+  const preference = currentChapterTitlePreference();
+  openDialog("标题编号",
+    field("chapterTitleFormat", "编号格式", "select", preference, Object.entries(chapterTitleFormatLabels)) +
+    `<p id="volume-title-number-note" class="form-field-note">${esc(describeChapterTitleFormatNote(preference, currentChapterTitleFormatStatus()))}</p>` +
+    `<p class="form-field-note">编号格式供这部作品的新章节使用，切换后不会改写已有标题。重新编号只改写“${esc(item.title)}”，其他分卷保持不变。插入章节时，也只给所在分卷补序号并后移该卷后续章节。</p>` +
+    `<div class="entity-dialog-management-actions"><button class="ghost-button" type="button" data-volume-title-renumber>重新编号本卷</button></div>`,
+    async () => {},
+    "分卷",
+    { submitLabel: "完成", meta: item.title }
+  );
+  const select = $("#dialog-fields select[name='chapterTitleFormat']");
+  select?.addEventListener("change", () => {
+    void saveChapterTitleFormat(select.value, select);
+  });
+  $("#dialog-fields").querySelector("[data-volume-title-renumber]")?.addEventListener("click", async () => {
+    if (select && select.value !== currentChapterTitlePreference()) {
+      const saved = await saveChapterTitleFormat(select.value, select);
+      if (!saved) return;
+    }
+    await renumberVolumeChapterTitles(item);
+  });
+  void refreshChapterTitleFormat();
+}
+
+async function renumberVolumeChapterTitles(item) {
+  if (!state.work || !item || !canEditProse()) return toast("当前权限不能修改分卷", "error");
+  const preference = $("#dialog-fields select[name='chapterTitleFormat']")?.value || currentChapterTitlePreference();
+  const status = currentChapterTitleFormatStatus();
+  if (preference === "off" || (preference === "auto" && status && !status.resolved)) {
+    toast("请先选择标题编号格式，或使用自动识别", "error");
+    return;
+  }
+  $("#form-dialog").close();
+  const confirmed = await confirmToast(`按当前标题编号格式，重新编排分卷“${item.title}”里的章节序号。只影响这一卷，序号以外的标题文字会保留，其他分卷不变。`, {
+    title: "重新编号本卷",
+    confirmLabel: "重新编号"
+  });
+  if (!confirmed) return openVolumeTitleNumberingDialog(item);
+  try {
+    const result = await api(`/api/volumes/${encodeURIComponent(item.id)}/renumber-titles`, { method: "POST", body: {} });
+    const workId = state.work.id;
+    const selectedId = state.chapter?.id ?? null;
+    const selectedVolumeId = state.chapter?.volumeId ?? null;
+    const contentBefore = selectedId ? $("#chapter-content").value : "";
+    await reloadWorkDirectory(workId);
+    if (selectedId && selectedVolumeId === item.id && state.work?.id === workId) {
+      const fresh = await api(`/api/chapters/${encodeURIComponent(selectedId)}`);
+      if (state.chapter?.id === selectedId) {
+        const contentDirty = Boolean(lastSavedChapterSnapshot) && contentBefore !== lastSavedChapterSnapshot.content;
+        state.chapter = { ...state.chapter, title: fresh.title, versionNo: fresh.versionNo, updatedAt: fresh.updatedAt };
+        $("#chapter-title").value = fresh.title;
+        lastSavedChapterSnapshot = {
+          chapterId: selectedId,
+          title: fresh.title,
+          content: contentDirty ? lastSavedChapterSnapshot.content : state.chapter.content
+        };
+        updateChapterPath();
+        syncChapterTreeSelection();
+        if (contentDirty) scheduleChapterAutoSave(120);
+      }
+    }
+    const label = chapterTitleFormatLabels[result.format] ?? result.format;
+    toast(`已按「${label}」重新编号分卷“${item.title}”，从 ${result.startAt} 起更新 ${result.updated} 章`);
+    void refreshChapterTitleFormat();
+  } catch (error) {
+    toast(error.message, "error");
+    openVolumeTitleNumberingDialog(item);
+  }
+}
+
 async function deleteVolume(item) {
   if (!state.work || !item || !canEditProse()) return toast("当前权限不能删除分卷", "error");
   $("#form-dialog").close();
@@ -20087,6 +20457,7 @@ async function showVersions() {
     }
     try {
       state.chapter = await api(`/api/chapters/${state.chapter.id}/restore`, { method: "POST", body: { versionNo: Number(button.dataset.restoreVersion) } });
+      chapterContentReadyId = state.chapter.id;
       resetChapterDraftLineIds(state.chapter);
       lastSavedChapterSnapshot = { chapterId: state.chapter.id, title: state.chapter.title, content: state.chapter.content };
       $("#chapter-title").value = state.chapter.title;
@@ -21170,8 +21541,8 @@ $("#login-form").addEventListener("submit", async (event) => {
     window.location.reload();
   } catch (error) {
     $("#auth-error").textContent = error.message;
-    // 仅在验证码已显示时自动换一张，未加载过则保持默认隐藏状态
-    if (!$("#login-captcha-image").hidden) refreshAuthCaptcha("login").catch(() => {});
+    // 答案错误时保留同一张图；过期、已核销或其他失败才换一张
+    if (error?.code !== "CAPTCHA_INCORRECT" && !$("#login-captcha-image").hidden) refreshAuthCaptcha("login").catch(() => {});
   }
 });
 $("#register-form").addEventListener("submit", async (event) => {
@@ -21199,8 +21570,8 @@ $("#register-form").addEventListener("submit", async (event) => {
     window.location.reload();
   } catch (error) {
     $("#auth-error").textContent = error.message;
-    // 仅在验证码已显示时自动换一张，未加载过则保持默认隐藏状态
-    if (!$("#register-captcha-image").hidden) refreshAuthCaptcha("register").catch(() => {});
+    // 答案错误时保留同一张图；过期、已核销或其他失败才换一张
+    if (error?.code !== "CAPTCHA_INCORRECT" && !$("#register-captcha-image").hidden) refreshAuthCaptcha("register").catch(() => {});
   }
 });
 $("#settings-return").addEventListener("click", () => returnFromSettings().catch((error) => toast(error.message, "error")));
@@ -21567,6 +21938,12 @@ $("#appearance-form").addEventListener("submit", (event) => {
   $("#appearance-dialog").close();
   toast(persisted ? "显示设置已保存" : "显示设置已应用，但当前浏览器无法保存偏好", persisted ? "info" : "error");
 });
+$("#chapter-title").addEventListener("focus", () => {
+  chapterTitleOnFocus = $("#chapter-title").value.trim();
+});
+$("#chapter-title").addEventListener("blur", () => {
+  void applyEditedChapterTitleNumber();
+});
 $("#chapter-title").addEventListener("input", () => scheduleChapterAutoSave());
 $("#chapter-content").addEventListener("beforeinput", (event) => {
   if (!state.chapter) return;
@@ -22063,6 +22440,59 @@ $("#cover-file").addEventListener("change", async (event) => {
     event.target.value = "";
   }
 });
+async function applyEditedChapterTitleNumber() {
+  if (!state.chapter || !canEditProse() || chapterEditorReadOnly) return;
+  const preference = currentChapterTitlePreference();
+  if (preference === "off") return;
+  if (chapterSaveInFlight) await chapterSaveInFlight;
+  if (!state.chapter || chapterEditorReadOnly) return;
+  const title = $("#chapter-title").value.trim();
+  const titleAtFocus = chapterTitleOnFocus;
+  if (!title || chapterTitleHasNumber(title)) return;
+  if (title === titleAtFocus && title === lastSavedChapterSnapshot?.title) return;
+  cancelChapterAutoSave();
+  const chapterId = state.chapter.id;
+  const workId = state.work.id;
+  const contentBefore = $("#chapter-content").value;
+  try {
+    const chapter = await api(`/api/chapters/${encodeURIComponent(chapterId)}/apply-title-number`, {
+      method: "POST",
+      body: { title, expectedVersionNo: state.chapter.versionNo }
+    });
+    if (state.work?.id !== workId) return;
+    await reloadWorkDirectory(workId);
+    if (state.chapter?.id !== chapterId || state.work?.id !== workId) return;
+    const contentDirty = Boolean(lastSavedChapterSnapshot) && contentBefore !== lastSavedChapterSnapshot.content;
+    state.chapter = { ...state.chapter, ...chapter, content: state.chapter.content };
+    $("#chapter-title").value = chapter.title;
+    chapterTitleOnFocus = chapter.title;
+    lastSavedChapterSnapshot = {
+      chapterId,
+      title: chapter.title,
+      content: contentDirty ? lastSavedChapterSnapshot.content : state.chapter.content
+    };
+    syncChapterTreeSelection();
+    if (contentDirty) scheduleChapterAutoSave(120);
+    else setSaveState("已保存");
+    void refreshChapterTitleFormat();
+  } catch (error) {
+    toast(error.message, "error");
+    if (state.chapter?.id === chapterId) scheduleChapterAutoSave(120);
+  }
+}
+
+$("#volume-context-menu").addEventListener("click", (event) => {
+  const volume = state.work?.volumes.find((item) => item.id === state.contextVolumeId);
+  if (event.target.closest("[data-volume-menu-detail]")) {
+    closeVolumeContextMenu();
+    if (volume) openVolumeDialog(volume);
+    return;
+  }
+  if (event.target.closest("[data-volume-menu-numbering]")) {
+    closeVolumeContextMenu();
+    if (volume) openVolumeTitleNumberingDialog(volume);
+  }
+});
 $("#chapter-type-menu").addEventListener("click", async (event) => {
   const aiReferenceButton = event.target.closest("[data-add-chapter-ai-reference]");
   if (aiReferenceButton) {
@@ -22071,6 +22501,19 @@ $("#chapter-type-menu").addEventListener("click", async (event) => {
     if (chapterId) addChapterAsAiReference(chapterId);
     return;
   }
+  const insertBeforeButton = event.target.closest("[data-insert-chapter-before]");
+  const insertAfterButton = event.target.closest("[data-insert-chapter-after]");
+  if (insertBeforeButton || insertAfterButton) {
+    const chapterId = state.contextChapterId;
+    const location = chapterId ? findChapterLocation(chapterId) : null;
+    closeChapterTypeMenu();
+    if (location) {
+      if (insertBeforeButton) openChapterDialog.insertBeforeChapterId = chapterId;
+      else openChapterDialog.insertAfterChapterId = chapterId;
+      await openChapterDialog(location.volume.id);
+    }
+    return;
+  }
   const deleteButton = event.target.closest("[data-delete-chapter]");
   if (deleteButton) {
     const chapterId = state.contextChapterId;
@@ -22112,6 +22555,7 @@ document.addEventListener("contextmenu", (event) => {
 });
 document.addEventListener("pointerdown", (event) => {
   if (!event.target.closest("#chapter-type-menu")) closeChapterTypeMenu();
+  if (!event.target.closest("#volume-context-menu")) closeVolumeContextMenu();
   if (!event.target.closest("#line-citation-menu")) closeLineCitationMenu();
   if (!event.target.closest("#markdown-table-menu")) closeMarkdownTableMenu();
   if (!event.target.closest("#manuscript-export-menu") && !event.target.closest("#export-button") && !event.target.closest("#work-export-button")) {