@ggboy123/dsh-paper-reader 1.3.0 → 1.3.2

package/README.md

@@ -42,7 +42,7 @@
 **DeepSeek 官方桌面端**（[deepseek.com/download](https://www.deepseek.com/download/) 下载，即 DeepSeek Harness 桌面版）：
 
 1. 安装并启动，登录 DeepSeek 账号
-2. 侧栏 → **插件** → **添加插件**，输入 `@ggboy123/dsh-paper-reader@1.3.0` 安装
+2. 侧栏 → **插件** → **添加插件**，输入 `@ggboy123/dsh-paper-reader@1.3.2` 安装
 3. 装完默认**停用**：点进插件详情，打开「启用」开关
 4. **重启桌面端**（热启用状态下打开论文的链路会静默失效，重启进开机组合才正常，实测）
 
@@ -69,7 +69,7 @@ dsh plugin --profile web add @ggboy123/dsh-paper-reader
 **已装过的用户升级必须带显式版本号**——不带版本的 `add` 对已存在的依赖是 no-op（pnpm 按首次安装时记录的版本范围解析，不会追新）：
 
 ```bash
-dsh plugin --profile web add @ggboy123/dsh-paper-reader@1.3.0
+dsh plugin --profile web add @ggboy123/dsh-paper-reader@1.3.2
 # 重启 dsh web 生效；浏览器 Cmd+Shift+R 强刷，避免旧阅读器页面缓存
 ```
 

package/dist/host.js

@@ -1,6 +1,6 @@
 // host.ts — webServer 路由：阅读器页面 + PDF 文件 + 转录数据接口 + 选中即问。
 // 壳层代码：只做 HTTP ↔ 纯函数核心(library/transcribe)的转接。
-import { createReadStream } from 'node:fs';
+import { createReadStream, readFileSync } from 'node:fs';
 import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
 import { randomUUID } from 'node:crypto';
 import { basename, join } from 'node:path';
@@ -44,6 +44,8 @@ export function registerRoutes(ctx, config) {
     // dist/host.js → 包根/reader/index.html
     const readerHtml = new URL('../reader/index.html', import.meta.url);
     const readerVendorDir = new URL('../reader/vendor/', import.meta.url);
+    // 插件版本（读包根 package.json，注入阅读器顶栏——用户截图反馈时一眼可见）
+    const pluginVersion = 'v' + JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
     // 自带「论文伴读」agent preset → $DSH_HOME/.agent-presets/（实时扫描，免重启）；
     // 失败（旧版 dsh/无权限）则回退默认 preset，功能不受影响。
     const presetDir = installPaperPreset(new URL('../', import.meta.url));
@@ -145,8 +147,15 @@ export function registerRoutes(ctx, config) {
     const dispatch = async (req, res, url) => {
         const sub = url.pathname.slice('/paper-reader'.length); // '' | '/' | '/api/...'
         if ((sub === '' || sub === '/') && req.method === 'GET') {
-            const html = await readFile(readerHtml);
-            res.writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'content-length': html.length });
+            // no-cache：桌面端 webview 无法强刷（README 里浏览器 Cmd+Shift+R 的建议对桌面端
+            // 无效），不带缓存头时升级插件后用户会一直看到缓存的旧阅读器页面（实测空白 bug
+            // 「修了还在」正是这个）。版本号注入供用户截图反馈时一眼对版本。
+            const html = (await readFile(readerHtml)).toString('utf8').replaceAll('__DPR_VERSION__', pluginVersion);
+            res.writeHead(200, {
+                'content-type': 'text/html; charset=utf-8',
+                'content-length': Buffer.byteLength(html),
+                'cache-control': 'no-cache',
+            });
             res.end(html);
             return;
         }
@@ -160,7 +169,7 @@ export function registerRoutes(ctx, config) {
             const mime = { '.mjs': 'text/javascript', '.js': 'text/javascript', '.css': 'text/css', '.map': 'application/json' };
             try {
                 const body = await readFile(new URL(name, readerVendorDir));
-                res.writeHead(200, { 'content-type': (mime[name.slice(name.lastIndexOf('.'))] ?? 'application/octet-stream') + '; charset=utf-8', 'content-length': body.length, 'cache-control': 'max-age=3600' });
+                res.writeHead(200, { 'content-type': (mime[name.slice(name.lastIndexOf('.'))] ?? 'application/octet-stream') + '; charset=utf-8', 'content-length': body.length, 'cache-control': 'no-cache' });
                 res.end(body);
             }
             catch {

package/lib/client.js

@@ -268,6 +268,17 @@ window.__ModuleLoader__.load({
           // 阅读器整个右移并变窄（实测 x=800 w=300，而列是 280..1100）。
           // 只补 minWidth，不碰 width：dsh 每次会话提交都重写内联 width，抢同一属性会持续闪烁。
           setStyle(panel, 'minWidth', eff ? '100%' : '')
+          // 全屏态层级修复（用户实测「点全屏放大后一片白」）：dsh 的页签宿主 ._tabCell
+          // z-index 是 var(--dsh-dockkit-dock-layer, 10)，全屏时该变量被抬到 40——但只定义在
+          // 右栏**面板**（P3OORG_panel）子树上，把本阅读器 z-10 的悬浮 iframe 压在下面：
+          // iframe 里页面活着、工具栏都在，却被白色 tab 宿主盖住。⚠️ 变量不从列/帧继承，
+          // body 级 iframe 拿到的是回落值 10——必须从 panel 上现读实际值再 +2：
+          // 盖回 tabCell、仍低于对话头部浮动按钮 45（全屏下拖拽手柄本就隐藏）；
+          // 非全屏回 10（低于手柄 11 与 overlayLayer 20）。
+          if (readerIframeEl) {
+            const dockLayer = parseFloat(getComputedStyle(panel).getPropertyValue('--dsh-dockkit-dock-layer')) || 10
+            setStyle(readerIframeEl, 'zIndex', frame.hasAttribute('data-rightbar-fullscreen') ? String(dockLayer + 2) : '10')
+          }
         }
         const tick = () => {
           if (!alive) return

package/package.json

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

package/reader/index.html

@@ -48,6 +48,8 @@
   #pager { display: flex; align-items: center; gap: 4px; flex: none; }
   #page-input { width: 3.5em; padding: 3px 6px; border: 1px solid var(--border); border-radius: 6px; background: var(--panel); color: var(--text); font: inherit; font-size: 12.5px; text-align: right; }
   #page-total { flex: none; color: var(--text-2); font-size: 12px; white-space: nowrap; }
+  /* 插件版本号（host 注入；未被替换时隐藏——比如旧 host 配新页面的错位场景） */
+  #ver { flex: none; font-size: 10.5px; color: var(--text-2); opacity: .65; user-select: none; }
   .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 CSS 必须是 pdf.js 6.x 官方规则的子集：TextLayer 只往 span 写 --font-height/--scale-x/--rotate
@@ -126,6 +128,7 @@
   <span id="zoom-label">100%</span>
   <button id="zoom-in" class="tbtn">＋</button>
   <button id="zoom-fit" class="tbtn">适宽</button>
+  <span id="ver" title="插件版本">__DPR_VERSION__</span>
 </div>
 
 <div id="main">
@@ -871,7 +874,11 @@ bootstrap().catch((e) => {
   $('empty').textContent = '文献库加载失败：' + e.message;
 });
 
+// 版本号未被 host 注入（旧宿主配新页面的错位场景）时藏掉占位符
+if (!/^v\d/.test(document.getElementById('ver').textContent)) document.getElementById('ver').style.display = 'none';
+
 window.dpr = {
+  version: document.getElementById('ver').textContent,
   openPaper: (topic, name, page, q) => openPaper(topic, name, { page, q }),
   jumpToPage,
   // 伴读会话的跳转链接用：当前文档里原地跳转，不重载 —— 用户正在看中文版就落在中文版；