@ggboy123/dsh-paper-reader 1.1.0 → 1.2.1

package/README.md

@@ -9,6 +9,8 @@
 
 [DeepSeek Harness (dsh)](https://github.com/deepseek-ai/deepseek-harness) 插件：论文伴读工作台 —— PDF 转录 / 检索 + 原生对话伴读 + 内置阅读器。
 
+> **👉 普通用户直接看「安装 → 方式一」**：装 DeepSeek 官方桌面端，添加插件即可，不需要任何开发环境。本仓库面向的是想自己装插件、或想改代码的用户。
+
 功能迁移自本地独立产品 pdfqa（Go 实现的论文伴读工具）。原则：agent 循环 / 模型层 / 会话持久化全部交给 dsh 框架，插件只做「转录 + 检索 + 阅读器 UI」的薄壳组合。
 
 **安装后不改动官方界面** —— 侧栏底部多一行「📚 论文伴读」开关，点击才进入伴读模式（左侧变为文献库树），再点即还原官方工作区列表：
@@ -33,17 +35,23 @@
 
 ## 安装
 
-### 方式一：DSH Desktop（零环境，推荐普通用户）
+### 方式一：官方桌面端装插件（推荐）
+
+**DeepSeek 官方桌面端**（[deepseek.com/download](https://www.deepseek.com/download/) 下载，即 DeepSeek Harness 桌面版）：
+
+1. 安装并启动，登录 DeepSeek 账号
+2. 侧栏 → **插件** → **添加插件**，输入 `@ggboy123/dsh-paper-reader@1.2.1` 安装
+3. 装完默认**停用**：点进插件详情，打开「启用」开关
+4. **重启桌面端**（热启用状态下打开论文的链路会静默失效，重启进开机组合才正常，实测）
 
-[DSH Desktop](https://github.com/anywhere-labs/dsh-desktop) 是社区的 DeepSeek Harness 桌面客户端（macOS / Windows，开箱即用，不需要装 Node.js）：
+完整流程演示（添加插件 → 启用 → 重启 → 打开论文直接提问）：
 
-1. 下载安装 DSH Desktop 并启动
-2. 托盘菜单 → **Open DSH Terminal**（终端里自带 `dsh`/`pnpm`，只对那个终端生效）
-3. 执行 `dsh plugin add @ggboy123/dsh-paper-reader@1.1.0`
-4. 退出并重开 DSH Desktop（插件变更要重启才进 Loader 组合）
+![官方桌面端安装并使用论文伴读插件](https://raw.githubusercontent.com/GGboya/dsh-paper-reader/main/docs/desktop-official-use.gif)
 
-> 已在 DSH Desktop 2.0.13（内置 dsh 0.1.5-rc.2）上实测通过：侧栏文献库、PDF 阅读器、选中即问、页码跳转、原生对话伴读、翻译引擎自动安装（uv + Python + babeldoc 全程落在用户目录）全部可用。
-> 注意：Desktop 的 `desktop` profile 被 Electron 独占管理，外部 CLI 直接 `dsh plugin --profile desktop add` 会被拒（`managed exclusively by the Electron application`）——必须从 Desktop 自己的终端进。
+> 已在官方桌面端 V0.2.0-rc.2（内置 dsh 0.2.0-rc.2，macOS arm64）实测通过：侧栏文献库、新建专题、上传 PDF、PDF 阅读器、原生对话伴读、历史/新建对话按钮全部可用。
+> 需要 ≥1.2.0：更早版本会被 0.2.x 运行时的 peer 兼容校验拒载（插件列表里显示异常）。
+
+> 曾经的 PaperReader 桌面版（基于社区 DSH Desktop 的预装打包）**已不再维护**——统一收敛到官方桌面端 + 插件的形式，老用户请迁移到本方式。
 
 ### 方式二：命令行 dsh（开发者）
 
@@ -59,7 +67,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.1.0
+dsh plugin --profile web add @ggboy123/dsh-paper-reader@1.2.1
 # 重启 dsh web 生效；浏览器 Cmd+Shift+R 强刷，避免旧阅读器页面缓存
 ```
 
@@ -71,7 +79,11 @@ grep '"version"' ~/.dsh/profiles/web/node_modules/@ggboy123/dsh-paper-reader/pac
 
 > pnpm 若开了供应链策略 `minimumReleaseAge`（发布 N 小时内的新包拒装）：要么等过窗口期，要么在 `~/.dsh/profiles/web/.npmrc` 加一行 `minimum-release-age-exclude[]=@ggboy123/dsh-paper-reader`（只豁免本插件，不动全局策略）。
 
-本地开发：
+### 参与开发（本地调试）
+
+欢迎改代码。流程：clone → 构建 → 以本地目录装进 profile，之后改完 `pnpm run build` 重启对应 profile 即可验证：
+
+![参与开发：clone → pnpm install → build → 本地安装](https://raw.githubusercontent.com/GGboya/dsh-paper-reader/main/docs/dev-workflow.gif)
 
 ```bash
 git clone https://github.com/GGboya/dsh-paper-reader
@@ -102,6 +114,21 @@ dsh --profile web                                  # 侧栏变为文献库树
 
 > 伴读模式是**按需开启**的：默认不注册 `sidebar.workspaces`（官方工作区/会话列表原样），侧栏底部「📚 论文伴读」开关点击才接管，再点还原；模式选择记在 localStorage。退出模式时已打开的 PDF 页签和伴读会话不受影响。
 
+### 翻译引擎冒烟测试（Windows 依赖完整性）
+
+Windows 用户最常见的翻车点是翻译引擎装不上（杀软拦 uv、网络截断、venv 残缺）。安装逻辑 `src/babeldoc-install.ts` 是纯 Node 模块（不依赖 Cordis/Electron），配了 GitHub Actions 在**全新干净机器**上跑冒烟，无需本地 Windows：
+
+```bash
+pnpm build
+pnpm smoke:engine clean          # 全新安装全链路
+pnpm smoke:engine managed-uv     # 强制走插件托管 uv 下载（sha256 校验路径）
+pnpm smoke:engine pip-fallback   # 强制走 pip + 国内镜像备用通道
+pnpm smoke:engine repair         # 破坏 venv（删 pymupdf）后验证自检→自动修复
+pnpm smoke:engine translate      # 再起本地 mock OpenAI 端点,真跑一遍 babeldoc 翻译管线
+```
+
+CI（`.github/workflows/engine-smoke.yml`）：`windows-latest` 跑全部四个场景 + translate-e2e，`macos-latest`/`ubuntu-latest` 跑 clean 防回归；改安装/翻译代码的 push 触发，外加每周一定时（uv/PyPI 在变，代码不动也可能突然坏）。两个测试钩子环境变量：`DSH_PR_MANAGED_UV_ONLY=1`（跳过系统 uv 查找）、`DSH_PR_FORCE_PIP_CHANNEL=1`（跳过 uv 装包通道）。
+
 ## 架构
 
 ```

package/dist/babeldoc-install.js

@@ -2,7 +2,10 @@
 //
 // 链路：uv 独立二进制（GitHub Releases，带 sha256 校验）
 //   → `uv venv`（uv 自动下载托管 Python，系统没有 Python 也能跑）
-//   → `uv pip install babeldoc`
+//   → `uv pip install babeldoc`（失败时退到 pip + 国内镜像自举）
+// 使用前后各做一次 `babeldoc --version` 自检：venv 残缺（依赖被杀软/中断搞掉一半，
+// exe 还在但一跑就 ModuleNotFoundError）会被当场抓住并自动走重装修复，而不是让用户
+// 在翻译时对着 import 报错干瞪眼。
 // 全部落在用户目录：uv 二进制在 <dshHome>/.dsh-paper-reader/bin/uv（win32 为 uv.exe），
 // venv 在 文献库同级 .venv-pdf2zh（必须与 translate.ts findBabeldoc 的第一候选位一致），
 // 不碰系统 Python、不需要 sudo。
@@ -62,6 +65,10 @@ async function findUv(home) {
     const own = uvPath(home);
     if (existsSync(own))
         return own;
+    // 测试钩子：CI runner 常在 PATH 预装 uv，会静默绕过 downloadUv；
+    // DSH_PR_MANAGED_UV_ONLY=1 时跳过系统查找，强制走插件托管下载链路（含 sha256 校验）。
+    if (process.env.DSH_PR_MANAGED_UV_ONLY === '1')
+        return null;
     if (await whichOk('uv'))
         return 'uv';
     const candidates = isWin
@@ -73,6 +80,36 @@ async function findUv(home) {
     }
     return null;
 }
+/** GitHub API 请求头：有 GITHUB_TOKEN/GH_TOKEN 就带上——匿名限流 60/h 按出口 IP 算，
+ * CI runner 和企业 NAT 都是共享 IP,极易撞 403;带 token 后按账号 5000/h。 */
+function ghHeaders(accept) {
+    const h = { accept, 'user-agent': 'dsh-paper-reader' };
+    const token = process.env.GITHUB_TOKEN ?? process.env.GH_TOKEN;
+    if (token)
+        h.authorization = `Bearer ${token}`;
+    return h;
+}
+/**
+ * fetch 带重试：用户网络抖一下（尤其国内到 GitHub）就直接失败太脆了。
+ * 只对网络错误和 5xx 重试，4xx 是确定性错误直接抛。
+ */
+async function fetchWithRetry(url, init, tries = 3) {
+    let lastErr = null;
+    for (let i = 0; i < tries; i++) {
+        try {
+            const r = await fetch(url, init);
+            if (r.ok || (r.status >= 400 && r.status < 500))
+                return r;
+            lastErr = new Error(`HTTP ${r.status}`);
+        }
+        catch (e) {
+            lastErr = e;
+        }
+        if (i < tries - 1)
+            await new Promise((r) => setTimeout(r, 2000 * (i + 1)));
+    }
+    throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+}
 /**
  * 下载 uv 独立二进制。全程走 api.github.com（资产接口 + octet-stream 直连），
  * 不依赖 github.com 页面域——后者在部分网络环境不可达，而 API 域通常可达。
@@ -89,8 +126,8 @@ async function downloadUv(home, onPhase) {
     await mkdir(tmp, { recursive: true });
     try {
         onPhase('正在安装翻译引擎（1/3 下载 uv）…');
-        const rel = await fetch('https://api.github.com/repos/astral-sh/uv/releases/latest', {
-            headers: { accept: 'application/vnd.github+json', 'user-agent': 'dsh-paper-reader' },
+        const rel = await fetchWithRetry('https://api.github.com/repos/astral-sh/uv/releases/latest', {
+            headers: ghHeaders('application/vnd.github+json'),
             signal: AbortSignal.timeout(30_000),
         });
         if (!rel.ok)
@@ -101,8 +138,8 @@ async function downloadUv(home, onPhase) {
             throw new Error(`uv 最新版没有 ${want} 资产`);
         const sumAsset = assets.find((a) => a.name === want + '.sha256');
         const download = async (a) => {
-            const r = await fetch(`https://api.github.com/repos/astral-sh/uv/releases/assets/${a.id}`, {
-                headers: { accept: 'application/octet-stream', 'user-agent': 'dsh-paper-reader' },
+            const r = await fetchWithRetry(`https://api.github.com/repos/astral-sh/uv/releases/assets/${a.id}`, {
+                headers: ghHeaders('application/octet-stream'),
                 signal: AbortSignal.timeout(180_000),
             });
             if (!r.ok)
@@ -124,7 +161,10 @@ async function downloadUv(home, onPhase) {
         // 不带 -z：bsdtar（macOS 自带 / Win10 1803+ 的 tar.exe）和 GNU tar 解包时都自动探测格式，
         // 同一条命令通吃 tar.gz 与 zip（win32 的 uv 只发 zip）
         await run('tar', ['-xf', pkgPath, '-C', tmp], { timeout: 60_000 });
-        const extracted = join(tmp, `uv-${triple}`, isWin ? 'uv.exe' : 'uv');
+        // tar.gz 有顶层目录 uv-<triple>/;win32 的 zip 是平铺的(uv.exe 直接在根)
+        const binName = isWin ? 'uv.exe' : 'uv';
+        const nested = join(tmp, `uv-${triple}`, binName);
+        const extracted = existsSync(nested) ? nested : join(tmp, binName);
         if (!existsSync(extracted))
             throw new Error('uv 解包结果不符合预期');
         const dst = uvPath(home);
@@ -137,16 +177,95 @@ async function downloadUv(home, onPhase) {
         await rm(tmp, { recursive: true, force: true });
     }
 }
-/** 建 venv + 装 babeldoc。uv 没有可用 Python 时会自己下载托管版，无需系统 Python。 */
+/** venv 里的 python 路径（win32 在 Scripts/ 且带 .exe）。 */
+function venvPython(venvDir) {
+    return isWin ? join(venvDir, 'Scripts', 'python.exe') : join(venvDir, 'bin', 'python');
+}
+/** venv 里的 babeldoc 可执行文件路径（与 translate.ts findBabeldoc 的第一候选位一致）。 */
+function venvBabeldoc(venvDir) {
+    return isWin ? join(venvDir, 'Scripts', 'babeldoc.exe') : join(venvDir, 'bin', 'babeldoc');
+}
+/**
+ * 自检：跑一次 --version。import 链上缺任何包（configargparse/pymupdf/rich…）都会在这里炸，
+ * 正好覆盖「exe 在、依赖残缺」的坏状态。通过的 bin 记进 Set，后续调用零开销。
+ */
+const verified = new Set();
+function smokeCheck(bin) {
+    if (verified.has(bin))
+        return Promise.resolve();
+    return new Promise((res, rej) => {
+        execFile(bin, ['--version'], { timeout: 60_000 }, (err, stdout, stderr) => {
+            if (err) {
+                const tail = (stdout + '\n' + stderr).trim().slice(-300);
+                rej(new Error(tail || err.message));
+            }
+            else {
+                verified.add(bin);
+                res();
+            }
+        });
+    });
+}
+/**
+ * uv 之外的备用安装通道：venv 自举 pip（ensurepip）→ 国内镜像轮询装 babeldoc。
+ * 触发场景（均在实测中出现过）：
+ * - 杀毒软件锁 uv 临时入口 exe 的 PE 资源更新（UpdateResource 被拒，uv 全线失败）；
+ * - uv 默认 PyPI 源在国内网络下超时/响应截断。pip 写入口 exe 用普通文件写，不踩这两坑。
+ */
+const CN_MIRRORS = [
+    'https://pypi.tuna.tsinghua.edu.cn/simple',
+    'https://mirrors.aliyun.com/pypi/simple/',
+    'https://mirrors.cloud.tencent.com/pypi/simple',
+];
+async function pipInstallBabeldoc(py) {
+    await run(py, ['-m', 'ensurepip', '--upgrade'], { timeout: 5 * 60_000 });
+    let lastErr = null;
+    for (const m of CN_MIRRORS) {
+        try {
+            await run(py, [
+                '-m', 'pip', 'install', '--no-cache-dir', '--timeout', '120', '--retries', '3', '-i', m, 'babeldoc',
+            ], { timeout: 30 * 60_000 });
+            return;
+        }
+        catch (e) {
+            lastErr = e; // 换下一个镜像；已装成功的包 pip 会跳过，重试是断点续传式的
+        }
+    }
+    throw lastErr instanceof Error ? lastErr : new Error(String(lastErr));
+}
+/**
+ * 建 venv + 装 babeldoc（或修复残缺安装）。uv 没有可用 Python 时会自己下载托管版。
+ * venv 已存在时跳过 `uv venv`——它会清空重建，毁掉 pip 修复过的包，直接补依赖即可
+ * （`uv pip install` 对缺失的依赖是幂等补装）。
+ */
 async function installBabeldoc(uv, venvDir, onPhase) {
-    onPhase('正在安装翻译引擎（2/3 安装 Python）…');
-    // --python-preference only-managed：不碰用户系统里可能残缺/带 externally-managed 标记的 Python
-    await run(uv, ['venv', venvDir, '--python', '3.12', '--python-preference', 'only-managed'], { timeout: 10 * 60_000 });
-    // win32 venv 用 Scripts/ 而非 bin/，可执行文件带 .exe
-    const py = isWin ? join(venvDir, 'Scripts', 'python.exe') : join(venvDir, 'bin', 'python');
+    const py = venvPython(venvDir);
+    const bin = venvBabeldoc(venvDir);
+    if (!existsSync(join(venvDir, 'pyvenv.cfg'))) {
+        onPhase('正在安装翻译引擎（2/3 安装 Python）…');
+        // --python-preference only-managed：不碰用户系统里可能残缺/带 externally-managed 标记的 Python
+        await run(uv, ['venv', venvDir, '--python', '3.12', '--python-preference', 'only-managed'], { timeout: 10 * 60_000 });
+    }
     onPhase('正在安装翻译引擎（3/3 安装 babeldoc，首次约几分钟）…');
-    await run(uv, ['pip', 'install', '--python', py, 'babeldoc'], { timeout: 20 * 60_000 });
-    const bin = isWin ? join(venvDir, 'Scripts', 'babeldoc.exe') : join(venvDir, 'bin', 'babeldoc');
+    const viaPipFallback = async (cause) => {
+        onPhase('正在安装翻译引擎（3/3 备用通道：pip + 国内镜像）…');
+        if (cause) {
+            console.warn('[dsh-paper-reader] uv 安装 babeldoc 失败，改用 pip 镜像通道:', cause instanceof Error ? cause.message : cause);
+        }
+        await pipInstallBabeldoc(py);
+    };
+    // 测试钩子：DSH_PR_FORCE_PIP_CHANNEL=1 跳过 uv 通道，让 CI 确定性覆盖 pip 备用路径
+    //（杀软锁 uv 入口 exe、PyPI 截断时的逃生通道，Windows 上最关键的一条路径）
+    if (process.env.DSH_PR_FORCE_PIP_CHANNEL === '1')
+        await viaPipFallback(null);
+    else {
+        try {
+            await run(uv, ['pip', 'install', '--python', py, 'babeldoc'], { timeout: 20 * 60_000 });
+        }
+        catch (uvErr) {
+            await viaPipFallback(uvErr);
+        }
+    }
     if (!existsSync(bin))
         throw new Error('babeldoc 安装完成但未找到可执行文件');
     return bin;
@@ -155,18 +274,29 @@ async function installBabeldoc(uv, venvDir, onPhase) {
 let inflight = null;
 /**
  * 确保 babeldoc 可用，返回可执行文件路径。
- * 已存在（venv/PATH/miniconda）直接返回；否则后台走完 uv → python → babeldoc 全链路。
+ * 已存在（venv/PATH/miniconda）先自检：残缺（exe 在、依赖缺）不直接用，转修复流程。
  * venv 落 dirname(dataDir)/.venv-pdf2zh —— 与 translate.ts findBabeldoc 的第一候选位严格一致。
  */
 export function ensureBabeldoc(dataDir, home, findExisting, onPhase) {
     if (!inflight) {
         inflight = (async () => {
             const existing = await findExisting();
-            if (existing)
-                return existing;
+            if (existing) {
+                try {
+                    await smokeCheck(existing);
+                    return existing;
+                }
+                catch (e) {
+                    console.warn('[dsh-paper-reader] babeldoc 自检未过（残缺安装），进入修复:', e instanceof Error ? e.message : e);
+                    onPhase('检测到翻译引擎组件缺失，正在修复…');
+                }
+            }
             const venvDir = join(dirname(dataDir), '.venv-pdf2zh');
             const uv = (await findUv(home)) ?? (await downloadUv(home, onPhase));
-            return installBabeldoc(uv, venvDir, onPhase);
+            const bin = await installBabeldoc(uv, venvDir, onPhase);
+            // 终检：把真实的缺包报错在安装阶段抛出来，别等到翻译跑一半才炸
+            await smokeCheck(bin);
+            return bin;
         })().finally(() => {
             // 成功后清掉单例让下次走快速路径；失败也清掉让下次可以重试
             inflight = null;

package/lib/client.js

@@ -29,6 +29,8 @@ window.__ModuleLoader__.load({
     const zh = {
       library: '文献库',
       empty: '文献库为空', hint: '新建专题或上传 PDF 开始', newTopic: '新建专题',
+      cancel: '取消', ok: '确定', defaultTopic: '默认专题', uploadBtn: '上传 PDF',
+      newTopicFail: '新建专题失败',
       upload: '上传 PDF 到此专题', newChat: '新建对话', session: '会话', pdfTab: '论文 PDF',
       history: '历史对话',
       sync: '对话还停在另一篇文献的会话里，点击切到当前文献',
@@ -48,6 +50,8 @@ window.__ModuleLoader__.load({
     const en = {
       library: 'Library',
       empty: 'Library is empty', hint: 'Create a topic or upload a PDF to start', newTopic: 'New topic',
+      cancel: 'Cancel', ok: 'OK', defaultTopic: 'Default', uploadBtn: 'Upload PDF',
+      newTopicFail: 'Failed to create topic',
       upload: 'Upload PDF into this topic', newChat: 'New chat', session: 'Session', pdfTab: 'Paper PDF',
       history: 'Chat history',
       sync: 'Chat is still on another paper — click to switch to the current one',
@@ -108,6 +112,34 @@ window.__ModuleLoader__.load({
       return r.json()
     }
 
+    /* 当前在屏（主视图）会话 id：0.1.x 是会话列表快照的 .current 字段；
+       0.2.0 起快照没有该字段，官方以 retainedBy.mainView>0 标记主视图保留的会话
+       （dsh-client-ui-workspace 自己的 current() 就是这么读的）—— 两代都取到。 */
+    function currentSessionOf(snap) {
+      if (!snap) return null
+      if (snap.current !== undefined) return snap.current
+      try {
+        return Object.values(snap.byId ?? {}).find((row) => (row.retainedBy?.mainView ?? 0) > 0)?.id ?? null
+      } catch { return null }
+    }
+
+    /* ---------- 轻提示（DOM 直挂，不进 React 树） ----------
+       window.alert 桌面端（Electron）虽可用但阻塞且各壳表现不一，一律换掉。 */
+    function toast(msg) {
+      const el = document.createElement('div')
+      el.setAttribute('data-dpr-toast', '')
+      el.textContent = msg
+      Object.assign(el.style, {
+        position: 'fixed', left: '50%', bottom: '30px', transform: 'translateX(-50%)',
+        zIndex: 80, maxWidth: '76vw', padding: '8px 14px', borderRadius: '8px',
+        fontSize: '12px', lineHeight: 1.6, whiteSpace: 'pre-wrap', textAlign: 'center',
+        background: 'var(--dsw-alias-bg-inverse, #24292f)', color: 'var(--dsw-alias-label-inverse, #f6f8fa)',
+        boxShadow: '0 4px 16px rgba(0,0,0,.25)',
+      })
+      document.body.appendChild(el)
+      setTimeout(() => el.remove(), 4000)
+    }
+
     /* ---------- 会话切换护栏：PDF/网格全程冻结，只允许对话区换内容 ----------
        rightbar.session 是 session 作用域 slot，切会话 = seat 整体重挂：
        旧 seat 卸载时汇报 closeRightbar，新 seat 初挂时 surface 尚未建立也汇报
@@ -304,7 +336,7 @@ window.__ModuleLoader__.load({
           let docked = null
           try {
             const snap = uiWorkspace.sessions?.list?.getSnapshot?.()
-            const cur = snap?.current ?? null
+            const cur = currentSessionOf(snap)
             setCurSid((prev) => (prev === cur ? prev : cur))
             const col = document.querySelector('[data-rightbar-col]')?.previousElementSibling
             const conv = col?.querySelector('[data-phase]')
@@ -459,6 +491,10 @@ window.__ModuleLoader__.load({
       root: { padding: '4px 0 12px', fontSize: '13px', color: 'var(--dsw-alias-label-primary, #24292f)' },
       head: { display: 'flex', alignItems: 'center', gap: '4px', padding: '8px 10px 6px', fontSize: '12px', fontWeight: 600, color: 'var(--dsw-alias-label-secondary, #656d76)' },
       iconBtn: { cursor: 'pointer', border: 'none', background: 'none', color: 'inherit', padding: '0 4px', fontSize: '13px', opacity: .75 },
+      // 页内弹窗（Electron 无 window.prompt）与空库入口按钮
+      btnPrimary: { fontSize: '13px', padding: '5px 14px', borderRadius: '6px', border: 'none', cursor: 'pointer', background: 'var(--dsw-alias-button-primary-fill, #1f6feb)', color: 'var(--dsw-alias-button-primary-foreground, #fff)' },
+      btnGhost: { fontSize: '13px', padding: '5px 14px', borderRadius: '6px', cursor: 'pointer', background: 'none', border: '1px solid var(--dsw-alias-border-l1, #d0d7de)', color: 'var(--dsw-alias-label-secondary, #656d76)' },
+      linkBtn: { display: 'inline-flex', alignItems: 'center', gap: '4px', fontSize: '12px', padding: '4px 10px', borderRadius: '6px', cursor: 'pointer', background: 'none', border: '1px solid var(--dsw-alias-border-l1, #d0d7de)', color: 'var(--dsw-alias-label-action-primary, #0969da)' },
       topicHead: { display: 'flex', alignItems: 'center', gap: '6px', padding: '5px 8px', margin: '1px 6px 0', borderRadius: '6px', cursor: 'pointer', fontWeight: 600, userSelect: 'none' },
       caret: { fontSize: '10px', color: 'var(--dsw-alias-label-secondary, #656d76)', transition: 'transform .12s', display: 'inline-block' },
       items: { marginLeft: '14px' },
@@ -472,6 +508,35 @@ window.__ModuleLoader__.load({
       railBtn: { width: '36px', height: '36px', display: 'inline-flex', alignItems: 'center', justifyContent: 'center', border: 'none', background: 'none', borderRadius: '50%', color: 'var(--dsw-alias-label-primary, #24292f)', cursor: 'pointer', fontSize: '17px', padding: '0' },
     }
 
+    /* ---------- 页内文本输入弹窗：Electron 渲染进程不实现 window.prompt
+       （实测同版本 Electron 调用即抛 "prompt() is not supported"，桌面端点「＋」
+       曾因此毫无反应），一律走 createPortal 挂 document.body，避免被侧栏 overflow 裁剪。 ---------- */
+    function AskText(props) {
+      const { title, confirmText, cancelText, onConfirm, onCancel } = props
+      const [v, setV] = useState('')
+      const ref = React.useRef(null)
+      useEffect(() => { ref.current?.focus() }, [])
+      const submit = () => { const s = v.trim(); if (s) onConfirm(s) }
+      return h('div', {
+        style: { position: 'fixed', inset: 0, zIndex: 99999, background: 'rgba(0,0,0,.35)', display: 'flex', alignItems: 'center', justifyContent: 'center', font: 'inherit' },
+        onClick: onCancel,
+      },
+        h('div', {
+          style: { width: '320px', maxWidth: '90vw', padding: '16px', borderRadius: '10px', boxShadow: '0 8px 30px rgba(0,0,0,.3)', background: 'var(--dsw-alias-bg-layer-1, #ffffff)', color: 'var(--dsw-alias-label-primary, #24292f)' },
+          onClick: (e) => e.stopPropagation(),
+        },
+          h('div', { style: { fontSize: '13px', fontWeight: 600, margin: '0 0 10px' } }, title),
+          h('input', {
+            ref, value: v, type: 'text',
+            style: { width: '100%', boxSizing: 'border-box', fontSize: '13px', padding: '6px 10px', borderRadius: '6px', border: '1px solid var(--dsw-alias-border-l1, #d0d7de)', background: 'var(--dsw-alias-bg-layer-2, #f6f8fa)', color: 'inherit', outline: 'none' },
+            onChange: (e) => setV(e.target.value),
+            onKeyDown: (e) => { if (e.key === 'Enter') submit(); else if (e.key === 'Escape') onCancel() },
+          }),
+          h('div', { style: { display: 'flex', gap: '8px', justifyContent: 'flex-end', margin: '12px 0 0' } },
+            h('button', { type: 'button', style: S.btnGhost, onClick: onCancel }, cancelText),
+            h('button', { type: 'button', style: S.btnPrimary, onClick: submit }, confirmText))))
+    }
+
     function LibraryTree(props) {
       const { layout, uiWorkspace, sidebarRight, wide, expandSidebar } = props
       const [lib, setLib] = useState(null)
@@ -498,11 +563,15 @@ window.__ModuleLoader__.load({
 
       // 打开 PDF 页签：等 rightbar seat 绑定到目标会话后只调一次 openTab（成功即停，
       // 不再轮询——否则用户关页签会被后续 tick 重开，「关很多次才能关掉」）。
+      // 「在屏会话」的读法两代不同：0.1.x 是 sidebarRight.binding.sessionId，
+      // 0.2.0 起没有 binding，换成 mounted store（快照=在屏 sessionId）——
+      // 只认旧的会把新版的页签轮询 30 次全部耗尽，PDF 永远开不出来（issue #1 实测）。
+      const onScreenSession = (sr) => sr.binding?.sessionId ?? sr.mounted?.getSnapshot?.()
       const openPdfTab = useCallback((sessionId) => {
         let tries = 30
         const tick = () => {
           try {
-            if (sidebarRight.binding?.sessionId !== sessionId) throw new Error('seat-not-bound')
+            if (onScreenSession(sidebarRight) !== sessionId) throw new Error('seat-not-bound')
             sidebarRight.openTab('dpr-reader', { revealIfOpened: true })
           } catch {
             // 快轮询：seat 重绑一完成就开页签，把"面板空白"窗口压到最短
@@ -519,7 +588,7 @@ window.__ModuleLoader__.load({
         const tick = () => {
           try {
             const snap = uiWorkspace.sessions?.list?.getSnapshot?.()
-            if (snap && snap.current === sessionId) return // 已是当前会话
+            if (currentSessionOf(snap) === sessionId) return // 已是当前会话
             const listed = !!(snap && (snap.byId?.[sessionId] || snap.ids?.includes(sessionId)))
             if (listed) uiWorkspace.openSession(sessionId)
             if (--tries > 0) setTimeout(tick, 300)
@@ -559,7 +628,7 @@ window.__ModuleLoader__.load({
         // 离开的若是空白草稿（点了新建又没问任何问题）→ 后台归档，不留在会话列表里
         try {
           const snap = uiWorkspace.sessions?.list?.getSnapshot?.()
-          const leaving = snap?.current
+          const leaving = currentSessionOf(snap)
           if (leaving && typeof leaving === 'string' && leaving.startsWith('dpr-') && leaving !== target.sessionId
             && snap?.byId?.[leaving]?.blank && !snap.byId[leaving].running) {
             api('/sessions/archive', {
@@ -609,15 +678,19 @@ window.__ModuleLoader__.load({
         loadSessions(topic, name) // 后台对账：让 host 的空白过滤把被顶替的旧空白会话收掉
       }, [activate, loadSessions])
 
-      const newTopic = useCallback(async () => {
-        const name = window.prompt(t('newTopic') + '：')
-        if (!name?.trim()) return
+      const [askTopic, setAskTopic] = useState(false)
+      const createTopic = useCallback(async (raw) => {
+        const name = raw?.trim()
+        if (!name) return
         await api('/library/topic', {
           method: 'POST', headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({ name: name.trim() }),
+          body: JSON.stringify({ name }),
         })
         refresh()
       }, [refresh])
+      // 新建专题：window.prompt 在 Electron 渲染进程不可用（抛 "prompt() is not
+      // supported"，点击无任何反应），改为 AskText 页内弹窗（见 LibraryTree return）。
+      const newTopic = useCallback(() => setAskTopic(true), [])
 
       const upload = useCallback((topic) => {
         uploadTopic.current = topic
@@ -638,13 +711,30 @@ window.__ModuleLoader__.load({
             const body = await r.json().catch(() => ({}))
             throw new Error(body.error || body.reason || ('HTTP ' + r.status))
           }
-        }).catch((err) => window.alert('上传失败: ' + err.message))
+        }).catch((err) => toast('上传失败: ' + err.message))
         refresh()
       }, [refresh])
 
       const topics = lib?.topics ?? []
       const papers = lib?.papers ?? []
 
+      // 头部「⬆」与空库按钮共用：定位目标专题，没有专题时先自动建「默认专题」
+      // （宿主端 mkdir recursive，重名无害）再弹文件选择——空库不再是无入口的死路。
+      const uploadSmart = useCallback(async () => {
+        let topic = cur?.topic || topics[0]
+        if (!topic) {
+          topic = t('defaultTopic')
+          try {
+            await api('/library/topic', {
+              method: 'POST', headers: { 'content-type': 'application/json' },
+              body: JSON.stringify({ name: topic }),
+            })
+          } catch { /* 已存在等情形忽略，继续走上传 */ }
+          refresh()
+        }
+        upload(topic)
+      }, [cur, topics, upload, refresh])
+
       // 对话头部按钮 → 树的既有动作（enter/newChat 闭包在这里）
       useEffect(() => {
         const onEnter = (e) => enter(e.detail.topic, e.detail.name, e.detail.n)
@@ -669,10 +759,15 @@ window.__ModuleLoader__.load({
         : h(React.Fragment, null,
             h('div', { style: S.head },
               h('span', { style: { flex: 1 } }, t('library')),
+              h('button', { style: S.iconBtn, title: t('upload'), onClick: () => uploadSmart() }, '⬆'),
               h('button', { style: S.iconBtn, title: t('newTopic'), onClick: newTopic }, '＋'),
               h('button', { style: S.iconBtn, title: 'refresh', onClick: refresh }, '⟳'),
             ),
-            lib && topics.length === 0 && h('div', { style: S.empty }, `${t('empty')}: ${t('hint')}`),
+            lib && topics.length === 0 && h('div', { style: S.empty },
+              `${t('empty')}：${t('hint')}`,
+              h('div', { style: { display: 'flex', gap: '8px', margin: '8px 0 2px' } },
+                h('button', { type: 'button', style: S.linkBtn, onClick: () => uploadSmart() }, '⬆ ', t('uploadBtn')),
+                h('button', { type: 'button', style: S.linkBtn, onClick: newTopic }, '＋ ', t('newTopic')))),
             topics.map((topic) => {
               const isClosed = !!closed[topic]
               return h('div', { key: topic },
@@ -711,6 +806,16 @@ window.__ModuleLoader__.load({
         // 阅读器 iframe 与对话头部按钮组已迁往 shell.overlay 常驻注册（见 applyPaperMode 下方）——
         // 它们不属于侧栏，更不能跟着「退出伴读模式」被卸载（已打开的 PDF 页签要继续活着）
         tree,
+        askTopic && createPortal(
+          h(AskText, {
+            title: t('newTopic') + '：', confirmText: t('ok'), cancelText: t('cancel'),
+            onConfirm: (name) => {
+              setAskTopic(false)
+              createTopic(name).catch((err) => toast(t('newTopicFail') + ': ' + err.message))
+            },
+            onCancel: () => setAskTopic(false),
+          }),
+          document.body),
       )
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ggboy123/dsh-paper-reader",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "DeepSeek Harness 插件：论文伴读工作台 — PDF 转录 / 检索 / 原生对话伴读 + 内置阅读器页面。",
   "license": "MIT",
   "type": "module",
@@ -45,6 +45,7 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
+    "smoke:engine": "node scripts/engine-smoke.mjs",
     "prepublishOnly": "tsc -p tsconfig.json"
   },
   "keywords": [
@@ -70,7 +71,7 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.1 <0.2.0-0"
+    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.1 <0.3.0-0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",

package/reader/index.html

@@ -4,12 +4,10 @@
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>论文伴读 · dsh-paper-reader</title>
-<!-- pdf.js 6.x 本地 vendor（不再走 CDN）：3.11 的字体解析对 babeldoc 嵌入的 CID 字体会回退成黑体 -->
-<script type="module">
-  import * as pdfjsLib from '/paper-reader/vendor/pdf.min.mjs';
-  window.pdfjsLib = pdfjsLib;
-  pdfjsLib.GlobalWorkerOptions.workerSrc = '/paper-reader/vendor/pdf.worker.min.mjs';
-</script>
+<!-- pdf.js 6.x 本地 vendor（不再走 CDN）：3.11 的字体解析对 babeldoc 嵌入的 CID 字体会回退成黑体。
+     不用 <script type="module">：module 是 defer 语义（整页解析完 + 458KB 拉取编译完才执行），
+     而底部经典脚本在解析期就开跑 bootstrap()，库里有论文时先到 loadPdf，此刻 window.pdfjsLib
+     还没就绪 → "pdfjsLib is not defined"。改为经典脚本里动态 import()（见 ensurePdfjs），顺序有保证。 -->
 <style>
   :root {
     --bg: #f6f7f9; --panel: #ffffff; --border: #e2e5ea; --text: #24292f;
@@ -398,7 +396,27 @@ $('cfg-save').onclick = async () => {
 };
 
 /* ================= PDF 渲染(pdf.js:缩放 + devicePixelRatio 高清,移植自 pdfqa) ================= */
-/* pdfjsLib 与 workerSrc 由头部 module 脚本设置（本地 vendor，pdf.js 6.x） */
+/* pdf.js 6.x 本地 vendor：动态 import（缓存的 Promise），loadPdf 先 await 再用——
+   底部经典脚本解析期就开跑 bootstrap()，必须由这里保证「pdf.js 就绪后才渲染」；
+   失败（vendor 404 / MIME 拒绝）抛带 URL 的可读错误，而不是莫名其妙的 ReferenceError。 */
+let pdfjsReadyP = null;
+function ensurePdfjs() {
+  if (!pdfjsReadyP) {
+    pdfjsReadyP = import('/paper-reader/vendor/pdf.min.mjs').then(
+      (m) => {
+        window.pdfjsLib = m;
+        m.GlobalWorkerOptions.workerSrc = '/paper-reader/vendor/pdf.worker.min.mjs';
+        return m;
+      },
+      (e) => {
+        pdfjsReadyP = null; // 失败后清缓存：瞬时故障不至于让本页签永久坏掉，下次 loadPdf 重试
+        throw new Error('pdf.js 加载失败（/paper-reader/vendor/pdf.min.mjs）：' + (e && e.message ? e.message : e));
+      },
+    );
+  }
+  return pdfjsReadyP;
+}
+ensurePdfjs().catch(() => {}); // 预热：与 bootstrap 的 API 请求并行拉取，不把首屏串行化
 
 let pdfDoc = null;
 let zoomScale = 1.5;
@@ -416,6 +434,7 @@ let renderToken = 0;
 })();
 
 async function loadPdf(url) {
+  await ensurePdfjs(); // 就绪前禁止触 pdfjsLib（defer 竞态，见文件头注释）
   pdfDoc = await pdfjsLib.getDocument({ url }).promise; // v6 起不接受字符串参数，必须传对象
   $('empty').style.display = 'none';
   if (fitMode) { fitToWidth(); return; } // fitToWidth 内部 setZoom → renderAllPages