dsh-ai-book-shelf 2.6.9 → 2.6.15

package/README.md

@@ -1,19 +1,31 @@
 # AI Book Shelf / AI 书架
 
 [![GitHub](https://img.shields.io/badge/GitHub-0avatar0%2Fdsh--ai--book--shelf-181717?logo=github)](https://github.com/0avatar0/dsh-ai-book-shelf)
-[![Release](https://img.shields.io/badge/release-v2.6.9-2ea44f)](https://github.com/0avatar0/dsh-ai-book-shelf/releases/tag/v2.6.9)
+[![Release](https://img.shields.io/badge/release-v2.6.15-2ea44f)](https://github.com/0avatar0/dsh-ai-book-shelf/releases/tag/v2.6.15)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
 A persistent DSH Web UI plugin that adds a full-page multi-format reader to the
-sidebar and an AI explanation rail for selected text. It also includes a
-separate paper library with paragraph/whole-paper translation and bilingual
-comparison.
+sidebar, an AI explanation rail for selected text, a paper library with
+translation and bilingual comparison, and a dossier library with searchable
+files and AI summaries.
+
+## Highlights
+
+- **Read many formats** — EPUB, PDF, TXT, Markdown, HTML, FB2 and DOCX.
+- **Ask without leaving the page** — select text for background, context,
+  explanations and follow-ups in the right rail.
+- **Search the whole shelf** — full-book `Ctrl+F`, online book search (Project
+  Gutenberg, Standard Ebooks, Chinese Wikimedia sources) and custom OPDS sources.
+- **Paper mode** — paragraph/whole-paper translation, bilingual comparison, AI
+  explanations and follow-ups.
+- **Dossier mode** — folders, Ctrl+A multi-import, keyword search, AI summaries
+  of results, and per-folder skills.
 
 ## Install
 
-1. Download `dsh-ai-book-shelf-2.6.9.tgz` from the
-   [latest release](https://github.com/0avatar0/dsh-ai-book-shelf/releases/tag/v2.6.9),
-   or install from npm with `dsh-ai-book-shelf@2.6.9`.
+1. Download `dsh-ai-book-shelf-2.6.15.tgz` from the
+   [latest release](https://github.com/0avatar0/dsh-ai-book-shelf/releases/tag/v2.6.15),
+   or install from npm with `dsh-ai-book-shelf@2.6.15`.
 2. In DSH open **Plugins → Add plugin** and choose the downloaded tgz, or paste
    the npm package spec.
 3. Reload the plugin and open **AI 书架 / AI Book Shelf** in the sidebar.
@@ -31,8 +43,9 @@ instructions: [PUBLISHING.md](PUBLISHING.md).
   a name collision gets a ` (2)` suffix rather than overwriting anything.
 - **Dossier mode** — a separate dossier library with folders, multi-select
   import (Ctrl/Cmd or Ctrl+A in the file picker), folder-scoped full-text
-  search, streamed AI summaries, and folder skills. A Markdown file named
-  Creating a folder adds an empty skill you can fill in; an imported `SKILL.md` can replace it, and AI summaries follow it.
+  search, streamed AI summaries, and folder skills. Creating a folder adds an
+  empty skill you can fill in; an imported `SKILL.md` can replace it, and AI
+  summaries follow it.
 - **Public-domain search** — the **Search books** tab queries Project Gutenberg
   (Gutendex, with the Gutenberg website search as a fallback), a Chinese-only
   Project Gutenberg catalog (`lang=zh`), Chinese Wikisource, Chinese Wikibooks,

package/client.js

@@ -218,6 +218,22 @@ window.__ModuleLoader__.load({
       'reader.next': '下一章',
       'reader.fontSmaller': '减小字号',
       'reader.fontLarger': '放大字号',
+      'reader.zoomHint': 'Ctrl / ⌘ + 鼠标滚轮调整字号',
+      'reader.zoomHintShort': '+ 滚轮',
+      'settings.title': '存储与目录',
+      'settings.booksDir': '书籍目录',
+      'settings.papersDir': '论文存放目录',
+      'settings.dossiersDir': '卷宗存放目录',
+      'settings.hint': '留空使用默认路径。修改后返回对应模式重新加载；现有文件不会自动移动。',
+      'settings.choose': '选择路径',
+      'settings.save': '保存',
+      'settings.cancel': '取消',
+      'reader.settings': '阅读设置',
+      'reader.booksDir': '书籍目录',
+      'reader.booksDirHint': '修改后书架会扫描并优先保存到这个目录；留空使用默认目录：{path}',
+      'reader.settingsSaved': '书籍目录已保存，返回书架后生效',
+      'reader.save': '保存',
+      'reader.cancel': '取消',
       'reader.ai': 'AI 解释',
       'reader.find': '全书搜索',
       'reader.findPlaceholder': '搜索全书文字…',
@@ -466,6 +482,22 @@ window.__ModuleLoader__.load({
       'reader.next': 'Next chapter',
       'reader.fontSmaller': 'Smaller text',
       'reader.fontLarger': 'Larger text',
+      'reader.zoomHint': 'Ctrl / ⌘ + mouse wheel to resize text',
+      'reader.zoomHintShort': '+ wheel',
+      'settings.title': 'Storage folders',
+      'settings.booksDir': 'Books folder',
+      'settings.papersDir': 'Papers folder',
+      'settings.dossiersDir': 'Dossiers folder',
+      'settings.hint': 'Leave empty for the default path. Reload the matching mode after saving; existing files are not moved.',
+      'settings.choose': 'Choose',
+      'settings.save': 'Save',
+      'settings.cancel': 'Cancel',
+      'reader.settings': 'Reader settings',
+      'reader.booksDir': 'Books folder',
+      'reader.booksDirHint': 'The shelf scans and saves books here. Leave empty for the default: {path}',
+      'reader.settingsSaved': 'Books folder saved; return to the shelf to apply',
+      'reader.save': 'Save',
+      'reader.cancel': 'Cancel',
       'reader.ai': 'Explain',
       'reader.find': 'Find in book',
       'reader.findPlaceholder': 'Search the whole book…',
@@ -580,6 +612,8 @@ window.__ModuleLoader__.load({
 .epub-library-inner { width: min(100%, 1200px); margin: 0 auto; }
 .epub-library-head { display: flex; align-items: flex-start; justify-content: space-between; gap: 24px; flex-wrap: wrap; }
 .epub-brand { display: flex; align-items: center; gap: 15px; min-width: 0; }
+.epub-brand-settings { display: grid; place-items: center; width: 34px; height: 34px; flex: none; margin-left: 8px; border: 1px solid var(--epub-line); border-radius: 8px; background: var(--epub-surface); color: var(--epub-muted); }
+.epub-brand-settings:hover { color: var(--epub-text); border-color: var(--epub-line-strong); background: var(--epub-surface-2); }
 .epub-brand-mark {
   width: 52px; height: 52px; flex: none; border-radius: 16px;
   display: grid; place-items: center;
@@ -762,6 +796,18 @@ window.__ModuleLoader__.load({
 .epub-reader-book-title { font-size: 13.5px; line-height: 1.4; font-weight: 650; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
 .epub-reader-book-sub { margin-top: 2px; color: var(--epub-muted); font-size: 10.5px; line-height: 1.4; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
 .epub-reader-head-right { display: flex; align-items: center; gap: 7px; flex: none; }
+.epub-zoom-hint { display: inline-flex; align-items: center; gap: 2px; color: var(--epub-muted); font-size: 8.5px; white-space: nowrap; }
+.epub-reader-settings { width: min(560px, 100%); padding: 16px; border: 1px solid var(--epub-line-strong); border-radius: 13px; background: var(--epub-surface); box-shadow: 0 22px 60px -18px rgba(0,0,0,.6); }
+.epub-reader-settings header { display: flex; align-items: flex-start; justify-content: space-between; gap: 8px; margin-bottom: 12px; }
+.epub-reader-settings h3 { margin: 2px 0 0; font-size: 15px; }
+.epub-reader-settings-row { margin-bottom: 9px; }
+.epub-reader-settings-label { display: block; margin-bottom: 5px; color: var(--epub-muted); font-size: 9px; text-transform: uppercase; letter-spacing: .06em; }
+.epub-reader-settings-path { display: flex; align-items: center; gap: 6px; }
+.epub-reader-settings-path .epub-reader-settings-input { flex: 1; min-width: 0; }
+.epub-reader-settings-input { width: 100%; height: 34px; padding: 0 9px; border: 1px solid var(--epub-line); border-radius: 7px; outline: 0; background: var(--dsw-alias-bg-base); color: var(--epub-text); font-size: 11px; }
+.epub-reader-settings-input:focus { border-color: color-mix(in srgb, var(--epub-accent) 45%, var(--epub-line)); }
+.epub-reader-settings-hint { margin: 7px 0 0; color: var(--epub-muted); font-size: 9px; line-height: 1.55; overflow-wrap: anywhere; }
+.epub-reader-settings-error { margin: 8px 0 0; color: var(--epub-danger); font-size: 9.5px; line-height: 1.5; }
 .epub-kbd { margin-left: 3px; padding: 1px 4px; border: 1px solid var(--epub-line); border-radius: 4px; color: var(--epub-muted); font-family: inherit; font-size: 8.5px; font-weight: 500; line-height: 1.4; }
 .epub-find-panel { position: absolute; top: 68px; right: 18px; z-index: 45; display: flex; flex-direction: column; width: min(430px, calc(100% - 36px)); max-height: min(520px, calc(100% - 90px)); border: 1px solid var(--epub-line-strong); border-radius: 12px; background: var(--epub-surface); box-shadow: 0 18px 45px -18px rgba(0,0,0,.55); overflow: hidden; }
 .epub-find-head { display: flex; align-items: center; gap: 8px; padding: 10px; border-bottom: 1px solid var(--epub-line); }
@@ -1092,6 +1138,7 @@ window.__ModuleLoader__.load({
   .epub-dossier-search input { width: 100%; min-width: 0; }
   .epub-dossier-grid { grid-template-columns: 1fr; }
   .epub-dossier-summary { max-height: 88vh; }
+  .epub-zoom-hint { display: none; }
   .epub-paper-folders { display: flex; gap: 4px; overflow-x: auto; border-right: 0; border-bottom: 1px solid var(--epub-line); }
   .epub-paper-folder-wrap { flex: none; }
   .epub-paper-folder-top { flex: none; }
@@ -1680,6 +1727,13 @@ window.__ModuleLoader__.load({
       return iconBase(props ?? {}, [h('path', { key: 'a', d: 'M12 5v14M5 12h14' })])
     }
 
+    function IconSettings(props) {
+      return iconBase(props ?? {}, [
+        h('circle', { key: 'a', cx: 12, cy: 12, r: 3.2 }),
+        h('path', { key: 'b', d: 'M12.22 2h-.44a2 2 0 0 0-2 2v.18a2 2 0 0 1-1 1.73l-.43.25a2 2 0 0 1-2 0l-.15-.08a2 2 0 0 0-2.73.73l-.22.38a2 2 0 0 0 .73 2.73l.15.09a2 2 0 0 1 1 1.74v.51a2 2 0 0 1-1 1.74l-.15.09a2 2 0 0 0-.73 2.73l.22.38a2 2 0 0 0 2.73.73l.15-.08a2 2 0 0 1 2 0l.43.25a2 2 0 0 1 1 1.73V20a2 2 0 0 0 2 2h.44a2 2 0 0 0 2-2v-.18a2 2 0 0 1 1-1.73l.43-.25a2 2 0 0 1 2 0l.15.08a2 2 0 0 0 2.73-.73l.22-.38a2 2 0 0 0-.73-2.73l-.15-.09a2 2 0 0 1-1-1.74v-.51a2 2 0 0 1 1-1.74l.15-.09a2 2 0 0 0 .73-2.73l-.22-.38a2 2 0 0 0-2.73-.73l-.15.08a2 2 0 0 1-2 0l-.43-.25a2 2 0 0 1-1-1.73V4a2 2 0 0 0-2-2z' }),
+      ])
+    }
+
     function IconStopCircle(props) {
       return iconBase(props ?? {}, [
         h('circle', { key: 'a', cx: 12, cy: 12, r: 8.5 }),
@@ -1903,6 +1957,12 @@ window.__ModuleLoader__.load({
       const [dragOver, setDragOver] = React.useState(false)
       const [showHidden, setShowHidden] = React.useState(false)
       const [bookMenu, setBookMenu] = React.useState(null)
+      const [settingsOpen, setSettingsOpen] = React.useState(false)
+      const [settings, setSettings] = React.useState({ booksDir: '', papersDir: '', dossiersDir: '' })
+      const [settingsDefaults, setSettingsDefaults] = React.useState({ booksDir: '', papersDir: '', dossiersDir: '' })
+      const [settingsSaving, setSettingsSaving] = React.useState(false)
+      const [settingsPicking, setSettingsPicking] = React.useState('')
+      const [settingsError, setSettingsError] = React.useState('')
       const fileRef = React.useRef(null)
 
       React.useEffect(() => {
@@ -2008,6 +2068,60 @@ window.__ModuleLoader__.load({
         await importFiles([file])
       }
 
+      async function openSettings() {
+        setSettingsOpen(true)
+        setSettingsError('')
+        try {
+          const data = await apiGet('/settings')
+          setSettings({
+            booksDir: data.booksDir ?? '',
+            papersDir: data.papersDir ?? '',
+            dossiersDir: data.dossiersDir ?? '',
+          })
+          setSettingsDefaults({
+            booksDir: data.defaultDir ?? '',
+            papersDir: data.defaultPapersDir ?? '',
+            dossiersDir: data.defaultDossiersDir ?? '',
+          })
+        } catch (reason) {
+          setSettingsError(reason instanceof Error ? reason.message : String(reason))
+        }
+      }
+
+      async function chooseSettingsPath(field) {
+        setSettingsPicking(field)
+        setSettingsError('')
+        try {
+          const data = await apiPost('/settings/pick', {})
+          if (typeof data.path === 'string' && data.path !== '') {
+            setSettings((current) => ({ ...current, [field]: data.path }))
+          }
+        } catch (reason) {
+          setSettingsError(reason instanceof Error ? reason.message : String(reason))
+        } finally {
+          setSettingsPicking('')
+        }
+      }
+
+      async function saveSettings() {
+        setSettingsSaving(true)
+        setSettingsError('')
+        try {
+          const data = await apiPost('/settings', settings)
+          setSettings({
+            booksDir: data.booksDir ?? '',
+            papersDir: data.papersDir ?? '',
+            dossiersDir: data.dossiersDir ?? '',
+          })
+          setSettingsOpen(false)
+          await load()
+        } catch (reason) {
+          setSettingsError(reason instanceof Error ? reason.message : String(reason))
+        } finally {
+          setSettingsSaving(false)
+        }
+      }
+
       function saveSourcePrefs(next) {
         setSourcePrefs(next)
         writeSourcePrefs(next)
@@ -2175,6 +2289,7 @@ window.__ModuleLoader__.load({
                 h('p', { className: 'epub-subtitle' }, t('library.subtitle')),
                 h('p', { className: 'epub-formats' }, t('library.supportedFormats')),
               ),
+              h('button', { type: 'button', className: 'epub-brand-settings', onClick: () => void openSettings(), title: t('settings.title'), 'aria-label': t('settings.title') }, h(IconSettings, { size: 20 })),
             ),
             h(
               'div',
@@ -2466,7 +2581,32 @@ window.__ModuleLoader__.load({
                           })),
                         ),
               ),
-          bookMenu !== null
+          settingsOpen
+          ? h('div', { className: 'epub-dialog-backdrop', onMouseDown: (event) => { if (event.target === event.currentTarget) setSettingsOpen(false) } },
+              h('section', { className: 'epub-reader-settings' },
+                h('header', null,
+                  h('div', null, h('p', { className: 'epub-eyebrow' }, 'STORAGE'), h('h3', null, t('settings.title'))),
+                  h('button', { type: 'button', className: 'epub-icon-btn', onClick: () => setSettingsOpen(false), title: t('reader.close') }, h(IconX, { size: 16 })),
+                ),
+                [['booksDir', t('settings.booksDir'), settingsDefaults.booksDir], ['papersDir', t('settings.papersDir'), settingsDefaults.papersDir], ['dossiersDir', t('settings.dossiersDir'), settingsDefaults.dossiersDir]].map(([field, label, placeholder]) =>
+                  h('div', { className: 'epub-reader-settings-row', key: field },
+                    h('label', { className: 'epub-reader-settings-label' }, label),
+                    h('div', { className: 'epub-reader-settings-path' },
+                      h('input', { className: 'epub-reader-settings-input', value: settings[field], placeholder, onChange: (event) => setSettings({ ...settings, [field]: event.target.value }) }),
+                      h('button', { type: 'button', className: 'epub-btn', disabled: settingsPicking !== '', onClick: () => void chooseSettingsPath(field) }, settingsPicking === field ? '…' : t('settings.choose')),
+                    ),
+                  ),
+                ),
+                h('p', { className: 'epub-reader-settings-hint' }, t('settings.hint')),
+                settingsError !== '' ? h('p', { className: 'epub-reader-settings-error' }, settingsError) : null,
+                h('div', { className: 'epub-dialog-actions' },
+                  h('button', { type: 'button', className: 'epub-btn', onClick: () => setSettingsOpen(false) }, t('settings.cancel')),
+                  h('button', { type: 'button', className: 'epub-btn epub-btn-primary', onClick: () => void saveSettings(), disabled: settingsSaving }, settingsSaving ? '…' : t('settings.save')),
+                ),
+              ),
+            )
+          : null,
+        bookMenu !== null
             ? h('div', { className: 'epub-context-menu', style: { left: `${bookMenu.x}px`, top: `${bookMenu.y}px` }, onClick: (event) => event.stopPropagation() },
                 h('button', { type: 'button', className: 'epub-context-item', onClick: () => { const selected = bookMenu.book; setBookMenu(null); void toggleHidden(selected) } }, bookMenu.book.hidden === true ? t('library.unhide') : t('library.hide')),
                 h('button', {
@@ -4818,6 +4958,7 @@ window.__ModuleLoader__.load({
               h('button', { type: 'button', onClick: () => updateFont(-1), title: t('reader.fontSmaller'), 'aria-label': t('reader.fontSmaller') }, h(IconMinus, { size: 13 })),
               h('button', { type: 'button', onClick: () => updateFont(1), title: t('reader.fontLarger'), 'aria-label': t('reader.fontLarger') }, h(IconPlus, { size: 13 })),
             ),
+            h('span', { className: 'epub-zoom-hint', title: t('reader.zoomHint') }, h('kbd', { className: 'epub-kbd' }, 'Ctrl'), t('reader.zoomHintShort')),
             h('button', { type: 'button', className: cn('epub-ghost-btn', tocOpen && 'is-active'), onClick: () => setTocOpen((value) => !value), title: t('reader.toc'), 'aria-label': t('reader.toc') }, h(IconList, { size: 15 }), h('span', null, t('reader.toc'))),
             h('button', { type: 'button', className: 'epub-ai-trigger', onClick: () => setAi((current) => ({ ...current, open: !current.open })), title: t('reader.ai'), 'aria-label': t('reader.ai') }, h(IconSparkles, { size: 15 }), h('span', null, t('reader.ai'))),
           ),

package/index.js

@@ -7,7 +7,7 @@
  * credential.
  */
 import { createHash } from 'node:crypto'
-import { promises as fs } from 'node:fs'
+import { promises as fs, readFileSync } from 'node:fs'
 import path from 'node:path'
 import { BookError, EpubError, parseBook } from './lib/books.js'
 import { stripTags } from './lib/sanitize.js'
@@ -24,6 +24,9 @@ const MAX_SCAN_DEPTH = 6
 const BOOK_EXTENSIONS = new Set([
   '.epub', '.pdf', '.txt', '.text', '.md', '.markdown', '.html', '.htm', '.xhtml', '.fb2', '.docx',
 ])
+let activeBooksDir = ''
+let activePapersDir = ''
+let activeDossiersDir = ''
 const SEARCH_TTL_MS = 30 * 60 * 1000
 const MAX_SEARCH_RESULTS = 24
 const DOWNLOAD_TIMEOUT_MS = 180_000
@@ -167,7 +170,7 @@ function firstWorkspaceRoot(ctx) {
   return process.cwd()
 }
 
-function resolveArchiveDir(config, ctx) {
+function defaultArchiveDir(config, ctx) {
   const configuredArchive = typeof config?.archiveDir === 'string' ? config.archiveDir.trim() : ''
   if (configuredArchive !== '') return path.resolve(configuredArchive)
   const configured = configuredLibraryDirs(config)
@@ -178,11 +181,19 @@ function resolveArchiveDir(config, ctx) {
   return path.resolve(firstWorkspaceRoot(ctx))
 }
 
+function resolveArchiveDir(config, ctx) {
+  return defaultArchiveDir(config, ctx)
+}
+
+function resolveBooksDir(config, ctx) {
+  return activeBooksDir !== '' ? path.resolve(activeBooksDir) : defaultArchiveDir(config, ctx)
+}
+
 function normalizeRoots(config, ctx) {
   const configured = configuredLibraryDirs(config)
   // Scan only the archive shelf by default. External books enter the shelf
   // through Open EPUB, which copies them into the archive before opening.
-  if (configured.length === 0) configured.push(resolveArchiveDir(config, ctx))
+  if (configured.length === 0) configured.push(resolveBooksDir(config, ctx))
   const unique = []
   for (const root of configured) {
     const resolved = path.resolve(root)
@@ -231,6 +242,37 @@ async function ensureArchiveDir(config, ctx) {
   }
 }
 
+async function ensureBooksDir(config, ctx) {
+  const directory = resolveBooksDir(config, ctx)
+  try {
+    await fs.mkdir(directory, { recursive: true })
+    return await fs.realpath(directory)
+  } catch (error) {
+    throw new HttpError(500, 'BOOKS_DIR_UNAVAILABLE', `无法创建书籍目录 ${directory}：${publicErrorMessage(error)}`)
+  }
+}
+
+function readerSettingsPath(config, ctx) {
+  return path.join(defaultArchiveDir(config, ctx), ANNOTATION_DIRECTORY, 'settings.json')
+}
+
+function readReaderSettingsSync(config, ctx) {
+  try {
+    const value = JSON.parse(readFileSync(readerSettingsPath(config, ctx), 'utf8'))
+    return value !== null && typeof value === 'object' ? value : {}
+  } catch {
+    return {}
+  }
+}
+
+async function writeReaderSettings(config, ctx, settings) {
+  const file = readerSettingsPath(config, ctx)
+  await fs.mkdir(path.dirname(file), { recursive: true })
+  const temporary = `${file}.${process.pid}.tmp`
+  await fs.writeFile(temporary, `${JSON.stringify(settings, null, 2)}\n`, 'utf8')
+  await fs.rename(temporary, file)
+}
+
 /**
  * Put one EPUB into the archive directory. An identical file already stored
  * under the same name is reused; a name collision with different content gets
@@ -1356,6 +1398,16 @@ async function openModelStream(ctx, route, payload, signal) {
 }
 
 function createHandler(ctx, config) {
+  const savedSettings = readReaderSettingsSync(config, ctx)
+  activeBooksDir = typeof savedSettings.booksDir === 'string' && savedSettings.booksDir.trim() !== ''
+    ? path.resolve(savedSettings.booksDir.trim())
+    : ''
+  activePapersDir = typeof savedSettings.papersDir === 'string' && savedSettings.papersDir.trim() !== ''
+    ? path.resolve(savedSettings.papersDir.trim())
+    : ''
+  activeDossiersDir = typeof savedSettings.dossiersDir === 'string' && savedSettings.dossiersDir.trim() !== ''
+    ? path.resolve(savedSettings.dossiersDir.trim())
+    : ''
   const store = new BookStore(MAX_OPEN_BOOKS)
   let catalog = new Map()
   const searchCache = new Map()
@@ -1438,9 +1490,9 @@ function createHandler(ctx, config) {
       throw new HttpError(500, 'READ_FAILED', `读取失败：${publicErrorMessage(error)}`)
     }
 
-    const archiveDir = await ensureArchiveDir(config, ctx)
-    if (!isInside(archiveDir, entry.path)) {
-      return await ingestBuffer(buffer, entry.name, archiveDir)
+    const booksDir = await ensureBooksDir(config, ctx)
+    if (!isInside(booksDir, entry.path)) {
+      return await ingestBuffer(buffer, entry.name, booksDir)
     }
 
     let book
@@ -1465,7 +1517,7 @@ function createHandler(ctx, config) {
     return { book, copied: false, created: false, copyPath: '' }
   }
 
-  function paperRootFor(archiveDir) { return path.join(archiveDir, '.epub-reader', 'papers') }
+  function paperRootFor(archiveDir) { return activePapersDir !== '' ? path.resolve(activePapersDir) : path.join(archiveDir, '.epub-reader', 'papers') }
 
   async function ensurePaperDirs(archiveDir) {
     const root = paperRootFor(archiveDir)
@@ -1805,7 +1857,7 @@ function createHandler(ctx, config) {
   }
 
   function dossierRootFor(archiveDir) {
-    return path.join(archiveDir, '.epub-reader', 'dossiers')
+    return activeDossiersDir !== '' ? path.resolve(activeDossiersDir) : path.join(archiveDir, '.epub-reader', 'dossiers')
   }
 
   async function ensureDossierDirs(archiveDir) {
@@ -2228,8 +2280,8 @@ function createHandler(ctx, config) {
     }
     const buffer = await readBody(req, MAX_IMPORT_BYTES)
     if (buffer.length === 0) throw new HttpError(400, 'EMPTY_FILE', '没有收到文件内容')
-    const archiveDir = await ensureArchiveDir(config, ctx)
-    return await ingestBuffer(buffer, name, archiveDir)
+    const booksDir = await ensureBooksDir(config, ctx)
+    return await ingestBuffer(buffer, name, booksDir)
   }
 
   function readSearchOptions(url) {
@@ -2331,12 +2383,12 @@ function createHandler(ctx, config) {
         ? lastError
         : new HttpError(502, 'DOWNLOAD_FAILED', '下载失败，请稍后重试')
     }
-    const archiveDir = await ensureArchiveDir(config, ctx)
+    const booksDir = await ensureBooksDir(config, ctx)
     if (downloadFileName === '') {
       const author = item.author === '' ? '' : ` - ${item.author}`
       downloadFileName = `${item.title}${author}.epub`
     }
-    const result = await ingestBuffer(buffer, downloadFileName, archiveDir)
+    const result = await ingestBuffer(buffer, downloadFileName, booksDir)
     return { ...result, source: item.source, sourceName: item.sourceName }
   }
 
@@ -2437,6 +2489,70 @@ function createHandler(ctx, config) {
         return
       }
 
+      if (method === 'GET' && pathname === '/settings') {
+        const base = defaultArchiveDir(config, ctx)
+        sendJson(res, 200, {
+          booksDir: resolveBooksDir(config, ctx),
+          papersDir: activePapersDir !== '' ? activePapersDir : path.join(base, '.epub-reader', 'papers'),
+          dossiersDir: activeDossiersDir !== '' ? activeDossiersDir : path.join(base, '.epub-reader', 'dossiers'),
+          defaultDir: base,
+          defaultPapersDir: path.join(base, '.epub-reader', 'papers'),
+          defaultDossiersDir: path.join(base, '.epub-reader', 'dossiers'),
+        })
+        return
+      }
+
+      if (method === 'POST' && pathname === '/settings/pick') {
+        const picker = ctx.get('directoryPickerController')
+        if (picker === undefined || typeof picker.pick !== 'function') {
+          throw new HttpError(503, 'PICKER_UNAVAILABLE', '当前环境没有可用的目录选择器，请直接输入路径')
+        }
+        await readJson(req)
+        const controller = new AbortController()
+        res.on('close', () => { if (!res.writableEnded) controller.abort() })
+        const selected = await picker.pick(controller.signal)
+        sendJson(res, 200, { path: typeof selected === 'string' ? selected : '' })
+        return
+      }
+
+      if (method === 'POST' && pathname === '/settings') {
+        const payload = await readJson(req)
+        const fields = [
+          ['booksDir', '书籍目录', 'BOOKS_DIR_UNAVAILABLE'],
+          ['papersDir', '论文存放目录', 'PAPERS_DIR_UNAVAILABLE'],
+          ['dossiersDir', '卷宗存放目录', 'DOSSIERS_DIR_UNAVAILABLE'],
+        ]
+        const next = {}
+        for (const [field, label, code] of fields) {
+          if (typeof payload[field] !== 'string') continue
+          const requested = payload[field].trim()
+          if (requested === '') { next[field] = ''; continue }
+          const target = path.resolve(requested)
+          try {
+            await fs.mkdir(target, { recursive: true })
+            next[field] = await fs.realpath(target)
+          } catch (error) {
+            throw new HttpError(400, code, `无法使用${label} ${target}：${publicErrorMessage(error)}`)
+          }
+        }
+        const current = readReaderSettingsSync(config, ctx)
+        await writeReaderSettings(config, ctx, { ...current, ...next })
+        if ('booksDir' in next) activeBooksDir = next.booksDir
+        if ('papersDir' in next) activePapersDir = next.papersDir
+        if ('dossiersDir' in next) activeDossiersDir = next.dossiersDir
+        catalog = new Map()
+        const base = defaultArchiveDir(config, ctx)
+        sendJson(res, 200, {
+          booksDir: resolveBooksDir(config, ctx),
+          papersDir: activePapersDir !== '' ? activePapersDir : path.join(base, '.epub-reader', 'papers'),
+          dossiersDir: activeDossiersDir !== '' ? activeDossiersDir : path.join(base, '.epub-reader', 'dossiers'),
+          defaultDir: base,
+          defaultPapersDir: path.join(base, '.epub-reader', 'papers'),
+          defaultDossiersDir: path.join(base, '.epub-reader', 'dossiers'),
+        })
+        return
+      }
+
       if (method === 'GET' && pathname === '/books') {
         const roots = normalizeRoots(config, ctx)
         const result = await scanLibrary(roots)

package/locale/en.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "AI Book Shelf",
-    "description": "AI Book Shelf: read books and papers, search full text, ask AI with follow-ups, and translate papers side by side."
-  }
-}
+{
+  "meta": {
+    "title": "AI Book Shelf",
+    "description": "AI Book Shelf: read EPUB, PDF, TXT, Markdown, HTML, FB2 and DOCX; select text for one-click background and explanations, then follow up without leaving the page; full-book search, online book search and custom sources; paper mode with translation, bilingual compare, explanations and follow-ups; dossier mode with batch import, keyword search, AI summaries and skills."
+  }
+}

package/locale/zh.json

@@ -1,6 +1,6 @@
-{
-  "meta": {
-    "title": "AI 书架",
-    "description": "AI 书架：阅读 EPUB/PDF 与论文，全文搜索、AI 解释与追问、论文翻译和中英对照。"
-  }
-}
+{
+  "meta": {
+    "title": "AI 书架",
+    "description": "AI 书架：支持 EPUB、PDF、TXT、Markdown、HTML、FB2、DOCX 阅读；选中文字即可一键获取背景解释、作者省略的解释并继续追问，无需切换界面；支持全文搜索、在线搜书和自定义书源；论文模式支持翻译、中英对照、解释与追问；卷宗模式支持批量导入、关键词搜索、AI 总结搜索结果和 Skill。"
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-ai-book-shelf",
-  "version": "2.6.9",
-  "description": "AI Book Shelf: read books and papers in Harness, search full text, explain and discuss with AI, translate papers and compare bilingual text.",
+  "version": "2.6.15",
+  "description": "AI Book Shelf: read EPUB, PDF, TXT, Markdown, HTML, FB2 and DOCX; select text for one-click background and explanations, then follow up without leaving the page; full-book search, online book search and custom sources; paper mode with translation, bilingual compare, explanations and follow-ups; dossier mode with batch import, keyword search, AI summaries and skills.",
   "keywords": [
     "dsh-plugin",
     "ai-book-shelf",
@@ -12,7 +12,13 @@
     "pdf",
     "reader",
     "ai",
-    "deepseek-harness"
+    "deepseek-harness",
+    "dossier",
+    "dossier-mode",
+    "case-file",
+    "online-book-search",
+    "custom-opds",
+    "full-text-search"
   ],
   "repository": {
     "type": "git",