@ggboy123/dsh-paper-reader 1.4.1 → 1.5.0

package/lib/client.js

@@ -39,6 +39,22 @@ function clearFailureText(err, t) {
   }
 }
 
+/**
+ * 分屏「同步滚动」偏好 —— **纯函数**（文件顶层：Node 里执行本文件即可取用，测试 harness 追加导出）。
+ * 与 `reader/index.html` 里的同键读写必须保持同一套编码，所以两边都只认 `'1'` / `'0'`。
+ *
+ * 键为什么长这样（`dpr.syncScroll`：无 topic/name、也不带 `dpr.variant.` 前缀）：
+ *   ① 用户明确要求**全局**（所有论文共用一个值，不按篇记）；
+ *   ② `migrateLsKeys`（改名搬家）只搬 `dpr.variant.` / `dpr.sessionN.` 两个前缀 ⇒ 这个键既不会被搬
+ *      也不会被删，论文/专题改名**不可能**让偏好丢失（全局键本来就没有「跟着某篇走」的身份）。
+ *      反例：若塞进 `dpr.variant.<topic>/<name>`（按篇），改名搬家会搬它，而「全局」语义就破了。
+ *   ③ 缺省 = 开：与改造前「分屏两列被 rAF 强行同步」的既有行为一致（老用户升级后观感不变）。
+ */
+const DPR_SYNC_SCROLL_KEY = 'dpr.syncScroll'
+/** 只认显式的 '0' 为关；缺失 / 脏值 / 隐私模式都算开（与 reader 的 readSyncPref 逐字同义）。 */
+function dprSyncScrollFromRaw(raw) { return raw !== '0' }
+function dprSyncScrollRaw(on) { return on ? '1' : '0' }
+
 window.__ModuleLoader__.load({
   // 必须等于 npm 包名：浏览器端 loader 按包名期待注册（改名时漏改这里 →
   // "loaded without registering" 整页插件加载失败，实测）
@@ -86,6 +102,13 @@ window.__ModuleLoader__.load({
       setMineruWhyLocal: '本地模式需要你自己跑一个 MinerU 服务（127.0.0.1:8000），适合有显卡、论文不外传的场景。',
       setMineruWhyCloud: '云端模式只要一个 mineru.net token，无需本地显卡；论文会上传到 mineru.net 解析。',
       setMineruOffHint: '当前为「关闭」：转录走本地 pdf.js——有文本层的普通 PDF 完全够用；扫描版（没有文本层）与公式引用才需要 MinerU（选本地或云端）。',
+      // 分屏「同步滚动」（模式 B 的全局偏好）：与阅读器分屏控件旁的那个开关是**同一个值**
+      // （键 dpr.syncScroll，见文件顶层的纯函数），任一处改动另一处立即跟着变。
+      setSyncScrollTitle: '分屏同步滚动',
+      setSyncScrollDesc: '阅读器里「分屏」对照（模式 B：原文 PDF ↔ 中文版 PDF 两列）时，两列是否一起滚动。关闭后两列各自独立滚动（适合对照着看不同页）；重新打开会自动把两列对齐回当前页，不会停在两页上。全局偏好：所有论文共用一个值，不按篇记；默认开。模式 A（babeldoc 的中英对照 PDF）只有一个滚动条，不受此项影响。',
+      setSyncScrollLabel: '分屏两列同步滚动',
+      setSyncScrollOnHint: '当前：开 —— 两列一起滚动（默认）',
+      setSyncScrollOffHint: '当前：关 —— 两列各自独立滚动；再打开时会自动对齐回当前页',
       // 文献管理（删除/重命名）：契约见 docs/reader-ux-requirements.md §2.9。
       // 去重说明：rename/renameTopic/renamePaper/renameFail/delFail 只保留上面上游那组
       // （JS 对象字面量重复 key 不报错、后者静默胜出 → 必须手工去重，否则文案悄悄取自另一份）。
@@ -158,6 +181,11 @@ window.__ModuleLoader__.load({
       setMineruWhyLocal: 'Local mode expects your own MinerU service (127.0.0.1:8000) — for GPUs and papers that should stay on your machine.',
       setMineruWhyCloud: 'Cloud mode needs only a mineru.net token and no local GPU; the paper is uploaded to mineru.net for parsing.',
       setMineruOffHint: 'Currently Off: transcription uses local pdf.js — fine for PDFs that already have a text layer; scanned PDFs (no text layer) and formula citing need MinerU (local or cloud).',
+      setSyncScrollTitle: 'Split-view sync scrolling',
+      setSyncScrollDesc: 'In the reader split view (mode B: the original PDF next to the translated -zh.pdf) — should the two columns scroll together? Off: each column scrolls independently (handy to compare different pages); turning it back on realigns both columns to the current page instead of leaving them on different pages. Global preference: one value for every paper, never per paper; on by default. Mode A (babeldoc dual PDF) has a single scrollbar and is unaffected.',
+      setSyncScrollLabel: 'Scroll the two split columns together',
+      setSyncScrollOnHint: 'Currently: on — the two columns scroll together (default)',
+      setSyncScrollOffHint: 'Currently: off — the two columns scroll independently; turning it on realigns them to the current page',
       newName: 'New name', renameDone: 'Renamed',
       renameDetached: 'Note: {n} past chats are kept but no longer listed',
       renameTargetExists: 'A paper or topic with that name already exists',
@@ -1418,6 +1446,47 @@ window.__ModuleLoader__.load({
       )
     }
 
+    /* ---------- 分屏同步滚动卡片（模式 B 的**全局**偏好）----------
+       本卡片与阅读器是**两个文档**（阅读器是同源 iframe ~ /paper-reader/），共享同一个 localStorage：
+         · 这里勾/取消 → 写 `dpr.syncScroll` → 阅读器收到 storage 事件 → 开关与滚动行为立即跟着变
+           （打开时还会自动把两列对齐回当前页）；
+         · 反之在阅读器「分屏」控件旁点开关 → 这里收到 storage 事件 → 勾选态立即跟着变。
+       ⇒ 两处入口互相同步，且都是**同一个键**（键名与 '1'/'0' 编码由文件顶层的纯函数定义，
+          与 reader/index.html 逐字一致）。默认开 = 缺省值（与改造前行为一致）。 */
+    function SyncScrollCard() {
+      const readPref = () => { try { return dprSyncScrollFromRaw(localStorage.getItem(DPR_SYNC_SCROLL_KEY)) } catch { return true } }
+      const [on, setOn] = useState(readPref)
+      useEffect(() => {
+        const onStorage = (e) => {
+          if (!e || e.key !== DPR_SYNC_SCROLL_KEY) return
+          setOn(dprSyncScrollFromRaw(e.newValue))   // 另一处（阅读器/另一个窗口）改了 → 立即反映
+        }
+        window.addEventListener('storage', onStorage)
+        return () => window.removeEventListener('storage', onStorage)
+      }, [])
+      const apply = (v) => {
+        setOn(v)
+        try { localStorage.setItem(DPR_SYNC_SCROLL_KEY, dprSyncScrollRaw(v)) } catch { /* 隐私模式写不了：阅读器里仍可单独改 */ }
+      }
+      return h('div', { style: SET.card, 'data-dsh-plugin': 'dsh-paper-reader', 'data-dsh-part': 'settings-card' },
+        h('h3', { style: SET.title }, t('setSyncScrollTitle')),
+        h('p', { style: SET.desc }, t('setSyncScrollDesc')),
+        h('div', { style: SET.row },
+          h('label', { style: { ...SET.label, display: 'flex', alignItems: 'center', gap: '8px', margin: '0' }, 'data-dpr-sync-label': '' },
+            h('input', {
+              type: 'checkbox', checked: on, 'data-dpr-sync-input': '',
+              // 与面板主题色对齐（原生 checkbox 的默认蓝与每套主题都对不上）：accent-color 是标准
+              // 属性，不支持的旧壳只是回落成默认色，不影响可用性
+              style: { width: '16px', height: '16px', cursor: 'pointer', accentColor: 'var(--dsw-alias-button-primary-fill, #1f6feb)' },
+              onChange: (e) => apply(!!e.target.checked),
+            }),
+            t('setSyncScrollLabel'),
+          ),
+          h('span', { style: SET.meta, 'data-dpr-sync-state': '' }, on ? t('setSyncScrollOnHint') : t('setSyncScrollOffHint')),
+        ),
+      )
+    }
+
     function SettingsPanel() {
       return h('div', { style: { maxWidth: '560px' }, 'data-dsh-plugin': 'dsh-paper-reader', 'data-dsh-surface': 'settings-modal' },
         h(EndpointCard, {
@@ -1433,6 +1502,7 @@ window.__ModuleLoader__.load({
           baseUrlPlaceholder: 'https://api.deepseek.com/v1', modelPlaceholder: 'deepseek-chat', keyPlaceholder: 'sk-...',
         }),
         h(MineruCard, null),
+        h(SyncScrollCard, null),
       )
     }
 

package/package.json

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