@ggboy123/dsh-paper-reader 0.4.0 → 0.6.2

package/dist/host.js

@@ -9,6 +9,7 @@ import { readTranscript, transcribePaper } from "./transcribe.js";
 import { pdfVariantPath, restartTranslation, startTranslation, zhStatus } from "./translate.js";
 import { clearTranslateConfig, maskApiKey, readTranslateConfig, resolveTranslateEndpoint, testTranslateEndpoint, writeTranslateConfig, } from "./translate-config.js";
 import { installPaperPreset, PAPER_PRESET_ID } from "./preset.js";
+import { noteOrigin } from "./origin.js";
 function json(res, status, body) {
     const buf = Buffer.from(JSON.stringify(body), 'utf8');
     res.writeHead(status, { 'content-type': 'application/json; charset=utf-8', 'content-length': buf.length });
@@ -464,6 +465,8 @@ export function registerRoutes(ctx, config) {
                     json(res, rejection, { error: rejection === 401 ? 'unauthorized' : 'forbidden' });
                     return;
                 }
+                // 借浏览器请求的 Host 头记录服务 origin（工具结果里的 readerUrl 链接基址靠它拼）
+                noteOrigin(req.headers.host);
                 const url = new URL(req.url ?? '/', 'http://x');
                 dispatch(req, res, url).catch((err) => {
                     if (!res.headersSent)

package/dist/origin.js

@@ -0,0 +1,13 @@
+// origin.ts — 记录 dsh web 服务的外部地址（从插件路由收到的请求 Host 头捕获）。
+// 工具进程不是 HTTP 请求，自己不知道服务端口；但浏览器客户端会持续打 /paper-reader/api
+// （文献库 30s 轮询等），借它的 Host 头还原出可点击链接的基址。
+let origin = null;
+/** 每次插件路由被请求时调用；Host 已过宿主围栏校验，可信。 */
+export function noteOrigin(host) {
+    if (typeof host === 'string' && host.length > 0)
+        origin = `http://${host}`;
+}
+/** 当前服务 origin；尚无任何请求时为 null（此时工具输出不带链接基址）。 */
+export function readerOrigin() {
+    return origin;
+}

package/dist/tools.js

@@ -4,6 +4,7 @@ import { listPapers, listTopics, resolveDataDir, resolvePaper } from "./library.
 import { transcribePaper, readTranscript } from "./transcribe.js";
 import { chunkText, searchChunks, formatHits } from "./search.js";
 import { completeStep, formatStudy, readStudy, recordQuiz, setPlan } from "./study.js";
+import { readerOrigin } from "./origin.js";
 const locateParams = {
     path: { type: 'string', description: 'PDF 绝对路径。与 topic+name 二选一。' },
     topic: { type: 'string', description: '专题名（文献库一级目录）。' },
@@ -42,6 +43,21 @@ export function paperFromSessionId(sessionId) {
         return null;
     }
 }
+/** 某篇论文的阅读器链接基址（拼 &page=N 即跳转链接）；origin 未捕获到时为 null。 */
+function readerUrl(ref) {
+    const o = readerOrigin();
+    if (!o)
+        return null;
+    return `${o}/paper-reader/?topic=${encodeURIComponent(ref.topic)}&name=${encodeURIComponent(ref.name)}`;
+}
+/** 输出 schema 里的 readerUrl 字段声明（nullable：没有任何浏览器请求过时尚未捕获 origin）。 */
+const readerUrlSchema = {
+    oneOf: [{ type: 'string' }, { type: 'null' }],
+    required: true,
+    description: '阅读器链接基址。引用页码时在末尾拼 &page=N 生成跳转链接；要定位到具体段落再拼 &q=<该段落原文短引文，3~8个词，URL编码>，点击会高亮对应片段。为 null 时本次不带链接。',
+};
+/** render 文本尾部统一带出的链接基址行（preset 规定了用法，这里只暴露值）。 */
+const readerUrlLine = (url) => (url ? `\n阅读器链接基址：${url}` : '');
 export function registerTools(ctx, config) {
     const dataDir = resolveDataDir(config.dataDir);
     ctx.tools.register(defineTool({
@@ -102,6 +118,7 @@ export function registerTools(ctx, config) {
                     pageCount: { type: 'integer', required: true },
                     hasPageIndex: { type: 'boolean', required: true, description: '是否有页码索引（检索结果能否带页码）。' },
                     source: { type: 'string', required: true, enum: ['cache', 'local'] },
+                    readerUrl: readerUrlSchema,
                 },
                 additionalProperties: false,
             },
@@ -110,7 +127,8 @@ export function registerTools(ctx, config) {
                     type: 'text',
                     text: `已转录《${value.paper}》：${value.chars} 字符，${value.pageCount} 页` +
                         `（${value.source === 'cache' ? '缓存复用' : '本地提取'}${value.hasPageIndex ? '，含页码索引' : '，无页码索引'}）。` +
-                        `接下来可用 search_paper 检索具体内容。`,
+                        `接下来可用 search_paper 检索具体内容。` +
+                        readerUrlLine(value.readerUrl),
                 },
             ],
         },
@@ -124,6 +142,7 @@ export function registerTools(ctx, config) {
                 pageCount: t.pageCount,
                 hasPageIndex: t.pages.length > 0,
                 source: t.source,
+                readerUrl: readerUrl(ref),
             };
         },
     }));
@@ -162,6 +181,7 @@ export function registerTools(ctx, config) {
                             additionalProperties: false,
                         },
                     },
+                    readerUrl: readerUrlSchema,
                 },
                 additionalProperties: false,
             },
@@ -172,7 +192,7 @@ export function registerTools(ctx, config) {
                         chunk: { index: h.chunk, start: 0, end: 0, text: h.text },
                         score: 0,
                         page: h.page,
-                    })), value.totalChunks, value.query),
+                    })), value.totalChunks, value.query) + readerUrlLine(value.readerUrl),
                 },
             ],
         },
@@ -193,6 +213,7 @@ export function registerTools(ctx, config) {
                 query: args.query,
                 totalChunks: chunks.length,
                 hits: hits.map((h) => ({ chunk: h.chunk.index, page: h.page, text: h.chunk.text })),
+                readerUrl: readerUrl(ref),
             };
         },
     }));
@@ -235,13 +256,14 @@ export function registerTools(ctx, config) {
                             additionalProperties: false,
                         },
                     },
+                    readerUrl: readerUrlSchema,
                 },
                 additionalProperties: false,
             },
             render: (_args, value) => [
                 {
                     type: 'text',
-                    text: `《${value.paper}》学习档案：\n` + formatStudy(value.hasRecord ? { paper: value.paper, plan: value.plan, quizzes: value.quizzes } : null),
+                    text: `《${value.paper}》学习档案：\n` + formatStudy(value.hasRecord ? { paper: value.paper, plan: value.plan, quizzes: value.quizzes } : null) + readerUrlLine(value.readerUrl),
                 },
             ],
         },
@@ -253,6 +275,7 @@ export function registerTools(ctx, config) {
                 hasRecord: record !== null,
                 plan: record?.plan ?? [],
                 quizzes: record?.quizzes ?? [],
+                readerUrl: readerUrl(ref),
             };
         },
     }));

package/dist/translate-config.js

@@ -93,7 +93,9 @@ export async function testTranslateEndpoint(ep) {
         if (r.ok) {
             // 智谱系网关切错路径时（如 /api/v1）会回 HTTP 200 + {"code":1001,"success":false}，
             // 只看状态码会误判成功，babeldoc 跑起来才炸。真成功必须有 choices。
-            const text = (await r.text().catch(() => '')).slice(0, 300);
+            // 上限放宽到 4000：GLM 等响应字段多，max_tokens:1 也有几百字节；
+            // 历史上 slice(0,300) 把合法 JSON 截断导致 parse 失败、误报「不是补全结果」（0.6.2 修复）
+            const text = (await r.text().catch(() => '')).slice(0, 4000);
             try {
                 const data = JSON.parse(text);
                 if (Array.isArray(data.choices))

package/lib/client.js

@@ -54,6 +54,29 @@ window.__ModuleLoader__.load({
       window.dispatchEvent(new CustomEvent('dpr:paper', { detail: { topic, name, n } }))
     }
 
+    /* ---------- 会话消息里的阅读器跳转链接 ----------
+       agent 引用页码时给 [文字](http://<host>/paper-reader/?topic=..&name=..&page=N)
+       （dsh 渲染器对 http(s) 链接加 target=_blank，capture 拦截是应用内跳转的唯一窗口）。
+       同论文 → 阅读器 iframe 原地跳页：不重载文档，用户正在看中文版就落在中文版该页；
+       跨论文/iframe 未就绪 → setCurrentPaper 换论文，页码经 pendingJumpPage 挂上 src，
+       阅读器 bootstrap 直达目标页。 */
+    let readerIframeEl = null
+    let pendingJump = null // { page, q }：跨论文/iframe 未就绪时挂上 src，由阅读器 bootstrap 消费
+    function jumpToPaperPage(topic, name, page, q) {
+      // 阅读器页签若关着尽量展开（seat 未绑定时静默失败，跳转本身仍生效）
+      try { clientApi?.sidebarRight?.openTab('dpr-reader', { revealIfOpened: true }) } catch {}
+      const cur = JSON.parse(localStorage.getItem('dpr.last') || 'null')
+      const tp = topic || cur?.topic, nm = name || cur?.name
+      if (!tp || !nm) return
+      const win = readerIframeEl?.contentWindow
+      if (cur && tp === cur.topic && nm === cur.name && win?.dpr?.jumpPage) {
+        win.dpr.jumpPage(page, q || undefined)
+        return
+      }
+      pendingJump = { page, q }
+      setCurrentPaper(tp, nm, cur && tp === cur.topic && nm === cur.name ? cur.n : 0)
+    }
+
     async function api(path, opts) {
       const r = await fetch('/paper-reader/api' + path, opts)
       if (!r.ok) {
@@ -116,7 +139,12 @@ window.__ModuleLoader__.load({
       const [geo, setGeo] = useState({ visible: false, left: 0, top: 0, width: 0, height: 0 })
       const lastShownRef = React.useRef(0)
       useEffect(() => {
-        const on = (e) => setCur({ topic: e.detail.topic, name: e.detail.name })
+        const on = (e) => {
+          // 跳转链接挂的页码/引文（jumpToPaperPage 的跨论文路径）：随 src 传给阅读器 bootstrap
+          const j = pendingJump
+          pendingJump = null
+          setCur({ topic: e.detail.topic, name: e.detail.name, page: j?.page, q: j?.q })
+        }
         window.addEventListener('dpr:paper', on)
         return () => window.removeEventListener('dpr:paper', on)
       }, [])
@@ -185,9 +213,10 @@ window.__ModuleLoader__.load({
         return () => { alive = false; clearInterval(timer) }
       }, [])
       if (!cur) return null
-      const src = `/paper-reader/?topic=${encodeURIComponent(cur.topic)}&name=${encodeURIComponent(cur.name)}`
+      const src = `/paper-reader/?topic=${encodeURIComponent(cur.topic)}&name=${encodeURIComponent(cur.name)}${cur.page ? '&page=' + cur.page : ''}${cur.q ? '&q=' + encodeURIComponent(cur.q) : ''}`
       return createPortal(
         h('iframe', {
+          ref: (el) => { readerIframeEl = el },
           src, title: t('pdfTab'),
           'data-dsh-plugin': 'dsh-paper-reader', 'data-dsh-surface': 'reader-overlay',
           style: {
@@ -752,6 +781,23 @@ window.__ModuleLoader__.load({
 
           clientApi = { slots: ctx.slots, layout: ctx.layout, uiWorkspace: ctx.uiWorkspace, sidebarRight: ctx.sidebarRight }
 
+          // 阅读器跳转链接拦截（capture 阶段，一次绑定）：渲染器给 http(s) 链接加了
+          // target=_blank，不拦会新开浏览器标签页 —— 拦下后交给应用内跳转
+          if (!window.__dprJumpLinkBound) {
+            window.__dprJumpLinkBound = true
+            document.addEventListener('click', (e) => {
+              const a = e.target?.closest?.('a[href*="/paper-reader/"]')
+              if (!a) return
+              let url
+              try { url = new URL(a.href) } catch { return }
+              const page = +(url.searchParams.get('page') || 0)
+              if (!page) return
+              e.preventDefault()
+              e.stopImmediatePropagation()
+              jumpToPaperPage(url.searchParams.get('topic'), url.searchParams.get('name'), page, url.searchParams.get('q') || '')
+            }, true)
+          }
+
           // 常驻浮层（与模式开关无关）：阅读器 iframe + 对话头部历史/新建按钮组。
           // shell.overlay 是官方钦定的整页浮层自留地（list slot，additive，不遮蔽任何人）。
           // （对话头部按钮不走 slot —— session 作用域 slot 不渲染动态包条目，只能自渲染。）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggboy123/dsh-paper-reader",
-  "version": "0.4.0",
+  "version": "0.6.2",
   "description": "DeepSeek Harness 插件：论文伴读工作台 — PDF 转录 / 检索 / 原生对话伴读 + 内置阅读器页面。",
   "license": "MIT",
   "type": "module",

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

@@ -23,19 +23,24 @@
       - 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).
 
+      Tool results carry a `阅读器链接基址` (readerUrl) line. EVERY page reference in your replies MUST be a clickable markdown link built from it: [链接文字](<readerUrl 原样照搬>&page=N) — e.g. [第 4 页](…&page=4). Clicking it jumps the student's built-in reader straight to that page, in whichever language version (原文/中英对照/纯中文) they are currently viewing — so never add any language/variant parameter yourself.
+
+      When pointing at a specific passage (a re-read assignment, the evidence for an answer), ALSO append a quote parameter so the reader highlights the exact passage: &q=<a verbatim 3~8 word phrase lifted from that passage, URL-encoded, e.g. &q=inexpensive%20commodity%20hardware>. Rules for q: copy it character-for-character from the search_paper/transcript text (never paraphrase), prefer a phrase at the START of the passage, no line breaks inside it, always percent-encode spaces (%20) and other non-ASCII characters. If you're unsure of the exact wording, omit q rather than guess — a wrong q silently degrades to a plain page jump. Bare "（第 N 页）" text citations are a formatting failure; always link. If the latest tool result has no readerUrl (null), fall back to plain text page numbers.
+
       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.
+      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 links like [第 4 页](…&page=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 examiner-coach:
       - Always start by calling study_progress to see where the student is.
       - No plan yet: skim the paper yourself (transcribe/search the abstract, introduction, section headings), then design a 3~6 step plan with set_plan. The FIRST step is always an independent full read (独立通读) verified by 2~4 simple check questions; the remaining steps are theme-by-theme 精读, each verified by questions. After saving the plan, present ONLY the step-1 assignment: which pages to read and the check questions. Do NOT preview the paper — no abstract recap, no "this paper is about...". The questions themselves are the orientation.
-      - Step 1 (独立通读): pose 2~4 simple questions (e.g. 这篇论文要解决什么问题？方法用一句话怎么概括？最关键的实验结果/结论是什么？), point at the pages that matter if the paper is long, then STOP and wait. The student reads on their own and comes back with answers in their own words. Grade each answer specifically — what's right, what's vague, what's wrong, with page refs （第 N 页）. If an answer is hollow, ask ONE sharper follow-up on the same point before deciding. complete_step (with a short feedback note) only when the answers demonstrate real grasp.
-      - 精读 steps (question-driven): for each step, FIRST give the question(s) and the exact pages to read, then let the student go read and answer. Questions must force engagement: "为什么这里用 X 而不是 Y？", "第 N 页的图/公式说明了什么？", "去掉这个设计会怎样？" — never "请总结第 N 节". When an answer reveals a gap, use a hint ladder: ask a smaller sub-question or point to the exact page/paragraph and let them retry. Explain directly ONLY after a genuine failed attempt — and then explain just that point, not the whole section.
+      - Step 1 (独立通读): pose 2~4 simple questions (e.g. 这篇论文要解决什么问题？方法用一句话怎么概括？最关键的实验结果/结论是什么？), point at the pages that matter if the paper is long, then STOP and wait. The student reads on their own and comes back with answers in their own words. Grade each answer specifically — what's right, what's vague, what's wrong, with page links. If an answer is hollow, ask ONE sharper follow-up on the same point before deciding. complete_step (with a short feedback note) only when the answers demonstrate real grasp.
+      - 精读 steps (question-driven): for each step, FIRST give the question(s) and the exact pages to read (as links), then let the student go read and answer. Questions must force engagement: "为什么这里用 X 而不是 Y？", "第 N 页的图/公式说明了什么？", "去掉这个设计会怎样？" — never "请总结第 N 节".
+      - 严格师傅原则（答案不如意时的固定动作）: when an answer is vague, wrong, or smells pasted, your FIRST move is NOT to explain and NOT merely to follow up verbally — send the student back to the source: name the exact section and give a re-read link with q so the passage highlights on click ([重读 3.2 节（第 5 页）](…&page=5&q=…)), tell them what specific thing to look for, and have them re-answer the same question afterwards. Escalate up the hint ladder only across re-attempts: re-read assignment → a smaller sub-question → pointing at the exact paragraph. Explain directly ONLY after a genuine failed re-attempt — and then explain just that point, not the whole section.
       - complete_step is earned by demonstrated understanding (a correct answer in the student's own words), never by "我看完了". Feedback without the complete_step call in the same turn is a bookkeeping failure; if you skipped earlier bookkeeping, read study_progress and bring it up to date first.
-      - After the plan is done, or when the student asks to be tested: run a quiz — 3~5 questions grounded in the paper (mix recall, "why is it designed this way", and "apply it to a new case"); 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).
+      - After the plan is done, or when the student asks to be tested: run a quiz — 3~5 questions grounded in the paper (mix recall, "why is it designed this way", and "apply it to a new case"); 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 — each weak point gets a re-read link to the exact page.
       - Be warm but demanding. Praise genuine understanding; never wave through a wrong answer. If an answer smells pasted from the abstract or another AI, ask them to close the paper and re-answer from memory in their own words. 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.

package/reader/index.html

@@ -42,9 +42,33 @@
   #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 CSS 必须是 pdf.js 6.x 官方规则的子集：TextLayer 只往 span 写 --font-height/--scale-x/--rotate
+     变量，font-size 和 transform 全靠这里的 calc 表达式撑开；缺了的话 span 会按 body 字号渲染，
+     盒子与 canvas 字形错位 —— 表现为选中高亮缺字符。--scale-factor 由 JS 在渲染时写入 */
+  .textLayer {
+    position: absolute; inset: 0; overflow: clip; line-height: 1; text-align: initial;
+    letter-spacing: normal; word-spacing: normal; text-size-adjust: none;
+    forced-color-adjust: none; transform-origin: 0 0; caret-color: CanvasText; z-index: 0;
+    --total-scale-factor: calc(var(--scale-factor, 1) * var(--user-unit, 1));
+    --text-scale-factor: calc(var(--total-scale-factor) * var(--min-font-size, 1));
+    --min-font-size-inv: calc(1 / var(--min-font-size, 1));
+    --scale-round-x: 1px; --scale-round-y: 1px;
+  }
+  .textLayer :is(span, br) { color: transparent; position: absolute; white-space: pre; cursor: text; transform-origin: 0 0; user-select: text; }
+  .textLayer > :not(.markedContent),
+  .textLayer .markedContent span:not(.markedContent) {
+    z-index: 1;
+    --font-height: 0;
+    font-size: calc(var(--text-scale-factor) * var(--font-height));
+    --scale-x: 1; --rotate: 0deg;
+    transform: rotate(var(--rotate)) scaleX(var(--scale-x)) scale(var(--min-font-size-inv));
+  }
+  .textLayer .markedContent { display: contents; }
   .textLayer ::selection { background: rgba(22,93,255,.3); }
+  .textLayer br::selection { background: transparent; }
+  /* 跳转链接的片段高亮（&q= 引文定位）：常驻不淡出，用户在阅读器里任意点一下即消
+     （同代码编辑器的选中高亮语义：消失由用户触发，不由计时器触发） */
+  .textLayer span.dpr-hl { background: rgba(255,196,0,.45); border-radius: 2px; }
   #empty { margin: 60px auto; color: var(--text-2); text-align: center; max-width: 420px; }
 
   /* ---------- 选中即问浮层 ---------- */
@@ -149,6 +173,9 @@ function esc(s) { return s.replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;
 let current = null;        // { topic, name }
 let zhState = { zh: false, dual: false, busy: false };
 let zhVariant = null;      // null=原文 'dual'=中英对照 'zh'=纯中文
+// 每篇论文记住上次用的语言版本：伴读会话的跳转链接原地跳页不重载，
+// 加上这里的恢复，「中文界面跳中文」在同篇跳转/重开/跨论文三条路径上都成立
+const variantKey = (topic, name) => `dpr.variant.${topic}/${name}`;
 
 /* ================= 打开文献 ================= */
 function pdfUrl(variant) {
@@ -160,8 +187,6 @@ 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);
@@ -169,8 +194,13 @@ async function openPaper(topic, name, opts = {}) {
     ? `${name} · ${meta.pageCount ?? '?'} 页`
     : `${name} · 未转录（提问时会自动转录）`;
   await refreshZhState();
-  await loadPdf(pdfUrl(null));
-  if (opts.page) jumpToPage(opts.page);
+  // 恢复该论文上次的语言版本（译文已不存在时回落原文）
+  const saved = localStorage.getItem(variantKey(topic, name));
+  zhVariant = (saved === 'zh' && zhState.zh) || (saved === 'dual' && zhState.dual) ? saved : null;
+  $('zh-toggle').classList.toggle('active', zhVariant !== null);
+  if (zhVariant) { fitMode = true; fitBtn.classList.add('active'); } // 译文版页宽不同，强制适宽
+  await loadPdf(pdfUrl(zhVariant));
+  if (opts.page) jumpTo(opts.page, opts.q); // 不 await：跳转内部自带「等页面渲出来」轮询
 }
 
 /* ================= 中英切换 ================= */
@@ -197,6 +227,7 @@ $('zh-toggle').onclick = async () => {
   if (zhState.dual || zhState.zh) {
     // 两态切换：原文 ↔ 纯中文；只存在对照版时退到对照
     zhVariant = zhVariant === null ? (zhState.zh ? 'zh' : 'dual') : null;
+    localStorage.setItem(variantKey(current.topic, current.name), zhVariant ?? '');
     $('zh-toggle').classList.toggle('active', zhVariant !== null);
     // 切换变体后强制适宽：译文版页宽与原文不同（对照双栏≈2×），不重算会溢出裁切
     fitMode = true; fitBtn.classList.add('active');
@@ -458,6 +489,55 @@ function jumpToPage(n) {
   setTimeout(() => div.classList.remove('flash'), 1600);
 }
 
+/* 片段定位高亮（跳转链接的 &q= 引文）：在指定页 textLayer 里找 q、高亮并滚到它。
+   归一化时忽略空白/连字符/软连字符、大小写 —— 论文跨行断词（dis-tributed）也能命中。
+   找不到（如用户在中文界面而 q 是英文原文）返回 false，调用方退回仅跳页。 */
+function clearHighlights() {
+  document.querySelectorAll('.textLayer span.dpr-hl').forEach((sp) => sp.classList.remove('dpr-hl'));
+}
+// 高亮的消失交给用户：阅读器里任意点一下即清（mousedown 比 click 早，划选文字的那一下也算）
+document.addEventListener('mousedown', clearHighlights);
+
+function highlightSnippet(page, q) {
+  const spans = [...(document.querySelector(`.page[data-page="${page}"]`)?.querySelectorAll('.textLayer span:not(.markedContent)') ?? [])];
+  if (!spans.length || !q) return false;
+  let hay = '';
+  const startOf = [];
+  for (const sp of spans) { startOf.push(hay.length); hay += sp.textContent; }
+  // 归一化串 + 回原串的索引映射（归一化改变长度，不能直接用原索引）
+  const map = [];
+  let nh = '';
+  for (let i = 0; i < hay.length; i++) {
+    const c = hay[i].toLowerCase();
+    if (/\s/.test(c) || c === '-' || c === '­') continue;
+    nh += c; map.push(i);
+  }
+  const needle = q.toLowerCase().replace(/[\s\-­]+/g, '');
+  const at = needle ? nh.indexOf(needle) : -1;
+  if (at < 0) return false;
+  const from = map[at], to = map[at + needle.length - 1] + 1;
+  const hit = spans.filter((sp, i) => startOf[i] < to && startOf[i] + sp.textContent.length > from);
+  if (!hit.length) return false;
+  clearHighlights();
+  for (const sp of hit) sp.classList.add('dpr-hl');
+  hit[0].scrollIntoView({ behavior: 'smooth', block: 'center' });
+  return true;
+}
+
+/* 统一跳转入口：先等目标页渲染出来（fit 模式下 loadPdf 返回时页面可能还在渲），
+   有 q 就尝试片段高亮，否则整页跳转 + 边框闪烁 */
+async function jumpTo(page, q) {
+  const p0 = Math.max(1, (page | 0) || 1);
+  for (let i = 0; i < 100; i++) {
+    if (pdfDoc && document.querySelector(`.page[data-page="${Math.min(p0, pdfDoc.numPages)}"]`)) {
+      const p = Math.min(p0, pdfDoc.numPages);
+      if (!(q && highlightSnippet(p, q))) jumpToPage(p);
+      return;
+    }
+    await new Promise((r) => setTimeout(r, 100));
+  }
+}
+
 /* ================= 选中即问 ================= */
 const askPop = $('ask-pop');
 let askSelection = null;
@@ -510,6 +590,9 @@ $('ask-input').addEventListener('keydown', (e) => { if (e.key === 'Enter' && !e.
 async function bootstrap() {
   const params = new URLSearchParams(location.search);
   const pTopic = params.get('topic'), pName = params.get('name');
+  // 伴读会话里的跳转链接（[重读第 N 页](…?page=N)）经此直达目标页
+  const pPage = +(params.get('page') || 0) || undefined;
+  const pQ = params.get('q') || undefined;
   const lib = await api('/library');
   if (lib.topics.length === 0) {
     $('empty').style.display = 'block';
@@ -523,14 +606,20 @@ async function bootstrap() {
     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);
+  if (target) await openPaper(target.topic, target.name, { page: pPage, q: pQ });
 }
 bootstrap().catch((e) => {
   $('empty').style.display = 'block';
   $('empty').textContent = '文献库加载失败：' + e.message;
 });
 
-window.dpr = { openPaper: (topic, name, page) => openPaper(topic, name, { page }), jumpToPage };
+window.dpr = {
+  openPaper: (topic, name, page, q) => openPaper(topic, name, { page, q }),
+  jumpToPage,
+  // 伴读会话的跳转链接用：当前文档里原地跳转，不重载 —— 用户正在看中文版就落在中文版；
+  // 带 q（原文短引文）时定位并闪烁高亮对应片段，找不到则退回整页跳转
+  jumpPage: (n, q) => { jumpTo(n, q); },
+};
 </script>
 </body>
 </html>