+
+))
+CommandInput.displayName = 'CommandInput'
+
+export const CommandList = React.forwardRef<
+ React.ElementRef
+
+
+
+
+ {shelf.length === 0 ? (
+
+
+ {
+ jumpTo(openChapter, idx, offset)
+ setOpenChapter(null)
+ }}
+ />
+ )}
+ {openSearch && parsedRef.current[openSearch.path] && (
+ {
+ jumpTo(openSearch, idx, offset)
+ setOpenSearch(null)
+ }}
+ />
+ )}
+
+ )
+
+ function openBook(b: ShelfBook) {
+ if (parsedRef.current[b.path]) {
+ launchReader(b, parsedRef.current[b.path])
+ } else {
+ openFile(b.path, b.type)
+ }
+ }
+
+ function jumpTo(b: ShelfBook, chapterIndex: number, charOffset?: number) {
+ updateBookInShelf(b.id, { lastChapter: chapterIndex, progress: charOffset })
+ b.lastChapter = chapterIndex
+ b.progress = charOffset
+ const book = parsedRef.current[b.path]
+ if (book) launchReader(b, book, { chapterIndex, charOffset })
+ }
+
+ function pickFile() {
+ const files = window.services?.showOpenDialog?.({
+ title: '选择阅读文件',
+ filters: [{ name: '支持的格式', extensions: ['txt', 'epub', 'pdf'] }],
+ properties: ['openFile'],
+ })
+ if (files?.length) openFile(files[0])
+ }
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/main/components/BookCard.tsx b/plugins/serious-reading/src/main/components/BookCard.tsx
new file mode 100644
index 00000000..c71c19e4
--- /dev/null
+++ b/plugins/serious-reading/src/main/components/BookCard.tsx
@@ -0,0 +1,59 @@
+import { useState } from 'react'
+import { MoreVertical, BookMarked, Search, Trash2 } from 'lucide-react'
+import type { ShelfBook } from '@/shared/types'
+import {
+ DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator,
+} from '@/components/ui/dropdown-menu'
+
+export function BookCard(props: {
+ book: ShelfBook
+ cover?: string
+ progress: number
+ onOpen: () => void
+ onChapter: () => void
+ onSearch: () => void
+ onDelete: () => void
+}) {
+ const [menu, setMenu] = useState(false)
+ return (
+
+
+
+
+
+
+
+
+
+ ) : (
+
+ {shelf.map((b) => (
+ openBook(b)}
+ onChapter={() => setOpenChapter(b)}
+ onSearch={() => setOpenSearch(b)}
+ onDelete={() => {
+ removeBookFromShelf(b.id)
+ setShelf(getShelf())
+ }}
+ />
+ ))}
+
+
+ )}
+
+ {recents.length > 0 && shelf.length > 0 && (
+
+
+ )}
+ 最近阅读
+
+ {recents.slice(0, 8).map((r) => (
+
+ ))}
+
+
+
+
+ )
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/main/components/ChapterDialog.tsx b/plugins/serious-reading/src/main/components/ChapterDialog.tsx
new file mode 100644
index 00000000..35826079
--- /dev/null
+++ b/plugins/serious-reading/src/main/components/ChapterDialog.tsx
@@ -0,0 +1,50 @@
+import { useState, useMemo } from 'react'
+import type { ShelfBook, ParsedBook, Settings } from '@/shared/types'
+import { searchChapters } from '@/shared/parser'
+import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@/components/ui/dialog'
+import { Input } from '@/components/ui/input'
+import { Button } from '@/components/ui/button'
+import { Search } from 'lucide-react'
+
+export function ChapterDialog(props: {
+ book: ShelfBook
+ parsed: ParsedBook | undefined
+ settings: Settings
+ onSkip: (chapterIndex: number, charOffset?: number) => void
+}) {
+ const [kw, setKw] = useState('')
+ const [committed, setCommitted] = useState('')
+ const list = useMemo(() => {
+ if (!props.parsed) return []
+ if (!committed) return props.parsed.chapters
+ return searchChapters(props.parsed.chapters, committed)
+ }, [props.parsed, committed])
+
+ const curIdx = props.book.lastChapter ?? 0
+
+ return (
+
+ )
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/main/components/SearchDialog.tsx b/plugins/serious-reading/src/main/components/SearchDialog.tsx
new file mode 100644
index 00000000..c5d9592a
--- /dev/null
+++ b/plugins/serious-reading/src/main/components/SearchDialog.tsx
@@ -0,0 +1,80 @@
+import { useState } from 'react'
+import type { ShelfBook, ParsedBook, Settings } from '@/shared/types'
+import { searchFullText } from '@/shared/parser'
+import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@/components/ui/dialog'
+import { Input } from '@/components/ui/input'
+import { Button } from '@/components/ui/button'
+import { Search } from 'lucide-react'
+
+export function SearchDialog(props: {
+ book: ShelfBook
+ parsed: ParsedBook
+ settings: Settings
+ onSkip: (chapterIndex: number, charOffset: number) => void
+}) {
+ const [kw, setKw] = useState('')
+ const [items, setItems] = useState<{ index: number; snippet: string }[]>([])
+ const [hasMore, setHasMore] = useState(false)
+ const [from, setFrom] = useState(0)
+
+ const fullText = props.parsed.fullText
+ if (!fullText) {
+ return (
+
+ )
+ }
+
+ function doSearch(reset: boolean) {
+ const start = reset ? 0 : from
+ const { results, hasMore: hm } = searchFullText(fullText!, kw, 10, start)
+ setItems(reset ? results : [...items, ...results])
+ setHasMore(hm)
+ setFrom(start + results.length + 1)
+ }
+
+ /** 由字符 offset 定位所属章节 + 页内偏移 */
+ function locate(offset: number) {
+ const chapters = props.parsed.chapters
+ let chapter = 0
+ for (let i = 0; i < chapters.length; i++) {
+ if ((chapters[i].charOffset ?? 0) <= offset && offset < (chapters[i].charOffset ?? 0) + (chapters[i].charLength ?? 0)) {
+ chapter = i
+ break
+ }
+ if (i === chapters.length - 1) chapter = i
+ }
+ props.onSkip(chapter, offset)
+ }
+
+ return (
+
+ )
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/main/components/SettingsDialog.tsx b/plugins/serious-reading/src/main/components/SettingsDialog.tsx
new file mode 100644
index 00000000..2b152e75
--- /dev/null
+++ b/plugins/serious-reading/src/main/components/SettingsDialog.tsx
@@ -0,0 +1,293 @@
+import { useState, useEffect, useRef } from 'react'
+import type { Settings, TriggerKey, HideActions } from '@/shared/types'
+import { TRIGGER_OPTIONS, detectConflicts, DEFAULT_SETTINGS, FONT_OPTIONS } from '@/shared/constants'
+import { saveSettings } from '@/shared/storage'
+import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter } from '@/components/ui/dialog'
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem } from '@/components/ui/dropdown-menu'
+import { Slider } from '@/components/ui/slider'
+import { Switch } from '@/components/ui/switch'
+import { Checkbox } from '@/components/ui/checkbox'
+
+const PAGE_KEYS: { key: 'arrow' | 'wheel' | 'click' | 'pgupdn' | 'space' | 'touch'; label: string }[] = [
+ { key: 'arrow', label: '键盘 ←→' },
+ { key: 'wheel', label: '滚轮' },
+ { key: 'click', label: '点击左右' },
+ { key: 'pgupdn', label: 'PageUp/Down' },
+ { key: 'space', label: '空格' },
+ { key: 'touch', label: '触摸滑动' },
+]
+
+export function SettingsDialog(props: {
+ open: boolean
+ onOpenChange: (v: boolean) => void
+ settings: Settings
+ setSettings: (s: Settings) => void
+ setTheme: (t: Settings['theme']) => void
+}) {
+ const [draft, setDraft] = useState{props.book.name}
+
+
+
+
+
+
+
+
+
+
+
+ )
+}
+function Field({ label, children }: { label: string; children: React.ReactNode }) {
+ return (
+ {title}
+ {children}
+
+
+ )
+}
+
+function ColorPicker({ value, onChange }: { value: string; onChange: (v: string) => void }) {
+ const ref = useRef{label}
+ {children}
+ { if (e.key === 'Escape') { setPicking(false); setScreenImg(null) } }}>
+
+
+ )}
+ 点击任意位置取色 · Esc 取消
+
+
+
+ )
+}
+
+function isLight(hex: string): boolean {
+ const r = parseInt(hex.slice(1, 3), 16), g = parseInt(hex.slice(3, 5), 16), b = parseInt(hex.slice(5, 7), 16)
+ return (r * 299 + g * 587 + b * 114) / 1000 > 128
+}
+
+function FontSelect({ value, onChange }: { value: string; onChange: (v: string) => void }) {
+ const current = FONT_OPTIONS.find((f) => f.value === value)
+ return (
+
+ 吸
+
+ { onChange(e.target.value); setHex(e.target.value) }} className="h-9 flex-1 rounded border" />
+ 正在加载…
']) + const measureRef = useRef本章无内容
']) + setPageIndex((p) => p === -1 ? result.length - 1 : Math.min(p, result.length - 1)) + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [chapterHtml, settings.reader.fontSize, settings.reader.lineHeight, settings.reader.fontWeight, settings.reader.fontFamily, resizeN]) + + /* ---- 百分比 ---- */ + const percent = useMemo(() => { + if (!book) return 0 + if (book.format === 'pdf') return pdfTotal ? (pdfPage / pdfTotal) * 100 : 0 + if (book.fullText) return ((charOffset / book.fullText.length) * 100) + return book.totalChapters ? ((chapterIdx + 1) / book.totalChapters) * 100 : 0 + }, [book, charOffset, chapterIdx, pdfPage, pdfTotal]) + + /* ---- 翻页 ---- */ + const nextPage = useCallback(() => { + if (book?.format === 'pdf') { setPdfPage((p) => Math.min(p + 1, pdfTotal || p + 1)); return } + if (pageIndex < pages.length - 1) setPageIndex(pageIndex + 1) + else nextChapter() + }, [book, pageIndex, pages.length]) + + const prevPage = useCallback(() => { + if (book?.format === 'pdf') { setPdfPage((p) => Math.max(1, p - 1)); return } + if (pageIndex > 0) setPageIndex(pageIndex - 1) + else prevChapter() + }, [book, pageIndex]) + + // 用 ref 持有最新回调/状态，避免 document 事件监听反复挂载 + const nextPageRef = useRef(nextPage); nextPageRef.current = nextPage + const prevPageRef = useRef(prevPage); prevPageRef.current = prevPage + const pagesRef = useRef(pages); pagesRef.current = pages + const hideRef = useRef(settings.hide); hideRef.current = settings.hide + const pageCfgRef = useRef(settings.page); pageCfgRef.current = settings.page + const stealthRef = useRef(stealth); stealthRef.current = stealth + + function nextChapter() { + if (!book || book.format === 'pdf') return + if (chapterIdx < book.totalChapters - 1) { + const ni = chapterIdx + 1 + setPages(['…
']) + setChapterIdx(ni) + setCharOffset(book.chapters[ni]?.charOffset ?? 0) + setPageIndex(0) + } + } + function prevChapter() { + if (!book || book.format === 'pdf') return + if (chapterIdx > 0) { + const pi = chapterIdx - 1 + setPages(['…
']) + setChapterIdx(pi) + setCharOffset(book.chapters[pi]?.charOffset ?? 0) + setPageIndex(-1) + } + } + function goChapter(idx: number) { + if (!book || book.format === 'pdf') return + if (idx >= 0 && idx < book.totalChapters) { + setChapterIdx(idx) + setCharOffset(book.chapters[idx]?.charOffset ?? 0) + setPageIndex(0) + } + } + + /* ---- 进度保存 ---- */ + useEffect(() => { + if (!book) return + const t = setTimeout(() => { + const pg: ReadingProgress = { + filePath: book.filePath, format: book.format, + chapterIndex: book.format === 'pdf' ? pdfPage : chapterIdx, + pageIndex, charOffset, totalChapters: book.totalChapters, timestamp: Date.now(), + } + saveProgress(pg) + sendParent?.('sr:save-progress', pg) + }, 400) + return () => clearTimeout(t) + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [chapterIdx, pageIndex, charOffset, pdfPage]) + + /* ---- document 级事件：阅读窗容器是 drag region，React 事件会被吞掉 ---- */ + function dispatchTrigger(key: TriggerKey, e?: Event) { + const hide = hideRef.current + if (hide.realHide.includes(key)) { e?.preventDefault?.(); sendParent?.('sr:hide-reader'); return } + const isStealth = stealthRef.current + if (!isStealth && hide.stealthHide.includes(key)) { setStealth(true); return } + if (isStealth && hide.stealthShow.includes(key)) { setStealth(false); return } + } + useEffect(() => { + window.focus() + const onKey = (e: KeyboardEvent) => { + const hide = hideRef.current + if (e.key === 'Escape' && (hide.stealthHide.includes('escape') || hide.stealthShow.includes('escape') || hide.realHide.includes('escape'))) { dispatchTrigger('escape', e); e.preventDefault(); return } + const p = pageCfgRef.current + if (p.arrow && e.key === 'ArrowRight') { nextPageRef.current(); e.preventDefault() } + if (p.arrow && e.key === 'ArrowLeft') { prevPageRef.current(); e.preventDefault() } + if (p.pgupdn && e.key === 'PageDown') { nextPageRef.current(); e.preventDefault() } + if (p.pgupdn && e.key === 'PageUp') { prevPageRef.current(); e.preventDefault() } + if (p.space && e.key === ' ') { nextPageRef.current(); e.preventDefault() } + if (e.key === 'Home') { setPageIndex(0) } + if (e.key === 'End') { setPageIndex(pagesRef.current.length - 1) } + } + const onDbl = (e: MouseEvent) => { dispatchTrigger('dblclick', e) } + const onDown = (e: MouseEvent) => { if (e.button === 1) dispatchTrigger('middleClick', e) } + const onCtx = (e: MouseEvent) => { + const hide = hideRef.current + if (hide.realHide.includes('rightClick') || hide.stealthHide.includes('rightClick') || hide.stealthShow.includes('rightClick')) { e.preventDefault(); dispatchTrigger('rightClick', e) } + } + const onLeave = () => { dispatchTrigger('mouseleave') } + const onEnter = () => { dispatchTrigger('mouseenter') } + const onWheel = (e: WheelEvent) => { + if (pageCfgRef.current.wheel) { e.preventDefault(); if (e.deltaY > 0 || e.deltaX > 0) nextPageRef.current(); else prevPageRef.current() } + } + let tx = 0, ty = 0 + const onTouchStart = (e: TouchEvent) => { tx = e.touches[0].clientX; ty = e.touches[0].clientY } + const onTouchEnd = (e: TouchEvent) => { + if (!pageCfgRef.current.touch) return + const dx = e.changedTouches[0].clientX - tx + const dy = e.changedTouches[0].clientY - ty + if (Math.abs(dx) > Math.abs(dy) && Math.abs(dx) > 50) { if (dx < 0) nextPageRef.current(); else prevPageRef.current() } + } + document.addEventListener('keydown', onKey) + document.addEventListener('dblclick', onDbl) + document.addEventListener('mousedown', onDown) + document.addEventListener('contextmenu', onCtx) + document.addEventListener('mouseleave', onLeave) + document.addEventListener('mouseenter', onEnter) + document.addEventListener('wheel', onWheel, { passive: false }) + document.addEventListener('touchstart', onTouchStart) + document.addEventListener('touchend', onTouchEnd) + return () => { + document.removeEventListener('keydown', onKey) + document.removeEventListener('dblclick', onDbl) + document.removeEventListener('mousedown', onDown) + document.removeEventListener('contextmenu', onCtx) + document.removeEventListener('mouseleave', onLeave) + document.removeEventListener('mouseenter', onEnter) + document.removeEventListener('wheel', onWheel) + document.removeEventListener('touchstart', onTouchStart) + document.removeEventListener('touchend', onTouchEnd) + } + // eslint-disable-next-line react-hooks/exhaustive-deps + }, []) + + /* ---- 自动翻页 ---- */ + useEffect(() => { + const interval = settings.autoPage.interval + if (!interval || interval <= 0) return + if (stealth && settings.autoPage.pauseOnStealth) return + const t = setInterval(() => nextPage(), interval * 1000) + return () => clearInterval(t) + // eslint-disable-next-line react-hooks/exhaustive-deps + }, [settings.autoPage, nextPage, stealth]) + + /* ---- 中间区域拖动移动窗口 ---- */ + useEffect(() => { + if (!dragWin) return + const onMove = (e: MouseEvent) => { + sendParent?.('sr:win-delta', { type: 'move', dx: e.screenX - dragWin.sx, dy: e.screenY - dragWin.sy }) + } + const onUp = () => { + sendParent?.('sr:win-end') + setDragWin(null) + } + document.addEventListener('mousemove', onMove) + document.addEventListener('mouseup', onUp) + return () => { document.removeEventListener('mousemove', onMove); document.removeEventListener('mouseup', onUp) } + }, [dragWin, sendParent]) + + /* ---- resize 重排 ---- */ + useEffect(() => { + const onRes = () => setResizeN((n) => n + 1) + window.addEventListener('resize', onRes) + const saveT = setInterval(() => sendBounds(), 5000) + window.addEventListener('beforeunload', sendBounds) + return () => { window.removeEventListener('resize', onRes); clearInterval(saveT); window.removeEventListener('beforeunload', sendBounds) } + // eslint-disable-next-line react-hooks/exhaustive-deps + }, []) + + function sendBounds() { + const x = window.screenLeft, y = window.screenTop, w = window.innerWidth, h = window.innerHeight + if (w > 120 && h > 120 && w < 8000 && h < 8000) sendParent?.('sr:save-bounds', { x, y, width: w, height: h }) + } + + /* ---- 百分比跳转 ---- */ + function jumpPercent(v: number) { + if (!book) return + if (book.format === 'pdf') { setPdfPage(Math.max(1, Math.ceil((v / 100) * pdfTotal))); return } + if (book.fullText) { + const target = Math.round((v / 100) * book.fullText.length) + let ci = 0 + for (let i = 0; i < book.chapters.length; i++) { + const c = book.chapters[i] + if ((c.charOffset ?? 0) <= target) ci = i + } + setChapterIdx(ci); setCharOffset(target); setPageIndex(0) + } else { + const ci = Math.min(book.totalChapters - 1, Math.floor((v / 100) * book.totalChapters)) + goChapter(ci) + } + } + + if (!book && !pdfData) { + return正在加载…
+ }
+
+ return (
+
+ {/* 纯 JS 窗口移动 + 缩放把手（不使用 drag region，避免吞掉右键/中键） */}
+
e.preventDefault()}
+ >
+ {/* 测量容器 */}
+
+
+ {/* PDF 模式 */}
+ {book?.format === 'pdf' && pdfData ? (
+ (null)
+ const [total, setTotal] = useState(0)
+
+ useEffect(() => {
+ let cancelled = false
+ ;(async () => {
+ const buf = props.data
+ const loadingTask = pdfjsLib.getDocument({ data: buf })
+ const pdf = await loadingTask.promise
+ if (cancelled) return
+ if (!total) { setTotal(pdf.numPages); props.onPageReady(pdf.numPages) }
+ const num = Math.max(1, Math.min(props.page, pdf.numPages))
+ const page = await pdf.getPage(num)
+ const viewport = page.getViewport({ scale: props.scale || 1.2 })
+ const canvas = canvasRef.current
+ if (!canvas) { if (cancelled) return; return }
+ const ctx = canvas.getContext('2d')!
+ const dpr = window.devicePixelRatio || 1
+ canvas.width = viewport.width * dpr
+ canvas.height = viewport.height * dpr
+ canvas.style.width = viewport.width + 'px'
+ canvas.style.height = viewport.height + 'px'
+ await page.render({ canvasContext: ctx, viewport, transform: dpr !== 1 ? [dpr, 0, 0, dpr, 0, 0] : undefined } as any).promise
+ })().catch((e) => console.error('pdf render', e))
+ return () => { cancelled = true }
+ // eslint-disable-next-line react-hooks/exhaustive-deps
+ }, [props.data, props.page, props.scale])
+
+ return (
+
+ ,
+)
\ No newline at end of file
diff --git a/plugins/serious-reading/src/reader/usePagination.ts b/plugins/serious-reading/src/reader/usePagination.ts
new file mode 100644
index 00000000..70dd7994
--- /dev/null
+++ b/plugins/serious-reading/src/reader/usePagination.ts
@@ -0,0 +1,55 @@
+import { useEffect, useRef, useState } from 'react'
+
+/** 简单的高度测量分页：渲染内容到隐藏容器，按节点 height 累加断页。 */
+export function usePaginate(html: string, fontSize: number, lineHeight: number) {
+ const [pages, setPages] = useState([''])
+ const measureRef = useRef(null)
+
+ useLayoutPaginate(() => {
+ const measure = measureRef.current
+ if (!measure) return
+ const pageH = window.innerHeight - 48
+ const pageW = window.innerWidth - 64
+ measure.style.width = pageW + 'px'
+ measure.style.fontSize = fontSize + 'px'
+ measure.style.lineHeight = String(lineHeight)
+ measure.innerHTML = html
+ // 文本节点包 span 以便测量
+ const nodes: { height: number; html: string }[] = []
+ measure.childNodes.forEach((node) => {
+ if (node.nodeType === 3 && node.textContent?.trim()) {
+ const span = document.createElement('span')
+ span.textContent = node.textContent
+ measure.replaceChild(span, node)
+ nodes.push({ height: span.offsetHeight, html: span.outerHTML })
+ } else if (node.nodeType === 1) {
+ const el = node as HTMLElement
+ nodes.push({ height: el.offsetHeight, html: el.outerHTML })
+ }
+ })
+ const result: string[] = []
+ let cur = ''
+ let used = 0
+ for (const n of nodes) {
+ if (used + n.height > pageH && used > 0) {
+ result.push(cur)
+ cur = ''
+ used = 0
+ }
+ cur += n.html
+ used += n.height
+ }
+ if (cur) result.push(cur)
+ measure.innerHTML = ''
+ setPages(result.length ? result : [''])
+ }, [html, fontSize, lineHeight, window.innerHeight, window.innerWidth])
+
+ return { pages, measureRef }
+}
+
+import { useLayoutEffect } from 'react'
+function useLayoutPaginate(fn: () => void, deps: any[]) {
+ // eslint-disable-next-line react-hooks/exhaustive-deps
+ useLayoutEffect(fn, deps)
+ // debounce re-paginate on resize handled by signal in deps (window size)
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/shared/constants.ts b/plugins/serious-reading/src/shared/constants.ts
new file mode 100644
index 00000000..651a5c94
--- /dev/null
+++ b/plugins/serious-reading/src/shared/constants.ts
@@ -0,0 +1,65 @@
+import type { Settings, TriggerKey } from './types'
+
+/** 存储键前缀 */
+export const DB_PREFIX = 'serious_reading/'
+
+/** 触发动作的可选项（用于设置面板勾选） */
+export const TRIGGER_OPTIONS: { key: TriggerKey; label: string }[] = [
+ { key: 'dblclick', label: '双击' },
+ { key: 'middleClick', label: '中键' },
+ { key: 'rightClick', label: '右键' },
+ { key: 'escape', label: 'Esc' },
+ { key: 'mouseleave', label: '鼠标离开边缘' },
+ { key: 'mouseenter', label: '鼠标进入边缘' },
+]
+
+/** 三功能之间的冲突判定：同一触发键不能被多个功能同时启用 */
+export function detectConflicts(hide: Settings['hide']): Record {
+ const assigned: Record = {}
+ for (const k of hide.stealthHide) assigned[k] = assigned[k] ? assigned[k] + '/隐身' : '隐身'
+ for (const k of hide.stealthShow) assigned[k] = assigned[k] ? assigned[k] + '/显示' : '显示'
+ for (const k of hide.realHide) assigned[k] = assigned[k] ? assigned[k] + '/真隐藏' : '真隐藏'
+ const out = {} as Record
+ for (const k of Object.keys(assigned) as TriggerKey[]) {
+ out[k] = assigned[k].includes('/') ? assigned[k] : null
+ }
+ return out
+}
+
+export const DEFAULT_SETTINGS: Settings = {
+ theme: 'auto',
+ window: { width: 520, height: 780, x: -1, y: -1 },
+ reader: {
+ bgColor: '#f5f5f5',
+ textColor: '#1a1a1a',
+ opacity: 1,
+ fontSize: 17,
+ lineHeight: 1.85,
+ fontFamily: 'default',
+ fontWeight: 400,
+ cleanEmptyLines: false,
+ },
+ page: { arrow: true, wheel: true, click: true, pgupdn: true, space: false, touch: true, transition: 'none' },
+ hide: {
+ stealthHide: ['escape', 'dblclick', 'mouseleave'],
+ stealthShow: ['middleClick'],
+ realHide: ['rightClick'],
+ },
+ autoPage: { interval: 0, pauseOnStealth: true },
+}
+
+export const SUPPORTED_EXTS = ['txt', 'epub', 'pdf']
+
+export const FONT_OPTIONS: { value: string; label: string }[] = [
+ { value: 'default', label: '默认' },
+ { value: "'Microsoft YaHei', '微软雅黑', sans-serif", label: '微软雅黑' },
+ { value: "'SimSun', '宋体', serif", label: '宋体' },
+ { value: "'SimHei', '黑体', sans-serif", label: '黑体' },
+ { value: "'KaiTi', '楷体', serif", label: '楷体' },
+ { value: "'FangSong', '仿宋', serif", label: '仿宋' },
+ { value: "'PingFang SC', '苹方', sans-serif", label: '苹方' },
+ { value: "'Source Han Sans SC', '思源黑体', sans-serif", label: '思源黑体' },
+ { value: "'Source Han Serif SC', '思源宋体', serif", label: '思源宋体' },
+ { value: "Georgia, 'Times New Roman', serif", label: 'Georgia' },
+ { value: "'Courier New', monospace", label: 'Courier New' },
+]
\ No newline at end of file
diff --git a/plugins/serious-reading/src/shared/ipc.ts b/plugins/serious-reading/src/shared/ipc.ts
new file mode 100644
index 00000000..ecbc0eae
--- /dev/null
+++ b/plugins/serious-reading/src/shared/ipc.ts
@@ -0,0 +1,31 @@
+/**
+ * 父（主窗）↔ 子（阅读窗）之间的 IPC 通道。
+ * 阅读窗的 BrowserWindow proxy 由主窗 preload 持有，真隐藏等操作需经 IPC 回主窗；
+ * 其余阅读交互在阅读窗内自闭环，不经过 IPC。
+ */
+export const IPC = {
+ /** 阅读窗 → 主窗：通知主窗隐藏阅读窗（真隐藏 win.hide()） */
+ HIDE_READER: 'sr:hide-reader',
+ /** 阅读窗 → 主窗：保存阅读窗的位置/尺寸 */
+ SAVE_BOUNDS: 'sr:save-bounds',
+ /** 阅读窗 → 主窗：阅读进度变化（用于主窗刷新书架进度展示） */
+ PROGRESS: 'sr:progress',
+ /** 主窗 → 阅读窗：推送新的阅读状态（打开新文件/切章） */
+ READING_STATE: 'sr:reading-state',
+ /** 主窗 → 阅读窗：请求显示阅读窗（命令恢复） */
+ SHOW_READER: 'sr:show-reader',
+} as const
+
+export type IpcChannel = (typeof IPC)[keyof typeof IPC]
+
+/** 通过 reading-state 通道下发给阅读窗的状态 */
+export interface ReadingState {
+ filePath: string
+ format: 'txt' | 'epub' | 'pdf'
+ settings?: any
+ chapterIndex?: number
+ pageIndex?: number
+ charOffset?: number
+ /** PDF 页码 */
+ pdfPage?: number
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/shared/parser.ts b/plugins/serious-reading/src/shared/parser.ts
new file mode 100644
index 00000000..82e929a2
--- /dev/null
+++ b/plugins/serious-reading/src/shared/parser.ts
@@ -0,0 +1,155 @@
+import type { ParsedBook, Chapter, BookFormat } from './types'
+
+/** 中文小说章节标题正则（沿用 Serious-Reading 验证过的模式） */
+const CHAPTER_RE = /^(第[零一二三四五六七八九十百千万壹贰叁肆伍陆柒捌玖拾佰仟\d]+[章节回卷集部篇](?![的得了地]))\s*(.*)/gm
+
+function extractTitle(filePath: string): string {
+ const name = filePath.replace(/\\/g, '/').split('/').pop() ?? filePath
+ return name.replace(/\.[^.]+$/, '')
+}
+
+/**
+ * 解析 TXT：通过 preload 解码后切章。
+ * 同时计算每章在全文字符流中的偏移，供百分比跳转。
+ */
+export function parseTxt(content: string, filePath: string): ParsedBook {
+ if (content.charCodeAt(0) === 0xfeff) content = content.substring(1)
+ const chapters: Chapter[] = []
+ let lastChapterEnd = 0
+ let match: RegExpExecArray | null
+ CHAPTER_RE.lastIndex = 0
+ while ((match = CHAPTER_RE.exec(content)) !== null) {
+ if (chapters.length === 0 && match.index > 0) {
+ const pre = content.substring(0, match.index).trim()
+ if (pre.length > 0) chapters.push({ title: '开篇', index: 0, content: pre, charOffset: 0 })
+ } else if (chapters.length > 0) {
+ chapters[chapters.length - 1].content = content
+ .substring(lastChapterEnd, match.index)
+ .trim()
+ }
+ chapters.push({ title: match[0].trim(), index: chapters.length, content: '', charOffset: match.index })
+ lastChapterEnd = match.index + match[0].length
+ if (chapters.length > 5000) break
+ }
+ if (chapters.length > 0) {
+ chapters[chapters.length - 1].content = content.substring(lastChapterEnd).trim()
+ } else {
+ chapters.push({ title: '全文', index: 0, content: content.trim(), charOffset: 0 })
+ }
+ // 计算 charLength
+ let acc = 0
+ for (const ch of chapters) {
+ ch.charOffset = ch.charOffset ?? acc
+ ch.charLength = ch.content.length
+ acc = (ch.charOffset ?? 0) + ch.charLength
+ }
+ return { title: extractTitle(filePath), filePath, format: 'txt' as BookFormat, chapters, totalChapters: chapters.length, fullText: content }
+}
+
+/** EPUB：preload 已通过 adm-zip 提取，直接接收 */
+export function buildEpub(ebook: EBook, filePath: string): ParsedBook {
+ return {
+ title: ebook.title || extractTitle(filePath),
+ filePath,
+ format: 'epub',
+ chapters: ebook.chapters.map((c, i) => ({ title: c.title, index: i, content: c.content })),
+ totalChapters: ebook.chapters.length,
+ }
+}
+
+/** PDF：仅返回元信息，真正渲染由阅读窗用 pdfjs 处理 */
+export function buildPdf(filePath: string, totalPdfPages: number): ParsedBook {
+ return {
+ title: extractTitle(filePath),
+ filePath,
+ format: 'pdf',
+ chapters: [{ title: 'PDF', index: 0, content: '' }],
+ totalChapters: 1,
+ totalPdfPages,
+ }
+}
+
+/** 全文搜索：返回关键字上下文片段（含高亮），按 offset 排序 */
+export function searchFullText(
+ fullText: string,
+ keyword: string,
+ limit = 30,
+ from = 0,
+): { results: { index: number; snippet: string }[]; hasMore: boolean } {
+ if (!keyword || keyword.length < 2) return { results: [], hasMore: false }
+ const out: { index: number; snippet: string }[] = []
+ let idx = from
+ const ctx = 17
+ while (out.length < limit) {
+ idx = fullText.indexOf(keyword, idx + 1)
+ if (idx === -1) break
+ const begin = Math.max(0, idx - ctx)
+ const end = Math.min(fullText.length, idx + keyword.length + ctx)
+ const seg = fullText.substring(begin, end).replace(/\s/g, '')
+ const snippet = seg.replace(keyword, `${keyword}`)
+ out.push({ index: idx, snippet })
+ }
+ const hasMore = idx !== -1
+ return { results: out, hasMore }
+}
+
+/** 章节标题搜索 */
+export function searchChapters(chapters: Chapter[], keyword: string) {
+ const kw = keyword.toLowerCase()
+ return chapters.filter((c) => c.title.toLowerCase().includes(kw))
+}
+
+/** 渲染章节正文为安全 HTML（剥离 epub 的 img/style/script） */
+export function renderChapterHtml(content: string, format: BookFormat, cleanEmptyLines = false): string {
+ if (format === 'epub') {
+ return content
+ .replace(/]*>/g, '')
+ .replace(//gi, '')
+ .replace(//gi, '')
+ .replace(/<\/?a[^>]*>/g, '')
+ .replace(/\bp[>]/g, 'p style="text-indent:2em;margin:0 0 .15em 0;line-height:inherit">')
+ }
+ // TXT：按段落包 ) {
+ const list = getShelf().map((b) => (b.id === id ? { ...b, ...patch } : b))
+ saveShelf(list)
+}
+
+/** 封面附件 id（按 nativeId 隔离） */
+export function coverId(bookId: string): string {
+ const z = zt()
+ const native = z ? z.getNativeId() : 'dev'
+ return `${native}/${bookId}/cover`
+}
+
+export function saveCover(bookId: string, buf: ArrayBuffer | Buffer | Uint8Array, mime = 'image/png') {
+ // 运行期 Buffer 经结构化克隆到渲染进程后通常为 Uint8Array，postAttachment 兼容
+ zt()?.db.postAttachment(coverId(bookId), buf as any, mime)
+}
+
+export function getCover(bookId: string): Buffer | null {
+ return zt()?.db.getAttachment(coverId(bookId)) ?? null
+}
+
+export function removeCover(bookId: string) {
+ try {
+ zt()?.db.remove(coverId(bookId))
+ } catch {
+ /* 封面可能未存，忽略 */
+ }
+}
+
+/** Buffer 转 data URL（用于 ![]()
显示） */
+export function bufferToDataUrl(buf: Buffer | ArrayBuffer, mime = 'image/png'): string {
+ const bytes = buf instanceof ArrayBuffer ? new Uint8Array(buf) : new Uint8Array(buf)
+ let bin = ''
+ const chunk = 0x8000
+ for (let i = 0; i < bytes.length; i += chunk) {
+ bin += String.fromCharCode.apply(null, Array.from(bytes.subarray(i, i + chunk)) as any)
+ }
+ return `data:${mime};base64,${btoa(bin)}`
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/shared/types.ts b/plugins/serious-reading/src/shared/types.ts
new file mode 100644
index 00000000..08ff1613
--- /dev/null
+++ b/plugins/serious-reading/src/shared/types.ts
@@ -0,0 +1,137 @@
+/** 支持的书籍格式 */
+export type BookFormat = 'txt' | 'epub' | 'pdf'
+
+/** 单本书的书架元数据记录 */
+export interface ShelfBook {
+ id: string
+ type: BookFormat
+ name: string
+ /** TXT/EPUB/PDF 的本地绝对路径；EPUB 解析后内容会缓存为附件，这里仍留源路径以便重新解析 */
+ path: string
+ /** 封面附件 id（EPUB 有，其它为空） */
+ cover?: string
+ /** 章节总数（用于章节跳转显示） */
+ totalChapters?: number
+ /** 上次阅读的章节索引（章节模型进度） */
+ lastChapter?: number
+ /** 上次阅读的字符/页偏移（用于恢复进度） */
+ progress?: number
+ lastRead?: number
+}
+
+/** 全文章节（解析后内存模型，不入库） */
+export interface Chapter {
+ title: string
+ index: number
+ content: string
+ /** 章节在全文字符流中的起始偏移（用于百分比跳转） */
+ charOffset?: number
+ /** 章节在全文字符流中的长度 */
+ charLength?: number
+}
+
+/** 解析后的内存书籍对象 */
+export interface ParsedBook {
+ title: string
+ filePath: string
+ format: BookFormat
+ chapters: Chapter[]
+ totalChapters: number
+ /** 全文拼接字符串（TXT 用，用于全文搜索与百分比跳转） */
+ fullText?: string
+ /** PDF 的总页数 */
+ totalPdfPages?: number
+}
+
+/** 隐藏相关的触发动作标识 */
+export type TriggerKey =
+ | 'dblclick'
+ | 'middleClick'
+ | 'rightClick'
+ | 'escape'
+ | 'mouseenter'
+ | 'mouseleave'
+
+/** 三个隐藏/显示动作的可配置触发器集合 */
+export interface HideActions {
+ /** 隐身：阅读窗可见时触发，进入 stealth 透明状态 */
+ stealthHide: TriggerKey[]
+ /** 显示：阅读窗处于 stealth 状态时触发，恢复可见 */
+ stealthShow: TriggerKey[]
+ /** 真隐藏 win.hide()，彻底消失，需用命令恢复 */
+ realHide: TriggerKey[]
+}
+
+/** 翻页方式开关 */
+export interface PageActions {
+ arrow: boolean
+ wheel: boolean
+ click: boolean
+ pgupdn: boolean
+ space: boolean
+ touch: boolean
+ /** 翻页过渡：'none' 无动画，'slide' 滑动 */
+ transition: 'none' | 'slide'
+}
+
+/** 阅读窗外观配色（独立于 UI 明暗主题） */
+export interface ReaderStyle {
+ bgColor: string
+ textColor: string
+ opacity: number
+ fontSize: number
+ lineHeight: number
+ fontFamily: string
+ fontWeight: number
+ cleanEmptyLines: boolean
+}
+
+/** 自动翻页设置 */
+export interface AutoPageSetting {
+ /** 间隔秒数，0 = 关闭 */
+ interval: number
+ /** stealth 隐藏时是否暂停 */
+ pauseOnStealth: boolean
+}
+
+/** 完整设置对象 */
+export interface Settings {
+ theme: 'auto' | 'light' | 'dark'
+ window: { width: number; height: number; x: number; y: number }
+ reader: ReaderStyle
+ page: PageActions
+ hide: HideActions
+ autoPage: AutoPageSetting
+}
+
+/** 阅读进度记录（按书籍路径存储） */
+export interface ReadingProgress {
+ filePath: string
+ format: BookFormat
+ /** 章节索引或 PDF 页码 */
+ chapterIndex: number
+ /** 章内页索引（TXT/EPUB 高度分页）或 0 */
+ pageIndex: number
+ /** 字符偏移（百分比跳转用，TXT） */
+ charOffset?: number
+ /** 章节总数（用于书架封面进度展示） */
+ totalChapters?: number
+ timestamp: number
+}
+
+/** 全文搜索结果项 */
+export interface SearchResult {
+ /** 关键字在全文字符流中的起始偏移 */
+ index: number
+ /** 含高亮标记的上下文片段 HTML */
+ snippet: string
+}
+
+/** 最近阅读历史项 */
+export interface RecentBook {
+ filePath: string
+ title: string
+ format: BookFormat
+ lastChapter?: number
+ lastRead: number
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/shared/ztools.d.ts b/plugins/serious-reading/src/shared/ztools.d.ts
new file mode 100644
index 00000000..d2d77c40
--- /dev/null
+++ b/plugins/serious-reading/src/shared/ztools.d.ts
@@ -0,0 +1,140 @@
+/**
+ * ZTools 运行时全局 API 的环境类型声明。
+ * 这些 API 由 ZTools 宿主在运行时注入到 window.ztools，不在依赖包中。
+ */
+export {}
+
+declare global {
+ interface ZToolsDbStorage {
+ getItem(key: string): any
+ setItem(key: string, value: any): void
+ removeItem(key: string): void
+ }
+
+ interface ZToolsDbDoc {
+ _id: string
+ _rev?: string
+ [k: string]: any
+ }
+
+ interface ZToolsDb {
+ put(doc: ZToolsDbDoc): { ok: boolean; rev?: string; id: string; error?: boolean; message?: string }
+ get(id: string): ZToolsDbDoc | null
+ remove(docOrId: ZToolsDbDoc | string): { ok: boolean }
+ postAttachment(id: string, attachment: string | Buffer, type: string): { ok: boolean }
+ getAttachment(id: string): Buffer | null
+ }
+
+ interface ZToolsClipboard {
+ write: (id: string, shouldPaste?: boolean) => Promise
+ writeContent: (data: { type: 'text' | 'image'; content: string }, shouldPaste?: boolean) => Promise
+ }
+
+ interface BrowserWindowProxy {
+ show(): void
+ hide(): void
+ isVisible(): boolean
+ isDestroyed(): boolean
+ focus(): void
+ close(): void
+ getPosition(): [number, number]
+ getSize(): [number, number]
+ getBounds(): { x: number; y: number; width: number; height: number }
+ setBounds(bounds: { x?: number; y?: number; width?: number; height?: number }): void
+ setPosition(x: number, y: number): void
+ setSize(width: number, height: number): void
+ setAlwaysOnTop(flag: boolean, level?: string): void
+ webContents: {
+ id: number
+ send(channel: string, ...args: any[]): void
+ openDevTools(): void
+ }
+ }
+
+ interface LaunchParam {
+ payload: any
+ type: 'text' | 'regex' | 'over' | 'files' | 'img'
+ code: string
+ }
+
+ interface ZToolsApi {
+ getAppName(): string
+ isMacOs(): boolean
+ isWindows(): boolean
+ isLinux(): boolean
+ isDarkColors(): boolean
+ isDev(): boolean
+ getNativeId(): string
+ getAppVersion(): string
+ getWindowType(): string
+ setExpendHeight(height: number): void
+ showNotification(body: string): void
+ showMainWindow(): Promise
+ hideMainWindow(isRestorePreWindow?: boolean): Promise
+ outPlugin(isKill?: boolean): Promise
+ onPluginEnter(cb: (p: LaunchParam) => void): void
+ onPluginOut(cb: (isKill: boolean) => void): void
+ onPluginDetach(cb: () => void): void
+ onPluginReady(cb: (p: LaunchParam) => void): void
+ createBrowserWindow(
+ url: string,
+ options: Record,
+ callback?: () => void,
+ ): BrowserWindowProxy | null
+ sendToParent(channel: string, ...args: any[]): void
+ showOpenDialog(options: Record): string[] | undefined
+ showSaveDialog(options: Record): string | undefined
+ screenCapture(cb: (image: string) => void): void
+ copyText(text: string): boolean
+ getPath(name: string): string
+ getPathForFile(file: File): string
+ db: ZToolsDb
+ dbStorage: ZToolsDbStorage
+ clipboard: ZToolsClipboard
+ }
+
+ const ztools: ZToolsApi | undefined
+
+ interface Window {
+ ztools?: ZToolsApi
+ /**
+ * 主窗 preload 暴露给渲染进程的服务。
+ * 阅读窗有自己的 reader services，详见 preload/reader.js。
+ */
+ services?: ReaderServices
+ _ipcRenderer?: { on(channel: string, cb: (e: unknown, ...args: any[]) => void): void; send(channel: string, ...args: any[]): void }
+ _sendToParent?: (channel: string, data?: any) => void
+ }
+
+ /** preload 暴露的文件读取/解析服务 */
+ interface ReaderServices {
+ /** 读取 TXT 文件，自动检测编码并解码为字符串 */
+ readTxt(filePath: string): string | null
+ /** 解析 EPUB，返回书籍元信息 + 章节列表（正文为 HTML 字符串） */
+ readEpub(filePath: string): EBook | null
+ /** 读取 PDF 为 ArrayBuffer，交由前端 pdfjs 渲染 */
+ readPdf(filePath: string): ArrayBuffer | null
+ /** 取文件 Buffer（封面等） */
+ readBuffer(filePath: string): ArrayBuffer | null
+ /** 选择文件对话框 */
+ showOpenDialog(options: Record): string[] | undefined
+ /** 创建并持有悬浮阅读窗 */
+ createReaderWindow(state: any): BrowserWindowProxy | null
+ /** 向阅读窗发送消息 */
+ sendToReader(channel: string, data?: any): void
+ /** 显示阅读窗 */
+ showReader(): boolean
+ /** 切换阅读窗显隐 */
+ toggleReader(): boolean
+ }
+
+ /** EPUB 解析结果（readEpub 返回） */
+ interface EBook {
+ title: string
+ filePath: string
+ format: 'epub'
+ chapters: { title: string; content: string; index: number }[]
+ totalChapters: number
+ cover?: ArrayBuffer | null
+ }
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/styles/globals.css b/plugins/serious-reading/src/styles/globals.css
new file mode 100644
index 00000000..1e0a41b5
--- /dev/null
+++ b/plugins/serious-reading/src/styles/globals.css
@@ -0,0 +1,63 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+@layer base {
+ :root {
+ --background: 0 0% 100%;
+ --foreground: 222 47% 11%;
+ --card: 0 0% 100%;
+ --card-foreground: 222 47% 11%;
+ --primary: 160 84% 39%;
+ --primary-foreground: 0 0% 100%;
+ --secondary: 220 14% 96%;
+ --secondary-foreground: 222 47% 11%;
+ --muted: 220 14% 96%;
+ --muted-foreground: 220 9% 46%;
+ --accent: 220 14% 96%;
+ --accent-foreground: 222 47% 11%;
+ --destructive: 0 84% 60%;
+ --destructive-foreground: 0 0% 100%;
+ --border: 220 13% 91%;
+ --input: 220 13% 91%;
+ --ring: 160 84% 39%;
+ --radius: 0.5rem;
+ }
+
+ .dark {
+ --background: 222 47% 11%;
+ --foreground: 210 40% 98%;
+ --card: 222 47% 13%;
+ --card-foreground: 210 40% 98%;
+ --primary: 160 84% 45%;
+ --primary-foreground: 0 0% 100%;
+ --secondary: 217 33% 17%;
+ --secondary-foreground: 210 40% 98%;
+ --muted: 217 33% 17%;
+ --muted-foreground: 215 20% 65%;
+ --accent: 217 33% 17%;
+ --accent-foreground: 210 40% 98%;
+ --destructive: 0 63% 31%;
+ --destructive-foreground: 210 40% 98%;
+ --border: 217 33% 20%;
+ --input: 217 33% 20%;
+ --ring: 160 84% 45%;
+ }
+}
+
+html, body, #root { height: 100%; }
+body {
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Microsoft YaHei', sans-serif;
+ -webkit-font-smoothing: antialiased;
+}
+
+/* 阅读窗透明留窗（stealth）全局样式：内容近全透明，窗口仍在 */
+.sr-stealth {
+ color: #00000001 !important;
+ background: #00000001 !important;
+}
+.sr-stealth * { visibility: hidden !important; }
+
+/* 阅读窗拖拽区 */
+.sr-drag { -webkit-app-region: drag; }
+.sr-no-drag { -webkit-app-region: no-drag; }
\ No newline at end of file
diff --git a/plugins/serious-reading/src/vite-env.d.ts b/plugins/serious-reading/src/vite-env.d.ts
new file mode 100644
index 00000000..151aa685
--- /dev/null
+++ b/plugins/serious-reading/src/vite-env.d.ts
@@ -0,0 +1 @@
+/// `
+- 必填：否
+
+插件功能列表，定义插件支持的功能及其触发方式。
+
+### `feature.code`
+
+- 类型：`string`
+- 说明：功能唯一标识，用于区分不同功能。
+
+### `feature.explain`
+
+- 类型：`string`
+- 说明：功能说明，显示在搜索结果中。
+
+### `feature.cmds`
+
+- 类型：`Array`
+- 说明：触发指令列表。可以是简单的字符串，也可以是匹配对象（正则、全局、图片、文件等）。
+
+### `feature.platform`
+
+- 类型：`Array<'win32' | 'darwin' | 'linux'>`
+- 必填：否
+- 说明：支持的平台。如果不填，默认支持所有平台。
+
+## 指令类型详解
+
+### 文本指令 (String)
+
+最简单的触发方式，当用户输入完全匹配该文本时触发。
+
+
+
+```
+{
+ "features": [
+ {
+ "code": "hello",
+ "explain": "打招呼",
+ "cmds": ["hello", "你好"]
+ }
+ ]
+}
+```
+
+### 正则表达式指令 (RegexCmd)
+
+使用正则表达式匹配用户输入。
+
+
+
+```
+{
+ "features": [
+ {
+ "code": "color",
+ "explain": "颜色预览",
+ "cmds": [
+ {
+ "type": "regex",
+ "label": "颜色预览",
+ "match": "/^#([0-9a-fA-F]{6}|[0-9a-fA-F]{3})$/i",
+ "minLength": 4
+ }
+ ]
+ }
+ ]
+}
+```
+
+- `type`: 固定为 `"regex"`
+- `label`: 匹配成功后显示的名称
+- `match`: 正则表达式字符串 (例如 `"/^abc/i"`)
+- `minLength`: 触发匹配的最小字符长度
+
+### 全局匹配指令 (OverCmd)
+
+匹配任意文本，通常用于需要处理所有输入的场景（如翻译、搜索插件）。
+
+
+
+```
+{
+ "features": [
+ {
+ "code": "translate",
+ "explain": "翻译",
+ "cmds": [
+ {
+ "type": "over",
+ "label": "翻译",
+ "exclude": "/^exclude/i",
+ "minLength": 1,
+ "maxLength": 1000
+ }
+ ]
+ }
+ ]
+}
+```
+
+- `type`: 固定为 `"over"`
+- `label`: 显示的名称
+- `exclude`: (可选) 排除匹配的正则表达式字符串
+- `minLength`: (可选) 最小字符数
+- `maxLength`: (可选) 最大字符数 (默认 10000)
+
+### 图片匹配指令 (ImgCmd)
+
+当用户粘贴图片到 ZTools 时触发，用于处理图片的插件（如图片压缩、格式转换、OCR 识别等）。
+
+
+
+```
+{
+ "features": [
+ {
+ "code": "image-process",
+ "explain": "图片处理",
+ "cmds": [
+ {
+ "type": "img",
+ "label": "图片处理"
+ }
+ ]
+ }
+ ]
+}
+```
+
+- `type`: 固定为 `"img"`
+- `label`: 显示的名称
+
+**使用场景**：
+
+- 图片压缩
+- 图片格式转换
+- OCR 文字识别
+- 图片编辑
+- 图片上传
+
+### 文件匹配指令 (FilesCmd)
+
+当用户粘贴文件或文件夹到 ZTools 时触发，支持多种过滤条件来精确匹配文件。
+
+
+
+```
+{
+ "features": [
+ {
+ "code": "file-process",
+ "explain": "文件处理",
+ "cmds": [
+ {
+ "type": "files",
+ "label": "批量重命名",
+ "fileType": "file",
+ "extensions": ["txt", "md", "json"],
+ "match": "/^test/i",
+ "minLength": 1,
+ "maxLength": 100
+ }
+ ]
+ }
+ ]
+}
+```
+
+- `type`: 固定为 `"files"`
+- `label`: 显示的名称
+- `fileType`: (可选) 文件类型，`"file"` 表示只匹配文件，`"directory"` 表示只匹配文件夹。不指定则文件和文件夹都匹配
+- `extensions`: (可选) 文件扩展名数组，只对文件有效（不检查文件夹）。例如 `["jpg", "png", "gif"]`
+- `match`: (可选) 匹配文件(夹)名称的正则表达式字符串。例如 `"/^test/i"` 表示匹配以 "test" 开头的文件名（不区分大小写）
+- `minLength`: (可选) 最少文件数，默认 1
+- `maxLength`: (可选) 最多文件数，默认 10000
+
+**匹配规则**：
+
+1. 首先检查文件数量是否在 `minLength` 和 `maxLength` 范围内
+2. 然后检查每个文件是否满足以下条件（如果指定）：
+ - 文件类型（`fileType`）
+ - 文件扩展名（`extensions`）
+ - 文件名正则匹配（`match`）
+
+**使用场景**：
+
+- 批量文件重命名
+- 文件格式转换
+- 文件压缩打包
+- 文件批量上传
+- 代码文件批量处理
+
+
+
+
+
+# 认识 preload
+
+当你在 `plugin.json` 文件配置了 `preload` 字段，指定的 js 文件将被预加载，该 js 文件可以调用 Node.js API 的本地原生能力和 Electron 渲染进程 API。
+
+## 为什么需要 `preload`
+
+在传统的 web 开发中，为了保持用户运行环境的安全，JavaScript 被做了很强的沙箱限制，比如不能访问本地文件，不能访问跨域网络资源，不能访问本地存储等。
+
+ZTools 基于 Electron 构建，通过 preload 机制，在渲染线程中，释放了沙箱限制，使得用户可以通过调用 Node.js 的 API 来访问本地文件、跨域网络资源、本地存储等。
+
+## `preload` 的定义
+
+`preload` 是完全独立于前端项目的一个特殊文件，它应当与 `plugin.json` 位于同一目录或其子目录下，保证可以在打包插件应用时可以被一起打包。
+
+`preload` js 文件遵循 CommonJS 规范，因此你可以使用 `require` 来引入 Node.js 模块，此部分可以参考 Node.js 文档。
+
+## 前端使用 `preload`
+
+只需给 `window` 对象自定义一个属性，前端就可直接访问该属性。
+
+**preload.js**
+
+
+
+```
+const fs = require("fs");
+
+window.customApis = {
+ readFile: (path) => {
+ return fs.readFileSync(path, "utf8");
+ },
+};
+```
+
+## preload js 规范
+
+由于 `preload` js 文件可使用本地原生能力，为了防止开发者滥用各种读写文件、网络等能力，ZTools 规定：
+
+- `preload` js 文件代码不能进行打包/压缩/混淆等操作，要保证每一行代码清晰可读。
+- 引入的第三方模块也必须清晰可读，在提交时将源码一同提交，同样不允许压缩/混淆。
+
+
+
+
+
+```
+ } else {
+ console.log("Email sent: " + info.response);
+ }
+ });
+};
+window.services = {
+ sendMail: () => {
+ return sendMail();
+ },
+};
+```
+
+## 引入 Electron 渲染进程 API
+
+preload.js
+
+
+
+```
+const { clipboard, nativeImage } = require("electron");
+
+window.services = {
+ copyImage: (imageFilePath) => {
+ clipboard.writeImage(nativeImage.createFromPath(imageFilePath))
+ },
+};
+```
+
+
+
+# 插件 API 文档
+
+ZTools 为插件提供了一套丰富的 API，通过全局对象 `window.ztools` 暴露。
+
+## 基础 API
+
+### `ztools.getAppName()`
+
+获取应用名称。
+
+- **返回**: `string` - 应用名称，固定返回 `'ZTools'`。
+
+### `ztools.getPathForFile(file)`
+
+获取拖放文件的真实路径。用于处理用户拖放文件到插件界面的场景（基于 Electron `webUtils.getPathForFile`）。
+
+- **file**: `File` - 拖放事件中的 File 对象。
+- **返回**: `string` - 文件的本地路径。
+
+### `ztools.isMacOs()` / `ztools.isMacOS()`
+
+检测当前是否为 macOS 系统。
+
+- **返回**: `boolean` - 是否为 macOS。
+
+### `ztools.isWindows()`
+
+检测当前是否为 Windows 系统。
+
+- **返回**: `boolean` - 是否为 Windows。
+
+### `ztools.isLinux()`
+
+检测当前是否为 Linux 系统。
+
+- **返回**: `boolean` - 是否为 Linux。
+
+### `ztools.getNativeId()`
+
+获取设备唯一标识符（32位字符串）。
+
+- **返回**: `string` - 设备唯一标识符。
+
+### `ztools.getAppVersion()`
+
+获取应用版本号。
+
+- **返回**: `string` - 应用版本号。
+
+### `ztools.getWindowType()`
+
+获取当前窗口类型。
+
+- **返回**: `string` - 窗口类型。
+
+### `ztools.isDarkColors()`
+
+检测当前是否为深色主题。
+
+- **返回**: `boolean` - 是否为深色主题。
+
+### `ztools.isDev()`
+
+检查当前插件是否处于开发模式。
+
+- **返回**: `boolean` - 是否处于开发模式。
+
+### `ztools.getWebContentsId()`
+
+获取当前 WebContents ID。
+
+- **返回**: `number` - WebContents ID。
+
+### `ztools.setExpendHeight(height)`
+
+设置插件视图的高度。
+
+- **height**: `number` - 期望的高度（像素）。
+
+### `ztools.showNotification(body)`
+
+显示系统通知。
+
+- **body**: `string` - 通知内容。
+
+### `ztools.sendInputEvent(event)`
+
+发送模拟输入事件。
+
+- **event**: `MouseInputEvent | MouseWheelInputEvent | KeyboardInputEvent` - 输入事件对象。
+
+#### 事件对象结构
+
+**KeyboardInputEvent (键盘事件)**
+
+- `type`: `'keyDown'` | `'keyUp'` | `'char'`
+- `keyCode`: `string` - 键盘代码
+- `modifiers`: `string[]` - 修饰键数组 (例如 `['shift', 'control']`)
+
+**MouseInputEvent (鼠标事件)**
+
+- `type`: `'mouseDown'` | `'mouseUp'` | `'mouseEnter'` | `'mouseLeave'` | `'contextMenu'` | `'mouseMove'`
+- `x`: `number` - X 坐标
+- `y`: `number` - Y 坐标
+- `button`: `'left'` | `'middle'` | `'right'` - 按钮类型
+- `clickCount`: `number` - 点击次数
+
+**MouseWheelInputEvent (滚轮事件)**
+
+- `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` - 是否成功。
+
+### `ztools.hideMainWindow(isRestorePreWindow)`
+
+隐藏主窗口，包括此时正在主窗口运行的插件应用。
+
+- **isRestorePreWindow**: `boolean` - (可选) 是否焦点回归到前面的活动窗口，默认 `true`。
+- **返回**: `Promise` - 是否成功。
+
+### `ztools.outPlugin(isKill)`
+
+退出插件应用，默认将插件应用隐藏后台。
+
+- **isKill**: `boolean` - (可选) 为 `true` 时，将结束运行插件应用 (杀死进程)。
+- **返回**: `Promise` - 是否成功。
+
+## 事件 API
+
+### `ztools.onPluginEnter(callback)`
+
+监听插件进入事件。当用户打开插件时触发。
+
+- **callback**: `(param: LaunchParam) => void` - 回调函数，接收启动参数。
+
+#### LaunchParam 结构
+
+- `payload`: `any` - 传递的数据（例如搜索框内容）
+- `type`: `'text' | 'regex' | 'over'` - 命令类型
+ - `'text'`: 文本匹配
+ - `'regex'`: 正则表达式匹配
+ - `'over'`: 任意文本匹配
+- `code`: `string` - 插件 Feature Code (如果是由 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` - 是否成功。
+
+## 数据库 API
+
+插件拥有独立的数据库存储空间（Bucket），以插件名称隔离。
+
+### `ztools.db.put(doc)`
+
+保存数据。
+
+- **doc**: `object` - 文档对象（必须包含 `_id` 字段）。
+- **返回**: `object` - 保存后的文档对象（包含 `_id` 和 `_rev`）。
+
+### `ztools.db.get(id)`
+
+获取数据。
+
+- **id**: `string` - 文档 ID。
+- **返回**: `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)`
+
+获取所有文档或按 key 前缀查询。
+
+- **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` - 文档 ID。
+- **返回**: `Buffer` - 附件内容。
+
+### `ztools.db.getAttachmentType(id)`
+
+获取文档附件的 MIME 类型。
+
+- **id**: `string` - 文档 ID。
+- **返回**: `string` - MIME 类型。
+
+### Promise API
+
+数据库 API 还提供了 Promise 版本，位于 `window.ztools.db.promises` 下，所有方法签名与同步版本相同，但返回 `Promise`。
+
+- `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` 的简化接口，用于简单的键值对存储。
+
+### `ztools.dbStorage.setItem(key, value)`
+
+保存数据。
+
+- **key**: `string` - 键名。
+- **value**: `any` - 要保存的数据（会自动序列化为 JSON）。
+
+### `ztools.dbStorage.getItem(key)`
+
+获取数据。
+
+- **key**: `string` - 键名。
+- **返回**: `any` - 数据内容，不存在则返回 `null`。
+
+### `ztools.dbStorage.removeItem(key)`
+
+删除数据。
+
+- **key**: `string` - 键名。
+
+## 动态 Feature API
+
+### `ztools.getFeatures(codes)`
+
+获取动态添加的 features。
+
+- **codes**: `string[]` - (可选) 指定要获取的 feature codes，不传则返回所有。
+- **返回**: `object[]` - Feature 数组。
+
+### `ztools.setFeature(feature)`
+
+设置动态 feature（如果已存在则更新）。
+
+- **feature**: `object` - Feature 对象。
+- **返回**: `boolean` - 是否成功。
+
+### `ztools.removeFeature(code)`
+
+删除指定的动态 feature。
+
+- **code**: `string` - Feature code。
+- **返回**: `boolean` - 是否成功。
+
+## 剪贴板 API
+
+### `ztools.clipboard.getHistory(page, pageSize, filter)`
+
+获取剪贴板历史记录。
+
+- **page**: `number` - 页码，从 1 开始。
+- **pageSize**: `number` - 每页数量。
+- **filter**: `string` - (可选) 过滤条件。
+- **返回**: `Promise
+
+ ) : (
+ <>
+ {/* 分页内容条：绝对定位单页切换 */}
+
+ {pages.map((p, i) => (
+
+ ))}
+
+
+ {/* 翻页点击区（左右各 30%）+ 中间拖动移动区（40%） */}
+ {settings.page.click && !stealth ? (
+ <>
+
+
+ { if (e.button === 0) { e.preventDefault(); sendParent?.('sr:win-start', { type: 'move' }); setDragWin({ sx: e.screenX, sy: e.screenY }) } }}
+ />
+
+ ) : !stealth ? (
+
+ )
+}
+
+/**
+ * 纯 JS 窗口移动 + 缩放把手。
+ * 不使用 -webkit-app-region:drag（会吞掉右键/中键），改为鼠标按下后通过 IPC
+ * 让主窗调用 win.setPosition / win.setBounds 完成移动与缩放。
+ * 整窗保持 no-drag，右键/中键/双击/滚轮/翻页触发全部正常。
+ */
+function WindowHandles({ sendParent }: { sendParent?: (c: string, d?: any) => void }) {
+ const [drag, setDrag] = useState<{ type: string; sx: number; sy: number } | null>(null)
+
+ useEffect(() => {
+ if (!drag) return
+ const onMove = (e: MouseEvent) => {
+ sendParent?.('sr:win-delta', { type: drag.type, dx: e.screenX - drag.sx, dy: e.screenY - drag.sy })
+ }
+ const onUp = () => {
+ sendParent?.('sr:win-end')
+ setDrag(null)
+ }
+ document.addEventListener('mousemove', onMove)
+ document.addEventListener('mouseup', onUp)
+ return () => {
+ document.removeEventListener('mousemove', onMove)
+ document.removeEventListener('mouseup', onUp)
+ }
+ }, [drag, sendParent])
+
+ const start = (type: string) => (e: React.MouseEvent) => {
+ e.preventDefault()
+ e.stopPropagation()
+ sendParent?.('sr:win-start', { type })
+ setDrag({ type, sx: e.screenX, sy: e.screenY })
+ }
+
+ const handles = [
+ // 缩放：四边/四角，全部放在窗口内并置于最上层
+ { type: 'w', cls: 'left-0 top-0 bottom-0 w-1.5 z-[60] cursor-ew-resize' },
+ { type: 'e', cls: 'right-0 top-0 bottom-0 w-1.5 z-[60] cursor-ew-resize' },
+ { type: 's', cls: 'left-0 right-0 bottom-0 h-1.5 z-[60] cursor-ns-resize' },
+ { type: 'nw', cls: 'left-0 top-0 w-3 h-3 z-[60] cursor-nw-resize' },
+ { type: 'ne', cls: 'right-0 top-0 w-3 h-3 z-[60] cursor-ne-resize' },
+ { type: 'sw', cls: 'left-0 bottom-0 w-3 h-3 z-[60] cursor-sw-resize' },
+ { type: 'se', cls: 'right-0 bottom-0 w-3 h-3 z-[60] cursor-se-resize' },
+ ]
+
+ return (
+ <>
+ {handles.map((h) => (
+
+ ))}
+
+ )
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/reader/components/PdfView.tsx b/plugins/serious-reading/src/reader/components/PdfView.tsx
new file mode 100644
index 00000000..16892be1
--- /dev/null
+++ b/plugins/serious-reading/src/reader/components/PdfView.tsx
@@ -0,0 +1,47 @@
+import { useEffect, useRef, useState } from 'react'
+import * as pdfjsLib from 'pdfjs-dist'
+// Vite 以 url 加载 worker（构建后为独立 asset）
+import workerUrl from 'pdfjs-dist/build/pdf.worker.min.mjs?url'
+pdfjsLib.GlobalWorkerOptions.workerSrc = workerUrl
+
+export function PdfView(props: {
+ data: ArrayBuffer
+ page: number
+ scale: number
+ onPageReady: (totalPages: number) => void
+}) {
+ const canvasRef = useRef { if (e.button === 0) { e.preventDefault(); sendParent?.('sr:win-start', { type: 'move' }); setDragWin({ sx: e.screenX, sy: e.screenY }) } }}
+ />
+ ) : null}
+
+ {/* 进度条 */}
+ {!stealth && (
+
+
+
+
+ )}
+
+ )}
+
+
+
+ {total > 0 && {props.page}/{total}}
+
+ )
+}
\ No newline at end of file
diff --git a/plugins/serious-reading/src/reader/main.tsx b/plugins/serious-reading/src/reader/main.tsx
new file mode 100644
index 00000000..f137e0ac
--- /dev/null
+++ b/plugins/serious-reading/src/reader/main.tsx
@@ -0,0 +1,10 @@
+import React from 'react'
+import ReactDOM from 'react-dom/client'
+import App from './App'
+import '@/styles/globals.css'
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+ ，首行缩进两字，段间留白 + if (!cleanEmptyLines) { + // 默认：保留原文换行，每个 \n 产生一个
，空行变为间隔行 + const lines = content.split(/\n/) + return lines.map((line) => { + const t = escapeHtml(line.trimEnd()) + if (!t.trim()) return '
' + const startsWithQuote = /^[“"].*["”]/.test(t) + const indent = startsWithQuote ? '0' : '2em' + return `
${t}
` + }).join('') + } + // 清理空行：每行独立成段，连续空行压缩为1个间距（段落间保留一个空行，去除多余空行） + const rawLines = content.split(/\n/) + const paragraphs: string[] = [] + let prevEmpty = false + for (const line of rawLines) { + if (line.trim() === '') { + if (paragraphs.length > 0 && !prevEmpty) paragraphs.push('') + prevEmpty = true + } else { + prevEmpty = false + paragraphs.push(line.trim()) + } + } + // 去除首尾空行 + while (paragraphs.length && paragraphs[0] === '') paragraphs.shift() + while (paragraphs.length && paragraphs[paragraphs.length - 1] === '') paragraphs.pop() + return paragraphs.map((p) => { + if (!p) return '' + const t = escapeHtml(p) + const startsWithQuote = /^[“"].*["”]/.test(t) + const indent = startsWithQuote ? '0' : '2em' + return `
${t}
` + }).join('') +} + +function escapeHtml(s: string): string { + return s + .replace(/&/g, '&') + .replace(//g, '>') + .replace(/"/g, '"') +} \ No newline at end of file diff --git a/plugins/serious-reading/src/shared/storage.ts b/plugins/serious-reading/src/shared/storage.ts new file mode 100644 index 00000000..9b6f6520 --- /dev/null +++ b/plugins/serious-reading/src/shared/storage.ts @@ -0,0 +1,131 @@ +import type { + Settings, + ReadingProgress, + RecentBook, + ShelfBook, +} from './types' +import { DB_PREFIX, DEFAULT_SETTINGS } from './constants' + +/** 安全获取 ztools 全局（开发期可能未注入） */ +function zt() { + return typeof window !== 'undefined' ? window.ztools : undefined +} + +const SET_KEY = DB_PREFIX + 'settings' +const HIST_KEY = DB_PREFIX + 'history' +const WINPOS_KEY = DB_PREFIX + 'winpos' +const BOOKS_DOC_ID = DB_PREFIX + 'books' + +/* ---------------- KV（dbStorage） ---------------- */ + +export function getSettings(): Settings { + const z = zt() + const raw = z ? z.dbStorage.getItem(SET_KEY) : null + if (!raw) return JSON.parse(JSON.stringify(DEFAULT_SETTINGS)) + // 合并默认值，避免新增字段缺失 + return { ...DEFAULT_SETTINGS, ...raw, reader: { ...DEFAULT_SETTINGS.reader, ...raw.reader } } +} + +export function saveSettings(s: Settings) { + zt()?.dbStorage.setItem(SET_KEY, s) +} + +export function getWindowPos(): { x: number; y: number; width: number; height: number } | null { + return zt()?.dbStorage.getItem(WINPOS_KEY) ?? null +} + +export function saveWindowPos(b: { x: number; y: number; width: number; height: number }) { + zt()?.dbStorage.setItem(WINPOS_KEY, b) +} + +export function getProgress(filePath: string): ReadingProgress | null { + return zt()?.dbStorage.getItem(DB_PREFIX + 'progress/' + filePath) ?? null +} + +export function saveProgress(p: ReadingProgress) { + zt()?.dbStorage.setItem(DB_PREFIX + 'progress/' + p.filePath, p) +} + +export function getHistory(): RecentBook[] { + return zt()?.dbStorage.getItem(HIST_KEY) ?? [] +} + +export function addRecentBook(b: RecentBook) { + const list = getHistory() + const i = list.findIndex((x) => x.filePath === b.filePath) + if (i >= 0) list.splice(i, 1) + list.unshift(b) + zt()?.dbStorage.setItem(HIST_KEY, list.slice(0, 20)) +} + +/* ---------------- 文档（db） ---------------- */ + +/** 书架列表：单文档，data 为 ShelfBook 数组 */ +export function getShelf(): ShelfBook[] { + const z = zt() + if (!z) return [] + const doc = z.db.get(BOOKS_DOC_ID) + return (doc?.data as ShelfBook[]) ?? [] +} + +export function saveShelf(list: ShelfBook[]) { + const z = zt() + if (!z) return + const existing = z.db.get(BOOKS_DOC_ID) + const doc = existing ?? { _id: BOOKS_DOC_ID } + doc.data = list + z.db.put(doc) +} + +export function addBookToShelf(book: ShelfBook): boolean { + const list = getShelf() + if (list.some((b) => b.path === book.path)) return false + list.push(book) + saveShelf(list) + return true +} + +export function removeBookFromShelf(id: string) { + const list = getShelf().filter((b) => b.id !== id) + saveShelf(list) +} + +export function updateBookInShelf(id: string, patch: Partial