diff --git a/plugins/hushreader/.gitignore b/plugins/hushreader/.gitignore
index eb8e7331..e0b713c9 100644
--- a/plugins/hushreader/.gitignore
+++ b/plugins/hushreader/.gitignore
@@ -1,4 +1,6 @@
 node_modules
 dist
 **/*.zip
-test
\ No newline at end of file
+test
+功能说明文档.md
+docs/
diff --git a/plugins/hushreader/CHANGELOG.md b/plugins/hushreader/CHANGELOG.md
index 76ee9a34..ee7eab6d 100644
--- a/plugins/hushreader/CHANGELOG.md
+++ b/plugins/hushreader/CHANGELOG.md
@@ -1,6 +1,34 @@
 # Changelog
 
 All notable changes to this project will be documented in this file.
+
+## [1.4.0](https://github.com/me1dlinger/hushreader/releases/tag/v1.4.0) - 2026-06-23
+
+### Added
+- **已读完标记**：读完最后一章时自动标记为"已读完"，书籍卡片封面右上角显示"已读完"角标
+- **标记为未读完**：右键菜单新增"标记为未读完"选项，可清除已读完状态（仅已读完书籍显示）
+- **书架统计栏**：书架顶部新增统计栏，显示总书籍数、已读数、累计阅读时长
+- **书签功能**：隐阅窗口右键菜单新增"添加书签"选项，自动提取当前页首句作为书签内容
+- **书签快捷键**：隐阅窗口支持可配置的添加书签快捷键（默认 Shift+F）
+- **书签列表**：书架书籍右键菜单新增"书签列表"选项，显示日期、阅读进度和内容预览
+- **书签跳转**：双击书签可打开隐阅窗口并跳转到书签位置
+- **书签删除**：书签列表中每条书签支持直接删除，无需确认
+- **销毁隐阅窗口**：新增可配置的销毁快捷键（默认 Shift+D），快速关闭隐阅窗口
+- **全文搜索跳转**：书籍右键菜单新增"搜索跳转"选项，可搜索全书内容，按句子展示结果，支持分页浏览、关键词高亮、双击跳转到对应位置
+- **批量设置分类**：多选模式下新增"批量设置分类"按钮，可统一为选中书籍设置分类
+- **卡片/列表视图切换**：书架头部新增视图切换按钮，支持卡片视图与列表视图一键切换，移除设置界面"其他设置"中的"列表书架模式"开关
+
+### Changed
+- **多选按钮图标**：多选按钮默认图标改为勾选框样式，与视图切换按钮做视觉区分
+- **列表模式已读完标识**：列表模式下已读完标识从封面移至文字信息行，避免挤占小封面空间
+
+### Fixed
+- **阅读百分比无法达到100%**：修复翻到最后一页时百分比达不到100%的问题，最后一页使用页末字符偏移计算进度
+- **恢复封面未删除自定义封面**：修复 TXT 书籍恢复封面时自定义封面未从 IndexedDB 删除，导致重启后仍加载自定义封面的问题
+- **多选模式已读完角标重叠**：修复多选模式下已读完角标与勾选框重叠的问题
+- **搜索 XSS 隐患**：修复全文搜索结果使用 v-html 渲染未转义内容导致的 XSS 安全隐患
+- **搜索性能问题**：修复全文搜索循环中每次迭代重复调用 toLowerCase() 导致大文件 OOM 和卡死的问题，将小写转换提取到循环外并限制句子边界查找窗口
+
 ## [1.3.3](https://github.com/me1dlinger/hushreader/releases/tag/v1.3.3) - 2026-06-19
 
 ### Added
diff --git a/plugins/hushreader/README.md b/plugins/hushreader/README.md
index 534623c2..ad43f9cd 100644
--- a/plugins/hushreader/README.md
+++ b/plugins/hushreader/README.md
@@ -16,25 +16,45 @@
 
 ## 功能一览
 
-| 阅读体验                | 个性化              | 书架管理              |
-| :------------------ | :--------------- | :---------------- |
-| 沉浸式悬浮窗口，可置于任意位置     | 背景透明度与整体透明度分离控制  | 支持按添加时间、书名、作者、最近阅读排序 |
-| 滚轮翻页 / 快捷键翻页 / 自动翻页 | 自定义字体，支持添加系统字体   | 右键编辑元数据（标题、作者、分类） |
-| 只显示完整行，文字不残缺       | 十六进制颜色输入 + 颜色选择器 | 阅读进度持久化，关闭再开继续读   |
-| 文本预处理：压缩空行、清理空白     | 设置实时预览，取消可还原     | 拖拽导入 / 快捷文件导入（`导入书籍`） |
-| 鼠标移出隐藏三模式（关闭/仅进度/全隐藏） | 亮色 / 暗色主题切换     | 书籍信息窗口（封面、简介、分类、阅读统计） |
-| 鼠标移入显示延迟可调         | 列表书架模式           | 多选模式 + 批量重载/删除    |
-| 百分比进度编辑跳转          | 窗口大小锁定           | 重载元数据 / 恢复封面      |
-| 章节列表高亮当前进度         | —                | 书籍分类筛选栏            |
+### 隐阅窗口
+- 悬浮窗口，可置于任意位置
+- 翻页控制：滚轮翻页 / 快捷键翻页 / 自动翻页
+- 进度管理：百分比进度编辑跳转、章节列表高亮当前进度、书签功能（添加/列表/跳转/删除）
+- 全文搜索：搜索全书内容，按句子展示结果，支持分页浏览、关键词高亮、双击跳转
+- 窗口行为：鼠标移出隐藏三模式（不隐藏/仅进度/全隐藏）、移入显示延迟可调、窗口大小锁定
+- 快捷操作：添加书签快捷键（Shift+F）、销毁窗口快捷键（Shift+D）
+
+### 书架管理
+- 书籍导入：拖拽导入 / 快捷文件导入（`导入书籍`）
+- 信息管理：书籍信息窗口（封面、简介、分类、阅读统计）、右键编辑元数据（标题、作者、分类）
+- 批量操作：多选模式 + 批量重载/删除/设置分类、重载元数据 / 恢复封面
+- 阅读状态：已读完标记 + 标记为未读完、书架统计栏（总书籍/已读/阅读时长）
+- 筛选排序：书籍分类筛选栏、按添加时间/书名/作者/最近阅读排序
+
+### 个性化设置
+- 外观控制：背景透明度与整体透明度分离控制、亮色/暗色主题切换、列表书架模式
+- 字体样式：自定义字体（支持添加系统字体）、十六进制颜色输入 + 颜色选择器
+- 配置管理：设置实时预览、取消可还原、多配置方案切换
+
+### 技术特性
+- 只显示完整行，文字不残缺
+- 文本预处理：压缩空行、清理空白
+- 阅读进度持久化，关闭再开继续读
 
 ## 截图
 
-![书架](https://files.seeusercontent.com/2026/06/17/qvX8/image_86.png)
-![暗色模式](https://files.seeusercontent.com/2026/06/17/lu4H/image_85.png)
-![书籍信息](https://files.seeusercontent.com/2026/06/18/D9di/image_90.png)
-![隐阅窗口设置](https://files.seeusercontent.com/2026/06/17/eCu4/image_89.png)
-![功能设置](https://files.seeusercontent.com/2026/06/17/0bqW/image_88.png)
-![其他设置](https://files.seeusercontent.com/2026/06/17/y3uD/image_87.png)
+![书架](https://files.seeusercontent.com/2026/06/24/Pqs5/image_105.png)
+![列表书架](https://files.seeusercontent.com/2026/06/24/1xDq/image_110.png)
+![暗色模式](https://files.seeusercontent.com/2026/06/24/iR3q/image_106.png)
+![右键菜单](https://files.seeusercontent.com/2026/06/24/Mb0u/image_107.png)
+![书籍信息](https://files.seeusercontent.com/2026/06/24/6oZd/image_109.png)
+![章节列表](https://files.seeusercontent.com/2026/06/24/zc1T/image_111.png)
+![书签列表](https://files.seeusercontent.com/2026/06/24/Sur5/image_112.png)
+![搜索跳转](https://files.seeusercontent.com/2026/06/24/5Nhl/image_113.png)
+![书籍分类](https://files.seeusercontent.com/2026/06/24/7xXx/image_114.png)
+![隐阅窗口设置](https://files.seeusercontent.com/2026/06/24/Dl4e/image_115.png)
+![功能设置](https://files.seeusercontent.com/2026/06/24/9Nle/image_117.png)
+![其他设置](https://files.seeusercontent.com/2026/06/24/Wta6/image_118.png)
 ![隐阅效果](https://files.seeusercontent.com/2026/06/18/h1Jb/show.gif)
 
 
@@ -87,6 +107,8 @@ npm run build    # 构建生产版本
 | `categories`       | 分类数组        |
 | `customCoverImage` | 自定义封面       |
 | `fileModifiedAt`   | 文件修改时间      |
+| `isFinished`       | 是否已读完       |
+| `bookmarks`        | 书签列表（章节索引、字符偏移、内容预览、创建时间） |
 
 </details>
 
diff --git a/plugins/hushreader/package.json b/plugins/hushreader/package.json
index 2065aa5f..fe6a0b30 100644
--- a/plugins/hushreader/package.json
+++ b/plugins/hushreader/package.json
@@ -1,7 +1,7 @@
 {
   "name": "hushreader",
   "private": true,
-  "version": "1.3.3",
+  "version": "1.4.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/plugins/hushreader/public/hushreader.html b/plugins/hushreader/public/hushreader.html
index 000bc033..b6e48a0d 100644
--- a/plugins/hushreader/public/hushreader.html
+++ b/plugins/hushreader/public/hushreader.html
@@ -1015,6 +1015,8 @@
       const binding = getKeyboardEventBinding(event)
       const prevPageKey = normalizeKeyBinding(latestSettings.prevPageKey, "ArrowLeft")
       const nextPageKey = normalizeKeyBinding(latestSettings.nextPageKey, "ArrowRight")
+      const addBookmarkKey = normalizeKeyBinding(latestSettings.addBookmarkKey, "Shift+F")
+      const destroyKey = normalizeKeyBinding(latestSettings.destroyKey, "Shift+D")
 
       if (binding && binding === nextPageKey) {
         event.preventDefault()
@@ -1022,6 +1024,12 @@
       } else if (binding && binding === prevPageKey) {
         event.preventDefault()
         sendCommand("prev")
+      } else if (binding && binding === addBookmarkKey) {
+        event.preventDefault()
+        sendCommand("add-bookmark")
+      } else if (binding && binding === destroyKey) {
+        event.preventDefault()
+        sendCommand("destroy")
       }
     })
 
@@ -1161,23 +1169,26 @@
 
     document.addEventListener("contextmenu", (event) => {
       event.preventDefault()
-      if (!latestSettings.showHushreaderMeta) return
-
-      const metaRect = metaNode.getBoundingClientRect()
-      const inMetaArea = event.clientX >= metaRect.left - 4 && event.clientX <= metaRect.right + 4
-        && event.clientY >= metaRect.top - 4 && event.clientY <= metaRect.bottom + 4
-
-      if (!inMetaArea) return
 
       const items = []
-      items.push({ label: "关闭隐阅窗口", command: "close-reader" })
-      items.push({ label: "显示主窗口", command: "show-main" })
-      if (isAutoPaging) {
-        items.push({ label: "停止自动翻页", command: "stop-auto" })
-      } else {
-        items.push({ label: "开启自动翻页", command: "start-auto" })
+      if (latestSettings.showHushreaderMeta) {
+        const metaRect = metaNode.getBoundingClientRect()
+        const inMetaArea = event.clientX >= metaRect.left - 4 && event.clientX <= metaRect.right + 4
+          && event.clientY >= metaRect.top - 4 && event.clientY <= metaRect.bottom + 4
+        if (inMetaArea) {
+          items.push({ label: "关闭隐阅窗口", command: "close-reader" })
+          items.push({ label: "添加书签", command: "add-bookmark" })
+          items.push({ label: "显示主窗口", command: "show-main" })
+          if (isAutoPaging) {
+            items.push({ label: "停止自动翻页", command: "stop-auto" })
+          } else {
+            items.push({ label: "开启自动翻页", command: "start-auto" })
+          }
+        }
       }
 
+      if (items.length === 0) return
+
       contextMenuNode.innerHTML = ""
       items.forEach((item) => {
         const btn = document.createElement("button")
diff --git a/plugins/hushreader/public/plugin.json b/plugins/hushreader/public/plugin.json
index 47e9bd2e..fed86cf4 100644
--- a/plugins/hushreader/public/plugin.json
+++ b/plugins/hushreader/public/plugin.json
@@ -4,7 +4,7 @@
   "title": "隐阅盒",
   "description": "ZTools自己的摸鱼阅读，支持TXT/EPUB/MOBI格式，沉浸式阅读",
   "author": "meidlinger",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "main": "index.html",
   "preload": "preload/services.js",
   "logo": "logo.png",
diff --git a/plugins/hushreader/src/App.vue b/plugins/hushreader/src/App.vue
index 8076d42b..012ff5e6 100644
--- a/plugins/hushreader/src/App.vue
+++ b/plugins/hushreader/src/App.vue
@@ -3,7 +3,7 @@ import { computed, nextTick, onBeforeUnmount, onMounted, provide, ref, watch } f
 import Bookshelf from './components/Bookshelf/index.vue'
 import Toast from './components/Bookshelf/Toast.vue'
 import { useReaderStore } from './stores/reader'
-import { useBookStore } from './stores/books'
+import { useBookStore, type Bookmark } from './stores/books'
 import { useConfigStore } from './stores/config'
 import { parseTxt } from './utils/txtParser'
 import { parseEpub } from './utils/epubParser'
@@ -208,6 +208,8 @@ function getHushreaderPayload(bounds = getHushreaderWindowBounds()) {
       bgOpacity: hushreaderCfg.value.bgOpacity,
       prevPageKey: hushreaderCfg.value.prevPageKey,
       nextPageKey: hushreaderCfg.value.nextPageKey,
+      addBookmarkKey: hushreaderCfg.value.addBookmarkKey,
+      destroyKey: hushreaderCfg.value.destroyKey,
       showHushreaderMeta: hushreaderCfg.value.showHushreaderMeta,
       progressMode: hushreaderCfg.value.progressMode,
       hideOnMouseLeave: hushreaderCfg.value.hideOnMouseLeave,
@@ -466,6 +468,10 @@ function saveReadingProgress() {
     updates.lastSaveReadChars = Math.round(totalChars * (readerStore.readingPercent / 100))
   }
 
+  if (readerStore.readingPercent >= 100 && !book.finishedAt) {
+    updates.finishedAt = now
+  }
+
   (window as any).__hushreaderSessionLastActive = now
   bookStore.updateBook(book.id, updates)
 }
@@ -629,9 +635,45 @@ function handleHushreaderCommand(command: HushreaderCommand) {
   else if (command === 'close') closePlugin()
   else if (command === 'auto') toggleAutoPaging()
   else if (command === 'close-reader') { isReaderHidden.value = true; blurHushreaderKeyboard() }
+  else if (command === 'destroy') { saveReadingProgress(); hushreaderActivated.value = false; stopReadingTimer(); hushreaderWindow?.close?.(); hushreaderWindow = null }
   else if (command === 'show-main') { (window as any).ztools?.showMainWindow?.() }
   else if (command === 'stop-auto') { isAutoPaging.value = false; hushreaderCfg.value.autoFlipEnabled = false }
   else if (command === 'start-auto') { if (currentBook.value) { isAutoPaging.value = true; hushreaderCfg.value.autoFlipEnabled = true } }
+  else if (command === 'add-bookmark') {
+    const book = currentBook.value
+    if (book) {
+      const pageText = hushreaderLines.value.join('')
+      const boundaryRe = /[。！？…!?\.\」\』\）\】\」]/
+      let start = 0
+      const boundary = boundaryRe.exec(pageText)
+      if (boundary) {
+        start = boundary.index + boundary[0].length
+        while (start < pageText.length && /[\s\u3000]/.test(pageText[start])) start++
+      }
+      if (start >= pageText.length) start = 0
+      const rest = pageText.slice(start)
+      const sentenceEndRe = /[。！？…!?\.]/
+      let text = ''
+      const endMatch = sentenceEndRe.exec(rest)
+      if (endMatch) {
+        text = rest.slice(0, endMatch.index + endMatch[0].length).trim()
+      } else {
+        text = rest.trim().slice(0, 50)
+      }
+      if (text.length > 50) text = text.slice(0, 50) + '...'
+      const bookmark: Bookmark = {
+        id: `bm_${Date.now()}_${Math.random().toString(36).slice(2)}`,
+        chapterIndex: readerStore.currentChapterIndex,
+        charIndex: readerStore.currentPageSlice.startIndex,
+        readingPercent: readerStore.readingPercent,
+        text,
+        createdAt: Date.now()
+      }
+      const existing = book.bookmarks ?? []
+      bookStore.updateBook(book.id, { bookmarks: [...existing, bookmark] })
+      toast('书签已添加', 'success')
+    }
+  }
   else if (command === 'notification-close') { pendingNotificationCallback?.(); pendingNotificationCallback = null }
 }
 
@@ -708,6 +750,8 @@ watch(
     hushreaderCfg.value.bgOpacity,
     hushreaderCfg.value.prevPageKey,
     hushreaderCfg.value.nextPageKey,
+    hushreaderCfg.value.addBookmarkKey,
+    hushreaderCfg.value.destroyKey,
     hushreaderCfg.value.showHushreaderMeta,
     hushreaderCfg.value.progressMode,
     hushreaderCfg.value.hideOnMouseLeave,
diff --git a/plugins/hushreader/src/components/Bookshelf/BookCard.vue b/plugins/hushreader/src/components/Bookshelf/BookCard.vue
index 35869d3b..74eb45c4 100644
--- a/plugins/hushreader/src/components/Bookshelf/BookCard.vue
+++ b/plugins/hushreader/src/components/Bookshelf/BookCard.vue
@@ -35,7 +35,7 @@ function formatDate(ts: number) {
 
 function progressText(book: Book): string {
   if (!book.lastReadAt) return ''
-    if (book.readingPercent != null) {
+  if (book.readingPercent != null) {
     return `${book.readingPercent}%`
   }
   if (book.totalChapters && book.lastChapter != null) {
@@ -47,36 +47,29 @@ function progressText(book: Book): string {
 </script>
 
 <template>
-  <div
-    class="book-card"
-    :class="{ 'list-mode': listMode, 'selection-mode': selectionMode, selected }"
+  <div class="book-card" :class="{ 'list-mode': listMode, 'selection-mode': selectionMode, selected }"
     @click="selectionMode ? emit('toggle-select') : emit('click')"
-    @contextmenu.prevent="!selectionMode && emit('contextmenu', $event)"
-  >
+    @contextmenu.prevent="!selectionMode && emit('contextmenu', $event)">
     <!-- Selection checkbox -->
     <div v-if="selectionMode" class="select-check" :class="{ checked: selected }">
-      <svg v-if="selected" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="3"><polyline points="20 6 9 17 4 12"/></svg>
+      <svg v-if="selected" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+        stroke-width="3">
+        <polyline points="20 6 9 17 4 12" />
+      </svg>
     </div>
     <!-- Cover -->
-    <div
-      class="book-cover"
-      :style="displayCover ? {} : { background: book.coverColor || '#4a7fa5' }"
-    >
-      <img
-        v-if="displayCover"
-        :src="displayCover"
-        :alt="book.title"
-        class="cover-img"
-        @error="onImgError"
-      />
+    <div class="book-cover" :style="displayCover ? {} : { background: book.coverColor || '#4a7fa5' }">
+      <img v-if="displayCover" :src="displayCover" :alt="book.title" class="cover-img" @error="onImgError" />
       <template v-else>
         <span class="cover-format">{{ book.format.toUpperCase() }}</span>
         <span class="cover-title">{{ book.title }}</span>
       </template>
+      <span class="format-badge" :class="book.format">{{ book.format.toUpperCase() }}</span>
       <span v-if="progressText(book)" class="cover-progress">
         <span class="progress-bar" :style="{ width: progressText(book) }"></span>
         <span class="progress-label">{{ progressText(book) }}</span>
       </span>
+      <span v-if="book.finishedAt && !selectionMode && !listMode" class="finished-badge">已读完</span>
     </div>
 
     <!-- Info -->
@@ -84,7 +77,9 @@ function progressText(book: Book): string {
       <p class="book-title">{{ book.title }}</p>
       <p class="book-author">{{ book.author || '未知作者' }}</p>
       <p v-if="listMode" class="book-meta">
-        {{ (book.categories || []).join('、') }}{{ book.categories?.length && book.lastReadAt ? ' · ' : '' }}{{ book.lastReadAt ? formatDate(book.lastReadAt) : '' }}
+        <span v-if="book.finishedAt" class="meta-finished">已读完</span>{{ (book.categories || []).join('、') }}{{
+          book.categories?.length && book.lastReadAt ? ' · ' : '' }}{{ book.lastReadAt ? formatDate(book.lastReadAt) : ''
+        }}
       </p>
     </div>
   </div>
@@ -100,6 +95,7 @@ function progressText(book: Book): string {
   padding: 6px;
   transition: background 0.15s var(--ease-out), box-shadow 0.15s var(--ease-out);
 }
+
 .book-card:hover {
   background: var(--c-surface-sunken);
 }
@@ -245,7 +241,9 @@ function progressText(book: Book): string {
   line-height: 1.4;
 }
 
-.list-mode .book-title { font-size: 13px; }
+.list-mode .book-title {
+  font-size: 13px;
+}
 
 .book-author {
   margin-top: 2px;
@@ -261,4 +259,68 @@ function progressText(book: Book): string {
   font-size: 11px;
   color: var(--c-ink-tertiary);
 }
+
+.meta-finished {
+  display: inline-block;
+  padding: 0 4px;
+  margin-right: 4px;
+  border-radius: var(--radius-xs);
+  background: var(--c-accent);
+  color: var(--c-ink-inverse);
+  font-size: 9px;
+  font-weight: 600;
+  line-height: 1.6;
+  vertical-align: middle;
+}
+
+.finished-badge {
+  position: absolute;
+  top: 6px;
+  right: 6px;
+  padding: 2px 6px;
+  border-radius: var(--radius-xs);
+  background: var(--c-accent);
+  color: var(--c-ink-inverse);
+  font-size: 9px;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  z-index: 2;
+  pointer-events: none;
+}
+
+.format-badge {
+  position: absolute;
+  top: 6px;
+  left: 6px;
+  padding: 1px 5px;
+  border-radius: var(--radius-xs);
+  font-size: 8px;
+  font-weight: 700;
+  letter-spacing: 0.5px;
+  z-index: 2;
+  pointer-events: none;
+  line-height: 1.5;
+}
+
+.format-badge.epub {
+  background: rgba(59, 130, 246, 0.85);
+  color: #fff;
+}
+
+.format-badge.txt {
+  background: rgba(107, 114, 128, 0.85);
+  color: #fff;
+}
+
+.format-badge.mobi {
+  background: rgba(234, 88, 12, 0.85);
+  color: #fff;
+}
+
+.list-mode .format-badge {
+  top: 3px;
+  left: 3px;
+  padding: 0 3px;
+  font-size: 7px;
+}
 </style>
diff --git a/plugins/hushreader/src/components/Bookshelf/ContextMenu.vue b/plugins/hushreader/src/components/Bookshelf/ContextMenu.vue
index 1b1b114b..713ab314 100644
--- a/plugins/hushreader/src/components/Bookshelf/ContextMenu.vue
+++ b/plugins/hushreader/src/components/Bookshelf/ContextMenu.vue
@@ -1,10 +1,12 @@
 <script setup lang="ts">
 import { ref, nextTick, watch } from 'vue'
 
-const props = defineProps<{ pos: { x: number; y: number } }>()
+const props = defineProps<{ pos: { x: number; y: number }; isFinished?: boolean }>()
 const emit = defineEmits<{
   'book-info': []
   'chapter-list': []
+  'bookmark-list': []
+  'search-jump': []
   'change-path': []
   'open-file-location': []
   'edit-metadata': []
@@ -12,6 +14,7 @@ const emit = defineEmits<{
   'set-category': []
   'set-cover': []
   'restore-cover': []
+  'mark-unfinished': []
   'delete': []
   'close': []
 }>()
@@ -51,6 +54,14 @@ watch(
         <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><line x1="8" y1="6" x2="21" y2="6"/><line x1="8" y1="12" x2="21" y2="12"/><line x1="8" y1="18" x2="21" y2="18"/><line x1="3" y1="6" x2="3.01" y2="6"/><line x1="3" y1="12" x2="3.01" y2="12"/><line x1="3" y1="18" x2="3.01" y2="18"/></svg>
         章节列表
       </li>
+      <li class="ctx-item" @click="emit('bookmark-list')">
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M19 21l-7-5-7 5V5a2 2 0 0 1 2-2h10a2 2 0 0 1 2 2z"/></svg>
+        书签列表
+      </li>
+      <li class="ctx-item" @click="emit('search-jump')">
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><path d="m21 21-4.35-4.35"/></svg>
+        搜索跳转
+      </li>
       <li class="ctx-item" @click="emit('change-path')">
         <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M11 4H4a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7"/><path d="M18.5 2.5a2.121 2.121 0 0 1 3 3L12 15l-4 1 1-4 9.5-9.5z"/></svg>
         修改本地路径
@@ -81,6 +92,11 @@ watch(
         恢复封面
       </li>
       <li class="ctx-divider"></li>
+      <li v-if="isFinished" class="ctx-item" @click="emit('mark-unfinished')">
+        <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M18 6L6 18"/><path d="M6 6l12 12"/></svg>
+        标记为未读完
+      </li>
+      <li v-if="isFinished" class="ctx-divider"></li>
       <li class="ctx-item ctx-danger" @click="emit('delete')">
         <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="3 6 5 6 21 6"/><path d="M19 6l-1 14a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2L5 6"/><path d="M10 11v6"/><path d="M14 11v6"/><path d="M9 6V4a1 1 0 0 1 1-1h4a1 1 0 0 1 1 1v2"/></svg>
         删除书籍
diff --git a/plugins/hushreader/src/components/Bookshelf/index.vue b/plugins/hushreader/src/components/Bookshelf/index.vue
index 287c4532..62d196a5 100644
--- a/plugins/hushreader/src/components/Bookshelf/index.vue
+++ b/plugins/hushreader/src/components/Bookshelf/index.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { ref, computed, inject, onMounted, onBeforeUnmount, watch } from 'vue'
-import { useBookStore } from '../../stores/books'
+import { useBookStore, type Bookmark } from '../../stores/books'
 import { useConfigStore } from '../../stores/config'
 import { useReaderStore } from '../../stores/reader'
 import { parseTxt } from '../../utils/txtParser'
@@ -127,11 +127,54 @@ function jumpToChapter(chapterIndex: number) {
   showChapterList.value = false
   const bookId = chapterListBookId.value
   if (!bookId) return
-  // Set lastChapter so it opens at that chapter
   bookStore.updateBook(bookId, { lastChapter: chapterIndex, lastPage: 0 })
   openBookAndHushreader?.(bookId)
 }
 
+// Bookmark list modal
+const showBookmarkList = ref(false)
+const bookmarkListBookId = ref<string | null>(null)
+
+function openBookmarkList(bookId: string) {
+  closeContextMenu()
+  bookmarkListBookId.value = bookId
+  showBookmarkList.value = true
+}
+
+function getBookmarkList(): Bookmark[] {
+  if (!bookmarkListBookId.value) return []
+  const book = bookStore.books.find(b => b.id === bookmarkListBookId.value)
+  return book?.bookmarks ?? []
+}
+
+function formatBookmarkDate(ts: number): string {
+  const d = new Date(ts)
+  const pad = (n: number) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}`
+}
+
+function formatBookmarkText(text: string): string {
+  if (text.length <= 50) return text
+  return text.slice(0, 50) + '...'
+}
+
+function jumpToBookmark(bookmark: Bookmark) {
+  const bookId = bookmarkListBookId.value
+  if (!bookId) return
+  showBookmarkList.value = false
+  bookStore.updateBook(bookId, { lastChapter: bookmark.chapterIndex, progressIndex: bookmark.charIndex })
+  openBookAndHushreader?.(bookId)
+}
+
+function deleteBookmark(bookmarkId: string) {
+  if (!bookmarkListBookId.value) return
+  const book = bookStore.books.find(b => b.id === bookmarkListBookId.value)
+  if (!book?.bookmarks) return
+  bookStore.updateBook(bookmarkListBookId.value, {
+    bookmarks: book.bookmarks.filter(bm => bm.id !== bookmarkId)
+  })
+}
+
 // Change file path
 const showPathModal = ref(false)
 const pathModalBookId = ref<string | null>(null)
@@ -285,18 +328,18 @@ async function restoreCover(bookId: string) {
   if (!book) return
 
   bookStore.updateBook(bookId, { customCoverImage: undefined })
-  removeCustomCover(bookId).catch(() => { })
+  await removeCustomCover(bookId)
 
   if (book.format === 'txt') {
     bookStore.updateBook(bookId, { coverImage: undefined })
-    removeCover(bookId).catch(() => { })
+    await removeCover(bookId)
     toast('封面已恢复为纯色', 'success')
     return
   }
 
   if (configStore.config.other.plainTextCover) {
     bookStore.updateBook(bookId, { coverImage: undefined })
-    removeCover(bookId).catch(() => { })
+    await removeCover(bookId)
     toast('封面已恢复', 'success')
     return
   }
@@ -305,7 +348,7 @@ async function restoreCover(bookId: string) {
     const content = window.services?.readFileBinary?.(book.filePath)
     if (!content) {
       bookStore.updateBook(bookId, { coverImage: undefined })
-      removeCover(bookId).catch(() => { })
+      await removeCover(bookId)
       toast('封面已恢复', 'success')
       return
     }
@@ -328,12 +371,12 @@ async function restoreCover(bookId: string) {
       saveCover(bookId, coverImage).catch(() => { })
     } else {
       bookStore.updateBook(bookId, { coverImage: undefined })
-      removeCover(bookId).catch(() => { })
+      await removeCover(bookId)
     }
     toast('封面已恢复', 'success')
   } catch {
     bookStore.updateBook(bookId, { coverImage: undefined })
-    removeCover(bookId).catch(() => { })
+    await removeCover(bookId)
     toast('封面已恢复', 'success')
   }
 }
@@ -370,6 +413,12 @@ function openDeleteModal(bookId: string) {
   showDeleteModal.value = true
 }
 
+function markUnfinished(bookId: string) {
+  closeContextMenu()
+  bookStore.updateBook(bookId, { finishedAt: undefined })
+  toast('已标记为未读完', 'success')
+}
+
 function confirmDelete() {
   if (!deleteBookId.value) return
   bookStore.removeBook(deleteBookId.value)
@@ -454,6 +503,264 @@ function openReloadMetadata(bookId: string) {
   reloadMetadata(bookId)
 }
 
+// Full-text search modal
+const showSearchModal = ref(false)
+const searchBookId = ref<string | null>(null)
+const searchKeyword = ref('')
+const searchResults = ref<{ charOffset: number; sentence: string; percent: number }[]>([])
+const searchLoading = ref(false)
+const searchPage = ref(1)
+
+function openSearchModal(bookId: string) {
+  closeContextMenu()
+  searchBookId.value = bookId
+  searchKeyword.value = ''
+  searchResults.value = []
+  searchPage.value = 1
+  showSearchModal.value = true
+}
+
+const SEARCH_PAGE_SIZE = 10
+
+const searchPagedResults = computed(() => {
+  const start = (searchPage.value - 1) * SEARCH_PAGE_SIZE
+  return searchResults.value.slice(start, start + SEARCH_PAGE_SIZE)
+})
+
+const searchTotalPages = computed(() => Math.max(1, Math.ceil(searchResults.value.length / SEARCH_PAGE_SIZE)))
+
+function escapeHtml(text: string): string {
+  return text
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#039;')
+}
+
+function highlightKeyword(text: string, keyword: string): string {
+  const safeText = escapeHtml(text)
+  if (!keyword) return safeText
+  const safeKeyword = escapeHtml(keyword)
+  const escaped = safeKeyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+  return safeText.replace(new RegExp(escaped, 'gi'), '<mark>$&</mark>')
+}
+
+function formatSearchResult(sentence: string, keyword: string): string {
+  const maxLen = 20
+  const idx = sentence.toLowerCase().indexOf(keyword.toLowerCase())
+  if (idx === -1) return sentence.length <= maxLen ? sentence : sentence.slice(0, maxLen) + '...'
+  const minEnd = idx + keyword.length + 5
+  const end = Math.max(minEnd, maxLen)
+  if (sentence.length <= end) return sentence
+  return sentence.slice(0, end) + '...'
+}
+
+async function executeSearch() {
+  const bookId = searchBookId.value
+  const keyword = searchKeyword.value.trim()
+  if (!bookId || !keyword) return
+
+  const book = bookStore.books.find(b => b.id === bookId)
+  if (!book) return
+
+  searchLoading.value = true
+  searchResults.value = []
+  searchPage.value = 1
+
+  try {
+    let fullText = ''
+
+    if (book.format === 'txt') {
+      fullText = window.services?.readFile(book.filePath) ?? ''
+    } else if (book.format === 'mobi') {
+      const content = window.services?.readFileBinary?.(book.filePath)
+      if (content) {
+        const blob = new Blob([content], { type: 'application/x-mobipocket-ebook' })
+        const file = new File([blob], book.filePath.split(/[\\/]/).pop() ?? 'book.mobi')
+        const result = await parseMobi(file)
+        if (result.error) { toast(`搜索失败：${result.error}`, 'error'); searchLoading.value = false; return }
+        fullText = result.chapters.map(c => c.content || '').join('\n')
+      }
+    } else {
+      const content = window.services?.readFileBinary?.(book.filePath)
+      if (content) {
+        const blob = new Blob([content], { type: 'application/epub+zip' })
+        const file = new File([blob], book.filePath.split(/[\\/]/).pop() ?? 'book.epub')
+        const { chapters: parsed } = await parseEpub(file)
+        fullText = parsed.map(c => c.content || '').join('\n')
+      }
+    }
+
+    if (!fullText) {
+      toast('无法加载书籍内容', 'error')
+      searchLoading.value = false
+      return
+    }
+
+    const totalLen = fullText.length
+    const fullTextLower = fullText.toLowerCase()
+    const boundaryRe = /[。！？…!?\.\」\』\）\】\」]/
+    const sentenceEndRe = /[。！？…!?\.]/
+    const kwLower = keyword.toLowerCase()
+    const BOUNDARY_WINDOW = 200
+    const results: typeof searchResults.value = []
+    let pos = 0
+
+    while (pos < fullTextLower.length) {
+      const kwIdx = fullTextLower.indexOf(kwLower, pos)
+      if (kwIdx === -1) break
+
+      let start = 0
+      const windowStart = Math.max(0, kwIdx - BOUNDARY_WINDOW)
+      const beforeKw = fullText.slice(windowStart, kwIdx)
+      let lastBoundary = -1
+      let searchIdx = beforeKw.length
+      while (searchIdx >= 0) {
+        const ch = beforeKw[searchIdx]
+        if (boundaryRe.test(ch)) {
+          lastBoundary = windowStart + searchIdx + 1
+          break
+        }
+        searchIdx--
+      }
+      if (lastBoundary >= 0) {
+        start = lastBoundary
+        while (start < fullText.length && /[\s\u3000]/.test(fullText[start])) start++
+      }
+      if (start > kwIdx) start = 0
+
+      const rest = fullText.slice(start)
+      const endMatch = sentenceEndRe.exec(rest)
+      let sentence: string
+      let sentenceEnd: number
+      if (endMatch) {
+        sentenceEnd = start + endMatch.index + endMatch[0].length
+        sentence = fullText.slice(start, sentenceEnd).trim()
+      } else {
+        sentence = rest.trim().slice(0, 50)
+        sentenceEnd = start + rest.trim().slice(0, 50).length
+      }
+
+      const alreadyFound = results.some(r => r.charOffset >= start && r.charOffset < sentenceEnd)
+      if (!alreadyFound) {
+        const percent = totalLen > 0 ? (start / totalLen) * 100 : 0
+        results.push({
+          charOffset: start,
+          sentence,
+          percent
+        })
+      }
+
+      pos = sentenceEnd > start ? sentenceEnd : kwIdx + 1
+    }
+
+    searchResults.value = results
+  } catch (e: any) {
+    toast(`搜索失败：${e.message}`, 'error')
+  } finally {
+    searchLoading.value = false
+  }
+}
+
+function jumpToSearchResult(result: { charOffset: number }) {
+  const bookId = searchBookId.value
+  if (!bookId) return
+  const book = bookStore.books.find(b => b.id === bookId)
+  if (!book) return
+
+  showSearchModal.value = false
+
+  let chapters: { index: number; content: string }[] = []
+  if (book.format === 'txt') {
+    const text = window.services?.readFile(book.filePath) ?? ''
+    const parsed = parseTxt(text, configStore.config.other.chapterRegex || undefined)
+    chapters = parsed.map(c => ({ index: c.index, content: c.content || '' }))
+  } else if (book.format === 'mobi') {
+    const content = window.services?.readFileBinary?.(book.filePath)
+    if (content) {
+      const blob = new Blob([content], { type: 'application/x-mobipocket-ebook' })
+      const file = new File([blob], book.filePath.split(/[\\/]/).pop() ?? 'book.mobi')
+      parseMobi(file).then(r => {
+        if (!r.error) {
+          const chs = r.chapters.map(c => ({ index: c.index, content: c.content || '' }))
+          jumpToOffset(bookId, chs, result.charOffset)
+        }
+      })
+      return
+    }
+  } else {
+    const content = window.services?.readFileBinary?.(book.filePath)
+    if (content) {
+      const blob = new Blob([content], { type: 'application/epub+zip' })
+      const file = new File([blob], book.filePath.split(/[\\/]/).pop() ?? 'book.epub')
+      parseEpub(file).then(({ chapters: parsed }) => {
+        const chs = parsed.map(c => ({ index: c.index, content: c.content || '' }))
+        jumpToOffset(bookId, chs, result.charOffset)
+      })
+      return
+    }
+  }
+
+  jumpToOffset(bookId, chapters, result.charOffset)
+}
+
+function jumpToOffset(bookId: string, chapters: { index: number; content: string }[], offset: number) {
+  let cumLen = 0
+  for (const ch of chapters) {
+    const chLen = ch.content.length + 1
+    if (cumLen + ch.content.length > offset) {
+      const charIndex = offset - cumLen
+      bookStore.updateBook(bookId, { lastChapter: ch.index, progressIndex: charIndex })
+      openBookAndHushreader?.(bookId)
+      return
+    }
+    cumLen += chLen
+  }
+  const last = chapters[chapters.length - 1]
+  if (last) {
+    bookStore.updateBook(bookId, { lastChapter: last.index, progressIndex: 0 })
+    openBookAndHushreader?.(bookId)
+  }
+}
+
+// Batch category modal
+const showBatchCategoryModal = ref(false)
+const batchCategorySelected = ref<string[]>([])
+const batchCategoryNew = ref('')
+
+function openBatchCategory() {
+  if (selectedIds.value.size === 0) return
+  batchCategorySelected.value = []
+  batchCategoryNew.value = ''
+  showBatchCategoryModal.value = true
+}
+
+function toggleBatchCategorySelection(cat: string) {
+  const idx = batchCategorySelected.value.indexOf(cat)
+  if (idx > -1) {
+    batchCategorySelected.value.splice(idx, 1)
+  } else {
+    batchCategorySelected.value.push(cat)
+  }
+}
+
+function confirmBatchCategory() {
+  const newCats = batchCategoryNew.value
+    .split(/[,，]/)
+    .map(s => s.trim())
+    .filter(Boolean)
+  const finalCats = [...new Set([...batchCategorySelected.value, ...newCats])]
+
+  for (const id of selectedIds.value) {
+    bookStore.updateBook(id, { categories: finalCats.length > 0 ? finalCats : undefined })
+  }
+
+  showBatchCategoryModal.value = false
+  toast(`已为 ${selectedIds.value.size} 本书设置分类`, 'success')
+  exitSelectionMode()
+}
+
 // Multi-select mode
 const selectionMode = ref(false)
 const selectedIds = ref<Set<string>>(new Set())
@@ -851,6 +1158,16 @@ watch(() => configStore.config.other.plainTextCover, async (plain) => {
 
 
 const cfg = computed(() => configStore.config)
+const statsTotal = computed(() => bookStore.books.length)
+const statsRead = computed(() => bookStore.books.filter(b => b.finishedAt).length)
+const statsReadingTimeMs = computed(() => bookStore.books.reduce((sum, b) => sum + (b.readingTimeMs || 0), 0))
+function formatReadingTime(ms: number): string {
+  const totalMin = Math.floor(ms / 60000)
+  if (totalMin < 60) return `${totalMin}分钟`
+  const h = Math.floor(totalMin / 60)
+  const m = totalMin % 60
+  return m > 0 ? `${h}小时${m}分` : `${h}小时`
+}
 </script>
 
 <template>
@@ -875,16 +1192,32 @@ const cfg = computed(() => configStore.config)
         <input v-model="bookStore.searchQuery" class="search-input" placeholder="搜索书名或作者..." />
       </div>
       <div class="shelf-actions">
+        <button class="icon-btn" :class="{ active: cfg.other.listMode }" :title="cfg.other.listMode ? '卡片视图' : '列表视图'"
+          @click="configStore.config.other.listMode = !configStore.config.other.listMode">
+          <svg v-if="cfg.other.listMode" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor"
+            stroke-width="2">
+            <rect x="3" y="3" width="7" height="7" rx="1" />
+            <rect x="14" y="3" width="7" height="7" rx="1" />
+            <rect x="3" y="14" width="7" height="7" rx="1" />
+            <rect x="14" y="14" width="7" height="7" rx="1" />
+          </svg>
+          <svg v-else width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+            <line x1="8" y1="6" x2="21" y2="6" />
+            <line x1="8" y1="12" x2="21" y2="12" />
+            <line x1="8" y1="18" x2="21" y2="18" />
+            <line x1="3" y1="6" x2="5" y2="6" />
+            <line x1="3" y1="12" x2="5" y2="12" />
+            <line x1="3" y1="18" x2="5" y2="18" />
+          </svg>
+        </button>
         <button class="icon-btn" :class="{ active: selectionMode }" :title="selectionMode ? '退出多选' : '多选'"
           @click="toggleSelectionMode">
           <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
             <polyline v-if="selectionMode" points="18 6 6 18" />
             <polyline v-if="selectionMode" points="6 6 18 18" />
             <template v-else>
-              <rect x="3" y="3" width="7" height="7" rx="1" />
-              <rect x="14" y="3" width="7" height="7" rx="1" />
-              <rect x="3" y="14" width="7" height="7" rx="1" />
-              <rect x="14" y="14" width="7" height="7" rx="1" />
+              <polyline points="9 11 12 14 22 4" />
+              <path d="M21 12v7a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h11" />
             </template>
           </svg>
         </button>
@@ -905,6 +1238,15 @@ const cfg = computed(() => configStore.config)
       </div>
     </header>
 
+    <!-- Stats bar -->
+    <div class="stats-bar">
+      <span class="stats-item"><span class="stats-value">{{ statsTotal }}</span>本书</span>
+      <span class="stats-divider"></span>
+      <span class="stats-item"><span class="stats-value">{{ statsRead }}</span>本已读</span>
+      <span class="stats-divider"></span>
+      <span class="stats-item">累计阅读<span class="stats-value">{{ formatReadingTime(statsReadingTimeMs) }}</span></span>
+    </div>
+
     <!-- Category tabs -->
     <div class="category-bar">
       <button v-if="selectionMode" class="category-tab select-all-btn"
@@ -956,11 +1298,14 @@ const cfg = computed(() => configStore.config)
     </div>
 
     <!-- Context Menu -->
-    <ContextMenu v-if="contextMenuBook" :pos="contextMenuPos" @book-info="openBookInfo(contextMenuBook!)"
-      @chapter-list="openChapterList(contextMenuBook!)" @change-path="openPathModal(contextMenuBook!)"
-      @open-file-location="openFileLocation(contextMenuBook!)" @edit-metadata="openMetadataModal(contextMenuBook!)"
-      @reload-metadata="openReloadMetadata(contextMenuBook!)" @set-category="openCategoryModal(contextMenuBook!)"
-      @set-cover="openCoverPicker(contextMenuBook!)" @restore-cover="openRestoreCover(contextMenuBook!)"
+    <ContextMenu v-if="contextMenuBook" :pos="contextMenuPos"
+      :is-finished="!!bookStore.books.find(b => b.id === contextMenuBook)?.finishedAt"
+      @book-info="openBookInfo(contextMenuBook!)" @chapter-list="openChapterList(contextMenuBook!)"
+      @bookmark-list="openBookmarkList(contextMenuBook!)" @search-jump="openSearchModal(contextMenuBook!)"
+      @change-path="openPathModal(contextMenuBook!)" @open-file-location="openFileLocation(contextMenuBook!)"
+      @edit-metadata="openMetadataModal(contextMenuBook!)" @reload-metadata="openReloadMetadata(contextMenuBook!)"
+      @set-category="openCategoryModal(contextMenuBook!)" @set-cover="openCoverPicker(contextMenuBook!)"
+      @restore-cover="openRestoreCover(contextMenuBook!)" @mark-unfinished="markUnfinished(contextMenuBook!)"
       @delete="openDeleteModal(contextMenuBook!)" @close="closeContextMenu" />
 
     <!-- Settings Modal -->
@@ -983,6 +1328,66 @@ const cfg = computed(() => configStore.config)
       </div>
     </Modal>
 
+    <!-- Bookmark List Modal -->
+    <Modal v-if="showBookmarkList" title="书签列表" @close="showBookmarkList = false">
+      <div class="bookmark-list">
+        <div v-if="getBookmarkList().length === 0" class="bookmark-empty">暂无书签</div>
+        <div v-else class="bookmark-items">
+          <div v-for="bm in getBookmarkList()" :key="bm.id" class="bookmark-item" @dblclick="jumpToBookmark(bm)">
+            <div class="bookmark-info">
+              <span class="bookmark-date">{{ formatBookmarkDate(bm.createdAt) }}</span>
+              <span class="bookmark-percent">{{ bm.readingPercent.toFixed(1) }}%</span>
+            </div>
+            <div class="bookmark-text">{{ formatBookmarkText(bm.text) }}</div>
+            <button class="bookmark-delete" @click.stop="deleteBookmark(bm.id)" title="删除书签">
+              <svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2">
+                <line x1="18" y1="6" x2="6" y2="18" />
+                <line x1="6" y1="6" x2="18" y2="18" />
+              </svg>
+            </button>
+          </div>
+        </div>
+        <p class="bookmark-hint">双击书签跳转到对应位置</p>
+      </div>
+    </Modal>
+
+    <!-- Search Jump Modal -->
+    <Modal v-if="showSearchModal" title="搜索跳转" @close="showSearchModal = false">
+      <div class="search-modal">
+        <div class="search-bar">
+          <input v-model="searchKeyword" class="form-input search-input-modal" placeholder="输入搜索关键词..."
+            @keydown.enter="executeSearch" />
+          <button class="btn-primary" :disabled="!searchKeyword.trim() || searchLoading" @click="executeSearch">
+            <span v-if="searchLoading" class="spinner"
+              style="width:14px;height:14px;border-width:1.5px;margin-right:4px"></span>
+            搜索
+          </button>
+        </div>
+        <div v-if="searchResults.length > 0" class="search-meta">
+          共 {{ searchResults.length }} 条结果，第 {{ searchPage }}/{{ searchTotalPages }} 页
+        </div>
+        <div v-if="searchResults.length > 0" class="search-results">
+          <div v-for="(r, i) in searchPagedResults" :key="i" class="search-result-item"
+            @dblclick="jumpToSearchResult(r)">
+            <div class="search-result-info">
+              <span class="search-result-percent">{{ r.percent.toFixed(1) }}%</span>
+            </div>
+            <div class="search-result-text"
+              v-html="highlightKeyword(formatSearchResult(r.sentence, searchKeyword), searchKeyword)"></div>
+          </div>
+        </div>
+        <div v-if="searchResults.length === 0 && !searchLoading && searchKeyword.trim()" class="search-empty">
+          暂无结果
+        </div>
+        <div v-if="searchResults.length > SEARCH_PAGE_SIZE" class="search-pagination">
+          <button class="btn-secondary" :disabled="searchPage <= 1" @click="searchPage--">上一页</button>
+          <span class="search-page-info">{{ searchPage }} / {{ searchTotalPages }}</span>
+          <button class="btn-secondary" :disabled="searchPage >= searchTotalPages" @click="searchPage++">下一页</button>
+        </div>
+        <p class="bookmark-hint">双击结果跳转到对应位置</p>
+      </div>
+    </Modal>
+
     <!-- Path Modal -->
     <Modal v-if="showPathModal" title="修改本地路径" @close="showPathModal = false">
       <div class="form-modal">
@@ -1070,6 +1475,7 @@ const cfg = computed(() => configStore.config)
             style="width:14px;height:14px;border-width:1.5px;margin-right:4px"></span>
           批量重载
         </button>
+        <button class="btn-secondary" :disabled="selectedCount === 0" @click="openBatchCategory">批量设置分类</button>
         <button class="btn-danger" :disabled="selectedCount === 0" @click="openBatchDelete">批量删除</button>
         <button class="btn-ghost" @click="exitSelectionMode">取消</button>
       </div>
@@ -1086,6 +1492,28 @@ const cfg = computed(() => configStore.config)
       </div>
     </Modal>
 
+    <!-- Batch Category Modal -->
+    <Modal v-if="showBatchCategoryModal" title="批量设置分类" @close="showBatchCategoryModal = false">
+      <div class="form-modal">
+        <p class="form-hint" style="margin: 0 0 8px">将为选中的 {{ selectedCount }} 本书统一设置以下分类（覆盖原有分类）</p>
+        <label class="form-label">已有分类（多选）</label>
+        <div v-if="bookStore.categories.length > 1" class="category-tags">
+          <button v-for="cat in bookStore.categories.filter(c => c !== '全部')" :key="cat" class="category-tag"
+            :class="{ active: batchCategorySelected.includes(cat) }" @click="toggleBatchCategorySelection(cat)">
+            {{ cat }}
+          </button>
+        </div>
+        <p v-else class="form-hint">暂无其他分类</p>
+        <label class="form-label" style="margin-top: 12px">新建分类</label>
+        <input v-model="batchCategoryNew" class="form-input" placeholder="输入新分类名称，多个用逗号分隔..." />
+        <p class="form-hint">留空则不添加新分类</p>
+        <div class="form-actions">
+          <button class="btn-secondary" @click="showBatchCategoryModal = false">取消</button>
+          <button class="btn-primary" @click="confirmBatchCategory">确认</button>
+        </div>
+      </div>
+    </Modal>
+
     <!-- Book Info Modal -->
     <BookInfoModal v-if="showBookInfo && bookInfoBook" :book="bookInfoBook" @close="showBookInfo = false"
       @saved="onBookInfoSaved" />
@@ -1184,6 +1612,35 @@ const cfg = computed(() => configStore.config)
   flex-shrink: 0;
 }
 
+.stats-bar {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 0 20px 8px;
+  font-size: 12px;
+  color: var(--c-ink-tertiary);
+  flex-shrink: 0;
+}
+
+.stats-item {
+  display: flex;
+  align-items: center;
+  gap: 3px;
+}
+
+.stats-value {
+  color: var(--c-ink-secondary);
+  font-weight: 600;
+  font-variant-numeric: tabular-nums;
+  font-family: var(--font-mono);
+}
+
+.stats-divider {
+  width: 1px;
+  height: 12px;
+  background: var(--c-border);
+}
+
 .icon-btn {
   display: flex;
   align-items: center;
@@ -1640,4 +2097,195 @@ const cfg = computed(() => configStore.config)
   right: 20px;
   z-index: 100;
 }
+
+.bookmark-list {
+  min-width: 280px;
+}
+
+.bookmark-empty {
+  text-align: center;
+  color: var(--c-ink-tertiary);
+  padding: 24px 0;
+  font-size: 13px;
+}
+
+.bookmark-items {
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+
+.bookmark-item {
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 10px 32px 10px 12px;
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  transition: background 0.12s var(--ease-out);
+}
+
+.bookmark-item:hover {
+  background: var(--c-surface-sunken);
+}
+
+.bookmark-info {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.bookmark-date {
+  font-size: 12px;
+  color: var(--c-ink-tertiary);
+  font-variant-numeric: tabular-nums;
+}
+
+.bookmark-percent {
+  font-size: 11px;
+  color: var(--c-accent);
+  background: var(--c-accent-soft);
+  padding: 1px 6px;
+  border-radius: var(--radius-sm);
+  font-weight: 500;
+}
+
+.bookmark-text {
+  font-size: 13px;
+  color: var(--c-ink);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.bookmark-delete {
+  position: absolute;
+  top: 50%;
+  right: 8px;
+  transform: translateY(-50%);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 22px;
+  height: 22px;
+  border-radius: var(--radius-sm);
+  color: var(--c-ink-tertiary);
+  opacity: 0;
+  transition: all 0.12s var(--ease-out);
+}
+
+.bookmark-item:hover .bookmark-delete {
+  opacity: 1;
+}
+
+.bookmark-delete:hover {
+  background: var(--c-danger-soft);
+  color: var(--c-danger);
+}
+
+.bookmark-hint {
+  margin: 12px 0 0;
+  font-size: 11px;
+  color: var(--c-ink-tertiary);
+  text-align: center;
+}
+
+.search-modal {
+  min-width: 320px;
+}
+
+.search-bar {
+  display: flex;
+  gap: 8px;
+}
+
+.search-input-modal {
+  flex: 1;
+}
+
+.search-meta {
+  font-size: 12px;
+  color: var(--c-ink-tertiary);
+  margin-top: 8px;
+}
+
+.search-results {
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+  margin-top: 8px;
+  max-height: 320px;
+  overflow-y: auto;
+}
+
+.search-result-item {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 8px 12px;
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  transition: background 0.12s var(--ease-out);
+}
+
+.search-result-item:hover {
+  background: var(--c-surface-sunken);
+}
+
+.search-result-info {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.search-result-chapter {
+  font-size: 12px;
+  color: var(--c-ink-tertiary);
+}
+
+.search-result-percent {
+  font-size: 11px;
+  color: var(--c-accent);
+  background: var(--c-accent-soft);
+  padding: 1px 6px;
+  border-radius: var(--radius-sm);
+  font-weight: 500;
+}
+
+.search-result-text {
+  font-size: 13px;
+  color: var(--c-ink);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.search-result-text :deep(mark) {
+  background: var(--c-accent-soft);
+  color: var(--c-accent);
+  padding: 0 2px;
+  border-radius: 2px;
+}
+
+.search-empty {
+  text-align: center;
+  color: var(--c-ink-tertiary);
+  padding: 24px 0;
+  font-size: 13px;
+}
+
+.search-pagination {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 12px;
+  margin-top: 10px;
+}
+
+.search-page-info {
+  font-size: 12px;
+  color: var(--c-ink-tertiary);
+  font-variant-numeric: tabular-nums;
+}
 </style>
diff --git a/plugins/hushreader/src/components/Settings/index.vue b/plugins/hushreader/src/components/Settings/index.vue
index 4ef54bc8..b91679c3 100644
--- a/plugins/hushreader/src/components/Settings/index.vue
+++ b/plugins/hushreader/src/components/Settings/index.vue
@@ -698,6 +698,24 @@ function commitCapture(targetArr: string[]) {
             </div>
           </div>
 
+          <div class="setting-row">
+            <label>添加书签快捷键</label>
+            <div class="input-group">
+              <input class="key-input" :value="cfg.hushreader.addBookmarkKey"
+                @keydown.prevent="(e: KeyboardEvent) => { const b = getKeyBinding(e); if (b) cfg.hushreader.addBookmarkKey = b }"
+                placeholder="按下按键..." readonly />
+            </div>
+          </div>
+
+          <div class="setting-row">
+            <label>销毁隐阅窗口快捷键</label>
+            <div class="input-group">
+              <input class="key-input" :value="cfg.hushreader.destroyKey"
+                @keydown.prevent="(e: KeyboardEvent) => { const b = getKeyBinding(e); if (b) cfg.hushreader.destroyKey = b }"
+                placeholder="按下按键..." readonly />
+            </div>
+          </div>
+
           <div class="divider"></div>
           <div class="section-label">自动翻页</div>
 
@@ -771,14 +789,6 @@ function commitCapture(targetArr: string[]) {
 
           <div class="section-label">书架</div>
 
-          <div class="setting-row">
-            <label>列表书架模式</label>
-            <label class="toggle">
-              <input type="checkbox" v-model="cfg.other.listMode" />
-              <span class="toggle-track"></span>
-            </label>
-          </div>
-
           <div class="setting-row">
             <label>显示纯色封面</label>
             <label class="toggle">
diff --git a/plugins/hushreader/src/stores/books.ts b/plugins/hushreader/src/stores/books.ts
index 865195ef..618ddd5c 100644
--- a/plugins/hushreader/src/stores/books.ts
+++ b/plugins/hushreader/src/stores/books.ts
@@ -2,6 +2,15 @@ import { defineStore } from 'pinia'
 import { ref, computed } from 'vue'
 import { removeBookData, loadAllCovers } from '../utils/db'
 
+export interface Bookmark {
+  id: string
+  chapterIndex: number
+  charIndex: number
+  readingPercent: number
+  text: string
+  createdAt: number
+}
+
 export interface Book {
   id: string
   title: string
@@ -26,6 +35,8 @@ export interface Book {
   readingSpeed?: number
   lastSaveReadChars?: number
   fileModifiedAt?: number | null
+  finishedAt?: number
+  bookmarks?: Bookmark[]
 }
 
 function storageGet(key: string): string | null {
diff --git a/plugins/hushreader/src/stores/config.ts b/plugins/hushreader/src/stores/config.ts
index b13325da..a4f6eef2 100644
--- a/plugins/hushreader/src/stores/config.ts
+++ b/plugins/hushreader/src/stores/config.ts
@@ -12,6 +12,8 @@ export interface HushreaderConfig {
   wheelTurnPage: boolean
   prevPageKey: string
   nextPageKey: string
+  addBookmarkKey: string
+  destroyKey: string
   opacity: number
   bgOpacity: number
   bgColor: string
@@ -83,6 +85,8 @@ const DEFAULT_CONFIG: ReaderConfig = {
     wheelTurnPage: true,
     prevPageKey: 'ArrowLeft',
     nextPageKey: 'ArrowRight',
+    addBookmarkKey: 'Shift+F',
+    destroyKey: 'Shift+D',
     opacity: 82,
     bgOpacity: 100,
     bgColor: '#1e1f22',
diff --git a/plugins/hushreader/src/stores/reader.ts b/plugins/hushreader/src/stores/reader.ts
index 7e5e0d59..50cda5b6 100644
--- a/plugins/hushreader/src/stores/reader.ts
+++ b/plugins/hushreader/src/stores/reader.ts
@@ -52,10 +52,14 @@ export const useReaderStore = defineStore('reader', () => {
     if (chapters.value.length === 0) return 0
     const totalChars = chapters.value.reduce((sum, ch) => sum + ch.content.length, 0)
     if (totalChars === 0) return 0
+    const isLastChapter = currentChapterIndex.value === chapters.value.length - 1
+    const isLastPage = isLastChapter && currentPage.value === totalPages.value - 1
+    const effectiveIndex = isLastPage ? currentPageSlice.value.endIndex : progressIndex.value
     const readChars = chapters.value
       .slice(0, currentChapterIndex.value)
       .reduce((sum, ch) => sum + ch.content.length, 0)
-      + progressIndex.value
+      + effectiveIndex
+    if (readChars >= totalChars) return 100
     return Math.min(100, Math.floor((readChars / totalChars) * 10000) / 100)
   })
 
diff --git a/plugins/hushreader/ztools.api.md b/plugins/hushreader/ztools.api.md
deleted file mode 100644
index d66b4c95..00000000
--- a/plugins/hushreader/ztools.api.md
+++ /dev/null
@@ -1,543 +0,0 @@
-# ZTools 插件 API 文档
-ZTools 为插件提供了一套丰富的 API，通过全局对象 `window.ztools` 暴露。
-
-## 目录
-1. [基础 API](#基础-api)
-2. [事件 API](#事件-api)
-3. [搜索框 API](#搜索框-api)
-4. [数据库 API](#数据库-api)
-5. [dbStorage 简易键值存储](#dbstorage-api)
-6. [动态 Feature API](#动态-feature-api)
-7. [剪贴板 API](#剪贴板-api)
-8. [文件操作 API](#文件操作-api)
-9. [窗口 API](#窗口-api)
-10. [显示器 API](#显示器-api)
-11. [Shell API](#shell-api)
-12. [其他通用 API](#其他-api)
-13. [AI API](#ai-api)
-
-## 基础 API
-### ztools.getAppName()
-获取应用名称。
-- 返回: `string` - 应用名称，固定返回 `'ZTools'`。
-
-### ztools.getPathForFile(file)
-获取拖放文件的真实路径，用于处理用户拖放文件到插件界面场景（底层基于 Electron `webUtils.getPathForFile`）。
-- 参数：
-  - `file: File` - 拖放事件中的 File 对象
-- 返回: `string` - 文件本地路径
-
-### ztools.isMacOs() / ztools.isMacOS()
-检测当前是否为 macOS 系统。
-- 返回: `boolean`
-
-### ztools.isWindows()
-检测当前是否为 Windows 系统。
-- 返回: `boolean`
-
-### ztools.isLinux()
-检测当前是否为 Linux 系统。
-- 返回: `boolean`
-
-### ztools.getNativeId()
-获取设备唯一标识符（32位字符串）。
-- 返回: `string`
-
-### ztools.getAppVersion()
-获取应用版本号。
-- 返回: `string`
-
-### ztools.getWindowType()
-获取当前窗口类型。
-- 返回: `string`
-
-### ztools.isDarkColors()
-检测当前是否为深色主题。
-- 返回: `boolean`
-
-### ztools.isDev()
-检查当前插件是否处于开发模式。
-- 返回: `boolean`
-
-### ztools.getWebContentsId()
-获取当前 WebContents ID。
-- 返回: `number`
-
-### ztools.setExpendHeight(height)
-设置插件视图高度。
-- 参数：
-  - `height: number` - 期望高度，单位像素
-
-### ztools.showNotification(body)
-显示系统通知。
-- 参数：
-  - `body: string` - 通知文本内容
-
-### ztools.sendInputEvent(event)
-发送模拟输入事件。
-- 参数：
-  - `event: MouseInputEvent | MouseWheelInputEvent | KeyboardInputEvent`
-
-#### 事件对象结构
-##### KeyboardInputEvent 键盘事件
-```ts
-{
-  type: 'keyDown' | 'keyUp' | 'char',
-  keyCode: string,
-  modifiers: string[] // 修饰键，如 ['shift', 'control']
-}
-```
-
-##### MouseInputEvent 鼠标事件
-```ts
-{
-  type: 'mouseDown' | 'mouseUp' | 'mouseEnter' | 'mouseLeave' | 'contextMenu' | 'mouseMove',
-  x: number,
-  y: number,
-  button: 'left' | 'middle' | 'right',
-  clickCount: number
-}
-```
-
-##### MouseWheelInputEvent 滚轮事件
-```ts
-{
-  type: 'mouseWheel',
-  deltaX: number,
-  deltaY: number,
-  wheelTicksX: number,
-  wheelTicksY: number,
-  accelerationRatioX: number,
-  accelerationRatioY: number,
-  hasPreciseScrollingDeltas: boolean,
-  canScroll: boolean
-}
-```
-
-### ztools.simulateKeyboardTap(key, ...modifiers)
-模拟键盘按键。
-- 参数：
-  - `key: string` - 按键标识
-  - `modifiers: string[]` 可选，修饰键数组
-- 返回: `boolean` - 是否执行成功
-
-### ztools.showMainWindow()
-显示主窗口。
-- 返回: `Promise<boolean>`
-
-### ztools.hideMainWindow(isRestorePreWindow)
-隐藏主窗口，同时隐藏主窗口内运行的插件。
-- 参数：
-  - `isRestorePreWindow?: boolean` 可选，是否将焦点切回上一个活动窗口，默认 `true`
-- 返回: `Promise<boolean>`
-
-### ztools.outPlugin(isKill)
-退出插件应用，默认后台隐藏插件进程。
-- 参数：
-  - `isKill?: boolean` 可选，为 `true` 时强制杀死插件进程
-- 返回: `Promise<boolean>`
-
-## 事件 API
-### ztools.onPluginEnter(callback)
-监听插件打开事件，用户启动插件时触发。
-- 参数：
-  - `callback: (param: LaunchParam) => void`
-
-#### LaunchParam 结构
-```ts
-{
-  payload: any, // 外部传入数据，如搜索框文本
-  type: 'text' | 'regex' | 'over',
-  // text：普通文本匹配
-  // regex：正则匹配
-  // over：任意文本匹配
-  code: string // Feature 触发时对应的功能码
-}
-```
-
-### ztools.onPluginOut(callback)
-监听插件退出事件。
-- 参数：
-  - `callback: (isKill: boolean) => void`
-    - `isKill`：是否为强制杀死进程退出
-
-### ztools.onPluginDetach(callback)
-监听插件分离独立窗口事件，用户拖拽插件脱离主窗口时触发。
-- 参数：
-  - `callback: () => void`
-
-### ztools.onMainPush(callback, selectCallback)
-注册主搜索栏推送结果，无需打开插件即可展示搜索列表。
-- 参数：
-  - `callback: (queryData: any) => object[]`：输入查询回调，返回结果数组
-  - `selectCallback?: (selectData: any) => boolean`：选中结果回调，返回 `true` 自动进入插件
-
-### ztools.onPluginReady(callback)
-兼容旧版 API，功能等同于 `onPluginEnter`。
-- 参数：
-  - `callback: (param: LaunchParam) => void`
-
-## 搜索框 API
-### ztools.setSubInput(onChange, placeholder, isFocus)
-插件激活时配置主窗口子搜索框行为。
-- 参数：
-  - `onChange: (text: string) => void`：输入内容变更回调
-  - `placeholder: string`：输入框占位提示文字
-  - `isFocus?: boolean` 可选，自动聚焦输入框，默认 `true`
-
-### ztools.setSubInputValue(text)
-设置子输入框内容。
-- 参数：
-  - `text: string`
-
-### ztools.subInputFocus()
-主动聚焦子输入框。
-- 返回: `boolean`
-
-### ztools.subInputBlur()
-子输入框失焦，焦点切回插件页面。
-- 返回: `boolean`
-
-### ztools.subInputSelect()
-聚焦输入框并全选已有内容。
-- 返回: `boolean`
-
-### ztools.removeSubInput()
-隐藏/移除子搜索框。
-- 返回: `Promise<boolean>`
-
-## 数据库 API
-插件拥有独立隔离存储空间（Bucket），以插件标识隔离数据。同步方法如下：
-
-### ztools.db.put(doc)
-写入/更新文档，文档必须包含 `_id`。
-- 参数：
-  - `doc: object`
-- 返回: `object` - 写入后的完整文档（含 `_id`、`_rev`）
-
-### ztools.db.get(id)
-根据 ID 查询文档。
-- 参数：
-  - `id: string`
-- 返回: `object | null`，不存在返回 `null`
-
-### ztools.db.remove(docOrId)
-删除文档。
-- 参数：
-  - `docOrId: object | string`：完整文档对象（需 `_id/_rev`）或文档ID
-- 返回: `object` - 删除结果
-
-### ztools.db.bulkDocs(docs)
-批量新增/更新文档。
-- 参数：
-  - `docs: object[]`
-- 返回: `object[]` - 每条文档操作结果
-
-### ztools.db.allDocs(key)
-查询全部文档，支持 ID 前缀过滤。
-- 参数：
-  - `key?: string` 可选，文档ID前缀过滤
-- 返回: `object[]`
-
-### ztools.db.postAttachment(id, attachment, type)
-为文档添加二进制附件。
-- 参数：
-  - `id: string` 文档ID
-  - `attachment: string | Buffer` base64字符串或二进制Buffer
-  - `type: string` MIME类型
-- 返回: `object`
-
-### ztools.db.getAttachment(id)
-读取文档附件二进制内容。
-- 参数：
-  - `id: string`
-- 返回: `Buffer`
-
-### ztools.db.getAttachmentType(id)
-获取附件 MIME 类型。
-- 参数：
-  - `id: string`
-- 返回: `string`
-
-### Promise 异步版本数据库
-所有同步方法均存在异步 Promise 实现，挂载于 `ztools.db.promises`，方法签名一致，返回 Promise：
-```js
-window.ztools.db.promises.put(doc)
-window.ztools.db.promises.get(id)
-window.ztools.db.promises.remove(docOrId)
-window.ztools.db.promises.bulkDocs(docs)
-window.ztools.db.promises.allDocs(key)
-window.ztools.db.promises.postAttachment(id, attachment, type)
-window.ztools.db.promises.getAttachment(id)
-window.ztools.db.promises.getAttachmentType(id)
-```
-
-## dbStorage API
-轻量化键值持久化存储，类似 localStorage，自动 JSON 序列化。
-### ztools.dbStorage.setItem(key, value)
-- 参数：
-  - `key: string`
-  - `value: any` 任意可序列化数据
-
-### ztools.dbStorage.getItem(key)
-- 参数：
-  - `key: string`
-- 返回: `any | null`，无数据返回 `null`
-
-### ztools.dbStorage.removeItem(key)
-删除指定键。
-- 参数：
-  - `key: string`
-
-## 动态 Feature API
-### ztools.getFeatures(codes)
-获取动态注册功能项。
-- 参数：
-  - `codes?: string[]` 可选，指定功能码列表，不传返回全部
-- 返回: `object[]` Feature 数组
-
-### ztools.setFeature(feature)
-新增/更新动态 Feature。
-- 参数：
-  - `feature: object`
-- 返回: `boolean`
-
-### ztools.removeFeature(code)
-删除指定 Feature。
-- 参数：
-  - `code: string` Feature 唯一编码
-- 返回: `boolean`
-
-## 剪贴板 API
-### ztools.clipboard.getHistory(page, pageSize, filter)
-分页读取剪贴板历史记录。
-- 参数：
-  - `page: number` 页码，从 1 开始
-  - `pageSize: number` 单页条数
-  - `filter?: string` 过滤关键词
-- 返回: `Promise<object>`
-
-### ztools.clipboard.search(keyword)
-全文检索剪贴板历史。
-- 参数：
-  - `keyword: string`
-- 返回: `Promise<object[]>`
-
-### ztools.clipboard.delete(id)
-删除单条剪贴板历史记录。
-- 参数：
-  - `id: string` 记录ID
-- 返回: `Promise<boolean>`
-
-### ztools.clipboard.clear(type)
-清空剪贴板历史，支持类型过滤。
-- 参数：
-  - `type?: string` 可选，指定数据类型
-- 返回: `Promise<boolean>`
-
-### ztools.clipboard.getStatus()
-读取剪贴板模块运行状态。
-- 返回: `Promise<object>`
-
-### ztools.clipboard.write(id, shouldPaste)
-将历史记录重新写入系统剪贴板。
-- 参数：
-  - `id: string` 记录ID
-  - `shouldPaste?: boolean` 可选，写入后模拟粘贴，默认 `true`
-- 返回: `Promise<boolean>`
-
-### ztools.clipboard.writeContent(data, shouldPaste)
-自定义内容写入剪贴板。
-- 参数：
-  ```ts
-  data: {
-    type: 'text' | 'image',
-    content: string // 文本或base64图片
-  }
-  ```
-  - `shouldPaste?: boolean` 可选，默认 `true`
-- 返回: `Promise<boolean>`
-
-### ztools.clipboard.updateConfig(config)
-修改剪贴板模块全局配置。
-- 参数：
-  - `config: object`
-- 返回: `Promise<boolean>`
-
-### ztools.clipboard.onChange(callback)
-监听剪贴板新增记录事件。
-- 参数：
-  - `callback: (item: object) => void`
-
-### ztools.copyText(text)
-快速复制文本到剪贴板（同步）。
-- 参数：
-  - `text: string`
-- 返回: `boolean`
-
-### ztools.copyImage(image)
-复制图片到剪贴板。
-- 参数：
-  - `image: string` base64 DataURL 或本地文件路径
-- 返回: `boolean`
-
-### ztools.copyFile(filePath)
-复制文件到剪贴板。
-- 参数：
-  - `filePath: string` 文件完整路径
-- 返回: `boolean`
-
-## 文件操作 API
-### ztools.getPath(name)
-获取系统标准目录路径。
-- 参数：
-  - `name: string` 目录标识，支持 `home` / `desktop` / `documents` 等
-- 返回: `string`
-
-### ztools.showSaveDialog(options)
-弹出文件保存窗口（同步）。
-- 参数：
-  - `options: SaveDialogOptions` 配置同 Electron `showSaveDialogSync`
-- 返回: `string | undefined` 用户选择路径，取消返回 `undefined`
-
-### ztools.showOpenDialog(options)
-弹出文件选择窗口（同步）。
-- 参数：
-  - `options: OpenDialogOptions` 配置同 Electron `showOpenDialogSync`
-- 返回: `string[] | undefined` 选中文件路径数组，取消返回 `undefined`
-
-### ztools.screenCapture(callback)
-唤起系统截图工具，截图完成回调返回图片。
-- 参数：
-  - `callback: (image: string) => void`
-    - `image`：截图 base64 DataURL
-
-## 窗口 API
-### ztools.createBrowserWindow(url, options, callback)
-创建独立浏览器窗口。
-- 参数：
-  - `url: string` 页面加载地址
-  - `options: object` 窗口配置，兼容 Electron BrowserWindow 参数
-  - `callback?: () => void` 可选，窗口加载完成回调
-- 返回: `Proxy<BrowserWindow> | null` 窗口代理对象，创建失败返回 `null`
-
-### ztools.sendToParent(channel, ...args)
-向父窗口发送 IPC 消息。
-- 参数：
-  - `channel: string` 消息通道名
-  - `args: any[]` 透传参数列表
-
-## 显示器 API
-### ztools.getPrimaryDisplay()
-获取主显示器信息。
-- 返回: `object`
-
-### ztools.getAllDisplays()
-获取全部显示器列表。
-- 返回: `object[]`
-
-### ztools.getCursorScreenPoint()
-获取鼠标光标屏幕坐标。
-- 返回: `{ x: number, y: number }`
-
-### ztools.getDisplayNearestPoint(point)
-根据坐标查找最近的显示器。
-- 参数：
-  - `point: { x: number, y: number }`
-- 返回: `object` 显示器信息
-
-### ztools.desktopCaptureSources(options)
-获取屏幕/窗口捕获源列表（录屏截图使用）。
-- 参数：
-  - `options: object`
-- 返回: `Promise<object[]>`
-
-### ztools.dipToScreenPoint(point)
-DIP 逻辑坐标 → 屏幕物理像素坐标。
-- 参数：
-  - `point: { x: number, y: number }`
-- 返回: `{ x: number, y: number }`
-
-### ztools.screenToDipPoint(point)
-屏幕物理像素坐标 → DIP 逻辑坐标。
-- 参数：
-  - `point: { x: number, y: number }`
-- 返回: `{ x: number, y: number }`
-
-### ztools.dipToScreenRect(rect)
-DIP 矩形区域 → 物理像素矩形。
-- 参数：
-  - `rect: { x: number, y: number, width: number, height: number }`
-- 返回: `{ x: number, y: number, width: number, height: number }`
-
-## Shell API
-### ztools.shellOpenExternal(url)
-系统默认浏览器打开网页链接。
-- 参数：
-  - `url: string`
-- 返回: `boolean`
-
-### ztools.shellOpenPath(fullPath)
-使用系统默认程序打开文件/文件夹。
-- 参数：
-  - `fullPath: string` 完整本地路径
-- 返回: `boolean`
-
-### ztools.shellShowItemInFolder(fullPath)
-文件管理器定位并选中目标文件。
-- 参数：
-  - `fullPath: string` 文件路径
-- 返回: `boolean`
-
-## 其他 API
-### ztools.redirect(label, payload)
-插件间跳转。
-- 参数：
-  - `label: string` 目标插件标识
-  - `payload: any` 传递数据
-- 返回: `boolean`
-
-### ztools.http.setHeaders(headers)
-全局设置 HTTP 请求公共请求头。
-- 参数：
-  - `headers: object`
-- 返回: `boolean`
-
-### ztools.http.getHeaders()
-读取当前全局请求头。
-- 返回: `object`
-
-### ztools.http.clearHeaders()
-清空全局 HTTP 请求头配置。
-- 返回: `boolean`
-
-## AI API
-### ztools.ai(option, streamCallback)
-调用内置 AI 模型，支持流式输出与中断请求。
-- 参数：
-  - `option: object` AI 请求配置，必填 `prompt` 字段
-  - `streamCallback?: (chunk: any) => void` 可选，传入则启用流式分段回调
-- 返回: `PromiseLike & { abort: () => void }`
-  - 非流式：await 直接获取完整返回结果
-  - 流式：分段数据通过 streamCallback 推送，await 等待请求结束
-  - `.abort()` 手动中断当前 AI 请求
-
-#### 使用示例
-```js
-// 非流式完整返回
-const result = await ztools.ai({ prompt: '你好' })
-
-// 流式逐段接收
-const request = ztools.ai({ prompt: '你好' }, (chunk) => {
-  console.log('流式分片：', chunk)
-})
-await request
-
-// 中途终止AI请求
-request.abort()
-```
-
-### ztools.allAiModels()
-获取全部可用 AI 模型列表。
-- 返回: `Promise<object[]>`
-- 异常：接口获取失败抛出 Error
\ No newline at end of file