@musnows/scriverse 1.0.6 → 1.0.8

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);
 }
 
@@ -5393,6 +5437,26 @@ function addSelectedLinesAsCitation() {
   toast(`已引用《${citation.chapterTitle}》第 ${citation.startLine}${citation.startLine === citation.endLine ? "" : `-${citation.endLine}`} 行`);
 }
 
+function addChapterAsAiReference(chapterId) {
+  if (!state.work || !canWritePermissionModule(state.work, "ai-chat")) return toast("当前账户没有创作助手编辑权限", "error");
+  const volume = state.work.volumes.find((item) => item.chapters.some((chapter) => chapter.id === chapterId));
+  const chapter = volume?.chapters.find((item) => item.id === chapterId);
+  if (!volume || !chapter) return toast("章节不存在或已被删除", "error");
+  const reference = { kind: "chapter", id: String(chapter.id), name: `${volume.title} / ${chapter.title}` };
+  if (state.aiReferences.some((item) => aiReferenceKey(item) === aiReferenceKey(reference))) {
+    ensureAiPanelExpanded();
+    renderAiReferences();
+    return toast(`《${chapter.title}》已在助手引用中`);
+  }
+  const chapterReferenceCount = state.aiReferences.filter((item) => item.kind === "chapter").length;
+  if (chapterReferenceCount >= 20) return toast("一次最多添加 20 个章节助手引用", "error");
+  state.aiReferences.push(reference);
+  ensureAiPanelExpanded();
+  renderAiReferences();
+  persistActiveAiChatTab();
+  toast(`已将《${chapter.title}》添加到助手引用`);
+}
+
 async function createSelectedLineAnnotation(kind) {
   const permissionModule = kind === "todo" ? "todos" : "comments";
   if (!state.chapter || !chapterLineSelection || !canWritePermissionModule(state.work, permissionModule)) return;
@@ -5909,6 +5973,7 @@ function createClientError(payload, fallbackMessage, fallbackStatus = null) {
   const error = new Error(typeof source.message === "string" ? source.message : fallbackMessage);
   error.code = typeof source.code === "string" ? source.code : undefined;
   error.status = Number.isInteger(source.status) ? source.status : fallbackStatus;
+  error.failureOrigin = source.failureOrigin === "platform" || source.failureOrigin === "provider" ? source.failureOrigin : undefined;
   error.details = source.details;
   error.failure = typeof source.failure === "string" ? source.failure : undefined;
   error.callId = typeof source.callId === "string" ? source.callId : undefined;
@@ -5946,21 +6011,31 @@ function formatAiFailureMessage(error) {
   const providerName = typeof error?.providerName === "string" ? error.providerName : typeof details.providerName === "string" ? details.providerName : "";
   const providerId = typeof error?.providerId === "string" ? error.providerId : typeof details.providerId === "string" ? details.providerId : "";
   const modelId = typeof error?.modelId === "string" ? error.modelId : typeof details.modelId === "string" ? details.modelId : "";
+  const failureOrigin = aiFailureOrigin(error, details);
+  const providerLabel = providerName || providerId;
   if (code) lines.push(`错误码：${code}`);
-  if (status) lines.push(`服务端状态：HTTP ${status}`);
+  lines.push(`错误来源：${failureOrigin === "provider" ? `LLM 供应商${providerLabel ? `（${providerLabel}）` : ""}` : "叙界平台"}`);
+  if (status) lines.push(`叙界响应状态：HTTP ${status}`);
   if (details.platformLimited === true) {
     const limitSource = details.limitScope === "provider"
       ? `配置的供应商额度${providerName ? `（${providerName}）` : ""}`
       : "单个小说额度";
     lines.push(`叙界平台限制来源：${limitSource}`);
   }
-  if (providerName || providerId) lines.push(`模型供应商：${providerName || providerId}`);
-  if (modelId) lines.push(`模型 ID：${modelId}`);
+  if (failureOrigin === "platform" && providerLabel) lines.push(`请求模型供应商：${providerLabel}`);
+  if (modelId) lines.push(`请求模型 ID：${modelId}`);
   if (callId) lines.push(`调用 ID：${callId}`);
-  if (failure && failure !== message) lines.push(`详细原因：${failure}`);
+  if (failure && failure !== message) lines.push(`${failureOrigin === "provider" ? "LLM 供应商详情" : "平台详情"}：${failure}`);
   return lines.join("\n");
 }
 
+function aiFailureOrigin(error, details) {
+  if (error?.failureOrigin === "platform" || error?.failureOrigin === "provider") return error.failureOrigin;
+  if (details.failureOrigin === "platform" || details.failureOrigin === "provider") return details.failureOrigin;
+  if (details.platformLimited === true || error?.code !== "AI_CALL_FAILED") return "platform";
+  return "provider";
+}
+
 function aiFailureMessageMetadata(error) {
   const details = error?.details && typeof error.details === "object" && !Array.isArray(error.details) ? error.details : {};
   return {
@@ -6074,6 +6149,12 @@ function invalidateModuleRequestsAfterMutation(path, method) {
 function applyProductHealthMetadata(health) {
   const version = String(health?.version ?? "").trim();
   const versionLabel = String(health?.versionLabel ?? "").trim();
+  const iconPath = health?.development === true ? "/icon-dev.svg?v=20260910" : "/icon.svg?v=20260712";
+  document.querySelectorAll(".brand-mark").forEach((element) => {
+    element.src = iconPath;
+  });
+  const favicon = document.querySelector('link[rel="icon"]');
+  if (favicon) favicon.href = iconPath;
   document.querySelectorAll("[data-product-footer-version]").forEach((element) => {
     element.textContent = versionLabel || (version ? `v${version}` : "v—");
   });
@@ -8833,10 +8914,17 @@ function renderTree() {
       }
     });
     button.addEventListener("contextmenu", (event) => {
-      if (!canEditProse()) return;
+      if (!canEditProse() && !canWritePermissionModule(state.work, "ai-chat")) return;
       event.preventDefault();
       openChapterTypeMenu(button.dataset.chapterId, event.clientX, event.clientY);
     });
+    button.addEventListener("keydown", (event) => {
+      if (!canEditProse() && !canWritePermissionModule(state.work, "ai-chat")) return;
+      if (event.key !== "ContextMenu" && !(event.shiftKey && event.key === "F10")) return;
+      event.preventDefault();
+      const rect = button.getBoundingClientRect();
+      openChapterTypeMenu(button.dataset.chapterId, rect.left, rect.bottom);
+    });
     if (proseEditable) {
       button.addEventListener("dragstart", (event) => {
         event.dataTransfer?.setData("text/plain", button.dataset.chapterId);
@@ -9059,7 +9147,12 @@ function openChapterTypeMenu(chapterId, clientX, clientY) {
   if (!chapter) return;
   state.contextChapterId = chapterId;
   const menu = $("#chapter-type-menu");
-  menu.querySelector("strong").textContent = `标记“${chapter.title}”`;
+  const canManageChapter = canEditProse();
+  const canAddAiReference = canWritePermissionModule(state.work, "ai-chat");
+  menu.querySelector("strong").textContent = `操作“${chapter.title}”`;
+  menu.querySelectorAll("[data-chapter-type], [data-delete-chapter]").forEach((button) => button.classList.toggle("hidden", !canManageChapter));
+  menu.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")));
@@ -13973,7 +14066,7 @@ async function renderBookAiSettings() {
   const remoteMcpStatusText = remoteMcpServers.length > 0
     ? `已验证 ${remoteMcpServers.length} 个远程 MCP Server，共发现 ${remoteMcpToolCount} 个工具。`
     : "尚未配置远程 MCP Server。";
-  const maximumAgentToolCallLimit = Math.max(5, Number(settings.agentToolCallLimitMaximum) || 80);
+  const maximumAgentToolCallLimit = Math.max(10, Number(settings.agentToolCallLimitMaximum) || 300);
   const agentTools = new Set(settings.agentTools ?? ["story_index", "read_chapters", "grep", "search_story_entities", "read_character_sections", "search_drafts", "image", "calculate_time"]);
   const dailyTokenQuota = settings.dailyTokenQuota === null ? null : Number(settings.dailyTokenQuota);
   const quotaUsedTokens = Number(usage?.quota?.usedTokens) || 0;
@@ -13995,7 +14088,7 @@ async function renderBookAiSettings() {
   host.innerHTML = `<section class="config-section">${tokenUsageOverviewMarkup(usage, {
     title: "本书 Token 用量",
     description: `仅统计《${state.work.title}》迄今产生的 AI Token 消耗与缓存命中情况。`
-  })}</section><section class="config-section"><div class="config-section-header"><div><h2>每日 Token 额度</h2><p>限制本书在后端部署时区（${esc(quotaTimezone)}）每个自然日可使用的输入与输出 Token 总量。额度必须设置为大于 0 的整数；低于 10,000 时仅提示风险；达到额度后，新的 AI 请求会等到后端时区的次日零点重置后再执行。</p></div></div><div class="config-inline-save"><label class="checkbox-field config-checkbox-field"><input id="daily-token-quota-enabled" type="checkbox" ${dailyTokenQuota === null ? "" : "checked"}>启用每日额度</label><label class="daily-token-quota-field">每日额度<input id="daily-token-quota" type="number" min="1" max="2000000000" step="1" value="${esc(String(dailyTokenQuota ?? 10000))}" aria-label="本书每日 Token 额度" ${dailyTokenQuota === null ? "disabled" : ""}></label><button id="save-daily-token-quota" class="ghost-button config-save-button" type="button">保存</button></div><p id="daily-token-quota-status" class="usage-measurement-note" role="status">${esc(quotaStatusText)}</p></section><section class="config-section"><div class="config-section-header"><div><h2>本书系统提示词</h2><p>会追加在内置系统提示词和平台全局系统提示词之后，只影响《${esc(state.work.title)}》的 AI 请求。</p></div></div><div class="field-label"><textarea id="work-system-prompt" rows="8" aria-label="本书系统提示词" placeholder="例如：叙事使用第三人称，哥斯拉不得离开地球。">${esc(settings.systemPrompt)}</textarea></div><div class="card-actions"><button id="save-work-system-prompt" class="ghost-button config-save-button" type="button">保存本书提示词</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>人物关系拼音索引</h2><p>平时由系统记录增量任务；“同步增量队列”只处理发生变化的来源，“完整重建索引”会将本书全部正文和设定来源重新排队。</p></div></div><div id="relationship-search-index-status" role="status" aria-live="polite">${relationshipIndexStatusMarkup(relationshipIndex)}</div><div class="relationship-index-actions"><button id="sync-relationship-search-index" class="primary-button config-save-button" type="button">同步增量队列</button><button id="refresh-relationship-search-index" class="ghost-button" type="button">刷新状态</button><button id="rebuild-relationship-search-index" class="ghost-button config-save-button" type="button">完整重建索引</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>全书概要引用配额</h2><p>引用全书概要时按分卷保留覆盖，并优先加入与当前问题相关的章节概要；该比例控制概要可使用的上下文预算。</p></div></div><div class="config-inline-save"><label class="book-summary-context-percent-field">上下文占比（%）<input id="book-summary-context-percent" type="number" min="1" max="90" value="${esc(String(settings.bookSummaryContextPercent ?? 50))}" aria-label="全书概要引用上下文占比"></label><button id="save-book-summary-context-percent" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>对话上下文 Compact</h2><p>该阈值按对话历史的独立预算计算，用于显示可选择压缩或忽略的提醒；整次请求达到模型上下文窗口 95% 时仍会强制压缩较早消息，并尽量保留最近八条原文。</p></div></div><div class="config-inline-save"><label class="context-compact-threshold-field">Compact 阈值（%）<input id="context-compact-threshold" type="number" min="50" max="90" value="${esc(String(settings.contextCompactThreshold ?? 85))}" aria-label="对话上下文 compact 阈值"></label><button id="save-context-compact-threshold" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>设定上下文注入</h2><p>开启后，本书的普通 AI 请求会自动注入锁定设定、组织、种族与相关约束；即使本轮同时使用“@注入上下文设定”，也只会注入一次。</p></div></div><div class="config-inline-save"><label class="checkbox-field config-checkbox-field"><input id="always-include-setting-info" type="checkbox" ${settings.alwaysIncludeSettingInfo ? "checked" : ""}>是否注入设定</label><button id="save-always-include-setting-info" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>Agent 工具调用上限</h2><p>限制单次回答里 Agent 可调用工具的次数，并用「全局倍数」给整次回答加一道不会因 Compact 重置的熔断阀，防止工具死循环空耗 Token。调用上限 5–48（默认 12）；全局倍数 1–6（默认 3，全局上限 = 调用上限 × 倍数）。<a class="config-doc-link" href="https://scriverse.top/docs/global-tool-call-limit.html" target="_blank" rel="noopener noreferrer">了解原理与推荐设置</a></p></div></div><div class="config-inline-save"><label class="agent-tool-call-limit-field">调用上限<input id="agent-tool-call-limit" type="number" min="5" max="48" value="${esc(String(settings.agentToolCallLimit ?? 12))}" aria-label="Agent 工具调用上限"></label><div class="agent-tool-call-global-multiplier-field"><span id="agent-tool-call-global-multiplier-label">全局倍数</span><div class="settings-layout-toggle agent-tool-call-global-multiplier-toggle" role="group" aria-labelledby="agent-tool-call-global-multiplier-label">${[1, 2, 3, 4, 5, 6].map((value) => `<button type="button" data-global-multiplier="${value}" aria-pressed="${Number(settings.agentToolCallGlobalMultiplier ?? 3) === value}">${value}</button>`).join("")}</div><input id="agent-tool-call-global-multiplier" type="hidden" value="${esc(String(Math.min(6, Math.max(1, Number(settings.agentToolCallGlobalMultiplier ?? 3) || 3))))}" aria-label="Agent 工具调用全局倍数"></div><button id="save-agent-tool-call-limit" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section ai-agent-tools-section"><div class="config-section-header"><div><h2>AI 查询工具</h2><p>工具默认可用，作为已有上下文的补充。关闭后模型不会看到对应能力；所有工具只读且有数量、篇幅与调用轮次限制。已开始的对话会锁定创建时的工具集，修改后仅对新对话生效，避免打断 prompt cache。</p></div></div><div class="ai-agent-tools"><label><input name="agent-tool" type="checkbox" value="story_index" ${agentTools.has("story_index") ? "checked" : ""}><span><strong>作品目录与章节概要</strong><small>分页获取卷章、章节 ID 和当前概要，不返回正文。</small></span></label><label><input name="agent-tool" type="checkbox" value="read_chapters" ${agentTools.has("read_chapters") ? "checked" : ""}><span><strong>读取章节</strong><small>按章节 ID 获取概要或正文，每次最多 3 章。</small></span></label><label><input name="agent-tool" type="checkbox" value="search_story_entities" ${agentTools.has("search_story_entities") ? "checked" : ""}><span><strong>搜索作品实体</strong><small>按实体名、拼音或短关键词混合检索设定、人物、组织、时间线、关系、大纲和伏笔；非语义问答。</small></span></label></div><div class="card-actions"><button id="save-agent-tools" class="ghost-button config-save-button" type="button">保存工具设置</button></div></section>${renderTaskDefaults(models, providers, taskDefaults, settings)}`;
+  })}</section><section class="config-section"><div class="config-section-header"><div><h2>每日 Token 额度</h2><p>限制本书在后端部署时区（${esc(quotaTimezone)}）每个自然日可使用的输入与输出 Token 总量。额度必须设置为大于 0 的整数；低于 10,000 时仅提示风险；达到额度后，新的 AI 请求会等到后端时区的次日零点重置后再执行。</p></div></div><div class="config-inline-save"><label class="checkbox-field config-checkbox-field"><input id="daily-token-quota-enabled" type="checkbox" ${dailyTokenQuota === null ? "" : "checked"}>启用每日额度</label><label class="daily-token-quota-field">每日额度<input id="daily-token-quota" type="number" min="1" max="2000000000" step="1" value="${esc(String(dailyTokenQuota ?? 10000))}" aria-label="本书每日 Token 额度" ${dailyTokenQuota === null ? "disabled" : ""}></label><button id="save-daily-token-quota" class="ghost-button config-save-button" type="button">保存</button></div><p id="daily-token-quota-status" class="usage-measurement-note" role="status">${esc(quotaStatusText)}</p></section><section class="config-section"><div class="config-section-header"><div><h2>本书系统提示词</h2><p>会追加在内置系统提示词和平台全局系统提示词之后，只影响《${esc(state.work.title)}》的 AI 请求。</p></div></div><div class="field-label"><textarea id="work-system-prompt" rows="8" aria-label="本书系统提示词" placeholder="例如：叙事使用第三人称，哥斯拉不得离开地球。">${esc(settings.systemPrompt)}</textarea></div><div class="card-actions"><button id="save-work-system-prompt" class="ghost-button config-save-button" type="button">保存本书提示词</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>人物关系拼音索引</h2><p>平时由系统记录增量任务；“同步增量队列”只处理发生变化的来源，“完整重建索引”会将本书全部正文和设定来源重新排队。</p></div></div><div id="relationship-search-index-status" role="status" aria-live="polite">${relationshipIndexStatusMarkup(relationshipIndex)}</div><div class="relationship-index-actions"><button id="sync-relationship-search-index" class="primary-button config-save-button" type="button">同步增量队列</button><button id="refresh-relationship-search-index" class="ghost-button" type="button">刷新状态</button><button id="rebuild-relationship-search-index" class="ghost-button config-save-button" type="button">完整重建索引</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>全书概要引用配额</h2><p>引用全书概要时按分卷保留覆盖，并优先加入与当前问题相关的章节概要；该比例控制概要可使用的上下文预算。</p></div></div><div class="config-inline-save"><label class="book-summary-context-percent-field">上下文占比（%）<input id="book-summary-context-percent" type="number" min="1" max="90" value="${esc(String(settings.bookSummaryContextPercent ?? 50))}" aria-label="全书概要引用上下文占比"></label><button id="save-book-summary-context-percent" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>对话上下文 Compact</h2><p>该阈值按对话历史的独立预算计算，用于显示可选择压缩或忽略的提醒；整次请求达到模型上下文窗口 95% 时仍会强制压缩较早消息，并尽量保留最近八条原文。</p></div></div><div class="config-inline-save"><label class="context-compact-threshold-field">Compact 阈值（%）<input id="context-compact-threshold" type="number" min="50" max="90" value="${esc(String(settings.contextCompactThreshold ?? 85))}" aria-label="对话上下文 compact 阈值"></label><button id="save-context-compact-threshold" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>设定上下文注入</h2><p>开启后，本书的普通 AI 请求会自动注入锁定设定、组织、种族与相关约束；即使本轮同时使用“@注入上下文设定”，也只会注入一次。</p></div></div><div class="config-inline-save"><label class="checkbox-field config-checkbox-field"><input id="always-include-setting-info" type="checkbox" ${settings.alwaysIncludeSettingInfo ? "checked" : ""}>是否注入设定</label><button id="save-always-include-setting-info" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section"><div class="config-section-header"><div><h2>Agent 工具调用上限</h2><p>限制单次回答里 Agent 可调用工具的次数，并用「全局倍数」给整次回答加一道不会因 Compact 重置的熔断阀，防止工具死循环空耗 Token。调用上限 10–${maximumAgentToolCallLimit}（默认 20）；全局倍数 1–6（默认 3，全局上限 = 调用上限 × 倍数）。<a class="config-doc-link" href="https://scriverse.top/docs/global-tool-call-limit.html" target="_blank" rel="noopener noreferrer">了解原理与推荐设置</a></p></div></div><div class="config-inline-save"><label class="agent-tool-call-limit-field">调用上限<input id="agent-tool-call-limit" type="number" min="10" max="${maximumAgentToolCallLimit}" value="${esc(String(settings.agentToolCallLimit ?? 20))}" aria-label="Agent 工具调用上限"></label><div class="agent-tool-call-global-multiplier-field"><span id="agent-tool-call-global-multiplier-label">全局倍数</span><div class="settings-layout-toggle agent-tool-call-global-multiplier-toggle" role="group" aria-labelledby="agent-tool-call-global-multiplier-label">${[1, 2, 3, 4, 5, 6].map((value) => `<button type="button" data-global-multiplier="${value}" aria-pressed="${Number(settings.agentToolCallGlobalMultiplier ?? 3) === value}">${value}</button>`).join("")}</div><input id="agent-tool-call-global-multiplier" type="hidden" value="${esc(String(Math.min(6, Math.max(1, Number(settings.agentToolCallGlobalMultiplier ?? 3) || 3))))}" aria-label="Agent 工具调用全局倍数"></div><button id="save-agent-tool-call-limit" class="ghost-button config-save-button" type="button">保存</button></div></section><section class="config-section ai-agent-tools-section"><div class="config-section-header"><div><h2>AI 查询工具</h2><p>工具默认可用，作为已有上下文的补充。关闭后模型不会看到对应能力；所有工具只读且有数量、篇幅与调用轮次限制。已开始的对话会锁定创建时的工具集，修改后仅对新对话生效，避免打断 prompt cache。</p></div></div><div class="ai-agent-tools"><label><input name="agent-tool" type="checkbox" value="story_index" ${agentTools.has("story_index") ? "checked" : ""}><span><strong>作品目录与章节概要</strong><small>分页获取卷章、章节 ID 和当前概要，不返回正文。</small></span></label><label><input name="agent-tool" type="checkbox" value="read_chapters" ${agentTools.has("read_chapters") ? "checked" : ""}><span><strong>读取章节</strong><small>按章节 ID 获取概要或正文，每次最多 3 章。</small></span></label><label><input name="agent-tool" type="checkbox" value="search_story_entities" ${agentTools.has("search_story_entities") ? "checked" : ""}><span><strong>搜索作品实体</strong><small>按实体名、拼音或短关键词混合检索设定、人物、组织、时间线、关系、大纲和伏笔；非语义问答。</small></span></label></div><div class="card-actions"><button id="save-agent-tools" class="ghost-button config-save-button" type="button">保存工具设置</button></div></section>${renderTaskDefaults(models, providers, taskDefaults, settings)}`;
   const workSystemPromptSection = host.querySelector("#work-system-prompt")?.closest(".config-section");
   workSystemPromptSection?.insertAdjacentHTML("afterend", `<section class="config-section remote-mcp-settings"><div class="config-section-header"><div><h2>远程 MCP 工具</h2><p>填写标准的 <code>mcpServers</code> JSON 配置。保存前会逐个检查 JSON、远程传输、安全地址、MCP 握手与工具列表；任一 Server 失败时都不会覆盖当前配置。</p></div></div><label class="field-label remote-mcp-config-field"><span>mcpServers JSON</span><textarea id="remote-mcp-config" rows="12" spellcheck="false" autocapitalize="off" autocomplete="off" aria-describedby="remote-mcp-config-help remote-mcp-status" placeholder='{"mcpServers":{"example":{"url":"https://example.com/mcp"}}}'>${esc(remoteMcpConfigText)}</textarea></label><small id="remote-mcp-config-help" class="remote-mcp-config-help">仅支持远程 MCP 工具（SSE / Streamable HTTP），不支持会执行本地命令的 stdio 配置。敏感 Header 会加密保存，页面中的 ${esc("********")} 掩码再次保存时会保留原值。</small><p id="remote-mcp-status" class="remote-mcp-status" role="status" aria-live="polite">${esc(remoteMcpStatusText)}</p><div class="card-actions"><button id="save-remote-mcp-config" class="ghost-button config-save-button" type="button">测试并保存 MCP 配置</button></div></section>`);
   const semanticModelOptions = (kind, selectedId) => semanticModels
@@ -14035,10 +14128,6 @@ async function renderBookAiSettings() {
   };
   configureTokenQuotaInput(host.querySelector("#daily-token-quota"), "daily-token-quota-warning", 10_000);
   configureTokenQuotaInput(host.querySelector("#monthly-token-quota"), "monthly-token-quota-warning", 1_000_000);
-  const agentToolCallLimitInput = host.querySelector("#agent-tool-call-limit");
-  agentToolCallLimitInput?.setAttribute("max", String(maximumAgentToolCallLimit));
-  const agentToolCallDescription = agentToolCallLimitInput?.closest(".config-section")?.querySelector(".config-section-header p");
-  if (agentToolCallDescription?.firstChild) agentToolCallDescription.firstChild.nodeValue = agentToolCallDescription.firstChild.nodeValue.replace("5–48", `5–${maximumAgentToolCallLimit}`);
   host.querySelectorAll(".config-section").forEach((section) => {
     if (section.querySelector("h2")?.textContent === "Agent 工具调用上限") section.id = "agent-tool-call-limit-settings";
   });
@@ -14398,9 +14487,9 @@ async function renderBookAiSettings() {
     const button = $("#save-agent-tool-call-limit");
     const input = $("#agent-tool-call-limit");
     const value = Number(input.value);
-    const maximum = Number(input.max) || 80;
-    if (!Number.isInteger(value) || value < 5) {
-      toast(`Agent 工具调用上限必须是 5 到 ${maximum} 之间的整数`, "error");
+    const maximum = Number(input.max) || 300;
+    if (!Number.isInteger(value) || value < 10) {
+      toast(`Agent 工具调用上限必须是 10 到 ${maximum} 之间的整数`, "error");
       input.focus();
       return;
     }
@@ -14589,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";
@@ -14634,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);
@@ -14653,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}`);
@@ -18450,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 = "";
@@ -18478,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);
@@ -18486,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);
@@ -18648,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");
@@ -18671,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);
@@ -21051,6 +21142,13 @@ $("#cover-file").addEventListener("change", async (event) => {
   }
 });
 $("#chapter-type-menu").addEventListener("click", async (event) => {
+  const aiReferenceButton = event.target.closest("[data-add-chapter-ai-reference]");
+  if (aiReferenceButton) {
+    const chapterId = state.contextChapterId;
+    closeChapterTypeMenu();
+    if (chapterId) addChapterAsAiReference(chapterId);
+    return;
+  }
   const deleteButton = event.target.closest("[data-delete-chapter]");
   if (deleteButton) {
     const chapterId = state.contextChapterId;

package/dist/public/icon-dev.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title description">
+  <title id="title">叙界</title>
+  <desc id="description">一本展开的书与一颗星，代表小说创作与灵感</desc>
+  <rect width="64" height="64" rx="14" fill="#bb911a"/>
+  <path d="M10 16.5c8.7-1.6 15.7.4 21 6v29c-5.4-4.8-12.4-6.5-21-5.1V16.5Z" fill="#fffaf0"/>
+  <path d="M54 16.5c-8.7-1.6-15.7.4-21 6v29c5.4-4.8 12.4-6.5 21-5.1V16.5Z" fill="#fffaf0"/>
+  <path d="M31 22.5h2V52h-2z" fill="#c79b32"/>
+  <path d="m48 9.5 1.7 4.1 4.3 1.7-4.3 1.7-1.7 4.1-1.7-4.1-4.3-1.7 4.3-1.7L48 9.5Z" fill="#ffe6a0"/>
+  <path d="M15.5 25.5c4.2-.3 7.8.6 10.8 2.7M15.5 32c4.2-.3 7.8.6 10.8 2.7M48.5 25.5c-4.2-.3-7.8.6-10.8 2.7M48.5 32c-4.2-.3-7.8.6-10.8 2.7" fill="none" stroke="#b69048" stroke-linecap="round" stroke-width="2"/>
+</svg>