@musnows/scriverse 1.0.7 → 1.0.8

package/dist/public/ai-context-meter.js

@@ -1,3 +1,25 @@
+export function formatAiContextCacheHitPercent(value) {
+  const rate = Number(value);
+  if (!Number.isFinite(rate)) return "—";
+  const clamped = Math.max(0, Math.min(100, Math.round((rate + Number.EPSILON) * 10) / 10));
+  const label = Number.isInteger(clamped) ? String(clamped) : clamped.toFixed(1);
+  return `${label}%`;
+}
+
+export function formatAiContextPercentSummary(usage) {
+  const distribution = normalizeAiContextTokenDistribution(usage);
+  const contextPercent = formatAiContextUsagePercent(distribution.occupiedTokens, distribution.contextWindow);
+  return `context ${contextPercent} · cache hit ${formatAiContextCacheHitPercent(usage?.cacheHitPercent)}`;
+}
+
+export function formatAiContextPopoverDescription(usage) {
+  if (!usage) return "选择可用模型后显示当前上下文用量";
+  const distribution = normalizeAiContextTokenDistribution(usage);
+  const occupied = distribution.occupiedTokens.toLocaleString("zh-CN");
+  const contextWindow = distribution.contextWindow.toLocaleString("zh-CN");
+  return `已占用 ${occupied} / ${contextWindow} tok · ${formatAiContextPercentSummary(usage)}`;
+}
+
 export function formatAiContextUsageTooltip(usage) {
   if (!usage) return "选择可用模型后显示当前上下文用量";
   const inputTokens = Math.max(0, Math.round(Number(usage.inputTokens) || 0)).toLocaleString("zh-CN");
@@ -6,7 +28,23 @@ export function formatAiContextUsageTooltip(usage) {
   const conversationTokens = Math.max(0, Math.round(Number(usage.conversationTokens) || 0)).toLocaleString("zh-CN");
   const conversationBudget = Math.max(0, Math.round(Number(usage.conversationBudgetTokens) || 0)).toLocaleString("zh-CN");
   const outputTokens = Math.max(0, Math.round(Number(usage.outputTokens) || 0)).toLocaleString("zh-CN");
-  return `总输入 ${inputTokens} / ${contextWindow} tok · 作品上下文 ${contextTokens} tok · 对话历史 ${conversationTokens} / ${conversationBudget} tok · 当前调用实际输出 ${outputTokens} tok`;
+  return `总输入 ${inputTokens} / ${contextWindow} tok · 作品上下文 ${contextTokens} tok · 对话历史 ${conversationTokens} / ${conversationBudget} tok · 当前调用实际输出 ${outputTokens} tok · ${formatAiContextPercentSummary(usage)}`;
+}
+
+export function attachAiContextCacheHitPercent(usage, cacheHitPercent) {
+  if (!usage || typeof usage !== "object" || Array.isArray(usage)) return usage ?? null;
+  const rate = Number(cacheHitPercent);
+  if (!Number.isFinite(rate)) return usage;
+  return { ...usage, cacheHitPercent: Math.max(0, Math.min(100, rate)) };
+}
+
+function withPreservedCacheHitPercent(previousUsage, nextUsage) {
+  if (!nextUsage || typeof nextUsage !== "object" || Array.isArray(nextUsage)) return nextUsage;
+  const nextCacheHit = Number(nextUsage.cacheHitPercent);
+  if (Number.isFinite(nextCacheHit)) return nextUsage;
+  const previousCacheHit = Number(previousUsage?.cacheHitPercent);
+  if (!Number.isFinite(previousCacheHit)) return nextUsage;
+  return { ...nextUsage, cacheHitPercent: previousCacheHit };
 }
 
 function tokenCount(value) {
@@ -14,7 +52,8 @@ function tokenCount(value) {
 }
 
 export function resolveAiContextUsage(previousUsage, nextUsage) {
-  return nextUsage && typeof nextUsage === "object" ? nextUsage : previousUsage ?? null;
+  if (!nextUsage || typeof nextUsage !== "object") return previousUsage ?? null;
+  return withPreservedCacheHitPercent(previousUsage, nextUsage);
 }
 
 const maximumAiContextUsageFields = [
@@ -28,7 +67,9 @@ const minimumAiContextUsageFields = ["remainingTokens"];
 
 export function mergeAiContextUsage(previousUsage, nextUsage, allowShrink = false) {
   if (!nextUsage || typeof nextUsage !== "object" || Array.isArray(nextUsage)) return previousUsage ?? null;
-  if (!previousUsage || typeof previousUsage !== "object" || Array.isArray(previousUsage) || allowShrink) return nextUsage;
+  if (!previousUsage || typeof previousUsage !== "object" || Array.isArray(previousUsage) || allowShrink) {
+    return withPreservedCacheHitPercent(previousUsage, nextUsage);
+  }
   const mergedUsage = { ...nextUsage };
   for (const field of [...maximumAiContextUsageFields, ...minimumAiContextUsageFields]) {
     const previousValue = Number(previousUsage[field]);
@@ -41,7 +82,7 @@ export function mergeAiContextUsage(previousUsage, nextUsage, allowShrink = fals
     else if (Number.isFinite(previousValue)) mergedUsage[field] = previousValue;
     else if (Number.isFinite(nextValue)) mergedUsage[field] = nextValue;
   }
-  return mergedUsage;
+  return withPreservedCacheHitPercent(previousUsage, mergedUsage);
 }
 
 export function formatAiContextUsagePercent(occupiedTokens, contextWindow) {

package/dist/public/ai-render-scheduler.js

@@ -0,0 +1,30 @@
+export function createAiRenderScheduler({ isVisible, isConnected = () => true, schedule = requestAnimationFrame, now = () => performance.now(), intervalMs = 32, budgetMs = 4 }) {
+  const pending = new Map();
+  let frame = null;
+  let lastRendered = -Infinity;
+  const refresh = () => {
+    for (const target of pending.keys()) {
+      if (!isConnected(target)) pending.delete(target);
+    }
+    if (frame !== null || ![...pending.keys()].some(isVisible)) return;
+    frame = schedule(() => {
+      frame = null;
+      const started = now();
+      if (started - lastRendered >= intervalMs) {
+        for (const [target, render] of pending) {
+          if (!isConnected(target)) { pending.delete(target); continue; }
+          if (!isVisible(target)) continue;
+          pending.delete(target);
+          render();
+          lastRendered = started;
+          if (now() - started >= budgetMs) break;
+        }
+      }
+      refresh();
+    });
+  };
+  return {
+    enqueue(target, render) { pending.set(target, render); refresh(); },
+    refresh
+  };
+}

package/dist/public/app.js

@@ -1,7 +1,9 @@
 import { buildRelationshipGraph, createGalaxyRenderer, normalizeGalaxyFrameRate, normalizeGalaxyMotionMode, renderRelationshipMindMap } from "/relationship-graph.js?v=20260817-relationship-canvas-scale-v1&feature=galaxy-motion-mode-v3&feature=galaxy-edge-label-threshold-v1";
 import { formatDateTime, normalizeParagraphSpacing } from "/text-formatting.js?v=20260713-saved-at-seconds";
 import { countProseWords } from "/text-count.js?v=20260906-chapter-word-count-consistency-v1";
-import { renderMarkdown } from "/markdown.js?v=20260830-adjacent-blockquotes-v1";
+import { renderMarkdown } from "/markdown.js?v=20260912-stream-render-v2";
+import { createStreamingMarkdownRenderer } from "/stream-markdown.js?v=20260912-stream-render-v2";
+import { createAiRenderScheduler } from "/ai-render-scheduler.js?v=20260912-stream-render-v2";
 import { createImWorkspace } from "/im.js?v=20260904-im-judge-outcomes-v106";
 import { findAiMention, listAiMentionOptions, mergeAiReferenceScope, userMessageMentionNames } from "/ai-mentions.js?v=20260811-user-message-mentions-v1";
 import { applyAiSkillCommand, findAiSkillCommand, listAiSkillOptions } from "/ai-skill-menu.js?v=20260830-ai-skill-slash-menu-v1";
@@ -32,11 +34,11 @@ import { MIN_MODEL_CONTEXT_WINDOW, MODEL_PURPOSE_OPTIONS, MODEL_THINKING_EFFORT_
 import { connectivityConfigurationSavedToast, connectivityTestErrorToast, connectivityTestResultToast } from "/ai-connectivity-test.js?v=20260822-private-ai-endpoint-hint-v1";
 import { shouldSendAiPrompt } from "/ai-prompt-keyboard.js?v=20260713-enter-to-send";
 import { estimateAiMessageTokens, formatAiMessageMeta } from "/ai-message-meta.js?v=20260814-ai-model-lock-v1";
-import { createStreamTypewriter, createStreamTypewriterSpeedController } from "/stream-typewriter.js?v=20260906-background-stream-v2";
+import { createStreamTypewriter, createStreamTypewriterSpeedController } from "/stream-typewriter.js?v=20260912-stream-render-v2";
 import { assertAiStreamCompleted, readAiEventStream } from "/ai-stream-protocol.js?v=20260812-ai-stream-complete-v1";
 import { buildUsageCalendar, formatCacheHitRate, formatEstimatedCost, formatTokenCount, usageCalendarYears } from "/ai-usage.js?v=20260830-ai-usage-year-v1";
 import { formatAiMessageTime } from "/ai-message-time.js?v=20260801-month-day-time";
-import { formatAiContextUsagePercent, formatAiContextUsageTooltip, mergeAiContextUsage, normalizeAiContextTokenDistribution, resolveAiContextUsage } from "/ai-context-meter.js?v=20260828-context-output-usage-v1";
+import { attachAiContextCacheHitPercent, formatAiContextPopoverDescription, formatAiContextUsageTooltip, mergeAiContextUsage, normalizeAiContextTokenDistribution, resolveAiContextUsage } from "/ai-context-meter.js?v=20260911-context-cache-hit-v1";
 import { isPhoneClient } from "/phone-client.js?v=20260819-phone-client-v1";
 import { formatAiToolCallResult } from "/ai-tool-call.js?v=20260801-ai-tool-result-chars-v1";
 import {
@@ -2688,6 +2690,7 @@ function activateAiChatTab(tabId, { persistCurrent = true, force = false } = {})
     feed.id = feed === tab.feed ? "ai-feed" : `ai-chat-panel-${feed.dataset.aiTabId}`;
   }
   tab.feed.classList.remove("hidden");
+  aiStreamRenders.refresh();
   applyAiChatTabState(tab);
   renderAiChatTabs();
   return tab;
@@ -2703,6 +2706,7 @@ function closeAiChatTab(tabId) {
   }
   const { active } = aiChatTabManager.close(tab.id);
   tab.feed.remove();
+  aiStreamRenders.refresh();
   if (!wasActive) {
     renderAiChatTabs();
     return;
@@ -3087,6 +3091,42 @@ const aiFeedScrollFrames = new WeakMap();
 const aiFeedAutoScrollStates = new WeakMap();
 const aiFeedScrollBindings = new WeakSet();
 const aiProcessScrollFrames = new WeakMap();
+const aiProcessRenderStates = new WeakMap();
+const aiMarkdownRenderers = new WeakMap();
+function aiStreamTargetVisible(target) {
+  target = target.element ?? target;
+  const feed = target.closest(".ai-feed");
+  const app = $("#app");
+  return document.visibilityState !== "hidden" && Boolean(feed?.isConnected)
+    && !feed.classList.contains("hidden") && !app.classList.contains("shelf-mode")
+    && (!app.classList.contains("ai-panel-collapsed") || app.classList.contains("ai-workspace-mode"));
+}
+const aiStreamRenders = createAiRenderScheduler({
+  isVisible: aiStreamTargetVisible,
+  isConnected: (target) => (target.element ?? target).isConnected
+});
+document.addEventListener("visibilitychange", () => aiStreamRenders.refresh());
+// 只监听面板显隐，不观察正文或消息内容，避免渲染自身触发新的刷新。
+const aiPanelVisibilityObserver = new MutationObserver(() => aiStreamRenders.refresh());
+aiPanelVisibilityObserver.observe($("#app"), { attributes: true, attributeFilter: ["class"] });
+
+function updateAiMarkdown(body, content) {
+  let render = aiMarkdownRenderers.get(body);
+  if (!render) {
+    const target = { element: body };
+    render = createStreamingMarkdownRenderer(body, {
+      enqueue: (callback) => queueMicrotask(() => aiStreamRenders.enqueue(target, callback)),
+      onRender: () => {
+        const message = body.closest(".assistant-message");
+        if (message?.classList.contains("is-streaming")) scrollAiProcessStepsToBottom(message);
+        const feed = body.closest(".ai-feed");
+        if (feed) scrollAiFeedToBottom(feed);
+      }
+    });
+    aiMarkdownRenderers.set(body, render);
+  }
+  return render(content);
+}
 const AI_FEED_BOTTOM_THRESHOLD_PX = 24;
 let markdownTableMenuTarget = null;
 let markdownTableMenuTrigger = null;
@@ -3153,9 +3193,8 @@ function scrollAiFeedToBottom(feed = $("#ai-feed"), { force = false } = {}) {
   bindAiFeedAutoScroll(feed);
   if (force) aiFeedAutoScrollStates.set(feed, true);
   if (!aiFeedAutoScrollStates.get(feed)) return;
-  feed.scrollTop = feed.scrollHeight;
   const currentFrame = aiFeedScrollFrames.get(feed);
-  if (currentFrame !== undefined) window.cancelAnimationFrame(currentFrame);
+  if (currentFrame !== undefined || !aiStreamTargetVisible(feed)) return;
   const nextFrame = window.requestAnimationFrame(() => {
     feed.scrollTop = feed.scrollHeight;
     aiFeedScrollFrames.delete(feed);
@@ -3169,9 +3208,8 @@ function scrollAiProcessStepsToBottom(message) {
       body.scrollTop = body.scrollHeight;
     });
   };
-  scroll();
   const currentFrame = aiProcessScrollFrames.get(message);
-  if (currentFrame !== undefined) window.cancelAnimationFrame(currentFrame);
+  if (currentFrame !== undefined || !aiStreamTargetVisible(message)) return;
   const nextFrame = window.requestAnimationFrame(() => {
     scroll();
     aiProcessScrollFrames.delete(message);
@@ -3724,74 +3762,80 @@ function shouldRenderAiProcessStep(step) {
 }
 
 function renderAiProcessSteps(message, steps, completed, durationMs = null, visibleContents = null) {
-  const previousDetails = message.querySelector(".ai-process-details");
-  const previousScrollStates = new Map();
-  previousDetails?.querySelectorAll(".ai-process-step[data-ai-process-step-id]").forEach((section) => {
-    const body = section.querySelector(".ai-process-step-body");
-    if (!body) return;
-    previousScrollStates.set(section.dataset.aiProcessStepId, {
-      scrollTop: body.scrollTop,
-      nearBottom: body.scrollHeight - body.scrollTop - body.clientHeight < 24
-    });
-  });
-  previousDetails?.remove();
+  const cached = aiProcessRenderStates.get(message);
   const renderableSteps = (Array.isArray(steps) ? steps : []).filter(shouldRenderAiProcessStep);
-  if (!renderableSteps.length) return;
-  const details = document.createElement("details");
+  if (!renderableSteps.length) {
+    cached?.details.remove();
+    aiProcessRenderStates.delete(message);
+    return;
+  }
+  const details = cached?.details ?? document.createElement("details");
   details.className = "ai-process-details";
   // 存在待确认/待回答的交互卡片时保持展开，避免审批入口在历史消息中被折叠。
   details.open = !completed || steps.some((step) => step?.type === "tool" && isInteractiveToolPending(step.toolCall));
-  const summary = document.createElement("summary");
-  const title = document.createElement("span");
+  const summary = cached?.summary ?? document.createElement("summary");
+  const title = cached?.title ?? document.createElement("span");
   title.textContent = completed ? "思考与执行过程" : "正在思考与执行";
-  const status = document.createElement("small");
+  const status = cached?.status ?? document.createElement("small");
   const duration = durationMs === null || durationMs === undefined ? "" : formatAiProcessDuration(durationMs);
   status.textContent = `${renderableSteps.length} 个步骤${duration ? ` · 耗时 ${duration}` : ""}`;
-  summary.append(title, status);
-  const list = document.createElement("div");
+  if (!cached) summary.append(title, status);
+  const list = cached?.list ?? document.createElement("div");
   list.className = "ai-process-list";
-  for (const step of renderableSteps) {
+  const entries = new Map();
+  const nextNodes = [];
+  for (const [index, step] of renderableSteps.entries()) {
+    const key = `${step.type}:${String(step.id ?? index)}`;
+    const previous = cached?.entries.get(key);
     if (step?.type === "context_compaction") {
-      list.append(createAiContextCompactionDivider({
+      const divider = previous?.node ?? createAiContextCompactionDivider({
         kind: "tool",
         ariaLabel: `第 ${Number(step.round) || 1} 轮已压缩上下文`,
         title: `已将 ${Number(step.sourceMessageCount) || 0} 条工具上下文压缩为摘要`
-      }));
+      });
+      entries.set(key, { node: divider });
+      nextNodes.push(divider);
       continue;
     }
     if (step?.type === "tool" && step.toolCall) {
+      if (previous?.value === step.toolCall) {
+        entries.set(key, previous);
+        nextNodes.push(previous.node);
+        continue;
+      }
       const tool = document.createElement("section");
       tool.className = "ai-process-step ai-process-tool-step";
       const label = document.createElement("small");
       label.textContent = `第 ${Number(step.round) || 1} 轮 · 工具调用`;
       tool.append(label, createAiToolCallButton(step.toolCall));
-      list.append(tool);
+      entries.set(key, { node: tool, value: step.toolCall });
+      nextNodes.push(tool);
       continue;
     }
-    const section = document.createElement("section");
+    const section = previous?.node ?? document.createElement("section");
     section.className = `ai-process-step ai-process-${step.type}-step`;
     section.dataset.aiProcessStepId = `${step.type}:${String(step.id ?? step.round ?? "")}`;
-    const label = document.createElement("small");
+    const label = previous?.label ?? document.createElement("small");
     label.textContent = `第 ${Number(step.round) || 1} 轮 · ${step.type === "thinking" ? "Thinking" : "中间输出"}`;
-    const body = document.createElement("div");
+    const body = previous?.body ?? document.createElement("div");
     body.className = "message-body ai-process-step-body";
     const content = visibleContents?.has(step) ? visibleContents.get(step) : step.content;
-    body.innerHTML = renderMarkdown(content);
-    section.append(label, body);
-    list.append(section);
-  }
-  details.append(summary, list);
-  list.querySelectorAll(".ai-process-step[data-ai-process-step-id]").forEach((section) => {
-    const scrollState = previousScrollStates.get(section.dataset.aiProcessStepId);
-    const body = section.querySelector(".ai-process-step-body");
-    if (!scrollState || !body) return;
-    body.scrollTop = scrollState.nearBottom
-      ? body.scrollHeight
-      : Math.min(scrollState.scrollTop, body.scrollHeight);
-  });
-  const body = message.querySelector(".message-body");
-  if (body) body.before(details);
-  else message.append(details);
+    updateAiMarkdown(body, content);
+    if (!previous) section.append(label, body);
+    entries.set(key, { node: section, label, body });
+    nextNodes.push(section);
+  }
+  if (!cached) details.append(summary, list);
+  nextNodes.forEach((node, index) => {
+    if (list.children[index] !== node) list.insertBefore(node, list.children[index] ?? null);
+  });
+  while (list.children.length > nextNodes.length) list.lastElementChild.remove();
+  if (!cached) {
+    const body = message.querySelector(".message-body");
+    if (body) body.before(details);
+    else message.append(details);
+  }
+  aiProcessRenderStates.set(message, { details, summary, title, status, list, entries, completed });
   if (!completed) scrollAiProcessStepsToBottom(message);
 }
 
@@ -9108,6 +9152,7 @@ function openChapterTypeMenu(chapterId, clientX, clientY) {
   menu.querySelector("strong").textContent = `操作“${chapter.title}”`;
   menu.querySelectorAll("[data-chapter-type], [data-delete-chapter]").forEach((button) => button.classList.toggle("hidden", !canManageChapter));
   menu.querySelector("[data-add-chapter-ai-reference]")?.classList.toggle("hidden", !canAddAiReference);
+  menu.querySelector("#chapter-type-ai-reference-separator")?.classList.toggle("hidden", !(canManageChapter && canAddAiReference));
   menu.querySelectorAll("[data-chapter-type]").forEach((button) => {
     button.classList.toggle("active", button.dataset.chapterType === (chapter.chapterType || "正文"));
     button.setAttribute("aria-checked", String(button.classList.contains("active")));
@@ -14633,10 +14678,7 @@ function renderAiContextDistribution(usage) {
   const popover = $("#ai-context-popover");
   const host = $("#ai-context-distribution");
   const distribution = normalizeAiContextTokenDistribution(usage);
-  const contextWindow = distribution.contextWindow.toLocaleString("zh-CN");
-  $("#ai-context-popover-description").textContent = usage
-    ? `已占用 ${distribution.occupiedTokens.toLocaleString("zh-CN")} / ${contextWindow} tok · ${formatAiContextUsagePercent(distribution.occupiedTokens, distribution.contextWindow)}`
-    : "选择可用模型后显示当前上下文用量";
+  $("#ai-context-popover-description").textContent = formatAiContextPopoverDescription(usage);
   host.replaceChildren(...distribution.items.map((item) => {
     const row = document.createElement("div");
     row.className = "ai-context-distribution-row";
@@ -14678,13 +14720,11 @@ function setAiContextMeter(usage, allowShrink = true) {
     : mergeAiContextUsage(latestAiContextUsage, usage, false);
   latestAiContextUsage = displayUsage;
   const meter = $("#ai-context-meter");
-  const value = meter.querySelector("b");
   const distribution = renderAiContextDistribution(displayUsage);
   if (!displayUsage) {
     meter.classList.add("is-empty");
     meter.classList.remove("is-warning", "is-danger");
     meter.style.setProperty("--context-usage", "0");
-    value.textContent = "—";
     const tooltip = formatAiContextUsageTooltip(null);
     meter.dataset.tooltip = tooltip;
     meter.setAttribute("aria-label", tooltip);
@@ -14697,7 +14737,6 @@ function setAiContextMeter(usage, allowShrink = true) {
   meter.classList.toggle("is-warning", percent >= 70 && percent < 90);
   meter.classList.toggle("is-danger", percent >= 90);
   meter.style.setProperty("--context-usage", String(percent));
-  value.textContent = formatAiContextUsagePercent(distribution.occupiedTokens, distribution.contextWindow);
   const tooltip = formatAiContextUsageTooltip(displayUsage);
   meter.dataset.tooltip = tooltip;
   meter.setAttribute("aria-label", `当前上下文用量：${tooltip}`);
@@ -18494,11 +18533,15 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
   };
   const typewriter = createStreamTypewriter({
     speedController: streamSpeedController,
+    shouldAnimate: () => aiStreamTargetVisible(feed),
     onRender: (text, progress) => {
       if (!aiRequestTargetsCurrentState(requestHolder.snapshot) || !mountAssistantMessage()) return;
-      content.innerHTML = renderMarkdown(text);
-      renderAiStreamingCharacterProgress(meta, progress.visibleCharacters);
-      scrollAiFeedToBottom(feed);
+      aiStreamRenders.enqueue(content, () => {
+        if (!aiRequestTargetsCurrentState(requestHolder.snapshot) && message.classList.contains("is-streaming")) return;
+        updateAiMarkdown(content, text);
+        if (message.classList.contains("is-streaming")) renderAiStreamingCharacterProgress(meta, progress.visibleCharacters);
+        scrollAiFeedToBottom(feed);
+      });
     }
   });
   let streamedText = "";
@@ -18522,7 +18565,10 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
   const processStepVisibleContents = new Map();
   const renderStreamingProcessSteps = (completed, durationMs = elapsedProcessTime()) => {
     if (!aiRequestTargetsCurrentState(requestHolder.snapshot)) return;
-    renderAiProcessSteps(message, processSteps, completed, durationMs, processStepVisibleContents);
+    aiStreamRenders.enqueue(message, () => {
+      renderAiProcessSteps(message, processSteps, completed, durationMs, processStepVisibleContents);
+      scrollAiFeedToBottom(feed);
+    });
   };
   const processStepTypewriter = (step) => {
     const existing = processStepTypewriters.get(step);
@@ -18530,6 +18576,7 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
     processStepVisibleContents.set(step, "");
     const typewriter = createStreamTypewriter({
       speedController: streamSpeedController,
+      shouldAnimate: () => aiStreamTargetVisible(feed),
       onRender: (text) => {
         if (!aiRequestTargetsCurrentState(requestHolder.snapshot)) return;
         processStepVisibleContents.set(step, text);
@@ -18692,7 +18739,7 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
           || writingSuggestion?.processSteps?.some((step) => step?.toolCall?.status === "failed");
         if (writingSuggestionFailed) setAiChatTabStatus(tab, "error");
         const announcedCompaction = contextAction === "compacted" || streamContextCompacted;
-        setAiChatTabContextUsage(tab, payload.contextUsage, announcedCompaction);
+        setAiChatTabContextUsage(tab, attachAiContextCacheHitPercent(payload.contextUsage, payload.cacheHitPercent), announcedCompaction);
         await Promise.all([typewriter.finish(), finishProcessStepTypewriters()]);
         assertAiRequestCurrent(requestHolder.snapshot);
         message.classList.remove("is-streaming");
@@ -18715,7 +18762,7 @@ async function streamChat(requestHolder, body, idempotencyKey, { endpoint = null
             writingSuggestionId: writingSuggestion.id
           } : {})
         };
-        renderAiProcessSteps(message, processSteps, true, processDurationMs);
+        renderStreamingProcessSteps(true, processDurationMs);
         meta.textContent = formatAiMessageMeta(payload.model?.displayName, payload.outputTokens, payload.cacheHitPercent, "", processDurationMs);
         attachAssistantCopyAction(message, streamedText);
         scrollAiFeedToBottom(feed);

package/dist/public/index.html

@@ -9,7 +9,7 @@
     <script src="/theme-init.js?v=20260827-reader-prefetch-v1"></script>
     <link rel="icon" href="/icon.svg?v=20260712" type="image/svg+xml">
     <link rel="manifest" href="/site.webmanifest">
-    <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=chapter-comment-filters-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=ai-stream-character-count-five-digit-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&feature=editor-toolbar-compact-v2&feature=reader-first-frame-v1&feature=auth-compact-v2&feature=editor-preview-toggle-v2&feature=setting-title-chrome-v2&feature=entity-pin-icon-center-v1&feature=chapter-center-bottom-space-v1&feature=work-editor-preferences-v1&feature=work-editor-preference-checkbox-v1&feature=ai-roleplay-memory-v2&feature=ai-roleplay-memory-v3&feature=ai-roleplay-memory-v5&feature=character-editor-header-actions-v1&feature=roleplay-memory-header-actions-v1&feature=roleplay-memory-action-icons-v1&feature=roleplay-memory-action-colors-v1&feature=roleplay-memory-pin-border-v1&feature=ai-write-tools-v2&feature=ai-write-card-actions-compact-v1&feature=ai-write-plan-actions-footer-v1&feature=ai-question-actions-footer-v1&feature=ai-question-selection-highlight-v1&feature=ai-question-submit-guidance-v1&feature=ai-question-answer-limit-v1&feature=ai-question-batch-v1&feature=semantic-search-v6&feature=chapter-title-renumber-v1&feature=ai-writing-skills-v1&feature=remote-mcp-v1&feature=character-alias-chips-v2&feature=character-title-input-v1&feature=character-detail-value-wrap-v2&feature=ai-settings-textarea-font-v1&feature=ai-usage-stat-display-v1&feature=ai-usage-year-v1&feature=ai-skill-slash-menu-v1&feature=ai-message-citation-popover-v1&feature=line-citation-menu-separator-v1&feature=global-im-v106&feature=im-sidebar-compact-v1&feature=im-narration-contrast-v1&feature=im-member-add-plus-v2&feature=im-button-hierarchy-v1&feature=im-icon-button-size-v1&feature=compact-sidebar-directory-v5&feature=ai-model-config-dialog-v1&feature=system-prompt-override-v3&feature=continuation-guard-failure-details-v1&feature=entity-editor-back-icon-v1&feature=toast-stack-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=ai-composer-compact-controls-v1&feature=ai-context-meter-ring-only-v1&feature=ai-context-cache-hit-v1&feature=annotation-line-counts-v1&feature=chapter-comment-filters-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=ai-stream-character-count-five-digit-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&feature=editor-toolbar-compact-v2&feature=reader-first-frame-v1&feature=auth-compact-v2&feature=editor-preview-toggle-v2&feature=setting-title-chrome-v2&feature=entity-pin-icon-center-v1&feature=chapter-center-bottom-space-v1&feature=work-editor-preferences-v1&feature=work-editor-preference-checkbox-v1&feature=ai-roleplay-memory-v2&feature=ai-roleplay-memory-v3&feature=ai-roleplay-memory-v5&feature=character-editor-header-actions-v1&feature=roleplay-memory-header-actions-v1&feature=roleplay-memory-action-icons-v1&feature=roleplay-memory-action-colors-v1&feature=roleplay-memory-pin-border-v1&feature=ai-write-tools-v2&feature=ai-write-card-actions-compact-v1&feature=ai-write-plan-actions-footer-v1&feature=ai-question-actions-footer-v1&feature=ai-question-selection-highlight-v1&feature=ai-question-submit-guidance-v1&feature=ai-question-answer-limit-v1&feature=ai-question-batch-v1&feature=semantic-search-v6&feature=chapter-title-renumber-v1&feature=ai-writing-skills-v1&feature=remote-mcp-v1&feature=character-alias-chips-v2&feature=character-title-input-v1&feature=character-detail-value-wrap-v2&feature=ai-settings-textarea-font-v1&feature=ai-usage-stat-display-v1&feature=ai-usage-year-v1&feature=ai-skill-slash-menu-v1&feature=ai-message-citation-popover-v1&feature=line-citation-menu-separator-v1&feature=global-im-v106&feature=im-sidebar-compact-v1&feature=im-narration-contrast-v1&feature=im-member-add-plus-v2&feature=im-button-hierarchy-v1&feature=im-icon-button-size-v1&feature=compact-sidebar-directory-v5&feature=ai-model-config-dialog-v1&feature=system-prompt-override-v3&feature=continuation-guard-failure-details-v1&feature=entity-editor-back-icon-v1&feature=toast-stack-v1">
   </head>
   <body class="auth-pending">
     <section id="auth-view" class="auth-view hidden" aria-labelledby="auth-title">
@@ -440,7 +440,7 @@
             <div id="ai-prompt" class="ai-prompt" contenteditable="true" role="textbox" aria-multiline="true" aria-autocomplete="list" aria-controls="ai-mention-menu" aria-haspopup="listbox" aria-expanded="false" aria-keyshortcuts="Enter" title="Enter 发送，Shift+Enter 换行" data-placeholder="告诉 AI 你想讨论或修改什么……"></div>
             <div id="ai-mention-menu" class="ai-mention-menu hidden" role="listbox" aria-label="引用角色、设定、章节或上下文能力"></div>
             <div class="prompt-composer-actions">
-              <button id="ai-context-meter" class="ai-context-meter is-empty" type="button" aria-haspopup="dialog" aria-expanded="false" aria-controls="ai-context-popover" aria-live="polite" aria-label="当前上下文用量"><b>—</b></button>
+              <button id="ai-context-meter" class="ai-context-meter is-empty" type="button" aria-haspopup="dialog" aria-expanded="false" aria-controls="ai-context-popover" aria-live="polite" aria-label="当前上下文用量"></button>
               <section id="ai-context-popover" class="ai-context-popover hidden" role="dialog" aria-labelledby="ai-context-popover-title" aria-describedby="ai-context-popover-description">
                 <header class="ai-context-popover-header"><div><strong id="ai-context-popover-title">Token 分布</strong><small id="ai-context-popover-description">按当前模型上下文窗口计算</small></div><button id="ai-context-popover-close" class="ai-context-popover-close" type="button" aria-label="关闭 Token 分布">×</button></header>
                 <div id="ai-context-distribution" class="ai-context-distribution" role="list" aria-label="当前 Token 分布"></div>
@@ -522,6 +522,7 @@
         <button type="button" role="menuitemradio" data-chapter-type="设定">设定</button>
         <button type="button" role="menuitemradio" data-chapter-type="作者的话">作者的话</button>
         <button type="button" role="menuitemradio" data-chapter-type="其他">其他</button>
+        <div id="chapter-type-ai-reference-separator" class="line-citation-menu-separator hidden" role="separator" aria-orientation="horizontal"></div>
         <button type="button" role="menuitem" data-add-chapter-ai-reference>添加到助手引用</button>
         <button class="danger-button" type="button" role="menuitem" data-delete-chapter>删除章节</button>
       </div>
@@ -1426,6 +1427,7 @@
     </dialog>
 
     <div id="auth-loading" class="auth-loading" role="status" aria-label="正在载入工作台"></div>
-    <script type="module" src="/app.js?v=20260816-extended-thinking-effort-v1&feature=ai-history-rename-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-v2&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&feature=ai-context-input-output-v1&feature=editor-blank-lines-preserved-v1&feature=reader-first-frame-v1&feature=vditor-lazy-load-v1&feature=ui-module-preload-v1&feature=reader-initial-prefetch-v1&feature=editor-preview-toggle-v2&feature=vditor-fullscreen-disabled-v1&feature=chapter-auto-indent-v1&feature=chapter-centered-scroll-v1&feature=work-editor-preferences-v1&feature=ai-context-output-usage-v1&feature=ai-roleplay-memory-v4&feature=ai-roleplay-memory-v5&feature=roleplay-memory-header-actions-v1&feature=roleplay-memory-header-toolbar-v1&feature=roleplay-memory-action-icons-v1&feature=roleplay-memory-action-colors-v1&feature=annotation-line-anchor-v1&feature=stable-line-ids-v1&feature=live-annotation-anchors-v1&feature=chapter-comment-filters-v1&feature=ai-write-tools-v3&feature=ai-question-option-supplement-v1&feature=ai-question-selection-highlight-v1&feature=ai-question-continuation-ui-v3&feature=ai-background-stream-v1&feature=ai-question-tool-result-v1&feature=ai-question-tool-summary-v1&feature=ai-question-submit-guidance-v1&feature=ai-question-batch-v1&feature=ai-question-answer-limit-v1&feature=semantic-search-v6&feature=chapter-title-renumber-v1&feature=ai-writing-skills-v3&feature=ai-cancel-preserve-process-v2&feature=remote-mcp-v1&feature=character-alias-chips-v2&feature=character-title-input-v1&feature=character-detail-value-wrap-v2&feature=chapter-batch-editor-refresh-v1&feature=ai-usage-stat-display-v1&feature=ai-usage-year-v1&feature=semantic-search-rag-label-v1&feature=ai-skill-slash-menu-v1&feature=ai-roleplay-scene-bubble-v1&feature=ai-roleplay-scene-collapse-v1&feature=markdown-adjacent-blockquotes-v1&feature=chapter-save-shortcut-v2&feature=ai-message-citation-popover-v1&feature=line-citation-menu-separator-v1&feature=global-im-v106&feature=im-sidebar-compact-v1&feature=ai-fork-progress-toast-v1&feature=im-settings-gear-v1&feature=compact-sidebar-directory-v2&feature=chapter-word-count-consistency-v1&feature=continuation-guard-failure-details-v1&feature=ai-all-message-references-v2&feature=ai-question-render-recovery-v3&feature=ai-suggestion-editor-boundary-v1&feature=setting-category-preservation-v1&feature=toast-stack-v1&feature=toast-stack-label-v2&feature=agent-tool-limits-300-v1&feature=server-dev-logo-v1&feature=chapter-directory-ai-reference-v2&feature=ai-error-origin-v1"></script>
+    <script type="module" src="/app.js?v=20260816-extended-thinking-effort-v1&feature=ai-history-rename-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-v2&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&feature=ai-context-input-output-v1&feature=editor-blank-lines-preserved-v1&feature=reader-first-frame-v1&feature=vditor-lazy-load-v1&feature=ui-module-preload-v1&feature=reader-initial-prefetch-v1&feature=editor-preview-toggle-v2&feature=vditor-fullscreen-disabled-v1&feature=chapter-auto-indent-v1&feature=chapter-centered-scroll-v1&feature=work-editor-preferences-v1&feature=ai-context-output-usage-v1&feature=ai-context-meter-ring-only-v1&feature=ai-context-cache-hit-v1&feature=ai-roleplay-memory-v4&feature=ai-roleplay-memory-v5&feature=roleplay-memory-header-actions-v1&feature=roleplay-memory-header-toolbar-v1&feature=roleplay-memory-action-icons-v1&feature=roleplay-memory-action-colors-v1&feature=annotation-line-anchor-v1&feature=stable-line-ids-v1&feature=live-annotation-anchors-v1&feature=chapter-comment-filters-v1&feature=ai-write-tools-v3&feature=ai-question-option-supplement-v1&feature=ai-question-selection-highlight-v1&feature=ai-question-continuation-ui-v3&feature=ai-background-stream-v1&feature=ai-question-tool-result-v1&feature=ai-question-tool-summary-v1&feature=ai-question-submit-guidance-v1&feature=ai-question-batch-v1&feature=ai-question-answer-limit-v1&feature=semantic-search-v6&feature=chapter-title-renumber-v1&feature=ai-writing-skills-v3&feature=ai-cancel-preserve-process-v2&feature=remote-mcp-v1&feature=character-alias-chips-v2&feature=character-title-input-v1&feature=character-detail-value-wrap-v2&feature=chapter-batch-editor-refresh-v1&feature=ai-usage-stat-display-v1&feature=ai-usage-year-v1&feature=semantic-search-rag-label-v1&feature=ai-skill-slash-menu-v1&feature=ai-roleplay-scene-bubble-v1&feature=ai-roleplay-scene-collapse-v1&feature=markdown-adjacent-blockquotes-v1&feature=chapter-save-shortcut-v2&feature=ai-message-citation-popover-v1&feature=line-citation-menu-separator-v1&feature=global-im-v106&feature=im-sidebar-compact-v1&feature=ai-fork-progress-toast-v1&feature=im-settings-gear-v1&feature=compact-sidebar-directory-v2&feature=chapter-word-count-consistency-v1&feature=continuation-guard-failure-details-v1&feature=ai-all-message-references-v2&feature=ai-question-render-recovery-v3&feature=ai-suggestion-editor-boundary-v1&feature=setting-category-preservation-v1&feature=toast-stack-v1&feature=toast-stack-label-v2&feature=agent-tool-limits-300-v1&feature=server-dev-logo-v1&feature=chapter-directory-ai-reference-v3&feature=ai-error-origin-v1&feature=ai-stream-render-performance-v2"></script>
+
   </body>
 </html>

package/dist/public/markdown.js

@@ -142,8 +142,20 @@ function renderMarkdownTable(headers, alignments, rows) {
 }
 
 export function renderMarkdown(value) {
+  return renderMarkdownParts(value).map((part) => part.html).join("");
+}
+
+export function renderMarkdownParts(value) {
   const lines = String(value ?? "").replace(/\r\n?/gu, "\n").split("\n");
   const output = [];
+  const offsets = [];
+  let offset = 0;
+  for (const line of lines) {
+    offsets.push(offset);
+    offset += line.length + 1;
+  }
+  let lineIndex = 0;
+  const emit = (html, endLine = lineIndex) => output.push({ html, end: offsets[endLine] ?? offset - 1 });
   let paragraph = [];
   let list = null;
   let quote = null;
@@ -151,12 +163,12 @@ export function renderMarkdown(value) {
 
   const flushParagraph = () => {
     if (!paragraph.length) return;
-    output.push(`<p>${paragraph.map(renderInlineMarkdown).join("<br>")}</p>`);
+    emit(`<p>${paragraph.map(renderInlineMarkdown).join("<br>")}</p>`);
     paragraph = [];
   };
   const flushList = () => {
     if (!list) return;
-    output.push(`<${list.tag}>${list.items.map((item) => `<li class="markdown-depth-${item.depth}">${renderInlineMarkdown(item.text)}</li>`).join("")}</${list.tag}>`);
+    emit(`<${list.tag}>${list.items.map((item) => `<li class="markdown-depth-${item.depth}">${renderInlineMarkdown(item.text)}</li>`).join("")}</${list.tag}>`);
     list = null;
   };
   const flushQuote = () => {
@@ -166,7 +178,7 @@ export function renderMarkdown(value) {
       const html = content.split(/\n\s*\n/gu)
         .map((part) => part.split("\n").map(renderInlineMarkdown).join("<br>"))
         .join("<br><br>");
-      output.push(`<blockquote>${html}</blockquote>`);
+      emit(`<blockquote>${html}</blockquote>`);
     }
     quote = null;
   };
@@ -176,11 +188,11 @@ export function renderMarkdown(value) {
     flushQuote();
   };
 
-  for (let lineIndex = 0; lineIndex < lines.length; lineIndex += 1) {
+  for (lineIndex = 0; lineIndex < lines.length; lineIndex += 1) {
     const line = lines[lineIndex];
     if (codeFence) {
       if (/^\s*```/u.test(line)) {
-        output.push(`<pre><code${codeFence.language ? ` class="language-${codeFence.language}"` : ""}>${escapeHtml(codeFence.lines.join("\n"))}</code></pre>`);
+        emit(`<pre><code${codeFence.language ? ` class="language-${codeFence.language}"` : ""}>${escapeHtml(codeFence.lines.join("\n"))}</code></pre>`, lineIndex + 1);
         codeFence = null;
       } else {
         codeFence.lines.push(line);
@@ -230,12 +242,12 @@ export function renderMarkdown(value) {
     if (heading) {
       flushBlocks();
       const level = heading[1].length;
-      output.push(`<h${level}>${renderInlineMarkdown(heading[2])}</h${level}>`);
+      emit(`<h${level}>${renderInlineMarkdown(heading[2])}</h${level}>`, lineIndex + 1);
       continue;
     }
     if (/^\s*(---+|___+|\*\*\*+)\s*$/u.test(line)) {
       flushBlocks();
-      output.push("<hr>");
+      emit("<hr>", lineIndex + 1);
       continue;
     }
     const tableHeaders = splitMarkdownTableRow(line);
@@ -251,7 +263,7 @@ export function renderMarkdown(value) {
         lineIndex += 1;
       }
       lineIndex -= 1;
-      output.push(renderMarkdownTable(tableHeaders, alignments, rows));
+      emit(renderMarkdownTable(tableHeaders, alignments, rows), lineIndex + 1);
       continue;
     }
     const listItem = line.match(/^(\s*)([-+*]|\d+\.)\s+(.+)$/u);
@@ -266,7 +278,7 @@ export function renderMarkdown(value) {
     if (list) flushList();
     paragraph.push(line);
   }
-  if (codeFence) output.push(`<pre><code${codeFence.language ? ` class="language-${codeFence.language}"` : ""}>${escapeHtml(codeFence.lines.join("\n"))}</code></pre>`);
+  if (codeFence) emit(`<pre><code${codeFence.language ? ` class="language-${codeFence.language}"` : ""}>${escapeHtml(codeFence.lines.join("\n"))}</code></pre>`);
   flushBlocks();
-  return output.join("");
+  return output;
 }