@musnows/scriverse 0.9.0 → 0.9.2

package/dist/public/app.js

@@ -1052,9 +1052,14 @@ function renderPresence() {
     return;
   }
   const groups = groupedPresenceParticipants();
+  const showControl = groups.length > 1;
   const localKey = presencePageKey(presencePageForRoute());
   syncChapterAutoSaveWithPresence();
-  control.classList.remove("hidden");
+  control.classList.toggle("hidden", !showControl);
+  if (!showControl) {
+    $("#presence-panel").classList.add("hidden");
+    $("#presence-button").setAttribute("aria-expanded", "false");
+  }
   $("#presence-count").textContent = `${groups.length} 人`;
   $("#presence-list").innerHTML = groups.map((participant) => {
     const isCurrent = participant.userId === state.user?.userId;
@@ -3445,15 +3450,18 @@ async function createNewAiConversation(taskType = "chat") {
 function favoriteCharactersFirst(characters) {
   const items = Array.isArray(characters) ? characters : [];
   return [
-    ...items.filter((character) => character.isFavorite === true),
-    ...items.filter((character) => character.isFavorite !== true)
+    ...items.filter((character) => character.isPinned === true && character.isFavorite === true),
+    ...items.filter((character) => character.isPinned === true && character.isFavorite !== true),
+    ...items.filter((character) => character.isPinned !== true && character.isFavorite === true),
+    ...items.filter((character) => character.isPinned !== true && character.isFavorite !== true)
   ];
 }
 
 function roleplayCharacterOptionLabel(character) {
-  const favoriteLabel = character?.isFavorite === true ? "[已收藏] " : "";
+  const pinLabel = character?.isPinned === true ? "[置顶]" : "";
+  const favoriteLabel = character?.isFavorite === true ? "[收藏]" : "";
   const deathLabel = character?.isDead ? "（已死亡）" : "";
-  return `${favoriteLabel}${String(character?.name ?? "")}${deathLabel}`;
+  return `${pinLabel}${favoriteLabel}${pinLabel || favoriteLabel ? " " : ""}${String(character?.name ?? "")}${deathLabel}`;
 }
 
 function renderAiRoleplayCharacterSelect() {
@@ -4109,6 +4117,31 @@ function aiPromptTextBeforeCursor() {
   return promptTextFromNode(fragment).replace(/\n$/u, "");
 }
 
+function aiPromptTextFromRange(range, prompt) {
+  const beforeCursor = range.cloneRange();
+  beforeCursor.selectNodeContents(prompt);
+  beforeCursor.setEnd(range.endContainer, range.endOffset);
+  const fragment = document.createElement("div");
+  fragment.append(beforeCursor.cloneContents());
+  return promptTextFromNode(fragment).replace(/\n$/u, "");
+}
+
+function aiPromptTextBoundary(prompt, offset) {
+  const walker = document.createTreeWalker(prompt, NodeFilter.SHOW_TEXT);
+  let remaining = Math.max(0, Number(offset) || 0);
+  let lastTextNode = null;
+  while (walker.nextNode()) {
+    const textNode = walker.currentNode;
+    if (textNode.parentElement?.closest("[data-ai-reference-key]")) continue;
+    lastTextNode = textNode;
+    const length = textNode.textContent?.length ?? 0;
+    if (remaining <= length) return { node: textNode, offset: remaining };
+    remaining -= length;
+  }
+  if (lastTextNode) return { node: lastTextNode, offset: lastTextNode.textContent?.length ?? 0 };
+  return { node: prompt, offset: prompt.childNodes.length };
+}
+
 function hideAiMentionMenu() {
   aiMentionMatch = null;
   aiMentionRange = null;
@@ -4197,12 +4230,14 @@ function selectAiMention(button) {
     id: button.dataset.aiReferenceId,
     name: button.dataset.aiReferenceName
   };
-  const range = aiMentionRange.cloneRange();
-  const textNode = range.startContainer;
-  const localText = textNode.nodeType === Node.TEXT_NODE ? textNode.textContent?.slice(0, range.startOffset) ?? "" : "";
-  const localMention = findAiMention(localText);
+  const cursorText = aiPromptTextFromRange(aiMentionRange, prompt);
+  const localMention = findAiMention(cursorText);
   if (!localMention) return hideAiMentionMenu();
-  range.setStart(textNode, localMention.start);
+  const range = document.createRange();
+  const startBoundary = aiPromptTextBoundary(prompt, localMention.start);
+  const endBoundary = aiPromptTextBoundary(prompt, cursorText.length);
+  range.setStart(startBoundary.node, startBoundary.offset);
+  range.setEnd(endBoundary.node, endBoundary.offset);
   range.deleteContents();
   const spacer = document.createTextNode(" ");
   range.insertNode(spacer);
@@ -4705,6 +4740,7 @@ function uploadWithProgress(path, options = {}, onProgress = () => {}) {
     request.upload.addEventListener("progress", (event) => {
       onProgress(event.lengthComputable && event.total > 0 ? (event.loaded / event.total) * 100 : null);
     });
+    request.upload.addEventListener("load", () => onProgress(100));
     request.addEventListener("error", () => {
       updateSystemHealth({ status: "offline" });
       reject(new Error("网络连接失败"));
@@ -5365,6 +5401,56 @@ function persistentToast(message, type = "info") {
   return () => dismissToastElement(element);
 }
 
+function createImportProgressToast(fileName) {
+  const region = $("#import-progress-region");
+  const element = document.createElement("div");
+  element.className = "toast import-progress-toast";
+  element.setAttribute("role", "status");
+  element.setAttribute("aria-atomic", "true");
+  const copy = document.createElement("div");
+  copy.className = "import-progress-copy";
+  const title = document.createElement("strong");
+  title.textContent = `正在导入“${fileName}”`;
+  const status = document.createElement("span");
+  status.className = "import-progress-status";
+  status.textContent = "正在上传 · 0%";
+  const progress = document.createElement("progress");
+  progress.max = 100;
+  progress.value = 0;
+  progress.setAttribute("aria-label", "书籍导入上传进度");
+  copy.append(title, status);
+  element.append(copy, progress);
+  region.append(element);
+  if (typeof region.showPopover === "function" && !region.matches(":popover-open")) region.showPopover();
+  let closed = false;
+  return {
+    update(uploadProgress) {
+      if (closed) return;
+      if (Number.isFinite(uploadProgress) && uploadProgress >= 100) {
+        progress.removeAttribute("value");
+        status.textContent = "上传完成，正在解析并写入作品…";
+        return;
+      }
+      if (Number.isFinite(uploadProgress)) {
+        const percentage = Math.max(0, Math.min(99, Math.round(uploadProgress)));
+        progress.value = percentage;
+        status.textContent = `正在上传 · ${percentage}%`;
+      } else {
+        progress.removeAttribute("value");
+        status.textContent = "正在上传…";
+      }
+    },
+    close() {
+      if (closed) return;
+      closed = true;
+      element.remove();
+      if (!region.childElementCount && typeof region.hidePopover === "function" && region.matches(":popover-open")) {
+        region.hidePopover();
+      }
+    }
+  };
+}
+
 function restoreToastFocus(previousFocus) {
   if (
     previousFocus instanceof HTMLElement
@@ -8687,6 +8773,18 @@ function characterFavoriteIconMarkup() {
   return '<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="m12 3 2.8 5.7 6.2.9-4.5 4.4 1.1 6.2-5.6-2.9-5.6 2.9 1.1-6.2L3 9.6l6.2-.9L12 3Z"></path></svg>';
 }
 
+function pushPinIconMarkup() {
+  return '<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M16 9V4h1V2H7v2h1v5c0 1.66-1.34 3-3 3v2h5.97v6l1.03 1 1.03-1v-6H20v-2c-2.21 0-4-1.79-4-4Z"></path></svg>';
+}
+
+function characterPinButton(item) {
+  const isPinned = item.isPinned === true;
+  const canPin = canEditModule("characters");
+  const action = isPinned ? "取消置顶" : "置顶";
+  const title = canPin ? action : "当前账户没有角色模块写入权限";
+  return `<button class="character-pin-button${isPinned ? " is-pinned" : ""}" type="button" data-character-pin="${esc(item.id)}" aria-label="${action}角色“${esc(item.name)}”" aria-pressed="${isPinned}" title="${title}" ${canPin ? "" : "disabled"}>${pushPinIconMarkup()}</button>`;
+}
+
 function characterFavoriteButton(item) {
   const isFavorite = item.isFavorite === true;
   const canFavorite = canEditModule("characters");
@@ -8713,6 +8811,17 @@ function recordFavoriteButton(type, item, { cardControl = false } = {}) {
   return `<button class="record-favorite-button${cardControl ? " is-card-control" : ""}${isFavorite ? " is-favorite" : ""}" type="button" data-record-favorite="${esc(item.id)}" data-record-favorite-type="${esc(type)}" aria-label="${action}${config.label}“${esc(name)}”" aria-pressed="${isFavorite}" title="${title}" ${canFavorite ? "" : "disabled"}>${characterFavoriteIconMarkup()}</button>`;
 }
 
+function recordPinButton(type, item, { cardControl = false } = {}) {
+  const config = recordFavoriteConfigs[type];
+  if (!config) return "";
+  const isPinned = item.isPinned === true;
+  const canPin = canEditModule(config.module);
+  const action = isPinned ? "取消置顶" : "置顶";
+  const title = canPin ? action : `当前账户没有${config.label}模块写入权限`;
+  const name = String(item[config.nameField] ?? "");
+  return `<button class="record-pin-button${cardControl ? " is-card-control" : ""}${isPinned ? " is-pinned" : ""}" type="button" data-record-pin="${esc(item.id)}" data-record-pin-type="${esc(type)}" aria-label="${action}${config.label}“${esc(name)}”" aria-pressed="${isPinned}" title="${title}" ${canPin ? "" : "disabled"}>${pushPinIconMarkup()}</button>`;
+}
+
 async function toggleRecordFavorite(type, item, render) {
   const config = recordFavoriteConfigs[type];
   if (!config) return;
@@ -8729,6 +8838,22 @@ async function toggleRecordFavorite(type, item, render) {
   toast(updated.isFavorite ? `已收藏${config.label}“${name}”` : `已取消收藏${config.label}“${name}”`);
 }
 
+async function toggleRecordPin(type, item, render) {
+  const config = recordFavoriteConfigs[type];
+  if (!config) return;
+  const updated = await api(`/api/${config.resource}/${encodeURIComponent(item.id)}/pin`, {
+    method: "PATCH",
+    body: { isPinned: item.isPinned !== true }
+  });
+  await render();
+  const pinButton = [...$("#module-content").querySelectorAll("[data-record-pin]")].find((button) => (
+    button.dataset.recordPinType === type && button.dataset.recordPin === String(updated.id)
+  ));
+  pinButton?.focus({ preventScroll: true });
+  const name = String(updated[config.nameField] ?? "");
+  toast(updated.isPinned ? `已置顶${config.label}“${name}”` : `已取消置顶${config.label}“${name}”`);
+}
+
 function bindRecordFavoriteButtons(type, items, render) {
   const config = recordFavoriteConfigs[type];
   if (!config) return;
@@ -8745,6 +8870,22 @@ function bindRecordFavoriteButtons(type, items, render) {
   }));
 }
 
+function bindRecordPinButtons(type, items, render) {
+  const config = recordFavoriteConfigs[type];
+  if (!config) return;
+  $("#module-content").querySelectorAll(`[data-record-pin-type="${type}"]`).forEach((button) => button.addEventListener("click", async () => {
+    const item = items.find((candidate) => candidate.id === button.dataset.recordPin);
+    if (!item || !canEditModule(config.module)) return;
+    button.disabled = true;
+    try {
+      await toggleRecordPin(type, item, render);
+    } catch (error) {
+      button.disabled = false;
+      toast(`${config.label}置顶状态更新失败：${error.message}`, "error");
+    }
+  }));
+}
+
 function syncEntityDetailFavoriteButton(button, type, item) {
   const config = recordFavoriteConfigs[type];
   const visible = Boolean(config && item);
@@ -8769,6 +8910,30 @@ function syncEntityDetailFavoriteButton(button, type, item) {
   button.disabled = !canFavorite;
 }
 
+function syncEntityDetailPinButton(button, type, item) {
+  const config = recordFavoriteConfigs[type];
+  const visible = Boolean(config && item);
+  button.classList.toggle("hidden", !visible);
+  button.innerHTML = pushPinIconMarkup();
+  if (!visible) {
+    button.disabled = true;
+    button.classList.remove("is-pinned");
+    button.setAttribute("aria-pressed", "false");
+    button.removeAttribute("aria-label");
+    button.removeAttribute("title");
+    return;
+  }
+  const isPinned = item.isPinned === true;
+  const canPin = canEditModule(config.module);
+  const action = isPinned ? "取消置顶" : "置顶";
+  const name = String(item[config.nameField] ?? "");
+  button.classList.toggle("is-pinned", isPinned);
+  button.setAttribute("aria-pressed", String(isPinned));
+  button.setAttribute("aria-label", `${action}${config.label}“${name}”`);
+  button.title = canPin ? action : `当前账户没有${config.label}模块写入权限`;
+  button.disabled = !canPin;
+}
+
 function bindEntityDetailFavoriteButton(button, type, getItem, onUpdated) {
   syncEntityDetailFavoriteButton(button, type, getItem());
   button.onclick = async () => {
@@ -8793,6 +8958,30 @@ function bindEntityDetailFavoriteButton(button, type, getItem, onUpdated) {
   };
 }
 
+function bindEntityDetailPinButton(button, type, getItem, onUpdated) {
+  syncEntityDetailPinButton(button, type, getItem());
+  button.onclick = async () => {
+    const config = recordFavoriteConfigs[type];
+    const item = getItem();
+    if (!config || !item || !canEditModule(config.module)) return;
+    button.disabled = true;
+    try {
+      const updated = await api(`/api/${config.resource}/${encodeURIComponent(item.id)}/pin`, {
+        method: "PATCH",
+        body: { isPinned: item.isPinned !== true }
+      });
+      onUpdated(updated);
+      syncEntityDetailPinButton(button, type, getItem() ?? updated);
+      button.focus({ preventScroll: true });
+      const name = String(updated[config.nameField] ?? "");
+      toast(updated.isPinned ? `已置顶${config.label}“${name}”` : `已取消置顶${config.label}“${name}”`);
+    } catch (error) {
+      syncEntityDetailPinButton(button, type, getItem());
+      toast(`${config.label}置顶状态更新失败：${error instanceof Error ? error.message : "未知错误"}`, "error");
+    }
+  };
+}
+
 function recordCardEditButton(attribute, id, label) {
   return `<button class="record-card-edit" type="button" data-${attribute}="${esc(id)}" aria-label="编辑${esc(label)}" title="编辑">${pencilIconMarkup()}</button>`;
 }
@@ -9131,7 +9320,7 @@ function settingRecordActions(item) {
   const recordAction = canEditModule("settings")
     ? recordCardEditButton("edit-setting", item.id, `设定“${item.title}”`)
     : recordHistoryButton("setting", item.id, item.title);
-  return `${recordFavoriteButton("setting", item)}${recordAction}`;
+  return `${recordPinButton("setting", item)}${recordFavoriteButton("setting", item)}${recordAction}`;
 }
 
 function draftTypeLabel(draftType) {
@@ -9245,7 +9434,11 @@ function openDraftDialog(item = null, { readOnly = false } = {}) {
   }
   if (item && viewOnly) {
     const headerActions = $("#dialog-context-actions");
-    headerActions.innerHTML = `<button id="draft-dialog-favorite" class="entity-detail-favorite-button" type="button" aria-pressed="false"></button>${canEditModule("drafts") ? '<button id="draft-dialog-edit" class="ghost-button" type="button">编辑想法</button>' : ""}`;
+    headerActions.innerHTML = `<button id="draft-dialog-pin" class="entity-detail-pin-button hidden" type="button" aria-pressed="false"></button><button id="draft-dialog-favorite" class="entity-detail-favorite-button" type="button" aria-pressed="false"></button>${canEditModule("drafts") ? '<button id="draft-dialog-edit" class="ghost-button" type="button">编辑想法</button>' : ""}`;
+    bindEntityDetailPinButton($("#draft-dialog-pin"), "draft", () => draftDialogItem, (updated) => {
+      draftDialogItem = updated;
+      void renderDrafts(moduleListPages.drafts).catch((error) => toast(`想法列表刷新失败：${error instanceof Error ? error.message : "未知错误"}`, "error"));
+    });
     bindEntityDetailFavoriteButton($("#draft-dialog-favorite"), "draft", () => draftDialogItem, (updated) => {
       draftDialogItem = updated;
       void renderDrafts(moduleListPages.drafts).catch((error) => toast(`想法列表刷新失败：${error instanceof Error ? error.message : "未知错误"}`, "error"));
@@ -9288,7 +9481,7 @@ async function renderDrafts(page = moduleListPages.drafts) {
     <details class="character-filter-dropdown"><summary><span>按绑定位置筛选</span><strong>${selectedBindingKeys.size ? `已选 ${selectedBindingKeys.size} 项` : "全部位置"}</strong></summary><div id="draft-binding-filter" class="character-filter-options">${bindingOptions.map(([value, label]) => `<label class="character-filter-option"><input type="checkbox" value="${esc(value)}" ${selectedBindingKeys.has(value) ? "checked" : ""}><span>${esc(label)}</span></label>`).join("")}</div></details>
     <div class="character-filter-toolbar-actions">${hasDraftFilters ? `<span class="character-filter-result-count" aria-live="polite">筛选后剩余 ${drafts.length} 条想法</span>` : ""}<button id="clear-draft-filters" class="ghost-button" type="button" ${hasDraftFilters ? "" : "disabled"}>重置筛选</button></div>
   </section>`;
-  const actions = (item) => `${recordFavoriteButton("draft", item)}${canEditModule("drafts")
+  const actions = (item) => `${recordPinButton("draft", item)}${recordFavoriteButton("draft", item)}${canEditModule("drafts")
     ? `${recordCardEditButton("edit-draft", item.id, `想法“${item.title}”`)}${recordHistoryButton("draft", item.id, item.title)}`
     : recordHistoryButton("draft", item.id, item.title)}`;
   const cards = `<div class="card-grid">${pageResult.items.map((item) => `
@@ -9350,6 +9543,10 @@ async function renderDrafts(page = moduleListPages.drafts) {
     moduleListPages.drafts = 1;
     await renderDrafts(1);
   });
+  bindRecordPinButtons("draft", pageResult.items, async () => {
+    moduleListPages.drafts = 1;
+    await renderDrafts(1);
+  });
   bindEntityHistoryButtons(() => renderDrafts(pageResult.page));
 }
 
@@ -9417,6 +9614,10 @@ async function renderSettings(page = moduleListPages.settings) {
       moduleListPages.settings = 1;
       await renderSettings(1);
     });
+    bindRecordPinButtons("setting", pageResult.items, async () => {
+      moduleListPages.settings = 1;
+      await renderSettings(1);
+    });
     bindEntityHistoryButtons(async () => { await renderSettings(pageResult.page); await loadAiReferences(); });
   };
 
@@ -9468,6 +9669,21 @@ async function toggleCharacterFavorite(item) {
   toast(updated.isFavorite ? `已收藏角色“${updated.name}”` : `已取消收藏角色“${updated.name}”`);
 }
 
+async function toggleCharacterPin(item) {
+  const updated = await api(`/api/characters/${encodeURIComponent(item.id)}/pin`, {
+    method: "PATCH",
+    body: { isPinned: item.isPinned !== true }
+  });
+  if (loadedAiReferencesWorkId === state.work?.id) {
+    state.characters = upsertEntityCollection(state.characters, updated);
+    renderAiRoleplayCharacterSelect();
+  }
+  characterListPage = 1;
+  await renderCharacters(1);
+  $("#module-content").querySelector(`[data-character-pin="${CSS.escape(String(updated.id))}"]`)?.focus({ preventScroll: true });
+  toast(updated.isPinned ? `已置顶角色“${updated.name}”` : `已取消置顶角色“${updated.name}”`);
+}
+
 async function renderCharacters(page = characterListPage) {
   const hasCharacterFilters = characterFilters.raceIds.length > 0
     || characterFilters.organizationIds.length > 0
@@ -9490,14 +9706,14 @@ async function renderCharacters(page = characterListPage) {
   [state.races, state.organizations] = [races, organizations];
   mountModuleCount(characterPage.total);
   const layout = readModuleLayout();
-  const characterActions = (item) => `${characterFavoriteButton(item)}${recordCardEditButton("edit-character", item.id, `角色“${item.name}”`)}`;
+  const characterActions = (item) => `${characterPinButton(item)}${characterFavoriteButton(item)}${recordCardEditButton("edit-character", item.id, `角色“${item.name}”`)}`;
   const characterLockBadge = (item) => item.lockedFields.length
     ? `<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);
     return `
-    <article class="record-card character-card preview-record-card has-card-edit" data-open-character="${esc(item.id)}" role="button" tabindex="0" aria-label="查看角色 ${esc(item.name)}">${characterFavoriteButton(item)}${recordCardEditButton("edit-character", item.id, `角色“${item.name}”`)}
+    <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>` : ""}
     <div class="character-gender"><b>性别</b><span class="pill">${esc(characterGenderLabel(item.gender))}</span></div>
@@ -9574,6 +9790,17 @@ async function renderCharacters(page = characterListPage) {
       toast(`角色收藏状态更新失败：${error.message}`, "error");
     }
   }));
+  $("#module-content").querySelectorAll("[data-character-pin]").forEach((button) => button.addEventListener("click", async () => {
+    const item = pageCharacters.find((candidate) => candidate.id === button.dataset.characterPin);
+    if (!item || !canEditModule("characters")) return;
+    button.disabled = true;
+    try {
+      await toggleCharacterPin(item);
+    } catch (error) {
+      button.disabled = false;
+      toast(`角色置顶状态更新失败：${error.message}`, "error");
+    }
+  }));
   const readSelectedValues = (selector) => [...$(selector).querySelectorAll('input[type="checkbox"]:checked')].map((input) => input.value);
   $("#character-race-filter").addEventListener("change", async () => {
     characterFiltersPanelOpen = true;
@@ -9728,14 +9955,14 @@ async function renderOrganizations(page = moduleListPages.organizations) {
   moduleListPages.organizations = pageResult.page;
   const layout = readModuleLayout();
   const canEditOrganizations = canEditModule("organizations");
-  const organizationActions = (item, { cardControl = false } = {}) => `${recordFavoriteButton("organization", item, { cardControl })}${canEditOrganizations
+  const organizationActions = (item, { cardControl = false } = {}) => `${recordPinButton("organization", item, { cardControl })}${recordFavoriteButton("organization", item, { cardControl })}${canEditOrganizations
     ? recordCardEditButton("edit-organization", item.id, `组织“${item.name}”`)
     : recordHistoryButton("organization", item.id, item.name)}`;
   const organizationCardActions = (item) => canEditOrganizations
     ? organizationActions(item, { cardControl: true })
     : `<div class="card-actions">${organizationActions(item)}</div>`;
   const organizationCards = () => `<div class="card-grid organization-grid">${pageResult.items.map((item) => `
-    <article class="record-card organization-card preview-record-card${canEditOrganizations ? " has-card-edit has-favorite-control" : ""}" data-open-organization="${esc(item.id)}" role="button" tabindex="0" aria-label="查看组织 ${esc(item.name)}"><small>${item.memberIds.length} 位成员 · ${(item.settingsCount ?? item.settings?.length ?? 0) ? "已填写组织设定" : "暂无组织设定"}</small>
+    <article class="record-card organization-card preview-record-card${canEditOrganizations ? " has-card-edit has-favorite-control has-pin-control" : ""}" data-open-organization="${esc(item.id)}" role="button" tabindex="0" aria-label="查看组织 ${esc(item.name)}"><small>${item.memberIds.length} 位成员 · ${(item.settingsCount ?? item.settings?.length ?? 0) ? "已填写组织设定" : "暂无组织设定"}</small>
       <h3>${esc(item.name)}${entityLifecycleBadge(item.isDissolved, "已解散")}</h3><p>${esc(item.description || "尚未填写组织简介")}</p>
       <div class="organization-settings">${item.settingsCount ? `<span class="pill">${item.settingsCount} 条组织设定，打开查看详情</span>` : '<span class="pill">暂无组织设定</span>'}</div>
       <p class="organization-members">成员：${item.members.length ? item.members.map((member) => esc(member.name)).join("、") : "暂无绑定角色"}</p>
@@ -9764,6 +9991,10 @@ async function renderOrganizations(page = moduleListPages.organizations) {
     moduleListPages.organizations = 1;
     await renderOrganizations(1);
   });
+  bindRecordPinButtons("organization", pageResult.items, async () => {
+    moduleListPages.organizations = 1;
+    await renderOrganizations(1);
+  });
   bindEntityHistoryButtons(async () => { await renderOrganizations(pageResult.page); await loadAiReferences(); });
 }
 
@@ -13476,6 +13707,10 @@ function openSettingEditor(item = null, { readOnly = false } = {}) {
   const editButton = $("#setting-editor-edit");
   editButton.classList.toggle("hidden", !readOnly || !canEditModule("settings"));
   editButton.onclick = () => openSettingEditor(settingEditorItem);
+  bindEntityDetailPinButton($("#setting-editor-pin"), "setting", () => viewOnly ? settingEditorItem : null, (updated) => {
+    settingEditorItem = updated;
+    state.settings = upsertEntityCollection(state.settings, updated);
+  });
   bindEntityDetailFavoriteButton($("#setting-editor-favorite"), "setting", () => viewOnly ? settingEditorItem : null, (updated) => {
     settingEditorItem = updated;
     state.settings = upsertEntityCollection(state.settings, updated);
@@ -14712,6 +14947,13 @@ async function openCharacterEditor(item = null, { readOnly = false } = {}) {
   const editButton = $("#character-editor-edit");
   editButton.classList.toggle("hidden", !readOnly || !canEditModule("characters"));
   editButton.onclick = () => void openCharacterEditor(characterEditorItem);
+  bindEntityDetailPinButton($("#character-editor-pin"), "character", () => viewOnly ? characterEditorItem : null, (updated) => {
+    characterEditorItem = updated;
+    if (loadedAiReferencesWorkId === state.work?.id) {
+      state.characters = upsertEntityCollection(state.characters, updated);
+      renderAiRoleplayCharacterSelect();
+    }
+  });
   bindEntityDetailFavoriteButton($("#character-editor-favorite"), "character", () => viewOnly ? characterEditorItem : null, (updated) => {
     characterEditorItem = updated;
     if (loadedAiReferencesWorkId === state.work?.id) {
@@ -14905,6 +15147,10 @@ async function openKnowledgeEditor(kind, item, { readOnly = false } = {}) {
   editButton.textContent = `编辑${label}`;
   editButton.classList.toggle("hidden", !readOnly || !canEditModule(module));
   editButton.onclick = () => void openKnowledgeEditor(kind, knowledgeEditorItem);
+  bindEntityDetailPinButton($("#knowledge-editor-pin"), "organization", () => !isRace && viewOnly ? knowledgeEditorItem : null, (updated) => {
+    knowledgeEditorItem = updated;
+    state.organizations = upsertEntityCollection(state.organizations, updated);
+  });
   bindEntityDetailFavoriteButton($("#knowledge-editor-favorite"), "organization", () => !isRace && viewOnly ? knowledgeEditorItem : null, (updated) => {
     knowledgeEditorItem = updated;
     state.organizations = upsertEntityCollection(state.organizations, updated);
@@ -18663,15 +18909,22 @@ $("#import-file").addEventListener("change", async (event) => {
   body.append("file", file);
   body.append("mode", mode);
   body.append("expectedVersionNo", String(state.work.versionNo));
+  const importProgress = createImportProgressToast(file.name);
   try {
-    const result = await api(`/api/works/${state.work.id}/import`, { method: "POST", body });
+    const result = await uploadWithProgress(
+      `/api/works/${state.work.id}/import`,
+      { method: "POST", body },
+      (progress) => importProgress.update(progress)
+    );
     setSaveState(mode === "append" ? "已追加" : "已覆盖");
     state.work = result.tree;
     renderTree();
     const completion = mode === "append" ? "正文追加完成" : "正文覆盖完成";
-    toast(result.warnings.length ? `${completion}：${result.warnings.join("；")}` : completion);
     if (result.firstImportedChapterId) await selectChapter(result.firstImportedChapterId);
+    importProgress.close();
+    toast(result.warnings.length ? `${completion}：${result.warnings.join("；")}` : completion);
   } catch (error) {
+    importProgress.close();
     toast(error.message, "error");
     if (state.dirty) scheduleChapterAutoSave();
   }
@@ -18686,11 +18939,18 @@ $("#new-import-file").addEventListener("change", async (event) => {
   body.append("title", metadata.title ?? "");
   body.append("author", metadata.author ?? "");
   body.append("description", metadata.description ?? "");
+  const importProgress = createImportProgressToast(file.name);
   try {
-    const result = await api("/api/works/import", { method: "POST", body });
-    toast(result.warnings.length ? `作品已导入：${result.warnings.join("；")}` : "作品已导入");
+    const result = await uploadWithProgress(
+      "/api/works/import",
+      { method: "POST", body },
+      (progress) => importProgress.update(progress)
+    );
     await loadWorks(result.work.id);
+    importProgress.close();
+    toast(result.warnings.length ? `作品已导入：${result.warnings.join("；")}` : "作品已导入");
   } catch (error) {
+    importProgress.close();
     toast(error.message, "error");
   } finally {
     state.pendingImportMeta = null;

package/dist/public/index.html

@@ -10,7 +10,7 @@
     <link rel="icon" href="/icon.svg?v=20260712" type="image/svg+xml">
     <link rel="manifest" href="/site.webmanifest">
     <link rel="stylesheet" href="/vendor/vditor/dist/index.css?v=3.11.2">
-    <link rel="stylesheet" href="/styles.css?v=20260816-task-scope-volume-collapse-v2&feature=ai-tool-call-copy-feedback-v2&feature=ai-send-control-v3&feature=character-gender-v1&feature=character-filter-state-v1&feature=relationship-canvas-scale-v1&feature=relationship-table-scroll-v1&feature=galaxy-compact-controls-v2&feature=galaxy-motion-mode-v2&feature=chapter-search-replace-v3&feature=task-auto-run-ring-center-v3&feature=character-relationship-delete-v1&feature=ai-assistant-workspace-v2&feature=mobile-module-tab-position-v1&feature=volume-detail-icon-v1&feature=editor-actions-flow-v1&feature=reader-controls-subpanel-v1&feature=reader-focus-ring-v1&feature=ai-message-actions-v1&feature=assistant-responsive-navigation-v2&feature=ai-composer-square-controls-v2&feature=annotation-line-counts-v1&feature=line-number-gutter-fill-v1&feature=ai-relationship-roleplay-v1&feature=ai-model-picker-v1&feature=markdown-word-count-five-digit-v2&feature=ai-stream-character-count-stable-v1&feature=annotation-marker-offset-v1&feature=mobile-ai-entry-hidden-v1&feature=phone-client-entry-v1&feature=ai-stream-idle-timeout-v1&feature=ai-user-message-width-v2&feature=ai-chat-image-attachments-v9&feature=ai-message-image-preview-v1&feature=ai-thinking-scroll-v2&feature=toast-click-dismiss-v3&feature=character-avatar-v6&feature=admin-ai-conversations-v1&feature=ai-usage-pricing-v1&feature=ai-usage-pricing-badge-v2&feature=ai-token-quota-positive-v5&feature=ai-token-usage-details-v1&feature=ai-token-usage-details-centered-v1&feature=ai-stream-connection-seconds-v1&feature=ai-token-usage-estimated-price-v1&feature=record-favorites-v1&feature=entity-detail-favorites-v1&feature=character-persona-summary-v1&feature=ai-roleplay-scene-turn-v1&feature=admin-account-identity-v2&feature=task-detail-failure-orange-v1">
+    <link rel="stylesheet" href="/styles.css?v=20260816-task-scope-volume-collapse-v2&feature=ai-tool-call-copy-feedback-v2&feature=ai-send-control-v3&feature=character-gender-v1&feature=character-filter-state-v1&feature=relationship-canvas-scale-v1&feature=relationship-table-scroll-v1&feature=galaxy-compact-controls-v2&feature=galaxy-motion-mode-v2&feature=chapter-search-replace-v3&feature=task-auto-run-ring-center-v3&feature=character-relationship-delete-v1&feature=ai-assistant-workspace-v2&feature=mobile-module-tab-position-v1&feature=volume-detail-icon-v1&feature=editor-actions-flow-v1&feature=reader-controls-subpanel-v1&feature=reader-focus-ring-v1&feature=ai-message-actions-v1&feature=assistant-responsive-navigation-v2&feature=ai-composer-square-controls-v2&feature=annotation-line-counts-v1&feature=line-number-gutter-fill-v1&feature=ai-relationship-roleplay-v1&feature=ai-model-picker-v1&feature=markdown-word-count-five-digit-v2&feature=ai-stream-character-count-stable-v1&feature=annotation-marker-offset-v1&feature=mobile-ai-entry-hidden-v1&feature=phone-client-entry-v1&feature=ai-stream-idle-timeout-v1&feature=ai-user-message-width-v2&feature=ai-chat-image-attachments-v9&feature=ai-message-image-preview-v1&feature=ai-thinking-scroll-v2&feature=toast-click-dismiss-v3&feature=character-avatar-v6&feature=admin-ai-conversations-v1&feature=ai-usage-pricing-v1&feature=ai-usage-pricing-badge-v2&feature=ai-token-quota-positive-v5&feature=ai-token-usage-details-v1&feature=ai-token-usage-details-centered-v1&feature=ai-stream-connection-seconds-v1&feature=ai-token-usage-estimated-price-v1&feature=record-favorites-v1&feature=entity-detail-favorites-v1&feature=entity-pin-v1&feature=character-persona-summary-v1&feature=ai-roleplay-scene-turn-v1&feature=admin-account-identity-v2&feature=task-detail-failure-orange-v1&feature=character-card-header-alignment-v6&feature=character-card-title-fit-v2&feature=book-import-progress-v1">
   </head>
   <body class="auth-pending">
     <section id="auth-view" class="auth-view hidden" aria-labelledby="auth-title">
@@ -476,6 +476,7 @@
     </section>
 
     <div id="toast-region" class="toast-region" data-position="bottom-right" aria-live="polite" popover="manual"></div>
+    <div id="import-progress-region" class="toast-region import-progress-region" data-position="bottom-right" aria-live="polite" popover="manual"></div>
     <div id="chapter-type-menu" class="chapter-type-menu hidden" role="menu" aria-label="章节操作" data-testid="chapter-type-menu">
       <strong>标记章节</strong>
       <div>
@@ -658,6 +659,7 @@
             </div>
           </div>
           <div class="entity-editor-mode-actions">
+            <button id="setting-editor-pin" class="entity-detail-pin-button hidden" type="button" aria-pressed="false"></button>
             <button id="setting-editor-favorite" class="entity-detail-favorite-button hidden" type="button" aria-pressed="false"></button>
             <button id="setting-editor-edit" class="ghost-button hidden" type="button">编辑设定</button>
             <button id="setting-editor-confirm" class="ghost-button hidden" type="button">确认候选</button>
@@ -685,6 +687,7 @@
             <div class="character-editor-title-row"><h1 id="character-editor-title">新建角色</h1><span id="character-editor-version" class="character-version-badge">新档案</span><span id="character-editor-readonly-badge" class="entity-editor-readonly-badge hidden">只读模式</span></div>
           </div>
           <div class="character-editor-header-actions">
+            <button id="character-editor-pin" class="entity-detail-pin-button hidden" type="button" aria-pressed="false"></button>
             <button id="character-editor-favorite" class="entity-detail-favorite-button hidden" type="button" aria-pressed="false"></button>
             <button id="character-editor-edit" class="primary-button hidden" type="button">编辑角色</button>
             <button id="character-history-button" class="ghost-button" type="button" aria-controls="character-history-panel" aria-expanded="false">版本历史</button>
@@ -721,6 +724,7 @@
           </div>
           <div class="character-editor-header-actions">
             <span id="knowledge-editor-header-note" class="knowledge-editor-header-note">独立资料页</span>
+            <button id="knowledge-editor-pin" class="entity-detail-pin-button hidden" type="button" aria-pressed="false"></button>
             <button id="knowledge-editor-favorite" class="entity-detail-favorite-button hidden" type="button" aria-pressed="false"></button>
             <button id="knowledge-editor-edit" class="primary-button hidden" type="button">编辑档案</button>
             <button id="knowledge-editor-history" class="ghost-button hidden" type="button">版本历史</button>
@@ -1258,6 +1262,6 @@
     <div id="auth-loading" class="auth-loading" role="status" aria-label="正在载入工作台"></div>
     <script id="vditorIconScript" src="/vendor/vditor/dist/js/icons/ant.js?v=3.11.2"></script>
     <script src="/vendor/vditor/dist/index.min.js?v=3.11.2"></script>
-    <script type="module" src="/app.js?v=20260816-extended-thinking-effort-v1&feature=ai-tool-call-copy-feedback-v2&feature=ai-send-control-v2&feature=analysis-task-queue-refresh-v1&feature=character-gender-v1&feature=character-filter-state-v1&feature=relationship-canvas-scale-v1&feature=relationship-table-scroll-v1&feature=ai-session-id-copy-v2&feature=galaxy-motion-mode-v3&feature=galaxy-edge-label-threshold-v1&feature=calculate-time-tool-v2&feature=analysis-task-expired-toast-v1&feature=global-replace-volume-v1&feature=chapter-search-replace-v1&feature=chapter-save-toast-v1&feature=character-relationship-delete-v1&feature=character-relationship-group-v1&feature=analysis-task-stability-delay-v1&feature=ai-assistant-workspace-v2&feature=volume-detail-icon-v1&feature=volume-story-order-v1&feature=reader-manual-chapter-navigation-v1&feature=ai-message-reference-badges-v1&feature=ai-message-actions-v1&feature=assistant-responsive-navigation-v3&feature=annotation-permissions-v1&feature=annotation-line-counts-v1&feature=ai-relationship-roleplay-v1&feature=ai-roleplay-user-character-visibility-v1&feature=ai-roleplay-story-recall-v1&feature=ai-model-picker-v1&feature=ai-fork-model-unlock-v1&feature=context-percent-format-v1&feature=annotation-precise-locate-v1&feature=markdown-word-count-stable-v1&feature=ai-stream-character-count-stable-v2&feature=ai-process-empty-intermediate-v1&feature=ai-feed-scroll-follow-v1&feature=ai-message-retry-v1&feature=ai-stream-idle-timeout-v2&feature=ai-config-delete-v1&feature=ai-provider-protocol-options-v1&feature=ai-provider-thinking-type-v1&feature=ai-chat-image-attachments-v8&feature=ai-message-image-preview-v1&feature=ai-thinking-scroll-v2&feature=ai-image-conversation-model-lock-v1&feature=toast-click-dismiss-v2&feature=system-restart-dialog-delay-v1&feature=character-avatar-v6&feature=character-death-position-v1&feature=admin-ai-conversations-v1&feature=ai-usage-pricing-v1&feature=ai-usage-pricing-badge-v2&feature=ai-usage-pricing-label-v1&feature=ai-usage-token-breakdown-v1&feature=ai-usage-pricing-cache-v2&feature=ai-usage-pricing-manual-refresh-v1&feature=ai-monthly-token-quota-v1&feature=ai-provider-token-quota-v1&feature=ai-token-quota-positive-v6&feature=ai-model-thinking-label-v1&feature=ai-model-picker-focus-v1&feature=ai-provider-model-import-v1&feature=ai-assistant-brain-icon-v1&feature=ai-token-usage-details-v1&feature=ai-token-usage-details-centered-v1&feature=ai-token-usage-raw-input-v1&feature=ai-stream-connection-seconds-v1&feature=phone-client-entry-v1&feature=ai-usage-pricing-cache-v1&feature=ai-model-thinking-label-v3&feature=ai-roleplay-speaker-label-v1&feature=toast-modal-host-v1&feature=api-key-copy-existing-v1&feature=character-favorite-v1&feature=record-favorites-v1&feature=ai-token-usage-estimated-price-v1&feature=entity-detail-favorites-v1&feature=roleplay-favorite-label-v1&feature=ai-roleplay-knowledge-tools-v1&feature=character-persona-summary-v1&feature=ai-roleplay-scene-turn-v2&feature=admin-account-identity-v2&feature=ai-provider-analysis-timeout-v1&feature=task-detail-failure-orange-v1"></script>
+    <script type="module" src="/app.js?v=20260816-extended-thinking-effort-v1&feature=ai-tool-call-copy-feedback-v2&feature=ai-send-control-v2&feature=analysis-task-queue-refresh-v1&feature=character-gender-v1&feature=character-filter-state-v1&feature=relationship-canvas-scale-v1&feature=relationship-table-scroll-v1&feature=ai-session-id-copy-v2&feature=galaxy-motion-mode-v3&feature=galaxy-edge-label-threshold-v1&feature=calculate-time-tool-v2&feature=analysis-task-expired-toast-v1&feature=global-replace-volume-v1&feature=chapter-search-replace-v1&feature=chapter-save-toast-v1&feature=character-relationship-delete-v1&feature=character-relationship-group-v1&feature=analysis-task-stability-delay-v1&feature=ai-assistant-workspace-v2&feature=volume-detail-icon-v1&feature=volume-story-order-v1&feature=reader-manual-chapter-navigation-v1&feature=ai-message-reference-badges-v1&feature=ai-roleplay-message-reference-v1&feature=ai-message-actions-v1&feature=assistant-responsive-navigation-v3&feature=annotation-permissions-v1&feature=annotation-line-counts-v1&feature=ai-relationship-roleplay-v1&feature=ai-roleplay-user-character-visibility-v1&feature=ai-roleplay-story-recall-v1&feature=ai-model-picker-v1&feature=ai-fork-model-unlock-v1&feature=context-percent-format-v1&feature=annotation-precise-locate-v1&feature=markdown-word-count-stable-v1&feature=ai-stream-character-count-stable-v2&feature=ai-process-empty-intermediate-v1&feature=ai-feed-scroll-follow-v1&feature=ai-message-retry-v1&feature=ai-stream-idle-timeout-v2&feature=ai-config-delete-v1&feature=ai-provider-protocol-options-v1&feature=ai-provider-thinking-type-v1&feature=ai-chat-image-attachments-v8&feature=ai-message-image-preview-v1&feature=ai-thinking-scroll-v2&feature=ai-image-conversation-model-lock-v1&feature=toast-click-dismiss-v2&feature=system-restart-dialog-delay-v1&feature=character-avatar-v6&feature=character-death-position-v1&feature=admin-ai-conversations-v1&feature=ai-usage-pricing-v1&feature=ai-usage-pricing-badge-v2&feature=ai-usage-pricing-label-v1&feature=ai-usage-token-breakdown-v1&feature=ai-usage-pricing-cache-v2&feature=ai-usage-pricing-manual-refresh-v1&feature=ai-monthly-token-quota-v1&feature=ai-provider-token-quota-v1&feature=ai-token-quota-positive-v6&feature=ai-model-thinking-label-v1&feature=ai-model-picker-focus-v1&feature=ai-provider-model-import-v1&feature=ai-assistant-brain-icon-v1&feature=ai-token-usage-details-v1&feature=ai-token-usage-details-centered-v1&feature=ai-token-usage-raw-input-v1&feature=ai-stream-connection-seconds-v1&feature=phone-client-entry-v1&feature=ai-usage-pricing-cache-v1&feature=ai-model-thinking-label-v3&feature=ai-roleplay-speaker-label-v1&feature=toast-modal-host-v1&feature=api-key-copy-existing-v1&feature=character-favorite-v1&feature=record-favorites-v1&feature=ai-token-usage-estimated-price-v1&feature=entity-detail-favorites-v1&feature=entity-pin-v1&feature=entity-pin-icon-v1&feature=roleplay-favorite-label-v1&feature=ai-roleplay-knowledge-tools-v1&feature=character-persona-summary-v1&feature=ai-roleplay-scene-turn-v2&feature=admin-account-identity-v2&feature=ai-provider-analysis-timeout-v1&feature=task-detail-failure-orange-v1&feature=book-import-progress-v1&feature=presence-multiple-users-v1"></script>
   </body>
 </html>