@musnows/scriverse 0.4.10 → 0.4.12

package/dist/public/app.js

@@ -1,4 +1,4 @@
-import { buildRelationshipGraph, createGalaxyRenderer, renderRelationshipMindMap } from "/relationship-graph.js?v=20260725-galaxy-ripple";
+import { buildRelationshipGraph, createGalaxyRenderer, renderRelationshipMindMap } from "/relationship-graph.js?v=20260726-network-theme-palette";
 import { collapseExcessBlankLines, formatDateTime, normalizeParagraphSpacing } from "/text-formatting.js?v=20260713-saved-at-seconds";
 import { renderMarkdown } from "/markdown.js?v=20260725-ordered-list";
 import { buildAiReferenceScope, findAiMention, listAiMentionOptions } from "/ai-mentions.js?v=20260716-chapter-references";
@@ -6,7 +6,7 @@ import { shouldShowAiQuickActions } from "/ai-conversation.js?v=20260713-quick-a
 import { calculateLineNumberRowHeight, calculateLineNumberRowTop, calculateLineNumberTextOffset, calculateLineNumberTop } from "/line-number-layout.js?v=20260713-row-box-alignment";
 import { MODEL_PURPOSE_OPTIONS, isKimiModelId, modelFormValues, modelOptionLabel, modelPayload } from "/model-config.js?v=20260723-kimi-temperature";
 import { shouldSendAiPrompt } from "/ai-prompt-keyboard.js?v=20260713-enter-to-send";
-import { estimateAiMessageTokens, formatAiMessageMeta } from "/ai-message-meta.js?v=20260713-persisted-output-tokens";
+import { estimateAiMessageTokens, formatAiMessageMeta } from "/ai-message-meta.js?v=20260726-cache-hit-percent";
 import { formatAiMessageTime } from "/ai-message-time.js?v=20260713-cross-day-time";
 import { formatAiContextUsageTooltip } from "/ai-context-meter.js?v=20260718-layered-context";
 import { copyAiRawMarkdown } from "/ai-message-actions.js?v=20260713-copy-raw-markdown";
@@ -35,7 +35,7 @@ import {
 import { parsePageRoute, serializePageRoute } from "/page-route.js?v=20260723-knowledge-editor-page";
 import { splitRelationshipKeywordInput, splitRelationshipKeywords, uniqueRelationshipKeywords } from "/relationship-keywords.js?v=20260720-relationship-keyword-chips";
 import { tokenizeVisibleSpaces } from "/whitespace-visualization.js?v=20260718-visible-whitespace";
-import { buildRaceForest, eligibleRaceParents, racePathLabel } from "/race-hierarchy.js?v=20260721-race-hierarchy";
+import { buildRaceForest, eligibleRaceParents, orderRaceFilterOptions, racePathLabel } from "/race-hierarchy.js?v=20260726-race-filter-order";
 import { ANALYSIS_TYPES, analysisTypeDescription } from "/analysis-types.js?v=20260721-analysis-descriptions";
 import { WORK_PERMISSION_MODULES, canReadPermissionModule, canReadUiModule, canWritePermissionModule, canWriteUiModule, emptyModulePermissions, firstReadableUiModule, normalizeModulePermissions, permissionSummary } from "/work-permissions.js?v=20260724-outline-title";
 import { MODULE_LAYOUT_STORAGE_KEY, LEGACY_SETTINGS_LAYOUT_STORAGE_KEY, normalizeModuleLayout } from "/module-layout.js?v=20260723-module-layout-toggle";
@@ -104,6 +104,8 @@ let peerPageStale = false;
 let collaborationAutoSaveDisabled = false;
 
 let timelineMultiSelectEnabled = false;
+let taskProgressRefreshTimer = null;
+const taskProgressRefreshInterval = 2_500;
 
 const chapterTypes = ["正文", "设定", "作者的话", "其他"];
 
@@ -2989,6 +2991,7 @@ async function showModule(module) {
   if (module !== "editor" && state.module === "editor" && !(await confirmDiscardChanges())) return;
   if (module !== "editor" && state.module === "editor" && state.dirty) setSaveState("已放弃修改");
   state.module = module;
+  if (module !== "tasks") stopTaskProgressRefresh();
   applyWorkAccessMode();
   markActiveModule(module);
   if (module === "editor") {
@@ -3501,7 +3504,7 @@ async function renderCharacters(page = characterListPage) {
     return `<label class="character-filter-option"><input type="checkbox" value="${esc(value)}" ${selectedIds.has(value) ? "checked" : ""}><span>${esc(label)}</span></label>`;
   }).join("");
   const filterToolbar = `<section id="character-filter-panel" class="character-filter-toolbar${characterFiltersPanelOpen ? "" : " hidden"}" aria-label="角色筛选">
-    <details class="character-filter-dropdown"><summary><span>按种族筛选</span><strong>${selectedRaceNames.length ? `已选 ${selectedRaceNames.length} 项` : "全部种族"}</strong></summary><div id="character-race-filter" class="character-filter-options">${filterOptionList(races, selectedRaceIds)}</div></details>
+    <details class="character-filter-dropdown"><summary><span>按种族筛选</span><strong>${selectedRaceNames.length ? `已选 ${selectedRaceNames.length} 项` : "全部种族"}</strong></summary><div id="character-race-filter" class="character-filter-options">${filterOptionList(orderRaceFilterOptions(races), selectedRaceIds)}</div></details>
     <details class="character-filter-dropdown"><summary><span>按组织筛选</span><strong>${selectedOrganizationNames.length ? `已选 ${selectedOrganizationNames.length} 项` : "全部组织"}</strong></summary><div id="character-organization-filter" class="character-filter-options">${filterOptionList(organizations, selectedOrganizationIds, "id")}</div></details>
     <div class="character-filter-toolbar-actions">${hasCharacterFilters ? `<span class="character-filter-result-count" aria-live="polite">筛选后剩余 ${characterPage.total} 个角色</span>` : ""}<button id="clear-character-filters" class="ghost-button" type="button" ${hasCharacterFilters ? "" : "disabled"}>重置筛选</button></div>
   </section>`;
@@ -3541,10 +3544,7 @@ async function renderCharacters(page = characterListPage) {
 }
 
 async function renderRaces() {
-  [state.races, state.characters] = await Promise.all([
-    apiAllPages(`/api/works/${state.work.id}/races`),
-    canReadModule("characters") ? apiAllPages(`/api/works/${state.work.id}/characters`) : Promise.resolve([])
-  ]);
+  state.races = await apiAllPages(`/api/works/${state.work.id}/races`);
   mountModuleCount(state.races.length);
   const layout = readModuleLayout();
   const canEditRaces = canEditModule("races");
@@ -3748,6 +3748,7 @@ async function renderOutlines() {
 async function renderRelationships() {
   state.characters = canReadModule("characters") ? await apiAllPages(`/api/works/${state.work.id}/characters`) : [];
   const relationships = await apiAllPages(`/api/works/${state.work.id}/relationships`);
+  const canEditRelationships = canEditModule("relationships");
   mountModuleCount(relationships.length);
   const nameOf = (id) => state.characters.find((item) => item.id === id)?.name ?? "未知角色";
   state.galaxy?.destroy();
@@ -3757,7 +3758,7 @@ async function renderRelationships() {
   state.relationshipGraph = graph;
   $("#module-content").innerHTML = `<div id="relationship-map-host"></div>${relationships.length ? `<table class="table-list relationship-table"><thead><tr><th>人物</th><th>关系</th><th>关键词</th><th>证据</th><th>置信度</th><th>状态</th><th>操作</th></tr></thead><tbody>${relationships.map((item) => `
     <tr><td>${esc(nameOf(item.fromCharacterId))} ${item.directed ? "→" : "—"} ${esc(nameOf(item.toCharacterId))}</td>
-    <td>${esc(relationshipCategoryLabel(item.category))} / ${esc(item.subtype || "未细分")}</td><td>${(item.keywords ?? []).map((keyword) => `<span class="pill relationship-keyword">${esc(keyword)}</span>`).join("") || "—"}</td><td>${item.evidence.length}</td><td>${Math.round(item.confidence * 100)}%</td><td>${esc(relationshipConfirmationLabel(item.confirmationStatus))}</td><td class="relationship-actions"><button data-edit-relationship="${esc(item.id)}">编辑</button><button data-entity-history="relationship" data-entity-id="${esc(item.id)}" data-entity-title="${esc(`${nameOf(item.fromCharacterId)} / ${nameOf(item.toCharacterId)}`)}">历史</button></td></tr>`).join("")}</tbody></table>` : '<div class="relationship-empty-note">尚无关系边；孤立角色仍显示在力导向图谱中。可人工新建关系，或运行全书人物关系分析。</div>'}`;
+    <td>${esc(relationshipCategoryLabel(item.category))} / ${esc(item.subtype || "未细分")}</td><td>${(item.keywords ?? []).map((keyword) => `<span class="pill relationship-keyword">${esc(keyword)}</span>`).join("") || "—"}</td><td>${item.evidence.length}</td><td>${Math.round(item.confidence * 100)}%</td><td>${esc(relationshipConfirmationLabel(item.confirmationStatus))}</td><td class="relationship-actions">${canEditRelationships ? `<button data-edit-relationship="${esc(item.id)}">编辑</button>` : ""}<button data-entity-history="relationship" data-entity-id="${esc(item.id)}" data-entity-title="${esc(`${nameOf(item.fromCharacterId)} / ${nameOf(item.toCharacterId)}`)}">历史</button></td></tr>`).join("")}</tbody></table>` : '<div class="relationship-empty-note">尚无关系边；孤立角色仍显示在力导向图谱中。可人工新建关系，或运行全书人物关系分析。</div>'}`;
   const openGalaxy = () => {
     state.galaxy?.destroy();
     state.galaxy = createGalaxyRenderer($("#relationship-galaxy-dialog"), graph, { workId: state.work.id });
@@ -3870,6 +3871,7 @@ async function renderReviews() {
 }
 
 async function renderTasks() {
+  stopTaskProgressRefresh();
   const [tasks, settings] = await Promise.all([
     apiAllPages(`/api/works/${state.work.id}/tasks?view=summary`),
     canReadModule("ai-settings")
@@ -3879,7 +3881,12 @@ async function renderTasks() {
   mountModuleCount(tasks.length);
   const canConfigureAutoRun = canEditModule("tasks") && canEditModule("ai-settings");
   const pendingCount = tasks.filter((item) => item.status === "pending").length;
-  const runningCount = tasks.filter((item) => item.status === "running").length;
+  const runningTasks = tasks.filter((item) => item.status === "running");
+  const runningCount = runningTasks.length;
+  const activeTaskCount = pendingCount + runningCount;
+  const runningProgress = runningCount
+    ? Math.round(runningTasks.reduce((total, item) => total + Math.min(100, Math.max(0, Number(item.progress) || 0)), 0) / runningCount)
+    : 0;
   $("#module-content").innerHTML = `
     <section class="task-auto-run-panel ${canConfigureAutoRun ? "" : "hidden"}" aria-labelledby="task-auto-run-title">
       <div class="task-auto-run-copy">
@@ -3895,6 +3902,10 @@ async function renderTasks() {
         <button id="task-auto-run-continue" class="ghost-button" type="button" ${settings.autoRunEnabled ? "" : "disabled"}>开始下一轮</button>
       </div>
       <p class="task-auto-run-meta">待执行队列 ${pendingCount} 个 · 正在运行 ${runningCount} 个</p>
+      <div class="task-auto-run-progress ${activeTaskCount ? "" : "hidden"}" aria-live="polite">
+        <div class="task-auto-run-progress-label"><span>${runningCount ? "运行中任务平均进度" : "等待任务开始"}</span><strong>${runningProgress}%</strong></div>
+        <progress class="task-auto-run-progress-bar" max="100" value="${runningProgress}" aria-label="${runningCount ? "运行中任务平均进度" : "待执行任务进度"}">${runningProgress}%</progress>
+      </div>
     </section>
     ${tasks.length ? `<table class="table-list task-table"><thead><tr><th>分析类型</th><th>范围</th><th>状态</th><th>进度</th><th>操作</th></tr></thead><tbody>${tasks.map((item) => `
     <tr>
@@ -3958,6 +3969,7 @@ async function renderTasks() {
       button.textContent = "运行中";
       const cancel = button.parentElement.querySelector("[data-cancel-task]");
       if (cancel) cancel.textContent = "取消运行";
+      scheduleTaskProgressRefresh(workId, 1);
       const completed = await api(`/api/tasks/${button.dataset.runTask}/run`, { method: "POST", body: { modelId: $("#ai-model").value || undefined } });
       toast(completed.status === "cancelled" ? "分析任务已取消" : completed.status === "expired" ? "正文已变化，本次分析已过期" : "分析已完成");
       if (state.module === "tasks" && state.work?.id === workId) await renderTasks();
@@ -3977,6 +3989,32 @@ async function renderTasks() {
       button.disabled = false;
     }
   }));
+  scheduleTaskProgressRefresh(state.work.id, runningCount);
+}
+
+function stopTaskProgressRefresh() {
+  if (taskProgressRefreshTimer === null) return;
+  window.clearTimeout(taskProgressRefreshTimer);
+  taskProgressRefreshTimer = null;
+}
+
+function scheduleTaskProgressRefresh(workId, runningCount) {
+  stopTaskProgressRefresh();
+  if (runningCount === 0) return;
+  taskProgressRefreshTimer = window.setTimeout(async () => {
+    taskProgressRefreshTimer = null;
+    if (state.module !== "tasks" || state.work?.id !== workId) return;
+    if ($(".task-auto-run-controls")?.contains(document.activeElement)) {
+      scheduleTaskProgressRefresh(workId, runningCount);
+      return;
+    }
+    try {
+      await renderTasks();
+    } catch (error) {
+      console.error("Failed to refresh task progress", error);
+      scheduleTaskProgressRefresh(workId, runningCount);
+    }
+  }, taskProgressRefreshInterval);
 }
 
 function openTaskDetailDialog(task) {
@@ -4532,6 +4570,8 @@ function openDialog(title, fields, onSubmit, eyebrow = "新增", options = {}) {
   bindRelationshipKeywordControls($("#dialog-fields"));
   bindVditorEditors($("#dialog-fields"));
   const form = $("#dynamic-form");
+  form.onclick = null;
+  form.onkeydown = null;
   form.onsubmit = async (event) => {
     if (event.submitter?.value === "cancel") {
       void discardPendingMarkdownAttachments();
@@ -5891,11 +5931,30 @@ async function openRelationshipDialog(item, options = {}) {
   const characterOptions = state.characters.map((item) => [item.id, item.name]);
   const defaultFrom = options.characterId && state.characters.some((character) => character.id === options.characterId) ? options.characterId : characterOptions[0][0];
   const defaultTo = characterOptions.find(([id]) => id !== defaultFrom)?.[0] ?? characterOptions[1][0];
-  openDialog(item ? "编辑人物关系" : "新建人物关系", field("from", "起点人物", "select", item?.fromCharacterId ?? defaultFrom, characterOptions) + field("to", "终点人物", "select", item?.toCharacterId ?? defaultTo, characterOptions) + field("category", "关系大类", "select", item?.category ?? "social", [["family", "亲属"], ["social", "社交"], ["emotional", "情感"], ["conflict", "冲突"], ["uncertain", "未确定"]]) + field("subtype", "关系子类", "text", item?.subtype) + field("keywords", "关系关键词", "keyword-chips", item?.keywords ?? []) + field("confidence", "置信度（0-1）", "number", item?.confidence ?? "1") + field("directed", "有方向性", "checkbox", item?.directed ?? false), async (form) => {
+  const relationshipName = item ? `${state.characters.find((character) => character.id === item.fromCharacterId)?.name ?? "未知角色"} / ${state.characters.find((character) => character.id === item.toCharacterId)?.name ?? "未知角色"}` : "";
+  const management = item && canEditModule("relationships") ? `<section class="entity-dialog-management" aria-label="人物关系操作">
+    <div><strong>关系操作</strong><small>删除操作会记录到版本历史和审计日志。</small></div>
+    <div class="entity-dialog-management-actions"><button class="danger-button" type="button" data-dialog-relationship-delete>删除关系</button></div>
+  </section>` : "";
+  openDialog(item ? "编辑人物关系" : "新建人物关系", field("from", "起点人物", "select", item?.fromCharacterId ?? defaultFrom, characterOptions) + field("to", "终点人物", "select", item?.toCharacterId ?? defaultTo, characterOptions) + field("category", "关系大类", "select", item?.category ?? "social", [["family", "亲属"], ["social", "社交"], ["emotional", "情感"], ["conflict", "冲突"], ["uncertain", "未确定"]]) + field("subtype", "关系子类", "text", item?.subtype) + field("keywords", "关系关键词", "keyword-chips", item?.keywords ?? []) + field("confidence", "置信度（0-1）", "number", item?.confidence ?? "1") + field("directed", "有方向性", "checkbox", item?.directed ?? false) + management, async (form) => {
     const keywords = uniqueRelationshipKeywords(form.getAll("keywords").map(String));
     await api(item ? `/api/relationships/${item.id}` : `/api/works/${state.work.id}/relationships`, { method: item ? "PATCH" : "POST", body: { fromCharacterId: form.get("from"), toCharacterId: form.get("to"), category: form.get("category"), subtype: form.get("subtype"), keywords, confidence: Number(form.get("confidence")), directed: form.get("directed") === "on", confirmationStatus: item?.confirmationStatus ?? "confirmed", ...(item ? { expectedVersionNo: item.versionNo } : {}) } });
     await refreshRelationshipSurfaces(options.characterId ?? null);
   }, item ? "关系档案" : "人工确认关系");
+  $("#dialog-fields").querySelector("[data-dialog-relationship-delete]")?.addEventListener("click", async () => {
+    const dialog = $("#form-dialog");
+    dialog.close();
+    if (!await confirmToast(`确认删除人物关系“${relationshipName}”吗？`, { title: "删除人物关系", confirmLabel: "继续删除" })) return dialog.showModal();
+    if (!await confirmToast(`删除人物关系“${relationshipName}”后无法恢复。`, { title: "删除操作需要再次确认", confirmLabel: "确认删除" })) return dialog.showModal();
+    try {
+      await api(`/api/relationships/${item.id}`, { method: "DELETE", body: { expectedVersionNo: item.versionNo } });
+      await Promise.all([refreshRelationshipSurfaces(options.characterId ?? null), loadAiReferences()]);
+      toast(`已删除人物关系“${relationshipName}”`);
+    } catch (error) {
+      dialog.showModal();
+      toast(error.message, "error");
+    }
+  });
 }
 
 function openReviewDialog() {
@@ -5905,14 +5964,58 @@ function openReviewDialog() {
   });
 }
 
-function openTaskDialog() {
+async function openTaskDialog() {
   const chapterOptions = state.work.volumes.flatMap((volume) => volume.chapters.map((chapter) => [chapter.id, `${volume.title} / ${chapter.title}`]));
+  let relationshipCharacters = [];
+  try {
+    relationshipCharacters = canReadModule("characters")
+      ? await apiAllPages(`/api/works/${state.work.id}/characters`)
+      : [];
+  } catch (error) {
+    toast(`角色列表加载失败：${error.message}`, "error");
+    return;
+  }
+  const characterOptions = relationshipCharacters.map((character) => [character.id, character.name]);
+  const relationshipCharacterPicker = `<div class="form-field relationship-character-field">
+    <span id="relationship-character-label">被分析角色（可多选）</span>
+    <div class="relationship-character-picker">
+      <button class="relationship-character-trigger" type="button" aria-expanded="false" aria-controls="relationship-character-bubble" aria-labelledby="relationship-character-label relationship-character-summary">
+        <span id="relationship-character-summary">选择需要定向分析的角色</span>
+        <span class="relationship-character-trigger-meta"><span data-relationship-character-count>未选择</span><span class="relationship-character-chevron" aria-hidden="true">⌄</span></span>
+      </button>
+      <div id="relationship-character-bubble" class="relationship-character-bubble hidden">
+        <label class="relationship-character-search">筛选角色<input type="search" data-relationship-character-search placeholder="输入角色名" autocomplete="off"></label>
+        <div class="relationship-character-bubble-meta"><span>共 ${characterOptions.length} 个角色</span><button type="button" data-relationship-character-clear disabled>清空选择</button></div>
+        <div class="relationship-character-options" role="group" aria-labelledby="relationship-character-label">
+          ${characterOptions.map(([characterId, characterName]) => `<label class="relationship-character-chip" data-character-search-name="${esc(String(characterName).toLocaleLowerCase())}"><input type="checkbox" name="characterIds" value="${esc(characterId)}" data-character-name="${esc(characterName)}"><span>${esc(characterName)}</span></label>`).join("")}
+        </div>
+        <p class="relationship-character-empty hidden" data-relationship-character-empty>没有匹配的角色</p>
+      </div>
+    </div>
+  </div>`;
   const defaultTaskType = ANALYSIS_TYPES[0].value;
   const taskTypeField = `<div class="form-field analysis-type-field"><label>分析类型<select name="taskType" aria-describedby="analysis-type-description">${ANALYSIS_TYPES.map(({ value, label }) => `<option value="${esc(value)}" ${value === defaultTaskType ? "selected" : ""}>${esc(label)}</option>`).join("")}</select></label><p id="analysis-type-description" class="analysis-type-description" aria-live="polite">${esc(analysisTypeDescription(defaultTaskType))}</p></div>`;
   const chapterField = `<label class="task-chapter-field">章节<select name="chapterId">${chapterOptions.map(([key, text], index) => `<option value="${esc(key)}" ${index === 0 ? "selected" : ""}>${esc(text)}</option>`).join("")}</select></label>`;
-  openDialog("开始 AI 分析", taskTypeField + field("scopeType", "分析范围", "select", "chapter", [["chapter", "指定章节"], ["book", "全书"]]) + chapterField, async (form) => {
-    const scope = form.get("taskType") === "character-identity-audit" || form.get("scopeType") === "book" ? { type: "book" } : { type: "chapter", chapterId: form.get("chapterId") };
-    await api(`/api/works/${state.work.id}/tasks`, { method: "POST", body: { taskType: form.get("taskType"), scope } });
+  const relationshipFields = `<div class="relationship-analysis-options hidden">
+    ${relationshipCharacterPicker}
+    <p class="relationship-analysis-helper"><span aria-hidden="true">i</span><span>留空时使用基础关系抽取；选中角色后，将汇总其跨章节证据再进行全局关系归纳。</span></p>
+    <div class="relationship-overwrite-card hidden">
+      <label class="checkbox-field"><input name="replaceExistingRelationships" type="checkbox" disabled><span>用本次结果覆盖所选角色的已有关系</span></label>
+      <p>任务成功后，会先删除所有涉及所选角色的旧关系，再写入本次分析结果。</p>
+    </div>
+    <label>额外分析提示<textarea name="additionalPrompt" maxlength="10000" placeholder="例如：重点识别权力继承、师承变化或隐秘亲缘关系"></textarea><small>将同时追加到证据收集和全局关系归纳提示词，仅影响本次任务。</small></label>
+  </div>`;
+  openDialog("开始 AI 分析", taskTypeField + field("scopeType", "分析范围", "select", "chapter", [["chapter", "指定章节"], ["book", "全书"]]) + chapterField + relationshipFields, async (form) => {
+    const taskType = String(form.get("taskType"));
+    const scopeType = String(form.get("scopeType"));
+    const includeAllSettings = taskType === "relationship-analysis" && scopeType === "book-with-settings";
+    const additionalPrompt = taskType === "relationship-analysis" ? String(form.get("additionalPrompt") ?? "").trim() : "";
+    const characterIds = taskType === "relationship-analysis" ? form.getAll("characterIds").map(String).filter(Boolean) : [];
+    const replaceExistingRelationships = characterIds.length > 0 && form.get("replaceExistingRelationships") === "on";
+    const scope = taskType === "character-identity-audit" || scopeType === "book" || includeAllSettings
+      ? { type: "book", ...(includeAllSettings ? { includeAllSettings: true } : {}), ...(additionalPrompt ? { additionalPrompt } : {}), ...(characterIds.length ? { characterIds } : {}), ...(replaceExistingRelationships ? { replaceExistingRelationships: true } : {}) }
+      : { type: "chapter", chapterId: form.get("chapterId"), ...(additionalPrompt ? { additionalPrompt } : {}), ...(characterIds.length ? { characterIds } : {}), ...(replaceExistingRelationships ? { replaceExistingRelationships: true } : {}) };
+    await api(`/api/works/${state.work.id}/tasks`, { method: "POST", body: { taskType, scope } });
     await renderTasks();
   });
   const taskTypeSelect = $("#dialog-fields").querySelector('select[name="taskType"]');
@@ -5920,17 +6023,99 @@ function openTaskDialog() {
   const chapterSelect = $("#dialog-fields").querySelector('select[name="chapterId"]');
   const chapterFieldElement = chapterSelect.closest(".task-chapter-field");
   const description = $("#analysis-type-description");
+  const relationshipOptions = $("#dialog-fields").querySelector(".relationship-analysis-options");
+  const relationshipPrompt = relationshipOptions.querySelector('textarea[name="additionalPrompt"]');
+  const relationshipCharacterPickerElement = relationshipOptions.querySelector(".relationship-character-picker");
+  const relationshipCharacterTrigger = relationshipOptions.querySelector(".relationship-character-trigger");
+  const relationshipCharacterBubble = relationshipOptions.querySelector(".relationship-character-bubble");
+  const relationshipCharacterSearch = relationshipOptions.querySelector("[data-relationship-character-search]");
+  const relationshipCharacterInputs = [...relationshipOptions.querySelectorAll('input[name="characterIds"]')];
+  const relationshipCharacterSummary = relationshipOptions.querySelector("#relationship-character-summary");
+  const relationshipCharacterCount = relationshipOptions.querySelector("[data-relationship-character-count]");
+  const relationshipCharacterClear = relationshipOptions.querySelector("[data-relationship-character-clear]");
+  const relationshipCharacterEmpty = relationshipOptions.querySelector("[data-relationship-character-empty]");
+  const replaceRelationships = relationshipOptions.querySelector('input[name="replaceExistingRelationships"]');
+  const relationshipOverwriteCard = relationshipOptions.querySelector(".relationship-overwrite-card");
+  const allSettingsOption = document.createElement("option");
+  allSettingsOption.value = "book-with-settings";
+  allSettingsOption.textContent = "全书 + 所有设定";
   const syncChapterField = () => {
-    const disabled = scopeTypeSelect.value === "book";
+    const disabled = scopeTypeSelect.value !== "chapter";
     chapterSelect.disabled = disabled;
     chapterFieldElement.classList.toggle("is-disabled", disabled);
     chapterFieldElement.setAttribute("aria-disabled", String(disabled));
   };
+  const setRelationshipCharacterBubbleOpen = (open) => {
+    relationshipCharacterBubble.classList.toggle("hidden", !open);
+    relationshipCharacterTrigger.setAttribute("aria-expanded", String(open));
+    if (open) relationshipCharacterSearch.focus();
+  };
+  const syncRelationshipCharacterPicker = () => {
+    const selected = relationshipCharacterInputs.filter((input) => input.checked);
+    const selectedNames = selected.map((input) => input.dataset.characterName);
+    relationshipCharacterSummary.textContent = selectedNames.length
+      ? `${selectedNames.slice(0, 2).join("、")}${selectedNames.length > 2 ? ` 等 ${selectedNames.length} 人` : ""}`
+      : "选择需要定向分析的角色";
+    relationshipCharacterCount.textContent = selected.length ? `已选 ${selected.length}` : "未选择";
+    relationshipCharacterClear.disabled = selected.length === 0;
+    relationshipCharacterTrigger.setAttribute("aria-label", `筛选被分析角色，已选择 ${selected.length} 个`);
+  };
+  const filterRelationshipCharacters = () => {
+    const query = relationshipCharacterSearch.value.trim().toLocaleLowerCase();
+    let visibleCount = 0;
+    for (const input of relationshipCharacterInputs) {
+      const chip = input.closest(".relationship-character-chip");
+      const visible = !query || chip.dataset.characterSearchName.includes(query);
+      chip.classList.toggle("hidden", !visible);
+      if (visible) visibleCount += 1;
+    }
+    relationshipCharacterEmpty.classList.toggle("hidden", visibleCount > 0);
+  };
+  const syncRelationshipOptions = () => {
+    const enabled = taskTypeSelect.value === "relationship-analysis";
+    if (enabled && !allSettingsOption.isConnected) scopeTypeSelect.append(allSettingsOption);
+    if (!enabled && allSettingsOption.isConnected) {
+      if (scopeTypeSelect.value === allSettingsOption.value) scopeTypeSelect.value = "book";
+      allSettingsOption.remove();
+    }
+    relationshipOptions.classList.toggle("hidden", !enabled);
+    relationshipPrompt.disabled = !enabled;
+    relationshipCharacterTrigger.disabled = !enabled;
+    relationshipCharacterSearch.disabled = !enabled;
+    for (const input of relationshipCharacterInputs) input.disabled = !enabled;
+    if (!enabled) setRelationshipCharacterBubbleOpen(false);
+    const hasSelectedCharacters = enabled && relationshipCharacterInputs.some((input) => input.checked);
+    replaceRelationships.disabled = !hasSelectedCharacters;
+    relationshipOverwriteCard.classList.toggle("hidden", !hasSelectedCharacters);
+    if (!hasSelectedCharacters) replaceRelationships.checked = false;
+    syncRelationshipCharacterPicker();
+    filterRelationshipCharacters();
+    syncChapterField();
+  };
   taskTypeSelect.addEventListener("change", () => {
     description.textContent = analysisTypeDescription(taskTypeSelect.value);
+    syncRelationshipOptions();
   });
+  relationshipCharacterTrigger.addEventListener("click", () => {
+    setRelationshipCharacterBubbleOpen(relationshipCharacterTrigger.getAttribute("aria-expanded") !== "true");
+  });
+  relationshipCharacterSearch.addEventListener("input", filterRelationshipCharacters);
+  for (const input of relationshipCharacterInputs) input.addEventListener("change", syncRelationshipOptions);
+  relationshipCharacterClear.addEventListener("click", () => {
+    for (const input of relationshipCharacterInputs) input.checked = false;
+    syncRelationshipOptions();
+  });
+  $("#dynamic-form").onclick = (event) => {
+    if (!relationshipCharacterPickerElement.contains(event.target)) setRelationshipCharacterBubbleOpen(false);
+  };
+  $("#dynamic-form").onkeydown = (event) => {
+    if (event.key !== "Escape" || relationshipCharacterBubble.classList.contains("hidden")) return;
+    event.preventDefault();
+    setRelationshipCharacterBubbleOpen(false);
+    relationshipCharacterTrigger.focus();
+  };
   scopeTypeSelect.addEventListener("change", syncChapterField);
-  syncChapterField();
+  syncRelationshipOptions();
 }
 
 function openProviderDialog(item) {
@@ -6021,7 +6206,7 @@ async function sendAi() {
     } else {
       suggestion = await api(`/api/works/${state.work.id}/suggestions`, { method: "POST", body: { taskType, instruction, scope, modelId, citations } });
       assistantContent = suggestion.content;
-      assistantMetadata = { modelDisplayName: suggestion.model?.displayName, outputTokens: suggestion.outputTokens };
+      assistantMetadata = { modelDisplayName: suggestion.model?.displayName, outputTokens: suggestion.outputTokens, cacheHitPercent: suggestion.cacheHitPercent };
     }
     try {
       const persistedAssistantMessage = await persistAiConversationMessage("assistant", assistantContent, [], assistantMetadata);
@@ -6117,9 +6302,9 @@ async function streamChat(body) {
         toolCalls = Array.isArray(payload.toolCalls) ? payload.toolCalls : toolCalls;
         processSteps = Array.isArray(payload.processSteps) ? payload.processSteps : processSteps;
         const processDurationMs = elapsedProcessTime();
-        generatedMetadata = { modelDisplayName: payload.model?.displayName, outputTokens: payload.outputTokens, toolCalls, processSteps, processDurationMs };
+        generatedMetadata = { modelDisplayName: payload.model?.displayName, outputTokens: payload.outputTokens, cacheHitPercent: payload.cacheHitPercent, toolCalls, processSteps, processDurationMs };
         renderAiProcessSteps(message, processSteps, true, processDurationMs);
-        meta.textContent = formatAiMessageMeta(payload.model?.displayName, payload.outputTokens);
+        meta.textContent = formatAiMessageMeta(payload.model?.displayName, payload.outputTokens, payload.cacheHitPercent);
         attachAssistantCopyAction(message, streamedText);
         scrollAiFeedToBottom();
       } else if (eventName === "error") {
@@ -6174,7 +6359,7 @@ function appendMessage(role, text, citations = [], createdAt = null, metadata =
     const outputTokens = Number.isFinite(metadata?.outputTokens) ? metadata.outputTokens : estimateAiMessageTokens(text);
     const meta = document.createElement("div");
     meta.className = "message-meta";
-    meta.textContent = formatAiMessageMeta(modelDisplayName, outputTokens);
+    meta.textContent = formatAiMessageMeta(modelDisplayName, outputTokens, metadata?.cacheHitPercent);
     message.append(meta);
     attachAssistantCopyAction(message, text);
   }
@@ -6189,7 +6374,7 @@ function appendSuggestion(suggestion, createdAt = null, messageId = null) {
   const applicable = suggestion.action !== "note";
   const guard = suggestion.guard;
   const guardHtml = guard ? `<section class="guard-card ${esc(guard.status)}" data-testid="continuation-guard"><strong>${guard.status === "clear" ? "一致性守卫：未发现冲突" : guard.status === "warning" ? `一致性守卫：发现 ${guard.issues.length} 项风险` : "一致性守卫：检查失败"}</strong>${guard.status === "failed" ? `<p>${esc(guard.failure || "无法完成检查，请谨慎采纳")}</p>` : guard.issues.map((issue) => `<p><b>${esc(levelLabel(issue.severity))} · ${esc(reviewItemTypeLabel(issue.type))}</b> ${esc(issue.title)}${issue.description ? `：${esc(issue.description)}` : ""}</p>`).join("")}</section>` : "";
-  message.innerHTML = `<div class="message-body">${renderMarkdown(suggestion.content)}</div><div class="message-meta">${esc(formatAiMessageMeta(suggestion.model?.displayName, suggestion.outputTokens, `基于 v${suggestion.chapterVersion ?? "-"}`))}</div>${guardHtml}${applicable ? '<div class="message-actions"><button data-action="accept">采纳到正文</button><button data-action="reject">拒绝</button></div>' : ""}`;
+  message.innerHTML = `<div class="message-body">${renderMarkdown(suggestion.content)}</div><div class="message-meta">${esc(formatAiMessageMeta(suggestion.model?.displayName, suggestion.outputTokens, suggestion.cacheHitPercent, `基于 v${suggestion.chapterVersion ?? "-"}`))}</div>${guardHtml}${applicable ? '<div class="message-actions"><button data-action="accept">采纳到正文</button><button data-action="reject">拒绝</button></div>' : ""}`;
   attachMessageHeading(message, "助手建议", createdAt ?? undefined);
   attachAssistantCopyAction(message, suggestion.content);
   attachMessageIdentity(message, messageId);

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=20260725-module-count-vditor-left-panel">
+    <link rel="stylesheet" href="/styles.css?v=20260726-ai-history-cache-analysis-progress">
   </head>
   <body class="auth-pending">
     <section id="auth-view" class="auth-view hidden" aria-labelledby="auth-title">
@@ -239,13 +239,12 @@
         <div id="ai-panel-resize" class="panel-resize-handle" role="separator" aria-label="调整创作助手宽度" aria-orientation="vertical" tabindex="0"></div>
         <div class="ai-heading">
           <button id="ai-panel-toggle" class="panel-collapse-button" type="button" aria-label="收起创作助手" aria-expanded="true">›</button>
-          <div><span class="status-dot"></span><strong>创作助手</strong></div>
-          <small>结果作为建议</small>
-        </div>
-        <div class="ai-conversation-toolbar">
-          <span id="ai-conversation-title">新对话</span>
-          <button id="ai-new-conversation" type="button">新建对话</button>
-          <button id="ai-history-toggle" type="button" aria-controls="ai-history-dialog" aria-expanded="false" aria-haspopup="dialog">历史记录</button>
+          <div class="ai-heading-title"><span class="status-dot"></span><strong>创作助手</strong></div>
+          <div class="ai-heading-actions">
+            <span id="ai-conversation-title" title="当前对话">新对话</span>
+            <button id="ai-history-toggle" type="button" aria-label="历史记录" aria-controls="ai-history-dialog" aria-expanded="false" aria-haspopup="dialog" title="历史记录"><svg class="ai-heading-action-icon" viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 12a9 9 0 1 0 3-6.7L3 8"></path><path d="M3 3v5h5M12 7v5l3.5 2"></path></svg></button>
+            <button id="ai-new-conversation" type="button" aria-label="新建对话" title="新建对话">＋</button>
+          </div>
         </div>
         <div class="quick-actions" aria-label="快捷指令">
           <button type="button" data-task="chat" data-prompt="总结当前章节，并列出尚未解决的冲突。">总结本章</button>
@@ -733,6 +732,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=20260725-collab-refresh-left-panel-resize"></script>
+    <script type="module" src="/app.js?v=20260726-ai-history-cache-analysis-progress"></script>
   </body>
 </html>

package/dist/public/race-hierarchy.js

@@ -32,6 +32,42 @@ export function eligibleRaceParents(races, currentRaceId = null) {
   return races.filter((race) => !excluded.has(String(race?.id ?? "")));
 }
 
+export function orderRaceFilterOptions(races) {
+  const raceIds = new Set(races.map((race) => String(race?.id ?? "")).filter(Boolean));
+  const childrenByParent = new Map();
+  const roots = [];
+  for (const race of races) {
+    const id = String(race?.id ?? "");
+    const parentRaceId = race?.parentRaceId == null ? "" : String(race.parentRaceId);
+    if (!parentRaceId || parentRaceId === id || !raceIds.has(parentRaceId)) {
+      roots.push(race);
+      continue;
+    }
+    const children = childrenByParent.get(parentRaceId) ?? [];
+    children.push(race);
+    childrenByParent.set(parentRaceId, children);
+  }
+  const sortByName = (items) => items.sort((left, right) => String(left?.name ?? "").localeCompare(String(right?.name ?? ""), "zh-CN"));
+  sortByName(roots);
+  for (const children of childrenByParent.values()) sortByName(children);
+
+  const ordered = [...roots];
+  const pending = [...roots];
+  const visited = new Set(roots);
+  while (pending.length) {
+    const parent = pending.shift();
+    const children = childrenByParent.get(String(parent?.id ?? "")) ?? [];
+    for (const child of children) {
+      if (visited.has(child)) continue;
+      visited.add(child);
+      ordered.push(child);
+      pending.push(child);
+    }
+  }
+  ordered.push(...sortByName(races.filter((race) => !visited.has(race))));
+  return ordered;
+}
+
 export function buildRaceForest(races) {
   const nodes = new Map(races.map((race) => [String(race.id), { ...race, children: [] }]));
   const roots = [];

package/dist/public/relationship-graph.js

@@ -6,14 +6,26 @@ const RELATION_STYLE = Object.freeze({
   uncertain: { label: "未确定", color: "#9aa5b5" }
 });
 
-/** Obsidian Graph View 风格：低饱和度分组配色 */
+/** Obsidian Graph View 风格：为浅色和深色背景分别提供可辨识的低饱和度分组配色 */
 export const OBSIDIAN_NODE_PALETTE = Object.freeze([
-  Object.freeze({ key: "blue", color: "#7a9bb5", glow: "rgba(122,155,181,.48)" }),
-  Object.freeze({ key: "lavender", color: "#9a8fb5", glow: "rgba(154,143,181,.48)" }),
-  Object.freeze({ key: "slate", color: "#8b9099", glow: "rgba(139,144,153,.42)" }),
-  Object.freeze({ key: "rose", color: "#b58a9a", glow: "rgba(181,138,154,.48)" }),
-  Object.freeze({ key: "mist", color: "#8aa8a3", glow: "rgba(138,168,163,.45)" }),
-  Object.freeze({ key: "sand", color: "#a89a88", glow: "rgba(168,154,136,.42)" })
+  Object.freeze({ key: "blue", color: "#3f6f99", darkColor: "#7fb7e3", glow: "rgba(63,111,153,.42)", darkGlow: "rgba(127,183,227,.56)" }),
+  Object.freeze({ key: "indigo", color: "#5b5fa3", darkColor: "#9ea6ed", glow: "rgba(91,95,163,.42)", darkGlow: "rgba(158,166,237,.56)" }),
+  Object.freeze({ key: "violet", color: "#77549a", darkColor: "#bd91df", glow: "rgba(119,84,154,.42)", darkGlow: "rgba(189,145,223,.56)" }),
+  Object.freeze({ key: "purple", color: "#8b4f83", darkColor: "#d28bc5", glow: "rgba(139,79,131,.42)", darkGlow: "rgba(210,139,197,.56)" }),
+  Object.freeze({ key: "rose", color: "#a84e6a", darkColor: "#e78da8", glow: "rgba(168,78,106,.42)", darkGlow: "rgba(231,141,168,.56)" }),
+  Object.freeze({ key: "red", color: "#ad554f", darkColor: "#ef948c", glow: "rgba(173,85,79,.42)", darkGlow: "rgba(239,148,140,.56)" }),
+  Object.freeze({ key: "coral", color: "#a95d45", darkColor: "#eda083", glow: "rgba(169,93,69,.42)", darkGlow: "rgba(237,160,131,.56)" }),
+  Object.freeze({ key: "amber", color: "#956b2f", darkColor: "#deb46d", glow: "rgba(149,107,47,.42)", darkGlow: "rgba(222,180,109,.56)" }),
+  Object.freeze({ key: "olive", color: "#777331", darkColor: "#bdba70", glow: "rgba(119,115,49,.42)", darkGlow: "rgba(189,186,112,.56)" }),
+  Object.freeze({ key: "green", color: "#47794f", darkColor: "#84c98f", glow: "rgba(71,121,79,.42)", darkGlow: "rgba(132,201,143,.56)" }),
+  Object.freeze({ key: "emerald", color: "#337965", darkColor: "#74c9aa", glow: "rgba(51,121,101,.42)", darkGlow: "rgba(116,201,170,.56)" }),
+  Object.freeze({ key: "teal", color: "#31777a", darkColor: "#72c6c8", glow: "rgba(49,119,122,.42)", darkGlow: "rgba(114,198,200,.56)" }),
+  Object.freeze({ key: "cyan", color: "#34758f", darkColor: "#7cc4de", glow: "rgba(52,117,143,.42)", darkGlow: "rgba(124,196,222,.56)" }),
+  Object.freeze({ key: "sky", color: "#41749f", darkColor: "#87bce6", glow: "rgba(65,116,159,.42)", darkGlow: "rgba(135,188,230,.56)" }),
+  Object.freeze({ key: "steel", color: "#576f86", darkColor: "#98afc5", glow: "rgba(87,111,134,.42)", darkGlow: "rgba(152,175,197,.56)" }),
+  Object.freeze({ key: "slate", color: "#626b78", darkColor: "#aab3c0", glow: "rgba(98,107,120,.42)", darkGlow: "rgba(170,179,192,.56)" }),
+  Object.freeze({ key: "sand", color: "#806e58", darkColor: "#c5ad91", glow: "rgba(128,110,88,.42)", darkGlow: "rgba(197,173,145,.56)" }),
+  Object.freeze({ key: "taupe", color: "#75636d", darkColor: "#b9a0ad", glow: "rgba(117,99,109,.42)", darkGlow: "rgba(185,160,173,.56)" })
 ]);
 
 const clamp = (value, minimum, maximum) => Math.min(maximum, Math.max(minimum, value));
@@ -186,12 +198,18 @@ export function getObsidianNodeAppearance(node, maxDegree = 1) {
   const group = resolveRelationshipNodeGroup(node);
   const degree = Math.max(0, Number(node?.degree) || 0);
   const normalizedDegree = clamp(degree / Math.max(1, Number(maxDegree) || 1), 0, 1);
-  const paletteIndex = group.key === "default" ? 2 : hashString(group.key) % OBSIDIAN_NODE_PALETTE.length;
+  // 未分组角色没有可共享的分组语义，按角色稳定标识散列，避免资料不完整时大片同色。
+  const colorKey = group.key === "default"
+    ? `node:${String(node?.id ?? node?.name ?? "default")}`
+    : group.key;
+  const paletteIndex = hashString(colorKey) % OBSIDIAN_NODE_PALETTE.length;
   const palette = OBSIDIAN_NODE_PALETTE[paletteIndex];
   return {
     group,
     color: palette.color,
+    darkColor: palette.darkColor,
     glow: palette.glow,
+    darkGlow: palette.darkGlow,
     size: clamp(8 + Math.sqrt(degree) * 4.8 + normalizedDegree * 4, 8, 38),
     degree,
     normalizedDegree
@@ -299,7 +317,9 @@ export function buildRelationshipGraph(characters, relationships) {
     node.importance = node.weightedDegree + Math.sqrt(node.degree) * 0.8;
     const appearance = getObsidianNodeAppearance(node, maxDegree);
     node.color = appearance.color;
+    node.darkColor = appearance.darkColor;
     node.glow = appearance.glow;
+    node.darkGlow = appearance.darkGlow;
     node.nodeSize = appearance.size;
   }
   nodes.sort((left, right) => right.importance - left.importance || left.name.localeCompare(right.name, "zh-CN"));
@@ -1253,8 +1273,10 @@ export function renderRelationshipMindMap(container, graph, options = {}) {
     button.dataset.groupKey = node.groupKey || appearance.group.key;
     button.classList.toggle("is-label-visible", graph.nodes.indexOf(node) < defaultLabelLimit || node.degree >= 4);
     button.style.setProperty("--node-size", `${nodeSize}px`);
-    button.style.setProperty("--node-color", node.color || appearance.color);
-    button.style.setProperty("--node-glow", node.glow || appearance.glow);
+    button.style.setProperty("--node-color-light", node.color || appearance.color);
+    button.style.setProperty("--node-color-dark", node.darkColor || appearance.darkColor);
+    button.style.setProperty("--node-glow-light", node.glow || appearance.glow);
+    button.style.setProperty("--node-glow-dark", node.darkGlow || appearance.darkGlow);
     const labelEl = document.createElement("span");
     labelEl.textContent = node.name;
     button.append(labelEl);