@ggboy123/dsh-paper-reader 1.3.4 → 1.4.0

package/lib/client.js

@@ -15,6 +15,30 @@
 // 加载机制：package.json 声明 dsh.client.inject + exports["./client"]；require 解析
 // 官方客户端包，不要用裸 import。
 
+/**
+ * 失败文案组装（**纯函数**：入参 `err` + i18n 的 `t`，返回 `{ text, recovery }`）。
+ * 放在 `load()` **之外**的文件顶层：Node 里执行本文件即可直接取用（测试用 harness 追加导出），
+ * 不需要给模块对象加任何测试钩子。
+ *
+ * 为什么必须在这里组装（评审 F-B）：clear 失败会返回 409 `file-busy` 且带 `rollbackFailed` ——
+ * 那些文件**真的还在 `.trash/` 里**，而 `listPapers` 只看常规文件，于是文献树里该篇看起来
+ * 「消失」了。若只 toast 一句「文件被占用，关闭后重试」，用户永远不知道该去回收站恢复。
+ * 规则：
+ *   · `rollbackFailed` 非空 ⇒ 点名文件 + 给出回收站**相对**路径（`trashRel`，绝不用绝对路径）与恢复方法；
+ *   · 未回滚非空时**不得**声称「文献库未改变」（F-C：那句是服务端内层文案，只对失败那一篇成立）；
+ *   · 没有回滚失败 ⇒ 只给简洁文案，不吓唬用户。
+ */
+function clearFailureText(err, t) {
+  const files = Array.isArray(err && err.rollbackFailed) ? err.rollbackFailed.filter((x) => typeof x === 'string') : []
+  const where = err && typeof err.trashRel === 'string' && err.trashRel ? err.trashRel : '.trash'
+  const base = err && err.code === 'file-busy' ? t('delBusyFile') : ((err && err.message) || String(err))
+  if (files.length === 0) return { text: base, recovery: '' }
+  return {
+    text: t('clearPartialFailText').replace('{n}', String(files.length)).replace('{names}', files.join('、')),
+    recovery: t('clearRecoveryHint').replace('{where}', where).replace('{names}', files.join('、')),
+  }
+}
+
 window.__ModuleLoader__.load({
   // 必须等于 npm 包名：浏览器端 loader 按包名期待注册（改名时漏改这里 →
   // "loaded without registering" 整页插件加载失败，实测）
@@ -32,7 +56,7 @@ window.__ModuleLoader__.load({
       cancel: '取消', ok: '确定', defaultTopic: '默认专题', uploadBtn: '上传 PDF',
       newTopicFail: '新建专题失败',
       rename: '重命名', renameTopic: '重命名专题', renamePaper: '重命名论文',
-      del: '删除', delArm: '确认删除?', renameFail: '重命名失败', delFail: '删除失败',
+      renameFail: '重命名失败', delFail: '删除失败',
       upload: '上传 PDF 到此专题', newChat: '新建对话', session: '会话', pdfTab: '论文 PDF',
       history: '历史对话',
       sync: '对话还停在另一篇文献的会话里，点击切到当前文献',
@@ -40,6 +64,8 @@ window.__ModuleLoader__.load({
       settings: '论文伴读',
       setRerankTitle: '检索重排（Jev）',
       setRerankDesc: 'search_paper 检索的语义重排：关键词先捞候选，Jev 逐个判断「这段能否回答这个问题」再排序——大白话提问也能命中论文里的术语段落。不配则退回纯关键词排序。',
+      setEmbedTitle: '嵌入模型检索（可选）',
+      setEmbedDesc: 'search_paper 的语义召回：分块文本会发送到该 OpenAI 兼容 /embeddings 端点，用向量把「关键词一个字都没命中」的语义相近片段也捞进候选（与关键词结果融合，不替代）。留空即关闭，检索行为与现在完全一致。注意：分块文本（论文正文）会发往该端点。',
       setTranslateTitle: '翻译端点',
       setTranslateDesc: '「生成中文版」（babeldoc）用的 OpenAI 兼容端点，三项必填。保存前会先测连接。',
       setBaseUrl: '端点 URL', setModel: '模型', setKey: 'API Key',
@@ -48,6 +74,55 @@ window.__ModuleLoader__.load({
       setKeyKeep: '留空沿用已保存的 ', setOptional: '可选',
       setSourceFile: '当前来源：设置页', setSourceProfile: '当前来源：配置文件（部署方默认）',
       setSourceEnv: '当前来源：环境变量', setSourceNone: '未配置',
+      setMineruTitle: 'MinerU 解析后端',
+      setMineruDesc: 'PDF 转录的 MinerU 后端：本地 MinerU API（127.0.0.1:8000，扫描件/OCR 友好）或 mineru.net v4 云端。默认关闭（走本地 pdf.js）。保存前会先测试连接。',
+      setMineruMode: '模式', setMineruModeOff: '关闭', setMineruModeLocal: '本地', setMineruModeCloud: '云端',
+      setMineruLocalUrl: '本地服务地址', setMineruLocalKey: '本地 API Key', setMineruBackend: '本地解析后端',
+      setMineruEffort: 'hybrid effort', setMineruParseMethod: '本地解析方式', setMineruCloudKey: '云端 token',
+      setMineruTestConnection: '测试连接', setMineruHealthOk: '连接正常', setMineruHealthFail: '连接失败',
+      // 激活门槛人话（上游评审第 7 条）：普通用户不知道 MinerU 是什么。① 什么时候需要它
+      // （扫描版读不了 / 公式点不了）；② 配置后入口出现在哪（阅读器公式面板的「用 MinerU 重新转录」）。
+      setMineruWhy: '扫描版论文读不了？公式点不了？——在这里配置后就能解析：本地 MinerU 或 mineru.net 云端 token，二选一；保存后阅读器公式面板里会出现「用 MinerU 重新转录」。',
+      setMineruWhyLocal: '本地模式需要你自己跑一个 MinerU 服务（127.0.0.1:8000），适合有显卡、论文不外传的场景。',
+      setMineruWhyCloud: '云端模式只要一个 mineru.net token，无需本地显卡；论文会上传到 mineru.net 解析。',
+      setMineruOffHint: '当前为「关闭」：转录走本地 pdf.js——有文本层的普通 PDF 完全够用；扫描版（没有文本层）与公式引用才需要 MinerU（选本地或云端）。',
+      // 文献管理（删除/重命名）：契约见 docs/reader-ux-requirements.md §2.9。
+      // 去重说明：rename/renameTopic/renamePaper/renameFail/delFail 只保留上面上游那组
+      // （JS 对象字面量重复 key 不报错、后者静默胜出 → 必须手工去重，否则文案悄悄取自另一份）。
+      newName: '新名称', renameDone: '已重命名',
+      renameDetached: '注意：{n} 个历史会话不会删除，但不再显示在列表里',
+      renameTargetExists: '已存在同名文献或专题',
+      delPaper: '删除文献', delTopic: '删除专题',
+      delConfirmTitle: '确认删除', delToTrash: '移入回收站',
+      delConfirmBody: '将移入回收站（可恢复）：共 {files} 个文件、{size}',
+      delNotDeleted: '不会删除：伴读会话历史、共享翻译环境',
+      delTopicTypeName: '请输入专题名「{name}」以确认',
+      delDone: '已移入回收站（{files} 个文件）',
+      delBusySession: '该文献有正在运行的会话，请先结束后再操作',
+      delBusyTranslate: '正在生成译文，请等待完成后再操作',
+      delTopicNotEmpty: '专题内还有 {n} 篇文献，需批量清空或先逐篇删除',
+      delTopicClearTitle: '清空「{topic}」并删除',
+      delTopicClearBody: '共 {papers} 篇文献、{files} 个文件（{size}）：确认后逐篇移入回收站（可恢复），然后删除专题目录。有运行中会话或正在翻译的文献会被服务端先拦下。',
+      delTopicClearConfirm: '清空并删除',
+      delTopicClearFiles: '{n} 个文件',
+      delTopicClearBlocked: '注意：以下文献正在翻译或有运行中会话，会被服务端拦下（先处理再清空）：{names}',
+      delTopicClearPlanFail: '无法获取清空清单',
+      delTopicClearHidden: '隐藏条目 {names} 也会进回收站（不销毁）',
+      clearDone: '已清空「{topic}」：{papers} 篇 / {files} 个文件 → 已移入回收站',
+      delBusyFile: '文件被占用（可能正在阅读器或其他程序中打开），关闭后重试',
+      // F-B/F-C：回滚失败必须把「哪些文件、在哪个回收站、怎么恢复」说清楚；未回滚时不得声称「库未改变」
+      clearPartialFailText: '操作未完成：{n} 个文件未能回滚，仍在回收站里（文献树里可能已看不到）：{names}',
+      clearRecoveryHint: '恢复方法：把 {where}/ 里列出的这些文件移回原专题目录即可',
+      delPlanFail: '无法获取删除清单',
+      delBusy: '同一篇文献的另一个删除/重命名操作正在进行，请稍后重试',
+      delSessionUnknown: '暂时无法确认该文献的伴读会话状态，为避免误删已取消本次操作；请稍后重试',
+      eqTitle: '公式', eqPanelEmpty: '本论文未解析出公式',
+      eqNeedMineru: '需要 MinerU 解析产物才能点击引用公式',
+      eqTranscribe: '用 MinerU 重新转录', eqBadArtifact: 'MinerU 产物损坏，已忽略',
+      eqCopy: '复制 LaTeX', eqCopied: '已复制公式 LaTeX',
+      eqChip: '第 {page} 页 · 公式 {k}',
+      eqTranslatedView: '译文视图没有公式位置信息，切回原文可点击',
+      eqNoPosition: '无位置信息',
     }
     const en = {
       library: 'Library',
@@ -55,7 +130,7 @@ window.__ModuleLoader__.load({
       cancel: 'Cancel', ok: 'OK', defaultTopic: 'Default', uploadBtn: 'Upload PDF',
       newTopicFail: 'Failed to create topic',
       rename: 'Rename', renameTopic: 'Rename topic', renamePaper: 'Rename paper',
-      del: 'Delete', delArm: 'Delete?', renameFail: 'Rename failed', delFail: 'Delete failed',
+      renameFail: 'Rename failed', delFail: 'Delete failed',
       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',
@@ -63,6 +138,8 @@ window.__ModuleLoader__.load({
       settings: 'Paper Reader',
       setRerankTitle: 'Search rerank (Jev)',
       setRerankDesc: 'Semantic rerank for search_paper: keyword search shortlists candidates, Jev judges "can this passage answer the question" and reorders — plain-language questions hit terminology passages. Without it, plain keyword ranking is used.',
+      setEmbedTitle: 'Embedding search (optional)',
+      setEmbedDesc: 'Semantic recall for search_paper: chunk texts are sent to this OpenAI-compatible /embeddings endpoint so passages that share no keywords but are semantically close still enter the candidate set (fused with keyword hits, never replacing them). Leave empty to keep it off — search behaviour stays exactly as today. Note: chunk texts (paper body) are sent to this endpoint.',
       setTranslateTitle: 'Translate endpoint',
       setTranslateDesc: 'OpenAI-compatible endpoint for "Generate Chinese version" (babeldoc). All three fields required. Connection is tested before saving.',
       setBaseUrl: 'Endpoint URL', setModel: 'Model', setKey: 'API Key',
@@ -71,6 +148,49 @@ window.__ModuleLoader__.load({
       setKeyKeep: 'Leave empty to keep saved ', setOptional: 'optional',
       setSourceFile: 'Source: settings page', setSourceProfile: 'Source: config file (deployment default)',
       setSourceEnv: 'Source: environment variable', setSourceNone: 'Not configured',
+      setMineruTitle: 'MinerU parser',
+      setMineruDesc: 'MinerU backend for PDF transcription: local MinerU API (127.0.0.1:8000, scan/OCR friendly) or mineru.net v4 cloud. Off by default (local pdf.js). Connection is tested before saving.',
+      setMineruMode: 'Mode', setMineruModeOff: 'Off', setMineruModeLocal: 'Local', setMineruModeCloud: 'Cloud',
+      setMineruLocalUrl: 'Local service URL', setMineruLocalKey: 'Local API key', setMineruBackend: 'Local backend',
+      setMineruEffort: 'hybrid effort', setMineruParseMethod: 'Parse method', setMineruCloudKey: 'Cloud token',
+      setMineruTestConnection: 'Test connection', setMineruHealthOk: 'Connection OK', setMineruHealthFail: 'Connection failed',
+      setMineruWhy: 'Scanned PDFs unreadable? Formulas not clickable? Configure a parser here: either a local MinerU API or a mineru.net cloud token. Once saved, the reader adds a "Re-parse with MinerU" button in the formula panel.',
+      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).',
+      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',
+      delPaper: 'Delete paper', delTopic: 'Delete topic',
+      delConfirmTitle: 'Confirm deletion', delToTrash: 'Move to trash',
+      delConfirmBody: 'Will be moved to trash (recoverable): {files} files, {size}',
+      delNotDeleted: 'Not deleted: chat history, shared translation venv',
+      delTopicTypeName: 'Type the topic name "{name}" to confirm',
+      delDone: 'Moved to trash ({files} files)',
+      delBusySession: 'A session is still running — end it first',
+      delBusyTranslate: 'Translation in progress — try again later',
+      delTopicNotEmpty: 'Topic still has {n} papers — use bulk clear, or delete them one by one',
+      delTopicClearTitle: 'Clear \u201c{topic}\u201d and delete',
+      delTopicClearBody: '{papers} papers, {files} files ({size}): after confirmation each paper is moved to the trash (recoverable), then the topic folder is removed. Papers with a running chat or an in-progress translation are blocked first.',
+      delTopicClearConfirm: 'Clear & delete',
+      delTopicClearFiles: '{n} files',
+      delTopicClearBlocked: 'Heads up: these papers are translating or have running chats and will be blocked by the server — handle them first: {names}',
+      delTopicClearPlanFail: 'Could not fetch the clear plan',
+      delTopicClearHidden: 'Hidden entries {names} are moved to the trash too (never destroyed)',
+      clearDone: 'Cleared \u201c{topic}\u201d: {papers} papers / {files} files \u2192 moved to trash',
+      delBusyFile: 'File is in use (open in the reader or another program) — close it and retry',
+      clearPartialFailText: 'The operation did not finish: {n} file(s) could not be rolled back and are still in the trash (the paper may look gone in the tree): {names}',
+      clearRecoveryHint: 'To recover: move those files from {where}/ back into the original topic folder',
+      delPlanFail: 'Could not fetch the deletion manifest',
+      delBusy: 'Another delete/rename on this paper is in progress — try again later',
+      delSessionUnknown: 'Could not confirm chat status — cancelled to avoid accidental deletion; try again later',
+      eqTitle: 'Formulas', eqPanelEmpty: 'No formulas parsed for this paper',
+      eqNeedMineru: 'MinerU output required to click-cite formulas',
+      eqTranscribe: 'Re-parse with MinerU', eqBadArtifact: 'MinerU output is corrupt — ignored',
+      eqCopy: 'Copy LaTeX', eqCopied: 'Formula LaTeX copied',
+      eqChip: 'p.{page} · formula {k}',
+      eqTranslatedView: 'No positions in the translated view — switch back to the original',
+      eqNoPosition: 'No position info',
     }
 
     let t = (k) => k
@@ -111,7 +231,13 @@ window.__ModuleLoader__.load({
       const r = await fetch('/paper-reader/api' + path, opts)
       if (!r.ok) {
         const body = await r.json().catch(() => ({}))
-        throw new Error(body.error || body.reason || ('HTTP ' + r.status))
+        const err = new Error(body.error || body.reason || ('HTTP ' + r.status))
+        // 机器可读码挂到 Error 上：调用方按 code 分支（别去匹配中文文案）
+        err.code = body.code
+        err.status = r.status
+        if (body.papers) err.papers = body.papers
+        if (body.entries) err.entries = body.entries
+        throw err
       }
       return r.json()
     }
@@ -561,9 +687,12 @@ window.__ModuleLoader__.load({
        曾因此毫无反应），一律走 createPortal 挂 document.body，避免被侧栏 overflow 裁剪。 ---------- */
     function AskText(props) {
       const { title, confirmText, cancelText, onConfirm, onCancel, initial } = props
-      const [v, setV] = useState(() => initial ?? '')
+      const [v, setV] = useState(() => initial ?? '')   // 上游写法：惰性初值（避免每次渲染重算）
       const ref = React.useRef(null)
-      useEffect(() => { ref.current?.focus() }, [])
+      useEffect(() => {
+        ref.current?.focus()
+        if (ref.current && initial) ref.current.select() // 重命名场景：默认选中旧名，直接覆盖输入
+      }, [])
       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' },
@@ -585,6 +714,44 @@ window.__ModuleLoader__.load({
             h('button', { type: 'button', style: S.btnPrimary, onClick: submit }, confirmText))))
     }
 
+    /* ---------- 破坏性操作确认弹窗（删除专用）----------
+       与 AskText 同一套 portal + 页内弹窗约定：Electron 渲染进程不支持 window.confirm/prompt。
+       契约要求：文案必须**逐条列出将删除的内容**，且清单来自服务端 dry-run（delete-plan），
+       不允许前端自己拼。专题删除额外要求输入专题名（type-to-confirm）。 */
+    function ConfirmDelete(props) {
+      const { title, body, detail, notDeleted, confirmText, cancelText, requireText, onConfirm, onCancel } = props
+      const [typed, setTyped] = useState('')
+      const ok = !requireText || typed.trim() === requireText
+      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: '380px', maxWidth: '92vw', maxHeight: '86vh', overflow: 'auto', 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 8px' } }, title),
+          body ? h('div', { style: { fontSize: '12.5px', lineHeight: 1.6 } }, body) : null,
+          detail ? h('div', {
+            style: { margin: '8px 0 0', padding: '6px 8px', borderRadius: '6px', background: 'var(--dsw-alias-bg-layer-2, #f6f8fa)', fontSize: '11.5px', lineHeight: 1.7, maxHeight: '32vh', overflow: 'auto', whiteSpace: 'pre-wrap', wordBreak: 'break-all' },
+          }, detail) : null,
+          notDeleted ? h('div', { style: { marginTop: '8px', fontSize: '11.5px', color: 'var(--dsw-alias-label-secondary, #656d76)', lineHeight: 1.6 } }, notDeleted) : null,
+          requireText ? h('input', {
+            value: typed, type: 'text', placeholder: requireText,
+            style: { width: '100%', boxSizing: 'border-box', marginTop: '10px', 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) => setTyped(e.target.value),
+            onKeyDown: (e) => { if (e.key === 'Enter' && ok) onConfirm(); else if (e.key === 'Escape') onCancel() },
+          }) : null,
+          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, ...(ok ? {} : { opacity: .5, cursor: 'default' }) },
+              disabled: !ok,
+              onClick: () => { if (ok) onConfirm() },
+            }, confirmText))))
+    }
+
     function LibraryTree(props) {
       const { layout, uiWorkspace, sidebarRight, wide, expandSidebar } = props
       const [lib, setLib] = useState(null)
@@ -756,24 +923,25 @@ window.__ModuleLoader__.load({
          已知代价（README 明示）：sessionId 编码旧 topic/name，改名后历史伴读会话从树上
          消失（会话本体仍在 dsh 全局列表）；study.json/译文/转录缓存随文件改名全部保留。 */
       const [renaming, setRenaming] = useState(null) // {kind:'topic'|'paper', topic, name}
-      const [armDel, setArmDel] = useState(null)     // {kind, topic, name}：两段式删除的待确认态
-
-      // 两段式删除的待确认态 3s 自动复位（复刻阅读器 ↻ 重译按钮的 arm 模式）
-      useEffect(() => {
-        if (!armDel) return undefined
-        const timer = setTimeout(() => setArmDel(null), 3000)
-        return () => clearTimeout(timer)
-      }, [armDel])
 
       const doRename = useCallback(async (kind, topic, name, to) => {
         const newTopicName = kind === 'topic' ? to : topic
         const newName = kind === 'paper' ? to : name
+        let r = null
         try {
-          await api(`/library/rename-${kind}`, {
+          r = await api(`/library/rename-${kind}`, {
             method: 'POST', headers: { 'content-type': 'application/json' },
             body: JSON.stringify(kind === 'topic' ? { topic, to } : { topic, name, to }),
           })
-        } catch (err) { toast(t('renameFail') + ': ' + err.message); return }
+        } catch (err) {
+          // 与删除一致：改名失败也可能带回 rollbackFailed（部分产物名字没能回滚）→ 必须给出恢复指引
+          const f = clearFailureText(err, t)
+          toast(t('renameFail') + ': ' + f.text + (f.recovery ? '　' + f.recovery : ''), f.recovery ? 15000 : 6000)
+          return
+        }
+        // 我们分支的加固实现会回 detachedSessions（会话 id 内嵌旧 topic/name → 改名后不再挂树上，
+        // 但会话本体不删除）。上游 UI 不提示这一点，用户会以为会话丢了——保留我们的提示。
+        if (r && r.detachedSessions) toast(t('renameDone') + ' · ' + t('renameDetached').replace('{n}', String(r.detachedSessions)), 6000)
         // 本地记忆（语言版本/会话序号/上次打开/折叠态）搬到新身份
         migrateLsKeys(topic, newTopicName, kind === 'paper' ? name : null, kind === 'paper' ? newName : null)
         setSessions((m) => { const c = { ...m }; delete c[`${topic}/${name}`]; return c })
@@ -791,36 +959,9 @@ window.__ModuleLoader__.load({
         refresh()
       }, [cur, refresh])
 
-      const doDelete = useCallback(async (kind, topic, name) => {
-        try {
-          await api(`/library/delete-${kind}`, {
-            method: 'POST', headers: { 'content-type': 'application/json' },
-            body: JSON.stringify(kind === 'topic' ? { topic } : { topic, name }),
-          })
-        } catch (err) { toast(t('delFail') + ': ' + err.message); return }
-        setSessions((m) => { const c = { ...m }; delete c[`${topic}/${name}`]; return c })
-        refresh()
-        // 删的是当前论文（或其所在专题）→ 切到剩余第一篇；全空则收起阅读器
-        if (cur && (kind === 'topic' ? cur.topic === topic : (cur.topic === topic && cur.name === name))) {
-          const d = await api('/library').catch(() => null)
-          const next = d?.papers?.[0] || null
-          if (next) {
-            setCur({ topic: next.topic, name: next.name })
-            window.dispatchEvent(new CustomEvent('dpr:paper', { detail: { topic: next.topic, name: next.name } }))
-          } else {
-            setCur(null)
-            try { localStorage.removeItem('dpr.last') } catch {}
-            window.dispatchEvent(new CustomEvent('dpr:paper', { detail: { empty: true } }))
-          }
-        }
-      }, [cur, refresh])
-
-      // 两段式删除点击：第一击进入待确认（按钮变红显示「确认删除?」），第二击执行
-      const clickDelete = useCallback((kind, topic, name) => {
-        const armed = armDel && armDel.kind === kind && armDel.topic === topic && armDel.name === name
-        if (armed) { setArmDel(null); doDelete(kind, topic, name); return }
-        setArmDel({ kind, topic, name })
-      }, [armDel, doDelete])
+      // 删除不走上游的「同一按钮点两次（3s arm）」：改用我们的「服务端删除计划 + 页内确认框」
+      // （文献列清单/总字节，专题要手输专题名）。语义上严格包含上游的两段式——第二击之前
+      // 还多一次带清单的确认，且底层是移入回收站（可恢复）而不是 rmSync。
 
       const upload = useCallback((topic) => {
         uploadTopic.current = topic
@@ -877,6 +1018,140 @@ window.__ModuleLoader__.load({
         }
       }, [enter, newChat])
 
+      /* ---------- 文献管理：重命名 / 删除（契约 §2）----------
+         破坏性操作的 UI 规矩：
+           · 一律页内 portal 弹窗（Electron 无 window.confirm/prompt）；
+           · 删除前先打 /library/paper/delete-plan 拿服务端清单，把「将删除什么 / 不删什么」
+             逐条写进确认框（前端不许自己拼清单）；
+           · 服务端 409 用机器可读 code 分支（session-running / translation-busy /
+             topic-not-empty / target-exists），不匹配中文文案。 */
+      const [delDlg, setDelDlg] = useState(null) // {kind, topic, name, plan}
+
+      const fmtBytes = (n) => (n >= 1048576 ? (n / 1048576).toFixed(1) + ' MB' : n >= 1024 ? Math.round(n / 1024) + ' KB' : n + ' B')
+      const errText = (err) => {
+        switch (err && err.code) {
+          case 'session-running': return t('delBusySession')
+          case 'translation-busy': return t('delBusyTranslate')
+          case 'busy': return t('delBusy')
+          // 上游必修 3：Windows 文件占用（EBUSY/EPERM）→ 409 file-busy，给「关掉占用程序再试」的可执行文案
+          case 'file-busy': return t('delBusyFile')
+          case 'session-unknown': return t('delSessionUnknown')
+          case 'target-exists': return t('renameTargetExists')
+          case 'topic-not-empty': return t('delTopicNotEmpty').replace('{n}', String((err.papers || []).length || (err.entries || []).length || 0))
+          default: return (err && err.message) || String(err)
+        }
+      }
+
+      const openDelete = useCallback(async (kind, topic, name) => {
+        try {
+          if (kind === 'topic') {
+            const n = (lib?.papers ?? []).filter((p) => p.topic === name).length
+            if (n > 0) {
+              // 非空专题 → 「批量清空」中间态（上游评论第 10 条：逐篇列清单、一次确认）。
+              // 清单来自服务端 dry-run（topic/clear-plan），前端不自己拼；拿不到就如实报错，不弹空壳。
+              const plan = await api(`/library/topic/clear-plan?topic=${encodeURIComponent(name)}`)
+              setDelDlg({ kind: 'topic-clear', topic: name, name, plan })
+              return
+            }
+            setDelDlg({ kind, topic: name, name, plan: null })
+            return
+          }
+          const plan = await api(`/library/paper/delete-plan?topic=${encodeURIComponent(topic)}&name=${encodeURIComponent(name)}`)
+          setDelDlg({ kind, topic, name, plan })
+        } catch (e) {
+          // 预览失败（含 409/400/404）：用 code 给出可读原因，不弹一个空壳确认框
+          toast(t('delPlanFail') + '：' + errText(e))
+        }
+      }, [lib])
+
+      /** 删掉的是当前打开的文献（或其所在专题）→ 切到剩余第一篇；全空则收起阅读器。
+       *  （上游 v1.3.0 doDelete 的行为，整合时保留——否则 iframe 会指向已被删除的文件。） */
+      const switchAfterDelete = useCallback(async (kind, topic, name) => {
+        if (!(cur && (kind === 'topic' ? cur.topic === topic : (cur.topic === topic && cur.name === name)))) return
+        const d = await api('/library').catch(() => null)
+        const next = d?.papers?.[0] || null
+        if (next) {
+          setCur({ topic: next.topic, name: next.name })
+          window.dispatchEvent(new CustomEvent('dpr:paper', { detail: { topic: next.topic, name: next.name } }))
+        } else {
+          setCur(null)
+          try { localStorage.removeItem('dpr.last') } catch { /* 隐私模式 */ }
+          window.dispatchEvent(new CustomEvent('dpr:paper', { detail: { empty: true } }))
+        }
+      }, [cur])
+
+      const doDeletePaper = useCallback(async () => {
+        const d = delDlg
+        if (!d) return
+        setDelDlg(null)
+        try {
+          // O2（t4 评审）：删除也走**上游规范名**（与重命名的 /library/rename-${kind} 一致）；
+          // 别名族仍保留在服务端（旧测试与旧客户端用），但本 UI 只用规范名这一条。
+          const r = await api('/library/delete-paper', {
+            method: 'POST', headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ topic: d.topic, name: d.name }),
+          })
+          toast(t('delDone').replace('{files}', String((r.moved || []).length)))
+          await switchAfterDelete('paper', d.topic, d.name)
+          refresh()
+        } catch (e) {
+          const f = clearFailureText(e, t)
+          toast(t('delFail') + '：' + f.text + (f.recovery ? '　' + f.recovery : ''), f.recovery ? 15000 : 6000)
+          refresh()
+        }
+      }, [delDlg, refresh, switchAfterDelete])
+
+      /** 批量清空 + 删除专题：**一次**确认（手输专题名保留在这一步），逐篇走回收站；
+       *  失败由服务端「整体回滚」并把 rollbackFailed 如实带回，这里只按 code 给可读文案。 */
+      const doClearTopic = useCallback(async () => {
+        const d = delDlg
+        if (!d) return
+        setDelDlg(null)
+        try {
+          const r = await api('/library/topic/clear', {
+            method: 'POST', headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ topic: d.name, confirmName: d.name }),
+          })
+          toast(t('clearDone').replace('{topic}', d.name).replace('{papers}', String(r.cleared)).replace('{files}', String(r.movedFiles)), 5000)
+          await switchAfterDelete('topic', d.name, undefined)
+          refresh()
+        } catch (e) {
+          // F-B：clear 失败正是走 409 file-busy + rollbackFailed —— 必须把「文件还在回收站、
+          // 在哪个回收站、怎么恢复」显示出来（只报「文件被占用」会让用户以为文献丢了）。
+          const f = clearFailureText(e, t)
+          toast(t('delFail') + '：' + f.text + (f.recovery ? '　' + f.recovery : ''), f.recovery ? 15000 : 8000)
+          refresh()
+        }
+      }, [delDlg, refresh, switchAfterDelete])
+
+      const doDeleteTopic = useCallback(async () => {
+        const d = delDlg
+        if (!d) return
+        setDelDlg(null)
+        try {
+          await api('/library/delete-topic', {
+            method: 'POST', headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ name: d.name, confirmName: d.name }),
+          })
+          toast(t('delDone').replace('{files}', '0'))
+          await switchAfterDelete('topic', d.name, undefined)
+          refresh()
+        } catch (e) {
+          const f = clearFailureText(e, t)
+          toast(t('delFail') + '：' + f.text + (f.recovery ? '　' + f.recovery : ''), f.recovery ? 15000 : 6000)
+          // 竞态：确认框弹出后该专题又有了文献 → 服务端 409 topic-not-empty 且带 clearEndpoint，
+          // 直接改走「批量清空」中间态（服务端同源清单），不让用户从头再来一次。
+          if (e?.code === 'topic-not-empty' && e?.clearEndpoint) await openDelete('topic', d.name, d.name)
+          refresh()
+        }
+      }, [delDlg, refresh, switchAfterDelete, openDelete])
+
+      // 清空确认框里的「会被服务端拦下」提示：清单里的 translation.busy / sessions.running 篇名
+      // （在用户点确认**之前**就提示，而不是等 409）
+      const clearBlockedNames = delDlg?.kind === 'topic-clear'
+        ? (delDlg.plan?.papers ?? []).filter((p) => p.translation?.busy || (p.sessions?.running ?? 0) > 0).map((p) => p.name)
+        : []
+
       // 收起态（rail）：官方契约 —— sidebar.workspaces 在窄栏里只该给一个图标入口，点击请求
       // 宿主展开。整棵树不渲染：塞进 56px 会被挤成竖排文字（实测）。
       // 用 wide === false 而非 !wide：宿主万一没传这个 prop 时按展开态走，即改动前的行为。
@@ -900,7 +1175,6 @@ window.__ModuleLoader__.load({
                 h('button', { type: 'button', style: S.linkBtn, onClick: newTopic }, '＋ ', t('newTopic')))),
             topics.map((topic) => {
               const isClosed = !!closed[topic]
-              const topicArmed = armDel && armDel.kind === 'topic' && armDel.topic === topic
               return h('div', { key: topic },
                 h('div', {
                   style: S.topicHead, 'data-dpr-row': '',
@@ -921,16 +1195,13 @@ window.__ModuleLoader__.load({
                     onClick: (e) => { e.stopPropagation(); setRenaming({ kind: 'topic', topic }) },
                   }, '✎'),
                   h('button', {
-                    'data-dpr-act': 'del', ...(topicArmed ? { 'data-dpr-armed': '' } : {}),
-                    style: topicArmed ? { ...S.iconBtn, color: 'var(--dsw-alias-state-error-primary, #cf222e)' } : S.iconBtn,
-                    title: t('del'),
-                    onClick: (e) => { e.stopPropagation(); clickDelete('topic', topic, undefined) },
-                  }, topicArmed ? t('delArm') : '🗑'),
+                    'data-dpr-act': 'del', style: S.iconBtn, title: t('delTopic'),
+                    onClick: (e) => { e.stopPropagation(); openDelete('topic', topic, topic) },
+                  }, '🗑'),
                 ),
                 !isClosed && h('div', { style: S.items },
                   papers.filter((p) => p.topic === topic).map((p) => {
                     const isCurrentPaper = cur && cur.topic === p.topic && cur.name === p.name
-                    const paperArmed = armDel && armDel.kind === 'paper' && armDel.topic === p.topic && armDel.name === p.name
                     return h('div', {
                       key: p.name,
                       style: { ...S.item, ...(isCurrentPaper ? S.active : {}) },
@@ -944,18 +1215,18 @@ window.__ModuleLoader__.load({
                         onClick: (e) => { e.stopPropagation(); setRenaming({ kind: 'paper', topic: p.topic, name: p.name }) },
                       }, '✎'),
                       h('button', {
-                        'data-dpr-act': 'del', ...(paperArmed ? { 'data-dpr-armed': '' } : {}),
-                        style: paperArmed ? { ...S.iconBtn, color: 'var(--dsw-alias-state-error-primary, #cf222e)' } : S.iconBtn,
-                        title: t('del'),
-                        onClick: (e) => { e.stopPropagation(); clickDelete('paper', p.topic, p.name) },
-                      }, paperArmed ? t('delArm') : '🗑'))
+                        'data-dpr-act': 'del', style: S.iconBtn, title: t('delPaper'),
+                        onClick: (e) => { e.stopPropagation(); openDelete('paper', p.topic, p.name) },
+                      }, '🗑'))
                   }),
                 ),
               )
             }),
           )
 
-      return h('div', { style: S.root, 'data-dsh-plugin': 'dsh-paper-reader', 'data-dsh-surface': 'sidebar' },
+      return h('div', {
+        style: S.root, 'data-dsh-plugin': 'dsh-paper-reader', 'data-dsh-surface': 'sidebar',
+      },
         h('input', { ref: fileInput, type: 'file', accept: '.pdf', style: { display: 'none' }, onChange: onFile }),
         // 阅读器 iframe 与对话头部按钮组已迁往 shell.overlay 常驻注册（见 applyPaperMode 下方）——
         // 它们不属于侧栏，更不能跟着「退出伴读模式」被卸载（已打开的 PDF 页签要继续活着）
@@ -970,6 +1241,7 @@ window.__ModuleLoader__.load({
             onCancel: () => setAskTopic(false),
           }),
           document.body),
+        // 重命名：上游 v1.3.0 的页内输入弹窗（初始值 = 旧名，走 migrateLsKeys 迁移本地记忆）
         renaming && createPortal(
           h(AskText, {
             title: (renaming.kind === 'topic' ? t('renameTopic') : t('renamePaper')) + '：',
@@ -983,6 +1255,43 @@ window.__ModuleLoader__.load({
             onCancel: () => setRenaming(null),
           }),
           document.body),
+        // 删除：确认框必须列出服务端给的清单；专题删除还要输入专题名
+        delDlg && createPortal(
+          h(ConfirmDelete, {
+            title: delDlg.kind === 'topic-clear'
+              ? t('delTopicClearTitle').replace('{topic}', delDlg.topic)
+              : `${t('delConfirmTitle')} · ${delDlg.kind === 'paper' ? delDlg.name : delDlg.topic}`,
+            body: delDlg.kind === 'topic-clear'
+              ? t('delTopicClearBody')
+                  .replace('{papers}', String(delDlg.plan.papersCount))
+                  .replace('{files}', String(delDlg.plan.filesCount))
+                  .replace('{size}', fmtBytes(delDlg.plan.totalBytes))
+              : delDlg.kind === 'paper' && delDlg.plan
+                ? t('delConfirmBody').replace('{files}', String(delDlg.plan.files.length)).replace('{size}', fmtBytes(delDlg.plan.totalBytes))
+                : t('delTopicTypeName').replace('{name}', delDlg.name),
+            detail: delDlg.kind === 'topic-clear'
+              // 逐篇列出清单（服务端同源）：篇名 — k 个文件 · 大小，再跟该篇的产物文件名
+              ? delDlg.plan.papers.map((p) => `· ${p.name} — ${t('delTopicClearFiles').replace('{n}', String(p.files.length))} · ${fmtBytes(p.totalBytes)}\n    ${p.files.map((f) => f.name).join('、')}`).join('\n')
+              : delDlg.kind === 'paper' && delDlg.plan
+                ? delDlg.plan.files.map((f) => `· ${f.name}  ${fmtBytes(f.bytes)}`).join('\n')
+                : null,
+            // R4-F4：清单必须与服务端同源——用 delete-plan 返回的 notDeleted 派生出文案，
+            // 不再用本地 i18n 硬编码（那份已经与契约漂移了）。专题删除没有 plan，保留本地兜底文案。
+            notDeleted: delDlg.kind === 'topic-clear'
+              ? [Array.isArray(delDlg.plan.notDeleted) ? delDlg.plan.notDeleted.join(' · ') : '',
+                 clearBlockedNames.length ? t('delTopicClearBlocked').replace('{names}', clearBlockedNames.join('、')) : '',
+                 delDlg.plan.hidden?.length ? t('delTopicClearHidden').replace('{names}', delDlg.plan.hidden.join('、')) : ''].filter(Boolean).join('  ')
+              : delDlg.kind === 'paper' && delDlg.plan && Array.isArray(delDlg.plan.notDeleted)
+                ? delDlg.plan.notDeleted.join(' · ')
+                : t('delNotDeleted'),
+            confirmText: delDlg.kind === 'topic-clear' ? t('delTopicClearConfirm') : delDlg.kind === 'paper' ? t('delToTrash') : t('delTopic'),
+            cancelText: t('cancel'),
+            // 手输专题名确认保留在「批量清空」这一步（与单篇删除同强度，不放松）
+            requireText: delDlg.kind === 'paper' ? undefined : delDlg.name,
+            onConfirm: delDlg.kind === 'topic-clear' ? doClearTopic : delDlg.kind === 'paper' ? doDeletePaper : doDeleteTopic,
+            onCancel: () => setDelDlg(null),
+          }),
+          document.body),
       )
     }
 
@@ -1115,10 +1424,120 @@ window.__ModuleLoader__.load({
           path: '/typesafe/config', title: t('setRerankTitle'), desc: t('setRerankDesc'), optional: true,
           baseUrlPlaceholder: 'https://api.typesafe.ai', modelPlaceholder: 'jev-latest', keyPlaceholder: 'ts-...',
         }),
+        h(EndpointCard, {
+          path: '/embed/config', title: t('setEmbedTitle'), desc: t('setEmbedDesc'), optional: true,
+          baseUrlPlaceholder: 'https://api.openai.com/v1', modelPlaceholder: 'text-embedding-3-small', keyPlaceholder: 'sk-...',
+        }),
         h(EndpointCard, {
           path: '/translate/config', title: t('setTranslateTitle'), desc: t('setTranslateDesc'),
           baseUrlPlaceholder: 'https://api.deepseek.com/v1', modelPlaceholder: 'deepseek-chat', keyPlaceholder: 'sk-...',
         }),
+        h(MineruCard, null),
+      )
+    }
+
+    /* ---------- MinerU 卡片：模式 + 本地/云端参数 + 保存前预检 ---------- */
+    function MineruCard() {
+      const [cfg, setCfg] = useState(null)
+      const [form, setForm] = useState({ mode: 'off', baseUrl: '', backend: 'pipeline', effort: 'medium', parseMethod: 'auto', apiKey: '', cloudApiKey: '' })
+      const [busy, setBusy] = useState(false)
+      const [msg, setMsg] = useState(null) // { ok, text }
+      const load = useCallback(() => {
+        api('/mineru/config').then((d) => {
+          setCfg(d)
+          setForm({
+            mode: d.mode || 'off',
+            baseUrl: d.local?.baseUrl || '',
+            backend: d.local?.backend || 'pipeline',
+            effort: d.local?.effort || 'medium',
+            parseMethod: d.local?.parseMethod || 'auto',
+            apiKey: '',
+            cloudApiKey: '',
+          })
+        }).catch((e) => setMsg({ ok: false, text: String(e.message || e) }))
+      }, [])
+      useEffect(load, [load])
+      const sourceText = !cfg ? '' : { file: t('setSourceFile'), profile: t('setSourceProfile'), env: t('setSourceEnv'), none: t('setSourceNone') }[cfg.source] || ''
+      const payload = () => ({
+        mode: form.mode,
+        local: { baseUrl: form.baseUrl, backend: form.backend, effort: form.effort, parseMethod: form.parseMethod, apiKey: form.apiKey },
+        cloud: { apiKey: form.cloudApiKey },
+      })
+      const save = async () => {
+        setBusy(true); setMsg(null)
+        try {
+          await api('/mineru/config', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(payload()) })
+          setMsg({ ok: true, text: t('setSaved') })
+          load()
+        } catch (e) { setMsg({ ok: false, text: String(e.message || e) }) } finally { setBusy(false) }
+      }
+      const clear = async () => {
+        setBusy(true); setMsg(null)
+        try {
+          await api('/mineru/config', { method: 'DELETE' })
+          setMsg({ ok: true, text: t('setCleared') })
+          load()
+        } catch (e) { setMsg({ ok: false, text: String(e.message || e) }) } finally { setBusy(false) }
+      }
+      const testConn = async () => {
+        setBusy(true); setMsg(null)
+        try {
+          const d = await api('/mineru/test', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(payload()) })
+          setMsg({ ok: d.reachable, text: d.reachable ? t('setMineruHealthOk') : (t('setMineruHealthFail') + (d.error ? ': ' + d.error : '')) })
+        } catch (e) { setMsg({ ok: false, text: String(e.message || e) }) } finally { setBusy(false) }
+      }
+      const field = (key, label, placeholder, type) => h('div', null,
+        h('label', { style: SET.label }, label),
+        h('input', {
+          style: SET.input, type: type || 'text', value: form[key], placeholder, disabled: busy,
+          onChange: (e) => setForm({ ...form, [key]: e.target.value }),
+        }),
+      )
+      const select = (key, label, options) => h('div', null,
+        h('label', { style: SET.label }, label),
+        h('select', {
+          style: SET.input, value: form[key], disabled: busy,
+          onChange: (e) => setForm({ ...form, [key]: e.target.value }),
+        }, options.map((o) => h('option', { value: o.value, key: o.value }, o.label))),
+      )
+      return h('div', { style: SET.card, 'data-dsh-plugin': 'dsh-paper-reader', 'data-dsh-part': 'settings-card' },
+        h('h3', { style: SET.title }, t('setMineruTitle')),
+        h('p', { style: SET.desc }, t('setMineruDesc')),
+        // 激活门槛人话（上游评审第 7 条）：说清「什么时候需要 + 配好之后入口出现在哪」，
+        // 并按当前模式给一句取舍；「关闭」时明确 pdf.js 与 MinerU 各自能干什么（不夸大）。
+        h('p', { style: SET.desc }, t('setMineruWhy')),
+        h('p', { style: SET.meta },
+          form.mode === 'local' ? t('setMineruWhyLocal') : form.mode === 'cloud' ? t('setMineruWhyCloud') : t('setMineruOffHint')),
+        select('mode', t('setMineruMode'), [
+          { value: 'off', label: t('setMineruModeOff') },
+          { value: 'local', label: t('setMineruModeLocal') },
+          { value: 'cloud', label: t('setMineruModeCloud') },
+        ]),
+        field('baseUrl', t('setMineruLocalUrl'), 'http://127.0.0.1:8000'),
+        select('backend', t('setMineruBackend'), [
+          { value: 'pipeline', label: 'pipeline' },
+          { value: 'hybrid-engine', label: 'hybrid-engine' },
+          { value: 'vlm-engine', label: 'vlm-engine' },
+          { value: 'vlm-http-client', label: 'vlm-http-client' },
+          { value: 'hybrid-http-client', label: 'hybrid-http-client' },
+        ]),
+        select('parseMethod', t('setMineruParseMethod'), [
+          { value: 'auto', label: 'auto' },
+          { value: 'txt', label: 'txt' },
+          { value: 'ocr', label: 'ocr' },
+        ]),
+        select('effort', t('setMineruEffort'), [
+          { value: 'medium', label: 'medium' },
+          { value: 'high', label: 'high' },
+        ]),
+        field('apiKey', t('setMineruLocalKey'), cfg?.local?.hasApiKey ? t('setKeyKeep') + cfg.local.apiKeyHint : '', 'password'),
+        field('cloudApiKey', t('setMineruCloudKey'), cfg?.cloud?.hasApiKey ? t('setKeyKeep') + cfg.cloud.apiKeyHint : 'mineru.net token', 'password'),
+        h('div', { style: SET.row },
+          h('button', { type: 'button', style: SET.btn, disabled: busy, onClick: save }, busy ? t('setSaving') : t('setSave')),
+          h('button', { type: 'button', style: SET.btnGhost, disabled: busy, onClick: testConn }, t('setMineruTestConnection')),
+          cfg?.source === 'file' ? h('button', { type: 'button', style: SET.btnGhost, disabled: busy, onClick: clear }, t('setClear')) : null,
+          msg ? h('span', { style: msg.ok ? SET.ok : SET.err }, msg.text) : h('span', { style: SET.meta }, sourceText),
+        ),
       )
     }
 
@@ -1146,9 +1565,9 @@ window.__ModuleLoader__.load({
             const styleEl = document.createElement('style')
             styleEl.id = 'dpr-surface-css'
             styleEl.textContent = '[data-dpr-rail]:hover,[data-dpr-mode]:hover{background:var(--dsw-alias-interactive-bg-hover)!important}'
-              // 树行内的 ✎🗑 操作按钮：默认隐身，行悬停才现身（两段式删除的待确认态常亮）
+              // 树行内的 ✎🗑 操作按钮：默认隐身，行悬停才现身（不再有「待确认态常亮」的 armed 状态）
               + '[data-dpr-act]{opacity:0!important;transition:opacity .12s}'
-              + '[data-dpr-row]:hover [data-dpr-act],[data-dpr-armed]{opacity:1!important}'
+              + '[data-dpr-row]:hover [data-dpr-act]{opacity:1!important}'
             document.head.appendChild(styleEl)
           }