@yfwu2020/dsh-selection-explain 0.11.0 → 0.12.0

package/lib/client.js

@@ -151,7 +151,6 @@ var VOICE_SILENCE_RMS = 0.012;
 var CONTEXT_WINDOW = 1500;
 var KEY_CONTEXT_CHARS = 300;
 var MAX_QUOTES = 4;
-var MAX_QUOTE_CHARS = 3e3;
 var MAX_QUOTE_SELECTION = 2e4;
 var QUOTE_ONLY_QUESTION = "\u5C31\u4E0A\u9762\u5F15\u7528\u7684\u6587\u5B57\uFF0C\u8BF4\u8BF4\u5B83\u5728\u8FD9\u91CC\u662F\u4EC0\u4E48\u610F\u601D\u3002";
 var QUOTE_CONTEXT_API = "/selection-explain/api/quote-context";
@@ -1836,6 +1835,13 @@ function adaptPreviewHtml(code, previewId) {
 }
 var previewSeq = 0;
 var previewFrames = {};
+function releasePreviewFrames(root) {
+  if (!root) return;
+  for (var key in previewFrames) {
+    var frame = previewFrames[key].frame;
+    if (frame === root || root.contains && root.contains(frame)) delete previewFrames[key];
+  }
+}
 function registerPreviewFrame(frame) {
   previewSeq += 1;
   var id = "pv" + previewSeq;
@@ -1919,6 +1925,7 @@ function webPreviewBlock(code) {
   return { root: wrap, pre, frame };
 }
 function renderRich(parent2, text, options) {
+  releasePreviewFrames(parent2);
   parent2.textContent = "";
   var lines = String(text || "").replace(/\r/g, "").split("\n");
   var current = null;
@@ -3259,7 +3266,7 @@ function createVoiceCardController(env) {
   }
   function unpinVCardBox() {
     if (vcardState.unpinTimer) {
-      clearTimeout(vcardState.unpinTimer);
+      env.timerScope.clear(vcardState.unpinTimer);
       vcardState.unpinTimer = null;
     }
     if (vcard && vcardState.unpinHandler) {
@@ -3273,7 +3280,7 @@ function createVoiceCardController(env) {
   function scheduleVCardUnpin() {
     if (!vcard) return;
     if (vcardState.unpinTimer) {
-      clearTimeout(vcardState.unpinTimer);
+      env.timerScope.clear(vcardState.unpinTimer);
       vcardState.unpinTimer = null;
     }
     if (vcardState.unpinHandler) {
@@ -3582,7 +3589,7 @@ function createVoiceCardController(env) {
     line.setAttribute("data-off", "a");
     var done = function() {
       if (vcardState.crtTimer) {
-        clearTimeout(vcardState.crtTimer);
+        env.timerScope.clear(vcardState.crtTimer);
         vcardState.crtTimer = null;
       }
       if (vcard && vcardState.crtHandler) {
@@ -3601,7 +3608,7 @@ function createVoiceCardController(env) {
   function finishCrtOff() {
     vcardState.closing = false;
     if (vcardState.crtTimer) {
-      clearTimeout(vcardState.crtTimer);
+      env.timerScope.clear(vcardState.crtTimer);
       vcardState.crtTimer = null;
     }
     if (vcard && vcardState.crtHandler) {
@@ -3755,14 +3762,13 @@ function createVoiceCardController(env) {
   function startMicWatch() {
     if (vcardState.timer) return;
     if (!env.state.selection && !env.state.quoteSelection) return;
-    vcardState.timer = setInterval(micTick, MIC_POLL_MS);
-    env.timers.push(vcardState.timer);
+    vcardState.timer = env.timerScope.interval(micTick, MIC_POLL_MS);
     micTick();
   }
   function stopMicWatch() {
     quoteVoiceHandled = false;
     if (!vcardState.timer) return;
-    clearInterval(vcardState.timer);
+    env.timerScope.clear(vcardState.timer);
     vcardState.timer = null;
   }
   function micTick() {
@@ -3882,8 +3888,6 @@ function createQuotesController(env) {
   function addQuote(text, label, extra) {
     var clean = String(text || "").replace(/\u00a0/g, " ").trim();
     if (!clean) return false;
-    var truncated = clean.length > MAX_QUOTE_CHARS;
-    if (truncated) clean = clean.slice(0, MAX_QUOTE_CHARS) + "\u2026";
     for (var i = 0; i < env.state.quotes.length; i += 1) {
       if (env.state.quotes[i].text === clean) {
         env.setStatus("\u8FD9\u6BB5\u5DF2\u7ECF\u5728\u5F15\u7528\u91CC\u4E86");
@@ -3896,19 +3900,27 @@ function createQuotesController(env) {
     }
     quoteSeq += 1;
     var context = extra && typeof extra.context === "string" ? extra.context.trim() : "";
-    env.state.quotes.push({
+    var quote = {
       id: quoteSeq,
       label: label || "\u5F15\u7528",
       text: clean,
       context,
-      session: !!(extra && extra.session === true)
-    });
+      session: !!(extra && extra.session === true),
+      sessionId: extra && extra.sessionId || env.currentSessionId(),
+      contextJob: null
+    };
+    env.state.quotes.push(quote);
+    if (quote.session && quote.sessionId) {
+      quote.contextJob = fetchQuoteContext(quote.sessionId, quote.text).then(function(context2) {
+        if (context2) quote.context = context2;
+      });
+    }
     renderQuotes();
     env.refreshAskState();
     env.askRow.style.display = "";
     if (env.composerVisible()) env.focusAskBox();
     env.setStatus(
-      "\u5DF2\u52A0\u5165\u5F15\u7528\uFF08" + quoteLabelOf(env.state.quotes[env.state.quotes.length - 1]) + " \xB7 " + clean.length + " \u5B57" + (truncated ? "\uFF08\u539F\u6587\u66F4\u957F\uFF0C\u5DF2\u622A\u65AD\uFF09" : "") + (context ? " \xB7 \u5E26\u4E0A\u4E0B\u6587 " + context.length + " \u5B57" : "") + "\uFF09"
+      "\u5DF2\u52A0\u5165\u5F15\u7528\uFF08" + quoteLabelOf(env.state.quotes[env.state.quotes.length - 1]) + " \xB7 " + clean.length + " \u5B57" + (context ? " \xB7 \u5E26\u4E0A\u4E0B\u6587 " + context.length + " \u5B57" : "") + "\uFF09"
     );
     return true;
   }
@@ -3973,6 +3985,22 @@ function createQuotesController(env) {
   function quoteContextFor(selection) {
     if (!selection) return { context: "", session: false };
     if (selection.source === "panel") {
+      var index = selection.turnIndex;
+      var through = env.state.contextState && env.state.contextState.through || 0;
+      var visibleBefore = env.state.turns.slice(0, index).filter(function(t) {
+        return !t.hidden;
+      }).length;
+      if (index >= 0 && visibleBefore < through) {
+        var pieces = env.state.turns.slice(Math.max(0, index - 1), index + 2).filter(function(t) {
+          return !t.hidden;
+        }).map(function(t) {
+          var text = t.role === "assistant" ? env.foldForHistory(t.text || "") : sentTextOf(t);
+          var at = text.indexOf(selection.text);
+          var start = at >= 0 ? Math.max(0, at - 500) : 0;
+          return (t.role === "user" ? "\u7528\u6237\uFF1A" : "\u52A9\u624B\uFF1A") + text.slice(start, start + Math.max(1500, selection.text.length + 500));
+        });
+        return { context: pieces.join("\n"), session: false };
+      }
       return { context: "", session: false };
     }
     if (selection.source === "iframe") {
@@ -3993,22 +4021,16 @@ function createQuotesController(env) {
     for (var i = 0; i < quotes.length; i += 1) {
       if (quotes[i].session === true) jobs.push(quotes[i]);
     }
-    var sessionId = env.currentSessionId();
-    if (jobs.length === 0 || !sessionId) return Promise.resolve(quotes);
-    return Promise.all(
-      jobs.map(function(quote) {
-        return fetchQuoteContext(sessionId, quote.text).then(function(context) {
-          if (context) quote.context = context;
-          return quote;
-        });
-      })
-    ).then(function() {
+    if (jobs.length === 0) return Promise.resolve(quotes);
+    return Promise.all(jobs.map(function(quote) {
+      return quote.contextJob || Promise.resolve();
+    })).then(function() {
       return quotes;
     });
   }
   function fetchQuoteContext(sessionId, text) {
     var controller = typeof AbortController === "function" ? new AbortController() : null;
-    var timer = setTimeout(function() {
+    var timer = env.timerScope.later(function() {
       if (controller) {
         try {
           controller.abort();
@@ -4016,7 +4038,6 @@ function createQuotesController(env) {
         }
       }
     }, QUOTE_CONTEXT_TIMEOUT);
-    env.timers.push(timer);
     return fetch(QUOTE_CONTEXT_API, {
       method: "POST",
       headers: { "content-type": "application/json" },
@@ -4025,11 +4046,11 @@ function createQuotesController(env) {
     }).then(function(response) {
       return response.ok ? response.json() : null;
     }).then(function(data) {
-      clearTimeout(timer);
+      env.timerScope.clear(timer);
       if (data && data.ok === true && data.matched === true && typeof data.context === "string") return data.context;
       return "";
     }).catch(function() {
-      clearTimeout(timer);
+      env.timerScope.clear(timer);
       return "";
     });
   }
@@ -4071,6 +4092,7 @@ function createQuotesController(env) {
       out.push({
         role: turn.role,
         text: sentTextOf(turn),
+        ...turn.contextExcluded === true ? { contextExcluded: true } : {},
         ...turn.attachments && turn.attachments.length > 0 ? { attachments: turn.attachments } : {}
       });
     }
@@ -4919,7 +4941,7 @@ function createPreviewController(env) {
 // src/client/panel.js
 function createPanelController(env) {
   function panelOrCurrentSessionId() {
-    return env.panelSessionId || currentSessionId();
+    return env.state.contextState && typeof env.state.contextState.sessionId === "string" ? env.state.contextState.sessionId : env.panelSessionId || currentSessionId();
   }
   function currentSessionId() {
     try {
@@ -5015,8 +5037,9 @@ function createPanelController(env) {
     env.state.selection = null;
   }
   function openPanelWithInner(text, context, label, anchor, keyContext, options) {
-    env.state.voiceAsk = !!(options && options.askFirst);
+    env.state.skipInterpretation = !!(options && options.askFirst);
     env.panelSessionId = currentSessionId();
+    env.state.contextState = null;
     env.state.payload = buildPayload(text, context, label);
     env.state.kind = env.state.payload.kind;
     env.hideButton();
@@ -5050,6 +5073,7 @@ function createPanelController(env) {
     }
     env.renderTurns();
     if (cached) {
+      env.state.skipInterpretation = false;
       env.state.turns = (cached.turns || []).slice();
       env.state.phase = "done";
       env.state.stage = "";
@@ -5281,12 +5305,12 @@ function createPanelController(env) {
     env.panel.style.transition = "transform " + PANEL_GROW_MS + "ms " + PANEL_GROW_EASE;
     env.panel.style.transform = "none";
     if (env.panelGrowTimer) {
-      clearTimeout(env.panelGrowTimer);
+      env.timerScope.clear(env.panelGrowTimer);
       env.panelGrowTimer = null;
     }
     var settle = function() {
       if (env.panelGrowTimer) {
-        clearTimeout(env.panelGrowTimer);
+        env.timerScope.clear(env.panelGrowTimer);
         env.panelGrowTimer = null;
       }
       if (env.panelGrowHandler) {
@@ -5309,7 +5333,7 @@ function createPanelController(env) {
     env.panelOpen = false;
     env.panel.style.display = "none";
     if (env.panelGrowTimer) {
-      clearTimeout(env.panelGrowTimer);
+      env.timerScope.clear(env.panelGrowTimer);
       env.panelGrowTimer = null;
     }
     if (env.panelGrowHandler) {
@@ -5327,6 +5351,11 @@ function createPanelController(env) {
     if (env.state.request) env.state.aborted = true;
     if (env.state.request) env.state.request.abort();
     env.state.request = null;
+    if (env.state.askRequest) {
+      env.state.stopped = true;
+      env.state.askRequest.abort();
+    }
+    releaseRenderedContent();
     env.paintPill();
     env.syncRouteWatch();
   }
@@ -5340,7 +5369,7 @@ function createPanelController(env) {
     for (var i = 0; i < env.state.turns.length; i += 1) {
       if (env.state.turns[i].role === "user") asked = true;
     }
-    env.expandButton.style.display = !hasDetail && translationReady && !asked && !env.state.voiceAsk ? "" : "none";
+    env.expandButton.style.display = !hasDetail && translationReady && !asked && !env.state.skipInterpretation ? "" : "none";
     env.expandButton.disabled = false;
     return asked;
   }
@@ -5355,14 +5384,35 @@ function createPanelController(env) {
     var what = env.state.toolBusy ? "\u6B63\u5728\u68C0\u7D22\u8D44\u6599\u2026" : env.state.phase === "loading" ? "\u6B63\u5728\u5206\u6790\u2026" : "\u751F\u6210\u4E2D\u2026";
     return what + " " + seconds + "s";
   }
+  function releaseRenderedContent() {
+    env.clearWaiting();
+    env.clearRenderedTurns();
+    for (var content of [env.translationSection.content, env.detailSection.content]) {
+      releasePreviewFrames(content);
+      content.textContent = "";
+    }
+  }
   function paint() {
+    if (!env.panelOpen) {
+      releaseRenderedContent();
+      env.paintPill();
+      return;
+    }
     var streaming = env.state.phase === "loading" || env.state.phase === "streaming";
     var stage = env.state.stage;
     var selected = env.state.payload && env.state.payload.text ? env.state.payload.text : env.state.selection ? env.state.selection.text : "";
     var sections = splitSections(env.visibleRaw());
-    env.translationSection.root.style.display = env.state.voiceAsk ? "none" : "";
     var live = stripEchoPrefix(stage === "detail" ? "" : sections.translation || sections.other, selected);
     var liveDetail = (sections.detail || sections.other || "").trim();
+    var askedSoFar = false;
+    for (var qi = 0; qi < env.state.turns.length; qi += 1) {
+      if (env.state.turns[qi].role === "user") {
+        askedSoFar = true;
+        break;
+      }
+    }
+    var emptyInterpretation = !env.state.parts.translation && !env.state.parts.detail && !live.trim();
+    env.translationSection.root.style.display = env.state.skipInterpretation || emptyInterpretation && askedSoFar ? "none" : "";
     if (env.state.parts.translation) {
       renderRich(env.translationSection.content, stripEchoPrefix(env.state.parts.translation, selected), { callout: true, settled: true });
     } else if (stage !== "detail" && live.trim()) {
@@ -5423,7 +5473,7 @@ function createPanelController(env) {
     var surfaceTheme = env.currentSurfaceTheme();
     env.layer.setAttribute("data-theme", surfaceTheme);
     env.panel.setAttribute("data-theme", surfaceTheme);
-    env.askRow.style.display = wide || translationReady || env.state.voiceAsk || env.state.quotes.length > 0 ? "" : "none";
+    env.askRow.style.display = wide || translationReady || env.state.skipInterpretation || env.state.quotes.length > 0 ? "" : "none";
     syncExpandCta();
     env.closeButton.title = "\u5173\u95ED\uFF08Esc\uFF09";
     if (env.state.phase !== "error" && env.state.phase !== "paused" && env.retryButton.parentNode) {
@@ -5546,6 +5596,7 @@ function createPanelController(env) {
     env.panel.style.top = Math.round(top) + "px";
   }
   return {
+    releaseRenderedContent,
     openForSelection,
     currentSessionId,
     loadPanelSize,
@@ -6134,9 +6185,69 @@ function createPillController(env) {
   };
 }
 
+// src/chat-context.ts
+var CHAT_REQUEST_BYTES = 512 * 1024;
+var EMPTY_DIGEST = "811c9dc5";
+function readContextState(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const s = raw;
+  if (s.version !== 1 || !Number.isSafeInteger(s.through) || s.through < 0 || !/^[a-f0-9]{8}$/.test(s.source) || !/^[a-f0-9]{8}$/.test(s.digest) || typeof s.summary !== "string" || s.summary.length > 12e3 || s.through > 0 && !s.summary.trim()) return null;
+  if (s.background !== null && (!s.background || typeof s.background.transcript !== "string" || s.background.transcript.length > 2e5 || typeof s.background.marked !== "boolean")) return null;
+  if (s.sessionId !== void 0 && (typeof s.sessionId !== "string" || s.sessionId.length > 500)) return null;
+  return {
+    version: 1,
+    ...typeof s.sessionId === "string" ? { sessionId: s.sessionId } : {},
+    source: s.source,
+    through: s.through,
+    digest: s.digest,
+    summary: s.summary,
+    background: s.background ? { transcript: s.background.transcript, marked: s.background.marked } : null
+  };
+}
+function modelTurn(turn) {
+  if (turn.contextExcluded) return {
+    role: turn.role === "assistant" ? "assistant" : "user",
+    text: turn.role === "assistant" ? "\uFF08\u8BE5\u8F6E\u672A\u751F\u6210\u56DE\u7B54\u3002\uFF09" : "\uFF08\u8BE5\u63D0\u95EE\u672A\u63D0\u4EA4\u7ED9\u6A21\u578B\uFF0C\u539F\u59CB\u5185\u5BB9\u4ECD\u4FDD\u5B58\u5728\u754C\u9762\u5386\u53F2\u4E2D\uFF1B\u9700\u8981\u65F6\u8BF7\u91CD\u65B0\u5F15\u7528\u5FC5\u8981\u90E8\u5206\u3002\uFF09"
+  };
+  return {
+    role: turn.role === "assistant" ? "assistant" : "user",
+    text: turn.sent || turn.text || "",
+    ...turn.attachments?.length ? { attachments: turn.attachments } : {}
+  };
+}
+function historyDigest(turns, initial = EMPTY_DIGEST) {
+  let hash = Number.parseInt(initial, 16) >>> 0;
+  for (const raw of turns) {
+    const t = modelTurn(raw);
+    const text = JSON.stringify([t.role, t.text, (t.attachments || []).map((a) => [a.kind, a.ref.attachmentId])]) + "\n";
+    for (let i = 0; i < text.length; i++) hash = Math.imul(hash ^ text.charCodeAt(i), 16777619) >>> 0;
+  }
+  return hash.toString(16).padStart(8, "0");
+}
+function contextSource(session, text, context, initial) {
+  return historyDigest([{ role: "user", text: JSON.stringify([session, text, context, initial]) }]);
+}
+function prepareChatHistory(turns, rawState) {
+  const visible = turns.filter((t) => !t.hidden);
+  let state = readContextState(rawState);
+  if (state && (state.through > visible.length || historyDigest(visible.slice(0, state.through)) !== state.digest)) state = null;
+  const start = state?.through || 0;
+  const materials = [];
+  const seen = /* @__PURE__ */ new Set();
+  visible.forEach((turn, index) => {
+    for (const item of turn.attachments || []) {
+      const key = item.kind + ":" + item.ref.attachmentId;
+      if (!seen.has(key)) {
+        seen.add(key);
+        materials.push({ kind: item.kind, ref: item.ref, turn: index });
+      }
+    }
+  });
+  return { history: visible.slice(start).map(modelTurn), historyStart: start, contextState: state, materials };
+}
+
 // src/client/history.js
 function createHistoryController(env) {
-  var FOLD_HISTORY_KEEP_LATEST = true;
   var foldCount = 0;
   var HTML_VOID_TAGS = {
     area: 1,
@@ -6417,16 +6528,6 @@ function createHistoryController(env) {
     src = src.replace(/```html[ \t]*\n([\s\S]*)$/, one);
     return src;
   }
-  function historyTextOf(turn, keepRaw) {
-    if (!turn) return "";
-    if (turn.role === "user") return env.sentTextOf(turn);
-    if (keepRaw) return turn.text;
-    if (typeof turn.foldedCache === "string") return turn.foldedCache;
-    if (turn.streaming === true) return turn.text;
-    var folded = foldForHistory(turn.text);
-    turn.foldedCache = folded;
-    return folded;
-  }
   function currentSurfaceTheme() {
     try {
       var bodyEl = document.body;
@@ -6455,6 +6556,7 @@ function createHistoryController(env) {
   function visibleRaw() {
     return env.state.raw;
   }
+  var historySaveSequence = 0;
   function saveHistory(options) {
     var payload = env.state.payload;
     if (!payload || !env.state.cacheKey) return;
@@ -6465,6 +6567,22 @@ function createHistoryController(env) {
       if (turn.hidden === true) continue;
       turns.push(exported[i]);
     }
+    var owner = env.state.turns;
+    var ownerKey = env.state.cacheKey;
+    var sequence = ++historySaveSequence;
+    function noteSaved(error) {
+      if (sequence !== historySaveSequence || env.state.turns !== owner || env.state.cacheKey !== ownerKey) return;
+      var last = owner[owner.length - 1];
+      if (!last || last.role !== "assistant") return;
+      if (error) {
+        last.notice = "\u5386\u53F2\u8BB0\u5F55\u4FDD\u5B58\u5931\u8D25\uFF0C\u5F53\u524D\u539F\u6587\u4ECD\u5728\u5C0F\u7A97\u4E2D\uFF1B\u5237\u65B0\u6216\u9000\u51FA\u524D\u8BF7\u5148\u590D\u5236\u91CD\u8981\u5185\u5BB9\u3002";
+        last.noticeCode = "history-save-failed";
+      } else if (last.noticeCode === "history-save-failed") {
+        last.notice = "";
+        last.noticeCode = "";
+      } else return;
+      renderTurns();
+    }
     try {
       fetch(HISTORY, {
         method: "POST",
@@ -6477,16 +6595,40 @@ function createHistoryController(env) {
           parts: env.state.parts,
           turns,
           toolDigest: env.state.toolDigest,
-          pinned: !!(options && options.pinned)
+          contextState: env.state.contextState || null,
+          pinned: !!(options && options.pinned),
+          // 这段对话有没有解读，必须跟着条目落盘：回放时靠它决定画不画「翻译」一节。
+          // 不落盘的话，语音卡那条"跳过翻译与详解、直接追问"的对话下次开出来，
+          // 会顶着一张空翻译卡片（"这次没有返回内容"）——用户实测。
+          skipped: env.state.skipInterpretation === true
         })
+      }).then(function(response) {
+        if (!response.ok) throw new Error("HTTP " + response.status);
+        return response.json();
+      }).then(function(result) {
+        noteSaved(!result || result.ok !== true);
       }).catch(function() {
+        noteSaved(true);
       });
     } catch (error) {
+      noteSaved(true);
     }
   }
   function applyHistoryEntry(entry, source) {
     var parts = entry.parts || {};
     env.state.parts = { translation: parts.translation || "", detail: parts.detail || "" };
+    var replayTurns = Array.isArray(entry.turns) ? entry.turns : [];
+    var hasAskTurn = false;
+    for (var step = 0; step < replayTurns.length; step += 1) {
+      if (replayTurns[step] && replayTurns[step].role === "user") {
+        hasAskTurn = true;
+        break;
+      }
+    }
+    var noInterpretation = !String(parts.translation || "").trim() && !String(parts.detail || "").trim();
+    env.state.skipInterpretation = entry.skipped === true || entry.skipped === void 0 && noInterpretation && hasAskTurn;
+    env.state.contextState = readContextState(entry.contextState);
+    if (env.state.contextState && typeof env.state.contextState.sessionId === "string") env.panelSessionId = env.state.contextState.sessionId;
     env.state.turns = Array.isArray(entry.turns) ? entry.turns.slice() : [];
     env.clearQuotes();
     env.state.toolDigest = typeof entry.toolDigest === "string" ? entry.toolDigest : "";
@@ -6518,8 +6660,7 @@ function createHistoryController(env) {
       settled = true;
       if (env.state.cacheKey === cacheKey && onMiss) onMiss();
     }
-    var timer = setTimeout(miss, 1500);
-    env.timers.push(timer);
+    var timer = env.timerScope.later(miss, 1500);
     try {
       fetch(HISTORY + "?key=" + encodeURIComponent(cacheKey)).then(function(response) {
         return response.json();
@@ -6531,7 +6672,7 @@ function createHistoryController(env) {
         }
         if (data && data.ok === true && data.entry) {
           settled = true;
-          clearTimeout(timer);
+          env.timerScope.clear(timer);
           applyHistoryEntry(data.entry, "history");
           return;
         }
@@ -6686,7 +6827,7 @@ function createHistoryController(env) {
     });
     bar.appendChild(undo);
     env.historyList.appendChild(bar);
-    setTimeout(function() {
+    env.timerScope.later(function() {
       if (bar.parentNode) bar.parentNode.removeChild(bar);
     }, 5e3);
   }
@@ -6818,24 +6959,81 @@ function createHistoryController(env) {
     if (Date.now() - stickAt < 150) return;
     env.state.follow = nearBottom();
   }
+  var turnWindowSize = 40;
+  var turnWindowKey = null;
+  var renderedTurns = [];
+  function clearRenderedTurns() {
+    env.clearWaiting(env.chatLog);
+    releasePreviewFrames(env.chatLog);
+    env.chatLog.textContent = "";
+    renderedTurns = [];
+    turnWindowSize = 40;
+    turnWindowKey = null;
+  }
   function renderTurns(options) {
+    if (!env.panelOpen) {
+      clearRenderedTurns();
+      return;
+    }
     var force = !!(options && options.stick === true);
-    var stick = force || nearBottom();
+    var stick = !(options && options.preservePosition) && (force || nearBottom());
     var visible = [];
     for (var i = 0; i < env.state.turns.length; i++) {
       if (env.state.turns[i].hidden !== true) visible.push(env.state.turns[i]);
     }
-    if (env.chatLog.children.length !== visible.length) {
+    if (turnWindowKey !== env.state.cacheKey) {
+      turnWindowKey = env.state.cacheKey;
+      turnWindowSize = 40;
+    }
+    var earlier = Math.max(0, visible.length - turnWindowSize);
+    visible = visible.slice(earlier);
+    var sameWindow = renderedTurns.length === visible.length && visible.every(function(turn2, index) {
+      return renderedTurns[index] === turn2;
+    });
+    var prependCount = visible.length - renderedTurns.length;
+    var canPrepend = options && options.prepend && renderedTurns.length > 0 && prependCount > 0 && renderedTurns.every(function(turn2, index) {
+      return visible[prependCount + index] === turn2;
+    });
+    if (canPrepend) {
+      var moreButton = env.chatLog.children[0];
+      var firstBubble = env.chatLog.children[1];
+      if (earlier > 0) moreButton.textContent = "\u663E\u793A\u66F4\u65E9\u7684\u6D88\u606F\uFF08\u8FD8\u6709 " + earlier + " \u6761\uFF09";
+      else env.chatLog.removeChild(moreButton);
+      for (var p = 0; p < prependCount; p++) {
+        var prepended = bubbleFor(visible[p]);
+        prepended.__turn = visible[p];
+        env.chatLog.insertBefore(prepended, firstBubble);
+      }
+      renderedTurns = visible.slice();
+    } else if (!sameWindow || env.chatLog.children.length !== visible.length + (earlier > 0 ? 1 : 0)) {
       env.clearWaiting(env.chatLog);
+      releasePreviewFrames(env.chatLog);
       env.chatLog.textContent = "";
+      if (earlier > 0) {
+        var more = el("button", "dsh-sel-expand", "\u663E\u793A\u66F4\u65E9\u7684\u6D88\u606F\uFF08\u8FD8\u6709 " + earlier + " \u6761\uFF09");
+        more.type = "button";
+        more.setAttribute("data-history-more", "1");
+        listen(more, "click", function(event) {
+          event.preventDefault();
+          event.stopPropagation();
+          var top = env.body.scrollTop;
+          var height = env.body.scrollHeight;
+          turnWindowSize += 40;
+          renderTurns({ preservePosition: true, prepend: true });
+          env.body.scrollTop = top + Math.max(0, env.body.scrollHeight - height);
+          env.state.follow = false;
+        });
+        env.chatLog.appendChild(more);
+      }
       for (var j = 0; j < visible.length; j++) {
         var bubble = bubbleFor(visible[j]);
         bubble.__turn = visible[j];
         env.chatLog.appendChild(bubble);
       }
+      renderedTurns = visible.slice();
       var fresh = visible[visible.length - 1];
       if (fresh && fresh.role === "assistant" && fresh.asking === true && !fresh.text) {
-        env.showWaiting(env.chatLog.children[visible.length - 1], "\u6B63\u5728\u56DE\u7B54\u2026", {
+        env.showWaiting(env.chatLog.children[env.chatLog.children.length - 1], "\u6B63\u5728\u56DE\u7B54\u2026", {
           startedAt: fresh.startedAt,
           effort: fresh.effort,
           effortOf: function() {
@@ -6847,7 +7045,7 @@ function createHistoryController(env) {
         });
       }
     } else if (visible.length > 0) {
-      var node = env.chatLog.children[visible.length - 1];
+      var node = env.chatLog.children[env.chatLog.children.length - 1];
       var turn = visible[visible.length - 1];
       var painted = false;
       node.className = "dsh-sel-bubble " + (turn.role === "user" ? "dsh-sel-bubble-user" : "dsh-sel-bubble-bot") + (turn.error ? " dsh-sel-bubble-err" : "");
@@ -7030,6 +7228,7 @@ function createHistoryController(env) {
     return seed.length > 1500 ? seed.slice(0, 1500) + "\u2026" : seed;
   }
   return {
+    clearRenderedTurns,
     hideHistoryList,
     placeHistoryList,
     toggleHistoryList,
@@ -7062,13 +7261,6 @@ function createHistoryController(env) {
     loadHistoryEntry,
     seedHistoryFromExplanation,
     ensureChatFollow,
-    get FOLD_HISTORY_KEEP_LATEST() {
-      return FOLD_HISTORY_KEEP_LATEST;
-    },
-    set FOLD_HISTORY_KEEP_LATEST(value) {
-      FOLD_HISTORY_KEEP_LATEST = value;
-    },
-    historyTextOf,
     clearTransientNotice,
     saveHistory,
     applyToolEvent,
@@ -7189,7 +7381,8 @@ function createConversationController(env) {
     if (env.state.turns.length === 0 && (env.state.raw.trim() || env.state.parts.translation || env.state.parts.detail)) {
       env.state.turns.push({ role: "assistant", text: env.seedHistoryFromExplanation(), seed: true, hidden: true });
     }
-    env.state.turns.push({ role: "user", text: asked || QUOTE_ONLY_QUESTION, quotes, sent, attachments: withAttachments });
+    var questionTurn = { role: "user", text: asked || QUOTE_ONLY_QUESTION, quotes, sent, attachments: withAttachments };
+    env.state.turns.push(questionTurn);
     var answerTurn = {
       role: "assistant",
       text: "",
@@ -7211,23 +7404,22 @@ function createConversationController(env) {
     if (env.state.sessionOpen !== void 0) {
     }
     var startedAt = Date.now();
-    var timer = setInterval(function() {
+    var timer = env.timerScope.interval(function() {
       env.paintPill();
       env.setStatus(
         (env.state.toolBusy ? "\u6B63\u5728\u68C0\u7D22\u8D44\u6599\u2026 " : "\u8FFD\u95EE\u4E2D\u2026 ") + ((Date.now() - startedAt) / 1e3).toFixed(1) + "s"
       );
       updateWaitClocks();
     }, 200);
-    env.timers.push(timer);
     var historyTurns = env.state.turns.slice(0, env.state.turns.length - 2);
-    var history = historyTurns.map(function(turn, index) {
-      var keepRaw = env.FOLD_HISTORY_KEEP_LATEST && index === historyTurns.length - 1;
-      return {
-        role: turn.role,
-        text: env.historyTextOf(turn, keepRaw),
-        ...turn.attachments && turn.attachments.length > 0 ? { attachments: turn.attachments } : {}
-      };
-    });
+    var initialExplanation = env.state.skipInterpretation ? "" : env.seedHistoryFromExplanation();
+    var source = contextSource(env.panelOrCurrentSessionId(), payload.text.trim(), payload.context, initialExplanation);
+    if (env.state.contextState && env.state.contextState.source !== source) env.state.contextState = null;
+    var prepared = prepareChatHistory(historyTurns, env.state.contextState);
+    env.state.contextState = prepared.contextState;
+    var history = prepared.history;
+    var requestTurns = env.state.turns;
+    var requestKey = env.state.cacheKey;
     env.state.stopped = false;
     var askController = new AbortController();
     env.state.askRequest = {
@@ -7239,7 +7431,7 @@ function createConversationController(env) {
       }
     };
     function finish(error) {
-      clearInterval(timer);
+      env.timerScope.clear(timer);
       env.state.asking = false;
       env.state.toolBusy = false;
       env.clearTransientNotice(answerTurn);
@@ -7263,24 +7455,36 @@ function createConversationController(env) {
       );
       env.askFocusAfterTurn();
     }
+    var requestBody = JSON.stringify({
+      text: payload.text,
+      context: payload.context,
+      label: payload.label,
+      sessionId: env.panelOrCurrentSessionId(),
+      question: sent,
+      history,
+      key: requestKey,
+      historyStart: prepared.historyStart,
+      contextState: prepared.contextState,
+      materials: prepared.materials,
+      initialExplanation,
+      // 附件只带**引用**（图片/文件都已经在 host 的附件服务里），body 不会因为一张截图胖几 MB
+      ...withAttachments.length > 0 ? { attachments: withAttachments } : {},
+      // 网页输出要跟着当前深浅走：深色 Harness 里给一张白底页面会很刺眼
+      ...env.state.webAnswer ? { webAnswer: true, theme: env.currentSurfaceTheme() } : {},
+      ...env.state.modelChoice ? { provider: env.state.modelChoice.provider, model: env.state.modelChoice.model } : {},
+      ...env.state.effort ? { effort: env.state.effort } : {},
+      ...env.state.toolDigest ? { toolDigest: env.state.toolDigest } : {}
+    });
+    if (new TextEncoder().encode(requestBody).byteLength > CHAT_REQUEST_BYTES) {
+      questionTurn.contextExcluded = true;
+      answerTurn.contextExcluded = true;
+      finish("\u672C\u8F6E\u6750\u6599\u8D85\u8FC7\u8BF7\u6C42\u5BB9\u91CF\uFF0C\u8BF7\u7F29\u5C0F\u63D0\u95EE\u6216\u5F15\u7528\u8303\u56F4\uFF1B\u539F\u6587\u4ECD\u4FDD\u7559\u5728\u5F53\u524D\u5386\u53F2\u4E2D");
+      return;
+    }
     fetch(API, {
       method: "POST",
       headers: { "content-type": "application/json" },
-      body: JSON.stringify({
-        text: payload.text,
-        context: payload.context,
-        label: payload.label,
-        sessionId: env.panelOrCurrentSessionId(),
-        question: sent,
-        history,
-        // 附件只带**引用**（图片/文件都已经在 host 的附件服务里），body 不会因为一张截图胖几 MB
-        ...withAttachments.length > 0 ? { attachments: withAttachments } : {},
-        // 网页输出要跟着当前深浅走：深色 Harness 里给一张白底页面会很刺眼
-        ...env.state.webAnswer ? { webAnswer: true, theme: env.currentSurfaceTheme() } : {},
-        ...env.state.modelChoice ? { provider: env.state.modelChoice.provider, model: env.state.modelChoice.model } : {},
-        ...env.state.effort ? { effort: env.state.effort } : {},
-        ...env.state.toolDigest ? { toolDigest: env.state.toolDigest } : {}
-      }),
+      body: requestBody,
       signal: askController.signal
     }).then(function(response) {
       if (!response.ok) {
@@ -7306,7 +7510,18 @@ function createConversationController(env) {
           } catch (error) {
             continue;
           }
-          if (message.type === "delta") {
+          if (message.type === "context-state") {
+            if (!askController.signal.aborted && env.state.turns === requestTurns && env.state.cacheKey === requestKey) {
+              env.state.contextState = readContextState(message.state);
+            }
+          } else if (message.type === "material-restored") {
+            var material = message.attachment;
+            if (!askController.signal.aborted && material && (material.kind === "image" || material.kind === "file") && material.ref && material.ref.attachmentId) {
+              if (!questionTurn.attachments.some(function(a) {
+                return a.kind === material.kind && a.ref.attachmentId === material.ref.attachmentId;
+              })) questionTurn.attachments.push(material);
+            }
+          } else if (message.type === "delta") {
             env.clearTransientNotice(answerTurn);
             if (!answerTurn.text.trim()) answerTurn.asking = false;
             answerTurn.text += message.text;
@@ -7345,6 +7560,10 @@ function createConversationController(env) {
             }
             scheduleTurnsRender();
           } else if (message.type === "error") {
+            if (message.code === "context-rejected") {
+              questionTurn.contextExcluded = true;
+              answerTurn.contextExcluded = true;
+            }
             finish(message.message || "\u6A21\u578B\u8FD4\u56DE\u9519\u8BEF");
           }
         }
@@ -7502,16 +7721,15 @@ function createConversationController(env) {
     env.state.startedAt = Date.now();
     env.state.elapsed = 0;
     env.paint();
-    var ticker = setInterval(function() {
+    var ticker = env.timerScope.interval(function() {
       env.paintPill();
       if (env.state.phase === "loading" || env.state.phase === "streaming") {
         env.setStatus(env.progressText());
         updateWaitClocks();
       }
     }, 200);
-    env.timers.push(ticker);
     function stopTicker() {
-      clearInterval(ticker);
+      env.timerScope.clear(ticker);
     }
     function fail(message) {
       if (env.state.phase === "done") return;
@@ -9100,6 +9318,101 @@ function createVoiceController(env) {
   };
 }
 
+// src/client/memory.js
+function createResultCache(maxEntries = 20, maxBytes = 8 * 1024 * 1024) {
+  const entries = /* @__PURE__ */ new Map();
+  let textBytes = 0;
+  let disposed = false;
+  function remove(key) {
+    const entry = entries.get(key);
+    if (!entry) return;
+    textBytes -= entry.bytes;
+    entries.delete(key);
+  }
+  const cache = {
+    get size() {
+      return entries.size;
+    },
+    // Conservative UTF-16 size of serialized text, not a measurement of JS heap size.
+    get textBytes() {
+      return textBytes;
+    },
+    keys() {
+      return entries.keys();
+    },
+    get(key) {
+      const entry = entries.get(key);
+      if (!entry) return void 0;
+      entries.delete(key);
+      entries.set(key, entry);
+      return JSON.parse(entry.json);
+    },
+    set(key, value) {
+      if (disposed) return cache;
+      remove(key);
+      let json;
+      try {
+        json = JSON.stringify(value);
+      } catch {
+        return cache;
+      }
+      if (typeof json !== "string") return cache;
+      const bytes = (String(key).length + json.length) * 2;
+      if (bytes > maxBytes || maxEntries <= 0) return cache;
+      entries.set(key, { json, bytes });
+      textBytes += bytes;
+      while (entries.size > maxEntries || textBytes > maxBytes) remove(entries.keys().next().value);
+      return cache;
+    },
+    clear() {
+      entries.clear();
+      textBytes = 0;
+    },
+    dispose() {
+      disposed = true;
+      cache.clear();
+    }
+  };
+  return cache;
+}
+function createTimerScope() {
+  const active = /* @__PURE__ */ new Set();
+  let disposed = false;
+  return {
+    get size() {
+      return active.size;
+    },
+    later(fn, ms) {
+      if (disposed) return null;
+      const id = setTimeout(() => {
+        active.delete(id);
+        if (!disposed) fn();
+      }, ms);
+      active.add(id);
+      return id;
+    },
+    interval(fn, ms) {
+      if (disposed) return null;
+      const id = setInterval(fn, ms);
+      active.add(id);
+      return id;
+    },
+    clear(id) {
+      clearTimeout(id);
+      clearInterval(id);
+      active.delete(id);
+    },
+    dispose() {
+      disposed = true;
+      active.forEach((id) => {
+        clearTimeout(id);
+        clearInterval(id);
+      });
+      active.clear();
+    }
+  };
+}
+
 // src/client/index.js
 function apply(ctx) {
   var state = {
@@ -9148,6 +9461,14 @@ function apply(ctx) {
     payload: null,
     /** 已生成的两节内容（分阶段产出）。 */
     parts: { translation: "", detail: "" },
+    /**
+     * 这段对话**没有解读**（语音卡那条"跳过翻译与详解、直接追问"的路）：
+     * 翻译节整节不画，追问输入框直接可见。
+     *
+     * 语义单位是"一段对话"而不是"一次开窗"：落盘时写进历史条目的 skipped，
+     * 回放/缓存命中时按它复原（否则同一个词再开一次，空翻译卡片又冒出来 —— 用户实测）。
+     */
+    skipInterpretation: false,
     /** 当前阶段：'translation' | 'detail' | 'chat'。 */
     stage: "",
     /** 追问轮次：[{ role: 'user' | 'assistant', text }]，只活在面板/内存里（临时）。 */
@@ -9204,7 +9525,8 @@ function apply(ctx) {
     /** 升格请求进行中。 */
     promoting: false
   };
-  var cache = /* @__PURE__ */ new Map();
+  var cache = createResultCache();
+  var timerScope = createTimerScope();
   var styleEl = el("style");
   styleEl.setAttribute("data-plugin", "@yfwu2020/dsh-selection-explain");
   styleEl.textContent = CSS;
@@ -9639,8 +9961,8 @@ function apply(ctx) {
     get frameTouchedAt() {
       return previewController.frameTouchedAt;
     },
-    get timers() {
-      return timers;
+    get timerScope() {
+      return timerScope;
     },
     get voice() {
       return voiceController.voice;
@@ -9665,6 +9987,9 @@ function apply(ctx) {
     }
   });
   var quotesController = createQuotesController({
+    get foldForHistory() {
+      return historyController.foldForHistory;
+    },
     get state() {
       return state;
     },
@@ -9698,8 +10023,8 @@ function apply(ctx) {
     get currentSessionId() {
       return panelController.currentSessionId;
     },
-    get timers() {
-      return timers;
+    get timerScope() {
+      return timerScope;
     }
   });
   var previewController = createPreviewController({
@@ -9720,6 +10045,9 @@ function apply(ctx) {
     }
   });
   var panelController = createPanelController({
+    get timerScope() {
+      return timerScope;
+    },
     get panelSessionId() {
       return panelSessionId;
     },
@@ -9756,6 +10084,12 @@ function apply(ctx) {
     get renderTurns() {
       return historyController.renderTurns;
     },
+    get clearRenderedTurns() {
+      return historyController.clearRenderedTurns;
+    },
+    get clearWaiting() {
+      return conversationController.clearWaiting;
+    },
     get sendAsk() {
       return conversationController.sendAsk;
     },
@@ -10015,6 +10349,9 @@ function apply(ctx) {
     }
   });
   var historyController = createHistoryController({
+    set panelSessionId(value) {
+      panelSessionId = value;
+    },
     get sentTextOf() {
       return quotesController.sentTextOf;
     },
@@ -10045,8 +10382,8 @@ function apply(ctx) {
     get paint() {
       return panelController.paint;
     },
-    get timers() {
-      return timers;
+    get timerScope() {
+      return timerScope;
     },
     get panelOpen() {
       return panelOpen;
@@ -10176,14 +10513,8 @@ function apply(ctx) {
     get paintPill() {
       return pillController.paintPill;
     },
-    get timers() {
-      return timers;
-    },
-    get FOLD_HISTORY_KEEP_LATEST() {
-      return historyController.FOLD_HISTORY_KEEP_LATEST;
-    },
-    get historyTextOf() {
-      return historyController.historyTextOf;
+    get timerScope() {
+      return timerScope;
     },
     get clearTransientNotice() {
       return historyController.clearTransientNotice;
@@ -10457,7 +10788,6 @@ function apply(ctx) {
   var STREAM_RENDER_MS = 90;
   var turnsRenderPending = false;
   var lastTurnsRenderAt = 0;
-  var timers = [];
   var PILL_POLL_MIN = 2e3;
   var PILL_POLL_MAX = 6e4;
   var pillPollDelay = PILL_POLL_MIN;
@@ -10477,9 +10807,7 @@ function apply(ctx) {
   var pillObserver = null;
   var waitList = [];
   function later(fn, ms) {
-    var id = setTimeout(fn, ms);
-    timers.push(id);
-    return id;
+    return timerScope.later(fn, ms);
   }
   var offBridgeMessage = listen(window, "message", function(event) {
     var data = event && event.data;
@@ -11049,6 +11377,14 @@ function apply(ctx) {
     turns: function() {
       return state.turns.slice();
     },
+    memory: function() {
+      return {
+        cacheEntries: cache.size,
+        cacheTextBytes: cache.textBytes,
+        timers: timerScope.size,
+        previewFrames: Object.keys(previewFrames).length
+      };
+    },
     /** 自检用：当前待发送的引用（引用区里那几张卡片）。 */
     quotes: function() {
       return state.quotes.map(function(quote2) {
@@ -11393,6 +11729,7 @@ function apply(ctx) {
       state.selection = null;
       state.bridgeActive = false;
       state.parts = { translation: "", detail: "" };
+      state.contextState = null;
       state.turns = [];
       quotesController.clearQuotes();
       state.raw = "";
@@ -11420,6 +11757,13 @@ function apply(ctx) {
       console.log("[dsh-selection-explain] \u5212\u8BCD\u89E3\u8BFB\u5DF2\u5C31\u7EEA\uFF08\u9009\u4E2D\u6587\u5B57\u8BD5\u8BD5\uFF09");
     }
     return function() {
+      panelOpen = false;
+      timerScope.dispose();
+      cache.dispose();
+      voiceCardController.closeVCard(false);
+      attachController.clear();
+      panelController.releaseRenderedContent();
+      if (state.askRequest) state.askRequest.abort();
       offPopEnd();
       offQuotePopEnd();
       offMouseUp();
@@ -11507,13 +11851,17 @@ function apply(ctx) {
         }
       });
       previewController.bridged.clear();
+      previewController.frameTouchedAt.clear();
       state.turns = [];
       state.quotes = [];
+      state.selection = null;
+      state.quoteSelection = null;
+      state.payload = null;
+      state.parts = { translation: "", detail: "" };
+      state.raw = "";
       if (state.request) state.request.abort();
-      for (var i = 0; i < timers.length; i++) clearTimeout(timers[i]);
       if (pillIdleId) clearTimeout(pillIdleId);
       if (pillController.pillStarTimer) clearTimeout(pillController.pillStarTimer);
-      cache.clear();
       if (layer.parentNode) layer.parentNode.removeChild(layer);
       if (button.parentNode) button.parentNode.removeChild(button);
       if (quoteButton.parentNode) quoteButton.parentNode.removeChild(quoteButton);