@ggboy123/dsh-paper-reader 0.1.0

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@ggboy123/dsh-paper-reader",
+  "version": "0.1.0",
+  "description": "DeepSeek Harness 插件：论文伴读工作台 — PDF 转录 / 检索 / 原生对话伴读 + 内置阅读器页面。",
+  "license": "MIT",
+  "type": "module",
+  "author": "GGboya",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GGboya/dsh-paper-reader.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GGboya/dsh-paper-reader/issues"
+  },
+  "homepage": "https://github.com/GGboya/dsh-paper-reader#readme",
+  "engines": {
+    "node": "^22.19.0 || >=24"
+  },
+  "main": "./dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./client": "./lib/client.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "lib",
+    "reader",
+    "presets",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-locale"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "tsc -p tsconfig.json"
+  },
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "pdf",
+    "paper",
+    "reader"
+  ],
+  "dependencies": {
+    "@deepseek-ai/dsh-tools": "0.1.5-rc.2"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.6.0"
+  }
+}

package/presets/paper-reader/agent.cordis.yml

@@ -0,0 +1,57 @@
+# dsh-paper-reader 的论文伴读 agent preset。
+#
+# 设计：persona 即完整系统提示词（complete），屏蔽编码 agent 身份与运行时上下文；
+# 工具面只保留宿主层注册的论文工具（list_papers/transcribe_pdf/search_paper/
+# study_progress/study_update）——不带 bash/fs/todo/web。compaction 组照抄
+# standard preset，长会话上下文可压缩。插件启动时把本目录复制到
+# $DSH_HOME/.agent-presets/paper-reader/（用户根，发现是实时扫描，免重启）。
+
+- id: persona
+  name: '@deepseek-ai/dsh-persona'
+  config:
+    complete: true
+    includeRuntimeContext: false
+    prefix: |
+      You are a paper-reading tutor (论文伴读老师) powered by the {{model}} model. You don't just answer questions about a paper — you TEACH it, the way a good advisor walks a student through a paper: with a plan, step-by-step guidance, and exams.
+
+      Tools at your disposal:
+      - list_papers: list topics and papers in the library.
+      - transcribe_pdf: extract a paper's full text (cached, with a per-page index).
+      - search_paper: search one paper's transcript; returns chunks with page numbers.
+      - study_progress: read the student's learning record for a paper (plan + quiz history), stored in <论文>.study.json next to the PDF.
+      - study_update: update that record — set_plan (3~6 steps), complete_step (with your feedback note), record_quiz (score/total + weak-point summary).
+
+      Your session is bound to one paper: every paper tool auto-locates it when you omit topic/name, so NEVER ask the user which paper they mean in a paper session — just call the tool. Only pass topic/name explicitly when the user asks about a DIFFERENT paper.
+
+      Two modes:
+
+      1) Quick Q&A. When the user asks a factual question (often a passage selected in the reader, with its page number), just answer it: search_paper first, answer with explicit page citations like （第 4 页）, match the user's language. No lesson, no plan, no quiz.
+
+      2) Guided learning. When the user wants to LEARN the paper ("带我读", "我想学这篇", "继续", "检验我", or is working through a plan), act as the tutor:
+      - Always start by calling study_progress to see where the student is.
+      - No plan yet: skim the paper (transcribe/search the abstract, introduction, section headings), then design a 3~6 step reading plan. Each step names WHAT to read (with pages) and WHAT the student should be able to explain afterwards. Save it with set_plan, present it, and immediately start guiding step 1.
+      - Guiding a step: point to the exact pages/sections, explain the background the student needs, and end with one focused question the student answers in their own words. When they respond, give specific feedback (what was right, what was missing, with page references) and IN THE SAME TURN call complete_step with a short note — feedback without the complete_step call is a bookkeeping failure; the next step only begins after the record shows it. If you skipped earlier bookkeeping, read study_progress and bring it up to date before continuing.
+      - After the plan is done, or when the student asks to be tested: run a quiz — 3~5 questions grounded in the paper (mix of recall and "why is it designed this way"), one at a time or as a set; grade each answer specifically, and IN THE SAME TURN as the final grading call record_quiz with the score and a weak-point summary, then finish with targeted review advice (which pages to revisit).
+      - Be encouraging but honest. Praise what was genuinely understood; never wave through a wrong answer. Chinese students get Chinese, English students get English.
+
+      The conversation itself is durable (the harness persists it) — never offer to save, archive, or export the conversation, and never mention file paths or tool names in your reply.
+
+- id: compaction
+  name: cordis:group
+  group: true
+  isolate:
+    compaction: true
+    toolResultPruner: true
+  config:
+    - id: compaction-basic
+      name: '@deepseek-ai/dsh-compaction-basic'
+
+    - id: command-compact
+      name: '@deepseek-ai/dsh-command-compact'
+
+    - id: tool-result-pruner
+      name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
+      config:
+        thresholdChars: 8192
+        headChars: 4096
+        tailChars: 1024

package/presets/paper-reader/preset.yml

@@ -0,0 +1,3 @@
+name: 论文伴读
+description: 像老师一样带读论文的 Agent：制定分步阅读计划、逐节指导、出题检验并记录成绩（每篇论文一份 .study.json 学习档案）。
+order: 10

package/reader/index.html

@@ -0,0 +1,433 @@
+<!DOCTYPE html>
+<html lang="zh">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>论文伴读 · dsh-paper-reader</title>
+<script src="https://cdn.jsdelivr.net/npm/pdfjs-dist@3.11.174/build/pdf.min.js"></script>
+<style>
+  :root {
+    --bg: #f6f7f9; --panel: #ffffff; --border: #e2e5ea; --text: #24292f;
+    --text-2: #656d76; --accent: #0969da; --accent-soft: rgba(9,105,218,.12);
+    --hl: rgba(255, 196, 0, .55);
+  }
+  * { box-sizing: border-box; }
+  html, body { margin: 0; height: 100%; }
+  body { font: 14px/1.6 -apple-system, "SF Pro", "PingFang SC", "Helvetica Neue", sans-serif; background: var(--bg); color: var(--text); display: flex; flex-direction: column; }
+
+  /* ---------- 顶栏 ---------- */
+  #bar { display: flex; align-items: center; gap: 8px; padding: 8px 12px; background: var(--panel); border-bottom: 1px solid var(--border); flex: none; }
+  #bar button { font: inherit; }
+  /* flex:none —— 列被拖窄时按钮不许被压缩（否则文字竖排、按钮变窄条） */
+  .tbtn { flex: none; padding: 4px 10px; border: 1px solid var(--border); border-radius: 6px; background: var(--panel); color: var(--text); cursor: pointer; }
+  .tbtn:hover { background: var(--bg); }
+  .tbtn.active { background: var(--accent-soft); border-color: var(--accent); color: var(--accent); }
+  .tbtn:disabled { opacity: .45; cursor: default; }
+  #zh-toggle { font-weight: 700; }
+  #zoom-label { flex: none; min-width: 44px; text-align: center; color: var(--text-2); }
+  #bar .spacer { flex: 1; }
+  /* min-width:0 —— flex 项默认 min-width:auto 会拒绝收缩，空间不够时转而去挤按钮；
+     让标题自己截断（已有 ellipsis），按钮才能保持原样 */
+  #status { min-width: 0; color: var(--text-2); font-size: 12.5px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+
+  /* ---------- PDF 区 ---------- */
+  #main { display: flex; flex: 1; min-height: 0; }
+  #pdf-pane { flex: 1; overflow: auto; padding: 16px; }
+  /* safe center：页宽超过视口时退回左对齐——普通 center 会让左右同时溢出且左侧滚不到 */
+  #pdf-pages { display: flex; flex-direction: column; align-items: safe center; gap: 14px; }
+  .page { position: relative; background: #fff; box-shadow: 0 1px 4px rgba(0,0,0,.18); }
+  .page.flash { outline: 3px solid var(--hl); outline-offset: 2px; transition: outline .15s; }
+  .textLayer { position: absolute; inset: 0; overflow: hidden; line-height: 1; }
+  .textLayer span { position: absolute; white-space: pre; color: transparent; cursor: text; transform-origin: 0 0; }
+  .textLayer ::selection { background: rgba(22,93,255,.3); }
+  #empty { margin: 60px auto; color: var(--text-2); text-align: center; max-width: 420px; }
+
+  /* ---------- 选中即问浮层 ---------- */
+  #ask-pop { position: fixed; z-index: 50; display: none; background: var(--panel); border: 1px solid var(--border); border-radius: 10px; box-shadow: 0 6px 24px rgba(0,0,0,.16); padding: 10px; width: 320px; }
+  #ask-quote { font-size: 12px; color: var(--text-2); max-height: 64px; overflow: hidden; margin-bottom: 8px; border-left: 3px solid var(--accent-soft); padding-left: 8px; }
+  #ask-input { width: 100%; border: 1px solid var(--border); border-radius: 6px; padding: 6px 8px; font: inherit; resize: none; }
+  #ask-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 8px; }
+  #ask-send { background: var(--accent); color: #fff; border: none; border-radius: 6px; padding: 5px 14px; cursor: pointer; }
+  #ask-send:disabled { opacity: .5; cursor: default; }
+  #ask-cancel { background: none; border: none; color: var(--text-2); cursor: pointer; }
+
+  /* ---------- 翻译端点设置浮层 ---------- */
+  /* 阅读器在窄 iframe 里，宽度要能收缩 */
+  #cfg-pop { position: fixed; z-index: 60; display: none; background: var(--panel); border: 1px solid var(--border); border-radius: 10px; box-shadow: 0 6px 24px rgba(0,0,0,.16); padding: 10px; width: min(320px, calc(100vw - 32px)); }
+  #cfg-pop h3 { margin: 0; font-size: 13px; }
+  #cfg-hint { font-size: 12px; color: var(--text-2); margin: 4px 0 2px; }
+  #cfg-pop label { display: block; font-size: 12px; color: var(--text-2); margin: 8px 0 2px; }
+  #cfg-pop input { width: 100%; border: 1px solid var(--border); border-radius: 6px; padding: 6px 8px; font: inherit; }
+  #cfg-actions { display: flex; justify-content: flex-end; gap: 8px; margin-top: 10px; }
+  #cfg-save { background: var(--accent); color: #fff; border: none; border-radius: 6px; padding: 5px 14px; cursor: pointer; }
+  #cfg-save:disabled { opacity: .5; cursor: default; }
+  #cfg-cancel { background: none; border: none; color: var(--text-2); cursor: pointer; }
+
+  #toast { position: fixed; left: 50%; bottom: 28px; transform: translateX(-50%); background: rgba(30,30,30,.92); color: #fff; padding: 8px 16px; border-radius: 8px; font-size: 13px; display: none; z-index: 99; max-width: 70%; }
+</style>
+</head>
+<body>
+
+<div id="bar">
+  <span id="status">论文伴读</span>
+  <button id="zh-toggle" class="tbtn" title="切换中文译文（没有译文时可生成）" style="display:none">中</button>
+  <span class="spacer"></span>
+  <button id="cfg-open" class="tbtn" title="翻译端点设置">⚙</button>
+  <button id="zoom-out" class="tbtn">−</button>
+  <span id="zoom-label">100%</span>
+  <button id="zoom-in" class="tbtn">＋</button>
+  <button id="zoom-fit" class="tbtn">适宽</button>
+</div>
+
+<div id="main">
+  <div id="pdf-pane">
+    <div id="pdf-pages"></div>
+    <div id="empty" style="display:none"></div>
+  </div>
+</div>
+
+<div id="ask-pop">
+  <div id="ask-quote"></div>
+  <textarea id="ask-input" rows="2" placeholder="围绕选中内容提问…"></textarea>
+  <div id="ask-actions">
+    <button id="ask-cancel">取消</button>
+    <button id="ask-send">提问</button>
+  </div>
+</div>
+
+<div id="cfg-pop">
+  <h3>翻译端点</h3>
+  <div id="cfg-hint">填 OpenAI 兼容端点即可（DeepSeek / 通义 / 本地 vLLM 等）。保存前会先测试连接。</div>
+  <label for="cfg-url">端点 URL</label>
+  <input id="cfg-url" type="text" placeholder="https://api.deepseek.com/v1" autocomplete="off">
+  <label for="cfg-key">API Key</label>
+  <input id="cfg-key" type="password" placeholder="sk-..." autocomplete="new-password">
+  <label for="cfg-model">模型</label>
+  <input id="cfg-model" type="text" placeholder="deepseek-chat" autocomplete="off">
+  <div id="cfg-actions">
+    <button id="cfg-cancel">取消</button>
+    <button id="cfg-save">保存</button>
+  </div>
+</div>
+
+<div id="toast"></div>
+
+<script>
+'use strict';
+/* ================= 基础 ================= */
+const $ = (id) => document.getElementById(id);
+const api = (p, opts) => fetch('/paper-reader/api' + p, opts).then(async (r) => {
+  if (!r.ok) {
+    // 服务端错误体有两种：{error}（参数/权限）与 {reason}（zh/generate 的未启动原因，带完整说明）
+    const body = await r.json().catch(() => ({}));
+    const err = new Error(body.error || body.reason || ('HTTP ' + r.status));
+    err.code = body.code;   // 机器可读码（如 no-endpoint）——让调用方靠它分支，别去匹配中文文案
+    err.status = r.status;
+    throw err;
+  }
+  return r.json();
+});
+function toast(msg, ms = 3200) {
+  const t = $('toast'); t.textContent = msg; t.style.display = 'block';
+  clearTimeout(toast._t); toast._t = setTimeout(() => t.style.display = 'none', ms);
+}
+function esc(s) { return s.replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c])); }
+
+let current = null;        // { topic, name }
+let zhState = { zh: false, dual: false, busy: false };
+let zhVariant = null;      // null=原文 'dual'=中英对照 'zh'=纯中文
+
+/* ================= 打开文献 ================= */
+function pdfUrl(variant) {
+  const q = `topic=${encodeURIComponent(current.topic)}&name=${encodeURIComponent(current.name)}`;
+  return `/paper-reader/api/pdf?${q}${variant ? '&variant=' + variant : ''}&t=${Date.now()}`;
+}
+
+async function openPaper(topic, name, opts = {}) {
+  if (!name) return;
+  current = { topic, name };
+  localStorage.setItem('dpr.last', JSON.stringify(current));
+  zhVariant = null;
+  $('zh-toggle').classList.remove('active');
+  $('status').textContent = '加载 PDF…';
+  const q = `topic=${encodeURIComponent(topic)}&name=${encodeURIComponent(name)}`;
+  const meta = await api('/paper?' + q);
+  $('status').textContent = meta.hasTranscript
+    ? `${name} · ${meta.pageCount ?? '?'} 页`
+    : `${name} · 未转录（提问时会自动转录）`;
+  await refreshZhState();
+  await loadPdf(pdfUrl(null));
+  if (opts.page) jumpToPage(opts.page);
+}
+
+/* ================= 中英切换 ================= */
+async function refreshZhState() {
+  zhState = await api(`/zh?topic=${encodeURIComponent(current.topic)}&name=${encodeURIComponent(current.name)}`);
+  const btn = $('zh-toggle');
+  btn.style.display = '';
+  btn.disabled = zhState.busy;
+  btn.textContent = zhState.busy ? '译' : '中';
+  btn.title = zhState.busy ? '翻译进行中…'
+    : (zhState.zh || zhState.dual) ? '切换中文译文'
+    : '还没有中文版，点击生成（babeldoc，需要几分钟）';
+}
+
+$('zh-toggle').onclick = async () => {
+  if (!current || zhState.busy) return;
+  if (zhState.dual || zhState.zh) {
+    // 两态切换：原文 ↔ 纯中文；只存在对照版时退到对照
+    zhVariant = zhVariant === null ? (zhState.zh ? 'zh' : 'dual') : null;
+    $('zh-toggle').classList.toggle('active', zhVariant !== null);
+    // 切换变体后强制适宽：译文版页宽与原文不同（对照双栏≈2×），不重算会溢出裁切
+    fitMode = true; fitBtn.classList.add('active');
+    await loadPdf(pdfUrl(zhVariant));
+    return;
+  }
+  try {
+    await api('/zh/generate', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(current) });
+    toast('开始生成中文版（babeldoc，约几分钟）…', 5000);
+  } catch (e) {
+    // 没配端点 → 直接弹配置表单；填好保存后自动回来重试生成
+    if (e.code === 'no-endpoint') { openCfgPop(true); return; }
+    toast(e.message, 8000); return;
+  }
+  $('zh-toggle').disabled = true; $('zh-toggle').textContent = '译';
+  const timer = setInterval(async () => {
+    await refreshZhState();
+    if (!zhState.busy) {
+      clearInterval(timer);
+      if (zhState.dual || zhState.zh) { toast('中文版已生成'); $('zh-toggle').click(); }
+      else toast('生成失败：' + (zhState.error || '未知原因'), 8000);
+    }
+  }, 5000);
+};
+
+/* ================= 翻译端点设置 ================= */
+// 保存成功后是否自动接着生成：点「中」发现没配 → 弹本表单 → 填完直接开跑
+let cfgRetryGenerate = false;
+
+async function openCfgPop(retryGenerate) {
+  cfgRetryGenerate = Boolean(retryGenerate);
+  let cfg;
+  try {
+    cfg = await api('/translate/config');
+  } catch (e) { toast('读取配置失败：' + e.message, 8000); return; }
+  $('cfg-url').value = cfg.baseUrl || '';
+  $('cfg-model').value = cfg.model || '';
+  // 明文 key 不回传：留空 = 沿用已存的那把
+  $('cfg-key').value = '';
+  $('cfg-key').placeholder = cfg.hasApiKey ? `已保存（${cfg.apiKeyHint}），留空则不修改` : 'sk-...';
+  const pop = $('cfg-pop');
+  pop.style.display = 'block';
+  // 先显示再量尺寸（不像 #ask-pop 那样写死尺寸常量，免得跟 CSS 漂移）
+  pop.style.left = Math.max(8, (window.innerWidth - pop.offsetWidth) / 2) + 'px';
+  pop.style.top = Math.max(8, (window.innerHeight - pop.offsetHeight) / 3) + 'px';
+  $('cfg-url').focus();
+}
+function closeCfgPop() { $('cfg-pop').style.display = 'none'; cfgRetryGenerate = false; }
+
+$('cfg-open').onclick = () => openCfgPop(false);
+$('cfg-cancel').onclick = closeCfgPop;
+
+$('cfg-save').onclick = async () => {
+  const btn = $('cfg-save'), label = btn.textContent, retry = cfgRetryGenerate;
+  btn.disabled = true; btn.textContent = '测试中…';
+  try {
+    // 服务端先打一发极小的 chat/completions 验证 url/key/model，通过才落盘
+    await api('/translate/config', {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({
+        baseUrl: $('cfg-url').value.trim(),
+        apiKey: $('cfg-key').value.trim(),
+        model: $('cfg-model').value.trim(),
+      }),
+    });
+  } catch (e) {
+    toast('保存失败：' + e.message, 8000);
+    return;
+  } finally {
+    btn.disabled = false; btn.textContent = label;
+  }
+  closeCfgPop();
+  await refreshZhState();
+  if (retry) $('zh-toggle').click();  // 复用「中」的生成逻辑（含它自己的 toast）
+  else toast('翻译端点已保存');
+};
+
+/* ================= PDF 渲染(pdf.js:缩放 + devicePixelRatio 高清,移植自 pdfqa) ================= */
+pdfjsLib.GlobalWorkerOptions.workerSrc = 'https://cdn.jsdelivr.net/npm/pdfjs-dist@3.11.174/build/pdf.worker.min.js';
+
+let pdfDoc = null;
+let zoomScale = 1.5;
+let dpr = window.devicePixelRatio || 1;
+let renderToken = 0;
+
+(function watchDpr() {
+  const mq = matchMedia(`(resolution: ${dpr}dppx)`);
+  mq.addEventListener('change', function onChange() {
+    mq.removeEventListener('change', onChange);
+    dpr = window.devicePixelRatio || 1;
+    if (pdfDoc) renderAllPages();
+    watchDpr();
+  });
+})();
+
+async function loadPdf(url) {
+  pdfDoc = await pdfjsLib.getDocument(url).promise;
+  $('empty').style.display = 'none';
+  if (fitMode) { fitToWidth(); return; } // fitToWidth 内部 setZoom → renderAllPages
+  await renderAllPages();
+}
+
+async function renderAllPages() {
+  const token = ++renderToken;
+  const container = $('pdf-pages');
+  const pane = $('pdf-pane');
+  if (pane.clientHeight === 0) return; // 悬浮层隐藏期间不重渲（否则锚点恢复会把滚动清零）
+  // 滚动比例锚点：不用 DOM rect（并发重渲时旧页可能已被清空，rect 全灭 → 锚点归零）
+  const range = pane.scrollHeight - pane.clientHeight;
+  const anchorRatio = range > 0 ? pane.scrollTop / range : 0;
+  container.innerHTML = '';
+  $('zoom-label').textContent = Math.round(zoomScale / 1.5 * 100) + '%';
+
+  for (let i = 1; i <= pdfDoc.numPages; i++) {
+    if (token !== renderToken) return;
+    const page = await pdfDoc.getPage(i);
+    if (token !== renderToken) return;
+    const viewport = page.getViewport({ scale: zoomScale });
+    const div = document.createElement('div');
+    div.className = 'page';
+    div.dataset.page = i;
+    div.style.width = viewport.width + 'px';
+
+    const canvas = document.createElement('canvas');
+    canvas.width = Math.ceil(viewport.width * dpr);
+    canvas.height = Math.ceil(viewport.height * dpr);
+    canvas.style.width = viewport.width + 'px';
+    canvas.style.height = viewport.height + 'px';
+    div.appendChild(canvas);
+
+    const tl = document.createElement('div');
+    tl.className = 'textLayer';
+    tl.style.width = viewport.width + 'px';
+    tl.style.height = viewport.height + 'px';
+    tl.style.setProperty('--scale-factor', String(zoomScale));
+    div.appendChild(tl);
+    container.appendChild(div);
+
+    await page.render({
+      canvasContext: canvas.getContext('2d'),
+      viewport,
+      transform: dpr !== 1 ? [dpr, 0, 0, dpr, 0, 0] : null,
+    }).promise;
+    if (token !== renderToken) return;
+    const tc = await page.getTextContent();
+    if (token !== renderToken) return;
+    await pdfjsLib.renderTextLayer({ textContent: tc, container: tl, viewport, textDivs: [] }).promise;
+  }
+  const newRange = pane.scrollHeight - pane.clientHeight;
+  pane.scrollTop = anchorRatio * Math.max(0, newRange);
+}
+
+function setZoom(newScale) { if (!pdfDoc) return; zoomScale = Math.min(4.5, Math.max(0.6, newScale)); renderAllPages(); }
+// 默认适宽：rightbar 窄列里 1.5 倍缩放会把页面撑出视口（中英对照双栏页宽≈2×，更明显）
+let fitMode = true;
+const fitBtn = $('zoom-fit');
+fitBtn.classList.add('active');
+function exitFitMode() { fitMode = false; fitBtn.classList.remove('active'); }
+function fitToWidth() {
+  if (!pdfDoc) return // resize 可能先于首次 loadPdf 触发（布局换位/条带注入会改容器尺寸）
+  const paneWidth = $('pdf-pane').clientWidth - 32
+  if (paneWidth <= 0) return // 隐藏期间尺寸为 0，算出的缩放无意义
+  pdfDoc.getPage(1).then((p) => setZoom(paneWidth / p.getViewport({ scale: 1 }).width))
+}
+$('zoom-in').onclick = () => { exitFitMode(); setZoom(zoomScale + 0.25); };
+$('zoom-out').onclick = () => { exitFitMode(); setZoom(zoomScale - 0.25); };
+fitBtn.onclick = () => { if (!pdfDoc) return; fitMode = true; fitBtn.classList.add('active'); fitBtn.blur(); fitToWidth(); };
+window.addEventListener('resize', () => { if (fitMode) fitToWidth(); });
+
+function jumpToPage(n) {
+  const div = document.querySelector(`.page[data-page="${n}"]`);
+  if (!div) return;
+  div.scrollIntoView({ behavior: 'smooth', block: 'start' });
+  div.classList.add('flash');
+  setTimeout(() => div.classList.remove('flash'), 1600);
+}
+
+/* ================= 选中即问 ================= */
+const askPop = $('ask-pop');
+let askSelection = null;
+
+document.addEventListener('mouseup', (e) => {
+  if (askPop.contains(e.target)) return;
+  setTimeout(() => {
+    const sel = window.getSelection();
+    const text = sel ? sel.toString().trim() : '';
+    if (!text || !current) { askPop.style.display = 'none'; return; }
+    const node = sel.anchorNode && sel.anchorNode.parentElement;
+    if (!node || !node.closest('.textLayer')) { askPop.style.display = 'none'; return; }
+    const range = sel.getRangeAt(0).getBoundingClientRect();
+    askSelection = { text, page: +((node.closest('.page') || {}).dataset?.page || 0) || null };
+    $('ask-quote').textContent = text.length > 140 ? text.slice(0, 140) + '…' : text;
+    $('ask-input').value = '';
+    askPop.style.display = 'block';
+    // 夹在 iframe 视口内（rightbar 窄列里也要能用）
+    const popW = 336, popH = 190;
+    const x = Math.max(8, Math.min(e.clientX, window.innerWidth - popW - 8));
+    const y = Math.max(8, Math.min(range.bottom + 8, window.innerHeight - popH - 8));
+    askPop.style.left = x + 'px';
+    askPop.style.top = y + 'px';
+    $('ask-input').focus();
+  }, 10);
+});
+document.addEventListener('mousedown', (e) => { if (!askPop.contains(e.target)) askPop.style.display = 'none'; });
+$('ask-cancel').onclick = () => { askPop.style.display = 'none'; };
+
+$('ask-send').onclick = async () => {
+  const question = $('ask-input').value.trim();
+  if (!question || !askSelection || !current) return;
+  $('ask-send').disabled = true;
+  try {
+    // 会话序号由侧栏树激活时写入 localStorage（默认最新）
+    const key = `dpr.sessionN.${current.topic}/${current.name}`;
+    const n = +(localStorage.getItem(key) || 0) || undefined;
+    const r = await api('/ask', {
+      method: 'POST', headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ ...current, question, selectedText: askSelection.text, page: askSelection.page, ...(n ? { n } : {}) }),
+    });
+    askPop.style.display = 'none';
+    toast(`已发送到 会话${r.n}，回答见对话区`);
+  } catch (e) { toast('提问失败：' + e.message, 6000); }
+  $('ask-send').disabled = false;
+};
+$('ask-input').addEventListener('keydown', (e) => { if (e.key === 'Enter' && !e.shiftKey) { e.preventDefault(); $('ask-send').click(); } });
+
+/* ================= 启动：URL 参数 > localStorage > 第一篇 ================= */
+async function bootstrap() {
+  const params = new URLSearchParams(location.search);
+  const pTopic = params.get('topic'), pName = params.get('name');
+  const lib = await api('/library');
+  if (lib.topics.length === 0) {
+    $('empty').style.display = 'block';
+    $('empty').innerHTML = '文献库为空。<br>在左侧文献库树上传 PDF 或新建专题即可开始。';
+    return;
+  }
+  let target = null;
+  if (pTopic && pName && lib.papers.some((p) => p.topic === pTopic && p.name === pName)) target = { topic: pTopic, name: pName };
+  else {
+    const last = JSON.parse(localStorage.getItem('dpr.last') || 'null');
+    if (last && lib.papers.some((p) => p.topic === last.topic && p.name === last.name)) target = last;
+    else target = lib.papers[0];
+  }
+  if (target) await openPaper(target.topic, target.name);
+}
+bootstrap().catch((e) => {
+  $('empty').style.display = 'block';
+  $('empty').textContent = '文献库加载失败：' + e.message;
+});
+
+window.dpr = { openPaper: (topic, name, page) => openPaper(topic, name, { page }), jumpToPage };
+</script>
+</body>
+</html>