@musnows/scriverse 0.4.11 → 0.4.12

package/dist/public/ai-message-meta.js

@@ -1,7 +1,12 @@
-export function formatAiMessageMeta(modelDisplayName, outputTokens, suffix = "") {
+export function formatAiMessageMeta(modelDisplayName, outputTokens, cacheHitPercent, suffix = "") {
   const modelName = String(modelDisplayName || "模型").trim();
   const tokenCount = Math.max(0, Math.round(Number(outputTokens) || 0)).toLocaleString("zh-CN");
-  return [modelName, `${tokenCount} tok`, String(suffix || "").trim()].filter(Boolean).join(" · ");
+  const cachePercent = Number(cacheHitPercent);
+  const roundedCachePercent = Math.round((cachePercent + Number.EPSILON) * 10) / 10;
+  const cacheLabel = Number.isFinite(cachePercent)
+    ? `缓存命中 ${Math.max(0, Math.min(100, roundedCachePercent)).toLocaleString("zh-CN")}%`
+    : "";
+  return [modelName, `${tokenCount} tok`, cacheLabel, String(suffix || "").trim()].filter(Boolean).join(" · ");
 }
 
 export function estimateAiMessageTokens(value) {

package/dist/public/app.js

@@ -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";
@@ -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") {
@@ -3868,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")
@@ -3877,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">
@@ -3893,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>
@@ -3956,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();
@@ -3975,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) {
@@ -4530,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();
@@ -5922,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"]');
@@ -5937,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) {
@@ -6038,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);
@@ -6134,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") {
@@ -6191,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);
   }
@@ -6206,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=20260726-ai-panel-header-relationship-network-palette">
+    <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">
@@ -242,8 +242,8 @@
           <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>
-            <button id="ai-history-toggle" type="button" aria-controls="ai-history-dialog" aria-expanded="false" aria-haspopup="dialog" title="历史记录">历史</button>
           </div>
         </div>
         <div class="quick-actions" aria-label="快捷指令">
@@ -732,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=20260726-relationship-permission-actions"></script>
+    <script type="module" src="/app.js?v=20260726-ai-history-cache-analysis-progress"></script>
   </body>
 </html>

package/dist/public/styles.css

@@ -1180,6 +1180,13 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
   margin: 0;
 }
 .task-auto-run-meta { margin: 0; color: var(--muted); font-size: 10px; }
+.task-auto-run-progress { display: grid; gap: 6px; width: min(100%, 420px); }
+.task-auto-run-progress-label { display: flex; align-items: center; justify-content: space-between; gap: 12px; color: var(--muted); font-size: 10px; }
+.task-auto-run-progress-label strong { color: var(--ink); font-family: var(--font-latin), monospace; font-size: 10px; font-weight: 600; }
+.task-auto-run-progress-bar { width: 100%; height: 6px; overflow: hidden; border: 0; border-radius: 999px; appearance: none; background: color-mix(in srgb, var(--line) 72%, transparent); }
+.task-auto-run-progress-bar::-webkit-progress-bar { border-radius: inherit; background: color-mix(in srgb, var(--line) 72%, transparent); }
+.task-auto-run-progress-bar::-webkit-progress-value { border-radius: inherit; background: var(--accent); transition: width .25s ease; }
+.task-auto-run-progress-bar::-moz-progress-bar { border-radius: inherit; background: var(--accent); transition: width .25s ease; }
 .task-row-actions { display: flex; flex-wrap: wrap; gap: 6px; }
 .task-detail { display: grid; gap: 12px; }
 .task-detail p, .task-detail div { margin: 0; font-size: 12px; line-height: 1.55; }
@@ -1481,6 +1488,7 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
 .ai-heading-actions { display: flex; align-items: center; min-width: 0; margin-left: auto; gap: 5px; }
 .ai-heading-actions > span { min-width: 0; max-width: 88px; overflow: hidden; color: var(--muted); font-size: 9px; text-overflow: ellipsis; white-space: nowrap; }
 .ai-heading-actions button { min-width: 28px; height: 28px; padding: 0 7px; border: 1px solid var(--line); border-radius: 4px; background: transparent; color: var(--muted); font-size: 9px; }
+.ai-heading-action-icon { display: block; width: 15px; height: 15px; margin: auto; fill: none; stroke: currentColor; stroke-linecap: round; stroke-linejoin: round; stroke-width: 1.8; }
 .ai-heading-actions #ai-new-conversation { padding: 0; font: 17px/1 var(--font-latin), monospace; }
 .ai-heading-actions button:hover, .ai-heading-actions button[aria-expanded="true"] { background: var(--paper-deep); color: var(--ink); }
 .status-dot { width: 7px; height: 7px; border-radius: 50%; background: var(--green); box-shadow: 0 0 0 3px rgba(94,118,92,.14); }
@@ -1740,6 +1748,36 @@ select:focus, input:focus, textarea:focus { border-color: #a77768; box-shadow: 0
 .task-chapter-field { transition: opacity .15s ease; }
 .task-chapter-field.is-disabled { opacity: .48; }
 .task-chapter-field select:disabled { cursor: not-allowed; }
+.relationship-analysis-options { display: grid; gap: 14px; }
+.relationship-character-field { min-width: 0; }
+.relationship-character-picker { display: grid; gap: 8px; min-width: 0; }
+.dialog-fields .relationship-character-trigger { display: flex; width: 100%; min-height: 42px; align-items: center; justify-content: space-between; gap: 12px; padding: 9px 11px; border: 1px solid var(--line); border-radius: 4px; background: var(--surface); color: var(--ink); font-size: 12px; text-align: left; }
+.relationship-character-trigger:hover, .relationship-character-trigger:focus-visible, .relationship-character-trigger[aria-expanded="true"] { border-color: var(--accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--accent) 12%, transparent); outline: none; }
+.relationship-character-trigger:disabled { cursor: not-allowed; opacity: .48; }
+.relationship-character-trigger > span:first-child { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.relationship-character-trigger-meta { display: inline-flex; flex: 0 0 auto; align-items: center; gap: 8px; color: var(--muted); font-family: var(--font-latin), monospace; font-size: 10px; }
+.relationship-character-chevron { font-size: 15px; line-height: 1; transition: transform .15s ease; }
+.relationship-character-trigger[aria-expanded="true"] .relationship-character-chevron { transform: rotate(180deg); }
+.relationship-character-bubble { position: relative; display: grid; gap: 9px; padding: 12px; border: 1px solid color-mix(in srgb, var(--accent) 36%, var(--line)); border-radius: 8px; background: var(--surface-soft); box-shadow: 0 10px 30px rgba(48,39,31,.12); }
+.relationship-character-bubble::before { position: absolute; top: -6px; right: 20px; width: 10px; height: 10px; border-top: 1px solid color-mix(in srgb, var(--accent) 36%, var(--line)); border-left: 1px solid color-mix(in srgb, var(--accent) 36%, var(--line)); background: var(--surface-soft); content: ""; transform: rotate(45deg); }
+.dialog-fields .relationship-character-search { gap: 5px; }
+.dialog-fields .relationship-character-search input { min-height: 36px; padding: 7px 9px; background: var(--surface); }
+.relationship-character-bubble-meta { display: flex; align-items: center; justify-content: space-between; gap: 10px; color: var(--muted); font-size: 9px; }
+.relationship-character-bubble-meta button { padding: 2px 0; border: 0; background: transparent; color: var(--accent-dark); font-size: 9px; }
+.relationship-character-bubble-meta button:disabled { color: var(--muted); cursor: default; opacity: .45; }
+.relationship-character-options { display: flex; flex-wrap: wrap; gap: 7px; max-height: 220px; overflow-y: auto; padding: 2px 2px 2px 0; }
+.dialog-fields .relationship-character-chip { position: relative; display: inline-flex; width: auto; cursor: pointer; }
+.relationship-character-chip input { position: absolute; width: 1px !important; min-width: 1px; height: 1px; opacity: 0; }
+.relationship-character-chip span { display: inline-flex; align-items: center; min-height: 30px; padding: 5px 10px; border: 1px solid var(--line); border-radius: 16px; background: var(--panel); color: var(--muted); font-size: 10px; transition: background .14s ease, border-color .14s ease, color .14s ease; }
+.relationship-character-chip input:checked + span { border-color: var(--accent); background: var(--accent); color: #fff; }
+.relationship-character-chip input:focus-visible + span { outline: 2px solid var(--accent); outline-offset: 2px; }
+.relationship-character-empty { margin: 0; padding: 18px 8px; color: var(--muted); font-size: 10px; text-align: center; }
+.relationship-analysis-helper { display: flex; gap: 7px; align-items: flex-start; margin: -7px 2px 0; color: var(--muted); font-size: 10px; line-height: 1.55; }
+.relationship-analysis-helper > span:first-child { display: inline-grid; flex: 0 0 16px; width: 16px; height: 16px; margin-top: 1px; place-items: center; border: 1px solid var(--line); border-radius: 50%; color: var(--accent-dark); font-family: var(--font-latin), monospace; font-size: 9px; font-style: normal; font-weight: 700; line-height: 1; }
+.relationship-overwrite-card { display: grid; gap: 5px; padding: 11px 12px; border: 1px solid var(--line); border-radius: 5px; background: var(--surface-soft); transition: border-color .15s ease, background .15s ease, opacity .15s ease; }
+.relationship-overwrite-card .checkbox-field { color: var(--ink); font-size: 11px; font-weight: 600; }
+.relationship-overwrite-card > p { margin: 0 0 0 25px; color: var(--muted); font-size: 10px; line-height: 1.55; }
+.relationship-overwrite-card:has(input:checked) { border-color: color-mix(in srgb, var(--accent) 62%, var(--line)); background: color-mix(in srgb, var(--accent) 7%, var(--surface)); }
 .model-temperature-hint { margin: 0; color: var(--accent-dark); font-size: 10px; line-height: 1.55; }
 .item-list-rows { display: grid; gap: 7px; }
 .item-list-row { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 7px; }

package/dist/store.js

@@ -3607,6 +3607,15 @@ export class Store {
         const timestamp = now();
         const scope = input.scope ?? { type: "book" };
         const sourceVersions = {};
+        if (Array.isArray(scope.characterIds)) {
+            for (const characterId of scope.characterIds) {
+                if (typeof characterId !== "string")
+                    throw new AppError(400, "CHARACTER_REQUIRED", "被分析角色标识无效");
+                const character = this.getCharacter(characterId);
+                if (character.workId !== workId)
+                    throw new AppError(400, "CHARACTER_WORK_MISMATCH", "被分析角色不属于当前作品");
+            }
+        }
         if (typeof scope.chapterId === "string") {
             const chapter = this.getChapter(scope.chapterId);
             if (chapter.workId !== workId)
@@ -3759,17 +3768,23 @@ export class Store {
         };
     }
     taskScopeSummaryFromMaps(scope, chapterSummaries, volumeTitles) {
+        const targetedSuffix = Array.isArray(scope.characterIds) && scope.characterIds.length
+            ? ` · 定向 ${scope.characterIds.length} 人${scope.replaceExistingRelationships === true ? " · 覆盖已有关系" : ""}`
+            : "";
         if (typeof scope.chapterId === "string")
-            return chapterSummaries.get(scope.chapterId) ?? "章节已删除";
+            return `${chapterSummaries.get(scope.chapterId) ?? "章节已删除"}${targetedSuffix}`;
         if (scope.type === "volume" && typeof scope.volumeId === "string") {
             const title = volumeTitles.get(scope.volumeId);
-            return title ? `分卷 · ${title}` : "分卷已删除";
+            return title ? `分卷 · ${title}${targetedSuffix}` : "分卷已删除";
         }
         if (scope.type === "book" || Object.keys(scope).length === 0)
-            return "全书";
+            return `${scope.includeAllSettings === true ? "全书 + 所有设定" : "全书"}${targetedSuffix}`;
         return "未指定范围";
     }
     taskScopeSummary(workId, scope) {
+        const targetedSuffix = Array.isArray(scope.characterIds) && scope.characterIds.length
+            ? ` · 定向 ${scope.characterIds.length} 人${scope.replaceExistingRelationships === true ? " · 覆盖已有关系" : ""}`
+            : "";
         if (typeof scope.chapterId === "string") {
             const chapter = this.db.get(`SELECT chapter.title AS title, volume.title AS volume_title
          FROM chapters chapter
@@ -3779,14 +3794,14 @@ export class Store {
                 return "章节已删除";
             const title = requiredString(chapter, "title");
             const volumeTitle = requiredString(chapter, "volume_title");
-            return `${volumeTitle} · ${title}`;
+            return `${volumeTitle} · ${title}${targetedSuffix}`;
         }
         if (scope.type === "volume" && typeof scope.volumeId === "string") {
             const volume = this.db.get("SELECT title FROM volumes WHERE id = ? AND work_id = ?", scope.volumeId, workId);
-            return volume ? `分卷 · ${requiredString(volume, "title")}` : "分卷已删除";
+            return volume ? `分卷 · ${requiredString(volume, "title")}${targetedSuffix}` : "分卷已删除";
         }
         if (scope.type === "book" || Object.keys(scope).length === 0)
-            return "全书";
+            return `${scope.includeAllSettings === true ? "全书 + 所有设定" : "全书"}${targetedSuffix}`;
         return "未指定范围";
     }
     taskScopeDetails(workId, scope) {